@fundamental-engine/core 0.10.1 → 0.10.2

package/dist/engine/shadow.d.ts

@@ -11,11 +11,27 @@
  *                          and builds bodies. The DOM-event wiring lives in `field.ts`.
  */
 import type { Body } from './types.ts';
-import type { BodyAttrs } from './scanner.ts';
+import { type BodyAttrs } from './scanner.ts';
 /** The registration event names. `composed: true` lets them cross the shadow boundary. */
 export declare const REGISTER_BODY = "field:register-body";
 export declare const UNREGISTER_BODY = "field:unregister-body";
 export declare const UPDATE_BODY = "field:update-body";
+/**
+ * Which field(s) a registered host participates in (shadow-dom.md §18). `'global'` — the default,
+ * and the pre-scope behaviour — means EVERY field that hears the composed registration event adopts
+ * the host. `'nearest'` applies the same nearest-enclosing-field ownership the light-DOM scanner
+ * uses (#980): only the field whose scan root is the host's nearest enclosing `data-field-boundary`
+ * (a contained field's bounds element) adopts it, or the page field when no boundary encloses it.
+ */
+export type FieldScope = 'nearest' | 'global';
+/**
+ * An explicit field target — a portal (shadow-dom.md §17, §19). `'root'` is the page field (the one
+ * scanning the document); a selector string or an `Element` names a contained field by its SCAN ROOT
+ * (the `bounds:` / `containerHost` element). When set it beats `scope`: the host joins exactly the
+ * targeted field regardless of where it sits in the tree, and no field at all if none matches
+ * (§17 rung 4 — inert until such a field exists).
+ */
+export type FieldTarget = 'root' | string | Element;
 /** Payload of a `field:register-body` event (shadow-dom.md §7). */
 export interface RegisterBodyDetail {
     /** the public physical element — usually the custom-element host. */
@@ -27,7 +43,40 @@ export interface RegisterBodyDetail {
     attrs?: Record<string, string>;
     /** element that receives the CSS-variable write-back; defaults to `element`. */
     writeTarget?: HTMLElement;
+    /** participation scope (§18) — omitted / `'global'`: every field that hears the event adopts the
+     *  host (the pre-scope behaviour); `'nearest'`: only the nearest enclosing field does. */
+    scope?: FieldScope;
+    /** explicit field target — a portal (§19). Beats `scope` when set. */
+    field?: FieldTarget;
 }
+/**
+ * The nearest enclosing `[data-field-boundary]` of `el` across shadow boundaries (§17): `closest()`
+ * inside the current tree, then hop from a shadow root to its host and continue, so a host nested
+ * inside another component's shadow tree still resolves to the light-DOM boundary around it. Every
+ * DOM capability is feature-detected — an element without `closest` resolves to `null`, and a root
+ * node without `host` (the document) ends the walk. Pure: no globals.
+ */
+export declare function nearestFieldBoundary(el: Element): Element | null;
+/**
+ * Is `root` the PAGE field's scan root — the document itself (`browserHost`) or its
+ * `documentElement` (the platform runtime's scan root)? Anything else (a contained field's bounds
+ * element, a fragment, a headless stub) is not. Feature-detected on `nodeType`.
+ */
+export declare function isPageRoot(root: ParentNode): boolean;
+/**
+ * Does the field scanning `root` adopt this registration (§17 resolution order)?
+ *  1. an explicit `field` target wins: `'root'` → the page field only; a selector → the field whose
+ *     scan root matches it; an `Element` → the field whose scan root IS it.
+ *  2. `scope: 'nearest'` → nearest-enclosing-field ownership, mirroring the scanner's
+ *     `ownedByScanRoot` (#980) but across shadow boundaries: owned when the host's nearest
+ *     boundary is this root, or when no boundary encloses it and this root is not itself a
+ *     contained field's (marked) bounds element — a host outside every contained field is the
+ *     page's. An element without `closest` is always owned (the scanner's rule — ownership only
+ *     applies where an ancestor chain exists).
+ *  3. otherwise (no `field`, no `scope`, or `'global'`) → adopted, the default.
+ * Pure of the DOM event system; every DOM method is feature-detected.
+ */
+export declare function fieldAdopts(detail: RegisterBodyDetail, root: ParentNode): boolean;
 /**
  * Component-side helper (shadow-dom.md §31.1) so a custom element joins the field without
  * repeating event boilerplate. Construct with the host (and optional extra detail), then
@@ -63,7 +112,14 @@ export declare class ShadowRegistry {
      * the scanner's `bodyFromElement`; `attrs` (if supplied at registration) override the
      * host's own `data-*`, else the host is read directly. A custom `getRect` and `writeTarget`
      * are attached to the resulting body.
+     *
+     * `root` — the asking field's scan root — enables scoped participation (§17–§19): a host
+     * registered with `scope: 'nearest'` or an explicit `field` target is built only when
+     * {@link fieldAdopts} says this root owns it. Omitting `root` (headless / harness hosts), or a
+     * detail with neither key, builds every live host exactly as before — the root is never touched
+     * on that path. A host this field does not adopt stays registered (it may be adopted later, e.g.
+     * once its target field exists) and is still pruned when it disconnects.
      */
-    bodies(build: (el: HTMLElement, attrs?: BodyAttrs) => Body): Body[];
+    bodies(build: (el: HTMLElement, attrs?: BodyAttrs) => Body, root?: ParentNode): Body[];
 }
 //# sourceMappingURL=shadow.d.ts.map

