@pascal-app/viewer 1.0.1 → 1.0.4

package/dist/lib/hero-pose.js

@@ -1,7 +1,7 @@
 import { sceneRegistry, useScene } from '@pascal-app/core';
 import { Box3, Vector3 } from 'three';
 export const DEFAULT_FRAMING_EXCLUDED_TYPES = ['site', 'scan', 'guide', 'spawn'];
-export function heroCameraPose({ boxes, aspect, aim, fovDeg = 60, azimuthRad = Math.PI / 4, elevationRad = (13 * Math.PI) / 180, padding = 1.03, minDistance = 4, frameShift = 0, }) {
+export function heroCameraPose({ boxes, aspect, aim, fovDeg = 60, azimuthRad = Math.PI / 4, elevationRad = (13 * Math.PI) / 180, padding = 1.03, minDistance = 4, frameShift = 0, tightFit = false, }) {
     const list = Array.isArray(boxes) ? boxes : [boxes];
     const union = new Box3();
     for (const box of list)
@@ -37,6 +37,62 @@ export function heroCameraPose({ boxes, aspect, aim, fovDeg = 60, azimuthRad = M
             }
         }
     }
+    if (tightFit) {
+        // Every corner as (lateral, vertical, depth) around `center`. For a camera
+        // distance d, a shift (sx, sy) of aim+camera along right/up keeps a corner
+        // in frame iff |lateral − sx| ≤ tanH·(d + depth) (same vertically), so each
+        // corner bounds the feasible shift window; the tightest d whose windows
+        // still intersect is the fit, bisected from the symmetric distance.
+        const samples = [];
+        for (const box of list) {
+            for (const x of [box.min.x, box.max.x]) {
+                for (const y of [box.min.y, box.max.y]) {
+                    for (const z of [box.min.z, box.max.z]) {
+                        offset.subVectors(corner.set(x, y, z), center);
+                        samples.push([offset.dot(right), offset.dot(up), offset.dot(forward)]);
+                    }
+                }
+            }
+        }
+        const tanH = tanHorizontal / padding;
+        const tanV = tanVertical / padding;
+        const shiftWindow = (d) => {
+            let loX = Number.NEGATIVE_INFINITY;
+            let hiX = Number.POSITIVE_INFINITY;
+            let loY = Number.NEGATIVE_INFINITY;
+            let hiY = Number.POSITIVE_INFINITY;
+            for (const [lateral, vertical, depth] of samples) {
+                const z = d + depth;
+                if (z <= 0.1)
+                    return null;
+                loX = Math.max(loX, lateral - tanH * z);
+                hiX = Math.min(hiX, lateral + tanH * z);
+                loY = Math.max(loY, vertical - tanV * z);
+                hiY = Math.min(hiY, vertical + tanV * z);
+            }
+            return loX <= hiX && loY <= hiY ? { sx: (loX + hiX) / 2, sy: (loY + hiY) / 2 } : null;
+        };
+        let lo = minDistance;
+        let hi = distance;
+        while (!shiftWindow(hi))
+            hi *= 1.5;
+        for (let i = 0; i < 40; i++) {
+            const mid = (lo + hi) / 2;
+            if (shiftWindow(mid))
+                hi = mid;
+            else
+                lo = mid;
+        }
+        const shift = shiftWindow(hi);
+        const target = center
+            .clone()
+            .addScaledVector(right, shift.sx)
+            .addScaledVector(up, shift.sy - frameShift * hi * tanVertical);
+        return {
+            position: [target.x + dir.x * hi, target.y + dir.y * hi, target.z + dir.z * hi],
+            target: [target.x, target.y, target.z],
+        };
+    }
     // Reframe: slide aim and camera together along the view-up axis — pure
     // composition shift, no perspective change.
     const drop = up.clone().multiplyScalar(-frameShift * distance * tanVertical);
@@ -166,7 +222,7 @@ function dominantWallYaw() {
  * structure (pure furniture arrangements) fall back to framing every
  * non-helper node.
  */
-export function computeHeroFraming() {
+export function computeHeroFraming({ sitePlates = true, } = {}) {
     const structural = perNodeBoxes([...DEFAULT_FRAMING_EXCLUDED_TYPES, 'item', 'building', 'level']);
     if (structural.length === 0) {
         const all = perNodeBoxes([...DEFAULT_FRAMING_EXCLUDED_TYPES, 'building', 'level']);
@@ -176,12 +232,17 @@ export function computeHeroFraming() {
         for (const box of all)
             union.union(box);
         const center = union.getCenter(new Vector3());
-        return { boxes: all, aim: [center.x, center.y, center.z], azimuthRad: Math.PI / 4 };
+        return {
+            boxes: all,
+            aim: [center.x, center.y, center.z],
+            azimuthRad: Math.PI / 4,
+            detachedItemIds: [],
+        };
     }
     const structuralUnion = new Box3();
     for (const box of structural)
         structuralUnion.union(box);
-    const plates = sitePlateBoxes();
+    const plates = sitePlates ? sitePlateBoxes() : [];
     const groundUnion = structuralUnion.clone();
     for (const box of plates)
         groundUnion.union(box);
@@ -189,14 +250,19 @@ export function computeHeroFraming() {
         .clone()
         .expandByVector(groundUnion.getSize(new Vector3()).multiplyScalar(0.15));
     const boxes = [...structural, ...plates];
+    const detachedItemIds = [];
     const itemIds = sceneRegistry.byType.item;
     for (const id of itemIds) {
         const object = sceneRegistry.nodes.get(id);
         if (!object)
             continue;
         const bounds = new Box3().setFromObject(object);
-        if (!bounds.isEmpty() && nearby.intersectsBox(bounds))
+        if (bounds.isEmpty())
+            continue;
+        if (nearby.intersectsBox(bounds))
             boxes.push(bounds);
+        else
+            detachedItemIds.push(id);
     }
     const groundCenter = groundUnion.getCenter(new Vector3());
     const structuralCenter = structuralUnion.getCenter(new Vector3());
@@ -205,6 +271,7 @@ export function computeHeroFraming() {
         boxes,
         aim: [groundCenter.x, structuralCenter.y, groundCenter.z],
         azimuthRad: Math.PI / 4 - (yaw ?? 0),
+        detachedItemIds,
     };
 }
 export function temporarilyHideNodeTypes(types) {

package/dist/lib/ink-edges.d.ts

@@ -1,5 +1,7 @@
-export declare function inkedEdges({ depthTex, normalTex, inkColor, radius, opacity, sceneRgb, }: {
-    depthTex: any;
+import type { Camera } from 'three';
+export declare function createEdgeDepthSampler(depthTex: any, camera: Camera): (uv: any) => any;
+export declare function inkedEdges({ sampleDepth, normalTex, inkColor, radius, opacity, sceneRgb, }: {
+    sampleDepth: (uv: any) => any;
     normalTex: any;
     inkColor: any;
     radius: number;

package/dist/lib/ink-edges.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ink-edges.d.ts","sourceRoot":"","sources":["../../src/lib/ink-edges.ts"],"names":[],"mappings":"AAoBA,wBAAgB,UAAU,CAAC,EACzB,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,MAAM,EACN,OAAO,EACP,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,GAAG,CAAA;IACb,SAAS,EAAE,GAAG,CAAA;IACd,QAAQ,EAAE,GAAG,CAAA;IAKb,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,GAAG,CAAA;IACZ,QAAQ,EAAE,GAAG,CAAA;CACd,OAsCA"}
+{"version":3,"file":"ink-edges.d.ts","sourceRoot":"","sources":["../../src/lib/ink-edges.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAqB,MAAM,OAAO,CAAA;AAkBtD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,QACd,GAAG,SAYxD;AAkBD,wBAAgB,UAAU,CAAC,EACzB,WAAW,EACX,SAAS,EACT,QAAQ,EACR,MAAM,EACN,OAAO,EACP,QAAQ,GACT,EAAE;IACD,WAAW,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,GAAG,CAAA;IAC7B,SAAS,EAAE,GAAG,CAAA;IACd,QAAQ,EAAE,GAAG,CAAA;IAKb,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,GAAG,CAAA;IACZ,QAAQ,EAAE,GAAG,CAAA;CACd,OAsCA"}

package/dist/lib/ink-edges.js

@@ -1,5 +1,15 @@
-import { abs, float, max, min, mix, screenSize, screenUV, smoothstep, vec2 } from 'three/tsl';
+import { abs, float, max, min, mix, perspectiveDepthToViewZ, screenSize, screenUV, smoothstep, uniform, vec2, viewZToPerspectiveDepth, } from 'three/tsl';
 import { unpackRGBToNormal } from './tsl-compat';
+export function createEdgeDepthSampler(depthTex, camera) {
+    if (!('isPerspectiveCamera' in camera))
+        return (uv) => depthTex.sample(uv).r;
+    const perspective = camera;
+    const near = uniform(perspective.near).onRenderUpdate(() => perspective.near);
+    const far = uniform(perspective.far).onRenderUpdate(() => perspective.far);
+    // Ink and AO thresholds were calibrated at near 0.1 / far 1000. Keep
+    // their world distances when orbit, walkthrough or capture clipping changes.
+    return (uv) => viewZToPerspectiveDepth(perspectiveDepthToViewZ(depthTex.sample(uv).r, near, far), float(0.1), float(1000));
+}
 // Screen-space ink outline (SketchUp / Moebius look). Reads the scene-pass
 // depth + normal MRT and inks two signals:
 //
@@ -16,14 +26,14 @@ import { unpackRGBToNormal } from './tsl-compat';
 // Topology-agnostic: works on CSG triangle soup, organic GLBs, anything — it
 // only sees the rendered buffers. `intensity` scales the final mask; `inkColor`
 // should track the background luminance (dark lines on light scenes).
-export function inkedEdges({ depthTex, normalTex, inkColor, radius, opacity, sceneRgb, }) {
+export function inkedEdges({ sampleDepth, normalTex, inkColor, radius, opacity, sceneRgb, }) {
     const px = vec2(1, 1).div(screenSize).mul(radius);
     const uvN = screenUV;
-    const dC = depthTex.sample(uvN).r;
-    const dR = depthTex.sample(uvN.add(vec2(px.x, 0))).r;
-    const dL = depthTex.sample(uvN.sub(vec2(px.x, 0))).r;
-    const dU = depthTex.sample(uvN.add(vec2(0, px.y))).r;
-    const dD = depthTex.sample(uvN.sub(vec2(0, px.y))).r;
+    const dC = sampleDepth(uvN);
+    const dR = sampleDepth(uvN.add(vec2(px.x, 0)));
+    const dL = sampleDepth(uvN.sub(vec2(px.x, 0)));
+    const dU = sampleDepth(uvN.add(vec2(0, px.y)));
+    const dD = sampleDepth(uvN.sub(vec2(0, px.y)));
     const depthLap = abs(dR.add(dL).add(dU).add(dD).sub(dC.mul(4)));
     const invDepth = float(1).sub(dC);
     const depthMetric = depthLap.div(invDepth.mul(invDepth).add(float(0.00002)));

package/dist/lib/key-light-override.d.ts

@@ -0,0 +1,11 @@
+import type { Vector3Tuple } from 'three';
+/**
+ * Aims the key (shadow-casting) light along a world direction, ahead of the
+ * theme or atmosphere source. For captures that compose their own camera —
+ * the worker thumbnail sets the sun relative to its hero angle so shadows
+ * read instead of falling straight behind the building. `null` restores the
+ * theme/atmosphere direction.
+ */
+export declare function setKeyLightDirectionOverride(direction: Vector3Tuple | null): void;
+export declare function getKeyLightDirectionOverride(): Vector3Tuple | null;
+//# sourceMappingURL=key-light-override.d.ts.map

package/dist/lib/key-light-override.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-light-override.d.ts","sourceRoot":"","sources":["../../src/lib/key-light-override.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAIzC;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,YAAY,GAAG,IAAI,QAE1E;AAED,wBAAgB,4BAA4B,IAAI,YAAY,GAAG,IAAI,CAElE"}

package/dist/lib/key-light-override.js

@@ -0,0 +1,14 @@
+let keyLightDirection = null;
+/**
+ * Aims the key (shadow-casting) light along a world direction, ahead of the
+ * theme or atmosphere source. For captures that compose their own camera —
+ * the worker thumbnail sets the sun relative to its hero angle so shadows
+ * read instead of falling straight behind the building. `null` restores the
+ * theme/atmosphere direction.
+ */
+export function setKeyLightDirectionOverride(direction) {
+    keyLightDirection = direction;
+}
+export function getKeyLightDirectionOverride() {
+    return keyLightDirection;
+}

package/dist/lib/live-frame-hold.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Holds the viewport's LAST presented frame on screen while a capture works
+ * on the shared scene: the frame loop keeps ticking (useFrame systems still
+ * run, a capture can pump frames by hand) but the live draw is skipped, so
+ * whatever a capture swaps in for its own renders — a presentation flip, a
+ * hidden ground, an override material held across a GPU readback — never
+ * reaches the canvas.
+ *
+ * Holds nest; each one expires on its own after `maxMs` so a capture that
+ * never settles cannot freeze the viewport for the session.
+ */
+export declare function holdLiveFrame(maxMs?: number): () => void;
+export declare function isLiveFrameHeld(): boolean;
+//# sourceMappingURL=live-frame-hold.d.ts.map

package/dist/lib/live-frame-hold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-frame-hold.d.ts","sourceRoot":"","sources":["../../src/lib/live-frame-hold.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,wBAAgB,aAAa,CAAC,KAAK,SAAS,GAAG,MAAM,IAAI,CAWxD;AAED,wBAAgB,eAAe,IAAI,OAAO,CAEzC"}

package/dist/lib/live-frame-hold.js

@@ -0,0 +1,28 @@
+/**
+ * Holds the viewport's LAST presented frame on screen while a capture works
+ * on the shared scene: the frame loop keeps ticking (useFrame systems still
+ * run, a capture can pump frames by hand) but the live draw is skipped, so
+ * whatever a capture swaps in for its own renders — a presentation flip, a
+ * hidden ground, an override material held across a GPU readback — never
+ * reaches the canvas.
+ *
+ * Holds nest; each one expires on its own after `maxMs` so a capture that
+ * never settles cannot freeze the viewport for the session.
+ */
+let holds = 0;
+export function holdLiveFrame(maxMs = 60_000) {
+    holds += 1;
+    let released = false;
+    const release = () => {
+        if (released)
+            return;
+        released = true;
+        clearTimeout(expiry);
+        holds -= 1;
+    };
+    const expiry = setTimeout(release, maxMs);
+    return release;
+}
+export function isLiveFrameHeld() {
+    return holds > 0;
+}

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":"AAAA,OAAO,EAGL,KAAK,qBAAqB,EAE1B,KAAK,cAAc,EAGnB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,WAAW,EACjB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,EAAE,uBAAuB,EAA4B,MAAM,cAAc,CAAA;AAOhF,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,UAAU,CAAA;AAChD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,WAAW,CAAA;AAEjE,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAQpD,CAAA;AAID,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAQrD,CAAA;AAED,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAQpD,CAAA;AAED,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAQzD,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAK5E,CAAA;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,WAAW,EACnB,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAKR;AAOD,eAAO,MAAM,aAAa,yBAKxB,CAAA;AAsBF,wBAAgB,yBAAyB,IAAI,MAAM,CAElD;AA2ED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAWtF;AAED,wBAAgB,aAAa,CAAC,QAAQ,CAAC,EAAE,cAAc,GAAG,MAAM,CAK/D;AA6SD,wBAAgB,8BAA8B,CAC5C,aAAa,EAAE,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,EAChD,MAAM,EAAE,qBAAqB,GAAG,IAAI,GAAG,SAAS,QAcjD;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,qBAAqB,EAC7B,OAAO,GAAE,aAA0B,GAClC,KAAK,CAAC,QAAQ,CAchB;AAED,wBAAgB,2BAA2B,CACzC,cAAc,CAAC,EAAE,MAAM,EACvB,OAAO,GAAE,aAA0B,GAClC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAIvB;AAED,wBAAgB,cAAc,CAC5B,QAAQ,CAAC,EAAE,cAAc,EACzB,OAAO,GAAE,aAA0B,GAClC,KAAK,CAAC,QAAQ,CAqChB;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,cAAc,EAAE,MAAM,CAAC,eAAe,EAAE,aAAa,CAAC,GAAG,SAAS,EAClE,OAAO,GAAE,aAA0B,GAClC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAOvB;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,aAA0B,EACnC,SAAS,SAAM,GACd,KAAK,CAAC,QAAQ,CAShB;AAED,wBAAgB,qBAAqB,CACnC,KAAK,SAAY,EACjB,SAAS,SAAM,EACf,OAAO,GAAE,aAA0B,EACnC,IAAI,GAAE,KAAK,CAAC,IAAsB,GACjC,KAAK,CAAC,QAAQ,CAehB;AAmBD,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,WAAW,EACnB,IAAI,GAAE,KAAK,CAAC,IAAsB,EAClC,YAAY,CAAC,EAAE,MAAM,GACpB,KAAK,CAAC,QAAQ,CA8BhB;AAED,wBAAgB,YAAY,CAAC,OAAO,GAAE,aAA0B,GAAG,KAAK,CAAC,QAAQ,CAEhF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,aAA0B,GAAG,KAAK,CAAC,QAAQ,CAEzF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,aAA0B,GAAG,KAAK,CAAC,QAAQ,CAEzF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,aAA0B,GAAG,KAAK,CAAC,QAAQ,CAEzF;AAED,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,aAA0B,GAAG,KAAK,CAAC,QAAQ,CA2B3F;AAED,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,aAA0B,GAAG,KAAK,CAAC,QAAQ,CAE5F;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,aAA0B,GAAG,KAAK,CAAC,QAAQ,CAEzF;AAED,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,aAA0B,GAAG,KAAK,CAAC,QAAQ,CAE1F;AAED,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,aAA0B,GAAG,KAAK,CAAC,QAAQ,CAE1F;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,CAE9D;AAED,KAAK,oBAAoB,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,MAAM,IAAI,CAAC,CAAA;AAG7D,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,IAAI,CAKtF;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAwBzC"}
+{"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"}