@fundamental-engine/core 0.4.0

package/dist/agents/relationship.js

@@ -0,0 +1,40 @@
+/**
+ * RelationshipAgent (system-contracts §7) — an active connection between two bodies. It is not
+ * merely a rendered line: it carries strength, tension, and memory; it strengthens with use and
+ * decays over time; it can transfer attention and emit thresholded events.
+ *
+ * The dynamics here are pure (plain state + dt), so they are deterministic and node-testable. The
+ * rendering (a line, a current) and the DOM event dispatch live in the field loop / feedback layer.
+ */
+import { Thresholder } from "./event-agent.js";
+export const DEFAULT_RELATIONSHIP_DYNAMICS = {
+    strengthen: 1.5,
+    decay: 0.3,
+    remember: 0.2,
+};
+const clamp01 = (n) => (n < 0 ? 0 : n > 1 ? 1 : n);
+/**
+ * Advance a relationship one step. `active` is whether it was exercised this tick (a click, a
+ * traversal, attention flowing across it); `tension` is the current strain. Strengthens toward 1
+ * while active, decays toward 0 while idle, and memory follows more slowly — so a long-used
+ * relationship stays warm after a pause, while a one-off fades.
+ */
+export function updateRelationship(r, active, tension, dt, dyn = DEFAULT_RELATIONSHIP_DYNAMICS) {
+    r.active = active;
+    r.tension = clamp01(tension);
+    r.strength = clamp01(r.strength + (active ? dyn.strengthen : -dyn.decay) * dt);
+    r.memory = clamp01(r.memory + (active ? dyn.remember : -dyn.remember * 0.5) * dt);
+}
+/**
+ * Attention transferred across a relationship: a fraction of the source body's attention flows to
+ * the target, scaled by the live strength. Pure — returns the amount to add at `to` and remove at
+ * `from` (the caller applies it, conserving the budget).
+ */
+export function attentionTransfer(r, fromAttention, rate = 0.25) {
+    return fromAttention * r.strength * rate;
+}
+/** Build a watched relationship with a sensible strengthen/weaken threshold. */
+export function watchRelationship(agent, debounceMs = 400) {
+    return { agent, threshold: new Thresholder({ enter: 0.6, exit: 0.3, debounceMs }) };
+}
+//# sourceMappingURL=relationship.js.map

package/dist/agents/relationship.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationship.js","sourceRoot":"","sources":["../../src/agents/relationship.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AA4B/C,MAAM,CAAC,MAAM,6BAA6B,GAAyB;IACjE,UAAU,EAAE,GAAG;IACf,KAAK,EAAE,GAAG;IACV,QAAQ,EAAE,GAAG;CACd,CAAC;AAEF,MAAM,OAAO,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,CAAoB,EACpB,MAAe,EACf,OAAe,EACf,EAAU,EACV,MAA4B,6BAA6B;IAEzD,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC;IAClB,CAAC,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC,CAAC,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;IAC/E,CAAC,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;AACpF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,CAAoB,EAAE,aAAqB,EAAE,IAAI,GAAG,IAAI;IACxF,OAAO,aAAa,GAAG,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC;AAC3C,CAAC;AAQD,gFAAgF;AAChF,MAAM,UAAU,iBAAiB,CAAC,KAAwB,EAAE,UAAU,GAAG,GAAG;IAC1E,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,WAAW,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;AACtF,CAAC"}

package/dist/agents/user-agent.d.ts

