@pascal-app/core 1.0.1 → 1.0.4

package/dist/lib/floor-room-faces.d.ts

@@ -0,0 +1,5 @@
+import { type ExtractedRoom } from './room-graph.js';
+import type { BoundaryNode } from './room-topology-index.js';
+export declare function floorRoomFaces(boundaries: BoundaryNode[]): ExtractedRoom[];
+export declare function roomPolygonKey(polygon: readonly (readonly number[])[], holes?: readonly (readonly (readonly number[])[])[]): string;
+//# sourceMappingURL=floor-room-faces.d.ts.map

package/dist/lib/floor-room-faces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"floor-room-faces.d.ts","sourceRoot":"","sources":["../../src/lib/floor-room-faces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAgB,MAAM,cAAc,CAAA;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAIzD,wBAAgB,cAAc,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,aAAa,EAAE,CAmB1E;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,EACvC,KAAK,GAAE,SAAS,CAAC,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC,EAAO,GACtD,MAAM,CAOR"}

package/dist/lib/floor-room-faces.js

@@ -0,0 +1,29 @@
+import { extractRooms } from './room-graph.js';
+const facesByGeometry = new Map();
+export function floorRoomFaces(boundaries) {
+    const ordered = [...boundaries].sort((a, b) => a.id.localeCompare(b.id));
+    const signature = JSON.stringify(ordered.map((boundary) => [
+        boundary.id,
+        boundary.type,
+        boundary.start,
+        boundary.end,
+        boundary.type === 'wall'
+            ? [boundary.curveOffset, boundary.thickness, boundary.justification]
+            : null,
+    ]));
+    const cached = facesByGeometry.get(signature);
+    if (cached)
+        return cached;
+    const faces = extractRooms(ordered);
+    facesByGeometry.set(signature, faces);
+    if (facesByGeometry.size > 64)
+        facesByGeometry.delete(facesByGeometry.keys().next().value);
+    return faces;
+}
+export function roomPolygonKey(polygon, holes = []) {
+    const ring = (points) => points
+        .map(([x, z]) => `${Math.round(x * 1e6)},${Math.round(z * 1e6)}`)
+        .sort()
+        .join(';');
+    return [ring(polygon), ...holes.map(ring).sort()].join('|');
+}

package/dist/lib/floor-step-finish.d.ts

@@ -0,0 +1,49 @@
+import type { ZoneNode } from '../schema/index.js';
+/**
+ * A room's steps — the riser faces where its floor drops to a lower one — are
+ * painted per doorway. Each riser is keyed by what it steps through: the door
+ * (or floor-anchored window) it sits under, else the lower room it looks at.
+ * A riser draws as `step:<ownerZoneId>/<key>`; `step:<ownerZoneId>` alone is
+ * the room scope, every step of the room.
+ *
+ * What a step shows, highest first:
+ *   1. an override for its doorway (`zone.floorStepOverrides`, exact step
+ *      index before the whole doorway)
+ *   2. the owning room's `floorStepFinish`
+ *   3. the owning room's floor finish
+ *
+ * An override belongs to its doorway, not to whichever room is higher. When a
+ * floor edit hands the step to the room on the other side, the override stays
+ * where it was painted and is read through from there, so the step keeps its
+ * colour; the next paint or erase of that step moves or clears it.
+ */
+export type FloorStepOverride = NonNullable<ZoneNode['floorStepOverrides']>[number];
+type StepZone = Pick<ZoneNode, 'id' | 'parentId' | 'floorStepOverrides'>;
+export declare function floorStepRole(zoneId: string, key?: string, step?: number): string;
+export declare function parseFloorStepRole(role: string): {
+    zoneId: string;
+    key: string | null;
+    step: number | null;
+} | null;
+/**
+ * Whether painting `target` paints the step mesh drawn as `role`: the room scope
+ * covers every step of the room, a doorway every step index of that doorway.
+ */
+export declare function floorStepRoleCovers(target: string, role: string): boolean;
+/** The override painting step `key` (`#step`) of `zone`, wherever it is stored. */
+export declare function floorStepOverrideFor<Z extends StepZone>(zone: Z, key: string, step: number | null, zones: readonly Z[]): FloorStepOverride | undefined;
+/** What a step of `zone` keyed `key` draws; `undefined` = the plate's own top. */
+export declare function resolveFloorStepFinish(zone: Pick<ZoneNode, 'id' | 'parentId' | 'floorStepOverrides' | 'floorStepFinish' | 'floor'>, key: string | null, step: number | null, zones: readonly StepZone[]): string | Record<string, unknown> | undefined;
+/**
+ * The rooms that change when step `key` of `owner` is painted (`finish`) or
+ * erased (`undefined`): the doorway's paint is dropped from every holder and,
+ * painting, written on the owner — one colour per doorway. No step index paints
+ * the whole doorway, so its per-step entries go too.
+ */
+export declare function withFloorStepOverride<Z extends StepZone>(owner: Z, key: string, step: number | null, finish: string | undefined, zones: readonly Z[]): Z[];
+/** `zone` without the overrides keyed by `keys` (deleted doors), or null when none go. */
+export declare function withoutFloorStepOverrideKeys<Z extends StepZone>(zone: Z, keys: ReadonlySet<string>): Z | null;
+/** `zone` with override keys naming a retired room renamed to its survivor, or null. */
+export declare function remapFloorStepOverrideKeys<Z extends StepZone>(zone: Z, remap: ReadonlyMap<string, string>): Z | null;
+export {};
+//# sourceMappingURL=floor-step-finish.d.ts.map

