@fundamental-engine/core 0.4.0

package/dist/core/scalar-grid.d.ts

@@ -0,0 +1,51 @@
+/**
+ * A scalar field on a uniform grid — the backing store for field-buffer forces
+ * (§20.1 class [C]): `diffuse` (heat/concentration, `∂φ/∂t = D∇²φ`) and `propagate`
+ * (a travelling wave, `∂²φ/∂t² = c²∇²φ`). Particles `deposit` into it and read its
+ * `gradient`; the engine advances it once per frame with `step()`.
+ *
+ * Two stepping modes, chosen at construction (the field picks by grid name):
+ *  - `diffuse` — explicit heat equation with a decay term; D is clamped to the
+ *    stable range for the forward scheme.
+ *  - `wave`    — second-order leapfrog using a previous buffer; c² clamped for the
+ *    CFL limit, with light damping.
+ *
+ * Pure (no DOM), so every operation is golden-tested.
+ */
+import type { ScalarGrid, Vec2 } from './types.ts';
+export type GridMode = 'diffuse' | 'wave' | 'memory';
+export declare class ScalarGridImpl implements ScalarGrid {
+    readonly mode: GridMode;
+    readonly cell: number;
+    private W;
+    private H;
+    private cols;
+    private rows;
+    private cur;
+    private nxt;
+    private prev;
+    constructor(W: number, H: number, mode?: GridMode, cell?: number);
+    private clampCol;
+    private clampRow;
+    /** the current value at a clamped (Neumann boundary) cell. */
+    private at;
+    /** bilinear sample of the field in pixel space. */
+    sample(x: number, y: number): number;
+    /** add `amount` to the nearest cell. */
+    deposit(x: number, y: number, amount: number): void;
+    /** the current peak value across the field — for normalizing a heatmap to [0, 1]. */
+    max(): number;
+    /** central-difference gradient ∇φ in pixel space (points up-slope). */
+    gradient(x: number, y: number): Vec2;
+    /** advance one frame in the grid's mode. */
+    step(): void;
+    /** explicit heat equation `φ' = (φ + D·∇²φ)·(1 − decay)` (§20.10). */
+    stepDiffuse(D?: number, decay?: number): void;
+    /** leapfrog wave `φ' = 2φ − φ_prev + c²·∇²φ`, lightly damped (§20.10). */
+    stepWave(c2?: number, damping?: number): void;
+    /** Zero every cell in all internal buffers (cur, nxt, prev). */
+    clear(): void;
+    /** resize to a new viewport, preserving nothing (rebuilds the buffers). */
+    resize(W: number, H: number): void;
+}
+//# sourceMappingURL=scalar-grid.d.ts.map

package/dist/core/scalar-grid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scalar-grid.d.ts","sourceRoot":"","sources":["../../src/core/scalar-grid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAErD,qBAAa,cAAe,YAAW,UAAU;IAC/C,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,CAAC,CAAS;IAClB,OAAO,CAAC,CAAC,CAAS;IAClB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,GAAG,CAAe;IAC1B,OAAO,CAAC,GAAG,CAAe;IAC1B,OAAO,CAAC,IAAI,CAAe;gBAIf,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,QAAoB,EAAE,IAAI,SAAK;IAavE,OAAO,CAAC,QAAQ;IAGhB,OAAO,CAAC,QAAQ;IAGhB,8DAA8D;IAC9D,OAAO,CAAC,EAAE;IAIV,mDAAmD;IACnD,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;IAYpC,wCAAwC;IACxC,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAMnD,qFAAqF;IACrF,GAAG,IAAI,MAAM;IAMb,uEAAuE;IACvE,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAQpC,4CAA4C;IAC5C,IAAI,IAAI,IAAI;IAMZ,sEAAsE;IACtE,WAAW,CAAC,CAAC,SAAO,EAAE,KAAK,SAAO,GAAG,IAAI;IAiBzC,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,SAAO,EAAE,OAAO,SAAQ,GAAG,IAAI;IAmB1C,gEAAgE;IAChE,KAAK,IAAI,IAAI;IAMb,2EAA2E;IAC3E,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;CAWnC"}

package/dist/core/scalar-grid.js

