@fundamental-engine/core 0.4.0

package/dist/core/currents.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Currents — the carrier waves (§24, §2.3).
+ *
+ * Five layered standing waveforms that form the resting structure of the field:
+ * they carry **bound** particles (shimmer) and impart a flow on the **free**
+ * ones. Pure data + math here; rendering and the bound/free reservoir live in
+ * the field loop.
+ */
+import type { RGB } from './math.ts';
+export interface Wave {
+    /** vertical anchor as a fraction of viewport height. */
+    baseFrac: number;
+    amp: number;
+    freq: number;
+    phase: number;
+    speed: number;
+    color: RGB;
+    /** 0 (back) … 1 (front) — drives opacity and parallax. */
+    depth: number;
+    /** travel direction (±1). */
+    dir: number;
+    /** scroll-parallax offset, eased. */
+    offsetY: number;
+}
+/** A particle riding a wave line (the shimmer). */
+export interface BoundParticle {
+    /** index into the wave array. */
+    wi: number;
+    /** position along the wave, 0…1. */
+    progress: number;
+    /** vertical jitter offset. */
+    phase: number;
+    size: number;
+    glow: boolean;
+    /** drift speed along the wave (±). */
+    speed: number;
+}
+/** Build the five wave layers, coloring them from the palette (§24.4). */
+export declare function buildWaves(palette: readonly RGB[]): Wave[];
+/** Build the bound shimmer pool: `round(16·density)` riders per wave (§2.5). */
+export declare function buildBound(waveCount: number, density: number, rand: () => number): BoundParticle[];
+/** An engaged element the lines bend toward — the "spine" (§24). */
+export interface WavePull {
+    x: number;
+    y: number;
+    /** strength 0…1 (eased as the element engages/releases). */
+    k: number;
+}
+/** The wave's y at horizontal position `x` and `time` seconds (§2.3). */
+export declare function waveYat(w: Wave, x: number, time: number, H: number, waveSpeed?: number, amplitude?: number, pull?: WavePull): number;
+/** The wave's slope at `x` — the derivative the free particles drift along. */
+export declare function waveSlope(w: Wave, x: number, time: number, waveSpeed?: number, amplitude?: number): number;
+//# sourceMappingURL=currents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"currents.d.ts","sourceRoot":"","sources":["../../src/core/currents.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAErC,MAAM,WAAW,IAAI;IACnB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,GAAG,CAAC;IACX,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,mDAAmD;AACnD,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;CACf;AAKD,0EAA0E;AAC1E,wBAAgB,UAAU,CAAC,OAAO,EAAE,SAAS,GAAG,EAAE,GAAG,IAAI,EAAE,CAgB1D;AAED,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,MAAM,GAAG,aAAa,EAAE,CAgBlG;AAED,oEAAoE;AACpE,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,4DAA4D;IAC5D,CAAC,EAAE,MAAM,CAAC;CACX;AAED,yEAAyE;AACzE,wBAAgB,OAAO,CACrB,CAAC,EAAE,IAAI,EACP,CAAC,EAAE,MAAM,EACT,IAAI,EAAE,MAAM,EACZ,CAAC,EAAE,MAAM,EACT,SAAS,SAAI,EACb,SAAS,SAAI,EACb,IAAI,CAAC,EAAE,QAAQ,GACd,MAAM,CAaR;AAED,+EAA+E;AAC/E,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,SAAI,EAAE,SAAS,SAAI,GAAG,MAAM,CAIhG"}

package/dist/core/currents.js

