@pascal-app/nodes 0.1.1

package/dist/cabinet/geometry/shared.js

@@ -0,0 +1,356 @@
+import { getMaterialPresetByRef, } from '@pascal-app/core';
+import { applyMaterialPresetToMaterials, applyWorldScaleBoxUVs, createDefaultMaterial, createMaterial, createSurfaceRoleMaterial, glassMaterial as defaultGlassMaterial, resolveMaterialRef, resolveSlotDefaultMaterial, } from '@pascal-app/viewer';
+import { BoxGeometry, CylinderGeometry, ExtrudeGeometry, FrontSide, Mesh, MeshBasicMaterial, MeshStandardMaterial, Shape, } from 'three';
+import { cabinetSlots } from '../slots';
+const CABINET_SLOT_DEFAULTS = Object.fromEntries(cabinetSlots().map((slot) => [slot.slotId, slot.default]));
+export function createWorldScaleBoxGeometry(width, height, depth) {
+    const geometry = new BoxGeometry(width, height, depth);
+    applyWorldScaleBoxUVs(geometry, width, height, depth);
+    return geometry;
+}
+function getLegacyCabinetMaterial(node, shading) {
+    if (node.materialPreset) {
+        const preset = getMaterialPresetByRef(node.materialPreset);
+        if (preset) {
+            const base = createDefaultMaterial('#ffffff', 0.6, shading);
+            applyMaterialPresetToMaterials(base, preset);
+            return base;
+        }
+    }
+    if (node.material)
+        return createMaterial(node.material, shading);
+    return null;
+}
+function getCabinetSlotMaterial(node, slotId, materials, shading, textures, colorPreset, sceneTheme) {
+    if (!textures) {
+        if (slotId === 'glass')
+            return defaultGlassMaterial;
+        return createSurfaceRoleMaterial('joinery', colorPreset, FrontSide, sceneTheme);
+    }
+    const slotRef = node.slots?.[slotId];
+    if (slotRef) {
+        const resolved = resolveMaterialRef(slotRef, materials, shading);
+        if (resolved)
+            return resolved;
+    }
+    if (slotId === 'front' ||
+        slotId === 'carcass' ||
+        slotId === 'countertop' ||
+        slotId === 'plinth') {
+        const legacy = getLegacyCabinetMaterial(node, shading);
+        if (legacy)
+            return legacy;
+    }
+    return resolveSlotDefaultMaterial(CABINET_SLOT_DEFAULTS[slotId], shading, slotId === 'hardware' || slotId === 'appliance' ? 0.45 : 0.8);
+}
+export function getCabinetSlotMaterials(node, ctx, shading, textures, colorPreset, sceneTheme) {
+    return {
+        front: getCabinetSlotMaterial(node, 'front', ctx?.materials, shading, textures, colorPreset, sceneTheme),
+        carcass: getCabinetSlotMaterial(node, 'carcass', ctx?.materials, shading, textures, colorPreset, sceneTheme),
+        countertop: getCabinetSlotMaterial(node, 'countertop', ctx?.materials, shading, textures, colorPreset, sceneTheme),
+        plinth: getCabinetSlotMaterial(node, 'plinth', ctx?.materials, shading, textures, colorPreset, sceneTheme),
+        hardware: getCabinetSlotMaterial(node, 'hardware', ctx?.materials, shading, textures, colorPreset, sceneTheme),
+        glass: getCabinetSlotMaterial(node, 'glass', ctx?.materials, shading, textures, colorPreset, sceneTheme),
+        appliance: getCabinetSlotMaterial(node, 'appliance', ctx?.materials, shading, textures, colorPreset, sceneTheme),
+        applianceInterior: getCabinetSlotMaterial(node, 'applianceInterior', ctx?.materials, shading, textures, colorPreset, sceneTheme),
+    };
+}
+export function stampSlot(mesh, slotId) {
+    mesh.userData.slotId = slotId;
+    return mesh;
+}
+export function addBox(group, size, position, materialOrColor, name, slotId = 'carcass') {
+    const material = typeof materialOrColor === 'string'
+        ? new MeshStandardMaterial({ color: materialOrColor, metalness: 0.08, roughness: 0.72 })
+        : materialOrColor;
+    const geometry = createWorldScaleBoxGeometry(size[0], size[1], size[2]);
+    const mesh = stampSlot(new Mesh(geometry, material), slotId);
+    mesh.name = name;
+    mesh.position.set(position[0], position[1], position[2]);
+    mesh.castShadow = true;
+    mesh.receiveShadow = true;
+    group.add(mesh);
+    return mesh;
+}
+export const OVEN_OPEN_ANGLE = (88 * Math.PI) / 180;
+export const APPLIANCE_CAVITY_WALL = 0.02;
+export const applianceDisplayMaterial = new MeshStandardMaterial({
+    color: '#120c05',
+    emissive: '#ff9a3d',
+    emissiveIntensity: 0.85,
+    roughness: 0.3,
+});
+export const applianceLampMaterial = new MeshStandardMaterial({
+    color: '#2b2417',
+    emissive: '#ffd9a0',
+    emissiveIntensity: 0.6,
+    roughness: 0.4,
+});
+export const microwaveScreenMaterial = new MeshStandardMaterial({
+    color: '#05070a',
+    emissive: '#111827',
+    emissiveIntensity: 0.2,
+    metalness: 0.05,
+    roughness: 0.32,
+});
+export const microwaveButtonMaterial = new MeshStandardMaterial({
+    color: '#2f3338',
+    metalness: 0.35,
+    roughness: 0.42,
+});
+export const microwaveStartButtonMaterial = new MeshStandardMaterial({
+    color: '#1d6f45',
+    emissive: '#16a34a',
+    emissiveIntensity: 0.08,
+    metalness: 0.2,
+    roughness: 0.38,
+});
+export const microwaveCancelButtonMaterial = new MeshStandardMaterial({
+    color: '#7f1d1d',
+    emissive: '#ef4444',
+    emissiveIntensity: 0.08,
+    metalness: 0.2,
+    roughness: 0.38,
+});
+export const microwavePanelMaterial = new MeshStandardMaterial({
+    color: '#16191d',
+    metalness: 0.55,
+    roughness: 0.36,
+});
+export const cooktopGlassMaterial = new MeshStandardMaterial({
+    color: '#17191c',
+    metalness: 0.45,
+    roughness: 0.07,
+});
+export const cooktopBurnerMaterial = new MeshStandardMaterial({
+    color: '#7d8389',
+    metalness: 0.85,
+    roughness: 0.3,
+});
+export const cooktopTrimMaterial = new MeshStandardMaterial({
+    color: '#3a3d41',
+    metalness: 0.85,
+    roughness: 0.3,
+});
+export const cooktopGrateMaterial = new MeshStandardMaterial({
+    color: '#0d0e10',
+    metalness: 0.55,
+    roughness: 0.5,
+});
+export const cooktopInductionZoneMaterial = new MeshStandardMaterial({
+    color: '#07111f',
+    emissive: '#2563eb',
+    emissiveIntensity: 0.22,
+    metalness: 0.05,
+    roughness: 0.2,
+});
+export const cooktopInductionActiveZoneMaterial = new MeshStandardMaterial({
+    color: '#0b1f3a',
+    emissive: '#38bdf8',
+    emissiveIntensity: 0.75,
+    metalness: 0.05,
+    roughness: 0.18,
+});
+export const cooktopKnobOnMaterial = new MeshStandardMaterial({
+    color: '#ffb86b',
+    emissive: '#f97316',
+    emissiveIntensity: 0.45,
+    metalness: 0.2,
+    roughness: 0.24,
+});
+export const cooktopKnobHitMaterial = new MeshBasicMaterial({
+    colorWrite: false,
+    depthWrite: false,
+    transparent: true,
+    opacity: 0,
+});
+export const refrigeratorSilverMaterial = new MeshStandardMaterial({
+    color: '#c9ccd0',
+    metalness: 0.78,
+    roughness: 0.32,
+});
+export const refrigeratorBrassAccentMaterial = new MeshStandardMaterial({
+    color: '#b3925f',
+    metalness: 0.75,
+    roughness: 0.3,
+});
+export const refrigeratorDarkTrimMaterial = new MeshStandardMaterial({
+    color: '#4d5257',
+    metalness: 0.6,
+    roughness: 0.42,
+});
+export const refrigeratorSealMaterial = new MeshStandardMaterial({
+    color: '#d9dbdd',
+    metalness: 0.02,
+    roughness: 0.6,
+});
+export const refrigeratorLinerMaterial = new MeshStandardMaterial({
+    color: '#f7f8f9',
+    metalness: 0.02,
+    roughness: 0.55,
+});
+export const refrigeratorLinerAccentMaterial = new MeshStandardMaterial({
+    color: '#eef0f2',
+    metalness: 0.02,
+    roughness: 0.48,
+});
+export const refrigeratorDrawerMaterial = new MeshStandardMaterial({
+    color: '#eef4f8',
+    transparent: true,
+    opacity: 0.45,
+    metalness: 0.02,
+    roughness: 0.18,
+});
+export const refrigeratorBinMaterial = new MeshStandardMaterial({
+    color: '#f4f6f8',
+    transparent: true,
+    opacity: 0.62,
+    metalness: 0.02,
+    roughness: 0.24,
+});
+export const refrigeratorLightMaterial = new MeshStandardMaterial({
+    color: '#fff7d6',
+    emissive: '#fff1a8',
+    emissiveIntensity: 0.32,
+    roughness: 0.24,
+});
+export const refrigeratorWaterMaterial = new MeshStandardMaterial({
+    color: '#38bdf8',
+    emissive: '#0ea5e9',
+    emissiveIntensity: 0.18,
+    metalness: 0.05,
+    roughness: 0.22,
+});
+export const ovenDialMaterial = new MeshStandardMaterial({
+    color: '#d5d7d8',
+    metalness: 0.72,
+    roughness: 0.24,
+});
+export const ovenIndicatorMaterial = new MeshStandardMaterial({
+    color: '#f8fafc',
+    emissive: '#f8fafc',
+    emissiveIntensity: 0.12,
+    metalness: 0.1,
+    roughness: 0.32,
+});
+export const ovenHeatElementMaterial = new MeshStandardMaterial({
+    color: '#4a1f16',
+    emissive: '#ff6b35',
+    emissiveIntensity: 0.28,
+    metalness: 0.35,
+    roughness: 0.42,
+});
+export const ovenStatusLightMaterials = ['#f97316', '#22c55e', '#38bdf8'].map((color) => new MeshStandardMaterial({
+    color,
+    emissive: color,
+    emissiveIntensity: 0.42,
+    roughness: 0.28,
+}));
+// These module-level materials are shared by every cabinet instance in the
+// scene. Without the cached flag, the geometry system's disposeChildren would
+// dispose them on each rebuild, breaking every other cabinet still using them
+// and forcing scene-wide shader recompiles.
+for (const material of [
+    applianceDisplayMaterial,
+    applianceLampMaterial,
+    microwaveScreenMaterial,
+    microwaveButtonMaterial,
+    microwaveStartButtonMaterial,
+    microwaveCancelButtonMaterial,
+    microwavePanelMaterial,
+    cooktopGlassMaterial,
+    cooktopBurnerMaterial,
+    cooktopTrimMaterial,
+    cooktopGrateMaterial,
+    cooktopInductionZoneMaterial,
+    cooktopInductionActiveZoneMaterial,
+    cooktopKnobOnMaterial,
+    cooktopKnobHitMaterial,
+    refrigeratorSilverMaterial,
+    refrigeratorBrassAccentMaterial,
+    refrigeratorDarkTrimMaterial,
+    refrigeratorSealMaterial,
+    refrigeratorLinerMaterial,
+    refrigeratorLinerAccentMaterial,
+    refrigeratorDrawerMaterial,
+    refrigeratorBinMaterial,
+    refrigeratorLightMaterial,
+    refrigeratorWaterMaterial,
+    ovenDialMaterial,
+    ovenIndicatorMaterial,
+    ovenHeatElementMaterial,
+    ...ovenStatusLightMaterials,
+]) {
+    material.userData.__pascalCachedMaterial = true;
+}
+export function addApplianceHandle(group, material, position, length, vertical, name) {
+    const tube = stampSlot(new Mesh(new CylinderGeometry(0.009, 0.009, length, 16), material), 'appliance');
+    tube.name = name;
+    tube.position.set(position[0], position[1], position[2] + 0.042);
+    if (!vertical)
+        tube.rotation.z = Math.PI / 2;
+    tube.castShadow = true;
+    group.add(tube);
+    const standoffDistance = length * 0.38;
+    for (const offset of [-standoffDistance, standoffDistance]) {
+        const standoff = stampSlot(new Mesh(new CylinderGeometry(0.006, 0.006, 0.04, 10), material), 'appliance');
+        standoff.name = `${name}-standoff`;
+        standoff.position.set(position[0] + (vertical ? 0 : offset), position[1] + (vertical ? offset : 0), position[2] + 0.02);
+        standoff.rotation.x = Math.PI / 2;
+        standoff.castShadow = true;
+        group.add(standoff);
+    }
+}
+export function roundedButtonGeometry(width, height, depth, radius) {
+    const shape = new Shape();
+    const halfWidth = width / 2;
+    const halfHeight = height / 2;
+    const r = Math.min(radius, halfWidth, halfHeight);
+    shape.moveTo(-halfWidth + r, -halfHeight);
+    shape.lineTo(halfWidth - r, -halfHeight);
+    shape.quadraticCurveTo(halfWidth, -halfHeight, halfWidth, -halfHeight + r);
+    shape.lineTo(halfWidth, halfHeight - r);
+    shape.quadraticCurveTo(halfWidth, halfHeight, halfWidth - r, halfHeight);
+    shape.lineTo(-halfWidth + r, halfHeight);
+    shape.quadraticCurveTo(-halfWidth, halfHeight, -halfWidth, halfHeight - r);
+    shape.lineTo(-halfWidth, -halfHeight + r);
+    shape.quadraticCurveTo(-halfWidth, -halfHeight, -halfWidth + r, -halfHeight);
+    const geometry = new ExtrudeGeometry(shape, {
+        depth,
+        bevelEnabled: true,
+        bevelThickness: Math.min(0.0015, depth * 0.3),
+        bevelSize: Math.min(0.0015, r * 0.35),
+        bevelSegments: 2,
+        curveSegments: 8,
+        steps: 1,
+    });
+    geometry.translate(0, 0, -depth / 2);
+    geometry.computeVertexNormals();
+    return geometry;
+}
+export function addMicrowaveDisplaySegments(group, x, y, z, width, name) {
+    const segmentWidth = width * 0.16;
+    const segmentHeight = 0.004;
+    for (let i = 0; i < 3; i += 1) {
+        const segment = stampSlot(new Mesh(new BoxGeometry(segmentWidth, segmentHeight, 0.002), applianceDisplayMaterial), 'appliance');
+        segment.name = `${name}-display-segment-${i}`;
+        segment.position.set(x - width * 0.22 + i * width * 0.22, y, z + 0.006);
+        group.add(segment);
+    }
+}
+export function addWireRack(group, materials, width, depth, y, zCenter, name) {
+    const bar = 0.006;
+    const frame = [
+        { size: [width, bar, bar], position: [0, y, zCenter + depth / 2 - bar / 2] },
+        { size: [width, bar, bar], position: [0, y, zCenter - depth / 2 + bar / 2] },
+        { size: [bar, bar, depth], position: [-width / 2 + bar / 2, y, zCenter] },
+        { size: [bar, bar, depth], position: [width / 2 - bar / 2, y, zCenter] },
+    ];
+    frame.forEach((piece, i) => {
+        addBox(group, piece.size, piece.position, materials.applianceInterior, `${name}-frame-${i}`, 'applianceInterior');
+    });
+    for (let i = 1; i <= 7; i++) {
+        const x = -width / 2 + (width * i) / 8;
+        addBox(group, [0.004, 0.004, Math.max(0.01, depth - bar * 2)], [x, y, zCenter], materials.applianceInterior, `${name}-bar-${i}`, 'applianceInterior');
+    }
+}

