@fundamental-engine/core 0.4.0

package/dist/contracts/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * field-ui contracts (Phase 4). The formal, inspectable contract layer over the engine:
+ *  - `types.ts`   — named contract type definitions
+ *  - `passport.ts` — every force's declarative, validated description
+ *  - `guards.ts`  — dev-mode runtime enforcement (the Error Taxonomy)
+ *  - `CONTRACTS`  — the inspectable catalog: each contract and the five questions it answers
+ */
+import type { ContractMeta } from './types.ts';
+export * from './types.ts';
+export * from './passport.ts';
+export * from './guards.ts';
+/**
+ * The inspectable catalog of the foundational contracts (system-contracts §1–§16). Each records
+ * the five questions every contract answers. Agent-type, visual-language, and recipe contracts
+ * are formalized in later phases.
+ */
+export declare const CONTRACTS: readonly ContractMeta[];
+//# sourceMappingURL=index.d.ts.map

package/dist/contracts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAE5B;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,SAAS,YAAY,EAiG5C,CAAC"}

package/dist/contracts/index.js

@@ -0,0 +1,107 @@
+export * from "./types.js";
+export * from "./passport.js";
+export * from "./guards.js";
+/**
+ * The inspectable catalog of the foundational contracts (system-contracts §1–§16). Each records
+ * the five questions every contract answers. Agent-type, visual-language, and recipe contracts
+ * are formalized in later phases.
+ */
+export const CONTRACTS = [
+    {
+        name: 'Body Contract',
+        mustExist: 'id, element/owner, geometry provider, field target, write-back target, behavior registration, lifecycle hooks',
+        mayMutate: 'its own write-back target (CSS vars, data-state)',
+        sideEffectFree: 'its geometry provider (measurement must not change layout)',
+        testable: 'registry + scanner tests; the default body is the custom-element host',
+        inspectable: 'the ShadowRegistry size and the per-body rect',
+    },
+    {
+        name: 'Field Contract',
+        mustExist: 'field(body, x, y, env) → vector/scalar/compound/null, declaring its kind',
+        mayMutate: 'nothing',
+        sideEffectFree: 'the whole function — stable values for a fixed state; mutates no particles or bodies',
+        testable: 'field lines trace field(), not apply(); purity (same input → same output)',
+        inspectable: 'field lines, streamlines, heatmaps, Lab probes',
+    },
+    {
+        name: 'Force Contract',
+        mustExist: 'token, label, apply(); a passport declaring its physics (passport.ts)',
+        mayMutate: 'particle velocity, heat, phase, capture state, identity, life',
+        sideEffectFree: 'its optional field() hook',
+        testable: 'a conformance experiment per force; the passport is validated against ground truth',
+        inspectable: 'the passport and the conformance verdict (the Lab)',
+    },
+    {
+        name: 'Transport Contract',
+        mustExist: 'a primitive that moves matter along field geometry; fieldflow is canonical',
+        mayMutate: 'particle velocity (it does work) via env.fieldAt()',
+        sideEffectFree: 'must not replace another force’s physical law',
+        testable: 'fieldflow moves neutral matter along a field; magnetism alone does not',
+        inspectable: 'streamlines aligned to the field it follows',
+    },
+    {
+        name: 'Agent Contract',
+        mustExist: 'identity, state, inputs, outputs, accepted influence, emitted metrics, events, tests',
+        mayMutate: 'only its own outputs (DOM state for an ElementAgent; never particles unless also a body)',
+        sideEffectFree: 'its metric reads',
+        testable: 'per agent-kind response tests',
+        inspectable: 'its metrics and dispatched events (Phase 5 expands the kinds)',
+    },
+    {
+        name: 'Event Contract',
+        mustExist: 'a thresholded, debounced event with a useful detail payload, traceable to a metric',
+        mayMutate: 'nothing (it notifies)',
+        sideEffectFree: 'dispatch must not run physics',
+        testable: 'events are thresholded/debounced and do not fire every frame by default',
+        inspectable: 'the event type, source metric, threshold, and payload',
+    },
+    {
+        name: 'Feedback Contract',
+        mustExist: 'a write-back of field state to CSS vars / data-state / ElementInternals',
+        mayMutate: 'presentation (visually yes), not meaning',
+        sideEffectFree: 'must not break readability or require motion for meaning',
+        testable: 'density write-back sets --field-* / --d; reduced-motion holds meaning',
+        inspectable: 'the CSS variables and data-state written on each body',
+    },
+    {
+        name: 'Visualization Contract',
+        mustExist: 'a layer that reads field/particle/grid/relationship state to reveal it',
+        mayMutate: 'nothing — unless explicitly reclassified as feedback or force behavior',
+        sideEffectFree: 'the whole read path (debug overlays must not affect integration)',
+        testable: 'visualization does not alter physics; prediction mode does not mutate live state',
+        inspectable: 'each layer declares what it reads and whether it mutates physics',
+    },
+    {
+        name: 'Source/Sink Contract',
+        mustExist: 'a source budget (spawn rate, max particles, life, cooldown) or sink budget (capacity, saturation)',
+        mayMutate: 'particle count — within budget only',
+        sideEffectFree: 'budget accounting must be deterministic',
+        testable: 'no unbounded creation; a sink emits a saturation event',
+        inspectable: 'the live count vs. the declared cap',
+    },
+    {
+        name: 'Performance Contract',
+        mustExist: 'a budget for particles, bodies, local cells, field lines, heatmap resolution, DPR',
+        mayMutate: 'nothing (it bounds cost)',
+        sideEffectFree: 'budget evaluation',
+        testable: 'counts stay within budget; DPR is capped; debug overlays off in production',
+        inspectable: 'the budget vs. live counts',
+    },
+    {
+        name: 'Accessibility Contract',
+        mustExist: 'a reduced-motion fallback for any motion-dependent meaning; labels for interactive fields',
+        mayMutate: 'nothing physical — it constrains how feedback/visualization may present',
+        sideEffectFree: 'the checks (reduced-motion gating, lint) are pure',
+        testable: 'meaning survives without motion; events do not spam AT; color is not the sole carrier',
+        inspectable: 'reduced-motion state, the a11y lint findings, and ARIA on interactive fields',
+    },
+    {
+        name: 'Conformance Contract',
+        mustExist: 'proof for every force, render mode, agent, source/sink, recipe',
+        mayMutate: 'nothing',
+        sideEffectFree: 'the runner simulates headlessly without touching live state',
+        testable: 'golden math, behavioral scenario, snapshot, side-effect, threshold, reduced-motion',
+        inspectable: 'the Lab MATCH/NO-MATCH verdict per check',
+    },
+];
+//# sourceMappingURL=index.js.map