@@ -0,0 +1,57 @@
+/**
+ * UserAgent (system-contracts §8) — user input as field participation. The pointer is a wake, the
+ * focused element a first-class attention source, the selection a capture, scroll a current. It
+ * must respect reduced motion, keyboard accessibility, pointer absence, and touch.
+ *
+ * Pure state + update so it is node-testable; the engine feeds it raw input and reads the resulting
+ * field source. Under reduced motion, travel-heavy response is suppressed: the pointer wake stops
+ * but focus still produces an accessible (static) attention source.
+ */
+export interface UserAgentState {
+    /** pointer position in field space; null when the pointer is absent. */
+    px: number | null;
+    py: number | null;
+    /** pointer velocity (px/tick), eased. */
+    vx: number;
+    vy: number;
+    /** id of the focused body, or null. */
+    focusId: string | null;
+    /** id of the selected/captured body, or null. */
+    selectionId: string | null;
+    /** eased scroll speed (a current). */
+    scrollV: number;
+    /** honor prefers-reduced-motion — suppress travel-heavy response. */
+    reducedMotion: boolean;
+}
+export declare function createUserAgent(reducedMotion?: boolean): UserAgentState;
+export interface UserInput {
+    pointer?: {
+        x: number;
+        y: number;
+    } | null;
+    focusId?: string | null;
+    selectionId?: string | null;
+    scrollV?: number;
+}
+/** Advance the UserAgent from one input frame. Pure (mutates and returns the state). */
+export declare function updateUserAgent(u: UserAgentState, input: UserInput, ease_k?: number): UserAgentState;
+/**
+ * The field source the UserAgent projects, after accessibility gating. Under reduced motion the
+ * pointer wake (a moving source) is dropped, but a focused element still yields a static attention
+ * source — so meaning survives without motion (the §8 / Accessibility Contract rule).
+ */
+export interface UserFieldSource {
+    /** a moving pointer wake, if active and motion is allowed. */
+    wake: {
+        x: number;
+        y: number;
+        vx: number;
+        vy: number;
+    } | null;
+    /** an accessible attention source from focus (present even under reduced motion). */
+    focus: string | null;
+    /** a capture from selection. */
+    capture: string | null;
+}
+export declare function userFieldSource(u: UserAgentState): UserFieldSource;
+//# sourceMappingURL=user-agent.d.ts.map

package/dist/agents/user-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-agent.d.ts","sourceRoot":"","sources":["../../src/agents/user-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,uCAAuC;IACvC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,iDAAiD;IACjD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,eAAe,CAAC,aAAa,UAAQ,GAAG,cAAc,CAErE;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1C,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,SAAM,GAAG,cAAc,CAiBjG;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,8DAA8D;IAC9D,IAAI,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9D,qFAAqF;IACrF,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,gCAAgC;IAChC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,cAAc,GAAG,eAAe,CAOlE"}

package/dist/agents/user-agent.js

@@ -0,0 +1,45 @@
+/**
+ * UserAgent (system-contracts §8) — user input as field participation. The pointer is a wake, the
+ * focused element a first-class attention source, the selection a capture, scroll a current. It
+ * must respect reduced motion, keyboard accessibility, pointer absence, and touch.
+ *
+ * Pure state + update so it is node-testable; the engine feeds it raw input and reads the resulting
+ * field source. Under reduced motion, travel-heavy response is suppressed: the pointer wake stops
+ * but focus still produces an accessible (static) attention source.
+ */
+export function createUserAgent(reducedMotion = false) {
+    return { px: null, py: null, vx: 0, vy: 0, focusId: null, selectionId: null, scrollV: 0, reducedMotion };
+}
+const ease = (cur, next, k) => cur + (next - cur) * k;
+/** Advance the UserAgent from one input frame. Pure (mutates and returns the state). */
+export function updateUserAgent(u, input, ease_k = 0.3) {
+    if ('pointer' in input) {
+        const p = input.pointer ?? null;
+        if (p && u.px != null && u.py != null) {
+            u.vx = ease(u.vx, p.x - u.px, ease_k);
+            u.vy = ease(u.vy, p.y - u.py, ease_k);
+        }
+        else {
+            u.vx = 0;
+            u.vy = 0;
+        }
+        u.px = p ? p.x : null;
+        u.py = p ? p.y : null;
+    }
+    if ('focusId' in input)
+        u.focusId = input.focusId ?? null;
+    if ('selectionId' in input)
+        u.selectionId = input.selectionId ?? null;
+    if (input.scrollV != null)
+        u.scrollV = ease(u.scrollV, input.scrollV, ease_k);
+    return u;
+}
+export function userFieldSource(u) {
+    const moving = u.px != null && u.py != null && (Math.abs(u.vx) > 0.01 || Math.abs(u.vy) > 0.01);
+    return {
+        wake: !u.reducedMotion && moving ? { x: u.px, y: u.py, vx: u.vx, vy: u.vy } : null,
+        focus: u.focusId,
+        capture: u.selectionId,
+    };
+}
+//# sourceMappingURL=user-agent.js.map