package/dist/cabinet/geometry/sink.d.ts

@@ -0,0 +1,29 @@
+import { Group, type Material, Mesh } from 'three';
+import type { SinkLayout } from '../stack';
+export declare const FAUCET_SETBACK = 0.03;
+export type SinkBowlSpec = {
+    centerX: number;
+    width: number;
+    depth: number;
+};
+/**
+ * Bowl rects in module-local X/Z given the usable countertop footprint.
+ * Shared by the 3D cut, the run-countertop cut, and the 2D floorplan symbol.
+ */
+export declare function sinkBowls(layout: SinkLayout, usableWidth: number, usableDepth: number): SinkBowlSpec[];
+/**
+ * Subtract the sink bowl openings from a countertop mesh via three-bvh-csg.
+ * `cutCenterX/Z` position the sink footprint in the countertop mesh's local
+ * frame (the run countertop spans several modules, so the sink is off-center
+ * there). Returns a replacement mesh; the caller swaps it into the group.
+ */
+export declare function cutSinkIntoCountertop(countertop: Mesh, bowls: SinkBowlSpec[], cutCenterX: number, cutCenterZ: number, countertopThickness: number): Mesh;
+/**
+ * Undermount sink: basin shells + faucet, positioned under a countertop
+ * opening the caller has already cut via {@link cutSinkIntoCountertop}.
+ * `rimY` is the underside of the countertop (= carcass top);
+ * `countertopThickness` is the effective slab thickness above the rim (the
+ * parent run's when the module doesn't own its countertop).
+ */
+export declare function addSinkCompartment(group: Group, bowls: SinkBowlSpec[], centerX: number, centerZ: number, rimY: number, countertopThickness: number, index: number, applianceMaterial: Material): void;
+//# sourceMappingURL=sink.d.ts.map

