@pascal-app/core 1.0.3 → 1.0.4

package/dist/lib/plate-reference.js

@@ -0,0 +1,91 @@
+import { proceduralFootprint } from '../procedural-items/query.js';
+import { getFenceCenterlineFrameAt } from '../systems/fence/fence-centerline.js';
+import { getStairFloorPlacedFootprints } from '../systems/stair/stair-floor-footprints.js';
+import { stairArrivalOpening } from '../systems/stair/stair-footprint.js';
+import { calculateLevelMiters, getWallPlanFootprint } from '../systems/wall/wall-footprint.js';
+import { planFootprintCorners } from './plan-footprint.js';
+import { area, containsPoint, intersection, union, } from './polygon-boolean.js';
+export function replacementPlateFor(node, field, plates, nodes) {
+    let footprint = [];
+    let point;
+    if (field === 'deckSlabId' && node.type === 'stair') {
+        if (!node.position || !node.children)
+            return undefined;
+        const arrival = stairArrivalOpening(node, nodes);
+        if (arrival.length)
+            point = [
+                arrival.reduce((s, p) => s + p[0], 0) / arrival.length,
+                arrival.reduce((s, p) => s + p[1], 0) / arrival.length,
+            ];
+    }
+    else if (node.type === 'item') {
+        footprint = planFootprintCorners(node.position, node.asset.dimensions.map((v, i) => v * node.scale[i]), node.rotation[1]);
+    }
+    else if (node.type === 'procedural-item') {
+        const box = proceduralFootprint(node);
+        footprint = planFootprintCorners(box.position, box.dimensions, box.rotation[1]);
+    }
+    else if (node.type === 'stair') {
+        footprint = union(getStairFloorPlacedFootprints(node, nodes).map((box) => planFootprintCorners(box.position ?? node.position, box.dimensions, box.rotation[1])));
+    }
+    else if (node.type === 'block') {
+        const positions = node.topology.vertices.map((vertex) => vertex.position);
+        if (positions.length) {
+            const minX = Math.min(...positions.map((p) => p[0])), maxX = Math.max(...positions.map((p) => p[0]));
+            const minZ = Math.min(...positions.map((p) => p[2])), maxZ = Math.max(...positions.map((p) => p[2]));
+            const x = (minX + maxX) / 2, z = (minZ + maxZ) / 2;
+            footprint = planFootprintCorners([
+                node.position[0] + x * Math.cos(node.rotation) + z * Math.sin(node.rotation),
+                node.position[1],
+                node.position[2] - x * Math.sin(node.rotation) + z * Math.cos(node.rotation),
+            ], [maxX - minX, 0, maxZ - minZ], node.rotation);
+        }
+    }
+    else if (node.type === 'fence') {
+        const sides = [1, -1].map((sign) => Array.from({ length: 97 }, (_, i) => {
+            const frame = getFenceCenterlineFrameAt(node, i / 96);
+            return [
+                frame.point.x + (sign * frame.normal.x * node.thickness) / 2,
+                frame.point.y + (sign * frame.normal.y * node.thickness) / 2,
+            ];
+        }));
+        footprint = [...sides[0], ...sides[1].reverse()];
+    }
+    else if (node.type === 'wall') {
+        const walls = Object.values(nodes).filter((candidate) => candidate.type === 'wall' && candidate.parentId === node.parentId);
+        footprint = getWallPlanFootprint(node, calculateLevelMiters(walls)).map((point) => [point.x, point.y]);
+    }
+    else if ('polygon' in node && Array.isArray(node.polygon))
+        footprint = node.polygon;
+    else if ('position' in node && Array.isArray(node.position)) {
+        const rotation = 'rotation' in node ? (Array.isArray(node.rotation) ? node.rotation[1] : node.rotation) : 0;
+        if ('width' in node &&
+            'depth' in node &&
+            typeof node.width === 'number' &&
+            typeof node.depth === 'number')
+            footprint = planFootprintCorners(node.position, [node.width, 0, node.depth], typeof rotation === 'number' ? rotation : 0);
+        else
+            point = [node.position[0], node.position[2]];
+    }
+    return plates
+        .filter((plate) => plate.parentId ===
+        (field === 'deckSlabId' && 'deckSlabId' in node
+            ? (nodes[node.deckSlabId ?? '']?.parentId ?? node.parentId)
+            : node.parentId) &&
+        (node.type !== 'wall' ||
+            (plate.support !== 'open' &&
+                plate.plateRole !== 'platform' &&
+                plate.plateRole !== 'sunken')))
+        .map((plate) => ({
+        plate,
+        overlap: point
+            ? Number(containsPoint([{ outer: plate.polygon, holes: plate.holes }], point))
+            : footprint.length
+                ? area(intersection(footprint, { outer: plate.polygon, holes: plate.holes }))
+                : 0,
+    }))
+        .filter((p) => p.overlap > 0)
+        .sort((a, b) => b.plate.elevation - a.plate.elevation ||
+        b.overlap - a.overlap ||
+        a.plate.id.localeCompare(b.plate.id))[0]?.plate.id;
+}

package/dist/lib/plate-surface.d.ts

