@fundamental-engine/dom 0.7.0

package/dist/feedback.js

@@ -0,0 +1,134 @@
+/**
+ * FeedbackRegistry — the write-phase. Turns held state into DOM: CSS custom properties (continuous)
+ * and thresholded, debounced events (discrete). The native primitive Fundamental wishes existed —
+ * standard feedback channels with hysteresis instead of per-frame DOM events.
+ *
+ * Writes happen only in `flush()`, after measurement + simulation reads.
+ */
+import { Thresholder } from '@fundamental-engine/core';
+/** Write a CSS custom property. Returns the count of actual DOM mutations. */
+function writeVar(element, name, value) {
+    const style = element.style;
+    if (!style || typeof style.setProperty !== 'function')
+        return 0;
+    style.setProperty(name, value);
+    return 1;
+}
+function removeVar(element, name) {
+    const style = element.style;
+    if (!style || typeof style.removeProperty !== 'function')
+        return;
+    style.removeProperty(name);
+}
+function fire(element, type, detail) {
+    if (typeof element.dispatchEvent !== 'function')
+        return;
+    element.dispatchEvent(new CustomEvent(type, { bubbles: true, composed: true, detail }));
+}
+export class FeedbackRegistry {
+    bindings = new Map();
+    direct = new Map();
+    thresholds = [];
+    _cssWritesLastFrame = 0;
+    /** Declare which state keys map to which CSS vars on an element (e.g. `{ density: '--field-density' }`). */
+    bind(element, map) {
+        this.bindings.set(element, { ...this.bindings.get(element), ...map });
+    }
+    /**
+     * Remove the CSS var bound to `key` on `element` from the DOM. Use
+     * when a metric becomes absent — e.g. the host stops supplying `data-field-confidence` — so a value
+     * written on an earlier `flush()` doesn't linger. A no-op when nothing is bound for `key`; the
+     * binding itself is left intact, so the var is rewritten if the metric returns. `flush()` already
+     * skips keys with no state, so this only clears the previously written inline value.
+     */
+    clearVar(element, key) {
+        const name = this.bindings.get(element)?.[key];
+        if (name)
+            removeVar(element, name);
+    }
+    /** The declared bindings (element → the CSS-var names it writes), for lint / inspection. */
+    boundVars() {
+        return [...this.bindings].map(([element, map]) => ({ element, vars: Object.values(map) }));
+    }
+    /**
+     * Actual `style.setProperty` calls made during the last `flush()`. Use this (not
+     * `boundVars().length`) to measure real per-frame DOM write cost: off-screen elements with
+     * active bindings still generate mutations even though they produce no visible change.
+     */
+    cssWritesLastFrame() {
+        return this._cssWritesLastFrame;
+    }
+    /** Queue a direct CSS-var write (applied on the next `flush`). */
+    set(element, vars) {
+        const cur = this.direct.get(element) ?? {};
+        for (const k of Object.keys(vars))
+            cur[k] = String(vars[k]);
+        this.direct.set(element, cur);
+    }
+    /** Register a thresholded, debounced event for an element metric (hysteresis via enter/exit). */
+    threshold(element, eventName, opts) {
+        this.thresholds.push({
+            element,
+            eventName,
+            metric: opts.metric,
+            exitEvent: opts.exitEvent,
+            thresholder: new Thresholder({ enter: opts.enter, exit: opts.exit, debounceMs: opts.debounce ?? 0 }),
+        });
+    }
+    /**
+     * Drop ALL bindings and thresholds registered for one element. Use when an element is removed from
+     * the DOM and you want immediate reclamation rather than waiting for the next flush() sweep.
+     */
+    unregister(element) {
+        this.bindings.delete(element);
+        this.direct.delete(element);
+        // splice in reverse so the index arithmetic stays correct as we remove entries
+        for (let i = this.thresholds.length - 1; i >= 0; i--) {
+            if (this.thresholds[i].element === element)
+                this.thresholds.splice(i, 1);
+        }
+    }
+    /**
+     * Write-phase: apply bound state → CSS vars, apply queued direct writes, and run thresholders →
+     * fire edge events. `state` supplies the numeric values for bound vars + thresholds. Disconnected
+     * elements are pruned here — the natural per-frame moment — so bindings and thresholds for removed
+     * elements never accumulate across the lifetime of the registry.
+     */
+    flush(state, now = 0) {
+        this._cssWritesLastFrame = 0;
+        for (const [el, map] of this.bindings) {
+            // prune entries whose element left the DOM; writing to a disconnected element is a no-op
+            // layout-wise but still costs a Map lookup + style.setProperty call every frame.
+            if (!el.isConnected) {
+                this.bindings.delete(el);
+                continue;
+            }
+            for (const key of Object.keys(map)) {
+                const v = state.get(el, key);
+                if (!v)
+                    continue;
+                this._cssWritesLastFrame += writeVar(el, map[key], v.type === 'number' ? v.value.toFixed(3) : String(v.value ?? ''));
+            }
+        }
+        for (const [el, vars] of this.direct) {
+            for (const name of Object.keys(vars))
+                this._cssWritesLastFrame += writeVar(el, name, vars[name]);
+        }
+        this.direct.clear();
+        // prune disconnected threshold entries in-place (reverse splice keeps indices stable)
+        for (let i = this.thresholds.length - 1; i >= 0; i--) {
+            if (!this.thresholds[i].element.isConnected) {
+                this.thresholds.splice(i, 1);
+                continue;
+            }
+            const t = this.thresholds[i];
+            const value = state.number(t.element, t.metric);
+            const edge = t.thresholder.update(value, now);
+            if (edge === 'entered')
+                fire(t.element, t.eventName, { metric: t.metric, value });
+            else if (edge === 'exited' && t.exitEvent)
+                fire(t.element, t.exitEvent, { metric: t.metric, value });
+        }
+    }
+}
+//# sourceMappingURL=feedback.js.map

