@pascal-app/core 1.0.1 → 1.0.4

package/dist/node-slots/column.js

@@ -0,0 +1,24 @@
+export const COLUMN_SHAFT_DEFAULT = 'library:concrete-plaster';
+export const COLUMN_BASE_DEFAULT = 'library:concrete-plaster';
+export const COLUMN_CAPITAL_DEFAULT = 'library:concrete-plaster';
+export const COLUMN_FRAME_DEFAULT = 'library:metal-steel';
+export function columnSlots(node) {
+    if (node.source)
+        return node.source.manifest.slots.map((slot) => ({
+            slotId: slot.id,
+            label: slot.label ?? slot.id,
+        }));
+    const slots = [
+        { slotId: 'shaft', label: 'Shaft', default: COLUMN_SHAFT_DEFAULT },
+    ];
+    if (node.baseStyle !== 'none') {
+        slots.push({ slotId: 'base', label: 'Base', default: COLUMN_BASE_DEFAULT });
+    }
+    if (node.capitalStyle !== 'none') {
+        slots.push({ slotId: 'capital', label: 'Capital', default: COLUMN_CAPITAL_DEFAULT });
+    }
+    if (node.supportStyle !== 'vertical') {
+        slots.push({ slotId: 'frame', label: 'Frame', default: COLUMN_FRAME_DEFAULT });
+    }
+    return slots;
+}

package/dist/node-slots/door.d.ts

@@ -0,0 +1,9 @@
+import type { SlotDeclaration } from '../registry/types.js';
+export type DoorSlotId = 'panel' | 'frame' | 'glass' | 'hardware';
+/**
+ * A door exposes four paintable slots: `panel` (leaf faces), `frame`, `glass`,
+ * and `hardware` (handle / hinges / closer / panic bar). The opening reveal
+ * keeps its own material.
+ */
+export declare function doorSlots(): SlotDeclaration[];
+//# sourceMappingURL=door.d.ts.map

package/dist/node-slots/door.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"door.d.ts","sourceRoot":"","sources":["../../src/node-slots/door.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CAAA;AAUjE;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,eAAe,EAAE,CAO7C"}

package/dist/node-slots/door.js

@@ -0,0 +1,20 @@
+// Picker swatches. Rendering falls back to the live body/glass/hardware defaults
+// (which already track shading + theme), so these are just the indicator colours.
+const PANEL_DEFAULT = 'library:preset-softwhite';
+const FRAME_DEFAULT = 'library:preset-softwhite';
+const GLASS_DEFAULT = 'library:preset-glass';
+// Chrome — a flat (non-PBR) catalog metal finish.
+const HARDWARE_DEFAULT = 'library:metal-chrome';
+/**
+ * A door exposes four paintable slots: `panel` (leaf faces), `frame`, `glass`,
+ * and `hardware` (handle / hinges / closer / panic bar). The opening reveal
+ * keeps its own material.
+ */
+export function doorSlots() {
+    return [
+        { slotId: 'panel', label: 'Panel', default: PANEL_DEFAULT },
+        { slotId: 'frame', label: 'Frame', default: FRAME_DEFAULT },
+        { slotId: 'glass', label: 'Glass', default: GLASS_DEFAULT },
+        { slotId: 'hardware', label: 'Hardware', default: HARDWARE_DEFAULT },
+    ];
+}

package/dist/node-slots/duct.d.ts

@@ -0,0 +1,5 @@
+import type { SlotDeclaration } from '../registry/types.js';
+export declare const DUCT_BODY_SLOT_ID = "body";
+export declare const DUCT_BODY_SLOT_DEFAULT = "#ffffff";
+export declare function ductBodySlots(): SlotDeclaration[];
+//# sourceMappingURL=duct.d.ts.map

package/dist/node-slots/duct.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duct.d.ts","sourceRoot":"","sources":["../../src/node-slots/duct.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD,eAAO,MAAM,iBAAiB,SAAS,CAAA;AACvC,eAAO,MAAM,sBAAsB,YAAY,CAAA;AAE/C,wBAAgB,aAAa,IAAI,eAAe,EAAE,CAEjD"}

package/dist/node-slots/duct.js

@@ -0,0 +1,5 @@
+export const DUCT_BODY_SLOT_ID = 'body';
+export const DUCT_BODY_SLOT_DEFAULT = '#ffffff';
+export function ductBodySlots() {
+    return [{ slotId: DUCT_BODY_SLOT_ID, label: 'Body', default: DUCT_BODY_SLOT_DEFAULT }];
+}

package/dist/node-slots/elevator.d.ts

