@pascal-app/core 1.0.0-beta.5 → 1.0.1

package/dist/registry/index.js

@@ -1,5 +1,4 @@
-export { bakePolicyOf, discoverPlugins, extendPluginDiscovery, getHostRefFields, getInspectorExtensions, getNodePluginId, getRegistryVersion, getSelectableKinds, hasRegistry3DMoveTool, isDrawnViaTool, isDrawnViaToolKind, isNodeKindEnabled, isPresettable, isPresettableKind, isRegistryMovable, isRegistrySelectable, kindsWithBakePolicy, kindsWithFloorplanScope, loadPlugin, nodeRegistry, onRegistryChange, registerNode, resolveFacingIndicator, setPluginDiscovery, } from './registry';
-export { cascadeDirty, collectDescendants, } from './relations-resolver';
-export { createSceneApi } from './scene-api';
-export { cloneNodesInto, collectSubtree, } from './subtree';
-export { useRegistryVersion } from './use-registry-version';
+export { bakePolicyOf, discoverPlugins, extendPluginDiscovery, getHostRefFields, getInspectorExtensions, getNodePluginId, getRegistryVersion, getSelectableKinds, hasRegistry3DMoveTool, isDrawnViaTool, isDrawnViaToolKind, isNodeKindEnabled, isPresettable, isPresettableKind, isRegistryMovable, isRegistrySelectable, isSelectionHighlightEnabled, kindsWithBakePolicy, kindsWithFloorplanScope, loadPlugin, nodeRegistry, onRegistryChange, registerNode, resolveFacingIndicator, setPluginDiscovery, } from './registry.js';
+export { cascadeDirty, collectDescendants, } from './relations-resolver.js';
+export { createSceneApi } from './scene-api.js';
+export { cloneNodesInto, collectSubtree, } from './subtree.js';

package/dist/registry/registry.d.ts

@@ -1,4 +1,4 @@
-import type { AnyNodeDefinition, BakePolicy, InspectorExtension, NodeRegistry, Plugin } from './types';
+import type { AnyNodeDefinition, BakePolicy, FloorplanScope, InspectorExtension, NodeRegistry, Plugin } from './types.js';
 /** Monotonic counter, bumped on every kind registration (and test reset). */
 export declare function getRegistryVersion(): number;
 /**
@@ -10,6 +10,7 @@ export declare function onRegistryChange(listener: () => void): () => void;
 export declare const nodeRegistry: NodeRegistry & {
     _register: (def: AnyNodeDefinition) => void;
     _reset: () => void;
+    _snapshot: () => () => void;
 };
 export declare function registerNode(def: AnyNodeDefinition): void;
 /** The plugin that registered a node kind, when it came through {@link loadPlugin}. */
@@ -45,14 +46,20 @@ export declare function getSelectableKinds(): string[];
  * in expression chains like `if (node.type === 'wall' || isRegistrySelectable(node.type))`.
  */
 export declare function isRegistrySelectable(kind: string): boolean;
+/**
+ * Whether the editor should apply its material-based selection highlight to a
+ * kind. Selection highlighting is enabled by default, including for legacy or
+ * unregistered kinds; definitions may explicitly opt out.
+ */
+export declare function isSelectionHighlightEnabled(kind: string): boolean;
 /**
  * Kinds whose `def.floorplanScope` matches the requested scope. Used by
- * `FloorplanRegistryLayer` to discover building-scoped kinds (e.g.
- * elevator) without hardcoding kind names in the editor layer. `'level'`
- * is the default, so `kindsWithFloorplanScope('level')` includes kinds
- * that didn't set the field at all.
+ * `FloorplanRegistryLayer` to discover building- and site-scoped kinds
+ * without hardcoding kind names in the editor layer. `'level'` is the
+ * default, so `kindsWithFloorplanScope('level')` includes kinds that
+ * didn't set the field at all.
  */
