@pascal-app/core 1.0.3 → 1.0.5

package/dist/registry/registry.js

@@ -57,6 +57,17 @@ function isDevMode() {
     // No environment signal — be safe and treat as production.
     return false;
 }
+function assertValidDefinition(def) {
+    if (typeof def.kind !== 'string' || def.kind.length === 0) {
+        throw new Error('[registry] NodeDefinition.kind must be a non-empty string');
+    }
+    if (typeof def.schemaVersion !== 'number' || def.schemaVersion < 1) {
+        throw new Error(`[registry] NodeDefinition.schemaVersion must be a positive integer (kind: "${def.kind}")`);
+    }
+}
+function duplicateKindError(kind) {
+    return new Error(`[registry] duplicate node kind: "${kind}" already registered`);
+}
 class NodeRegistryImpl {
     defs = new Map();
     has(kind) {
@@ -76,12 +87,7 @@ class NodeRegistryImpl {
     }
     // Internal — exposed via registerNode below.
     _register(def) {
-        if (typeof def.kind !== 'string' || def.kind.length === 0) {
-            throw new Error('[registry] NodeDefinition.kind must be a non-empty string');
-        }
-        if (typeof def.schemaVersion !== 'number' || def.schemaVersion < 1) {
-            throw new Error(`[registry] NodeDefinition.schemaVersion must be a positive integer (kind: "${def.kind}")`);
-        }
+        assertValidDefinition(def);
         // Duplicate-kind handling depends on environment:
         //   - **Production**: throw. The plugin-authoring contract
         //     (`wiki/architecture/plugin-authoring.md`) guarantees that two
@@ -95,12 +101,22 @@ class NodeRegistryImpl {
                 console.warn(`[registry] re-registering node kind "${def.kind}" (HMR)`);
             }
             else {
-                throw new Error(`[registry] duplicate node kind: "${def.kind}" already registered`);
+                throw duplicateKindError(def.kind);
             }
         }
         this.defs.set(def.kind, def);
         notifyRegistryChanged();
     }
+    // Internal to `loadPlugin`: stores already-validated definitions without
+    // notifying, so a plugin commits all of its state before listeners run.
+    _commit(defs) {
+        for (const def of defs) {
+            if (this.defs.has(def.kind)) {
+                console.warn(`[registry] re-registering node kind "${def.kind}" (HMR)`);
+            }
+            this.defs.set(def.kind, def);
+        }
+    }
     // Test-only — clears the registry. Not exported from the package barrel.
     _reset() {
         this.defs.clear();
@@ -134,7 +150,8 @@ class NodeRegistryImpl {
         };
     }
 }
-export const nodeRegistry = new NodeRegistryImpl();
+const registryImpl = new NodeRegistryImpl();
+export const nodeRegistry = registryImpl;
 export function registerNode(def) {
     nodeRegistry._register(def);
 }
