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

package/dist/lib/post-processing-resources.d.ts

@@ -0,0 +1,12 @@
+import type { PassNode, RenderPipeline } from 'three/webgpu';
+import type { LayerPassIndex } from './layer-pass';
+export declare class PostProcessingResources {
+    layerIndex: LayerPassIndex | null;
+    readonly passes: PassNode[];
+    outline: {
+        dispose(): void;
+    } | null;
+    pipeline: RenderPipeline | null;
+    dispose(): void;
+}
+//# sourceMappingURL=post-processing-resources.d.ts.map

package/dist/lib/post-processing-resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-processing-resources.d.ts","sourceRoot":"","sources":["../../src/lib/post-processing-resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAIlD,qBAAa,uBAAuB;IAClC,UAAU,EAAE,cAAc,GAAG,IAAI,CAAO;IACxC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAK;IAChC,OAAO,EAAE;QAAE,OAAO,IAAI,IAAI,CAAA;KAAE,GAAG,IAAI,CAAO;IAC1C,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAO;IAEtC,OAAO;CAUR"}

package/dist/lib/post-processing-resources.js

@@ -0,0 +1,19 @@
+// RenderPipeline.dispose() only releases its fullscreen material, so the owner
+// must also release the passes and scene observers on failure and teardown.
+export class PostProcessingResources {
+    layerIndex = null;
+    passes = [];
+    outline = null;
+    pipeline = null;
+    dispose() {
+        this.layerIndex?.dispose();
+        this.layerIndex = null;
+        for (const pass of this.passes)
+            pass.dispose();
+        this.passes.length = 0;
+        this.outline?.dispose();
+        this.outline = null;
+        this.pipeline?.dispose();
+        this.pipeline = null;
+    }
+}

package/dist/lib/renderer-capability.d.ts

@@ -0,0 +1,56 @@
+export type RendererCapabilityCanvas = {
+    getContext(contextId: 'webgl2'): unknown;
+};
+/** Mirrors `GPUPowerPreference` without pulling WebGPU ambient types into the declaration build. */
+export type RendererPowerPreference = 'high-performance' | 'low-power';
+type RendererGpuAdapter = {
+    features?: Iterable<string>;
+    requestDevice(descriptor?: {
+        requiredFeatures?: string[];
+    }): Promise<unknown>;
+};
+type RendererGpu = {
+    requestAdapter(options?: Record<string, unknown>): Promise<RendererGpuAdapter | null>;
+};
+export type RendererCapability = {
+    backend: 'webgpu';
+    device: unknown;
+    status: 'supported';
+} | {
+    backend: 'webgl';
+    status: 'supported';
+} | {
+    error?: unknown;
+    status: 'unsupported';
+};
+export type RendererBackendParameters = {
+    device?: unknown;
+    forceWebGL?: boolean;
+};
+type InitializableRenderer = {
+    dispose?: () => void;
+    init: () => Promise<unknown>;
+};
+export type RendererInitializationResult<Renderer> = {
+    backend: 'webgpu' | 'webgl';
+    renderer: Renderer;
+    status: 'ready';
+} | {
+    error?: unknown;
+    status: 'unsupported';
+};
+export declare function detectRendererCapability({ canvas, gpu, powerPreference, webgpuTimeoutMs, }?: {
+    canvas?: RendererCapabilityCanvas | null;
+    gpu?: RendererGpu | null;
+    powerPreference?: RendererPowerPreference;
+    webgpuTimeoutMs?: number;
+}): Promise<RendererCapability>;
+export declare function initializeGpuRenderer<Renderer extends InitializableRenderer>({ createRenderer, gpu, powerPreference, probeCanvas, webgpuTimeoutMs, }: {
+    createRenderer: (parameters: RendererBackendParameters) => Renderer;
+    gpu?: RendererGpu | null;
+    powerPreference?: RendererPowerPreference;
+    probeCanvas?: RendererCapabilityCanvas | null;
+    webgpuTimeoutMs?: number;
+}): Promise<RendererInitializationResult<Renderer>>;
+export {};
+//# sourceMappingURL=renderer-capability.d.ts.map