@@ -0,0 +1,9 @@
+import type { SlotDeclaration } from '../registry/types.js';
+import type { ElevatorNode } from '../schema/nodes/elevator.js';
+export type ElevatorSlotId = 'cab' | 'doors' | 'shaft' | 'glass';
+export declare const ELEVATOR_CAB_SLOT_DEFAULT = "library:preset-softwhite";
+export declare const ELEVATOR_DOORS_SLOT_DEFAULT = "library:metal-steel";
+export declare const ELEVATOR_SHAFT_SLOT_DEFAULT = "library:preset-lightgrey";
+export declare const ELEVATOR_GLASS_SLOT_DEFAULT = "library:preset-glass";
+export declare function elevatorSlots(node: ElevatorNode): SlotDeclaration[];
+//# sourceMappingURL=elevator.d.ts.map

package/dist/node-slots/elevator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elevator.d.ts","sourceRoot":"","sources":["../../src/node-slots/elevator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAM5D,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAA;AAEhE,eAAO,MAAM,yBAAyB,6BAA6B,CAAA;AACnE,eAAO,MAAM,2BAA2B,wBAAwB,CAAA;AAChE,eAAO,MAAM,2BAA2B,6BAA6B,CAAA;AACrE,eAAO,MAAM,2BAA2B,yBAAyB,CAAA;AAEjE,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,eAAe,EAAE,CAenE"}

package/dist/node-slots/elevator.js

@@ -0,0 +1,17 @@
+import { getResolvedElevatorDoorPanelStyle, getResolvedElevatorShaftStyle, } from '../systems/elevator/elevator-geometry.js';
+export const ELEVATOR_CAB_SLOT_DEFAULT = 'library:preset-softwhite';
+export const ELEVATOR_DOORS_SLOT_DEFAULT = 'library:metal-steel';
+export const ELEVATOR_SHAFT_SLOT_DEFAULT = 'library:preset-lightgrey';
+export const ELEVATOR_GLASS_SLOT_DEFAULT = 'library:preset-glass';
+export function elevatorSlots(node) {
+    const slots = [
+        { slotId: 'cab', label: 'Cab', default: ELEVATOR_CAB_SLOT_DEFAULT },
+        { slotId: 'doors', label: 'Doors', default: ELEVATOR_DOORS_SLOT_DEFAULT },
+        { slotId: 'shaft', label: 'Shaft', default: ELEVATOR_SHAFT_SLOT_DEFAULT },
+    ];
+    const hasGlass = getResolvedElevatorShaftStyle(node.shaftStyle) === 'glass' ||
+        getResolvedElevatorDoorPanelStyle(node.doorPanelStyle) === 'glass-frame';
+    if (hasGlass)
+        slots.push({ slotId: 'glass', label: 'Glass', default: ELEVATOR_GLASS_SLOT_DEFAULT });
+    return slots;
+}

package/dist/node-slots/fence.d.ts

@@ -0,0 +1,10 @@
+import type { SlotDeclaration } from '../registry/types.js';
+import type { FenceNode } from '../schema/nodes/fence.js';
+export type FenceSlotId = 'posts' | 'infill' | 'base' | 'rail';
+export declare const FENCE_POSTS_SLOT_DEFAULT = "library:preset-white";
+export declare const FENCE_INFILL_SLOT_DEFAULT = "library:preset-white";
+export declare const FENCE_BASE_SLOT_DEFAULT = "library:preset-white";
+export declare const FENCE_RAIL_SLOT_DEFAULT = "library:preset-white";
+export declare const FENCE_SLOT_DEFAULTS: Record<FenceSlotId, string>;
+export declare function fenceSlots(node: FenceNode): SlotDeclaration[];
+//# sourceMappingURL=fence.d.ts.map

package/dist/node-slots/fence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fence.d.ts","sourceRoot":"","sources":["../../src/node-slots/fence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAItD,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAA;AAE9D,eAAO,MAAM,wBAAwB,yBAAyB,CAAA;AAC9D,eAAO,MAAM,yBAAyB,yBAAyB,CAAA;AAC/D,eAAO,MAAM,uBAAuB,yBAAyB,CAAA;AAC7D,eAAO,MAAM,uBAAuB,yBAAyB,CAAA;AAE7D,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAK3D,CAAA;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,eAAe,EAAE,CAY7D"}

package/dist/node-slots/fence.js

