@ifc-lite/create 3.2.0 → 4.0.0

package/dist/in-store/stair-edit.js

@@ -0,0 +1,190 @@
+/* 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 { AnchorEntityReader } from './resolve-anchor.js';
+import { axis3d, contextDimension, pointOf, refId } from './host-geometry-frame.js';
+import { safeLengthUnitScale } from './length-unit-scale.js';
+import { toNativeLength } from './anchor.js';
+import { assertStairParams, emitStairFlightBody, stairFlightOutline } from './stair.js';
+const close = (a, b) => Math.abs(a - b) <= 1e-7 * Math.max(1, Math.abs(a), Math.abs(b));
+const vectorIs = (a, b) => a.every((v, i) => close(v, b[i]));
+const ref = (id) => `#${id}`;
+// schemaAttributes emits explicit REAL wrappers; parsed source is numeric.
+function number(value) {
+    const raw = typeof value === 'object' && value !== null && 'real' in value ? value.real : value;
+    return typeof raw === 'number' && Number.isFinite(raw) ? raw : null;
+}
+function read(store, reader, id) {
+    if (!['IFC2X3', 'IFC4', 'IFC4X3'].includes(store.schemaVersion ?? 'IFC4'))
+        return null;
+    const selected = reader.entity(id);
+    if (!selected || !['IFCSTAIR', 'IFCSTAIRFLIGHT'].includes(selected.type.toUpperCase()))
+        return null;
+    const parents = [];
+    const aggregateCounts = new Map();
+    for (const relId of reader.ids('IFCRELAGGREGATES')) {
+        const rel = reader.entity(relId);
+        const parentId = rel ? refId(rel.attributes[4]) : null;
+        const members = rel?.attributes[5];
+        if (parentId !== null)
+            aggregateCounts.set(parentId, (aggregateCounts.get(parentId) ?? 0) + 1);
+        if (!Array.isArray(members))
+            continue;
+        if (parentId !== id && !members.some(v => refId(v) === id))
+            continue;
+        if (members.length !== 1 || parentId === null)
+            return null;
+        const flightId = refId(members[0]);
+        if (flightId === null || reader.entity(parentId)?.type.toUpperCase() !== 'IFCSTAIR'
+            || reader.entity(flightId)?.type.toUpperCase() !== 'IFCSTAIRFLIGHT')
+            return null;
+        parents.push({ stairId: parentId, flightId });
+    }
+    if (parents.length !== 1)
+        return null;
+    const { stairId, flightId } = parents[0];
+    if (aggregateCounts.get(stairId) !== 1)
+        return null;
+    const stair = reader.entity(stairId), flight = reader.entity(flightId);
+    // The parent must have no competing body; both placements must be rigid.
+    if (stair.attributes[6] !== null && stair.attributes[6] !== undefined)
+        return null;
+    for (const product of [stair, flight]) {
+        const placementId = refId(product.attributes[5]);
+        const placement = placementId === null ? null : reader.entity(placementId);
+        const axisId = placement ? refId(placement.attributes[1]) : null;
+        if (placement?.type.toUpperCase() !== 'IFCLOCALPLACEMENT' || axisId === null || !axis3d(reader, axisId))
+            return null;
+    }
+    const flightPlacement = reader.entity(refId(flight.attributes[5]));
+    if (refId(flightPlacement.attributes[0]) !== refId(stair.attributes[5]))
+        return null;
+    const attribute = (name) => flight.attributes[flight.names.indexOf(name)];
+    const n = number(attribute(store.schemaVersion === 'IFC2X3' ? 'NumberOfRiser' : 'NumberOfRisers'));
+    const r = number(attribute('RiserHeight')), t = number(attribute('TreadLength'));
+    if (typeof n !== 'number' || !Number.isInteger(n) || n < 1 || n > 4998 || attribute('NumberOfTreads') !== n
+        || typeof r !== 'number' || !Number.isFinite(r) || r <= 0
+        || typeof t !== 'number' || !Number.isFinite(t) || t <= 0)
+        return null;
+    const shapeId = refId(flight.attributes[6]), shape = shapeId === null ? null : reader.entity(shapeId);
+    const reps = shape?.attributes[2];
+    if (shape?.type.toUpperCase() !== 'IFCPRODUCTDEFINITIONSHAPE' || !Array.isArray(reps) || reps.length !== 1)
+        return null;
+    const repId = refId(reps[0]), rep = repId === null ? null : reader.entity(repId);
+    const contextId = rep ? refId(rep.attributes[0]) : null;
+    const items = rep?.attributes[3];
+    if (rep?.type.toUpperCase() !== 'IFCSHAPEREPRESENTATION' || rep.attributes[1] !== 'Body'
+        || rep.attributes[2] !== 'SweptSolid' || contextId === null || contextDimension(reader, contextId) !== 3
+        || !Array.isArray(items) || items.length !== 1)
+        return null;
+    const solidId = refId(items[0]), solid = solidId === null ? null : reader.entity(solidId);
+    if (solid?.type.toUpperCase() !== 'IFCEXTRUDEDAREASOLID')
+        return null;
+    const width = number(solid.attributes[3]);
+    if (typeof width !== 'number' || !Number.isFinite(width) || width <= 0)
+        return null;
+    const frame = axis3d(reader, solid.attributes[1]);
+    const extrusion = pointOf(reader, solid.attributes[2], 'IFCDIRECTION');
+    if (!frame || !vectorIs(frame.o, [0, width, 0]) || !vectorIs(frame.x, [1, 0, 0])
+        || !vectorIs(frame.y, [0, 0, 1]) || !vectorIs(frame.z, [0, -1, 0])
+        || !extrusion || !vectorIs(extrusion, [0, 0, 1]))
+        return null;
+    const profileId = refId(solid.attributes[0]), profile = profileId === null ? null : reader.entity(profileId);
+    if (profile?.type.toUpperCase() !== 'IFCARBITRARYCLOSEDPROFILEDEF' || profile.attributes[0] !== '.AREA.'
+        || (profile.attributes[1] !== null && profile.attributes[1] !== undefined && typeof profile.attributes[1] !== 'string'))
+        return null;
+    const curveId = refId(profile.attributes[2]), curve = curveId === null ? null : reader.entity(curveId);
+    const refs = curve?.attributes[0];
+    if (curve?.type.toUpperCase() !== 'IFCPOLYLINE' || !Array.isArray(refs)
+        || (refs.length !== 2 * n + 3 && refs.length !== 2 * n + 4))
+        return null;
+    const points = refs.map(v => pointOf(reader, v, 'IFCCARTESIANPOINT', 2));
+    if (points.some(p => p === null))
+        return null;
+    const p = points;
+    // Only the exact builder outline is editable. The pitch underside encodes
+    // waist thickness geometrically; optional native stair attributes do not.
+    const waist = refs.length === 2 * n + 4 ? (n * r - p[1][1]) * t / Math.hypot(r, t) : undefined;
+    if (waist !== undefined && (!Number.isFinite(waist) || waist <= 0))
+        return null;
+    const outline = stairFlightOutline(n, r, t, waist);
+    const closed = [...outline, outline[0]];
+    if (p.length !== closed.length || p.some((v, i) => !close(v[0], closed[i][0]) || !close(v[1], closed[i][1])))
+        return null;
+    const scale = safeLengthUnitScale(store.source, store.entityIndex, 'readStairDimensions');
+    if (scale === null)
+        return null;
+    const dimensions = {
+        stairId, flightId, NumberOfRisers: n, Width: width * scale,
+        RiserHeight: r * scale, TreadLength: t * scale,
+        ...(waist === undefined ? {} : { WaistThickness: waist * scale }),
+    };
+    return { dimensions, scale, flight, shape, rep, solidId: solidId, profileId: profileId, profile };
+}
+/** Parent and flight resolve to the same strict, single-flight dimensions. */
+export function readStairDimensions(store, id, view) {
+    return read(store, new AnchorEntityReader(store, view), id)?.dimensions ?? null;
+}
+/** Rebuild only the occurrence's canonical stepped body. Placements, the
+ * first-riser foot, identities, type/style leaves and source bodies stay held.
+ * RiserHeight changes the total rise; TreadLength changes the total run.
+ * Atomic refusal for unsupported graphs or dimensions, including late errors. */
+export function editStairDimensionsInStore(store, editor, id, patch) {
+    return editor.runAtomic(draft => {
+        const reader = new AnchorEntityReader(store, draft.getMutationView());
+        const current = read(store, reader, id);
+        if (!current)
+            throw new Error(`The stair #${id} is not a supported single stepped flight`);
+        const fields = ['Width', 'RiserHeight', 'TreadLength', 'WaistThickness'];
+        for (const [name, value] of Object.entries(patch)) {
+            if (!fields.some(field => field === name))
+                throw new Error(`Unsupported stair dimension ${name}`);
+            if (value !== undefined && (typeof value !== 'number' || !Number.isFinite(value) || value <= 0)) {
+                throw new Error(`${name} must be a finite positive number`);
+            }
+        }
+        const next = { ...current.dimensions };
+        for (const field of fields)
+            if (patch[field] !== undefined)
+                next[field] = patch[field];
+        assertStairParams({ ...next, Position: [0, 0, 0] }, 'editStairDimensionsInStore');
+        const native = (metres) => toNativeLength({ lengthUnitScale: current.scale }, metres);
+        const body = emitStairFlightBody(draft, next.NumberOfRisers, native(next.RiserHeight), native(next.TreadLength), native(next.Width), next.WaistThickness === undefined ? undefined : native(next.WaistThickness));
+        // Clone style attachments, retaining their shared style leaves; never
+        // repoint an attachment that may also style a different occurrence.
+        for (const styleId of reader.ids('IFCSTYLEDITEM')) {
+            const style = reader.entity(styleId);
+            const item = refId(style.attributes[0]);
+            const target = item === current.solidId ? body.solidId : item === current.profileId ? body.profileId : null;
+            if (target === null)
+                continue;
+            const styles = style.attributes[1];
+            if (!Array.isArray(styles) || styles.length === 0 || styles.some(v => refId(v) === null))
+                throw new Error('Unreadable stair style attachment');
+            const name = style.attributes[2];
+            if (name !== null && name !== undefined && typeof name !== 'string')
+                throw new Error('Unreadable stair style name');
+            draft.addEntity('IfcStyledItem', [ref(target), styles.map(v => ref(refId(v))), name ?? null]);
+        }
+        draft.setPositionalAttribute(body.profileId, 1, current.profile.attributes[1]);
+        const rep = draft.addEntity('IfcShapeRepresentation', [
+            ref(refId(current.rep.attributes[0])), current.rep.attributes[1],
+            current.rep.attributes[2], [ref(body.solidId)],
+        ]).expressId;
+        const labels = current.shape.attributes.slice(0, 2).map(v => {
+            if (v !== null && v !== undefined && typeof v !== 'string')
+                throw new Error('Unreadable stair shape label');
+            return v ?? null;
+        });
+        const shape = draft.addEntity('IfcProductDefinitionShape', [...labels, [ref(rep)]]).expressId;
+        draft.setPositionalAttribute(next.flightId, 6, ref(shape));
+        for (const name of ['RiserHeight', 'TreadLength']) {
+            draft.setPositionalAttribute(next.flightId, current.flight.names.indexOf(name), { real: native(next[name]) });
+        }
+        const updated = readStairDimensions(store, next.flightId, draft.getMutationView());
+        if (!updated)
+            throw new Error('The stair edit cannot reproduce its validated flight; all writes were rolled back');
+        return updated;
+    });
+}
+//# sourceMappingURL=stair-edit.js.map

