@pascal-app/nodes 1.0.3 → 1.0.5

package/dist/site/terrain-holes.js

@@ -0,0 +1,74 @@
+import { difference, union } from '@pascal-app/core';
+import { BufferAttribute, BufferGeometry, DynamicDrawUsage, ShapeUtils, Vector2 } from 'three';
+// Keep the regular grid's vertex layout for partial brush uploads. Only triangles
+// crossing an excavation rim need additional vertices, interpolated on that grid.
+export function cutTerrainHoles(buffers, holes) {
+    if (!holes.length)
+        return null;
+    const cutouts = union(holes);
+    const bounds = cutouts.map(({ outer }) => ({
+        minX: Math.min(...outer.map(([x]) => x)),
+        maxX: Math.max(...outer.map(([x]) => x)),
+        minZ: Math.min(...outer.map(([, z]) => z)),
+        maxZ: Math.max(...outer.map(([, z]) => z)),
+    }));
+    const kept = [], indices = [], samples = [];
+    for (let i = 0; i < buffers.indices.length; i += 3) {
+        const source = Array.from(buffers.indices.subarray(i, i + 3));
+        const triangle = source.map((id) => [
+            buffers.positions[id * 3],
+            buffers.positions[id * 3 + 2],
+        ]);
+        const xs = triangle.map(([x]) => x), zs = triangle.map(([, z]) => z);
+        if (!bounds.some((box) => box.maxX > Math.min(...xs) &&
+            box.minX < Math.max(...xs) &&
+            box.maxZ > Math.min(...zs) &&
+            box.minZ < Math.max(...zs))) {
+            kept.push(...source);
+            continue;
+        }
+        const [a, b, c] = triangle;
+        const determinant = (b[1] - c[1]) * (a[0] - c[0]) + (c[0] - b[0]) * (a[1] - c[1]);
+        for (const polygon of difference(triangle, cutouts)) {
+            const contour = polygon.outer.map(([x, z]) => new Vector2(x, z));
+            const voids = polygon.holes.map((ring) => ring.map(([x, z]) => new Vector2(x, z)));
+            const offset = samples.length;
+            for (const { x, y: z } of [contour, ...voids].flat()) {
+                const wa = ((b[1] - c[1]) * (x - c[0]) + (c[0] - b[0]) * (z - c[1])) / determinant;
+                const wb = ((c[1] - a[1]) * (x - c[0]) + (a[0] - c[0]) * (z - c[1])) / determinant;
+                samples.push({ indices: source, weights: [wa, wb, 1 - wa - wb] });
+            }
+            for (const [a, b, c] of ShapeUtils.triangulateShape(contour, voids))
+                indices.push(offset + c, offset + b, offset + a);
+        }
+    }
+    buffers.indices = new Uint32Array(kept);
+    const geometry = new BufferGeometry();
+    for (const name of ['position', 'normal'])
+        geometry.setAttribute(name, new BufferAttribute(new Float32Array(samples.length * 3), 3).setUsage(DynamicDrawUsage));
+    const uv = new Float32Array(samples.length * 2);
+    for (let i = 0; i < samples.length; i++)
+        for (let axis = 0; axis < 2; axis++)
+            uv[i * 2 + axis] = samples[i].indices.reduce((sum, id, j) => sum + buffers.uvs[id * 2 + axis] * samples[i].weights[j], 0);
+    geometry.setAttribute('uv', new BufferAttribute(uv, 2));
+    geometry.setIndex(indices);
+    const boundary = { geometry, samples };
+    updateTerrainHoleBoundary(boundary, buffers);
+    return boundary;
+}
+export function updateTerrainHoleBoundary(boundary, buffers) {
+    for (const [name, source] of [
+        ['position', buffers.positions],
+        ['normal', buffers.normals],
+    ]) {
+        const attribute = boundary.geometry.getAttribute(name);
+        for (let i = 0; i < boundary.samples.length; i++) {
+            const sample = boundary.samples[i];
+            for (let axis = 0; axis < 3; axis++)
+                attribute.array[i * 3 + axis] = sample.indices.reduce((sum, id, j) => sum + source[id * 3 + axis] * sample.weights[j], 0);
+        }
+        attribute.needsUpdate = true;
+    }
+    boundary.geometry.normalizeNormals();
+    boundary.geometry.computeBoundingSphere();
+}

package/dist/site/terrain-mesh.d.ts

@@ -1,6 +1,7 @@
-import type { HeightPatch, TerrainField } from '@pascal-app/core';
+import type { HeightPatch, Ring, TerrainField } from '@pascal-app/core';
 import { BufferGeometry } from 'three';
