@modernrelay/orbit-core 0.13.6 → 0.15.0

package/dist/{index-BoQfS8jd.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[];