package/dist/lib/renderer-capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-capability.d.ts","sourceRoot":"","sources":["../../src/lib/renderer-capability.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,wBAAwB,GAAG;IACrC,UAAU,CAAC,SAAS,EAAE,QAAQ,GAAG,OAAO,CAAA;CACzC,CAAA;AAED,oGAAoG;AACpG,MAAM,MAAM,uBAAuB,GAAG,kBAAkB,GAAG,WAAW,CAAA;AAEtE,KAAK,kBAAkB,GAAG;IACxB,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IAC3B,aAAa,CAAC,UAAU,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAC9E,CAAA;AAED,KAAK,WAAW,GAAG;IACjB,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAA;CACtF,CAAA;AAED,MAAM,MAAM,kBAAkB,GAC1B;IAAE,OAAO,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GAC3D;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GACzC;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,CAAA;AAE9C,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AAED,KAAK,qBAAqB,GAAG;IAC3B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,4BAA4B,CAAC,QAAQ,IAC7C;IAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACpE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,CAAA;AAiD9C,wBAAsB,wBAAwB,CAAC,EAC7C,MAAwB,EACxB,GAAkB,EAClB,eAAe,EACf,eAAkD,GACnD,GAAE;IACD,MAAM,CAAC,EAAE,wBAAwB,GAAG,IAAI,CAAA;IACxC,GAAG,CAAC,EAAE,WAAW,GAAG,IAAI,CAAA;IACxB,eAAe,CAAC,EAAE,uBAAuB,CAAA;IACzC,eAAe,CAAC,EAAE,MAAM,CAAA;CACpB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA2BnC;AAED,wBAAsB,qBAAqB,CAAC,QAAQ,SAAS,qBAAqB,EAAE,EAClF,cAAc,EACd,GAAG,EACH,eAAe,EACf,WAA6B,EAC7B,eAAkD,GACnD,EAAE;IACD,cAAc,EAAE,CAAC,UAAU,EAAE,yBAAyB,KAAK,QAAQ,CAAA;IACnE,GAAG,CAAC,EAAE,WAAW,GAAG,IAAI,CAAA;IACxB,eAAe,CAAC,EAAE,uBAAuB,CAAA;IACzC,WAAW,CAAC,EAAE,wBAAwB,GAAG,IAAI,CAAA;IAC7C,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB,GAAG,OAAO,CAAC,4BAA4B,CAAC,QAAQ,CAAC,CAAC,CAyClD"}

package/dist/lib/renderer-capability.js

@@ -0,0 +1,116 @@
+const WEBGPU_INITIALIZATION_TIMEOUT_MS = 4000;
+function browserGpu() {
+    if (typeof navigator === 'undefined')
+        return null;
+    return navigator.gpu ?? null;
+}
+function browserCanvas() {
+    if (typeof document === 'undefined')
+        return null;
+    return document.createElement('canvas');
+}
+/**
+ * Because we hand the device to `WebGPURenderer` ourselves, three treats it as
+ * caller-owned and never destroys it, and `Renderer.dispose()` is a no-op when
+ * `init()` failed. Any device we request and then abandon has to be released
+ * here or it counts against the browser's concurrent-device limit for the rest
+ * of the page's life.
+ */
+function releaseDevice(device) {
+    try {
+        ;
+        device?.destroy?.();
+    }
+    catch { }
+}
+function withTimeout(promise, timeoutMs, operation) {
+    let timeout;
+    const timeoutPromise = new Promise((_, reject) => {
+        timeout = setTimeout(() => {
+            reject(new Error(`${operation} timed out after ${timeoutMs}ms`));
+        }, timeoutMs);
+    });
+    return Promise.race([promise, timeoutPromise]).finally(() => clearTimeout(timeout));
+}
+async function requestWebGpuDevice(gpu, powerPreference) {
+    const adapter = await gpu.requestAdapter({
+        featureLevel: 'compatibility',
+        ...(powerPreference ? { powerPreference } : {}),
+    });
+    if (!adapter)
+        return null;
+    const requiredFeatures = adapter.features ? Array.from(adapter.features) : undefined;
+    return adapter.requestDevice(requiredFeatures?.length ? { requiredFeatures } : undefined);
+}
+export async function detectRendererCapability({ canvas = browserCanvas(), gpu = browserGpu(), powerPreference, webgpuTimeoutMs = WEBGPU_INITIALIZATION_TIMEOUT_MS, } = {}) {
+    let capabilityError;
+    if (gpu) {
+        const pending = requestWebGpuDevice(gpu, powerPreference);
+        try {
+            const device = await withTimeout(pending, webgpuTimeoutMs, 'WebGPU adapter/device request');
+            if (device)
+                return { backend: 'webgpu', device, status: 'supported' };
+        }
+        catch (error) {
+            capabilityError = error;
+            // Losing the race means a device may still arrive after we have given up
+            // on it, so reclaim it. Attaching the handler only on this path keeps
+            // ownership of a device we did return unambiguous.
+            pending.then(releaseDevice).catch(() => { });
+        }
+    }
+    if (canvas) {
+        try {
+            const context = canvas.getContext('webgl2');
+            if (context)
+                return { backend: 'webgl', status: 'supported' };
+        }
+        catch (error) {
+            capabilityError ??= error;
+        }
+    }
+    return { error: capabilityError, status: 'unsupported' };
+}
+export async function initializeGpuRenderer({ createRenderer, gpu, powerPreference, probeCanvas = browserCanvas(), webgpuTimeoutMs = WEBGPU_INITIALIZATION_TIMEOUT_MS, }) {
+    const capability = await detectRendererCapability({
+        canvas: probeCanvas,
+        gpu,
+        powerPreference,
+        webgpuTimeoutMs,
+    });
+    if (capability.status === 'unsupported')
+        return capability;
+    let renderer;
+    try {
+        renderer = createRenderer(capability.backend === 'webgpu' ? { device: capability.device } : { forceWebGL: true });
+        const initPromise = renderer.init();
+        await (capability.backend === 'webgpu'
+            ? withTimeout(initPromise, webgpuTimeoutMs, 'WebGPU renderer initialization')
+            : initPromise);
+        return { backend: capability.backend, renderer, status: 'ready' };
+    }
+    catch (error) {
+        try {
+            // r186 made dispose() async: let it finish before the device is released
+            // and the WebGL fallback starts on the same canvas.
+            await renderer?.dispose?.();
+        }
+        catch { }
+        if (capability.backend !== 'webgpu')
+            return { error, status: 'unsupported' };
+        releaseDevice(capability.device);
+        renderer = undefined;
+        try {
+            renderer = createRenderer({ forceWebGL: true });
+            await renderer.init();
+            return { backend: 'webgl', renderer, status: 'ready' };
+        }
+        catch (fallbackError) {
+            try {
+                await renderer?.dispose?.();
+            }
+            catch { }
+            return { error: fallbackError, status: 'unsupported' };
+        }
+    }
+}

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