package/dist/agents/user-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-agent.js","sourceRoot":"","sources":["../../src/agents/user-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmBH,MAAM,UAAU,eAAe,CAAC,aAAa,GAAG,KAAK;IACnD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC;AAC3G,CAAC;AASD,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,IAAY,EAAE,CAAS,EAAU,EAAE,CAAC,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;AAEtF,wFAAwF;AACxF,MAAM,UAAU,eAAe,CAAC,CAAiB,EAAE,KAAgB,EAAE,MAAM,GAAG,GAAG;IAC/E,IAAI,SAAS,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;YACtC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YACtC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACT,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACX,CAAC;QACD,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACtB,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACxB,CAAC;IACD,IAAI,SAAS,IAAI,KAAK;QAAE,CAAC,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC;IAC1D,IAAI,aAAa,IAAI,KAAK;QAAE,CAAC,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,IAAI,CAAC;IACtE,IAAI,KAAK,CAAC,OAAO,IAAI,IAAI;QAAE,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9E,OAAO,CAAC,CAAC;AACX,CAAC;AAgBD,MAAM,UAAU,eAAe,CAAC,CAAiB;IAC/C,MAAM,MAAM,GAAG,CAAC,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IAChG,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,CAAC,aAAa,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAG,EAAE,CAAC,EAAE,CAAC,CAAC,EAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI;QACpF,KAAK,EAAE,CAAC,CAAC,OAAO;QAChB,OAAO,EAAE,CAAC,CAAC,WAAW;KACvB,CAAC;AACJ,CAAC"}

package/dist/config/forces.config.d.ts

