@pascal-app/viewer 1.0.3 → 1.0.5

package/dist/systems/wall/wall-materials.js

@@ -1,8 +1,9 @@
-import { getEffectiveWallSurfaceMaterial, getMaterialPresetByRef, getWallSurfaceMaterialSignature, getWallSurfaceSideFromBandSlot, parseMaterialRef, resolveMaterial, WALL_SLOT_DEFAULT, WALL_SURFACE_SLOT_DEFAULTS, } from '@pascal-app/core';
+import { getEffectiveWallFaceMaterial, getMaterialPresetByRef, getWallSurfaceMaterialSignature, parseMaterialColor, parseMaterialRef, resolveMaterial, resolveWallExteriorSide, resolveWallFaceChain, WALL_SLOT_DEFAULT, wallAssemblyExposedStructure, wallAssemblyFinishRef, } from '@pascal-app/core';
 import { Color } from 'three';
-import { Fn, float, fract, length, mix, positionLocal, smoothstep, step, vec2 } from 'three/tsl';
+import { Fn, float, fract, length, mix, positionLocal, smoothstep, step, uv, vec2 } from 'three/tsl';
 import { MeshLambertNodeMaterial, MeshStandardNodeMaterial } from 'three/webgpu';
-import { baseMaterial, createDefaultMaterial, createMaterial, createMaterialFromPresetRef, createSurfaceRoleMaterial, materialPresetRefSignature, resolveMaterialRef, resolveSurfaceColor, } from '../../lib/materials';
+import { BLOCK_MASONRY, concreteMaterial, masonryMaterial, STRUCTURE_COLORS, } from '../../lib/foundation-materials';
+import { baseMaterial, createDefaultMaterial, createMaterial, createMaterialFromPresetRef, createSurfaceRoleMaterial, materialPresetRefSignature, resolveMaterialRef, resolveSlotDefaultRef, resolveSurfaceColor, } from '../../lib/materials';
 const DEFAULT_WALL_COLOR = '#e9e7e3';
 const WALL_HIGHLIGHT_PROFILES = {
     delete: {
@@ -33,112 +34,129 @@ function getSurfaceVisibleMaterial(spec, shading) {
     }
     return baseMaterial(shading);
 }
-function hasExplicitMaterial(spec) {
-    return Boolean(spec.materialPreset || spec.material);
-}
 // Resolve a wall face's declared default — a catalog `library:` finish or a
 // flat colour — to a renderable material.
-function resolveWallSlotDefault(slotDefault, shading) {
+function resolveWallSlotDefault(declaredDefault, shading) {
+    const slotDefault = resolveSlotDefaultRef(declaredDefault);
     if (parseMaterialRef(slotDefault)?.kind === 'library') {
         return createMaterialFromPresetRef(slotDefault, shading) ?? baseMaterial(shading);
     }
     return createDefaultMaterial(slotDefault, 0.9, shading);
 }
+// The assembly cladding's ref when `face` is the wall's exterior face (a is the
+// +normal face; an unresolved side keeps the cladding on b, as legacy did).
+function wallAssemblyFaceFinishRef(wallNode, face) {
+    const exteriorFace = resolveWallExteriorSide(wallNode) === 1 ? 'a' : 'b';
+    return face === exteriorFace ? wallAssemblyFinishRef(wallNode) : null;
+}
+// What `face` shows when it is the exterior face of a wall with no cladding over a bare masonry or
+// concrete core: the structure itself (null otherwise, and for any face with a cladding).
+function wallFaceExposedStructure(wallNode, face) {
+    if (wallAssemblyFaceFinishRef(wallNode, face))
+        return null;
+    const exteriorFace = resolveWallExteriorSide(wallNode) === 1 ? 'a' : 'b';
+    return face === exteriorFace ? wallAssemblyExposedStructure(wallNode) : null;
+}
+// The structure as the generic foundation draws it (same courses, joints and colours), made once:
+// the block's bond runs along the face's world-planar U, the wall's own metres. Solid shading
+// keeps to a flat colour, like every other wall finish.
+const structureMaterials = new Map();
+function exposedStructureMaterial(structure, shading) {
+    if (shading !== 'rendered')
+        return createDefaultMaterial(STRUCTURE_COLORS[structure], 0.9, shading);
+    let material = structureMaterials.get(structure);
+    if (!material) {
+        material = structure === 'cmu' ? masonryMaterial(BLOCK_MASONRY, uv().x) : concreteMaterial();
+        material.userData.__pascalCachedMaterial = true;
+        structureMaterials.set(structure, material);
+    }
+    return material;
+}
 // Slot-first resolution for one wall face, matching every other paintable kind:
-//   node.slots[side] ref → legacy inline fields → declared slot default.
+//   node.slots[face] ref → legacy inline finish → declared slot default.
 // A dangling `scene:` ref (material deleted / copied across scenes) falls back
 // to the declared default — it never blocks rendering (the dangling-ref rule).
-function resolveWallFaceMaterial(wallNode, side, shading, sceneMaterials) {
-    const ref = wallNode.slots?.[side];
-    if (ref) {
-        return (resolveMaterialRef(ref, sceneMaterials, shading) ??
-            resolveWallSlotDefault(WALL_SLOT_DEFAULT[side], shading));
-    }
-    const spec = getEffectiveWallSurfaceMaterial(wallNode, side);
-    if (hasExplicitMaterial(spec)) {
-        return getSurfaceVisibleMaterial(spec, shading);
+function resolveWallFaceMaterial(wallNode, face, shading, sceneMaterials) {
+    const finish = resolveWallFaceChain(wallNode, face);
+    if (finish.kind === 'ref') {
+        return (resolveMaterialRef(finish.ref, sceneMaterials, shading) ??
+            resolveWallSlotDefault(WALL_SLOT_DEFAULT[face], shading));
     }
-    return resolveWallSlotDefault(WALL_SLOT_DEFAULT[side], shading);
+    if (finish.kind === 'legacy')
+        return getSurfaceVisibleMaterial(finish.spec, shading);
+    // No paint on this face: the wall ASSEMBLY's cladding (WS5) skins the
+    // exterior — a "2x6 lap siding" wall reads as lap siding without the user
+    // painting it. Painting the face still wins.
+    const assemblyRef = wallAssemblyFaceFinishRef(wallNode, face);
+    const exposed = assemblyRef ? null : wallFaceExposedStructure(wallNode, face);
+    if (exposed)
+        return exposedStructureMaterial(exposed, shading);
+    return resolveWallSlotDefault(assemblyRef ?? finish.ref, shading);
 }
-function resolveWallSlotMaterial(wallNode, slotId, shading, sceneMaterials) {
-    const ref = wallNode.slots?.[slotId];
-    if (ref) {
-        return (resolveMaterialRef(ref, sceneMaterials, shading) ??
-            resolveWallSlotDefault(WALL_SURFACE_SLOT_DEFAULTS[slotId], shading));
-    }
-    const side = getWallSurfaceSideFromBandSlot(slotId);
-    if (side) {
-        return resolveWallFaceMaterial(wallNode, side, shading, sceneMaterials);
-    }
-    return resolveWallSlotDefault(WALL_SURFACE_SLOT_DEFAULTS[slotId], shading);
+// A region or room finish: its ref, else the face default (same dangling rule).
+function resolveWallFinishMaterial(ref, shading, sceneMaterials) {
+    return (resolveMaterialRef(ref, sceneMaterials, shading) ??
+        resolveWallSlotDefault(WALL_SLOT_DEFAULT.a, shading));
 }
-// Cache-key fragment for one face: the slot ref plus, for a `scene:` ref, the
-// referenced material's *content* — so editing a scene material assigned to a
-// wall invalidates the cache. A `library:` ref carries its resolution state
-// instead: AI-generated materials register asynchronously, and a dangling ref
-// resolved to the slot default must not stay cached once the library lands.
-// Falls back to the legacy signature when unmigrated.
-function wallFaceMaterialSignature(wallNode, side, sceneMaterials) {
-    const ref = wallNode.slots?.[side];
-    if (ref) {
-        const parsed = parseMaterialRef(ref);
-        if (parsed?.kind === 'scene') {
-            return JSON.stringify({
-                ref,
-                material: sceneMaterials?.[parsed.id]?.material ?? null,
-            });
-        }
-        return JSON.stringify({ ref: materialPresetRefSignature(ref) });
+// Cache-key fragment for a ref: for a `scene:` ref, the referenced material's
+// *content* — so editing a scene material assigned to a wall invalidates the
+// cache. A `library:` ref carries its resolution state instead: AI-generated
+// materials register asynchronously, and a dangling ref resolved to the slot
+// default must not stay cached once the library lands.
+function refMaterialSignature(ref, sceneMaterials) {
+    const parsed = parseMaterialRef(ref);
+    if (parsed?.kind === 'scene') {
+        return JSON.stringify({
+            ref,
+            material: sceneMaterials?.[parsed.id]?.material ?? null,
+        });
     }
-    return getWallSurfaceMaterialSignature(getEffectiveWallSurfaceMaterial(wallNode, side));
+    return JSON.stringify({ ref: materialPresetRefSignature(ref) });
 }
-function wallSlotMaterialSignature(wallNode, slotId, sceneMaterials) {
-    const ref = wallNode.slots?.[slotId];
-    if (ref) {
-        const parsed = parseMaterialRef(ref);
-        if (parsed?.kind === 'scene') {
-            return JSON.stringify({
-                ref,
-                material: sceneMaterials?.[parsed.id]?.material ?? null,
-            });
-        }
-        return JSON.stringify({ ref: materialPresetRefSignature(ref) });
-    }
-    const side = getWallSurfaceSideFromBandSlot(slotId);
-    if (side)
-        return wallFaceMaterialSignature(wallNode, side, sceneMaterials);
-    return JSON.stringify({ default: WALL_SURFACE_SLOT_DEFAULTS[slotId] });
+// Falls back to the legacy signature when the face has no slot ref.
+function wallFaceMaterialSignature(wallNode, face, sceneMaterials) {
+    const ref = wallNode.slots?.[face];
+    if (ref)
+        return refMaterialSignature(ref, sceneMaterials);
+    const spec = getEffectiveWallFaceMaterial(wallNode, face);
+    const assemblyRef = wallAssemblyFaceFinishRef(wallNode, face);
+    return JSON.stringify({
+        legacy: getWallSurfaceMaterialSignature(spec),
+        preset: spec.materialPreset ? materialPresetRefSignature(spec.materialPreset) : null,
+        // Changing the assembly's cladding must re-skin the face.
+        assemblyFinish: assemblyRef ? materialPresetRefSignature(assemblyRef) : null,
+        // So must baring or covering its structure.
+        structure: assemblyRef ? null : wallFaceExposedStructure(wallNode, face),
+    });
 }
-// Slot-first tint for the cutaway/invisible wall variant.
-function resolveWallFaceColor(wallNode, side, sceneMaterials, fallback) {
-    const ref = wallNode.slots?.[side];
-    if (ref) {
-        const parsed = parseMaterialRef(ref);
-        if (parsed?.kind === 'library') {
-            return getMaterialPresetByRef(ref)?.mapProperties?.color ?? fallback;
-        }
-        if (parsed?.kind === 'scene') {
-            const sceneMaterial = sceneMaterials?.[parsed.id];
-            return sceneMaterial ? resolveMaterial(sceneMaterial.material).color : fallback;
-        }
-        return fallback;
+function resolveRefColor(ref, sceneMaterials, fallback) {
+    const color = parseMaterialColor(ref);
+    if (color)
+        return color;
+    const parsed = parseMaterialRef(ref);
+    if (parsed?.kind === 'library') {
+        return getMaterialPresetByRef(ref)?.mapProperties?.color ?? fallback;
+    }
+    if (parsed?.kind === 'scene') {
+        const sceneMaterial = sceneMaterials?.[parsed.id];
+        return sceneMaterial ? resolveMaterial(sceneMaterial.material).color : fallback;
     }
-    return getSurfaceColor(getEffectiveWallSurfaceMaterial(wallNode, side), fallback);
+    return fallback;
 }
-function resolveWallSlotColor(wallNode, slotId, sceneMaterials, fallback) {
-    const ref = wallNode.slots?.[slotId];
-    if (ref) {
-        const parsed = parseMaterialRef(ref);
-        if (parsed?.kind === 'library') {
-            return getMaterialPresetByRef(ref)?.mapProperties?.color ?? fallback;
-        }
-        if (parsed?.kind === 'scene') {
-            const sceneMaterial = sceneMaterials?.[parsed.id];
-            return sceneMaterial ? resolveMaterial(sceneMaterial.material).color : fallback;
-        }
+// Slot-first tint for the cutaway/invisible wall variant.
+function resolveWallFaceColor(wallNode, face, sceneMaterials, fallback) {
+    const ref = wallNode.slots?.[face];
+    if (ref)
+        return resolveRefColor(ref, sceneMaterials, fallback);
+    const spec = getEffectiveWallFaceMaterial(wallNode, face);
+    const assemblyRef = wallAssemblyFaceFinishRef(wallNode, face);
+    if (assemblyRef && !(spec.materialPreset || spec.material)) {
+        return getMaterialPresetByRef(assemblyRef)?.mapProperties?.color ?? fallback;
     }
-    const side = getWallSurfaceSideFromBandSlot(slotId);
-    return side ? resolveWallFaceColor(wallNode, side, sceneMaterials, fallback) : fallback;
+    const exposed = assemblyRef ? null : wallFaceExposedStructure(wallNode, face);
+    if (exposed && !(spec.materialPreset || spec.material))
+        return STRUCTURE_COLORS[exposed];
+    return getSurfaceColor(spec, fallback);
 }
 function getSurfaceColor(spec, fallback = DEFAULT_WALL_COLOR) {
     const preset = getMaterialPresetByRef(spec.materialPreset);
@@ -286,27 +304,25 @@ function disposeOwnedMaterials(materials) {
         material.dispose();
     });
 }
-export function getWallMaterialHash(wallNode, shading, sceneMaterials, overrideHash) {
+export function getWallMaterialHash(wallNode, shading, sceneMaterials, finishRefs = [], overrideHash) {
     return JSON.stringify({
         shading,
         overrideHash,
-        interior: wallFaceMaterialSignature(wallNode, 'interior', sceneMaterials),
-        exterior: wallFaceMaterialSignature(wallNode, 'exterior', sceneMaterials),
-        lowerInterior: wallSlotMaterialSignature(wallNode, 'lowerInterior', sceneMaterials),
-        middleInterior: wallSlotMaterialSignature(wallNode, 'middleInterior', sceneMaterials),
-        upperInterior: wallSlotMaterialSignature(wallNode, 'upperInterior', sceneMaterials),
-        topInterior: wallSlotMaterialSignature(wallNode, 'topInterior', sceneMaterials),
-        lowerExterior: wallSlotMaterialSignature(wallNode, 'lowerExterior', sceneMaterials),
-        middleExterior: wallSlotMaterialSignature(wallNode, 'middleExterior', sceneMaterials),
-        upperExterior: wallSlotMaterialSignature(wallNode, 'upperExterior', sceneMaterials),
-        topExterior: wallSlotMaterialSignature(wallNode, 'topExterior', sceneMaterials),
+        a: wallFaceMaterialSignature(wallNode, 'a', sceneMaterials),
+        b: wallFaceMaterialSignature(wallNode, 'b', sceneMaterials),
+        finishes: finishRefs.map((ref) => refMaterialSignature(ref, sceneMaterials)),
     });
 }
-export function getMaterialsForWall(wallNode, shading = 'rendered', textures = true, colorPreset = 'clay', sceneTheme, sceneMaterials, override) {
+/**
+ * A wall's material palette: 0 caps/edges (themed role), 1 face a, 2 face b,
+ * then one entry per `finishRefs` — the region and room finishes the built
+ * geometry's groups point at (`getWallFinishRefs(mesh.geometry)`).
+ */
+export function getMaterialsForWall(wallNode, shading = 'rendered', textures = true, colorPreset = 'clay', sceneTheme, sceneMaterials, finishRefs = [], override) {
     const cacheKey = `${wallNode.id}-${shading}-${textures}-${colorPreset}-${sceneTheme ?? 'base'}`;
     const materialHash = textures
-        ? getWallMaterialHash(wallNode, shading, sceneMaterials, override?.hash)
-        : JSON.stringify({ textures, colorPreset, sceneTheme });
+        ? getWallMaterialHash(wallNode, shading, sceneMaterials, finishRefs, override?.hash)
+        : JSON.stringify({ textures, colorPreset, sceneTheme, finishes: finishRefs.length });
     const existing = wallMaterialCache.get(cacheKey);
     if (existing && existing.materialHash === materialHash) {
         return existing;
@@ -332,55 +348,22 @@ export function getMaterialsForWall(wallNode, shading = 'rendered', textures = t
         : textures
             ? [
                 wallRoleMaterial,
-                resolveWallFaceMaterial(wallNode, 'interior', shading, sceneMaterials),
-                resolveWallFaceMaterial(wallNode, 'exterior', shading, sceneMaterials),
-                resolveWallSlotMaterial(wallNode, 'lowerInterior', shading, sceneMaterials),
-                resolveWallSlotMaterial(wallNode, 'middleInterior', shading, sceneMaterials),
-                resolveWallSlotMaterial(wallNode, 'upperInterior', shading, sceneMaterials),
-                resolveWallSlotMaterial(wallNode, 'topInterior', shading, sceneMaterials),
-                resolveWallSlotMaterial(wallNode, 'lowerExterior', shading, sceneMaterials),
-                resolveWallSlotMaterial(wallNode, 'middleExterior', shading, sceneMaterials),
-                resolveWallSlotMaterial(wallNode, 'upperExterior', shading, sceneMaterials),
-                resolveWallSlotMaterial(wallNode, 'topExterior', shading, sceneMaterials),
+                resolveWallFaceMaterial(wallNode, 'a', shading, sceneMaterials),
+                resolveWallFaceMaterial(wallNode, 'b', shading, sceneMaterials),
+                ...finishRefs.map((ref) => resolveWallFinishMaterial(ref, shading, sceneMaterials)),
             ]
-            : Array.from({ length: 11 }, () => wallRoleMaterial);
+            : Array.from({ length: 3 + finishRefs.length }, () => wallRoleMaterial);
     const wallRoleColor = resolveSurfaceColor('wall', colorPreset, sceneTheme);
-    const invisible = [
-        createInvisibleWallMaterial(wallRoleColor, textures ? shading : 'solid'),
-        ...['interior', 'exterior'].map((side) => createInvisibleWallMaterial(textures
-            ? resolveWallFaceColor(wallNode, side, sceneMaterials, wallRoleColor)
-            : wallRoleColor, textures ? shading : 'solid')),
-        ...[
-            'lowerInterior',
-            'middleInterior',
-            'upperInterior',
-            'topInterior',
-            'lowerExterior',
-            'middleExterior',
-            'upperExterior',
-            'topExterior',
-        ].map((slotId) => createInvisibleWallMaterial(textures
-            ? resolveWallSlotColor(wallNode, slotId, sceneMaterials, wallRoleColor)
-            : wallRoleColor, textures ? shading : 'solid')),
-    ];
-    const translucent = [
-        createTranslucentWallMaterial(wallRoleColor, textures ? shading : 'solid'),
-        ...['interior', 'exterior'].map((side) => createTranslucentWallMaterial(textures
-            ? resolveWallFaceColor(wallNode, side, sceneMaterials, wallRoleColor)
-            : wallRoleColor, textures ? shading : 'solid')),
-        ...[
-            'lowerInterior',
-            'middleInterior',
-            'upperInterior',
-            'topInterior',
-            'lowerExterior',
-            'middleExterior',
-            'upperExterior',
-            'topExterior',
-        ].map((slotId) => createTranslucentWallMaterial(textures
-            ? resolveWallSlotColor(wallNode, slotId, sceneMaterials, wallRoleColor)
-            : wallRoleColor, textures ? shading : 'solid')),
+    const variantShading = textures ? shading : 'solid';
+    const paletteColors = [
+        wallRoleColor,
+        ...['a', 'b'].map((face) => textures
+            ? resolveWallFaceColor(wallNode, face, sceneMaterials, wallRoleColor)
+            : wallRoleColor),
+        ...finishRefs.map((ref) => textures ? resolveRefColor(ref, sceneMaterials, wallRoleColor) : wallRoleColor),
     ];
+    const invisible = paletteColors.map((color) => createInvisibleWallMaterial(color, variantShading));
+    const translucent = paletteColors.map((color) => createTranslucentWallMaterial(color, variantShading));
     const deleteVisible = mapWallMaterialArray(visible, (material) => createHighlightedWallMaterial(material, 'delete'));
     const deleteInvisible = mapWallMaterialArray(invisible, (material) => createHighlightedWallMaterial(material, 'delete'));
     const deleteTranslucent = mapWallMaterialArray(translucent, (material) => createHighlightedWallMaterial(material, 'delete'));
@@ -397,7 +380,6 @@ export function getMaterialsForWall(wallNode, shading = 'rendered', textures = t
     wallMaterialCache.set(cacheKey, result);
     return result;
 }
-export function getVisibleWallMaterials(wallNode, shading = 'rendered', textures = true, colorPreset = 'clay', sceneTheme, sceneMaterials) {
-    return getMaterialsForWall(wallNode, shading, textures, colorPreset, sceneTheme, sceneMaterials)
-        .visible;
+export function getVisibleWallMaterials(wallNode, shading = 'rendered', textures = true, colorPreset = 'clay', sceneTheme, sceneMaterials, finishRefs = []) {
+    return getMaterialsForWall(wallNode, shading, textures, colorPreset, sceneTheme, sceneMaterials, finishRefs).visible;
 }

package/dist/systems/wall/wall-placeholder-sweep.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wall-placeholder-sweep.d.ts","sourceRoot":"","sources":["../../../src/systems/wall/wall-placeholder-sweep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,eAAO,MAAM,+BAA+B,KAAK,CAAA;AAEjD,KAAK,YAAY,GAAG;IAClB,QAAQ,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;IACrD,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAA;CAC/D,GAAG,IAAI,CAAA;AAER,4EAA4E;AAC5E,eAAO,MAAM,yBAAyB,GAAI,UAAU,YAAY,KAAG,OAMlE,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,8CAK/B;IACD,4DAA4D;IAC5D,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IACzB,qEAAqE;IACrE,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,YAAY,CAAA;IAC5C,iEAAiE;IACjE,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAA;IACpC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;CACpC,KAAG,MAAM,EAST,CAAA"}
+{"version":3,"file":"wall-placeholder-sweep.d.ts","sourceRoot":"","sources":["../../../src/systems/wall/wall-placeholder-sweep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,eAAO,MAAM,+BAA+B,KAAK,CAAA;AAEjD,KAAK,YAAY,GAAG;IAClB,QAAQ,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;IACrD,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAA;CAC/D,GAAG,IAAI,CAAA;AAER,4EAA4E;AAC5E,eAAO,MAAM,yBAAyB,aAAc,YAAY,KAAG,OAMlE,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,iDAK3B;IACD,4DAA4D;IAC5D,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IACzB,qEAAqE;IACrE,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,YAAY,CAAA;IAC5C,iEAAiE;IACjE,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAA;IACpC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;CACpC,KAAG,MAAM,EAST,CAAA"}

package/dist/systems/wall/wall-system.d.ts

@@ -1,6 +1,7 @@
-import { type AnyNode, type AnyNodeId, type WallMiterData, type WallNode, type WallSlabSupportSegment } from '@pascal-app/core';
+import { type AnyNode, type AnyNodeId, type WallFinishLayout, type WallMiterData, type WallNode, type WallSlabSupportSegment } from '@pascal-app/core';
 import * as THREE from 'three';
 import { Brush } from 'three-bvh-csg';
+import { type WallFaceBaseRun } from './wall-finish-data';
 export { isWallInitialBuildActive } from './wall-build-lifecycle';
 export { drainRebuiltWalls } from './wall-rebuild-notifications';
 export declare function mergeWallCutoutBrushes(brushes: readonly Brush[]): {
@@ -8,6 +9,22 @@ export declare function mergeWallCutoutBrushes(brushes: readonly Brush[]): {
     fallbackBrushes: Brush[];
     droppedCount: number;
 };
+/**
+ * What decides a face triangle's material: the wall's finish layout (regions and
+ * room spans) and, where the faces stand on different floors, each face's base —
+ * region heights are measured from the face's own base.
+ */
+export type WallFinishContext = {
+    layout: WallFinishLayout;
+    faceBase: Record<'a' | 'b', WallFaceBaseRun[]> | null;
+    /** The palette's finish refs (material indices 3..): the layout's, then the foundation's. */
+    refs: readonly string[];
+    /** The underpinning's stemwall: triangles below local y `top` take material `index`. */
+    foundation: {
+        index: number;
+        top: number;
+    } | null;
+};
 export declare function shouldDeferWallRebuild(wallId: string, nodes: Record<AnyNodeId, AnyNode>, rebuiltThisFrame: number, elapsedMs: number): boolean;
 /** Rebuilds this system still owes — neighbours deferred during a drag. */
 export declare function getPendingWallRebuildCount(): number;
@@ -26,6 +43,20 @@ export declare const WallSystem: ({ geometryAdapter }?: {
     geometryAdapter?: WallGeometryAdapter;
 }) => null;
 export declare function runWallBuildFrame(geometryAdapter?: WallGeometryAdapter): void;
+/**
+ * A room's wall finish lives on its zone, so a zone edit must rebuild the walls
+ * bounding it — the old boundary and the new one. Zones without a wall finish
+ * never touch their walls, so ordinary room edits cost nothing here.
+ */
+export declare function markWallsForZoneFinishChanges(): void;
+/**
+ * The children a wall builds around, as they stand live: an opening still waiting for its
+ * construction reveal is left out, so the wall rises whole and is cut at the opening's turn.
+ */
+export declare function wallGeometryChildren(node: WallNode, nodes: Readonly<Record<string, AnyNode>>): AnyNode[];
 type WallTerrainBottomSampler = (x: number, z: number) => number | null;
-export declare function generateExtrudedWall(wallNode: WallNode, childrenNodes: AnyNode[], miterData: WallMiterData, slabElevation?: number, baseElevation?: number, baseSegments?: readonly WallSlabSupportSegment[], storeyHeight?: number, terrainBottomAt?: WallTerrainBottomSampler): THREE.BufferGeometry;
+export declare function generateExtrudedWall(wallNode: WallNode, childrenNodes: AnyNode[], miterData: WallMiterData, slabElevation?: number, baseElevation?: number, baseSegments?: readonly WallSlabSupportSegment[], storeyHeight?: number, terrainBottomAt?: WallTerrainBottomSampler, faceBase?: {
+    a: readonly WallSlabSupportSegment[];
+    b: readonly WallSlabSupportSegment[];
+}, finishLayout?: WallFinishLayout, sceneNodes?: Readonly<Record<string, AnyNode>>): THREE.BufferGeometry;
 //# sourceMappingURL=wall-system.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"wall-system.d.ts","sourceRoot":"","sources":["../../../src/systems/wall/wall-system.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,SAAS,EAyBd,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,sBAAsB,EAI5B,MAAM,kBAAkB,CAAA;AAGzB,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,EAAY,KAAK,EAA0B,MAAM,eAAe,CAAA;AAsBvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAA;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AA2DhE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,SAAS,KAAK,EAAE,GAAG;IACjE,MAAM,EAAE,KAAK,GAAG,IAAI,CAAA;IACpB,eAAe,EAAE,KAAK,EAAE,CAAA;IACxB,YAAY,EAAE,MAAM,CAAA;CACrB,CA4FA;AAmbD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,EACjC,gBAAgB,EAAE,MAAM,EACxB,SAAS,EAAE,MAAM,GAChB,OAAO,CAET;AAED,2EAA2E;AAC3E,wBAAgB,0BAA0B,IAAI,MAAM,CAEnD;AAID,MAAM,MAAM,0BAA0B,GAAG;IACvC,MAAM,EAAE,CAAC,EAAE,EAAE,SAAS,KAAK,OAAO,CAAA;CACnC,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,eAAe,CAAC,EAAE,CAChB,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,OAAO,EAAE,0BAA0B,KAChC;QAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;QAAC,cAAc,EAAE,OAAO,EAAE,CAAA;KAAE,CAAA;IAC/D,aAAa,CAAC,EAAE,CACd,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,KAAK,CAAC,cAAc,EAC9B,QAAQ,EAAE,SAAS,OAAO,EAAE,KACzB,KAAK,CAAC,cAAc,CAAA;IACzB,qBAAqB,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,cAAc,KAAK,IAAI,CAAA;CACnG,CAAA;AAED,eAAO,MAAM,UAAU,GAAI,sBAAqB;IAAE,eAAe,CAAC,EAAE,mBAAmB,CAAA;CAAO,SAM7F,CAAA;AAED,wBAAgB,iBAAiB,CAAC,eAAe,CAAC,EAAE,mBAAmB,QAatE;AAmcD,KAAK,wBAAwB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAA;AAgEvE,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,OAAO,EAAE,EACxB,SAAS,EAAE,aAAa,EACxB,aAAa,SAAI,EACjB,aAAa,SAAgB,EAC7B,YAAY,GAAE,SAAS,sBAAsB,EAE5C,EACD,YAAY,SAAuB,EACnC,eAAe,CAAC,EAAE,wBAAwB,GACzC,KAAK,CAAC,cAAc,CAwPtB"}
+{"version":3,"file":"wall-system.d.ts","sourceRoot":"","sources":["../../../src/systems/wall/wall-system.tsx"],"names":[],"mappings":"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"}