@@ -177,7 +194,7 @@ export function isNodeKindEnabled(kind, installedPlugins) {
 export function getSelectableKinds() {
     const result = [];
     for (const [kind, def] of nodeRegistry.entries()) {
-        if (def.capabilities.selectable !== undefined) {
+        if (def.capabilities.selectable) {
             result.push(kind);
         }
     }
@@ -188,7 +205,12 @@ export function getSelectableKinds() {
  * in expression chains like `if (node.type === 'wall' || isRegistrySelectable(node.type))`.
  */
 export function isRegistrySelectable(kind) {
-    return nodeRegistry.get(kind)?.capabilities.selectable !== undefined;
+    return Boolean(nodeRegistry.get(kind)?.capabilities.selectable);
+}
+/** Whether `node` takes part in floor-placement collision (`FloorPlacedConfig.collides`). */
+export function floorPlacedCollides(floorPlaced, node) {
+    const collides = floorPlaced?.collides;
+    return typeof collides === 'function' ? collides(node) : collides === true;
 }
 /**
  * Whether the editor should apply its material-based selection highlight to a
@@ -217,8 +239,8 @@ export function kindsWithFloorplanScope(scope) {
 /**
  * A kind's {@link BakePolicy} from the registry, defaulting to `'static'` for
  * kinds that don't declare one (or aren't registered). The bake and the baked
- * `/viewer` consult this instead of hardcoding kind names — see
- * plans/editor-plugin-trees-example.md → Part D.
+ * `/viewer` consult this instead of hardcoding kind names — see "Bake policy" in
+ * wiki/architecture/node-definitions.md.
  */
 export function bakePolicyOf(kind) {
     return nodeRegistry.get(kind)?.bake ?? 'static';
@@ -321,17 +343,34 @@ export async function loadPlugin(plugin) {
     if (plugin.apiVersion !== HOST_API_VERSION) {
         throw new Error(`[registry] plugin "${plugin.id}" requires apiVersion ${plugin.apiVersion}; host supports ${HOST_API_VERSION}`);
     }
-    for (const def of plugin.nodes ?? []) {
-        registerNode(def);
-        pluginIdsByKind.set(def.kind, plugin.id);
+    // Validate every definition and extension first, then commit all state,
+    // then notify once: a rejected plugin leaves nothing behind, and a listener
+    // (which may throw) only ever sees the whole plugin.
+    const nodes = plugin.nodes ?? [];
+    const kinds = new Set();
+    for (const def of nodes) {
+        assertValidDefinition(def);
+        if (!isDevMode() && (kinds.has(def.kind) || nodeRegistry.has(def.kind))) {
+            throw duplicateKindError(def.kind);
+        }
+        kinds.add(def.kind);
     }
-    let extensionsChanged = false;
-    for (const extension of plugin.inspectorExtensions ?? []) {
+    const extensions = plugin.inspectorExtensions ?? [];
+    for (const extension of extensions) {
+        if (typeof extension?.id !== 'string' ||
+            !Array.isArray(extension.kinds) ||
+            !extension.kinds.every((kind) => typeof kind === 'string' && kind.length > 0)) {
+            throw new Error(`[registry] plugin "${plugin.id}" has an invalid inspector extension "${String(extension?.id)}": kinds must be an array of node kinds`);
+        }
+    }
+    registryImpl._commit(nodes);
+    for (const def of nodes)
+        pluginIdsByKind.set(def.kind, plugin.id);
+    for (const extension of extensions) {
         for (const kind of extension.kinds) {
             const list = inspectorExtensionsByKind.get(kind);
             if (!list) {
                 inspectorExtensionsByKind.set(kind, [extension]);
-                extensionsChanged = true;
                 continue;
             }
             // Same-id re-registration replaces in place (dev HMR re-runs
@@ -341,13 +380,11 @@ export async function loadPlugin(plugin) {
                 list[existing] = extension;
             else
                 list.push(extension);
-            extensionsChanged = true;
         }
     }
-    // Nodes already notified per `registerNode`; bump once more so a plugin
-    // that only contributes inspector extensions still re-renders consumers.
-    if (extensionsChanged)
+    if (nodes.length > 0 || extensions.some((extension) => extension.kinds.length > 0)) {
         notifyRegistryChanged();
+    }
 }
 const defaultPluginDiscovery = async () => [];
 let pluginDiscovery = defaultPluginDiscovery;

package/dist/registry/scene-api.d.ts

@@ -9,6 +9,7 @@ import type { SceneApi } from './types.js';
 export type SceneStoreLike = {
     getState: () => {
         nodes: Record<AnyNodeId, AnyNode>;
+        installedPlugins?: string[];
         rootNodeIds: AnyNodeId[];
         dirtyNodes: Set<AnyNodeId>;
         createNode: (node: AnyNode, parentId?: AnyNodeId) => void;
@@ -43,6 +44,26 @@ export type SceneStoreLike = {
         };
     };
 };
+/**
+ * The kernel host seam (frozen by A-02; `ai-surface-agnostic-scene-tools.md`
+ * Phase 0.2). The object every surface — chat, public and hosted MCP, REST,
+ * CLI, bench — hands the one tool kernel. It wraps this module's store seam
+ * instead of adding a second one; the program library's `Host` and MCP's
+ * `SceneOperations` become implementations. Optional capabilities (catalog,
+ * sampling, persistence receipts) join additively, and a missing one is a
+ * typed refusal, never an implicit cloud fallback. Nothing implements it yet.
+ */
+export type SceneToolHost = {
+    store: SceneStoreLike;
+    getActiveLevelId: () => AnyNodeId | null;
+    /** A host without a selection answers an empty list. */
+    getSelection?: () => readonly AnyNodeId[];
+    /**
+     * Runs `fn` as one logical transaction: validated against the proposed
+     * final graph, committed once and undone as one step (R2, R8).
+     */
+    transact?: <T>(label: string, fn: (scene: SceneApi) => T) => T;
+};
 /**
  * Creates a {@link SceneApi} backed by a store.
  *

package/dist/registry/scene-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scene-api.d.ts","sourceRoot":"","sources":["../../src/registry/scene-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAWzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEvC;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,MAAM;QACd,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;QACjC,WAAW,EAAE,SAAS,EAAE,CAAA;QACxB,UAAU,EAAE,GAAG,CAAC,SAAS,CAAC,CAAA;QAC1B,UAAU,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,SAAS,KAAK,IAAI,CAAA;QACzD,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE;YAAE,IAAI,EAAE,OAAO,CAAC;YAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;SAAE,EAAE,KAAK,IAAI,CAAA;QACtE,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE;YAC3B,MAAM,CAAC,EAAE;gBAAE,IAAI,EAAE,OAAO,CAAC;gBAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;aAAE,EAAE,CAAA;YAClD,MAAM,CAAC,EAAE;gBAAE,EAAE,EAAE,SAAS,CAAC;gBAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;aAAE,EAAE,CAAA;YACpD,MAAM,CAAC,EAAE,SAAS,EAAE,CAAA;SACrB,KAAK,IAAI,CAAA;QACV,UAAU,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,CAAA;QAC3D,UAAU,EAAE,CAAC,EAAE,EAAE,SAAS,KAAK,IAAI,CAAA;QACnC,SAAS,EAAE,CAAC,EAAE,EAAE,SAAS,KAAK,IAAI,CAAA;KACnC,CAAA;IACD,SAAS,CAAC,EAAE,CACV,QAAQ,EAAE,CACR,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;KAAE,EAC5C,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;KAAE,KAC5C,IAAI,KACN,MAAM,IAAI,CAAA;IACf,QAAQ,EAAE;QACR,QAAQ,EAAE,MAAM;YAAE,KAAK,EAAE,MAAM,IAAI,CAAC;YAAC,MAAM,EAAE,MAAM,IAAI,CAAA;SAAE,CAAA;KAC1D,CAAA;CACF,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,QAAQ,CAwI9D"}
+{"version":3,"file":"scene-api.d.ts","sourceRoot":"","sources":["../../src/registry/scene-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAazD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEvC;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,MAAM;QACd,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;QACjC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;QAC3B,WAAW,EAAE,SAAS,EAAE,CAAA;QACxB,UAAU,EAAE,GAAG,CAAC,SAAS,CAAC,CAAA;QAC1B,UAAU,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,SAAS,KAAK,IAAI,CAAA;QACzD,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE;YAAE,IAAI,EAAE,OAAO,CAAC;YAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;SAAE,EAAE,KAAK,IAAI,CAAA;QACtE,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE;YAC3B,MAAM,CAAC,EAAE;gBAAE,IAAI,EAAE,OAAO,CAAC;gBAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;aAAE,EAAE,CAAA;YAClD,MAAM,CAAC,EAAE;gBAAE,EAAE,EAAE,SAAS,CAAC;gBAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;aAAE,EAAE,CAAA;YACpD,MAAM,CAAC,EAAE,SAAS,EAAE,CAAA;SACrB,KAAK,IAAI,CAAA;QACV,UAAU,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,CAAA;QAC3D,UAAU,EAAE,CAAC,EAAE,EAAE,SAAS,KAAK,IAAI,CAAA;QACnC,SAAS,EAAE,CAAC,EAAE,EAAE,SAAS,KAAK,IAAI,CAAA;KACnC,CAAA;IACD,SAAS,CAAC,EAAE,CACV,QAAQ,EAAE,CACR,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;KAAE,EAC5C,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;KAAE,KAC5C,IAAI,KACN,MAAM,IAAI,CAAA;IACf,QAAQ,EAAE;QACR,QAAQ,EAAE,MAAM;YAAE,KAAK,EAAE,MAAM,IAAI,CAAC;YAAC,MAAM,EAAE,MAAM,IAAI,CAAA;SAAE,CAAA;KAC1D,CAAA;CACF,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,cAAc,CAAA;IACrB,gBAAgB,EAAE,MAAM,SAAS,GAAG,IAAI,CAAA;IACxC,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,SAAS,SAAS,EAAE,CAAA;IACzC;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,CAAC,KAAK,CAAC,CAAA;CAC/D,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,QAAQ,CAsJ9D"}

package/dist/registry/scene-api.js

@@ -1,3 +1,4 @@
+import { filterDerivedNodeWrites } from '../store/derived-node-guard.js';
 import { activeSceneCommitNodeIds, pauseSceneHistory, resumeSceneHistory, } from '../store/history-control.js';
 import { collectSubtree, cloneNodesInto as runCloneNodesInto, } from './subtree.js';
 /**
@@ -28,16 +29,36 @@ export function createSceneApi(store) {
         nodes() {
             return store.getState().nodes;
         },
+        installedPlugins() {
+            return store.getState().installedPlugins;
+        },
         update(id, patch) {
+            const [update] = filterDerivedNodeWrites(store.getState().nodes, {
+                update: [{ id, data: patch }],
+            }).update;
+            if (!update)
+                return;
             captureIfNeeded(id);
-            store.getState().updateNode(id, patch);
+            store.getState().updateNode(id, update.data);
         },
         upsert(node, parentId) {
+            if (store.getState().nodes[node.id]) {
+                this.update(node.id, parentId === undefined ? node : { ...node, parentId });
+                return node.id;
+            }
+            const [create] = filterDerivedNodeWrites(store.getState().nodes, {
+                create: [{ node, parentId }],
+            }).create;
+            if (!create)
+                return node.id;
             captureIfNeeded(node.id);
-            store.getState().createNode(node, parentId);
+            store.getState().createNode(create.node, create.parentId);
             return node.id;
         },
         createMany(ops) {
+            ops = filterDerivedNodeWrites(store.getState().nodes, { create: ops }).create;
+            if (!ops.length)
+                return;
             for (const op of ops)
                 captureIfNeeded(op.node.id);
             const batch = store.getState().createNodes;
@@ -48,6 +69,9 @@ export function createSceneApi(store) {
                     this.upsert(op.node, op.parentId);
         },
         applyChanges(changes) {
+            changes = filterDerivedNodeWrites(store.getState().nodes, changes);
+            if (!changes.create?.length && !changes.update?.length && !changes.delete?.length)
+                return;
             for (const op of changes.create ?? [])
                 captureIfNeeded(op.node.id);
             for (const op of changes.update ?? [])
@@ -101,10 +125,10 @@ export function createSceneApi(store) {
                     store.getState().deleteNode(id);
             }
             else if (!current) {
-                store.getState().createNode(original);
+                this.upsert(original);
             }
             else {
-                store.getState().updateNode(id, original);
+                this.update(id, original);
             }
         },
         restoreAll() {
@@ -134,7 +158,6 @@ export function createSceneApi(store) {
             const root = cloned[0];
             if (!root)
                 return null;
-            const state = store.getState();
             const ops = [];
             for (let i = 0; i < cloned.length; i += 1) {
                 const node = cloned[i];
@@ -145,14 +168,7 @@ export function createSceneApi(store) {
                     ops.push({ node });
                 }
             }
-            const batch = state.createNodes;
-            if (batch) {
-                batch(ops);
-            }
-            else {
-                for (const op of ops)
-                    state.createNode(op.node, op.parentId);
-            }
+            this.createMany(ops);
             return rootId;
         },
     };

package/dist/registry/subtree.d.ts

@@ -64,4 +64,12 @@ export type CloneNodesIntoResult = {
  * before / after calling this function. See `getHostRefFields(def)`.
  */
 export declare function cloneNodesInto(nodes: ReadonlyArray<AnyNode>, opts: CloneNodesIntoOptions): CloneNodesIntoResult;
+/**
+ * A deep copy of `node` as a preset stores it, without its source identity
+ * (D5): the whole `provenance` (refs and lineage) and every other source
+ * reference the inventory strips on preset. A placed preset is a new element,
+ * so it must never claim the source elements of the node it was saved from.
+ * Host references stay the host's call (`getHostRefFields`).
+ */
+export declare function withoutSourceIdentity<T extends AnyNode>(node: T): T;
 //# sourceMappingURL=subtree.d.ts.map

package/dist/registry/subtree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subtree.d.ts","sourceRoot":"","sources":["../../src/registry/subtree.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAmBzD,kDAAkD;AAClD,MAAM,MAAM,OAAO,GAAG;IACpB,oEAAoE;IACpE,IAAI,EAAE,OAAO,CAAA;IACb,gGAAgG;IAChG,WAAW,EAAE,OAAO,EAAE,CAAA;CACvB,CAAA;AAcD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,EAC3C,MAAM,EAAE,SAAS,GAChB,OAAO,GAAG,IAAI,CAmBhB;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC;;;;;OAKG;IACH,MAAM,EAAE,SAAS,CAAA;IACjB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAC7C,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,8DAA8D;IAC9D,MAAM,EAAE,SAAS,CAAA;IACjB,uEAAuE;IACvE,KAAK,EAAE,OAAO,EAAE,CAAA;IAChB,qFAAqF;IACrF,KAAK,EAAE,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;CACjC,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,EAC7B,IAAI,EAAE,qBAAqB,GAC1B,oBAAoB,CA2EtB"}
+{"version":3,"file":"subtree.d.ts","sourceRoot":"","sources":["../../src/registry/subtree.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAmBzD,kDAAkD;AAClD,MAAM,MAAM,OAAO,GAAG;IACpB,oEAAoE;IACpE,IAAI,EAAE,OAAO,CAAA;IACb,gGAAgG;IAChG,WAAW,EAAE,OAAO,EAAE,CAAA;CACvB,CAAA;AAcD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,EAC3C,MAAM,EAAE,SAAS,GAChB,OAAO,GAAG,IAAI,CAmBhB;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC;;;;;OAKG;IACH,MAAM,EAAE,SAAS,CAAA;IACjB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAC7C,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,8DAA8D;IAC9D,MAAM,EAAE,SAAS,CAAA;IACjB,uEAAuE;IACvE,KAAK,EAAE,OAAO,EAAE,CAAA;IAChB,qFAAqF;IACrF,KAAK,EAAE,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;CACjC,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,EAC7B,IAAI,EAAE,qBAAqB,GAC1B,oBAAoB,CA4EtB;AAcD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAOnE"}

package/dist/registry/subtree.js

@@ -1,4 +1,6 @@
+import { EXISTING_REFERENCES, METADATA_REFERENCES } from '../contracts/reference-inventory.js';
 import { remapConstructionDimensionReferences, remapMeasurementReferences, } from '../lib/measurement-geometry.js';
+import { remapSurfaceSupportReferences } from '../lib/surface-support-references.js';
 import { generateId } from '../schema/base.js';
 function extractIdPrefix(id) {
     const i = id.indexOf('_');
@@ -98,6 +100,7 @@ export function cloneNodesInto(nodes, opts) {
                 .map((cid) => idMap.get(cid))
                 .filter((cid) => cid !== undefined);
         }
+        remapSurfaceSupportReferences(cloned, idMap);
         if (cloned.type === 'procedural-item') {
             cloned.attachments = Object.fromEntries(Object.entries(cloned.attachments).flatMap(([id, surface]) => {
                 const fresh = idMap.get(id);
@@ -130,3 +133,55 @@ export function cloneNodesInto(nodes, opts) {
     }
     return { rootId: rootFreshId, nodes: [root, ...out], idMap };
 }
+/**
+ * Source references a preset strips besides `provenance`: the reference
+ * inventory's `source` rows with `onPreset: 'strip'` (layer `src`, …).
+ */
+const PRESET_STRIPPED_SOURCES = [...EXISTING_REFERENCES, ...METADATA_REFERENCES].filter((row) => row.namespace === 'source' &&
+    row.onPreset === 'strip' &&
+    row.kind !== '#scene' &&
+    !row.path.startsWith('provenance.'));
+/**
+ * A deep copy of `node` as a preset stores it, without its source identity
+ * (D5): the whole `provenance` (refs and lineage) and every other source
+ * reference the inventory strips on preset. A placed preset is a new element,
+ * so it must never claim the source elements of the node it was saved from.
+ * Host references stay the host's call (`getHostRefFields`).
+ */
+export function withoutSourceIdentity(node) {
+    const copy = JSON.parse(JSON.stringify(node));
+    delete copy.provenance;
+    for (const row of PRESET_STRIPPED_SOURCES) {
+        if (row.kind === '*' || row.kind === node.type)
+            deleteReferenceField(copy, row.path);
+    }
+    return copy;
+}
+/**
+ * Deletes the field a `ReferencePath` names in every container it resolves
+ * to. A trailing `[]`, `*` or `@key` deletes the whole array or record.
+ */
+function deleteReferenceField(target, path) {
+    const segments = path.replace(/\[\]/g, '.[]').split('.');
+    while (['[]', '*', '@key'].includes(segments.at(-1) ?? ''))
+        segments.pop();
+    const field = segments.pop();
+    if (!field)
+        return;
+    let containers = [target];
+    for (const segment of segments) {
+        containers = containers.flatMap((value) => {
+            if (value === null || typeof value !== 'object')
+                return [];
+            if (segment === '[]')
+                return Array.isArray(value) ? value : [];
+            if (segment === '*' || segment === '@key')
+                return Object.values(value);
+            return [value[segment]];
+        });
+    }
+    for (const container of containers) {
+        if (container !== null && typeof container === 'object' && !Array.isArray(container))
+            delete container[field];
+    }
+}