@pascal-app/viewer 1.0.4 → 1.0.6

package/dist/systems/construction-reveal/dust-material.d.ts

@@ -0,0 +1,10 @@
+import type { InstancedBufferAttribute } from 'three';
+import { MeshBasicNodeMaterial } from 'three/webgpu';
+/**
+ * A soft disc on a quad, faded per sprite by `alpha`. It draws into the scene pass so walls in front
+ * hide it, and writes nothing to that pass's normals and diffuse colour (alpha 0 under their material
+ * blending): the ink reads the normals, and the whole quad, not just its disc, was an edge there.
+ * `output` is named too: a pass without MRT draws what this node names and nothing else.
+ */
+export declare function createDustMaterial(alpha: InstancedBufferAttribute): MeshBasicNodeMaterial;
+//# sourceMappingURL=dust-material.d.ts.map

package/dist/systems/construction-reveal/dust-material.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dust-material.d.ts","sourceRoot":"","sources":["../../../src/systems/construction-reveal/dust-material.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,OAAO,CAAA;AAErD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAIpD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,wBAAwB,yBAOjE"}

package/dist/systems/construction-reveal/dust-material.js

@@ -0,0 +1,17 @@
+import { color, float, instancedDynamicBufferAttribute, mrt, output, uv, vec4 } from 'three/tsl';
+import { MeshBasicNodeMaterial } from 'three/webgpu';
+const DUST_COLOR = '#d9cdb8';
+/**
+ * A soft disc on a quad, faded per sprite by `alpha`. It draws into the scene pass so walls in front
+ * hide it, and writes nothing to that pass's normals and diffuse colour (alpha 0 under their material
+ * blending): the ink reads the normals, and the whole quad, not just its disc, was an edge there.
+ * `output` is named too: a pass without MRT draws what this node names and nothing else.
+ */
+export function createDustMaterial(alpha) {
+    const material = new MeshBasicNodeMaterial({ transparent: true, depthWrite: false });
+    material.colorNode = color(DUST_COLOR);
+    const edge = float(1).sub(uv().sub(0.5).length().mul(2)).clamp(0, 1);
+    material.opacityNode = edge.mul(edge).mul(instancedDynamicBufferAttribute(alpha, 'float'));
+    material.mrtNode = mrt({ output, diffuseColor: vec4(0), normal: vec4(0) });
+    return material;
+}

package/dist/systems/construction-reveal/ghost-dress.d.ts

@@ -0,0 +1,10 @@
+import type { Object3D } from 'three';
+/**
+ * The picture a deleted node plays out is a copy of what stood there, and a copy wears the
+ * material its source had in that frame. A node the cutaway was hiding wears its stipple, so its
+ * deletion would play as faint dots: when its source carries a visible variant (the wall cutout
+ * keeps one, `visibleMaterialsOf`), the copy wears that instead, the one a capture draws, for as long
+ * as it plays. What the cutaway showed, and any other wall mode, keep what they wear.
+ */
+export declare function dressDeletionGhost(source: Object3D, clone: Object3D): void;
+//# sourceMappingURL=ghost-dress.d.ts.map

package/dist/systems/construction-reveal/ghost-dress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ghost-dress.d.ts","sourceRoot":"","sources":["../../../src/systems/construction-reveal/ghost-dress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,OAAO,CAAA;AAK3C;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,QAenE"}

package/dist/systems/construction-reveal/ghost-dress.js