package/dist/in-store/stair-edit.js.map

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

package/dist/in-store/stair.d.ts

@@ -0,0 +1,58 @@
+import type { StoreEditor } from '@ifc-lite/mutations';
+import { type SpatialAnchor } from './anchor.js';
+export interface StairInStoreParams {
+    /** Foot of the first riser, storey-local (metres). */
+    Position: [number, number, number];
+    /** Run direction in the XY plane, radians (0 = +X). Default 0. */
+    Direction?: number;
+    /** Number of risers (a positive integer). */
+    NumberOfRisers: number;
+    /** Riser height (metres). */
+    RiserHeight: number;
+    /** Tread length / going (metres). */
+    TreadLength: number;
+    /** Clear width across the run (metres). */
+    Width: number;
+    /**
+     * Waist thickness measured perpendicular to the pitch line (metres). When
+     * set the flight's underside follows the pitch; omitted, the flight is solid
+     * down to its base. Must leave material under the top tread.
+     */
+    WaistThickness?: number;
+    /** IfcStair PredefinedType / ShapeType. Default `STRAIGHT_RUN_STAIR`. */
+    PredefinedType?: string;
+    Name?: string;
+    Description?: string;
+    ObjectType?: string;
+    Tag?: string;
+    /** Explicit GlobalId for the IfcStair (22-char IFC GUID); generated when omitted. */
+    GlobalId?: string;
+    /** Explicit GlobalId for the IfcStairFlight; generated when omitted. */
+    FlightGlobalId?: string;
+}
+export interface StairBuildResult {
+    stairId: number;
+    flightId: number;
+    placementId: number;
+    flightPlacementId: number;
+    profileId: number;
+    solidId: number;
+    shapeRepId: number;
+    productShapeId: number;
+    relAggregatesId: number;
+    relContainedId: number;
+}
+/**
+ * The flight's side outline in (run, rise) coordinates, native units: the
+ * stepped top, then the underside. Counter-clockwise.
+ */
+export declare function stairFlightOutline(risers: number, riser: number, tread: number, waist?: number): Array<[number, number]>;
+/** Package-private validation shared by creation and occurrence edits. */
+export declare function assertStairParams(params: StairInStoreParams, op: string): void;
+export declare function addStairToStore(editor: StoreEditor, anchor: SpatialAnchor, params: StairInStoreParams): StairBuildResult;
+/** The canonical stepped solid, in native units; package-private. */
+export declare function emitStairFlightBody(editor: StoreEditor, risers: number, riser: number, tread: number, width: number, waist?: number): {
+    profileId: number;
+    solidId: number;
+};
+//# sourceMappingURL=stair.d.ts.map

