@pascal-app/core 1.0.4 → 1.0.6

package/dist/lib/snap-ease.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The ghost snapping to a corner: a short eased move, never a jump or a bounce. Under 200 ms and
+ * easing out, so it feels like the window was pulled in; it keeps following the cursor while it
+ * eases, and does nothing at all under reduced motion.
+ */
+/** How long the ghost takes to move into, or out of, a snap (ms). */
+export declare const SNAP_EASE_MS = 120;
+/** Whether the reader asked for reduced motion; false where the browser cannot say. */
+export declare function prefersReducedMotion(): boolean;
+export declare function createSnapEaser(): {
+    /**
+     * Where to draw the ghost along its wall: `target` is where it belongs (the cursor, or the
+     * snapped place), `isSnapped` whether it is snapped now. A change of `isSnapped` starts the move.
+     */
+    display(target: number, isSnapped: boolean, now: number, reducedMotion: boolean): number;
+    /** Whether a move is under way at `now`, so the caller keeps drawing frames. */
+    active(now: number): boolean;
+    reset(): void;
+};
+//# sourceMappingURL=snap-ease.d.ts.map

package/dist/lib/snap-ease.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snap-ease.d.ts","sourceRoot":"","sources":["../../src/lib/snap-ease.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,qEAAqE;AACrE,eAAO,MAAM,YAAY,MAAM,CAAA;AAE/B,uFAAuF;AACvF,wBAAgB,oBAAoB,IAAI,OAAO,CAM9C;AAID,wBAAgB,eAAe;IAO3B;;;OAGG;IACH,OAAO,SAAS,MAAM,aAAa,OAAO,OAAO,MAAM,iBAAiB,OAAO,GAAG,MAAM;IAcxF,gFAAgF;IAChF,MAAM,MAAM,MAAM,GAAG,OAAO;IAG5B,KAAK;EAMR"}

package/dist/lib/snap-ease.js

@@ -0,0 +1,50 @@
+/**
+ * The ghost snapping to a corner: a short eased move, never a jump or a bounce. Under 200 ms and
+ * easing out, so it feels like the window was pulled in; it keeps following the cursor while it
+ * eases, and does nothing at all under reduced motion.
+ */
+/** How long the ghost takes to move into, or out of, a snap (ms). */
+export const SNAP_EASE_MS = 120;
+/** Whether the reader asked for reduced motion; false where the browser cannot say. */
+export function prefersReducedMotion() {
+    return (typeof window !== 'undefined' &&
+        typeof window.matchMedia === 'function' &&
+        window.matchMedia('(prefers-reduced-motion: reduce)').matches);
+}
+const easeOutCubic = (t) => 1 - (1 - t) ** 3;
+export function createSnapEaser() {
+    let snapped = false;
+    let last = null;
+    let from = 0;
+    let started = Number.NEGATIVE_INFINITY;
+    return {
+        /**
+         * Where to draw the ghost along its wall: `target` is where it belongs (the cursor, or the
+         * snapped place), `isSnapped` whether it is snapped now. A change of `isSnapped` starts the move.
+         */
+        display(target, isSnapped, now, reducedMotion) {
+            if (isSnapped !== snapped) {
+                snapped = isSnapped;
+                if (reducedMotion || last === null)
+                    started = Number.NEGATIVE_INFINITY;
+                else {
+                    from = last;
+                    started = now;
+                }
+            }
+            const progress = Math.min(1, Math.max(0, (now - started) / SNAP_EASE_MS));
+            const shown = progress >= 1 ? target : target + (from - target) * (1 - easeOutCubic(progress));
+            last = shown;
+            return shown;
+        },
+        /** Whether a move is under way at `now`, so the caller keeps drawing frames. */
+        active(now) {
+            return now - started < SNAP_EASE_MS;
+        },
+        reset() {
+            snapped = false;
+            last = null;
+            started = Number.NEGATIVE_INFINITY;
+        },
+    };
+}

package/dist/lib/structure-kernel.d.ts

