@ifc-lite/create 3.2.0 → 4.0.0

package/dist/in-store/host-geometry-frame.js

@@ -0,0 +1,146 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/** Package-private body frame reads: defaults belong only to omitted optional
+ * attributes, never to an explicit unreadable reference (#6232 / #6539). */
+import { firstProjAxis } from '@ifc-lite/data';
+/** Source extractors use numbers; overlay references use #id strings. */
+export function refId(value) {
+    if (typeof value === 'number' && Number.isInteger(value) && value > 0)
+        return value;
+    if (typeof value === 'string' && /^#[1-9][0-9]*$/.test(value))
+        return Number(value.slice(1));
+    return null;
+}
+export function num(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : null;
+}
+/** A 3D frame needs exactly three coordinates. A profile opts into two,
+ * embedded in XY; missing 3D coordinates must never be synthesized. */
+export function vec3(value, dimension = 3) {
+    if (!Array.isArray(value) || value.length !== dimension)
+        return null;
+    const x = num(value[0]);
+    const y = num(value[1]);
+    const z = dimension === 3 ? num(value[2]) : 0;
+    return x === null || y === null || z === null ? null : [x, y, z];
+}
+export function pointOf(reader, ref, type = 'IFCCARTESIANPOINT', dimension = 3) {
+    const id = refId(ref);
+    const entity = id === null ? null : reader.entity(id);
+    return entity?.type.toUpperCase() === type ? vec3(entity.attributes[0], dimension) : null;
+}
+export function unit(v) {
+    const len = Math.hypot(v[0], v[1], v[2]);
+    return len > 1e-12 ? [v[0] / len, v[1] / len, v[2] / len] : null;
+}
+/** IfcAxis2Placement2D: Position is optional on a profile; Location is required. */
+export function axis2d(reader, ref) {
+    if (ref === null || ref === undefined)
+        return { o: [0, 0], x: [1, 0] };
+    const id = refId(ref), placement = id === null ? null : reader.entity(id);
+    if (placement?.type.toUpperCase() !== 'IFCAXIS2PLACEMENT2D')
+        return null;
+    const o = pointOf(reader, placement.attributes[0], 'IFCCARTESIANPOINT', 2);
+    const refDirection = placement.attributes[1];
+    const dir = refDirection === null || refDirection === undefined ? [1, 0, 0] : pointOf(reader, refDirection, 'IFCDIRECTION', 2);
+    const x = dir ? unit([dir[0], dir[1], 0]) : null;
+    return o && x ? { o: [o[0], o[1]], x: [x[0], x[1]] } : null;
+}
+/** IfcAxis2Placement3D: only an omitted optional Position/Axis/RefDirection
+ * uses defaults. An explicit missing, zero or parallel axis is unreadable. */
+export function axis3d(reader, ref) {
+    if (ref === null || ref === undefined)
+        return { o: [0, 0, 0], x: [1, 0, 0], y: [0, 1, 0], z: [0, 0, 1] };
+    const id = refId(ref), placement = id === null ? null : reader.entity(id);
+    if (placement?.type.toUpperCase() !== 'IFCAXIS2PLACEMENT3D')
+        return null;
+    const o = pointOf(reader, placement.attributes[0]);
+    const axis = placement.attributes[1], refDirection = placement.attributes[2];
+    const direction = axis === null || axis === undefined ? [0, 0, 1] : pointOf(reader, axis, 'IFCDIRECTION');
+    const z = direction ? unit(direction) : null;
+    if (!o || !z)
+        return null;
+    // An absent RefDirection uses the renderer's canonical fill (#5922).
+    const r = refDirection === null || refDirection === undefined ? firstProjAxis(z) : pointOf(reader, refDirection, 'IFCDIRECTION');
+    if (!r)
+        return null;
+    const dot = r[0] * z[0] + r[1] * z[1] + r[2] * z[2];
+    const x = unit([r[0] - dot * z[0], r[1] - dot * z[1], r[2] - dot * z[2]]);
+    if (!x)
+        return null;
+    const y = [z[1] * x[2] - z[2] * x[1], z[2] * x[0] - z[0] * x[2], z[0] * x[1] - z[1] * x[0]];
+    return { o, x, y, z };
+}
+export function applyFrame(f, p) {
+    return [
+        f.o[0] + f.x[0] * p[0] + f.y[0] * p[1] + f.z[0] * p[2],
+        f.o[1] + f.x[1] * p[0] + f.y[1] * p[1] + f.z[1] * p[2],
+        f.o[2] + f.x[2] * p[0] + f.y[2] * p[1] + f.z[2] * p[2],
+    ];
+}
+const IDENTITY_FRAME3 = { o: [0, 0, 0], x: [1, 0, 0], y: [0, 1, 0], z: [0, 0, 1] };
+export function transformBounds(bounds, frame) {
+    const min = [Infinity, Infinity, Infinity], max = [-Infinity, -Infinity, -Infinity];
+    for (const x of [bounds.min[0], bounds.max[0]])
+        for (const y of [bounds.min[1], bounds.max[1]])
+            for (const z of [bounds.min[2], bounds.max[2]]) {
+                const p = applyFrame(frame, [x, y, z]);
+                for (let i = 0; i < 3; i++) {
+                    min[i] = Math.min(min[i], p[i]);
+                    max[i] = Math.max(max[i], p[i]);
+                }
+            }
+    return { min, max };
+}
+export function composeFrame(outer, inner) {
+    const direction = (p) => [0, 1, 2].map(i => outer.x[i] * p[0] + outer.y[i] * p[1] + outer.z[i] * p[2]);
+    return { o: applyFrame(outer, inner.o), x: direction(inner.x), y: direction(inner.y), z: direction(inner.z) };
+}
+/** Rigid placement inverse; axis3d supplies orthonormal placement axes. */
+export function inverseFrame(f) {
+    return {
+        o: [f.x, f.y, f.z].map(v => -(v[0] * f.o[0] + v[1] * f.o[1] + v[2] * f.o[2])),
+        x: [f.x[0], f.y[0], f.z[0]], y: [f.x[1], f.y[1], f.z[1]], z: [f.x[2], f.y[2], f.z[2]],
+    };
+}
+/** Full 3D local-placement chain, including the opening's rotated frame.
+ * Missing references, cycles and excessive acyclic chains are unreadable. */
+export function placementInAncestor(reader, placementId, ancestorId) {
+    let frame = IDENTITY_FRAME3;
+    let id = placementId;
+    const visited = new Set();
+    while (id !== null && id !== ancestorId) {
+        if (visited.size >= 10_000 || visited.has(id))
+            return null;
+        visited.add(id);
+        const placement = reader.entity(id);
+        const axisId = placement ? refId(placement.attributes[1]) : null;
+        if (placement?.type.toUpperCase() !== 'IFCLOCALPLACEMENT' || axisId === null)
+            return null;
+        const own = axis3d(reader, axisId);
+        if (!own)
+            return null;
+        frame = composeFrame(own, frame);
+        id = refId(placement.attributes[0]);
+    }
+    return id === ancestorId ? frame : null;
+}
+/** Subcontexts inherit CoordinateSpaceDimension from ParentContext. */
+export function contextDimension(reader, contextId) {
+    let id = contextId;
+    const visited = new Set();
+    while (id !== null && visited.size < 10_000 && !visited.has(id)) {
+        visited.add(id);
+        const context = reader.entity(id);
+        if (context?.type.toUpperCase() === 'IFCGEOMETRICREPRESENTATIONCONTEXT') {
+            const dimension = context.attributes[2];
+            return dimension === 2 || dimension === 3 ? dimension : null;
+        }
+        if (context?.type.toUpperCase() !== 'IFCGEOMETRICREPRESENTATIONSUBCONTEXT')
+            return null;
+        id = refId(context.attributes[6]);
+    }
+    return null;
+}
+//# sourceMappingURL=host-geometry-frame.js.map

package/dist/in-store/host-geometry-frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-geometry-frame.js","sourceRoot":"","sources":["../../src/in-store/host-geometry-frame.ts"],"names":[],"mappings":"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"}

package/dist/in-store/hosted-element-edit.d.ts

@@ -0,0 +1,29 @@
+/** Shared hosted size/position commit (#6232). Resize the actual occurrence's
+ * geometry and its cut together, preserving the source's topology and style.
+ * Placement, movement and resize share one conservative fit/overlap decision. */
+import type { IfcDataStore } from '@ifc-lite/parser';
+import type { MutablePropertyView, StoreEditor } from '@ifc-lite/mutations';
+import { type HostedFillRead } from './hosted-fill-read.js';
+export interface HostedElementSize {
+    /** Effective IfcDoor / IfcWindow dimension, metres. Geometry supplies the
+     * dimension when the optional EXPRESS attribute is omitted. */
+    readonly OverallWidth: number;
+    readonly OverallHeight: number;
+}
+export interface HostedElementEdit {
+    readonly OverallWidth?: number;
+    readonly OverallHeight?: number;
+    /** Along the host's local X to the opening placement origin, metres. */
+    readonly Offset?: number;
+    /** Height of the opening placement origin in the host frame, metres. */
+    readonly Sill?: number;
+}
+/** Read through the effective overlay, including imported mapped geometry.
+ * A missing or unsupported physical shape is unreadable, never a rectangle. */
+export declare function readHostedElementSize(store: IfcDataStore, id: number, view?: MutablePropertyView | null): HostedElementSize | null;
+/** Atomic params-to-commit operation. Affine resizing is centred across the
+ * existing cut and held at its bottom; host thickness stays unchanged. Only
+ * the occurrence's Representation/placement/dimensions change, never its type
+ * maps, GlobalId, metadata or relationships. Refusals leave no overlay writes. */
+export declare function editHostedElementInStore(store: IfcDataStore, editor: StoreEditor, id: number, patch: HostedElementEdit): HostedFillRead;
+//# sourceMappingURL=hosted-element-edit.d.ts.map

package/dist/in-store/hosted-element-edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-element-edit.d.ts","sourceRoot":"","sources":["../../src/in-store/hosted-element-edit.ts"],"names":[],"mappings":"AAIA;;iFAEiF;AACjF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAI5E,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAO5E,MAAM,WAAW,iBAAiB;IAChC;mEAC+D;IAC/D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,wEAAwE;IACxE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,wEAAwE;IACxE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AA4CD;+EAC+E;AAC/E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,mBAAmB,GAAG,IAAI,GAAG,iBAAiB,GAAG,IAAI,CAElI;AAED;;;kFAGkF;AAClF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,cAAc,CAoDvI"}

package/dist/in-store/hosted-element-edit.js

@@ -0,0 +1,120 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+import { fromNativeLength, toNativeLength } from './anchor.js';
+import { AnchorEntityReader } from './resolve-anchor.js';
+import { localBodyExtent, placedBodyExtent, resolveHostAnchor } from './resolve-host.js';
+import { readHostedFill } from './hosted-fill-read.js';
+import { validateWallOpeningBounds } from './hosted-element.js';
+import { scaleHostedShape } from './hosted-shape-edit.js';
+import { moveHostedOpeningPlacement } from './hosted-placement-edit.js';
+import { placementInAncestor, refId, transformBounds } from './host-geometry-frame.js';
+import { safeLengthUnitScale } from './length-unit-scale.js';
+function geometry(store, reader, id, view, withSize = true) {
+    const read = readHostedFill(store, id, view);
+    const host = read ? reader.entity(read.hostId) : null;
+    const hostPlacement = host ? refId(host.attributes[5]) : null;
+    const opening = read ? reader.entity(read.openingId) : null;
+    const openingPlacement = opening ? refId(opening.attributes[5]) : null;
+    const openingFrame = hostPlacement === null || openingPlacement === null ? null : placementInAncestor(reader, openingPlacement, hostPlacement);
+    const cut = read ? placedBodyExtent(store, read.openingId, view) : null;
+    if (!read || !cut || !openingFrame || hostPlacement === null)
+        return null;
+    if (read.fillingId === null)
+        return { read, cut, openingFrame, fillingFrame: null, size: null };
+    const filling = reader.entity(read.fillingId);
+    if (!filling || !['IFCDOOR', 'IFCWINDOW'].includes(filling.type.toUpperCase()))
+        return null;
+    const fillingPlacement = refId(filling.attributes[5]);
+    const fillingFrame = fillingPlacement === null ? null : placementInAncestor(reader, fillingPlacement, hostPlacement);
+    if (!fillingFrame)
+        return null;
+    // Movement needs a valid placement and opening, even when the filling's
+    // optional Body is absent or outside the conservative size reader (#6571).
+    if (!withSize)
+        return { read, cut, openingFrame, fillingFrame, size: null };
+    const local = localBodyExtent(store, read.fillingId, view);
+    if (!local)
+        return null;
+    const body = transformBounds(local, fillingFrame);
+    const scale = store.source.byteLength > 0 ? safeLengthUnitScale(store.source, store.entityIndex, 'readHostedElementSize') ?? 1 : 1;
+    const dimension = (name, axis) => {
+        const index = filling.names.indexOf(name);
+        const value = index < 0 ? null : filling.attributes[index];
+        const native = value === null || value === undefined ? body.max[axis] - body.min[axis] : value;
+        return typeof native === 'number' && Number.isFinite(native) && native > 0 ? fromNativeLength({ lengthUnitScale: scale }, native) : null;
+    };
+    const OverallWidth = dimension('OverallWidth', 0), OverallHeight = dimension('OverallHeight', 2);
+    return OverallWidth === null || OverallHeight === null ? null : {
+        read, cut, openingFrame, fillingFrame, size: { OverallWidth, OverallHeight },
+    };
+}
+/** Read through the effective overlay, including imported mapped geometry.
+ * A missing or unsupported physical shape is unreadable, never a rectangle. */
+export function readHostedElementSize(store, id, view) {
+    return geometry(store, new AnchorEntityReader(store, view), id, view)?.size ?? null;
+}
+/** Atomic params-to-commit operation. Affine resizing is centred across the
+ * existing cut and held at its bottom; host thickness stays unchanged. Only
+ * the occurrence's Representation/placement/dimensions change, never its type
+ * maps, GlobalId, metadata or relationships. Refusals leave no overlay writes. */
+export function editHostedElementInStore(store, editor, id, patch) {
+    if (!['IFC2X3', 'IFC4', 'IFC4X3'].includes(store.schemaVersion ?? 'IFC4'))
+        throw new Error('Hosted edits support IFC2X3, IFC4 and IFC4X3 only');
+    for (const [name, value] of Object.entries(patch)) {
+        if (value !== undefined && (!Number.isFinite(value) || ((name === 'OverallWidth' || name === 'OverallHeight') && value <= 0))) {
+            throw new Error(`${name} must be ${name.startsWith('Overall') ? 'positive and ' : ''}finite`);
+        }
+    }
+    return editor.runAtomic(draft => {
+        const view = draft.getMutationView(), reader = new AnchorEntityReader(store, view);
+        const sizing = patch.OverallWidth !== undefined || patch.OverallHeight !== undefined;
+        const current = geometry(store, reader, id, view, sizing);
+        if (!current)
+            throw new Error(`The hosted geometry of #${id} cannot be read, so the edit is refused`);
+        const { read, cut, size } = current;
+        const host = resolveHostAnchor(store, read.hostId, view);
+        if (host.hostKind !== 'wall')
+            throw new Error('Hosted size/position edits require a wall host');
+        if (sizing && !size)
+            throw new Error('Overall dimensions apply to a hosted IfcDoor or IfcWindow');
+        const widthScale = patch.OverallWidth === undefined || !size ? 1 : patch.OverallWidth / size.OverallWidth;
+        const heightScale = patch.OverallHeight === undefined || !size ? 1 : patch.OverallHeight / size.OverallHeight;
+        const dx = patch.Offset === undefined ? 0 : toNativeLength(host, patch.Offset) - read.location[0];
+        const dz = patch.Sill === undefined ? 0 : toNativeLength(host, patch.Sill) - read.location[2];
+        const anchor = [(cut.min[0] + cut.max[0]) / 2, (cut.min[1] + cut.max[1]) / 2, cut.min[2]];
+        const proposed = {
+            min: [anchor[0] + (cut.min[0] - anchor[0]) * widthScale + dx, cut.min[1], cut.min[2] + dz],
+            max: [anchor[0] + (cut.max[0] - anchor[0]) * widthScale + dx, cut.max[1], cut.min[2] + (cut.max[2] - cut.min[2]) * heightScale + dz],
+        };
+        validateWallOpeningBounds(store, view, host, proposed, read.openingId);
+        if (widthScale !== 1 || heightScale !== 1) {
+            scaleHostedShape(reader, draft, read.openingId, current.openingFrame, anchor, widthScale, heightScale);
+            if (read.fillingId !== null && current.fillingFrame) {
+                scaleHostedShape(reader, draft, read.fillingId, current.fillingFrame, anchor, widthScale, heightScale);
+            }
+        }
+        if (read.fillingId !== null && size) {
+            const filling = reader.entity(read.fillingId);
+            for (const name of ['OverallWidth', 'OverallHeight']) {
+                const value = patch[name], index = filling.names.indexOf(name);
+                if (value !== undefined) {
+                    if (index < 0)
+                        throw new Error(`${filling.type} has no ${name} attribute in this schema`);
+                    draft.setPositionalAttribute(read.fillingId, index, toNativeLength(host, value));
+                }
+            }
+        }
+        if (dx !== 0 || dz !== 0)
+            moveHostedOpeningPlacement(reader, draft, read, [read.location[0] + dx, read.location[1], read.location[2] + dz]);
+        const updated = readHostedFill(store, id, view);
+        const actual = placedBodyExtent(store, read.openingId, view);
+        const eps = toNativeLength(host, 1e-6);
+        if (!updated || !actual || actual.min.some((value, axis) => Math.abs(value - proposed.min[axis]) > eps)
+            || actual.max.some((value, axis) => Math.abs(value - proposed.max[axis]) > eps)) {
+            throw new Error('The hosted edit cannot reproduce its validated bounds; all writes were rolled back');
+        }
+        return updated;
+    });
+}
+//# sourceMappingURL=hosted-element-edit.js.map

package/dist/in-store/hosted-element-edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-element-edit.js","sourceRoot":"","sources":["../../src/in-store/hosted-element-edit.ts"],"names":[],"mappings":"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"}

package/dist/in-store/hosted-element.d.ts

@@ -0,0 +1,41 @@
+/** Params-to-commit core for hosted placement (#6232 D5). Hosts supply their
+ * editor and history/remesh policy; the IFC graph and refusal rules live here. */
+import type { StoreEditor, MutablePropertyView } from '@ifc-lite/mutations';
+import type { IfcDataStore } from '@ifc-lite/parser';
+import { type HostAnchor, type HostBounds } from './anchor.js';
+import { type OpeningInStoreParams } from './opening.js';
+import { type HostedDoorInStoreParams, type HostedWindowInStoreParams } from './hosted-fill.js';
+import { type HostedFillRead } from './hosted-fill-read.js';
+export type HostedElementInStoreSpec = {
+    readonly kind: 'opening';
+    readonly params: OpeningInStoreParams;
+} | {
+    readonly kind: 'door';
+    readonly params: HostedDoorInStoreParams;
+} | {
+    readonly kind: 'window';
+    readonly params: HostedWindowInStoreParams;
+};
+export interface HostedElementInStoreResult {
+    readonly expressId: number;
+    readonly openingId: number;
+    readonly hostId: number;
+}
+export interface HostedOpeningExtent extends HostedFillRead {
+    /** Cut bounds in the host's placement frame, in the file's native units. */
+    readonly bounds: HostBounds;
+}
+/** Effective void relationships, including this session's creations, edits
+ * and deletions. Unreadable placement/geometry is reported rather than guessed. */
+export declare function readHostOpeningExtents(store: IfcDataStore, hostId: number, view?: MutablePropertyView | null): {
+    cuts: HostedOpeningExtent[];
+    unreadable: number[];
+};
+/** Package-private fit/overlap decision shared by placement and edits. The
+ * selected cut alone is excluded; every other unreadable cut still refuses. */
+export declare function validateWallOpeningBounds(store: IfcDataStore, view: MutablePropertyView, host: HostAnchor, proposed: HostBounds, excludeOpeningId?: number): void;
+/** Write an opening or wall-hosted filling in one atomic overlay operation.
+ * The viewer, SDK and MCP share this core; callers group its mutation records
+ * into their own undo batch. Every refusal leaves the overlay unchanged. */
+export declare function addHostedElementInStore(store: IfcDataStore, editor: StoreEditor, hostId: number, spec: HostedElementInStoreSpec): HostedElementInStoreResult;
+//# sourceMappingURL=hosted-element.d.ts.map

package/dist/in-store/hosted-element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-element.d.ts","sourceRoot":"","sources":["../../src/in-store/hosted-element.ts"],"names":[],"mappings":"AAIA;kFACkF;AAClF,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAkB,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAE/E,OAAO,EAAqB,KAAK,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAEL,KAAK,uBAAuB,EAAE,KAAK,yBAAyB,EAC7D,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAK5E,MAAM,MAAM,wBAAwB,GAChC;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,GACnE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAA;CAAE,GACnE;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAA;CAAE,CAAC;AAE5E,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAoB,SAAQ,cAAc;IACzD,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B;AAED;mFACmF;AACnF,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,mBAAmB,GAAG,IAAI,GAChC;IAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAoBvD;AAuBD;+EAC+E;AAC/E,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,mBAAmB,EACzB,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,UAAU,EACpB,gBAAgB,CAAC,EAAE,MAAM,GACxB,IAAI,CAsBN;AAED;;4EAE4E;AAC5E,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,wBAAwB,GAC7B,0BAA0B,CAqB5B"}

package/dist/in-store/hosted-element.js

@@ -0,0 +1,124 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+import { toNativeLength } from './anchor.js';
+import { assertPositiveFinite } from './_emit-helpers.js';
+import { addOpeningToStore } from './opening.js';
+import { addHostedDoorToStore, addHostedWindowToStore, } from './hosted-fill.js';
+import { readHostedFill } from './hosted-fill-read.js';
+import { AnchorEntityReader } from './resolve-anchor.js';
+import { placedBodyExtent, resolveHostAnchor } from './resolve-host.js';
+import { assertHostedGlobalIdAvailable } from './hosted-global-id.js';
+/** Effective void relationships, including this session's creations, edits
+ * and deletions. Unreadable placement/geometry is reported rather than guessed. */
+export function readHostOpeningExtents(store, hostId, view) {
+    const reader = new AnchorEntityReader(store, view);
+    const cuts = [];
+    const unreadable = [];
+    for (const id of reader.ids('IFCRELVOIDSELEMENT')) {
+        const rel = reader.entity(id);
+        if (!rel) {
+            unreadable.push(id);
+            continue;
+        }
+        const relatingHost = refId(rel.attributes[4]);
+        // An unreadable host reference cannot establish that this cut belongs to
+        // a different wall, so fail conservatively instead of skipping it.
+        if (relatingHost === null) {
+            unreadable.push(id);
+            continue;
+        }
+        if (relatingHost !== hostId)
+            continue;
+        const openingId = refId(rel.attributes[5]);
+        if (openingId === null) {
+            unreadable.push(id);
+            continue;
+        }
+        const fill = readHostedFill(store, openingId, view);
+        const bounds = fill ? placedBodyExtent(store, openingId, view) : null;
+        if (!fill || fill.hostId !== hostId || !bounds)
+            unreadable.push(openingId);
+        else
+            cuts.push({ ...fill, bounds });
+    }
+    return { cuts, unreadable };
+}
+function refId(value) {
+    if (typeof value === 'number' && Number.isInteger(value) && value > 0)
+        return value;
+    return typeof value === 'string' && /^#[1-9][0-9]*$/.test(value) ? Number(value.slice(1)) : null;
+}
+function validateWallCut(store, view, host, spec) {
+    if (host.hostKind !== 'wall')
+        return; // Slab openings retain their existing builder contract.
+    const params = spec.params;
+    if (!('Offset' in params))
+        throw new Error('Hosted wall placement requires Offset, Width and Height');
+    assertPositiveFinite([params.Width, params.Height], 'Hosted wall placement: Width and Height must be positive');
+    const sill = params.Sill ?? 0;
+    if (!Number.isFinite(params.Offset) || !Number.isFinite(sill))
+        throw new Error('Hosted wall placement: Offset and Sill must be finite');
+    const bounds = host.hostBounds;
+    if (!bounds)
+        throw new Error(`The body of host #${host.hostId} cannot be read, so hosted placement is refused`);
+    const x = toNativeLength(host, params.Offset), w = toNativeLength(host, params.Width);
+    const z = toNativeLength(host, sill), h = toNativeLength(host, params.Height);
+    validateWallOpeningBounds(store, view, host, {
+        min: [x - w / 2, bounds.min[1], z], max: [x + w / 2, bounds.max[1], z + h],
+    });
+}
+/** Package-private fit/overlap decision shared by placement and edits. The
+ * selected cut alone is excluded; every other unreadable cut still refuses. */
+export function validateWallOpeningBounds(store, view, host, proposed, excludeOpeningId) {
+    if (host.hostKind !== 'wall')
+        return;
+    if ([...proposed.min, ...proposed.max].some(value => !Number.isFinite(value))
+        || proposed.min.some((value, axis) => value >= proposed.max[axis])) {
+        throw new Error('Hosted opening bounds must be finite with positive dimensions');
+    }
+    const bounds = host.hostBounds;
+    if (!bounds)
+        throw new Error(`The body of host #${host.hostId} cannot be read, so hosted placement is refused`);
+    const eps = toNativeLength(host, 1e-6);
+    if (proposed.min[0] < bounds.min[0] - eps || proposed.max[0] > bounds.max[0] + eps
+        || proposed.min[2] < bounds.min[2] - eps || proposed.max[2] > bounds.max[2] + eps) {
+        throw new Error("It doesn't fit in this wall: change its offset or sill");
+    }
+    const existing = readHostOpeningExtents(store, host.hostId, view);
+    if (existing.unreadable.length) {
+        throw new Error(`Opening geometry ${existing.unreadable.map(id => `#${id}`).join(', ')} cannot be read, so hosted placement is refused`);
+    }
+    const overlap = existing.cuts.find(({ openingId, bounds: cut }) => openingId !== excludeOpeningId
+        && Math.min(proposed.max[0], cut.max[0]) - Math.max(proposed.min[0], cut.min[0]) > eps
+        && Math.min(proposed.max[2], cut.max[2]) - Math.max(proposed.min[2], cut.min[2]) > eps
+        && Math.min(bounds.max[1], proposed.max[1], cut.max[1]) - Math.max(bounds.min[1], proposed.min[1], cut.min[1]) > eps);
+    if (overlap)
+        throw new Error(`The new opening overlaps opening #${overlap.openingId} in wall #${host.hostId}`);
+}
+/** Write an opening or wall-hosted filling in one atomic overlay operation.
+ * The viewer, SDK and MCP share this core; callers group its mutation records
+ * into their own undo batch. Every refusal leaves the overlay unchanged. */
+export function addHostedElementInStore(store, editor, hostId, spec) {
+    const schema = store.schemaVersion ?? 'IFC4';
+    if (!['IFC2X3', 'IFC4', 'IFC4X3'].includes(schema)) {
+        throw new Error(`Hosted placement supports IFC2X3, IFC4 and IFC4X3 only; ${schema} is refused`);
+    }
+    return editor.runAtomic(draft => {
+        const view = draft.getMutationView();
+        if (spec.params.GlobalId !== undefined) {
+            assertHostedGlobalIdAvailable(store, view, spec.params.GlobalId);
+        }
+        const host = resolveHostAnchor(store, hostId, view);
+        validateWallCut(store, view, host, spec);
+        if (spec.kind === 'opening') {
+            const opening = addOpeningToStore(draft, host, spec.params);
+            return { expressId: opening.openingId, openingId: opening.openingId, hostId };
+        }
+        const fill = spec.kind === 'door'
+            ? addHostedDoorToStore(draft, host, spec.params)
+            : addHostedWindowToStore(draft, host, spec.params);
+        return { expressId: fill.fillingId, openingId: fill.opening.openingId, hostId };
+    });
+}
+//# sourceMappingURL=hosted-element.js.map

package/dist/in-store/hosted-element.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-element.js","sourceRoot":"","sources":["../../src/in-store/hosted-element.ts"],"names":[],"mappings":"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"}

package/dist/in-store/hosted-fill-read.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Live reads for wall-hosted openings, doors and windows (#6232): the host
+ * wall's frame on its storey, and where an opening sits in its host.
+ *
+ * `addOpeningToStore` places the opening relative to the host's
+ * IfcLocalPlacement with its Location at `[Offset, …, Sill]` in the host's
+ * frame, and `addHostedDoorToStore` / `addHostedWindowToStore` place the
+ * filling relative to the opening. So a placing gesture needs the host's
+ * frame to turn a cursor into `Offset`, and an edit of Offset or Sill is one
+ * write to the opening's Location point: the filling follows it.
+ *
+ * Every read goes through the mutation overlay, so a wall or opening authored
+ * this session reads like one from the file, and a deleted one is gone.
+ */
+import { type IfcDataStore } from '@ifc-lite/parser';
+import type { MutablePropertyView } from '@ifc-lite/mutations';
+export interface HostPlanFrame {
+    /** The host's placement origin, storey-local metres; z is its height above the storey's placement. */
+    origin: [number, number, number];
+    /** The host's local +X on the storey plane, unit length. */
+    axisX: [number, number];
+}
+/**
+ * The host's placement frame on storey `storeyExpressId`, composed through
+ * every `PlacementRelTo` hop the same way the storey's wall axes are
+ * (`extractWallSegmentsForStorey`), so a point read against one lines up
+ * with the other. Null when the host has no readable placement.
+ */
+export declare function hostPlanFrame(store: IfcDataStore, hostExpressId: number, storeyExpressId: number, view?: MutablePropertyView | null): HostPlanFrame | null;
+export interface HostedFillRead {
+    /** The voided wall or slab (IfcRelVoidsElement.RelatingBuildingElement). */
+    hostId: number;
+    openingId: number;
+    /** The IfcDoor / IfcWindow in the opening (IfcRelFillsElement); null for a bare opening. */
+    fillingId: number | null;
+    /** The opening placement's Location point: Offset is its x, Sill its z (native units). */
+    locationPointId: number;
+    /** Its current coordinates, native units. */
+    location: [number, number, number];
+    /** Along the host's local X to the opening's placement origin, metres (the centre, for an authored one). */
+    offset: number;
+    /** The opening's bottom above the host's placement origin, metres. */
+    sill: number;
+}
+/**
+ * Where an opening, or the door or window filling one, sits in its host.
+ * Null when `expressId` is neither, when it has no live host, or when the
+ * opening is not placed relative to its host (an absolutely placed opening
+ * has no offset along the wall to edit).
+ */
+export declare function readHostedFill(store: IfcDataStore, expressId: number, view?: MutablePropertyView | null): HostedFillRead | null;
+/** Package-private batch reader: one relation walk for any number of cuts.
+ * Reuses the single-read placement contract; source relations are indexed
+ * before the atomic writer starts moving any occurrence (#6232). */
+export declare function readHostedOpeningBatch(store: IfcDataStore, openingIds: ReadonlySet<number>, view?: MutablePropertyView | null): ReadonlyMap<number, HostedFillRead | null>;
+//# sourceMappingURL=hosted-fill-read.d.ts.map

package/dist/in-store/hosted-fill-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-fill-read.d.ts","sourceRoot":"","sources":["../../src/in-store/hosted-fill-read.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAa/D,MAAM,WAAW,aAAa;IAC5B,sGAAsG;IACtG,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,4DAA4D;IAC5D,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzB;AAQD;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,YAAY,EACnB,aAAa,EAAE,MAAM,EACrB,eAAe,EAAE,MAAM,EACvB,IAAI,CAAC,EAAE,mBAAmB,GAAG,IAAI,GAChC,aAAa,GAAG,IAAI,CAatB;AA6CD,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,4FAA4F;IAC5F,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,0FAA0F;IAC1F,eAAe,EAAE,MAAM,CAAC;IACxB,6CAA6C;IAC7C,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,4GAA4G;IAC5G,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;CACd;AAUD;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,mBAAmB,GAAG,IAAI,GAChC,cAAc,GAAG,IAAI,CAyBvB;AAED;;oEAEoE;AACpE,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,mBAAmB,GAAG,IAAI,GACtF,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC,CAoB5C"}