@fundamental-engine/core 0.4.0

package/dist/recipes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/recipes/index.ts"],"names":[],"mappings":"AAQA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAE7B,+DAA+D;AAC/D,MAAM,CAAC,MAAM,gBAAgB,GAA4B;IACvD;QACE,IAAI,EAAE,uBAAuB;QAC7B,SAAS,EAAE,qJAAqJ;QAChK,SAAS,EAAE,wDAAwD;QACnE,cAAc,EAAE,uCAAuC;QACvD,QAAQ,EAAE,gJAAgJ;QAC1J,WAAW,EAAE,kFAAkF;KAChG;IACD;QACE,IAAI,EAAE,yBAAyB;QAC/B,SAAS,EAAE,2OAA2O;QACtP,SAAS,EAAE,0GAA0G;QACrH,cAAc,EAAE,oGAAoG;QACpH,QAAQ,EAAE,sKAAsK;QAChL,WAAW,EAAE,qFAAqF;KACnG;IACD;QACE,IAAI,EAAE,0BAA0B;QAChC,SAAS,EAAE,uEAAuE;QAClF,SAAS,EAAE,6CAA6C;QACxD,cAAc,EAAE,yEAAyE;QACzF,QAAQ,EAAE,wEAAwE;QAClF,WAAW,EAAE,+DAA+D;KAC7E;CACF,CAAC"}

package/dist/recipes/intent.d.ts

@@ -0,0 +1,44 @@
+/**
+ * The intent compiler (authoring-and-recipes §4). Authors describe intent ("draw-focus") and the
+ * compiler emits the concrete force tokens, attributes, and render layers. It is inspectable: the
+ * compiled output is plain data the author can read back. Tokens use the current names (viscosity,
+ * wall — not the legacy drag/reflect).
+ */
+import type { RenderLayer } from './schema.ts';
+export interface IntentPreset {
+    /** force tokens the intent compiles to. */
+    body: string[];
+    /** default range in px. */
+    range?: number;
+    /** enable DOM write-back. */
+    feedback?: boolean;
+    /** render layers the intent turns on. */
+    render?: RenderLayer[];
+}
+/** The intent → composition table (authoring §4), mapped to real force tokens. */
+export declare const INTENT_PRESETS: Readonly<Record<string, IntentPreset>>;
+/** The concrete authoring output a compiled intent produces. */
+export interface CompiledIntent {
+    /** the `data-body` value. */
+    body: string;
+    strength?: number;
+    range?: number;
+    feedback: boolean;
+    render: RenderLayer[];
+    /** the data-* attribute set, ready to apply to an element. */
+    attributes: Record<string, string>;
+}
+export interface IntentOptions {
+    /** maps to data-strength (authoring's data-intensity). */
+    intensity?: number;
+    /** raises thermal/contrast for risky states (authoring's data-risk). */
+    risk?: 'low' | 'medium' | 'high';
+}
+/**
+ * Compile an intent + options into a concrete body composition. Returns null for an unknown intent
+ * (the author should see that, not get silent defaults).
+ */
+export declare function compileIntent(intent: string, opts?: IntentOptions): CompiledIntent | null;
+/** The known intent names, for inspectors / autocomplete. */
+export declare function knownIntents(): string[];
+//# sourceMappingURL=intent.d.ts.map

package/dist/recipes/intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../src/recipes/intent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yCAAyC;IACzC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,kFAAkF;AAClF,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CASjE,CAAC;AAEF,gEAAgE;AAChE,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,IAAI,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,cAAc,GAAG,IAAI,CAqB7F;AAED,6DAA6D;AAC7D,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC"}

package/dist/recipes/intent.js

@@ -0,0 +1,46 @@
+/** The intent → composition table (authoring §4), mapped to real force tokens. */
+export const INTENT_PRESETS = {
+    'draw-focus': { body: ['attract'], range: 280, feedback: true },
+    'clear-space': { body: ['repel'], range: 240 },
+    'show-motion': { body: ['stream'], render: ['trails'] },
+    'show-relationship': { body: ['memory'], render: ['links'] },
+    'contain-energy': { body: ['viscosity', 'wall'] },
+    ignite: { body: ['thermal', 'fieldflow'], render: ['heatmap', 'particles'] },
+    stabilize: { body: ['viscosity', 'cohesion'] },
+    warn: { body: ['repel', 'thermal'], feedback: true },
+};
+/**
+ * Compile an intent + options into a concrete body composition. Returns null for an unknown intent
+ * (the author should see that, not get silent defaults).
+ */
+export function compileIntent(intent, opts = {}) {
+    const preset = INTENT_PRESETS[intent];
+    if (!preset)
+        return null;
+    const body = [...preset.body];
+    // a high-risk intent adds a thermal warning layer if not already present
+    if (opts.risk === 'high' && !body.includes('thermal'))
+        body.push('thermal');
+    const attributes = { 'data-body': body.join(' ') };
+    if (opts.intensity != null)
+        attributes['data-strength'] = String(opts.intensity);
+    if (preset.range != null)
+        attributes['data-range'] = String(preset.range);
+    if (preset.feedback)
+        attributes['data-feedback'] = '';
+    if (preset.render?.length)
+        attributes['data-render'] = preset.render.join(' ');
+    return {
+        body: body.join(' '),
+        strength: opts.intensity,
+        range: preset.range,
+        feedback: preset.feedback ?? false,
+        render: preset.render ?? ['particles'],
+        attributes,
+    };
+}
+/** The known intent names, for inspectors / autocomplete. */
+export function knownIntents() {
+    return Object.keys(INTENT_PRESETS);
+}
+//# sourceMappingURL=intent.js.map

