@pascal-app/core 1.0.3 → 1.0.5

package/dist/schema/nodes/wall.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wall.d.ts","sourceRoot":"","sources":["../../../src/schema/nodes/wall.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"wall.d.ts","sourceRoot":"","sources":["../../../src/schema/nodes/wall.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAW5C,eAAO,MAAM,iBAAiB;;;;;;EAAqD,CAAA;AACnF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAEjE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;EAkB1B,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAE7D,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAOzB,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAE3D,eAAO,MAAM,qBAAqB,EAAE,cAMnC,CAAA;AAED,eAAO,MAAM,kBAAkB,EAAE,cAMhC,CAAA;AAED,eAAO,MAAM,uBAAuB,EAAE,cAOrC,CAAA;AAED,eAAO,MAAM,kBAAkB;aAC7B,QAAQ;;;;;;;;aACR,KAAK;;;;;;;;aACL,SAAS;;;;;;;;CACD,CAAA;AAEV,eAAO,MAAM,0BAA0B,6BAA6B,CAAA;AACpE,eAAO,MAAM,uBAAuB,yBAAyB,CAAA;AAC7D,eAAO,MAAM,4BAA4B,yBAAyB,CAAA;AAElE,eAAO,MAAM,0BAA0B;aACrC,CAAC,EAAE,0BAA0B;aAC7B,CAAC,EAAE,0BAA0B;aAC7B,SAAS;aACT,SAAS;aACT,MAAM;aACN,MAAM;aACN,UAAU;aACV,UAAU;aAIV,UAAU,EAAE,sBAAsB;CAC1B,CAAA;AAEV,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,0BAA0B,CAAA;AACvE,MAAM,MAAM,QAAQ,GAAG,GAAG,GAAG,GAAG,CAAA;AAEhC,eAAO,MAAM,sBAAsB,IAAI,CAAA;AAMvC,eAAO,MAAM,cAAc;;;;;;;;;;;iBAQzB,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAE3D;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGzB,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAO3D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uBAAuB;;;;;iBAKlC,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E,eAAO,MAAM,gBAAgB;;;;;;;;;iBAI3B,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAU/D,eAAO,MAAM,0BAA0B;;;;;;;EAOrC,CAAA;AACF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAEnF,eAAO,MAAM,6BAA6B;;;;;EAA+C,CAAA;AACzF,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAA;AAEzF,eAAO,MAAM,uBAAuB;;;;;EAAwC,CAAA;AAC5E,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E,eAAO,MAAM,0BAA0B;;;;EAAyC,CAAA;AAChF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAEnF,qFAAqF;AACrF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6CtB,CAAA;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAEvD,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0GpB,CAAA;AACD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAA;AAE/C,0DAA0D;AAC1D,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,UAAU,CAAA;AAOrD,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAGtD,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,CAAA;AAC7D,MAAM,MAAM,cAAc,GAAG,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,EAAE,CAAA;AAE/E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,cAAc,CAEpF;AAED,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,SAAS,GAAG,QAAQ,EAAE,CAIjF;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;IACzC,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,KAAK,yBAAyB,GAAG;IAC/B,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;IACzC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,gBAAgB,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;IACjD,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,gBAAgB,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;IACjD,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAChC,CAAA;AAuBD,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,yBAAyB,EAC/B,IAAI,EAAE,eAAe,GACpB,uBAAuB,CAUzB;AAED,KAAK,sBAAsB,GAAG,yBAAyB,GAAG;IACxD,mBAAmB,CAAC,EAAE,QAAQ,CAAC,qBAAqB,CAAC,CAAA;CACtD,CAAA;AAED,mGAAmG;AACnG,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,sBAAsB,EAC5B,IAAI,EAAE,QAAQ,GACb,uBAAuB,CAMzB;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,uBAAuB,GAAG,MAAM,CAKrF"}

package/dist/schema/nodes/wall.js

@@ -1,13 +1,19 @@
 import dedent from 'dedent';
 import { z } from 'zod';