package/dist/contracts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AASA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAE5B;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAA4B;IAChD;QACE,IAAI,EAAE,eAAe;QACrB,SAAS,EAAE,+GAA+G;QAC1H,SAAS,EAAE,kDAAkD;QAC7D,cAAc,EAAE,4DAA4D;QAC5E,QAAQ,EAAE,uEAAuE;QACjF,WAAW,EAAE,+CAA+C;KAC7D;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,SAAS,EAAE,0EAA0E;QACrF,SAAS,EAAE,SAAS;QACpB,cAAc,EAAE,sFAAsF;QACtG,QAAQ,EAAE,2EAA2E;QACrF,WAAW,EAAE,gDAAgD;KAC9D;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,SAAS,EAAE,uEAAuE;QAClF,SAAS,EAAE,+DAA+D;QAC1E,cAAc,EAAE,2BAA2B;QAC3C,QAAQ,EAAE,oFAAoF;QAC9F,WAAW,EAAE,oDAAoD;KAClE;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,SAAS,EAAE,4EAA4E;QACvF,SAAS,EAAE,oDAAoD;QAC/D,cAAc,EAAE,+CAA+C;QAC/D,QAAQ,EAAE,wEAAwE;QAClF,WAAW,EAAE,6CAA6C;KAC3D;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,SAAS,EAAE,sFAAsF;QACjG,SAAS,EAAE,0FAA0F;QACrG,cAAc,EAAE,kBAAkB;QAClC,QAAQ,EAAE,+BAA+B;QACzC,WAAW,EAAE,+DAA+D;KAC7E;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,SAAS,EAAE,oFAAoF;QAC/F,SAAS,EAAE,uBAAuB;QAClC,cAAc,EAAE,+BAA+B;QAC/C,QAAQ,EAAE,yEAAyE;QACnF,WAAW,EAAE,uDAAuD;KACrE;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,SAAS,EAAE,yEAAyE;QACpF,SAAS,EAAE,0CAA0C;QACrD,cAAc,EAAE,0DAA0D;QAC1E,QAAQ,EAAE,uEAAuE;QACjF,WAAW,EAAE,uDAAuD;KACrE;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,SAAS,EAAE,wEAAwE;QACnF,SAAS,EAAE,wEAAwE;QACnF,cAAc,EAAE,kEAAkE;QAClF,QAAQ,EAAE,kFAAkF;QAC5F,WAAW,EAAE,kEAAkE;KAChF;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,SAAS,EAAE,mGAAmG;QAC9G,SAAS,EAAE,qCAAqC;QAChD,cAAc,EAAE,yCAAyC;QACzD,QAAQ,EAAE,wDAAwD;QAClE,WAAW,EAAE,qCAAqC;KACnD;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,SAAS,EAAE,mFAAmF;QAC9F,SAAS,EAAE,0BAA0B;QACrC,cAAc,EAAE,mBAAmB;QACnC,QAAQ,EAAE,4EAA4E;QACtF,WAAW,EAAE,4BAA4B;KAC1C;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,SAAS,EAAE,2FAA2F;QACtG,SAAS,EAAE,yEAAyE;QACpF,cAAc,EAAE,mDAAmD;QACnE,QAAQ,EAAE,uFAAuF;QACjG,WAAW,EAAE,8EAA8E;KAC5F;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,SAAS,EAAE,gEAAgE;QAC3E,SAAS,EAAE,SAAS;QACpB,cAAc,EAAE,6DAA6D;QAC7E,QAAQ,EAAE,oFAAoF;QAC9F,WAAW,EAAE,0CAA0C;KACxD;CACF,CAAC"}

