@pascal-app/core 1.0.3 → 1.0.5

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

@@ -0,0 +1,38 @@
+import type { AnyNode, AnyNodeId } from '../schema/index.js';
+import { type DerivedWriteOptions } from '../store/derived-node-guard.js';
+import type { NodePatch, SceneNodes } from './structure-kernel.js';
+import { type StructureIdFactory } from './structure-reconcile.js';
+type StructureStoreLike = {
+    getState: () => {
+        nodes: SceneNodes;
+        createNodes: (ops: {
+            node: AnyNode;
+            parentId?: AnyNodeId;
+        }[], options?: DerivedWriteOptions) => void;
+        updateNodes: (updates: {
+            id: AnyNodeId;
+            data: Partial<AnyNode>;
+        }[], options?: DerivedWriteOptions) => void;
+        deleteNodes: (ids: AnyNodeId[], options?: DerivedWriteOptions) => void;
+    };
+};
+/**
+ * The only sanctioned writer of derived construction into a scene store.
+ *
+ * Runs the pure kernel over the requested levels and applies its patches while
+ * holding the derived-writer capability, so plates and auto ceilings reach the
+ * store through the guarded actions without any caller being able to forge the
+ * capability. Both the browser's commit subscriber (`initSpaceDetectionSync`)
+ * and the headless MCP bridge go through here.
+ *
+ * Callers own history framing: pause scene history around this call so the
+ * derived writes join the triggering edit's undo step
+ * (`wiki/architecture/space-detection.md`).
+ */
+export declare function applyStructureReconciliation(sceneStore: StructureStoreLike, options: {
+    levelIds?: string[];
+    previousNodes?: SceneNodes;
+    mintId: StructureIdFactory;
+}): NodePatch[];
+export {};
+//# sourceMappingURL=structure-commit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"structure-commit.d.ts","sourceRoot":"","sources":["../../src/lib/structure-commit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AACnD,OAAO,EAAwB,KAAK,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AAE5F,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC/D,OAAO,EAA2B,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAExF,KAAK,kBAAkB,GAAG;IACxB,QAAQ,EAAE,MAAM;QACd,KAAK,EAAE,UAAU,CAAA;QACjB,WAAW,EAAE,CACX,GAAG,EAAE;YAAE,IAAI,EAAE,OAAO,CAAC;YAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;SAAE,EAAE,EAC9C,OAAO,CAAC,EAAE,mBAAmB,KAC1B,IAAI,CAAA;QACT,WAAW,EAAE,CACX,OAAO,EAAE;YAAE,EAAE,EAAE,SAAS,CAAC;YAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;SAAE,EAAE,EACpD,OAAO,CAAC,EAAE,mBAAmB,KAC1B,IAAI,CAAA;QACT,WAAW,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,OAAO,CAAC,EAAE,mBAAmB,KAAK,IAAI,CAAA;KACvE,CAAA;CACF,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,kBAAkB,EAC9B,OAAO,EAAE;IACP,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,aAAa,CAAC,EAAE,UAAU,CAAA;IAC1B,MAAM,EAAE,kBAAkB,CAAA;CAC3B,GACA,SAAS,EAAE,CA0Cb"}

package/dist/lib/structure-commit.js