package/dist/recipes/intent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.js","sourceRoot":"","sources":["../../src/recipes/intent.ts"],"names":[],"mappings":"AAmBA,kFAAkF;AAClF,MAAM,CAAC,MAAM,cAAc,GAA2C;IACpE,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC/D,aAAa,EAAE,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE;IAC9C,aAAa,EAAE,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE;IACvD,mBAAmB,EAAE,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE;IAC5D,gBAAgB,EAAE,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE;IACjD,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE;IAC5E,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC,EAAE;IAC9C,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE;CACrD,CAAC;AAqBF;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,OAAsB,EAAE;IACpE,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,IAAI,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9B,yEAAyE;IACzE,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAE5E,MAAM,UAAU,GAA2B,EAAE,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IAC3E,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI;QAAE,UAAU,CAAC,eAAe,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjF,IAAI,MAAM,CAAC,KAAK,IAAI,IAAI;QAAE,UAAU,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1E,IAAI,MAAM,CAAC,QAAQ;QAAE,UAAU,CAAC,eAAe,CAAC,GAAG,EAAE,CAAC;IACtD,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM;QAAE,UAAU,CAAC,aAAa,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE/E,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;QACpB,QAAQ,EAAE,IAAI,CAAC,SAAS;QACxB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,KAAK;QAClC,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC;QACtC,UAAU;KACX,CAAC;AACJ,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,YAAY;IAC1B,OAAO,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AACrC,CAAC"}

package/dist/recipes/schema.d.ts