@@ -0,0 +1,23 @@
+export const FENCE_POSTS_SLOT_DEFAULT = 'library:preset-white';
+export const FENCE_INFILL_SLOT_DEFAULT = 'library:preset-white';
+export const FENCE_BASE_SLOT_DEFAULT = 'library:preset-white';
+export const FENCE_RAIL_SLOT_DEFAULT = 'library:preset-white';
+export const FENCE_SLOT_DEFAULTS = {
+    posts: FENCE_POSTS_SLOT_DEFAULT,
+    infill: FENCE_INFILL_SLOT_DEFAULT,
+    base: FENCE_BASE_SLOT_DEFAULT,
+    rail: FENCE_RAIL_SLOT_DEFAULT,
+};
+export function fenceSlots(node) {
+    const slots = [
+        { slotId: 'posts', label: 'Posts', default: FENCE_POSTS_SLOT_DEFAULT },
+    ];
+    if (node.showInfill !== false) {
+        slots.push({ slotId: 'infill', label: 'Infill', default: FENCE_INFILL_SLOT_DEFAULT });
+    }
+    if (node.baseStyle !== 'floating') {
+        slots.push({ slotId: 'base', label: 'Base', default: FENCE_BASE_SLOT_DEFAULT });
+    }
+    slots.push({ slotId: 'rail', label: 'Rail', default: FENCE_RAIL_SLOT_DEFAULT });
+    return slots;
+}

package/dist/node-slots/index.d.ts

@@ -0,0 +1,25 @@
+import type { SlotDeclaration } from '../registry/types.js';
+import type { AnyNode } from '../schema/types.js';
+export * from './block.js';
+export * from './cabinet.js';
+export * from './ceiling.js';
+export * from './column.js';
+export * from './door.js';
+export * from './duct.js';
+export * from './elevator.js';
+export * from './fence.js';
+export * from './lean-to-extension.js';
+export * from './procedural-item.js';
+export * from './roof-accessories.js';
+export * from './shelf.js';
+export * from './slab.js';
+export * from './stair.js';
+export * from './wall.js';
+export * from './window.js';
+/**
+ * The paintable slots a node exposes — the keys its `slots` may carry. A node
+ * built from a script exposes its manifest's slots. Null for a kind that
+ * declares none here (an item's slots come from its GLB).
+ */
+export declare function nodeSlotDeclarations(node: AnyNode): SlotDeclaration[] | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/node-slots/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node-slots/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAyB9C,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA;AACxB,cAAc,QAAQ,CAAA;AACtB,cAAc,QAAQ,CAAA;AACtB,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA;AACtB,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA;AACtB,cAAc,UAAU,CAAA;AAExB;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,EAAE,GAAG,IAAI,CAsD5E"}

package/dist/node-slots/index.js

@@ -0,0 +1,92 @@
+import { blockSlots } from './block.js';
+import { cabinetSlots } from './cabinet.js';
+import { ceilingSlots } from './ceiling.js';
+import { columnSlots } from './column.js';
+import { doorSlots } from './door.js';
+import { ductBodySlots } from './duct.js';
+import { elevatorSlots } from './elevator.js';
+import { fenceSlots } from './fence.js';
+import { leanToSlots } from './lean-to-extension.js';
+import { proceduralItemSlots } from './procedural-item.js';
+import { boxVentSlots, cupolaSlots, downspoutSlots, eyebrowVentSlots, gutterSlots, turbineVentSlots, } from './roof-accessories.js';
+import { shelfSlots } from './shelf.js';
+import { slabSlots } from './slab.js';
+import { stairSlots } from './stair.js';
+import { wallSlots } from './wall.js';
+import { windowSlots } from './window.js';
+export * from './block.js';
+export * from './cabinet.js';
+export * from './ceiling.js';
+export * from './column.js';
+export * from './door.js';
+export * from './duct.js';
+export * from './elevator.js';
+export * from './fence.js';
+export * from './lean-to-extension.js';
+export * from './procedural-item.js';
+export * from './roof-accessories.js';
+export * from './shelf.js';
+export * from './slab.js';
+export * from './stair.js';
+export * from './wall.js';
+export * from './window.js';
+/**
+ * The paintable slots a node exposes — the keys its `slots` may carry. A node
+ * built from a script exposes its manifest's slots. Null for a kind that
+ * declares none here (an item's slots come from its GLB).
+ */
+export function nodeSlotDeclarations(node) {
+    const source = node
+        .source;
+    if (source?.manifest?.slots) {
+        return source.manifest.slots.map((slot) => ({ slotId: slot.id, label: slot.label ?? slot.id }));
+    }
+    switch (node.type) {
+        case 'block':
+            return blockSlots(node);
+        case 'box-vent':
+            return boxVentSlots();
+        case 'cabinet':
+        case 'cabinet-module':
+            return cabinetSlots();
+        case 'ceiling':
+            return ceilingSlots();
+        case 'column':
+            return columnSlots(node);
+        case 'cupola':
+            return cupolaSlots();
+        case 'door':
+            return doorSlots();
+        case 'downspout':
+            return downspoutSlots();
+        case 'duct-fitting':
+        case 'duct-segment':
+            return ductBodySlots();
+        case 'elevator':
+            return elevatorSlots(node);
+        case 'eyebrow-vent':
+            return eyebrowVentSlots();
+        case 'fence':
+            return fenceSlots(node);
+        case 'gutter':
+            return gutterSlots();
+        case 'lean-to-extension':
+            return leanToSlots();
+        case 'procedural-item':
+            return proceduralItemSlots(node);
+        case 'shelf':
+            return shelfSlots(node);
+        case 'slab':
+            return slabSlots();
+        case 'stair':
+            return stairSlots(node);
+        case 'turbine-vent':
+            return turbineVentSlots();
+        case 'wall':
+            return wallSlots(node);
+        case 'window':
+            return windowSlots();
+        default:
+            return null;
+    }
+}