package/dist/contracts/passport.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Force passports (system-contracts §3, testing-and-conformance §2).
+ *
+ * Every force declares a passport: what it is, what it mutates, whether it does work, whether it
+ * needs charge or velocity, whether it touches neutral matter, and how it can be visualized. The
+ * passport is the inspectable, lintable description that prose alone used to carry — and it is
+ * cross-checked against ground truth (the live registry + the conformance catalog) by the test
+ * suite, so it cannot silently drift from the implementation.
+ *
+ * Structural facts (family, class, ownsField, isSource, isModifier) are validated against the live
+ * `Force` objects and the conformance experiments. Physics semantics (doesWork, conservesSpeed,
+ * requiresCharge/Velocity, affectsNeutralMatter, usesFieldAt) are declared here and, where the
+ * conformance catalog proves them, cross-checked too.
+ */
+import type { Token, Force } from '../core/types.ts';
+import type { ForceClass, ForceConformance } from '../conformance/types.ts';
+/**
+ * The five truth modes the docs classify behavior by (definition §11, behavior-table, worldclass §1),
+ * plus `hybrid`. Forces are `physical`, `designed`, or `hybrid`; `diagnostic` classifies
+ * visualizations, `poetic` classifies composite presets, and `semantic` classifies the
+ * meaning→metric mappings (see `semantic/`).
+ */
+export type TruthMode = 'physical' | 'designed' | 'hybrid' | 'diagnostic' | 'poetic' | 'semantic';
+/** The truth-mode catalog (what each mode classifies), for inspectors. */
+export declare const TRUTH_MODES: Readonly<Record<TruthMode, string>>;
+/** Render modes + the renderable structure layers a force reads best in (incl. field-lines/heatmap). */
+export type RenderMode = 'dots' | 'trails' | 'links' | 'streamlines' | 'metaballs' | 'voronoi' | 'field-lines' | 'heatmap';
+/** A force's complete, inspectable contract description. */
+export interface ForcePassport {
+    token: Token;
+    label: string;
+    family: 'canonical' | 'natural' | 'extended';
+    /** input class (§20.1): A body→particle · B particle↔particle · C field-grid · D shape · S source · modifier. */
+    klass: ForceClass;
+    truthMode: TruthMode;
+    /** defines `field()` — a renderable field structure (charge, magnetism). */
+    ownsField: boolean;
+    /** reads `env.fieldAt()` to follow field geometry (transport). */
+    usesFieldAt: boolean;
+    /** moves particles (a non-no-op `apply`). False for pure modifiers and color-only forces. */
+    movesParticles: boolean;
+    /** changes a particle's kinetic energy. */
+    doesWork: boolean;
+    /** preserves |v| — a pure rotation or elastic reflection. */
+    conservesSpeed: boolean;
+    /** no effect on charge-free matter (q = 0). */
+    requiresCharge: boolean;
+    /** no effect on a still particle (needs motion). */
+    requiresVelocity: boolean;
+    /** acts on neutral (uncharged) matter. */
+    affectsNeutralMatter: boolean;
+    /** creates matter via `env.spawn` (class S) — must be budgeted. */
+    isSource: boolean;
+    /** affects sibling forces via `modify()` rather than moving matter directly. */
+    isModifier: boolean;
+    /** can be drawn as field lines (iff it owns a `field()`). */
+    canVisualizeFieldLines: boolean;
+    /** can be drawn as force vectors via a probe (iff it moves particles). */
+    canVisualizeForceVectors: boolean;
+    /** the render modes that read best for this force (testing §2 "Best render modes"). */
+    bestRenderModes: readonly RenderMode[];
+    /** preset composites this force commonly appears in (testing §2 "Common composites"). */
+    commonComposites: readonly string[];
+    designUse: string;
+    physicsNote: string;
+}
+/** The passport registry — `token → passport`, derived fields filled in. */
+export declare const PASSPORTS: Readonly<Record<Token, ForcePassport>>;
+/** The passport for a force token, or `undefined` if none is registered. */
+export declare function passportFor(token: Token): ForcePassport | undefined;
+/**
+ * The conformance-check labels that prove a force (testing-and-conformance §2 "Conformance tests"),
+ * derived from the live conformance catalog so the passport's proof list never drifts from the
+ * tests that actually run. Empty when a force has no experiment.
+ */
+export declare function conformanceTests(token: Token): string[];
+/** A problem found while validating passports against ground truth. */
+export interface PassportProblem {
+    token: string;
+    issue: string;
+}
+/**
+ * Validate the authored passports against the live registry and the conformance catalog. Returns
+ * every mismatch (empty array = all consistent). Used by the test suite — this is what keeps a
+ * passport honest: structural claims must match the implementation and the conformance class.
+ */
+export declare function validatePassports(registry: Readonly<Record<Token, Force>>, catalog: readonly ForceConformance[]): PassportProblem[];
+//# sourceMappingURL=passport.d.ts.map

package/dist/contracts/passport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"passport.d.ts","sourceRoot":"","sources":["../../src/contracts/passport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG5E;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GACjB,UAAU,GACV,UAAU,GACV,QAAQ,GACR,YAAY,GACZ,QAAQ,GACR,UAAU,CAAC;AAEf,0EAA0E;AAC1E,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAO3D,CAAC;AAEF,wGAAwG;AACxG,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,QAAQ,GACR,OAAO,GACP,aAAa,GACb,WAAW,GACX,SAAS,GACT,aAAa,GACb,SAAS,CAAC;AAEd,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,UAAU,CAAC;IAC7C,iHAAiH;IACjH,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;IACrB,4EAA4E;IAC5E,SAAS,EAAE,OAAO,CAAC;IACnB,kEAAkE;IAClE,WAAW,EAAE,OAAO,CAAC;IACrB,6FAA6F;IAC7F,cAAc,EAAE,OAAO,CAAC;IACxB,2CAA2C;IAC3C,QAAQ,EAAE,OAAO,CAAC;IAClB,6DAA6D;IAC7D,cAAc,EAAE,OAAO,CAAC;IACxB,+CAA+C;IAC/C,cAAc,EAAE,OAAO,CAAC;IACxB,oDAAoD;IACpD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,0CAA0C;IAC1C,oBAAoB,EAAE,OAAO,CAAC;IAC9B,mEAAmE;IACnE,QAAQ,EAAE,OAAO,CAAC;IAClB,gFAAgF;IAChF,UAAU,EAAE,OAAO,CAAC;IACpB,6DAA6D;IAC7D,sBAAsB,EAAE,OAAO,CAAC;IAChC,0EAA0E;IAC1E,wBAAwB,EAAE,OAAO,CAAC;IAClC,uFAAuF;IACvF,eAAe,EAAE,SAAS,UAAU,EAAE,CAAC;IACvC,yFAAyF;IACzF,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AA8FD,4EAA4E;AAC5E,eAAO,MAAM,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,aAAa,CAAC,CAE5D,CAAC;AAEF,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,aAAa,GAAG,SAAS,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,CAGvD;AAED,uEAAuE;AACvE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,EACxC,OAAO,EAAE,SAAS,gBAAgB,EAAE,GACnC,eAAe,EAAE,CA8BnB"}