@@ -0,0 +1,101 @@
+/**
+ * The canonical catalog — the single source of truth.
+ *
+ * Lifted from the prototype's `ds-data.js` (`DS_FORCES` / `DS_FORMATIONS` /
+ * `DS_CONDITIONS`), which the design treats as the authority. Force identity
+ * **colors are canonical**; disciplines inherit their mapped force's color.
+ * See `docs/engine-reference/forces-system.md` §6 (forces), §7 (formations), §5 (conditions),
+ * §15 (disciplines).
+ *
+ * This is the *designed* nine (the implemented prototype set). Extended,
+ * physical, and cosmology forces (§20) live in their own modules once built.
+ */
+import type { Formation } from '../core/types.ts';
+/** The canonical nine force ids (the implemented set). */
+export type ForceId = 'attract' | 'jet' | 'tether' | 'wall' | 'stream' | 'repel' | 'viscosity' | 'swirl' | 'sink';
+export interface ForceDef {
+    id: ForceId;
+    name: string;
+    /** canonical identity color (the authority). */
+    color: string;
+    /** plain-language gloss. */
+    does: string;
+    /** the discipline this force maps to (§15). */
+    discipline: string;
+    /** the verb shown on the discipline card. */
+    verb: string;
+    /** the engine `data-body` tokens that realize it. */
+    body: string;
+    /** default authoring attributes. */
+    attrs: Record<string, string>;
+    /** one-line law (see the falloff-accuracy note, §6 — "inverse-square" here
+     *  is the prototype's metaphor; the engine falloff is bounded `(1−d/d_max)ⁿ`,
+     *  the true `1/d²` law is the `gravity` primitive, §20.10). */
+    law: string;
+}
+export declare const FORCES: readonly ForceDef[];
+export declare const FORCE_BY: Readonly<Record<ForceId, ForceDef>>;
+/** The canonical palette, in force order. Wave/Currents and the accent journey
+ *  draw from this — never a separate constant (§24.4). */
+export declare const PALETTE: readonly string[];
+/** The site scroll accent journey (§9). */
+export declare const ACCENT_JOURNEY: readonly string[];
+/** A `data-body` token's application class. */
+export type BodyTokenKind = 'modifier' | 'force' | 'source';
+/** Modifier tokens in their formalized application order (`spotlight → screen → resonate`).
+ *  The order is part of the contract: authoring `data-body="resonate spotlight attract"`
+ *  evaluates the modifiers in THIS order, not authored order. (Today's modifiers compose
+ *  commutatively — gates OR, strength multipliers multiply — so the formalization changes
+ *  no existing behavior; it pins the contract for modifiers where order will matter.) */
+export declare const MODIFIER_ORDER: readonly string[];
+/** Class-[S] source tokens — they CREATE matter and must be budgeted: every [S] body
+ *  declares at least one of `data-life` / `data-cap` / `data-budget` / `data-sink`,
+ *  or the scanner's dev guard warns and applies {@link SOURCE_DEFAULT_LIFE} /
+ *  {@link SOURCE_DEFAULT_CAP} (workover §"Source and sink rules"). */
+export declare const SOURCE_TOKENS: readonly string[];
+/** The safe default budget the source guard applies to an unbudgeted [S] body:
+ *  each emitted particle lives this many frames (`data-life="300"`). */
+export declare const SOURCE_DEFAULT_LIFE = 300;
+/** …and the body sustains at most this many live particles (`data-cap="120"`);
+ *  the emission rate is clamped to `cap / life` per frame. */
+export declare const SOURCE_DEFAULT_CAP = 120;
+/** Classify one `data-body` token (unknown tokens are plain forces). */
+export declare function classifyBodyToken(token: string): BodyTokenKind;
+/** A body's tokens split into the three application classes (workover §"Modifier contract"). */
+export interface ClassifiedTokens {
+    /** modifier tokens, sorted into the formalized order (`spotlight → screen → resonate`). */
+    modifiers: string[];
+    /** core force tokens (including unknown tokens — unchanged behavior), authored order. */
+    forces: string[];
+    /** class-[S] source tokens, authored order. */
+    sources: string[];
+}
+/** Split a body's tokens into `{ modifiers, forces, sources }`. Pure; preserves authored
+ *  order within each class except modifiers, which sort into {@link MODIFIER_ORDER}. */
+export declare function classifyBodyTokens(tokens: readonly string[]): ClassifiedTokens;
+export type FormationId = 'ambient' | 'wells' | 'lanes' | 'scatter' | 'accretion';
+export interface FormationDef {
+    id: FormationId;
+    name: string;
+    /** the page section it backs (the journey, §7.1). */
+    section: string;
+    color: string;
+    cue: string;
+    /** the numeric bias preset applied to every free particle (`FORMS`). */
+    preset: Formation;
+}
+export declare const FORMATIONS: readonly FormationDef[];
+export declare const FORMATION_BY: Readonly<Record<FormationId, FormationDef>>;
+/** Section → formation mapping for the scroll journey (§7.1, `SECTION_FORM`). */
+export declare const SECTION_FORM: Readonly<Record<string, FormationId>>;
+export type ConditionId = '' | 'active' | 'fast' | 'slow' | 'hot' | 'cool' | 'scrolling';
+export interface ConditionDef {
+    id: ConditionId;
+    name: string;
+    desc: string;
+    /** selective gates read each particle (act only on free agents, §5). */
+    selective: boolean;
+}
+export declare const CONDITIONS: readonly ConditionDef[];
+export declare const CONDITION_BY: Readonly<Record<ConditionId, ConditionDef>>;
+//# sourceMappingURL=forces.config.d.ts.map

package/dist/config/forces.config.d.ts.map

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

package/dist/config/forces.config.js