@@ -0,0 +1,52 @@
+import { DERIVED_WRITER_TOKEN } from '../store/derived-node-guard.js';
+import { omitUndefined } from '../utils/omit-undefined.js';
+import { reconcileSceneStructure } from './structure-reconcile.js';
+/**
+ * The only sanctioned writer of derived construction into a scene store.
+ *
+ * Runs the pure kernel over the requested levels and applies its patches while
+ * holding the derived-writer capability, so plates and auto ceilings reach the
+ * store through the guarded actions without any caller being able to forge the
+ * capability. Both the browser's commit subscriber (`initSpaceDetectionSync`)
+ * and the headless MCP bridge go through here.
+ *
+ * Callers own history framing: pause scene history around this call so the
+ * derived writes join the triggering edit's undo step
+ * (`wiki/architecture/space-detection.md`).
+ */
+export function applyStructureReconciliation(sceneStore, options) {
+    const capability = { derivedWriter: DERIVED_WRITER_TOKEN };
+    const { patches } = reconcileSceneStructure({
+        levelIds: options.levelIds,
+        nodes: sceneStore.getState().nodes,
+        previousNodes: options.previousNodes,
+        mintId: options.mintId,
+    });
+    const state = sceneStore.getState();
+    const creates = patches.flatMap((patch) => patch.op === 'create'
+        ? [{ node: omitUndefined(patch.node), parentId: patch.node.parentId }]
+        : []);
+    const updates = patches.flatMap((patch) => patch.op === 'update'
+        ? [
+            {
+                id: patch.id,
+                // Top-level undefined is the store's remove-field instruction, not a stored value.
+                data: Object.fromEntries(Object.entries(patch.data).map(([key, value]) => [key, omitUndefined(value)])),
+            },
+        ]
+        : []);
+    const deletes = patches.flatMap((patch) => (patch.op === 'delete' ? [patch.id] : []));
+    if (creates.length)
+        state.createNodes(creates, capability);
+    if (updates.length)
+        state.updateNodes(updates, capability);
+    if (deletes.length) {
+        // Retiring a derived ceiling must not cascade into the children the kernel
+        // just re-parented off it.
+        const hosts = deletes.filter((id) => sceneStore.getState().nodes[id]?.type === 'ceiling');
+        if (hosts.length)
+            state.updateNodes(hosts.map((id) => ({ id, data: { children: [] } })), capability);
+        state.deleteNodes(deletes, capability);
+    }
+    return patches;
+}

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

@@ -0,0 +1,66 @@
+import type { AnyNode, AnyNodeId, WallNode } from '../schema/index.js';
+import type { ZoneNode } from '../schema/nodes/zone.js';
+import { type FloorOpeningIndex } from './floor-opening-intent.js';
+import { type Polygon, type Ring } from './polygon-boolean.js';
+import type { BoundarySpan } from './room-topology-index.js';
+export declare const ORPHAN_MERGE_COVERAGE_THRESHOLD = 0.6;
+export type SceneNodes = Readonly<Record<string, AnyNode>>;
+export type NodePatch = {
+    op: 'create';
+    node: AnyNode;
+} | {
+    op: 'update';
+    id: AnyNodeId;
+    data: Partial<AnyNode>;
+} | {
+    op: 'delete';
+    id: AnyNodeId;
+};
+export type StructureEvent = {
+    type: 'created' | 'adopted' | 'opened' | 'reopened' | 'retired';
+    zoneId: string;
+    survivorId?: string;
+};
+export type StructureRoom = {
+    zoneId: ZoneNode['id'];
+    polygon: Ring;
+    holes: Ring[];
+    clear: Polygon;
+    spans: BoundarySpan[];
+};
+export type LevelStructureSnapshot = {
+    levelId: string;
+    rooms: StructureRoom[];
+};
+/**
+ * The rooms that are outside: without a ceiling, and left without crossing a wall, through a
+ * separator no room stands behind or into another such room. A porch made a room for its floor
+ * left its wall with no outside: the front door faced the hall. A room that only lost its
+ * ceiling is walled in and a kitchen open to a terrace keeps its ceiling, so both stay inside; so
+ * does a courtyard walled on every side, a limit of this rule.
+ */
+export declare function outdoorRoomIds(rooms: readonly {
+    spans: readonly BoundarySpan[];
+    hasCeiling: boolean;
+}[]): Set<string>;
+/** A wall face is inside when an indoor room stands on it; an outdoor room's face is outside. */
+export declare function classifyWallSides(wall: WallNode, spans: readonly BoundarySpan[], outdoor?: ReadonlySet<string>): Pick<WallNode, 'frontSide' | 'backSide'>;
+export declare function reconcileLevelStructure(input: Parameters<typeof planLevelStructure>[0]): ReturnType<typeof planLevelStructure>;
+declare function planLevelStructure({ levelId, nodes, mintId, openingIndex, }: {
+    levelId: string;
+    nodes: SceneNodes;
+    previousNodes?: SceneNodes;
+    mintId: (kind: 'zone' | 'ceiling' | 'slab' | 'separator') => string;
+    openingIndex?: FloorOpeningIndex;
+}): {
+    patches: NodePatch[];
+    snapshot: LevelStructureSnapshot;
+    events: StructureEvent[];
+};
+export declare function createLevelStructurePreview(levelId: string, nodes: SceneNodes): (walls: readonly WallNode[]) => {
+    op: 'update';
+    id: AnyNodeId;
+    data: Partial<AnyNode>;
+}[];
+export {};
+//# sourceMappingURL=structure-kernel.d.ts.map

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

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