package/dist/node-slots/lean-to-extension.d.ts

@@ -0,0 +1,5 @@
+import type { SlotDeclaration } from '../registry/types.js';
+export type LeanToSlotId = 'flashing' | 'ledger' | 'beam' | 'framing' | 'posts' | 'footings';
+export declare const LEAN_TO_SLOT_DEFAULTS: Partial<Record<LeanToSlotId, string>>;
+export declare function leanToSlots(): SlotDeclaration[];
+//# sourceMappingURL=lean-to-extension.d.ts.map

package/dist/node-slots/lean-to-extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lean-to-extension.d.ts","sourceRoot":"","sources":["../../src/node-slots/lean-to-extension.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAA;AAE5F,eAAO,MAAM,qBAAqB,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAIvE,CAAA;AAED,wBAAgB,WAAW,IAAI,eAAe,EAAE,CAS/C"}

package/dist/node-slots/lean-to-extension.js

@@ -0,0 +1,15 @@
+export const LEAN_TO_SLOT_DEFAULTS = {
+    flashing: 'library:metal-steel',
+    posts: 'library:concrete-plaster',
+    footings: 'library:concrete-plaster',
+};
+export function leanToSlots() {
+    return [
+        { slotId: 'flashing', label: 'Flashing', default: LEAN_TO_SLOT_DEFAULTS.flashing },
+        { slotId: 'ledger', label: 'Ledger / high beam', default: LEAN_TO_SLOT_DEFAULTS.ledger },
+        { slotId: 'beam', label: 'Low beam', default: LEAN_TO_SLOT_DEFAULTS.beam },
+        { slotId: 'framing', label: 'Framing', default: LEAN_TO_SLOT_DEFAULTS.framing },
+        { slotId: 'posts', label: 'Posts', default: LEAN_TO_SLOT_DEFAULTS.posts },
+        { slotId: 'footings', label: 'Footings', default: LEAN_TO_SLOT_DEFAULTS.footings },
+    ];
+}

package/dist/node-slots/procedural-item.d.ts

@@ -0,0 +1,4 @@
+import type { ProceduralItemNode } from '../procedural-items/node.js';
+import type { SlotDeclaration } from '../registry/types.js';
+export declare function proceduralItemSlots(node: ProceduralItemNode): SlotDeclaration[];
+//# sourceMappingURL=procedural-item.d.ts.map

package/dist/node-slots/procedural-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedural-item.d.ts","sourceRoot":"","sources":["../../src/node-slots/procedural-item.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,GAAG,eAAe,EAAE,CAE/E"}

package/dist/node-slots/procedural-item.js

@@ -0,0 +1,3 @@
+export function proceduralItemSlots(node) {
+    return node.recipe.slots.map((s) => ({ slotId: s.id, label: s.label, default: s.color }));
+}

package/dist/node-slots/roof-accessories.d.ts

@@ -0,0 +1,9 @@
+import type { SlotDeclaration } from '../registry/types.js';
+export declare const CUPOLA_LOUVERS_DEFAULT = "library:preset-metal";
+export declare function boxVentSlots(): SlotDeclaration[];
+export declare function cupolaSlots(): SlotDeclaration[];
+export declare function eyebrowVentSlots(): SlotDeclaration[];
+export declare function turbineVentSlots(): SlotDeclaration[];
+export declare function gutterSlots(): SlotDeclaration[];
+export declare function downspoutSlots(): SlotDeclaration[];
+//# sourceMappingURL=roof-accessories.d.ts.map

