@pascal-app/viewer 1.0.3 → 1.0.5

package/dist/lib/reveal-wipe.js

@@ -0,0 +1,105 @@
+import { positionWorld, uniform } from 'three/tsl';
+/** A node that rises less than this (m) is flat: it sweeps along its longer plan side. */
+export const COVER_MIN_RISE_M = 0.6;
+/** The sweep of a node drawn inside `box` (world space). */
+export function coverSweepOf(box) {
+    // Nothing drawn yet: an empty sweep, so the covering has nothing to close.
+    if (!(box.max.y >= box.min.y))
+        return { axis: 'y', from: 0, to: 0 };
+    if (box.max.y - box.min.y >= COVER_MIN_RISE_M) {
+        return { axis: 'y', from: box.min.y, to: box.max.y };
+    }
+    const alongX = box.max.x - box.min.x >= box.max.z - box.min.z;
+    return alongX
+        ? { axis: 'x', from: box.min.x, to: box.max.x }
+        : { axis: 'z', from: box.min.z, to: box.max.z };
+}
+/** The time a covering of `sweep` takes in `range`. */
+export function coverDurationMs(sweep, range) {
+    const length = Math.max(0, sweep.to - sweep.from);
+    return Math.min(range.maxMs, Math.max(range.minMs, length * range.perMeterMs));
+}
+/**
+ * How much of the sweep the covering has closed `elapsedMs` into `durationMs`, as a share in [0, 1].
+ * It moves continuously: an ease in and out (a sine), so it starts and stops without a jolt, and it
+ * is exactly 0 at the start and 1 at the end.
+ */
+export function coverShareAt(elapsedMs, durationMs) {
+    if (!(durationMs > 0))
+        return elapsedMs >= 0 ? 1 : 0;
+    const t = Math.min(1, Math.max(0, elapsedMs / durationMs));
+    return 0.5 - 0.5 * Math.cos(Math.PI * t);
+}
+const worn = new WeakMap();
+const sweeps = new WeakMap();
+const eachOf = (material) => Array.isArray(material) ? material : [material];
+const isMesh = (object) => object.isMesh === true && Boolean(object.material);
+function maskOf(sweep) {
+    const coordinate = sweep.axis === 'y' ? positionWorld.y : sweep.axis === 'x' ? positionWorld.x : positionWorld.z;
+    return coordinate.lessThanEqual(sweep.level);
+}
+function wipedClone(material, mask) {
+    const clone = material.clone();
+    clone.maskNode = clone.maskNode ? clone.maskNode.and(mask) : mask;
+    return clone;
+}
+/**
+ * Shows what is below `at` (world metres along the sweep's axis) of everything drawn under `root`,
+ * and hides the rest. Idempotent: a frame later it only moves the level; a mesh whose renderer put
+ * its own materials back is dressed again. Cleared by `clearRevealWipe`.
+ */
+export function setRevealWipe(root, sweep, at) {
+    let state = sweeps.get(root);
+    if (!state || state.axis !== sweep.axis) {
+        if (state)
+            clearRevealWipe(root);
+        state = { level: uniform(at), axis: sweep.axis };
+        sweeps.set(root, state);
+    }
+    state.level.value = at;
+    const mask = maskOf(state);
+    root.traverse((child) => {
+        if (!isMesh(child))
+            return;
+        let entry = worn.get(child);
+        if (entry && child.material !== entry.wiped) {
+            // Its renderer set the real materials again: they are the originals now.
+            for (const material of eachOf(entry.wiped))
+                material.dispose();
+            entry = undefined;
+        }
+        if (!entry) {
+            const original = child.material;
+            const wiped = Array.isArray(original)
+                ? original.map((material) => wipedClone(material, mask))
+                : wipedClone(original, mask);
+            entry = { original, wiped, cast: child.castShadow };
+            worn.set(child, entry);
+            child.material = wiped;
+        }
+        // The depth pass has no mask: a row not yet laid would still throw its shadow.
+        child.castShadow = false;
+    });
+}
+/** Gives every mesh under `root` its own materials and its shadow back. */
+export function clearRevealWipe(root) {
+    if (!sweeps.delete(root))
+        return;
+    root.traverse((child) => {
+        if (!isMesh(child))
+            return;
+        const entry = worn.get(child);
+        if (!entry)
+            return;
+        if (child.material === entry.wiped)
+            child.material = entry.original;
+        for (const material of eachOf(entry.wiped))
+            material.dispose();
+        child.castShadow = entry.cast;
+        worn.delete(child);
+    });
+}
+/** The world coordinate the covering has reached on `root`, or null when it is not under a wipe. */
+export function revealWipeLevelOf(root) {
+    return sweeps.get(root)?.level.value ?? null;
+}

