@pascal-app/viewer 1.0.3 → 1.0.4

package/dist/lib/materials.d.ts

@@ -13,6 +13,8 @@ export declare const glassMaterial: MeshLambertNodeMaterial;
 export declare function getMaterialTextureVersion(): number;
 export declare function resolveTextureRepeat(repeat: unknown, scale: unknown): [number, number];
 export declare function getTextureKey(material?: MaterialSchema): string;
+/** Glass lets light through; shadow maps would otherwise treat it as a solid panel. */
+export declare function materialCastsShadow(material: THREE.Material | THREE.Material[]): boolean;
 export declare function applyMaterialPresetToMaterials(materialInput: THREE.Material | THREE.Material[], preset: MaterialPresetPayload | null | undefined): void;
 export declare function createMaterialFromPreset(preset: MaterialPresetPayload, shading?: RenderShading): THREE.Material;
 export declare function createMaterialFromPresetRef(materialPreset?: string, shading?: RenderShading): THREE.Material | null;
@@ -26,17 +28,22 @@ export declare function createMaterial(material?: MaterialSchema, shading?: Rend
  */
 export declare function materialPresetRefSignature(ref: string): string;
 /**
- * Resolve a MaterialRef ('library:<id>' | 'scene:<id>') to a three.js material.
- * Returns null for an unknown / dangling ref so callers fall back to the
- * slot's default (authored material, then themed default). Never throws.
+ * Resolve a MaterialRef ('library:<id>' | 'scene:<id>') or a plain '#rrggbb'
+ * colour to a three.js material; the colour paints like
+ * `material: { properties: { color } }`. Returns null for an unknown / dangling
+ * ref so callers fall back to the slot's default (authored material, then
+ * themed default). Never throws.
  */
 export declare function resolveMaterialRef(ref: string | undefined, sceneMaterials: Record<SceneMaterialId, SceneMaterial> | undefined, shading?: RenderShading): THREE.Material | null;
 /**
- * Resolve a node kind's declared slot default — either a catalog `library:<id>`
- * finish or a flat `#rrggbb` colour — to a renderable material. Shared by the
- * procedural kinds whose colored-mode unpainted appearance comes from a
- * declarative default (slab, wall).
+ * Swaps declared slot DEFAULTS (never painted refs) for another finish, e.g.
+ * the worker thumbnail renders unpainted walls as plaster instead of the
+ * prepared-drywall default. Must be set before the scene builds its
+ * materials; `null` restores the declared defaults.
  */
+export declare function setSlotDefaultOverrides(overrides: Readonly<Record<string, string>> | null): void;
+/** A declared slot default after `setSlotDefaultOverrides`. */
+export declare function resolveSlotDefaultRef(slotDefault: string): string;
 export declare function resolveSlotDefaultMaterial(slotDefault: string, shading?: RenderShading, roughness?: number): THREE.Material;
 export declare function createDefaultMaterial(color?: string, roughness?: number, shading?: RenderShading, side?: THREE.Side): THREE.Material;
 export declare function createSurfaceRoleMaterial(role: SurfaceRole, preset: ColorPreset, side?: THREE.Side, sceneThemeId?: string): THREE.Material;

package/dist/lib/materials.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"materials.d.ts","sourceRoot":"","sources":["../../src/lib/materials.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"materials.d.ts","sourceRoot":"","sources":["../../src/lib/materials.ts"],"names":[],"mappings":"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"}

package/dist/lib/materials.js

@@ -1,4 +1,4 @@
-import { getMaterialPresetByRef, parseMaterialRef, resolveMaterial, } from '@pascal-app/core';
+import { getMaterialPresetByRef, materialColorPaint, parseMaterialColor, parseMaterialRef, resolveMaterial, } from '@pascal-app/core';
 import { addAfterEffect, invalidate } from '@react-three/fiber';
 import * as THREE from 'three';
 import { float, mix, positionViewDirection, transformedNormalView } from 'three/tsl';
@@ -346,6 +346,12 @@ function applyMaterialMapProperties(material, mapProperties) {
 // Glass-like transparency threshold: any standard material authored as
 // `transparent` with opacity below this gets the fresnel treatment.
 const GLASS_OPACITY_THRESHOLD = 0.6;
+/** Glass lets light through; shadow maps would otherwise treat it as a solid panel. */
+export function materialCastsShadow(material) {
+    const materials = Array.isArray(material) ? material : [material];
+    return !materials.some((entry) => entry.transmission > 0 ||
+        (entry.transparent && entry.opacity < GLASS_OPACITY_THRESHOLD));
+}
 /**
  * Fresnel-driven opacity for glass: nearly the authored opacity head-on,
  * increasingly opaque (showing the environment reflection) at grazing angles.
@@ -446,14 +452,19 @@ export function createMaterial(material, shading = 'rendered') {
  * the dangling-ref fallback for the whole session.
  */
 export function materialPresetRefSignature(ref) {
-    return getMaterialPresetByRef(ref) ? ref : `${ref}#unresolved`;
+    return getMaterialPresetByRef(ref) || parseMaterialColor(ref) ? ref : `${ref}#unresolved`;
 }
 /**
- * Resolve a MaterialRef ('library:<id>' | 'scene:<id>') to a three.js material.
- * Returns null for an unknown / dangling ref so callers fall back to the
- * slot's default (authored material, then themed default). Never throws.
+ * Resolve a MaterialRef ('library:<id>' | 'scene:<id>') or a plain '#rrggbb'
+ * colour to a three.js material; the colour paints like
+ * `material: { properties: { color } }`. Returns null for an unknown / dangling
+ * ref so callers fall back to the slot's default (authored material, then
+ * themed default). Never throws.
  */
 export function resolveMaterialRef(ref, sceneMaterials, shading = 'rendered') {
+    const color = parseMaterialColor(ref);
+    if (color)
+        return createMaterial(materialColorPaint(color), shading);
     const parsed = parseMaterialRef(ref);
     if (!parsed)
         return null;
@@ -470,7 +481,22 @@ export function resolveMaterialRef(ref, sceneMaterials, shading = 'rendered') {
  * procedural kinds whose colored-mode unpainted appearance comes from a
  * declarative default (slab, wall).
  */
+let slotDefaultOverrides = null;
+/**
+ * Swaps declared slot DEFAULTS (never painted refs) for another finish, e.g.
+ * the worker thumbnail renders unpainted walls as plaster instead of the
+ * prepared-drywall default. Must be set before the scene builds its
+ * materials; `null` restores the declared defaults.
+ */
+export function setSlotDefaultOverrides(overrides) {
+    slotDefaultOverrides = overrides;
+}
+/** A declared slot default after `setSlotDefaultOverrides`. */
+export function resolveSlotDefaultRef(slotDefault) {
+    return slotDefaultOverrides?.[slotDefault] ?? slotDefault;
+}
 export function resolveSlotDefaultMaterial(slotDefault, shading = 'rendered', roughness = 0.9) {
+    slotDefault = resolveSlotDefaultRef(slotDefault);
     if (parseMaterialRef(slotDefault)?.kind === 'library') {
         return (createMaterialFromPresetRef(slotDefault, shading) ??
             cachedDefaultMaterial(`slot-#ffffff-${roughness}`, '#ffffff', roughness, shading));

package/dist/lib/node-top-surface-height.d.ts

@@ -0,0 +1,6 @@
+import { type AnyNodeId } from '@pascal-app/core';
+type HeightSampler = (x: number, z: number) => number | null;
+/** Samples one locked node's upward-facing mesh in level-local coordinates. */
+export declare function createNodeTopSurfaceHeightSampler(hostId: AnyNodeId, levelId: AnyNodeId): HeightSampler | null;
+export {};
+//# sourceMappingURL=node-top-surface-height.d.ts.map

package/dist/lib/node-top-surface-height.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-top-surface-height.d.ts","sourceRoot":"","sources":["../../src/lib/node-top-surface-height.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAiB,MAAM,kBAAkB,CAAA;AAKhE,KAAK,aAAa,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAA;AAS5D,+EAA+E;AAC/E,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,SAAS,GACjB,aAAa,GAAG,IAAI,CAqEtB"}

package/dist/lib/node-top-surface-height.js

@@ -0,0 +1,74 @@
+import { sceneRegistry } from '@pascal-app/core';
+import { Box3, Matrix3, Raycaster, Vector3 } from 'three';
+import useViewer from '../store/use-viewer';
+import { setSurfaceRaycastLayers } from './layers';
+const samplerCache = new WeakMap();
+/** Samples one locked node's upward-facing mesh in level-local coordinates. */
+export function createNodeTopSurfaceHeightSampler(hostId, levelId) {
+    const host = sceneRegistry.nodes.get(hostId);
+    const level = sceneRegistry.nodes.get(levelId);
+    if (!(host && level))
+        return null;
+    host.updateWorldMatrix(true, false);
+    level.updateWorldMatrix(true, false);
+    const revision = useViewer.getState().geometryRevision;
+    const cached = samplerCache.get(host)?.get(level);
+    if (cached?.revision === revision &&
+        cached.hostMatrix.every((value, index) => value === host.matrixWorld.elements[index]) &&
+        cached.levelMatrix.every((value, index) => value === level.matrixWorld.elements[index])) {
+        return cached.sample;
+    }
+    host.updateWorldMatrix(true, true);
+    const bounds = new Box3().setFromObject(host);
+    if (bounds.isEmpty())
+        return null;
+    const raycaster = new Raycaster();
+    setSurfaceRaycastLayers(raycaster.layers);
+    raycaster.far = Math.max(4, bounds.max.y - bounds.min.y + 4);
+    const origin = new Vector3();
+    const direction = new Vector3(0, -1, 0);
+    const normal = new Vector3();
+    const normalMatrix = new Matrix3();
+    const registeredRoots = new Set(sceneRegistry.nodes.values());
+    const sample = (x, z) => {
+        origin.set(x, 0, z);
+        level.localToWorld(origin);
+        origin.y = bounds.max.y + 2;
+        raycaster.set(origin, direction);
+        for (const hit of raycaster.intersectObject(host, true)) {
+            if (!hit.face)
+                continue;
+            let owner = hit.object.parent;
+            let nestedNode = false;
+            while (owner && owner !== host) {
+                if (registeredRoots.has(owner)) {
+                    nestedNode = true;
+                    break;
+                }
+                owner = owner.parent;
+            }
+            if (nestedNode)
+                continue;
+            normalMatrix.getNormalMatrix(hit.object.matrixWorld);
+            normal.copy(hit.face.normal).applyMatrix3(normalMatrix).normalize();
+            if (normal.y < 0.1)
+                continue;
+            const point = hit.point.clone();
+            level.worldToLocal(point);
+            return point.y;
+        }
+        return null;
+    };
+    let byLevel = samplerCache.get(host);
+    if (!byLevel) {
+        byLevel = new WeakMap();
+        samplerCache.set(host, byLevel);
+    }
+    byLevel.set(level, {
+        revision,
+        hostMatrix: [...host.matrixWorld.elements],
+        levelMatrix: [...level.matrixWorld.elements],
+        sample,
+    });
+    return sample;
+}

package/dist/lib/perf-probe-state.d.ts

@@ -0,0 +1,39 @@
+type TemporalLike = {
+    temporal: {
+        getState(): {
+            pastStates: readonly unknown[];
+            futureStates: readonly unknown[];
+            isTracking: boolean;
+        };
+    };
+};
+type SelectionLike = {
+    getState(): {
+        selection: {
+            buildingId: string | null;
+            levelId: string | null;
+            zoneId: string | null;
+            selectedIds: readonly string[];
+        };
+    };
+};
+export type PerfHistoryState = {
+    /** Undo entries. */
+    past: number;
+    /** Redo entries. */
+    future: number;
+    /** False while any owner has history paused. */
+    tracking: boolean;
+    /** Refcounted pause owners (`pauseSceneHistory` + leases); direct `temporal.pause()` is not counted. */
+    pauseDepth: number;
+};
+export type PerfSelectionState = {
+    buildingId: string | null;
+    levelId: string | null;
+    zoneId: string | null;
+    selectedIds: string[];
+};
+export declare function readPerfHistory(store: TemporalLike): PerfHistoryState;
+export declare function readPerfSelection(store: SelectionLike): PerfSelectionState;
+export {};
+//# sourceMappingURL=perf-probe-state.d.ts.map

package/dist/lib/perf-probe-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"perf-probe-state.d.ts","sourceRoot":"","sources":["../../src/lib/perf-probe-state.ts"],"names":[],"mappings":"AAMA,KAAK,YAAY,GAAG;IAClB,QAAQ,EAAE;QACR,QAAQ,IAAI;YACV,UAAU,EAAE,SAAS,OAAO,EAAE,CAAA;YAC9B,YAAY,EAAE,SAAS,OAAO,EAAE,CAAA;YAChC,UAAU,EAAE,OAAO,CAAA;SACpB,CAAA;KACF,CAAA;CACF,CAAA;AAED,KAAK,aAAa,GAAG;IACnB,QAAQ,IAAI;QACV,SAAS,EAAE;YACT,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;YACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;YACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;YACrB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;SAC/B,CAAA;KACF,CAAA;CACF,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,gDAAgD;IAChD,QAAQ,EAAE,OAAO,CAAA;IACjB,wGAAwG;IACxG,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,WAAW,EAAE,MAAM,EAAE,CAAA;CACtB,CAAA;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,gBAAgB,CAQrE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,kBAAkB,CAG1E"}

package/dist/lib/perf-probe-state.js

@@ -0,0 +1,17 @@
+// Read-only state for scripted `?perf` receipts (bench/next-house, scripts/perf): the scene
+// history and the viewer selection, so production builds can report undo entries and
+// history pauses without dev-only store handles.
+import { getSceneHistoryPauseDepth } from '@pascal-app/core';
+export function readPerfHistory(store) {
+    const temporal = store.temporal.getState();
+    return {
+        past: temporal.pastStates.length,
+        future: temporal.futureStates.length,
+        tracking: temporal.isTracking,
+        pauseDepth: getSceneHistoryPauseDepth(),
+    };
+}
+export function readPerfSelection(store) {
+    const { buildingId, levelId, zoneId, selectedIds } = store.getState().selection;
+    return { buildingId, levelId, zoneId, selectedIds: [...selectedIds] };
+}

package/dist/lib/pointer-events.d.ts

@@ -3,5 +3,13 @@ import * as THREE from 'three';
 /** Opt in only when the raycast appends hits without reading prior hits or mutating scene/query state. */
 export declare function markPureRaycast<T extends THREE.Object3D['raycast']>(raycast: T): T;
 export declare function choosePointerEvents(search?: string): typeof createWebEvents;
+/**
+ * Whether a mesh has a material for everything a raycast reads: three indexes
+ * a material array by each geometry group, and one with no entry throws on
+ * `material.side`. A mesh caught mid-swap (a preview restored an older array
+ * over a rebuilt geometry) is skipped for this move instead of taking the whole
+ * pointer event down; its children are still tested.
+ */
+export declare function hasMaterialsForGroups(object: THREE.Object3D): boolean;
 export declare function createPascalPointerEvents(store: RootStore): EventManager<HTMLElement>;
 //# sourceMappingURL=pointer-events.d.ts.map

package/dist/lib/pointer-events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pointer-events.d.ts","sourceRoot":"","sources":["../../src/lib/pointer-events.ts"],"names":[],"mappings":"AA6BA,OAAO,EACL,MAAM,IAAI,eAAe,EAGzB,KAAK,YAAY,EAMjB,KAAK,SAAS,EAEf,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAqC9B,0GAA0G;AAC1G,wBAAgB,eAAe,CAAC,CAAC,SAAS,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAGlF;AAYD,wBAAgB,mBAAmB,CACjC,MAAM,SAA8D,GACnE,OAAO,eAAe,CAIxB;AAiLD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,SAAS,GAAG,YAAY,CAAC,WAAW,CAAC,CAmBrF"}
+{"version":3,"file":"pointer-events.d.ts","sourceRoot":"","sources":["../../src/lib/pointer-events.ts"],"names":[],"mappings":"AA6BA,OAAO,EACL,MAAM,IAAI,eAAe,EAGzB,KAAK,YAAY,EAMjB,KAAK,SAAS,EAEf,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAqC9B,0GAA0G;AAC1G,wBAAgB,eAAe,CAAC,CAAC,SAAS,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAGlF;AAYD,wBAAgB,mBAAmB,CACjC,MAAM,SAA8D,GACnE,OAAO,eAAe,CAIxB;AAiED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,GAAG,OAAO,CAUrE;AAkHD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,SAAS,GAAG,YAAY,CAAC,WAAW,CAAC,CAmBrF"}

package/dist/lib/pointer-events.js

@@ -21,8 +21,8 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  *
- * Vendored from R3F 9.6.1:
- * https://raw.githubusercontent.com/pmndrs/react-three-fiber/v9.6.1/packages/fiber/src/core/events.ts
+ * Vendored from R3F 9.8.1:
+ * https://raw.githubusercontent.com/pmndrs/react-three-fiber/v9.8.1/packages/fiber/src/core/events.ts
  * Ray collection is cached; camera-drag moves are throttled before stock dispatch.
  * The throttle is a vendored-manager policy; dev ?stockEvents uses untouched R3F.
  */
@@ -112,6 +112,28 @@ function querySnapshot(raycaster) {
     }
     return snapshot;
 }
+/**
+ * Whether a mesh has a material for everything a raycast reads: three indexes
+ * a material array by each geometry group, and one with no entry throws on
+ * `material.side`. A mesh caught mid-swap (a preview restored an older array
+ * over a rebuilt geometry) is skipped for this move instead of taking the whole
+ * pointer event down; its children are still tested.
+ */
+export function hasMaterialsForGroups(object) {
+    const mesh = object;
+    if (!mesh.isMesh)
+        return true;
+    const material = mesh.material;
+    if (!material)
+        return false;
+    if (!Array.isArray(material))
+        return true;
+    for (const group of mesh.geometry?.groups ?? []) {
+        if (!material[group.materialIndex ?? 0])
+            return false;
+    }
+    return true;
+}
 function distanceOrder(a, b) {
     return a.distance - b.distance;
 }
@@ -140,7 +162,8 @@ function createCachedRaycast() {
                 unsupportedObject = object;
                 return false;
             }
-            result = object.raycast(raycaster, hits);
+            if (hasMaterialsForGroups(object))
+                result = object.raycast(raycaster, hits);
         }
         if (result !== false) {
             const children = object.children;
@@ -246,7 +269,7 @@ export function createPascalPointerEvents(store) {
     return manager;
 }
 function makeId(event) {
-    // biome-ignore lint/style/useTemplate: Keep the vendored dispatch identical to R3F 9.6.1.
+    // biome-ignore lint/style/useTemplate: Keep the vendored dispatch identical to R3F 9.8.1.
     return (event.eventObject || event.object).uuid + '/' + event.index + event.instanceId;
 }
 /**

package/dist/lib/procedural-emission.d.ts

@@ -0,0 +1,7 @@
+import type { EvaluatedLight } from '@pascal-app/core/procedural-items';
+import type { Material, Mesh, Object3D } from 'three';
+export declare function cloneWithProceduralEmission(material: Material, color: string, on: boolean): Material;
+export declare function setProceduralEmission(material: Material, on: boolean): void;
+export declare function proceduralSlotMeshes(root: Object3D, slots: Set<string>): Mesh[];
+export declare function decorateProceduralEmission(root: Object3D, lights: EvaluatedLight[], on: boolean): () => void;
+//# sourceMappingURL=procedural-emission.d.ts.map

package/dist/lib/procedural-emission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedural-emission.d.ts","sourceRoot":"","sources":["../../src/lib/procedural-emission.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAA;AACvE,OAAO,KAAK,EAAS,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAQ5D,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,OAAO,GACV,QAAQ,CAQV;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAG3E;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,CAW/E;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,cAAc,EAAE,EACxB,EAAE,EAAE,OAAO,GACV,MAAM,IAAI,CAwBZ"}

package/dist/lib/procedural-emission.js

@@ -0,0 +1,54 @@
+export function cloneWithProceduralEmission(material, color, on) {
+    const clone = material.clone();
+    clone.userData = { ...clone.userData, __pascalCachedMaterial: false };
+    if (clone.emissive)
+        clone.emissive.set(color);
+    if ('emissiveIntensity' in clone)
+        clone.emissiveIntensity = on ? 1 : 0;
+    if ('emissiveMap' in clone)
+        clone.emissiveMap = null;
+    clone.needsUpdate = true;
+    return clone;
+}
+export function setProceduralEmission(material, on) {
+    const controlled = material;
+    if ('emissiveIntensity' in controlled)
+        controlled.emissiveIntensity = on ? 1 : 0;
+}
+export function proceduralSlotMeshes(root, slots) {
+    const meshes = [];
+    const owner = root.userData.pascalId;
+    const visit = (object) => {
+        if (object !== root && object.userData.pascalId && object.userData.pascalId !== owner)
+            return;
+        const mesh = object;
+        if (mesh.isMesh && slots.has(mesh.userData.slotId))
+            meshes.push(mesh);
+        for (const child of object.children)
+            visit(child);
+    };
+    visit(root);
+    return meshes;
+}
+export function decorateProceduralEmission(root, lights, on) {
+    const colors = new Map(lights.flatMap((light) => light.emissiveSlot ? [[light.emissiveSlot, light.color]] : []));
+    const restores = [];
+    for (const mesh of proceduralSlotMeshes(root, new Set(colors.keys()))) {
+        const slot = mesh.userData.slotId;
+        const color = colors.get(slot);
+        if (!color)
+            continue;
+        const previous = mesh.material;
+        const clones = (Array.isArray(previous) ? previous : [previous]).map((material) => cloneWithProceduralEmission(material, color, on));
+        mesh.material = Array.isArray(previous) ? clones : clones[0];
+        restores.push(() => {
+            mesh.material = previous;
+            for (const clone of clones)
+                clone.dispose();
+        });
+    }
+    return () => {
+        for (const restore of restores)
+            restore();
+    };
+}

package/dist/lib/scene-support-height.d.ts

@@ -0,0 +1,4 @@
+import { type AnyNode, type AnyNodeId } from '@pascal-app/core';
+/** The highest walkable surface at a level-local point, including rendered shaped tops. */
+export declare function createSceneSupportHeightSampler(nodes: Readonly<Record<AnyNodeId, AnyNode>>, levelId: AnyNodeId, selectedHostId?: AnyNodeId): (x: number, z: number) => number;
+//# sourceMappingURL=scene-support-height.d.ts.map

package/dist/lib/scene-support-height.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-support-height.d.ts","sourceRoot":"","sources":["../../src/lib/scene-support-height.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,SAAS,EAIf,MAAM,kBAAkB,CAAA;AAGzB,2FAA2F;AAC3F,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,EAC3C,OAAO,EAAE,SAAS,EAClB,cAAc,CAAC,EAAE,SAAS,GACzB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,CAiClC"}

package/dist/lib/scene-support-height.js

@@ -0,0 +1,34 @@
+import { findLevelAncestorId, levelBaseElevationAt, nodeRegistry, } from '@pascal-app/core';
+import { createNodeTopSurfaceHeightSampler } from './node-top-surface-height';
+/** The highest walkable surface at a level-local point, including rendered shaped tops. */
+export function createSceneSupportHeightSampler(nodes, levelId, selectedHostId) {
+    const supports = Object.values(nodes)
+        .filter((node) => node.visible !== false &&
+        (!selectedHostId || node.id === selectedHostId) &&
+        findLevelAncestorId(node.id, nodes) === levelId &&
+        !!nodeRegistry.get(node.type)?.capabilities.surfaces?.top)
+        .map((node) => {
+        const top = nodeRegistry.get(node.type)?.capabilities.surfaces?.top;
+        const resolveSupportHeight = top?.supportHeight;
+        return {
+            node,
+            resolveDataHeight: resolveSupportHeight
+                ? (x, z) => resolveSupportHeight(node, x, z, { nodes })
+                : null,
+            sampleRenderedHeight: resolveSupportHeight
+                ? null
+                : createNodeTopSurfaceHeightSampler(node.id, levelId),
+        };
+    });
+    return (x, z) => {
+        let height = levelBaseElevationAt(nodes, levelId, x, z);
+        for (const support of supports) {
+            const top = support.resolveDataHeight
+                ? support.resolveDataHeight(x, z)
+                : (support.sampleRenderedHeight?.(x, z) ?? null);
+            if (top !== null)
+                height = Math.max(height, top);
+        }
+        return height;
+    };
+}

package/dist/lib/scene-visibility.d.ts

@@ -12,4 +12,10 @@ export declare function hideFromScene(obj: Object3D, reason: HiddenReason): void
 /** Drops `reason`, restoring the mask `obj` had before the first one arrived. */
 export declare function showInScene(obj: Object3D, reason: HiddenReason): void;
 export declare function temporarilyShowShadowOnly(root: Object3D): () => void;
+/**
+ * Lifts what the user's view holds back under `root` — solo's shadow-only
+ * levels and isolation — for one capture: an interior view shows its floor
+ * whole, whatever the user isolated.
+ */
+export declare function temporarilyShowPresentation(root: Object3D): () => void;
 //# sourceMappingURL=scene-visibility.d.ts.map

package/dist/lib/scene-visibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scene-visibility.d.ts","sourceRoot":"","sources":["../../src/lib/scene-visibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAGrC;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,aAAa,GAAG,SAAS,GAAG,cAAc,CAAA;AAmBlF,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAMvE;AAED,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAarE;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,IAAI,CAgBpE"}
+{"version":3,"file":"scene-visibility.d.ts","sourceRoot":"","sources":["../../src/lib/scene-visibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAGrC;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,aAAa,GAAG,SAAS,GAAG,cAAc,CAAA;AAmBlF,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAMvE;AAED,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAarE;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,IAAI,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,IAAI,CAEtE"}

package/dist/lib/scene-visibility.js

@@ -34,16 +34,28 @@ export function showInScene(obj, reason) {
     delete holder[HOLD];
 }
 export function temporarilyShowShadowOnly(root) {
+    return temporarilyShowHeld(root, ['shadow-only']);
+}
+/**
+ * Lifts what the user's view holds back under `root` — solo's shadow-only
+ * levels and isolation — for one capture: an interior view shows its floor
+ * whole, whatever the user isolated.
+ */
+export function temporarilyShowPresentation(root) {
+    return temporarilyShowHeld(root, ['shadow-only', 'isolated']);
+}
+function temporarilyShowHeld(root, lifted) {
     const masks = new Map();
     root.traverse((obj) => {
         const hold = obj[HOLD];
-        if (!hold?.reasons.has('shadow-only'))
+        if (!hold || !lifted.some((reason) => hold.reasons.has(reason)))
             return;
         masks.set(obj, obj.layers.mask);
         const reasons = new Set(hold.reasons);
-        reasons.delete('shadow-only');
+        for (const reason of lifted)
+            reasons.delete(reason);
         // A capture needs the original scene geometry, while editor overlays and
-        // objects hidden by isolation or batching must retain their own masks.
+        // the reasons not lifted (batching) must retain their own masks.
         if (reasons.size === 0)
             obj.layers.mask = hold.original;
         else

package/dist/lib/scripted-opening.d.ts

@@ -0,0 +1,11 @@
+import type * as THREE from 'three';
+/** The group a scripted window or door renders its artifact into; the opening's system leaves it alone. */
+export declare const SCRIPTED_MODEL_FLAG = "scriptedModel";
+/**
+ * A window or door built from a script renders its artifact, not the
+ * parametric frame: drop what an earlier parametric build left under the
+ * mesh, and report whether the artifact has loaded (until then the node
+ * stays dirty, so scene-ready and bakes wait for it, as for items).
+ */
+export declare function settleScriptedOpening(mesh: THREE.Object3D): boolean;
+//# sourceMappingURL=scripted-opening.d.ts.map

package/dist/lib/scripted-opening.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripted-opening.d.ts","sourceRoot":"","sources":["../../src/lib/scripted-opening.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAA;AAEnC,2GAA2G;AAC3G,eAAO,MAAM,mBAAmB,kBAAkB,CAAA;AAElD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,GAAG,OAAO,CAWnE"}

package/dist/lib/scripted-opening.js

@@ -0,0 +1,20 @@
+/** The group a scripted window or door renders its artifact into; the opening's system leaves it alone. */
+export const SCRIPTED_MODEL_FLAG = 'scriptedModel';
+/**
+ * A window or door built from a script renders its artifact, not the
+ * parametric frame: drop what an earlier parametric build left under the
+ * mesh, and report whether the artifact has loaded (until then the node
+ * stays dirty, so scene-ready and bakes wait for it, as for items).
+ */
+export function settleScriptedOpening(mesh) {
+    let settled = false;
+    for (const child of [...mesh.children]) {
+        if (child.userData[SCRIPTED_MODEL_FLAG]) {
+            settled = child.userData.itemModelSettled === true;
+            continue;
+        }
+        mesh.remove(child);
+        child.traverse((object) => object.geometry?.dispose());
+    }
+    return settled;
+}

package/dist/lib/snapshot-pipeline.d.ts

@@ -29,6 +29,21 @@ export type SnapshotCaptureResult = {
     outW: number;
     outH: number;
 };
+/**
+ * An opaque studio backdrop in place of the theme sky: a radial gradient in
+ * exact sRGB (never tone mapped, so the hexes land as authored). Fixed at
+ * pipeline creation — callers without one get the untouched theme-backdrop
+ * pipeline. Ground shadows come from the caller's own shadow catcher, which
+ * composites over it through the scene alpha.
+ */
+export type StudioBackdrop = {
+    /** sRGB hex at `center`. */
+    inner: string;
+    /** sRGB hex at the frame corner farthest from `center`. */
+    outer: string;
+    /** Gradient centre in screen UV (0,0 = top-left). */
+    center: [number, number];
+};
 export type SnapshotPipeline = {
     applyEnvironment: ({ theme, transparent, grade, edges, camera, }: {
         theme: string;
@@ -37,17 +52,32 @@ export type SnapshotPipeline = {
         edges: EdgeMode;
         camera: Camera;
     }) => void;
-    capture: ({ captureMode, cropRegion, standardSize, }: {
+    capture: ({ captureMode, cropRegion, standardSize, mime, }: {
         captureMode?: SnapshotCaptureMode;
         cropRegion?: SnapshotCropRegion;
         standardSize?: SnapshotSize;
+        /** The encoding, when not the snapshot default (a print picture wants a lossless `image/png`). */
+        mime?: string;
     }) => Promise<SnapshotCaptureResult>;
     dispose: () => void;
 };
-export declare function createSnapshotPipeline({ renderer, scene, camera, atmosphere, }: {
+export declare function createSnapshotPipeline({ renderer, scene, camera, atmosphere, studioBackdrop, }: {
     renderer: WebGPURenderer;
     scene: Scene;
     camera: Camera;
     atmosphere?: SceneAtmosphereSource | null;
+    studioBackdrop?: StudioBackdrop;
+}): Promise<SnapshotPipeline | null>;
+/**
+ * A capture WITHOUT the post-processing stack: the scene as the renderer
+ * draws it, into an offscreen target, read back and encoded like the
+ * post-processed frames. The sheets' orthographic elevation captures use
+ * it (2026-09-10): an SSGI pass built for a second, orthographic camera
+ * never delivered a frame and held the generator's guard forever.
+ */
+export declare function createPlainSnapshotPipeline({ renderer, scene, camera, }: {
+    renderer: WebGPURenderer;
+    scene: Scene;
+    camera: Camera;
 }): Promise<SnapshotPipeline | null>;
 //# sourceMappingURL=snapshot-pipeline.d.ts.map

package/dist/lib/snapshot-pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot-pipeline.d.ts","sourceRoot":"","sources":["../../src/lib/snapshot-pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAkB,KAAK,KAAK,EAAoB,MAAM,OAAO,CAAA;AAoBjF,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,cAAc,CAAA;AAErB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAA;AAElF,OAAO,EAAE,KAAK,QAAQ,EAAqC,MAAM,cAAc,CAAA;AAK/E,eAAO,MAAM,eAAe,OAAO,CAAA;AACnC,eAAO,MAAM,gBAAgB,OAAO,CAAA;AAEpC;;;;;GAKG;AACH,eAAO,MAAM,aAAa,eAAe,CAAA;AACzC,eAAO,MAAM,gBAAgB,MAAM,CAAA;AAEnC,eAAO,MAAM,iBAAiB,OAAO,CAAA;AAUrC,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAA;AAElE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,IAAI,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,gBAAgB,EAAE,CAAC,EACjB,KAAK,EACL,WAAW,EACX,KAAK,EACL,KAAK,EACL,MAAM,GACP,EAAE;QACD,KAAK,EAAE,MAAM,CAAA;QACb,WAAW,EAAE,OAAO,CAAA;QACpB,KAAK,EAAE,OAAO,CAAA;QACd,KAAK,EAAE,QAAQ,CAAA;QACf,MAAM,EAAE,MAAM,CAAA;KACf,KAAK,IAAI,CAAA;IACV,OAAO,EAAE,CAAC,EACR,WAAW,EACX,UAAU,EACV,YAAY,GACb,EAAE;QACD,WAAW,CAAC,EAAE,mBAAmB,CAAA;QACjC,UAAU,CAAC,EAAE,kBAAkB,CAAA;QAC/B,YAAY,CAAC,EAAE,YAAY,CAAA;KAC5B,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAA;IACpC,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB,CAAA;AAgBD,wBAAsB,sBAAsB,CAAC,EAC3C,QAAQ,EACR,KAAK,EACL,MAAM,EACN,UAAiB,GAClB,EAAE;IACD,QAAQ,EAAE,cAAc,CAAA;IACxB,KAAK,EAAE,KAAK,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAA;CAC1C,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CA0SnC"}
+{"version":3,"file":"snapshot-pipeline.d.ts","sourceRoot":"","sources":["../../src/lib/snapshot-pipeline.ts"],"names":[],"mappings":"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"}