@@ -0,0 +1,103 @@
+import type { PerformanceBudget } from '../contracts/types.ts';
+import type { FundamentalField } from '../config/manual.ts';
+export type RenderLayer = 'particles' | 'dots' | 'trails' | 'links' | 'streamlines' | 'metaballs' | 'voronoi' | 'field-lines' | 'heatmap';
+/** A diagnostic mode that reveals a recipe's behavior (the debug / scalar / graph overlays). */
+export type DiagnosticMode = 'force-vectors' | 'contours' | 'potential' | 'energy' | 'topology' | 'inspector' | 'causality' | 'prediction';
+/** One body in a recipe: a force token (or space-separated tokens) + attributes. */
+export interface BodyRecipe {
+    body: string;
+    strength?: number;
+    range?: number;
+    spin?: number;
+    angle?: number;
+    feedback?: boolean;
+    scope?: 'local' | 'global';
+    /** condition gate for this body (`data-when`) — must be a REGISTERED engine condition id
+     *  (active, fast, slow, hot, cool, scrolling); validateRecipe rejects unknown ids so a
+     *  recipe can never declare a gate that silently never passes (#370). Recipe-level
+     *  `conditions` remain the activation vocabulary; `when` is the executable per-body gate. */
+    when?: string;
+}
+export interface RelationshipRecipe {
+    from: string;
+    to: string;
+    type: string;
+    strength?: number;
+}
+export interface AccessibilityRecipe {
+    /** what replaces motion under prefers-reduced-motion. */
+    reducedMotion: string;
+    /** how meaning survives without color/motion. */
+    meaningWithoutMotion: string;
+}
+export interface ExpectedMetrics {
+    particleCount?: number;
+    entropyRange?: [number, number];
+    energyDriftMax?: number;
+}
+/** Which catalog tier a recipe belongs to. */
+export type RecipeTier = 'core' | 'applied' | 'systems' | 'operational';
+/** A recipe's implementation status. */
+export type RecipeStatus = 'shipped' | 'experimental' | 'planned' | 'conceptual';
+/**
+ * A portable field recipe (authoring §5) — the reusable unit that connects the natural-field model,
+ * engine primitives, DOM authoring, platform feedback, diagnostics, and the accessibility fallback.
+ */
+export interface FieldRecipe {
+    /** stable kebab-case id (e.g. `priority-well`) — the recipe's identity across the docs + gallery. */
+    id: string;
+    name: string;
+    intent: string;
+    /** which catalog tier the recipe sits in (injected during assembly). */
+    tier?: RecipeTier;
+    /** the fundamental field this recipe translates (gravity / electromagnetic / strong / weak), if one dominates. */
+    naturalField?: FundamentalField;
+    /** a short natural-field translation phrase (conceptual), e.g. "priority, convergence, hierarchy". */
+    translation?: string;
+    /** RUNTIME TOKENS: the strict, real, passported engine forces this recipe composes (= distinct body tokens). */
+    primitives: string[];
+    /** CONCEPTS: human-facing product language (orbit, spring, trust, staleness) — never runtime tokens. */
+    concepts?: string[];
+    /** METRICS: measured / semantic state (mass, attention, pressure, confidence) — not forces. */
+    metrics: string[];
+    /** DIAGNOSTICS: inspection / render modes that reveal this recipe's behavior — not forces. */
+    diagnostics: string[];
+    /** CONDITIONS: activation logic (dwell, threshold, stale, in-view, focused) — not forces. */
+    conditions?: string[];
+    bodies: BodyRecipe[];
+    relationships?: RelationshipRecipe[];
+    render: RenderLayer[];
+    /** the reduced-motion + meaning-without-motion equivalent — required: no recipe is motion-only. */
+    accessibility: AccessibilityRecipe;
+    status?: RecipeStatus;
+    budget?: Partial<PerformanceBudget>;
+    expected?: ExpectedMetrics;
+    notes?: string;
+}
+/** @deprecated renamed to {@link FieldRecipe}. */
+export type SceneRecipe = FieldRecipe;
+/** A reusable render stack (authoring §6). */
+export interface VisualizationPreset {
+    name: string;
+    layers: RenderLayer[];
+    notes?: string;
+}
+/** Every render + diagnostic mode id a recipe may reference (mirrors `RENDER_MODES` + `particles`). */
+export declare const FIELD_MODES: ReadonlySet<string>;
+/** The distinct engine primitives used across a recipe's bodies, in first-seen order. */
+export declare function primitivesOf(bodies: readonly BodyRecipe[]): string[];
+export interface RecipeProblem {
+    path: string;
+    issue: string;
+}
+/**
+ * Validate a recipe's shape and references. Returns every problem (empty = valid). Each force token
+ * must be a real, passported force; each render layer + diagnostic must be a known mode; the declared
+ * primitives must match the body tokens; the natural field must be one of the four.
+ */
+export declare function validateRecipe(r: FieldRecipe): RecipeProblem[];
+/** Serialize a recipe to canonical JSON. */
+export declare function serializeRecipe(r: FieldRecipe): string;
+/** Parse + validate a recipe from JSON; throws on invalid shape. */
+export declare function parseRecipe(json: string): FieldRecipe;
+//# sourceMappingURL=schema.d.ts.map

package/dist/recipes/schema.d.ts.map

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

package/dist/recipes/schema.js