@@ -0,0 +1,146 @@
+/**
+ * A scalar field on a uniform grid — the backing store for field-buffer forces
+ * (§20.1 class [C]): `diffuse` (heat/concentration, `∂φ/∂t = D∇²φ`) and `propagate`
+ * (a travelling wave, `∂²φ/∂t² = c²∇²φ`). Particles `deposit` into it and read its
+ * `gradient`; the engine advances it once per frame with `step()`.
+ *
+ * Two stepping modes, chosen at construction (the field picks by grid name):
+ *  - `diffuse` — explicit heat equation with a decay term; D is clamped to the
+ *    stable range for the forward scheme.
+ *  - `wave`    — second-order leapfrog using a previous buffer; c² clamped for the
+ *    CFL limit, with light damping.
+ *
+ * Pure (no DOM), so every operation is golden-tested.
+ */
+export class ScalarGridImpl {
+    mode;
+    cell;
+    W;
+    H;
+    cols;
+    rows;
+    cur;
+    nxt;
+    prev; // previous frame, for the wave scheme
+    // NB: explicit field assignment, not constructor parameter properties — Node's
+    // strip-only type-stripping (which runs node:test) rejects the latter.
+    constructor(W, H, mode = 'diffuse', cell = 32) {
+        this.W = W;
+        this.H = H;
+        this.mode = mode;
+        this.cell = cell;
+        this.cols = Math.max(2, Math.ceil(W / cell) + 1);
+        this.rows = Math.max(2, Math.ceil(H / cell) + 1);
+        const n = this.cols * this.rows;
+        this.cur = new Float32Array(n);
+        this.nxt = new Float32Array(n);
+        this.prev = new Float32Array(n);
+    }
+    clampCol(ix) {
+        return ix < 0 ? 0 : ix >= this.cols ? this.cols - 1 : ix;
+    }
+    clampRow(iy) {
+        return iy < 0 ? 0 : iy >= this.rows ? this.rows - 1 : iy;
+    }
+    /** the current value at a clamped (Neumann boundary) cell. */
+    at(ix, iy) {
+        return this.cur[this.clampRow(iy) * this.cols + this.clampCol(ix)];
+    }
+    /** bilinear sample of the field in pixel space. */
+    sample(x, y) {
+        const gx = x / this.cell;
+        const gy = y / this.cell;
+        const ix = Math.floor(gx);
+        const iy = Math.floor(gy);
+        const fx = gx - ix;
+        const fy = gy - iy;
+        const top = this.at(ix, iy) * (1 - fx) + this.at(ix + 1, iy) * fx;
+        const bot = this.at(ix, iy + 1) * (1 - fx) + this.at(ix + 1, iy + 1) * fx;
+        return top * (1 - fy) + bot * fy;
+    }
+    /** add `amount` to the nearest cell. */
+    deposit(x, y, amount) {
+        const ix = this.clampCol(Math.round(x / this.cell));
+        const iy = this.clampRow(Math.round(y / this.cell));
+        this.cur[iy * this.cols + ix] += amount;
+    }
+    /** the current peak value across the field — for normalizing a heatmap to [0, 1]. */
+    max() {
+        let m = 0;
+        for (let i = 0; i < this.cur.length; i++)
+            if (this.cur[i] > m)
+                m = this.cur[i];
+        return m;
+    }
+    /** central-difference gradient ∇φ in pixel space (points up-slope). */
+    gradient(x, y) {
+        const h = this.cell;
+        return {
+            x: (this.sample(x + h, y) - this.sample(x - h, y)) / (2 * h),
+            y: (this.sample(x, y + h) - this.sample(x, y - h)) / (2 * h),
+        };
+    }
+    /** advance one frame in the grid's mode. */
+    step() {
+        if (this.mode === 'wave')
+            this.stepWave();
+        else if (this.mode === 'memory')
+            this.stepDiffuse(0.03, 0.004); // barely blur, fade slowly
+        else
+            this.stepDiffuse();
+    }
+    /** explicit heat equation `φ' = (φ + D·∇²φ)·(1 − decay)` (§20.10). */
+    stepDiffuse(D = 0.18, decay = 0.01) {
+        const Dc = D < 0 ? 0 : D > 0.24 ? 0.24 : D; // forward-scheme stability
+        const keep = 1 - decay;
+        const { cols, rows, cur, nxt } = this;
+        for (let iy = 0; iy < rows; iy++) {
+            for (let ix = 0; ix < cols; ix++) {
+                const i = iy * cols + ix;
+                const lap = this.at(ix - 1, iy) + this.at(ix + 1, iy) + this.at(ix, iy - 1) + this.at(ix, iy + 1) -
+                    4 * cur[i];
+                nxt[i] = (cur[i] + Dc * lap) * keep;
+            }
+        }
+        this.cur = nxt;
+        this.nxt = cur;
+    }
+    /** leapfrog wave `φ' = 2φ − φ_prev + c²·∇²φ`, lightly damped (§20.10). */
+    stepWave(c2 = 0.25, damping = 0.002) {
+        const cc = c2 < 0 ? 0 : c2 > 0.5 ? 0.5 : c2; // CFL limit
+        const keep = 1 - damping;
+        const { cols, rows, cur, prev, nxt } = this;
+        for (let iy = 0; iy < rows; iy++) {
+            for (let ix = 0; ix < cols; ix++) {
+                const i = iy * cols + ix;
+                const lap = this.at(ix - 1, iy) + this.at(ix + 1, iy) + this.at(ix, iy - 1) + this.at(ix, iy + 1) -
+                    4 * cur[i];
+                nxt[i] = (2 * cur[i] - prev[i] + cc * lap) * keep;
+            }
+        }
+        // rotate buffers: prev ← cur, cur ← nxt, reuse old prev as next scratch
+        this.prev = cur;
+        this.cur = nxt;
+        this.nxt = prev;
+    }
+    /** Zero every cell in all internal buffers (cur, nxt, prev). */
+    clear() {
+        this.cur.fill(0);
+        this.nxt.fill(0);
+        this.prev.fill(0);
+    }
+    /** resize to a new viewport, preserving nothing (rebuilds the buffers). */
+    resize(W, H) {
+        if (W === this.W && H === this.H)
+            return;
+        this.W = W;
+        this.H = H;
+        this.cols = Math.max(2, Math.ceil(W / this.cell) + 1);
+        this.rows = Math.max(2, Math.ceil(H / this.cell) + 1);
+        const n = this.cols * this.rows;
+        this.cur = new Float32Array(n);
+        this.nxt = new Float32Array(n);
+        this.prev = new Float32Array(n);
+    }
+}
+//# sourceMappingURL=scalar-grid.js.map

