@fundamental-engine/core 0.4.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"materials.d.ts","sourceRoot":"","sources":["../../src/semantic/materials.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,MAAM,MAAM,mBAAmB,GAC3B,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,OAAO,GACP,QAAQ,GACR,OAAO,GACP,OAAO,GACP,OAAO,CAAC;AAEZ,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,kCAAkC;IAClC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IACvB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,mBAAmB,EAAE,cAAc,CAAC,CAWvF,CAAC;AAEF,mDAAmD;AACnD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,CAElE"}

package/dist/semantic/materials.js

@@ -0,0 +1,17 @@
+export const INTERACTION_MATERIALS = {
+    glass: { tokens: ['lens', 'wall'], note: 'lens + reflect + low drag' },
+    rubber: { tokens: ['tether', 'viscosity'], note: 'spring + damping' },
+    liquid: { tokens: ['cohesion', 'pressure'], render: ['metaballs'], note: 'cohesion + pressure' },
+    plasma: { tokens: ['fieldflow', 'thermal'], render: ['trails', 'field-lines'], note: 'fieldflow + thermal + trails' },
+    dust: { tokens: ['diffuse'], note: 'diffuse + low mass' },
+    metal: { tokens: ['magnetism', 'wall'], note: 'magnetism + reflect' },
+    fabric: { tokens: ['link', 'shear'], note: 'link + shear' },
+    paper: { tokens: ['memory'], note: 'low motion + memory' },
+    stone: { tokens: ['wall'], note: 'high mass + low response' },
+    smoke: { tokens: ['diffuse', 'stream'], render: ['trails'], note: 'diffuse + stream + entropy' },
+};
+/** The `data-body` token string for a material. */
+export function materialBody(material) {
+    return INTERACTION_MATERIALS[material].tokens.join(' ');
+}
+//# sourceMappingURL=materials.js.map

package/dist/semantic/materials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"materials.js","sourceRoot":"","sources":["../../src/semantic/materials.ts"],"names":[],"mappings":"AA6BA,MAAM,CAAC,MAAM,qBAAqB,GAA0D;IAC1F,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,2BAA2B,EAAE;IACtE,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE;IACrE,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE;IAChG,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE,IAAI,EAAE,8BAA8B,EAAE;IACrH,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE;IACzD,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE;IACrE,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE;IAC3D,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE;IAC1D,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,0BAA0B,EAAE;IAC7D,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,4BAA4B,EAAE;CACjG,CAAC;AAEF,mDAAmD;AACnD,MAAM,UAAU,YAAY,CAAC,QAA6B;IACxD,OAAO,qBAAqB,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC"}

package/dist/semantic/states.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Field states (worldclass §9, interaction §23 "state machines as physical scenes"). A small,
+ * named state set plus the field behavior each implies — so a component's state machine can map
+ * directly onto field behavior. Pure data + transition validation; node-testable.
+ */
+export type FieldState = 'idle' | 'focused' | 'searching' | 'navigating' | 'reading' | 'warning' | 'critical' | 'celebrating' | 'hovered' | 'pressed' | 'loading' | 'success' | 'error';
+/** state → the field behavior it produces (interaction §23 table). */
+export declare const FIELD_STATES: Readonly<Record<FieldState, string>>;
+/** Whether a string is a known field state. */
+export declare function isFieldState(s: string): s is FieldState;
+//# sourceMappingURL=states.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"states.d.ts","sourceRoot":"","sources":["../../src/semantic/states.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,UAAU,GAElB,MAAM,GACN,SAAS,GACT,WAAW,GACX,YAAY,GACZ,SAAS,GACT,SAAS,GACT,UAAU,GACV,aAAa,GAEb,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,OAAO,CAAC;AAEZ,sEAAsE;AACtE,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAc7D,CAAC;AAEF,+CAA+C;AAC/C,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,IAAI,UAAU,CAEvD"}

package/dist/semantic/states.js

@@ -0,0 +1,26 @@
+/**
+ * Field states (worldclass §9, interaction §23 "state machines as physical scenes"). A small,
+ * named state set plus the field behavior each implies — so a component's state machine can map
+ * directly onto field behavior. Pure data + transition validation; node-testable.
+ */
+/** state → the field behavior it produces (interaction §23 table). */
+export const FIELD_STATES = {
+    idle: 'ambient',
+    focused: 'attract + feedback',
+    searching: 'scatter → wells',
+    navigating: 'stream',
+    reading: 'memory trail',
+    warning: 'entropy / thermal',
+    critical: 'reduce sources / warn',
+    celebrating: 'burst / emission',
+    hovered: 'attract',
+    pressed: 'sink (absorb)',
+    loading: 'stream / swirl',
+    success: 'release',
+    error: 'repel + thermal',
+};
+/** Whether a string is a known field state. */
+export function isFieldState(s) {
+    return s in FIELD_STATES;
+}
+//# sourceMappingURL=states.js.map