package/dist/node-slots/roof-accessories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roof-accessories.d.ts","sourceRoot":"","sources":["../../src/node-slots/roof-accessories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAGxD,eAAO,MAAM,sBAAsB,yBAAyB,CAAA;AAE5D,wBAAgB,YAAY,IAAI,eAAe,EAAE,CAKhD;AAED,wBAAgB,WAAW,IAAI,eAAe,EAAE,CAO/C;AAED,wBAAgB,gBAAgB,IAAI,eAAe,EAAE,CAKpD;AAED,wBAAgB,gBAAgB,IAAI,eAAe,EAAE,CAKpD;AAED,wBAAgB,WAAW,IAAI,eAAe,EAAE,CAE/C;AAED,wBAAgB,cAAc,IAAI,eAAe,EAAE,CAElD"}

package/dist/node-slots/roof-accessories.js

@@ -0,0 +1,34 @@
+const ACCESSORY_DEFAULT = 'library:preset-softwhite';
+export const CUPOLA_LOUVERS_DEFAULT = 'library:preset-metal';
+export function boxVentSlots() {
+    return [
+        { slotId: 'base', label: 'Base', default: ACCESSORY_DEFAULT },
+        { slotId: 'top', label: 'Top', default: ACCESSORY_DEFAULT },
+    ];
+}
+export function cupolaSlots() {
+    return [
+        { slotId: 'base', label: 'Base', default: ACCESSORY_DEFAULT },
+        { slotId: 'body', label: 'Body', default: ACCESSORY_DEFAULT },
+        { slotId: 'roof', label: 'Roof', default: ACCESSORY_DEFAULT },
+        { slotId: 'louvers', label: 'Louvers', default: CUPOLA_LOUVERS_DEFAULT },
+    ];
+}
+export function eyebrowVentSlots() {
+    return [
+        { slotId: 'hood', label: 'Hood', default: ACCESSORY_DEFAULT },
+        { slotId: 'front', label: 'Louvers', default: ACCESSORY_DEFAULT },
+    ];
+}
+export function turbineVentSlots() {
+    return [
+        { slotId: 'base', label: 'Base', default: ACCESSORY_DEFAULT },
+        { slotId: 'head', label: 'Head', default: ACCESSORY_DEFAULT },
+    ];
+}
+export function gutterSlots() {
+    return [{ slotId: 'gutter', label: 'Gutter', default: ACCESSORY_DEFAULT }];
+}
+export function downspoutSlots() {
+    return [{ slotId: 'surface', label: 'Surface', default: ACCESSORY_DEFAULT }];
+}

package/dist/node-slots/shelf.d.ts

@@ -0,0 +1,9 @@
+import type { SlotDeclaration } from '../registry/types.js';
+import type { ShelfNode } from '../schema/nodes/shelf.js';
+export type ShelfSlotId = 'shelves' | 'frame' | 'back';
+export declare const SHELF_SLOT_DEFAULT_COLOR = "#ffffff";
+/** Map a builder mesh name to its slot id (null = not a paintable shelf part). */
+export declare function shelfSlotIdForMeshName(name: string): ShelfSlotId | null;
+/** Which slots a given shelf actually exposes (depends on style/flags). */
+export declare function shelfSlots(node: ShelfNode): SlotDeclaration[];
+//# sourceMappingURL=shelf.d.ts.map

package/dist/node-slots/shelf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shelf.d.ts","sourceRoot":"","sources":["../../src/node-slots/shelf.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAEtD,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAA;AAGtD,eAAO,MAAM,wBAAwB,YAAY,CAAA;AAEjD,kFAAkF;AAClF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAavE;AAED,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,eAAe,EAAE,CAS7D"}

package/dist/node-slots/shelf.js