package/dist/lib/scene-pass-mrt.d.ts

@@ -0,0 +1,12 @@
+import { mrt } from 'three/tsl';
+/** Unlit assets already contain their lighting; screen-space AO/GI must not light them again. */
+export declare function sceneLightingMask(): import("three/webgpu").VarNode<"vec4", import("three/webgpu").JoinNode<"vec4">>;
+/**
+ * The scene pass's attachments. three blends `output` by the material and leaves every other
+ * attachment unblended, so a transparent draw overwrites the whole of what it covers in the normals
+ * and the diffuse colour, however faint it is: a dust sprite's square was inked as an edge. With the
+ * material's blending on them, a draw that writes alpha 0 there (the dust's `mrtNode`) leaves them
+ * as they are, and an opaque draw, which has no blending, still overwrites.
+ */
+export declare function scenePassMrt(outputs: Parameters<typeof mrt>[0]): import("three/webgpu").MRTNode;
+//# sourceMappingURL=scene-pass-mrt.d.ts.map

package/dist/lib/scene-pass-mrt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-pass-mrt.d.ts","sourceRoot":"","sources":["../../src/lib/scene-pass-mrt.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,GAAG,EAAiB,MAAM,WAAW,CAAA;AAM5D,iGAAiG;AACjG,wBAAgB,iBAAiB,oFAKhC;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,kCAK9D"}

package/dist/lib/scene-pass-mrt.js

@@ -0,0 +1,23 @@
+import { MaterialBlending } from 'three';
+import { diffuseColor, mrt, uniform, vec4 } from 'three/tsl';
+import { BlendMode } from 'three/webgpu';
+import { importedUnlitMaterial } from './gltf-unlit';
+const materialBlend = new BlendMode(MaterialBlending);
+/** Unlit assets already contain their lighting; screen-space AO/GI must not light them again. */
+export function sceneLightingMask() {
+    const weight = uniform(1).onObjectUpdate(({ material }) => importedUnlitMaterial(material) ? 0 : 1);
+    return vec4(weight, 0, 0, diffuseColor.a);
+}
+/**
+ * The scene pass's attachments. three blends `output` by the material and leaves every other
+ * attachment unblended, so a transparent draw overwrites the whole of what it covers in the normals
+ * and the diffuse colour, however faint it is: a dust sprite's square was inked as an edge. With the
+ * material's blending on them, a draw that writes alpha 0 there (the dust's `mrtNode`) leaves them
+ * as they are, and an opaque draw, which has no blending, still overwrites.
+ */
+export function scenePassMrt(outputs) {
+    return mrt(outputs)
+        .setBlendMode('diffuseColor', materialBlend)
+        .setBlendMode('normal', materialBlend)
+        .setBlendMode('lighting', materialBlend);
+}

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-themes.d.ts