package/dist/feedback.js.map

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

package/dist/field-nav.d.ts

@@ -0,0 +1,35 @@
+/**
+ * `bindFieldNav` — the navigation-chrome idiom the Fundamental site hand-spread across a dozen surfaces
+ * (top nav, chapter rail, docs sidebar/outline/search, breadcrumbs, pagers, footer, filter rosters),
+ * lifted into the platform. It runs a recipe SIGNALS-ONLY (`render: []`) over the `<a>` links inside a
+ * root: every link becomes a body, the current link can be pinned as the "well" (`data-field-attention
+ * = 1`), and previously-visited links can be marked (`data-field-memory = 1` + a `nav-visited` class)
+ * from a caller-supplied predicate. The platform writes the recipe's `--field-*` lanes back onto each
+ * link; CSS turns them into ink, weight, glows, and marks. Nothing is drawn.
+ *
+ * Progressive enhancement is the contract: under `prefers-reduced-motion` (or when the recipe can't be
+ * resolved / there are no links) it returns `null` and writes nothing — the links stay plain and
+ * reachable. The caller owns the visit log and the recipe lookup; this helper owns the binding and its
+ * teardown. Unfrozen (experimental) — option names may refine before 1.0.
+ */
+import { type FieldRecipe } from '@fundamental-engine/core';
+export interface FieldNavOptions {
+    /** the link to pin as the current/"well" — its attention lane is held at 1. */
+    pin?: Element | null;
+    /** predicate over a link's `href`: true → mark it visited (`data-field-memory=1` + `nav-visited`). */
+    visited?: (href: string) => boolean;
+    /** extra metric lanes to bind beyond the recipe's (default `['attention','memory']`). */
+    extraMetrics?: string[];
+    /** force the reduced-motion path (defaults to the OS `prefers-reduced-motion` setting). */
+    reducedMotion?: boolean;
+}
+export interface FieldNavHandle {
+    destroy(): void;
+}
+/**
+ * Bind a recipe signals-only over the `<a href>` links inside `root`. `recipe` may be a `FieldRecipe`
+ * or a catalog id. Returns a teardown, or `null` when there's nothing to bind (reduced motion, no
+ * links, or an unknown recipe id).
+ */
+export declare function bindFieldNav(root: Element, recipe: FieldRecipe | string, opts?: FieldNavOptions): FieldNavHandle | null;
+//# sourceMappingURL=field-nav.d.ts.map