@@ -0,0 +1,30 @@
+// Visual parity with the retired DEFAULT_SHELF_MATERIAL (off-white).
+export const SHELF_SLOT_DEFAULT_COLOR = '#ffffff';
+/** Map a builder mesh name to its slot id (null = not a paintable shelf part). */
+export function shelfSlotIdForMeshName(name) {
+    if (name.startsWith('shelf-board'))
+        return 'shelves';
+    if (name === 'shelf-back')
+        return 'back';
+    if (name.startsWith('shelf-side') ||
+        name.startsWith('shelf-post') ||
+        name.startsWith('shelf-divider') ||
+        name.startsWith('shelf-bracket') ||
+        name.startsWith('shelf-brace')) {
+        return 'frame';
+    }
+    return null;
+}
+/** Which slots a given shelf actually exposes (depends on style/flags). */
+export function shelfSlots(node) {
+    const slots = [
+        { slotId: 'shelves', label: 'Shelves', default: SHELF_SLOT_DEFAULT_COLOR },
+    ];
+    const hasFrame = !(node.style === 'wall-shelf' && node.bracketStyle === 'hidden');
+    if (hasFrame)
+        slots.push({ slotId: 'frame', label: 'Frame', default: SHELF_SLOT_DEFAULT_COLOR });
+    const hasBack = node.style === 'cubby' || (node.style === 'bookshelf' && node.withBack);
+    if (hasBack)
+        slots.push({ slotId: 'back', label: 'Back', default: SHELF_SLOT_DEFAULT_COLOR });
+    return slots;
+}

package/dist/node-slots/slab.d.ts

@@ -0,0 +1,7 @@
+import type { SlotDeclaration } from '../registry/types.js';
+export type SlabSlotId = 'surface' | 'side' | 'edge' | 'riser' | 'underside' | 'foundation';
+export declare const SLAB_TOP_SLOT_DEFAULT = "library:wood-woodplank48";
+export declare const SLAB_SIDE_SLOT_DEFAULT = "#cccccc";
+export declare const FOUNDATION_SLOT_DEFAULT = "library:concrete-raw";
+export declare function slabSlots(): SlotDeclaration[];
+//# sourceMappingURL=slab.d.ts.map

package/dist/node-slots/slab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slab.d.ts","sourceRoot":"","sources":["../../src/node-slots/slab.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,WAAW,GAAG,YAAY,CAAA;AAU3F,eAAO,MAAM,qBAAqB,6BAA6B,CAAA;AAC/D,eAAO,MAAM,sBAAsB,YAAY,CAAA;AAE/C,eAAO,MAAM,uBAAuB,yBAAyB,CAAA;AAE7D,wBAAgB,SAAS,IAAI,eAAe,EAAE,CAS7C"}

package/dist/node-slots/slab.js

@@ -0,0 +1,21 @@
+// Declared default appearances for an unpainted slab in colored mode — a
+// catalog `library:<id>` finish or a `#rrggbb` colour. Textures-off collapses
+// both to the themed floor role (the escape hatch).
+//
+// `surface` (top face) keeps the wood floor default and the slot id used before
+// the top/side split, so existing painted slabs keep their floor finish. `side`
+// (walls + underside) defaults to a light grey so a slab's edges read as a
+// distinct trim rather than wood end-grain.
+export const SLAB_TOP_SLOT_DEFAULT = 'library:wood-woodplank48';
+export const SLAB_SIDE_SLOT_DEFAULT = '#cccccc';
+export const FOUNDATION_SLOT_DEFAULT = 'library:concrete-raw';
+export function slabSlots() {
+    return [
+        { slotId: 'foundation', label: 'Foundation', default: FOUNDATION_SLOT_DEFAULT },
+        { slotId: 'surface', label: 'Top', default: SLAB_TOP_SLOT_DEFAULT },
+        { slotId: 'side', label: 'Sides', default: SLAB_SIDE_SLOT_DEFAULT },
+        { slotId: 'edge', label: 'Floor edge', default: SLAB_SIDE_SLOT_DEFAULT },
+        { slotId: 'riser', label: 'Riser', default: SLAB_SIDE_SLOT_DEFAULT },
+        { slotId: 'underside', label: 'Underside', default: SLAB_SIDE_SLOT_DEFAULT },
+    ];
+}

package/dist/node-slots/stair.d.ts

@@ -0,0 +1,8 @@
+import type { SlotDeclaration } from '../registry/types.js';
+import type { StairNode } from '../schema/nodes/stair.js';
+export type StairSlotId = 'treads' | 'body' | 'railing' | 'infill';
+export declare const STAIR_TREADS_SLOT_DEFAULT = "library:wood-woodplank48";
+export declare const STAIR_BODY_SLOT_DEFAULT = "library:preset-lightgrey";
+export declare const STAIR_RAILING_SLOT_DEFAULT = "library:metal-steel";
+export declare function stairSlots(node: StairNode): SlotDeclaration[];
+//# sourceMappingURL=stair.d.ts.map