-import { type TerrainMeshBuffers, type TerrainSkirtBuffers } from './terrain-geometry';
+import { type TerrainMeshBuffers, type TerrainSkirtBuffers } from './terrain-geometry.js';
+import { type TerrainHoleBoundary } from './terrain-holes.js';
 /**
  * The Three.js side of the terrain heightfield: owns the `BufferGeometry` and the
  * dirty-rect upload.
@@ -20,6 +21,7 @@ import { type TerrainMeshBuffers, type TerrainSkirtBuffers } from './terrain-geo
 /** A terrain geometry plus the CPU buffers backing it. */
 export type TerrainGeometry = {
     readonly geometry: BufferGeometry;
+    readonly holeBoundary: TerrainHoleBoundary | null;
     readonly buffers: TerrainMeshBuffers;
     /** Expands during live edits; a committed-field rebuild tightens it again. */
     readonly heightBounds: {
@@ -32,7 +34,12 @@ export type TerrainGeometry = {
         readonly buffers: TerrainSkirtBuffers;
     };
 };
-export declare function createTerrainGeometry(field: TerrainField): TerrainGeometry;
+/**
+ * `ring` (from `skirtRing`) runs the skirt along the lot's property line instead
+ * of the field's rectangle: the surface is cut to the lot by its material (see
+ * `lotMaskedMaterial`), and the skirt closes it as a block with a flat base.
+ */
+export declare function createTerrainGeometry(field: TerrainField, holes?: Ring[], ring?: Float32Array | null): TerrainGeometry;
 /**
  * Push one patch to the GPU, touching only the affected rows.
  *

package/dist/site/terrain-mesh.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"terrain-mesh.d.ts","sourceRoot":"","sources":["../../src/site/terrain-mesh.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACjE,OAAO,EAAmB,cAAc,EAA4B,MAAM,OAAO,CAAA;AACjF,OAAO,EAKL,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EAGzB,MAAM,oBAAoB,CAAA;AAE3B;;;;;;;;;;;;;;;GAeG;AAEH,0DAA0D;AAC1D,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAA;IACjC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAA;IACpC,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACrD,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAA;KAAE,CAAA;CAC7F,CAAA;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,YAAY,GAAG,eAAe,CAsC1E;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,WAAW,GACjB,IAAI,CA6CN;AAuED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAElF;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAGpE"}
+{"version":3,"file":"terrain-mesh.d.ts","sourceRoot":"","sources":["../../src/site/terrain-mesh.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACvE,OAAO,EAAmB,cAAc,EAA4B,MAAM,OAAO,CAAA;AACjF,OAAO,EAML,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EAGzB,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,iBAAiB,CAAA;AAExB;;;;;;;;;;;;;;;GAeG;AAEH,0DAA0D;AAC1D,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAA;IACjC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,GAAG,IAAI,CAAA;IACjD,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAA;IACpC,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACrD,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAA;KAAE,CAAA;CAC7F,CAAA;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,YAAY,EACnB,KAAK,GAAE,IAAI,EAAO,EAClB,IAAI,GAAE,YAAY,GAAG,IAAW,GAC/B,eAAe,CAyCjB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,WAAW,GACjB,IAAI,CA+CN;AAoFD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAElF;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAIpE"}

package/dist/site/terrain-mesh.js

@@ -1,7 +1,14 @@
 import { BufferAttribute, BufferGeometry, DynamicDrawUsage, Sphere } from 'three';
-import { buildTerrainMesh, buildTerrainSkirt, HORIZON_PLANE_Y, patchUpdateRange, updateTerrainMesh, updateTerrainSkirt, } from './terrain-geometry';
-export function createTerrainGeometry(field) {
+import { buildTerrainMesh, buildTerrainSkirt, HORIZON_PLANE_Y, patchUpdateRange, SKIRT_DROP, updateTerrainMesh, updateTerrainSkirt, } from './terrain-geometry.js';
+import { cutTerrainHoles, updateTerrainHoleBoundary, } from './terrain-holes.js';
+/**
+ * `ring` (from `skirtRing`) runs the skirt along the lot's property line instead
+ * of the field's rectangle: the surface is cut to the lot by its material (see
+ * `lotMaskedMaterial`), and the skirt closes it as a block with a flat base.
+ */
+export function createTerrainGeometry(field, holes = [], ring = null) {
     const buffers = buildTerrainMesh(field);
+    const holeBoundary = cutTerrainHoles(buffers, holes);
     const geometry = new BufferGeometry();
     geometry.setAttribute('position', new BufferAttribute(buffers.positions, 3).setUsage(DynamicDrawUsage));
     geometry.setAttribute('normal', new BufferAttribute(buffers.normals, 3).setUsage(DynamicDrawUsage));
@@ -12,14 +19,17 @@ export function createTerrainGeometry(field) {
     // A separate geometry, not extra vertices on the surface: the surface's dirty
     // range is a row span over a `cols * rows` layout, and appending a perimeter ring
     // to it would break that indexing for a saving of one draw call.
-    const skirtBuffers = buildTerrainSkirt(field);
+    const skirtBuffers = buildTerrainSkirt(field, ring);
     const skirtGeometry = new BufferGeometry();
     skirtGeometry.setAttribute('position', new BufferAttribute(skirtBuffers.positions, 3).setUsage(DynamicDrawUsage));
     skirtGeometry.setAttribute('normal', new BufferAttribute(skirtBuffers.normals, 3).setUsage(DynamicDrawUsage));
     skirtGeometry.setIndex(new BufferAttribute(skirtBuffers.indices, 1));
+    if (skirtBuffers.ring)
+        skirtGeometry.userData.ring = skirtBuffers.ring;
     setSkirtBounds(skirtGeometry, field, span);
     return {
         geometry,
+        holeBoundary,
         buffers,
         heightBounds: span,
         skirt: { geometry: skirtGeometry, buffers: skirtBuffers },
@@ -38,7 +48,10 @@ export function applyTerrainPatch(target, field, patch) {
     if (!range)
         return;
     updateTerrainMesh(field, target.buffers, patch);
-    if (patch.col0 <= 0 ||
+    if (target.holeBoundary)
+        updateTerrainHoleBoundary(target.holeBoundary, target.buffers);
+    if (target.skirt.buffers.ring ||
+        patch.col0 <= 0 ||
         patch.row0 <= 0 ||
         patch.col0 + patch.cols >= field.cols ||
         patch.row0 + patch.rows >= field.rows) {
@@ -111,12 +124,25 @@ function setTerrainBounds(geometry, field, { minY, maxY }) {
  * same reason the geometry does.
  */
 function setSkirtBounds(geometry, field, { minY, maxY }) {
-    const low = Math.min(minY, HORIZON_PLANE_Y) - 1;
+    const low = Math.min(minY, HORIZON_PLANE_Y) - SKIRT_DROP;
     const high = Math.max(maxY, HORIZON_PLANE_Y);
-    const minX = field.origin[0];
-    const minZ = field.origin[1];
-    const maxX = minX + (field.cols - 1) * field.spacing;
-    const maxZ = minZ + (field.rows - 1) * field.spacing;
+    let minX = field.origin[0];
+    let minZ = field.origin[1];
+    let maxX = minX + (field.cols - 1) * field.spacing;
+    let maxZ = minZ + (field.rows - 1) * field.spacing;
+    const ring = geometry.userData.ring;
+    if (ring && ring.length >= 6) {
+        minX = maxX = ring[0] ?? 0;
+        minZ = maxZ = ring[1] ?? 0;
+        for (let i = 2; i < ring.length; i += 2) {
+            const x = ring[i] ?? 0;
+            const z = ring[i + 1] ?? 0;
+            minX = Math.min(minX, x);
+            maxX = Math.max(maxX, x);
+            minZ = Math.min(minZ, z);
+            maxZ = Math.max(maxZ, z);
+        }
+    }
     geometry.boundingSphere ??= new Sphere();
     const sphere = geometry.boundingSphere;
     sphere.center.set((minX + maxX) / 2, (low + high) / 2, (minZ + maxZ) / 2);
@@ -147,5 +173,6 @@ export function needsRebuild(target, field) {
 }
 export function disposeTerrainGeometry(target) {
     target.geometry.dispose();
+    target.holeBoundary?.geometry.dispose();
     target.skirt.geometry.dispose();
 }

package/dist/site/terrain-renderer.d.ts

@@ -1,4 +1,4 @@
-import { type SiteNode } from '@pascal-app/core';
+import { type Ring, type SiteNode } from '@pascal-app/core';
 import type { Material } from 'three';
 /**
  * Renders the site's sculpted ground.
@@ -19,10 +19,19 @@ import type { Material } from 'three';
  *   the editor layer, but moving actual scene geometry there would exclude it from
  *   the MRT depth/normal pass and break the screen-space ink against it.
  */
-export declare const TerrainRenderer: ({ material, site, }: {
+export declare const TerrainRenderer: ({ material, veil, site, holes, polygon, }: {
     /** Owned by `SiteRenderer` so the ground material stays defined in one place. */
     material: Material;
+    /** The veil drawn in the ground's place over a level below grade, owned there too. */
+    veil: Material;
     site: SiteNode;
+    holes: Ring[];
+    /**
+     * The lot's property line (live while it is being edited). With one, the
+     * ground is the lot alone — cut to the line, closed by a skirt down to a flat
+     * base — rather than the field's padded box.
+     */
+    polygon?: ReadonlyArray<readonly [number, number]> | null;
 }) => import("react").JSX.Element | null;
 export default TerrainRenderer;
 //# sourceMappingURL=terrain-renderer.d.ts.map

package/dist/site/terrain-renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"terrain-renderer.d.ts","sourceRoot":"","sources":["../../src/site/terrain-renderer.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,QAAQ,EAAkC,MAAM,kBAAkB,CAAA;AAEhF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AASrC;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,eAAe,GAAI,qBAG7B;IACD,iFAAiF;IACjF,QAAQ,EAAE,QAAQ,CAAA;IAClB,IAAI,EAAE,QAAQ,CAAA;CACf,uCA6DA,CAAA;AAED,eAAe,eAAe,CAAA"}
+{"version":3,"file":"terrain-renderer.d.ts","sourceRoot":"","sources":["../../src/site/terrain-renderer.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,IAAI,EAAE,KAAK,QAAQ,EAAkC,MAAM,kBAAkB,CAAA;AAG3F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAYrC;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,eAAe,8CAMzB;IACD,iFAAiF;IACjF,QAAQ,EAAE,QAAQ,CAAA;IAClB,sFAAsF;IACtF,IAAI,EAAE,QAAQ,CAAA;IACd,IAAI,EAAE,QAAQ,CAAA;IACd,KAAK,EAAE,IAAI,EAAE,CAAA;IACb;;;;OAIG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,CAAA;CAC1D,uCA+GA,CAAA;eAEc,eAAe"}

package/dist/site/terrain-renderer.js

@@ -1,8 +1,12 @@
 'use client';
-import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { terrainFieldOf, useLiveTerrain } from '@pascal-app/core';
+import { SITE_GROUND } from '@pascal-app/viewer';
 import { useEffect, useMemo, useRef } from 'react';
-import { applyTerrainPatch, createTerrainGeometry, disposeTerrainGeometry, needsRebuild, } from './terrain-mesh';
+import { GroundVeil } from './ground-veil.js';
+import { lotMaskedMaterial } from './lot-mask.js';
+import { skirtRing } from './terrain-geometry.js';
+import { applyTerrainPatch, createTerrainGeometry, disposeTerrainGeometry, needsRebuild, } from './terrain-mesh.js';
 /**
  * Renders the site's sculpted ground.
  *
@@ -22,7 +26,7 @@ import { applyTerrainPatch, createTerrainGeometry, disposeTerrainGeometry, needs
  *   the editor layer, but moving actual scene geometry there would exclude it from
  *   the MRT depth/normal pass and break the screen-space ink against it.
  */
-export const TerrainRenderer = ({ material, site, }) => {
+export const TerrainRenderer = ({ material, veil, site, holes, polygon, }) => {
     const targetRef = useRef(null);
     // Persisted terrain only — the live stroke is applied imperatively below, so a
     // dab never triggers a React render.
@@ -31,8 +35,21 @@ export const TerrainRenderer = ({ material, site, }) => {
         const field = useLiveTerrain.getState().fieldOf(site.id) ?? persistedField;
         if (!field)
             return null;
-        return createTerrainGeometry(field);
-    }, [persistedField, site.id]);
+        const ring = polygon && polygon.length >= 3 ? skirtRing(field, polygon) : null;
+        return createTerrainGeometry(field, holes, ring && ring.length >= 6 ? ring : null);
+    }, [persistedField, site.id, holes, polygon]);
+    // The surface (and the cut edges round recessed slabs) stop at the property
+    // line; the skirt keeps the plain material — it *is* the line.
+    const surfaceMaterial = useMemo(() => (polygon && polygon.length >= 3 ? lotMaskedMaterial(material, polygon) : material), [material, polygon]);
+    useEffect(() => () => {
+        if (surfaceMaterial !== material)
+            surfaceMaterial.dispose();
+    }, [surfaceMaterial, material]);
+    const surfaceVeil = useMemo(() => (polygon && polygon.length >= 3 ? lotMaskedMaterial(veil, polygon) : veil), [veil, polygon]);
+    useEffect(() => () => {
+        if (surfaceVeil !== veil)
+            surfaceVeil.dispose();
+    }, [surfaceVeil, veil]);
     targetRef.current = target;
     useEffect(() => () => {
         if (target)
@@ -64,6 +81,6 @@ export const TerrainRenderer = ({ material, site, }) => {
     }, [site.id]);
     if (!target)
         return null;
-    return (_jsxs(_Fragment, { children: [_jsx("mesh", { castShadow: true, geometry: target.geometry, material: material, receiveShadow: true }), _jsx("mesh", { geometry: target.skirt.geometry, material: material, receiveShadow: true })] }));
+    return (_jsxs(_Fragment, { children: [_jsx("mesh", { castShadow: true, geometry: target.geometry, material: surfaceMaterial, receiveShadow: true, userData: { [SITE_GROUND]: 'solid' } }), _jsx(GroundVeil, { geometry: target.geometry, material: surfaceVeil }), target.holeBoundary && (_jsxs(_Fragment, { children: [_jsx("mesh", { castShadow: true, geometry: target.holeBoundary.geometry, material: surfaceMaterial, receiveShadow: true, userData: { [SITE_GROUND]: 'solid' } }), _jsx(GroundVeil, { geometry: target.holeBoundary.geometry, material: surfaceVeil })] })), _jsx("mesh", { geometry: target.skirt.geometry, material: material, receiveShadow: true, userData: { [SITE_GROUND]: 'solid' } }), _jsx(GroundVeil, { geometry: target.skirt.geometry, material: veil })] }));
 };
 export default TerrainRenderer;

package/dist/site/underground-edge.d.ts

@@ -0,0 +1,26 @@
+import type { UndergroundEdge } from '@pascal-app/viewer';
+/**
+ * The hole's edge looks (`UndergroundEdge`), as numbers: the ground's mask and its rim read them
+ * as uniforms and the pit's walls as uniforms and a CPU contour, so changing the look compiles
+ * nothing. `noise` is the shipped one; the others are variants to choose from.
+ */
+export type EdgeLook = {
+    /** The hole's base margin around the footprint, in metres. */
+    margin: number;
+    /** How far the noise moves the edge in or out of the margin, in metres (0: a constant offset). */
+    erode: number;
+    /** Noise cells per metre on the ground, of the broadest octave. */
+    scale: number;
+    /** The soft shade on the ground side of the cut: its width in metres and how dark it gets. */
+    featherWidth: number;
+    featherStrength: number;
+    /** The thin line along the cut: its width in metres and colour. */
+    lineWidth: number;
+    lineColor: string;
+    /** How far (m) the pit's walls are roughened sideways in depth. */
+    crumble: number;
+    /** 1: the wall is a flat section face with a line at grade, not strata under a topsoil layer. */
+    section: number;
+};
+export declare const EDGE_LOOKS: Record<UndergroundEdge, EdgeLook>;
+//# sourceMappingURL=underground-edge.d.ts.map

package/dist/site/underground-edge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"underground-edge.d.ts","sourceRoot":"","sources":["../../src/site/underground-edge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEzD;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAA;IACd,kGAAkG;IAClG,KAAK,EAAE,MAAM,CAAA;IACb,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAA;IACb,8FAA8F;IAC9F,YAAY,EAAE,MAAM,CAAA;IACpB,eAAe,EAAE,MAAM,CAAA;IACvB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAA;IACf,iGAAiG;IACjG,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,eAAe,EAAE,QAAQ,CA6CxD,CAAA"}

package/dist/site/underground-edge.js

@@ -0,0 +1,46 @@
+export const EDGE_LOOKS = {
+    noise: {
+        margin: 1.6,
+        erode: 0.9,
+        scale: 0.6,
+        featherWidth: 0.55,
+        featherStrength: 0.6,
+        lineWidth: 0.09,
+        lineColor: '#f4f4f4',
+        crumble: 0.9,
+        section: 0,
+    },
+    quiet: {
+        margin: 1.6,
+        erode: 0.15,
+        scale: 2.4,
+        featherWidth: 0.55,
+        featherStrength: 0.6,
+        lineWidth: 0.09,
+        lineColor: '#f4f4f4',
+        crumble: 0.25,
+        section: 0,
+    },
+    section: {
+        margin: 0.6,
+        erode: 0,
+        scale: 0.6,
+        featherWidth: 0.25,
+        featherStrength: 0.4,
+        lineWidth: 0.07,
+        lineColor: '#2b2b2b',
+        crumble: 0,
+        section: 1,
+    },
+    'section-earth': {
+        margin: 0.6,
+        erode: 0,
+        scale: 0.6,
+        featherWidth: 0.25,
+        featherStrength: 0.4,
+        lineWidth: 0.07,
+        lineColor: '#2b2b2b',
+        crumble: 0.25,
+        section: 0,
+    },
+};

package/dist/skylight/definition.d.ts

@@ -1,5 +1,5 @@
 import { type NodeDefinition } from '@pascal-app/core';
-import { SkylightNode } from './schema';
+import { SkylightNode } from './schema.js';
 /**
  * Skylight — a framed glass opening hosted on a roof segment. All five
  * type variants (flat / walk-on / lantern / opening / sliding) render

package/dist/skylight/definition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/skylight/definition.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EAIpB,MAAM,kBAAkB,CAAA;AASzB,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAoMvC;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,cAAc,CAAC,OAAO,YAAY,CAkFlE,CAAA"}
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/skylight/definition.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EAIpB,MAAM,kBAAkB,CAAA;AASzB,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAoMvC;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,cAAc,CAAC,OAAO,YAAY,CAmFlE,CAAA"}

package/dist/skylight/definition.js

@@ -1,9 +1,9 @@
 import { SkylightNode as SkylightNodeSchema, } from '@pascal-app/core';
-import { buildSkylightFloorplan } from './floorplan';
-import { closeSkylightOpenState, isOperableSkylightNode, toggleSkylightOpenState, } from './interaction';
-import { skylightParametrics } from './parametrics';
-import { buildSkylightRoofCut } from './roof-cut';
-import { SkylightNode } from './schema';
+import { buildSkylightFloorplan } from './floorplan.js';
+import { closeSkylightOpenState, isOperableSkylightNode, toggleSkylightOpenState, } from './interaction.js';
+import { skylightParametrics } from './parametrics.js';
+import { buildSkylightRoofCut } from './roof-cut.js';
+import { SkylightNode } from './schema.js';
 // In-world handle constants. Offsets are measured from the skylight's
 // edge to the arrow's CENTER, so they need to clear half the chevron's
 // own length (~13 cm at default scale) plus the frame's outward depth
@@ -212,6 +212,7 @@ export const skylightDefinition = {
         return rest;
     },
     capabilities: {
+        exterior: true,
         selectable: { hitVolume: 'bbox' },
         duplicable: true,
         deletable: true,
@@ -229,16 +230,16 @@ export const skylightDefinition = {
     rendersChildren: false,
     renderer: {
         kind: 'parametric',
-        module: () => import('./renderer'),
+        module: () => import('./renderer.js'),
     },
-    preview: () => import('./preview'),
+    preview: () => import('./preview.js'),
     system: {
-        module: () => import('./system'),
+        module: () => import('./system.js'),
         priority: 3,
     },
-    tool: () => import('./tool'),
+    tool: () => import('./tool.js'),
     affordanceTools: {
-        move: () => import('./move-tool'),
+        move: () => import('./move-tool.js'),
     },
     toolHints: [
         { key: 'Left click', label: 'Place skylight on roof' },

package/dist/skylight/geometry.d.ts

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import { getAnalyticalNormal, getSurfaceY } from '../shared/roof-surface';
+import { getAnalyticalNormal, getSurfaceY } from '../shared/roof-surface.js';
 export { getAnalyticalNormal, getSurfaceY };
 export declare function paneSize(value: number): number;
 export declare function clamp01(value: number): number;

package/dist/skylight/geometry.js

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import { getAnalyticalNormal, getSurfaceY } from '../shared/roof-surface';
+import { getAnalyticalNormal, getSurfaceY } from '../shared/roof-surface.js';
 export { getAnalyticalNormal, getSurfaceY };
 export function paneSize(value) {
     return Math.max(0.02, value);

package/dist/skylight/index.d.ts

@@ -1,5 +1,5 @@
-export { skylightDefinition } from './definition';
-export { buildFrameGeometry } from './frame-csg';
-export { buildLanternGlassGeometry } from './geometry';
-export { SkylightNode } from './schema';
+export { skylightDefinition } from './definition.js';
+export { buildFrameGeometry } from './frame-csg.js';
+export { buildLanternGlassGeometry } from './geometry.js';
+export { SkylightNode } from './schema.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/skylight/index.js

@@ -1,4 +1,4 @@
-export { skylightDefinition } from './definition';
-export { buildFrameGeometry } from './frame-csg';
-export { buildLanternGlassGeometry } from './geometry';
-export { SkylightNode } from './schema';
+export { skylightDefinition } from './definition.js';
+export { buildFrameGeometry } from './frame-csg.js';
+export { buildLanternGlassGeometry } from './geometry.js';
+export { SkylightNode } from './schema.js';

package/dist/skylight/move-tool.js

@@ -4,10 +4,10 @@ import { emitter, sceneRegistry, useScene, } from '@pascal-app/core';
 import { consumePlacementDragRelease, markToolCancelConsumed, triggerSFX, useEditor, } from '@pascal-app/editor';
 import { useCallback, useEffect, useRef, useState } from 'react';
 import * as THREE from 'three';
-import { createRelativeRoofDrag, roofSegmentLocalToBuildingLocal, snapRelativeRoofDragTarget, } from '../shared/relative-roof-drag';
-import { getAnalyticalNormal, surfaceQuatFromNormal } from '../shared/roof-surface';
-import { clearRoofSurfacePlacementGuides, publishRoofSurfaceNodePlacementGuides, snapRoofSurfaceNodeTarget, } from '../shared/roof-surface-placement-guides';
-import SkylightPreview from './preview';
+import { createRelativeRoofDrag, roofSegmentLocalToBuildingLocal, snapRelativeRoofDragTarget, } from '../shared/relative-roof-drag.js';
+import { getAnalyticalNormal, surfaceQuatFromNormal } from '../shared/roof-surface.js';
+import { clearRoofSurfacePlacementGuides, publishRoofSurfaceNodePlacementGuides, snapRoofSurfaceNodeTarget, } from '../shared/roof-surface-placement-guides.js';
+import SkylightPreview from './preview.js';
 export default function MoveSkylightTool({ node }) {
     const exitMoveMode = useCallback(() => {
         useEditor.getState().setMovingNode(null);

package/dist/skylight/panel.js

@@ -1,5 +1,5 @@
 'use client';
-import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { SKYLIGHT_TYPE_ORDER, SKYLIGHT_TYPE_PRESETS, sceneRegistry, useLiveNodeOverrides, useScene, } from '@pascal-app/core';
 import { ActionButton, ActionGroup, PanelSection, PanelWrapper, SegmentedControl, SliderControl, triggerSFX, } from '@pascal-app/editor';
 import { useViewer } from '@pascal-app/viewer';
@@ -217,7 +217,7 @@ export default function SkylightPanel() {
                             const isSelected = activeSkylightType === skylightType;
                             return (_jsx("button", { className: cn('flex min-h-12 items-center gap-2.5 rounded-lg border px-3 py-2.5 text-left text-xs transition-colors', isSelected
                                     ? 'border-orange-400/60 bg-orange-400/10 text-foreground'
-                                    : 'border-border/50 bg-[#2C2C2E] text-muted-foreground hover:bg-[#3e3e3e] hover:text-foreground'), onClick: () => handleTypeChange(skylightType), type: "button", children: _jsx("span", { className: "min-w-0 truncate font-medium", children: SKYLIGHT_TYPE_PRESETS[skylightType].label }) }, skylightType));
+                                    : 'border-border/50 bg-black/4 dark:bg-[#2C2C2E] text-muted-foreground hover:bg-black/8 dark:hover:bg-[#3e3e3e] hover:text-foreground'), onClick: () => handleTypeChange(skylightType), type: "button", children: _jsx("span", { className: "min-w-0 truncate font-medium", children: SKYLIGHT_TYPE_PRESETS[skylightType].label }) }, skylightType));
                         }) }), _jsx(SliderControl, { label: "Glass Thickness", max: 0.05, min: 0.002, onChange: (v) => previewProp({ glassThickness: v }), onCommit: (v) => commitProp({ glassThickness: v }), precision: 3, restoreOnCommit: false, step: 0.001, unit: "m", value: node.glassThickness ?? 0.01 }), activeSkylightType === 'lantern' && (_jsxs(_Fragment, { children: [_jsx(SliderControl, { label: "Lantern Height", max: 1.0, min: 0.05, onChange: (v) => previewProp({ lanternHeight: v }), onCommit: (v) => commitProp({ lanternHeight: v }), precision: 3, restoreOnCommit: false, step: 0.01, unit: "m", value: node.lanternHeight ?? 0.25 }), _jsx(SliderControl, { label: "Top Scale", max: 0.95, min: 0, onChange: (v) => previewProp({ lanternTopScale: v }), onCommit: (v) => commitProp({ lanternTopScale: v }), precision: 2, restoreOnCommit: false, step: 0.05, unit: "", value: Math.round((node.lanternTopScale ?? 0.25) * 100) / 100 })] })), activeSkylightType === 'opening' && (_jsxs(_Fragment, { children: [_jsx(SliderControl, { label: "Open", max: 1, min: 0, onChange: (v) => previewProp({ operationState: v }), onCommit: (v) => commitProp({ operationState: v }), precision: 2, restoreOnCommit: false, step: 0.01, unit: "", value: Math.round((node.operationState ?? 0) * 100) / 100 }), _jsx(SliderControl, { label: "Opening Angle", max: 80, min: 0, onChange: (deg) => previewProp({ openingAngle: (deg * Math.PI) / 180 }), onCommit: (deg) => commitProp({ openingAngle: (deg * Math.PI) / 180 }), precision: 0, restoreOnCommit: false, step: 1, unit: "\u00B0", value: Math.round(((node.openingAngle ?? Math.PI / 10) * 180) / Math.PI) }), _jsx(SegmentedControl, { onChange: (v) => commitProp({ openingSide: v }), options: [
                                     { label: 'Top', value: 'top' },
                                     { label: 'Bottom', value: 'bottom' },
@@ -249,5 +249,5 @@ export default function SkylightPanel() {
                             const m = skylightObj.matrixWorld.elements;
                             const ancestorWorldY = Math.atan2(-(m[2] ?? 0), m[0] ?? 1);
                             previewProp({ rotation: newWorldRot - ancestorWorldY });
-                        }, onCommit: (degrees) => commitWorldRotation((degrees * Math.PI) / 180), precision: 0, restoreOnCommit: false, step: 1, unit: "\u00B0", value: Math.round((worldRotation_now * 180) / Math.PI) })] }), _jsx(PanelSection, { title: "Actions", children: _jsx(ActionGroup, { children: _jsx(ActionButton, { className: "hover:bg-red-500/20", icon: _jsx(Trash2, { className: "h-3.5 w-3.5 text-red-400" }), label: "Delete", onClick: handleDelete }) }) })] }));
+                        }, onCommit: (degrees) => commitWorldRotation((degrees * Math.PI) / 180), precision: 0, restoreOnCommit: false, step: 1, unit: "\u00B0", value: Math.round((worldRotation_now * 180) / Math.PI) })] }), _jsx(PanelSection, { title: "Actions", children: _jsx(ActionGroup, { children: _jsx(ActionButton, { className: "hover:bg-red-500/20", icon: _jsx(Trash2, { className: "h-3.5 w-3.5 text-red-600 dark:text-red-400" }), label: "Delete", onClick: handleDelete }) }) })] }));
 }

package/dist/skylight/parametrics.d.ts

@@ -1,4 +1,4 @@
 import type { ParametricDescriptor } from '@pascal-app/core';
-import type { SkylightNode } from './schema';
+import type { SkylightNode } from './schema.js';
 export declare const skylightParametrics: ParametricDescriptor<SkylightNode>;
 //# sourceMappingURL=parametrics.d.ts.map

package/dist/skylight/parametrics.js

@@ -1,5 +1,5 @@
 export const skylightParametrics = {
-    customPanel: () => import('./panel'),
+    customPanel: () => import('./panel.js'),
     groups: [
         {
             label: 'Type',

package/dist/skylight/preview.d.ts

@@ -1,4 +1,4 @@
-import type { SkylightNode } from './schema';
+import type { SkylightNode } from './schema.js';
 declare const SkylightPreview: ({ node, invalid }: {
     node: SkylightNode;
     invalid?: boolean;

package/dist/skylight/preview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/skylight/preview.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAsB5C,QAAA,MAAM,eAAe,GAAI,mBAAmB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,uCAuCpF,CAAA;AAED,eAAe,eAAe,CAAA"}
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/skylight/preview.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAsB5C,QAAA,MAAM,eAAe,sBAAuB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,uCAuCpF,CAAA;eAEc,eAAe"}

package/dist/skylight/preview.js

@@ -2,8 +2,8 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEffect, useMemo } from 'react';
 import * as THREE from 'three';
-import { INVALID_GHOST_COLOR } from '../shared/ghost-materials';
-import { buildFrameGeometry } from './frame-csg';
+import { INVALID_GHOST_COLOR } from '../shared/ghost-materials.js';
+import { buildFrameGeometry } from './frame-csg.js';
 const ghostMaterial = new THREE.MeshStandardMaterial({
     color: 0xff_ff_ff,
     emissive: 0xff_ff_ff,

package/dist/skylight/renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../src/skylight/renderer.tsx"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,YAAY,EAMlB,MAAM,kBAAkB,CAAA;AAmpBzB,QAAA,MAAM,gBAAgB,GAAI,qBAAqB;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,uCAgNpE,CAAA;AAED,eAAe,gBAAgB,CAAA"}
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../src/skylight/renderer.tsx"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,YAAY,EAMlB,MAAM,kBAAkB,CAAA;AAmpBzB,QAAA,MAAM,gBAAgB,wBAAyB;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,uCAgNpE,CAAA;eAEc,gBAAgB"}

package/dist/skylight/renderer.js

@@ -1,13 +1,13 @@
 'use client';
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { SKYLIGHT_TYPE_PRESETS, useInteractive, useLiveNodeOverrides, useRegistry, useScene, } from '@pascal-app/core';
 import { createMaterial, createMaterialFromPresetRef, createSurfaceRoleMaterial, getRoofOuterSurfaceFrameAtPoint, useNodeEvents, useViewer, } from '@pascal-app/viewer';
 import { useEffect, useMemo, useRef } from 'react';
 import * as THREE from 'three';
-import { surfaceQuatFromNormal } from '../shared/roof-surface';
-import { TrimClippedMesh, useSegmentTrimClippedGeometry } from '../shared/use-segment-trim-clip';
-import { buildFrameGeometry } from './frame-csg';
-import { buildLanternGlassGeometry, clamp01, paneSize } from './geometry';
+import { surfaceQuatFromNormal } from '../shared/roof-surface.js';
+import { TrimClippedMesh, useSegmentTrimClippedGeometry } from '../shared/use-segment-trim-clip.js';
+import { buildFrameGeometry } from './frame-csg.js';
+import { buildLanternGlassGeometry, clamp01, paneSize } from './geometry.js';
 const yAxis = new THREE.Vector3(0, 1, 0);
 const defaultFrameMaterial = new THREE.MeshStandardMaterial({
     color: 0xff_ff_ff,

package/dist/skylight/system.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/skylight/system.tsx"],"names":[],"mappings":"AAOA,QAAA,MAAM,uBAAuB,YAgD5B,CAAA;AAED,eAAe,uBAAuB,CAAA"}
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/skylight/system.tsx"],"names":[],"mappings":"AAOA,QAAA,MAAM,uBAAuB,YAgD5B,CAAA;eAEc,uBAAuB"}

package/dist/skylight/tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/skylight/tool.tsx"],"names":[],"mappings":"AA4BA,QAAA,MAAM,YAAY,mCAsIjB,CAAA;AAED,eAAe,YAAY,CAAA"}
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/skylight/tool.tsx"],"names":[],"mappings":"AA4BA,QAAA,MAAM,YAAY,mCAsIjB,CAAA;eAEc,YAAY"}

package/dist/skylight/tool.js

@@ -1,16 +1,16 @@
 'use client';
-import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { emitter, SkylightNode, sceneRegistry, useScene, } from '@pascal-app/core';
 import { triggerSFX, usePlacementPreview } from '@pascal-app/editor';
 import { useViewer } from '@pascal-app/viewer';
 import { useEffect, useMemo, useRef, useState } from 'react';
 import * as THREE from 'three';
-import { RoofAttachmentFallbackPreview } from '../shared/roof-attachment-fallback-preview';
-import { resolveRoofSegmentHit } from '../shared/roof-segment-hit';
-import { getAnalyticalNormal, surfaceQuatFromNormal } from '../shared/roof-surface';
-import { clearRoofSurfacePlacementGuides, publishRoofSurfacePlacementGuides, roofSurfaceFootprintFromNode, } from '../shared/roof-surface-placement-guides';
-import { skylightDefinition } from './definition';
-import SkylightPreview from './preview';
+import { RoofAttachmentFallbackPreview } from '../shared/roof-attachment-fallback-preview.js';
+import { resolveRoofSegmentHit } from '../shared/roof-segment-hit.js';
+import { getAnalyticalNormal, surfaceQuatFromNormal } from '../shared/roof-surface.js';
+import { clearRoofSurfacePlacementGuides, publishRoofSurfacePlacementGuides, roofSurfaceFootprintFromNode, } from '../shared/roof-surface-placement-guides.js';
+import { skylightDefinition } from './definition.js';
+import SkylightPreview from './preview.js';
 const worldPoint = new THREE.Vector3();
 const SkylightTool = () => {
     const activeBuildingId = useViewer((s) => s.selection.buildingId);

package/dist/slab/boundary-editor.d.ts

@@ -3,7 +3,7 @@ import { type SlabNode } from '@pascal-app/core';
  * Phase 5 Stage D — slab boundary editor (registry-driven).
  *
  * Thin wrapper around the shared `PolygonEditor`. Activates when a
- * slab is selected in structure/select mode (not currently editing a
+ * slab is selected in select mode (not currently editing a
  * hole). The heavy lifting — vertex drag, edge slide, snap, history
  * bracketing — lives in `PolygonEditor` itself.
  *