ContractSpec docs

OSS-first docs

These docs teach the open system first: contracts, generated surfaces, runtimes, governance, and incremental adoption. Studio shows up as the operating layer on top, not as the source of truth.

SavedView — serialisable graph viewport + filter + layout snapshot

Encodes graph viewport, active filter, and layout as a base64 URL param (?gv=). Use serializeSavedView / deserializeSavedView to persist and restore. useSavedViewRestore reads ?gv= on mount and applies the snapshot.

field.key.label
SavedView — serialisable graph viewport + filter + layout snapshot
field.version.label
field.type.label
field.title.label
SavedView — serialisable graph viewport + filter + layout snapshot
field.description.label

Encodes graph viewport, active filter, and layout as a base64 URL param (?gv=). Use serializeSavedView / deserializeSavedView to persist and restore. useSavedViewRestore reads ?gv= on mount and applies the snapshot.

field.tags.label
graph,saved-view,url,restore,viewport,m3
field.owners.label
field.stability.label
public

Serialisable snapshot of the current graph state stored in `?gv=<base64>`.

Fields

| Field | Type | Description | |---|---|---| | `id` | `string` | Unique view identifier | | `name` | `string` | Human-readable label | | `viewport` | `SavedViewport` | Pan + zoom state | | `filter` | `GraphFilterSpec?` | Active filter snapshot | | `layout` | `string?` | Layout kind key | | `savedAt` | `string` | ISO 8601 timestamp |

URL encoding

Zoom is clamped to `[0.05, 10]` on decode. Invalid or absent `?gv=` always yields `null`.