package/dist/field-nav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-nav.d.ts","sourceRoot":"","sources":["../src/field-nav.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAIxE,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,GAAG,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACrB,sGAAsG;IACtG,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACpC,yFAAyF;IACzF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,2FAA2F;IAC3F,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,IAAI,IAAI,CAAC;CACjB;AAWD;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,WAAW,GAAG,MAAM,EAC5B,IAAI,GAAE,eAAoB,GACzB,cAAc,GAAG,IAAI,CAgDvB"}

package/dist/field-nav.js

@@ -0,0 +1,82 @@
+/**
+ * `bindFieldNav` — the navigation-chrome idiom the Fundamental site hand-spread across a dozen surfaces
+ * (top nav, chapter rail, docs sidebar/outline/search, breadcrumbs, pagers, footer, filter rosters),
+ * lifted into the platform. It runs a recipe SIGNALS-ONLY (`render: []`) over the `<a>` links inside a
+ * root: every link becomes a body, the current link can be pinned as the "well" (`data-field-attention
+ * = 1`), and previously-visited links can be marked (`data-field-memory = 1` + a `nav-visited` class)
+ * from a caller-supplied predicate. The platform writes the recipe's `--field-*` lanes back onto each
+ * link; CSS turns them into ink, weight, glows, and marks. Nothing is drawn.
+ *
+ * Progressive enhancement is the contract: under `prefers-reduced-motion` (or when the recipe can't be
+ * resolved / there are no links) it returns `null` and writes nothing — the links stay plain and
+ * reachable. The caller owns the visit log and the recipe lookup; this helper owns the binding and its
+ * teardown. Unfrozen (experimental) — option names may refine before 1.0.
+ */
+import { recipeById } from '@fundamental-engine/core';
+import { applyRecipe } from "./apply-recipe.js";
+import { prefersReducedMotion } from "./env.js";
+/** The `--field-*` lanes a nav binding may write — cleared on teardown so a re-bind starts clean. */
+const NAV_METRIC_VARS = [
+    '--field-attention',
+    '--field-memory',
+    '--field-priority',
+    '--field-density',
+    '--field-recency',
+];
+/**
+ * Bind a recipe signals-only over the `<a href>` links inside `root`. `recipe` may be a `FieldRecipe`
+ * or a catalog id. Returns a teardown, or `null` when there's nothing to bind (reduced motion, no
+ * links, or an unknown recipe id).
+ */
+export function bindFieldNav(root, recipe, opts = {}) {
+    if (opts.reducedMotion ?? prefersReducedMotion())
+        return null;
+    const resolved = typeof recipe === 'string' ? recipeById(recipe) : recipe;
+    if (!resolved)
+        return null;
+    const links = [...root.querySelectorAll('a[href]')];
+    if (!links.length)
+        return null;
+    const pinned = opts.pin ?? null;
+    pinned?.setAttribute('data-field-attention', '1');
+    const marked = [];
+    if (opts.visited) {
+        for (const a of links) {
+            if (opts.visited(a.getAttribute('href') ?? '')) {
+                a.setAttribute('data-field-memory', '1');
+                a.classList.add('nav-visited');
+                marked.push(a);
+            }
+        }
+    }
+    const undoAnnotations = () => {
+        pinned?.removeAttribute('data-field-attention');
+        for (const a of marked) {
+            a.removeAttribute('data-field-memory');
+            a.classList.remove('nav-visited');
+        }
+    };
+    let applied;
+    try {
+        applied = applyRecipe(root, resolved, {
+            bodies: links,
+            annotateBodies: false,
+            renderless: true,
+            extraMetrics: opts.extraMetrics ?? ['attention', 'memory'],
+        });
+    }
+    catch {
+        undoAnnotations();
+        return null; // the plain links stand on their own
+    }
+    return {
+        destroy() {
+            applied.destroy();
+            undoAnnotations();
+            for (const a of links)
+                for (const v of NAV_METRIC_VARS)
+                    a.style.removeProperty(v);
+        },
+    };
+}
+//# sourceMappingURL=field-nav.js.map