@@ -0,0 +1,24 @@
+import { hasMaterialsForGroups } from '../../lib/pointer-events';
+import useViewer from '../../store/use-viewer';
+import { visibleMaterialsOf } from '../wall/wall-cutout-cache';
+/**
+ * The picture a deleted node plays out is a copy of what stood there, and a copy wears the
+ * material its source had in that frame. A node the cutaway was hiding wears its stipple, so its
+ * deletion would play as faint dots: when its source carries a visible variant (the wall cutout
+ * keeps one, `visibleMaterialsOf`), the copy wears that instead, the one a capture draws, for as long
+ * as it plays. What the cutaway showed, and any other wall mode, keep what they wear.
+ */
+export function dressDeletionGhost(source, clone) {
+    const visible = visibleMaterialsOf.get(source);
+    const mesh = clone;
+    if (visible &&
+        useViewer.getState().wallMode === 'cutaway' &&
+        source.userData.wallHidden === true &&
+        mesh.isMesh &&
+        mesh.geometry &&
+        // A room-wide paint preview can leave the source with more groups than the palette has
+        // entries; a copy with a group and no material throws on every raycast over it (see
+        // `WallCutoutCache.mayAssign`), so it keeps what it wears then.
+        hasMaterialsForGroups(mesh, visible))
+        mesh.material = visible;
+}

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

@@ -1,2 +1,9 @@
+import { type Object3D } from 'three';
+/**
+ * The roots of every elevator button under `object`. Any button along the ray
+ * takes the click, so only they are raycast — never the rest of the scene,
+ * whose meshes this capture-phase listener must not trip over.
+ */
+export declare function collectElevatorButtons(object: Object3D, into?: Object3D[]): Object3D[];
 export declare function ElevatorInteractionSystem(): null;
 //# sourceMappingURL=elevator-interaction-system.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"elevator-interaction-system.d.ts","sourceRoot":"","sources":["../../../src/systems/elevator/elevator-interaction-system.tsx"],"names":[],"mappings":"AAkCA,wBAAgB,yBAAyB,SA0DxC"}