package/dist/contracts/passport.js

@@ -0,0 +1,135 @@
+import { EXPERIMENTS } from "../conformance/experiments.js";
+/** The truth-mode catalog (what each mode classifies), for inspectors. */
+export const TRUTH_MODES = {
+    physical: 'modeled after a real physical law',
+    designed: 'shaped for readable UI behavior',
+    hybrid: 'a designed primitive operating over natural field geometry',
+    diagnostic: 'reveals internal state (visualizations, inspectors)',
+    poetic: 'an expressive composite from stable primitives (presets)',
+    semantic: 'maps data/interface meaning into physics',
+};
+/** Per-force render-mode + composite hints (the forces where they're meaningful). Others default. */
+const EXTRA = {
+    attract: { render: ['dots', 'metaballs'], composites: ['blackhole', 'galaxy', 'star'] },
+    repel: { render: ['dots'], composites: ['whitehole', 'nebula'] },
+    swirl: { render: ['trails', 'streamlines'], composites: ['galaxy', 'tornado'] },
+    stream: { render: ['trails', 'streamlines'], composites: ['fountain'] },
+    jet: { render: ['trails'], composites: ['fountain', 'quasar'] },
+    sink: { render: ['dots', 'metaballs'], composites: ['blackhole', 'accretion'] },
+    gravity: { render: ['field-lines', 'trails'], composites: ['blackhole', 'galaxy', 'star'] },
+    charge: { render: ['field-lines', 'dots'], composites: ['quasar'] },
+    magnetism: { render: ['field-lines', 'trails'], composites: ['star', 'quasar'] },
+    thermal: { render: ['heatmap', 'trails'], composites: ['star', 'nebula'] },
+    fieldflow: { render: ['streamlines', 'trails', 'field-lines'], composites: ['star', 'nebula', 'quasar'] },
+    diffuse: { render: ['heatmap'], composites: ['nebula'] },
+    link: { render: ['links'], composites: [] },
+    morph: { render: ['dots'], composites: [] },
+};
+// Derived fields (isSource, isModifier, canVisualize*, render/composite hints) are computed in
+// `finish()`, so they can never contradict the structural facts.
+function finish(r) {
+    const extra = EXTRA[r.token];
+    return {
+        ...r,
+        isSource: r.klass === 'S',
+        isModifier: r.klass === 'modifier',
+        canVisualizeFieldLines: r.ownsField,
+        canVisualizeForceVectors: r.movesParticles,
+        bestRenderModes: extra?.render ?? (r.ownsField ? ['field-lines', 'dots'] : ['dots']),
+        commonComposites: extra?.composites ?? [],
+    };
+}
+const C = 'canonical';
+const N = 'natural';
+const E = 'extended';
+const ROWS = [
+    // ── canonical nine (§6): designed interface verbs, class A ───────────────────────────────
+    { token: 'attract', label: 'Attract', family: C, klass: 'A', truthMode: 'designed', ownsField: false, usesFieldAt: false, movesParticles: true, doesWork: true, conservesSpeed: false, requiresCharge: false, requiresVelocity: false, affectsNeutralMatter: true, designUse: 'draw matter into a focus / well', physicsNote: 'soft (1 − d/r)² inward pull, optional orbital swirl' },
+    { token: 'repel', label: 'Repel', family: C, klass: 'A', truthMode: 'designed', ownsField: false, usesFieldAt: false, movesParticles: true, doesWork: true, conservesSpeed: false, requiresCharge: false, requiresVelocity: false, affectsNeutralMatter: true, designUse: 'carve a void / keep-clear region', physicsNote: 'soft (1 − d/r)² outward push' },
+    { token: 'swirl', label: 'Swirl', family: C, klass: 'A', truthMode: 'designed', ownsField: false, usesFieldAt: false, movesParticles: true, doesWork: true, conservesSpeed: false, requiresCharge: false, requiresVelocity: false, affectsNeutralMatter: true, designUse: 'rotate matter around a centre', physicsNote: 'tangential-dominant swirl with light inward retention' },
+    { token: 'stream', label: 'Stream', family: C, klass: 'A', truthMode: 'designed', ownsField: false, usesFieldAt: false, movesParticles: true, doesWork: true, conservesSpeed: false, requiresCharge: false, requiresVelocity: false, affectsNeutralMatter: true, designUse: 'flow matter along a heading', physicsNote: 'directional push along data-angle' },
+    { token: 'viscosity', label: 'Viscosity', family: C, klass: 'A', truthMode: 'designed', ownsField: false, usesFieldAt: false, movesParticles: true, doesWork: true, conservesSpeed: false, requiresCharge: false, requiresVelocity: true, affectsNeutralMatter: true, designUse: 'damp motion / calm a region', physicsNote: 'linear drag −γv (removes kinetic energy)' },
+    { token: 'jet', label: 'Jet', family: C, klass: 'A', truthMode: 'designed', ownsField: false, usesFieldAt: false, movesParticles: true, doesWork: true, conservesSpeed: false, requiresCharge: false, requiresVelocity: false, affectsNeutralMatter: true, designUse: 'launch matter at a heading', physicsNote: 'velocity-replacing relaunch (kinematic)' },
+    { token: 'tether', label: 'Tether', family: C, klass: 'A', truthMode: 'designed', ownsField: false, usesFieldAt: false, movesParticles: true, doesWork: true, conservesSpeed: false, requiresCharge: false, requiresVelocity: false, affectsNeutralMatter: true, designUse: 'bind matter to an anchor', physicsNote: 'spring toward a rest length' },
+    { token: 'wall', label: 'Wall', family: C, klass: 'A', truthMode: 'designed', ownsField: false, usesFieldAt: false, movesParticles: true, doesWork: false, conservesSpeed: true, requiresCharge: false, requiresVelocity: true, affectsNeutralMatter: true, designUse: 'bounce matter off a boundary', physicsNote: 'velocity-replacing elastic reflection (kinematic, speed preserved)' },
+    { token: 'sink', label: 'Sink', family: C, klass: 'A', truthMode: 'designed', ownsField: false, usesFieldAt: false, movesParticles: true, doesWork: true, conservesSpeed: false, requiresCharge: false, requiresVelocity: false, affectsNeutralMatter: true, designUse: 'capture matter (accretion well)', physicsNote: 'pull + capture within data-absorb radius, budgeted by data-max' },
+    // ── natural primitives (§20.10): real field laws ─────────────────────────────────────────
+    { token: 'gravity', label: 'Gravity', family: N, klass: 'A', truthMode: 'physical', ownsField: true, usesFieldAt: false, movesParticles: true, doesWork: true, conservesSpeed: false, requiresCharge: false, requiresVelocity: false, affectsNeutralMatter: true, designUse: 'universal attraction toward mass', physicsNote: 'softened inverse-square GM/(d² + ε²), always attractive' },
+    { token: 'charge', label: 'Charge', family: N, klass: 'A', truthMode: 'physical', ownsField: true, usesFieldAt: false, movesParticles: true, doesWork: true, conservesSpeed: false, requiresCharge: true, requiresVelocity: false, affectsNeutralMatter: false, designUse: 'attract/repel charged matter', physicsNote: 'F = σ·q·GM/(d² + ε²); like repels, opposite attracts; monopole E field()' },
+    { token: 'magnetism', label: 'Magnetism', family: N, klass: 'A', truthMode: 'physical', ownsField: true, usesFieldAt: false, movesParticles: true, doesWork: false, conservesSpeed: true, requiresCharge: true, requiresVelocity: true, affectsNeutralMatter: false, designUse: 'curve moving charges (cyclotron)', physicsNote: 'Lorentz F = q(v × B); perpendicular, does no work; dipole B field()' },
+    { token: 'thermal', label: 'Thermal', family: N, klass: 'A', truthMode: 'physical', ownsField: false, usesFieldAt: false, movesParticles: true, doesWork: true, conservesSpeed: false, requiresCharge: false, requiresVelocity: false, affectsNeutralMatter: true, designUse: 'agitate matter at a temperature', physicsNote: 'Langevin/Brownian kicks, σ = √(2T)' },
+    { token: 'collide', label: 'Collide', family: N, klass: 'B', truthMode: 'physical', ownsField: false, usesFieldAt: false, movesParticles: true, doesWork: true, conservesSpeed: false, requiresCharge: false, requiresVelocity: true, affectsNeutralMatter: true, designUse: 'hard-sphere / granular collision', physicsNote: 'elastic pairwise impulse, momentum-conserving (energy too at e = 1)' },
+    { token: 'diffuse', label: 'Diffuse', family: N, klass: 'C', truthMode: 'physical', ownsField: false, usesFieldAt: false, movesParticles: true, doesWork: true, conservesSpeed: false, requiresCharge: false, requiresVelocity: false, affectsNeutralMatter: true, designUse: 'spread a quantity over the medium', physicsNote: 'scalar diffusion over env.grid' },
+    { token: 'propagate', label: 'Propagate', family: N, klass: 'C', truthMode: 'physical', ownsField: false, usesFieldAt: false, movesParticles: true, doesWork: true, conservesSpeed: false, requiresCharge: false, requiresVelocity: false, affectsNeutralMatter: true, designUse: 'travelling waves through the medium', physicsNote: 'wave propagation over env.grid' },
+    { token: 'memory', label: 'Memory', family: N, klass: 'C', truthMode: 'semantic', ownsField: false, usesFieldAt: false, movesParticles: true, doesWork: true, conservesSpeed: false, requiresCharge: false, requiresVelocity: false, affectsNeutralMatter: true, designUse: 'a decaying trail / hysteresis', physicsNote: 'a persistence METRIC (FORCE_KIND = metric), not a physical law: a decaying occupancy grid that biases motion toward worn paths. Lives in natural.ts (file grouping), but its truthMode is semantic — meaning→metric — not physical.' },
+    // ── extended designed forces (§20.3) ─────────────────────────────────────────────────────
+    { token: 'fieldflow', label: 'Fieldflow', family: E, klass: 'A', truthMode: 'hybrid', ownsField: false, usesFieldAt: true, movesParticles: true, doesWork: true, conservesSpeed: false, requiresCharge: false, requiresVelocity: false, affectsNeutralMatter: true, designUse: 'solar prominences, aurora, plasma streams, guided matter', physicsNote: 'field-aligned transport: steers + accelerates matter along env.fieldAt(); carries neutral matter (magnetism does not)' },
+    { token: 'lens', label: 'Lens', family: E, klass: 'A', truthMode: 'designed', ownsField: false, usesFieldAt: false, movesParticles: true, doesWork: true, conservesSpeed: false, requiresCharge: false, requiresVelocity: true, affectsNeutralMatter: true, designUse: 'bend passing matter (refraction)', physicsNote: 'velocity-replacing deflection (kinematic)' },
+    { token: 'gate', label: 'Gate', family: E, klass: 'A', truthMode: 'designed', ownsField: false, usesFieldAt: false, movesParticles: true, doesWork: true, conservesSpeed: false, requiresCharge: false, requiresVelocity: true, affectsNeutralMatter: true, designUse: 'admit or deflect matter at a boundary', physicsNote: 'velocity-replacing gate (kinematic)' },
+    { token: 'buoyancy', label: 'Buoyancy', family: E, klass: 'A', truthMode: 'designed', ownsField: false, usesFieldAt: false, movesParticles: true, doesWork: true, conservesSpeed: false, requiresCharge: false, requiresVelocity: false, affectsNeutralMatter: true, designUse: 'sort matter by size/mass vertically', physicsNote: 'size-graded vertical lift' },
+    { token: 'shear', label: 'Shear', family: E, klass: 'A', truthMode: 'designed', ownsField: false, usesFieldAt: false, movesParticles: true, doesWork: true, conservesSpeed: false, requiresCharge: false, requiresVelocity: false, affectsNeutralMatter: true, designUse: 'a velocity gradient across a region', physicsNote: 'position-dependent directional shear' },
+    { token: 'crystallize', label: 'Crystallize', family: E, klass: 'A', truthMode: 'designed', ownsField: false, usesFieldAt: false, movesParticles: true, doesWork: true, conservesSpeed: false, requiresCharge: false, requiresVelocity: false, affectsNeutralMatter: true, designUse: 'snap matter onto a lattice', physicsNote: 'pull toward nearest lattice site' },
+    { token: 'align', label: 'Align', family: E, klass: 'B', truthMode: 'designed', ownsField: false, usesFieldAt: false, movesParticles: true, doesWork: true, conservesSpeed: false, requiresCharge: false, requiresVelocity: true, affectsNeutralMatter: true, designUse: 'flocking — match neighbour heading', physicsNote: 'neighbour velocity averaging (boids alignment)' },
+    { token: 'wind', label: 'Wind', family: E, klass: 'A', truthMode: 'designed', ownsField: false, usesFieldAt: false, movesParticles: true, doesWork: true, conservesSpeed: false, requiresCharge: false, requiresVelocity: false, affectsNeutralMatter: true, designUse: 'a directional ambient current', physicsNote: 'uniform directional push' },
+    { token: 'cohesion', label: 'Cohesion', family: E, klass: 'B', truthMode: 'designed', ownsField: false, usesFieldAt: false, movesParticles: true, doesWork: true, conservesSpeed: false, requiresCharge: false, requiresVelocity: false, affectsNeutralMatter: true, designUse: 'flocking — pull toward neighbours', physicsNote: 'steer toward local neighbour centroid (boids cohesion)' },
+    { token: 'pressure', label: 'Pressure', family: E, klass: 'B', truthMode: 'designed', ownsField: false, usesFieldAt: false, movesParticles: true, doesWork: true, conservesSpeed: false, requiresCharge: false, requiresVelocity: false, affectsNeutralMatter: true, designUse: 'relax crowding (incompressibility)', physicsNote: 'SPH density relaxation, momentum-conserving' },
+    { token: 'hunt', label: 'Hunt', family: E, klass: 'B', truthMode: 'designed', ownsField: false, usesFieldAt: false, movesParticles: true, doesWork: true, conservesSpeed: false, requiresCharge: false, requiresVelocity: false, affectsNeutralMatter: true, designUse: 'predator/prey pursuit and flight', physicsNote: 'species-dependent neighbour pursuit/evasion' },
+    { token: 'spawn', label: 'Spawn', family: E, klass: 'S', truthMode: 'designed', ownsField: false, usesFieldAt: false, movesParticles: false, doesWork: true, conservesSpeed: false, requiresCharge: false, requiresVelocity: false, affectsNeutralMatter: true, designUse: 'emit new matter (a budgeted source)', physicsNote: 'creates matter via env.spawn, once per body per frame; budgeted by lifespan + pool ceiling' },
+    { token: 'link', label: 'Link', family: E, klass: 'B', truthMode: 'designed', ownsField: false, usesFieldAt: false, movesParticles: true, doesWork: true, conservesSpeed: false, requiresCharge: false, requiresVelocity: false, affectsNeutralMatter: true, designUse: 'ropes / cloth between neighbours', physicsNote: 'Verlet rest-length bonds to neighbours in radius' },
+    { token: 'morph', label: 'Morph', family: E, klass: 'D', truthMode: 'designed', ownsField: false, usesFieldAt: false, movesParticles: true, doesWork: true, conservesSpeed: false, requiresCharge: false, requiresVelocity: false, affectsNeutralMatter: true, designUse: 'assemble matter into a mark/shape (never words, §11)', physicsNote: 'springs matter to body.targets marks' },
+    { token: 'resonate', label: 'Resonate', family: E, klass: 'modifier', truthMode: 'designed', ownsField: false, usesFieldAt: false, movesParticles: false, doesWork: false, conservesSpeed: true, requiresCharge: false, requiresVelocity: false, affectsNeutralMatter: false, designUse: 'amplify sibling forces rhythmically', physicsNote: 'no-op apply; modify() scales sibling strength per frame' },
+    { token: 'spotlight', label: 'Spotlight', family: E, klass: 'modifier', truthMode: 'designed', ownsField: false, usesFieldAt: false, movesParticles: false, doesWork: false, conservesSpeed: true, requiresCharge: false, requiresVelocity: false, affectsNeutralMatter: false, designUse: 'gate sibling forces by region/condition', physicsNote: 'no-op apply; modify() gates siblings' },
+    { token: 'screen', label: 'Screen', family: E, klass: 'modifier', truthMode: 'designed', ownsField: false, usesFieldAt: false, movesParticles: false, doesWork: false, conservesSpeed: true, requiresCharge: false, requiresVelocity: false, affectsNeutralMatter: false, designUse: 'quiet zones / shield text from noisy fields', physicsNote: "no-op apply; the integrator damps OTHER bodies' forces by clamp(1 − S·(1 − d/r)², min, 1) on matter inside data-range (cross-body, unlike spotlight/resonate which modify their own siblings)" },
+    { token: 'pigment', label: 'Pigment', family: E, klass: 'A', truthMode: 'designed', ownsField: false, usesFieldAt: false, movesParticles: false, doesWork: false, conservesSpeed: true, requiresCharge: false, requiresVelocity: false, affectsNeutralMatter: true, designUse: 'transport color through matter', physicsNote: 'tints particle color; does not change motion' },
+    { token: 'warp', label: 'Warp', family: E, klass: 'A', truthMode: 'designed', ownsField: false, usesFieldAt: false, movesParticles: true, doesWork: false, conservesSpeed: true, requiresCharge: false, requiresVelocity: false, affectsNeutralMatter: true, designUse: 'relocate matter to a paired throat (a wormhole)', physicsNote: 'velocity-replacing teleport (kinematic): repositions to the data-pair body and rotates velocity by data-twist; speed preserved, count conserved' },
+];
+/** The passport registry — `token → passport`, derived fields filled in. */
+export const PASSPORTS = Object.freeze(Object.fromEntries(ROWS.map((r) => [r.token, finish(r)])));
+/** The passport for a force token, or `undefined` if none is registered. */
+export function passportFor(token) {
+    return PASSPORTS[token];
+}
+/**
+ * The conformance-check labels that prove a force (testing-and-conformance §2 "Conformance tests"),
+ * derived from the live conformance catalog so the passport's proof list never drifts from the
+ * tests that actually run. Empty when a force has no experiment.
+ */
+export function conformanceTests(token) {
+    const c = EXPERIMENTS.find((e) => e.scenario.force === token);
+    return c ? c.expectations.map((x) => x.label) : [];
+}
+/**
+ * Validate the authored passports against the live registry and the conformance catalog. Returns
+ * every mismatch (empty array = all consistent). Used by the test suite — this is what keeps a
+ * passport honest: structural claims must match the implementation and the conformance class.
+ */
+export function validatePassports(registry, catalog) {
+    const problems = [];
+    const byToken = new Map(catalog.map((c) => [c.scenario.force, c.scenario]));
+    for (const token of Object.keys(registry)) {
+        const p = PASSPORTS[token];
+        if (!p) {
+            problems.push({ token, issue: 'no passport (every force needs one)' });
+            continue;
+        }
+        const force = registry[token];
+        const ownsField = typeof force.field === 'function';
+        if (p.ownsField !== ownsField)
+            problems.push({ token, issue: `ownsField=${p.ownsField} but force.field ${ownsField ? 'exists' : 'is absent'}` });
+        if (p.canVisualizeFieldLines !== ownsField)
+            problems.push({ token, issue: 'canVisualizeFieldLines must equal ownsField' });
+        const scenario = byToken.get(token);
+        if (scenario) {
+            if (p.family !== scenario.family)
+                problems.push({ token, issue: `family=${p.family} but conformance says ${scenario.family}` });
+            if (p.klass !== scenario.klass)
+                problems.push({ token, issue: `klass=${p.klass} but conformance says ${scenario.klass}` });
+        }
+        if (p.isSource !== (p.klass === 'S'))
+            problems.push({ token, issue: 'isSource must equal (klass === S)' });
+        if (p.isModifier !== (p.klass === 'modifier'))
+            problems.push({ token, issue: 'isModifier must equal (klass === modifier)' });
+    }
+    return problems;
+}
+//# sourceMappingURL=passport.js.map