@@ -1,10 +1,10 @@
-import type { SurfaceRole } from '@pascal-app/core';
+import type { SitePresentation, SurfaceRole } from '@pascal-app/core';
 export type SceneTheme = {
     id: string;
     name: string;
     appearance: 'light' | 'dark';
     background: string;
-    backgroundSky?: string;
+    backgroundSky?: string | null;
     ground: string;
     ambient: {
         color: string;
@@ -15,16 +15,38 @@ export type SceneTheme = {
         ground: string;
         intensity: number;
     };
-    lights: Array<{
-        position: [number, number, number];
-        color: string;
-        intensity: number;
-        castShadow?: boolean;
-    }>;
+    lights: NonNullable<NonNullable<SitePresentation['lighting']>['lights']>;
     toneMappingExposure: number;
+    environment?: NonNullable<SitePresentation['lighting']>['environment'];
+    postprocessing?: SitePresentation['postprocessing'];
     clayTints?: Partial<Record<SurfaceRole, string>>;
 };
+export declare function projectSceneTheme(theme: SceneTheme, presentation?: SitePresentation): SceneTheme;
 export declare const SCENE_THEMES: SceneTheme[];
 export declare const SCENE_THEME_IDS: string[];
 export declare function getSceneTheme(id: string): SceneTheme;
+/**
+ * The dark mode the eye dives into under the ground: a neutral anthracite / slate grey, no hue.
+ * Neither dark scene theme is neutral (`night` is navy, `twilight` is purple), and a theme would
+ * be a thing the person picks, so the underground has its own palette, here beside the theme
+ * tokens (`lib/underground-ambiance.ts` is its one reader). Every stop is a grey (R = G = B);
+ * the backdrop is the theme backdrop's own gradient (`lib/backdrop.ts`) in these stops.
+ */
+export declare const UNDERGROUND_PALETTE: {
+    /** The backdrop looking down, most of the frame under the lid: slate grey. */
+    readonly background: '#4a4a4a';
+    /** The thin band hugging the horizon. */
+    readonly haze: '#666666';
+    /** The sky above the horizon, and its zenith. */
+    readonly sky: '#1b1b1b';
+    readonly skyDeep: '#111111';
+    /** The corners the vignette closes in to. */
+    readonly vignette: '#0c0c0c';
+    /** The thin rim along the cut of the hole in the ground, from above. */
+    readonly rim: '#3c3c3c';
+    /** The grade ring under the ground: a light rim where the ground meets the level. */
+    readonly ring: '#b4b4b4';
+    /** The sky light's tint (ambient and hemisphere pulled toward it under the ground). */
+    readonly tint: '#c8c8c8';
+};
 //# sourceMappingURL=scene-themes.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"scene-themes.d.ts","sourceRoot":"","sources":["../../src/lib/scene-themes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IAIZ,UAAU,EAAE,OAAO,GAAG,MAAM,CAAA;IAC5B,UAAU,EAAE,MAAM,CAAA;IAIlB,aAAa,CAAC,EAAE,MAAM,CAAA;IAItB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IAC7C,IAAI,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IACzD,MAAM,EAAE,KAAK,CAAC;QACZ,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;QAClC,KAAK,EAAE,MAAM,CAAA;QACb,SAAS,EAAE,MAAM,CAAA;QACjB,UAAU,CAAC,EAAE,OAAO,CAAA;KACrB,CAAC,CAAA;IACF,mBAAmB,EAAE,MAAM,CAAA;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAA;CACjD,CAAA;AAED,eAAO,MAAM,YAAY,EAAE,UAAU,EAoMpC,CAAA;AAED,eAAO,MAAM,eAAe,UAAwC,CAAA;AAIpE,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAEpD"}
+{"version":3,"file":"scene-themes.d.ts","sourceRoot":"","sources":["../../src/lib/scene-themes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAErE,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IAIZ,UAAU,EAAE,OAAO,GAAG,MAAM,CAAA;IAC5B,UAAU,EAAE,MAAM,CAAA;IAIlB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAI7B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IAC7C,IAAI,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IACzD,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;IACxE,mBAAmB,EAAE,MAAM,CAAA;IAC3B,WAAW,CAAC,EAAE,WAAW,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAA;IACtE,cAAc,CAAC,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,CAAA;IACnD,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAA;CACjD,CAAA;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,YAAY,CAAC,EAAE,gBAAgB,GAAG,UAAU,CAUhG;AAED,eAAO,MAAM,YAAY,EAAE,UAAU,EAoMpC,CAAA;AAED,eAAO,MAAM,eAAe,UAAwC,CAAA;AAIpE,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAEpD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB;IAC9B,8EAA8E;aAC9E,UAAU,EAAE,SAAS;IACrB,yCAAyC;aACzC,IAAI,EAAE,SAAS;IACf,iDAAiD;aACjD,GAAG,EAAE,SAAS;aACd,OAAO,EAAE,SAAS;IAClB,6CAA6C;aAC7C,QAAQ,EAAE,SAAS;IACnB,wEAAwE;aACxE,GAAG,EAAE,SAAS;IACd,qFAAqF;aACrF,IAAI,EAAE,SAAS;IACf,uFAAuF;aACvF,IAAI,EAAE,SAAS;CACP,CAAA"}

package/dist/lib/scene-themes.js

@@ -1,3 +1,15 @@
+export function projectSceneTheme(theme, presentation) {
+    if (!presentation)
+        return theme;
+    const { backgroundSky, ...lighting } = presentation.lighting ?? {};
+    return {
+        ...theme,
+        ...lighting,
+        ...(backgroundSky === undefined ? {} : { backgroundSky }),
+        toneMappingExposure: presentation.exposure ?? theme.toneMappingExposure,
+        postprocessing: presentation.postprocessing,
+    };
+}
 export const SCENE_THEMES = [
     {
         id: 'studio',
@@ -200,3 +212,27 @@ const SCENE_THEME_BY_ID = new Map(SCENE_THEMES.map((theme) => [theme.id, theme])
 export function getSceneTheme(id) {
     return SCENE_THEME_BY_ID.get(id) ?? SCENE_THEMES[0];
 }
+/**
+ * The dark mode the eye dives into under the ground: a neutral anthracite / slate grey, no hue.
+ * Neither dark scene theme is neutral (`night` is navy, `twilight` is purple), and a theme would
+ * be a thing the person picks, so the underground has its own palette, here beside the theme
+ * tokens (`lib/underground-ambiance.ts` is its one reader). Every stop is a grey (R = G = B);
+ * the backdrop is the theme backdrop's own gradient (`lib/backdrop.ts`) in these stops.
+ */
+export const UNDERGROUND_PALETTE = {
+    /** The backdrop looking down, most of the frame under the lid: slate grey. */
+    background: '#4a4a4a',
+    /** The thin band hugging the horizon. */
+    haze: '#666666',
+    /** The sky above the horizon, and its zenith. */
+    sky: '#1b1b1b',
+    skyDeep: '#111111',
+    /** The corners the vignette closes in to. */
+    vignette: '#0c0c0c',
+    /** The thin rim along the cut of the hole in the ground, from above. */
+    rim: '#3c3c3c',
+    /** The grade ring under the ground: a light rim where the ground meets the level. */
+    ring: '#b4b4b4',
+    /** The sky light's tint (ambient and hemisphere pulled toward it under the ground). */
+    tint: '#c8c8c8',
+};

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

@@ -5,11 +5,27 @@ import type { Object3D } from 'three';
  * - `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.
+ * - `ground-aside` — the site's ground while a level below grade is active: the floor is seen,
+ *   and clicked, where the ground was.
  */
-export type HiddenReason = 'isolated' | 'shadow-only' | 'batched' | 'wall-batched';
+export type HiddenReason = 'isolated' | 'shadow-only' | 'batched' | 'wall-batched' | 'ground-aside';
 /** 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;
+/**
+ * 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;
+/**
+ * The site's ground surfaces set aside, or stood back on, for one capture, whatever the person's
+ * view holds: a picture of a floor below grade sees through the ground, one of the whole building
+ * stands on it. The returned function gives the person's view back.
+ */
+export declare function temporarilySetGroundAside(surfaces: readonly Object3D[], aside: boolean): () => void;
+/** Add a capture-only mask without changing the live visibility reasons or batching. */
+export declare function temporarilyHideFromScene(root: Object3D, reason: HiddenReason): () => 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;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,aAAa,GAAG,SAAS,GAAG,cAAc,GAAG,cAAc,CAAA;AAmBnG,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;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,SAAS,QAAQ,EAAE,EAC7B,KAAK,EAAE,OAAO,GACb,MAAM,IAAI,CAYZ;AAED,wFAAwF;AACxF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,IAAI,CAczF"}

package/dist/lib/scene-visibility.js

@@ -34,16 +34,66 @@ 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']);
+}
+/**
+ * The site's ground surfaces set aside, or stood back on, for one capture, whatever the person's
+ * view holds: a picture of a floor below grade sees through the ground, one of the whole building
+ * stands on it. The returned function gives the person's view back.
+ */
+export function temporarilySetGroundAside(surfaces, aside) {
+    if (!aside) {
+        const restores = surfaces.map((surface) => temporarilyShowHeld(surface, ['ground-aside']));
+        return () => {
+            for (const restore of restores)
+                restore();
+        };
+    }
+    const held = surfaces.filter((surface) => !surface[HOLD]?.reasons.has('ground-aside'));
+    for (const surface of held)
+        hideFromScene(surface, 'ground-aside');
+    return () => {
+        for (const surface of held)
+            showInScene(surface, 'ground-aside');
+    };
+}
+/** Add a capture-only mask without changing the live visibility reasons or batching. */
+export function temporarilyHideFromScene(root, reason) {
+    const masks = new Map();
+    root.traverse((obj) => {
+        masks.set(obj, obj.layers.mask);
+        const hold = obj[HOLD];
+        const reasons = new Set(hold?.reasons);
+        // Changing level presentation must not reveal isolated geometry or duplicate batch shadows.
+        reasons.delete('shadow-only');
+        reasons.add(reason);
+        applyHold(obj, { original: hold?.original ?? obj.layers.mask, reasons });
+    });
+    return () => {
+        for (const [obj, mask] of masks)
+            obj.layers.mask = mask;
+    };
+}
+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/site-surfaces.d.ts

@@ -0,0 +1,32 @@
+import type { Object3D } from 'three';
+/**
+ * `userData` key marking the site's ground surfaces with their {@link SiteGroundRole}: the lines
+ * drawn on the ground (property line, setbacks, contours) carry none.
+ */
+export declare const SITE_GROUND = "siteGround";
+/**
+ * `userData` key marking the generic foundation under the buildings (footing and stem, drawn under
+ * the ground): a capture that sees through the veil leaves it out, as it left it out before it was drawn.
+ */
+export declare const SITE_FOUNDATION = "siteFoundation";
+/**
+ * `solid`: the lot's fill, its sculpted terrain, the horizon disc. `veil`: what is drawn in their
+ * place over a level below grade, the grade ring with it.
+ */
+export type SiteGroundRole = 'solid' | 'veil';
+/**
+ * The site's own shown surfaces (ground, horizon disc, property and setback lines, contours), not
+ * its registered children (buildings, items), which are groups.
+ */
+export declare function siteSurfaces(): Object3D[];
+/** The site's generic foundation meshes, shown or not. */
+export declare function siteFoundation(): Object3D[];
+/** The site's ground by role, shown or not: the veil is hidden until a level below grade is shown. */
+export declare function siteGround(): Record<SiteGroundRole, Object3D[]>;
+/**
+ * The ground veiled, or solid, for one capture, whatever the person's view shows: a picture of a
+ * floor below grade sees it through the veil, a picture of the whole building stands on solid
+ * ground. The returned function gives the person's view back.
+ */
+export declare function temporarilyVeilGround(veiled: boolean): () => void;
+//# sourceMappingURL=site-surfaces.d.ts.map

package/dist/lib/site-surfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-surfaces.d.ts","sourceRoot":"","sources":["../../src/lib/site-surfaces.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAGrC;;;GAGG;AACH,eAAO,MAAM,WAAW,eAAe,CAAA;AAEvC;;;GAGG;AACH,eAAO,MAAM,eAAe,mBAAmB,CAAA;AAE/C;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,CAAA;AAE7C;;;GAGG;AACH,wBAAgB,YAAY,IAAI,QAAQ,EAAE,CAUzC;AAED,0DAA0D;AAC1D,wBAAgB,cAAc,IAAI,QAAQ,EAAE,CAQ3C;AAED,sGAAsG;AACtG,wBAAgB,UAAU,IAAI,MAAM,CAAC,cAAc,EAAE,QAAQ,EAAE,CAAC,CAS/D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,CAYjE"}

package/dist/lib/site-surfaces.js

@@ -0,0 +1,70 @@
+import { sceneRegistry } from '@pascal-app/core';
+import { temporarilySetGroundAside } from './scene-visibility';
+/**
+ * `userData` key marking the site's ground surfaces with their {@link SiteGroundRole}: the lines
+ * drawn on the ground (property line, setbacks, contours) carry none.
+ */
+export const SITE_GROUND = 'siteGround';
+/**
+ * `userData` key marking the generic foundation under the buildings (footing and stem, drawn under
+ * the ground): a capture that sees through the veil leaves it out, as it left it out before it was drawn.
+ */
+export const SITE_FOUNDATION = 'siteFoundation';
+/**
+ * The site's own shown surfaces (ground, horizon disc, property and setback lines, contours), not
+ * its registered children (buildings, items), which are groups.
+ */
+export function siteSurfaces() {
+    const surfaces = [];
+    for (const siteId of sceneRegistry.byType.site ?? []) {
+        for (const child of sceneRegistry.nodes.get(siteId)?.children ?? []) {
+            if (child.visible && !(child.type === 'Group' && child.children.length > 0)) {
+                surfaces.push(child);
+            }
+        }
+    }
+    return surfaces;
+}
+/** The site's generic foundation meshes, shown or not. */
+export function siteFoundation() {
+    const foundation = [];
+    for (const siteId of sceneRegistry.byType.site ?? []) {
+        for (const child of sceneRegistry.nodes.get(siteId)?.children ?? []) {
+            if (child.userData[SITE_FOUNDATION] === true)
+                foundation.push(child);
+        }
+    }
+    return foundation;
+}
+/** The site's ground by role, shown or not: the veil is hidden until a level below grade is shown. */
+export function siteGround() {
+    const ground = { solid: [], veil: [] };
+    for (const siteId of sceneRegistry.byType.site ?? []) {
+        for (const child of sceneRegistry.nodes.get(siteId)?.children ?? []) {
+            const role = child.userData[SITE_GROUND];
+            if (role === 'solid' || role === 'veil')
+                ground[role].push(child);
+        }
+    }
+    return ground;
+}
+/**
+ * The ground veiled, or solid, for one capture, whatever the person's view shows: a picture of a
+ * floor below grade sees it through the veil, a picture of the whole building stands on solid
+ * ground. The returned function gives the person's view back.
+ */
+export function temporarilyVeilGround(veiled) {
+    const { solid, veil } = siteGround();
+    const restoreSolid = temporarilySetGroundAside(solid, veiled);
+    // Seen through a veil the footing under a floor below grade would show: the picture has none.
+    const restoreFoundation = veiled ? temporarilySetGroundAside(siteFoundation(), true) : () => { };
+    const flipped = veil.filter((surface) => surface.visible !== veiled);
+    for (const surface of flipped)
+        surface.visible = veiled;
+    return () => {
+        for (const surface of flipped)
+            surface.visible = !veiled;
+        restoreFoundation();
+        restoreSolid();
+    };
+}

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

@@ -2,6 +2,7 @@ import { type Camera, type Scene } from 'three';
 import { type WebGPURenderer } from 'three/webgpu';
 import type { SceneAtmosphereSource } from '../components/viewer/scene-atmosphere';
 import { type EdgeMode } from './edge-style';
+import type { SceneTheme } from './scene-themes';
 export declare const THUMBNAIL_WIDTH = 1920;
 export declare const THUMBNAIL_HEIGHT = 1080;
 /**
@@ -29,25 +30,55 @@ 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;
+        theme: SceneTheme;
         transparent: boolean;
         grade: boolean;
         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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"}