@@ -0,0 +1,123 @@
+import { FUNDAMENTAL_FIELDS } from "../config/manual.js";
+import { passportFor } from "../contracts/passport.js";
+/** A render layer in a scene's stack (matter / structure / scalar surfaces). */
+/** The engine's registered condition ids (core/conditions.ts) — the executable `when` gates. */
+import { conditions as ENGINE_CONDITION_REGISTRY } from "../core/conditions.js";
+const ENGINE_CONDITIONS = new Set(Object.keys(ENGINE_CONDITION_REGISTRY));
+const RENDER_LAYERS = new Set([
+    'particles', 'dots', 'trails', 'links', 'streamlines', 'metaballs', 'voronoi', 'field-lines', 'heatmap',
+]);
+const DIAGNOSTIC_MODES = new Set([
+    'force-vectors', 'contours', 'potential', 'energy', 'topology', 'inspector', 'causality', 'prediction',
+]);
+/** Every render + diagnostic mode id a recipe may reference (mirrors `RENDER_MODES` + `particles`). */
+export const FIELD_MODES = new Set([...RENDER_LAYERS, ...DIAGNOSTIC_MODES]);
+const VALID_FIELDS = new Set(FUNDAMENTAL_FIELDS);
+const VALID_TIERS = new Set(['core', 'applied', 'systems', 'operational']);
+const VALID_STATUS = new Set(['shipped', 'experimental', 'planned', 'conceptual']);
+/**
+ * Well-known words that belong to a DIFFERENT lane than runtime tokens. None of these is a passported
+ * force, so they can never be a primitive — this map exists only to turn the generic "unknown token"
+ * error into a lane-aware one ("'potential' is a diagnostic, not a runtime token"). Keys must never be
+ * real tokens (e.g. `pressure`, `memory`, `gate` are tokens and are deliberately absent here).
+ */
+const OTHER_LANE = {
+    // diagnostics / render modes
+    potential: 'diagnostic', topology: 'diagnostic', causality: 'diagnostic', prediction: 'diagnostic',
+    energy: 'diagnostic', contours: 'diagnostic', 'field-lines': 'diagnostic', 'force-vectors': 'diagnostic',
+    'velocity-vectors': 'diagnostic', inspector: 'diagnostic', heatmap: 'diagnostic',
+    // metrics
+    mass: 'metric', attention: 'metric', confidence: 'metric', trust: 'metric', risk: 'metric',
+    coherence: 'metric', entropy: 'metric', recency: 'metric', priority: 'metric', density: 'metric',
+    // concepts (product language)
+    spring: 'concept', orbit: 'concept', drag: 'concept', reflect: 'concept', absorb: 'concept',
+    decay: 'concept', staleness: 'concept', handoff: 'concept', emitter: 'concept', consensus: 'concept',
+    // conditions
+    threshold: 'condition', dwell: 'condition', stale: 'condition', 'in-view': 'condition',
+    focused: 'condition', selected: 'condition', related: 'condition', conflicted: 'condition',
+    // scheduler phases
+    discover: 'phase', read: 'phase', compute: 'phase', write: 'phase', render: 'phase',
+};
+/** The distinct engine primitives used across a recipe's bodies, in first-seen order. */
+export function primitivesOf(bodies) {
+    const seen = new Set();
+    const out = [];
+    for (const b of bodies ?? [])
+        for (const t of (b.body ?? '').split(/\s+/).filter(Boolean))
+            if (!seen.has(t)) {
+                seen.add(t);
+                out.push(t);
+            }
+    return out;
+}
+/**
+ * Validate a recipe's shape and references. Returns every problem (empty = valid). Each force token
+ * must be a real, passported force; each render layer + diagnostic must be a known mode; the declared
+ * primitives must match the body tokens; the natural field must be one of the four.
+ */
+export function validateRecipe(r) {
+    const problems = [];
+    if (!r.id)
+        problems.push({ path: 'id', issue: 'required' });
+    if (!r.name)
+        problems.push({ path: 'name', issue: 'required' });
+    if (!Array.isArray(r.bodies) || r.bodies.length === 0)
+        problems.push({ path: 'bodies', issue: 'at least one body is required' });
+    (r.bodies ?? []).forEach((b, i) => {
+        const tokens = (b.body ?? '').split(/\s+/).filter(Boolean);
+        if (tokens.length === 0)
+            problems.push({ path: `bodies[${i}].body`, issue: 'empty force token list' });
+        for (const t of tokens)
+            if (!passportFor(t))
+                problems.push({ path: `bodies[${i}].body`, issue: `unknown force token "${t}"` });
+        // an executable gate must resolve in the engine's condition registry — an unknown id would
+        // gate the body shut forever (the silent-contract-gap class this field exists to prevent).
+        if (b.when != null && !ENGINE_CONDITIONS.has(b.when))
+            problems.push({ path: `bodies[${i}].when`, issue: `unknown condition id "${b.when}" (registered: ${[...ENGINE_CONDITIONS].join(', ')})` });
+    });
+    // declared primitives must be exactly the distinct body tokens (no drift between data and bodies).
+    const derived = primitivesOf(r.bodies ?? []);
+    const declared = r.primitives ?? [];
+    if (declared.length !== derived.length || derived.some((t) => !declared.includes(t)) || declared.some((t) => !derived.includes(t)))
+        problems.push({ path: 'primitives', issue: `must list exactly the body tokens (expected: ${derived.join(', ') || 'none'})` });
+    // cross-lane guard: a primitive must be a real runtime token — never a diagnostic, metric, condition, or concept.
+    declared.forEach((p, i) => {
+        if (passportFor(p))
+            return;
+        const lane = OTHER_LANE[p];
+        problems.push({
+            path: `primitives[${i}]`,
+            issue: lane ? `"${p}" is a ${lane}, not a runtime token — move it to ${lane === 'phase' ? 'a scheduler phase' : lane + 's'}` : `unknown runtime token "${p}"`,
+        });
+    });
+    (r.render ?? []).forEach((layer, i) => {
+        if (!RENDER_LAYERS.has(layer))
+            problems.push({ path: `render[${i}]`, issue: `unknown render layer "${layer}"` });
+    });
+    (r.diagnostics ?? []).forEach((mode, i) => {
+        if (!FIELD_MODES.has(mode))
+            problems.push({ path: `diagnostics[${i}]`, issue: `unknown diagnostic mode "${mode}"` });
+    });
+    if (r.naturalField !== undefined && !VALID_FIELDS.has(r.naturalField))
+        problems.push({ path: 'naturalField', issue: `unknown fundamental field "${r.naturalField}"` });
+    if (r.tier !== undefined && !VALID_TIERS.has(r.tier))
+        problems.push({ path: 'tier', issue: `unknown tier "${r.tier}"` });
+    if (r.status !== undefined && !VALID_STATUS.has(r.status))
+        problems.push({ path: 'status', issue: `unknown status "${r.status}"` });
+    if (!r.accessibility || !r.accessibility.reducedMotion || !r.accessibility.meaningWithoutMotion)
+        problems.push({ path: 'accessibility', issue: 'reducedMotion + meaningWithoutMotion are required (no recipe is motion-only)' });
+    return problems;
+}
+/** Serialize a recipe to canonical JSON. */
+export function serializeRecipe(r) {
+    return JSON.stringify(r, null, 2);
+}
+/** Parse + validate a recipe from JSON; throws on invalid shape. */
+export function parseRecipe(json) {
+    const r = JSON.parse(json);
+    const problems = validateRecipe(r);
+    if (problems.length)
+        throw new Error(`invalid recipe: ${problems.map((p) => `${p.path} (${p.issue})`).join('; ')}`);
+    return r;
+}
+//# sourceMappingURL=schema.js.map