package/dist/core/scalar-grid.js.map

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

package/dist/core/scanner.d.ts

@@ -0,0 +1,59 @@
+/**
+ * The DOM scanner — turns `[data-body]` elements into bodies the engine reads
+ * (§2.1, §3.1). The *parsing* is a pure function (testable without a DOM); the
+ * *measurement* (`getBoundingClientRect`) is thin glue.
+ */
+import type { Body } from './types.ts';
+/** A minimal attribute accessor — `name` is the suffix after `data-`. */
+export interface BodyAttrs {
+    get(name: string): string | null | undefined;
+    has(name: string): boolean;
+}
+/** The static (non-runtime) fields of a Body, parsed from attributes. */
+export type StaticBody = Pick<Body, 'tokens' | 'strength' | 'range' | 'absorbR' | 'capacity' | 'spin' | 'angle' | 'ux' | 'uy' | 'when' | 'feedback' | 'shaped' | 'fmin' | 'fmax' | 'opsz' | 'pair' | 'twist' | 'warpScale' | 'life' | 'cap' | 'budgeted' | 'screenMin' | 'classified' | 'M'>;
+/** Parse a body's static parameters from its `data-*` attributes (pure). */
+export declare function parseBodyParams(a: BodyAttrs): StaticBody;
+/** Expand a preset name into the static params of its virtual bodies (pure, §20.9).
+ *  An unknown preset yields `[]` — the element simply contributes nothing. */
+export declare function expandPreset(name: string): StaticBody[];
+/**
+ * The source-budget guard (workover v0.3, §"Source and sink rules"): a class-[S] source body
+ * (`spawn` — see `SOURCE_TOKENS`) must declare at least one of `data-life` / `data-cap` /
+ * `data-budget` / `data-sink`. An unbudgeted source gets the safe default budget
+ * (`data-life="300"`, `data-cap="120"`) so its live emission is bounded at ~cap regardless of
+ * the pool ceiling — and, in dev (the same flag that gates the contract guards), a LOUD
+ * `console.warn` naming the element and the missing attributes. Mutates `sb` in place; pure
+ * over its inputs otherwise (no DOM reads).
+ */
+export declare function guardSourceBudget(sb: StaticBody, name?: string): void;
+/** Build a single body from an element, parsing its `data-*` (or an explicit `attrs` view,
+ *  for event-registered shadow-DOM hosts whose attrs may be supplied out of band). */
+export declare function bodyFromElement(el: HTMLElement, attrs?: BodyAttrs): Body;
+/**
+ * A `BodyAttrs` for an element authored via `data-intent` or `data-field-role` instead of a raw
+ * `data-body`. The intent is compiled (authoring §4) or the role mapped to a default token; explicit
+ * `data-*` on the element still wins over the compiled defaults (precedence §3 — component props beat
+ * intent defaults). Returns null when the element carries neither an intent nor a known role.
+ */
+export declare function authoredAttrs(el: HTMLElement): BodyAttrs | null;
+/**
+ * The selector matching every element the scanner turns into one or more bodies: a raw `data-body`,
+ * a `data-preset`, or an element authored via `data-intent` / `data-field-role`. This is the single
+ * source of truth shared with the platform's MeasurementRegistry (Phase D) so the two never drift.
+ * `querySelectorAll` returns each element once, even if it matches several clauses.
+ */
+export declare const BODY_SELECTOR = "[data-body], [data-preset], [data-intent]:not([data-body]), [data-field-role]:not([data-body]):not([data-intent])";
+/**
+ * Every element in `root` that contributes a body, deduped and in document order. The geometry
+ * source for the platform MeasurementRegistry; pure over the passed root (no globals). A
+ * `data-preset` element still expands to several virtual bodies in `scanBodies`, but it is one
+ * element with one rect — which is exactly what measurement registers.
+ */
+export declare function bodyElements(root: ParentNode): Element[];
+/** Scan a DOM subtree for `[data-body]` and `[data-preset]` elements → bodies (§2.1,
+ *  §20.9). A preset element emits one virtual body per entry, all sharing its rect;
+ *  the plain `data-body` path is unchanged. */
+export declare function scanBodies(root: ParentNode): Body[];
+/** Refresh each body's measured rect, visibility, and engaged state (§2.1). */
+export declare function measureBodies(bodies: readonly Body[], W: number, H: number): void;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/core/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/core/scanner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAUvC,yEAAyE;AACzE,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC7C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5B;AAED,yEAAyE;AACzE,MAAM,MAAM,UAAU,GAAG,IAAI,CAC3B,IAAI,EACF,QAAQ,GACR,UAAU,GACV,OAAO,GACP,SAAS,GACT,UAAU,GACV,MAAM,GACN,OAAO,GACP,IAAI,GACJ,IAAI,GACJ,MAAM,GACN,UAAU,GACV,QAAQ,GACR,MAAM,GACN,MAAM,GACN,MAAM,GACN,MAAM,GACN,OAAO,GACP,WAAW,GACX,MAAM,GACN,KAAK,GACL,UAAU,GACV,WAAW,GACX,YAAY,GACZ,GAAG,CACN,CAAC;AAEF,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,CAAC,EAAE,SAAS,GAAG,UAAU,CAoDxD;AAqBD;8EAC8E;AAC9E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,CAGvD;AAUD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,SAAW,GAAG,IAAI,CAYvE;AA8BD;sFACsF;AACtF,wBAAgB,eAAe,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,IAAI,CAExE;AAgBD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI,CA6B/D;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa,sHAC2F,CAAC;AAEtH;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,EAAE,CAExD;AAED;;+CAE+C;AAC/C,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,EAAE,CAkBnD;AAED,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,IAAI,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAcjF"}

