@ifc-lite/create 4.0.0 → 5.1.1

package/dist/in-store/edit/placement-core.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Core placement-chain reader + generic IfcProduct edits.
+ *
+ * Walks the standard product placement chain
+ *
+ *   IfcProduct → ObjectPlacement → IfcLocalPlacement
+ *              → RelativePlacement → IfcAxis2Placement3D
+ *              → Location → IfcCartesianPoint → Coordinates [x, y, z]
+ *
+ * Reads honour the `StoreEditor` overlay (overlay-only entities,
+ * named/positional mutations and current retypes on top of source-buffer entities for placement owners).
+ * Writes go through `setPositionalAttribute` so they stack with
+ * other overlay edits and participate in the standard undo path.
+ *
+ * Wall-specific edits live in `wall-edit.ts`; this module stays
+ * generic so file size + cognitive scope stay manageable.
+ */
+import { type IfcDataStore } from '@ifc-lite/parser';
+import type { MutablePropertyView, StoreEditor } from '@ifc-lite/mutations';
+/** Synchronous source decoding for headless edits. The viewer may override
+ * this reader at boot; overlay reads never require a source buffer. */
+export type SourceAttrsReader = (dataStore: IfcDataStore, expressId: number) => unknown[] | null;
+/**
+ * Override the parser-backed source reader at app boot.
+ * Pass `null` to disable source reads (used by tests).
+ */
+export declare function setSourceAttrsReader(reader: SourceAttrsReader | null): void;
+type EntityAttrs = unknown[];
+/** #7315: only native placement owners use current named/retyped fields.
+ * The general body/profile reader retains its existing positional contract. */
+export declare function readPlacementAttributes(dataStore: IfcDataStore, view: MutablePropertyView, editor: Pick<StoreEditor, 'getNewEntity'> & Partial<Pick<StoreEditor, 'getEntityType'>>, expressId: number): EntityAttrs | null;
+/**
+ * Read the effective attribute list for an express id. Overlay-only
+ * entities come from the StoreEditor; source entities come from the
+ * original buffer. Positional-mutation overrides are layered on top so
+ * a previously-translated point reads back its mutated coords.
+ */
+export declare function readAttributes(dataStore: IfcDataStore, view: MutablePropertyView, 
+/** Only its overlay lookup is read, so the view itself will do. */
+editor: Pick<StoreEditor, 'getNewEntity'>, expressId: number): EntityAttrs | null;
+/**
+ * References take two forms in our attribute graph:
+ *   - number (the parser normalises `#123` → 123 when reading source)
+ *   - string `#123` (overlay entities created via `editor.addEntity`
+ *     carry the raw `#X` form straight through)
+ * Treat both as valid so the chain walker works for source-buffer
+ * AND overlay-only entities — it's the same conceptual reference.
+ */
+export declare function asExpressIdRef(value: unknown): number | null;
+export declare function asCoordinateTriple(value: unknown): [number, number, number] | null;
+export declare function asDirectionRatios(value: unknown): [number, number, number] | null;
+export interface PlacementChain {
+    /** IfcProduct.ObjectPlacement target (IfcLocalPlacement express id). */
+    localPlacementId: number;
+    /** IfcLocalPlacement.RelativePlacement target (IfcAxis2Placement3D express id). */
+    axisPlacementId: number;
+    /** IfcAxis2Placement3D.Location target (IfcCartesianPoint express id). */
+    cartesianPointId: number;
+    /** Current coordinates on the IfcCartesianPoint (storey-local, IFC Z-up). */
+    coordinates: [number, number, number];
+}
+/**
+ * Resolve the full placement chain for an IfcProduct. Returns `null`
+ * if any link is missing or has the wrong shape — callers should treat
+ * this as "this entity's placement isn't directly translatable" and
+ * surface a clear message rather than crashing.
+ *
+ * Indices follow the IfcProduct attribute order:
+ *   [0] GlobalId · [1] OwnerHistory · [2] Name · [3] Description
+ *   [4] ObjectType · [5] ObjectPlacement · [6] Representation · ...
+ *
+ * For non-product entities (e.g. profiles, points themselves) attrs[5]
+ * either doesn't exist or isn't a placement reference, so we bail.
+ */
+export declare function resolvePlacementChain(dataStore: IfcDataStore, view: MutablePropertyView, editor: StoreEditor, expressId: number): PlacementChain | null;
+/** Pure preview shared by atomic preflight and the placement writer. */
+export declare function translatedCoordinates(coordinates: readonly number[], delta: readonly number[]): [number, number, number] | null;
+export type TranslateResult = {
+    ok: true;
+    oldCoordinates: [number, number, number];
+    newCoordinates: [number, number, number];
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Translate an IfcProduct by `delta` (storey-local IFC Z-up). Reads
+ * the current coordinates from the chain, adds the delta, writes back
+ * via `setPositionalAttribute`. Caller is responsible for batching
+ * undo (the upstream `setPositionalAttribute` action already pushes a
+ * single mutation onto the model's undo stack).
+ */
+export declare function translateProduct(dataStore: IfcDataStore, view: MutablePropertyView, editor: StoreEditor, expressId: number, delta: [number, number, number]): TranslateResult;
+/**
+ * Set the entity's position to an absolute storey-local coordinate.
+ * Convenience over `translateProduct` when the caller has a target
+ * (e.g. a numeric form bound to current coordinates).
+ */
+export declare function setProductPosition(dataStore: IfcDataStore, view: MutablePropertyView, editor: StoreEditor, expressId: number, position: [number, number, number]): TranslateResult;
+/**
+ * Snapshot of the placement's IfcAxis2Placement3D rotation.
+ * `refDirectionId === null` means the slot is implicit (STEP `$`) —
+ * the default direction `[1, 0, 0]` is reported, but callers that
+ * want to rotate must refuse this case (no IfcDirection to write to
+ * without orphaning one on undo).
+ */
+export interface RotationState {
+    axisPlacementId: number;
+    refDirectionId: number | null;
+    refDirection: [number, number, number];
+    /** Current yaw about Z (rad). */
+    yawZ: number;
+}
+export declare function resolveRotationState(dataStore: IfcDataStore, view: MutablePropertyView, editor: StoreEditor, expressId: number): RotationState | null;
+export type RotateResult = {
+    ok: true;
+    oldYawZ: number;
+    newYawZ: number;
+    newRefDirection: [number, number, number];
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Rotate an IfcProduct about the storey-up Z axis by `deltaYaw`
+ * radians. Updates RefDirection on the IfcAxis2Placement3D in place
+ * when one already exists.
+ *
+ * Refuses to operate when the placement has no explicit RefDirection
+ * (the implicit `[1, 0, 0]` STEP default). Materialising a fresh
+ * IfcDirection there would require a multi-mutation atomic undo
+ * entry to avoid orphans on undo, which the store doesn't have yet.
+ * Every entity emitted by `@ifc-lite/create`'s in-store builders
+ * carries an explicit RefDirection, so the implicit branch only
+ * trips on hand-rolled source-buffer entities — surfacing a clear
+ * refusal beats silently leaking entities.
+ */
+export declare function rotateProductYaw(dataStore: IfcDataStore, view: MutablePropertyView, editor: StoreEditor, expressId: number, deltaYaw: number): RotateResult;
+export {};
+//# sourceMappingURL=placement-core.d.ts.map

package/dist/in-store/edit/placement-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"placement-core.d.ts","sourceRoot":"","sources":["../../../src/in-store/edit/placement-core.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAiD,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACpG,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAE5E;uEACuE;AACvE,MAAM,MAAM,iBAAiB,GAAG,CAC9B,SAAS,EAAE,YAAY,EACvB,SAAS,EAAE,MAAM,KACd,OAAO,EAAE,GAAG,IAAI,CAAC;AAUtB;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,GAAG,IAAI,CAE3E;AAED,KAAK,WAAW,GAAG,OAAO,EAAE,CAAC;AAqB7B;+EAC+E;AAC/E,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAW1N;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,YAAY,EACvB,IAAI,EAAE,mBAAmB;AACzB,mEAAmE;AACnE,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,EACzC,SAAS,EAAE,MAAM,GAChB,WAAW,GAAG,IAAI,CAapB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAO5D;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CASlF;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAQjF;AAED,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,gBAAgB,EAAE,MAAM,CAAC;IACzB,mFAAmF;IACnF,eAAe,EAAE,MAAM,CAAC;IACxB,0EAA0E;IAC1E,gBAAgB,EAAE,MAAM,CAAC;IACzB,6EAA6E;IAC7E,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,YAAY,EACvB,IAAI,EAAE,mBAAmB,EACzB,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,MAAM,GAChB,cAAc,GAAG,IAAI,CA+CvB;AAED,wEAAwE;AACxE,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAG/H;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAChG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,YAAY,EACvB,IAAI,EAAE,mBAAmB,EACzB,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAC9B,eAAe,CAajB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,YAAY,EACvB,IAAI,EAAE,mBAAmB,EACzB,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GACjC,eAAe,CAYjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,YAAY,EACvB,IAAI,EAAE,mBAAmB,EACzB,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,MAAM,GAChB,aAAa,GAAG,IAAI,CAyBtB;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GACzF;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,YAAY,EACvB,IAAI,EAAE,mBAAmB,EACzB,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,YAAY,CAyBd"}

package/dist/in-store/edit/placement-core.js

@@ -0,0 +1,317 @@
+/* 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/. */
+/**
+ * Core placement-chain reader + generic IfcProduct edits.
+ *
+ * Walks the standard product placement chain
+ *
+ *   IfcProduct → ObjectPlacement → IfcLocalPlacement
+ *              → RelativePlacement → IfcAxis2Placement3D
+ *              → Location → IfcCartesianPoint → Coordinates [x, y, z]
+ *
+ * Reads honour the `StoreEditor` overlay (overlay-only entities,
+ * named/positional mutations and current retypes on top of source-buffer entities for placement owners).
+ * Writes go through `setPositionalAttribute` so they stack with
+ * other overlay edits and participate in the standard undo path.
+ *
+ * Wall-specific edits live in `wall-edit.ts`; this module stays
+ * generic so file size + cognitive scope stay manageable.
+ */
+import { EntityExtractor, resolveEffectiveEntityRecord } from '@ifc-lite/parser';
+let configuredSourceReader = (store, id) => {
+    // @raw-entity-enumeration-ok source baseline; readAttributes applies positional overlay edits
+    const byId = store.entityIndex?.byId;
+    if (!store.source?.length || !byId)
+        return null;
+    const ref = byId.get(id);
+    return ref ? new EntityExtractor(store.source).extractEntity(ref)?.attributes ?? null : null;
+};
+/**
+ * Override the parser-backed source reader at app boot.
+ * Pass `null` to disable source reads (used by tests).
+ */
+export function setSourceAttrsReader(reader) {
+    configuredSourceReader = reader;
+}
+/** Shared source callback baseline; effective placement reads add no decoder. */
+function baseAttributes(dataStore, editor, expressId) {
+    const overlay = editor.getNewEntity(expressId);
+    let attrs = null;
+    if (overlay) {
+        attrs = overlay.attributes.slice();
+    }
+    else if (configuredSourceReader) {
+        attrs = configuredSourceReader(dataStore, expressId);
+        if (!attrs)
+            return null;
+        attrs = attrs.slice();
+    }
+    else {
+        // No source reader configured and no overlay entry — typical in
+        // unit tests that don't wire `setSourceAttrsReader`. Treat as
+        // "unknown entity" so callers fall back gracefully.
+        return null;
+    }
+    return attrs;
+}
+/** #7315: only native placement owners use current named/retyped fields.
+ * The general body/profile reader retains its existing positional contract. */
+export function readPlacementAttributes(dataStore, view, editor, expressId) {
+    if (view.isDeleted(expressId))
+        return null;
+    const attributes = baseAttributes(dataStore, editor, expressId);
+    if (!attributes)
+        return null;
+    const type = editor.getNewEntity(expressId)?.type ?? dataStore.getEntity(expressId)?.type ?? editor.getEntityType?.(expressId);
+    if (!type)
+        return null;
+    return resolveEffectiveEntityRecord({ type, attributes }, {
+        retype: view.getEntityTypeMutation(expressId)?.newType,
+        named: view.getAttributeMutationsForEntity(expressId).map(({ name, value }) => [name, value]),
+        positional: view.getPositionalMutationsForEntity(expressId) ?? [],
+    }, dataStore.schemaVersion).attributes;
+}
+/**
+ * Read the effective attribute list for an express id. Overlay-only
+ * entities come from the StoreEditor; source entities come from the
+ * original buffer. Positional-mutation overrides are layered on top so
+ * a previously-translated point reads back its mutated coords.
+ */
+export function readAttributes(dataStore, view, 
+/** Only its overlay lookup is read, so the view itself will do. */
+editor, expressId) {
+    let attrs = baseAttributes(dataStore, editor, expressId);
+    if (!attrs)
+        return null;
+    // Apply positional mutations so a partially-edited entity reflects
+    // its current state (relevant when the user translates the same
+    // entity twice — the second read must see the first delta).
+    const mutated = view.getPositionalMutationsForEntity(expressId);
+    if (mutated) {
+        for (const [index, value] of mutated.entries()) {
+            attrs[index] = value;
+        }
+    }
+    return attrs;
+}
+/**
+ * References take two forms in our attribute graph:
+ *   - number (the parser normalises `#123` → 123 when reading source)
+ *   - string `#123` (overlay entities created via `editor.addEntity`
+ *     carry the raw `#X` form straight through)
+ * Treat both as valid so the chain walker works for source-buffer
+ * AND overlay-only entities — it's the same conceptual reference.
+ */
+export function asExpressIdRef(value) {
+    if (typeof value === 'number' && Number.isFinite(value))
+        return value;
+    if (typeof value === 'string' && value.startsWith('#')) {
+        const id = parseInt(value.slice(1), 10);
+        return Number.isFinite(id) ? id : null;
+    }
+    return null;
+}
+export function asCoordinateTriple(value) {
+    if (!Array.isArray(value))
+        return null;
+    if (value.length < 2)
+        return null;
+    const x = typeof value[0] === 'number' ? value[0] : NaN;
+    const y = typeof value[1] === 'number' ? value[1] : NaN;
+    // Coordinates may be 2D ([x, y]) — treat the missing Z as 0.
+    const z = value.length >= 3 && typeof value[2] === 'number' ? value[2] : 0;
+    if (Number.isNaN(x) || Number.isNaN(y))
+        return null;
+    return [x, y, z];
+}
+export function asDirectionRatios(value) {
+    if (!Array.isArray(value))
+        return null;
+    if (value.length < 2)
+        return null;
+    const x = typeof value[0] === 'number' ? value[0] : NaN;
+    const y = typeof value[1] === 'number' ? value[1] : NaN;
+    const z = value.length >= 3 && typeof value[2] === 'number' ? value[2] : 0;
+    if (Number.isNaN(x) || Number.isNaN(y))
+        return null;
+    return [x, y, z];
+}
+/**
+ * Resolve the full placement chain for an IfcProduct. Returns `null`
+ * if any link is missing or has the wrong shape — callers should treat
+ * this as "this entity's placement isn't directly translatable" and
+ * surface a clear message rather than crashing.
+ *
+ * Indices follow the IfcProduct attribute order:
+ *   [0] GlobalId · [1] OwnerHistory · [2] Name · [3] Description
+ *   [4] ObjectType · [5] ObjectPlacement · [6] Representation · ...
+ *
+ * For non-product entities (e.g. profiles, points themselves) attrs[5]
+ * either doesn't exist or isn't a placement reference, so we bail.
+ */
+export function resolvePlacementChain(dataStore, view, editor, expressId) {
+    const productAttrs = readPlacementAttributes(dataStore, view, editor, expressId);
+    if (!productAttrs)
+        return null;
+    const localPlacementId = asExpressIdRef(productAttrs[5]);
+    if (localPlacementId === null || editor.getEntityType(localPlacementId)?.toUpperCase() !== 'IFCLOCALPLACEMENT')
+        return null;
+    // This API exposes the same point to both numeric edits and the move gizmo.
+    // A child-local point below IfcGridPlacement is not a storey-local writable
+    // position: returning zero would offer a misleading edit origin (#6232).
+    // Inspect the complete parent chain so an intermediate local placement
+    // cannot hide the grid frame. File references are iterative and bounded.
+    const visited = new Set();
+    let ancestor = localPlacementId;
+    while (ancestor !== null) {
+        if (visited.size >= 10_000 || visited.has(ancestor))
+            return null;
+        visited.add(ancestor);
+        if (editor.getEntityType(ancestor)?.toUpperCase() !== 'IFCLOCALPLACEMENT')
+            return null;
+        const attrs = readPlacementAttributes(dataStore, view, editor, ancestor);
+        if (!attrs)
+            return null;
+        const parent = attrs[0];
+        ancestor = parent === null || parent === undefined ? null : asExpressIdRef(parent);
+        if (parent !== null && parent !== undefined && ancestor === null)
+            return null;
+    }
+    const localPlacementAttrs = readPlacementAttributes(dataStore, view, editor, localPlacementId);
+    if (!localPlacementAttrs)
+        return null;
+    // IfcLocalPlacement.RelativePlacement is at index 1
+    // ([0] = PlacementRelTo (parent placement)).
+    const axisPlacementId = asExpressIdRef(localPlacementAttrs[1]);
+    if (axisPlacementId === null)
+        return null;
+    const axisAttrs = readPlacementAttributes(dataStore, view, editor, axisPlacementId);
+    if (!axisAttrs)
+        return null;
+    // IfcAxis2Placement3D.Location at index 0.
+    const cartesianPointId = asExpressIdRef(axisAttrs[0]);
+    if (cartesianPointId === null)
+        return null;
+    const pointAttrs = readPlacementAttributes(dataStore, view, editor, cartesianPointId);
+    if (!pointAttrs)
+        return null;
+    const coordinates = asCoordinateTriple(pointAttrs[0]);
+    if (!coordinates)
+        return null;
+    return { localPlacementId, axisPlacementId, cartesianPointId, coordinates };
+}
+/** Pure preview shared by atomic preflight and the placement writer. */
+export function translatedCoordinates(coordinates, delta) {
+    const next = [coordinates[0] + delta[0], coordinates[1] + delta[1], coordinates[2] + delta[2]];
+    return delta.every(Number.isFinite) && next.every(Number.isFinite) ? next : null;
+}
+/**
+ * Translate an IfcProduct by `delta` (storey-local IFC Z-up). Reads
+ * the current coordinates from the chain, adds the delta, writes back
+ * via `setPositionalAttribute`. Caller is responsible for batching
+ * undo (the upstream `setPositionalAttribute` action already pushes a
+ * single mutation onto the model's undo stack).
+ */
+export function translateProduct(dataStore, view, editor, expressId, delta) {
+    const chain = resolvePlacementChain(dataStore, view, editor, expressId);
+    if (!chain) {
+        return {
+            ok: false,
+            reason: 'Entity placement is not a simple IfcLocalPlacement → IfcAxis2Placement3D → IfcCartesianPoint chain',
+        };
+    }
+    const next = translatedCoordinates(chain.coordinates, delta);
+    if (!next)
+        return { ok: false, reason: 'Placement translation overflow: derived coordinates must be finite' };
+    editor.setPositionalAttribute(chain.cartesianPointId, 0, next);
+    return { ok: true, oldCoordinates: chain.coordinates, newCoordinates: next };
+}
+/**
+ * Set the entity's position to an absolute storey-local coordinate.
+ * Convenience over `translateProduct` when the caller has a target
+ * (e.g. a numeric form bound to current coordinates).
+ */
+export function setProductPosition(dataStore, view, editor, expressId, position) {
+    const chain = resolvePlacementChain(dataStore, view, editor, expressId);
+    if (!chain) {
+        return {
+            ok: false,
+            reason: 'Entity placement is not a simple IfcLocalPlacement → IfcAxis2Placement3D → IfcCartesianPoint chain',
+        };
+    }
+    if (!position.every(Number.isFinite))
+        return { ok: false, reason: 'Placement coordinates must be finite' };
+    editor.setPositionalAttribute(chain.cartesianPointId, 0, position);
+    return { ok: true, oldCoordinates: chain.coordinates, newCoordinates: position };
+}
+export function resolveRotationState(dataStore, view, editor, expressId) {
+    const chain = resolvePlacementChain(dataStore, view, editor, expressId);
+    if (!chain)
+        return null;
+    const axisAttrs = readPlacementAttributes(dataStore, view, editor, chain.axisPlacementId);
+    if (!axisAttrs)
+        return null;
+    // IfcAxis2Placement3D index 2 = RefDirection (an optional IfcDirection ref).
+    const refDirectionId = asExpressIdRef(axisAttrs[2]);
+    if (refDirectionId === null) {
+        return {
+            axisPlacementId: chain.axisPlacementId,
+            refDirectionId: null,
+            refDirection: [1, 0, 0],
+            yawZ: 0,
+        };
+    }
+    const dirAttrs = readPlacementAttributes(dataStore, view, editor, refDirectionId);
+    if (!dirAttrs)
+        return null;
+    // IfcDirection index 0 = DirectionRatios (list of doubles).
+    const ratios = asDirectionRatios(dirAttrs[0]);
+    if (!ratios)
+        return null;
+    // Yaw about Z derived from the in-plane direction. Numerically
+    // stable for any unit-length input; for non-unit inputs we still
+    // recover the angle from atan2.
+    const yawZ = Math.atan2(ratios[1], ratios[0]);
+    return { axisPlacementId: chain.axisPlacementId, refDirectionId, refDirection: ratios, yawZ };
+}
+/**
+ * Rotate an IfcProduct about the storey-up Z axis by `deltaYaw`
+ * radians. Updates RefDirection on the IfcAxis2Placement3D in place
+ * when one already exists.
+ *
+ * Refuses to operate when the placement has no explicit RefDirection
+ * (the implicit `[1, 0, 0]` STEP default). Materialising a fresh
+ * IfcDirection there would require a multi-mutation atomic undo
+ * entry to avoid orphans on undo, which the store doesn't have yet.
+ * Every entity emitted by `@ifc-lite/create`'s in-store builders
+ * carries an explicit RefDirection, so the implicit branch only
+ * trips on hand-rolled source-buffer entities — surfacing a clear
+ * refusal beats silently leaking entities.
+ */
+export function rotateProductYaw(dataStore, view, editor, expressId, deltaYaw) {
+    const state = resolveRotationState(dataStore, view, editor, expressId);
+    if (!state) {
+        return {
+            ok: false,
+            reason: 'Entity placement is not a simple IfcLocalPlacement → IfcAxis2Placement3D chain',
+        };
+    }
+    if (state.refDirectionId === null) {
+        return {
+            ok: false,
+            reason: 'Entity has an implicit reference direction; rotation requires an explicit IfcDirection on its axis placement.',
+        };
+    }
+    const newYaw = state.yawZ + deltaYaw;
+    const newRatios = [
+        Math.cos(newYaw),
+        Math.sin(newYaw),
+        state.refDirection[2],
+    ];
+    if (!Number.isFinite(newYaw) || !newRatios.every(Number.isFinite))
+        return { ok: false, reason: 'Placement rotation overflow: derived direction must be finite' };
+    editor.setPositionalAttribute(state.refDirectionId, 0, newRatios);
+    return { ok: true, oldYawZ: state.yawZ, newYawZ: newYaw, newRefDirection: newRatios };
+}
+//# sourceMappingURL=placement-core.js.map

package/dist/in-store/edit/placement-core.js.map

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

package/dist/in-store/edit/polygon-clip.d.ts

@@ -0,0 +1,58 @@
+/**
+ * 2D polygon half-plane clipping. Used by slab / roof / plate /
+ * space split to divide a footprint polygon into two halves by a
+ * cut line.
+ *
+ * The cut line is defined by two points in the polygon's local
+ * plane. We derive the line's normal (rotated 90° CCW from the
+ * direction) and use it to assign each polygon vertex to one of
+ * the two half-planes. Sutherland-Hodgman-style edge walk
+ * produces the clipped polygon for each side; the union of the
+ * two output polygons reconstructs the input (minus any sliver
+ * vertices that landed exactly on the cut line, which both halves
+ * include as boundary).
+ *
+ * Returns:
+ *
+ *   - `{ ok: true, left, right }` when the cut intersects the
+ *     polygon and both halves have ≥ 3 vertices (a valid polygon).
+ *   - `{ ok: false, reason }` when the cut misses the polygon, is
+ *     tangent to a single vertex, or produces a degenerate sliver
+ *     (< 3 vertices on either side).
+ *
+ * "Left" / "right" naming follows the cut-line direction: walking
+ * from A to B, "left" is the half-plane on the user's left
+ * (positive cross product of (B-A) with (vertex-A)).
+ */
+export type Point2D = [number, number];
+export type PolygonClipResult = {
+    ok: true;
+    left: Point2D[];
+    right: Point2D[];
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Split a polygon into two halves by a cut line.
+ *
+ * Inputs:
+ *   - `polygon` — outer curve as an ordered list of 2D vertices
+ *     (CW or CCW; the algorithm is orientation-independent).
+ *     First vertex should NOT repeat at the end.
+ *   - `a`, `b` — two points defining the cut line. The line
+ *     extends infinitely in both directions through these points,
+ *     so the user-clicked endpoints don't need to lie on the
+ *     polygon edge.
+ *
+ * Returns `{ ok: true, left, right }` when both halves are valid
+ * polygons (≥ 3 vertices). Otherwise returns `{ ok: false, reason }`.
+ */
+export declare function clipPolygonByLine(polygon: Point2D[], a: Point2D, b: Point2D): PolygonClipResult;
+/**
+ * Test helper: is `p` strictly inside `polygon` (ray-cast). Used by
+ * the slab-split tool to figure out which half the user clicked on
+ * after committing the cut, so we can move selection to that half.
+ */
+export declare function pointInPolygon(polygon: Point2D[], p: Point2D): boolean;
+//# sourceMappingURL=polygon-clip.d.ts.map

package/dist/in-store/edit/polygon-clip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polygon-clip.d.ts","sourceRoot":"","sources":["../../../src/in-store/edit/polygon-clip.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEvC,MAAM,MAAM,iBAAiB,GACzB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,EAAE,CAAC;IAAC,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,GAC/C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AA4FlC;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,OAAO,EAAE,EAClB,CAAC,EAAE,OAAO,EACV,CAAC,EAAE,OAAO,GACT,iBAAiB,CA+BnB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CActE"}