package/dist/recipes/schema.js.map

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

package/dist/recipes/wayfinding.d.ts

@@ -0,0 +1,39 @@
+/**
+ * The Wayfinding Field — two experimental `FieldRecipe`s that turn site navigation chrome into a
+ * member of the invisible-fields family: the nav's destinations become bodies, and the engine runs
+ * signals-only (`render: []`) to write CSS custom properties back onto the links. Nothing is drawn;
+ * the only visible thing is the consequence — destinations surfacing and receding. Progressive
+ * enhancement: with the engine off (or under reduced motion) the nav degrades to plain, reachable
+ * links with a labelled current state.
+ *
+ * Two distinct variations — by natural field, and by which wayfinding question they answer
+ * (the canonical "where am I / where can I go / where have I been", reading-field §):
+ *   • Wayfinding Field (gravity)           — "where am I, what's adjacent" (present-tense orientation).
+ *   • Wayfinding Current (electromagnetic)  — "where have I been" (the path travelled, the current from home).
+ *
+ * Both pass `validateRecipe` (real passported tokens, known render layers + diagnostics, primitives =
+ * body tokens, a fundamental field, a reduced-motion equivalent). They are kept OUT of the canonical
+ * 64-recipe `FIELD_RECIPES` catalog (a locked 4×16 of shipped recipes, cited as such across the
+ * papers) and marked `experimental` — they surface on the /recipes hub as a labelled experimental
+ * group, not folded into the canon.
+ */
+import type { FieldRecipe } from './schema.ts';
+/**
+ * Variation 1 — orientation by proximity. The current route is a gravity well; conserved attention
+ * brightens the destinations nearest it while the rest recede, and `cohesion` writes back
+ * `--field-coherence` so adjacency surfaces. The signature visual is a field-line traced from the
+ * wordmark (home) to the current destination.
+ */
+export declare const WAYFINDING_FIELD: FieldRecipe;
+/**
+ * Variation 2 — the journey. A current propagates from the wordmark (home/source) toward the current
+ * route along the nav's structure (`fieldflow`); visited destinations sink matter into a faint wake
+ * (the Sink/Accretion model) that `memory` holds across client-side navigation, riding along on the
+ * persisted field-root.
+ */
+export declare const WAYFINDING_CURRENT: FieldRecipe;
+/** The Wayfinding Field variations — experimental nav-chrome recipes, not part of `FIELD_RECIPES`. */
+export declare const WAYFINDING_RECIPES: readonly FieldRecipe[];
+/** Experimental recipes surfaced on the /recipes hub outside the canonical 64. */
+export declare const EXPERIMENTAL_RECIPES: readonly FieldRecipe[];
+//# sourceMappingURL=wayfinding.d.ts.map

package/dist/recipes/wayfinding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wayfinding.d.ts","sourceRoot":"","sources":["../../src/recipes/wayfinding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,WA4B9B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,WA8BhC,CAAC;AAEF,sGAAsG;AACtG,eAAO,MAAM,kBAAkB,EAAE,SAAS,WAAW,EAA2C,CAAC;AAKjG,kFAAkF;AAClF,eAAO,MAAM,oBAAoB,EAAE,SAAS,WAAW,EAItD,CAAC"}

package/dist/recipes/wayfinding.js