package/dist/in-store/stair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stair.d.ts","sourceRoot":"","sources":["../../src/in-store/stair.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,EAAkC,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAcjF,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GACb,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAiBzB;AAED,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAmB9E;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,kBAAkB,GACzB,gBAAgB,CAoFlB;AAED,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;;;EAgBnI"}

package/dist/in-store/stair.js

@@ -0,0 +1,156 @@
+/* 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/. */
+/**
+ * Anchored builder for a straight-run stair (#6232): an IfcStair contained in
+ * the storey, aggregating one IfcStairFlight that carries the body.
+ *
+ * Same footprint as `IfcCreator.addIfcStair` (`Position` is the foot of the
+ * first riser, the run goes along local +X rotated by `Direction`, the width
+ * spans local +Y, step i covers x in [i·T, (i+1)·T] and rises to (i+1)·R), but
+ * the body is one extruded stepped profile instead of one box per riser: a
+ * single IfcArbitraryClosedProfileDef in the stair's XZ plane, extruded across
+ * the width. With `WaistThickness` the underside follows the pitch line (a
+ * cast-in-place flight); without it the flight is solid down to its base, the
+ * volume IfcCreator's stacked treads enclose.
+ *
+ * The IfcStair itself has no representation: its geometry is its flight's,
+ * which is how IFC4 decomposes a stair (IfcRelAggregates, stair -> flight).
+ * The flight's placement is relative to the stair's, so moving the stair
+ * moves the flight.
+ *
+ * Schema gating (D2): attributes are laid out from the target schema's
+ * registry, so IFC2X3 gets `IfcStair.ShapeType` and
+ * `IfcStairFlight.NumberOfRiser` (its spelling) with no flight PredefinedType,
+ * IFC4/IFC4X3 get `PredefinedType`s, and IFC5 is refused.
+ */
+import { generateIfcGuid } from '@ifc-lite/encoding';
+import { assertFinitePoint3 } from '../ifc-creator-math.js';
+import { toNativeLength, toNativePoint3 } from './anchor.js';
+import { assertPositiveFinite, emitBodyRepresentation, emitLocalPlacement, emitPolygonProfile, emitRelContainedInSpatialStructure, ownerHistoryRef, productGuid, } from './_emit-helpers.js';
+import { schemaAttributes, schemaRegistry } from './schema-attributes.js';
+/**
+ * The flight's side outline in (run, rise) coordinates, native units: the
+ * stepped top, then the underside. Counter-clockwise.
+ */
+export function stairFlightOutline(risers, riser, tread, waist) {
+    const top = [[0, 0]];
+    for (let i = 0; i < risers; i++) {
+        top.push([i * tread, (i + 1) * riser], [(i + 1) * tread, (i + 1) * riser]);
+    }
+    const run = risers * tread;
+    const rise = risers * riser;
+    if (waist === undefined) {
+        // Solid to the base: down the back, along the floor.
+        return [...top, [run, 0]].reverse();
+    }
+    // Underside parallel to the pitch line z = x·R/T, `waist` below it
+    // (perpendicular), i.e. a vertical drop of waist / cos(pitch).
+    const drop = waist * Math.hypot(riser, tread) / tread;
+    const foot = drop * tread / riser; // where the underside meets the floor
+    const underside = [[run, rise - drop], [foot, 0]];
+    return [...top, ...underside].reverse();
+}
+/** Package-private validation shared by creation and occurrence edits. */
+export function assertStairParams(params, op) {
+    assertFinitePoint3({ Position: params.Position }, op);
+    if (!Number.isInteger(params.NumberOfRisers) || params.NumberOfRisers < 1) {
+        throw new Error(`${op}: NumberOfRisers must be a positive integer`);
+    }
+    assertPositiveFinite([params.RiserHeight, params.TreadLength, params.Width], `${op}: RiserHeight, TreadLength and Width must be finite positive numbers`);
+    if (params.Direction !== undefined && !Number.isFinite(params.Direction)) {
+        throw new Error(`${op}: Direction must be a finite number (radians)`);
+    }
+    if (params.WaistThickness !== undefined) {
+        assertPositiveFinite([params.WaistThickness], `${op}: WaistThickness must be a finite positive number`);
+        const drop = params.WaistThickness * Math.hypot(params.RiserHeight, params.TreadLength) / params.TreadLength;
+        if (drop >= params.NumberOfRisers * params.RiserHeight) {
+            throw new Error(`${op}: WaistThickness is too thick for a flight of this height`);
+        }
+    }
+}
+export function addStairToStore(editor, anchor, params) {
+    const op = 'addStairToStore';
+    assertStairParams(params, op);
+    const registry = schemaRegistry(anchor.schema, op);
+    const isIfc2x3 = registry.name.toUpperCase() === 'IFC2X3';
+    const shapeType = params.PredefinedType ?? 'STRAIGHT_RUN_STAIR';
+    const stairGuid = productGuid(params, anchor.guidRandom);
+    const flightGuid = productGuid({ GlobalId: params.FlightGlobalId }, anchor.guidRandom);
+    const stairValues = (placement) => ({
+        GlobalId: stairGuid,
+        OwnerHistory: ownerHistoryRef(anchor.ownerHistoryId),
+        Name: params.Name ?? 'Stair',
+        Description: params.Description,
+        ObjectType: params.ObjectType,
+        ObjectPlacement: placement,
+        Tag: params.Tag,
+        [isIfc2x3 ? 'ShapeType' : 'PredefinedType']: shapeType,
+    });
+    // Lay the stair record out once before the first emit, so a bad
+    // PredefinedType or a missing IFC2X3 OwnerHistory refuses cleanly.
+    schemaAttributes(registry, 'IfcStair', stairValues(null), op);
+    const riser = toNativeLength(anchor, params.RiserHeight);
+    const tread = toNativeLength(anchor, params.TreadLength);
+    const width = toNativeLength(anchor, params.Width);
+    const waist = params.WaistThickness === undefined ? undefined : toNativeLength(anchor, params.WaistThickness);
+    const direction = params.Direction ?? 0;
+    // Stair placement: at Position, local X along the run. Written with
+    // explicit axes so the stair can be turned later (rotateEntity edits the
+    // RefDirection).
+    const placementId = emitLocalPlacement(editor, anchor.storeyPlacementId, toNativePoint3(anchor, params.Position), [0, 0, 1], [Math.cos(direction), Math.sin(direction), 0]);
+    const flightPlacementId = emitLocalPlacement(editor, placementId, [0, 0, 0]);
+    const { profileId, solidId } = emitStairFlightBody(editor, params.NumberOfRisers, riser, tread, width, waist);
+    const { shapeRepId, productShapeId } = emitBodyRepresentation(editor, anchor.bodyContextId, solidId);
+    const stairId = editor.addEntity('IfcStair', schemaAttributes(registry, 'IfcStair', stairValues(`#${placementId}`), op)).expressId;
+    const flightId = editor.addEntity('IfcStairFlight', schemaAttributes(registry, 'IfcStairFlight', {
+        GlobalId: flightGuid,
+        OwnerHistory: ownerHistoryRef(anchor.ownerHistoryId),
+        Name: `${params.Name ?? 'Stair'} Flight`,
+        ObjectPlacement: `#${flightPlacementId}`,
+        Representation: `#${productShapeId}`,
+        [isIfc2x3 ? 'NumberOfRiser' : 'NumberOfRisers']: params.NumberOfRisers,
+        NumberOfTreads: params.NumberOfRisers,
+        RiserHeight: riser,
+        TreadLength: tread,
+        ...(isIfc2x3 ? {} : { PredefinedType: 'STRAIGHT' }),
+    }, op)).expressId;
+    const relAggregatesId = editor.addEntity('IfcRelAggregates', schemaAttributes(registry, 'IfcRelAggregates', {
+        GlobalId: generateIfcGuid(anchor.guidRandom),
+        OwnerHistory: ownerHistoryRef(anchor.ownerHistoryId),
+        RelatingObject: `#${stairId}`,
+        RelatedObjects: [`#${flightId}`],
+    }, op)).expressId;
+    const relContainedId = emitRelContainedInSpatialStructure(editor, anchor.ownerHistoryId, stairId, anchor.storeyId, anchor.guidRandom);
+    return {
+        stairId,
+        flightId,
+        placementId,
+        flightPlacementId,
+        profileId,
+        solidId,
+        shapeRepId,
+        productShapeId,
+        relAggregatesId,
+        relContainedId,
+    };
+}
+/** The canonical stepped solid, in native units; package-private. */
+export function emitStairFlightBody(editor, risers, riser, tread, width, waist) {
+    // The stepped side outline lies in the solid's XY plane. The solid's frame
+    // maps profile X -> stair +X (run) and profile Y -> stair +Z (rise) with
+    // extrusion along -Y, from y = width, so the flight spans y in [0, width].
+    const profileId = emitPolygonProfile(editor, stairFlightOutline(risers, riser, tread, waist));
+    const solidOrigin = editor.addEntity('IfcCartesianPoint', [[0, width, 0]]).expressId;
+    const solidAxis = editor.addEntity('IfcDirection', [[0, -1, 0]]).expressId;
+    const solidRef = editor.addEntity('IfcDirection', [[1, 0, 0]]).expressId;
+    const solidPosition = editor.addEntity('IfcAxis2Placement3D', [
+        `#${solidOrigin}`, `#${solidAxis}`, `#${solidRef}`,
+    ]).expressId;
+    const extrusion = editor.addEntity('IfcDirection', [[0, 0, 1]]).expressId;
+    const solidId = editor.addEntity('IfcExtrudedAreaSolid', [
+        `#${profileId}`, `#${solidPosition}`, `#${extrusion}`, width,
+    ]).expressId;
+    return { profileId, solidId };
+}
+//# sourceMappingURL=stair.js.map

