@fundamental-engine/dom 0.7.0

package/dist/thread-overlay.d.ts

@@ -0,0 +1,63 @@
+/**
+ * threadOverlay — the hover-thread SVG overlay extracted from the invisible-fields example
+ * runtimes (the `wireThreads`/`centerIn` pattern in the Evidence page, adapted by the Backlog
+ * board and the Dependencies spill). Three hand-rolled copies drew the same picture; this is
+ * the common core: an absolutely-positioned, `aria-hidden`, pointer-events-none SVG prepended
+ * into a host, with one cubic-bezier path per (from → target) edge and the family's `lit` /
+ * `cited` class marks on the endpoints.
+ *
+ * GEOMETRY + CLASSES ONLY — no event wiring. The pages own hover semantics (pointerenter →
+ * `draw`, pointerleave → `clear`), reveal pacing, and color choice; this primitive owns the
+ * SVG lifecycle and the math.
+ *
+ * The CSS contract (what the three pages already style, unchanged):
+ *   - the overlay carries `opts.className` (default `field-threads`; the example family passes
+ *     `ev-threads`) — pages style `.<className> path { stroke: var(--thread, …); fill: none; }`.
+ *   - `draw(…, { color })` sets the overlay's `--thread` custom property; omitting `color`
+ *     removes it, so the page's `var(--thread, fallback)` fallback shows.
+ *   - the hovered element gains `.lit`, each resolved target gains `.cited`; `clear()` removes
+ *     both from everything this overlay marked.
+ *   - inline geometry (position:absolute; inset:0; width/height:100%; pointer-events:none) is
+ *     written on creation so the overlay covers the host before page CSS loads. The HOST must
+ *     be a containing block (`position: relative` or similar) — that part stays page CSS.
+ *
+ * Coordinates are host-relative (the `centerIn` math): the viewBox is sized from the host's
+ * current rect at each `draw`, and every path runs center-to-center through the family's
+ * midpoint-y cubic — `M ax ay C ax my, bx my, bx by` with `my = (ay + by) / 2`.
+ *
+ * Geometry is sampled AT DRAW TIME and not observed afterwards: callers must re-draw (or
+ * `clear()`) after layout changes — FLIP re-sorts, batch reveals, container resize. The
+ * example pages clear on re-sort and re-draw on the next hover; that discipline is the
+ * caller's.
+ *
+ * SSR-safe: construction touches no globals (the SVG is created lazily via
+ * `host.ownerDocument` on first `draw`); `clear()`/`destroy()` are no-ops before that.
+ */
+export interface ThreadOverlayOptions {
+    /** class for the overlay SVG (default `field-threads`; the example family uses `ev-threads`). */
+    className?: string;
+}
+export interface ThreadDrawOptions {
+    /** value for the overlay's `--thread` custom property (the stroke channel pages style against). Omitted → the property is removed and the page's CSS fallback applies. */
+    color?: string;
+}
+export interface ThreadOverlay {
+    /**
+     * Draw one thread per target: host-relative center-to-center cubic beziers from `from`,
+     * marking `from` with `.lit` and each target with `.cited`. Replaces the previous draw
+     * (paths and class marks). Reads layout — call outside the platform's write phase.
+     */
+    draw(from: HTMLElement, targets: readonly HTMLElement[], opts?: ThreadDrawOptions): void;
+    /** Empty the overlay's paths and remove every `lit`/`cited` mark this overlay applied. */
+    clear(): void;
+    /** `clear()` + remove the SVG from the host. `clear()` is a no-op afterwards; a later `draw()` recreates the overlay. */
+    destroy(): void;
+}
+/**
+ * Create (or adopt) a thread overlay on `host`. If a `svg.<className>` already exists in the
+ * host it is reused — so a page that server-renders the overlay shell, or re-inits its
+ * runtime, never stacks duplicates. Otherwise the SVG is created lazily on the first `draw`
+ * and PREPENDED (the evidence pattern: threads paint under the host's content in DOM order).
+ */
+export declare function threadOverlay(host: HTMLElement, opts?: ThreadOverlayOptions): ThreadOverlay;
+//# sourceMappingURL=thread-overlay.d.ts.map