@@ -0,0 +1,15 @@
+import type { Object3D } from 'three';
+/**
+ * Why an object is currently held off the scene layer.
+ *
+ * - `isolated` — outside the focused subtree of the viewer's isolation filter.
+ * - `shadow-only` — solo mode: out of the color passes, still casting shadows.
+ * - `batched` — a level's merged wall mesh draws this wall now.
+ */
+export type HiddenReason = 'isolated' | 'shadow-only' | 'batched' | 'wall-batched';
+/** Holds `obj` off the scene layer for `reason`. Idempotent per reason. */
+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;
+//# sourceMappingURL=scene-visibility.d.ts.map

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

@@ -0,0 +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"}

package/dist/lib/scene-visibility.js

@@ -0,0 +1,69 @@
+import { BATCHED_LAYER, SCENE_LAYER, SHADOW_ONLY_LAYER } from './layers';
+/**
+ * Single owner of `Object3D.layers` for every feature that hides an object.
+ *
+ * Isolation, solo's shadow-caster pass and wall batching all hide by clearing
+ * {@link SCENE_LAYER}, and they overlap freely — a wall can be sewn into a
+ * batch, then soloed, then isolated. While each stashed and restored the mask privately, the
+ * second to finish wrote back a mask the first had since changed. Recording
+ * *reasons* rather than masks makes the order irrelevant: the mask is
+ * recomputed from the one snapshot taken when the first reason arrived, and
+ * handed back only when the last one leaves.
+ */
+const HOLD = Symbol('pascal:scene-visibility:hold');
+/** Holds `obj` off the scene layer for `reason`. Idempotent per reason. */
+export function hideFromScene(obj, reason) {
+    const holder = obj;
+    const hold = holder[HOLD] ?? { original: obj.layers.mask, reasons: new Set() };
+    holder[HOLD] = hold;
+    hold.reasons.add(reason);
+    applyHold(obj, hold);
+}
+/** Drops `reason`, restoring the mask `obj` had before the first one arrived. */
+export function showInScene(obj, reason) {
+    const holder = obj;
+    const hold = holder[HOLD];
+    if (!hold)
+        return;
+    hold.reasons.delete(reason);
+    if (hold.reasons.size > 0) {
+        applyHold(obj, hold);
+        return;
+    }
+    obj.layers.mask = hold.original;
+    delete holder[HOLD];
+}
+export function temporarilyShowShadowOnly(root) {
+    const masks = new Map();
+    root.traverse((obj) => {
+        const hold = obj[HOLD];
+        if (!hold?.reasons.has('shadow-only'))
+            return;
+        masks.set(obj, obj.layers.mask);
+        const reasons = new Set(hold.reasons);
+        reasons.delete('shadow-only');
+        // A capture needs the original scene geometry, while editor overlays and
+        // objects hidden by isolation or batching must retain their own masks.
+        if (reasons.size === 0)
+            obj.layers.mask = hold.original;
+        else
+            applyHold(obj, { original: hold.original, reasons });
+    });
+    return () => {
+        for (const [obj, mask] of masks)
+            obj.layers.mask = mask;
+    };
+}
+function applyHold(obj, hold) {
+    obj.layers.mask = hold.original;
+    obj.layers.disable(SCENE_LAYER);
+    // A batched wall is both drawn and shadowed by the merged mesh, so it stays
+    // out of the shadow pass too — enabling the shadow-only bit would submit its
+    // triangles a second time, on top of the copy the batch already casts.
+    if (hold.reasons.has('batched') || hold.reasons.has('wall-batched')) {
+        obj.layers.enable(BATCHED_LAYER);
+        return;
+    }
+    if (hold.reasons.has('shadow-only'))
+        obj.layers.enable(SHADOW_ONLY_LAYER);
+}

