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

package/dist/systems/door/door-system.js

@@ -4,6 +4,7 @@ import { useEffect, useRef } from 'react';
 import * as THREE from 'three';
 import { applyWorldScaleBoxUVs } from '../../lib/box-uv';
 import { createDefaultMaterial, createSurfaceRoleMaterial, glassMaterial as defaultGlassMaterial, baseMaterial as getBaseMaterial, resolveMaterialRef, } from '../../lib/materials';
+import { timeSpan } from '../../lib/perf-tracks';
 import useViewer from '../../store/use-viewer';
 import { getOpeningCutoutProxyDepth } from '../wall/opening-cutout-geometry';
 // Invisible material for root mesh — used as selection hitbox only
@@ -94,7 +95,11 @@ export const DoorSystem = () => {
         }
     }, [sceneMaterials]);
     useFrame(() => {
-        if (dirtyNodes.size === 0)
+        // Doors mid-swing rebuild every tick via their `doorAnimations` entry —
+        // the tween is a needs-frame signal, not dirty-set work (the set must be
+        // able to reach zero while an animation runs).
+        const animatingDoorIds = Object.keys(useInteractive.getState().doorAnimations);
+        if (dirtyNodes.size === 0 && animatingDoorIds.length === 0)
             return;
         const frameJoineryMaterial = createSurfaceRoleMaterial('joinery', colorPreset);
         baseMaterial = textures ? getBaseMaterial(shading) : frameJoineryMaterial;
@@ -114,6 +119,10 @@ export const DoorSystem = () => {
                 return;
             dirtyDoorIds.push(id);
         });
+        for (const id of animatingDoorIds) {
+            if (nodes[id]?.type === 'door' && !dirtyDoorIds.includes(id))
+                dirtyDoorIds.push(id);
+        }
         const useProgressiveDoorRebuilds = dirtyDoorIds.length > DOOR_PROGRESSIVE_DIRTY_THRESHOLD;
         const frameStartedAt = performance.now();
         let rebuiltDoorsThisFrame = 0;
@@ -137,7 +146,9 @@ export const DoorSystem = () => {
             // rebuild reflects the in-flight drag without zustand churn. When
             // no override is set this returns the scene node unchanged.
             const effectiveNode = getEffectiveNode(node);
-            updateDoorMesh(effectiveNode, mesh);
+            timeSpan('door', () => updateDoorMesh(effectiveNode, mesh), {
+                properties: [['node', id]],
+            });
             clearDirty(id);
             rebuiltDoorsThisFrame += 1;
             // Rebuild the parent wall so its cutout reflects the updated door geometry

package/dist/systems/floor-elevation/floor-elevation-system.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"floor-elevation-system.d.ts","sourceRoot":"","sources":["../../../src/systems/floor-elevation/floor-elevation-system.tsx"],"names":[],"mappings":"AAyCA;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,oBAAoB,YAoEhC,CAAA"}
+{"version":3,"file":"floor-elevation-system.d.ts","sourceRoot":"","sources":["../../../src/systems/floor-elevation/floor-elevation-system.tsx"],"names":[],"mappings":"AAyCA;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,oBAAoB,YA6EhC,CAAA"}

package/dist/systems/floor-elevation/floor-elevation-system.js

@@ -64,6 +64,15 @@ export const FloorElevationSystem = () => {
             const position = effectiveNode.position;
             if (!position)
                 return;
+            // `applies === false` means the kind opts OUT of floor stacking for this
+            // node: its Y belongs to a host frame (a wall/ceiling-mounted item, a
+            // cabinet module inside a run, a wall duct terminal). `getFloorPlacedElevation`
+            // already returns 0 for them, so the write below would degenerate to
+            // copying `position[1]` into the mesh — and tools publish live transforms
+            // in WORLD space, so during a drag that lifts the ghost off its host by
+            // the host frame's own elevation.
+            if (floorPlaced.applies && !floorPlaced.applies(effectiveNode))
+                return;
             // This system is the single drag-time authority for floor-stack mesh Y:
             // tools publish base positions to live stores, renderers may
             // reconcile that base Y onto the group, then this presentation system

package/dist/systems/geometry/geometry-system.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"geometry-system.d.ts","sourceRoot":"","sources":["../../../src/systems/geometry/geometry-system.tsx"],"names":[],"mappings":"AAkBA,OAAO,EAAa,KAAK,KAAK,EAA4B,KAAK,QAAQ,EAAE,MAAM,OAAO,CAAA;AAQtF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,cAAc,YA8L1B,CAAA;AAoKD,eAAe,cAAc,CAAA;AAE7B,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,KAAK,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAU7D;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,EAC3C,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,GACV,OAAO,CAKT"}
+{"version":3,"file":"geometry-system.d.ts","sourceRoot":"","sources":["../../../src/systems/geometry/geometry-system.tsx"],"names":[],"mappings":"AAkBA,OAAO,EAAa,KAAK,KAAK,EAA4B,KAAK,QAAQ,EAAE,MAAM,OAAO,CAAA;AAUtF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,cAAc,YAuM1B,CAAA;AA8ID,eAAe,cAAc,CAAA;AAE7B,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,KAAK,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAU7D;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,EAC3C,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,GACV,OAAO,CAKT"}

package/dist/systems/geometry/geometry-system.js

@@ -3,7 +3,9 @@ import { findLevelAncestorId, getEffectiveNode, levelBaseElevationAt, nodeRegist
 import { useFrame } from '@react-three/fiber';
 import { useEffect, useRef } from 'react';
 import { FrontSide } from 'three';
+import { disposeObject3DResources } from '../../lib/dispose-object3d';
 import { createSurfaceRoleMaterial, } from '../../lib/materials';
+import { timeSpan } from '../../lib/perf-tracks';
 import useViewer from '../../store/use-viewer';
 /**
  * Generic geometry system.
@@ -137,7 +139,7 @@ export const GeometrySystem = () => {
                         siblings.push(node);
                 }
             }
-            levelDataByBatch.set(key, def.computeLevelData(siblings));
+            levelDataByBatch.set(key, timeSpan('geometry', () => def.computeLevelData(siblings), { name: 'geometry:levelData' }));
         }
         // Phase 3 — per-node rebuild. Each node receives its batch's
         // precomputed `levelData` in ctx.
@@ -179,7 +181,7 @@ export const GeometrySystem = () => {
             // The builder is typed against the kind's specific node — at the
             // generic system level we lose that refinement, so the cast lands
             // here. Builders are responsible for trusting their schema.
-            const built = builder(effectiveNode, ctx, shading, textures, colorPreset, sceneTheme);
+            const built = timeSpan('geometry', () => builder(effectiveNode, ctx, shading, textures, colorPreset, sceneTheme), { name: `geometry:${node.type}`, properties: [['node', id]] });
             if (!textures && def.surfaceRole) {
                 applyDefaultSurfaceRole(built, def.surfaceRole, colorPreset, sceneTheme);
             }
@@ -289,28 +291,7 @@ function disposeChildren(group) {
         if (!fromGeometry)
             continue;
         group.remove(child);
-        const mesh = child;
-        if (mesh.geometry?.dispose)
-            mesh.geometry.dispose();
-        if ('material' in mesh) {
-            const m = mesh.material;
-            if (Array.isArray(m)) {
-                for (const mat of m) {
-                    if (isCachedMaterial(mat))
-                        continue;
-                    if (mat && typeof mat.dispose === 'function') {
-                        ;
-                        mat.dispose();
-                    }
-                }
-            }
-            else if (isCachedMaterial(m)) {
-            }
-            else if (m && typeof m.dispose === 'function') {
-                ;
-                m.dispose();
-            }
-        }
+        disposeObject3DResources(child);
     }
 }
 function applyDefaultSurfaceRole(root, defaultRole, colorPreset, sceneTheme) {
@@ -339,10 +320,6 @@ function getMaterialSide(material) {
     const source = Array.isArray(material) ? material[0] : material;
     return source?.side ?? FrontSide;
 }
-function isCachedMaterial(value) {
-    return Boolean(value?.userData
-        ?.__pascalCachedMaterial);
-}
 export default GeometrySystem;
 export function markGeometryBuildOutput(child) {
     // Tag the builder subtree so paint previews can reach nested meshes (for

package/dist/systems/level/level-system.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"level-system.d.ts","sourceRoot":"","sources":["../../../src/systems/level/level-system.tsx"],"names":[],"mappings":"AAeA,eAAO,MAAM,WAAW,YAuDvB,CAAA"}
+{"version":3,"file":"level-system.d.ts","sourceRoot":"","sources":["../../../src/systems/level/level-system.tsx"],"names":[],"mappings":"AAcA,eAAO,MAAM,WAAW,YA6DvB,CAAA"}

package/dist/systems/level/level-system.js

@@ -3,7 +3,7 @@ import { useFrame } from '@react-three/fiber';
 import { lerp } from 'three/src/math/MathUtils.js';
 import { applyShadowOnly, clearShadowOnly } from '../../lib/shadow-only';
 import useViewer from '../../store/use-viewer';
-const EXPLODED_GAP = 5;
+import { EXPLODED_GAP } from './level-utils';
 // Levels currently in shadow-caster-only mode (solo hides them from the color
 // passes but keeps their sun shadows). Tracked so we can restore layer masks
 // exactly once on transition; apply re-runs every frame so meshes rebuilt
@@ -35,7 +35,13 @@ export const LevelSystem = () => {
             const baseY = levelElevations.get(levelId)?.baseY ?? 0;
             const explodedExtra = levelMode === 'exploded' ? index * EXPLODED_GAP : 0;
             const targetY = baseY + explodedExtra;
-            obj.position.y = lerp(obj.position.y, targetY, delta * 12); // Smoothly animate to new Y position
+            // Clamped smoothing. The naive `lerp(y, target, delta*12)` multiplies
+            // the error by |1 - 12*delta| per frame — DIVERGENT once a frame
+            // exceeds ~166 ms (slow machines, headless GL, heavy scenes): levels
+            // oscillated kilometers off-screen and the level-fit camera followed
+            // (blank viewport). Clamping keeps every step a contraction: identical
+            // feel at 60 fps, exact snap instead of overshoot on slow frames.
+            obj.position.y = lerp(obj.position.y, targetY, Math.min(1, delta * 12));
             // Solo: hidden levels ABOVE the soloed one stay in the shadow map
             // (shadow-caster-only) so the sun still shadows the soloed floor through
             // them; levels below can't block the sun, so they plain-hide.

package/dist/systems/level/level-utils.d.ts

@@ -1,3 +1,12 @@
+export declare const EXPLODED_GAP = 5;
+/**
+ * The Y a level settles at under the given presentation mode — its stacked
+ * elevation plus the exploded gap. Analytic (scene store + mode), never a
+ * mesh read: a level created this frame has its Object3D at y=0 until
+ * LevelSystem lerps it, and a mode switch leaves meshes mid-lerp — camera
+ * code framing a level must aim at the destination, not the moving target.
+ */
+export declare function getLevelPresentationY(levelId: string, nodes: Record<string, unknown>, levelMode: 'stacked' | 'exploded' | 'solo' | 'manual'): number;
 /**
  * Instantly snaps all level Objects3D to their true stacked Y positions
  * (ignores levelMode — always uses stacked, no exploded gap).

package/dist/systems/level/level-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"level-utils.d.ts","sourceRoot":"","sources":["../../../src/systems/level/level-utils.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,IAAI,CAyCtD"}
+{"version":3,"file":"level-utils.d.ts","sourceRoot":"","sources":["../../../src/systems/level/level-utils.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY,IAAI,CAAA;AAE7B;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,SAAS,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GACpD,MAAM,CAKR;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,IAAI,CAyCtD"}

package/dist/systems/level/level-utils.js

@@ -1,4 +1,18 @@
 import { getLevelElevations, sceneRegistry, useScene } from '@pascal-app/core';
+export const EXPLODED_GAP = 5;
+/**
+ * The Y a level settles at under the given presentation mode — its stacked
+ * elevation plus the exploded gap. Analytic (scene store + mode), never a
+ * mesh read: a level created this frame has its Object3D at y=0 until
+ * LevelSystem lerps it, and a mode switch leaves meshes mid-lerp — camera
+ * code framing a level must aim at the destination, not the moving target.
+ */
+export function getLevelPresentationY(levelId, nodes, levelMode) {
+    const level = nodes[levelId];
+    const baseY = getLevelElevations(nodes).get(levelId)?.baseY ?? 0;
+    const explodedExtra = levelMode === 'exploded' && level ? level.level * EXPLODED_GAP : 0;
+    return baseY + explodedExtra;
+}
 /**
  * Instantly snaps all level Objects3D to their true stacked Y positions
  * (ignores levelMode — always uses stacked, no exploded gap).

package/dist/systems/perf-action-settle/perf-action-settle-system.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Feeds the action-cost ledger (lib/perf-actions.ts) the per-frame settle
+ * state: how much of the scene is still dirty and how many wall neighbour
+ * rebuilds the wall system still owes. Without `?perf` the inner component
+ * never mounts, so no useFrame subscriber is registered at all.
+ */
+export declare const PerfActionSettleSystem: () => import("react").JSX.Element | null;
+//# sourceMappingURL=perf-action-settle-system.d.ts.map

package/dist/systems/perf-action-settle/perf-action-settle-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"perf-action-settle-system.d.ts","sourceRoot":"","sources":["../../../src/systems/perf-action-settle/perf-action-settle-system.tsx"],"names":[],"mappings":"AAuBA;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,0CAGlC,CAAA"}

package/dist/systems/perf-action-settle/perf-action-settle-system.js

@@ -0,0 +1,32 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useScene } from '@pascal-app/core';
+import { useFrame } from '@react-three/fiber';
+import { PERF_OVERLAY_ENABLED } from '../../lib/gpu-perf';
+import { notifyPerfActionFrame } from '../../lib/perf-actions';
+import { getPendingWallRebuildCount } from '../wall/wall-system';
+// Later than every other viewer system (the highest in the tree is 10) and
+// later than the render call in post-processing (priority 1), so the counts
+// reported are what the frame actually left behind.
+const SETTLE_PRIORITY = 100;
+const PerfActionSettleFrame = () => {
+    useFrame(() => {
+        // The raw set size, deliberately: the dirty lifecycle now guarantees marks
+        // are cleared when their node goes away (undo sweep) and never added for
+        // consumerless kinds (GuardedDirtySet), so any lingering mark is a leak
+        // that SHOULD fail settle instead of being filtered out here.
+        const { dirtyNodes } = useScene.getState();
+        notifyPerfActionFrame(dirtyNodes.size, getPendingWallRebuildCount());
+    }, SETTLE_PRIORITY);
+    return null;
+};
+/**
+ * Feeds the action-cost ledger (lib/perf-actions.ts) the per-frame settle
+ * state: how much of the scene is still dirty and how many wall neighbour
+ * rebuilds the wall system still owes. Without `?perf` the inner component
+ * never mounts, so no useFrame subscriber is registered at all.
+ */
+export const PerfActionSettleSystem = () => {
+    if (!PERF_OVERLAY_ENABLED)
+        return null;
+    return _jsx(PerfActionSettleFrame, {});
+};