package/dist/lib/floor-step-finish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"floor-step-finish.d.ts","sourceRoot":"","sources":["../../src/lib/floor-step-finish.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAEzC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;AACnF,KAAK,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,UAAU,GAAG,oBAAoB,CAAC,CAAA;AAExE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAGjF;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,GACX;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,CAQpE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAOzE;AAwCD,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,QAAQ,EACrD,IAAI,EAAE,CAAC,EACP,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,KAAK,EAAE,SAAS,CAAC,EAAE,GAClB,iBAAiB,GAAG,SAAS,CAM/B;AAED,kFAAkF;AAClF,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,UAAU,GAAG,oBAAoB,GAAG,iBAAiB,GAAG,OAAO,CAAC,EAC5F,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,KAAK,EAAE,SAAS,QAAQ,EAAE,GACzB,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAM9C;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,QAAQ,EACtD,KAAK,EAAE,CAAC,EACR,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,EAAE,SAAS,CAAC,EAAE,GAClB,CAAC,EAAE,CAqBL;AASD,0FAA0F;AAC1F,wBAAgB,4BAA4B,CAAC,CAAC,SAAS,QAAQ,EAC7D,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GACxB,CAAC,GAAG,IAAI,CAOV;AAED,wFAAwF;AACxF,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,QAAQ,EAC3D,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,CAAC,GAAG,IAAI,CAYV"}

package/dist/lib/floor-step-finish.js