+{"version":3,"file":"elevator-interaction-system.d.ts","sourceRoot":"","sources":["../../../src/systems/elevator/elevator-interaction-system.tsx"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,QAAQ,EAAsB,MAAM,OAAO,CAAA;AAwBzD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAE,QAAQ,EAAO,GAAG,QAAQ,EAAE,CAO1F;AAED,wBAAgB,yBAAyB,SA6DxC"}

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

@@ -12,6 +12,20 @@ function getElevatorButtonData(object) {
     }
     return null;
 }
+/**
+ * The roots of every elevator button under `object`. Any button along the ray
+ * takes the click, so only they are raycast — never the rest of the scene,
+ * whose meshes this capture-phase listener must not trip over.
+ */
+export function collectElevatorButtons(object, into = []) {
+    if (object.userData.elevatorButton) {
+        into.push(object);
+        return into;
+    }
+    for (const child of object.children)
+        collectElevatorButtons(child, into);
+    return into;
+}
 export function ElevatorInteractionSystem() {
     const camera = useThree((state) => state.camera);
     const gl = useThree((state) => state.gl);
@@ -23,6 +37,9 @@ export function ElevatorInteractionSystem() {
         const handlePointerDown = (event) => {
             if (event.button !== 0)
                 return;
+            const buttons = collectElevatorButtons(scene);
+            if (buttons.length === 0)
+                return;
             const rect = canvas.getBoundingClientRect();
             const pointer = pointerRef.current;
             pointer.x = ((event.clientX - rect.left) / rect.width) * 2 - 1;
@@ -30,7 +47,7 @@ export function ElevatorInteractionSystem() {
             const raycaster = raycasterRef.current;
             raycaster.setFromCamera(pointer, camera);
             const button = raycaster
-                .intersectObjects(scene.children, true)
+                .intersectObjects(buttons, true)
                 .map((intersection) => getElevatorButtonData(intersection.object))
                 .find((data) => data !== null);
             if (!button || button.disabled)

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;AAatF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,cAAc,YA8N1B,CAAA;AA+KD,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,CAY7D;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;AAatF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,cAAc,YA8N1B,CAAA;eA+Kc,cAAc;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,CAY7D;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/interactive/control-widget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"control-widget.d.ts","sourceRoot":"","sources":["../../../src/systems/interactive/control-widget.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAE7D;;8EAE8E;AAC9E,eAAO,MAAM,aAAa,GAAI,+BAI3B;IACD,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,YAAY,CAAA;IACnB,QAAQ,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,CAAA;CACpC,uCAuEA,CAAA"}
+{"version":3,"file":"control-widget.d.ts","sourceRoot":"","sources":["../../../src/systems/interactive/control-widget.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAE7D;;8EAE8E;AAC9E,eAAO,MAAM,aAAa,kCAIvB;IACD,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,YAAY,CAAA;IACnB,QAAQ,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,CAAA;CACpC,uCAuEA,CAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"interactive-system.d.ts","sourceRoot":"","sources":["../../../src/systems/interactive/interactive-system.tsx"],"names":[],"mappings":"AAmCA,eAAO,MAAM,iBAAiB,mCAmC7B,CAAA"}
+{"version":3,"file":"interactive-system.d.ts","sourceRoot":"","sources":["../../../src/systems/interactive/interactive-system.tsx"],"names":[],"mappings":"AAwCA,eAAO,MAAM,iBAAiB,mCAoC7B,CAAA"}

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

@@ -1,6 +1,6 @@
 'use client';
-import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
-import { pointInPolygon, sceneRegistry, useInteractive, useScene, } from '@pascal-app/core';
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { isScriptedNode, pointInPolygon, sceneRegistry, scriptedOrigin, scriptedSize, scriptInteractive, useInteractive, useScene, } from '@pascal-app/core';
 import { evaluateRecipe, operableParts, } from '@pascal-app/core/procedural-items';
 import { Html } from '@react-three/drei';
 import { createPortal, useFrame } from '@react-three/fiber';
@@ -29,7 +29,8 @@ export const InteractiveSystem = () => {
         return z?.polygon ?? null;
     });
     const interactiveNodeIds = useScene(useShallow((state) => Object.values(state.nodes)
-        .filter((n) => (n.type === 'item' && n.asset.interactive != null) ||
+        .filter((n) => (isScriptedNode(n) && scriptInteractive(n.source.manifest) != null) ||
+        (n.type === 'item' && n.asset.interactive != null) ||
         (n.type === 'procedural-item' &&
             (operableParts(n.recipe).length > 0 || n.recipe.parts.some((part) => part.light))))
         .map((n) => n.id)));
@@ -61,14 +62,23 @@ const ItemControlsOverlay = ({ nodeId, zonePolygon, isSelected, }) => {
     ]);
     let descriptors = [];
     let height = 0;
-    if (node?.type === 'item' && node.asset.interactive && controlValues) {
-        descriptors = node.asset.interactive.controls.map((control, i) => ({
+    const interactive = isScriptedNode(node)
+        ? scriptInteractive(node.source.manifest, scriptedOrigin(node))
+        : node?.type === 'item'
+            ? node.asset.interactive
+            : undefined;
+    if (interactive && controlValues) {
+        descriptors = interactive.controls.map((control, i) => ({
             key: String(i),
             control,
             value: controlValues[i] ?? false,
             onChange: (value) => setControlValue(nodeId, i, value),
         }));
-        height = node.asset.dimensions[1];
+        height = isScriptedNode(node)
+            ? scriptedSize(node.source.manifest)[1] + scriptedOrigin(node)[1]
+            : node?.type === 'item'
+                ? node.asset.dimensions[1]
+                : 0;
     }
     else if (node?.type === 'procedural-item') {
         descriptors = proceduralControlDescriptors(node.recipe, proceduralState, (partId) => togglePart(nodeId, partId), () => toggleLights(nodeId), lampDefault);

package/dist/systems/interactive/scripted-clips.js

@@ -1,5 +1,5 @@
 'use client';
-import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
 import { useInteractive, } from '@pascal-app/core';
 import { useFrame } from '@react-three/fiber';
 import { useEffect, useLayoutEffect, useMemo, useRef } from 'react';

package/dist/systems/item-light/item-light-system.js

@@ -1,4 +1,4 @@
-import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
 import { findLevelAncestorId, sceneRegistry, useScene } from '@pascal-app/core';
 import { useFrame, useThree } from '@react-three/fiber';
 import { useRef } from 'react';

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

@@ -0,0 +1,4 @@
+export declare const setHeldLevelY: (levelId: string, y: number) => void;
+export declare const heldLevelY: (levelId: string) => number | undefined;
+export declare const releaseLevel: (levelId: string) => void;
+//# sourceMappingURL=level-hold.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"level-hold.d.ts","sourceRoot":"","sources":["../../../src/systems/level/level-hold.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,aAAa,YAAa,MAAM,KAAK,MAAM,SAEvD,CAAA;AAED,eAAO,MAAM,UAAU,YAAa,MAAM,KAAG,MAAM,GAAG,SAA+B,CAAA;AAErF,eAAO,MAAM,YAAY,YAAa,MAAM,SAE3C,CAAA"}

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

@@ -0,0 +1,14 @@
+/**
+ * Levels a construction reveal presents at a height of its own: the levels above a floor being taken
+ * apart stay where they stood until it has gone, then the reveal brings them down onto what is below,
+ * writing the height every frame. `LevelSystem` reads `heldLevelY` ahead of the stacked elevation, so a
+ * held level is neither lerped nor snapped. Presentation only: no scene write.
+ */
+const heldY = new Map();
+export const setHeldLevelY = (levelId, y) => {
+    heldY.set(levelId, y);
+};
+export const heldLevelY = (levelId) => heldY.get(levelId);
+export const releaseLevel = (levelId) => {
+    heldY.delete(levelId);
+};

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":"AAQA,eAAO,MAAM,WAAW,YA+DvB,CAAA"}
+{"version":3,"file":"level-system.d.ts","sourceRoot":"","sources":["../../../src/systems/level/level-system.tsx"],"names":[],"mappings":"AAWA,eAAO,MAAM,WAAW,YAyEvB,CAAA"}

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

@@ -3,14 +3,17 @@ 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';
+import { heldLevelY } from './level-hold';
 import { EXPLODED_GAP, resolveLevelVisibility } from './level-utils';
 import { shadowOnlyLevels } from './shadow-only-levels';
+const placed = new WeakSet();
 export const LevelSystem = () => {
     useFrame((_, delta) => {
         const nodes = useScene.getState().nodes;
         const levelMode = useViewer.getState().levelMode;
         const hideAbove = useViewer.getState().hideLevelsAboveSelection;
         const selectedLevel = useViewer.getState().selection.levelId;
+        const levelsRevealing = useViewer.getState().levelsRevealing;
         const levelElevations = getLevelElevations(nodes);
         const entries = [];
         sceneRegistry.byType.level.forEach((levelId) => {
@@ -24,6 +27,10 @@ export const LevelSystem = () => {
                 });
             }
         });
+        // A level that has just mounted (a restored floor, a new storey) cuts every level to its height
+        // together: sliding them from where they were would run the floor and the levels above through
+        // each other.
+        const appeared = entries.some(({ obj }) => !placed.has(obj));
         const selectedIndex = selectedLevel
             ? entries.find((e) => e.levelId === selectedLevel)?.index
             : undefined;
@@ -38,7 +45,14 @@ export const LevelSystem = () => {
             // 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));
+            const held = heldLevelY(levelId);
+            if (held !== undefined)
+                obj.position.y = held;
+            else if (appeared)
+                obj.position.y = targetY;
+            else
+                obj.position.y = lerp(obj.position.y, targetY, Math.min(1, delta * 12));
+            placed.add(obj);
             const { visible, shadowOnly } = resolveLevelVisibility({
                 levelMode,
                 hideAbove,
@@ -47,6 +61,7 @@ export const LevelSystem = () => {
                 index,
                 selectedIndex,
                 nodeVisible: level?.visible !== false,
+                revealing: levelsRevealing.includes(levelId),
             });
             if (shadowOnly) {
                 applyShadowOnly(obj);

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

@@ -1,4 +1,5 @@
-export declare const EXPLODED_GAP = 5;
+import { type SceneViewPresentation } from '@pascal-app/core/agent-operations';
+export { EXPLODED_GAP } from '@pascal-app/core';
 /**
  * The Y a level settles at under the given presentation mode — its stacked
  * elevation plus the exploded gap. Analytic (scene store + mode), never a
@@ -19,8 +20,12 @@ export declare function getLevelPresentationY(levelId: string, nodes: Record<str
  * shadow map so the sun still shadows the selected floor through them.
  * A level the author hid never enters that shadow-caster branch: its shadows
  * on the floor below would be exactly what hiding it was meant to remove.
+ *
+ * A level a construction reveal is playing on (`revealing`) shows whatever the
+ * presentation hides, so the animation is seen; only the author's own hiding
+ * keeps it out.
  */
-export declare function resolveLevelVisibility({ levelMode, hideAbove, hasSelectedLevel, isSelected, index, selectedIndex, nodeVisible, }: {
+export declare function resolveLevelVisibility({ levelMode, hideAbove, hasSelectedLevel, isSelected, index, selectedIndex, nodeVisible, revealing, }: {
     levelMode: 'stacked' | 'exploded' | 'solo' | 'manual';
     hideAbove: boolean;
     hasSelectedLevel: boolean;
@@ -28,6 +33,7 @@ export declare function resolveLevelVisibility({ levelMode, hideAbove, hasSelect
     index: number;
     selectedIndex: number | undefined;
     nodeVisible: boolean;
+    revealing: boolean;
 }): {
     visible: boolean;
     shadowOnly: boolean;
@@ -46,5 +52,9 @@ export declare function resolveLevelVisibility({ levelMode, hideAbove, hasSelect
  *   renderer.render(scene, camera)
  *   restore()
  */
-export declare function snapLevelsToTruePositions(): () => void;
+export declare function snapLevelsToTruePositions({ readOnly, }?: {
+    readOnly?: boolean;
+}): () => void;
+/** The viewer's settled level presentation for one render, without changing saved preferences. */
+export declare function presentLevelsForCapture(presentation: SceneViewPresentation): () => void;
 //# sourceMappingURL=level-utils.d.ts.map

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":"AAIA,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;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,KAAK,EACL,aAAa,EACb,WAAW,GACZ,EAAE;IACD,SAAS,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAA;IACrD,SAAS,EAAE,OAAO,CAAA;IAClB,gBAAgB,EAAE,OAAO,CAAA;IACzB,UAAU,EAAE,OAAO,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,aAAa,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,WAAW,EAAE,OAAO,CAAA;CACrB,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAQ5C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,IAAI,CA+CtD"}
+{"version":3,"file":"level-utils.d.ts","sourceRoot":"","sources":["../../../src/systems/level/level-utils.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,KAAK,qBAAqB,EAE3B,MAAM,mCAAmC,CAAA;AAS1C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAE/C;;;;;;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;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,KAAK,EACL,aAAa,EACb,WAAW,EACX,SAAS,GACV,EAAE;IACD,SAAS,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAA;IACrD,SAAS,EAAE,OAAO,CAAA;IAClB,gBAAgB,EAAE,OAAO,CAAA;IACzB,UAAU,EAAE,OAAO,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,aAAa,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,WAAW,EAAE,OAAO,CAAA;IACpB,SAAS,EAAE,OAAO,CAAA;CACnB,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAS5C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CAAC,EACxC,QAAgB,GACjB,GAAE;IACD,QAAQ,CAAC,EAAE,OAAO,CAAA;CACd,GAAG,MAAM,IAAI,CAiDlB;AAED,kGAAkG;AAClG,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,qBAAqB,GAAG,MAAM,IAAI,CAiCvF"}

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

@@ -1,7 +1,9 @@
-import { getLevelElevations, sceneRegistry, useScene } from '@pascal-app/core';
+import { EXPLODED_GAP, getLevelElevations, sceneRegistry, useScene, } from '@pascal-app/core';
+import { sceneViewPresentationLevel, } from '@pascal-app/core/agent-operations';
+import { temporarilyHideFromScene, temporarilyShowPresentation, temporarilyShowShadowOnly, } from '../../lib/scene-visibility';
 import { applyShadowOnly, clearShadowOnly } from '../../lib/shadow-only';
 import { shadowOnlyLevels } from './shadow-only-levels';
-export const EXPLODED_GAP = 5;
+export { EXPLODED_GAP } from '@pascal-app/core';
 /**
  * The Y a level settles at under the given presentation mode — its stacked
  * elevation plus the exploded gap. Analytic (scene store + mode), never a
@@ -27,10 +29,16 @@ export function getLevelPresentationY(levelId, nodes, levelMode) {
  * shadow map so the sun still shadows the selected floor through them.
  * A level the author hid never enters that shadow-caster branch: its shadows
  * on the floor below would be exactly what hiding it was meant to remove.
+ *
+ * A level a construction reveal is playing on (`revealing`) shows whatever the
+ * presentation hides, so the animation is seen; only the author's own hiding
+ * keeps it out.
  */
-export function resolveLevelVisibility({ levelMode, hideAbove, hasSelectedLevel, isSelected, index, selectedIndex, nodeVisible, }) {
+export function resolveLevelVisibility({ levelMode, hideAbove, hasSelectedLevel, isSelected, index, selectedIndex, nodeVisible, revealing, }) {
     if (!nodeVisible)
         return { visible: false, shadowOnly: false };
+    if (revealing)
+        return { visible: true, shadowOnly: false };
     const hidden = (levelMode === 'solo' && hasSelectedLevel && !isSelected) ||
         (hideAbove && selectedIndex !== undefined && index > selectedIndex);
     const shadowOnly = hidden && selectedIndex !== undefined && index > selectedIndex;
@@ -50,7 +58,7 @@ export function resolveLevelVisibility({ levelMode, hideAbove, hasSelectedLevel,
  *   renderer.render(scene, camera)
  *   restore()
  */
-export function snapLevelsToTruePositions() {
+export function snapLevelsToTruePositions({ readOnly = false, } = {}) {
     const nodes = useScene.getState().nodes;
     const entries = [];
     sceneRegistry.byType.level.forEach((levelId) => {
@@ -74,8 +82,10 @@ export function snapLevelsToTruePositions() {
         obj.position.y = levelElevations.get(levelId)?.baseY ?? 0;
         obj.visible = nodeVisible;
     }
-    for (const { obj } of shadowOnly)
-        clearShadowOnly(obj);
+    const restoreMasks = readOnly ? shadowOnly.map(({ obj }) => temporarilyShowShadowOnly(obj)) : [];
+    if (!readOnly)
+        for (const { obj } of shadowOnly)
+            clearShadowOnly(obj);
     return () => {
         for (const { levelId, obj } of entries) {
             const saved = snapshot.get(levelId);
@@ -84,7 +94,45 @@ export function snapLevelsToTruePositions() {
                 obj.visible = saved.visible;
             }
         }
-        for (const { obj } of shadowOnly)
-            applyShadowOnly(obj);
+        if (readOnly)
+            for (const restore of restoreMasks.reverse())
+                restore();
+        else
+            for (const { obj } of shadowOnly)
+                applyShadowOnly(obj);
+    };
+}
+/** The viewer's settled level presentation for one render, without changing saved preferences. */
+export function presentLevelsForCapture(presentation) {
+    const nodes = useScene.getState().nodes;
+    const selected = sceneViewPresentationLevel(nodes, presentation);
+    if (selected &&
+        (!sceneRegistry.nodes.has(selected.id) || !sceneRegistry.byType.level?.has(selected.id)))
+        throw new Error('The level to capture is not ready in this renderer. Try again.');
+    const restores = [snapLevelsToTruePositions({ readOnly: true })];
+    for (const levelId of sceneRegistry.byType.level ?? []) {
+        const obj = sceneRegistry.nodes.get(levelId);
+        const level = nodes[levelId];
+        if (!obj || level?.type !== 'level')
+            continue;
+        obj.position.y = getLevelPresentationY(levelId, nodes, presentation.mode);
+        const { visible, shadowOnly } = resolveLevelVisibility({
+            levelMode: presentation.mode,
+            hideAbove: false,
+            hasSelectedLevel: Boolean(selected),
+            isSelected: level.id === selected?.id,
+            index: level.level,
+            selectedIndex: selected?.type === 'level' ? selected.level : undefined,
+            nodeVisible: level.visible !== false,
+            revealing: false,
+        });
+        obj.visible = visible;
+        restores.push(level.id === selected?.id ? temporarilyShowPresentation(obj) : temporarilyShowShadowOnly(obj));
+        if (shadowOnly)
+            restores.push(temporarilyHideFromScene(obj, 'shadow-only'));
+    }
+    return () => {
+        for (const restore of restores.reverse())
+            restore();
     };
 }

package/dist/systems/roof/__fixtures__/roof-plane-cases.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Every roof the hosted Architect plugin's `hip_roof_planes` and `gable_roof_planes` built, each
+ * beside the `roof_segment_add` call that covers it and the roof segment that call writes, so the
+ * two plane tools can retire into it (catalogue slice R). No stored thread called either tool, so
+ * the cases are what their contracts take (both ridge axes, a hip either way and square, the
+ * default, wide, flush and wider-than-the-eaves gable overhangs, a thickness, an eave on the plate,
+ * over it and on posts) and the plugin's own call (a hip at the walls' 2.6 m tops).
+ *
+ * The plane tools took the rectangle of the walls' outside faces, a rise per 12, the overhang past
+ * those faces in metres (a gable's ends their own), a thickness square to the slope (0.29 m by
+ * default) and an eave height that was the roof's SURFACE at the outside wall face. The segment
+ * takes the same rectangle (`rectAt: 'outside'`), the pitch, the overhangs and the thickness in
+ * any unit, and an eave that is the plate it bears on, its default the walls' tops; the walls'
+ * thickness, which it reads from the walls along those faces (6.5 in where none stand, a porch on
+ * posts), puts their centre lines inside the faces.
+ *
+ * A plane call whose roof stood on its walls, or over them, is the same roof as a segment: same
+ * outline, surface, ridge and thickness (`lift` 0).
+ *
+ * Not reproduced, on purpose (no stored call made either, so each is a call a model could make):
+ * - A plane call with its eave at the walls' tops, the plugin's own and the likeliest, sank its roof
+ *   into them: its slab's underside stood `thickness / cos(pitch)` under the plate at the wall face.
+ *   A segment is never sunk under the walls it sits on (`eave_under_walls`); the replacement leaves
+ *   the eave out and the roof sits on them, the same outline, pitch and thickness, its surface
+ *   `lift` higher. Those rows say so.
+ * - Planes over a storey with another over it stood inside that storey; a segment refuses that
+ *   (`into_storey_above`). The hosted table checks the refusal.
+ * - The plane tools answered each plane's id, so one slope could be edited or painted on its own
+ *   (`update_roof_plane`). A segment is one mass whose slopes change together; one slope on its own
+ *   is `create_roof_plane`'s, which stays, and the retired tools' answer says so.
+ *
+ * The viewer runs the segments through the roof geometry against the planes' own geometry
+ * (`roof-plane-cases.test.ts`); the hosted plugin runs each replacement call through
+ * `roof_segment_add` and reads back the segment it wrote.
+ */
+type Rect = [number, number, number, number];
+/** The walls' thickness, a 2x6 wall finished: what `roof_segment_add` reads from them. */
+export declare const ROOF_PLANE_WALL_THICKNESS: number;
+/** The covering a segment lays over its deck, in the thickness the plane tools took whole. */
+export declare const ROOF_PLANE_COVERING = 0.02;
+export type RoofPlaneCall = {
+    tool: 'hip_roof_planes' | 'gable_roof_planes';
+    rect: Rect;
+    ridgeAxis?: 'x' | 'z';
+    /** Rise per 12. */
+    pitch: number;
+    /** The roof's surface at the outside wall face, metres above the storey's floor. */
+    eaveHeight: number;
+    overhang?: number;
+    gableOverhang?: number;
+    thickness?: number;
+    name?: string;
+};
+export type RoofSegmentAddCall = {
+    roofType: 'hip' | 'gable';
+    name: string;
+    rect: Rect;
+    rectAt: 'outside';
+    ridgeAxis: 'x' | 'z';
+    pitchTwelfths: number;
+    overhangIn: string;
+    gableOverhangIn?: string;
+    thicknessIn: string;
+    eaveHeight?: number;
+};
+/** The segment a replacement call writes, in its storey's plan and metres. */
+export type ExpectedRoofSegment = {
+    roofType: 'hip' | 'gable';
+    name: string;
+    /** The centre of its wall centre-line rectangle. */
+    centre: [number, number];
+    /** Along its ridge axis and across it, at the wall centre lines. */
+    width: number;
+    depth: number;
+    rotation: number;
+    /** Degrees. */
+    pitch: number;
+    /** Along the slope, as the node stores it. */
+    overhang: number;
+    /** In plan past the gable-end walls' outside faces; none on a hip. */
+    gableOverhang?: number;
+    wallThickness: number;
+    deckThickness: number;
+    shingleThickness: number;
+    /** The plate it bears on, metres above the storey's floor. */
+    eave: number;
+};
+export type RoofPlaneCase = {
+    name: string;
+    /** The walls under the roof: their outside faces and how tall they stand (none: posts). */
+    walls: {
+        rect: Rect;
+        height: number;
+    } | null;
+    call: RoofPlaneCall;
+    replacement: RoofSegmentAddCall;
+    segment: ExpectedRoofSegment;
+    /** How far the segment's surface stands over the planes' (0: the same roof). */
+    lift: number;
+};
+export declare const ROOF_PLANE_CASES: readonly RoofPlaneCase[];
+export {};
+//# sourceMappingURL=roof-plane-cases.d.ts.map

package/dist/systems/roof/__fixtures__/roof-plane-cases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roof-plane-cases.d.ts","sourceRoot":"","sources":["../../../../src/systems/roof/__fixtures__/roof-plane-cases.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAG5C,0FAA0F;AAC1F,eAAO,MAAM,yBAAyB,QAAW,CAAA;AACjD,8FAA8F;AAC9F,eAAO,MAAM,mBAAmB,OAAO,CAAA;AAMvC,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,iBAAiB,GAAG,mBAAmB,CAAA;IAC7C,IAAI,EAAE,IAAI,CAAA;IACV,SAAS,CAAC,EAAE,GAAG,GAAG,GAAG,CAAA;IACrB,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,oFAAoF;IACpF,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,KAAK,GAAG,OAAO,CAAA;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,IAAI,CAAA;IACV,MAAM,EAAE,SAAS,CAAA;IACjB,SAAS,EAAE,GAAG,GAAG,GAAG,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,8EAA8E;AAC9E,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,KAAK,GAAG,OAAO,CAAA;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,oDAAoD;IACpD,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxB,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe;IACf,KAAK,EAAE,MAAM,CAAA;IACb,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAA;IAChB,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,gBAAgB,EAAE,MAAM,CAAA;IACxB,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,2FAA2F;IAC3F,KAAK,EAAE;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IAC5C,IAAI,EAAE,aAAa,CAAA;IACnB,WAAW,EAAE,kBAAkB,CAAA;IAC/B,OAAO,EAAE,mBAAmB,CAAA;IAC5B,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AA0ED,eAAO,MAAM,gBAAgB,EAAE,SAAS,aAAa,EAsRpD,CAAA"}