package/dist/semantic/states.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"states.js","sourceRoot":"","sources":["../../src/semantic/states.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmBH,sEAAsE;AACtE,MAAM,CAAC,MAAM,YAAY,GAAyC;IAChE,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,oBAAoB;IAC7B,SAAS,EAAE,iBAAiB;IAC5B,UAAU,EAAE,QAAQ;IACpB,OAAO,EAAE,cAAc;IACvB,OAAO,EAAE,mBAAmB;IAC5B,QAAQ,EAAE,uBAAuB;IACjC,WAAW,EAAE,kBAAkB;IAC/B,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,eAAe;IACxB,OAAO,EAAE,gBAAgB;IACzB,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,iBAAiB;CACzB,CAAC;AAEF,+CAA+C;AAC/C,MAAM,UAAU,YAAY,CAAC,CAAS;IACpC,OAAO,CAAC,IAAI,YAAY,CAAC;AAC3B,CAAC"}

package/dist/visual/channels.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Visual channels (visual-language §3, §5, §6, §9) — the metric→appearance mappings, as pure
+ * functions returning plain value objects plus CSS string builders. Every channel is bounded so a
+ * runaway metric can't blow out contrast, saturation, or glow (the §5.2 accessibility caps). The
+ * caller writes the strings to the DOM; nothing here touches it.
+ */
+import type { ElementMetrics } from '../agents/element-agent.ts';
+export interface TypographyOpts {
+    /** variable-font weight range. */
+    weight?: [number, number];
+    /** optical-size range. */
+    opsz?: [number, number];
+    /** letter-spacing range in em. */
+    tracking?: [number, number];
+}
+export interface TypographyValue {
+    weight: number;
+    opsz: number;
+    tracking: number;
+    /** text-shadow glow radius in px (from attention). */
+    glow: number;
+}
+/** Map density (presence) and attention (emphasis) to live variable-font axes + glow. */
+export declare function typography(m: ElementMetrics, opts?: TypographyOpts): TypographyValue;
+/** The CSS a `TypographyValue` produces (font-variation-settings + text-shadow). */
+export declare function typographyCss(v: TypographyValue, glowColor?: string): Record<string, string>;
+export interface Hsl {
+    h: number;
+    s: number;
+    l: number;
+    a: number;
+}
+export interface ColorCaps {
+    /** max saturation (a11y §5.2). */
+    maxSat: number;
+    /** lightness floor/ceiling to keep contrast. */
+    minL: number;
+    maxL: number;
+}
+export declare const DEFAULT_COLOR_CAPS: ColorCaps;
+/**
+ * Field-driven color (§5.1): density deepens tone, heat warms the hue + lifts it, attention raises
+ * saturation, entropy desaturates and jitters the hue, coherence pulls back toward the base hue,
+ * memory adds a persistent tint. Bounded by the accessibility caps so it never blows out.
+ */
+export declare function fieldColor(base: Hsl, m: ElementMetrics, caps?: ColorCaps): Hsl;
+export declare function hslString(c: Hsl): string;
+export interface ShapeValue {
+    /** scale multiplier. */
+    scale: number;
+    /** corner radius in px. */
+    radius: number;
+    /** stroke width in px. */
+    stroke: number;
+}
+/** Pressure swells scale; coherence sharpens corners; attention thickens the stroke. */
+export declare function shape(m: ElementMetrics): ShapeValue;
+export interface EmissionValue {
+    /** glow radius in px. */
+    radius: number;
+    /** glow alpha. */
+    alpha: number;
+}
+export interface EmissionOpts {
+    maxGlow?: number;
+    /** under reduced motion, emission becomes a flat static highlight, not a pulsing bloom. */
+    reducedMotion?: boolean;
+}
+/** Heat drives emission; capped by maxGlow and flattened under reduced motion. */
+export declare function emission(m: ElementMetrics, opts?: EmissionOpts): EmissionValue;
+//# sourceMappingURL=channels.d.ts.map

package/dist/visual/channels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../../src/visual/channels.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAKjE,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,0BAA0B;IAC1B,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AACD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,yFAAyF;AACzF,wBAAgB,UAAU,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,GAAE,cAAmB,GAAG,eAAe,CAYxF;AAED,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,CAAC,EAAE,eAAe,EAAE,SAAS,SAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMpG;AAGD,MAAM,WAAW,GAAG;IAClB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AACD,MAAM,WAAW,SAAS;IACxB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AACD,eAAO,MAAM,kBAAkB,EAAE,SAAmD,CAAC;AAErF;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,cAAc,EAAE,IAAI,GAAE,SAA8B,GAAG,GAAG,CAsBlG;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,GAAG,MAAM,CAExC;AAGD,MAAM,WAAW,UAAU;IACzB,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AACD,wFAAwF;AACxF,wBAAgB,KAAK,CAAC,CAAC,EAAE,cAAc,GAAG,UAAU,CAMnD;AAGD,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AACD,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2FAA2F;IAC3F,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AACD,kFAAkF;AAClF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,GAAE,YAAiB,GAAG,aAAa,CAKlF"}