package/dist/systems/roof/roof-system.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"roof-system.d.ts","sourceRoot":"","sources":["../../../src/systems/roof/roof-system.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EAcZ,KAAK,eAAe,EAKrB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,EAAY,KAAK,EAA0B,MAAM,eAAe,CAAA;AAwIvE,eAAO,MAAM,UAAU,YAuItB,CAAA;AAmXD;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,EAAE;IAC7B,KAAK,CAAC,iBAAiB;IACvB,KAAK,CAAC,iBAAiB;IACvB,KAAK,CAAC,iBAAiB;IACvB,KAAK,CAAC,iBAAiB;CAMxB,CAAA;AAID,eAAO,MAAM,wBAAwB,IAAI,CAAA;AAEzC,KAAK,mBAAmB,GAAG;IACzB,QAAQ,EAAE,KAAK,CAAA;IACf,QAAQ,EAAE,KAAK,CAAA;IACf,SAAS,EAAE,KAAK,CAAA;IAChB,UAAU,EAAE,KAAK,CAAA;IACjB,UAAU,EAAE,KAAK,CAAC,cAAc,GAAG,IAAI,CAAA;CACxC,CAAA;AA0FD,wBAAgB,yBAAyB,CACvC,kBAAkB,EAAE,MAAM,GAAG,SAAS,EACtC,YAAY,EAAE,KAAK,CAAC,QAAQ,EAAE,EAC9B,UAAU,EAAE,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,GACtC,MAAM,CAuBR;AAgUD;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,KAAK,CAAC,cAAc,GAAG,IAAI,EACrC,OAAO,EAAE,eAAe,GACvB,KAAK,CAAC,cAAc,GAAG,IAAI,CAyB7B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,eAAe,GAAG,mBAAmB,GAAG,IAAI,CA+SvF;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,eAAe,EACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,KAAK,CAAC,cAAc,CAsFtB;AAsLD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,KAAK,CAAC,cAAc,EAAE,IAAI,EAAE,eAAe,QA2ExF;AAijBD,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,KAAK,CAAC,OAAO,CAAA;IACpB,MAAM,EAAE,KAAK,CAAC,OAAO,CAAA;CACtB,CAAA;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,eAAe,EACxB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACT,YAAY,CAqLd"}
+{"version":3,"file":"roof-system.d.ts","sourceRoot":"","sources":["../../../src/systems/roof/roof-system.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EAoBZ,KAAK,eAAe,EAQrB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,EAAY,KAAK,EAA0B,MAAM,eAAe,CAAA;AAkMvE,eAAO,MAAM,UAAU,YAwItB,CAAA;AAgbD;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,EAAE;IAC7B,KAAK,CAAC,iBAAiB;IACvB,KAAK,CAAC,iBAAiB;IACvB,KAAK,CAAC,iBAAiB;IACvB,KAAK,CAAC,iBAAiB;CAMxB,CAAA;AAID,eAAO,MAAM,wBAAwB,IAAI,CAAA;AAEzC,KAAK,mBAAmB,GAAG;IACzB,QAAQ,EAAE,KAAK,CAAA;IACf,QAAQ,EAAE,KAAK,CAAA;IACf,SAAS,EAAE,KAAK,CAAA;IAChB,UAAU,EAAE,KAAK,CAAA;IACjB,UAAU,EAAE,KAAK,CAAC,cAAc,GAAG,IAAI,CAAA;CACxC,CAAA;AA0FD,wBAAgB,yBAAyB,CACvC,kBAAkB,EAAE,MAAM,GAAG,SAAS,EACtC,YAAY,EAAE,KAAK,CAAC,QAAQ,EAAE,EAC9B,UAAU,EAAE,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,GACtC,MAAM,CAuBR;AAoWD;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,KAAK,CAAC,cAAc,GAAG,IAAI,EACrC,OAAO,EAAE,eAAe,GACvB,KAAK,CAAC,cAAc,GAAG,IAAI,CAyB7B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,eAAe,GAAG,mBAAmB,GAAG,IAAI,CA8TvF;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,eAAe,EACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,KAAK,CAAC,cAAc,CA2GtB;AAuyCD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,KAAK,CAAC,cAAc,EAAE,IAAI,EAAE,eAAe,QA0ExF;AA+qBD,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,KAAK,CAAC,OAAO,CAAA;IACpB,MAAM,EAAE,KAAK,CAAC,OAAO,CAAA;CACtB,CAAA;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,eAAe,EACxB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACT,YAAY,CAqLd"}