package/dist/engine/shadow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shadow.d.ts","sourceRoot":"","sources":["../../src/engine/shadow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,0FAA0F;AAC1F,eAAO,MAAM,aAAa,wBAAwB,CAAC;AACnD,eAAO,MAAM,eAAe,0BAA0B,CAAC;AACvD,eAAO,MAAM,WAAW,sBAAsB,CAAC;AAE/C,mEAAmE;AACnE,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,OAAO,EAAE,WAAW,CAAC;IACrB,2FAA2F;IAC3F,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC;IACxB;iEAC6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,gFAAgF;IAChF,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED;;;;GAIG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+C;gBAE1D,IAAI,EAAE,WAAW,EAAE,MAAM,GAAE,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,SAAS,CAAM;IAKxF,mEAAmE;IACnE,OAAO,IAAI,IAAI;IAGf,0DAA0D;IAC1D,UAAU,IAAI,IAAI;IAGlB,qEAAqE;IACrE,MAAM,IAAI,IAAI;IAId,OAAO,CAAC,IAAI;CAIb;AAOD;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8C;IAEpE,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAI1C,mBAAmB;IACnB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAItC,kFAAkF;IAClF,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,SAAS,KAAK,IAAI,GAAG,IAAI,EAAE;CAepE"}
+{"version":3,"file":"shadow.d.ts","sourceRoot":"","sources":["../../src/engine/shadow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAgD,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAE5F,0FAA0F;AAC1F,eAAO,MAAM,aAAa,wBAAwB,CAAC;AACnD,eAAO,MAAM,eAAe,0BAA0B,CAAC;AACvD,eAAO,MAAM,WAAW,sBAAsB,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpD,mEAAmE;AACnE,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,OAAO,EAAE,WAAW,CAAC;IACrB,2FAA2F;IAC3F,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC;IACxB;iEAC6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,gFAAgF;IAChF,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B;8FAC0F;IAC1F,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,sEAAsE;IACtE,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAWhE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAQpD;AAQD;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAiBjF;AAED;;;;GAIG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+C;gBAE1D,IAAI,EAAE,WAAW,EAAE,MAAM,GAAE,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,SAAS,CAAM;IAKxF,mEAAmE;IACnE,OAAO,IAAI,IAAI;IAGf,0DAA0D;IAC1D,UAAU,IAAI,IAAI;IAGlB,qEAAqE;IACrE,MAAM,IAAI,IAAI;IAId,OAAO,CAAC,IAAI;CAIb;AAOD;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8C;IAEpE,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAI1C,mBAAmB;IACnB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAItC,kFAAkF;IAClF,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,SAAS,KAAK,IAAI,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,EAAE;CAgBvF"}

package/dist/engine/shadow.js

@@ -1,7 +1,83 @@
+import { FIELD_BOUNDARY_ATTR, FIELD_BOUNDARY_SELECTOR } from "./scanner.js";
 /** The registration event names. `composed: true` lets them cross the shadow boundary. */
 export const REGISTER_BODY = 'field:register-body';
 export const UNREGISTER_BODY = 'field:unregister-body';
 export const UPDATE_BODY = 'field:update-body';
+/**
+ * The nearest enclosing `[data-field-boundary]` of `el` across shadow boundaries (§17): `closest()`
+ * inside the current tree, then hop from a shadow root to its host and continue, so a host nested
+ * inside another component's shadow tree still resolves to the light-DOM boundary around it. Every
+ * DOM capability is feature-detected — an element without `closest` resolves to `null`, and a root
+ * node without `host` (the document) ends the walk. Pure: no globals.
+ */
+export function nearestFieldBoundary(el) {
+    let cur = el;
+    while (cur) {
+        if (typeof cur.closest !== 'function')
+            return null;
+        const boundary = cur.closest(FIELD_BOUNDARY_SELECTOR);
+        if (boundary)
+            return boundary;
+        const rootNode = typeof cur.getRootNode === 'function' ? cur.getRootNode() : null;
+        const host = rootNode ? (rootNode.host ?? null) : null;
+        cur = host && host !== cur ? host : null;
+    }
+    return null;
+}
+/**
+ * Is `root` the PAGE field's scan root — the document itself (`browserHost`) or its
+ * `documentElement` (the platform runtime's scan root)? Anything else (a contained field's bounds
+ * element, a fragment, a headless stub) is not. Feature-detected on `nodeType`.
+ */
+export function isPageRoot(root) {
+    const n = root.nodeType;
+    if (n === 9)
+        return true; // Node.DOCUMENT_NODE
+    if (n === 1) {
+        const doc = root.ownerDocument;
+        return !!doc && doc.documentElement === root;
+    }
+    return false;
+}
+/** Is `root` a contained field's bounds element (carries the engine-set boundary marker)? */
+function isBoundaryRoot(root) {
+    const r = root;
+    return typeof r.hasAttribute === 'function' && r.hasAttribute(FIELD_BOUNDARY_ATTR);
+}
+/**
+ * Does the field scanning `root` adopt this registration (§17 resolution order)?
+ *  1. an explicit `field` target wins: `'root'` → the page field only; a selector → the field whose
+ *     scan root matches it; an `Element` → the field whose scan root IS it.
+ *  2. `scope: 'nearest'` → nearest-enclosing-field ownership, mirroring the scanner's
+ *     `ownedByScanRoot` (#980) but across shadow boundaries: owned when the host's nearest
+ *     boundary is this root, or when no boundary encloses it and this root is not itself a
+ *     contained field's (marked) bounds element — a host outside every contained field is the
+ *     page's. An element without `closest` is always owned (the scanner's rule — ownership only
+ *     applies where an ancestor chain exists).
+ *  3. otherwise (no `field`, no `scope`, or `'global'`) → adopted, the default.
+ * Pure of the DOM event system; every DOM method is feature-detected.
+ */
+export function fieldAdopts(detail, root) {
+    const { field, scope, element } = detail;
+    if (field !== undefined && field !== null && field !== '') {
+        if (field === 'root')
+            return isPageRoot(root);
+        if (typeof field === 'string') {
+            const r = root;
+            return typeof r.matches === 'function' && r.matches(field);
+        }
+        return field === root;
+    }
+    if (scope === 'nearest') {
+        if (typeof element.closest !== 'function')
+            return true;
+        const boundary = nearestFieldBoundary(element);
+        if (boundary === null)
+            return !isBoundaryRoot(root);
+        return boundary === root;
+    }
+    return true;
+}
 /**
  * Component-side helper (shadow-dom.md §31.1) so a custom element joins the field without
  * repeating event boilerplate. Construct with the host (and optional extra detail), then
@@ -55,14 +131,23 @@ export class ShadowRegistry {
      * the scanner's `bodyFromElement`; `attrs` (if supplied at registration) override the
      * host's own `data-*`, else the host is read directly. A custom `getRect` and `writeTarget`
      * are attached to the resulting body.
+     *
+     * `root` — the asking field's scan root — enables scoped participation (§17–§19): a host
+     * registered with `scope: 'nearest'` or an explicit `field` target is built only when
+     * {@link fieldAdopts} says this root owns it. Omitting `root` (headless / harness hosts), or a
+     * detail with neither key, builds every live host exactly as before — the root is never touched
+     * on that path. A host this field does not adopt stays registered (it may be adopted later, e.g.
+     * once its target field exists) and is still pruned when it disconnects.
      */
-    bodies(build) {
+    bodies(build, root) {
         const out = [];
         for (const [el, detail] of this.hosts) {
             if (!el.isConnected) {
                 this.hosts.delete(el);
                 continue;
             }
+            if (root !== undefined && !fieldAdopts(detail, root))
+                continue;
             const attrs = detail.attrs ? attrsView(detail.attrs, el) : undefined;
             const body = build(el, attrs);
             if (detail.getRect)

package/dist/engine/shadow.js.map

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

package/dist/engine/snapshot-policy.d.ts

@@ -0,0 +1,28 @@
+import type { FieldPolicy, FieldSnapshotOptions } from './types.ts';
+/** Deep-copy a {@link FieldPolicy} (shallow is unsafe — `budgets` is nested). `undefined` → `{}` (the
+ *  unbounded default). Used on set + read so callers can neither mutate the field's live policy nor
+ *  observe later mutations of the object they passed in. */
+export declare function clonePolicy(p: FieldPolicy | undefined): FieldPolicy;
+/** Concrete inclusion flags a snapshot resolves to. */
+export interface ResolvedSnapshotInclusion {
+    includeParticles: boolean;
+    includeRelationships: boolean;
+    includeData: boolean;
+    includeInfluences: boolean;
+}
+/**
+ * Resolve {@link FieldSnapshotOptions} — an optional {@link SnapshotProfile} composed with the explicit
+ * `include*` flags — to concrete inclusion, TIGHTEST-wins. A profile establishes a baseline; an explicit
+ * flag may tighten it further but never widen it (an explicit `true` cannot re-enable what the profile
+ * turned off). `includeData` additionally passes through the policy gate at the call site (this only
+ * governs whether the CALLER asked for it). Relationships default true when nothing narrows them.
+ */
+export declare function resolveSnapshotInclusion(opts: FieldSnapshotOptions): ResolvedSnapshotInclusion;
+/**
+ * Strip a set of dotted `redactions` paths from a plain reading (query result or snapshot). A top-level
+ * key (`'metrics'`, `'relationships'`) deletes that key from the object. A `<prefix>.<key>` path where
+ * prefix ∈ {body, relationship, influence, projection} strips `<key>` from each entry of the matching
+ * list; `body.data` strips per-body `data`. Mutates the passed object (it's always a fresh result/copy).
+ */
+export declare function applyRedactions<T extends Record<string, unknown>>(reading: T, redactions: readonly string[]): T;
+//# sourceMappingURL=snapshot-policy.d.ts.map

package/dist/engine/snapshot-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-policy.d.ts","sourceRoot":"","sources":["../../src/engine/snapshot-policy.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAmB,MAAM,YAAY,CAAC;AAErF;;4DAE4D;AAC5D,wBAAgB,WAAW,CAAC,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,WAAW,CAQnE;AAED,uDAAuD;AACvD,MAAM,WAAW,yBAAyB;IACxC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,WAAW,EAAE,OAAO,CAAC;IACrB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,oBAAoB,GAAG,yBAAyB,CA4B9F;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,CAAC,CAwB/G"}

package/dist/engine/snapshot-policy.js

@@ -0,0 +1,95 @@
+// Snapshot / query disclosure policy — the three pure helpers that decide what a READER of the field
+// is allowed to see. Extracted verbatim from `engine/field.ts` (#994, behavior-preserving): they are
+// module-level and closure-free, so they were never part of `createField`'s state and read better as
+// their own seam. Pure and type-only-dependent — no runtime import, nothing field-specific.
+//
+// INTERNAL. Not exported from the package surface; `createField` is still the one public entry.
+/** Deep-copy a {@link FieldPolicy} (shallow is unsafe — `budgets` is nested). `undefined` → `{}` (the
+ *  unbounded default). Used on set + read so callers can neither mutate the field's live policy nor
+ *  observe later mutations of the object they passed in. */
+export function clonePolicy(p) {
+    if (!p)
+        return {};
+    const out = {};
+    if (p.allowBodyDataInSnapshots != null)
+        out.allowBodyDataInSnapshots = p.allowBodyDataInSnapshots;
+    if (p.allowMotionProjection != null)
+        out.allowMotionProjection = p.allowMotionProjection;
+    if (p.maxMotionBudget != null)
+        out.maxMotionBudget = p.maxMotionBudget;
+    if (p.budgets)
+        out.budgets = { ...p.budgets };
+    return out;
+}
+/**
+ * Resolve {@link FieldSnapshotOptions} — an optional {@link SnapshotProfile} composed with the explicit
+ * `include*` flags — to concrete inclusion, TIGHTEST-wins. A profile establishes a baseline; an explicit
+ * flag may tighten it further but never widen it (an explicit `true` cannot re-enable what the profile
+ * turned off). `includeData` additionally passes through the policy gate at the call site (this only
+ * governs whether the CALLER asked for it). Relationships default true when nothing narrows them.
+ */
+export function resolveSnapshotInclusion(opts) {
+    // Per-profile baselines. `debug` = everything; `agent` = structure + attribution, no opaque data;
+    // `bug-report` = structural + versions, no data; `public` = ids + shape only.
+    const base = {
+        debug: { includeParticles: true, includeRelationships: true, includeData: true, includeInfluences: true },
+        agent: { includeParticles: false, includeRelationships: true, includeData: false, includeInfluences: true },
+        'bug-report': { includeParticles: false, includeRelationships: true, includeData: false, includeInfluences: true },
+        public: { includeParticles: false, includeRelationships: false, includeData: false, includeInfluences: false },
+    };
+    const p = opts.profile;
+    if (!p) {
+        // No profile: today's defaults — relationships default true, the rest default false.
+        return {
+            includeParticles: opts.includeParticles === true,
+            includeRelationships: opts.includeRelationships !== false,
+            includeData: opts.includeData === true,
+            includeInfluences: opts.includeInfluences === true,
+        };
+    }
+    const b = base[p];
+    // TIGHTEST wins: a flag is on only if the profile allows it AND the caller didn't explicitly turn it
+    // off. An explicit `true` can never widen past the profile's baseline.
+    return {
+        includeParticles: b.includeParticles && opts.includeParticles !== false,
+        includeRelationships: b.includeRelationships && opts.includeRelationships !== false,
+        includeData: b.includeData && opts.includeData !== false,
+        includeInfluences: b.includeInfluences && opts.includeInfluences !== false,
+    };
+}
+/**
+ * Strip a set of dotted `redactions` paths from a plain reading (query result or snapshot). A top-level
+ * key (`'metrics'`, `'relationships'`) deletes that key from the object. A `<prefix>.<key>` path where
+ * prefix ∈ {body, relationship, influence, projection} strips `<key>` from each entry of the matching
+ * list; `body.data` strips per-body `data`. Mutates the passed object (it's always a fresh result/copy).
+ */
+export function applyRedactions(reading, redactions) {
+    const listKeyFor = { body: 'bodies', relationship: 'relationships', influence: 'influences', projection: 'projections' };
+    for (const path of redactions) {
+        const dot = path.indexOf('.');
+        if (dot < 0) {
+            delete reading[path];
+            continue;
+        }
+        const prefix = path.slice(0, dot);
+        const key = path.slice(dot + 1);
+        const listKey = listKeyFor[prefix];
+        if (listKey && Array.isArray(reading[listKey])) {
+            for (const entry of reading[listKey]) {
+                if (entry && typeof entry === 'object')
+                    delete entry[key];
+            }
+        }
+        else if (prefix === 'metrics' && reading['metrics'] && typeof reading['metrics'] === 'object') {
+            delete reading['metrics'][key];
+        }
+        else {
+            // an unrecognized prefix addresses a nested top-level object key.
+            const target = reading[prefix];
+            if (target && typeof target === 'object')
+                delete target[key];
+        }
+    }
+    return reading;
+}
+//# sourceMappingURL=snapshot-policy.js.map

package/dist/engine/snapshot-policy.js.map

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

package/dist/engine/streamlines.d.ts

@@ -1,18 +1,35 @@
 /**
  * Streamlines / vector-field render (§20.6, diagnostic) — instead of the matter, draw
- * the *forces themselves*. At a grid of probe points we measure the net push a
- * still test particle would feel and draw a short arrow along it, so the invisible
- * field a layout creates becomes visible. Invaluable in the Lab: place forces, then
- * see the field they make.
+ * the *forces themselves*. At a grid of probe points we measure the net push a still test particle
+ * would feel and draw a short arrow along it, so the invisible field a layout creates becomes
+ * visible. Invaluable in the Lab: place forces, then see the field they make.
  *
- * `forceAt` is pure and mirrors the integrator's body-force loop (same range cull),
- * minus the per-particle modifier pass — a faithful-enough probe for a diagnostic.
+ * `forceAt` mirrors the integrator's body-force loop (same range cull), minus the per-particle
+ * modifier pass — a faithful-enough probe for a diagnostic.
+ *
+ * PURITY (#1155). A probe is an instrument, not matter: it may READ the field and must never write
+ * to it. That contract used to be incidental rather than structural — the loop ran each body's real
+ * `apply()` against the CALLER'S LIVE ENV, so `sink` advanced a real body's accretion budget and
+ * could fire the live `supernova` from a drawing, `diffuse`/`memory` wore the real scalar grids, a
+ * source could spawn, and every sample advanced the simulation's seeded rng. Now every sample runs
+ * under this module's own `probeEnv`, whose writing services are inert.
+ *
+ * The two halves are inseparable. `sink`'s guard is `if (p.cap || …) return`, so while the shared
+ * probe carried `cap` between samples the leak was self-limiting BY ACCIDENT: a body was
+ * over-accreted exactly once, and every later `sink`/`warp` sample silently short-circuited (the
+ * drawn field going quietly wrong downstream of the first sink). Clearing `cap` per sample WITHOUT
+ * an inert path first would convert that one-off into one accretion per probe point per frame —
+ * hundreds a second, racing a real body to capacity. The path is inert first; `cap` is cleared
+ * because it is.
  */
 import type { Body, Env, ForceRegistry } from './types.ts';
 /** Net force a zero-velocity test particle would feel at (x, y) — the field vector.
  *  A force that defines a `field()` (its visual/structure field) contributes that instead
  *  of its `apply`, so velocity- and charge-dependent forces (magnetism, charge) appear here
- *  even though they no-op on a still, neutral probe. */
+ *  even though they no-op on a still, neutral probe.
+ *
+ *  READ-ONLY: `env` supplies the per-frame reading only — the forces run against `probeEnv`, so this
+ *  never writes to the simulation (#1155). */
 export declare function forceAt(bodies: readonly Body[], forces: ForceRegistry, env: Env, x: number, y: number): {
     fx: number;
     fy: number;

package/dist/engine/streamlines.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"streamlines.d.ts","sourceRoot":"","sources":["../../src/engine/streamlines.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,aAAa,EAAY,MAAM,YAAY,CAAC;AAIrE;;;wDAGwD;AACxD,wBAAgB,OAAO,CACrB,MAAM,EAAE,SAAS,IAAI,EAAE,EACvB,MAAM,EAAE,aAAa,EACrB,GAAG,EAAE,GAAG,EACR,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CA8C5B;AAED;;;;iFAIiF;AACjF,wBAAgB,QAAQ,CACtB,MAAM,EAAE,SAAS,IAAI,EAAE,EACvB,MAAM,EAAE,aAAa,EACrB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAoB1B"}
+{"version":3,"file":"streamlines.d.ts","sourceRoot":"","sources":["../../src/engine/streamlines.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,GAAG,EAAa,aAAa,EAAwB,MAAM,YAAY,CAAC;AAgG5F;;;;;;8CAM8C;AAC9C,wBAAgB,OAAO,CACrB,MAAM,EAAE,SAAS,IAAI,EAAE,EACvB,MAAM,EAAE,aAAa,EACrB,GAAG,EAAE,GAAG,EACR,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAgD5B;AAED;;;;iFAIiF;AACjF,wBAAgB,QAAQ,CACtB,MAAM,EAAE,SAAS,IAAI,EAAE,EACvB,MAAM,EAAE,aAAa,EACrB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAoB1B"}

package/dist/engine/streamlines.js

@@ -1,14 +1,105 @@
 const probe = { x: 0, y: 0, vx: 0, vy: 0, m: 1, heat: 0, size: 1, cap: null };
+/** The probe's OWN noise, never the simulation's (mulberry32 — the engine's stream shape). Reseeded
+ *  at the top of every sample, so a stochastic force (`jet`'s nozzle cone, `thermal`'s kick) reads the
+ *  same at the same point however many samples came before it, and a seeded run a host is recording
+ *  is never advanced by drawing a diagnostic. */
+const PROBE_SEED = 0x9e3779b9;
+let noise = PROBE_SEED;
+function probeRng() {
+    noise = (noise + 0x6d2b79f5) | 0;
+    let t = Math.imul(noise ^ (noise >>> 15), 1 | noise);
+    t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
+    return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+}
+/** The live env this sample mirrors — the source behind the read-through services below. */
+let live = null;
+/** A read-through, write-DROPPING view of a live scalar grid: `diffuse`/`memory` still read the real
+ *  field (an honest diagnostic reading), but their deposits never wear it. Cached per grid name, so a
+ *  whole frame's grid walk allocates nothing. */
+const gridViews = new Map();
+function probeGrid(name) {
+    let v = gridViews.get(name);
+    if (!v) {
+        v = {
+            sample: (x, y) => live?.grid(name).sample(x, y) ?? 0,
+            gradient: (x, y) => live?.grid(name).gradient(x, y) ?? { x: 0, y: 0 },
+            deposit: () => { },
+            decay: () => { },
+            clear: () => { },
+        };
+        gridViews.set(name, v);
+    }
+    return v;
+}
+/** Copied, never aliased, so no force can write through it back into the live env. */
+const probeForm = { driftX: 0, wander: 0, orbit: 0, spread: 0, conv: 0 };
+/**
+ * The one env every probe sample runs under. Its per-frame SCALARS mirror the caller's live env (so
+ * the reading is of the field as it is right now); every service that WRITES is inert —
+ * `spark`/`supernova`/`spawn` are no-ops, grids drop deposits, `rng` is the probe's own stream. The
+ * `probe` marker tells a force that writes engine state outside the probe particle (today only
+ * `sink`'s accretion) that this pass is a reading, not a capture.
+ */
+const probeEnv = {
+    dx: 0,
+    dy: 0,
+    dz: 0,
+    dist: 1,
+    form: probeForm,
+    W: 0,
+    H: 0,
+    t: 0,
+    frameN: 0,
+    dt: 1,
+    c: 12,
+    G: 1,
+    probe: true,
+    rng: probeRng,
+    spark: () => { },
+    supernova: () => { },
+    spawn: () => { },
+    neighbors: (p, r) => live?.neighbors(p, r) ?? [],
+    grid: probeGrid,
+};
+/** Point the probe env at this sample's live env: mirror the read-only per-frame state and reseed the
+ *  probe's noise. The writing services are never re-pointed. */
+function syncProbeEnv(env) {
+    live = env;
+    probeEnv.W = env.W;
+    probeEnv.H = env.H;
+    probeEnv.D = env.D;
+    probeEnv.t = env.t;
+    probeEnv.frameN = env.frameN;
+    probeEnv.dt = env.dt;
+    probeEnv.c = env.c;
+    probeEnv.G = env.G;
+    probeEnv.scrollV = env.scrollV;
+    probeEnv.integrator = env.integrator;
+    probeEnv.fieldAt = env.fieldAt; // a pure read (netField over the live bodies)
+    probeEnv.accum = undefined; // attribution belongs to the integrator's pass, not to a drawing
+    probeEnv.kinTouch = undefined;
+    // the probe sits on the body plane, so the z leg of every force vanishes — and is never the stale
+    // value the integrator happened to leave on the live env.
+    probeEnv.dz = 0;
+    Object.assign(probeForm, env.form);
+    noise = PROBE_SEED;
+    return probeEnv;
+}
 /** Net force a zero-velocity test particle would feel at (x, y) — the field vector.
  *  A force that defines a `field()` (its visual/structure field) contributes that instead
  *  of its `apply`, so velocity- and charge-dependent forces (magnetism, charge) appear here
- *  even though they no-op on a still, neutral probe. */
+ *  even though they no-op on a still, neutral probe.
+ *
+ *  READ-ONLY: `env` supplies the per-frame reading only — the forces run against `probeEnv`, so this
+ *  never writes to the simulation (#1155). */
 export function forceAt(bodies, forces, env, x, y) {
     probe.x = x;
     probe.y = y;
     probe.vx = 0;
     probe.vy = 0;
     probe.heat = 0;
+    probe.cap = null; // a fresh instrument every sample — safe ONLY because the path is inert (header)
+    const pe = syncProbeEnv(env);
     let fxField = 0; // field() contributions, accumulated apart from the apply probe
     let fyField = 0;
     for (const b of bodies) {
@@ -36,9 +127,9 @@ export function forceAt(bodies, forces, env, x, y) {
         if (b.range > 0 && d2 >= b.range * b.range * 2.56)
             continue; // same cull as the integrator
         const d = Math.sqrt(d2);
-        env.dx = dx;
-        env.dy = dy;
-        env.dist = d < 1 ? 1 : d;
+        pe.dx = dx;
+        pe.dy = dy;
+        pe.dist = d < 1 ? 1 : d;
         for (const tok of b.tokens) {
             const f = forces[tok];
             if (!f || f.modify)
@@ -49,7 +140,7 @@ export function forceAt(bodies, forces, env, x, y) {
                 fyField += v.y;
             }
             else {
-                f.apply(b, probe, env);
+                f.apply(b, probe, pe);
             }
         }
     }

package/dist/engine/streamlines.js.map

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