package/dist/visual/channels.js

@@ -0,0 +1,70 @@
+import { clamp, lerp } from "../core/math.js";
+import { clamp01, mapRange } from "./mapping.js";
+/** Map density (presence) and attention (emphasis) to live variable-font axes + glow. */
+export function typography(m, opts = {}) {
+    const d = clamp01(m.density ?? 0);
+    const a = clamp01(m.attention ?? 0);
+    const [wLo, wHi] = opts.weight ?? [300, 800];
+    const [oLo, oHi] = opts.opsz ?? [12, 48];
+    const [tLo, tHi] = opts.tracking ?? [0, -0.02];
+    return {
+        weight: Math.round(lerp(wLo, wHi, d)),
+        opsz: Math.round(lerp(oLo, oHi, d)),
+        tracking: lerp(tLo, tHi, d),
+        glow: lerp(0, 12, a),
+    };
+}
+/** The CSS a `TypographyValue` produces (font-variation-settings + text-shadow). */
+export function typographyCss(v, glowColor = 'currentColor') {
+    return {
+        'font-variation-settings': `"wght" ${v.weight}, "opsz" ${v.opsz}`,
+        'letter-spacing': `${v.tracking.toFixed(3)}em`,
+        'text-shadow': v.glow > 0.1 ? `0 0 ${v.glow.toFixed(1)}px ${glowColor}` : 'none',
+    };
+}
+export const DEFAULT_COLOR_CAPS = { maxSat: 0.9, minL: 0.25, maxL: 0.85 };
+/**
+ * Field-driven color (§5.1): density deepens tone, heat warms the hue + lifts it, attention raises
+ * saturation, entropy desaturates and jitters the hue, coherence pulls back toward the base hue,
+ * memory adds a persistent tint. Bounded by the accessibility caps so it never blows out.
+ */
+export function fieldColor(base, m, caps = DEFAULT_COLOR_CAPS) {
+    const heat = clamp01(m.heat ?? 0);
+    const entropy = clamp01(m.entropy ?? 0);
+    const coherence = clamp01(m.coherence ?? 0);
+    const attention = clamp01(m.attention ?? 0);
+    const density = clamp01(m.density ?? 0);
+    const memory = clamp01(m.memory ?? 0);
+    // hue: heat shifts toward warm (~30°); entropy jitters; coherence pulls back to base.
+    const warmTarget = 30;
+    let h = lerp(base.h, warmTarget, heat * 0.5);
+    h += entropy * 24 * (((h % 7) - 3) / 3); // deterministic per-hue jitter, not random
+    h = lerp(h, base.h, coherence * 0.6);
+    h = ((h % 360) + 360) % 360;
+    // saturation: attention raises it, entropy lowers it; capped.
+    const s = clamp(base.s + attention * 0.4 - entropy * 0.5, 0, caps.maxSat);
+    // lightness: density deepens (darkens) the tone, heat lifts it; clamped for contrast.
+    const l = clamp(base.l - density * 0.2 + heat * 0.15, caps.minL, caps.maxL);
+    // alpha: a faint persistent memory tint nudges opacity up.
+    const a = clamp01(base.a + memory * 0.1);
+    return { h, s, l, a };
+}
+export function hslString(c) {
+    return `hsl(${c.h.toFixed(0)} ${(c.s * 100).toFixed(0)}% ${(c.l * 100).toFixed(0)}% / ${c.a.toFixed(2)})`;
+}
+/** Pressure swells scale; coherence sharpens corners; attention thickens the stroke. */
+export function shape(m) {
+    return {
+        scale: mapRange(clamp01(m.pressure ?? 0), 0, 1, 1, 1.25, 'ease-out'),
+        radius: mapRange(clamp01(m.coherence ?? 0), 0, 1, 16, 2),
+        stroke: mapRange(clamp01(m.attention ?? 0), 0, 1, 1, 3),
+    };
+}
+/** Heat drives emission; capped by maxGlow and flattened under reduced motion. */
+export function emission(m, opts = {}) {
+    const heat = clamp01(m.heat ?? 0);
+    const max = opts.maxGlow ?? 24;
+    const radius = mapRange(heat, 0, 1, 0, max, opts.reducedMotion ? 'linear' : 'ease-out');
+    return { radius, alpha: clamp01(heat * (opts.reducedMotion ? 0.5 : 0.8)) };
+}
+//# sourceMappingURL=channels.js.map

