@pascal-app/viewer 1.0.4 → 1.0.6

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

@@ -1,7 +1,8 @@
-import type { AnyNode, BaseNode, BuildingNode, LevelNode, UnitNode, ZoneNode } from '@pascal-app/core';
+import type { AnyNode, BaseNode, BuildingNode, GroundBox, LevelGradeStanding, LevelNode, SitePresentation, UnitNode, ZoneNode } from '@pascal-app/core';
 import type { Object3D } from 'three';
 import type { EdgeMode } from '../lib/edge-style';
 import type { ColorPreset, RenderShading } from '../lib/materials';
+import { type SceneTheme } from '../lib/scene-themes';
 export type RenderContext = 'editor' | 'viewer';
 export type MetricNotation = 'meters' | 'millimeters';
 export type WallMode = 'up' | 'cutaway' | 'down' | 'translucent';
@@ -15,6 +16,14 @@ type Outliner = {
     selectedObjects: Object3D[];
     hoveredObjects: Object3D[];
 };
+type LookDefaults = {
+    theme: string;
+    edges: EdgeMode;
+    shadows: boolean;
+};
+type LocalLook = Partial<LookDefaults> & {
+    shadingByContext?: Partial<Record<RenderContext, RenderShading>>;
+};
 type ViewerState = {
     selection: SelectionPath;
     focusedUnitId: UnitNode['id'] | null;
@@ -25,6 +34,11 @@ type ViewerState = {
      * selection paths without changing the local user's editable selection. */
     externalSelectedIds: BaseNode['id'][];
     setExternalSelectedIds: (ids: BaseNode['id'][]) => void;
+    /** Elements a chat context chip points at (Point and ask), drawn in the `point` outline style.
+     * Its own slot, so a teammate's highlight in `externalSelectedIds` is never clobbered. */
+    pointedIds: BaseNode['id'][];
+    /** `null` clears it. */
+    setPointedIds: (ids: BaseNode['id'][] | null) => void;
     hoverHighlightMode: string;
     setHoverHighlightMode: (mode: string) => void;
     hoveredId: AnyNode['id'] | ZoneNode['id'] | null;
@@ -32,14 +46,21 @@ type ViewerState = {
     cameraMode: 'perspective' | 'orthographic';
     setCameraMode: (mode: 'perspective' | 'orthographic') => void;
     sceneTheme: string;
-    /** The user's own pick, and the only theme that persists. */
+    sceneAppearance: SceneTheme;
+    lookDefaults: LookDefaults;
+    projectPresentation?: SitePresentation;
+    setProjectPresentation: (presentation: SitePresentation | undefined) => void;
+    resetProjectLook: () => void;
+    previewSceneTheme: string | null;
+    contextDefaultShading: RenderShading;
+    /** The selected project/global theme before a temporary preview. */
     savedSceneTheme: string;
     setSceneTheme: (id: string) => void;
     /** Show a theme without saving it (e.g. a project's own mood); `null`
      *  returns to the saved one. */
     showSceneTheme: (id: string | null) => void;
     renderContext: RenderContext;
-    setRenderContext: (context: RenderContext) => void;
+    setRenderContext: (context: RenderContext, defaultShading?: RenderShading) => void;
     /** True during a GLB bake/export pass. Renderers that normally draw via a
      * collective InstancedMesh (`def.system`) and mount only an invisible per-node
      * proxy can watch this to emit real, visible geometry so the exporter — which
@@ -84,6 +105,81 @@ type ViewerState = {
      * while editing; never persisted, so the viewer app keeps its own mode.
      */
     hideLevelsAboveSelection: boolean;
+    /**
+     * The levels a construction reveal is playing on (a build, an undo, a move): each shows while its
+     * work plays, whatever the level display hides, so the animation is seen. Set by the reveal, never
+     * persisted; the author's own hiding of a level still wins.
+     */
+    levelsRevealing: readonly string[];
+    /**
+     * The nodes a construction reveal is playing now (moving in, going out, carried, or an edit
+     * replaying): the cutaway leaves each of them, and the openings it hosts, in view while it
+     * plays, whatever the wall mode. Set by the reveal, never persisted; the person's own wall mode
+     * is not written.
+     */
+    nodesRevealing: readonly string[];
+    /**
+     * The level shown lies below grade, the storeys above it hidden. Set by the host's level display
+     * beside `hideLevelsAboveSelection`; never persisted. Whether the ground over it is veiled also
+     * depends on `groundMode`: read both through `groundVeiled`.
+     */
+    belowGrade: boolean;
+    /**
+     * The shown level's standing against the sculpted terrain, set beside `belowGrade`:
+     * only partly below grade, the ground veils just where it stands in the way (the ground
+     * window), not wholesale.
+     */
+    gradeStanding: LevelGradeStanding;
+    /**
+     * The box the ground window opens for: the shown level, or the whole building when it is
+     * shown. Set by the host (never on the site phase, where the ground is the work); never
+     * persisted. `null` closes the window.
+     */
+    groundWindowBox: GroundBox | null;
+    /** Ground stands between the eye and `groundWindowBox` now, set by the site renderer. */
+    groundWindowVeiled: boolean;
+    /** The person's choice for the ground over a level below grade. Not persisted. */
+    groundMode: GroundMode;
+    setGroundMode: (mode: GroundMode) => void;
+    /**
+     * The scene has a level below grade (the below-grade footprint is not empty): set by the site
+     * renderer. The ground materials carry the hole's mask, and the eye's fill light is mounted,
+     * from the moment this is true, so that changing floors changes uniforms and never materials
+     * or the light count; scenes without a level below grade keep plain materials. Never persisted.
+     */
+    hasLevelBelowGrade: boolean;
+    /**
+     * The host lets the eye dive under the ground (the editor's orbit may, with the ground on Auto).
+     * The eye's fill light is mounted, from the moment this is true, so that the first crossing of the
+     * ground compiles nothing: a scene with no level below grade is dived under as well. Set by the
+     * host's camera; never persisted.
+     */
+    diveAvailable: boolean;
+    /**
+     * The eye lies under the ground at its own position (a free orbit under the lid). Set by the
+     * viewer's underground ambiance from the camera; never persisted.
+     */
+    eyeUnderGround: boolean;
+    /**
+     * Levels whose foundation a plugin is drawing under the ground right now (a framing plugin pours
+     * the real footing and stem from the building's record). The generic foundation derived from the
+     * walls is not drawn under these levels, so nothing is drawn twice. Written by that plugin while
+     * its meshes are mounted, empty otherwise; never persisted.
+     */
+    pluginFoundationLevelIds: readonly string[];
+    /**
+     * The world is turned, or turning, to earth (the underground ambiance's factor is above 0).
+     * Its factor itself eases every frame and lives with the shaders, not here; this flips only at
+     * the crossing's ends. Set by the viewer's underground ambiance; never persisted.
+     */
+    ambianceActive: boolean;
+    /**
+     * How the ground reads as a medium: the edge of the hole over a level below grade and the
+     * crossing as the eye dives under the ground. Variants the owner and the team choose from;
+     * every one is a uniform, so changing it compiles nothing. Never persisted.
+     */
+    undergroundLook: UndergroundLook;
+    setUndergroundLook: (look: Partial<UndergroundLook>) => void;
     wallMode: WallMode;
     setWallMode: (mode: WallMode) => void;
     showScans: boolean;
@@ -103,6 +199,7 @@ type ViewerState = {
     projectId: string | null;
     setProjectId: (id: string | null) => void;
     projectPreferences: Record<string, {
+        look?: LocalLook;
         showScans?: boolean;
         showGuides?: boolean;
         showGrid?: boolean;
@@ -140,28 +237,33 @@ type ViewerState = {
     inputDragging: boolean;
     setInputDragging: (dragging: boolean) => void;
 };
-declare const useViewer: import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<ViewerState>, "setState" | "persist"> & {
-    setState(partial: ViewerState | Partial<ViewerState> | ((state: ViewerState) => ViewerState | Partial<ViewerState>), replace?: false | undefined): unknown;
+/** The owner's pick (16 Oct): the section cut's clean edge over earth walls, and the simple fade. */
+export declare const DEFAULT_UNDERGROUND_LOOK: UndergroundLook;
+declare const useViewer: import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<ViewerState>, "persist" | "setState"> & {
+    setState(partial: Partial<ViewerState> | ViewerState | ((state: ViewerState) => Partial<ViewerState> | ViewerState), replace?: false | undefined): unknown;
     setState(state: ViewerState | ((state: ViewerState) => ViewerState), replace: true): unknown;
     persist: {
         setOptions: (options: Partial<import("zustand/middleware").PersistOptions<ViewerState, {
-            metricNotation: MetricNotation;
-            levelMode: "manual" | "stacked" | "exploded" | "solo";
-            wallMode: WallMode;
-            projectPreferences: Record<string, {
-                showScans?: boolean;
-                showGuides?: boolean;
-                showGrid?: boolean;
-                showMeasurements?: boolean;
-            }>;
-            unit?: "metric" | "imperial" | undefined;
-            cameraMode: "perspective" | "orthographic";
+            cameraMode: "orthographic" | "perspective";
             sceneTheme: string;
             shadingByContext: Partial<Record<RenderContext, RenderShading>>;
             textures: boolean;
             colorPreset: ColorPreset;
             edges: EdgeMode;
             shadows: boolean;
+            unit?: "imperial" | "metric" | undefined;
+            metricNotation: MetricNotation;
+            levelMode: "exploded" | "manual" | "solo" | "stacked";
+            wallMode: WallMode;
+            projectPreferences: {
+                [k: string]: {
+                    look?: LocalLook;
+                    showScans?: boolean;
+                    showGuides?: boolean;
+                    showGrid?: boolean;
+                    showMeasurements?: boolean;
+                };
+            };
         }, unknown>>) => void;
         clearStorage: () => void;
         rehydrate: () => Promise<void> | void;
@@ -169,26 +271,81 @@ declare const useViewer: import("zustand").UseBoundStore<Omit<import("zustand").
         onHydrate: (fn: (state: ViewerState) => void) => () => void;
         onFinishHydration: (fn: (state: ViewerState) => void) => () => void;
         getOptions: () => Partial<import("zustand/middleware").PersistOptions<ViewerState, {
-            metricNotation: MetricNotation;
-            levelMode: "manual" | "stacked" | "exploded" | "solo";
-            wallMode: WallMode;
-            projectPreferences: Record<string, {
-                showScans?: boolean;
-                showGuides?: boolean;
-                showGrid?: boolean;
-                showMeasurements?: boolean;
-            }>;
-            unit?: "metric" | "imperial" | undefined;
-            cameraMode: "perspective" | "orthographic";
+            cameraMode: "orthographic" | "perspective";
             sceneTheme: string;
             shadingByContext: Partial<Record<RenderContext, RenderShading>>;
             textures: boolean;
             colorPreset: ColorPreset;
             edges: EdgeMode;
             shadows: boolean;
+            unit?: "imperial" | "metric" | undefined;
+            metricNotation: MetricNotation;
+            levelMode: "exploded" | "manual" | "solo" | "stacked";
+            wallMode: WallMode;
+            projectPreferences: {
+                [k: string]: {
+                    look?: LocalLook;
+                    showScans?: boolean;
+                    showGuides?: boolean;
+                    showGrid?: boolean;
+                    showMeasurements?: boolean;
+                };
+            };
         }, unknown>>;
     };
 }>;
+/**
+ * Over a level below grade the ground is `auto`: drawn as a faint veil, so the floor under it is
+ * seen and clicked; `solid` keeps it as it is everywhere else.
+ */
+export type GroundMode = 'auto' | 'solid';
+/**
+ * The hole's edge seen from above: `noise` the eroded, scalloped border (today's), `quiet` the
+ * same with a fine, faint noise (almost straight from the default camera), `section` an
+ * architect's section cut (a constant offset of the footprint, straight edges, a flat face with a
+ * thin line at grade), `section-earth` the same outline over the earth's walls (topsoil, strata,
+ * a low crumble that is zero at the rim).
+ */
+export type UndergroundEdge = 'noise' | 'quiet' | 'section' | 'section-earth';
+/** The dive under the ground: `noise` closes a noise mask over the screen, `fade` fades the whole frame at once. */
+export type UndergroundTransition = 'noise' | 'fade';
+export type UndergroundLook = {
+    edge: UndergroundEdge;
+    transition: UndergroundTransition;
+};
+/**
+ * Whether the site's ground is drawn as a veil wholesale: a level below grade is shown, the
+ * ground on auto. A level only partly below grade is the exception — there the ground window
+ * veils just the ground in the way, and the rest stays solid. The walkthrough walks on its
+ * floors: its ground is always solid, whatever level the overview had shown.
+ */
+export declare function groundVeiled(state: {
+    belowGrade: boolean;
+    groundMode: GroundMode;
+    gradeStanding?: LevelGradeStanding;
+    walkthroughMode?: boolean;
+}): boolean;
+/** Whether any ground is veiled now, wholesale or through the eye's window. */
+export declare function anyGroundVeiled(state: {
+    belowGrade: boolean;
+    groundMode: GroundMode;
+    gradeStanding?: LevelGradeStanding;
+    groundWindowVeiled: boolean;
+    walkthroughMode?: boolean;
+}): boolean;
+/**
+ * Whether the site draws its own ground. `showGround: false` says other geometry supplies the
+ * ground (an authored landscape), which stands on a level above a basement; while a level below
+ * grade is shown, the level display hides the storeys above it (`belowGrade`) and the landscape
+ * with them. The site's ground stands in then, with its veil, hole and pit, so the basement is
+ * seen through an opening and not through nothing. With a level at or above grade shown, the
+ * landscape is shown and `showGround` is the author's.
+ */
+export declare function siteGroundShown(site: {
+    showGround?: boolean;
+}, state: {
+    belowGrade: boolean;
+}): boolean;
 /** Apply an authoritative country code (e.g. IP-derived by the host app) as
  * the unit default. Stronger signal than the timezone heuristic used at store
  * creation, but still a default: it never overrides an explicit user choice

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":"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"}

package/dist/store/use-viewer.js

@@ -1,7 +1,7 @@
 'use client';
 import { create } from 'zustand';
 import { persist } from 'zustand/middleware';
-import { SCENE_THEME_IDS } from '../lib/scene-themes';
+import { getSceneTheme, projectSceneTheme, SCENE_THEME_IDS, } from '../lib/scene-themes';
 const CAMERA_MODES = ['perspective', 'orthographic'];
 const RENDER_SHADINGS = ['solid', 'rendered'];
 const COLOR_PRESETS = ['clay', 'white', 'mono', 'blueprint'];
@@ -89,7 +89,24 @@ function normalizeProjectPreferences(value) {
         if (!preferences || typeof preferences !== 'object' || Array.isArray(preferences))
             continue;
         const record = preferences;
+        const look = record.look && typeof record.look === 'object'
+            ? record.look
+            : undefined;
         next[projectId] = {
+            ...(look
+                ? {
+                    look: {
+                        ...(typeof look.theme === 'string' && SCENE_THEME_IDS.includes(look.theme)
+                            ? { theme: look.theme }
+                            : {}),
+                        ...(typeof look.edges === 'string' && EDGE_MODES.includes(look.edges)
+                            ? { edges: look.edges }
+                            : {}),
+                        ...(typeof look.shadows === 'boolean' ? { shadows: look.shadows } : {}),
+                        shadingByContext: normalizeShadingByContext(look.shadingByContext),
+                    },
+                }
+                : {}),
             ...(typeof record.showScans === 'boolean' ? { showScans: record.showScans } : {}),
             ...(typeof record.showGuides === 'boolean' ? { showGuides: record.showGuides } : {}),
             ...(typeof record.showGrid === 'boolean' ? { showGrid: record.showGrid } : {}),
@@ -120,6 +137,47 @@ function normalizePersistedViewerState(value) {
         projectPreferences: normalizeProjectPreferences(state.projectPreferences),
     };
 }
+/** The owner's pick (16 Oct): the section cut's clean edge over earth walls, and the simple fade. */
+export const DEFAULT_UNDERGROUND_LOOK = {
+    edge: 'section-earth',
+    transition: 'fade',
+};
+function resolveLook(state, patch) {
+    const next = { ...state, ...patch };
+    const local = next.projectPreferences[next.projectId ?? '']?.look;
+    const savedTheme = local?.theme ?? next.projectPresentation?.theme ?? next.lookDefaults.theme;
+    const theme = getSceneTheme(next.previewSceneTheme ?? savedTheme);
+    return {
+        ...patch,
+        savedSceneTheme: savedTheme,
+        sceneTheme: theme.id,
+        sceneAppearance: projectSceneTheme(theme, next.previewSceneTheme === null && !local?.theme ? next.projectPresentation : undefined),
+        shading: local?.shadingByContext?.[next.renderContext] ??
+            next.projectPresentation?.shading ??
+            next.shadingByContext[next.renderContext] ??
+            next.contextDefaultShading,
+        edges: local?.edges ?? next.projectPresentation?.edges ?? next.lookDefaults.edges,
+        shadows: local?.shadows ?? next.projectPresentation?.shadows ?? next.lookDefaults.shadows,
+    };
+}
+function chooseLook(state, look) {
+    const key = state.projectId ?? '';
+    const previous = state.projectPreferences[key];
+    const { shadingByContext, ...defaults } = look;
+    return resolveLook(state, {
+        ...(!state.projectId
+            ? {
+                lookDefaults: { ...state.lookDefaults, ...defaults },
+                shadingByContext: { ...state.shadingByContext, ...shadingByContext },
+            }
+            : {}),
+        projectPreferences: {
+            ...state.projectPreferences,
+            [key]: { ...previous, look: { ...previous?.look, ...look } },
+        },
+        ...('theme' in look ? { previewSceneTheme: null } : {}),
+    });
+}
 const useViewer = create()(persist((set) => ({
     selection: { buildingId: null, levelId: null, zoneId: null, selectedIds: [] },
     focusedUnitId: null,
@@ -134,6 +192,15 @@ const useViewer = create()(persist((set) => ({
         }
         return { externalSelectedIds: ids };
     }),
+    pointedIds: [],
+    setPointedIds: (ids) => set((state) => {
+        const next = ids ?? [];
+        if (state.pointedIds.length === next.length &&
+            state.pointedIds.every((id, index) => id === next[index])) {
+            return state;
+        }
+        return { pointedIds: next };
+    }),
     hoverHighlightMode: 'default',
     setHoverHighlightMode: (mode) => set((state) => (state.hoverHighlightMode === mode ? state : { hoverHighlightMode: mode })),
     hoveredId: null,
@@ -141,11 +208,24 @@ const useViewer = create()(persist((set) => ({
     cameraMode: 'perspective',
     setCameraMode: (mode) => set({ cameraMode: mode }),
     sceneTheme: 'studio',
+    sceneAppearance: getSceneTheme('studio'),
+    lookDefaults: { theme: 'studio', edges: 'soft', shadows: true },
+    projectPresentation: undefined,
+    setProjectPresentation: (projectPresentation) => set((state) => resolveLook(state, { projectPresentation })),
+    resetProjectLook: () => set((state) => {
+        const projectPreferences = { ...state.projectPreferences };
+        const key = state.projectId ?? '';
+        const { look: _look, ...rest } = projectPreferences[key] ?? {};
+        projectPreferences[key] = rest;
+        return resolveLook(state, { projectPreferences, previewSceneTheme: null });
+    }),
+    previewSceneTheme: null,
+    contextDefaultShading: 'rendered',
     savedSceneTheme: 'studio',
-    setSceneTheme: (id) => set({ sceneTheme: id, savedSceneTheme: id }),
-    showSceneTheme: (id) => set((state) => ({ sceneTheme: id ?? state.savedSceneTheme })),
+    setSceneTheme: (id) => set((state) => chooseLook(state, { theme: id })),
+    showSceneTheme: (id) => set((state) => resolveLook(state, { previewSceneTheme: id })),
     renderContext: 'editor',
-    setRenderContext: (context) => set({ renderContext: context }),
+    setRenderContext: (context, defaultShading = 'rendered') => set((state) => resolveLook(state, { renderContext: context, contextDefaultShading: defaultShading })),
     isExporting: false,
     setExporting: (value) => set({ isExporting: value }),
     itemLoadFailures: {},
@@ -163,18 +243,20 @@ const useViewer = create()(persist((set) => ({
     setRenderPaused: (value) => set({ renderPaused: value }),
     shading: 'rendered',
     shadingByContext: {},
-    setShading: (shading) => set((state) => ({
-        shading,
-        shadingByContext: { ...state.shadingByContext, [state.renderContext]: shading },
+    setShading: (shading) => set((state) => chooseLook(state, {
+        shadingByContext: {
+            ...state.projectPreferences[state.projectId ?? '']?.look?.shadingByContext,
+            [state.renderContext]: shading,
+        },
     })),
     textures: true,
     setTextures: (textures) => set({ textures }),
     colorPreset: 'clay',
     setColorPreset: (preset) => set({ colorPreset: preset }),
     edges: 'soft',
-    setEdges: (edges) => set({ edges }),
+    setEdges: (edges) => set((state) => chooseLook(state, { edges })),
     shadows: true,
-    setShadows: (shadows) => set({ shadows }),
+    setShadows: (shadows) => set((state) => chooseLook(state, { shadows })),
     unit: detectDefaultUnit(),
     metricNotation: 'meters',
     unitExplicit: false,
@@ -183,6 +265,21 @@ const useViewer = create()(persist((set) => ({
     levelMode: 'stacked',
     setLevelMode: (mode) => set({ levelMode: mode }),
     hideLevelsAboveSelection: false,
+    levelsRevealing: [],
+    nodesRevealing: [],
+    belowGrade: false,
+    gradeStanding: 'at-grade',
+    groundWindowBox: null,
+    groundWindowVeiled: false,
+    groundMode: 'auto',
+    setGroundMode: (mode) => set({ groundMode: mode }),
+    hasLevelBelowGrade: false,
+    diveAvailable: false,
+    eyeUnderGround: false,
+    pluginFoundationLevelIds: [],
+    ambianceActive: false,
+    undergroundLook: DEFAULT_UNDERGROUND_LOOK,
+    setUndergroundLook: (look) => set((state) => ({ undergroundLook: { ...state.undergroundLook, ...look } })),
     wallMode: 'up',
     setWallMode: (mode) => set({ wallMode: mode }),
     showScans: true,
@@ -237,16 +334,20 @@ const useViewer = create()(persist((set) => ({
     setInkOpacity: (opacity) => set({ inkOpacity: opacity }),
     projectId: null,
     setProjectId: (id) => set((state) => {
-        if (!id)
-            return { projectId: id };
-        const prefs = state.projectPreferences?.[id] || {};
-        return {
+        if (id === state.projectId)
+            return state;
+        const prefs = (id && state.projectPreferences?.[id]) || {};
+        const { '': _unscoped, ...projectPreferences } = state.projectPreferences;
+        return resolveLook(state, {
             projectId: id,
+            projectPreferences,
+            projectPresentation: undefined,
+            previewSceneTheme: null,
             showScans: prefs.showScans ?? true,
             showGuides: prefs.showGuides ?? true,
             showGrid: prefs.showGrid ?? true,
             showMeasurements: prefs.showMeasurements ?? true,
-        };
+        });
     }),
     projectPreferences: {},
     setSelection: (updates) => set((state) => {
@@ -303,24 +404,59 @@ const useViewer = create()(persist((set) => ({
         return {
             ...currentState,
             ...persisted,
-            savedSceneTheme: persisted.sceneTheme ?? currentState.savedSceneTheme,
+            ...resolveLook(currentState, {
+                ...persisted,
+                lookDefaults: {
+                    theme: persisted.sceneTheme ?? currentState.lookDefaults.theme,
+                    edges: persisted.edges ?? currentState.lookDefaults.edges,
+                    shadows: persisted.shadows ?? currentState.lookDefaults.shadows,
+                },
+            }),
         };
     },
     partialize: (state) => ({
         cameraMode: state.cameraMode,
-        sceneTheme: state.savedSceneTheme,
+        sceneTheme: state.lookDefaults.theme,
         shadingByContext: state.shadingByContext,
         textures: state.textures,
         colorPreset: state.colorPreset,
-        edges: state.edges,
-        shadows: state.shadows,
+        edges: state.lookDefaults.edges,
+        shadows: state.lookDefaults.shadows,
         ...(state.unitExplicit ? { unit: state.unit } : {}),
         metricNotation: state.metricNotation,
         levelMode: state.levelMode,
         wallMode: state.wallMode,
-        projectPreferences: state.projectPreferences,
+        projectPreferences: Object.fromEntries(Object.entries(state.projectPreferences).filter(([key]) => key !== '')),
     }),
 }));
+/**
+ * Whether the site's ground is drawn as a veil wholesale: a level below grade is shown, the
+ * ground on auto. A level only partly below grade is the exception — there the ground window
+ * veils just the ground in the way, and the rest stays solid. The walkthrough walks on its
+ * floors: its ground is always solid, whatever level the overview had shown.
+ */
+export function groundVeiled(state) {
+    return (state.belowGrade &&
+        state.groundMode === 'auto' &&
+        state.gradeStanding !== 'partly-below-grade' &&
+        state.walkthroughMode !== true);
+}
+/** Whether any ground is veiled now, wholesale or through the eye's window. */
+export function anyGroundVeiled(state) {
+    return (groundVeiled(state) ||
+        (state.groundMode === 'auto' && state.groundWindowVeiled && state.walkthroughMode !== true));
+}
+/**
+ * Whether the site draws its own ground. `showGround: false` says other geometry supplies the
+ * ground (an authored landscape), which stands on a level above a basement; while a level below
+ * grade is shown, the level display hides the storeys above it (`belowGrade`) and the landscape
+ * with them. The site's ground stands in then, with its veil, hole and pit, so the basement is
+ * seen through an opening and not through nothing. With a level at or above grade shown, the
+ * landscape is shown and `showGround` is the author's.
+ */
+export function siteGroundShown(site, state) {
+    return site.showGround !== false || state.belowGrade;
+}
 /** Apply an authoritative country code (e.g. IP-derived by the host app) as
  * the unit default. Stronger signal than the timezone heuristic used at store
  * creation, but still a default: it never overrides an explicit user choice

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

@@ -1 +1 @@
-{"version":3,"file":"ceiling-system.d.ts","sourceRoot":"","sources":["../../../src/systems/ceiling/ceiling-system.tsx"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,kBAAkB,EAYvB,QAAQ,EACT,MAAM,kBAAkB,CAAA;AAEzB,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAI9B,iFAAiF;AACjF,eAAO,MAAM,mBAAmB,mBAAmB,CAAA;AAEnD;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,KAAK,KAAK,CAAC,QAAQ,CAAA;AAE5F,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAA;AAa/D,eAAO,MAAM,aAAa,YA4BzB,CAAA;AAsCD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,KAAK,CAAC,IAAI,EAChB,UAAU,GAAE,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAM,EAC/C,KAAK,GAAE,UAAsC,QA8C9C;AAqDD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,WAAW,EACxB,UAAU,GAAE,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAM,GAC9C,KAAK,CAAC,cAAc,CA6DtB"}
+{"version":3,"file":"ceiling-system.d.ts","sourceRoot":"","sources":["../../../src/systems/ceiling/ceiling-system.tsx"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,kBAAkB,EAYvB,QAAQ,EACT,MAAM,kBAAkB,CAAA;AAEzB,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAI9B,iFAAiF;AACjF,eAAO,MAAM,mBAAmB,mBAAmB,CAAA;AAEnD;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,KAAK,KAAK,CAAC,QAAQ,CAAA;AAE5F,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAA;AAa/D,eAAO,MAAM,aAAa,YA4BzB,CAAA;AAsCD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,KAAK,CAAC,IAAI,EAChB,UAAU,GAAE,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAM,EAC/C,KAAK,GAAE,UAAsC,QA8C9C;AAuDD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,WAAW,EACxB,UAAU,GAAE,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAM,GAC9C,KAAK,CAAC,cAAc,CA6DtB"}

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

@@ -127,6 +127,8 @@ function syncCeilingRegionMeshes(mesh, cells) {
         if (!region) {
             region = new THREE.Mesh();
             region.name = CEILING_REGION_MESH;
+            region.castShadow = true;
+            region.receiveShadow = true;
             mesh.add(region);
         }
         else

package/dist/systems/construction-reveal/construction-dust.d.ts

@@ -0,0 +1,16 @@
+import { type DustPool } from '../../lib/construction-dust';
+/**
+ * Draws a reveal's dust: one instanced mesh of camera-facing soft discs, as
+ * many as the pool holds, on the grid layer: inside the scene pass, so walls
+ * in front hide it (on the overlay layer it showed through them, Victor run
+ * 12), with no depth written, so the ink never outlines it; thumbnails leave
+ * it out. Renders nothing itself; it owns the mesh, adds it to the scene and
+ * disposes it on unmount.
+ */
+export declare function ConstructionDust({ pool, clock }: {
+    pool: DustPool;
+    clock: {
+        current: number;
+    };
+}): null;
+//# sourceMappingURL=construction-dust.d.ts.map

package/dist/systems/construction-reveal/construction-dust.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"construction-dust.d.ts","sourceRoot":"","sources":["../../../src/systems/construction-reveal/construction-dust.tsx"],"names":[],"mappings":"AAcA,OAAO,EAAE,KAAK,QAAQ,EAAkB,MAAM,6BAA6B,CAAA;AAI3E;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,QA8E/F"}