-export declare function kindsWithFloorplanScope(scope: 'level' | 'building'): string[];
+export declare function kindsWithFloorplanScope(scope: FloorplanScope): string[];
 /**
  * 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

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

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/registry/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,MAAM,EACP,MAAM,SAAS,CAAA;AAiChB,6EAA6E;AAC7E,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAKjE;AAgFD,eAAO,MAAM,YAAY,EAAE,YAAY,GAAG;IACxC,SAAS,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,IAAI,CAAA;IAC3C,MAAM,EAAE,MAAM,IAAI,CAAA;CACM,CAAA;AAE1B,wBAAgB,YAAY,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI,CAEzD;AAED,uFAAuF;AACvF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEhE;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAEzE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAI7F;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAQ7C;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,EAAE,CAO7E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAErD;AAED;qFACqF;AACrF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,EAAE,CAMhE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOvD;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAI3D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAK7D;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAIjF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,iBAAiB,GAAG,aAAa,CAAC,MAAM,CAAC,CAE9E;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAE9D;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGxD;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA8B9D;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;AAMrD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,eAAe,GAAG,IAAI,CAO5D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,eAAe,GAAG,IAAI,CAM/D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAEnD"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/registry/registry.ts"],"names":[],"mappings":"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"}

package/dist/registry/registry.js

@@ -108,6 +108,31 @@ class NodeRegistryImpl {
         inspectorExtensionsByKind.clear();
         notifyRegistryChanged();
     }
+    // Test-only — captures the registry (definitions + plugin bookkeeping) and
+    // returns a restore function. The registry is a module singleton and bun
+    // runs a package's test files sequentially in ONE process, so a test that
+    // registers a throwaway kind (or `_reset()`s) without restoring leaks that
+    // state into every later test FILE — and file order varies by platform
+    // (macOS vs CI Linux), which turns the leak into an order-dependent flake.
+    // Wrap registry mutations in `const restore = nodeRegistry._snapshot()`
+    // + `restore()` in `afterEach`/`finally`.
+    _snapshot() {
+        const defs = new Map(this.defs);
+        const pluginIds = new Map(pluginIdsByKind);
+        const extensions = new Map(Array.from(inspectorExtensionsByKind, ([kind, list]) => [kind, [...list]]));
+        return () => {
+            this.defs.clear();
+            for (const [kind, def] of defs)
+                this.defs.set(kind, def);
+            pluginIdsByKind.clear();
+            for (const [kind, id] of pluginIds)
+                pluginIdsByKind.set(kind, id);
+            inspectorExtensionsByKind.clear();
+            for (const [kind, list] of extensions)
+                inspectorExtensionsByKind.set(kind, [...list]);
+            notifyRegistryChanged();
+        };
+    }
 }
 export const nodeRegistry = new NodeRegistryImpl();
 export function registerNode(def) {
@@ -165,12 +190,20 @@ export function getSelectableKinds() {
 export function isRegistrySelectable(kind) {
     return nodeRegistry.get(kind)?.capabilities.selectable !== undefined;
 }
+/**
+ * Whether the editor should apply its material-based selection highlight to a
+ * kind. Selection highlighting is enabled by default, including for legacy or
+ * unregistered kinds; definitions may explicitly opt out.
+ */
+export function isSelectionHighlightEnabled(kind) {
+    return nodeRegistry.get(kind)?.capabilities.selectionHighlight !== false;
+}
 /**
  * Kinds whose `def.floorplanScope` matches the requested scope. Used by
- * `FloorplanRegistryLayer` to discover building-scoped kinds (e.g.
- * elevator) without hardcoding kind names in the editor layer. `'level'`
- * is the default, so `kindsWithFloorplanScope('level')` includes kinds
- * that didn't set the field at all.
+ * `FloorplanRegistryLayer` to discover building- and site-scoped kinds
+ * without hardcoding kind names in the editor layer. `'level'` is the
+ * default, so `kindsWithFloorplanScope('level')` includes kinds that
+ * didn't set the field at all.
  */
 export function kindsWithFloorplanScope(scope) {
     const result = [];

package/dist/registry/relations-resolver.d.ts

@@ -1,5 +1,5 @@
-import type { AnyNode, AnyNodeId } from '../schema/types';
-import type { SceneApi } from './types';
+import type { AnyNode, AnyNodeId } from '../schema/types.js';
+import type { SceneApi } from './types.js';
 /**
  * Spatial neighbor query — given a node and a set of kinds, returns IDs of
  * neighboring nodes of those kinds. The runtime provides this from

package/dist/registry/relations-resolver.js

@@ -1,4 +1,4 @@
-import { nodeRegistry } from './registry';
+import { nodeRegistry } from './registry.js';
 const DEFAULT_MAX_DEPTH = 16;
 /**
  * Walks the relations graph from one dirty node and returns the full set of

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

@@ -1,5 +1,5 @@
-import type { AnyNode, AnyNodeId } from '../schema/types';
-import type { SceneApi } from './types';
+import type { AnyNode, AnyNodeId } from '../schema/types.js';
+import type { SceneApi } from './types.js';
 /**
  * Minimal store shape this module depends on.
  *
@@ -16,10 +16,26 @@ export type SceneStoreLike = {
             node: AnyNode;
             parentId?: AnyNodeId;
         }[]) => void;
+        applyNodeChanges?: (changes: {
+            create?: {
+                node: AnyNode;
+                parentId?: AnyNodeId;
+            }[];
+            update?: {
+                id: AnyNodeId;
+                data: Partial<AnyNode>;
+            }[];
+            delete?: AnyNodeId[];
+        }) => void;
         updateNode: (id: AnyNodeId, data: Partial<AnyNode>) => void;
         deleteNode: (id: AnyNodeId) => void;
         markDirty: (id: AnyNodeId) => void;
     };
+    subscribe?: (listener: (state: {
+        nodes: Record<AnyNodeId, AnyNode>;
+    }, previous: {
+        nodes: Record<AnyNodeId, AnyNode>;
+    }) => void) => () => void;
     temporal: {
         getState: () => {
             pause: () => void;

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;AAOzD,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,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,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,CAgG9D"}
+{"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"}

package/dist/registry/scene-api.js

@@ -1,5 +1,5 @@
-import { pauseSceneHistory, resumeSceneHistory } from '../store/history-control';
-import { collectSubtree, cloneNodesInto as runCloneNodesInto, } from './subtree';
+import { activeSceneCommitNodeIds, pauseSceneHistory, resumeSceneHistory, } from '../store/history-control.js';
+import { collectSubtree, cloneNodesInto as runCloneNodesInto, } from './subtree.js';
 /**
  * Creates a {@link SceneApi} backed by a store.
  *
@@ -37,6 +37,54 @@ export function createSceneApi(store) {
             store.getState().createNode(node, parentId);
             return node.id;
         },
+        createMany(ops) {
+            for (const op of ops)
+                captureIfNeeded(op.node.id);
+            const batch = store.getState().createNodes;
+            if (batch)
+                batch(ops);
+            else
+                for (const op of ops)
+                    this.upsert(op.node, op.parentId);
+        },
+        applyChanges(changes) {
+            for (const op of changes.create ?? [])
+                captureIfNeeded(op.node.id);
+            for (const op of changes.update ?? [])
+                captureIfNeeded(op.id);
+            for (const id of changes.delete ?? [])
+                captureIfNeeded(id);
+            const batch = store.getState().applyNodeChanges;
+            if (batch) {
+                batch(changes);
+                return;
+            }
+            for (const op of changes.create ?? [])
+                this.upsert(op.node, op.parentId);
+            for (const op of changes.update ?? [])
+                this.update(op.id, op.data);
+            for (const id of changes.delete ?? [])
+                this.delete(id);
+        },
+        subscribeNodes(listener) {
+            return (store.subscribe?.((state, previous) => {
+                if (state.nodes === previous.nodes)
+                    return;
+                const scopedIds = activeSceneCommitNodeIds();
+                const changedIds = new Set(scopedIds);
+                if (!scopedIds) {
+                    for (const id of Object.keys(state.nodes)) {
+                        if (state.nodes[id] !== previous.nodes[id])
+                            changedIds.add(id);
+                    }
+                    for (const id of Object.keys(previous.nodes)) {
+                        if (!(id in state.nodes))
+                            changedIds.add(id);
+                    }
+                }
+                listener(state.nodes, previous.nodes, changedIds);
+            }) ?? (() => { }));
+        },
         delete(id) {
             captureIfNeeded(id);
             store.getState().deleteNode(id);

package/dist/registry/subtree.d.ts

@@ -1,4 +1,4 @@
-import type { AnyNode, AnyNodeId } from '../schema/types';
+import type { AnyNode, AnyNodeId } from '../schema/types.js';
 /** A flat live-scene subtree rooted at `root`. */
 export type Subtree = {
     /** The root node, exactly as stored in `useScene.nodes[rootId]`. */

package/dist/registry/subtree.js

@@ -1,5 +1,5 @@
-import { remapConstructionDimensionReferences, remapMeasurementReferences, } from '../lib/measurement-geometry';
-import { generateId } from '../schema/base';
+import { remapConstructionDimensionReferences, remapMeasurementReferences, } from '../lib/measurement-geometry.js';
+import { generateId } from '../schema/base.js';
 function extractIdPrefix(id) {
     const i = id.indexOf('_');
     return i === -1 ? 'node' : id.slice(0, i);