package/dist/field-nav.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-nav.js","sourceRoot":"","sources":["../src/field-nav.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,UAAU,EAAoB,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAiBhD,qGAAqG;AACrG,MAAM,eAAe,GAAG;IACtB,mBAAmB;IACnB,gBAAgB;IAChB,kBAAkB;IAClB,iBAAiB;IACjB,iBAAiB;CAClB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAa,EACb,MAA4B,EAC5B,OAAwB,EAAE;IAE1B,IAAI,IAAI,CAAC,aAAa,IAAI,oBAAoB,EAAE;QAAE,OAAO,IAAI,CAAC;IAC9D,MAAM,QAAQ,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC1E,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAoB,SAAS,CAAC,CAAC,CAAC;IACvE,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAE/B,MAAM,MAAM,GAAI,IAAI,CAAC,GAA0B,IAAI,IAAI,CAAC;IACxD,MAAM,EAAE,YAAY,CAAC,sBAAsB,EAAE,GAAG,CAAC,CAAC;IAClD,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;gBAC/C,CAAC,CAAC,YAAY,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;gBACzC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;gBAC/B,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,eAAe,GAAG,GAAS,EAAE;QACjC,MAAM,EAAE,eAAe,CAAC,sBAAsB,CAAC,CAAC;QAChD,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,CAAC,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC;YACvC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QACpC,CAAC;IACH,CAAC,CAAC;IAEF,IAAI,OAA4B,CAAC;IACjC,IAAI,CAAC;QACH,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE;YACpC,MAAM,EAAE,KAAK;YACb,cAAc,EAAE,KAAK;YACrB,UAAU,EAAE,IAAI;YAChB,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC;SAC3D,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,eAAe,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,CAAC,qCAAqC;IACpD,CAAC;IAED,OAAO;QACL,OAAO;YACL,OAAO,CAAC,OAAO,EAAE,CAAC;YAClB,eAAe,EAAE,CAAC;YAClB,KAAK,MAAM,CAAC,IAAI,KAAK;gBAAE,KAAK,MAAM,CAAC,IAAI,eAAe;oBAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;QACpF,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/flip.d.ts

@@ -0,0 +1,31 @@
+/** Options for {@link withFlip}. */
+export interface FlipOptions {
+    /** Transition duration in ms. Default 500. */
+    duration?: number;
+    /** Transition easing. Default the family's `cubic-bezier(.2, .7, .2, 1)`. */
+    easing?: string;
+    /**
+     * Which axes the released offset travels on. `"both"` (default) animates `translate(dx, dy)`;
+     * `"y"` animates `translateY(dy)` only — for single-column lists where any horizontal delta
+     * is noise.
+     */
+    axis?: 'y' | 'both';
+    /**
+     * Elements the mutation moved but that should NOT be translated — e.g. a tile whose size class
+     * changed, where a translate cannot honestly animate the reflow and the caller settles it
+     * another way (a fade). Evaluated after `mutate`, once per element.
+     */
+    exclude?: (el: HTMLElement) => boolean;
+}
+/**
+ * Measure `elements()`, run `mutate` (which may reorder, move, or reparent them), then translate
+ * each moved element from its old box to its new one and release the offset under a transition.
+ * The inline transition is removed on `transitionend`.
+ *
+ * `elements` is called twice — once before `mutate` (First) and once after (Last) — so a callback
+ * that re-queries the DOM naturally covers reparenting. Elements that appear only after `mutate`
+ * (no first rect) are left alone. Skips the animation entirely under
+ * `prefers-reduced-motion: reduce` (`mutate` still runs).
+ */
+export declare function withFlip(elements: () => HTMLElement[], mutate: () => void, opts?: FlipOptions): void;
+//# sourceMappingURL=flip.d.ts.map

package/dist/flip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flip.d.ts","sourceRoot":"","sources":["../src/flip.ts"],"names":[],"mappings":"AAeA,oCAAoC;AACpC,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,IAAI,CAAC,EAAE,GAAG,GAAG,MAAM,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC;CACxC;AAKD;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,WAAW,EAAE,EAAE,MAAM,EAAE,MAAM,IAAI,EAAE,IAAI,GAAE,WAAgB,GAAG,IAAI,CAuCxG"}