@@ -0,0 +1,65 @@
+/**
+ * Currents — the carrier waves (§24, §2.3).
+ *
+ * Five layered standing waveforms that form the resting structure of the field:
+ * they carry **bound** particles (shimmer) and impart a flow on the **free**
+ * ones. Pure data + math here; rendering and the bound/free reservoir live in
+ * the field loop.
+ */
+const LAYERS = 5;
+const BASE = [0.24, 0.4, 0.55, 0.7, 0.85];
+/** Build the five wave layers, coloring them from the palette (§24.4). */
+export function buildWaves(palette) {
+    const waves = [];
+    for (let i = 0; i < LAYERS; i++) {
+        waves.push({
+            baseFrac: BASE[i] ?? 0.5,
+            amp: 22 + i * 15,
+            freq: 0.0012 + i * 0.0008,
+            phase: (i * 1.7) % 6.28, // deterministic spread (no Math.random at module build)
+            speed: 0.00013 + i * 0.00009,
+            color: palette[i % palette.length] ?? [77, 163, 255],
+            depth: i / (LAYERS - 1),
+            dir: i % 2 ? -1 : 1,
+            offsetY: 0,
+        });
+    }
+    return waves;
+}
+/** Build the bound shimmer pool: `round(16·density)` riders per wave (§2.5). */
+export function buildBound(waveCount, density, rand) {
+    const per = Math.round(16 * density);
+    const bound = [];
+    for (let wi = 0; wi < waveCount; wi++) {
+        for (let k = 0; k < per; k++) {
+            bound.push({
+                wi,
+                progress: rand(),
+                phase: (rand() - 0.5) * 0.22 * Math.PI,
+                size: 0.7 + rand() * 1.5,
+                glow: rand() < 0.3,
+                speed: (0.00035 + rand() * 0.0009) * (rand() < 0.5 ? 1 : -1),
+            });
+        }
+    }
+    return bound;
+}
+/** The wave's y at horizontal position `x` and `time` seconds (§2.3). */
+export function waveYat(w, x, time, H, waveSpeed = 1, amplitude = 1, pull) {
+    let y = w.baseFrac * H +
+        w.offsetY +
+        Math.sin(x * w.freq + w.phase + time * w.speed * 1000 * waveSpeed) * w.amp * amplitude;
+    // the engaged element bends the lines locally toward it (Gaussian falloff).
+    if (pull && pull.k > 0.001) {
+        const dx = x - pull.x;
+        const s = 260;
+        const fall = Math.exp(-(dx * dx) / (2 * s * s));
+        y += (pull.y - y) * 0.42 * fall * pull.k * (0.45 + w.depth * 0.55);
+    }
+    return y;
+}
+/** The wave's slope at `x` — the derivative the free particles drift along. */
+export function waveSlope(w, x, time, waveSpeed = 1, amplitude = 1) {
+    return (Math.cos(x * w.freq + w.phase + time * w.speed * 1000 * waveSpeed) * w.amp * w.freq * amplitude);
+}
+//# sourceMappingURL=currents.js.map

package/dist/core/currents.js.map

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

package/dist/core/dock.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Dock — the pure, DOM-free decision core for element capture (§22.3, agent-consumption-model).
+ *
+ * The element-level analogue of particle capture: a `[data-move][data-dock]` element drifting under
+ * the field, when it falls inside a `sink` body's capture radius, **docks** — it collapses toward the
+ * sink core (translate + scale → 0) and is held until the sink releases (supernova), which restores
+ * it. This module computes the trigger, the eased collapse progress, and the transform; `field.ts`
+ * performs the DOM writes, the a11y toggle, and the `field:captured`/`field:released` dispatch.
+ */
+import type { Vec2 } from './types.ts';
+/** Per-element collapse state: progress 0 (free) → 1 (fully docked at the sink). */
+export interface DockState {
+    dock: number;
+}
+/** Whether a screen point lies inside a sink's capture radius (the dock trigger). */
+export declare function withinCapture(center: Vec2, sink: {
+    cx: number;
+    cy: number;
+    absorbR: number;
+}): boolean;
+/** Ease a dock progress toward `target` (1 docking, 0 releasing), snapping at the ends. */
+export declare function stepDock(progress: number, target: 0 | 1, rate?: number): number;
+/**
+ * The collapse transform for a docking element: translate from its current field offset toward the
+ * sink centre and scale 1 → 0 as it docks. `home` is the element's layout-slot centre (its screen
+ * centre at offset 0), `offset` its current field offset, `sink` the core centre. At progress 1 the
+ * element sits at the sink centre, scaled to nothing.
+ */
+export declare function dockTransform(home: Vec2, offset: Vec2, sink: Vec2, progress: number): {
+    tx: number;
+    ty: number;
+    scale: number;
+    opacity: number;
+};
+//# sourceMappingURL=dock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dock.d.ts","sourceRoot":"","sources":["../../src/core/dock.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,oFAAoF;AACpF,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAItG;AAED,2FAA2F;AAC3F,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,SAAO,GAAG,MAAM,CAK7E;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,IAAI,EACZ,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,MAAM,GACf;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAO5D"}

