@pascal-app/core 1.1.0 → 1.1.1

package/dist/lib/asset-storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"asset-storage.d.ts","sourceRoot":"","sources":["../../src/lib/asset-storage.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,YAAY,gBAAgB,CAAA;AAQzC;;GAEG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAI3D;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoCtE"}
+{"version":3,"file":"asset-storage.d.ts","sourceRoot":"","sources":["../../src/lib/asset-storage.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,YAAY,gBAAgB,CAAA;AAQzC;;GAEG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAI3D;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqCtE"}

package/dist/lib/asset-storage.js

@@ -1,5 +1,6 @@
 import { get, set } from 'idb-keyval';
 import { customAlphabet } from 'nanoid';
+import { isSchemeRelativeUrl } from '../schema/asset-url.js';
 import { ARTIFACT_URL_PREFIX, resolveArtifactUrl } from './artifact-store.js';
 export const ASSET_PREFIX = 'asset_data:';
 // Cache for active object URLs to prevent leaks and flickering
@@ -21,6 +22,8 @@ export async function saveAsset(file) {
 export async function loadAssetUrl(url) {
     if (!url)
         return null;
+    if (isSchemeRelativeUrl(url))
+        return null;
     // If it's already a blob or http URL, return as is
     if (url.startsWith('blob:') || url.startsWith('http')) {
         return url;

package/dist/lib/floor-foundation-datum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"floor-foundation-datum.d.ts","sourceRoot":"","sources":["../../src/lib/floor-foundation-datum.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAclD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACxC,KAAK,EAAE,QAAQ,GACd,MAAM,CAER;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACxC,KAAK,EAAE,QAAQ,GACd,MAAM,CA+BR;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACxC,KAAK,EAAE,QAAQ,GACd,WAAW,GAAG,gBAAgB,CA+BhC;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACxC,KAAK,EAAE,QAAQ,GACd,OAAO,CAMT;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACxC,KAAK,EAAE,QAAQ,GACd,OAAO,CAET;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACxC,KAAK,EAAE,QAAQ,GACd;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,CAK7E;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACxC,KAAK,EAAE,QAAQ,GACd,MAAM,CAER;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,GAAG,MAAM,CAM/F;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACxC,KAAK,EAAE,QAAQ,EACf,SAAS,GAAE,MAA6C,GACvD;IACD,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5B,MAAM,CAAC,EAAE,aAAa,CAAA;CACvB,GAAG,IAAI,CAYP;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACxC,IAAI,EAAE,OAAO,EACb,YAAY,EAAE,MAAM,GACnB,MAAM,CAUR;AAID,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACvC,OAAO,CAgBT"}
+{"version":3,"file":"floor-foundation-datum.d.ts","sourceRoot":"","sources":["../../src/lib/floor-foundation-datum.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAclD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACxC,KAAK,EAAE,QAAQ,GACd,MAAM,CAER;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACxC,KAAK,EAAE,QAAQ,GACd,MAAM,CA+BR;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACxC,KAAK,EAAE,QAAQ,GACd,WAAW,GAAG,gBAAgB,CA+BhC;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACxC,KAAK,EAAE,QAAQ,GACd,OAAO,CAMT;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACxC,KAAK,EAAE,QAAQ,GACd,OAAO,CAET;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACxC,KAAK,EAAE,QAAQ,GACd;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,CAK7E;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACxC,KAAK,EAAE,QAAQ,GACd,MAAM,CAER;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,GAAG,MAAM,CAM/F;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACxC,KAAK,EAAE,QAAQ,EACf,SAAS,GAAE,MAA6C,GACvD;IACD,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5B,MAAM,CAAC,EAAE,aAAa,CAAA;CACvB,GAAG,IAAI,CAYP;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACxC,IAAI,EAAE,OAAO,EACb,YAAY,EAAE,MAAM,GACnB,MAAM,CAUR;AAID,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACvC,OAAO,CAgBT"}

package/dist/lib/floor-foundation-datum.js

@@ -1,3 +1,4 @@
+import { roofFaceShapes } from '../registry/roofs.js';
 import { DEFAULT_SLAB_ELEVATION, MIN_SLAB_THICKNESS } from '../schema/nodes/slab.js';
 import { wallOverlapsSlabFootprint } from '../systems/slab/slab-support.js';
 import { getWallArcData } from '../systems/wall/wall-curve.js';
@@ -199,8 +200,11 @@ function computeFootprintSupport(base, node, nodes) {
         const segments = node.children
             .map((id) => nodes[id])
             .filter((segment) => segment?.type === 'roof-segment');
-        if (!segments.length)
+        const faces = roofFaceShapes(node, nodes);
+        if (!segments.length && !faces.length)
             return containsPoint([{ outer: base.polygon, holes: base.holes ?? [] }], [node.position[0], node.position[2]]);
+        if (faces.some((face) => polygonsOverlap(base, face.outline)))
+            return true;
         return segments.some((segment) => {
             if (segment.type !== 'roof-segment')
                 return false;

package/dist/lib/floorplan/context.d.ts

@@ -0,0 +1,95 @@
+import type { FloorplanGeometry, FloorplanPalette, GeometryContext } from '../../registry/types.js';
+import type { AnyNode } from '../../schema/index.js';
+/** The `def.floorplan` contract every plan host shares: context extensions and geometry metadata. */
+export declare const FLOORPLAN_GEOMETRY_METADATA_KEY = "pascal:editor/floorplan";
+export declare const FLOORPLAN_CONTEXT_EXTENSION_KEY = "pascal:editor/floorplan";
+export type FloorplanRenderPurpose = 'edit' | 'document';
+export type FloorplanMetricNotation = 'meters' | 'millimeters';
+/**
+ * Display → Measure walls: which finished faces wall dimensions measure to —
+ * the interior faces (ID, the room sizes), the exterior faces (OD, the
+ * outside size) or both. Read by a selected wall's temporary dimensions in 2D
+ * and 3D and by the Expert plan's automatic dimension strings.
+ */
+export type FloorplanWallDimensionFaces = 'interior' | 'exterior' | 'both';
+export declare const DEFAULT_FLOORPLAN_WALL_DIMENSION_FACES: FloorplanWallDimensionFaces;
+export declare function normalizeFloorplanWallDimensionFaces(value: unknown): FloorplanWallDimensionFaces;
+export type FloorplanAnnotationRole = 'automatic-dimension' | 'contextual-dimension' | 'manual-dimension' | 'measurement' | 'opening-mark' | 'structural-grid' | 'column-center' | 'room-label'
+/** A room's finish / ceiling-height lines — detail under the name, off in the clean plan. */
+ | 'room-detail'
+/** The roof plan proper: outline, ridges, hips, slope arrows. Off over a floor plan unless asked. */
+ | 'roof-plan' | 'roof-pitch' | 'stair-annotation';
+export type FloorplanSchedule = {
+    id: string;
+    title: string;
+    columns: ReadonlyArray<{
+        key: string;
+        label: string;
+        weight?: number;
+    }>;
+    rows: ReadonlyArray<{
+        id: string;
+        cells: Readonly<Record<string, string>>;
+    }>;
+    issues?: readonly string[];
+};
+type FloorplanGeometryMetadata = {
+    annotationRole?: FloorplanAnnotationRole;
+    annotationObstacle?: 'bounds' | 'outline';
+    renderPass?: 'overlay';
+    /**
+     * Annotation text only: the size to print at, in paper points, instead of
+     * the size its role implies. Lets a sheet set a room tag's name larger than
+     * its number without inventing a role per size.
+     */
+    textSizePt?: number;
+};
+type FloorplanContextExtension = {
+    automaticDimensions: boolean;
+    purpose: FloorplanRenderPurpose;
+    /**
+     * Sheet drafting (the Sheets plan viewports): kinds draw the permit-set
+     * convention — fixtures as labelled linework, furniture as light outlines,
+     * no raster sprites. Only `collectSheetGeometry` sets it; the editor and the
+     * read-only viewer never do, so their plans keep today's look.
+     */
+    drafting: boolean;
+    /**
+     * The editor canvas draws room labels as screen pills over the plan
+     * (`RoomLabels2D`), so zones skip their drawn tags and wash there. Exports,
+     * sheets and the read-only viewer keep the drawn tags.
+     */
+    roomLabelOverlay: boolean;
+    metricNotation: FloorplanMetricNotation;
+    wallDimensionFaces: FloorplanWallDimensionFaces;
+};
+export declare function floorplanGeometryMetadata(values: FloorplanGeometryMetadata): Readonly<Record<string, unknown>>;
+export declare function withFloorplanGeometryMetadata<T extends FloorplanGeometry | null>(geometry: T, values: FloorplanGeometryMetadata): T;
+export declare function readFloorplanGeometryMetadata(geometry: unknown): FloorplanGeometryMetadata;
+export declare function isFloorplanAnnotationObstacleGeometry(geometry: FloorplanGeometry): boolean;
+export declare function floorplanAnnotationObstacleMode(geometry: FloorplanGeometry): 'bounds' | 'outline' | '' | undefined;
+export declare function createFloorplanContextExtensions(values: Partial<FloorplanContextExtension>): Readonly<Record<string, unknown>>;
+export declare function readFloorplanContext(ctx: GeometryContext): FloorplanContextExtension;
+export declare function readFloorplanMetricNotationOverride(ctx: GeometryContext): FloorplanMetricNotation | undefined;
+export type FloorplanViewState = {
+    automaticDimensions?: boolean;
+    selected: boolean;
+    unit: 'metric' | 'imperial';
+    metricNotation?: 'meters' | 'millimeters';
+    purpose?: 'edit' | 'document';
+    /** Sheet drafting conventions (see `FloorplanContextExtension.drafting`). */
+    drafting?: boolean;
+    /** Room labels drawn as screen pills (see `FloorplanContextExtension.roomLabelOverlay`). */
+    roomLabelOverlay?: boolean;
+    wallDimensionFaces?: FloorplanWallDimensionFaces;
+    highlighted: boolean;
+    hovered: boolean;
+    moving: boolean;
+    focusedUnitId?: string;
+    focusedUnitMemberIds?: readonly string[];
+    palette: FloorplanPalette | undefined;
+};
+export declare function buildFloorplanContext(node: AnyNode, nodes: Record<string, AnyNode>, viewState: FloorplanViewState, levelData?: unknown): GeometryContext;
+export declare function floorplanLayerRank(type: string): number;
+export {};
+//# sourceMappingURL=context.d.ts.map

package/dist/lib/floorplan/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/lib/floorplan/context.ts"],"names":[],"mappings":"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"}

package/dist/lib/floorplan/context.js

@@ -0,0 +1,155 @@
+/** The `def.floorplan` contract every plan host shares: context extensions and geometry metadata. */
+export const FLOORPLAN_GEOMETRY_METADATA_KEY = 'pascal:editor/floorplan';
+export const FLOORPLAN_CONTEXT_EXTENSION_KEY = 'pascal:editor/floorplan';
+export const DEFAULT_FLOORPLAN_WALL_DIMENSION_FACES = 'both';
+export function normalizeFloorplanWallDimensionFaces(value) {
+    return value === 'interior' || value === 'exterior'
+        ? value
+        : DEFAULT_FLOORPLAN_WALL_DIMENSION_FACES;
+}
+export function floorplanGeometryMetadata(values) {
+    return { [FLOORPLAN_GEOMETRY_METADATA_KEY]: values };
+}
+export function withFloorplanGeometryMetadata(geometry, values) {
+    if (!geometry)
+        return geometry;
+    const existing = readFloorplanGeometryMetadata(geometry);
+    return {
+        ...geometry,
+        metadata: floorplanGeometryMetadata({ ...existing, ...values }),
+    };
+}
+export function readFloorplanGeometryMetadata(geometry) {
+    const metadata = geometry?.metadata;
+    const value = metadata?.[FLOORPLAN_GEOMETRY_METADATA_KEY];
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : {};
+}
+export function isFloorplanAnnotationObstacleGeometry(geometry) {
+    if (floorplanAnnotationObstacleMode(geometry))
+        return true;
+    if (geometry.kind !== 'group')
+        return false;
+    const hasPlate = geometry.children.some((child) => child.kind === 'rect' || child.kind === 'circle');
+    const hasUprightText = geometry.children.some((child) => child.kind === 'text' && child.upright);
+    return hasPlate && hasUprightText;
+}
+export function floorplanAnnotationObstacleMode(geometry) {
+    const metadata = readFloorplanGeometryMetadata(geometry);
+    if (metadata.annotationObstacle)
+        return metadata.annotationObstacle;
+    switch (metadata.annotationRole) {
+        case 'room-label':
+            return geometry.kind === 'text' ? 'bounds' : undefined;
+        case 'column-center':
+            return geometry.kind === 'line' || geometry.kind === 'text' ? 'bounds' : undefined;
+        case 'stair-annotation':
+            return geometry.kind === 'polyline' || geometry.kind === 'line' ? 'outline' : 'bounds';
+        default:
+            return undefined;
+    }
+}
+export function createFloorplanContextExtensions(values) {
+    return {
+        [FLOORPLAN_CONTEXT_EXTENSION_KEY]: {
+            automaticDimensions: values.automaticDimensions !== false,
+            purpose: values.purpose === 'document' ? 'document' : 'edit',
+            drafting: values.drafting === true,
+            roomLabelOverlay: values.roomLabelOverlay === true,
+            metricNotation: values.metricNotation === 'millimeters' ? 'millimeters' : 'meters',
+            wallDimensionFaces: normalizeFloorplanWallDimensionFaces(values.wallDimensionFaces),
+        },
+    };
+}
+export function readFloorplanContext(ctx) {
+    const value = ctx.extensions?.[FLOORPLAN_CONTEXT_EXTENSION_KEY];
+    if (value && typeof value === 'object' && !Array.isArray(value)) {
+        const extension = value;
+        return {
+            automaticDimensions: extension.automaticDimensions !== false,
+            purpose: extension.purpose === 'document' ? 'document' : 'edit',
+            drafting: extension.drafting === true,
+            roomLabelOverlay: extension.roomLabelOverlay === true,
+            metricNotation: extension.metricNotation === 'millimeters' ? 'millimeters' : 'meters',
+            wallDimensionFaces: normalizeFloorplanWallDimensionFaces(extension.wallDimensionFaces),
+        };
+    }
+    return {
+        automaticDimensions: true,
+        purpose: 'edit',
+        drafting: false,
+        roomLabelOverlay: false,
+        metricNotation: 'meters',
+        wallDimensionFaces: DEFAULT_FLOORPLAN_WALL_DIMENSION_FACES,
+    };
+}
+export function readFloorplanMetricNotationOverride(ctx) {
+    const value = ctx.extensions?.[FLOORPLAN_CONTEXT_EXTENSION_KEY];
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return undefined;
+    const metricNotation = value.metricNotation;
+    return metricNotation === 'meters' || metricNotation === 'millimeters'
+        ? metricNotation
+        : undefined;
+}
+export function buildFloorplanContext(node, nodes, viewState, levelData) {
+    const resolve = (id) => nodes[id];
+    const childIds = node.children;
+    const children = Array.isArray(childIds)
+        ? childIds.map((id) => nodes[id]).filter((child) => child !== undefined)
+        : [];
+    const parentId = node.parentId;
+    const parent = parentId ? (nodes[parentId] ?? null) : null;
+    let siblings = [];
+    if (parent) {
+        const parentChildIds = parent.children;
+        siblings = Array.isArray(parentChildIds)
+            ? parentChildIds
+                .filter((id) => id !== node.id)
+                .map((id) => nodes[id])
+                .filter((sibling) => sibling?.type === node.type)
+            : Object.values(nodes).filter((candidate) => candidate.id !== node.id &&
+                candidate.type === node.type &&
+                candidate.parentId === node.parentId);
+    }
+    return {
+        resolve,
+        children,
+        siblings,
+        parent,
+        levelData,
+        sceneNodes: nodes,
+        extensions: createFloorplanContextExtensions({
+            automaticDimensions: viewState.automaticDimensions,
+            metricNotation: viewState.metricNotation ?? 'meters',
+            purpose: viewState.purpose ?? 'edit',
+            drafting: viewState.drafting === true,
+            roomLabelOverlay: viewState.roomLabelOverlay === true,
+            wallDimensionFaces: viewState.wallDimensionFaces,
+        }),
+        viewState: viewState.palette
+            ? {
+                selected: viewState.selected,
+                unit: viewState.unit,
+                highlighted: viewState.highlighted,
+                hovered: viewState.hovered,
+                moving: viewState.moving,
+                focusedUnitId: viewState.focusedUnitId,
+                focusedUnitMemberIds: viewState.focusedUnitMemberIds,
+                palette: viewState.palette,
+            }
+            : undefined,
+    };
+}
+export function floorplanLayerRank(type) {
+    switch (type) {
+        case 'zone':
+            return 0;
+        case 'slab':
+        case 'ceiling':
+            return 1;
+        default:
+            return 2;
+    }
+}

package/dist/lib/floorplan/index.d.ts

@@ -0,0 +1,6 @@
+export * from './context.js';
+export * from './marks.js';
+export * from './plan-math.js';
+export * from './svg-paths.js';
+export * from './wall-affordances.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/floorplan/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/floorplan/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,oBAAoB,CAAA"}

package/dist/lib/floorplan/index.js

@@ -0,0 +1,5 @@
+export * from './context.js';
+export * from './marks.js';
+export * from './plan-math.js';
+export * from './svg-paths.js';
+export * from './wall-affordances.js';

package/dist/lib/floorplan/marks.d.ts

@@ -0,0 +1,71 @@
+import type { AnyNode, AnyNodeId, DoorNode, WindowNode } from '../../schema/index.js';
+/**
+ * Deterministic door / window marks per level — WS3.
+ *
+ * `packages/core/src/schema/nodes/door.ts:75-79` promises "the deterministic
+ * level fallback (101, 102, ...)"; this is the implementation.
+ *
+ * Numbering
+ * ---------
+ *   base   = (level.level + 1) * 100          — level 0 → 100, level 1 → 200
+ *   doors  = `D${base + n}`   → D101, D102 …
+ *   windows= `W${base + n}`   → W101, W102 …
+ *
+ * Order
+ * -----
+ * Openings are visited **clockwise** around the level, starting from the
+ * north-west-most exterior wall, exterior walls first and interior walls
+ * after. Clockwise is the ascending-angle sweep of the wall midpoint about
+ * the level centroid, anchored on the north-west diagonal (plan axes are
+ * x east, z south — z grows down the screen — so a screen-clockwise sweep
+ * is increasing atan2(z, x)). Openings on the same wall are ordered along
+ * the wall direction.
+ *
+ * Stability
+ * ---------
+ * An explicit `mark` on the node always wins and is never reassigned.
+ * `resolveMarks` also reports, in `assignments`, the marks it invented for
+ * nodes that had none — the caller is expected to PERSIST those back onto
+ * `node.mark` the first time they are resolved in an edit session
+ * (`persistResolvedMarks`). That is what makes numbering stable under
+ * insertion: once written, an existing opening keeps its number forever and
+ * a newly inserted opening only ever takes the next free number. Without
+ * the write-back, inserting a door in the middle of a wall would silently
+ * renumber every door after it.
+ */
+export type OpeningMarkKind = 'door' | 'window';
+export type MarkResolution = {
+    /** Every door and window on the level → its mark. */
+    marks: ReadonlyMap<string, string>;
+    /** Only the marks that were invented (node.mark was empty). */
+    assignments: ReadonlyMap<string, string>;
+    /** Duplicate explicit marks and other reportable defects. */
+    issues: readonly string[];
+};
+export type MarkSceneInput = {
+    nodes: Readonly<Record<string, AnyNode>>;
+};
+/**
+ * Resolve marks for every door and window under `levelId`.
+ *
+ * `scene` may be a `{ nodes }` snapshot or the raw node map.
+ */
+export declare function resolveMarks(scene: MarkSceneInput | Readonly<Record<string, AnyNode>>, levelId: AnyNodeId): Map<string, string>;
+export declare function resolveMarkDetail(scene: MarkSceneInput | Readonly<Record<string, AnyNode>>, levelId: AnyNodeId): MarkResolution;
+/**
+ * Write invented marks back onto the nodes so numbering never drifts.
+ *
+ * Call once per level per edit session (the caller decides when — this
+ * module stays pure). `update` is typically `sceneApi.update`.
+ */
+export declare function persistResolvedMarks(resolution: MarkResolution, update: (id: AnyNodeId, data: Record<string, unknown>) => void): number;
+type Opening = (DoorNode | WindowNode) & {
+    type: 'door' | 'window';
+};
+/**
+ * Every door and window under the level, clockwise from the NW-most
+ * exterior wall, exterior walls first.
+ */
+export declare function orderedOpenings(nodes: Readonly<Record<string, AnyNode>>, levelId: AnyNodeId): Opening[];
+export {};
+//# sourceMappingURL=marks.d.ts.map

package/dist/lib/floorplan/marks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marks.d.ts","sourceRoot":"","sources":["../../../src/lib/floorplan/marks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAuB,UAAU,EAAE,MAAM,cAAc,CAAA;AAEjG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,CAAA;AAE/C,MAAM,MAAM,cAAc,GAAG;IAC3B,qDAAqD;IACrD,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,+DAA+D;IAC/D,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxC,6DAA6D;IAC7D,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CACzC,CAAA;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACzD,OAAO,EAAE,SAAS,GACjB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAErB;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACzD,OAAO,EAAE,SAAS,GACjB,cAAc,CAkDhB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,cAAc,EAC1B,MAAM,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAC7D,MAAM,CAOR;AAID,KAAK,OAAO,GAAG,CAAC,QAAQ,GAAG,UAAU,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAA;CAAE,CAAA;AAEpE;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACxC,OAAO,EAAE,SAAS,GACjB,OAAO,EAAE,CAuCX"}

package/dist/lib/floorplan/marks.js

@@ -0,0 +1,157 @@
+/**
+ * Resolve marks for every door and window under `levelId`.
+ *
+ * `scene` may be a `{ nodes }` snapshot or the raw node map.
+ */
+export function resolveMarks(scene, levelId) {
+    return new Map(resolveMarkDetail(scene, levelId).marks);
+}
+export function resolveMarkDetail(scene, levelId) {
+    const nodes = normalizeNodes(scene);
+    const level = nodes[levelId];
+    const ordinal = level && level.type === 'level' ? (level.level ?? 0) : 0;
+    const base = (Math.max(0, ordinal) + 1) * 100;
+    const openings = orderedOpenings(nodes, levelId);
+    const marks = new Map();
+    const assignments = new Map();
+    const issues = [];
+    for (const kind of ['door', 'window']) {
+        const prefix = kind === 'door' ? 'D' : 'W';
+        const list = openings.filter((opening) => opening.type === kind);
+        const used = new Set();
+        const explicitOwners = new Map();
+        for (const opening of list) {
+            const explicit = opening.mark?.trim();
+            if (!explicit)
+                continue;
+            marks.set(opening.id, explicit);
+            const normalized = explicit.toLocaleUpperCase();
+            used.add(normalized);
+            const owners = explicitOwners.get(normalized);
+            if (owners)
+                owners.push(opening.id);
+            else
+                explicitOwners.set(normalized, [opening.id]);
+        }
+        let sequence = 1;
+        for (const opening of list) {
+            if (marks.has(opening.id))
+                continue;
+            let candidate = `${prefix}${base + sequence}`;
+            while (used.has(candidate.toLocaleUpperCase())) {
+                sequence++;
+                candidate = `${prefix}${base + sequence}`;
+            }
+            marks.set(opening.id, candidate);
+            assignments.set(opening.id, candidate);
+            used.add(candidate.toLocaleUpperCase());
+            sequence++;
+        }
+        for (const [mark, owners] of explicitOwners) {
+            if (owners.length > 1) {
+                issues.push(`Duplicate ${kind} mark ${mark} (${owners.length} instances)`);
+            }
+        }
+    }
+    return { marks, assignments, issues };
+}
+/**
+ * Write invented marks back onto the nodes so numbering never drifts.
+ *
+ * Call once per level per edit session (the caller decides when — this
+ * module stays pure). `update` is typically `sceneApi.update`.
+ */
+export function persistResolvedMarks(resolution, update) {
+    let written = 0;
+    for (const [id, mark] of resolution.assignments) {
+        update(id, { mark });
+        written++;
+    }
+    return written;
+}
+/**
+ * Every door and window under the level, clockwise from the NW-most
+ * exterior wall, exterior walls first.
+ */
+export function orderedOpenings(nodes, levelId) {
+    const walls = [];
+    const orphanOpenings = [];
+    const visit = (id) => {
+        const node = nodes[id];
+        if (!node)
+            return;
+        if (node.visible === false)
+            return;
+        if (node.type === 'wall')
+            walls.push(node);
+        else if (node.type === 'door' || node.type === 'window') {
+            const opening = node;
+            if (!opening.wallId || !nodes[opening.wallId])
+                orphanOpenings.push(opening);
+        }
+        for (const childId of node.children ?? [])
+            visit(childId);
+    };
+    visit(levelId);
+    const centroid = wallCentroid(walls);
+    const ordered = [...walls].sort((left, right) => {
+        const leftExterior = isExteriorWall(left) ? 0 : 1;
+        const rightExterior = isExteriorWall(right) ? 0 : 1;
+        if (leftExterior !== rightExterior)
+            return leftExterior - rightExterior;
+        return clockwiseKey(left, centroid) - clockwiseKey(right, centroid);
+    });
+    const result = [];
+    for (const wall of ordered) {
+        const wallOpenings = [];
+        for (const childId of wall.children ?? []) {
+            const child = nodes[childId];
+            if (child && child.visible !== false && (child.type === 'door' || child.type === 'window')) {
+                wallOpenings.push(child);
+            }
+        }
+        wallOpenings.sort((left, right) => left.position[0] - right.position[0]);
+        result.push(...wallOpenings);
+    }
+    result.push(...orphanOpenings);
+    return result;
+}
+function wallCentroid(walls) {
+    if (walls.length === 0)
+        return [0, 0];
+    let x = 0;
+    let z = 0;
+    for (const wall of walls) {
+        x += (wall.start[0] + wall.end[0]) / 2;
+        z += (wall.start[1] + wall.end[1]) / 2;
+    }
+    return [x / walls.length, z / walls.length];
+}
+/**
+ * Sweep key: 0 at the north-west direction, increasing clockwise on screen.
+ *
+ * Plan axes are x east, z south — z grows DOWN the screen — so a clockwise
+ * screen sweep (up → right → down → left) is the INCREASING atan2(z, x)
+ * direction. The north-west diagonal sits at atan2(-1, -1) = -3π/4, so
+ * anchoring there and wrapping into [0, 2π) yields north, east, south, west.
+ */
+const NORTH_WEST_ANGLE = (-3 * Math.PI) / 4;
+function clockwiseKey(wall, centroid) {
+    const midX = (wall.start[0] + wall.end[0]) / 2 - centroid[0];
+    const midZ = (wall.start[1] + wall.end[1]) / 2 - centroid[1];
+    let sweep = Math.atan2(midZ, midX) - NORTH_WEST_ANGLE;
+    while (sweep < 0)
+        sweep += Math.PI * 2;
+    while (sweep >= Math.PI * 2)
+        sweep -= Math.PI * 2;
+    return sweep;
+}
+function isExteriorWall(wall) {
+    return wall.frontSide === 'exterior' || wall.backSide === 'exterior';
+}
+function normalizeNodes(scene) {
+    const candidate = scene;
+    return candidate && typeof candidate === 'object' && 'nodes' in candidate
+        ? candidate.nodes
+        : scene;
+}

package/dist/lib/floorplan/plan-math.d.ts

@@ -0,0 +1,18 @@
+import { type WallJustification } from '../../systems/wall/wall-frame.js';
+import type { Point2D } from '../../systems/wall/wall-mitering.js';
+export declare const FLOORPLAN_VIEW_ROTATION_DEG = 0;
+export declare function clampPlanValue(value: number, min: number, max: number): number;
+export declare function rotatePlanVector(x: number, y: number, rotation: number): [number, number];
+export declare function worldToFloorplanLocalPoint(worldX: number, worldZ: number, buildingPosition: readonly [number, number, number], buildingRotationY: number): Point2D;
+export declare function floorplanLocalToWorldPoint(point: Point2D | [number, number], buildingPosition: readonly [number, number, number], buildingRotationY: number): {
+    x: number;
+    z: number;
+};
+export declare function interpolatePlanPoint(start: Point2D, end: Point2D, t: number): Point2D;
+export declare function getPlanPointDistance(start: Point2D, end: Point2D): number;
+export declare function movePlanPointTowards(start: Point2D, end: Point2D, distance: number): Point2D;
+export declare function getThickPlanLinePolygon(line: {
+    start: Point2D;
+    end: Point2D;
+}, thickness: number, justification?: WallJustification): Point2D[];
+//# sourceMappingURL=plan-math.d.ts.map

package/dist/lib/floorplan/plan-math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-math.d.ts","sourceRoot":"","sources":["../../../src/lib/floorplan/plan-math.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AAC1F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAA;AAY/D,eAAO,MAAM,2BAA2B,IAAI,CAAA;AAE5C,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,UAErE;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAIzF;AAQD,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACnD,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAUT;AAGD,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,gBAAgB,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACnD,iBAAiB,EAAE,MAAM,GACxB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAU1B;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAKrF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,CAEzE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAO5F;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,EACtC,SAAS,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,iBAAiB,GAChC,OAAO,EAAE,CAqBX"}