package/dist/flip.js

@@ -0,0 +1,65 @@
+/**
+ * withFlip — the FLIP reflow primitive (First, Last, Invert, Play).
+ *
+ * Every invisible-fields example re-sorts live DOM (reweight, triage, cross-pane moves) and wants
+ * the reflow to read as travel, not teleportation. The recipe is always the same: measure where
+ * each element sits, mutate the DOM, measure again, then translate each element from its old box
+ * back over its new one and release the offset under a transition. This module is that recipe,
+ * extracted (#295) so a runtime states only WHAT changes, not how the motion works.
+ *
+ * Pure DOM helper: no registries, no engine, no module-top window access (SSR-safe — the
+ * reduced-motion probe runs at call time). Under `prefers-reduced-motion: reduce` the mutation
+ * still runs; only the animation is skipped.
+ */
+import { prefersReducedMotion } from "./env.js";
+const DEFAULT_DURATION = 500;
+const DEFAULT_EASING = 'cubic-bezier(.2, .7, .2, 1)';
+/**
+ * Measure `elements()`, run `mutate` (which may reorder, move, or reparent them), then translate
+ * each moved element from its old box to its new one and release the offset under a transition.
+ * The inline transition is removed on `transitionend`.
+ *
+ * `elements` is called twice — once before `mutate` (First) and once after (Last) — so a callback
+ * that re-queries the DOM naturally covers reparenting. Elements that appear only after `mutate`
+ * (no first rect) are left alone. Skips the animation entirely under
+ * `prefers-reduced-motion: reduce` (`mutate` still runs).
+ */
+export function withFlip(elements, mutate, opts = {}) {
+    if (prefersReducedMotion()) {
+        mutate();
+        return;
+    }
+    const duration = opts.duration ?? DEFAULT_DURATION;
+    const easing = opts.easing ?? DEFAULT_EASING;
+    const axis = opts.axis ?? 'both';
+    // First: where everything sits now.
+    const first = new Map(elements().map((el) => {
+        const b = el.getBoundingClientRect();
+        return [el, { top: b.top, left: b.left }];
+    }));
+    mutate();
+    // Last + Invert + Play, per element.
+    for (const el of elements()) {
+        if (opts.exclude?.(el))
+            continue;
+        const was = first.get(el);
+        if (!was)
+            continue; // appeared during mutate — no origin to travel from
+        const now = el.getBoundingClientRect();
+        const dx = axis === 'y' ? 0 : was.left - now.left;
+        const dy = was.top - now.top;
+        if (!dx && !dy)
+            continue;
+        el.style.setProperty('transform', axis === 'y' ? `translateY(${dy}px)` : `translate(${dx}px, ${dy}px)`);
+        el.style.setProperty('transition', 'none');
+        void el.getBoundingClientRect(); // commit the inverted offset before releasing it
+        requestAnimationFrame(() => {
+            el.style.setProperty('transition', `transform ${duration}ms ${easing}`);
+            el.style.removeProperty('transform');
+            el.addEventListener('transitionend', () => el.style.removeProperty('transition'), {
+                once: true,
+            });
+        });
+    }
+}
+//# sourceMappingURL=flip.js.map

