@pascal-app/viewer 0.9.1 → 0.9.2

package/dist/lib/materials.d.ts

@@ -1,4 +1,4 @@
-import { type MaterialPresetPayload, type MaterialSchema, type SurfaceRole } from '@pascal-app/core';
+import { type MaterialPresetPayload, type MaterialSchema, type SceneMaterial, type SceneMaterialId, type SurfaceRole } from '@pascal-app/core';
 import * as THREE from 'three';
 import { MeshLambertNodeMaterial } from 'three/webgpu';
 export type RenderShading = 'solid' | 'rendered';
@@ -14,6 +14,19 @@ export declare function applyMaterialPresetToMaterials(materialInput: THREE.Mate
 export declare function createMaterialFromPreset(preset: MaterialPresetPayload, shading?: RenderShading): THREE.Material;
 export declare function createMaterialFromPresetRef(materialPreset?: string, shading?: RenderShading): THREE.Material | null;
 export declare function createMaterial(material?: MaterialSchema, shading?: RenderShading): THREE.Material;
+/**
+ * Resolve a MaterialRef ('library:<id>' | 'scene:<id>') to a three.js material.
+ * Returns null for an unknown / dangling ref so callers fall back to the
+ * slot's default (authored material, then themed default). Never throws.
+ */
+export declare function resolveMaterialRef(ref: string | undefined, sceneMaterials: Record<SceneMaterialId, SceneMaterial> | undefined, shading?: RenderShading): THREE.Material | null;
+/**
+ * Resolve a node kind's declared slot default — either a catalog `library:<id>`
+ * finish or a flat `#rrggbb` colour — to a renderable material. Shared by the
+ * procedural kinds whose colored-mode unpainted appearance comes from a
+ * declarative default (slab, wall).
+ */
+export declare function resolveSlotDefaultMaterial(slotDefault: string, shading?: RenderShading, roughness?: number): THREE.Material;
 export declare function createDefaultMaterial(color?: string, roughness?: number, shading?: RenderShading, side?: THREE.Side): THREE.Material;
 export declare function createSurfaceRoleMaterial(role: SurfaceRole, preset: ColorPreset, side?: THREE.Side, sceneThemeId?: string): THREE.Material;
 export declare function baseMaterial(shading?: RenderShading): THREE.Material;

package/dist/lib/materials.d.ts.map

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

package/dist/lib/materials.js

@@ -1,7 +1,9 @@
-import { getMaterialPresetByRef, resolveMaterial, } from '@pascal-app/core';
+import { getMaterialPresetByRef, parseMaterialRef, resolveMaterial, } from '@pascal-app/core';
 import * as THREE from 'three';
+import { float, mix, positionViewDirection, transformedNormalView } from 'three/tsl';
 import { MeshLambertNodeMaterial, MeshStandardNodeMaterial } from 'three/webgpu';
 import { resolveCdnUrl } from './asset-url';
+import { isKtx2Url, ktx2Loader, whenKtx2Ready } from './ktx2-loader';
 import { getSceneTheme } from './scene-themes';
 export const CLAY_PALETTE = {
     wall: '#dcd6c7',
@@ -12,14 +14,16 @@ export const CLAY_PALETTE = {
     glazing: '#c8d4dc',
     furnishing: '#d2ccbe',
 };
+// Albedos are clamped to ≈0.83 linear (max channel #eb): real white paint
+// reflects ~80%, and pure-white albedo kills GI/shadow contrast.
 export const WHITE_PALETTE = {
-    wall: '#f4f3ef',
-    floor: '#ece9e2',
-    ceiling: '#fbfaf6',
+    wall: '#ebeae6',
+    floor: '#e7e4dd',
+    ceiling: '#ebeae6',
     roof: '#dedbd2',
-    joinery: '#e8e5dc',
+    joinery: '#e5e2d9',
     glazing: '#dbe8ee',
-    furnishing: '#efede7',
+    furnishing: '#e9e7e1',
 };
 export const MONO_PALETTE = {
     wall: '#c8c8c8',
@@ -49,7 +53,7 @@ export function resolveSurfaceColor(role, preset, sceneThemeId) {
     // The active scene theme may tint individual roles (e.g. Mediterranean's blue
     // roof); fall back to the chosen colour preset's palette when it doesn't.
     const tints = sceneThemeId ? getSceneTheme(sceneThemeId).clayTints : undefined;
-    return tints?.[role] ?? PRESET_PALETTES[preset][role];
+    return tints?.[role] ?? (PRESET_PALETTES[preset] ?? CLAY_PALETTE)[role];
 }
 // DoubleSide on any NodeMaterial inside the MRT scenePass (SSGI's output /
 // diffuseColor / normal targets) causes WebGPU to create a render pipeline
@@ -62,10 +66,14 @@ export const glassMaterial = new MeshLambertNodeMaterial({
     opacity: 0.35,
     side: THREE.FrontSide,
 });
+glassMaterial.userData.__pascalCachedMaterial = true;
+function resolveNodeMaterialSide(side) {
+    return side === THREE.DoubleSide ? THREE.FrontSide : side;
+}
 const sideMap = {
     front: THREE.FrontSide,
     back: THREE.BackSide,
-    double: THREE.DoubleSide,
+    double: THREE.FrontSide,
 };
 const materialCache = new Map();
 const defaultMaterialCache = new Map();
@@ -73,6 +81,13 @@ const surfaceRoleMaterialCache = new Map();
 const textureCache = new Map();
 const textureLoadPromises = new Map();
 const textureLoader = new THREE.TextureLoader();
+// `.ktx2` finish maps transcode through the shared KTX2 loader (support is
+// detected once at viewer init); everything else loads as a normal image.
+function pickTextureLoader(url) {
+    // KTX2Loader's load/loadAsync are call-compatible with TextureLoader (url →
+    // Texture / Promise<Texture>); cast for typing.
+    return isKtx2Url(url) ? ktx2Loader : textureLoader;
+}
 const wrapMap = {
     Repeat: THREE.RepeatWrapping,
     ClampToEdge: THREE.ClampToEdgeWrapping,
@@ -116,7 +131,7 @@ function getTexture(material) {
     const cached = textureCache.get(cacheKey);
     if (cached)
         return cached;
-    const texture = textureLoader.load(textureConfig.url);
+    const texture = pickTextureLoader(textureConfig.url).load(textureConfig.url);
     texture.wrapS = THREE.RepeatWrapping;
     texture.wrapT = THREE.RepeatWrapping;
     const repeatX = textureConfig.repeat?.[0] ?? textureConfig.scale ?? 1;
@@ -162,7 +177,7 @@ function getPresetTexture(path, props, slot) {
     const cached = textureCache.get(cacheKey);
     if (cached)
         return cached;
-    const texture = textureLoader.load(resolvedPath);
+    const texture = pickTextureLoader(resolvedPath).load(resolvedPath);
     applyTextureProperties(texture, props, slot);
     setTextureCacheKey(texture, cacheKey);
     textureCache.set(cacheKey, texture);
@@ -195,8 +210,14 @@ async function loadPresetTexture(path, props, slot) {
     const existingPromise = textureLoadPromises.get(cacheKey);
     if (existingPromise)
         return existingPromise;
-    const promise = textureLoader
-        .loadAsync(resolvedPath)
+    // `.ktx2` loads wait for `detectSupport` (KTX2Loader.load throws before it) —
+    // materials can be created while a capture canvas's renderer is still
+    // initializing, and failing here would cache the material permanently
+    // texture-less (white).
+    const load = isKtx2Url(resolvedPath)
+        ? whenKtx2Ready().then(() => ktx2Loader.loadAsync(resolvedPath))
+        : textureLoader.loadAsync(resolvedPath);
+    const promise = load
         .then((texture) => {
         applyTextureProperties(texture, props, slot);
         setTextureCacheKey(texture, cacheKey);
@@ -257,15 +278,35 @@ function applyMaterialMapProperties(material, mapProperties) {
     }
     material.transparent = mapProperties.transparent;
     material.opacity = mapProperties.opacity;
-    material.side =
-        mapProperties.side === 0
-            ? THREE.FrontSide
-            : mapProperties.side === 1
-                ? THREE.BackSide
-                : THREE.DoubleSide;
+    material.side = resolveNodeMaterialSide(mapProperties.side === 0
+        ? THREE.FrontSide
+        : mapProperties.side === 1
+            ? THREE.BackSide
+            : THREE.DoubleSide);
     applyTexturePropertiesToMaterial(material, mapProperties);
     material.needsUpdate = true;
 }
+// Glass-like transparency threshold: any standard material authored as
+// `transparent` with opacity below this gets the fresnel treatment.
+const GLASS_OPACITY_THRESHOLD = 0.6;
+/**
+ * Fresnel-driven opacity for glass: nearly the authored opacity head-on,
+ * increasingly opaque (showing the environment reflection) at grazing angles.
+ * This is what makes glass read as a surface instead of a flat blue tint.
+ */
+function applyGlassFresnel(material) {
+    const facing = transformedNormalView.dot(positionViewDirection).clamp(0, 1);
+    const fresnel = facing.oneMinus().pow(3);
+    material.opacityNode = mix(float(material.opacity), float(0.92), fresnel);
+    material.envMapIntensity = 1.4;
+}
+function maybeApplyGlassFresnel(material) {
+    if (material instanceof MeshStandardNodeMaterial &&
+        material.transparent &&
+        material.opacity < GLASS_OPACITY_THRESHOLD) {
+        applyGlassFresnel(material);
+    }
+}
 function applyMaterialPresetTextures(material, preset) {
     const { maps, mapProperties } = preset;
     queueTextureAssignment(material, 'map', maps.albedoMap, mapProperties);
@@ -302,6 +343,8 @@ export function createMaterialFromPreset(preset, shading = 'rendered') {
     }
     const material = shading === 'solid' ? new MeshLambertNodeMaterial() : new MeshStandardNodeMaterial();
     applyMaterialPresetToMaterials(material, preset);
+    maybeApplyGlassFresnel(material);
+    material.userData.__pascalCachedMaterial = true;
     materialCache.set(cacheKey, material);
     return material;
 }
@@ -333,21 +376,53 @@ export function createMaterial(material, shading = 'rendered') {
             roughness: props.roughness,
             metalness: props.metalness,
         });
+    maybeApplyGlassFresnel(threeMaterial);
+    threeMaterial.userData.__pascalCachedMaterial = true;
     materialCache.set(cacheKey, threeMaterial);
     return threeMaterial;
 }
+/**
+ * Resolve a MaterialRef ('library:<id>' | 'scene:<id>') to a three.js material.
+ * Returns null for an unknown / dangling ref so callers fall back to the
+ * slot's default (authored material, then themed default). Never throws.
+ */
+export function resolveMaterialRef(ref, sceneMaterials, shading = 'rendered') {
+    const parsed = parseMaterialRef(ref);
+    if (!parsed)
+        return null;
+    if (parsed.kind === 'library')
+        return createMaterialFromPresetRef(ref, shading);
+    const sceneMaterial = sceneMaterials?.[parsed.id];
+    if (!sceneMaterial)
+        return null;
+    return createMaterial(sceneMaterial.material, shading);
+}
+/**
+ * Resolve a node kind's declared slot default — either a catalog `library:<id>`
+ * finish or a flat `#rrggbb` colour — to a renderable material. Shared by the
+ * procedural kinds whose colored-mode unpainted appearance comes from a
+ * declarative default (slab, wall).
+ */
+export function resolveSlotDefaultMaterial(slotDefault, shading = 'rendered', roughness = 0.9) {
+    if (parseMaterialRef(slotDefault)?.kind === 'library') {
+        return (createMaterialFromPresetRef(slotDefault, shading) ??
+            createDefaultMaterial('#ffffff', roughness, shading));
+    }
+    return createDefaultMaterial(slotDefault, roughness, shading);
+}
 export function createDefaultMaterial(color = '#ffffff', roughness = 0.9, shading = 'rendered', side = THREE.FrontSide) {
+    const resolvedSide = resolveNodeMaterialSide(side);
     if (shading === 'solid') {
         return new MeshLambertNodeMaterial({
             color,
-            side,
+            side: resolvedSide,
         });
     }
     return new MeshStandardNodeMaterial({
         color,
         roughness,
         metalness: 0,
-        side,
+        side: resolvedSide,
     });
 }
 function cachedDefaultMaterial(key, color, roughness, shading, side = THREE.FrontSide) {
@@ -356,6 +431,7 @@ function cachedDefaultMaterial(key, color, roughness, shading, side = THREE.Fron
     if (cached)
         return cached;
     const material = createDefaultMaterial(color, roughness, shading, side);
+    material.userData.__pascalCachedMaterial = true;
     defaultMaterialCache.set(cacheKey, material);
     return material;
 }
@@ -368,7 +444,7 @@ export function createSurfaceRoleMaterial(role, preset, side = THREE.FrontSide,
     // on both gable faces on the first frame). Callers that need both sides
     // visible (e.g. dormer back gable) must rotate the host mesh 180° so the
     // FrontSide faces the viewer.
-    const resolvedSide = role === 'glazing' ? THREE.FrontSide : side;
+    const resolvedSide = role === 'glazing' ? THREE.FrontSide : resolveNodeMaterialSide(side ?? THREE.FrontSide);
     const cacheKey = `${role}-${preset}-${resolvedSide}-${sceneThemeId ?? 'base'}`;
     const cached = surfaceRoleMaterialCache.get(cacheKey);
     if (cached)
@@ -390,10 +466,10 @@ export function createSurfaceRoleMaterial(role, preset, side = THREE.FrontSide,
     return material;
 }
 export function baseMaterial(shading = 'rendered') {
-    return cachedDefaultMaterial('base', '#f2f0ed', 0.5, shading);
+    return cachedDefaultMaterial('base', '#e9e7e3', 0.5, shading);
 }
 export function DEFAULT_WALL_MATERIAL(shading = 'rendered') {
-    return cachedDefaultMaterial('wall', '#ffffff', 0.9, shading);
+    return cachedDefaultMaterial('wall', '#e9e6e0', 0.9, shading);
 }
 export function DEFAULT_SLAB_MATERIAL(shading = 'rendered') {
     return cachedDefaultMaterial('slab', '#e5e5e5', 0.8, shading);
@@ -424,20 +500,21 @@ export function DEFAULT_WINDOW_MATERIAL(shading = 'rendered') {
             roughness: 0.1,
             metalness: 0.1,
         });
+    maybeApplyGlassFresnel(material);
     defaultMaterialCache.set(cacheKey, material);
     return material;
 }
 export function DEFAULT_CEILING_MATERIAL(shading = 'rendered') {
-    return cachedDefaultMaterial('ceiling', '#f5f5dc', 0.95, shading);
+    return cachedDefaultMaterial('ceiling', '#ebebd3', 0.95, shading);
 }
 export function DEFAULT_ROOF_MATERIAL(shading = 'rendered') {
     return cachedDefaultMaterial('roof', '#808080', 0.85, shading);
 }
 export function DEFAULT_SHELF_MATERIAL(shading = 'rendered') {
-    return cachedDefaultMaterial('shelf', '#ffffff', 0.9, shading);
+    return cachedDefaultMaterial('shelf', '#e9e6e0', 0.9, shading);
 }
 export function DEFAULT_STAIR_MATERIAL(shading = 'rendered') {
-    return cachedDefaultMaterial('stair', '#ffffff', 0.9, shading);
+    return cachedDefaultMaterial('stair', '#e9e6e0', 0.9, shading);
 }
 export function disposeMaterial(material) {
     material.dispose();

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

@@ -4,6 +4,7 @@ export type SceneTheme = {
     name: string;
     appearance: 'light' | 'dark';
     background: string;
+    backgroundSky?: string;
     ground: string;
     ambient: {
         color: string;

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,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,EA2LpC,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,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"}

package/dist/lib/scene-themes.js

@@ -3,13 +3,14 @@ export const SCENE_THEMES = [
         id: 'studio',
         name: 'Studio',
         appearance: 'light',
-        background: '#ffffff',
-        ground: '#f4f4f2',
+        background: '#fbfbfa',
+        backgroundSky: '#b6cfe7',
+        ground: '#e9e7e2',
         ambient: { color: '#ffffff', intensity: 0.15 },
-        hemi: { sky: '#ffffff', ground: '#aaa49a', intensity: 0.6 },
+        hemi: { sky: '#ffffff', ground: '#aaa49a', intensity: 0.45 },
         lights: [
             { position: [10, 10, 10], color: '#ffffff', intensity: 4, castShadow: true },
-            { position: [-10, 10, -10], color: '#ffffff', intensity: 0.75 },
+            { position: [-10, 10, -10], color: '#ffffff', intensity: 0.6 },
         ],
         toneMappingExposure: 0.9,
         clayTints: {
@@ -25,6 +26,7 @@ export const SCENE_THEMES = [
         name: 'Paper',
         appearance: 'light',
         background: '#ede9df',
+        backgroundSky: '#c0d2e4',
         ground: '#e7e1d3',
         ambient: { color: '#fff9eb', intensity: 0.55 },
         hemi: { sky: '#fff5d9', ground: '#c2b89c', intensity: 0.35 },
@@ -46,6 +48,7 @@ export const SCENE_THEMES = [
         name: 'Sunset',
         appearance: 'light',
         background: '#f6e8d4',
+        backgroundSky: '#b5bede',
         ground: '#ecd9bf',
         ambient: { color: '#ffd9a8', intensity: 0.45 },
         hemi: { sky: '#ffd9a8', ground: '#5b4634', intensity: 0.4 },
@@ -67,11 +70,12 @@ export const SCENE_THEMES = [
         name: 'Overcast',
         appearance: 'light',
         background: '#e6e7e6',
+        backgroundSky: '#c3ccd6',
         ground: '#dadcd9',
         ambient: { color: '#eef0ef', intensity: 1.1 },
         hemi: { sky: '#f4f5f3', ground: '#bcbfbb', intensity: 0.9 },
         lights: [{ position: [12, 28, 10], color: '#f4f5f3', intensity: 0.8, castShadow: true }],
-        toneMappingExposure: 0.95,
+        toneMappingExposure: 0.9,
         clayTints: {
             wall: '#dedfdc',
             floor: '#cdcec9',
@@ -85,6 +89,7 @@ export const SCENE_THEMES = [
         name: 'Blueprint',
         appearance: 'light',
         background: '#dde6ef',
+        backgroundSky: '#a5c4e2',
         ground: '#c9d6e6',
         ambient: { color: '#cfdcec', intensity: 0.7 },
         hemi: { sky: '#dfeaf6', ground: '#5b6b80', intensity: 0.55 },
@@ -92,7 +97,7 @@ export const SCENE_THEMES = [
             { position: [16, 24, 12], color: '#e6efff', intensity: 1.8, castShadow: true },
             { position: [-12, 10, -8], color: '#9fb6d8', intensity: 0.4 },
         ],
-        toneMappingExposure: 0.95,
+        toneMappingExposure: 0.9,
         clayTints: {
             wall: '#9fb6d2',
             floor: '#8ba2c2',
@@ -106,6 +111,7 @@ export const SCENE_THEMES = [
         name: 'Mediterranean',
         appearance: 'light',
         background: '#bdd6e8',
+        backgroundSky: '#8ab4d6',
         ground: '#ddd2bb',
         ambient: { color: '#d6e6f3', intensity: 0.5 },
         hemi: { sky: '#a8c8e2', ground: '#d8c9a4', intensity: 0.6 },
@@ -127,14 +133,15 @@ export const SCENE_THEMES = [
         name: 'Twilight',
         appearance: 'dark',
         background: '#3a3550',
-        ground: '#4a4566',
-        ambient: { color: '#a89cc8', intensity: 0.35 },
-        hemi: { sky: '#d8a8c0', ground: '#1c1830', intensity: 0.5 },
+        backgroundSky: '#272338',
+        ground: '#67618a',
+        ambient: { color: '#a89cc8', intensity: 0.55 },
+        hemi: { sky: '#d8a8c0', ground: '#3a3450', intensity: 0.7 },
         lights: [
             { position: [-14, 22, -10], color: '#a4b6e8', intensity: 1.4, castShadow: true },
             { position: [14, 6, 8], color: '#ffb070', intensity: 0.9 },
         ],
-        toneMappingExposure: 1.1,
+        toneMappingExposure: 0.9,
         clayTints: {
             wall: '#c5b9cf',
             floor: '#ad9fbb',
@@ -148,12 +155,13 @@ export const SCENE_THEMES = [
         name: 'Night',
         appearance: 'dark',
         background: '#1f2433',
-        ground: '#2b3247',
-        ambient: { color: '#a0b0ff', intensity: 0.07 },
-        hemi: { sky: '#3a4666', ground: '#0e111c', intensity: 0.4 },
+        backgroundSky: '#12161f',
+        ground: '#4a5470',
+        ambient: { color: '#a0b0ff', intensity: 0.25 },
+        hemi: { sky: '#3a4666', ground: '#232a3d', intensity: 0.55 },
         lights: [
-            { position: [10, 10, 10], color: '#e0e5ff', intensity: 0.8, castShadow: true },
-            { position: [-10, 10, -10], color: '#8090ff', intensity: 0.2 },
+            { position: [10, 10, 10], color: '#e0e5ff', intensity: 1.2, castShadow: true },
+            { position: [-10, 10, -10], color: '#8090ff', intensity: 0.3 },
         ],
         toneMappingExposure: 0.9,
         clayTints: {
@@ -169,6 +177,7 @@ export const SCENE_THEMES = [
         name: 'Verdant',
         appearance: 'light',
         background: '#d6e4d2',
+        backgroundSky: '#aecde0',
         ground: '#c7d6b4',
         ambient: { color: '#e3efdd', intensity: 0.5 },
         hemi: { sky: '#cfe6cf', ground: '#8ea06f', intensity: 0.65 },
@@ -176,7 +185,7 @@ export const SCENE_THEMES = [
             { position: [16, 22, 12], color: '#fff6d8', intensity: 3, castShadow: true },
             { position: [-12, 10, -8], color: '#bfe0c2', intensity: 0.5 },
         ],
-        toneMappingExposure: 0.95,
+        toneMappingExposure: 0.9,
         clayTints: {
             wall: '#eef0e6',
             floor: '#d8ddc6',

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

@@ -0,0 +1,4 @@
+import type { Object3D } from 'three';
+export declare function applyShadowOnly(root: Object3D): void;
+export declare function clearShadowOnly(root: Object3D): void;
+//# sourceMappingURL=shadow-only.d.ts.map

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

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

package/dist/lib/shadow-only.js

@@ -0,0 +1,36 @@
+import { SCENE_LAYER, SHADOW_ONLY_LAYER } from './layers';
+/**
+ * Shadow-caster-only hiding: removes an object (and its descendants) from the
+ * color passes while keeping it in the shadow map, so a hidden roof or level
+ * still shadows the interior and sun enters through windows correctly.
+ *
+ * Uses layer masks instead of `visible = false` for two reasons: `visible`
+ * cascades (and, critically, prunes the object from the shadow pass too),
+ * while layers are tested per-object against the rendering camera — the main
+ * camera never enables {@link SHADOW_ONLY_LAYER}, but every shadow-casting
+ * light's shadow camera does (see `lights.tsx`).
+ *
+ * The original `layers.mask` is stashed under a private Symbol so
+ * {@link clearShadowOnly} restores the exact prior state. Both calls are
+ * idempotent and cheap to reapply.
+ */
+const ORIGINAL_LAYERS = Symbol('pascal:shadow-only:original-layers');
+export function applyShadowOnly(root) {
+    root.traverse((obj) => {
+        const carrier = obj;
+        if (carrier[ORIGINAL_LAYERS] === undefined) {
+            carrier[ORIGINAL_LAYERS] = obj.layers.mask;
+        }
+        obj.layers.disable(SCENE_LAYER);
+        obj.layers.enable(SHADOW_ONLY_LAYER);
+    });
+}
+export function clearShadowOnly(root) {
+    root.traverse((obj) => {
+        const carrier = obj;
+        if (carrier[ORIGINAL_LAYERS] === undefined)
+            return;
+        obj.layers.mask = carrier[ORIGINAL_LAYERS];
+        delete carrier[ORIGINAL_LAYERS];
+    });
+}

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

@@ -0,0 +1,12 @@
+/**
+ * three runs at 0.185 but @types/three is pinned at 0.184: the 0.185 typings
+ * make tsgo's type inference allocate unboundedly (microsoft/typescript-go
+ * #2125 class) and OOM the machine. r185 renamed directionToColor /
+ * colorToDirection to packNormalToRGB / unpackRGBToNormal — re-export the new
+ * runtime names under the old names' signatures. Delete this file (and the
+ * @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">;
+//# sourceMappingURL=tsl-compat.d.ts.map

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

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

package/dist/lib/tsl-compat.js

@@ -0,0 +1,13 @@
+import * as TSL from 'three/tsl';
+/**
+ * three runs at 0.185 but @types/three is pinned at 0.184: the 0.185 typings
+ * make tsgo's type inference allocate unboundedly (microsoft/typescript-go
+ * #2125 class) and OOM the machine. r185 renamed directionToColor /
+ * colorToDirection to packNormalToRGB / unpackRGBToNormal — re-export the new
+ * runtime names under the old names' signatures. Delete this file (and the
+ * @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 const packNormalToRGB = TSL
+    .packNormalToRGB;
+export const unpackRGBToNormal = TSL.unpackRGBToNormal;