package/dist/core/scanner.js

@@ -0,0 +1,260 @@
+/**
+ * The DOM scanner — turns `[data-body]` elements into bodies the engine reads
+ * (§2.1, §3.1). The *parsing* is a pure function (testable without a DOM); the
+ * *measurement* (`getBoundingClientRect`) is thin glue.
+ */
+import { PRESETS } from "../config/presets.js";
+import { classifyBodyTokens, SOURCE_DEFAULT_CAP, SOURCE_DEFAULT_LIFE, } from "../config/forces.config.js";
+import { contractChecksEnabled } from "../contracts/guards.js";
+import { compileIntent } from "../recipes/intent.js";
+/** Parse a body's static parameters from its `data-*` attributes (pure). */
+export function parseBodyParams(a) {
+    const num = (name, def) => {
+        const v = Number.parseFloat(a.get(name) ?? '');
+        return Number.isFinite(v) ? v : def;
+    };
+    const strength = num('strength', 0.5);
+    const angle = (num('angle', 0) * Math.PI) / 180;
+    const spinRaw = a.get('spin');
+    const spin = spinRaw == null ? 1 : Number.isFinite(Number.parseFloat(spinRaw)) ? Number.parseFloat(spinRaw) : 0;
+    const tokens = (a.get('body') ?? '').split(/\s+/).filter(Boolean);
+    // the modifier contract (workover v0.3): classify tokens into {modifiers, forces, sources}
+    // at parse time, so the integrator consumes the classified sets in the documented order.
+    const classified = classifyBodyTokens(tokens);
+    // the source budget contract: an [S] body declares at least one of
+    // data-life / data-cap / data-budget / data-sink (guarded in makeBody/guardSourceBudget).
+    const lifeRaw = a.get('life');
+    const capRaw = a.get('cap');
+    const life = Number.parseFloat(lifeRaw ?? '');
+    const cap = Number.parseFloat(capRaw ?? '');
+    const budgeted = lifeRaw != null || capRaw != null || a.has('budget') || a.has('sink');
+    return {
+        tokens,
+        classified,
+        ...(Number.isFinite(life) && life > 0 ? { life } : {}),
+        ...(Number.isFinite(cap) && cap > 0 ? { cap } : {}),
+        budgeted,
+        strength,
+        range: num('range', 280),
+        absorbR: num('absorb', 64),
+        capacity: num('max', 60),
+        spin,
+        angle,
+        ux: Math.cos(angle),
+        uy: Math.sin(angle),
+        when: a.get('when') ?? '',
+        feedback: a.has('feedback'),
+        shaped: a.has('shaped'), // data-shaped → forces sample the element's box surface (Stage C)
+        fmin: num('fmin', 0),
+        fmax: num('fmax', 0),
+        opsz: a.get('opsz') ?? '',
+        // `warp` relocate pairing (§22.3): the paired body's selector + the twist/scale applied to
+        // matter that crosses the throat. Undefined `pair` ⇒ not a wormhole (the force no-ops).
+        pair: a.get('pair') || undefined,
+        twist: (num('twist', 0) * Math.PI) / 180,
+        warpScale: num('scale', 1),
+        // `screen` quiet zones (workover v0.3): the attenuation floor (0 = full cancellation allowed).
+        screenMin: num('screen-min', 0),
+        // source mass M = strength · k_g (k_g = 1 for now, §20.10).
+        M: strength,
+    };
+}
+/** A `BodyAttrs` view over one preset entry, so it parses through the very same
+ *  defaults as a real `data-*` element (single source of truth in `parseBodyParams`).
+ *  The entry's keys map to the attribute suffixes the parser already reads. */
+function entryAttrs(e) {
+    const map = { body: e.body };
+    if (e.strength != null)
+        map.strength = String(e.strength);
+    if (e.range != null)
+        map.range = String(e.range);
+    if (e.spin != null)
+        map.spin = String(e.spin);
+    if (e.angle != null)
+        map.angle = String(e.angle);
+    if (e.absorb != null)
+        map.absorb = String(e.absorb);
+    if (e.max != null)
+        map.max = String(e.max);
+    if (e.life != null)
+        map.life = String(e.life);
+    if (e.cap != null)
+        map.cap = String(e.cap);
+    return {
+        get: (name) => map[name] ?? null,
+        has: (name) => name in map,
+    };
+}
+/** Expand a preset name into the static params of its virtual bodies (pure, §20.9).
+ *  An unknown preset yields `[]` — the element simply contributes nothing. */
+export function expandPreset(name) {
+    const entries = PRESETS[name];
+    return entries ? entries.map((e) => parseBodyParams(entryAttrs(e))) : [];
+}
+/** A compact element description for guard messages: `tag#id.class` (best effort). */
+function describeEl(el) {
+    const tag = (el.tagName ?? 'element').toLowerCase();
+    const id = el.id ? `#${el.id}` : '';
+    const cls = typeof el.className === 'string' && el.className ? `.${el.className.split(/\s+/)[0]}` : '';
+    return `<${tag}${id}${cls}>`;
+}
+/**
+ * The source-budget guard (workover v0.3, §"Source and sink rules"): a class-[S] source body
+ * (`spawn` — see `SOURCE_TOKENS`) must declare at least one of `data-life` / `data-cap` /
+ * `data-budget` / `data-sink`. An unbudgeted source gets the safe default budget
+ * (`data-life="300"`, `data-cap="120"`) so its live emission is bounded at ~cap regardless of
+ * the pool ceiling — and, in dev (the same flag that gates the contract guards), a LOUD
+ * `console.warn` naming the element and the missing attributes. Mutates `sb` in place; pure
+ * over its inputs otherwise (no DOM reads).
+ */
+export function guardSourceBudget(sb, name = '<body>') {
+    if (!sb.classified || sb.classified.sources.length === 0 || sb.budgeted)
+        return;
+    sb.life = SOURCE_DEFAULT_LIFE;
+    sb.cap = SOURCE_DEFAULT_CAP;
+    if (contractChecksEnabled()) {
+        console.warn(`[field-ui:UNBUDGETED_SOURCE] ${name} runs the source force "${sb.classified.sources.join(' ')}" ` +
+            `with none of data-life / data-cap / data-budget / data-sink. Applying the safe default budget ` +
+            `(data-life="${SOURCE_DEFAULT_LIFE}", data-cap="${SOURCE_DEFAULT_CAP}") — declare one to make ` +
+            `the source's budget explicit (workover v0.3 source rules).`);
+    }
+}
+/** A fresh Body from static params, all runtime fields zeroed — shared by both paths. */
+function makeBody(el, sb) {
+    guardSourceBudget(sb, describeEl(el));
+    return {
+        el,
+        ...sb,
+        tint: el.dataset.color, // data-color → pigment tint (§20.8); undefined if absent
+        cx: 0,
+        cy: 0,
+        hw: 0,
+        hh: 0,
+        on: false,
+        vis: true,
+        accreted: 0,
+        count: 0,
+        d: 0,
+        attn: 1,
+    };
+}
+/** Read an element's own `data-*` attributes as a `BodyAttrs` view. */
+function elementAttrs(el) {
+    return {
+        get: (name) => el.getAttribute('data-' + name),
+        has: (name) => el.hasAttribute('data-' + name),
+    };
+}
+/** Build a single body from an element, parsing its `data-*` (or an explicit `attrs` view,
+ *  for event-registered shadow-DOM hosts whose attrs may be supplied out of band). */
+export function bodyFromElement(el, attrs) {
+    return makeBody(el, parseBodyParams(attrs ?? elementAttrs(el)));
+}
+/**
+ * Default force tokens per `data-field-role` (worldclass §12). Force-like roles map to a token;
+ * `sensor`/`display` are feedback-only responders (no token, density still sampled). Used only when
+ * a role element has no explicit `data-body`/`data-intent`.
+ */
+const FIELD_ROLE_TOKENS = {
+    source: 'jet',
+    sink: 'sink',
+    anchor: 'tether',
+    boundary: 'wall',
+    sensor: '', // feedback-only
+    display: '', // feedback-only
+};
+/**
+ * A `BodyAttrs` for an element authored via `data-intent` or `data-field-role` instead of a raw
+ * `data-body`. The intent is compiled (authoring §4) or the role mapped to a default token; explicit
+ * `data-*` on the element still wins over the compiled defaults (precedence §3 — component props beat
+ * intent defaults). Returns null when the element carries neither an intent nor a known role.
+ */
+export function authoredAttrs(el) {
+    let compiled = null;
+    const intent = el.getAttribute('data-intent');
+    if (intent) {
+        const intensityAttr = el.getAttribute('data-intensity');
+        const c = compileIntent(intent, {
+            intensity: intensityAttr != null ? Number(intensityAttr) : undefined,
+            risk: el.getAttribute('data-risk') ?? undefined,
+        });
+        if (c) {
+            compiled = { body: c.body };
+            if (c.strength != null)
+                compiled.strength = String(c.strength);
+            if (c.range != null)
+                compiled.range = String(c.range);
+            if (c.feedback)
+                compiled.feedback = '';
+        }
+    }
+    if (!compiled) {
+        const role = el.getAttribute('data-field-role');
+        if (role != null && role in FIELD_ROLE_TOKENS)
+            compiled = { body: FIELD_ROLE_TOKENS[role], feedback: '' };
+    }
+    if (!compiled)
+        return null;
+    const defaults = compiled;
+    return {
+        get: (name) => el.getAttribute('data-' + name) ?? defaults[name] ?? null,
+        has: (name) => el.hasAttribute('data-' + name) || name in defaults,
+    };
+}
+/**
+ * The selector matching every element the scanner turns into one or more bodies: a raw `data-body`,
+ * a `data-preset`, or an element authored via `data-intent` / `data-field-role`. This is the single
+ * source of truth shared with the platform's MeasurementRegistry (Phase D) so the two never drift.
+ * `querySelectorAll` returns each element once, even if it matches several clauses.
+ */
+export const BODY_SELECTOR = '[data-body], [data-preset], [data-intent]:not([data-body]), [data-field-role]:not([data-body]):not([data-intent])';
+/**
+ * Every element in `root` that contributes a body, deduped and in document order. The geometry
+ * source for the platform MeasurementRegistry; pure over the passed root (no globals). A
+ * `data-preset` element still expands to several virtual bodies in `scanBodies`, but it is one
+ * element with one rect — which is exactly what measurement registers.
+ */
+export function bodyElements(root) {
+    return [...root.querySelectorAll(BODY_SELECTOR)];
+}
+/** Scan a DOM subtree for `[data-body]` and `[data-preset]` elements → bodies (§2.1,
+ *  §20.9). A preset element emits one virtual body per entry, all sharing its rect;
+ *  the plain `data-body` path is unchanged. */
+export function scanBodies(root) {
+    const bodies = [];
+    root.querySelectorAll('[data-body]').forEach((node) => {
+        bodies.push(bodyFromElement(node));
+    });
+    root.querySelectorAll('[data-preset]').forEach((node) => {
+        const el = node;
+        for (const sb of expandPreset(el.dataset.preset ?? ''))
+            bodies.push(makeBody(el, sb));
+    });
+    // authored via intent/role rather than a raw data-body (authoring §4, worldclass §12). An
+    // explicit data-body always takes the plain path above, so these never double-register.
+    root
+        .querySelectorAll('[data-intent]:not([data-body]), [data-field-role]:not([data-body]):not([data-intent])')
+        .forEach((node) => {
+        const a = authoredAttrs(node);
+        if (a)
+            bodies.push(bodyFromElement(node, a));
+    });
+    return bodies;
+}
+/** Refresh each body's measured rect, visibility, and engaged state (§2.1). */
+export function measureBodies(bodies, W, H) {
+    const margin = H * 0.15;
+    for (const b of bodies) {
+        // a shadow-DOM body may carry a custom rect provider (closed root, internal core); the
+        // host's own box is the default (shadow-dom.md §10/§16).
+        const r = b.rect ? b.rect() : b.el.getBoundingClientRect();
+        b.cx = r.left + r.width / 2;
+        b.cy = r.top + r.height / 2;
+        b.hw = r.width / 2;
+        b.hh = r.height / 2;
+        b.on = b.el.dataset.active === '1';
+        b.vis =
+            r.bottom > -margin && r.top < H + margin && r.right > -margin && r.left < W + margin;
+    }
+}
+//# sourceMappingURL=scanner.js.map