@@ -58,7 +58,7 @@ declare function planLevelStructure({ levelId, nodes, mintId, openingIndex, }: {
     events: StructureEvent[];
 };
 export declare function createLevelStructurePreview(levelId: string, nodes: SceneNodes): (walls: readonly WallNode[]) => {
-    op: "update";
+    op: 'update';
     id: AnyNodeId;
     data: Partial<AnyNode>;
 }[];

package/dist/lib/structure-kernel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"structure-kernel.d.ts","sourceRoot":"","sources":["../../src/lib/structure-kernel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAiB,QAAQ,EAAE,MAAM,WAAW,CAAA;AAI5E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAWpD,OAAO,EAAE,KAAK,iBAAiB,EAAsB,MAAM,wBAAwB,CAAA;AAOnF,OAAO,EAKL,KAAK,OAAO,EACZ,KAAK,IAAI,EAEV,MAAM,mBAAmB,CAAA;AAI1B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAUzD,eAAO,MAAM,+BAA+B,MAAM,CAAA;AAElD,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAC1D,MAAM,MAAM,SAAS,GACjB;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC/B;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,GACvD;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,SAAS,CAAA;CAAE,CAAA;AACnC,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAA;IAC/D,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AACD,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAA;IACtB,OAAO,EAAE,IAAI,CAAA;IACb,KAAK,EAAE,IAAI,EAAE,CAAA;IACb,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,EAAE,YAAY,EAAE,CAAA;CACtB,CAAA;AACD,MAAM,MAAM,sBAAsB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,aAAa,EAAE,CAAA;CAAE,CAAA;AAuDhF;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS;IAAE,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,EAAE,GACxE,GAAG,CAAC,MAAM,CAAC,CAuCb;AAED,iGAAiG;AACjG,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,OAAO,GAAE,WAAW,CAAC,MAAM,CAAa,GACvC,IAAI,CAAC,QAAQ,EAAE,WAAW,GAAG,UAAU,CAAC,CAS1C;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAAC,GAC9C,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAiBvC;AAED,iBAAS,kBAAkB,CAAC,EAC1B,OAAO,EACP,KAAK,EACL,MAAM,EACN,YAAY,GACb,EAAE;IACD,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,UAAU,CAAA;IACjB,aAAa,CAAC,EAAE,UAAU,CAAA;IAC1B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,KAAK,MAAM,CAAA;IACnE,YAAY,CAAC,EAAE,iBAAiB,CAAA;CACjC,GAAG;IAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAAC,QAAQ,EAAE,sBAAsB,CAAC;IAAC,MAAM,EAAE,cAAc,EAAE,CAAA;CAAE,CA0nBvF;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,IAuCpE,OAAO,SAAS,QAAQ,EAAE;QA10B1B,QAAQ;QAAM,SAAS;UAAQ,OAAO,CAAC,OAAO,CAAC;IAo2BxD"}
+{"version":3,"file":"structure-kernel.d.ts","sourceRoot":"","sources":["../../src/lib/structure-kernel.ts"],"names":[],"mappings":"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"}

package/dist/lib/structure-kernel.js

@@ -98,6 +98,8 @@ export function outdoorRoomIds(rooms) {
 }
 /** A wall face is inside when an indoor room stands on it; an outdoor room's face is outside. */
 export function classifyWallSides(wall, spans, outdoor = new Set()) {
+    if (wall.metadata?.roomBoundary === false)
+        return { frontSide: 'unknown', backSide: 'unknown' };
     const boundary = spans.filter((span) => span.boundaryId === wall.id);
     if (!boundary.length)
         return { frontSide: wall.frontSide, backSide: wall.backSide };

package/dist/lib/surface-support-references.d.ts

@@ -0,0 +1,4 @@
+import type { AnyNode } from '../schema/types.js';
+export declare function remapSurfaceSupportReferences(node: AnyNode, ids: ReadonlyMap<string, string>): void;
+export declare function deletedSurfaceSupportPatch(node: AnyNode, deleted: ReadonlySet<string>): Partial<AnyNode> | null;
+//# sourceMappingURL=surface-support-references.d.ts.map

package/dist/lib/surface-support-references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-support-references.d.ts","sourceRoot":"","sources":["../../src/lib/surface-support-references.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAI9C,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,IAAI,CAMN;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,GAC3B,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAQzB"}

package/dist/lib/surface-support-references.js

@@ -0,0 +1,19 @@
+const fields = ['supportSurfaceNodeId', 'destinationSurfaceId'];
+export function remapSurfaceSupportReferences(node, ids) {
+    const record = node;
+    for (const field of fields) {
+        const id = record[field];
+        if (typeof id === 'string')
+            record[field] = ids.get(id) ?? id;
+    }
+}
+export function deletedSurfaceSupportPatch(node, deleted) {
+    const record = node;
+    const patch = {};
+    for (const field of fields) {
+        const id = record[field];
+        if (typeof id === 'string' && deleted.has(id))
+            patch[field] = undefined;
+    }
+    return Object.keys(patch).length ? patch : null;
+}

package/dist/lib/terrain-support-query.d.ts

@@ -12,6 +12,7 @@
  * matrix be tested per kind without a canvas.
  */
 import type { AnyNode } from '../schema/index.js';
+import type { BuildingNode } from '../schema/nodes/building.js';
 import type { SiteNode } from '../schema/nodes/site.js';
 import { persistedTerrainFieldOf } from './terrain-source-persisted.js';
 /**
@@ -33,6 +34,15 @@ export declare const SITE_DATUM_Y = 0;
 export declare const SITE_DATUM_EPSILON = 0.0001;
 /** True when a world-space height is the site datum — i.e. the terrain's plane. */
 export declare function isSiteDatum(worldY: number): boolean;
+/**
+ * Level-local XZ → world XZ, through the building's transform.
+ *
+ * A level group carries only a Y offset (`LevelSystem` writes `position.y` and
+ * nothing else), so level-local XZ is building-local XZ; the building carries the
+ * site-space placement, and the site renders at the origin. Only the Y rotation
+ * matters — a building tipped in X or Z is not a thing the editor can produce.
+ */
+export declare function levelLocalToWorldXZ(building: BuildingNode | null, x: number, z: number): [number, number];
 /**
  * Whether the sculpted ground is what a node on `levelId` stands on — i.e.
  * whether moving the terrain moves that node.

package/dist/lib/terrain-support-query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"terrain-support-query.d.ts","sourceRoot":"","sources":["../../src/lib/terrain-support-query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAa,MAAM,WAAW,CAAA;AAEnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAGpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAA;AAEpE;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,IAAI,CAAA;AAE7B;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,SAAO,CAAA;AAEtC,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEnD;AAoGD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAE3F;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,MAAM,EACf,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,GAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,UAAU,CAAC,OAAO,uBAAuB,CAA2B,GAChG,MAAM,GAAG,IAAI,CAYf;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,MAAM,EACf,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR,MAAM,CAER"}
+{"version":3,"file":"terrain-support-query.d.ts","sourceRoot":"","sources":["../../src/lib/terrain-support-query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAa,MAAM,WAAW,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAGpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAA;AAEpE;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,IAAI,CAAA;AAE7B;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,SAAO,CAAA;AAEtC,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEnD;AA6CD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,YAAY,GAAG,IAAI,EAC7B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR,CAAC,MAAM,EAAE,MAAM,CAAC,CAQlB;AAmCD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAE3F;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,MAAM,EACf,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,GAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,UAAU,CAAC,OAAO,uBAAuB,CAA2B,GAChG,MAAM,GAAG,IAAI,CAYf;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,MAAM,EACf,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR,MAAM,CAER"}

package/dist/lib/terrain-support-query.js

@@ -82,7 +82,7 @@ function siteOf(nodes) {
  * site-space placement, and the site renders at the origin. Only the Y rotation
  * matters — a building tipped in X or Z is not a thing the editor can produce.
  */
-function levelLocalToWorldXZ(building, x, z) {
+export function levelLocalToWorldXZ(building, x, z) {
     if (!building)
         return [x, z];
     const angle = building.rotation?.[1] ?? 0;

package/dist/lib/wall-face-script.d.ts

@@ -0,0 +1,66 @@
+import type { AnyNode, CompiledGeometryScript, WallFaceScript } from '../schema/index.js';
+import type { WallFace } from '../schema/nodes/wall.js';
+import type { WallSlabSupport } from '../systems/slab/slab-support.js';
+type SceneNodes = Readonly<Record<string, AnyNode>>;
+/** A rectangle on a wall face, in the face's frame and metres. */
+export type WallFaceRect = {
+    x0: number;
+    y0: number;
+    x1: number;
+    y1: number;
+};
+/**
+ * What a wall face's script is built for, in the face's frame and metres: x along the wall from
+ * its start, y up from the face's base (its lowest floor), z out of the face. `outline` is the
+ * face's rectangle (its mitred ends, up to the wall's top or the script's `toHeight`); `holes` the
+ * doors and windows cutting it, clipped to it (a door from the floor under it, a window from its
+ * sill); `base` the face's floor from end to end as `[x, y]` points (one level run on a flat floor,
+ * a jump where a raised room meets it); `thickness` the wall's. The build stays in this frame.
+ */
+export type WallFaceScriptInputs = {
+    outline: WallFaceRect;
+    holes: WallFaceRect[];
+    base: [number, number][];
+    thickness: number;
+};
+/** How far the face's frame stands above the wall's own origin: its lowest floor, wall-local. */
+export declare function wallFaceBaseOffset(support: WallSlabSupport, face: WallFace): number;
+/**
+ * The face a script builds on, or null when it has none: a curved or curtain wall, a wall with no
+ * level, or a face with no height above its floor.
+ */
+export declare function wallFaceScriptInputs(nodes: SceneNodes, wallId: string, face: WallFace, toHeight?: number): WallFaceScriptInputs | null;
+/** The key a face script keeps of the face it was built for (`WallFaceScript.inputs`). */
+export declare function wallFaceScriptInputsKey(inputs: WallFaceScriptInputs): string;
+/** A compile as the wall keeps it on a face: its script source, its face's key, its `toHeight`. */
+export declare function wallFaceScriptRecord(compiled: CompiledGeometryScript, inputs: WallFaceScriptInputs, toHeight: number | undefined, previous?: WallFaceScript): WallFaceScript;
+/**
+ * Where a face's build goes in the wall's local frame (x along the wall from its start, z toward
+ * face a): its frame's origin at the face's base, 1 mm proud of the face. Face b's frame has z out
+ * of face b, so the build is mirrored through the wall (`scale` z −1; three.js flips the winding of
+ * a mirrored mesh) and its x still runs from the wall's start. Null when the face has no frame.
+ */
+export declare function wallFaceScriptPlacement(nodes: SceneNodes, wallId: string, face: WallFace): {
+    position: [number, number, number];
+    scale: [number, number, number];
+} | null;
+/**
+ * Where a face's skirting gives way to its script, as it does at a door: the build's span along
+ * the wall when the build comes down into the skirting's band (its bottom below `bandTop`, in the
+ * face's frame), else null. The script wins visually where it covers the band; a splashback above
+ * the skirting leaves it whole.
+ */
+export declare function wallFaceScriptSkirtingGap(script: WallFaceScript, bandTop: number): [number, number] | null;
+export type WallFacePaintRefusal = {
+    status: 'refused';
+    code: 'wall-face-built-by-script';
+    message: string;
+};
+/**
+ * Why a paint on a wall's `role` is refused: it lands on a face (the face itself, a region of it,
+ * the room's finish on it) that a script builds to the top, and the script owns its colours. A
+ * script stopping at `toHeight` leaves its face paintable, since the paint shows above it.
+ */
+export declare function wallFaceScriptPaintRefusal(wall: AnyNode | undefined, role: string): WallFacePaintRefusal | undefined;
+export {};
+//# sourceMappingURL=wall-face-script.d.ts.map

package/dist/lib/wall-face-script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wall-face-script.d.ts","sourceRoot":"","sources":["../../src/lib/wall-face-script.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,sBAAsB,EAEtB,cAAc,EAGf,MAAM,WAAW,CAAA;AAClB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAEpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAenE,KAAK,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAEnD,kEAAkE;AAClE,MAAM,MAAM,YAAY,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAA;AAE7E;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,YAAY,CAAA;IACrB,KAAK,EAAE,YAAY,EAAE,CAAA;IACrB,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAKD,iGAAiG;AACjG,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,CAOnF;AAgID;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,QAAQ,EACd,QAAQ,CAAC,EAAE,MAAM,GAChB,oBAAoB,GAAG,IAAI,CAgC7B;AAED,0FAA0F;AAC1F,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAI5E;AAED,mGAAmG;AACnG,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,sBAAsB,EAChC,MAAM,EAAE,oBAAoB,EAC5B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,QAAQ,CAAC,EAAE,cAAc,GACxB,cAAc,CAMhB;AAKD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,QAAQ,GACb;IAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,IAAI,CAYhF;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,MAAM,GACd,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAGzB;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,SAAS,CAAA;IACjB,IAAI,EAAE,2BAA2B,CAAA;IACjC,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,OAAO,GAAG,SAAS,EACzB,IAAI,EAAE,MAAM,GACX,oBAAoB,GAAG,SAAS,CAkBlC"}

package/dist/lib/wall-face-script.js

@@ -0,0 +1,235 @@
+import { getWallTop } from '../services/storey.js';
+import { isCurvedWall } from '../systems/wall/wall-curve.js';
+import { parseWallPaintRole } from '../systems/wall/wall-finish.js';
+import { getWallThickness } from '../systems/wall/wall-footprint.js';
+import { getWallLocalFaceZ } from '../systems/wall/wall-frame.js';
+import { calculateLevelMiters, getWallMiterBoundaryPoints, } from '../systems/wall/wall-mitering.js';
+import { isFloorAnchoredOpening } from './floor-opening-footprints.js';
+import { scriptSource } from './geometry-script-node.js';
+import { getOpeningFloorDatum, wallSupportForNodes } from './opening-floor-datum.js';
+import { scriptInputsKey } from './script-inputs-key.js';
+const EPS = 1e-6;
+const round = (value) => Math.round(value * 1e4) / 1e4;
+/** How far the face's frame stands above the wall's own origin: its lowest floor, wall-local. */
+export function wallFaceBaseOffset(support, face) {
+    const runs = support.faceDatum[face];
+    if (!runs.length)
+        return 0;
+    const lowest = Math.min(...runs.map((run) => Math.min(run.elevation, run.endElevation ?? run.elevation)));
+    return lowest - support.elevation;
+}
+const mitersByNodes = new WeakMap();
+function levelMiters(nodes, levelId) {
+    let levels = mitersByNodes.get(nodes);
+    if (!levels) {
+        levels = new Map();
+        mitersByNodes.set(nodes, levels);
+    }
+    let miters = levels.get(levelId);
+    if (!miters) {
+        const walls = Object.values(nodes)
+            .filter((node) => node.type === 'wall' && node.parentId === levelId)
+            .sort((a, b) => a.id.localeCompare(b.id));
+        miters = calculateLevelMiters(walls);
+        levels.set(levelId, miters);
+    }
+    return miters;
+}
+/** A wall whose faces a script can build on: straight, not a curtain wall, standing on a level. */
+function scriptableWall(nodes, wallId) {
+    const wall = nodes[wallId];
+    if (wall?.type !== 'wall' || !wall.parentId)
+        return null;
+    if (wall.wallType === 'curtain' || isCurvedWall(wall))
+        return null;
+    return Math.hypot(wall.end[0] - wall.start[0], wall.end[1] - wall.start[1]) < EPS ? null : wall;
+}
+function faceFrame(nodes, wallId, face) {
+    const wall = scriptableWall(nodes, wallId);
+    if (!wall?.parentId)
+        return null;
+    const dx = wall.end[0] - wall.start[0];
+    const dz = wall.end[1] - wall.start[1];
+    const length = Math.hypot(dx, dz);
+    const support = wallSupportForNodes(wall, nodes);
+    const offset = wallFaceBaseOffset(support, face);
+    const top = getWallTop(wall, wall.parentId, nodes, support.elevation) -
+        support.elevation -
+        offset;
+    const station = (point) => ((point.x - wall.start[0]) * dx + (point.y - wall.start[1]) * dz) / length;
+    const ends = getWallMiterBoundaryPoints(wall, levelMiters(nodes, wall.parentId));
+    const x0 = ends ? station(face === 'a' ? ends.startLeft : ends.startRight) : 0;
+    const x1 = ends ? station(face === 'a' ? ends.endLeft : ends.endRight) : length;
+    if (top <= EPS || x1 - x0 <= EPS)
+        return null;
+    return { wall, length, support, offset, x0, x1, top };
+}
+/** The face's floor as `[x, y]` points from `x0` to `x1`, in the face's frame. */
+function faceBase(frame, face) {
+    const { support, length, offset, x0, x1 } = frame;
+    const runs = [...support.faceDatum[face]].sort((a, b) => a.start - b.start);
+    const points = runs.length
+        ? runs.flatMap((run) => [
+            [run.start * length, run.elevation - support.elevation - offset],
+            [run.end * length, (run.endElevation ?? run.elevation) - support.elevation - offset],
+        ])
+        : [
+            [0, 0],
+            [length, 0],
+        ];
+    const yAt = (x) => {
+        if (x <= points[0][0])
+            return points[0][1];
+        for (let index = 1; index < points.length; index += 1) {
+            const [ax, ay] = points[index - 1];
+            const [bx, by] = points[index];
+            if (x <= bx)
+                return bx - ax < EPS ? by : ay + ((x - ax) / (bx - ax)) * (by - ay);
+        }
+        return points[points.length - 1][1];
+    };
+    const kept = [
+        [x0, yAt(x0)],
+        ...points.filter(([x]) => x > x0 + EPS && x < x1 - EPS),
+        [x1, yAt(x1)],
+    ];
+    const base = kept.map(([x, y]) => [round(x), round(y)]);
+    // A point on the straight line between its neighbours (a run's end where the next runs on
+    // level) says nothing; a jump (two points at one x) or a bend stays.
+    const simplified = [];
+    for (const point of base) {
+        const previous = simplified[simplified.length - 1];
+        if (previous && previous[0] === point[0] && previous[1] === point[1])
+            continue;
+        const before = simplified[simplified.length - 2];
+        if (before &&
+            previous &&
+            before[0] < previous[0] &&
+            previous[0] < point[0] &&
+            Math.abs((previous[0] - before[0]) * (point[1] - before[1]) -
+                (previous[1] - before[1]) * (point[0] - before[0])) < EPS)
+            simplified.pop();
+        simplified.push(point);
+    }
+    return simplified;
+}
+/** The lowest point of `base` over `[x0, x1]`. */
+function baseLowUnder(base, x0, x1) {
+    let low = Number.POSITIVE_INFINITY;
+    for (let index = 1; index < base.length; index += 1) {
+        const [ax, ay] = base[index - 1];
+        const [bx, by] = base[index];
+        if (bx < x0 || ax > x1)
+            continue;
+        const at = (x) => bx - ax < EPS ? Math.min(ay, by) : ay + ((x - ax) / (bx - ax)) * (by - ay);
+        low = Math.min(low, at(Math.max(ax, x0)), at(Math.min(bx, x1)));
+    }
+    return Number.isFinite(low) ? low : 0;
+}
+/**
+ * The face a script builds on, or null when it has none: a curved or curtain wall, a wall with no
+ * level, or a face with no height above its floor.
+ */
+export function wallFaceScriptInputs(nodes, wallId, face, toHeight) {
+    const frame = faceFrame(nodes, wallId, face);
+    if (!frame)
+        return null;
+    const { wall, support, offset, x0, x1, top } = frame;
+    const outline = {
+        x0: round(x0),
+        y0: 0,
+        x1: round(x1),
+        y1: round(toHeight === undefined ? top : Math.min(toHeight, top)),
+    };
+    const base = faceBase(frame, face);
+    const holes = (wall.children ?? []).flatMap((childId) => {
+        const opening = nodes[childId];
+        if (opening?.type !== 'door' && opening?.type !== 'window')
+            return [];
+        const { position, width, height } = opening;
+        const centre = getOpeningFloorDatum(wall, opening, nodes, support) - support.elevation - offset + position[1];
+        const left = position[0] - width / 2;
+        const right = position[0] + width / 2;
+        const bottom = isFloorAnchoredOpening(opening)
+            ? Math.min(centre - height / 2, baseLowUnder(base, left, right))
+            : centre - height / 2;
+        const hole = {
+            x0: round(Math.max(left, outline.x0)),
+            y0: round(Math.max(bottom, outline.y0)),
+            x1: round(Math.min(right, outline.x1)),
+            y1: round(Math.min(centre + height / 2, outline.y1)),
+        };
+        return hole.x1 - hole.x0 > EPS && hole.y1 - hole.y0 > EPS ? [hole] : [];
+    });
+    holes.sort((a, b) => a.x0 - b.x0 || a.y0 - b.y0);
+    return { outline, holes, base, thickness: round(getWallThickness(wall)) };
+}
+/** The key a face script keeps of the face it was built for (`WallFaceScript.inputs`). */
+export function wallFaceScriptInputsKey(inputs) {
+    return scriptInputsKey(JSON.stringify([inputs.outline, inputs.holes, inputs.base, inputs.thickness]));
+}
+/** A compile as the wall keeps it on a face: its script source, its face's key, its `toHeight`. */
+export function wallFaceScriptRecord(compiled, inputs, toHeight, previous) {
+    return {
+        ...scriptSource(compiled, {}, previous),
+        inputs: wallFaceScriptInputsKey(inputs),
+        ...(toHeight === undefined ? {} : { toHeight }),
+    };
+}
+/** Over the face, so the face's own finish never shows through the tiles. */
+const WALL_FACE_SCRIPT_PROUD = 0.001;
+/**
+ * Where a face's build goes in the wall's local frame (x along the wall from its start, z toward
+ * face a): its frame's origin at the face's base, 1 mm proud of the face. Face b's frame has z out
+ * of face b, so the build is mirrored through the wall (`scale` z −1; three.js flips the winding of
+ * a mirrored mesh) and its x still runs from the wall's start. Null when the face has no frame.
+ */
+export function wallFaceScriptPlacement(nodes, wallId, face) {
+    const wall = scriptableWall(nodes, wallId);
+    if (!wall)
+        return null;
+    const out = face === 'a' ? 1 : -1;
+    return {
+        position: [
+            0,
+            wallFaceBaseOffset(wallSupportForNodes(wall, nodes), face),
+            getWallLocalFaceZ(wall, face) + out * WALL_FACE_SCRIPT_PROUD,
+        ],
+        scale: [1, 1, out],
+    };
+}
+/**
+ * Where a face's skirting gives way to its script, as it does at a door: the build's span along
+ * the wall when the build comes down into the skirting's band (its bottom below `bandTop`, in the
+ * face's frame), else null. The script wins visually where it covers the band; a splashback above
+ * the skirting leaves it whole.
+ */
+export function wallFaceScriptSkirtingGap(script, bandTop) {
+    const { min, max } = script.manifest.bounds;
+    return min[1] < bandTop - EPS ? [min[0], max[0]] : null;
+}
+/**
+ * Why a paint on a wall's `role` is refused: it lands on a face (the face itself, a region of it,
+ * the room's finish on it) that a script builds to the top, and the script owns its colours. A
+ * script stopping at `toHeight` leaves its face paintable, since the paint shows above it.
+ */
+export function wallFaceScriptPaintRefusal(wall, role) {
+    if (wall?.type !== 'wall')
+        return;
+    const parsed = parseWallPaintRole(role, (slotId) => slotId === 'a' || slotId === 'b');
+    const face = parsed?.kind === 'slot'
+        ? parsed.slotId
+        : parsed?.kind === 'room-face'
+            ? parsed.face
+            : parsed?.kind === 'region'
+                ? wall.faceRegions?.find((region) => region.id === parsed.regionId)?.face
+                : undefined;
+    const script = face && wall.finishScripts?.[face];
+    if (!face || !script || script.toHeight !== undefined)
+        return;
+    return {
+        status: 'refused',
+        code: 'wall-face-built-by-script',
+        message: `${wall.name?.trim() || 'This wall'}'s side ${face.toUpperCase()} is built by a script, which owns its colours. Remove the script to paint that side.`,
+    };
+}

package/dist/lib/zone-colors.d.ts

@@ -1,5 +1,5 @@
 /** The colour picker's swatches, in hue order. */
-export declare const ZONE_COLOR_PALETTE: readonly ["#ef4444", "#f97316", "#f59e0b", "#84cc16", "#22c55e", "#10b981", "#06b6d4", "#3b82f6", "#6366f1", "#a855f7", "#64748b", "#cccccc"];
+export declare const ZONE_COLOR_PALETTE: readonly ['#ef4444', '#f97316', '#f59e0b', '#84cc16', '#22c55e', '#10b981', '#06b6d4', '#3b82f6', '#6366f1', '#a855f7', '#64748b', '#cccccc'];
 /**
  * The colour a new zone is created with: a palette hue picked from a seed —
  * the zone's id, or for an imported room a value of its source that survives

package/dist/lib/zone-colors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zone-colors.d.ts","sourceRoot":"","sources":["../../src/lib/zone-colors.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,eAAO,MAAM,kBAAkB,+IAarB,CAAA;AAKV;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOrD"}
+{"version":3,"file":"zone-colors.d.ts","sourceRoot":"","sources":["../../src/lib/zone-colors.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,eAAO,MAAM,kBAAkB,YAC7B,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,CACD,CAAA;AAKV;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOrD"}

package/dist/lib/zone-quantities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zone-quantities.d.ts","sourceRoot":"","sources":["../../src/lib/zone-quantities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAmC,QAAQ,EAAE,MAAM,WAAW,CAAA;AAwBnF,MAAM,MAAM,iBAAiB,GACzB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAE7C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,cAAc,EAAE,WAAW,GAAG,eAAe,CAAA;IAC7C,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,WAAW,EAAE,iBAAiB,CAAA;IAC9B,YAAY,EAAE,iBAAiB,CAAA;IAC/B,MAAM,EAAE,iBAAiB,CAAA;CAC1B,CAAA;AAqQD,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,QAAQ,EACd,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC5C,kBAAkB,CA2IpB"}
+{"version":3,"file":"zone-quantities.d.ts","sourceRoot":"","sources":["../../src/lib/zone-quantities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAmC,QAAQ,EAAE,MAAM,WAAW,CAAA;AAuBnF,MAAM,MAAM,iBAAiB,GACzB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAE7C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,cAAc,EAAE,WAAW,GAAG,eAAe,CAAA;IAC7C,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,WAAW,EAAE,iBAAiB,CAAA;IAC9B,YAAY,EAAE,iBAAiB,CAAA;IAC/B,MAAM,EAAE,iBAAiB,CAAA;CAC1B,CAAA;AAsQD,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,QAAQ,EACd,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC5C,kBAAkB,CA0IpB"}

package/dist/lib/zone-quantities.js

@@ -1,9 +1,8 @@
-import { DEFAULT_LEVEL_HEIGHT, resolveCeilingHeight } from '../services/level-height.js';
-import { getWallPlaneTop } from '../services/storey.js';
+import { resolveCeilingHeight } from '../services/level-height.js';
+import { getWallTop } from '../services/storey.js';
 import { computeWallSlabSupport } from '../systems/slab/slab-support.js';
 import { sampleWallCenterline } from '../systems/wall/wall-curve.js';
 import { getWallLocalFaceZ } from '../systems/wall/wall-frame.js';
-import { resolveWallEffectiveHeight } from '../systems/wall/wall-top.js';
 import { levelWallCover } from './plate-surface.js';
 import { area, containsPoint, difference, distanceToBoundary, intersection, union, } from './polygon-boolean.js';
 import { roomFloorPlate } from './room-floor-plate.js';
@@ -111,6 +110,7 @@ function boundaryFaceKey(boundary) {
     const pointKey = (point) => `${point[0].toFixed(6)},${point[1].toFixed(6)}`;
     const forward = boundary.points.map(pointKey).join('|');
     const reverse = [...boundary.points].reverse().map(pointKey).join('|');
+    // biome-ignore lint/complexity/useMathMinMax: lexicographic string comparison
     return `${boundary.wallId}:${boundary.face}:${forward < reverse ? forward : reverse}`;
 }
 function spansFromSpaces(spaces, zone, wallsById) {
@@ -233,8 +233,7 @@ export function deriveZoneQuantityReport(zone, sceneNodes) {
     const slabs = levelNodes.filter((node) => node.type === 'slab');
     const wallEffectiveHeight = (wall) => {
         const support = computeWallSlabSupport(wall, slabs, walls, wall.supportSlabId, undefined, 0, sceneNodes);
-        const planeTop = levelId ? getWallPlaneTop(wall, levelId, sceneNodes) : DEFAULT_LEVEL_HEIGHT;
-        return resolveWallEffectiveHeight(wall, planeTop, support.elevation);
+        return getWallTop(wall, levelId ?? '', sceneNodes, support.elevation) - support.elevation;
     };
     const edgeLengths = [zone.polygon, ...(zone.holes ?? [])].flatMap((ring) => ring.map((start, index) => {
         const end = ring[(index + 1) % ring.length];

package/dist/material-kinds.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The material library's kinds and the surfaces its materials suit, apart from the catalog: an
+ * agent tool's contract names them without loading the library it searches.
+ */
+export declare const MATERIAL_CATEGORIES: readonly ['colors', 'wood', 'stone', 'brick', 'tile', 'wallpaper', 'concrete', 'metal', 'plastic', 'fabric', 'carpet', 'leather', 'roofing', 'ground', 'glass', 'other'];
+export type MaterialCategory = (typeof MATERIAL_CATEGORIES)[number];
+export declare const MATERIAL_SURFACES: readonly ['floor', 'wall', 'ceiling', 'roof', 'furniture', 'outdoor'];
+export type MaterialSurface = (typeof MATERIAL_SURFACES)[number];
+//# sourceMappingURL=material-kinds.d.ts.map

package/dist/material-kinds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-kinds.d.ts","sourceRoot":"","sources":["../src/material-kinds.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,mBAAmB,YAC9B,QAAQ,EACR,MAAM,EACN,OAAO,EACP,OAAO,EACP,MAAM,EACN,WAAW,EACX,UAAU,EACV,OAAO,EACP,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,SAAS,EACT,QAAQ,EACR,OAAO,EACP,OAAO,CACC,CAAA;AACV,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEnE,eAAO,MAAM,iBAAiB,YAC5B,OAAO,EACP,MAAM,EACN,SAAS,EACT,MAAM,EACN,WAAW,EACX,SAAS,CACD,CAAA;AACV,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAA"}

package/dist/material-kinds.js

@@ -0,0 +1,30 @@
+/**
+ * The material library's kinds and the surfaces its materials suit, apart from the catalog: an
+ * agent tool's contract names them without loading the library it searches.
+ */
+export const MATERIAL_CATEGORIES = [
+    'colors',
+    'wood',
+    'stone',
+    'brick',
+    'tile',
+    'wallpaper',
+    'concrete',
+    'metal',
+    'plastic',
+    'fabric',
+    'carpet',
+    'leather',
+    'roofing',
+    'ground',
+    'glass',
+    'other',
+];
+export const MATERIAL_SURFACES = [
+    'floor',
+    'wall',
+    'ceiling',
+    'roof',
+    'furniture',
+    'outdoor',
+];

package/dist/material-library.d.ts

@@ -1,4 +1,6 @@
+import type { MaterialCategory, MaterialSurface } from './material-kinds.js';
 import { type MaterialPresetPayload, type MaterialSchema } from './schema/material.js';
+export { MATERIAL_CATEGORIES, MATERIAL_SURFACES, type MaterialCategory, type MaterialSurface, } from './material-kinds.js';
 export type MaterialSource = 'pascal' | 'community' | 'mine' | 'workspace';
 export type MaterialCatalogItem = {
     id: string;
@@ -16,10 +18,6 @@ export type MaterialCatalogItem = {
     previewColor?: string;
     preset: MaterialPresetPayload;
 };
-export declare const MATERIAL_CATEGORIES: readonly ["colors", "wood", "stone", "brick", "tile", "wallpaper", "concrete", "metal", "plastic", "fabric", "carpet", "leather", "roofing", "ground", "glass", "other"];
-export type MaterialCategory = (typeof MATERIAL_CATEGORIES)[number];
-export declare const MATERIAL_SURFACES: readonly ["floor", "wall", "ceiling", "roof", "furniture", "outdoor"];
-export type MaterialSurface = (typeof MATERIAL_SURFACES)[number];
 export declare const MATERIAL_CATALOG: MaterialCatalogItem[];
 export declare function registerLibraryMaterials(items: MaterialCatalogItem[]): void;
 export declare function unregisterLibraryMaterials(ids: string[]): void;
@@ -27,6 +25,8 @@ export declare function getDynamicLibraryMaterials(): MaterialCatalogItem[];
 export declare function subscribeLibraryMaterials(listener: () => void): () => void;
 export declare function getLibraryMaterialsVersion(): number;
 export declare function getMaterialsForCategory(category: MaterialCategory): MaterialCatalogItem[];
+/** A community material's id (`mtl_…`, as the host's database mints them), well formed. */
+export declare function isCommunityMaterialId(id: string): boolean;
 export declare function getCatalogMaterialById(id?: string): MaterialCatalogItem | undefined;
 export declare const LIBRARY_MATERIAL_REF_PREFIX = "library:";
 export declare const SCENE_MATERIAL_REF_PREFIX = "scene:";

package/dist/material-library.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"material-library.d.ts","sourceRoot":"","sources":["../src/material-library.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,qBAAqB,EAE1B,KAAK,cAAc,EAGpB,MAAM,mBAAmB,CAAA;AAE1B,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,GAAG,WAAW,CAAA;AAE1E,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,2EAA2E;IAC3E,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAA;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,qBAAqB,CAAA;CAC9B,CAAA;AAuCD,eAAO,MAAM,mBAAmB,0KAiBtB,CAAA;AACV,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEnE,eAAO,MAAM,iBAAiB,uEAOpB,CAAA;AACV,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEhE,eAAO,MAAM,gBAAgB,EAAE,mBAAmB,EA2/IjD,CAAA;AAkBD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,mBAAmB,EAAE,GAAG,IAAI,CAM3E;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,CAM9D;AAED,wBAAgB,0BAA0B,IAAI,mBAAmB,EAAE,CAElE;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAK1E;AAED,wBAAgB,0BAA0B,IAAI,MAAM,CAEnD;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,mBAAmB,EAAE,CAMzF;AAED,wBAAgB,sBAAsB,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAGnF;AAED,eAAO,MAAM,2BAA2B,aAAa,CAAA;AACrD,eAAO,MAAM,yBAAyB,WAAW,CAAA;AAEjD,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,UAE9C;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,UAE5C;AAED,wBAAgB,2BAA2B,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,iBAItE;AAED,wBAAgB,yBAAyB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAIpF;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,CAAA;AAEhC,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAA;AAE/F,wBAAgB,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,iBAAiB,GAAG,IAAI,CAM9E;AAID;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAEvE;AAED,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAEhE;AAED,wBAAgB,sBAAsB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,qBAAqB,GAAG,IAAI,CAIhG"}
+{"version":3,"file":"material-library.d.ts","sourceRoot":"","sources":["../src/material-library.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACzE,OAAO,EACL,KAAK,qBAAqB,EAE1B,KAAK,cAAc,EAGpB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAA;AAEzB,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,GAAG,WAAW,CAAA;AAE1E,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,2EAA2E;IAC3E,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAA;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,qBAAqB,CAAA;CAC9B,CAAA;AAuCD,eAAO,MAAM,gBAAgB,EAAE,mBAAmB,EA6jJjD,CAAA;AAkBD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,mBAAmB,EAAE,GAAG,IAAI,CAM3E;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,CAM9D;AAED,wBAAgB,0BAA0B,IAAI,mBAAmB,EAAE,CAElE;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAK1E;AAED,wBAAgB,0BAA0B,IAAI,MAAM,CAEnD;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,mBAAmB,EAAE,CAMzF;AAED,2FAA2F;AAC3F,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,sBAAsB,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAGnF;AAED,eAAO,MAAM,2BAA2B,aAAa,CAAA;AACrD,eAAO,MAAM,yBAAyB,WAAW,CAAA;AAEjD,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,UAE9C;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,UAE5C;AAED,wBAAgB,2BAA2B,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,iBAItE;AAED,wBAAgB,yBAAyB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAIpF;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,CAAA;AAEhC,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAA;AAE/F,wBAAgB,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,iBAAiB,GAAG,IAAI,CAM9E;AAID;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAEvE;AAED,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAEhE;AAED,wBAAgB,sBAAsB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,qBAAqB,GAAG,IAAI,CAIhG"}