package/dist/in-store/stair.js.map

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

package/dist/in-store/wall-join-apply.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Apply a wall join (`computeWallJoin`) to two walls in the store: rewrite each
+ * joined wall's body profile and `Axis` representation, and write the
+ * `IfcRelConnectsPathElements` between them (#6232 D1).
+ *
+ * The wall's ObjectPlacement is left where it is. A join only moves an axis end
+ * along the axis, so the wall frame (origin, +X along the axis) stays valid,
+ * and openings placed relative to the wall keep their position. The new body
+ * and axis are written in that frame, offset by where the new Start sits in it.
+ * That is why a target carries `origin`: the plan point of the placement
+ * origin, which is the wall's Start until a join moves Start.
+ *
+ * Only the entities the wall owns are replaced: a new profile goes into the
+ * existing IfcExtrudedAreaSolid.SweptArea, a new Axis representation replaces
+ * the old one in IfcProductDefinitionShape.Representations. The old profile and
+ * axis are removed when this session created them (overlay entities), and left
+ * to the exporter otherwise.
+ *
+ * Pure: writes through the editor only.
+ */
+import type { StoreEditor } from '@ifc-lite/mutations';
+import type { SpatialAnchor } from './anchor.js';
+import { type WallBuildResult, type WallInStoreParams } from './wall.js';
+import { type PlanPoint, type WallJoin, type WallJoinOptions, type WallJoinWall } from './wall-join.js';
+/** A wall in the store, with the ids a join rewrites and its current plan shape. */
+export interface WallJoinTarget {
+    wallId: number;
+    /** IfcExtrudedAreaSolid of the Body; its SweptArea is replaced. */
+    solidId: number;
+    /** The profile the solid sweeps now. */
+    profileId: number;
+    /** IfcProductDefinitionShape of the wall. */
+    productShapeId: number;
+    /** Its current Representations, in order. */
+    representationIds: readonly number[];
+    /** The current `Axis` representation, when the wall has one (it is replaced, else a new one is appended). */
+    axisRepId: number | null;
+    /** Plan point (metres) of the wall's placement origin; the placement's +X runs along the axis. */
+    origin: PlanPoint;
+    /** The wall's current plan shape, metres. */
+    wall: WallJoinWall;
+}
+export interface WallJoinApplyResult {
+    join: WallJoin;
+    /** The IfcRelConnectsPathElements written. */
+    relId: number;
+    /** The walls after the join, ready to take part in a next join. */
+    a: WallJoinTarget;
+    b: WallJoinTarget;
+}
+export interface WallJoinApplyOptions extends WallJoinOptions {
+    /** Layer priorities for the relationship, by wall. Default empty. */
+    priorities?: {
+        a?: readonly number[];
+        b?: readonly number[];
+    };
+    /** Name for the IfcRelConnectsPathElements. */
+    Name?: string;
+}
+export type JoinAnchor = Pick<SpatialAnchor, 'ownerHistoryId' | 'axisContextId' | 'schema' | 'lengthUnitScale' | 'guidRandom'>;
+/** The join target for a wall `addWallToStore` just built from `params`. */
+export declare function wallJoinTargetFromBuild(build: WallBuildResult, params: WallInStoreParams): WallJoinTarget;
+/**
+ * Join walls `a` and `b` in the store. See `computeWallJoin` for the geometry
+ * and `options`. Refuses IFC5 / IFCX anchors; IFC2X3, IFC4 and IFC4X3 are
+ * written by their own attribute layouts.
+ */
+export declare function applyWallJoinToStore(editor: StoreEditor, anchor: JoinAnchor, a: WallJoinTarget, b: WallJoinTarget, options?: WallJoinApplyOptions): WallJoinApplyResult;
+/**
+ * Give `target` the body and `Axis` of `wall`, written in the frame of the
+ * placement at `target.origin` (`wall`'s axis runs along that frame's +X).
+ */
+export declare function rewriteWall(editor: StoreEditor, anchor: JoinAnchor, target: WallJoinTarget, wall: WallJoinWall): WallJoinTarget;
+//# sourceMappingURL=wall-join-apply.d.ts.map

package/dist/in-store/wall-join-apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wall-join-apply.d.ts","sourceRoot":"","sources":["../../src/in-store/wall-join-apply.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,OAAO,EAA2E,KAAK,eAAe,EAAE,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAClJ,OAAO,EAAmB,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,KAAK,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEzH,oFAAoF;AACpF,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,6GAA6G;IAC7G,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,kGAAkG;IAClG,MAAM,EAAE,SAAS,CAAC;IAClB,6CAA6C;IAC7C,IAAI,EAAE,YAAY,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,CAAC,EAAE,cAAc,CAAC;IAClB,CAAC,EAAE,cAAc,CAAC;CACnB;AAED,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC3D,qEAAqE;IACrE,UAAU,CAAC,EAAE;QAAE,CAAC,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,CAAC,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;IAC9D,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,EAAE,gBAAgB,GAAG,eAAe,GAAG,QAAQ,GAAG,iBAAiB,GAAG,YAAY,CAAC,CAAC;AAE/H,4EAA4E;AAC5E,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,iBAAiB,GAAG,cAAc,CAWzG;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,UAAU,EAClB,CAAC,EAAE,cAAc,EACjB,CAAC,EAAE,cAAc,EACjB,OAAO,GAAE,oBAAyB,GACjC,mBAAmB,CAkCrB;AASD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,YAAY,GAAG,cAAc,CAQ/H"}