package/dist/lib/shadow-only.d.ts

@@ -1,4 +1,20 @@
 import type { Object3D } from 'three';
+/**
+ * Shadow-caster-only hiding: removes an object (and its descendants) from the
+ * color passes while keeping it in the shadow map, so a hidden roof or level
+ * still shadows the interior and sun enters through windows correctly.
+ *
+ * Uses layer masks instead of `visible = false` for two reasons: `visible`
+ * cascades (and, critically, prunes the object from the shadow pass too),
+ * while layers are tested per-object against the rendering camera — the main
+ * camera never enables the shadow-only layer, but every shadow-casting
+ * light's shadow camera does (see `lights.tsx`).
+ *
+ * The mask itself belongs to `lib/scene-visibility.ts`, which reconciles this
+ * with the isolation filter. Both calls are idempotent and cheap to reapply —
+ * solo re-runs `applyShadowOnly` every frame so meshes rebuilt while hidden
+ * get re-hidden.
+ */
 export declare function applyShadowOnly(root: Object3D): void;
 export declare function clearShadowOnly(root: Object3D): void;
 //# sourceMappingURL=shadow-only.d.ts.map

package/dist/lib/shadow-only.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shadow-only.d.ts","sourceRoot":"","sources":["../../src/lib/shadow-only.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAuBrC,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CASpD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAOpD"}
+{"version":3,"file":"shadow-only.d.ts","sourceRoot":"","sources":["../../src/lib/shadow-only.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAGrC;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAIpD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAIpD"}

package/dist/lib/shadow-only.js

@@ -1,4 +1,4 @@
-import { SCENE_LAYER, SHADOW_ONLY_LAYER } from './layers';
+import { hideFromScene, showInScene } from './scene-visibility';
 /**
  * Shadow-caster-only hiding: removes an object (and its descendants) from the
  * color passes while keeping it in the shadow map, so a hidden roof or level
@@ -7,30 +7,21 @@ import { SCENE_LAYER, SHADOW_ONLY_LAYER } from './layers';
  * Uses layer masks instead of `visible = false` for two reasons: `visible`
  * cascades (and, critically, prunes the object from the shadow pass too),
  * while layers are tested per-object against the rendering camera — the main
- * camera never enables {@link SHADOW_ONLY_LAYER}, but every shadow-casting
+ * camera never enables the shadow-only layer, but every shadow-casting
  * light's shadow camera does (see `lights.tsx`).
  *
- * The original `layers.mask` is stashed under a private Symbol so
- * {@link clearShadowOnly} restores the exact prior state. Both calls are
- * idempotent and cheap to reapply.
+ * The mask itself belongs to `lib/scene-visibility.ts`, which reconciles this
+ * with the isolation filter. Both calls are idempotent and cheap to reapply —
+ * solo re-runs `applyShadowOnly` every frame so meshes rebuilt while hidden
+ * get re-hidden.
  */
-const ORIGINAL_LAYERS = Symbol('pascal:shadow-only:original-layers');
 export function applyShadowOnly(root) {
     root.traverse((obj) => {
-        const carrier = obj;
-        if (carrier[ORIGINAL_LAYERS] === undefined) {
-            carrier[ORIGINAL_LAYERS] = obj.layers.mask;
-        }
-        obj.layers.disable(SCENE_LAYER);
-        obj.layers.enable(SHADOW_ONLY_LAYER);
+        hideFromScene(obj, 'shadow-only');
     });
 }
 export function clearShadowOnly(root) {
     root.traverse((obj) => {
-        const carrier = obj;
-        if (carrier[ORIGINAL_LAYERS] === undefined)
-            return;
-        obj.layers.mask = carrier[ORIGINAL_LAYERS];
-        delete carrier[ORIGINAL_LAYERS];
+        showInScene(obj, 'shadow-only');
     });
 }

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

@@ -3,6 +3,15 @@ import { type WebGPURenderer } from 'three/webgpu';
 import { type EdgeMode } from './edge-style';
 export declare const THUMBNAIL_WIDTH = 1920;
 export declare const THUMBNAIL_HEIGHT = 1080;
+/**
+ * Captures are re-renderable artifacts, not user originals, so they encode as
+ * webp: a 1920×1080 hero shot lands roughly an order of magnitude under PNG,
+ * which is what listings and the catalog actually ship over the wire. Alpha
+ * survives, so transparent item/preset captures keep working.
+ */
+export declare const SNAPSHOT_MIME = "image/webp";
+export declare const SNAPSHOT_QUALITY = 0.9;
+export declare const SNAPSHOT_MAX_EDGE = 2048;
 export type SnapshotCaptureMode = 'standard' | 'viewport' | 'area';
 export type SnapshotCropRegion = {
     x: number;

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;AAqBjF,OAAO,EAAgC,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAGhF,OAAO,EAAE,KAAK,QAAQ,EAAqC,MAAM,cAAc,CAAA;AAK/E,eAAO,MAAM,eAAe,OAAO,CAAA;AACnC,eAAO,MAAM,gBAAgB,OAAO,CAAA;AAEpC,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;AAED,wBAAsB,sBAAsB,CAAC,EAC3C,QAAQ,EACR,KAAK,EACL,MAAM,GACP,EAAE;IACD,QAAQ,EAAE,cAAc,CAAA;IACxB,KAAK,EAAE,KAAK,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;CACf,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAoSnC"}
+{"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;AAqBjF,OAAO,EAAgC,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAGhF,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;AAED,wBAAsB,sBAAsB,CAAC,EAC3C,QAAQ,EACR,KAAK,EACL,MAAM,GACP,EAAE;IACD,QAAQ,EAAE,cAAc,CAAA;IACxB,KAAK,EAAE,KAAK,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;CACf,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAwSnC"}

package/dist/lib/snapshot-pipeline.js

@@ -12,6 +12,23 @@ import { getSceneTheme } from './scene-themes';
 import { packNormalToRGB, unpackRGBToNormal } from './tsl-compat';
 export const THUMBNAIL_WIDTH = 1920;
 export const THUMBNAIL_HEIGHT = 1080;
+/**
+ * Captures are re-renderable artifacts, not user originals, so they encode as
+ * webp: a 1920×1080 hero shot lands roughly an order of magnitude under PNG,
+ * which is what listings and the catalog actually ship over the wire. Alpha
+ * survives, so transparent item/preset captures keep working.
+ */
+export const SNAPSHOT_MIME = 'image/webp';
+export const SNAPSHOT_QUALITY = 0.9;
+// Retina canvases make viewport/area captures multi-MB; 2048 keeps them near the 1920 presets.
+export const SNAPSHOT_MAX_EDGE = 2048;
+function clampSnapshotSize(width, height) {
+    const maxEdge = Math.max(width, height);
+    if (maxEdge <= SNAPSHOT_MAX_EDGE)
+        return { w: width, h: height };
+    const scale = SNAPSHOT_MAX_EDGE / maxEdge;
+    return { w: Math.round(width * scale), h: Math.round(height * scale) };
+}
 export async function createSnapshotPipeline({ renderer, scene, camera, }) {
     try {
         if (renderer.init)
@@ -200,20 +217,27 @@ export async function createSnapshotPipeline({ renderer, scene, camera, }) {
                 let outH;
                 let blob;
                 if (captureMode === 'viewport') {
-                    outW = captureWidth;
-                    outH = captureHeight;
+                    ;
+                    ({ w: outW, h: outH } = clampSnapshotSize(captureWidth, captureHeight));
                     const offscreen = new OffscreenCanvas(outW, outH);
-                    offscreen.getContext('2d').drawImage(srcCanvas, 0, 0);
-                    blob = await offscreen.convertToBlob({ type: 'image/png' });
+                    const ctx = offscreen.getContext('2d');
+                    if (outW !== captureWidth || outH !== captureHeight)
+                        ctx.imageSmoothingQuality = 'high';
+                    ctx.drawImage(srcCanvas, 0, 0, captureWidth, captureHeight, 0, 0, outW, outH);
+                    blob = await offscreen.convertToBlob({ type: SNAPSHOT_MIME, quality: SNAPSHOT_QUALITY });
                 }
                 else if (captureMode === 'area' && cropRegion) {
                     const sx = Math.round(cropRegion.x * captureWidth);
                     const sy = Math.round(cropRegion.y * captureHeight);
-                    outW = Math.round(cropRegion.width * captureWidth);
-                    outH = Math.round(cropRegion.height * captureHeight);
+                    const sourceW = Math.round(cropRegion.width * captureWidth);
+                    const sourceH = Math.round(cropRegion.height * captureHeight);
+                    ({ w: outW, h: outH } = clampSnapshotSize(sourceW, sourceH));
                     const offscreen = new OffscreenCanvas(outW, outH);
-                    offscreen.getContext('2d').drawImage(srcCanvas, sx, sy, outW, outH, 0, 0, outW, outH);
-                    blob = await offscreen.convertToBlob({ type: 'image/png' });
+                    const ctx = offscreen.getContext('2d');
+                    if (outW !== sourceW || outH !== sourceH)
+                        ctx.imageSmoothingQuality = 'high';
+                    ctx.drawImage(srcCanvas, sx, sy, sourceW, sourceH, 0, 0, outW, outH);
+                    blob = await offscreen.convertToBlob({ type: SNAPSHOT_MIME, quality: SNAPSHOT_QUALITY });
                 }
                 else {
                     // Standard: center-crop to the requested aspect (default 1920×1080)
@@ -237,7 +261,7 @@ export async function createSnapshotPipeline({ renderer, scene, camera, }) {
                     offscreen
                         .getContext('2d')
                         .drawImage(srcCanvas, sx, sy, sWidth, sHeight, 0, 0, outW, outH);
-                    blob = await offscreen.convertToBlob({ type: 'image/png' });
+                    blob = await offscreen.convertToBlob({ type: SNAPSHOT_MIME, quality: SNAPSHOT_QUALITY });
                 }
                 return { blob, outW, outH };
             },

package/dist/store/use-viewer.d.ts

@@ -4,6 +4,7 @@ import type { EdgeMode } from '../lib/edge-style';
 import type { ColorPreset, RenderShading } from '../lib/materials';
 export type RenderContext = 'editor' | 'viewer';
 export type MetricNotation = 'meters' | 'millimeters';
+export type WallMode = 'up' | 'cutaway' | 'down' | 'translucent';
 type SelectionPath = {
     buildingId: BuildingNode['id'] | null;
     levelId: LevelNode['id'] | null;
@@ -70,8 +71,8 @@ type ViewerState = {
     unitExplicit: boolean;
     levelMode: 'stacked' | 'exploded' | 'solo' | 'manual';
     setLevelMode: (mode: 'stacked' | 'exploded' | 'solo' | 'manual') => void;
-    wallMode: 'up' | 'cutaway' | 'down' | 'translucent';
-    setWallMode: (mode: 'up' | 'cutaway' | 'down' | 'translucent') => void;
+    wallMode: WallMode;
+    setWallMode: (mode: WallMode) => void;
     showScans: boolean;
     setShowScans: (show: boolean) => void;
     showGuides: boolean;
@@ -101,8 +102,8 @@ type ViewerState = {
      * effects can re-apply to the freshly swapped meshes. */
     geometryRevision: number;
     bumpGeometryRevision: () => void;
-    exportScene: ((format?: 'glb' | 'stl' | 'obj') => Promise<void>) | null;
-    setExportScene: (fn: ((format?: 'glb' | 'stl' | 'obj') => Promise<void>) | null) => void;
+    exportScene: ((format?: 'glb' | 'usdz' | 'stl' | 'obj') => Promise<void>) | null;
+    setExportScene: (fn: ((format?: 'glb' | 'usdz' | 'stl' | 'obj') => Promise<void>) | null) => void;
     debugColors: boolean;
     setDebugColors: (enabled: boolean) => void;
     walkthroughMode: boolean;
@@ -133,7 +134,7 @@ declare const useViewer: import("zustand").UseBoundStore<Omit<import("zustand").
         setOptions: (options: Partial<import("zustand/middleware").PersistOptions<ViewerState, {
             metricNotation: MetricNotation;
             levelMode: "manual" | "stacked" | "exploded" | "solo";
-            wallMode: "up" | "down" | "cutaway" | "translucent";
+            wallMode: WallMode;
             projectPreferences: Record<string, {
                 showScans?: boolean;
                 showGuides?: boolean;
@@ -157,7 +158,7 @@ declare const useViewer: import("zustand").UseBoundStore<Omit<import("zustand").
         getOptions: () => Partial<import("zustand/middleware").PersistOptions<ViewerState, {
             metricNotation: MetricNotation;
             levelMode: "manual" | "stacked" | "exploded" | "solo";
-            wallMode: "up" | "down" | "cutaway" | "translucent";
+            wallMode: WallMode;
             projectPreferences: Record<string, {
                 showScans?: boolean;
                 showGuides?: boolean;

package/dist/store/use-viewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-viewer.d.ts","sourceRoot":"","sources":["../../src/store/use-viewer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"use-viewer.d.ts","sourceRoot":"","sources":["../../src/store/use-viewer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC5F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAIrC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAGlE,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAC/C,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,aAAa,CAAA;AACrD,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,aAAa,CAAA;AAEhE,KAAK,aAAa,GAAG;IACnB,UAAU,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IACrC,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IAC/B,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IAC7B,WAAW,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAA;CAC9B,CAAA;AAED,KAAK,QAAQ,GAAG;IACd,eAAe,EAAE,QAAQ,EAAE,CAAA;IAC3B,cAAc,EAAE,QAAQ,EAAE,CAAA;CAC3B,CAAA;AAED,KAAK,WAAW,GAAG;IACjB,SAAS,EAAE,aAAa,CAAA;IACxB,kBAAkB,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAA;IACpC,qBAAqB,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,CAAA;IACtD;+EAC2E;IAC3E,mBAAmB,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAA;IACrC,sBAAsB,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,CAAA;IACvD,kBAAkB,EAAE,MAAM,CAAA;IAC1B,qBAAqB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC7C,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IAChD,YAAY,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,KAAK,IAAI,CAAA;IAEjE,UAAU,EAAE,aAAa,GAAG,cAAc,CAAA;IAC1C,aAAa,EAAE,CAAC,IAAI,EAAE,aAAa,GAAG,cAAc,KAAK,IAAI,CAAA;IAE7D,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IAEnC,aAAa,EAAE,aAAa,CAAA;IAC5B,gBAAgB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAA;IAElD;;;;qBAIiB;IACjB,WAAW,EAAE,OAAO,CAAA;IACpB,YAAY,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAEtC;;;4EAGwE;IACxE,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxC,qBAAqB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5D,oBAAoB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IAE9C,uFAAuF;IACvF,YAAY,EAAE,OAAO,CAAA;IACrB,eAAe,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAEzC,OAAO,EAAE,aAAa,CAAA;IACtB,gBAAgB,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC,CAAA;IAC/D,UAAU,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAA;IAE5C,QAAQ,EAAE,OAAO,CAAA;IACjB,WAAW,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAA;IAExC,WAAW,EAAE,WAAW,CAAA;IACxB,cAAc,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAA;IAE7C,KAAK,EAAE,QAAQ,CAAA;IACf,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAA;IAEnC,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IAEtC,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAA;IAC3B,OAAO,EAAE,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,KAAK,IAAI,CAAA;IAC9C,cAAc,EAAE,cAAc,CAAA;IAC9B,iBAAiB,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAA;IACrD;;sDAEkD;IAClD,YAAY,EAAE,OAAO,CAAA;IAErB,SAAS,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAA;IACrD,YAAY,EAAE,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,KAAK,IAAI,CAAA;IAExE,QAAQ,EAAE,QAAQ,CAAA;IAClB,WAAW,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAA;IAErC,SAAS,EAAE,OAAO,CAAA;IAClB,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IAErC,UAAU,EAAE,OAAO,CAAA;IACnB,aAAa,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IAEtC,QAAQ,EAAE,OAAO,CAAA;IACjB,WAAW,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IAEpC,gBAAgB,EAAE,OAAO,CAAA;IACzB,mBAAmB,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IAO5C,SAAS,EAAE,OAAO,CAAA;IAClB,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IAErC,qBAAqB,EAAE,OAAO,CAAA;IAC9B,wBAAwB,EAAE,CAAC,WAAW,EAAE,OAAO,KAAK,IAAI,CAAA;IAGxD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;IAE/C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;IACzC,kBAAkB,EAAE,MAAM,CACxB,MAAM,EACN;QACE,SAAS,CAAC,EAAE,OAAO,CAAA;QACnB,UAAU,CAAC,EAAE,OAAO,CAAA;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAC3B,CACF,CAAA;IAGD,YAAY,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,KAAK,IAAI,CAAA;IACvD,cAAc,EAAE,MAAM,IAAI,CAAA;IAE1B,QAAQ,EAAE,QAAQ,CAAA;IAClB;6DACyD;IACzD,gBAAgB,EAAE,MAAM,CAAA;IACxB,oBAAoB,EAAE,MAAM,IAAI,CAAA;IAGhC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAA;IAChF,cAAc,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,KAAK,IAAI,CAAA;IAEjG,WAAW,EAAE,OAAO,CAAA;IACpB,cAAc,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IAE1C,eAAe,EAAE,OAAO,CAAA;IACxB,kBAAkB,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IAE3C;4EACwE;IACxE,oBAAoB,EAAE,OAAO,CAAA;IAC7B,uBAAuB,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAA;IAErD,cAAc,EAAE,OAAO,CAAA;IACvB,iBAAiB,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAA;IAE9C;;;;;;;;;OASG;IACH,aAAa,EAAE,OAAO,CAAA;IACtB,gBAAgB,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAA;CAC9C,CAAA;AAmJD,QAAA,MAAM,SAAS;;;;;;;;;4BAlMG,OAAO;6BACN,OAAO;2BACT,OAAO;mCACC,OAAO;;;;;;;;;;;;;;;;;;;;;4BAHd,OAAO;6BACN,OAAO;2BACT,OAAO;mCACC,OAAO;;;;;;;;;;;;EA6a/B,CAAA;AAED;;;;cAIc;AACd,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,QAMzE;AAED,eAAe,SAAS,CAAA"}

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

@@ -35,7 +35,7 @@ export const CeilingSystem = () => {
             }
             // If mesh not found, keep it dirty for next frame
         });
-    });
+    }, 2);
     return null;
 };
 /**

package/dist/systems/door/door-animation-system.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"door-animation-system.d.ts","sourceRoot":"","sources":["../../../src/systems/door/door-animation-system.tsx"],"names":[],"mappings":"AAYA,eAAO,MAAM,mBAAmB,YA8C/B,CAAA"}
+{"version":3,"file":"door-animation-system.d.ts","sourceRoot":"","sources":["../../../src/systems/door/door-animation-system.tsx"],"names":[],"mappings":"AAKA,eAAO,MAAM,mBAAmB,YAkD/B,CAAA"}

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

@@ -1,13 +1,6 @@
 import { emitter, useInteractive, useScene } from '@pascal-app/core';
 import { useFrame } from '@react-three/fiber';
 const easeDoorAnimation = (value) => value * value * (3 - 2 * value);
-function markDoorDirty(doorId) {
-    const scene = useScene.getState();
-    const node = scene.nodes[doorId];
-    scene.dirtyNodes.add(doorId);
-    if (node?.parentId)
-        scene.dirtyNodes.add(node.parentId);
-}
 export const DoorAnimationSystem = () => {
     useFrame(({ clock }) => {
         const interactive = useInteractive.getState();
@@ -30,19 +23,23 @@ export const DoorAnimationSystem = () => {
             }
             const progress = Math.min(1, (now - startedAt) / animation.durationMs);
             const value = animation.from + (animation.to - animation.from) * easeDoorAnimation(progress);
+            // No dirty mark per tick: DoorSystem rebuilds any door with an entry in
+            // `doorAnimations`, and a dirty mark is a one-shot work item, not a
+            // needs-frame signal — per-tick marks kept the scene from ever settling.
             interactive.setDoorOpenState(typedDoorId, { [animation.field]: value });
-            markDoorDirty(typedDoorId);
             if (progress < 1)
                 continue;
             interactive.cancelDoorAnimation(typedDoorId);
             if (animation.persist) {
                 scene.updateNode(typedDoorId, { [animation.field]: animation.to });
                 interactive.removeDoorOpenState(typedDoorId);
-                markDoorDirty(typedDoorId);
             }
             else {
                 interactive.setDoorOpenState(typedDoorId, { [animation.field]: animation.to });
             }
+            // One final mark so the settled pose gets a rebuild after the animation
+            // entry is gone (the persist branch's updateNode also marks, harmlessly).
+            scene.markDirty(typedDoorId);
             emitter.emit('door:animation-completed', {
                 doorId: typedDoorId,
                 field: animation.field,

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

@@ -1 +1 @@
-{"version":3,"file":"door-system.d.ts","sourceRoot":"","sources":["../../../src/systems/door/door-system.tsx"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,QAAQ,EAYd,MAAM,kBAAkB,CAAA;AAGzB,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AA0D9B,eAAO,MAAM,UAAU,YA6GtB,CAAA;AAupCD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,KAAK,CAAC,QAAQ,GAAG,SAAS,EAChC,KAAK,EAAE,MAAM,GACZ,OAAO,CA6GT;AAyuCD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,GAAG,KAAK,CAAC,IAAI,CAI/D"}
+{"version":3,"file":"door-system.d.ts","sourceRoot":"","sources":["../../../src/systems/door/door-system.tsx"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,QAAQ,EAYd,MAAM,kBAAkB,CAAA;AAGzB,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AA2D9B,eAAO,MAAM,UAAU,YAsHtB,CAAA;AAupCD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,KAAK,CAAC,QAAQ,GAAG,SAAS,EAChC,KAAK,EAAE,MAAM,GACZ,OAAO,CA6GT;AAyuCD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,GAAG,KAAK,CAAC,IAAI,CAI/D"}