@pascal-app/viewer 1.0.4 → 1.0.6

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-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,8 +5,10 @@ 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. */
@@ -18,4 +20,12 @@ export declare function temporarilyShowShadowOnly(root: Object3D): () => void;
  * 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,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,IAAI,CAEtE"}
+{"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

@@ -44,6 +44,44 @@ export function temporarilyShowShadowOnly(root) {
 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) => {

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;
 /**
@@ -46,7 +47,7 @@ export type StudioBackdrop = {
 };
 export type SnapshotPipeline = {
     applyEnvironment: ({ theme, transparent, grade, edges, camera, }: {
-        theme: string;
+        theme: SceneTheme;
         transparent: boolean;
         grade: boolean;
         edges: EdgeMode;

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

package/dist/lib/snapshot-pipeline.js

@@ -2,13 +2,13 @@ import { Color, Matrix4, SRGBColorSpace, UnsignedByteType } from 'three';
 import { ssgi } from 'three/addons/tsl/display/SSGINode.js';
 import { denoise } from 'three/examples/jsm/tsl/display/DenoiseNode.js';
 import { fxaa } from 'three/examples/jsm/tsl/display/FXAANode.js';
-import { clamp, convertToTexture, diffuseColor, float, mix, mrt, normalView, output, renderOutput, sample, saturation, screenUV, smoothstep, uniform, vec2, vec3, vec4, } from 'three/tsl';
+import { clamp, convertToTexture, diffuseColor, float, mix, normalView, output, renderOutput, sample, saturation, screenUV, smoothstep, uniform, vec2, vec3, vec4, } from 'three/tsl';
 import { PassNode, RenderPipeline, RenderTarget, } from 'three/webgpu';
 import { GRADE_PARAMS, SSGI_PARAMS } from '../components/viewer/post-processing';
-import { backdropGradient, deepSkyColor, horizonHazeColor } from './backdrop';
+import { backdropColors, backdropGradient, flatBackdropOutput } from './backdrop';
 import { edgeColorFor, edgeOpacityScaleFor } from './edge-style';
 import { createEdgeDepthSampler, inkedEdges } from './ink-edges';
-import { getSceneTheme } from './scene-themes';
+import { sceneLightingMask, scenePassMrt } from './scene-pass-mrt';
 import { packNormalToRGB, unpackRGBToNormal } from './tsl-compat';
 export const THUMBNAIL_WIDTH = 1920;
 export const THUMBNAIL_HEIGHT = 1080;
@@ -64,7 +64,9 @@ export async function createSnapshotPipeline({ renderer, scene, camera, atmosphe
         const bgProjInvUniform = uniform(new Matrix4());
         const bgCamWorldUniform = uniform(new Matrix4());
         const bgMixUniform = uniform(1);
+        const flatBgMixUniform = uniform(0);
         const gradeMixUniform = uniform(0);
+        const aoMixUniform = uniform(1);
         const inkMixUniform = uniform(0);
         const inkColorUniform = uniform(new Color('#1a1d24'));
         const inkOpacityUniform = uniform(0.5);
@@ -72,10 +74,11 @@ export async function createSnapshotPipeline({ renderer, scene, camera, atmosphe
         // The scene pass owns MRT and its transparent clear, including when nested
         // inside FXAA's intermediate render target.
         const scenePass = new SnapshotScenePass('color', scene, camera);
-        scenePass.setMRT(mrt({
+        scenePass.setMRT(scenePassMrt({
             output,
             diffuseColor,
             normal: packNormalToRGB(normalView),
+            lighting: sceneLightingMask(),
         }));
         const scenePassColor = scenePass.getTextureNode('output');
         const scenePassDepth = scenePass.getTextureNode('depth');
@@ -83,10 +86,12 @@ export async function createSnapshotPipeline({ renderer, scene, camera, atmosphe
         const scenePassNormal = scenePass.getTextureNode('normal');
         scenePass.getTexture('diffuseColor').type = UnsignedByteType;
         scenePass.getTexture('normal').type = UnsignedByteType;
+        scenePass.getTexture('lighting').type = UnsignedByteType;
         const sceneNormal = sample((uv) => unpackRGBToNormal(scenePassNormal.sample(uv)));
         const giPass = ssgi(scenePassColor, scenePassDepth, sceneNormal, camera);
-        giPass.sliceCount.value = SSGI_PARAMS.sliceCount;
-        giPass.stepCount.value = SSGI_PARAMS.stepCount;
+        // A saved still has no later frames to hide the viewport's sampling noise.
+        giPass.sliceCount.value = 3;
+        giPass.stepCount.value = 8;
         giPass.radius.value = SSGI_PARAMS.radius;
         giPass.expFactor.value = SSGI_PARAMS.expFactor;
         giPass.thickness.value = SSGI_PARAMS.thickness;
@@ -107,13 +112,13 @@ export async function createSnapshotPipeline({ renderer, scene, camera, atmosphe
         // horizon picks up a visible AO line in captures.
         const aoFarFade = smoothstep(float(0.9994), float(0.9998), sampleEdgeDepth(screenUV));
         const ao = mix(denoisePass.r, float(1), aoFarFade);
-        const aoRgb = scenePassColor.rgb.mul(ao);
+        const aoRgb = scenePassColor.rgb.mul(mix(float(1), ao, scenePass.getTextureNode('lighting').r.mul(aoMixUniform)));
         // Ink edges, mirroring the viewport pipeline (AO → ink → grade) so
         // captures carry the same soft/strong edge look the canvas shows.
         // Uniform-gated like grade/backdrop: one cached pipeline serves all modes.
         // Radius scales with render height: a supersampled capture (4K → 1080p)
         // would otherwise halve the apparent line weight vs the viewport's 1px.
-        const inkRadius = Math.max(1, Math.round(renderer.domElement.height / 1080));
+        const inkRadius = uniform(1);
         const inkedRgb = inkedEdges({
             sceneRgb: aoRgb,
             sampleDepth: sampleEdgeDepth,
@@ -167,7 +172,17 @@ export async function createSnapshotPipeline({ renderer, scene, camera, atmosphe
         else {
             // FXAA requires a texture node as input; convertToTexture renders finalOutput
             // into an intermediate RT so FXAA can sample it with neighbour UV offsets.
-            pipeline.outputNode = fxaa(convertToTexture(finalOutput));
+            const flatOutput = flatBackdropOutput({
+                background: bgColorUniform,
+                foreground: sceneRgb,
+                alpha,
+                toneMapping: renderer.toneMapping,
+                outputColorSpace: renderer.outputColorSpace,
+            });
+            const antialiased = fxaa(convertToTexture(mix(finalOutput, flatOutput, flatBgMixUniform)));
+            // One FXAA pass serves both inputs; transform only the linear input at output.
+            pipeline.outputColorTransform = false;
+            pipeline.outputNode = mix(renderOutput(antialiased, renderer.toneMapping, renderer.outputColorSpace), antialiased, flatBgMixUniform);
         }
         // Dedicated render target — pipeline outputs here instead of the canvas,
         // so R3F's main render loop can never overwrite our capture.
@@ -175,17 +190,21 @@ export async function createSnapshotPipeline({ renderer, scene, camera, atmosphe
         const renderTarget = new RenderTarget(width, height, { depthBuffer: true });
         return {
             applyEnvironment: ({ theme, transparent, grade, edges, camera: captureCamera }) => {
-                const sceneTheme = getSceneTheme(theme);
+                const sceneTheme = theme;
+                const backdrop = backdropColors(sceneTheme);
                 inkMixUniform.value = edges === 'off' ? 0 : 1;
                 inkOpacityUniform.value = edges === 'strong' ? 1 : 0.5;
                 inkColorUniform.value.set(edgeColorFor(sceneTheme.background));
                 inkOpacityScaleUniform.value = edgeOpacityScaleFor(sceneTheme.background);
                 bgColorUniform.value.set(sceneTheme.background);
-                bgSkyUniform.value.set(sceneTheme.backgroundSky ?? sceneTheme.background);
-                bgSkyDeepUniform.value.set(deepSkyColor(sceneTheme.backgroundSky ?? sceneTheme.background));
-                bgHazeUniform.value.set(horizonHazeColor(sceneTheme.backgroundSky ?? sceneTheme.background, sceneTheme.appearance));
+                bgSkyUniform.value.set(backdrop.sky);
+                bgSkyDeepUniform.value.set(backdrop.skyDeep);
+                bgHazeUniform.value.set(backdrop.haze);
                 bgMixUniform.value = transparent ? 0 : 1;
-                gradeMixUniform.value = grade ? 1 : 0;
+                flatBgMixUniform.value =
+                    !transparent && !atmosphere && sceneTheme.backgroundSky === null ? 1 : 0;
+                gradeMixUniform.value = grade && sceneTheme.postprocessing?.colorGrading !== false ? 1 : 0;
+                aoMixUniform.value = sceneTheme.postprocessing?.ambientOcclusion === false ? 0 : 1;
                 // The capture camera never joins the scene graph, so its matrixWorld
                 // is only refreshed by the render itself — too late for the backdrop
                 // uniforms below.
@@ -197,6 +216,7 @@ export async function createSnapshotPipeline({ renderer, scene, camera, atmosphe
                 const standardW = standardSize?.w ?? THUMBNAIL_WIDTH;
                 const standardH = standardSize?.h ?? THUMBNAIL_HEIGHT;
                 const { width: captureWidth, height: captureHeight } = renderer.domElement;
+                inkRadius.value = Math.max(1, Math.round(captureHeight / 1080));
                 // Resize RT if the canvas dimensions changed
                 if (renderTarget.width !== captureWidth || renderTarget.height !== captureHeight) {
                     renderTarget.setSize(captureWidth, captureHeight);
@@ -351,7 +371,7 @@ export async function createPlainSnapshotPipeline({ renderer, scene, camera, })
         return {
             applyEnvironment: ({ theme, transparent: alpha }) => {
                 transparent = alpha;
-                background.set(getSceneTheme(theme).background);
+                background.set(theme.background);
             },
             capture: async ({ captureMode, cropRegion, standardSize }) => {
                 const standardW = standardSize?.w ?? THUMBNAIL_WIDTH;

package/dist/lib/tsl-compat.d.ts

@@ -7,6 +7,6 @@
  * @types/three pin) once tsgo handles the 0.185 types; the `typeof` references
  * to the removed old names will fail the build as a reminder.
  */
-export declare const packNormalToRGB: (node: import("three/webgpu").Node) => import("three/webgpu").Node<"vec3">;
-export declare const unpackRGBToNormal: (node: import("three/webgpu").Node) => import("three/webgpu").Node<"vec3">;
+export declare const packNormalToRGB: (node: import("three/webgpu").Node<"vec3"> | import("three").Vector3) => import("three/webgpu").Node<"vec3">;
+export declare const unpackRGBToNormal: (node: import("three/webgpu").Node<"vec3"> | import("three/webgpu").Node<"vec4"> | import("three").Vector3) => import("three/webgpu").Node<"vec3">;
 //# sourceMappingURL=tsl-compat.d.ts.map

package/dist/lib/tsl-compat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tsl-compat.d.ts","sourceRoot":"","sources":["../../src/lib/tsl-compat.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,4EACV,CAAA;AAClB,eAAO,MAAM,iBAAiB,4EAEX,CAAA"}
+{"version":3,"file":"tsl-compat.d.ts","sourceRoot":"","sources":["../../src/lib/tsl-compat.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,8GACV,CAAA;AAClB,eAAO,MAAM,iBAAiB,oJAEX,CAAA"}