package/dist/cabinet/geometry/sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sink.d.ts","sourceRoot":"","sources":["../../../src/cabinet/geometry/sink.ts"],"names":[],"mappings":"AAOA,OAAO,EAGL,KAAK,EACL,KAAK,QAAQ,EACb,IAAI,EAGL,MAAM,OAAO,CAAA;AACd,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAQ1C,eAAO,MAAM,cAAc,OAAO,CAAA;AAElC,MAAM,MAAM,YAAY,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAE5E;;;GAGG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,YAAY,EAAE,CAuBhB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,IAAI,EAChB,KAAK,EAAE,YAAY,EAAE,EACrB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,mBAAmB,EAAE,MAAM,GAC1B,IAAI,CA8BN;AAkUD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,YAAY,EAAE,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,mBAAmB,EAAE,MAAM,EAC3B,KAAK,EAAE,MAAM,EACb,iBAAiB,EAAE,QAAQ,QAY5B"}

package/dist/cabinet/geometry/sink.js

@@ -0,0 +1,262 @@
+import { Brush, csgEvaluator, csgGeometry, prepareBrushForCSG, SUBTRACTION, } from '@pascal-app/viewer';
+import { BoxGeometry, CylinderGeometry, Group, Mesh, SphereGeometry, TorusGeometry, } from 'three';
+import { createWorldScaleBoxGeometry, stampSlot } from './shared';
+const BASIN_WALL = 0.012;
+const BASIN_DEPTH = 0.19;
+const BASIN_CORNER_MARGIN = 0.06;
+// Centers the faucet base in the strip between the bowl's back edge and the
+// countertop's back edge (BASIN_CORNER_MARGIN wide).
+export const FAUCET_SETBACK = 0.03;
+/**
+ * Bowl rects in module-local X/Z given the usable countertop footprint.
+ * Shared by the 3D cut, the run-countertop cut, and the 2D floorplan symbol.
+ */
+export function sinkBowls(layout, usableWidth, usableDepth) {
+    const depth = Math.max(0.1, usableDepth - BASIN_CORNER_MARGIN * 2);
+    const full = Math.max(0.15, usableWidth - BASIN_CORNER_MARGIN * 2);
+    if (layout === 'single') {
+        const width = Math.min(0.7, full);
+        return [{ centerX: 0, width, depth }];
+    }
+    const divider = 0.03;
+    if (layout === 'double') {
+        const width = Math.min(0.42, (full - divider) / 2);
+        return [
+            { centerX: -(width + divider) / 2, width, depth },
+            { centerX: (width + divider) / 2, width, depth },
+        ];
+    }
+    // double-offset: 60/40 split
+    const total = Math.min(0.86, full);
+    const main = (total - divider) * 0.6;
+    const side = (total - divider) * 0.4;
+    return [
+        { centerX: -(total / 2) + main / 2, width: main, depth },
+        { centerX: total / 2 - side / 2, width: side, depth },
+    ];
+}
+/**
+ * Subtract the sink bowl openings from a countertop mesh via three-bvh-csg.
+ * `cutCenterX/Z` position the sink footprint in the countertop mesh's local
+ * frame (the run countertop spans several modules, so the sink is off-center
+ * there). Returns a replacement mesh; the caller swaps it into the group.
+ */
+export function cutSinkIntoCountertop(countertop, bowls, cutCenterX, cutCenterZ, countertopThickness) {
+    const slotId = countertop.userData.slotId;
+    let result = new Brush(countertop.geometry, countertop.material);
+    result.position.copy(countertop.position);
+    prepareBrushForCSG(result);
+    for (const bowl of bowls) {
+        // Rim reveal: the opening is slightly smaller than the basin shell so
+        // the undermount lip tucks under the countertop.
+        const cutter = new Brush(new BoxGeometry(bowl.width - BASIN_WALL, countertopThickness * 4, bowl.depth - BASIN_WALL));
+        cutter.position.set(cutCenterX + bowl.centerX, countertop.position.y, cutCenterZ);
+        prepareBrushForCSG(cutter);
+        const next = csgEvaluator.evaluate(result, cutter, SUBTRACTION);
+        prepareBrushForCSG(next);
+        cutter.geometry.dispose();
+        if (result.geometry !== countertop.geometry)
+            result.geometry.dispose();
+        result = next;
+    }
+    const mesh = new Mesh(csgGeometry(result), countertop.material);
+    mesh.userData.slotId = slotId;
+    mesh.name = countertop.name;
+    // Brush geometry is baked in brush-local space with the brush transform
+    // applied at evaluate time — position stays at the original mesh position.
+    mesh.position.copy(countertop.position);
+    mesh.castShadow = true;
+    mesh.receiveShadow = true;
+    return mesh;
+}
+function addBasinShell(group, bowl, centerX, centerZ, rimY, name, applianceMaterial) {
+    const x = centerX + bowl.centerX;
+    const bottomY = rimY - BASIN_DEPTH;
+    const innerWidth = bowl.width - BASIN_WALL * 2;
+    const innerDepth = bowl.depth - BASIN_WALL * 2;
+    const walls = [
+        {
+            size: [bowl.width, BASIN_WALL, bowl.depth],
+            position: [x, bottomY + BASIN_WALL / 2, centerZ],
+            suffix: 'bottom',
+        },
+        {
+            size: [BASIN_WALL, BASIN_DEPTH, bowl.depth],
+            position: [x - bowl.width / 2 + BASIN_WALL / 2, rimY - BASIN_DEPTH / 2, centerZ],
+            suffix: 'left',
+        },
+        {
+            size: [BASIN_WALL, BASIN_DEPTH, bowl.depth],
+            position: [x + bowl.width / 2 - BASIN_WALL / 2, rimY - BASIN_DEPTH / 2, centerZ],
+            suffix: 'right',
+        },
+        {
+            size: [innerWidth, BASIN_DEPTH, BASIN_WALL],
+            position: [x, rimY - BASIN_DEPTH / 2, centerZ - bowl.depth / 2 + BASIN_WALL / 2],
+            suffix: 'back',
+        },
+        {
+            size: [innerWidth, BASIN_DEPTH, BASIN_WALL],
+            position: [x, rimY - BASIN_DEPTH / 2, centerZ + bowl.depth / 2 - BASIN_WALL / 2],
+            suffix: 'front',
+        },
+    ];
+    for (const wall of walls) {
+        const mesh = stampSlot(new Mesh(createWorldScaleBoxGeometry(...wall.size), applianceMaterial), 'appliance');
+        mesh.name = `${name}-basin-${wall.suffix}`;
+        mesh.position.set(...wall.position);
+        mesh.castShadow = true;
+        mesh.receiveShadow = true;
+        group.add(mesh);
+    }
+    const drain = stampSlot(new Mesh(new CylinderGeometry(0.024, 0.024, 0.004, 24), applianceMaterial), 'appliance');
+    drain.name = `${name}-drain`;
+    drain.position.set(x, bottomY + BASIN_WALL + 0.002, centerZ);
+    group.add(drain);
+    const trap = stampSlot(new Mesh(new CylinderGeometry(0.02, 0.02, Math.max(0.05, BASIN_DEPTH * 0.7), 16), applianceMaterial), 'appliance');
+    trap.name = `${name}-drain-pipe`;
+    trap.position.set(x, bottomY - Math.max(0.05, BASIN_DEPTH * 0.7) / 2, centerZ);
+    group.add(trap);
+}
+// Proportions from Kohler Simplice / Moen Align / Delta Essa spec sheets:
+// Ø52mm body ~95mm tall, straight riser to ~305mm, ~105mm-radius arc peaking
+// near 400mm, spray-head outlet ~240mm above deck, ~210mm reach. Handle is a
+// Grohe Minta-style horizontal pin lever off the side of the body.
+const FAUCET_BODY_RADIUS = 0.026;
+const FAUCET_BODY_HEIGHT = 0.095;
+const FAUCET_TUBE_RADIUS = 0.0125;
+const FAUCET_ARC_RADIUS = 0.105;
+const FAUCET_RISER_TOP = 0.305;
+function addFaucetHandle(group, x, y, z, name, applianceMaterial) {
+    const handle = new Group();
+    handle.name = `${name}-faucet-handle`;
+    handle.position.set(x, y, z);
+    const barrelRadius = 0.021;
+    const barrelLength = 0.064;
+    const rootInset = 0.022;
+    const saddle = stampSlot(new Mesh(new SphereGeometry(barrelRadius * 1.08, 24, 14), applianceMaterial), 'appliance');
+    saddle.name = `${name}-faucet-handle-saddle`;
+    saddle.scale.set(0.62, 1.05, 1.05);
+    saddle.position.set(-0.003, 0, 0);
+    saddle.castShadow = true;
+    handle.add(saddle);
+    const barrel = stampSlot(new Mesh(new CylinderGeometry(barrelRadius, barrelRadius, barrelLength + rootInset, 28), applianceMaterial), 'appliance');
+    barrel.name = `${name}-faucet-handle-barrel`;
+    barrel.rotation.z = Math.PI / 2;
+    barrel.position.set((barrelLength - rootInset) / 2, 0, 0);
+    barrel.castShadow = true;
+    handle.add(barrel);
+    const endCapThickness = 0.007;
+    const endCap = stampSlot(new Mesh(new CylinderGeometry(barrelRadius * 1.03, barrelRadius * 1.03, endCapThickness, 28), applianceMaterial), 'appliance');
+    endCap.name = `${name}-faucet-handle-cap`;
+    endCap.rotation.z = Math.PI / 2;
+    endCap.position.set(barrelLength + endCapThickness * 0.35, 0, 0);
+    endCap.castShadow = true;
+    handle.add(endCap);
+    const pinRadius = 0.0042;
+    const pinHeight = 0.072;
+    const pinX = barrelLength - 0.012;
+    const pin = stampSlot(new Mesh(new CylinderGeometry(pinRadius, pinRadius, pinHeight, 14), applianceMaterial), 'appliance');
+    pin.name = `${name}-faucet-handle-pin`;
+    pin.position.set(pinX, barrelRadius + pinHeight / 2 - 0.001, 0);
+    pin.castShadow = true;
+    handle.add(pin);
+    const pinCapHeight = 0.003;
+    const pinCap = stampSlot(new Mesh(new CylinderGeometry(pinRadius, pinRadius, pinCapHeight, 14), applianceMaterial), 'appliance');
+    pinCap.name = `${name}-faucet-handle-pin-tip`;
+    pinCap.position.set(pinX, barrelRadius + pinHeight + pinCapHeight / 2 - 0.001, 0);
+    pinCap.castShadow = true;
+    handle.add(pinCap);
+    group.add(handle);
+}
+function addFaucet(group, x, z, rimY, name, applianceMaterial) {
+    const bodyTopY = rimY + FAUCET_BODY_HEIGHT;
+    const riserTopY = rimY + FAUCET_RISER_TOP;
+    const reach = FAUCET_ARC_RADIUS * 2;
+    // Round base flare where the body meets the countertop.
+    const flare = stampSlot(new Mesh(new CylinderGeometry(FAUCET_BODY_RADIUS + 0.002, 0.032, 0.008, 28), applianceMaterial), 'appliance');
+    flare.name = `${name}-faucet-escutcheon`;
+    flare.position.set(x, rimY + 0.004, z);
+    flare.castShadow = true;
+    group.add(flare);
+    // Mixer body: straight Ø52mm column; riser, spout, and handle grow from it.
+    const body = stampSlot(new Mesh(new CylinderGeometry(FAUCET_BODY_RADIUS, FAUCET_BODY_RADIUS, FAUCET_BODY_HEIGHT, 28), applianceMaterial), 'appliance');
+    body.name = `${name}-faucet-base`;
+    body.position.set(x, rimY + FAUCET_BODY_HEIGHT / 2, z);
+    body.castShadow = true;
+    group.add(body);
+    // Domed shoulder capping the body.
+    const shoulder = stampSlot(new Mesh(new SphereGeometry(FAUCET_BODY_RADIUS, 24, 16), applianceMaterial), 'appliance');
+    shoulder.name = `${name}-faucet-shoulder`;
+    shoulder.scale.y = 0.5;
+    shoulder.position.set(x, bodyTopY, z);
+    shoulder.castShadow = true;
+    group.add(shoulder);
+    // Taper collar easing the Ø52 body into the Ø25 spout tube.
+    const collarHeight = 0.022;
+    const collar = stampSlot(new Mesh(new CylinderGeometry(FAUCET_TUBE_RADIUS, FAUCET_BODY_RADIUS * 0.62, collarHeight, 20), applianceMaterial), 'appliance');
+    collar.name = `${name}-faucet-collar`;
+    collar.position.set(x, bodyTopY + collarHeight / 2, z);
+    collar.castShadow = true;
+    group.add(collar);
+    // Straight riser from the collar up to where the arc begins (~55% of height).
+    const riserLength = riserTopY - (bodyTopY + collarHeight) + 0.002;
+    const riser = stampSlot(new Mesh(new CylinderGeometry(FAUCET_TUBE_RADIUS, FAUCET_TUBE_RADIUS, riserLength, 18), applianceMaterial), 'appliance');
+    riser.name = `${name}-faucet-riser`;
+    riser.position.set(x, bodyTopY + collarHeight + riserLength / 2 - 0.001, z);
+    riser.castShadow = true;
+    group.add(riser);
+    // Gooseneck: half-torus from the riser top over the apex (~400mm above
+    // deck) and back down toward the bowl (+Z).
+    const gooseneck = stampSlot(new Mesh(new TorusGeometry(FAUCET_ARC_RADIUS, FAUCET_TUBE_RADIUS, 14, 32, Math.PI), applianceMaterial), 'appliance');
+    gooseneck.name = `${name}-faucet-gooseneck`;
+    gooseneck.rotation.y = Math.PI / 2;
+    gooseneck.position.set(x, riserTopY, z + FAUCET_ARC_RADIUS);
+    gooseneck.castShadow = true;
+    group.add(gooseneck);
+    // Down-leg: short tube, dark dock seam, then the conical pull-down spray
+    // head. Outlet lands ~240mm above the deck per spec.
+    const spoutZ = z + reach;
+    const downTubeLength = 0.02;
+    const downTube = stampSlot(new Mesh(new CylinderGeometry(FAUCET_TUBE_RADIUS, FAUCET_TUBE_RADIUS, downTubeLength, 18), applianceMaterial), 'appliance');
+    downTube.name = `${name}-faucet-spout`;
+    downTube.position.set(x, riserTopY - downTubeLength / 2, spoutZ);
+    downTube.castShadow = true;
+    group.add(downTube);
+    const seamHeight = 0.005;
+    const seam = stampSlot(new Mesh(new CylinderGeometry(FAUCET_TUBE_RADIUS + 0.0008, FAUCET_TUBE_RADIUS + 0.0008, seamHeight, 18), applianceMaterial), 'appliance');
+    seam.name = `${name}-faucet-spray-seam`;
+    seam.position.set(x, riserTopY - downTubeLength - seamHeight / 2, spoutZ);
+    group.add(seam);
+    const headLength = 0.032;
+    const headTopY = riserTopY - downTubeLength - seamHeight;
+    const sprayHead = stampSlot(new Mesh(new CylinderGeometry(FAUCET_TUBE_RADIUS + 0.0005, 0.019, headLength, 20), applianceMaterial), 'appliance');
+    sprayHead.name = `${name}-faucet-spray-head`;
+    sprayHead.position.set(x, headTopY - headLength / 2, spoutZ);
+    sprayHead.castShadow = true;
+    group.add(sprayHead);
+    const faceHeight = 0.008;
+    const sprayFace = stampSlot(new Mesh(new CylinderGeometry(0.019, 0.018, faceHeight, 20), applianceMaterial), 'appliance');
+    sprayFace.name = `${name}-faucet-aerator`;
+    sprayFace.position.set(x, headTopY - headLength - faceHeight / 2, spoutZ);
+    group.add(sprayFace);
+    addFaucetHandle(group, x + FAUCET_BODY_RADIUS - 0.016, rimY + FAUCET_BODY_HEIGHT * 0.76, z, name, applianceMaterial);
+}
+/**
+ * Undermount sink: basin shells + faucet, positioned under a countertop
+ * opening the caller has already cut via {@link cutSinkIntoCountertop}.
+ * `rimY` is the underside of the countertop (= carcass top);
+ * `countertopThickness` is the effective slab thickness above the rim (the
+ * parent run's when the module doesn't own its countertop).
+ */
+export function addSinkCompartment(group, bowls, centerX, centerZ, rimY, countertopThickness, index, applianceMaterial) {
+    const name = `cabinet-sink-${index}`;
+    for (const [bowlIndex, bowl] of bowls.entries()) {
+        addBasinShell(group, bowl, centerX, centerZ, rimY, `${name}-${bowlIndex}`, applianceMaterial);
+    }
+    const bowlsMinX = Math.min(...bowls.map((bowl) => bowl.centerX - bowl.width / 2));
+    const bowlsMaxX = Math.max(...bowls.map((bowl) => bowl.centerX + bowl.width / 2));
+    const faucetX = centerX + (bowlsMinX + bowlsMaxX) / 2;
+    const faucetZ = centerZ - bowls[0].depth / 2 - FAUCET_SETBACK;
+    addFaucet(group, faucetX, faucetZ, rimY + countertopThickness, name, applianceMaterial);
+}

package/dist/cabinet/geometry.d.ts

@@ -0,0 +1,6 @@
+import type { GeometryContext } from '@pascal-app/core';
+import type { ColorPreset, RenderShading } from '@pascal-app/viewer';
+import { Group } from 'three';
+import { type CabinetGeometryNode } from './geometry/shared';
+export declare function buildCabinetGeometry(node: CabinetGeometryNode, ctx?: GeometryContext, shading?: RenderShading, textures?: boolean, colorPreset?: ColorPreset, sceneTheme?: string): Group;
+//# sourceMappingURL=geometry.d.ts.map

package/dist/cabinet/geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../src/cabinet/geometry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACpE,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAA;AAc7B,OAAO,EAAU,KAAK,mBAAmB,EAA2B,MAAM,mBAAmB,CAAA;AAkB7F,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,mBAAmB,EACzB,GAAG,CAAC,EAAE,eAAe,EACrB,OAAO,GAAE,aAA0B,EACnC,QAAQ,UAAO,EACf,WAAW,GAAE,WAAoB,EACjC,UAAU,CAAC,EAAE,MAAM,GAClB,KAAK,CAwdP"}