package/dist/node-slots/stair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stair.d.ts","sourceRoot":"","sources":["../../src/node-slots/stair.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAEtD,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAA;AAElE,eAAO,MAAM,yBAAyB,6BAA6B,CAAA;AACnE,eAAO,MAAM,uBAAuB,6BAA6B,CAAA;AACjE,eAAO,MAAM,0BAA0B,wBAAwB,CAAA;AAE/D,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,eAAe,EAAE,CAe7D"}

package/dist/node-slots/stair.js

@@ -0,0 +1,17 @@
+export const STAIR_TREADS_SLOT_DEFAULT = 'library:wood-woodplank48';
+export const STAIR_BODY_SLOT_DEFAULT = 'library:preset-lightgrey';
+export const STAIR_RAILING_SLOT_DEFAULT = 'library:metal-steel';
+export function stairSlots(node) {
+    const slots = [
+        { slotId: 'treads', label: 'Treads', default: STAIR_TREADS_SLOT_DEFAULT },
+        { slotId: 'body', label: 'Body', default: STAIR_BODY_SLOT_DEFAULT },
+    ];
+    if (node.railingMode && node.railingMode !== 'none') {
+        slots.push({ slotId: 'railing', label: 'Railing', default: STAIR_RAILING_SLOT_DEFAULT });
+    }
+    if (node.railingMode !== 'none' && node.railingStyle === 'glass')
+        slots.push({ slotId: 'infill', label: 'Glass infill', default: 'library:preset-glass' });
+    if (node.handrail && node.handrail.mode !== 'none' && node.railingMode === 'none')
+        slots.push({ slotId: 'railing', label: 'Handrail', default: STAIR_RAILING_SLOT_DEFAULT });
+    return slots;
+}

package/dist/node-slots/wall.d.ts

@@ -0,0 +1,12 @@
+import type { SlotDeclaration } from '../registry/types.js';
+import { type WallNode } from '../schema/nodes/wall.js';
+/**
+ * A wall exposes two paintable faces — `a` (left of start → end) and `b` —
+ * plus a skirting, crown and chair rail per face. Painting writes
+ * `node.slots[slotId]` via `wallPaint` like every other kind; this declaration
+ * surfaces the slot list + declared defaults for the picker and keeps walls on
+ * the same `{ slotId, label, default }` contract. Paint regions and room
+ * finishes are not slots: they live on `faceRegions` and on the zone.
+ */
+export declare function wallSlots(node?: WallNode): SlotDeclaration[];
+//# sourceMappingURL=wall.d.ts.map

package/dist/node-slots/wall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wall.d.ts","sourceRoot":"","sources":["../../src/node-slots/wall.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD,OAAO,EAA8B,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAEhF;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,eAAe,EAAE,CA4C5D"}

package/dist/node-slots/wall.js

@@ -0,0 +1,55 @@
+import { getCurtainWallConfig } from '../schema/nodes/curtain-wall.js';
+import { WALL_SURFACE_SLOT_DEFAULTS } from '../schema/nodes/wall.js';
+/**
+ * A wall exposes two paintable faces — `a` (left of start → end) and `b` —
+ * plus a skirting, crown and chair rail per face. Painting writes
+ * `node.slots[slotId]` via `wallPaint` like every other kind; this declaration
+ * surfaces the slot list + declared defaults for the picker and keeps walls on
+ * the same `{ slotId, label, default }` contract. Paint regions and room
+ * finishes are not slots: they live on `faceRegions` and on the zone.
+ */
+export function wallSlots(node) {
+    if (node?.wallType === 'curtain') {
+        const config = getCurtainWallConfig(node);
+        return [
+            { slotId: 'curtain-frame', label: 'Frame', default: config.frameColor },
+            { slotId: 'curtain-glass', label: 'Glass', default: config.glassColor },
+            { slotId: 'curtain-solid', label: 'Solid panels', default: config.solidColor },
+        ];
+    }
+    return [
+        { slotId: 'a', label: 'Side A', default: WALL_SURFACE_SLOT_DEFAULTS.a },
+        { slotId: 'b', label: 'Side B', default: WALL_SURFACE_SLOT_DEFAULTS.b },
+        {
+            slotId: 'aSkirting',
+            label: 'Skirting (side A)',
+            default: WALL_SURFACE_SLOT_DEFAULTS.aSkirting,
+        },
+        {
+            slotId: 'bSkirting',
+            label: 'Skirting (side B)',
+            default: WALL_SURFACE_SLOT_DEFAULTS.bSkirting,
+        },
+        { slotId: 'aCrown', label: 'Crown (side A)', default: WALL_SURFACE_SLOT_DEFAULTS.aCrown },
+        { slotId: 'bCrown', label: 'Crown (side B)', default: WALL_SURFACE_SLOT_DEFAULTS.bCrown },
+        {
+            slotId: 'aChairRail',
+            label: 'Chair rail (side A)',
+            default: WALL_SURFACE_SLOT_DEFAULTS.aChairRail,
+        },
+        {
+            slotId: 'bChairRail',
+            label: 'Chair rail (side B)',
+            default: WALL_SURFACE_SLOT_DEFAULTS.bChairRail,
+        },
+        ...(node?.underpinning
+            ? [
+                {
+                    slotId: 'foundation',
+                    label: 'Foundation',
+                    default: WALL_SURFACE_SLOT_DEFAULTS.foundation,
+                },
+            ]
+            : []),
+    ];
+}