@@ -0,0 +1,239 @@
+/**
+ * The canonical catalog — the single source of truth.
+ *
+ * Lifted from the prototype's `ds-data.js` (`DS_FORCES` / `DS_FORMATIONS` /
+ * `DS_CONDITIONS`), which the design treats as the authority. Force identity
+ * **colors are canonical**; disciplines inherit their mapped force's color.
+ * See `docs/engine-reference/forces-system.md` §6 (forces), §7 (formations), §5 (conditions),
+ * §15 (disciplines).
+ *
+ * This is the *designed* nine (the implemented prototype set). Extended,
+ * physical, and cosmology forces (§20) live in their own modules once built.
+ */
+export const FORCES = [
+    {
+        id: 'attract',
+        name: 'Attract',
+        color: '#4da3ff',
+        does: 'Pulls matter into a well',
+        discipline: 'Product strategy',
+        verb: 'gives direction',
+        body: 'attract',
+        attrs: { 'data-strength': '1', 'data-range': '300' },
+        law: 'a soft gravity-like well, bent into a spiral',
+    },
+    {
+        id: 'jet',
+        name: 'Jet',
+        color: '#a78bfa',
+        does: 'Draws matter in, jets it out',
+        discipline: 'AI systems',
+        verb: 'adapts response',
+        body: 'jet',
+        attrs: { 'data-angle': '0', 'data-strength': '1', 'data-range': '300' },
+        law: 'recycles the field into a stream',
+    },
+    {
+        id: 'tether',
+        name: 'Tether',
+        color: '#86e57f',
+        does: 'Tethers matter to a radius',
+        discipline: 'Software architecture',
+        verb: 'gives structure',
+        body: 'tether',
+        attrs: { 'data-strength': '1', 'data-range': '260' },
+        law: 'a rest length — a leash, not a drain',
+    },
+    {
+        id: 'wall',
+        name: 'Wall',
+        color: '#c4b5fd',
+        does: 'A surface that bounces — throws sparks',
+        discipline: 'Experience design',
+        verb: 'the human surface',
+        body: 'wall',
+        attrs: {},
+        law: 'elastic bounce off the bounding box',
+    },
+    {
+        id: 'stream',
+        name: 'Stream',
+        color: '#7dd3fc',
+        does: 'Blows a directional current',
+        discipline: 'Motion',
+        verb: 'reveals motion',
+        body: 'stream',
+        attrs: { 'data-angle': '0', 'data-strength': '1', 'data-range': '340' },
+        law: 'constant force along a heading',
+    },
+    {
+        id: 'repel',
+        name: 'Repel',
+        color: '#ff9d5c',
+        does: 'Pushes matter away',
+        discipline: 'Commerce',
+        verb: 'market pressure',
+        body: 'repel',
+        attrs: { 'data-strength': '1.1', 'data-range': '300' },
+        law: 'inverted well — carves a clean void',
+    },
+    {
+        id: 'viscosity',
+        name: 'Viscosity',
+        color: '#8da2c0',
+        does: 'Thickens the medium',
+        discipline: 'Physical production',
+        verb: 'adds constraint',
+        body: 'viscosity',
+        attrs: { 'data-strength': '1', 'data-range': '300' },
+        law: 'viscosity — bleeds momentum off',
+    },
+    {
+        id: 'swirl',
+        name: 'Swirl',
+        color: '#2dd4bf',
+        does: 'Spins matter into a swirl',
+        discipline: 'Creative technology',
+        verb: 'spins it together',
+        body: 'swirl',
+        attrs: { 'data-spin': '1', 'data-strength': '1', 'data-range': '320' },
+        law: 'tangential force — circles, never collapses',
+    },
+    {
+        id: 'sink',
+        name: 'Sink',
+        color: '#ff6e9c',
+        does: 'Swallows matter, then pops',
+        discipline: 'Attention',
+        verb: 'holds, then releases',
+        body: 'sink attract',
+        // §21.2 naming: the sink's captured count is `b.accreted` (was `b.mass`), its
+        // limit is `capacity` (was `maxMass`), and the CSS fill var is `--load` (alias
+        // `--mass`). `data-max` is the authoring alias for capacity.
+        attrs: {
+            'data-absorb': '64',
+            'data-max': '30',
+            'data-strength': '0.8',
+            'data-range': '360',
+        },
+        law: 'accretion, then supernova',
+    },
+];
+export const FORCE_BY = Object.fromEntries(FORCES.map((f) => [f.id, f]));
+/** The canonical palette, in force order. Wave/Currents and the accent journey
+ *  draw from this — never a separate constant (§24.4). */
+export const PALETTE = FORCES.map((f) => f.color);
+/** The site scroll accent journey (§9). */
+export const ACCENT_JOURNEY = [
+    '#4da3ff',
+    '#2dd4bf',
+    '#a78bfa',
+    '#ff6e9c',
+    '#ff9d5c',
+];
+/** Modifier tokens in their formalized application order (`spotlight → screen → resonate`).
+ *  The order is part of the contract: authoring `data-body="resonate spotlight attract"`
+ *  evaluates the modifiers in THIS order, not authored order. (Today's modifiers compose
+ *  commutatively — gates OR, strength multipliers multiply — so the formalization changes
+ *  no existing behavior; it pins the contract for modifiers where order will matter.) */
+export const MODIFIER_ORDER = ['spotlight', 'screen', 'resonate'];
+/** Class-[S] source tokens — they CREATE matter and must be budgeted: every [S] body
+ *  declares at least one of `data-life` / `data-cap` / `data-budget` / `data-sink`,
+ *  or the scanner's dev guard warns and applies {@link SOURCE_DEFAULT_LIFE} /
+ *  {@link SOURCE_DEFAULT_CAP} (workover §"Source and sink rules"). */
+export const SOURCE_TOKENS = ['spawn'];
+/** The safe default budget the source guard applies to an unbudgeted [S] body:
+ *  each emitted particle lives this many frames (`data-life="300"`). */
+export const SOURCE_DEFAULT_LIFE = 300;
+/** …and the body sustains at most this many live particles (`data-cap="120"`);
+ *  the emission rate is clamped to `cap / life` per frame. */
+export const SOURCE_DEFAULT_CAP = 120;
+/** Classify one `data-body` token (unknown tokens are plain forces). */
+export function classifyBodyToken(token) {
+    if (MODIFIER_ORDER.includes(token))
+        return 'modifier';
+    if (SOURCE_TOKENS.includes(token))
+        return 'source';
+    return 'force';
+}
+/** Split a body's tokens into `{ modifiers, forces, sources }`. Pure; preserves authored
+ *  order within each class except modifiers, which sort into {@link MODIFIER_ORDER}. */
+export function classifyBodyTokens(tokens) {
+    const modifiers = [];
+    const forces = [];
+    const sources = [];
+    for (const t of tokens) {
+        const kind = classifyBodyToken(t);
+        if (kind === 'modifier')
+            modifiers.push(t);
+        else if (kind === 'source')
+            sources.push(t);
+        else
+            forces.push(t);
+    }
+    if (modifiers.length > 1)
+        modifiers.sort((a, b) => MODIFIER_ORDER.indexOf(a) - MODIFIER_ORDER.indexOf(b));
+    return { modifiers, forces, sources };
+}
+export const FORMATIONS = [
+    {
+        id: 'ambient',
+        name: 'Ambient',
+        section: 'Hero',
+        color: '#4da3ff',
+        cue: 'resting drift',
+        preset: { driftX: 0, wander: 1.0, orbit: 0.1, spread: 0, conv: 0 },
+    },
+    {
+        id: 'wells',
+        name: 'Wells',
+        section: 'Work',
+        color: '#2dd4bf',
+        cue: 'matter pools',
+        preset: { driftX: 0, wander: 0.7, orbit: 0.85, spread: 0, conv: 0 },
+    },
+    {
+        id: 'lanes',
+        name: 'Lanes',
+        section: 'Writing',
+        color: '#ff9d5c',
+        cue: 'a current carries',
+        preset: { driftX: 0.55, wander: 0.5, orbit: 0, spread: 0, conv: 0 },
+    },
+    {
+        id: 'scatter',
+        name: 'Scatter',
+        section: 'Practice',
+        color: '#a78bfa',
+        cue: 'energy dispersed',
+        preset: { driftX: 0, wander: 1.7, orbit: 0, spread: 0.6, conv: 0 },
+    },
+    {
+        id: 'accretion',
+        name: 'Accretion',
+        section: 'Contact',
+        color: '#ffce6b',
+        cue: 'everything gathers',
+        preset: { driftX: 0, wander: 0.6, orbit: 0.4, spread: 0, conv: 0.6 },
+    },
+];
+export const FORMATION_BY = Object.fromEntries(FORMATIONS.map((f) => [f.id, f]));
+/** Section → formation mapping for the scroll journey (§7.1, `SECTION_FORM`). */
+export const SECTION_FORM = {
+    top: 'ambient',
+    capabilities: 'scatter',
+    work: 'wells',
+    writing: 'lanes',
+    contact: 'accretion',
+};
+export const CONDITIONS = [
+    { id: '', name: 'Always', desc: 'Acts on every particle, every frame.', selective: false },
+    { id: 'active', name: 'Active', desc: 'Only while the body is engaged.', selective: false },
+    { id: 'fast', name: 'Fast', desc: 'Only on fast-moving matter (v² > 0.9).', selective: true },
+    { id: 'slow', name: 'Slow', desc: 'Only on calm matter (v² < 0.22).', selective: true },
+    { id: 'hot', name: 'Hot', desc: 'Only on energized matter (heat > 0.3).', selective: true },
+    { id: 'cool', name: 'Cool', desc: 'Only on calm, un-energized matter (heat < 0.08).', selective: true },
+    { id: 'scrolling', name: 'Scrolling', desc: 'Only while the page is scrolling.', selective: false },
+];
+export const CONDITION_BY = Object.fromEntries(CONDITIONS.map((c) => [c.id, c]));
+//# sourceMappingURL=forces.config.js.map