package/dist/thread-overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-overlay.d.ts","sourceRoot":"","sources":["../src/thread-overlay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAIH,MAAM,WAAW,oBAAoB;IACnC,iGAAiG;IACjG,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,0KAA0K;IAC1K,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,WAAW,EAAE,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACzF,0FAA0F;IAC1F,KAAK,IAAI,IAAI,CAAC;IACd,yHAAyH;IACzH,OAAO,IAAI,IAAI,CAAC;CACjB;AAQD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,GAAE,oBAAyB,GAAG,aAAa,CA8D/F"}

package/dist/thread-overlay.js

@@ -0,0 +1,110 @@
+/**
+ * threadOverlay — the hover-thread SVG overlay extracted from the invisible-fields example
+ * runtimes (the `wireThreads`/`centerIn` pattern in the Evidence page, adapted by the Backlog
+ * board and the Dependencies spill). Three hand-rolled copies drew the same picture; this is
+ * the common core: an absolutely-positioned, `aria-hidden`, pointer-events-none SVG prepended
+ * into a host, with one cubic-bezier path per (from → target) edge and the family's `lit` /
+ * `cited` class marks on the endpoints.
+ *
+ * GEOMETRY + CLASSES ONLY — no event wiring. The pages own hover semantics (pointerenter →
+ * `draw`, pointerleave → `clear`), reveal pacing, and color choice; this primitive owns the
+ * SVG lifecycle and the math.
+ *
+ * The CSS contract (what the three pages already style, unchanged):
+ *   - the overlay carries `opts.className` (default `field-threads`; the example family passes
+ *     `ev-threads`) — pages style `.<className> path { stroke: var(--thread, …); fill: none; }`.
+ *   - `draw(…, { color })` sets the overlay's `--thread` custom property; omitting `color`
+ *     removes it, so the page's `var(--thread, fallback)` fallback shows.
+ *   - the hovered element gains `.lit`, each resolved target gains `.cited`; `clear()` removes
+ *     both from everything this overlay marked.
+ *   - inline geometry (position:absolute; inset:0; width/height:100%; pointer-events:none) is
+ *     written on creation so the overlay covers the host before page CSS loads. The HOST must
+ *     be a containing block (`position: relative` or similar) — that part stays page CSS.
+ *
+ * Coordinates are host-relative (the `centerIn` math): the viewBox is sized from the host's
+ * current rect at each `draw`, and every path runs center-to-center through the family's
+ * midpoint-y cubic — `M ax ay C ax my, bx my, bx by` with `my = (ay + by) / 2`.
+ *
+ * Geometry is sampled AT DRAW TIME and not observed afterwards: callers must re-draw (or
+ * `clear()`) after layout changes — FLIP re-sorts, batch reveals, container resize. The
+ * example pages clear on re-sort and re-draw on the next hover; that discipline is the
+ * caller's.
+ *
+ * SSR-safe: construction touches no globals (the SVG is created lazily via
+ * `host.ownerDocument` on first `draw`); `clear()`/`destroy()` are no-ops before that.
+ */
+const SVG_NS = 'http://www.w3.org/2000/svg';
+/** An element's center in host-rect coordinates (the family's `centerIn`). */
+function centerIn(el, hostRect) {
+    const r = el.getBoundingClientRect();
+    return { x: r.left - hostRect.left + r.width / 2, y: r.top - hostRect.top + r.height / 2 };
+}
+/**
+ * Create (or adopt) a thread overlay on `host`. If a `svg.<className>` already exists in the
+ * host it is reused — so a page that server-renders the overlay shell, or re-inits its
+ * runtime, never stacks duplicates. Otherwise the SVG is created lazily on the first `draw`
+ * and PREPENDED (the evidence pattern: threads paint under the host's content in DOM order).
+ */
+export function threadOverlay(host, opts = {}) {
+    const className = opts.className ?? 'field-threads';
+    const selector = 'svg.' + className.trim().split(/\s+/).join('.');
+    let svg = null;
+    const marked = new Set();
+    const ensure = () => {
+        if (svg)
+            return svg;
+        svg = host.querySelector(selector);
+        if (!svg) {
+            svg = host.ownerDocument.createElementNS(SVG_NS, 'svg');
+            svg.setAttribute('class', className);
+            svg.setAttribute('aria-hidden', 'true');
+            // cover the host even before page CSS loads; the host supplies the containing block.
+            svg.style.setProperty('position', 'absolute');
+            svg.style.setProperty('inset', '0');
+            svg.style.setProperty('width', '100%');
+            svg.style.setProperty('height', '100%');
+            svg.style.setProperty('pointer-events', 'none');
+            host.prepend(svg);
+        }
+        return svg;
+    };
+    const unmark = () => {
+        for (const el of marked)
+            el.classList.remove('lit', 'cited');
+        marked.clear();
+    };
+    const draw = (from, targets, drawOpts = {}) => {
+        const overlay = ensure();
+        unmark();
+        const box = host.getBoundingClientRect();
+        overlay.setAttribute('viewBox', `0 0 ${box.width} ${box.height}`);
+        if (drawOpts.color != null && drawOpts.color !== '')
+            overlay.style.setProperty('--thread', drawOpts.color);
+        else
+            overlay.style.removeProperty('--thread');
+        const a = centerIn(from, box);
+        from.classList.add('lit');
+        marked.add(from);
+        let d = '';
+        for (const t of targets) {
+            t.classList.add('cited');
+            marked.add(t);
+            const b = centerIn(t, box);
+            const my = (a.y + b.y) / 2;
+            d += `<path d="M${a.x} ${a.y} C ${a.x} ${my}, ${b.x} ${my}, ${b.x} ${b.y}"/>`;
+        }
+        overlay.innerHTML = d;
+    };
+    const clear = () => {
+        if (svg)
+            svg.innerHTML = '';
+        unmark();
+    };
+    const destroy = () => {
+        clear();
+        svg?.remove();
+        svg = null;
+    };
+    return { draw, clear, destroy };
+}
+//# sourceMappingURL=thread-overlay.js.map