package/dist/node-slots/window.d.ts

@@ -0,0 +1,5 @@
+import type { SlotDeclaration } from '../registry/types.js';
+export type WindowSlotId = 'frame' | 'glass';
+/** A window exposes two paintable slots: the joinery frame and the glass. */
+export declare function windowSlots(): SlotDeclaration[];
+//# sourceMappingURL=window.d.ts.map

package/dist/node-slots/window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"window.d.ts","sourceRoot":"","sources":["../../src/node-slots/window.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,OAAO,CAAA;AAO5C,6EAA6E;AAC7E,wBAAgB,WAAW,IAAI,eAAe,EAAE,CAK/C"}

package/dist/node-slots/window.js

@@ -0,0 +1,11 @@
+// Picker swatches. Rendering falls back to the live frame/glass defaults (which
+// already track shading + theme), so these are just the indicator colours.
+const FRAME_DEFAULT = 'library:preset-softwhite';
+const GLASS_DEFAULT = 'library:preset-glass';
+/** A window exposes two paintable slots: the joinery frame and the glass. */
+export function windowSlots() {
+    return [
+        { slotId: 'frame', label: 'Frame', default: FRAME_DEFAULT },
+        { slotId: 'glass', label: 'Glass', default: GLASS_DEFAULT },
+    ];
+}

package/dist/procedural-items/design-placement.d.ts

@@ -0,0 +1,49 @@
+import { type DesignDiagnostic } from './design.js';
+import { ProceduralItemNode } from './node.js';
+import { type QueryNodes } from './query.js';
+import { type Vec3 } from './recipe.js';
+/**
+ * Where and how to create one design instance, in today's hosting fields:
+ * - floor designs: `hostId` is a level, or a slab or zone of it (the level becomes the parent),
+ *   or a design whose named `surfaceId` it rests on; `position` is in that frame, y up;
+ * - wall-side designs: `hostId` is a straight wall, `position` is [along, height, offset] of
+ *   the mounting reference from the wall start on `side`;
+ * - ceiling designs: `hostId` is a ceiling, `position` is the plan [x, 0, z] of the reference.
+ * `rotation` is a yaw in radians (not for wall-side designs, which face away from the wall).
+ */
+export type DesignPlacementRequest = {
+    design: unknown;
+    hostId: string;
+    position: Vec3;
+    rotation?: number;
+    side?: 'front' | 'back';
+    surfaceId?: string;
+    parameters?: Record<string, number>;
+    slots?: Record<string, string>;
+    name?: string;
+    /** A new id; refused with node_exists when the scene already has it. */
+    id?: string;
+};
+export type DesignPlacementRefusal = 'invalid_design' | 'design_too_large' | 'design_version_not_enabled' | 'node_exists' | 'invalid_placement' | 'host_not_found' | 'wrong_host' | 'unknown_surface' | 'does_not_fit';
+/** A typed refusal; the message starts with the code because some clients only show messages. */
+export declare class DesignPlacementError extends Error {
+    readonly code: DesignPlacementRefusal;
+    readonly diagnostics: DesignDiagnostic[];
+    constructor(code: DesignPlacementRefusal, detail: string, diagnostics?: DesignDiagnostic[]);
+}
+export type DesignPlacement = {
+    node: ProceduralItemNode;
+    parentId: string;
+    /** The surface host's attachment map after placement, when the design rests on a design surface. */
+    hostUpdate?: {
+        id: string;
+        attachments: Record<string, string>;
+    };
+};
+/**
+ * Plan a create-only placement of a design: validate it (the same authority as
+ * `validateDesign`), resolve its host from its mounting, build the node and run the
+ * procedural relation checks without the node registry. Throws `DesignPlacementError`.
+ */
+export declare function planDesignPlacement(nodes: QueryNodes, request: DesignPlacementRequest): DesignPlacement;
+//# sourceMappingURL=design-placement.d.ts.map