package/dist/config/forces.config.js.map

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

package/dist/config/manual.d.ts

@@ -0,0 +1,134 @@
+/**
+ * The Field Manual catalog — the *complete, public-facing definition* of every force
+ * in the system: its family, token, the per-frame formula (transcribed from
+ * `docs/engine-reference/forces-system.md` §6/§20.3/§20.10), the `data-*` attributes it reads, and a
+ * one-line description.
+ *
+ * This is the single source the UI renders (the manual on fundamental-engine.com) and the
+ * shared reference for developers. A test cross-checks it against the registered
+ * force arrays, so the catalog can never silently fall out of sync with the engine —
+ * every force the engine knows has a definition here, and vice versa.
+ */
+/** Which register a force belongs to (§20.1). */
+export type ForceFamily = 'canonical' | 'natural' | 'extended';
+/** One force's complete definition for the manual. */
+export interface ManualEntry {
+    family: ForceFamily;
+    /** the `data-body` token. */
+    token: string;
+    /** display name. */
+    label: string;
+    /** a two-letter periodic-table style symbol — the force's compact identity. */
+    symbol: string;
+    /** the per-frame law, in plain text. */
+    formula: string;
+    /** the `data-*` attribute suffixes it reads (without the `data-` prefix). */
+    attrs: readonly string[];
+    /** one-line technical description (the manual register). */
+    desc: string;
+    /** a sensory one-line headline — what the force feels like. */
+    summary: string;
+    /** the functional one-liner — what the force does, plainly. */
+    effect: string;
+    /** the force's canonical accent color (§20.2 reconciliation). */
+    color: string;
+    /** a one-line real-world use — what you'd reach for this force to do in a UI. */
+    example: string;
+    /**
+     * True when the force only acts while `b.on` is true (element is engaged / data-hot).
+     * Propagate emits waves, spawn creates particles — both silently idle without engagement.
+     * Demo templates should add `data-hot` so hover activates the effect.
+     */
+    requiresEngagement?: boolean;
+    /**
+     * Concrete Δv per frame at a reference point: strength=1, range=280, d=100px, one frame.
+     * Lets developers calibrate forces without running the Lab.
+     * Format: "Δv ≈ X px/frame at d=100px (S=1, r=280)"
+     */
+    calibration?: string;
+}
+/**
+ * The canonical color for every registered force (§20.2 reconciliation). The nine
+ * mirror `forces.config.ts`; the designed-extended forces take the §20.2 registry
+ * colors; the §20.10 natural primitives (added after that table) get principled,
+ * clash-free accents. A test pins the nine to `FORCE_BY` so they can't drift.
+ */
+export declare const FORCE_COLORS: Record<string, string>;
+/**
+ * A one-line real-world use for each force — the spirit of the original manual's
+ * "real use example" captions (the canonical nine are adapted from them; the rest
+ * are authored). The UI renders this alongside a live demo of the force.
+ */
+export declare const FORCE_EXAMPLES: Record<string, string>;
+/**
+ * A two-letter symbol for every force — a periodic-table style identity used by the
+ * design system and the Lab's SYMBOL view. Mostly the first two letters, with curated
+ * exceptions so each is unique and reads well (memory → My, magnetism → Mg,
+ * crystallize → Cz, propagate → Pg, spotlight → Sl, pigment → Pm).
+ */
+export declare const FORCE_SYMBOLS: Record<string, string>;
+/**
+ * A sensory one-line headline for every force — what it *feels* like, the register the
+ * Lab's force card leads with. Distinct from `desc` (technical) and `example` (UI use).
+ * Four entries (gravity·morph·resonate·spotlight) are written to match this engine's real
+ * physics rather than the design bundle's simplified reading of those names.
+ */
+export declare const FORCE_SUMMARIES: Record<string, string>;
+/** The functional one-liner for every force — what it does, plainly (the Lab's EFFECT line). */
+export declare const FORCE_EFFECTS: Record<string, string>;
+/** Every force with its color, symbol, copy, and calibration state merged in. Grouped by `family`. */
+export declare const MANUAL_FORCES: readonly ManualEntry[];
+/** A preset definition: its name, the primitive tokens it composes, and a real use (§20.9). */
+export interface ManualPreset {
+    name: string;
+    tokens: readonly string[];
+    desc: string;
+    example: string;
+}
+/** The cosmology/weather presets, as compositions (§20.9). */
+export declare const MANUAL_PRESETS: readonly ManualPreset[];
+/** The `data-when` condition gates (§5). */
+export declare const MANUAL_CONDITIONS: readonly {
+    id: string;
+    desc: string;
+}[];
+/** The four fundamental fields field-ui translates into interface behavior. */
+export type FundamentalField = 'gravity' | 'electromagnetic' | 'strong' | 'weak';
+/** The four fundamental fields as a runtime list (for validation + iteration). */
+export declare const FUNDAMENTAL_FIELDS: readonly FundamentalField[];
+/**
+ * How a token sits in the translation model:
+ * - `designed`  — a designed UI verb (the canonical forces + designed-extended); not a natural force.
+ * - `primitive` — a direct engine expression of a fundamental field (gravity, charge, magnetism…).
+ * - `derived`   — an effective behavior from many interactions or scalar fields (thermal, diffuse…).
+ * - `analogue`  — a material/structural analogue of strong/weak (cohesion, crystallize, morph…).
+ * - `transport` — motion ALONG field structure (fieldflow, pigment), not a force itself.
+ * - `metric`    — a persistence/measurement signal, not physics (memory).
+ */
+export type ForceKind = 'designed' | 'primitive' | 'derived' | 'analogue' | 'transport' | 'metric';
+/** Every force token's translation kind (covers all of MANUAL_FORCES; checked by a test). */
+export declare const FORCE_KIND: Record<string, ForceKind>;
+/** The fundamental-field parent for tokens that translate one (omitted for designed/derived/metric/transport with no single parent). */
+export declare const FORCE_FIELD: Record<string, FundamentalField>;
+/** A token's translation classification: its kind, and its fundamental-field parent if it has one. */
+export declare function classifyForce(token: string): {
+    kind: ForceKind | undefined;
+    field: FundamentalField | undefined;
+};
+/** One fundamental field, its interface translation, and the engine tokens that express it. */
+export interface NaturalFieldInfo {
+    field: FundamentalField;
+    /** display title. */
+    title: string;
+    /** the interface behavior it translates into. */
+    translation: string;
+    /** one-line gloss. */
+    summary: string;
+    /** interface needs this field serves. */
+    interfaceUses: readonly string[];
+    /** the engine tokens that express this field (derived from FORCE_FIELD). */
+    expressions: readonly string[];
+}
+/** The four fundamental fields as interface grammar — the spine of the Natural Field Translation System. */
+export declare const NATURAL_FIELDS: readonly NaturalFieldInfo[];
+//# sourceMappingURL=manual.d.ts.map