+import { Assembly } from '../assembly.js';
 import { BaseNode, nodeType, objectId } from '../base.js';
+import { GeometryScriptSource } from '../geometry-source.js';
 import { MaterialSchema } from '../material.js';
 import { CurtainWallConfig } from './curtain-wall.js';
 import { DoorNode } from './door.js';
 import { ItemNode } from './item.js';
 import { LeanToExtensionNode } from './lean-to-extension.js';
 import { WindowNode } from './window.js';
-export const WallTreatmentSide = z.enum(['interior', 'exterior', 'both']);
+// Geometric faces: `a` is left of start → end, `b` is right (wall-frame convention).
+// `interior` / `exterior` are legacy semantic values the M1 load migration maps
+// onto a face; a runtime writer that still sends one renders on its canonical
+// face (interior → a, exterior → b).
+export const WallTreatmentSide = z.enum(['a', 'b', 'both', 'interior', 'exterior']);
 export const WallTrimProfile = z.enum([
     'flat',
     'bevel',
@@ -62,54 +68,140 @@ export const WALL_TRIM_DEFAULTS = {
     crown: WALL_CROWN_DEFAULT,
     chairRail: WALL_CHAIR_RAIL_DEFAULT,
 };
-const WallFaceBandConfigShape = z.object({
-    enabled: z.boolean().default(false),
-    count: z.number().int().min(1).max(4).default(1),
-    lowerHeight: z.number().default(0.84),
-    middleHeight: z.number().default(0.61),
-    upperHeight: z.number().default(0.61),
-});
-export const WallFaceBandConfig = z.preprocess((value) => {
-    if (value && typeof value === 'object' && !Array.isArray(value) && !('count' in value)) {
-        const enabled = value.enabled === true;
-        return { ...value, count: enabled ? 3 : 1 };
-    }
-    return value;
-}, WallFaceBandConfigShape);
-export const WALL_FACE_BAND_DEFAULT = {
-    enabled: false,
-    count: 1,
-    lowerHeight: 0.84,
-    middleHeight: 0.61,
-    upperHeight: 0.61,
-};
 export const WALL_SKIRTING_SLOT_DEFAULT = 'library:preset-softwhite';
 export const WALL_CROWN_SLOT_DEFAULT = 'library:preset-white';
 export const WALL_CHAIR_RAIL_SLOT_DEFAULT = 'library:preset-cream';
-export const WALL_FACE_BAND_SOLID_SLOT_DEFAULTS = {
-    lower: 'library:preset-white',
-    middle: 'library:preset-lightgrey',
-    upper: 'library:preset-greige',
-    top: 'library:preset-softwhite',
-};
 export const WALL_SURFACE_SLOT_DEFAULTS = {
-    interior: 'library:concrete-drywall',
-    exterior: 'library:concrete-drywall',
-    lowerInterior: 'library:concrete-drywall',
-    middleInterior: 'library:concrete-drywall',
-    upperInterior: 'library:concrete-drywall',
-    topInterior: 'library:concrete-drywall',
-    lowerExterior: 'library:concrete-drywall',
-    middleExterior: 'library:concrete-drywall',
-    upperExterior: 'library:concrete-drywall',
-    topExterior: 'library:concrete-drywall',
-    skirtingInterior: WALL_SKIRTING_SLOT_DEFAULT,
-    skirtingExterior: WALL_SKIRTING_SLOT_DEFAULT,
-    crownInterior: WALL_CROWN_SLOT_DEFAULT,
-    crownExterior: WALL_CROWN_SLOT_DEFAULT,
-    chairRailInterior: WALL_CHAIR_RAIL_SLOT_DEFAULT,
-    chairRailExterior: WALL_CHAIR_RAIL_SLOT_DEFAULT,
+    a: 'library:concrete-drywall',
+    b: 'library:concrete-drywall',
+    aSkirting: WALL_SKIRTING_SLOT_DEFAULT,
+    bSkirting: WALL_SKIRTING_SLOT_DEFAULT,
+    aCrown: WALL_CROWN_SLOT_DEFAULT,
+    bCrown: WALL_CROWN_SLOT_DEFAULT,
+    aChairRail: WALL_CHAIR_RAIL_SLOT_DEFAULT,
+    bChairRail: WALL_CHAIR_RAIL_SLOT_DEFAULT,
+    // The foundation under a wall's underpinning (see WallNode.underpinning):
+    // the concrete stemwall between the finish carried down over the floor
+    // platform and the ground.
+    foundation: 'library:concrete-raw',
 };
+export const WALL_FACE_REGION_LIMIT = 8;
+// A paint region overrides one face's finish inside a rectangle without cutting
+// the wall. `u` is metres from the wall start along the reference line (along
+// the chord for curved walls); `v` is metres above the face's own base. An
+// absent bound runs to that edge, so a wainscot stretches with the wall.
+export const WallFaceRegion = z.object({
+    id: z.string(),
+    face: z.enum(['a', 'b']),
+    u0: z.number().finite().optional(),
+    u1: z.number().finite().optional(),
+    v0: z.number().finite().optional(),
+    v1: z.number().finite().optional(),
+    finish: z.string(),
+});
+/**
+ * One wall face's finish built by a three.js module for exactly that face (`lib/wall-face-script`):
+ * the module gets the face's rectangle, its openings and its base in the face's own frame and lays
+ * tiles, boards or panelling on them. `inputs` is the key of the face it was built for; once the
+ * face differs (the wall lengthened, an opening added) the script is stale and runs again.
+ * `toHeight` (metres above the face's base) stops it there, as a dado does; absent, it covers the
+ * whole face.
+ */
+export const WallFaceScript = GeometryScriptSource.extend({
+    inputs: z.string(),
+    toHeight: z.number().positive().optional(),
+});
+const WallSurfaceMaterialSpecSchema = z.object({
+    material: MaterialSchema.optional(),
+    materialPreset: z.string().optional(),
+});
+/**
+ * What a wall carries BELOW its base on a house standing above the ground:
+ * `rim` metres of its exterior finish continued down over the floor
+ * platform's edge (subfloor, rim joist, mudsill), then the foundation —
+ * the concrete stemwall, painted through the `foundation` slot — `stem`
+ * metres more to the ground (with `fillToTerrain`, to the terrain wherever
+ * that is lower). The wall body, its top and its openings are unchanged,
+ * and the framers ignore it (a framing plugin pours its own stemwall
+ * from the building's foundation record). `openings` are the holes through the
+ * stem — a crawl space's vents and its access (IRC R408) — `u` metres
+ * along the wall from its start (the opening's centre), `top` and `bottom`
+ * in metres below the wall base.
+ */
+export const WallUnderpinningOpening = z.object({
+    u: z.number(),
+    width: z.number().positive(),
+    top: z.number().min(0),
+    bottom: z.number().min(0),
+});
+export const WallUnderpinning = z.object({
+    rim: z.number().min(0),
+    stem: z.number().min(0),
+    openings: z.array(WallUnderpinningOpening).optional(),
+});
+// ---------------------------------------------------------------------------
+// Wall assembly (WS5), legacy shape
+// ---------------------------------------------------------------------------
+// The four-slot stack #937 stored in `wall.assembly`. Walls now store F2
+// layers (`Assembly`, schema/assembly.ts); scenes saved with this shape are
+// converted on load (`migrateWallAssemblies`, `wallAssemblyFromLegacy`), and
+// the inspector edits F2 stacks through this view (`wallAssemblyToLegacy`).
+export const WallAssemblyExteriorFinish = z.enum([
+    'siding',
+    'stucco',
+    'brick',
+    'stone',
+    'fiber-cement',
+    'none',
+]);
+export const WallAssemblySheathingMaterial = z.enum(['osb', 'plywood', 'gypsum', 'none']);
+export const WallAssemblyFramingKind = z.enum(['wood', 'lgs', 'cmu', 'icf']);
+export const WallAssemblyInteriorFinish = z.enum(['drywall', 'plaster', 'none']);
+/** @deprecated The WS5 shape, kept for the load migration and the inspector view. */
+export const WallAssembly = z
+    .object({
+    /** Id of a `WALL_ASSEMBLY_PRESETS` entry this stack was seeded from. */
+    preset: z.string().optional(),
+    /** Outermost cladding. For `brick` the thickness INCLUDES the air space. */
+    exterior: z
+        .object({
+        finish: WallAssemblyExteriorFinish,
+        thickness: z.number().nonnegative(),
+    })
+        .optional(),
+    sheathing: z
+        .object({
+        material: WallAssemblySheathingMaterial,
+        thickness: z.number().nonnegative(),
+    })
+        .optional(),
+    /** The structural core. Always present — it is what makes a wall a wall. */
+    framing: z.object({
+        kind: WallAssemblyFramingKind,
+        depth: z.number().nonnegative(),
+    }),
+    interior: z
+        .object({
+        finish: WallAssemblyInteriorFinish,
+        thickness: z.number().nonnegative(),
+    })
+        .optional(),
+    /** Free-text cavity insulation note (e.g. 'R-21 batt'). No geometry. */
+    cavityInsulation: z.string().optional(),
+})
+    .describe(dedent `
+    Layered wall assembly, all thicknesses in metres, ordered outside -> inside:
+    exterior finish, sheathing, framing, interior finish.
+    - When present, this is the SINGLE SOURCE OF TRUTH for wall thickness:
+      wall.thickness MUST equal assemblyThickness(assembly) and is rewritten on
+      every assembly edit. Consumers keep reading wall.thickness as the total.
+    - A stack with neither exterior nor sheathing is a PARTITION: the interior
+      finish is applied to BOTH faces (total = 2 x interior + framing).
+    - Which face is exterior comes from wall.frontSide / wall.backSide;
+      frontSide is the +normal side, normal = perp(end - start).
+    - The weather-resistive barrier (IRC R703.2) is intentionally not modelled:
+      it is a film with no drawable thickness.
+    `);
 export const WallNode = BaseNode.extend({
     id: objectId('wall'),
     type: nodeType('wall'),
@@ -133,13 +225,42 @@ export const WallNode = BaseNode.extend({
     exteriorMaterial: MaterialSchema.optional(),
     exteriorMaterialPreset: z.string().optional(),
     // Per-slot material overrides on the unified slot model, mirroring
-    // `SlabNode.slots`. Key = slot id (`interior` / `exterior`), value = a
-    // `MaterialRef` (`library:<id>` / `scene:<id>`). Absent = the declared slot
-    // default (`WALL_SLOT_DEFAULT`). The legacy `*Material*` fields above are
-    // read only by the load migration that moves them into `slots`; delete them
-    // in a follow-up once migrated scenes are the norm.
+    // `SlabNode.slots`. Key = geometric slot id (`a` / `b` faces, `aSkirting` …
+    // trims), value = a `MaterialRef` (`library:<id>` / `scene:<id>`). Absent =
+    // the declared slot default (`WALL_SLOT_DEFAULT`). Legacy `interior` /
+    // `exterior` keys are rewritten by the M1 load migration.
     slots: z.record(z.string(), z.string()).optional(),
+    // Legacy per-face inline finish, written only by the M1 load migration from
+    // `interiorMaterial*` / `exteriorMaterial*` so a face keeps the fallback it
+    // rendered with. Read after `slots[face]`, before `material` / `materialPreset`.
+    legacyFaceMaterials: z
+        .object({
+        a: WallSurfaceMaterialSpecSchema.optional(),
+        b: WallSurfaceMaterialSpecSchema.optional(),
+    })
+        .optional(),
+    // Later entries win; at most WALL_FACE_REGION_LIMIT per face.
+    faceRegions: z
+        .array(WallFaceRegion)
+        .superRefine((regions, ctx) => {
+        for (const face of ['a', 'b']) {
+            if (regions.filter((region) => region.face === face).length > WALL_FACE_REGION_LIMIT)
+                ctx.addIssue({
+                    code: 'custom',
+                    message: `At most ${WALL_FACE_REGION_LIMIT} paint regions per wall face`,
+                });
+        }
+    })
+        .optional(),
+    // TOTAL wall thickness in metres — the one number every consumer reads.
+    // The sum of `assembly`'s layers whenever an assembly is present.
     thickness: z.number().optional(),
+    // Layered construction stack (F2). Optional: absent = a single unspecified
+    // slab of `thickness`. Present = the stack sets `thickness`: edit the layers
+    // and write their sum (`wallAssemblyPatch`), never `thickness` alone.
+    assembly: Assembly.optional(),
+    // Absent centers the body; a/b place it left/right of the stored start → end line.
+    justification: z.enum(['a', 'b']).optional(),
     height: z.number().optional(),
     curveOffset: z.number().optional(),
     // Persisted slab-support host — see ItemNode.supportSlabId for the rules.
@@ -150,22 +271,34 @@ export const WallNode = BaseNode.extend({
     // Extend downward from the authored wall base to the terrain while keeping
     // the wall body height and top unchanged.
     fillToTerrain: z.boolean().optional(),
-    faceBands: WallFaceBandConfig.optional(),
+    cap: z.boolean().optional(),
+    // The finish and the foundation carried below the base — see WallUnderpinning.
+    underpinning: WallUnderpinning.optional(),
     skirting: WallTrimConfig.optional(),
     crown: WallTrimConfig.optional(),
     chairRail: WallTrimConfig.optional(),
+    // Per-face finish built by a script — see WallFaceScript.
+    finishScripts: z
+        .object({ a: WallFaceScript.optional(), b: WallFaceScript.optional() })
+        .optional(),
     // e.g., start/end points for path
     start: z.tuple([z.number(), z.number()]),
     end: z.tuple([z.number(), z.number()]),
-    // Space detection for cutaway mode
+    // Derived room classification per face, still written by the structure
+    // kernel for cutaway and dimension readers. Wall finishes never read it.
     frontSide: z.enum(['interior', 'exterior', 'unknown']).default('unknown'),
     backSide: z.enum(['interior', 'exterior', 'unknown']).default('unknown'),
 }).describe(dedent `
   Wall node - used to represent a wall in the building
-  - thickness: thickness in meters
+  - thickness: TOTAL thickness in meters (all assembly layers together)
+  - assembly: optional layered construction stack; when present it is the single
+    source of truth and thickness is re-derived from it on every edit
   - height: height in meters
   - fillToTerrain: extends the wall downward to the terrain without changing its authored height
+  - underpinning: { rim, stem } — the finish carried rim metres below the base over the floor
+    platform's edge, then stem metres of concrete stemwall to the ground (the foundation slot)
   - curveOffset: midpoint sagitta offset used to bend the wall into an arc
+  - finishScripts: { a?, b? } — a three.js module that builds one face's finish (tiles, boards, panelling) for that face, optionally only up to toHeight; it owns that face's colours
   - start: start point of the wall in level coordinate system
   - end: end point of the wall in level coordinate system
   - size: size of the wall in grid units
@@ -178,142 +311,19 @@ export const WallNode = BaseNode.extend({
 // May be a `#rrggbb` colour or a `library:<id>` ref. Textures-off still
 // collapses to the themed wall role (the escape hatch).
 export const WALL_SLOT_DEFAULT = {
-    interior: WALL_SURFACE_SLOT_DEFAULTS.interior,
-    exterior: WALL_SURFACE_SLOT_DEFAULTS.exterior,
+    a: WALL_SURFACE_SLOT_DEFAULTS.a,
+    b: WALL_SURFACE_SLOT_DEFAULTS.b,
 };
-export function getWallFaceBandConfig(wall, effectiveWallHeight) {
-    const wallHeight = Math.max(0, effectiveWallHeight);
-    const raw = { ...WALL_FACE_BAND_DEFAULT, ...(wall.faceBands ?? {}) };
-    const count = raw.enabled ? Math.max(1, Math.min(4, Math.round(raw.count ?? 3))) : 1;
-    const lowerHeight = count >= 2 ? Math.max(0, Math.min(wallHeight, raw.lowerHeight)) : 0;
-    const middleHeight = count >= 3 ? Math.max(0, Math.min(wallHeight - lowerHeight, raw.middleHeight)) : 0;
-    const upperHeight = count >= 4 ? Math.max(0, Math.min(wallHeight - lowerHeight - middleHeight, raw.upperHeight)) : 0;
-    return {
-        enabled: raw.enabled && count > 1,
-        count,
-        lowerHeight,
-        middleHeight,
-        upperHeight,
-        lowerTop: lowerHeight,
-        middleTop: lowerHeight + middleHeight,
-        upperTop: lowerHeight + middleHeight + upperHeight,
-    };
-}
-export function getWallFaceBandForHeight(wall, y, effectiveWallHeight) {
-    const bands = getWallFaceBandConfig(wall, effectiveWallHeight);
-    if (!bands.enabled)
-        return 'upper';
-    if (y < bands.lowerTop)
-        return 'lower';
-    if (y < bands.middleTop)
-        return 'middle';
-    if (bands.count >= 4 && y < bands.upperTop)
-        return 'upper';
-    if (bands.count >= 4)
-        return 'top';
-    return 'upper';
+export function getWallTrimSlotId(face, kind) {
+    return `${face}${kind === 'skirting' ? 'Skirting' : kind === 'crown' ? 'Crown' : 'ChairRail'}`;
 }
-export function getWallBandSlotId(side, band) {
-    const suffix = side === 'interior' ? 'Interior' : 'Exterior';
-    return `${band}${suffix}`;
-}
-const WALL_FACE_BAND_SLOTS_BY_SIDE = {
-    interior: ['lowerInterior', 'middleInterior', 'upperInterior', 'topInterior'],
-    exterior: ['lowerExterior', 'middleExterior', 'upperExterior', 'topExterior'],
-};
-function getWallFaceBandSlotsForCount(side, count) {
-    if (count <= 1)
-        return [];
-    if (side === 'interior') {
-        if (count === 2)
-            return ['lowerInterior', 'upperInterior'];
-        if (count === 3)
-            return ['lowerInterior', 'middleInterior', 'upperInterior'];
-        return ['lowerInterior', 'middleInterior', 'upperInterior', 'topInterior'];
-    }
-    if (count === 2)
-        return ['lowerExterior', 'upperExterior'];
-    if (count === 3)
-        return ['lowerExterior', 'middleExterior', 'upperExterior'];
-    return ['lowerExterior', 'middleExterior', 'upperExterior', 'topExterior'];
-}
-function getWallFaceBandDefaultSlot(slotId) {
-    if (slotId.startsWith('lower'))
-        return WALL_FACE_BAND_SOLID_SLOT_DEFAULTS.lower;
-    if (slotId.startsWith('middle'))
-        return WALL_FACE_BAND_SOLID_SLOT_DEFAULTS.middle;
-    if (slotId.startsWith('top'))
-        return WALL_FACE_BAND_SOLID_SLOT_DEFAULTS.top;
-    return WALL_FACE_BAND_SOLID_SLOT_DEFAULTS.upper;
-}
-function getWallFaceTopBandSlot(side, count) {
-    const slots = getWallFaceBandSlotsForCount(side, count);
-    return slots[slots.length - 1] ?? null;
-}
-export function buildWallFaceBandCountPatch(wall, count) {
-    const slots = { ...(wall.slots ?? {}) };
-    const nextCount = Math.max(1, Math.min(4, Math.round(count)));
-    const previousCount = wall.faceBands?.enabled
-        ? Math.max(1, Math.min(4, Math.round(wall.faceBands.count ?? 3)))
-        : 1;
-    for (const side of ['interior', 'exterior']) {
-        const nextSlots = getWallFaceBandSlotsForCount(side, nextCount);
-        const activeSlots = new Set(nextSlots);
-        const previouslyActiveSlots = new Set(getWallFaceBandSlotsForCount(side, previousCount));
-        const previousTopSlot = getWallFaceTopBandSlot(side, previousCount);
-        const nextTopSlot = getWallFaceTopBandSlot(side, nextCount);
-        const topMaterial = (previousTopSlot ? slots[previousTopSlot] : undefined) ??
-            slots[side] ??
-            WALL_SURFACE_SLOT_DEFAULTS[side];
-        for (const slotId of WALL_FACE_BAND_SLOTS_BY_SIDE[side]) {
-            if (activeSlots.has(slotId)) {
-                if (slotId === nextTopSlot) {
-                    slots[slotId] = topMaterial;
-                    continue;
-                }
-                const wasActive = previouslyActiveSlots.has(slotId);
-                const wasPreviousTop = slotId === previousTopSlot;
-                if (!wasActive || wasPreviousTop || !slots[slotId]) {
-                    slots[slotId] = getWallFaceBandDefaultSlot(slotId);
-                }
-            }
-            else {
-                delete slots[slotId];
-            }
-        }
-    }
-    return {
-        faceBands: {
-            ...WALL_FACE_BAND_DEFAULT,
-            ...(wall.faceBands ?? {}),
-            enabled: nextCount > 1,
-            count: nextCount,
-            lowerHeight: wall.faceBands?.lowerHeight ?? WALL_FACE_BAND_DEFAULT.lowerHeight,
-            middleHeight: wall.faceBands?.middleHeight ?? WALL_FACE_BAND_DEFAULT.middleHeight,
-            upperHeight: wall.faceBands?.upperHeight ?? WALL_FACE_BAND_DEFAULT.upperHeight,
-        },
-        slots,
-    };
-}
-export function buildEnabledWallFaceBandPatch(wall) {
-    return buildWallFaceBandCountPatch(wall, 2);
-}
-export function getWallSurfaceSideFromBandSlot(slotId) {
-    if (slotId === 'interior' || slotId === 'exterior')
-        return slotId;
-    if (slotId === 'lowerInterior' ||
-        slotId === 'middleInterior' ||
-        slotId === 'upperInterior' ||
-        slotId === 'topInterior') {
-        return 'interior';
-    }
-    if (slotId === 'lowerExterior' ||
-        slotId === 'middleExterior' ||
-        slotId === 'upperExterior' ||
-        slotId === 'topExterior') {
-        return 'exterior';
-    }
-    return null;
+/** Faces a trim config draws on. Legacy semantic values use their canonical face. */
+export function getWallTrimFaces(sides) {
+    if (sides === 'a' || sides === 'interior')
+        return ['a'];
+    if (sides === 'b' || sides === 'exterior')
+        return ['b'];
+    return ['a', 'b'];
 }
 function getConfiguredWallSurfaceMaterial(wall, side) {
     if (side === 'interior') {
@@ -340,6 +350,14 @@ export function getEffectiveWallSurfaceMaterial(wall, side) {
         materialPreset: wall.materialPreset,
     };
 }
+/** A face's legacy inline finish: its migrated per-face spec, else the wall-wide legacy fields. */
+export function getEffectiveWallFaceMaterial(wall, face) {
+    const configured = wall.legacyFaceMaterials?.[face];
+    if (configured && hasSurfaceMaterial(configured)) {
+        return { material: configured.material, materialPreset: configured.materialPreset };
+    }
+    return { material: wall.material, materialPreset: wall.materialPreset };
+}
 export function getWallSurfaceMaterialSignature(spec) {
     return JSON.stringify({
         material: spec.material ?? null,