package/dist/core/dock.js

@@ -0,0 +1,39 @@
+/**
+ * Dock — the pure, DOM-free decision core for element capture (§22.3, agent-consumption-model).
+ *
+ * The element-level analogue of particle capture: a `[data-move][data-dock]` element drifting under
+ * the field, when it falls inside a `sink` body's capture radius, **docks** — it collapses toward the
+ * sink core (translate + scale → 0) and is held until the sink releases (supernova), which restores
+ * it. This module computes the trigger, the eased collapse progress, and the transform; `field.ts`
+ * performs the DOM writes, the a11y toggle, and the `field:captured`/`field:released` dispatch.
+ */
+/** Whether a screen point lies inside a sink's capture radius (the dock trigger). */
+export function withinCapture(center, sink) {
+    const dx = sink.cx - center.x;
+    const dy = sink.cy - center.y;
+    return dx * dx + dy * dy < sink.absorbR * sink.absorbR;
+}
+/** Ease a dock progress toward `target` (1 docking, 0 releasing), snapping at the ends. */
+export function stepDock(progress, target, rate = 0.14) {
+    const next = progress + (target - progress) * rate;
+    if (next < 0.001)
+        return 0;
+    if (next > 0.999)
+        return 1;
+    return next;
+}
+/**
+ * The collapse transform for a docking element: translate from its current field offset toward the
+ * sink centre and scale 1 → 0 as it docks. `home` is the element's layout-slot centre (its screen
+ * centre at offset 0), `offset` its current field offset, `sink` the core centre. At progress 1 the
+ * element sits at the sink centre, scaled to nothing.
+ */
+export function dockTransform(home, offset, sink, progress) {
+    const curX = home.x + offset.x;
+    const curY = home.y + offset.y;
+    const tx = offset.x + (sink.x - curX) * progress;
+    const ty = offset.y + (sink.y - curY) * progress;
+    const scale = 1 - progress;
+    return { tx, ty, scale, opacity: scale };
+}
+//# sourceMappingURL=dock.js.map

package/dist/core/dock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dock.js","sourceRoot":"","sources":["../../src/core/dock.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,qFAAqF;AACrF,MAAM,UAAU,aAAa,CAAC,MAAY,EAAE,IAAiD;IAC3F,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC;IAC9B,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC;IAC9B,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;AACzD,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,QAAQ,CAAC,QAAgB,EAAE,MAAa,EAAE,IAAI,GAAG,IAAI;IACnE,MAAM,IAAI,GAAG,QAAQ,GAAG,CAAC,MAAM,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC;IACnD,IAAI,IAAI,GAAG,KAAK;QAAE,OAAO,CAAC,CAAC;IAC3B,IAAI,IAAI,GAAG,KAAK;QAAE,OAAO,CAAC,CAAC;IAC3B,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAU,EACV,MAAY,EACZ,IAAU,EACV,QAAgB;IAEhB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IAC/B,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,QAAQ,CAAC;IACjD,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,QAAQ,CAAC;IACjD,MAAM,KAAK,GAAG,CAAC,GAAG,QAAQ,CAAC;IAC3B,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC3C,CAAC"}

package/dist/core/events.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Event agents (§22.5) — a force/condition firing on a body dispatches a
+ * debounced CustomEvent, so the field can drive app behaviour, not just pixels.
+ * Declared with `data-on="dense:field:lit, captured:field:dock"` (trigger:event,
+ * comma-separated). Rising-edge debounced: fires once on cross, re-arms on reset.
+ */
+export interface EventBinding {
+    trigger: string;
+    event: string;
+    /** true while the trigger is held (so we fire only on the rising edge). */
+    armed: boolean;
+}
+/** Parse a `data-on` string into trigger→event bindings (event names may contain ':'). */
+export declare function parseEventBindings(spec: string): EventBinding[];
+/** Body state a trigger reads. */
+export interface TriggerState {
+    d: number;
+    on: boolean;
+    accreted: number;
+}
+/** Whether a trigger currently holds (rising-edge debounce handled by the caller). */
+export declare function triggerActive(trigger: string, s: TriggerState): boolean;
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/core/events.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,0FAA0F;AAC1F,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CAU/D;AAED,kCAAkC;AAClC,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,YAAY,GAAG,OAAO,CAavE"}