@@ -0,0 +1,128 @@
+export function floorStepRole(zoneId, key, step) {
+    if (!key)
+        return `step:${zoneId}`;
+    return step === undefined ? `step:${zoneId}/${key}` : `step:${zoneId}/${key}#${step}`;
+}
+export function parseFloorStepRole(role) {
+    const match = /^step:([^/#]+)(?:\/([^/#]+)(?:#(\d+))?)?$/.exec(role);
+    if (!match)
+        return null;
+    return {
+        zoneId: match[1],
+        key: match[2] ?? null,
+        step: match[3] === undefined ? null : Number(match[3]),
+    };
+}
+/**
+ * Whether painting `target` paints the step mesh drawn as `role`: the room scope
+ * covers every step of the room, a doorway every step index of that doorway.
+ */
+export function floorStepRoleCovers(target, role) {
+    if (target === role)
+        return true;
+    const wide = parseFloorStepRole(target);
+    const mesh = parseFloorStepRole(role);
+    if (!(wide && mesh) || wide.zoneId !== mesh.zoneId)
+        return false;
+    if (!wide.key)
+        return true;
+    return wide.key === mesh.key && wide.step === null;
+}
+/**
+ * Every (room, key) pair that stores paint for the doorway `key` of `zone`'s
+ * steps: the owner itself, and whoever stored it before the owner changed — for
+ * a door, any other room keyed by the same door; for a step keyed by the lower
+ * room, that room keyed back by the owner.
+ */
+function doorwayHolders(zone, key, zones) {
+    const siblings = zones
+        .filter((other) => other.id !== zone.id && other.parentId === zone.parentId)
+        .sort((a, b) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
+    const lower = siblings.find((other) => other.id === key);
+    if (lower)
+        return [
+            { zone, key },
+            { zone: lower, key: zone.id },
+        ];
+    if (zones.some((other) => other.id === key))
+        return [{ zone, key }];
+    return [{ zone, key }, ...siblings.map((other) => ({ zone: other, key }))];
+}
+function pick(overrides, key, step) {
+    if (!overrides?.length)
+        return undefined;
+    return ((step === null
+        ? undefined
+        : overrides.find((entry) => entry.key === key && entry.step === step)) ??
+        overrides.find((entry) => entry.key === key && entry.step === undefined));
+}
+/** The override painting step `key` (`#step`) of `zone`, wherever it is stored. */
+export function floorStepOverrideFor(zone, key, step, zones) {
+    for (const holder of doorwayHolders(zone, key, zones)) {
+        const found = pick(holder.zone.floorStepOverrides, holder.key, step);
+        if (found)
+            return found;
+    }
+    return undefined;
+}
+/** What a step of `zone` keyed `key` draws; `undefined` = the plate's own top. */
+export function resolveFloorStepFinish(zone, key, step, zones) {
+    return ((key ? floorStepOverrideFor(zone, key, step, zones)?.finish : undefined) ??
+        zone.floorStepFinish ??
+        zone.floor?.finish);
+}
+/**
+ * The rooms that change when step `key` of `owner` is painted (`finish`) or
+ * erased (`undefined`): the doorway's paint is dropped from every holder and,
+ * painting, written on the owner — one colour per doorway. No step index paints
+ * the whole doorway, so its per-step entries go too.
+ */
+export function withFloorStepOverride(owner, key, step, finish, zones) {
+    const changed = new Map();
+    for (const holder of doorwayHolders(owner, key, zones)) {
+        const current = holder.zone.floorStepOverrides ?? [];
+        const kept = current.filter((entry) => entry.key !== holder.key || (step !== null && entry.step !== step));
+        if (kept.length !== current.length)
+            changed.set(holder.zone.id, withOverrides(holder.zone, kept));
+    }
+    if (finish !== undefined) {
+        const base = changed.get(owner.id) ?? owner;
+        changed.set(owner.id, withOverrides(base, [
+            ...(base.floorStepOverrides ?? []),
+            { key, ...(step === null ? {} : { step }), finish },
+        ]));
+    }
+    return [...changed.values()];
+}
+function withOverrides(zone, overrides) {
+    const next = { ...zone };
+    if (overrides.length)
+        next.floorStepOverrides = overrides;
+    else
+        delete next.floorStepOverrides;
+    return next;
+}
+/** `zone` without the overrides keyed by `keys` (deleted doors), or null when none go. */
+export function withoutFloorStepOverrideKeys(zone, keys) {
+    const current = zone.floorStepOverrides;
+    if (!current?.some((entry) => keys.has(entry.key)))
+        return null;
+    return withOverrides(zone, current.filter((entry) => !keys.has(entry.key)));
+}
+/** `zone` with override keys naming a retired room renamed to its survivor, or null. */
+export function remapFloorStepOverrideKeys(zone, remap) {
+    const current = zone.floorStepOverrides;
+    if (!current?.some((entry) => remap.has(entry.key)))
+        return null;
+    const byKey = new Map();
+    for (const entry of current) {
+        const key = remap.get(entry.key) ?? entry.key;
+        if (key === zone.id)
+            continue;
+        const id = `${key}#${entry.step ?? ''}`;
+        // An entry already under the survivor's key was painted on that step itself.
+        if (!byKey.has(id) || !remap.has(entry.key))
+            byKey.set(id, { ...entry, key });
+    }
+    return withOverrides(zone, [...byKey.values()]);
+}

package/dist/lib/geometry-script-node.d.ts

@@ -0,0 +1,82 @@
+import type { CompiledGeometryScript } from '../schema/index.js';
+import { GeometrySourceMeta } from '../schema/geometry-metadata.js';
+import type { ColumnNode } from '../schema/nodes/column.js';
+import type { DoorNode } from '../schema/nodes/door.js';
+import type { ItemNode } from '../schema/nodes/item.js';
+import type { WindowNode } from '../schema/nodes/window.js';
+/** A node built from a script: an authored item, or a window, door or column with a script source. */
+export type ScriptedNode = (ItemNode | WindowNode | DoorNode | ColumnNode) & {
+    source: NonNullable<ItemNode['source']>;
+};
+export declare const isScriptedNode: (node: {
+    type: string;
+    source?: unknown;
+} | undefined) => node is ScriptedNode;
+/**
+ * Merges reuse metadata into a source's, dropping `meta` when nothing is left:
+ * the scene carries no empty object.
+ */
+export declare function withSourceMeta<S extends {
+    meta?: GeometrySourceMeta;
+}>(source: S, next: object, parent?: string): S;
+/** The `source` a compile produces, the same on every kind. */
+export declare const scriptSource: (compiled: CompiledGeometryScript, meta?: object, previous?: ScriptedNode["source"]) => {
+    kind: "script";
+    meta: {
+        description?: string | undefined;
+        category?: string | undefined;
+        tags?: string[] | undefined;
+        parent?: string | undefined;
+    } | undefined;
+    language: "three" | "bpy";
+    script: string;
+    params: Record<string, string | number | boolean>;
+    artifact: string;
+    manifest: any;
+};
+/**
+ * What a scripted object is, for reuse, whatever its kind: the name from the
+ * node, an item's category from its asset, the rest from `source.meta`.
+ */
+export declare function scriptedObjectMeta(node: ScriptedNode): {
+    name: string | undefined;
+    description: string | undefined;
+    category: string | undefined;
+    tags: string[] | undefined;
+    parent: string | undefined;
+};
+/**
+ * A scripted node's thumbnail and floor-plan image as `artifact://` URLs, or
+ * null until an editor has taken them of the GLB the node shows now.
+ */
+export declare function scriptImages(node: {
+    type: string;
+    source?: unknown;
+} | undefined): {
+    thumbnail: string;
+    floorPlan: string;
+} | null;
+type Manifest = CompiledGeometryScript['manifest'];
+/**
+ * Paint and automatic matching write the same overrides. A rebuild keeps every
+ * pick, but a slot still holding what the previous build matched is matched
+ * again, so a script edit to that finish shows.
+ */
+export declare function matchScriptSlotsToLibrary(manifest: Manifest, overrides?: Record<string, string>, previous?: Manifest): Record<string, string>;
+/** Width, height and depth of what the script built. */
+export declare function scriptedSize(manifest: CompiledGeometryScript['manifest']): [number, number, number];
+/**
+ * Where the script's origin (the bottom centre of what it built) sits in the
+ * node's own frame: a window or door is placed by its centre.
+ */
+export declare function scriptedOrigin(node: ScriptedNode): [number, number, number];
+/**
+ * The item's controls from what the module emitted: a light switch for its
+ * lights, an open/close toggle for an `open` clip (closing plays `close`, or
+ * `open` reversed), a `loop` clip that runs throughout, and a play toggle per
+ * other clip, labelled with its name. Light offsets are in the node's frame,
+ * `origin` being where the script's origin sits in it (`scriptedOrigin`).
+ */
+export declare function scriptInteractive(manifest: CompiledGeometryScript['manifest'], origin?: [number, number, number]): ItemNode['asset']['interactive'];
+export {};
+//# sourceMappingURL=geometry-script-node.d.ts.map

package/dist/lib/geometry-script-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry-script-node.d.ts","sourceRoot":"","sources":["../../src/lib/geometry-script-node.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAA;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAGxD,sGAAsG;AACtG,MAAM,MAAM,YAAY,GAAG,CAAC,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC,GAAG;IAC3E,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAA;CACxC,CAAA;AAED,eAAO,MAAM,cAAc,GACzB,MAAM;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,KACnD,IAAI,IAAI,YAKiB,CAAA;AAE5B;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS;IAAE,IAAI,CAAC,EAAE,kBAAkB,CAAA;CAAE,EACpE,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,GACd,CAAC,CAUH;AAED,+DAA+D;AAC/D,eAAO,MAAM,YAAY,GACvB,UAAU,sBAAsB,EAChC,OAAM,MAAW,EACjB,WAAW,YAAY,CAAC,QAAQ,CAAC;;;;;;;;;;;;;CAgBhC,CAAA;AAEH;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY;;;;;;EASpD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,GACnD;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAKjD;AAED,KAAK,QAAQ,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAA;AAKlD;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,QAAQ,EAClB,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACtC,QAAQ,CAAC,EAAE,QAAQ,GAClB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYxB;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,sBAAsB,CAAC,UAAU,CAAC,GAC3C,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAG1B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAG3E;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,sBAAsB,CAAC,UAAU,CAAC,EAC5C,MAAM,GAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAa,GAC3C,QAAQ,CAAC,OAAO,CAAC,CAAC,aAAa,CAAC,CA0ClC"}

package/dist/lib/geometry-script-node.js

@@ -0,0 +1,147 @@
+import { matchPascalMaterial } from '../procedural-items/library-colors.js';
+import { GeometrySourceMeta } from '../schema/geometry-metadata.js';
+import { artifactUrl } from './artifact-store.js';
+export const isScriptedNode = (node) => Boolean(node?.source) &&
+    (node.type === 'item' ||
+        node.type === 'window' ||
+        node.type === 'door' ||
+        node.type === 'column');
+/**
+ * Merges reuse metadata into a source's, dropping `meta` when nothing is left:
+ * the scene carries no empty object.
+ */
+export function withSourceMeta(source, next, parent) {
+    const { meta: previous, ...rest } = source;
+    const meta = GeometrySourceMeta.parse({
+        ...previous,
+        ...Object.fromEntries(Object.entries(GeometrySourceMeta.parse(next)).filter(([, value]) => value !== undefined)),
+        ...(parent ? { parent } : {}),
+    });
+    return (Object.keys(meta).length > 0 ? { ...rest, meta } : rest);
+}
+/** The `source` a compile produces, the same on every kind. */
+export const scriptSource = (compiled, meta = {}, previous) => withSourceMeta({
+    kind: 'script',
+    meta: previous?.meta,
+    language: compiled.language,
+    script: compiled.script,
+    params: compiled.params,
+    artifact: compiled.sha256,
+    // Worker structured clones retain optional undefined fields; durable scene writes are JSON.
+    manifest: JSON.parse(JSON.stringify(compiled.manifest)),
+}, meta, 
+// A params-only rebuild runs the same script: its lineage stays where it was.
+previous && previous.script !== compiled.script ? previous.script : undefined);
+/**
+ * What a scripted object is, for reuse, whatever its kind: the name from the
+ * node, an item's category from its asset, the rest from `source.meta`.
+ */
+export function scriptedObjectMeta(node) {
+    const { description, category, tags, parent } = node.source.meta ?? {};
+    return {
+        name: node.name,
+        description,
+        category: node.type === 'item' ? node.asset.category : category,
+        tags,
+        parent,
+    };
+}
+/**
+ * A scripted node's thumbnail and floor-plan image as `artifact://` URLs, or
+ * null until an editor has taken them of the GLB the node shows now.
+ */
+export function scriptImages(node) {
+    if (!isScriptedNode(node))
+        return null;
+    const { images, artifact } = node.source;
+    if (images?.artifact !== artifact)
+        return null;
+    return { thumbnail: artifactUrl(images.thumbnail), floorPlan: artifactUrl(images.floorPlan) };
+}
+const matchSlot = (slot) => matchPascalMaterial({ ...slot, name: `${slot.id} ${slot.label ?? ''}` });
+/**
+ * Paint and automatic matching write the same overrides. A rebuild keeps every
+ * pick, but a slot still holding what the previous build matched is matched
+ * again, so a script edit to that finish shows.
+ */
+export function matchScriptSlotsToLibrary(manifest, overrides = {}, previous) {
+    const slots = { ...overrides };
+    for (const slot of manifest.slots) {
+        if (Object.hasOwn(overrides, slot.id)) {
+            const before = previous?.slots.find((candidate) => candidate.id === slot.id);
+            if (!before || overrides[slot.id] !== matchSlot(before))
+                continue;
+            delete slots[slot.id];
+        }
+        const ref = matchSlot(slot);
+        if (ref)
+            slots[slot.id] = ref;
+    }
+    return slots;
+}
+/** Width, height and depth of what the script built. */
+export function scriptedSize(manifest) {
+    const { min, max } = manifest.bounds;
+    return [max[0] - min[0], max[1] - min[1], max[2] - min[2]];
+}
+/**
+ * Where the script's origin (the bottom centre of what it built) sits in the
+ * node's own frame: a window or door is placed by its centre.
+ */
+export function scriptedOrigin(node) {
+    if (node.type !== 'window' && node.type !== 'door')
+        return [0, 0, 0];
+    return [0, -scriptedSize(node.source.manifest)[1] / 2, 0];
+}
+/**
+ * The item's controls from what the module emitted: a light switch for its
+ * lights, an open/close toggle for an `open` clip (closing plays `close`, or
+ * `open` reversed), a `loop` clip that runs throughout, and a play toggle per
+ * other clip, labelled with its name. Light offsets are in the node's frame,
+ * `origin` being where the script's origin sits in it (`scriptedOrigin`).
+ */
+export function scriptInteractive(manifest, origin = [0, 0, 0]) {
+    const controls = [];
+    const effects = [];
+    if (manifest.lights.length > 0) {
+        controls.push({ kind: 'toggle', label: 'Lights', default: true });
+        for (const light of manifest.lights) {
+            effects.push({
+                kind: 'light',
+                color: light.color,
+                intensityRange: [0, light.intensity],
+                distance: light.distance,
+                offset: [
+                    light.position[0] + origin[0],
+                    light.position[1] + origin[1],
+                    light.position[2] + origin[2],
+                ],
+            });
+        }
+    }
+    const clip = (name) => manifest.animations.some((animation) => animation.name === name);
+    if (clip('open')) {
+        effects.push({
+            kind: 'animation',
+            mode: 'open-close',
+            control: controls.length,
+            clips: { on: 'open', off: clip('close') ? 'close' : undefined },
+        });
+        controls.push({ kind: 'toggle', label: 'Open', default: false });
+    }
+    if (clip('loop'))
+        effects.push({ kind: 'animation', mode: 'ambient', clips: { loop: 'loop' } });
+    // Every other clip gets its own play toggle, labelled with its name.
+    for (const { name } of manifest.animations) {
+        if (name === 'open' || name === 'close' || name === 'loop')
+            continue;
+        effects.push({
+            kind: 'animation',
+            mode: 'ambient',
+            control: controls.length,
+            clips: { on: name },
+        });
+        controls.push({ kind: 'toggle', label: name, default: false });
+    }
+    return effects.length > 0 ? { controls, effects } : undefined;
+}

package/dist/lib/geometry-surfaces.d.ts

@@ -0,0 +1,61 @@
+import type { GeometryArtifactManifest } from '../schema/geometry-source.js';
+type Surface = GeometryArtifactManifest['surfaces'][number];
+type Manifest = Pick<GeometryArtifactManifest, 'surfaces' | 'parts'>;
+/**
+ * Where something dropped at local (x, z) comes to rest on an authored
+ * object: its main surface when the point is over it (a bench anywhere on a
+ * porch lands on the landing, not on the beam), otherwise the highest
+ * non-roof surface under the point. `maxY` caps the search. Null when
+ * nothing is under the point.
+ */
+export declare function geometrySurfaceAt(manifest: Manifest & Pick<GeometryArtifactManifest, 'bounds'>, x: number, z: number, maxY?: number): Surface | null;
+/**
+ * The one height an authored object offers as "where things rest" (the
+ * item's `asset.surface`): its highest main surface, so a porch rests things
+ * on its landing and a table on its top. Null when it has none.
+ */
+export declare function geometryRestingHeight(manifest: Manifest & Pick<GeometryArtifactManifest, 'bounds'>): number | null;
+/**
+ * Where a ceiling item hangs from an authored object above local (x, z): the
+ * lowest underside over the point (a beam before the vault plane above it),
+ * with its height there — sloped undersides included. Null when none is over it.
+ */
+export declare function geometryUndersideAt(manifest: Pick<GeometryArtifactManifest, 'undersides'>, x: number, z: number): {
+    part?: string;
+    y: number;
+    normal: [number, number, number];
+} | null;
+/**
+ * The rotation that seats a flush fixture (a recessed can) on a sloped
+ * underside: its +Y goes into the surface, against the downward `normal`,
+ * then it keeps its own turn `yaw`. Euler XYZ, as items store rotation.
+ */
+export declare function flushMountRotation(normal: readonly [number, number, number], yaw: number): [number, number, number];
+/**
+ * Whether a ceiling fixture sits flush on a surface (tilting with a slope)
+ * rather than hanging plumb: flagged `recessed`, or shallow enough that it
+ * can only be a can or a surface light (catalog data often lacks the flag).
+ */
+export declare function mountsFlush(asset: {
+    recessed?: boolean;
+    dimensions?: readonly number[];
+}): boolean;
+/** The closest point to (x, z) inside a convex outline (itself when inside). */
+export declare function nearestPointIn(polygon: readonly [number, number][], x: number, z: number): [number, number];
+/**
+ * Where a child item of an authored object sits after the object is rebuilt:
+ * a resting item back on the surface under it (moved onto the main surface
+ * when that shrank away from it), a hanging one from the underside above it.
+ * Positions are in the object's frame; `scale` is the object's. Null when
+ * nothing applies (wall-mounted children, objects without surfaces).
+ */
+export declare function resettledPosition(manifest: Pick<GeometryArtifactManifest, 'surfaces' | 'undersides' | 'parts' | 'bounds'>, child: {
+    position: readonly [number, number, number];
+    asset: {
+        attachTo?: string;
+        recessed?: boolean;
+        dimensions?: readonly number[];
+    };
+}, scale: readonly [number, number, number]): [number, number, number] | null;
+export {};
+//# sourceMappingURL=geometry-surfaces.d.ts.map

package/dist/lib/geometry-surfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry-surfaces.d.ts","sourceRoot":"","sources":["../../src/lib/geometry-surfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAA;AAEzE,KAAK,OAAO,GAAG,wBAAwB,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAA;AAC3D,KAAK,QAAQ,GAAG,IAAI,CAAC,wBAAwB,EAAE,UAAU,GAAG,OAAO,CAAC,CAAA;AAyCpE;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC,wBAAwB,EAAE,QAAQ,CAAC,EAC7D,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,IAAI,SAA2B,GAC9B,OAAO,GAAG,IAAI,CAMhB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC,wBAAwB,EAAE,QAAQ,CAAC,GAC5D,MAAM,GAAG,IAAI,CAEf;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,IAAI,CAAC,wBAAwB,EAAE,YAAY,CAAC,EACtD,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,IAAI,CASvE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACzC,GAAG,EAAE,MAAM,GACV,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAoB1B;AAKD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC/B,GAAG,OAAO,CAEV;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAC5B,OAAO,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EACpC,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR,CAAC,MAAM,EAAE,MAAM,CAAC,CAmBlB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,IAAI,CAAC,wBAAwB,EAAE,UAAU,GAAG,YAAY,GAAG,OAAO,GAAG,QAAQ,CAAC,EACxF,KAAK,EAAE;IACL,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAC3C,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAA;CACjF,EACD,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GACvC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAiBjC"}