package/dist/visual/channels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.js","sourceRoot":"","sources":["../../src/visual/channels.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAmBjD,yFAAyF;AACzF,MAAM,UAAU,UAAU,CAAC,CAAiB,EAAE,OAAuB,EAAE;IACrE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IAClC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC;IACpC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC7C,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACzC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;IAC/C,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QACrC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QACnC,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;QAC3B,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;KACrB,CAAC;AACJ,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,aAAa,CAAC,CAAkB,EAAE,SAAS,GAAG,cAAc;IAC1E,OAAO;QACL,yBAAyB,EAAE,UAAU,CAAC,CAAC,MAAM,YAAY,CAAC,CAAC,IAAI,EAAE;QACjE,gBAAgB,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;QAC9C,aAAa,EAAE,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,SAAS,EAAE,CAAC,CAAC,CAAC,MAAM;KACjF,CAAC;AACJ,CAAC;AAgBD,MAAM,CAAC,MAAM,kBAAkB,GAAc,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAErF;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,IAAS,EAAE,CAAiB,EAAE,OAAkB,kBAAkB;IAC3F,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;IAEtC,sFAAsF;IACtF,MAAM,UAAU,GAAG,EAAE,CAAC;IACtB,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,GAAG,GAAG,CAAC,CAAC;IAC7C,CAAC,IAAI,OAAO,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,2CAA2C;IACpF,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,SAAS,GAAG,GAAG,CAAC,CAAC;IACrC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;IAE5B,8DAA8D;IAC9D,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,GAAG,GAAG,GAAG,OAAO,GAAG,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1E,sFAAsF;IACtF,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,OAAO,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5E,2DAA2D;IAC3D,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,GAAG,GAAG,CAAC,CAAC;IACzC,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,CAAM;IAC9B,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AAC5G,CAAC;AAWD,wFAAwF;AACxF,MAAM,UAAU,KAAK,CAAC,CAAiB;IACrC,OAAO;QACL,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC;QACpE,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACxD,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;KACxD,CAAC;AACJ,CAAC;AAcD,kFAAkF;AAClF,MAAM,UAAU,QAAQ,CAAC,CAAiB,EAAE,OAAqB,EAAE;IACjE,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IACxF,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;AAC7E,CAAC"}