@@ -0,0 +1,77 @@
+/**
+ * Variation 1 — orientation by proximity. The current route is a gravity well; conserved attention
+ * brightens the destinations nearest it while the rest recede, and `cohesion` writes back
+ * `--field-coherence` so adjacency surfaces. The signature visual is a field-line traced from the
+ * wordmark (home) to the current destination.
+ */
+export const WAYFINDING_FIELD = {
+    id: 'wayfinding-field',
+    name: 'Wayfinding Field',
+    intent: 'orient the visitor in a navigation bar by surfacing where they are and what is adjacent',
+    naturalField: 'gravity',
+    status: 'experimental',
+    primitives: ['attract', 'tether', 'cohesion'],
+    concepts: ['wayfinding', 'orientation'],
+    conditions: ['in-view', 'focused'],
+    bodies: [
+        // the current route is the well — attention (conserved) pools toward it
+        { body: 'attract', strength: 1.1, range: 300, feedback: true },
+        // related destinations stay bound nearby rather than drifting off
+        { body: 'tether', strength: 0.6, range: 240 },
+        // coherence to the current route, written back as --field-coherence
+        { body: 'cohesion', strength: 0.5, range: 260, feedback: true },
+    ],
+    render: ['field-lines', 'heatmap'],
+    metrics: ['attention', 'coherence', 'priority'],
+    diagnostics: ['topology', 'field-lines', 'inspector'],
+    accessibility: {
+        reducedMotion: 'the current destination holds aria-current with a static underline; link weights stop travelling',
+        meaningWithoutMotion: 'links keep reading order and a labelled current state; adjacency reads as a visible grouping',
+    },
+    notes: 'Applied signals-only (render: []) over the nav: the simulation and feedback run, no canvas is drawn, and the only output is CSS custom properties on the links. The current route is a gravity well; conserved attention brightens the destinations nearest it while the rest recede; cohesion writes --field-coherence so adjacency surfaces. The declared render layers (field-lines, heatmap) are the visual vocabulary when the field is drawn — e.g. a field-line traced wordmark → current destination.',
+};
+/**
+ * Variation 2 — the journey. A current propagates from the wordmark (home/source) toward the current
+ * route along the nav's structure (`fieldflow`); visited destinations sink matter into a faint wake
+ * (the Sink/Accretion model) that `memory` holds across client-side navigation, riding along on the
+ * persisted field-root.
+ */
+export const WAYFINDING_CURRENT = {
+    id: 'wayfinding-current',
+    name: 'Wayfinding Current',
+    intent: 'trace the path a visitor has travelled and the current flowing from home to where they are',
+    naturalField: 'electromagnetic',
+    status: 'experimental',
+    primitives: ['propagate', 'fieldflow', 'sink', 'memory'],
+    concepts: ['wake', 'trail', 'provenance', 'accretion'],
+    conditions: ['return', 'related'],
+    bodies: [
+        // the signal travelling home → current route
+        { body: 'propagate', strength: 0.9, range: 360, feedback: true },
+        // carries the flow along the nav structure (transport, not a push — range 0)
+        { body: 'fieldflow', strength: 0.8, range: 0 },
+        // visited destinations sink matter into a wake (Sink/Accretion)
+        { body: 'sink', strength: 0.5, range: 240 },
+        // memory holds the visited trail across navigation
+        { body: 'memory', strength: 0.6, range: 280 },
+    ],
+    render: ['streamlines', 'heatmap', 'field-lines'],
+    metrics: ['signal', 'recency', 'memory'],
+    diagnostics: ['causality', 'field-lines', 'inspector'],
+    accessibility: {
+        reducedMotion: 'visited destinations get a static "seen" tick and the path reads as a breadcrumb — no travelling current',
+        meaningWithoutMotion: 'the journey is a breadcrumb list home → current; visited links are labelled seen',
+    },
+    notes: 'Applied signals-only over the nav. A current propagates from the wordmark (home/source) toward the current route along the nav structure (fieldflow carries, it does not push); visited destinations sink matter into a faint wake that memory holds across client-side navigation, riding on the persisted field-root. The declared render layers (streamlines, heatmap, field-lines) are the visual vocabulary when drawn.',
+};
+/** The Wayfinding Field variations — experimental nav-chrome recipes, not part of `FIELD_RECIPES`. */
+export const WAYFINDING_RECIPES = [WAYFINDING_FIELD, WAYFINDING_CURRENT];
+import { CHARGE_RECIPES } from "./charge.js";
+import { GRAVITY_RECIPES } from "./gravity.js";
+/** Experimental recipes surfaced on the /recipes hub outside the canonical 64. */
+export const EXPERIMENTAL_RECIPES = [
+    ...WAYFINDING_RECIPES,
+    ...CHARGE_RECIPES,
+    ...GRAVITY_RECIPES,
+];
+//# sourceMappingURL=wayfinding.js.map

package/dist/recipes/wayfinding.js.map

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