package/dist/thread-overlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-overlay.js","sourceRoot":"","sources":["../src/thread-overlay.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @fundamental-engine/dom — shared contracts for the platform-adjacent registries. These describe the
+ * native primitives Fundamental wishes the browser had (frame-stable geometry, typed element state,
+ * relationships, visual-semantic pairing) built on the ones it has. Pure data shapes; no DOM here.
+ */
+/** A measured rectangle in a coordinate space, with the centre precomputed. */
+export interface FieldRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    cx: number;
+    cy: number;
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+export type CoordinateSpace = 'viewport' | 'document' | 'field-root' | 'canvas';
+/** One element's frame-stable measurement. */
+export interface FieldMeasurement {
+    element: Element;
+    rect: FieldRect;
+    visible: boolean;
+    /** fraction of the element's area within the viewport, ∈ [0,1]. */
+    visibilityRatio: number;
+    coordinateSpace: CoordinateSpace;
+    /** the frame time this snapshot was taken. */
+    timestamp: number;
+}
+/** A typed, observable element state value — numeric/boolean/string/vector2 (NOT ARIA). */
+export type FieldStateValue = {
+    type: 'number';
+    value: number;
+} | {
+    type: 'boolean';
+    value: boolean;
+} | {
+    type: 'string';
+    value: string;
+} | {
+    type: 'vector2';
+    x: number;
+    y: number;
+};
+/** A viewport box for visibility computation (so measurement is testable without a window). */
+export interface Viewport {
+    width: number;
+    height: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,+EAA+E;AAC/E,MAAM,WAAW,SAAS;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,QAAQ,CAAC;AAEhF,8CAA8C;AAC9C,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,mEAAmE;IACnE,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,eAAe,CAAC;IACjC,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,2FAA2F;AAC3F,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9C,+FAA+F;AAC/F,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * @fundamental-engine/dom — shared contracts for the platform-adjacent registries. These describe the
+ * native primitives Fundamental wishes the browser had (frame-stable geometry, typed element state,
+ * relationships, visual-semantic pairing) built on the ones it has. Pure data shapes; no DOM here.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/visual-bindings.d.ts

@@ -0,0 +1,95 @@
+/**
+ * VisualBindingRegistry — bind an expressive visual layer (SVG, Canvas, WebGL) to its semantic DOM
+ * source without duplicating meaning or harming accessibility. The native primitive Fundamental wishes
+ * existed: a declarative "this visual represents that semantic element; don't double-expose it".
+ *
+ * The semantic source stays real HTML; the visual is `aria-hidden` unless it carries independent
+ * meaning. `lint()` flags orphan visuals and accessibility hazards.
+ *
+ * Declarative authoring: mark the visual with `data-field-visual-for` (id/selector of the semantic
+ * source) and `data-field-visual-role`, then call `scan(root)` to register it. This is the bridge from
+ *   semantic HTML + data attributes → VisualBindingRegistry
+ * It does NOT extract glyph outlines or generate vector geometry — it only binds an authored visual
+ * layer to its source so the field can lint and inspect the pairing.
+ *
+ * State mirroring (Body Matter Interaction — the Bound Visual tier): the element absorbs field
+ * matter; the visual layer shows what that absorption means; the semantic text remains the source
+ * of meaning. CSS custom properties don't cross to siblings, so with mirroring enabled
+ * (`setMirroring(true)` — the platform default) every `representation`/`measurement` visual
+ * receives its source's feedback channels (`--d`/`--field-density`, `--load`/`--mass`, the measured
+ * metrics — see MIRRORED_CHANNELS) copied onto its own inline style: an aria-hidden SVG beside a
+ * sink heading thickens its contours from `var(--load)` exactly as if it were the body itself.
+ * Change-gated via a MutationObserver on the source's style attribute — no polling, no frame cost
+ * while the field is quiet.
+ */
+export type VisualRole = 'decorative' | 'representation' | 'debug' | 'relationship' | 'measurement';
+export interface VisualBinding {
+    visual: Element;
+    semanticSource: Element | null;
+    role: VisualRole;
+    accessibility: {
+        ariaHidden: boolean;
+        /** does this role require a semantic source to exist? */
+        semanticSourceRequired: boolean;
+        /** would screen readers see duplicate text from the visual? (source-bound but not hidden) */
+        duplicateSemantics: boolean;
+    };
+}
+export interface VisualLintWarning {
+    visual: Element;
+    code: 'orphan-representation' | 'visual-not-hidden' | 'duplicate-semantics';
+    severity: 'warning' | 'error';
+    message: string;
+}
+/** A warning raised while scanning the DOM for declarative bindings (resolution-time, not a11y). */
+export interface VisualBindingScanWarning {
+    element: Element;
+    /** 'unresolved-source' | 'missing-source' | 'invalid-role' */
+    reason: string;
+    value?: string;
+}
+export interface VisualBindingScanResult {
+    total: number;
+    bound: number;
+    unresolved: number;
+    warnings: VisualBindingScanWarning[];
+}
+/** The feedback channels a bound visual mirrors from its semantic source — the engine's write-back
+ *  lanes (density, sink load, causality, measured metrics). One list, shared with the docs. */
+export declare const MIRRORED_CHANNELS: readonly string[];
+export declare class VisualBindingRegistry {
+    private readonly bindings;
+    private mirroring;
+    private readonly observers;
+    /** Bind a visual layer to a semantic source. `representation`/`relationship` need a source. */
+    bind(opts: {
+        visual: Element;
+        source?: Element | null;
+        role: VisualRole;
+    }): VisualBinding;
+    /**
+     * Turn source→visual state mirroring on or off for every current and future binding (the Bound
+     * Visual tier of Body Matter Interaction). On: each `representation`/`measurement` visual gets an
+     * immediate copy of its source's MIRRORED_CHANNELS plus a style-attribute observer that re-copies
+     * whenever the engine writes the source (change-gated — quiet field, zero work). Off: observers
+     * disconnect; already-mirrored values are left in place (the visual keeps its last honest state).
+     */
+    setMirroring(on: boolean): void;
+    /** Copy the source's current feedback channels onto the visual's inline style (one pass). */
+    mirrorNow(visual: Element): void;
+    private watch;
+    private unwatch;
+    /**
+     * Discover declarative bindings under `root`: elements carrying `data-field-visual-for` (the source
+     * id/selector) and/or `data-field-visual-role`. Calls `bind()` for each. Idempotent — bindings are
+     * keyed by the visual element, so re-scanning updates role/source/aria-hidden without duplicating,
+     * and disconnected visuals are pruned. `resolve` defaults to a document-backed resolver.
+     */
+    scan(root: ParentNode, resolve?: (ref: string) => Element | null): VisualBindingScanResult;
+    get(visual: Element): VisualBinding | undefined;
+    all(): VisualBinding[];
+    get size(): number;
+    /** Accessibility lint over the bindings (visual-language §16 rules). */
+    lint(): VisualLintWarning[];
+}
+//# sourceMappingURL=visual-bindings.d.ts.map

package/dist/visual-bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-bindings.d.ts","sourceRoot":"","sources":["../src/visual-bindings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,gBAAgB,GAAG,OAAO,GAAG,cAAc,GAAG,aAAa,CAAC;AAOpG,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/B,IAAI,EAAE,UAAU,CAAC;IACjB,aAAa,EAAE;QACb,UAAU,EAAE,OAAO,CAAC;QACpB,yDAAyD;QACzD,sBAAsB,EAAE,OAAO,CAAC;QAChC,6FAA6F;QAC7F,kBAAkB,EAAE,OAAO,CAAC;KAC7B,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,uBAAuB,GAAG,mBAAmB,GAAG,qBAAqB,CAAC;IAC5E,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,oGAAoG;AACpG,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AACD,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,wBAAwB,EAAE,CAAC;CACtC;AAID;+FAC+F;AAC/F,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAU9C,CAAC;AA8BF,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAC9D,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwC;IAElE,+FAA+F;IAC/F,IAAI,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QAAC,IAAI,EAAE,UAAU,CAAA;KAAE,GAAG,aAAa;IAmBzF;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI;IAU/B,6FAA6F;IAC7F,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAYhC,OAAO,CAAC,KAAK;IAUb,OAAO,CAAC,OAAO;IAQf;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,IAA4B,GAAG,uBAAuB;IAwCjH,GAAG,CAAC,MAAM,EAAE,OAAO,GAAG,aAAa,GAAG,SAAS;IAI/C,GAAG,IAAI,aAAa,EAAE;IAItB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,wEAAwE;IACxE,IAAI,IAAI,iBAAiB,EAAE;CAc5B"}

package/dist/visual-bindings.js

@@ -0,0 +1,211 @@
+/**
+ * VisualBindingRegistry — bind an expressive visual layer (SVG, Canvas, WebGL) to its semantic DOM
+ * source without duplicating meaning or harming accessibility. The native primitive Fundamental wishes
+ * existed: a declarative "this visual represents that semantic element; don't double-expose it".
+ *
+ * The semantic source stays real HTML; the visual is `aria-hidden` unless it carries independent
+ * meaning. `lint()` flags orphan visuals and accessibility hazards.
+ *
+ * Declarative authoring: mark the visual with `data-field-visual-for` (id/selector of the semantic
+ * source) and `data-field-visual-role`, then call `scan(root)` to register it. This is the bridge from
+ *   semantic HTML + data attributes → VisualBindingRegistry
+ * It does NOT extract glyph outlines or generate vector geometry — it only binds an authored visual
+ * layer to its source so the field can lint and inspect the pairing.
+ *
+ * State mirroring (Body Matter Interaction — the Bound Visual tier): the element absorbs field
+ * matter; the visual layer shows what that absorption means; the semantic text remains the source
+ * of meaning. CSS custom properties don't cross to siblings, so with mirroring enabled
+ * (`setMirroring(true)` — the platform default) every `representation`/`measurement` visual
+ * receives its source's feedback channels (`--d`/`--field-density`, `--load`/`--mass`, the measured
+ * metrics — see MIRRORED_CHANNELS) copied onto its own inline style: an aria-hidden SVG beside a
+ * sink heading thickens its contours from `var(--load)` exactly as if it were the body itself.
+ * Change-gated via a MutationObserver on the source's style attribute — no polling, no frame cost
+ * while the field is quiet.
+ */
+const VISUAL_ROLES = ['decorative', 'representation', 'debug', 'relationship', 'measurement'];
+const isVisualRole = (v) => v != null && VISUAL_ROLES.includes(v);
+/** roles that re-present existing meaning and therefore require a semantic source. */
+const requiresSource = (role) => role === 'representation' || role === 'relationship';
+const ariaHidden = (el) => el.getAttribute('aria-hidden') === 'true';
+/** The feedback channels a bound visual mirrors from its semantic source — the engine's write-back
+ *  lanes (density, sink load, causality, measured metrics). One list, shared with the docs. */
+export const MIRRORED_CHANNELS = [
+    '--d',
+    '--field-density',
+    '--load',
+    '--mass',
+    '--lit',
+    '--entropy',
+    '--coherence',
+    '--temperature',
+    '--field-heatmap-density',
+];
+/** roles that re-present source state and therefore receive mirrored feedback channels. */
+const mirrorsState = (b) => b.semanticSource != null && (b.role === 'representation' || b.role === 'measurement');
+/** Build the default document-backed source resolver for a scan root (the §"resolution policy"). */
+function defaultResolver(root) {
+    const doc = root.nodeType === 9 ? root : (root.ownerDocument ?? null);
+    const trySelector = (host, sel) => {
+        if (!host || typeof host.querySelector !== 'function')
+            return null;
+        try {
+            return host.querySelector(sel);
+        }
+        catch {
+            return null; // invalid selector → not a crash
+        }
+    };
+    return (ref) => {
+        if (!ref)
+            return null;
+        if (ref.startsWith('#'))
+            return trySelector(root, ref) ?? trySelector(doc, ref);
+        // bare value: prefer getElementById, then fall back to a (validated) selector
+        const byId = doc?.getElementById?.(ref) ?? null;
+        if (byId)
+            return byId;
+        return trySelector(root, ref);
+    };
+}
+export class VisualBindingRegistry {
+    bindings = new Map();
+    mirroring = false;
+    observers = new Map();
+    /** Bind a visual layer to a semantic source. `representation`/`relationship` need a source. */
+    bind(opts) {
+        const required = requiresSource(opts.role);
+        const hidden = ariaHidden(opts.visual);
+        const b = {
+            visual: opts.visual,
+            semanticSource: opts.source ?? null,
+            role: opts.role,
+            accessibility: {
+                ariaHidden: hidden,
+                semanticSourceRequired: required,
+                // a source-bound visual that is NOT hidden re-exposes the source's meaning to AT
+                duplicateSemantics: required && !hidden && !!opts.source,
+            },
+        };
+        this.bindings.set(opts.visual, b);
+        if (this.mirroring)
+            this.watch(b);
+        return b;
+    }
+    /**
+     * Turn source→visual state mirroring on or off for every current and future binding (the Bound
+     * Visual tier of Body Matter Interaction). On: each `representation`/`measurement` visual gets an
+     * immediate copy of its source's MIRRORED_CHANNELS plus a style-attribute observer that re-copies
+     * whenever the engine writes the source (change-gated — quiet field, zero work). Off: observers
+     * disconnect; already-mirrored values are left in place (the visual keeps its last honest state).
+     */
+    setMirroring(on) {
+        this.mirroring = on;
+        if (!on) {
+            for (const obs of this.observers.values())
+                obs.disconnect();
+            this.observers.clear();
+            return;
+        }
+        for (const b of this.bindings.values())
+            this.watch(b);
+    }
+    /** Copy the source's current feedback channels onto the visual's inline style (one pass). */
+    mirrorNow(visual) {
+        const b = this.bindings.get(visual);
+        if (!b || !mirrorsState(b))
+            return;
+        const src = b.semanticSource;
+        const dst = b.visual;
+        if (!src.style?.getPropertyValue || !dst.style?.setProperty)
+            return; // non-styled host (tests, SSR)
+        for (const channel of MIRRORED_CHANNELS) {
+            const value = src.style.getPropertyValue(channel);
+            if (value !== '' && value !== dst.style.getPropertyValue(channel))
+                dst.style.setProperty(channel, value);
+        }
+    }
+    watch(b) {
+        this.unwatch(b.visual);
+        if (!mirrorsState(b))
+            return;
+        this.mirrorNow(b.visual);
+        if (typeof MutationObserver === 'undefined' || !b.semanticSource)
+            return;
+        const obs = new MutationObserver(() => this.mirrorNow(b.visual));
+        obs.observe(b.semanticSource, { attributes: true, attributeFilter: ['style'] });
+        this.observers.set(b.visual, obs);
+    }
+    unwatch(visual) {
+        const obs = this.observers.get(visual);
+        if (obs) {
+            obs.disconnect();
+            this.observers.delete(visual);
+        }
+    }
+    /**
+     * Discover declarative bindings under `root`: elements carrying `data-field-visual-for` (the source
+     * id/selector) and/or `data-field-visual-role`. Calls `bind()` for each. Idempotent — bindings are
+     * keyed by the visual element, so re-scanning updates role/source/aria-hidden without duplicating,
+     * and disconnected visuals are pruned. `resolve` defaults to a document-backed resolver.
+     */
+    scan(root, resolve = defaultResolver(root)) {
+        // navigation hygiene: drop bindings whose visual OR source left the DOM (and stop mirroring
+        // them). Pruning only on the visual leaves a MutationObserver pinned to a removed source —
+        // holding that detached source subtree alive for as long as the visual stays mounted.
+        for (const [el, b] of this.bindings)
+            if (el.isConnected === false || b.semanticSource?.isConnected === false) {
+                this.unwatch(el);
+                this.bindings.delete(el);
+            }
+        const visuals = [...root.querySelectorAll('[data-field-visual-for], [data-field-visual-role], [data-visual-for]')];
+        const warnings = [];
+        let unresolved = 0;
+        for (const visual of visuals) {
+            const value = visual.getAttribute('data-field-visual-for') ?? visual.getAttribute('data-visual-for');
+            const roleAttr = visual.getAttribute('data-field-visual-role');
+            let role;
+            if (roleAttr == null) {
+                role = 'representation'; // role omitted but selected via data-field-visual-for → representation
+            }
+            else if (isVisualRole(roleAttr)) {
+                role = roleAttr;
+            }
+            else {
+                role = 'representation'; // invalid role → default + warn
+                warnings.push({ element: visual, reason: 'invalid-role', value: roleAttr });
+            }
+            const source = value ? resolve(value) : null;
+            if (requiresSource(role) && !source) {
+                unresolved++;
+                warnings.push({ element: visual, reason: value ? 'unresolved-source' : 'missing-source', value: value ?? undefined });
+            }
+            this.bind({ visual, source, role });
+        }
+        return { total: visuals.length, bound: visuals.length, unresolved, warnings };
+    }
+    get(visual) {
+        return this.bindings.get(visual);
+    }
+    all() {
+        return [...this.bindings.values()];
+    }
+    get size() {
+        return this.bindings.size;
+    }
+    /** Accessibility lint over the bindings (visual-language §16 rules). */
+    lint() {
+        const out = [];
+        for (const b of this.bindings.values()) {
+            if (b.accessibility.semanticSourceRequired && !b.semanticSource)
+                out.push({ visual: b.visual, code: 'orphan-representation', severity: 'error', message: `a ${b.role} visual must bind a semantic source` });
+            else if (!b.accessibility.ariaHidden) {
+                if (requiresSource(b.role))
+                    out.push({ visual: b.visual, code: 'duplicate-semantics', severity: 'warning', message: `a ${b.role} visual must be aria-hidden so assistive tech reads only the semantic source` });
+                else
+                    out.push({ visual: b.visual, code: 'visual-not-hidden', severity: 'warning', message: `a ${b.role} visual with no independent meaning should be aria-hidden` });
+            }
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=visual-bindings.js.map

package/dist/visual-bindings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-bindings.js","sourceRoot":"","sources":["../src/visual-bindings.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@fundamental-engine/dom",
+  "version": "0.7.0",
+  "description": "The platform-adjacent layer for Fundamental — native-first registries for measurement, semantic state, feedback, relationships, visual-semantic bindings, and overlays. The browser primitives Fundamental wishes existed, built on the ones it has.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Zach Shallbetter <hi@zachshallbetter.com> (https://zachshallbetter.com)",
+  "homepage": "https://fundamental-engine.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zachshallbetter/fundamental-engine.git",
+    "directory": "packages/dom"
+  },
+  "bugs": {
+    "url": "https://github.com/zachshallbetter/fundamental-engine/issues"
+  },
+  "keywords": [
+    "Fundamental",
+    "dom",
+    "measurement",
+    "relationships",
+    "state",
+    "feedback",
+    "overlays",
+    "web"
+  ],
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@fundamental-engine/core": "0.7.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --test"
+  }
+}