package/dist/visual/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * The visual language layer (Phase 6 — visual-language-and-geometry). Pure, dependency-free
+ * mappings from field metrics to appearance (typography, color, shape, emission), the lint rules
+ * that keep them accessible, the semantic-text fallback, and the Visual Layer declaration every
+ * visual layer must publish (§18). The math returns plain values + CSS strings; the DOM write
+ * stays in the feedback/agent layer.
+ */
+import type { ContractMeta } from '../contracts/types.ts';
+export * from './mapping.ts';
+export * from './channels.ts';
+export * from './lint.ts';
+export * from './semantic-text.ts';
+export * from './visualization.ts';
+export * from './tokens.ts';
+/** A visual layer's self-declaration (visual-language §18). Inspectable + lintable. */
+export interface VisualLayerDeclaration {
+    name: string;
+    /** the field metrics it reads (e.g. ['density', 'attention']). */
+    sourceMetrics: readonly string[];
+    /** the visual properties it writes (e.g. ['font-variation-settings', 'text-shadow']). */
+    targetProperties: readonly string[];
+    /** must be false unless the layer is also declared feedback/force. */
+    mutatesPhysics: boolean;
+    /** does it set data-state on the DOM? */
+    writesDomState: boolean;
+    /** what happens under prefers-reduced-motion. */
+    reducedMotion: string;
+    /** the accessible fallback that preserves meaning. */
+    accessibilityFallback: string;
+    /** rough cost, e.g. 'CSS only' | 'canvas' | 'svg'. */
+    performanceCost: string;
+    /** is it visible in debug/inspector? */
+    debugVisibility: boolean;
+}
+/** The authoring attributes the visual language recognizes (visual-language §19). */
+export declare const VISUAL_AUTHORING_ATTRIBUTES: readonly ["data-visual", "data-field-material", "data-color-mode", "data-shape-mode", "data-pattern-mode", "data-emission", "data-container-role", "data-semantic-layer", "data-reduced-visual"];
+/** The Visual Language Contract (system-contracts §19, visual-language §18). */
+export declare const VISUAL_CONTRACTS: readonly ContractMeta[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/visual/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAE5B,uFAAuF;AACvF,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,yFAAyF;IACzF,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,sEAAsE;IACtE,cAAc,EAAE,OAAO,CAAC;IACxB,yCAAyC;IACzC,cAAc,EAAE,OAAO,CAAC;IACxB,iDAAiD;IACjD,aAAa,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,sDAAsD;IACtD,eAAe,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,qFAAqF;AACrF,eAAO,MAAM,2BAA2B,kMAU9B,CAAC;AAEX,gFAAgF;AAChF,eAAO,MAAM,gBAAgB,EAAE,SAAS,YAAY,EASnD,CAAC"}

package/dist/visual/index.js

@@ -0,0 +1,30 @@
+export * from "./mapping.js";
+export * from "./channels.js";
+export * from "./lint.js";
+export * from "./semantic-text.js";
+export * from "./visualization.js";
+export * from "./tokens.js";
+/** The authoring attributes the visual language recognizes (visual-language §19). */
+export const VISUAL_AUTHORING_ATTRIBUTES = [
+    'data-visual',
+    'data-field-material',
+    'data-color-mode',
+    'data-shape-mode',
+    'data-pattern-mode',
+    'data-emission',
+    'data-container-role',
+    'data-semantic-layer',
+    'data-reduced-visual',
+];
+/** The Visual Language Contract (system-contracts §19, visual-language §18). */
+export const VISUAL_CONTRACTS = [
+    {
+        name: 'Visual Language Contract',
+        mustExist: 'a declared mapping from field metrics to bounded visual properties; a VisualLayerDeclaration per layer',
+        mayMutate: 'appearance (visually) and, if it opts in, data-state — never physics',
+        sideEffectFree: 'the metric→appearance math (pure value + CSS strings); the DOM write is separate',
+        testable: 'mappings are bounded (saturation/glow/contrast caps); reduced-motion keeps meaning; semantic text stays live',
+        inspectable: 'each layer’s declaration (source metrics, targets, mutatesPhysics, reduced-motion, a11y, cost)',
+    },
+];
+//# sourceMappingURL=index.js.map

package/dist/visual/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/visual/index.ts"],"names":[],"mappings":"AASA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAuB5B,qFAAqF;AACrF,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,aAAa;IACb,qBAAqB;IACrB,iBAAiB;IACjB,iBAAiB;IACjB,mBAAmB;IACnB,eAAe;IACf,qBAAqB;IACrB,qBAAqB;IACrB,qBAAqB;CACb,CAAC;AAEX,gFAAgF;AAChF,MAAM,CAAC,MAAM,gBAAgB,GAA4B;IACvD;QACE,IAAI,EAAE,0BAA0B;QAChC,SAAS,EAAE,wGAAwG;QACnH,SAAS,EAAE,sEAAsE;QACjF,cAAc,EAAE,kFAAkF;QAClG,QAAQ,EAAE,8GAA8G;QACxH,WAAW,EAAE,gGAAgG;KAC9G;CACF,CAAC"}

package/dist/visual/lint.d.ts

@@ -0,0 +1,41 @@
+export type LintSeverity = 'info' | 'warning' | 'error' | 'fatal';
+export interface LintFinding {
+    rule: string;
+    severity: LintSeverity;
+    message: string;
+}
+/** What a scene declares, for the linter to reason about. All fields optional. */
+export interface SceneDescriptor {
+    /** force tokens present on the page's bodies. */
+    forces?: readonly string[];
+    /** are any particles charged (so charge/magnetism can act)? */
+    hasChargedParticles?: boolean;
+    /** does any force own a field() for transport/field-lines to read? */
+    hasFieldSource?: boolean;
+    /** are field lines being rendered? */
+    fieldLinesEnabled?: boolean;
+    /** declared sources and whether each is budgeted. */
+    sources?: readonly {
+        token: string;
+        budgeted: boolean;
+    }[];
+    /** particle count in the busiest local cell. */
+    localCellParticles?: number;
+    /** is there a reduced-motion fallback for motion-dependent meaning? */
+    reducedMotionFallback?: boolean;
+    /** the max saturation a color layer uses, and its cap. */
+    saturation?: number;
+    saturationCap?: number;
+    /** the max glow a layer uses, and its cap. */
+    glow?: number;
+    glowCap?: number;
+    /** does any state rely on color alone to convey meaning? */
+    colorOnlyMeaning?: boolean;
+    /** is any expressive glyph missing accessible text? */
+    glyphOnlySemanticText?: boolean;
+    /** per-body token lists, for the duplicate-pull check. */
+    bodyTokens?: readonly (readonly string[])[];
+}
+/** Run all lint rules over a scene; returns every finding (empty = clean). */
+export declare function runVisualLint(scene: SceneDescriptor): LintFinding[];
+//# sourceMappingURL=lint.d.ts.map

package/dist/visual/lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/visual/lint.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAElE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,kFAAkF;AAClF,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,+DAA+D;IAC/D,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,sEAAsE;IACtE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,sCAAsC;IACtC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,qDAAqD;IACrD,OAAO,CAAC,EAAE,SAAS;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IAC1D,gDAAgD;IAChD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,uEAAuE;IACvE,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,uDAAuD;IACvD,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,0DAA0D;IAC1D,UAAU,CAAC,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC;CAC7C;AAOD,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,WAAW,EAAE,CA+CnE"}

package/dist/visual/lint.js

@@ -0,0 +1,58 @@
+/**
+ * Visual + scene lint rules (testing-and-conformance §14, visual-language §5.2). Static checks over
+ * a scene descriptor that catch the common misconfigurations the docs warn about — magnetism with
+ * no charge, fieldflow with no field to follow, an unbudgeted source, a missing reduced-motion
+ * fallback, color carrying meaning alone, saturation/glow over the accessibility caps. Pure: it
+ * reports findings, it does not touch the DOM.
+ */
+import { passportFor } from "../contracts/passport.js";
+/** Forces that pull matter inward — stacking two on one body usually double-counts the pull. */
+const PULL_FORCES = new Set(['attract', 'gravity', 'tether', 'cohesion']);
+const LOCAL_CELL_MAX = 400;
+/** Run all lint rules over a scene; returns every finding (empty = clean). */
+export function runVisualLint(scene) {
+    const out = [];
+    const forces = scene.forces ?? [];
+    const add = (rule, severity, message) => {
+        out.push({ rule, severity, message });
+    };
+    // physics activity
+    for (const token of forces) {
+        const p = passportFor(token);
+        if (!p)
+            continue;
+        if (p.requiresCharge && scene.hasChargedParticles === false)
+            add('inactive-force', 'warning', `${token} requires charge but no charged particles are present — it will appear inactive`);
+        if (p.usesFieldAt && scene.hasFieldSource === false)
+            add('no-field-source', 'warning', `${token} follows a field but no force nearby owns a field() — nothing to follow`);
+    }
+    // field lines need a field() to trace
+    if (scene.fieldLinesEnabled && scene.hasFieldSource === false)
+        add('field-lines-no-source', 'warning', 'field lines are enabled but no force owns a field() to trace');
+    // duplicate pull on one body (e.g. data-body="gravity attract")
+    for (const tokens of scene.bodyTokens ?? []) {
+        const pulls = tokens.filter((t) => PULL_FORCES.has(t));
+        if (pulls.length > 1)
+            add('duplicate-pull', 'info', `body stacks multiple pull forces (${pulls.join(' + ')}) — may double-count the pull`);
+    }
+    // sources must be budgeted
+    for (const s of scene.sources ?? [])
+        if (!s.budgeted)
+            add('unbudgeted-source', 'error', `source "${s.token}" has no budget (cap + lifespan required)`);
+    // performance
+    if ((scene.localCellParticles ?? 0) > LOCAL_CELL_MAX)
+        add('local-cell-overload', 'warning', `local cell particle count ${scene.localCellParticles} exceeds ${LOCAL_CELL_MAX}`);
+    // accessibility
+    if (scene.reducedMotionFallback === false)
+        add('missing-reduced-motion', 'error', 'motion-dependent meaning has no reduced-motion fallback');
+    if (scene.colorOnlyMeaning)
+        add('color-only-meaning', 'error', 'color must not be the only carrier of meaning (add icon/text/outline)');
+    if (scene.glyphOnlySemanticText)
+        add('glyph-only-text', 'error', 'expressive glyphs must not be the only semantic text (add sr-only text)');
+    if (scene.saturation != null && scene.saturationCap != null && scene.saturation > scene.saturationCap)
+        add('saturation-over-cap', 'warning', `saturation ${scene.saturation} exceeds the accessibility cap ${scene.saturationCap}`);
+    if (scene.glow != null && scene.glowCap != null && scene.glow > scene.glowCap)
+        add('glow-over-cap', 'warning', `glow ${scene.glow} exceeds the cap ${scene.glowCap}`);
+    return out;
+}
+//# sourceMappingURL=lint.js.map

package/dist/visual/lint.js.map

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

package/dist/visual/mapping.d.ts

@@ -0,0 +1,13 @@
+export type Curve = 'linear' | 'ease-in' | 'ease-out' | 'ease' | 'exp';
+/** Clamp to the unit interval [0,1]. */
+export declare const clamp01: (v: number) => number;
+/** Apply a response curve to a normalized input t ∈ [0,1]. */
+export declare function curve(t: number, c?: Curve): number;
+/** Map a value from an input range to an output range through a response curve. */
+export declare function mapRange(v: number, inLo: number, inHi: number, outLo: number, outHi: number, c?: Curve): number;
+/**
+ * Distance falloff (visual-language §7.2): a body's normalized influence at distance `d` within
+ * `range`, 1 at the core easing to 0 at the rim. `power` shapes the edge (2 = soft, 1 = linear).
+ */
+export declare function falloff(d: number, range: number, power?: number): number;
+//# sourceMappingURL=mapping.d.ts.map

package/dist/visual/mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../../src/visual/mapping.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,KAAK,CAAC;AAEvE,wCAAwC;AACxC,eAAO,MAAM,OAAO,GAAI,GAAG,MAAM,KAAG,MAAwB,CAAC;AAE7D,8DAA8D;AAC9D,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAE,KAAgB,GAAG,MAAM,CAc5D;AAED,mFAAmF;AACnF,wBAAgB,QAAQ,CACtB,CAAC,EAAE,MAAM,EACT,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,CAAC,GAAE,KAAgB,GAClB,MAAM,CAIR;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,CAGnE"}

package/dist/visual/mapping.js

@@ -0,0 +1,43 @@
+/**
+ * Visual mapping primitives (visual-language §1, §7). The visual language is, at root, a set of
+ * pure functions from a field metric (0..1) to a visual property — a weight, a hue, a scale, a glow
+ * radius. These are the building blocks: clamping, ranged interpolation with a response curve, and
+ * the distance falloff that turns a body's reach into a 0..1 influence. Zero dependencies —
+ * `clamp`/`lerp` are reused from the engine's math module so there is one source of truth.
+ */
+import { clamp, lerp } from "../core/math.js";
+/** Clamp to the unit interval [0,1]. */
+export const clamp01 = (v) => clamp(v, 0, 1);
+/** Apply a response curve to a normalized input t ∈ [0,1]. */
+export function curve(t, c = 'linear') {
+    const x = clamp01(t);
+    switch (c) {
+        case 'ease-in':
+            return x * x;
+        case 'ease-out':
+            return 1 - (1 - x) * (1 - x);
+        case 'ease':
+            return x * x * (3 - 2 * x); // smoothstep
+        case 'exp':
+            return x === 0 ? 0 : Math.pow(2, 10 * (x - 1));
+        default:
+            return x;
+    }
+}
+/** Map a value from an input range to an output range through a response curve. */
+export function mapRange(v, inLo, inHi, outLo, outHi, c = 'linear') {
+    if (inHi === inLo)
+        return outLo;
+    const t = curve((v - inLo) / (inHi - inLo), c);
+    return lerp(outLo, outHi, t);
+}
+/**
+ * Distance falloff (visual-language §7.2): a body's normalized influence at distance `d` within
+ * `range`, 1 at the core easing to 0 at the rim. `power` shapes the edge (2 = soft, 1 = linear).
+ */
+export function falloff(d, range, power = 2) {
+    if (range <= 0 || d >= range)
+        return 0;
+    return Math.pow(1 - d / range, power);
+}
+//# sourceMappingURL=mapping.js.map

package/dist/visual/mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.js","sourceRoot":"","sources":["../../src/visual/mapping.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAI9C,wCAAwC;AACxC,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAE7D,8DAA8D;AAC9D,MAAM,UAAU,KAAK,CAAC,CAAS,EAAE,IAAW,QAAQ;IAClD,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACrB,QAAQ,CAAC,EAAE,CAAC;QACV,KAAK,SAAS;YACZ,OAAO,CAAC,GAAG,CAAC,CAAC;QACf,KAAK,UAAU;YACb,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/B,KAAK,MAAM;YACT,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa;QAC3C,KAAK,KAAK;YACR,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACjD;YACE,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,QAAQ,CACtB,CAAS,EACT,IAAY,EACZ,IAAY,EACZ,KAAa,EACb,KAAa,EACb,IAAW,QAAQ;IAEnB,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAChC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/C,OAAO,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,CAAS,EAAE,KAAa,EAAE,KAAK,GAAG,CAAC;IACzD,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK;QAAE,OAAO,CAAC,CAAC;IACvC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,CAAC;AACxC,CAAC"}

package/dist/visual/semantic-text.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Semantic-text fallback (visual-language §16, migration-plan §11). The visual layer may vectorize,
+ * distort, or shader-render glyphs, but the semantic layer must stay real HTML text — SVG/Canvas
+ * glyphs must never be the only source of meaning. These helpers check that an expressive element
+ * carries accessible text and build the recommended pattern. Operate on a minimal node shape, so
+ * they run without a DOM.
+ */
+/** The minimal node surface these checks need (a real Element satisfies it). */
+export interface TextNodeLike {
+    textContent: string | null;
+    getAttribute(name: string): string | null;
+    querySelector(selector: string): unknown;
+}
+/**
+ * True when the element exposes accessible text: visible text content, an `aria-label`, or an
+ * `.sr-only` child carrying the meaning. An expressive glyph that is `aria-hidden` with none of
+ * these fails — the visual is decorative-only and the meaning is lost.
+ */
+export declare function hasAccessibleText(node: TextNodeLike): boolean;
+/**
+ * Build the recommended semantic-glyph pattern (migration-plan §11): a visually-hidden text span
+ * carrying the meaning, plus an `aria-hidden` SVG carrying the expressive form. Returns an HTML
+ * string the author can drop in.
+ */
+export declare function semanticGlyphMarkup(text: string, svgInner: string, tag?: string): string;
+/** The CSS for an `.sr-only` utility, if the consuming app doesn't already ship one. */
+export declare const SR_ONLY_CSS: string;
+//# sourceMappingURL=semantic-text.d.ts.map

package/dist/visual/semantic-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-text.d.ts","sourceRoot":"","sources":["../../src/visual/semantic-text.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,gFAAgF;AAChF,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC1C,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1C;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAK7D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,CAQxF;AAED,wFAAwF;AACxF,eAAO,MAAM,WAAW,QAE2B,CAAC"}

package/dist/visual/semantic-text.js

@@ -0,0 +1,36 @@
+/**
+ * Semantic-text fallback (visual-language §16, migration-plan §11). The visual layer may vectorize,
+ * distort, or shader-render glyphs, but the semantic layer must stay real HTML text — SVG/Canvas
+ * glyphs must never be the only source of meaning. These helpers check that an expressive element
+ * carries accessible text and build the recommended pattern. Operate on a minimal node shape, so
+ * they run without a DOM.
+ */
+/**
+ * True when the element exposes accessible text: visible text content, an `aria-label`, or an
+ * `.sr-only` child carrying the meaning. An expressive glyph that is `aria-hidden` with none of
+ * these fails — the visual is decorative-only and the meaning is lost.
+ */
+export function hasAccessibleText(node) {
+    const text = (node.textContent ?? '').trim();
+    if (text.length > 0)
+        return true;
+    if ((node.getAttribute('aria-label') ?? '').trim().length > 0)
+        return true;
+    return node.querySelector('.sr-only') != null;
+}
+/**
+ * Build the recommended semantic-glyph pattern (migration-plan §11): a visually-hidden text span
+ * carrying the meaning, plus an `aria-hidden` SVG carrying the expressive form. Returns an HTML
+ * string the author can drop in.
+ */
+export function semanticGlyphMarkup(text, svgInner, tag = 'span') {
+    const safe = text.replace(/[<>&]/g, (c) => ({ '<': '&lt;', '>': '&gt;', '&': '&amp;' })[c]);
+    return (`<${tag} class="field-glyph">` +
+        `<span class="sr-only">${safe}</span>` +
+        `<svg aria-hidden="true" focusable="false">${svgInner}</svg>` +
+        `</${tag}>`);
+}
+/** The CSS for an `.sr-only` utility, if the consuming app doesn't already ship one. */
+export const SR_ONLY_CSS = '.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;' +
+    'clip:rect(0,0,0,0);white-space:nowrap;border:0}';
+//# sourceMappingURL=semantic-text.js.map

package/dist/visual/semantic-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-text.js","sourceRoot":"","sources":["../../src/visual/semantic-text.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAkB;IAClD,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3E,OAAO,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;AAChD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,QAAgB,EAAE,GAAG,GAAG,MAAM;IAC9E,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC;IAC7F,OAAO,CACL,IAAI,GAAG,uBAAuB;QAC9B,yBAAyB,IAAI,SAAS;QACtC,6CAA6C,QAAQ,QAAQ;QAC7D,KAAK,GAAG,GAAG,CACZ,CAAC;AACJ,CAAC;AAED,wFAAwF;AACxF,MAAM,CAAC,MAAM,WAAW,GACtB,wFAAwF;IACxF,iDAAiD,CAAC"}

package/dist/visual/tokens.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Field design tokens, roles, and the output-variable catalog (worldclass §11/§12, interaction
+ * §5/§11/§13). Tuning knobs as `--field-*` custom properties, the `data-field-role` value set, and
+ * the full list of `--field-*` variables the field can write back (including the attention/memory
+ * sub-variables). Pure data + a CSS string builder. (Distinct from `config/tokens.ts`, which is the
+ * force-palette token set.)
+ */
+/** Field tuning tokens (worldclass §11), field-first names. */
+export declare const FIELD_DESIGN_TOKENS: Readonly<Record<string, string>>;
+/** The design tokens as a CSS rule (drop into a stylesheet). */
+export declare function fieldTokensCss(selector?: string): string;
+/** Field roles (worldclass §12) — `data-field-role` values. */
+export declare const FIELD_ROLES: readonly ["source", "sink", "anchor", "boundary", "sensor", "display"];
+export type FieldRole = (typeof FIELD_ROLES)[number];
+/** Whether a string is a known field role. */
+export declare function isFieldRole(s: string): s is FieldRole;
+/**
+ * The full `--field-*` output-variable catalog the field can write back, including the attention
+ * and memory sub-variables (interaction §5/§11/§13) and layout shift. The core loop writes the
+ * primary metrics today; the sub-vars are the agreed names for the agent layer to emit.
+ */
+export declare const FIELD_OUTPUT_VARS: readonly ["--field-density", "--field-attention", "--field-heat", "--field-entropy", "--field-coherence", "--field-memory", "--field-pressure", "--field-pull-x", "--field-pull-y", "--field-attention-share", "--field-attention-rank", "--field-related-attention", "--field-path-use", "--field-user-wake", "--field-layout-shift"];
+//# sourceMappingURL=tokens.d.ts.map

package/dist/visual/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/visual/tokens.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,+DAA+D;AAC/D,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAShE,CAAC;AAEF,gEAAgE;AAChE,wBAAgB,cAAc,CAAC,QAAQ,SAAU,GAAG,MAAM,CAKzD;AAED,+DAA+D;AAC/D,eAAO,MAAM,WAAW,wEAAyE,CAAC;AAClG,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,8CAA8C;AAC9C,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,IAAI,SAAS,CAErD;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,wUAgBpB,CAAC"}