package/dist/flip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flip.js","sourceRoot":"","sources":["../src/flip.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAsBhD,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAC7B,MAAM,cAAc,GAAG,6BAA6B,CAAC;AAErD;;;;;;;;;GASG;AACH,MAAM,UAAU,QAAQ,CAAC,QAA6B,EAAE,MAAkB,EAAE,OAAoB,EAAE;IAChG,IAAI,oBAAoB,EAAE,EAAE,CAAC;QAC3B,MAAM,EAAE,CAAC;QACT,OAAO;IACT,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,gBAAgB,CAAC;IACnD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,cAAc,CAAC;IAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC;IACjC,oCAAoC;IACpC,MAAM,KAAK,GAAG,IAAI,GAAG,CACnB,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;QACpB,MAAM,CAAC,GAAG,EAAE,CAAC,qBAAqB,EAAE,CAAC;QACrC,OAAO,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAU,CAAC;IACrD,CAAC,CAAC,CACH,CAAC;IACF,MAAM,EAAE,CAAC;IACT,qCAAqC;IACrC,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YAAE,SAAS;QACjC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,GAAG;YAAE,SAAS,CAAC,oDAAoD;QACxE,MAAM,GAAG,GAAG,EAAE,CAAC,qBAAqB,EAAE,CAAC;QACvC,MAAM,EAAE,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;QAClD,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;QAC7B,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE;YAAE,SAAS;QACzB,EAAE,CAAC,KAAK,CAAC,WAAW,CAClB,WAAW,EACX,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC,CAAC,aAAa,EAAE,OAAO,EAAE,KAAK,CACrE,CAAC;QACF,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QAC3C,KAAK,EAAE,CAAC,qBAAqB,EAAE,CAAC,CAAC,iDAAiD;QAClF,qBAAqB,CAAC,GAAG,EAAE;YACzB,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,YAAY,EAAE,aAAa,QAAQ,MAAM,MAAM,EAAE,CAAC,CAAC;YACxE,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;YACrC,EAAE,CAAC,gBAAgB,CAAC,eAAe,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC,YAAY,CAAC,EAAE;gBAChF,IAAI,EAAE,IAAI;aACX,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/governor.d.ts

@@ -0,0 +1,37 @@
+/**
+ * QualityGovernor — detects sustained frame-budget overruns and emits a tier signal so the
+ * caller can adapt render quality without a hard cutoff.
+ *
+ * Tier semantics (intentionally coarse — the governor detects, the caller responds):
+ *   0 = full quality (default)
+ *   1 = effects reduced  — caller should simplify overlay, drop heatmap, reduce particle draw
+ *   2 = minimal          — caller should switch render to 'dots', cut particle cap in half
+ *   3 = paused           — caller should suspend the field loop entirely
+ *
+ * Shipped consumer: the `<field-root>` platform runtime throttles its own tick cadence (the
+ * measurement/feedback DOM work) to every 2nd frame at tier 2 and every 4th at tier 3, and
+ * emits `field:quality-tier` so embedders can wire engine-side responses (render simplification,
+ * particle caps) — those are NOT automatic yet.
+ *
+ * Feed it rAF-to-rAF spacing (or better, measured work time). Callers should skip discontinuity
+ * frames (tab switches, system sleep) and reset() on visibilitychange — the elements runtime does.
+ *
+ * Recovery is asymmetric: a tier escalation fires after N consecutive overrun frames;
+ * recovery requires a longer run of clean frames to avoid thrashing at the boundary.
+ */
+export type QualityTier = 0 | 1 | 2 | 3;
+export declare class QualityGovernor {
+    private _tier;
+    private overrunStreak;
+    private cleanStreak;
+    private readonly budget;
+    constructor(budgetMs?: number);
+    get tier(): QualityTier;
+    /**
+     * Feed one frame duration (ms). Returns the new tier when it changes, `undefined` when stable.
+     * Call once per rAF tick, after `platform.tick()` completes.
+     */
+    feed(durationMs: number): QualityTier | undefined;
+    reset(): void;
+}
+//# sourceMappingURL=governor.d.ts.map

package/dist/governor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"governor.d.ts","sourceRoot":"","sources":["../src/governor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAgBxC,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,QAAQ,SAAQ;IAI5B,IAAI,IAAI,IAAI,WAAW,CAAuB;IAE9C;;;OAGG;IACH,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IA0BjD,KAAK,IAAI,IAAI;CAKd"}

package/dist/governor.js

