@pascal-app/core 1.0.0-beta.4 → 1.0.0

package/dist/utils/vertical-scene-migration.js

@@ -0,0 +1,179 @@
+import { GROUND_SUPPORT_ID } from '../hooks/spatial-grid/support-host-id';
+import { deriveLegacyLevelHeight } from '../services/level-height';
+import { getCeilingClampBound } from '../services/storey';
+import { computeWallSlabSupport } from '../systems/slab/slab-support';
+import { DEFAULT_WALL_HEIGHT } from '../systems/wall/wall-footprint';
+function getFiniteNumber(value, fallback) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : fallback;
+}
+function getStringArray(value) {
+    return Array.isArray(value)
+        ? value.filter((entry) => typeof entry === 'string')
+        : [];
+}
+// Walls whose top lands within this of the storey plane become plane-bound;
+// ceilings whose stored height lands within this of their clamp bound become
+// follows-mode. The strict comparison preserves intentional 0.20-short walls.
+const PLANE_BOUND_EPSILON = 0.2;
+// A ground-pinned wall counts as buried only when the elected slab's occupied
+// interval strictly straddles the pinned base. The tolerance absorbs float
+// drift in stamped offsets without capturing a slab that merely touches the
+// base from above.
+const BURIED_PIN_EPSILON = 1e-3;
+/**
+ * Applies the vertical-model load migration to serialized scene nodes.
+ *
+ * This must remain pure, idempotent, and server-safe: the editor loader and
+ * hosted scene authority both call it so they compare and persist the same
+ * canonical fields during collaboration.
+ */
+export function migrateVerticalSceneNodes(sourceNodes) {
+    const nodes = { ...sourceNodes };
+    let changed = false;
+    const replaceNode = (id, node) => {
+        nodes[id] = node;
+        changed = true;
+    };
+    // A level without `height` marks a scene saved before the vertical model
+    // landed. Compute the gate before mutating anything so stair and ceiling
+    // intent on already-migrated scenes is never reclassified.
+    const isLegacyScene = Object.values(nodes).some((node) => node?.type === 'level' && !('height' in node));
+    // Ordinals are semantic and compact independently within each building.
+    const buildingNodes = Object.values(nodes).filter((node) => node?.type === 'building');
+    const levelsByBuilding = new Map();
+    for (const [id, node] of Object.entries(nodes)) {
+        if (node?.type !== 'level')
+            continue;
+        const buildingId = buildingNodes.find((building) => building.id === node.parentId)?.id ??
+            buildingNodes.find((building) => getStringArray(building.children).includes(id))?.id ??
+            null;
+        const bucket = levelsByBuilding.get(buildingId) ?? [];
+        bucket.push({ id, ordinal: getFiniteNumber(node.level, 0) });
+        levelsByBuilding.set(buildingId, bucket);
+    }
+    for (const bucket of levelsByBuilding.values()) {
+        const sorted = [...bucket].sort((a, b) => a.ordinal - b.ordinal);
+        const negativeCount = sorted.filter((entry) => entry.ordinal < 0).length;
+        sorted.forEach((entry, index) => {
+            const nextOrdinal = index - negativeCount;
+            const current = nodes[entry.id];
+            if (current.level !== nextOrdinal) {
+                replaceNode(entry.id, { ...current, level: nextOrdinal });
+            }
+        });
+    }
+    // Materialize exact legacy storey planes before classifying wall tops.
+    const legacyLevelIds = Object.entries(nodes)
+        .filter(([, node]) => node?.type === 'level' && !('height' in node))
+        .map(([id]) => id);
+    const derivedHeights = new Map();
+    for (const levelId of legacyLevelIds) {
+        derivedHeights.set(levelId, deriveLegacyLevelHeight(levelId, nodes));
+    }
+    for (const levelId of legacyLevelIds) {
+        const plane = derivedHeights.get(levelId);
+        const level = nodes[levelId];
+        replaceNode(levelId, { ...level, height: plane });
+        const children = getStringArray(level.children)
+            .map((childId) => nodes[childId])
+            .filter((child) => child !== undefined);
+        const slabs = children.filter((child) => child.type === 'slab');
+        const walls = children.filter((child) => child.type === 'wall');
+        for (const wall of walls) {
+            const electedBase = computeWallSlabSupport({
+                start: wall.start,
+                end: wall.end,
+                curveOffset: wall.curveOffset,
+                thickness: wall.thickness,
+            }, slabs, walls).elevation;
+            const effectiveHeight = wall.height ?? DEFAULT_WALL_HEIGHT;
+            const top = Math.max(0, electedBase) + effectiveHeight;
+            if (Math.abs(plane - top) < PLANE_BOUND_EPSILON) {
+                if ('height' in wall) {
+                    const { height: _height, ...planeBound } = wall;
+                    replaceNode(wall.id, planeBound);
+                }
+            }
+            else if (wall.height !== effectiveHeight) {
+                replaceNode(wall.id, { ...wall, height: effectiveHeight });
+            }
+        }
+    }
+    if (isLegacyScene) {
+        for (const [id, node] of Object.entries(nodes)) {
+            if (node?.type !== 'stair' || node.totalRise !== 2.5)
+                continue;
+            const { totalRise: _totalRise, ...derivedRise } = node;
+            replaceNode(id, derivedRise);
+        }
+    }
+    // Preserve the exact occupied interval of legacy slabs.
+    for (const [id, node] of Object.entries(nodes)) {
+        if (node?.type !== 'slab' || 'thickness' in node)
+            continue;
+        const elevation = getFiniteNumber(node.elevation, 0.05);
+        replaceNode(id, elevation < 0
+            ? { ...node, thickness: 0.05, recessed: true }
+            : { ...node, thickness: elevation });
+    }
+    if (isLegacyScene) {
+        for (const [id, node] of Object.entries(nodes)) {
+            if (node?.type !== 'ceiling' || !('height' in node))
+                continue;
+            const dropHeight = () => {
+                const { height: _height, ...follows } = node;
+                replaceNode(id, follows);
+            };
+            if (node.autoFromWalls === true) {
+                dropHeight();
+                continue;
+            }
+            if (typeof node.parentId !== 'string')
+                continue;
+            const bound = getCeilingClampBound(node.parentId, nodes, Array.isArray(node.polygon) ? node.polygon : []);
+            const stored = getFiniteNumber(node.height, Number.NaN);
+            if (Number.isFinite(bound) && Math.abs(stored - bound) < PLANE_BOUND_EPSILON) {
+                dropHeight();
+            }
+        }
+    }
+    // Terrain-sculpt-era drafting stamped `supportSlabId: 'ground'` onto walls
+    // drawn in 3D on flat scenes. The pin short-circuits slab election, so a
+    // wall whose feet sit inside a floor slab keeps its base at the level floor
+    // — buried in the slab, z-fighting its side faces — while the panel shows
+    // the base as automatic. Heal the pin only in that buried state: a deck
+    // hovering above an intentionally grounded wall must keep its pin (dropping
+    // it would lift the wall onto the deck). Scenes with sculpted terrain are
+    // skipped wholesale — a ground host is load-bearing there, and the live
+    // terrain field isn't visible to this pure pass.
+    const hasSculptedTerrain = Object.values(nodes).some((node) => node?.type === 'site' && node.terrain != null);
+    if (!hasSculptedTerrain) {
+        for (const [id, node] of Object.entries(nodes)) {
+            if (node?.type !== 'wall' || node.supportSlabId !== GROUND_SUPPORT_ID)
+                continue;
+            const levelId = typeof node.parentId === 'string' ? node.parentId : null;
+            if (!levelId || nodes[levelId]?.type !== 'level')
+                continue;
+            const siblings = Object.values(nodes).filter((sibling) => sibling != null && sibling.parentId === levelId);
+            const support = computeWallSlabSupport({
+                start: node.start,
+                end: node.end,
+                curveOffset: node.curveOffset,
+                thickness: node.thickness,
+            }, siblings.filter((sibling) => sibling.type === 'slab'), siblings.filter((sibling) => sibling.type === 'wall'));
+            const elected = support.electedSlabId ? nodes[support.electedSlabId] : null;
+            if (!elected)
+                continue;
+            const pinnedBase = getFiniteNumber(node.supportOffset, 0);
+            const electedTop = getFiniteNumber(elected.elevation, 0.05);
+            const electedBottom = electedTop - getFiniteNumber(elected.thickness, 0.05);
+            const buried = electedBottom <= pinnedBase + BURIED_PIN_EPSILON &&
+                electedTop > pinnedBase + BURIED_PIN_EPSILON;
+            if (!buried)
+                continue;
+            const { supportSlabId: _host, supportOffset: _offset, ...healed } = node;
+            replaceNode(id, healed);
+        }
+    }
+    return changed ? { changed, nodes } : { changed, nodes: sourceNodes };
+}

