@modernrelay/orbit-core 0.13.5 → 0.14.0

package/dist/{index-CFZMson3.d.ts → index-CPRTWpGA.d.ts}

@@ -1,5 +1,5 @@
 /**
- * Typed error taxonomy (spec §6.5, v0.2 subset of call sites).
+ * Typed error taxonomy for public operation failures.
  *
  * Structural fatality rule: a *transient* context loss never mints a
  * GraphError — it is a status transition ('lost') plus a 'context-lost'
@@ -7,7 +7,7 @@
  * code 'context-lost' is constructed ONLY on terminal recovery failure, where
  * it is always fatal. This keeps fatality structural rather than conditional.
  */
-/** Placeholder until resource admission control lands (plan S4-T06). */
+/** Reserved for resource admission-control failures. */
 interface ResourceAdmissionReport {
     reason: string;
     estimatedBytes?: number;
@@ -31,8 +31,8 @@ type GraphError = {
     cause: unknown;
 };
 /**
- * Operation-scoped failures (spec §6.5): rejected promises / thrown calls.
- * All ten codes are typed now even where their subsystems are post-v0.2 —
+ * Operation-scoped failures: rejected promises / thrown calls.
+ * All ten codes are typed now even where their subsystems are post-v0.2
  * the union is the public contract, the wiring arrives with each subsystem.
  */
 type GraphOperationError = {
@@ -73,10 +73,10 @@ type GraphOperationError = {
 };
 /** Lifecycle phase an instance-level error occurred in. */
 type ErrorPhase = 'mount' | 'running' | 'recovery';
-/** Spec §6.5 fatality matrix as a pure decision function. */
+/** Spec fatality matrix as a pure decision function. */
 declare function isFatalGraphError(error: GraphError, phase: ErrorPhase): boolean;
 /**
- * Spec §6.5 rule for a resource-limit producer deciding `fatal`: rejection is
+ * Spec rule for a resource-limit producer deciding `fatal`: rejection is
  * fatal before the first accepted scene or during terminal recovery; a later
  * inadmissible declarative update keeps the previous scene (non-fatal).
  */
@@ -91,25 +91,25 @@ declare class OrbitOperationError extends Error {
 declare function graphErrorToError(graphError: GraphError, cause?: Error): Error;
 
 /**
- * orbit-core public data model (spec §5, v0.1 subset).
+ * orbit-core public data model.
  *
  * The public model is object-based, id-keyed, and generic over caller attribute
  * types. A `GraphSnapshot` is the declarative source of truth; the core keeps a
- * derived index model and drives the engine imperatively (§4).
+ * derived index model and drives the engine imperatively.
  */
 
 type NodeId = string;
 type EdgeId = string;
 /** Plain JSON value — the shape `dataRef` and other verbatim host payloads
- * must fit (§16.14: stored, round-tripped, compared canonically, NEVER
- * interpreted). */
+ * must fit. Values are stored, round-tripped, compared canonically, and NEVER
+ * interpreted. */
 type JsonValue = null | boolean | number | string | JsonValue[] | {
     [key: string]: JsonValue;
 };
 interface GraphNode<N = Record<string, unknown>> {
     id: NodeId;
     attrs?: N;
-    /** Optional fixed/persisted position (layout 'fixed' honors these; §10). */
+    /** Optional fixed/persisted position honored by the fixed layout. */
     x?: number;
     y?: number;
 }
@@ -118,7 +118,7 @@ interface GraphEdge<E = Record<string, unknown>> {
      * Optional stable id. When absent, the core synthesizes a deterministic id
      * `${escapedSource}→${escapedTarget}#${k}` where `\\`, `→`, and `#` are
      * backslash-escaped inside endpoint ids, and k disambiguates parallel edges
-     * in first-occurrence order (§5). Simple endpoint ids retain the familiar
+     * in first-occurrence order. Simple endpoint ids retain the familiar
      * `${source}→${target}#${k}` form.
      */
     id?: EdgeId;
@@ -126,51 +126,51 @@ interface GraphEdge<E = Record<string, unknown>> {
     target: NodeId;
     attrs?: E;
 }
-/** Versioned snapshot — the declarative source of truth (§4, §5). */
+/** Versioned snapshot — the declarative source of truth. */
 interface GraphSnapshot<N = Record<string, unknown>, E = Record<string, unknown>> {
-    /** Identity of the dataset; changing it clears all per-dataset state (§5). */
+    /** Identity of the dataset; changing it clears all per-dataset state. */
     datasetKey: string;
-    /** Caller-owned revision; same {datasetKey, sourceRevision} replays are idempotent (§5). */
+    /** Caller-owned revision; same {datasetKey, sourceRevision} replays are idempotent. */
     sourceRevision: number | string;
     nodes: readonly GraphNode<N>[];
     edges: readonly GraphEdge<E>[];
 }
 type DiagnosticSeverity = 'info' | 'warning' | 'error';
 type DiagnosticCode = 'duplicate-node-id' | 'duplicate-edge-id' | 'dangling-edge-endpoint' | 'invalid-node' | 'invalid-edge' | 'self-loop-retained'
-/** A filter predicate threw or an expr referenced bad data; aggregated (§9.1). */
+/** A filter predicate threw or an expr referenced bad data; aggregated. */
  | 'filter-error'
-/** Async metric column rejected (misaligned/duplicate/unknown ids; §12). */
+/** Async metric column rejected due to misalignment, duplicates, or unknown ids. */
  | 'metric-column-error'
-/** A channel reprojected repeatedly with identical outputs (§8 dev). */
+/** A channel reprojected repeatedly with identical outputs. */
  | 'accessor-churn'
-/** Image atlas resolve/decoding failures, cadence-batched (§8). */
+/** Image atlas resolve/decoding failures, cadence-batched. */
  | 'image-resolve-failed' | 'source-revision-reused'
-/** §5.1 columnar lane: invalid structure (length mismatch, detached
+/** columnar lane: invalid structure (length mismatch, detached
  * buffer, out-of-range dictionary or endpoint index) — the WHOLE snapshot
  * is rejected before derivation; the previous accepted scene stays. */
  | 'invalid-columnar-snapshot'
-/** ADR-006 D5: the worker lane could not boot — columnar acceptance runs
+/** The worker lane could not boot — columnar acceptance runs
  * on the main lane instead (info under execution:'auto', error under
  * 'worker'). One-shot per instance. */
  | 'worker-unavailable'
-/** A host config lane was rejected at the boundary (§5.1/§16.3 — e.g. a
+/** A host config lane was rejected at the boundary — e.g. a
  * groups array whose containment is cyclic or multiply parented); the
  * previous config stays live. */
  | 'config-error'
-/** §16.14: a setViewState payload failed structural validation or carries
+/** a setViewState payload failed structural validation or carries
  * a version newer than this library; NOTHING was applied. */
  | 'invalid-view-state' | 'engine-error' | 'accessor-error'
-/** A user event listener threw; isolated per §15 (the chain continues). */
+/** A user event listener threw; isolated so the listener chain continues. */
  | 'listener-error'
-/** showLabelsFor exceeded tracked-label capacity; omissions counted (§14). */
+/** showLabelsFor exceeded tracked-label capacity; omissions counted. */
  | 'label-overload'
-/** A same-id row from an earlier overlay won in admission order (§7.5). */
+/** A same-id row from an earlier overlay won in admission order. */
  | 'overlay-node-shadowed'
-/** A service call was aborted/discarded before admission (§9.2; info). */
+/** A service call was aborted/discarded before admission. */
  | 'service-aborted'
-/** A service call failed (§9.2; error). */
+/** A service call failed. */
  | 'service-error' | 'context-lost' | 'operation-rejected'
-/** Adapter-defined codes are namespaced (spec §6.5 routing note). */
+/** Adapter-defined codes are namespaced. */
  | `engine:${string}`;
 declare const DIAGNOSTIC_SAMPLE_CAP = 10;
 interface GraphDiagnostic {
@@ -187,10 +187,10 @@ interface Revisions {
     source: number | string | null;
     /** Monotonic counter advanced on every accepted model change. */
     model: number;
-    /** Filtering/subgraph scope revision (§9). Advances with every accepted
+    /** Filtering/subgraph scope revision. Advances with every accepted
      * model change AND on every hard-scope (subgraph) change; a SCOPE-ONLY
      * change advances `scope` and `render` but NOT `model` — the first genuine
-     * scope/model split (v0.5, §9.2). */
+     * scope/model split. */
     scope: number;
     /** Monotonic counter advanced on every desired-render publication. */
     render: number;
@@ -203,7 +203,7 @@ interface AcceptedEdge<E = Record<string, unknown>> extends GraphEdge<E> {
 interface AcceptedGraph<N = Record<string, unknown>, E = Record<string, unknown>> {
     datasetKey: string;
     sourceRevision: number | string;
-    /** Deduplicated (first-wins), in accepted-base order (§5.1, §16.2). */
+    /** Deduplicated (first-wins), in accepted-base order. */
     nodes: readonly GraphNode<N>[];
     /** Dangling endpoints dropped; ids present (synthesized when needed). */
     edges: readonly AcceptedEdge<E>[];
@@ -222,23 +222,23 @@ interface RenderScene {
     edgeIdByIndex: readonly EdgeId[];
     /**
      * 2*count floats. NaN pairs mean "no known position" — the engine seeds
-     * them (§7.3); known positions come from the position cache.
+     * them; known positions come from the position cache.
      */
     positions: Float32Array;
     /** 2*linkCount uint32 endpoint indices into the point set. */
     links: Uint32Array;
     /**
-     * §16.3 stage-3 synthetic suffix (S12). Present iff the scene was rewritten
+     * Synthetic suffix. Present iff the scene was rewritten
      * by collapsed groups: point slots >= physicalPointCount are super-nodes
      * and link slots >= physicalLinkCount are meta-edges (synthetics are always
      * a contiguous suffix). For those slots, idByIndex/edgeIdByIndex hold
-     * INTERNAL scene keys that never escape public payloads (§7.4) — consumers
+     * INTERNAL scene keys that never escape public payloads — consumers
      * resolve slots through the discriminated ScenePointRef/SceneLinkRef
      * helpers instead.
      */
     groups?: SceneGroups;
 }
-/** §16.3 compact synthetic-suffix descriptor attached to a rewritten scene. */
+/** compact synthetic-suffix descriptor attached to a rewritten scene. */
 interface SceneGroups {
     physicalPointCount: number;
     physicalLinkCount: number;
@@ -247,9 +247,9 @@ interface SceneGroups {
     /** Aligned to link slots physicalLinkCount..linkCount-1. */
     metaEdges: readonly MetaEdge[];
     /**
-     * §16.3 node folds: representatives that are REAL nodes, so they carry no
+     * node folds: representatives that are REAL nodes, so they carry no
      * synthetic slot and never appear in `superNodes`. A folded anchor keeps
-     * its physical row (and its own caller-driven styling, R-6.1-14) — this
+     * its physical row (and its own caller-driven styling) — this
      * list only reports how many descendants it currently stands for, for
      * badge rendering. Empty when nothing is folded.
      */
@@ -260,7 +260,7 @@ interface SceneFold {
     anchorId: NodeId;
     hiddenCount: number;
 }
-/** §7.4 discriminated point ref: a physical node id or a resolved group —
+/** discriminated point ref: a physical node id or a resolved group
  * public namespaces only, never internal scene keys. */
 type ScenePointRef = {
     kind: 'node';
@@ -269,7 +269,7 @@ type ScenePointRef = {
     kind: 'group';
     group: ResolvedGroup;
 };
-/** §7.4 discriminated link ref: a physical edge id or a meta-edge record. */
+/** discriminated link ref: a physical edge id or a meta-edge record. */
 type SceneLinkRef = {
     kind: 'edge';
     id: EdgeId;
@@ -280,8 +280,8 @@ type SceneLinkRef = {
 type Accessor<T, V> = V | ((item: T) => V);
 type LayoutKind = 'force' | 'fixed';
 /**
- * §10 force tunables under stable, engine-neutral names — orbit maps them onto
- * the active engine's parameters through atomic config-only commits (§13), so
+ * force tunables under stable, engine-neutral names — orbit maps them onto
+ * the active engine's parameters through atomic config-only commits, so
  * a value here never resets positions or restarts the layout.
  *
  * Every field is optional and OMISSION MEANS "leave the engine's default
@@ -373,7 +373,7 @@ interface ColumnarGraphSnapshot<N = Record<string, unknown>, E = Record<string,
     datasetKey: string;
     sourceRevision: string | number;
     /** Default 'borrowed'. 'transfer' detaches the supplied ArrayBuffers ONLY
-     * after structural validation AND admission succeed (ADR-006 D4); the
+     * after structural validation AND admission succeed; the
      * snapshot object is then single-use. */
     bufferOwnership?: 'borrowed' | 'transfer';
     nodes: {
@@ -404,65 +404,65 @@ interface GraphHostUpdate<N = Record<string, unknown>, E = Record<string, unknow
     nodeSize?: Accessor<GraphNode<N>, number> | Scale<number, N>;
     linkColor?: Accessor<AcceptedEdge<E>, string>;
     linkWidth?: Accessor<AcceptedEdge<E>, number>;
-    /** §12 async metric columns, joined once with revision-gated admission. */
+    /** async metric columns, joined once with revision-gated admission. */
     metrics?: readonly MetricColumn[];
     /**
-     * §8 image sprites: synchronous, string-valued ref accessor (URL/blob
+     * image sprites: synchronous, string-valued ref accessor (URL/blob
      * ref/cache key — opaque to orbit). Refs feed the image-atlas pipeline when
      * the engine declares `pointImages`; otherwise refs are retained and the
-     * placeholder shape renders (§13 capability policy).
+     * placeholder shape renders.
      */
-    /** §8 image refs; `null` CLEARS the accessor and evicts the atlas back to
+    /** image refs; `null` CLEARS the accessor and evicts the atlas back to
      * placeholders (D2 explicit reset — omission stays "no change"). */
     nodeImage?: ((node: GraphNode<N>) => string | null) | null;
-    /** §16.12 instanced arrowheads (capability-gated; inert when unsupported). */
+    /** instanced arrowheads (capability-gated; inert when unsupported). */
     edgeArrows?: boolean;
-    /** §16.14 durable source coordinate for view states — stored VERBATIM,
+    /** durable source coordinate for view states — stored VERBATIM,
      * never interpreted; serialized by getViewState and canonically compared
      * on setViewState. Stash-only lane: no publish, no commit. Omission means
      * no change (there is no clear form in v1 — set `{}` for emptiness). */
     dataRef?: JsonValue;
-    /** §16.13 runtime toggles — atomic config-only commits, no reprojection. */
+    /** runtime toggles — atomic config-only commits, no reprojection. */
     showLinks?: boolean;
-    /** §13 emphasis-ring toggle (default TRUE — the ring predates its name: it
+    /** emphasis-ring toggle (default TRUE — the ring predates its name: it
      * has followed hover since v0.1). False clears the engine ring once and
      * suppresses every driver (hover, focusNode, emphasizeNode). */
     emphasisRing?: boolean;
     layout?: LayoutKind;
     simulation?: SimulationConfig;
-    /** Controlled selection (uncontrolled when never provided; §6.4 subset). */
+    /** Controlled selection (uncontrolled when never provided; subset). */
     selection?: readonly NodeId[];
     theme?: ThemeInput;
-    /** DOM label lane configuration (§14; strategy 'dom' only in v0.4). */
+    /** DOM label lane configuration; strategy 'dom' only in v0.4. */
     labels?: LabelConfig<N>;
-    /** §15.1 accessibility runtime options. */
+    /** accessibility runtime options. */
     accessibility?: AccessibilityConfig<N>;
-    /** §9.2 hard scope: feed ONLY the resolved subset through the reconciler;
+    /** hard scope: feed ONLY the resolved subset through the reconciler;
      * null restores full scope. Positions come from the cache; reflow default
      * true restarts the layout around the remainder. */
     subgraph?: SubgraphSpec | null;
-    /** §9.1 soft filter: mask (hide/dim) with ZERO relayout; null clears. */
+    /** soft filter: mask (hide/dim) with ZERO relayout; null clears. */
     filter?: FilterSpec<N, E> | null;
-    /** §16.6 crossfilter dimensions (declarative; brushes live on the session). */
+    /** crossfilter dimensions (declarative; brushes live on the session). */
     crossfilter?: readonly DimensionSpec<N>[];
-    /** §16.3 manual groups; null clears (D2). Config-error with groupBy. */
+    /** manual groups; null clears (D2). Config-error with groupBy. */
     groups?: readonly GroupSpec[] | null;
-    /** §16.3 derived grouping; null clears (D2). Config-error with groups. */
+    /** derived grouping; null clears (D2). Config-error with groups. */
     groupBy?: GroupBySpec<N> | null;
-    /** §16.3 stage-4 non-collapsing layout clusters; null clears (D2). Clusters
+    /** stage-4 non-collapsing layout clusters; null clears (D2). Clusters
      * COEXIST with groups — they preserve every node and edge. */
     clusters?: ClusterSpec<N> | null;
-    /** §16.3 persistent pins (independent of transient drag pinning); null
+    /** persistent pins (independent of transient drag pinning); null
      * clears (D2). Departed ids prune through ownership. */
     pinnedNodeIds?: readonly NodeId[] | null;
-    /** §16.3 parallel-edge grouping toggle: same-pair edges collapse into one
+    /** parallel-edge grouping toggle: same-pair edges collapse into one
      * count-weighted meta-edge. */
     parallelEdgeGrouping?: boolean;
 }
 /** Built-in synchronous metrics plus caller-supplied async column names. */
 type MetricName = 'degree' | 'inDegree' | 'outDegree' | (string & {});
 interface DomainPolicy {
-    /** Domain population. Default 'dataset' (frozen per dataset revision —
+    /** Domain population. Default 'dataset' (frozen per dataset revision
      * masking/isolation never change what a color means). */
     scope?: 'dataset' | 'hard-scope' | 'visible';
     /** Streaming behavior. Default 'freeze-per-revision'; 'expand' permits
@@ -488,7 +488,7 @@ type Scale<T, N = Record<string, unknown>> = {
     mid: number;
     range: readonly [T, T, T];
 };
-/** Async metric column joined against the accepted model (§12). */
+/** Async metric column joined against the accepted model. */
 interface MetricColumn {
     metric: string;
     /** 'ids' joins by the ids array; 'index' is accepted-base positional. */
@@ -496,7 +496,7 @@ interface MetricColumn {
     values: readonly (number | null)[];
     ids?: readonly NodeId[];
     /**
-     * §12/I1 issue-time stamp: the `getRevisions().model` value CURRENT WHEN
+     * Issue-time stamp: the `getRevisions().model` value CURRENT WHEN
      * THE UPDATE CARRYING THIS COLUMN WAS BUILT. Capture it before starting an
      * async computation and deliver it with the result — admission rejects the
      * column (info diagnostic) when the model has moved since, so stale async
@@ -514,7 +514,7 @@ interface GraphTheme {
     labelFg: string;
     accent: string;
     mutedAlpha: number;
-    /** §13 emphasis-ring color (pointer hover, `focusNode`, `emphasizeNode`).
+    /** emphasis-ring color (pointer hover, `focusNode`, `emphasizeNode`).
      * Distinct from `accent` on purpose: accent is the SELECTION highlight, and
      * an emphasized node must not read as selected. */
     emphasisRing: string;
@@ -562,7 +562,7 @@ interface DimensionSpec<N = Record<string, unknown>> {
     /** Stable dimension key (brushes rebase by this key across data updates). */
     key: string;
     kind: DimensionKind;
-    /** Raw value accessor; §8 hygiene applies (non-finite → excluded from bins).
+    /** Raw value accessor; hygiene applies (non-finite → excluded from bins).
      * Temporal accepts epoch-ms numbers, ISO strings, or 'YYYY-MM-DD'. */
     get: (node: GraphNode<N>) => unknown;
     /** Histogram bin count for numeric/temporal (default 24). */
@@ -582,7 +582,7 @@ interface HistogramBin {
     /** Rows in this bin regardless of any mask. */
     total: number;
     /** Rows in this bin passing every OTHER dimension's brush + the filter
-     * prop's node mask (the §16.6 joint "filtered" second layer). */
+     * prop's node mask (the joint "filtered" second layer). */
     filtered: number;
 }
 interface CategoryBin {
@@ -601,7 +601,7 @@ interface DimensionSummary {
     };
     bins: readonly HistogramBin[];
     categories: readonly CategoryBin[];
-    /** Rows excluded by §8 hygiene (non-finite / unparseable). */
+    /** Rows excluded by hygiene (non-finite / unparseable). */
     excludedRows: number;
 }
 interface CrossfilterSession {
@@ -638,7 +638,7 @@ interface SearchResult<N = Record<string, unknown>> {
     label?: string;
     node?: GraphNode<N>;
 }
-/** Why an activated result could not be focused (§16.5 result contract). */
+/** Why an activated result could not be focused. */
 type SearchUnavailableReason = 'not-loaded' | 'out-of-scope' | 'filtered';
 type SearchActivation = {
     status: 'focused';
@@ -648,7 +648,7 @@ type SearchActivation = {
     reason: SearchUnavailableReason;
     result: SearchResult;
 };
-/** Context every async service call receives (§9.2 sequencing rule). */
+/** Context every async service call receives. */
 interface RequestContext {
     datasetKey: string;
     sourceRevision: number | string | null;
@@ -659,7 +659,7 @@ interface RequestContext {
     signal: AbortSignal;
 }
 type RevisionDimension = 'source' | 'model' | 'scope';
-/** A service declares exactly the revision dimensions it consumes (§9.2). */
+/** A service declares exactly the revision dimensions it consumes. */
 interface RevisionAwareService {
     readonly revisionDependencies: readonly RevisionDimension[];
 }
@@ -674,9 +674,9 @@ type ExpansionResponse<N = Record<string, unknown>, E = Record<string, unknown>>
     provenance?: unknown;
 };
 /**
- * §16.2 path resolver seam (S12-T08). `find` resolves the node/edge id path
+ * path resolver seam. `find` resolves the node/edge id path
  * between two loaded nodes or null when unreachable (null is a RESULT, not
- * an error). Extends the §9.2 revision-aware contract: abort is advisory,
+ * an error). Extends the revision-aware contract: abort is advisory,
  * revision admission at delivery is authoritative.
  */
 interface PathService extends RevisionAwareService {
@@ -687,7 +687,7 @@ interface ExpansionService<N = Record<string, unknown>, E = Record<string, unkno
 }
 interface BeginIngestOptions {
     /** 'replace' commits a new source coordinate atomically; 'overlay' advances
-     * only modelRevision and may be progressive (§7.5). */
+     * only modelRevision and may be progressive. */
     purpose: 'replace' | 'overlay';
     datasetKey: string;
     /** Required for 'replace': the source coordinate the commit establishes. */
@@ -707,7 +707,7 @@ interface BeginIngestOptions {
     maxPendingBytes?: number;
 }
 interface IngestBatch<N = Record<string, unknown>, E = Record<string, unknown>> {
-    /** Consecutive, strictly monotonic from zero (§7.5). */
+    /** Consecutive, strictly monotonic from zero. */
     sequence: number;
     /** Idempotency key: an admitted {sequence, batchId} replay returns its
      * original receipt; same sequence + different batchId rejects. */
@@ -734,7 +734,7 @@ interface IngestCommitReceipt {
     sourceRevision?: number | string;
     admittedNodes: number;
     admittedEdges: number;
-    /** Dangling edges dropped at commit (diagnostics emitted only then; §7.5). */
+    /** Dangling edges dropped at commit; diagnostics are emitted only then. */
     danglingEdges: number;
 }
 type IngestSessionState = 'open' | 'committing' | 'committed' | 'aborted';
@@ -745,14 +745,14 @@ interface IngestSession<N = Record<string, unknown>, E = Record<string, unknown>
     commit(): Promise<IngestCommitReceipt>;
     abort(reason?: unknown): Promise<void>;
 }
-/** §14 label lane configuration (zoom-LOD, ranking, forced ids). */
+/** label lane configuration (zoom-LOD, ranking, forced ids). */
 interface LabelConfig<N = Record<string, unknown>> {
     enabled?: boolean;
     /** Labels appear only at/above this zoom (LOD threshold). Default 1. */
     minZoom?: number;
     /**
-     * §16.3 cluster-label LOD ceiling. At or BELOW this zoom the active
-     * `clusters` spec's labels render and NODE labels are suppressed; above it
+     * cluster-label LOD ceiling. At or BELOW this zoom the active
+     * cluster labels render and NODE labels are suppressed; above it
      * cluster labels stop and node-label LOD (`minZoom`) takes over. Absent ⇒
      * no LOD hand-off: cluster labels (when a spec is active) and node labels
      * coexist, each on its own gate.
@@ -760,14 +760,14 @@ interface LabelConfig<N = Record<string, unknown>> {
     maxZoom?: number;
     /** Ranked-candidate cap k (viewport-culled). Default 64, policy max 1024. */
     maxVisible?: number;
-    /** Ids that claim capacity FIRST, bypassing ranking (§14 showLabelsFor). */
+    /** Ids that claim capacity FIRST, bypassing ranking. */
     showFor?: readonly NodeId[];
-    /** Label text; default attrs.label ?? id. Rendered as a TEXT NODE (§14). */
+    /** Label text; default attrs.label ?? id. Rendered as a TEXT NODE. */
     getText?: (node: GraphNode<N>) => string;
     /** Ranking weight; default nodeSize result order, else degree. */
     getWeight?: (node: GraphNode<N>) => number;
 }
-/** §15.1 accessibility runtime options. */
+/** accessibility runtime options. */
 interface AccessibilityConfig<N = Record<string, unknown>> {
     /** Canvas aria-label. Default 'Graph visualization'. */
     label?: string;
@@ -780,13 +780,13 @@ interface AccessibilityConfig<N = Record<string, unknown>> {
     getAccessibleLabel?: (node: GraphNode<N>) => string;
     /**
      * Reduced-motion override: true forces reduced, false forces full motion,
-     * undefined follows the host binding's media-query detection (§15.1).
+     * undefined follows the host binding's media-query detection.
      */
     reducedMotion?: boolean;
 }
-/** One positioned label emitted to the overlay lane per scheduler tick (§14). */
+/** One positioned label emitted to the overlay lane per scheduler tick. */
 interface LabelPlacement {
-    /** Node id — or, for `kind: 'cluster'`, the §16.3 CLUSTER KEY. */
+    /** Node id — or, for `kind: 'cluster'`, the CLUSTER KEY. */
     id: NodeId;
     text: string;
     /** Screen coordinates (CSS px, container-relative). */
@@ -794,10 +794,10 @@ interface LabelPlacement {
     y: number;
     forced: boolean;
     /**
-     * §16.3 placement kind. 'node' (default) anchors to the node's cached
+     * placement kind. 'node' (default) anchors to the node's cached
      * position; 'cluster' anchors to the cluster's force center while the
      * simulation is hot and to its settled centroid afterwards, and selects its
-     * MEMBER node ids when activated (R-16.3-18/21). Ids are drawn from
+     * MEMBER node ids when activated. Ids are drawn from
      * different namespaces, so consumers must key on `(kind, id)`.
      */
     kind?: 'node' | 'cluster';
@@ -808,22 +808,22 @@ interface ViewportState {
     zoom: number;
 }
 type InstanceStatus = 'idle' | 'mounting' | 'ready'
-/** WebGL context lost; engine frozen, CPU model stays live (§13.1). */
+/** WebGL context lost; engine frozen, CPU model stays live. */
  | 'lost'
-/** Context restored; the full-scene replay commit is in flight (§13.1). */
+/** Context restored; the full-scene replay commit is in flight. */
  | 'recovering' | 'destroyed' | 'error';
 /**
- * Namespaced selection (§16.2). Namespaces are independent: node-set algebra
- * never mutates edge selection. `groupIds` is reserved (populated from S12).
+ * Namespaced selection. Namespaces are independent: node-set algebra
+ * never mutates edge selection. `groupIds` is populated by group operations.
  */
 interface SelectionState {
     nodeIds: readonly NodeId[];
     edgeIds: readonly EdgeId[];
     groupIds: readonly string[];
 }
-/** §16.3 manual group definition. Flat and disjoint: membership may not
+/** manual group definition. Flat and disjoint: membership may not
  * nest, overlap, duplicate, self-reference, or name unknown ids — violations
- * are §5.1 config-error diagnostics BEFORE any scene rewrite. */
+ * are config-error diagnostics BEFORE any scene rewrite. */
 interface GroupSpec {
     /** Public group id — its own namespace, never colliding with node ids. */
     id: string;
@@ -833,7 +833,7 @@ interface GroupSpec {
     collapsed?: boolean;
     color?: string;
 }
-/** §16.3 derived grouping: one group per distinct accessor key (null =
+/** derived grouping: one group per distinct accessor key (null =
  * ungrouped). Membership is derived and READ-ONLY; collapsed defaults false
  * so adding groupBy alone changes no rendering. */
 interface GroupBySpec<N = Record<string, unknown>> {
@@ -848,10 +848,10 @@ interface GroupBySpec<N = Record<string, unknown>> {
     };
 }
 /**
- * §16.3 stage-4 non-collapsing layout clusters: a categorical `by` accessor
+ * stage-4 non-collapsing layout clusters: a categorical `by` accessor
  * partitions the PHYSICAL scene (`null` ⇒ unclustered) into force-clustered,
  * centroid-labelled sets. Clusters preserve every node and edge and therefore
- * NEVER synthesize super-nodes or meta-edges (R-16.3-17/19); they coexist with
+ * NEVER synthesize super-nodes or meta-edges; they coexist with
  * groups and re-derive over the post-group-rewrite physical scene.
  */
 interface ClusterSpec<N = Record<string, unknown>> {
@@ -860,11 +860,11 @@ interface ClusterSpec<N = Record<string, unknown>> {
     by: (node: GraphNode<N>) => string | null;
     /** Cluster-force strength handed to the engine. Inert (with ONE loud
      * degradation diagnostic) on engines that do not declare `clusterForce`;
-     * membership, labels, and centroids still work (R-13-39). */
+     * membership, labels, and centroids still work. */
     strength?: number;
     /** Explicit force centers per key, in SPACE coordinates. Keys omitted here
-     * generate deterministically from the ordered keys + layout seed
-     * (R-16.3-20 — see `resolveClusterCenters`). */
+     * generate deterministically from the ordered keys + layout seed; see
+     * `resolveClusterCenters`. */
     centers?: ReadonlyMap<string, readonly [number, number]>;
 }
 /** Resolved cluster surface for overlays/selection (public ids only). */
@@ -875,7 +875,7 @@ interface ResolvedCluster {
     memberIds: readonly NodeId[];
     /** The force center labels anchor to while the simulation is HOT. */
     forceCenter: readonly [number, number];
-    /** Settled centroid from the last permitted §7.1 readback (or the commit
+    /** Settled centroid from the last permitted readback (or the commit
      * under a fixed layout); null until one has landed. */
     centroid: readonly [number, number] | null;
 }
@@ -889,8 +889,8 @@ interface ResolvedGroup {
     derived: boolean;
     color?: string;
 }
-/** §16.3 rerouted member edge on a collapsed group (stage 3), or a grouped
- * parallel-edge bundle (§16.3 R-24). Count is the badge datum. */
+/** rerouted member edge on a collapsed group (stage 3), or a grouped
+ * parallel-edge bundle. Count is the badge datum. */
 interface MetaEdge {
     id: string;
     /** Node id OR group id endpoint (public namespaces). */
@@ -899,7 +899,7 @@ interface MetaEdge {
     /** Underlying (rerouted / collapsed-parallel) edge count. */
     count: number;
 }
-/** §16.2 path query options (PathService). */
+/** path query options (PathService). */
 interface PathOptions {
     /** Edge-direction rule for traversal. Default 'outgoing'. */
     direction?: 'outgoing' | 'incoming' | 'either';
@@ -919,68 +919,68 @@ interface GraphStoreState {
         nodeId: NodeId | null;
         edgeId: EdgeId | null;
     };
-    /** id → pinned space position (§16.3 pin slice; drag-pinning writes here). */
+    /** id → pinned space position. */
     pins: ReadonlyMap<NodeId, readonly [number, number]>;
-    /** §16.3 PERSISTENT pins (S12-T09): ids held at their CURRENT position via
+    /** PERSISTENT pins: ids held at their CURRENT position via
      * engine.setPinnedIndices. Independent lifecycle from the transient
      * drag-pin `pins` slice — the engine receives the UNION; releasing a drag
      * pin on a persistently-pinned node leaves it pinned. No position payload
      * in v0.10: a persistent pin freezes the node wherever it currently is. */
     pinnedNodeIds: ReadonlySet<NodeId>;
     hiddenNodeIds: ReadonlySet<NodeId>;
-    /** Active hard scope (§9.2); null = full scope. */
+    /** Active hard scope; null = full scope. */
     scope: SubgraphSpec | null;
-    /** Soft-mask visibility counts (§9.1): RENDERED SCENE entities with zero
-     * hide-failures — the §16.3 synthetic suffix INCLUDED, so a collapsed
+    /** Soft-mask visibility counts: RENDERED SCENE entities with zero
+     * hide-failures — the synthetic suffix INCLUDED, so a collapsed
      * group contributes its one drawn super-node. Equals nodeCount/edgeCount
      * when nothing masks, scopes, or groups.
      *
      * NOT the same question as `getVisibleNodeIds()`, which lists PUBLIC
-     * physical ids only (§7.4). Pair a count with that list via
+     * physical ids only. Pair a count with that list via
      * `getVisibleNodeIds().length`; use `visible` for "how much is on screen". */
     visible: {
         nodes: number;
         edges: number;
     };
-    /** Timeline playback state (§16.6): at most one playing dimension. */
+    /** Timeline playback state: at most one playing dimension. */
     timeline: {
         playingKey: string | null;
     };
-    /** §16.14 history kernel depths (S9-T20; full walk semantics in S15). */
+    /** history kernel depths. */
     history: {
         undoDepth: number;
         redoDepth: number;
     };
-    /** Node ids with an expansion in flight (§9.2 loading affordance). */
+    /** Node ids with an expansion in flight. */
     pendingExpansions: ReadonlySet<NodeId>;
     /**
-     * §16.3 node folds: anchor id → how many members it stands for. Empty when
+     * node folds: anchor id → how many members it stands for. Empty when
      * nothing is folded.
      *
      * Published so folds are OBSERVABLE. A fold changes neither an anchor's id
-     * nor its label text, so the §14 label lane — which re-renders content only
+     * nor its label text, so the label lane — which re-renders content only
      * when the candidate SET changes — would otherwise never re-render a badge
      * that depends on fold state. Subscribing to this slice is how a host keeps
      * fold-derived chrome (badges, affordances) in step.
      */
     folds: ReadonlyMap<NodeId, number>;
-    /** Committed overlay ids for the current dataset (§7.5). */
+    /** Committed overlay ids for the current dataset. */
     overlayIds: readonly string[];
-    /** §16.3 resolved groups (manual or groupBy-derived); [] when ungrouped.
+    /** resolved groups (manual or groupBy-derived); [] when ungrouped.
      * Path highlight is deliberately NOT here: session-local, never
-     * serialized (§16.2). */
+     * serialized. */
     groups: readonly ResolvedGroup[];
-    /** Last completed search (§16.5): feeds <GraphSearch> and the §15.1
+    /** Last completed search: feeds <GraphSearch> and the
      * navigator's search-results section. Cleared on datasetKey change. */
     search: {
         query: string;
         results: readonly SearchResult[];
     } | null;
     viewport: ViewportState | null;
-    /** §14/§16.1: live force-simulation activity — true after a commit with
-     * restart or resumeSimulation(); false on settle or pauseSimulation(). */
+    /** Live force-simulation activity — true after a commit with
+     * restart or resumeSimulation; false on settle or pauseSimulation. */
     simulationRunning: boolean;
-    /** §8 resolved theme tokens (S10): the merged GraphTheme currently driving
+    /** Resolved theme tokens: the merged GraphTheme currently driving
      * engine config, projection fallbacks, and mask dim alpha. Published on
      * change; defaults to the dark base. */
     theme: GraphTheme;
@@ -992,10 +992,10 @@ interface GraphListenerControl {
 interface NodeEventPayload<N = Record<string, unknown>> {
     node: GraphNode<N>;
 }
-/** §13 engine buffer channels. Canonical home (engine/index.ts re-exports —
+/** engine buffer channels. Canonical home (engine/index.ts re-exports
  * the engine seam imports from types, never the reverse). */
 type EngineBufferChannel = 'pointPosition' | 'link' | 'pointColor' | 'pointSize' | 'linkColor' | 'linkWidth';
-/** §17 performance snapshot — NEVER carries raw attrs or ids (§17). */
+/** performance snapshot — NEVER carries raw attrs or ids. */
 interface GraphPerfSnapshot {
     at: number;
     nodeCount: number;
@@ -1026,16 +1026,16 @@ interface GraphPerfSnapshot {
     activeDegradations: readonly DegradeStep[];
     execution: 'main' | 'worker';
     rangeUpdates: readonly EngineBufferChannel[];
-    /** §17 pressure-sampler mirror (S13-T07): EWMA of per-window mean frame
-     * deltas, dropped-frame count, and idle wakeups since the last sample —
-     * 0 idle wakeups is the healthy reading under the ADR-005 gated clock. */
+    /** pressure-sampler mirror: EWMA of per-window mean frame
+     * deltas, dropped-frame count, and idle wakeups since the last sample.
+     * Zero idle wakeups is the healthy reading under the gated activity clock. */
     pressure: {
         frameEwmaMs: number;
         droppedFrames: number;
         idleWakeups: number;
     };
 }
-/** §17/§6.1 `limits` — construction-time thresholds for the ladder (D7:
+/** `limits` — construction-time thresholds for the ladder (construction-only:
  * read once; a runtime change warns and is ignored). */
 interface ScaleLimits {
     /** Default 100_000. */
@@ -1050,7 +1050,7 @@ interface ScaleLimits {
     minimumDwellMs: number;
     /** Resource steps in engagement order. `uniform-link-style` participates
      * ONLY when explicitly listed — it can erase data-encoded styling, so
-     * omission means resource admission rejects instead (§17). */
+     * omission means resource admission rejects instead. */
     resourceDegradationOrder: readonly ResourceDegradeStep[];
 }
 type ResourceDegradeStep = 'disable-transitions' | 'defer-images' | 'uniform-link-style';
@@ -1065,10 +1065,10 @@ interface DegradeEvent {
     };
 }
 interface GraphEventMap<N = Record<string, unknown>, E = Record<string, unknown>> {
-    /** §17 throttled telemetry sample — never per frame (S13-T07). */
+    /** throttled telemetry sample — never per frame. */
     perfSample: GraphPerfSnapshot;
-    /** §17 ladder step engagement/disengagement (S13-T08). Notification
-     * pattern, not §6.4-controlled. */
+    /** Ladder step engagement/disengagement. This is a notification pattern,
+     * not a controlled state lane. */
     degrade: DegradeEvent;
     nodeClick: NodeEventPayload<N> & {
         metaKey?: boolean;
@@ -1090,14 +1090,14 @@ interface GraphEventMap<N = Record<string, unknown>, E = Record<string, unknown>
         x: number;
         y: number;
     };
-    /** §16.14: a setViewState dataRef mismatch — fired INSTEAD of applying.
+    /** a setViewState dataRef mismatch — fired INSTEAD of applying.
      * Restoration proceeds only when the caller re-invokes with the opt-in. */
     viewStateMismatch: {
         stored: JsonValue | undefined;
         current: JsonValue | undefined;
     };
-    /** §16.14 aggregate restore intent: fired ONCE per restore/history
-     * transaction touching any §6.4 controlled slice or serialized styling —
+    /** aggregate restore intent: fired ONCE per restore/history
+     * transaction touching any controlled slice or serialized styling
      * never fanned out per lane. The host reflects every participating prop in
      * one commit; the transaction commits when the reflected values match, and
      * times out / diverges / supersedes as typed results otherwise. `next` is
@@ -1120,7 +1120,7 @@ interface GraphEventMap<N = Record<string, unknown>, E = Record<string, unknown>
     };
     viewportChange: ViewportState;
     selectionChange: SelectionState;
-    /** §16.3/§7.4 (R-16.3-12): a super-node hit carries the resolved GROUP —
+    /** A super-node hit carries the resolved GROUP
      * never a GraphNode, never an internal scene key. Built-in follow-up
      * selects the group id into SelectionState.groupIds (preventDefault
      * cancels it, mirroring nodeClick). */
@@ -1128,31 +1128,31 @@ interface GraphEventMap<N = Record<string, unknown>, E = Record<string, unknown>
         group: ResolvedGroup;
         metaKey?: boolean;
     };
-    /** §16.3/§7.4: a meta-edge hit carries the MetaEdge record (public
+    /** A meta-edge hit carries the MetaEdge record (public
      * endpoint ids + the underlying count badge datum). No built-in follow-up. */
     metaEdgeClick: {
         metaEdge: MetaEdge;
     };
-    /** §6.4 groups slice change: op results (uncontrolled), op intents
+    /** groups slice change: op results (uncontrolled), op intents
      * (controlled — the host reflects the array back through the `groups`
      * prop), and groupBy re-derivations (notification; groupBy is always
-     * instance-derived, R-16.3-16). Host `groups` prop writes and manual
+     * instance-derived). Host `groups` prop writes and manual
      * model-drift re-resolutions are store-only and do NOT fire this. */
     groupsChange: {
         groups: readonly ResolvedGroup[];
     };
-    /** §6.4 persistent-pin slice change (S12-T09), the groups-latch mirror:
+    /** persistent-pin slice change, the groups-latch mirror:
      * op results (uncontrolled) and op INTENTS (controlled — the host
      * reflects the array back through the `pinnedNodeIds` prop). Host prop
      * writes and model-drift prunes are store-only and do NOT fire this. */
     pinnedChange: {
         pinnedNodeIds: readonly NodeId[];
     };
-    /** §16.3 effective-set reporting seam (S12-T03): retractExpansion fires this
+    /** effective-set reporting seam: retractExpansion fires this
      * with the NEXT effective set as a SubgraphSpec whenever a collapse
      * changed what is displayed. v0.10 keeps `subgraph` UNCONTROLLED-ONLY, so
      * this is a notification today; a future controlled subgraph mode turns
-     * it into the §6.4 intent without changing the payload shape. */
+     * it into the intent without changing the payload shape. */
     subgraphChange: {
         subgraph: SubgraphSpec;
     };
@@ -1166,19 +1166,19 @@ interface GraphEventMap<N = Record<string, unknown>, E = Record<string, unknown>
 type GraphEventName = keyof GraphEventMap;
 
 /**
- * GraphEngine adapter contract (spec §13, v0.1 subset).
+ * GraphEngine adapter contract.
  *
  * The core drives any engine exclusively through this interface; cosmos.gl is
  * the first implementation and lives in @modernrelay/orbit-engine-cosmos — the
- * only package allowed to import it. FakeEngine (core /testing) implements the
+ * only package allowed to import it. FakeEngine from the core testing entry implements the
  * same contract headlessly.
  *
  * v0.1 subset decisions:
- *  - Buffer updates are full-channel replaces, or RANGED patches for the
- *    channels an engine declares in `capabilities.rangeUpdates` (S13-T04).
- *  - One visibly atomic update per EngineCommit (§13): the adapter applies all
- *    channels/config of a commit before the next drawn frame.
- *  - Position readback (`getPositions`) is per-event only, never per-tick (§7.1/§17).
+ * - Buffer updates are full-channel replaces, or RANGED patches for the
+ * channels an engine declares in `capabilities.rangeUpdates`.
+ * - One visibly atomic update per EngineCommit: the adapter applies all
+ * channels/config of a commit before the next drawn frame.
+ * - Position readback (`getPositions`) is per-event only, never per-tick.
  */
 
 interface EngineCapabilities {
@@ -1186,30 +1186,30 @@ interface EngineCapabilities {
     linkPicking: boolean;
     /** Channels supporting ranged (partial) updates. Empty in v0.1 for cosmos. */
     rangeUpdates: readonly EngineBufferChannel[];
-    /** O(k) tracked-subset position readback per frame (§13). */
+    /** O(k) tracked-subset position readback per frame. */
     trackedPositions: boolean;
     /** Engine runs a live GPU force simulation. */
     simulation: boolean;
-    /** Instanced directional arrowheads on links (§16.12). */
+    /** Instanced directional arrowheads on links. */
     edgeArrows?: boolean;
-    /** Per-point image sprites via a texture atlas (§8). */
+    /** Per-point image sprites via a texture atlas. */
     pointImages?: boolean;
-    /** §16.3 cluster force: per-point cluster assignment with optional
-     * strength/centers (S12). Engines without it degrade loudly — membership,
-     * labels, and centroids still work (R-13-39). */
+    /** cluster force: per-point cluster assignment with optional
+     * strength/centers. Engines without it degrade loudly — membership,
+     * labels, and centroids still work. */
     clusterForce?: boolean;
-    /** §17 frame-loop idle behavior: 'stops' = zero rAF at rest (quiescent,
+    /** frame-loop idle behavior: 'stops' = zero rAF at rest (quiescent,
      * the stop-at-rest target); 'free-running' = the engine burns rAF while
      * idle — a documented degradation, not a violation. Absent reads as
      * 'free-running' (conservative). */
     idleFrames?: 'stops' | 'free-running';
-    /** §13/§17 onFrame phase: true = exact post-draw; false/absent = an
-     * activity clock (overlays may lag one sample — ADR-002). This field
+    /** onFrame phase: true = exact post-draw; false/absent = an
+     * activity clock (overlays may lag one sample). This field
      * makes the previously prose-only declaration real. */
     postDrawFrames?: boolean;
 }
 interface EngineConfigUpdate {
-    /** §16.3 stage-4 cluster force (capability `clusterForce`; inert
+    /** stage-4 cluster force (capability `clusterForce`; inert
      * otherwise). null clears. `pointClusters` maps point index → cluster
      * ordinal (aligned to `centers` pairs). */
     cluster?: {
@@ -1221,18 +1221,18 @@ interface EngineConfigUpdate {
     simulation?: SimulationConfig;
     /** Space-coordinate defaults used when seeding unknown (NaN) positions. */
     seedRadius?: number;
-    /** §16.12 arrowheads on/off (capability edgeArrows; inert otherwise). */
+    /** arrowheads on/off (capability edgeArrows; inert otherwise). */
     linkArrows?: boolean;
-    /** §16.13 link visibility toggle — config-only, never a buffer rebuild. */
+    /** link visibility toggle — config-only, never a buffer rebuild. */
     renderLinks?: boolean;
-    /** Engine-relevant §8 theme tokens beyond background. */
+    /** Engine-relevant theme tokens beyond background. */
     defaultPointColor?: string;
     defaultLinkColor?: string;
-    /** §13 emphasis-ring color (cosmos: `focusedPointRingColor`). No capability
+    /** emphasis-ring color (cosmos: `focusedPointRingColor`). No capability
      * gate: `setFocusedIndex` is a required engine member, so every engine has
      * the mechanism — one that ignores the COLOR degrades to its own default. */
     emphasisRingColor?: string;
-    /** §17 disable-transitions ladder step (S13-T09): 0 = atomic jumps;
+    /** disable-transitions ladder step: 0 = atomic jumps;
      * null = restore the engine's own default duration. Engines without
      * transitions ignore it. */
     transitionDurationMs?: number | null;
@@ -1269,12 +1269,12 @@ interface EngineCommit {
         linkWidth: Float32Array;
     }>;
     /**
-     * S13-T04 ranged channel updates — ONLY for channels the engine declared
+     * ranged channel updates — ONLY for channels the engine declared
      * in `capabilities.rangeUpdates`, and only AFTER that channel has been
      * seeded by at least one full-buffer commit. A channel appears in
      * `buffers` OR here in one commit, never both. `start` is in ELEMENT
      * units of the channel's layout (RGBA floats for color channels). Patch
-     * `data` views are valid only during `commit()` — same lifetime contract
+     * `data` views are valid only during `commit` — same lifetime contract
      * as full buffers.
      */
     bufferPatches?: Partial<{
@@ -1284,7 +1284,7 @@ interface EngineCommit {
         linkWidth: readonly BufferPatch[];
     }>;
     config?: EngineConfigUpdate;
-    /** §8 image-atlas resource updates (capability pointImages); applied
+    /** image-atlas resource updates (capability pointImages); applied
      * atomically with the same commit's buffers. */
     resources?: {
         imageAtlas?: {
@@ -1303,7 +1303,7 @@ interface EngineCommit {
     } | false;
 }
 /**
- * WebGL context lifecycle events (§13.1). `restored` means the adapter has a
+ * WebGL context lifecycle events. `restored` means the adapter has a
  * fresh, empty, commit-ready GL machine in the same container — the core then
  * re-commits the scene. `failed` is terminal reinitialization failure.
  */
@@ -1315,14 +1315,14 @@ type EngineContextEvent = {
     type: 'failed';
     error: Error;
 };
-/** Adapter observability channel; codes are namespaced `engine:*` (§6.5). */
+/** Adapter observability channel; codes are namespaced `engine:*`. */
 interface EngineDiagnostic {
     code: `engine:${string}`;
     severity: DiagnosticSeverity;
     message: string;
 }
-/** Events the engine reports up to the core (indices are engine-local; the
- * core maps them back to typed objects — §7.4). */
+/** Events the engine reports to core. Indices are engine-local; core maps
+ * them back to typed objects. */
 interface EngineHostEvents {
     onPointClick?(index: number | null, modifiers?: {
         metaKey: boolean;
@@ -1332,13 +1332,13 @@ interface EngineHostEvents {
     /** Native link picking (capability `linkPicking`); indices are link-local. */
     onLinkClick?(linkIndex: number): void;
     onLinkHover?(linkIndex: number | null): void;
-    /** Native point drag (space coords). The core owns pin semantics (§16.3). */
+    /** Native point drag (space coords). The core owns pin semantics. */
     onDragStart?(index: number): void;
     onDragEnd?(index: number, x: number, y: number): void;
     /** Context-menu gesture (right-click / touch long-press); null = background. */
     onContextMenu?(index: number | null, screen: readonly [number, number]): void;
     /**
-     * Overlay/activity clock (§13/§17): the adapter's per-frame callback for the
+     * Overlay/activity clock: the adapter's per-frame callback for the
      * core scheduler's fan-out (DOM labels, tooltips). Under
      * `postDrawFrames:false` engines this is an activity clock — overlays may
      * lag the canvas by one sample; the adapter reports that degradation once.
@@ -1358,7 +1358,7 @@ interface GraphEngine {
     readonly capabilities: EngineCapabilities;
     /** Mount into a container. Resolve when the first frame can be produced. */
     mount(container: HTMLElement, events: EngineHostEvents): Promise<void>;
-    /** Apply one atomic update (§13). Throws only on programmer error. */
+    /** Apply one atomic update. Throws only on programmer error. */
     commit(update: EngineCommit): void;
     /** Highest commit revision that is visibly applied. */
     appliedRevision(): number | null;
@@ -1378,7 +1378,7 @@ interface GraphEngine {
     pointsInPolygon?(screenPolygon: readonly [number, number][]): number[];
     /** Point indices inside a SCREEN-coordinate rect [x0,y0,x1,y1] (label cull). */
     pointsInRect?(screenRect: readonly [number, number, number, number]): number[];
-    /** Capture the current frame as an image (toolbar screenshot; §16.1). */
+    /** Capture the current frame as an image for toolbar screenshots and exports. */
     captureScreenshot?(): Promise<Blob | null>;
     /** 1-hop neighbor point indices (engine adjacency, if available). */
     neighborIndices?(index: number): number[];
@@ -1392,4 +1392,4 @@ interface GraphEngine {
 /** Engine factory the host passes in; called once per instance mount. */
 type EngineFactory = () => GraphEngine;
 
-export { type AccessibilityConfig as $, type AcceptedGraph as A, type BeginIngestOptions as B, type GraphEventMap as C, type GraphListenerControl as D, type EngineCapabilities as E, type FitViewOptions as F, type GraphEngine as G, type EdgeId as H, type IngestSession as I, type JsonValue as J, type GraphPerfSnapshot as K, type LabelPlacement as L, type MetaEdge as M, type NodeId as N, type ResolvedCluster as O, type PathService as P, type PathOptions as Q, type ResolvedGroup as R, type SceneFold as S, type PathResult as T, type SearchActivation as U, type ViewportState as V, type CrossfilterSession as W, type TimelinePlayback as X, type Scale as Y, type MetricName as Z, type Revisions as _, type EngineCommit as a, type ThemeInput as a0, type LabelConfig as a1, type IngestBatch as a2, type RevisionDimension as a3, type FilterSpec as a4, type FilterExpr as a5, type DimensionSpec as a6, type BrushState as a7, type DimensionSummary as a8, type DomainPolicy as a9, type InstanceStatus as aA, type LayoutKind as aB, type NodeEventPayload as aC, OrbitOperationError as aD, type ResourceAdmissionReport as aE, type ResourceDegradeStep as aF, type SearchUnavailableReason as aG, type SimulationConfig as aH, type StringColumn as aI, graphErrorToError as aJ, isFatalGraphError as aK, resourceLimitFatal as aL, type BufferPatch as aM, type EngineConfigUpdate as aN, type EngineContextEvent as aO, type EngineBufferChannel as aa, type MetricColumn as ab, type ColumnarGraphSnapshot as ac, type GraphSnapshotInput as ad, type AppendReceipt as ae, type CategoryBin as af, type ClusterSpec as ag, type Column as ah, type ColumnChange as ai, DIAGNOSTIC_SAMPLE_CAP as aj, type DegradeEvent as ak, type DegradeStep as al, type DiagnosticCode as am, type DiagnosticSeverity as an, type DimensionKind as ao, type ErrorPhase as ap, type ExpansionBatch as aq, type ExpansionResponse as ar, type FilterMode as as, type FilterValue as at, type GraphEdge as au, type GraphError as av, type GraphOperationError as aw, type HistogramBin as ax, type IngestCommitReceipt as ay, type IngestSessionState as az, type EngineHostEvents as b, type EngineDiagnostic as c, type GraphDiagnostic as d, type GraphNode as e, type GraphSnapshot as f, type AcceptedEdge as g, type GroupSpec as h, type GroupBySpec as i, type SceneGroups as j, type RenderScene as k, type SceneLinkRef as l, type ScenePointRef as m, type Accessor as n, type RevisionAwareService as o, type RequestContext as p, type SearchResult as q, type SelectionState as r, type SubgraphSpec as s, type EngineFactory as t, type ExpansionService as u, type ScaleLimits as v, type GraphTheme as w, type GraphStoreState as x, type GraphHostUpdate as y, type GraphEventName as z };
+export { type FilterExpr as $, type AcceptedGraph as A, type BeginIngestOptions as B, type PathOptions as C, type PathResult as D, type EngineFactory as E, type SearchActivation as F, type GraphSnapshot as G, type CrossfilterSession as H, type IngestSession as I, type JsonValue as J, type Scale as K, type LabelPlacement as L, type MetaEdge as M, type NodeId as N, type MetricName as O, type PathService as P, type Revisions as Q, type ResolvedGroup as R, type SceneFold as S, type TimelinePlayback as T, type AccessibilityConfig as U, type ViewportState as V, type ThemeInput as W, type LabelConfig as X, type IngestBatch as Y, type RevisionDimension as Z, type FilterSpec as _, type GraphDiagnostic as a, type DimensionSpec as a0, type BrushState as a1, type DimensionSummary as a2, type DomainPolicy as a3, type EngineBufferChannel as a4, type GraphEngine as a5, type EngineCommit as a6, type EngineCapabilities as a7, type MetricColumn as a8, type ColumnarGraphSnapshot as a9, OrbitOperationError as aA, type ResourceAdmissionReport as aB, type ResourceDegradeStep as aC, type SearchUnavailableReason as aD, type SimulationConfig as aE, type StringColumn as aF, graphErrorToError as aG, isFatalGraphError as aH, resourceLimitFatal as aI, type EngineHostEvents as aJ, type FitViewOptions as aK, type EngineDiagnostic as aL, type BufferPatch as aM, type EngineConfigUpdate as aN, type EngineContextEvent as aO, type GraphSnapshotInput as aa, type AppendReceipt as ab, type CategoryBin as ac, type ClusterSpec as ad, type Column as ae, type ColumnChange as af, DIAGNOSTIC_SAMPLE_CAP as ag, type DegradeEvent as ah, type DegradeStep as ai, type DiagnosticCode as aj, type DiagnosticSeverity as ak, type DimensionKind as al, type ErrorPhase as am, type ExpansionBatch as an, type ExpansionResponse as ao, type FilterMode as ap, type FilterValue as aq, type GraphEdge as ar, type GraphError as as, type GraphOperationError as at, type HistogramBin as au, type IngestCommitReceipt as av, type IngestSessionState as aw, type InstanceStatus as ax, type LayoutKind as ay, type NodeEventPayload as az, type GraphNode as b, type AcceptedEdge as c, type GroupSpec as d, type GroupBySpec as e, type SceneGroups as f, type RenderScene as g, type SceneLinkRef as h, type ScenePointRef as i, type Accessor as j, type RevisionAwareService as k, type RequestContext as l, type SearchResult as m, type SelectionState as n, type SubgraphSpec as o, type ExpansionService as p, type ScaleLimits as q, type GraphTheme as r, type GraphStoreState as s, type GraphHostUpdate as t, type GraphEventName as u, type GraphEventMap as v, type GraphListenerControl as w, type EdgeId as x, type GraphPerfSnapshot as y, type ResolvedCluster as z };