@@ -0,0 +1,120 @@
+import type { AnyNode, AnyNodeId, DoorNode, SlabNode, WallNode, WindowNode, ZoneNode } from '../schema/index.js';
+import { type MultiPolygon } from './polygon-boolean.js';
+/**
+ * Who draws the walking surface of a floor plate, and what the plate's vertical
+ * faces are.
+ *
+ * A plate (`slab.boundary === 'auto'`) spans every room it carries plus the
+ * wall footprints between them, so one mesh cannot hold one finish: the top is
+ * partitioned into cells by the polygon kernel and each cell draws its own
+ * resolved material. Priority, highest first:
+ *
+ *   1. a manual slab top at the same height  → masked out of the plate entirely
+ *   2. the zone's `floor.regions`            → later entries win
+ *   3. the zone's `floor.finish`             → inside the zone CLEAR polygon
+ *   4. the plate's own `surface` slot        → under walls and unfinished rooms
+ *
+ * The side faces are classified per exposed interval: `edge` where the face
+ * looks at the exterior, `riser` where it looks at a lower plate or the open
+ * air of a sub-zone step. Wall-covered steps are hidden except under doors;
+ * facade edges still show the slab thickness.
+ *
+ * Everything here is pure 2D and memoised per plate per topology/finish
+ * revision — `computePlateSurfacePartition` is the only entry point a renderer
+ * needs and never runs per frame.
+ */
+/** A zone floor finish: a `MaterialRef` string, or an inline legacy material. */
+export type PlateFinish = string | Record<string, unknown>;
+export type PlateTopCell = {
+    /** Paint role for a hit on this cell — a slab slot id or a `room:` route. */
+    role: string;
+    /** Finish drawing the cell; absent = the plate's own `surface` slot. */
+    finish?: PlateFinish;
+    /** Equal keys ⇒ one shared material instance, so batches never fragment. */
+    materialKey: string;
+    polygons: MultiPolygon;
+};
+export type PlateSideRole = 'edge' | 'riser' | 'hidden';
+export type PlateSideInterval = {
+    start: [number, number];
+    end: [number, number];
+    role: PlateSideRole;
+    /** Lower neighbouring plate top, in level-local metres. */
+    dropTo?: number;
+    zoneId?: string;
+    /**
+     * The doorway a room-owned riser steps through (`lib/floor-step-finish`):
+     * the door it sits under, else the lower room it looks at.
+     */
+    stepKey?: string;
+    bottom?: number;
+    top?: number;
+};
+export type PlateSurfacePartition = {
+    /** Disjoint, together covering the plate top minus `masked`. */
+    cells: PlateTopCell[];
+    /** Plate top covered by a manual surface or solid platform. */
+    masked: MultiPolygon;
+    sides: PlateSideInterval[];
+    /** True when the top is one plain `surface` cell — renderers skip the clip. */
+    plainTop: boolean;
+};
+export type PlateLevelContext = {
+    walls: WallNode[];
+    zones: ZoneNode[];
+    slabs: SlabNode[];
+    openings?: (DoorNode | WindowNode)[];
+    platform?: boolean;
+    nodes?: Readonly<Record<string, AnyNode>>;
+};
+export declare function isFloorPlate(slab: Pick<SlabNode, 'boundary'>): boolean;
+/** `room:<zoneId>` paints the room's floor finish; `/regionId` paints one region. */
+export declare function roomFinishRole(zoneId: string, regionId?: string): string;
+export declare function parseRoomFinishRole(role: string): {
+    zoneId: string;
+    regionId: string | null;
+} | null;
+/** Stable identity of a finish, so two rooms painted alike share one material. */
+export declare function plateFinishKey(finish: PlateFinish | undefined): string;
+/** Level neighbourhood a plate partition reads — walls, zones and sibling slabs. */
+export declare function plateLevelContext(parent: AnyNode | null, resolve: (id: AnyNodeId) => AnyNode | undefined): PlateLevelContext;
+/**
+ * Everything the partition of ONE plate depends on. Written into the geometry
+ * builder's memo and into the slab dependency tracker, so a finish edit rebuilds
+ * exactly the plates that show it and nothing else re-clips.
+ */
+export declare function platePartitionSignature(plate: SlabNode, context: PlateLevelContext): string;
+/** Joined plan footprints of every wall on the level — the "under a wall" mask. */
+export declare function levelWallCover(walls: readonly WallNode[]): MultiPolygon;
+export declare function plateOpeningLandings(context: PlateLevelContext): import("./floor-opening-footprints.js").OpeningLanding[];
+/**
+ * The plate's top cells and side classification, memoised on
+ * `platePartitionSignature`. Returns `null` for anything that is not an
+ * unrecessed floor plate — manual slabs and pools keep the plain two-slot path.
+ */
+export declare function computePlateSurfacePartition(plate: SlabNode, context: PlateLevelContext): PlateSurfacePartition | null;
+/**
+ * The doorway keys of every step `zoneId` owns on its level — what the room
+ * scope of a step paints. Reads the same memoised partitions the renderer does.
+ */
+export declare function floorStepKeysOf(nodes: Readonly<Record<string, AnyNode>>, levelId: string, zoneId: string): string[];
+/** Test seam — drops every memo so a test can assert a rebuild is deterministic. */
+export declare function clearPlateSurfaceCaches(): void;
+/**
+ * Role of a plate side face at a point on the plate outline.
+ */
+export declare function classifyPlateSideAt(partition: PlateSurfacePartition, point: readonly [number, number], tolerance?: number): PlateSideRole;
+/**
+ * Where the classification changes along one plate outline segment, as
+ * parameters in `[0, 1]` of that segment. A side quad is cut at these stations
+ * so a single edge can be exterior for part of its length and a step for the
+ * rest.
+ */
+export declare function plateSideRuns(partition: PlateSurfacePartition, start: readonly [number, number], end: readonly [number, number]): Array<{
+    t0: number;
+    t1: number;
+    role: PlateSideRole;
+    dropTo?: number;
+    zoneId?: string;
+}>;
+//# sourceMappingURL=plate-surface.d.ts.map

package/dist/lib/plate-surface.d.ts.map

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