package/dist/contracts/passport.js.map

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

package/dist/contracts/types.d.ts

@@ -0,0 +1,120 @@
+/**
+ * field-ui formal contracts (Phase 4 — system-contracts.md §1–§18).
+ *
+ * The engine already *implements* its contracts (the `Force`, `Body`, `Env` shapes in
+ * `core/types.ts`, the `ShadowRegistry`, the conformance framework). This module makes them
+ * **explicit, declarative, and inspectable**: named contract types plus a catalog that records,
+ * for each, the five questions every contract must answer —
+ *
+ *   What must exist?  ·  What may mutate state?  ·  What must stay side-effect free?
+ *   What must be testable?  ·  What must be inspectable?
+ *
+ * Nothing here changes runtime behavior. The force/agent *semantics* live in `passport.ts`; the
+ * runtime enforcement lives in `guards.ts`.
+ */
+/** The five questions every contract answers (system-contracts §Purpose). Inspectable metadata. */
+export interface ContractMeta {
+    /** the contract's name, e.g. "Force Contract". */
+    name: string;
+    /** what must exist for the contract to hold. */
+    mustExist: string;
+    /** what the contract is allowed to mutate. */
+    mayMutate: string;
+    /** what must remain side-effect free (pure). */
+    sideEffectFree: string;
+    /** how the contract is proven. */
+    testable: string;
+    /** how the contract is observed/debugged. */
+    inspectable: string;
+}
+/** A budgeted matter source. No unbounded creation. */
+export interface SourceBudget {
+    /** particles spawned per body per second (or per frame, documented by the source). */
+    spawnRate: number;
+    /** hard ceiling on live particles this source may sustain. */
+    maxParticles: number;
+    /** particle lifespan in seconds before despawn (mortal matter). */
+    particleLife: number;
+    /** optional energy budget; omit for unbounded-energy (still particle-capped) sources. */
+    energyBudget?: number;
+    /** seconds between spawn bursts. */
+    cooldown?: number;
+}
+/** A budgeted matter sink. */
+export interface SinkBudget {
+    /** maximum captured particles. */
+    capacity: number;
+    /** what happens at capacity — release them, or stop capturing. */
+    saturation: 'release' | 'hold' | 'destroy';
+    /** fraction of capacity at which `field:saturated` fires. */
+    saturationThreshold: number;
+}
+/** Every field runs within a budget. */
+export interface PerformanceBudget {
+    particles: number;
+    bodies: number;
+    localCells: number;
+    fieldLines: number;
+    /** heatmap cell size in px (4–8 recommended). */
+    heatmapResolution: number;
+    /** device-pixel-ratio cap. */
+    dprCap: number;
+}
+/** The suggested defaults (system-contracts §15). */
+export declare const DEFAULT_BUDGET: PerformanceBudget;
+/** A field event must be thresholded, debounced, inspectable, and traceable to a metric. */
+export interface EventContract {
+    /** the event type, e.g. `field:lit` (with its `forces:` alias). */
+    type: string;
+    /** the field metric that triggers it. */
+    sourceMetric: string;
+    /** crossing value that fires it (no per-frame firing by default). */
+    threshold: number;
+    /** debounce window in ms. */
+    debounceMs: number;
+}
+/** Feedback writes field state back to the DOM. May mutate presentation; must stay accessible. */
+export interface FeedbackContract {
+    /** CSS custom properties written (e.g. `--field-density`). */
+    cssVars: readonly string[];
+    /** data-* state attributes written. */
+    dataState: readonly string[];
+    /** does it require motion to convey meaning? Must be false (accessibility). */
+    motionRequiredForMeaning: false;
+}
+/** A visualization reveals state. It must not mutate physics unless declared as feedback. */
+export interface VisualizationContract {
+    name: string;
+    /** what it reads — `field()`, particle history, scalar grid, relationship agents. */
+    readsFrom: string;
+    /** must be false unless reclassified as feedback/force. */
+    mutatesPhysics: boolean;
+}
+/** A transport primitive moves matter along field geometry (fieldflow is canonical). */
+export interface TransportContract {
+    token: string;
+    /** transport may do work. */
+    doesWork: true;
+    /** transport reads existing field geometry via env.fieldAt(). */
+    usesFieldAt: true;
+    /** behavior when there is no field to follow. */
+    zeroFieldBehavior: string;
+    /** behavior beyond the source's range. */
+    rangeBehavior: string;
+    /** transport must not replace another force's physical law. */
+    replacesForceLaw: false;
+}
+/** Anything that can receive influence, hold state, change behavior, or affect another thing. */
+export interface AgentContract {
+    kind: string;
+    identity: string;
+    inputs: readonly string[];
+    outputs: readonly string[];
+    /** metrics it emits. */
+    metrics: readonly string[];
+    /** events it can dispatch. */
+    events: readonly string[];
+    /** conformance tests that prove it. */
+    tests: readonly string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/contracts/types.d.ts.map

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

package/dist/contracts/types.js

@@ -0,0 +1,24 @@
+/**
+ * field-ui formal contracts (Phase 4 — system-contracts.md §1–§18).
+ *
+ * The engine already *implements* its contracts (the `Force`, `Body`, `Env` shapes in
+ * `core/types.ts`, the `ShadowRegistry`, the conformance framework). This module makes them
+ * **explicit, declarative, and inspectable**: named contract types plus a catalog that records,
+ * for each, the five questions every contract must answer —
+ *
+ *   What must exist?  ·  What may mutate state?  ·  What must stay side-effect free?
+ *   What must be testable?  ·  What must be inspectable?
+ *
+ * Nothing here changes runtime behavior. The force/agent *semantics* live in `passport.ts`; the
+ * runtime enforcement lives in `guards.ts`.
+ */
+/** The suggested defaults (system-contracts §15). */
+export const DEFAULT_BUDGET = {
+    particles: 600,
+    bodies: 80,
+    localCells: 3,
+    fieldLines: 256,
+    heatmapResolution: 6,
+    dprCap: 2,
+};
+//# sourceMappingURL=types.js.map

package/dist/contracts/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/contracts/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAsDH,qDAAqD;AACrD,MAAM,CAAC,MAAM,cAAc,GAAsB;IAC/C,SAAS,EAAE,GAAG;IACd,MAAM,EAAE,EAAE;IACV,UAAU,EAAE,CAAC;IACb,UAAU,EAAE,GAAG;IACf,iBAAiB,EAAE,CAAC;IACpB,MAAM,EAAE,CAAC;CACV,CAAC"}