package/dist/semantic/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The semantic layer (BA2 — definition §11 "semantic truth", interaction §15/§23/§24). Maps
+ * interface *meaning* to field behavior: semantic layers (meaning→metric), interaction materials
+ * (feel→force composition), and field states (state→field behavior). Pure data + helpers — the
+ * "semantic truth" mode made concrete.
+ */
+import type { ContractMeta } from '../contracts/types.ts';
+export * from './layers.ts';
+export * from './materials.ts';
+export * from './states.ts';
+/** The semantic-mapping contracts (truth mode: semantic). */
+export declare const SEMANTIC_CONTRACTS: readonly ContractMeta[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/semantic/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAE5B,6DAA6D;AAC7D,eAAO,MAAM,kBAAkB,EAAE,SAAS,YAAY,EAyBrD,CAAC"}

package/dist/semantic/index.js

@@ -0,0 +1,31 @@
+export * from "./layers.js";
+export * from "./materials.js";
+export * from "./states.js";
+/** The semantic-mapping contracts (truth mode: semantic). */
+export const SEMANTIC_CONTRACTS = [
+    {
+        name: 'Semantic Layer Contract',
+        mustExist: 'a mapping from a meaning (importance, confidence, urgency…) to a field metric',
+        mayMutate: 'nothing — it produces a metric contribution the agent layer applies',
+        sideEffectFree: 'semanticToMetrics is pure',
+        testable: 'each layer maps to a real metric; values clamp to [0,1]',
+        inspectable: 'the SEMANTIC_LAYERS table',
+    },
+    {
+        name: 'Interaction Material Contract',
+        mustExist: 'a material → real force-token composition (feel built from behavior)',
+        mayMutate: 'nothing — it yields a data-body token string',
+        sideEffectFree: 'materialBody is pure',
+        testable: 'every material references real, passported forces',
+        inspectable: 'the INTERACTION_MATERIALS table',
+    },
+    {
+        name: 'Field State Contract',
+        mustExist: 'a named field state → the field behavior it implies',
+        mayMutate: 'nothing — it describes behavior',
+        sideEffectFree: 'isFieldState is pure',
+        testable: 'every state declares a behavior',
+        inspectable: 'the FIELD_STATES table',
+    },
+];
+//# sourceMappingURL=index.js.map

package/dist/semantic/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/semantic/index.ts"],"names":[],"mappings":"AAQA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAE5B,6DAA6D;AAC7D,MAAM,CAAC,MAAM,kBAAkB,GAA4B;IACzD;QACE,IAAI,EAAE,yBAAyB;QAC/B,SAAS,EAAE,+EAA+E;QAC1F,SAAS,EAAE,qEAAqE;QAChF,cAAc,EAAE,2BAA2B;QAC3C,QAAQ,EAAE,yDAAyD;QACnE,WAAW,EAAE,2BAA2B;KACzC;IACD;QACE,IAAI,EAAE,+BAA+B;QACrC,SAAS,EAAE,sEAAsE;QACjF,SAAS,EAAE,8CAA8C;QACzD,cAAc,EAAE,sBAAsB;QACtC,QAAQ,EAAE,mDAAmD;QAC7D,WAAW,EAAE,iCAAiC;KAC/C;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,SAAS,EAAE,qDAAqD;QAChE,SAAS,EAAE,iCAAiC;QAC5C,cAAc,EAAE,sBAAsB;QACtC,QAAQ,EAAE,iCAAiC;QAC3C,WAAW,EAAE,wBAAwB;KACtC;CACF,CAAC"}

package/dist/semantic/layers.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Semantic layers (definition §11, worldclass §8, visual §15, interaction §15) — the
+ * meaning→metric mapping that the "semantic truth" mode is about. It maps a piece of interface
+ * meaning (importance, confidence, urgency…) to the field metric that expresses it, so authors can
+ * drive the field from semantics instead of raw forces. Pure data + a tiny helper; node-testable.
+ */
+import type { ElementMetrics } from '../agents/element-agent.ts';
+export type SemanticLayer = 'importance' | 'confidence' | 'uncertainty' | 'urgency' | 'relationship' | 'history' | 'status' | 'hierarchy' | 'interactivity' | 'recency' | 'priority';
+/** Each semantic layer's target field metric (a key of ElementMetrics, or a conceptual one). */
+export interface SemanticMapping {
+    /** the metric this meaning drives. */
+    metric: keyof ElementMetrics | 'phase' | 'potential';
+    /** how it reads visually / behaviorally. */
+    response: string;
+}
+/** meaning → field metric (definition §11 / interaction §15 DataAgent merged). */
+export declare const SEMANTIC_LAYERS: Readonly<Record<SemanticLayer, SemanticMapping>>;
+/**
+ * Convert a semantic value (0..1) into the `ElementMetrics` contribution it implies, for the layers
+ * whose target metric is a real ElementMetric (status→phase and hierarchy→potential are conceptual
+ * and returned as `{}`). Pure.
+ */
+export declare function semanticToMetrics(layer: SemanticLayer, value: number): ElementMetrics;
+//# sourceMappingURL=layers.d.ts.map

package/dist/semantic/layers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layers.d.ts","sourceRoot":"","sources":["../../src/semantic/layers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,MAAM,MAAM,aAAa,GACrB,YAAY,GACZ,YAAY,GACZ,aAAa,GACb,SAAS,GACT,cAAc,GACd,SAAS,GACT,QAAQ,GACR,WAAW,GACX,eAAe,GACf,SAAS,GACT,UAAU,CAAC;AAEf,gGAAgG;AAChG,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,MAAM,EAAE,MAAM,cAAc,GAAG,OAAO,GAAG,WAAW,CAAC;IACrD,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,kFAAkF;AAClF,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,eAAe,CAAC,CAY5E,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,CAKrF"}

package/dist/semantic/layers.js

@@ -0,0 +1,27 @@
+/** meaning → field metric (definition §11 / interaction §15 DataAgent merged). */
+export const SEMANTIC_LAYERS = {
+    importance: { metric: 'attention', response: 'strength / attention, stronger presence' },
+    confidence: { metric: 'coherence', response: 'cleaner tone, stable hue, clarity' },
+    uncertainty: { metric: 'entropy', response: 'disorder, desaturation, blur' },
+    urgency: { metric: 'heat', response: 'warmer hue, higher glow' },
+    relationship: { metric: 'memory', response: 'topology links / threads' },
+    history: { metric: 'memory', response: 'patina, persistent tint, worn paths' },
+    status: { metric: 'phase', response: 'material phase (gas/liquid/solid/plasma)' },
+    hierarchy: { metric: 'pressure', response: 'potential / rank / depth' },
+    interactivity: { metric: 'density', response: 'feedback gain' },
+    recency: { metric: 'heat', response: 'recent = hot, cooling over time' },
+    priority: { metric: 'attention', response: 'attention share' },
+};
+/**
+ * Convert a semantic value (0..1) into the `ElementMetrics` contribution it implies, for the layers
+ * whose target metric is a real ElementMetric (status→phase and hierarchy→potential are conceptual
+ * and returned as `{}`). Pure.
+ */
+export function semanticToMetrics(layer, value) {
+    const m = SEMANTIC_LAYERS[layer];
+    const v = value < 0 ? 0 : value > 1 ? 1 : value;
+    if (m.metric === 'phase' || m.metric === 'potential')
+        return {};
+    return { [m.metric]: v };
+}
+//# sourceMappingURL=layers.js.map

package/dist/semantic/layers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layers.js","sourceRoot":"","sources":["../../src/semantic/layers.ts"],"names":[],"mappings":"AA6BA,kFAAkF;AAClF,MAAM,CAAC,MAAM,eAAe,GAAqD;IAC/E,UAAU,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,yCAAyC,EAAE;IACxF,UAAU,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,mCAAmC,EAAE;IAClF,WAAW,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,8BAA8B,EAAE;IAC5E,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,yBAAyB,EAAE;IAChE,YAAY,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,0BAA0B,EAAE;IACxE,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,qCAAqC,EAAE;IAC9E,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,0CAA0C,EAAE;IACjF,SAAS,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,0BAA0B,EAAE;IACvE,aAAa,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,EAAE;IAC/D,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,iCAAiC,EAAE;IACxE,QAAQ,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,iBAAiB,EAAE;CAC/D,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAoB,EAAE,KAAa;IACnE,MAAM,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAChD,IAAI,CAAC,CAAC,MAAM,KAAK,OAAO,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW;QAAE,OAAO,EAAE,CAAC;IAChE,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EAAoB,CAAC;AAC7C,CAAC"}

package/dist/semantic/materials.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Interaction materials (interaction §24, visual §11). Forces define behavior; materials define
+ * *feel*. Each material is a named composition of real force tokens (current names — viscosity, not
+ * drag; wall, not reflect) plus a suggested render layer. Validated against the passport registry
+ * by the test, so a material can't reference a force that doesn't exist.
+ */
+import type { RenderLayer } from '../recipes/schema.ts';
+export type InteractionMaterial = 'glass' | 'rubber' | 'liquid' | 'plasma' | 'dust' | 'metal' | 'fabric' | 'paper' | 'stone' | 'smoke';
+export interface MaterialRecipe {
+    /** force tokens that give the material its feel. */
+    tokens: string[];
+    /** render layers that suit it. */
+    render?: RenderLayer[];
+    /** the doc's plain description. */
+    note: string;
+}
+export declare const INTERACTION_MATERIALS: Readonly<Record<InteractionMaterial, MaterialRecipe>>;
+/** The `data-body` token string for a material. */
+export declare function materialBody(material: InteractionMaterial): string;
+//# sourceMappingURL=materials.d.ts.map