package/dist/core/scanner.js.map

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

package/dist/core/shadow.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Shadow-DOM participation (docs/engine-reference/shadow-dom.md) — the host-first, event-driven body
+ * registration model. A component encapsulates its rendering but exposes a public physical
+ * body: it dispatches a `composed` registration event, the field registers the HOST (never
+ * inspecting the shadow tree), measures it by `getBoundingClientRect` or an optional
+ * `getRect`, and writes field state back as CSS variables on the host (or a write target).
+ *
+ * Two halves, deliberately split so the engine logic is testable without a DOM event system:
+ *  - `FieldController` — the component side: dispatches register / unregister / update.
+ *  - `ShadowRegistry`   — the engine side: holds registered hosts, prunes the disconnected,
+ *                          and builds bodies. The DOM-event wiring lives in `field.ts`.
+ */
+import type { Body } from './types.ts';
+import type { BodyAttrs } from './scanner.ts';
+/** The registration event names. `composed: true` lets them cross the shadow boundary. */
+export declare const REGISTER_BODY = "field:register-body";
+export declare const UNREGISTER_BODY = "field:unregister-body";
+export declare const UPDATE_BODY = "field:update-body";
+/** Payload of a `field:register-body` event (shadow-dom.md §7). */
+export interface RegisterBodyDetail {
+    /** the public physical element — usually the custom-element host. */
+    element: HTMLElement;
+    /** optional rectangle provider, when the body's box is not the host box (closed roots). */
+    getRect?: () => DOMRect;
+    /** explicit body attributes (suffix → value, e.g. `{ body: 'attract', strength: '0.9' }`);
+     *  when omitted the engine reads the host's own `data-*`. */
+    attrs?: Record<string, string>;
+    /** element that receives the CSS-variable write-back; defaults to `element`. */
+    writeTarget?: HTMLElement;
+}
+/**
+ * Component-side helper (shadow-dom.md §31.1) so a custom element joins the field without
+ * repeating event boilerplate. Construct with the host (and optional extra detail), then
+ * call `connect()` / `disconnect()` / `update()` from the element's lifecycle callbacks.
+ */
+export declare class FieldController {
+    private readonly host;
+    private readonly detail;
+    constructor(host: HTMLElement, detail?: Omit<Partial<RegisterBodyDetail>, 'element'>);
+    /** register the host as a body — call from `connectedCallback`. */
+    connect(): void;
+    /** remove the body — call from `disconnectedCallback`. */
+    disconnect(): void;
+    /** refresh attrs/geometry — call from `attributeChangedCallback`. */
+    update(): void;
+    private emit;
+}
+/**
+ * Engine-side registry of event-registered hosts. Pure of the DOM event system: the field
+ * feeds it details and asks for bodies each scan. It prunes hosts that have left the document
+ * (do not rely on `disconnectedCallback` alone, §15) and never touches a shadow root.
+ */
+export declare class ShadowRegistry {
+    private readonly hosts;
+    /** Register (or, idempotently, refresh) a host. */
+    register(detail: RegisterBodyDetail): void;
+    /** Drop a host. */
+    unregister(element: HTMLElement): void;
+    /** how many hosts are currently registered (post-prune count is via `bodies`). */
+    get size(): number;
+    /**
+     * Build a `Body` per live registered host, pruning any that have disconnected. `build` is
+     * the scanner's `bodyFromElement`; `attrs` (if supplied at registration) override the
+     * host's own `data-*`, else the host is read directly. A custom `getRect` and `writeTarget`
+     * are attached to the resulting body.
+     */
+    bodies(build: (el: HTMLElement, attrs?: BodyAttrs) => Body): Body[];
+}
+//# sourceMappingURL=shadow.d.ts.map

package/dist/core/shadow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadow.d.ts","sourceRoot":"","sources":["../../src/core/shadow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,0FAA0F;AAC1F,eAAO,MAAM,aAAa,wBAAwB,CAAC;AACnD,eAAO,MAAM,eAAe,0BAA0B,CAAC;AACvD,eAAO,MAAM,WAAW,sBAAsB,CAAC;AAE/C,mEAAmE;AACnE,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,OAAO,EAAE,WAAW,CAAC;IACrB,2FAA2F;IAC3F,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC;IACxB;iEAC6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,gFAAgF;IAChF,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED;;;;GAIG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+C;gBAE1D,IAAI,EAAE,WAAW,EAAE,MAAM,GAAE,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,SAAS,CAAM;IAKxF,mEAAmE;IACnE,OAAO,IAAI,IAAI;IAGf,0DAA0D;IAC1D,UAAU,IAAI,IAAI;IAGlB,qEAAqE;IACrE,MAAM,IAAI,IAAI;IAId,OAAO,CAAC,IAAI;CAIb;AAOD;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8C;IAEpE,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAI1C,mBAAmB;IACnB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAItC,kFAAkF;IAClF,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,SAAS,KAAK,IAAI,GAAG,IAAI,EAAE;CAepE"}