package/dist/core/events.js

@@ -0,0 +1,34 @@
+/**
+ * Event agents (§22.5) — a force/condition firing on a body dispatches a
+ * debounced CustomEvent, so the field can drive app behaviour, not just pixels.
+ * Declared with `data-on="dense:field:lit, captured:field:dock"` (trigger:event,
+ * comma-separated). Rising-edge debounced: fires once on cross, re-arms on reset.
+ */
+/** Parse a `data-on` string into trigger→event bindings (event names may contain ':'). */
+export function parseEventBindings(spec) {
+    return spec
+        .split(',')
+        .map((s) => s.trim())
+        .filter(Boolean)
+        .map((pair) => {
+        const i = pair.indexOf(':');
+        return { trigger: pair.slice(0, i).trim(), event: pair.slice(i + 1).trim(), armed: false };
+    })
+        .filter((b) => b.trigger && b.event);
+}
+/** Whether a trigger currently holds (rising-edge debounce handled by the caller). */
+export function triggerActive(trigger, s) {
+    switch (trigger) {
+        case 'dense':
+            return s.d > 0.6;
+        case 'sparse':
+            return s.d < 0.2;
+        case 'engaged':
+            return s.on;
+        case 'captured':
+            return s.accreted > 0;
+        default:
+            return false;
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/core/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/core/events.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,0FAA0F;AAC1F,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,IAAI;SACR,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC7F,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC;AASD,sFAAsF;AACtF,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,CAAe;IAC5D,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,OAAO;YACV,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;QACnB,KAAK,QAAQ;YACX,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;QACnB,KAAK,SAAS;YACZ,OAAO,CAAC,CAAC,EAAE,CAAC;QACd,KAAK,UAAU;YACb,OAAO,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC;QACxB;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/core/feedback-sink.d.ts

@@ -0,0 +1,32 @@
+/**
+ * The engine's INTERNAL default feedback sink (#228, Phase 5) — the fallback write path when no
+ * platform `feedbackSink` is configured (raw `createField`, @fundamental-engine/vanilla, applyRecipe-scoped
+ * engines). Its output is byte-identical to the direct `style.setProperty` writes the engine
+ * performed historically: same variable names, same `.toFixed(3)` formatting, same write order,
+ * same `field:lit`/`field:dim` hysteresis on `data-fx-lit`. Only the shape moved — every feedback
+ * write now flows through the ONE sink contract, so instrumentation, lint, and future throttling
+ * see every write regardless of which sink is installed.
+ *
+ * Engine-internal plumbing: not exported from the package index, not public API. The platform
+ * route (`makeFeedbackSink` in @fundamental-engine/elements) replaces this sink when the platform runtime
+ * is on; both honor the same {@link FeedbackChannels} contract.
+ *
+ * DOM boundary note: this writes via the same `el.style` / `dispatchEvent` element members the
+ * engine has always used on injected nodes — it touches no DOM *globals*, so the empty-allowlist
+ * guard (`dom-boundary.test.ts`) holds.
+ */
+import type { FeedbackSink } from './types.ts';
+/**
+ * Write a body's feedback channels straight onto the element — the legacy direct-write behavior,
+ * preserved exactly:
+ *
+ * - density → `--d` (the established var) + `--field-density` — same value, three decimals.
+ * - heatmapDensity → `--field-heatmap-density`.
+ * - load → `--load` (the canonical author-facing var) + `--mass` (back-compat alias, §21.2).
+ * - lit → `--lit`, plus the thresholded `field:lit` (rising past 0.5) / `field:dim` (falling past
+ *   0.4) events, armed via `data-fx-lit` for hysteresis.
+ *
+ * Stateless: the lit hysteresis lives on the element (`dataset.fxLit`), exactly as before.
+ */
+export declare const defaultFeedbackSink: FeedbackSink;
+//# sourceMappingURL=feedback-sink.d.ts.map

package/dist/core/feedback-sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback-sink.d.ts","sourceRoot":"","sources":["../../src/core/feedback-sink.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,EAAE,YAmCjC,CAAC"}

package/dist/core/feedback-sink.js

@@ -0,0 +1,53 @@
+/**
+ * Write a body's feedback channels straight onto the element — the legacy direct-write behavior,
+ * preserved exactly:
+ *
+ * - density → `--d` (the established var) + `--field-density` — same value, three decimals.
+ * - heatmapDensity → `--field-heatmap-density`.
+ * - load → `--load` (the canonical author-facing var) + `--mass` (back-compat alias, §21.2).
+ * - lit → `--lit`, plus the thresholded `field:lit` (rising past 0.5) / `field:dim` (falling past
+ *   0.4) events, armed via `data-fx-lit` for hysteresis.
+ *
+ * Stateless: the lit hysteresis lives on the element (`dataset.fxLit`), exactly as before.
+ */
+export const defaultFeedbackSink = (el, ch) => {
+    if (ch.density !== undefined) {
+        const dStr = ch.density.toFixed(3);
+        el.style.setProperty('--d', dStr);
+        el.style.setProperty('--field-density', dStr);
+    }
+    if (ch.heatmapDensity !== undefined) {
+        const hStr = ch.heatmapDensity.toFixed(3);
+        el.style.setProperty('--field-heatmap-density', hStr);
+    }
+    if (ch.load !== undefined) {
+        const loadStr = ch.load.toFixed(3);
+        el.style.setProperty('--load', loadStr);
+        el.style.setProperty('--mass', loadStr);
+    }
+    // measured thermodynamics (workover v0.3): the bare names per the workover/BACKLOG contract.
+    // Engine-MEASURED local thermodynamics — distinct from the platform's INFERRED interaction
+    // lanes (`--field-entropy` / `--field-coherence`, system-contracts §6), and numeric where the
+    // `--coherence` on `:root` from cssTokens() is a palette *color* (element-scoped, so this
+    // shadows that color only on data-feedback subtrees that read it — none in the tree today).
+    if (ch.entropy !== undefined)
+        el.style.setProperty('--entropy', ch.entropy.toFixed(3));
+    if (ch.coherence !== undefined)
+        el.style.setProperty('--coherence', ch.coherence.toFixed(3));
+    if (ch.temperature !== undefined)
+        el.style.setProperty('--temperature', ch.temperature.toFixed(3));
+    if (ch.lit !== undefined) {
+        const lit = ch.lit;
+        el.style.setProperty('--lit', lit.toFixed(3));
+        const armed = el.dataset.fxLit === '1';
+        if (lit > 0.5 && !armed) {
+            el.dataset.fxLit = '1';
+            el.dispatchEvent(new CustomEvent('field:lit', { detail: { value: lit } }));
+        }
+        else if (lit < 0.4 && armed) {
+            el.dataset.fxLit = '0';
+            el.dispatchEvent(new CustomEvent('field:dim', { detail: { value: lit } }));
+        }
+    }
+};
+//# sourceMappingURL=feedback-sink.js.map

package/dist/core/feedback-sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback-sink.js","sourceRoot":"","sources":["../../src/core/feedback-sink.ts"],"names":[],"mappings":"AAmBA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAiB,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE;IAC1D,IAAI,EAAE,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACnC,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAClC,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,EAAE,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC1C,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,yBAAyB,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,EAAE,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACnC,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACxC,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IACD,6FAA6F;IAC7F,2FAA2F;IAC3F,8FAA8F;IAC9F,0FAA0F;IAC1F,4FAA4F;IAC5F,IAAI,EAAE,CAAC,OAAO,KAAK,SAAS;QAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACvF,IAAI,EAAE,CAAC,SAAS,KAAK,SAAS;QAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,aAAa,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7F,IAAI,EAAE,CAAC,WAAW,KAAK,SAAS;QAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,eAAe,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACnG,IAAI,EAAE,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC;QACnB,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,KAAK,GAAG,CAAC;QACvC,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YACxB,EAAE,CAAC,OAAO,CAAC,KAAK,GAAG,GAAG,CAAC;YACvB,EAAE,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;QAC7E,CAAC;aAAM,IAAI,GAAG,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC;YAC9B,EAAE,CAAC,OAAO,CAAC,KAAK,GAAG,GAAG,CAAC;YACvB,EAAE,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;AACH,CAAC,CAAC"}

package/dist/core/feedback.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Two-way density feedback (§8) — the field writes the density gathered on a body
+ * back into its element as `--d`, so type can glow, grow, and gain weight where
+ * matter collects (the sanctioned word treatment, §11 note). Pure math here; the
+ * DOM writes live in the field loop.
+ */
+/** Eased target density for a body from its per-frame `count` (§8). */
+export declare function feedbackTarget(count: number, on: boolean): number;
+/** Variable-font weight from density `d` ∈ [0,1] (§8). */
+export declare function feedbackWeight(fmin: number, fmax: number, d: number): number;
+//# sourceMappingURL=feedback.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../../src/core/feedback.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG,MAAM,CAGjE;AAED,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5E"}

package/dist/core/feedback.js

@@ -0,0 +1,16 @@
+/**
+ * Two-way density feedback (§8) — the field writes the density gathered on a body
+ * back into its element as `--d`, so type can glow, grow, and gain weight where
+ * matter collects (the sanctioned word treatment, §11 note). Pure math here; the
+ * DOM writes live in the field loop.
+ */
+/** Eased target density for a body from its per-frame `count` (§8). */
+export function feedbackTarget(count, on) {
+    const t = count / 20 + (on ? 0.45 : 0);
+    return t < 0 ? 0 : t > 1 ? 1 : t;
+}
+/** Variable-font weight from density `d` ∈ [0,1] (§8). */
+export function feedbackWeight(fmin, fmax, d) {
+    return Math.round(fmin + (fmax - fmin) * d);
+}
+//# sourceMappingURL=feedback.js.map

package/dist/core/feedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.js","sourceRoot":"","sources":["../../src/core/feedback.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,uEAAuE;AACvE,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,EAAW;IACvD,MAAM,CAAC,GAAG,KAAK,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACnC,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,IAAY,EAAE,CAAS;IAClE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC9C,CAAC"}

package/dist/core/field-store.d.ts

@@ -0,0 +1,26 @@
+/**
+ * FieldStore — owns the particle pool and the spatial index (§20.1 foundation).
+ *
+ * The single home for "all the matter": add/remove particles, rebuild the
+ * neighbour index once per frame, and answer `neighbors(p, r)`. Count is the
+ * conserved quantity (§2.4) — `size` is the live total.
+ */
+import type { Particle } from './types.ts';
+export declare class FieldStore {
+    readonly particles: Particle[];
+    private readonly hash;
+    constructor(cellSize?: number);
+    get size(): number;
+    add(p: Particle): Particle;
+    /** swap-remove a particle (O(1), order not preserved). */
+    remove(p: Particle): void;
+    clear(): void;
+    /** rebuild the neighbour index from the current pool (once per frame). */
+    reindex(): void;
+    /** neighbours within `r` of `p` (true 3D distance), excluding `p` itself. */
+    neighbors(p: Particle, r: number): Particle[];
+    /** particles within `r` of an arbitrary point (x, y) — for grid sampling (e.g. the
+     *  voronoi render mode), where the query origin is not itself a particle. */
+    near(x: number, y: number, r: number): Particle[];
+}
+//# sourceMappingURL=field-store.d.ts.map

package/dist/core/field-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-store.d.ts","sourceRoot":"","sources":["../../src/core/field-store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C,qBAAa,UAAU;IACrB,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAM;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAwB;gBAEjC,QAAQ,SAAK;IAIzB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,QAAQ;IAK1B,0DAA0D;IAC1D,MAAM,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI;IAOzB,KAAK,IAAI,IAAI;IAKb,0EAA0E;IAC1E,OAAO,IAAI,IAAI;IAIf,6EAA6E;IAC7E,SAAS,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,GAAG,QAAQ,EAAE;IAO7C;iFAC6E;IAC7E,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,QAAQ,EAAE;CAGlD"}

package/dist/core/field-store.js

@@ -0,0 +1,54 @@
+/**
+ * FieldStore — owns the particle pool and the spatial index (§20.1 foundation).
+ *
+ * The single home for "all the matter": add/remove particles, rebuild the
+ * neighbour index once per frame, and answer `neighbors(p, r)`. Count is the
+ * conserved quantity (§2.4) — `size` is the live total.
+ */
+import { SpatialHash } from "./spatial-hash.js";
+export class FieldStore {
+    particles = [];
+    hash;
+    constructor(cellSize = 64) {
+        this.hash = new SpatialHash(cellSize);
+    }
+    get size() {
+        return this.particles.length;
+    }
+    add(p) {
+        this.particles.push(p);
+        return p;
+    }
+    /** swap-remove a particle (O(1), order not preserved). */
+    remove(p) {
+        const i = this.particles.indexOf(p);
+        if (i < 0)
+            return;
+        const last = this.particles.pop();
+        if (last && i < this.particles.length)
+            this.particles[i] = last;
+    }
+    clear() {
+        this.particles.length = 0;
+        this.hash.clear();
+    }
+    /** rebuild the neighbour index from the current pool (once per frame). */
+    reindex() {
+        this.hash.rebuild(this.particles);
+    }
+    /** neighbours within `r` of `p` (true 3D distance), excluding `p` itself. */
+    neighbors(p, r) {
+        const found = this.hash.near(p.x, p.y, r, p.z ?? 0);
+        const out = [];
+        for (const n of found)
+            if (n !== p)
+                out.push(n);
+        return out;
+    }
+    /** particles within `r` of an arbitrary point (x, y) — for grid sampling (e.g. the
+     *  voronoi render mode), where the query origin is not itself a particle. */
+    near(x, y, r) {
+        return this.hash.near(x, y, r);
+    }
+}
+//# sourceMappingURL=field-store.js.map

package/dist/core/field-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-store.js","sourceRoot":"","sources":["../../src/core/field-store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,OAAO,UAAU;IACZ,SAAS,GAAe,EAAE,CAAC;IACnB,IAAI,CAAwB;IAE7C,YAAY,QAAQ,GAAG,EAAE;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,WAAW,CAAW,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;IAC/B,CAAC;IAED,GAAG,CAAC,CAAW;QACb,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,0DAA0D;IAC1D,MAAM,CAAC,CAAW;QAChB,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO;QAClB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;QAClC,IAAI,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM;YAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAClE,CAAC;IAED,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;IAED,0EAA0E;IAC1E,OAAO;QACL,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IAED,6EAA6E;IAC7E,SAAS,CAAC,CAAW,EAAE,CAAS;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACpD,MAAM,GAAG,GAAe,EAAE,CAAC;QAC3B,KAAK,MAAM,CAAC,IAAI,KAAK;YAAE,IAAI,CAAC,KAAK,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChD,OAAO,GAAG,CAAC;IACb,CAAC;IAED;iFAC6E;IAC7E,IAAI,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACjC,CAAC;CACF"}

package/dist/core/field.d.ts

@@ -0,0 +1,18 @@
+/**
+ * createField — the browser entry point (§13).
+ *
+ * Mounts the simulation against a `<canvas>`: builds the particle pool, scans
+ * the document for `[data-body]` bodies, runs the rAF loop (measure → reindex →
+ * step → render), and exposes the public `FieldHandle`. Pure glue — the testable
+ * physics lives in field-store / integrator / scanner.
+ *
+ * ── Renderer-agnostic (frontier) ──────────────────────────────────────────────────────
+ * This engine touches NO DOM globals. Every environment touchpoint — viewport size, scroll, rAF,
+ * reduced-motion, visibility, the scan root, and event wiring — goes through an injected
+ * {@link FieldHost} (default `browserHost()`). The browser's `window`/`document` surface is isolated
+ * in `browser-host.ts` (the one allowlisted DOM module, with `export.ts`). Pass `opts.host` to drive
+ * the same engine from a different renderer/environment. Enforced by `dom-boundary.test.ts`.
+ */
+import type { FieldHandle, FieldOptions } from './types.ts';
+export declare function createField(canvas: HTMLCanvasElement, opts?: FieldOptions): FieldHandle;
+//# sourceMappingURL=field.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../src/core/field.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAA0B,WAAW,EAAE,YAAY,EAAkD,MAAM,YAAY,CAAC;AAoDpI,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,GAAE,YAAiB,GAAG,WAAW,CA4yD3F"}