@@ -0,0 +1,72 @@
+/**
+ * QualityGovernor — detects sustained frame-budget overruns and emits a tier signal so the
+ * caller can adapt render quality without a hard cutoff.
+ *
+ * Tier semantics (intentionally coarse — the governor detects, the caller responds):
+ *   0 = full quality (default)
+ *   1 = effects reduced  — caller should simplify overlay, drop heatmap, reduce particle draw
+ *   2 = minimal          — caller should switch render to 'dots', cut particle cap in half
+ *   3 = paused           — caller should suspend the field loop entirely
+ *
+ * Shipped consumer: the `<field-root>` platform runtime throttles its own tick cadence (the
+ * measurement/feedback DOM work) to every 2nd frame at tier 2 and every 4th at tier 3, and
+ * emits `field:quality-tier` so embedders can wire engine-side responses (render simplification,
+ * particle caps) — those are NOT automatic yet.
+ *
+ * Feed it rAF-to-rAF spacing (or better, measured work time). Callers should skip discontinuity
+ * frames (tab switches, system sleep) and reset() on visibilitychange — the elements runtime does.
+ *
+ * Recovery is asymmetric: a tier escalation fires after N consecutive overrun frames;
+ * recovery requires a longer run of clean frames to avoid thrashing at the boundary.
+ */
+const ESCALATE = [
+    { aboveMs: 20, streak: 10, tier: 1 },
+    { aboveMs: 33, streak: 5, tier: 2 },
+    { aboveMs: 50, streak: 3, tier: 3 },
+];
+const RECOVER_STREAK = 30; // clean frames before dropping a tier
+export class QualityGovernor {
+    _tier = 0;
+    overrunStreak = 0;
+    cleanStreak = 0;
+    budget;
+    constructor(budgetMs = 16.67) {
+        this.budget = budgetMs;
+    }
+    get tier() { return this._tier; }
+    /**
+     * Feed one frame duration (ms). Returns the new tier when it changes, `undefined` when stable.
+     * Call once per rAF tick, after `platform.tick()` completes.
+     */
+    feed(durationMs) {
+        const overrun = durationMs > this.budget * 1.3;
+        if (overrun) {
+            this.cleanStreak = 0;
+            this.overrunStreak++;
+            for (const rule of ESCALATE) {
+                if (durationMs > rule.aboveMs && this.overrunStreak >= rule.streak && this._tier < rule.tier) {
+                    this._tier = rule.tier;
+                    return this._tier;
+                }
+            }
+        }
+        else {
+            this.overrunStreak = 0;
+            if (this._tier > 0) {
+                this.cleanStreak++;
+                if (this.cleanStreak >= RECOVER_STREAK) {
+                    this.cleanStreak = 0;
+                    this._tier = Math.max(0, this._tier - 1);
+                    return this._tier;
+                }
+            }
+        }
+        return undefined;
+    }
+    reset() {
+        this._tier = 0;
+        this.overrunStreak = 0;
+        this.cleanStreak = 0;
+    }
+}
+//# sourceMappingURL=governor.js.map