package/dist/validation/validate-build-json.d.ts

@@ -1,3 +1,4 @@
+import { SceneMaterial } from '../schema/scene-material';
 import { type AnyNodeType } from '../schema/types';
 export type ValidationSeverity = 'error' | 'warning';
 export type ValidationIssue = {
@@ -18,6 +19,8 @@ export type ParsedBuildJson = {
     nodes: Record<string, unknown>;
     rootNodeIds: string[];
     installedPlugins?: string[];
+    /** Scene materials referenced by node `slots` (`scene:<id>`). */
+    materials?: Record<string, SceneMaterial>;
 };
 export type SchemaIssue = {
     nodeId: string;

package/dist/validation/validate-build-json.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-build-json.d.ts","sourceRoot":"","sources":["../../src/validation/validate-build-json.ts"],"names":[],"mappings":"AACA,OAAO,EAAW,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAG3D,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,CAAA;AAEpD,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAA;IAC5C,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;CAC5B,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,EAAE,EAAE,OAAO,CAAA;IACX,MAAM,EAAE,eAAe,GAAG,IAAI,CAAA;IAC9B,KAAK,EAAE,UAAU,CAAA;IACjB,MAAM,EAAE,eAAe,EAAE,CAAA;IACzB,QAAQ,EAAE,eAAe,EAAE,CAAA;IAC3B,YAAY,EAAE,WAAW,EAAE,CAAA;IAC3B,gBAAgB,EAAE,MAAM,CAAA;CACzB,CAAA;AA8BD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,uBAAuB,CA8SzE"}
+{"version":3,"file":"validate-build-json.d.ts","sourceRoot":"","sources":["../../src/validation/validate-build-json.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAW,KAAK,WAAW,EAAc,MAAM,iBAAiB,CAAA;AAGvE,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,CAAA;AAEpD,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAA;IAC5C,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC3B,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;CAC1C,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,EAAE,EAAE,OAAO,CAAA;IACX,MAAM,EAAE,eAAe,GAAG,IAAI,CAAA;IAC9B,KAAK,EAAE,UAAU,CAAA;IACjB,MAAM,EAAE,eAAe,EAAE,CAAA;IACzB,QAAQ,EAAE,eAAe,EAAE,CAAA;IAC3B,YAAY,EAAE,WAAW,EAAE,CAAA;IAC3B,gBAAgB,EAAE,MAAM,CAAA;CACzB,CAAA;AA4BD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,uBAAuB,CA4VzE"}

package/dist/validation/validate-build-json.js

@@ -1,7 +1,8 @@
 import { nodeRegistry } from '../registry';
-import { AnyNode } from '../schema/types';
+import { SceneMaterial } from '../schema/scene-material';
+import { AnyNode, nodeKindOf } from '../schema/types';
 import { healSceneNodes } from '../utils/heal-scene-graph';
-const KNOWN_TYPES = new Set(AnyNode.options.map((o) => o.shape.type.parse(undefined)));
+const KNOWN_TYPES = new Set(AnyNode.options.map(nodeKindOf));
 function isPlainObject(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
@@ -61,6 +62,7 @@ export function validateBuildJson(input) {
     const nodesRaw = input.nodes;
     const rootNodeIdsRaw = input.rootNodeIds;
     const installedPluginsRaw = input.installedPlugins;
+    const materialsRaw = input.materials;
     if (!isPlainObject(nodesRaw)) {
         errors.push({
             severity: 'error',
@@ -102,6 +104,50 @@ export function validateBuildJson(input) {
             message: 'Ignored invalid "installedPlugins" — expected an array of plugin IDs.',
         });
     }
+    // Scene materials ride along with the graph: nodes reference them by
+    // `scene:<id>` slot refs, so dropping the table here silently strips
+    // every custom finish from the imported scene. Invalid entries are
+    // skipped one by one — a bad material must not take the import down.
+    //
+    // DELIBERATE: `safeParse().data` NORMALIZES — defaults are injected
+    // and unknown keys dropped. That is the opposite of the API boundary
+    // (`apiGraphSchema` preserves unknown fields on purpose), and it is
+    // chosen here because import feeds the live scene store, which only
+    // understands schema-shaped materials; a hand-edited file with a
+    // half-formed material should land as something the renderer can
+    // draw, not round-trip garbage.
+    let materials;
+    if (isPlainObject(materialsRaw)) {
+        const skippedIds = [];
+        const kept = {};
+        for (const [id, value] of Object.entries(materialsRaw)) {
+            const result = SceneMaterial.safeParse(value);
+            if (result.success) {
+                kept[id] = result.data;
+            }
+            else {
+                skippedIds.push(id);
+            }
+        }
+        if (Object.keys(kept).length > 0)
+            materials = kept;
+        if (skippedIds.length > 0) {
+            // Name the ids: the audience is hand-edited files, and a count
+            // alone leaves nothing to repair by.
+            warnings.push({
+                severity: 'warning',
+                code: 'invalid_materials',
+                message: `Ignored ${skippedIds.length} invalid scene material${skippedIds.length === 1 ? '' : 's'}: ${skippedIds.join(', ')}.`,
+            });
+        }
+    }
+    else if (materialsRaw !== undefined) {
+        warnings.push({
+            severity: 'warning',
+            code: 'invalid_materials',
+            message: 'Ignored invalid "materials" — expected an object of id → material.',
+        });
+    }
     if (strippedChildRefs > 0 || droppedWallIds.length > 0) {
         warnings.push({
             severity: 'warning',
@@ -301,6 +347,7 @@ export function validateBuildJson(input) {
                 nodes,
                 rootNodeIds,
                 ...(installedPlugins ? { installedPlugins } : {}),
+                ...(materials ? { materials } : {}),
             }
             : null,
         stats,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pascal-app/core",
-  "version": "1.0.0-beta.4",
+  "version": "1.0.0",
   "description": "Core library for Pascal 3D building editor",
   "type": "module",
   "main": "./dist/index.js",
@@ -21,6 +21,11 @@
       "import": "./dist/utils/scene-migrations.js",
       "default": "./dist/utils/scene-migrations.js"
     },
+    "./capture": {
+      "types": "./dist/capture/index.d.ts",
+      "import": "./dist/capture/index.js",
+      "default": "./dist/capture/index.js"
+    },
     "./registry": {
       "types": "./dist/registry/index.d.ts",
       "import": "./dist/registry/index.js",
@@ -66,20 +71,21 @@
     "dev": "tsgo --build --watch",
     "test": "bun test src",
     "bench:registry": "bun run src/registry/__bench__/relations-resolver.bench.ts",
+    "bench:schema": "bun run src/schema/__bench__/node-parsers.bench.ts",
     "prepublishOnly": "npm run build"
   },
   "peerDependencies": {
     "@react-three/drei": "^10",
     "@react-three/fiber": "^9",
     "react": "^18 || ^19",
-    "three": "^0.185"
+    "three": "^0.186"
   },
   "dependencies": {
     "dedent": "^1.7.1",
     "idb-keyval": "^6.2.2",
     "mitt": "^3.0.1",
     "nanoid": "^5.1.6",
-    "zod": "^4.3.5",
+    "zod": ">=4.5.4 <4.6",
     "zundo": "^2.3.0",
     "zustand": "^5"
   },
@@ -88,6 +94,7 @@
     "@types/bun": "^1.3.0",
     "@types/react": "^19.2.2",
     "@types/three": "^0.184.0",
+    "fake-indexeddb": "^6.2.5",
     "typescript": "6.0.3"
   },
   "keywords": [

package/dist/systems/elevator/elevator-runtime-system.d.ts

@@ -1,2 +0,0 @@
-export declare function ElevatorRuntimeSystem(): null;
-//# sourceMappingURL=elevator-runtime-system.d.ts.map

package/dist/systems/elevator/elevator-runtime-system.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"elevator-runtime-system.d.ts","sourceRoot":"","sources":["../../../src/systems/elevator/elevator-runtime-system.tsx"],"names":[],"mappings":"AAGA,wBAAgB,qBAAqB,SAMpC"}

package/dist/systems/elevator/elevator-runtime-system.js

@@ -1,8 +0,0 @@
-import { useFrame } from '@react-three/fiber';
-import { stepElevatorRuntimes } from './elevator-runtime';
-export function ElevatorRuntimeSystem() {
-    useFrame(({ clock }, delta) => {
-        stepElevatorRuntimes(clock.getElapsedTime() * 1000, delta);
-    }, 2);
-    return null;
-}