package/dist/governor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"governor.js","sourceRoot":"","sources":["../src/governor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAUH,MAAM,QAAQ,GAAwB;IACpC,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE;IACpC,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAG,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE;IACpC,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAG,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE;CACrC,CAAC;AAEF,MAAM,cAAc,GAAG,EAAE,CAAC,CAAC,sCAAsC;AAEjE,MAAM,OAAO,eAAe;IAClB,KAAK,GAAgB,CAAC,CAAC;IACvB,aAAa,GAAG,CAAC,CAAC;IAClB,WAAW,GAAG,CAAC,CAAC;IACP,MAAM,CAAS;IAEhC,YAAY,QAAQ,GAAG,KAAK;QAC1B,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;IACzB,CAAC;IAED,IAAI,IAAI,KAAkB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAE9C;;;OAGG;IACH,IAAI,CAAC,UAAkB;QACrB,MAAM,OAAO,GAAG,UAAU,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC;QAE/C,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;YACrB,IAAI,CAAC,aAAa,EAAE,CAAC;YACrB,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;gBAC5B,IAAI,UAAU,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;oBAC7F,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC;oBACvB,OAAO,IAAI,CAAC,KAAK,CAAC;gBACpB,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;YACvB,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;gBACnB,IAAI,CAAC,WAAW,EAAE,CAAC;gBACnB,IAAI,IAAI,CAAC,WAAW,IAAI,cAAc,EAAE,CAAC;oBACvC,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;oBACrB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,GAAG,CAAC,CAAgB,CAAC;oBACxD,OAAO,IAAI,CAAC,KAAK,CAAC;gBACpB,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;QACf,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;IACvB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @fundamental-engine/dom — the platform-adjacent layer: native-first registries that let the field
+ * engine treat the DOM as a connected, measurable, semantic environment. Strict dependency
+ * direction: this package depends on `Fundamental` (core) for contracts; core never depends on it.
+ *
+ * Registries: MeasurementRegistry · StateRegistry · FeedbackRegistry · RelationshipRegistry ·
+ * VisualBindingRegistry · OverlayRegistry, bound by createFieldPlatform.
+ *
+ * Also the browser environment adapter for the renderer-agnostic core engine: `browserHost()` (the
+ * default FieldHost), `createBrowserField()` (createField + browserHost), and the DOM download
+ * helpers — so core can import zero DOM.
+ */
+import { type FieldHandle, type FieldOptions } from '@fundamental-engine/core';
+export * from './types.ts';
+export * from './env.ts';
+export * from './schedule.ts';
+export * from './measurement.ts';
+export * from './state.ts';
+export * from './feedback.ts';
+export * from './relationships.ts';
+export * from './visual-bindings.ts';
+export * from './overlays.ts';
+export * from './lint.ts';
+export * from './platform.ts';
+export * from './metrics.ts';
+export * from './apply-recipe.ts';
+export * from './field-nav.ts';
+export * from './bind-data.ts';
+export * from './browser-host.ts';
+export * from './export-dom.ts';
+export * from './governor.ts';
+export * from './flip.ts';
+export * from './text-bodies.ts';
+export * from './contours.ts';
+export * from './thread-overlay.ts';
+export * from './perf.ts';
+/** Start the core engine on a canvas with the default browser host — `createField` + `browserHost()`. */
+export declare function createBrowserField(canvas: HTMLCanvasElement, opts?: Omit<FieldOptions, 'host'>): FieldHandle;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAe,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAG5F,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC;AAE1B,yGAAyG;AACzG,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,GAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAM,GAAG,WAAW,CAEhH"}

package/dist/index.js

@@ -0,0 +1,42 @@
+/**
+ * @fundamental-engine/dom — the platform-adjacent layer: native-first registries that let the field
+ * engine treat the DOM as a connected, measurable, semantic environment. Strict dependency
+ * direction: this package depends on `Fundamental` (core) for contracts; core never depends on it.
+ *
+ * Registries: MeasurementRegistry · StateRegistry · FeedbackRegistry · RelationshipRegistry ·
+ * VisualBindingRegistry · OverlayRegistry, bound by createFieldPlatform.
+ *
+ * Also the browser environment adapter for the renderer-agnostic core engine: `browserHost()` (the
+ * default FieldHost), `createBrowserField()` (createField + browserHost), and the DOM download
+ * helpers — so core can import zero DOM.
+ */
+import { createField } from '@fundamental-engine/core';
+import { browserHost } from "./browser-host.js";
+export * from "./types.js";
+export * from "./env.js";
+export * from "./schedule.js";
+export * from "./measurement.js";
+export * from "./state.js";
+export * from "./feedback.js";
+export * from "./relationships.js";
+export * from "./visual-bindings.js";
+export * from "./overlays.js";
+export * from "./lint.js";
+export * from "./platform.js";
+export * from "./metrics.js";
+export * from "./apply-recipe.js";
+export * from "./field-nav.js";
+export * from "./bind-data.js";
+export * from "./browser-host.js";
+export * from "./export-dom.js";
+export * from "./governor.js";
+export * from "./flip.js";
+export * from "./text-bodies.js";
+export * from "./contours.js";
+export * from "./thread-overlay.js";
+export * from "./perf.js";
+/** Start the core engine on a canvas with the default browser host — `createField` + `browserHost()`. */
+export function createBrowserField(canvas, opts = {}) {
+    return createField(canvas, { ...opts, host: browserHost() });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,WAAW,EAAuC,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC;AAE1B,yGAAyG;AACzG,MAAM,UAAU,kBAAkB,CAAC,MAAyB,EAAE,OAAmC,EAAE;IACjG,OAAO,WAAW,CAAC,MAAM,EAAE,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;AAC/D,CAAC"}