@ifc-lite/create 2.8.0 → 3.1.0

package/README.md

@@ -29,6 +29,13 @@ const { content } = creator.toIfc(); // IFC STEP text
 - Property sets, element quantities, materials, and colors
 - 4D scheduling entities: IfcWorkSchedule, IfcTask, IfcRelSequence
 - In-store builders (`addWallToStore`, `addSlabToStore`, ...) that emit elements into an existing parsed model
+- `resolveSpatialAnchor(store, storeyId, view)` reads the live mutation view when
+  authoring into an edited model. Pass the same view as the `StoreEditor` so a
+  created storey or placement, and deletions or retypes of source anchors, are
+  reflected before an element is emitted. Omitting `view` reads the parsed model.
+- `applyStylesInStore` reads styled items and representation chains from the
+  editor's live overlay, so a deleted style can be replaced and an authored
+  style is found before adding another one to the same representation item.
 - Loaded-model cost builders (`addCostScheduleToStore`, `addCostItemToStore`, `addCostValueToStore`,
   `addCostQuantityToStore`) plus relationship helpers for nesting, schedule/object assignment, value lists,
   and safe removal. They require a `CostAnchor` for schema/owner-history/GUID allocation, accept existing

package/dist/ifc-creator-alignment-referents.d.ts

@@ -0,0 +1,35 @@
+import { type HorizontalSegment } from './landxml/alignment-mapping.js';
+/** One station equation (§14.1): all lengths in the file's length unit. */
+export interface StationEquationParams {
+    /** Distance along the alignment's basis curve from its start. */
+    DistanceAlong: number;
+    /** `Pset_Stationing.Station` — the station from here on. */
+    Station: number;
+    /** `Pset_Stationing.IncomingStation` — the station arriving here. */
+    IncomingStation: number;
+    /** `Pset_Stationing.HasIncreasingStation`; omitted when `null` or absent. */
+    HasIncreasingStation?: boolean | null;
+    /** GlobalId seed role; defaults to `station-equation:<n>` (1-based). */
+    Role?: string;
+}
+export interface StationingContext {
+    emit: (type: string, attrs: string) => number;
+    ownerRef: string;
+    guid: (role: string) => string;
+}
+export interface StationingParams {
+    alignmentId: number;
+    compositeCurveId: number;
+    segments: readonly HorizontalSegment[];
+    startStation: number;
+    equations: readonly StationEquationParams[];
+}
+/** `0+123.456` — kilometres and metres, the usual stationing label. */
+export declare function stationLabel(station: number): string;
+/**
+ * Write the start referent (distance 0) and one referent per station
+ * equation, nest them under the alignment in order along it, and position
+ * the alignment by the start referent. Returns the referent ids, start first.
+ */
+export declare function emitStationing(params: StationingParams, ctx: StationingContext): number[];
+//# sourceMappingURL=ifc-creator-alignment-referents.d.ts.map

package/dist/ifc-creator-alignment-referents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ifc-creator-alignment-referents.d.ts","sourceRoot":"","sources":["../src/ifc-creator-alignment-referents.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAEzF,2EAA2E;AAC3E,MAAM,WAAW,qBAAqB;IACpC,iEAAiE;IACjE,aAAa,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,eAAe,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,oBAAoB,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACtC,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,SAAS,qBAAqB,EAAE,CAAC;CAC7C;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMpD;AAmDD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAoCzF"}

package/dist/ifc-creator-alignment-referents.js

@@ -0,0 +1,89 @@
+/* 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/. */
+/**
+ * An alignment's stationing: `IfcReferent`s / `.STATION.` carrying
+ * `Pset_Stationing`, nested under the alignment in order along it (mapping
+ * spec §11.1, §14).
+ *
+ * Each referent is placed the way IfcOpenShell 0.8.5's
+ * `add_stationing_referent` places one: an `IfcLinearPlacement` whose
+ * `IfcPointByDistanceExpression` measures `DistanceAlong` on the alignment's
+ * own composite curve, with the evaluated point and tangent as its
+ * `CartesianPosition`.
+ */
+import { esc, num } from './ifc-creator-math.js';
+import { evaluateSegment } from './landxml/alignment-mapping.js';
+/** `0+123.456` — kilometres and metres, the usual stationing label. */
+export function stationLabel(station) {
+    const sign = station < 0 ? '-' : '';
+    const abs = Math.abs(station);
+    const km = Math.floor(abs / 1000);
+    const m = (abs - km * 1000).toFixed(3).padStart(7, '0');
+    return `${sign}${km}+${m}`;
+}
+/** Point and tangent direction at `distance` along the layout's segments. */
+function pointAlong(segments, distance) {
+    let remaining = distance;
+    for (let index = 0; index < segments.length; index += 1) {
+        const segment = segments[index];
+        if (remaining <= segment.length || index === segments.length - 1) {
+            return evaluateSegment(segment.start, segment.direction, segment.startCurvature, segment.endCurvature, segment.length, Math.min(remaining, segment.length));
+        }
+        remaining -= segment.length;
+    }
+    throw new Error('addAlignment: cannot place a referent on an alignment with no segments');
+}
+function linearPlacement(ctx, compositeCurveId, distance, at) {
+    const along = ctx.emit('IFCPOINTBYDISTANCEEXPRESSION', `IFCLENGTHMEASURE(${num(distance)}),$,$,$,#${compositeCurveId}`);
+    const linear = ctx.emit('IFCAXIS2PLACEMENTLINEAR', `#${along},$,$`);
+    const point = ctx.emit('IFCCARTESIANPOINT', `(${num(at.point[0])},${num(at.point[1])},0.)`);
+    const up = ctx.emit('IFCDIRECTION', '(0.,0.,1.)');
+    const ahead = ctx.emit('IFCDIRECTION', `(${num(Math.cos(at.direction))},${num(Math.sin(at.direction))},0.)`);
+    const cartesian = ctx.emit('IFCAXIS2PLACEMENT3D', `#${point},#${up},#${ahead}`);
+    return ctx.emit('IFCLINEARPLACEMENT', `$,#${linear},#${cartesian}`);
+}
+function stationReferent(ctx, placement, station, roles, extra = []) {
+    const referentId = ctx.emit('IFCREFERENT', `'${ctx.guid(roles.referent)}',${ctx.ownerRef},'${esc(stationLabel(station))}',$,$,#${placement},$,.STATION.`);
+    const properties = [
+        ctx.emit('IFCPROPERTYSINGLEVALUE', `'Station',$,IFCLENGTHMEASURE(${num(station)}),$`),
+        ...extra.map((attrs) => ctx.emit('IFCPROPERTYSINGLEVALUE', attrs)),
+    ];
+    const pset = ctx.emit('IFCPROPERTYSET', `'${ctx.guid(roles.pset)}',${ctx.ownerRef},'Pset_Stationing',$,(${properties.map((id) => `#${id}`).join(',')})`);
+    ctx.emit('IFCRELDEFINESBYPROPERTIES', `'${ctx.guid(roles.rel)}',${ctx.ownerRef},$,$,(#${referentId}),#${pset}`);
+    return referentId;
+}
+/**
+ * Write the start referent (distance 0) and one referent per station
+ * equation, nest them under the alignment in order along it, and position
+ * the alignment by the start referent. Returns the referent ids, start first.
+ */
+export function emitStationing(params, ctx) {
+    const first = params.segments[0];
+    const startPlacement = linearPlacement(ctx, params.compositeCurveId, 0, { point: first.start, direction: first.direction });
+    const startId = stationReferent(ctx, startPlacement, params.startStation, {
+        referent: 'referent:start', pset: 'pset:stationing', rel: 'rel:stationing',
+    });
+    let previous = 0;
+    const equationIds = params.equations.map((equation, index) => {
+        if (!(equation.DistanceAlong > previous)) {
+            throw new Error(`addAlignment: station equation ${index + 1} is at ${equation.DistanceAlong} along the alignment, `
+                + 'not after the previous referent; referents are nested in order along it');
+        }
+        previous = equation.DistanceAlong;
+        const role = equation.Role ?? `station-equation:${index + 1}`;
+        const placement = linearPlacement(ctx, params.compositeCurveId, equation.DistanceAlong, pointAlong(params.segments, equation.DistanceAlong));
+        const extra = [`'IncomingStation',$,IFCLENGTHMEASURE(${num(equation.IncomingStation)}),$`];
+        if (equation.HasIncreasingStation !== null && equation.HasIncreasingStation !== undefined) {
+            extra.push(`'HasIncreasingStation',$,IFCBOOLEAN(${equation.HasIncreasingStation ? '.T.' : '.F.'}),$`);
+        }
+        return stationReferent(ctx, placement, equation.Station, {
+            referent: role, pset: `${role}:pset`, rel: `${role}:rel`,
+        }, extra);
+    });
+    const referents = [startId, ...equationIds];
+    ctx.emit('IFCRELNESTS', `'${ctx.guid('nests:referents')}',${ctx.ownerRef},$,$,#${params.alignmentId},(${referents.map((id) => `#${id}`).join(',')})`);
+    ctx.emit('IFCRELPOSITIONS', `'${ctx.guid('positions')}',${ctx.ownerRef},$,$,#${startId},(#${params.alignmentId})`);
+    return referents;
+}
+//# sourceMappingURL=ifc-creator-alignment-referents.js.map

package/dist/ifc-creator-alignment-referents.js.map

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

package/dist/ifc-creator-alignment-vertical.d.ts

@@ -0,0 +1,40 @@
+import { type VerticalSegment } from './landxml/profile-geometry.js';
+/** The creator hooks this emitter needs (a subset of `AlignmentContext`). */
+export interface VerticalContext {
+    emit: (type: string, attrs: string) => number;
+    ownerRef: string;
+}
+/** A vertical layout for `AlignmentParams.Vertical`. Distances and heights in metres. */
+export interface AlignmentVerticalParams {
+    Name?: string;
+    GlobalId?: string;
+    /** In order along the alignment; the zero-length terminator is added here. */
+    Segments: readonly VerticalSegment[];
+}
+/**
+ * Arc length of `A + Bx + Cx²` over `[0, L]`.
+ *
+ * IfcOpenShell's `_polynomial_length` closed form, where it is well
+ * conditioned. Its terms grow like `1/C` and cancel, so as `C·L` shrinks the
+ * result loses digits (1e-9 relative by `C·L = 1e-7`) and at `C ≈ 1e-19`
+ * returns 0 for an 80 m curve (#5930 review). Below `|C·L| = 1e-5` — where the
+ * closed form is still good to ~1e-11 — the nearly constant integrand
+ * `sqrt(1 + (B + 2Cx)²)` is integrated by Simpson's rule instead, exact to
+ * rounding for so gentle a curve.
+ */
+export declare function polynomialLength(B: number, C: number, L: number): number;
+/**
+ * The `IfcGradientCurve` over `compositeCurveId`, one curve segment per layout
+ * segment, the last `DISCONTINUOUS` (`IfcCompositeCurve.CurveContinuous`).
+ */
+export declare function emitGradientCurve(ctx: VerticalContext, params: AlignmentVerticalParams, compositeCurveId: number): number;
+/**
+ * The semantic layout: `IfcAlignmentVertical` and its segments, nested in
+ * order. The caller nests the layout itself under the alignment, beside the
+ * horizontal one.
+ */
+export declare function emitVerticalLayout(ctx: VerticalContext, params: AlignmentVerticalParams, guid: (role: string) => string): {
+    verticalId: number;
+    segmentIds: number[];
+};
+//# sourceMappingURL=ifc-creator-alignment-vertical.d.ts.map

package/dist/ifc-creator-alignment-vertical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ifc-creator-alignment-vertical.d.ts","sourceRoot":"","sources":["../src/ifc-creator-alignment-vertical.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAoB,KAAK,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEvF,6EAA6E;AAC7E,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,yFAAyF;AACzF,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;CACtC;AAyBD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAuBxE;AA4FD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAMzH;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,uBAAuB,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GACpF;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAgB9C"}

package/dist/ifc-creator-alignment-vertical.js

@@ -0,0 +1,182 @@
+/* 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/. */
+/**
+ * `IfcAlignmentVertical` emitter (mapping spec §12) — the vertical half of an
+ * `IfcAlignment`, called from `emitAlignment`.
+ *
+ * Writes both halves IFC 4.3 defines: the semantic layout (`IfcAlignmentVertical`
+ * nesting `IfcAlignmentSegment`s) and the geometry (`IfcGradientCurve` over the
+ * horizontal `IfcCompositeCurve`). Each `IfcCurveSegment` follows IfcOpenShell
+ * 0.8.5's `_map_alignment_vertical_segment` exactly, computed from the design
+ * parameters alone, so the geometry is the one a consumer derives from the
+ * semantics.
+ */
+import { esc, num } from './ifc-creator-math.js';
+import { ALIGNMENT_POSITION_TOLERANCE_M } from './landxml/alignment-mapping.js';
+import { evaluateVertical } from './landxml/profile-geometry.js';
+const allclose = (a, b) => Math.abs(a - b) <= 1e-8 + 1e-5 * Math.abs(b);
+/** Curvature of the distance/height curve: `y'' / (1 + y'²)^1.5` for a parabola. */
+function curvature(segment, x) {
+    if (segment.type === 'CONSTANTGRADIENT' || segment.horizontalLength === 0)
+        return 0;
+    if (segment.type === 'CIRCULARARC')
+        return 1 / (segment.radiusOfCurvature ?? Infinity);
+    const g = evaluateVertical(segment, x).gradient;
+    const second = (segment.endGradient - segment.startGradient) / segment.horizontalLength;
+    return second / (1 + g * g) ** 1.5;
+}
+function transitionCode(segment, next) {
+    const end = evaluateVertical(segment, segment.horizontalLength);
+    const samePosition = Math.abs(segment.startDistAlong + segment.horizontalLength - next.startDistAlong) <= ALIGNMENT_POSITION_TOLERANCE_M
+        && Math.abs(end.height - next.startHeight) <= ALIGNMENT_POSITION_TOLERANCE_M;
+    if (!samePosition)
+        return '.DISCONTINUOUS.';
+    const a = Math.atan(end.gradient);
+    const b = Math.atan(next.startGradient);
+    if (!(allclose(Math.cos(a), Math.cos(b)) && allclose(Math.sin(a), Math.sin(b))))
+        return '.CONTINUOUS.';
+    return allclose(curvature(segment, segment.horizontalLength), curvature(next, 0))
+        ? '.CONTSAMEGRADIENTSAMECURVATURE.' : '.CONTSAMEGRADIENT.';
+}
+/**
+ * Arc length of `A + Bx + Cx²` over `[0, L]`.
+ *
+ * IfcOpenShell's `_polynomial_length` closed form, where it is well
+ * conditioned. Its terms grow like `1/C` and cancel, so as `C·L` shrinks the
+ * result loses digits (1e-9 relative by `C·L = 1e-7`) and at `C ≈ 1e-19`
+ * returns 0 for an 80 m curve (#5930 review). Below `|C·L| = 1e-5` — where the
+ * closed form is still good to ~1e-11 — the nearly constant integrand
+ * `sqrt(1 + (B + 2Cx)²)` is integrated by Simpson's rule instead, exact to
+ * rounding for so gentle a curve.
+ */
+export function polynomialLength(B, C, L) {
+    if (Math.abs(C * L) < 1e-5) {
+        const steps = 64;
+        const h = L / steps;
+        let sum = 0;
+        for (let i = 0; i <= steps; i += 1) {
+            const weight = i === 0 || i === steps ? 1 : i % 2 === 1 ? 4 : 2;
+            const slope = B + 2 * C * i * h;
+            sum += weight * Math.sqrt(1 + slope * slope);
+        }
+        return (sum * h) / 3;
+    }
+    const a = 4 * C * C;
+    const b = 4 * B * C;
+    const c = B * B + 1;
+    const fn = (x) => {
+        const v1 = (b + 2 * a * x) / (4 * a);
+        const v2 = Math.sqrt(a * x * x + b * x + c);
+        const v3 = (4 * a * c - b * b) / (8 * a ** 1.5);
+        const v4 = Math.log(Math.abs(2 * a * x + b + 2 * Math.sqrt(a * (a * x * x + b * x + c))));
+        return v1 * v2 + v3 * v4;
+    };
+    return fn(L) - fn(0);
+}
+function point2d(ctx, x, y) {
+    return ctx.emit('IFCCARTESIANPOINT', `(${num(x)},${num(y)})`);
+}
+function direction2d(ctx, x, y) {
+    return ctx.emit('IFCDIRECTION', `(${num(x)},${num(y)})`);
+}
+/** `IfcCurveSegment` for one vertical segment — IfcOpenShell's mapping, term for term. */
+function curveSegment(ctx, segment, transition) {
+    const { startDistAlong: d, horizontalLength: L, startHeight: h, startGradient: g0, endGradient: g1 } = segment;
+    const placement = ctx.emit('IFCAXIS2PLACEMENT2D', `#${point2d(ctx, d, h)},#${direction2d(ctx, Math.cos(Math.atan(g0)), Math.sin(Math.atan(g0)))}`);
+    let parent;
+    let segmentStart = 0;
+    let segmentLength;
+    if (segment.type === 'CONSTANTGRADIENT') {
+        const vector = ctx.emit('IFCVECTOR', `#${direction2d(ctx, 1, 0)},1.`);
+        parent = ctx.emit('IFCLINE', `#${point2d(ctx, 0, 0)},#${vector}`);
+        segmentLength = L / Math.cos(Math.atan(g0));
+    }
+    else if (segment.type === 'PARABOLICARC') {
+        const C = (g1 - g0) / (2 * L);
+        const position = ctx.emit('IFCAXIS2PLACEMENT2D', `#${point2d(ctx, 0, 0)},#${direction2d(ctx, 1, 0)}`);
+        parent = ctx.emit('IFCPOLYNOMIALCURVE', `#${position},(0.,1.),(${num(h)},${num(g0)},${num(C)}),$`);
+        segmentLength = polynomialLength(g0, C, L);
+    }
+    else {
+        let startAngle = Math.atan(g0);
+        let endAngle = Math.atan(g1);
+        let radius;
+        let x;
+        let y;
+        if (startAngle < endAngle) {
+            radius = L / (Math.sin(endAngle) - Math.sin(startAngle));
+            x = -radius * Math.sin(startAngle);
+            y = radius * Math.cos(startAngle);
+            startAngle += (3 * Math.PI) / 2;
+            endAngle += (3 * Math.PI) / 2;
+        }
+        else {
+            radius = L / (Math.sin(startAngle) - Math.sin(endAngle));
+            x = radius * Math.sin(startAngle);
+            y = -radius * Math.cos(startAngle);
+            startAngle += Math.PI / 2;
+            endAngle += Math.PI / 2;
+        }
+        const position = ctx.emit('IFCAXIS2PLACEMENT2D', `#${point2d(ctx, x, y)},#${direction2d(ctx, 1, 0)}`);
+        parent = ctx.emit('IFCCIRCLE', `#${position},${num(radius)}`);
+        segmentStart = radius * startAngle;
+        segmentLength = radius * (endAngle - startAngle);
+    }
+    return ctx.emit('IFCCURVESEGMENT', `${transition},#${placement},IFCLENGTHMEASURE(${num(segmentStart)}),IFCLENGTHMEASURE(${num(segmentLength)}),#${parent}`);
+}
+/** The zero-length `CONSTANTGRADIENT` IFC 4.3 requires at the end of every layout. */
+function terminator(last) {
+    const end = evaluateVertical(last, last.horizontalLength);
+    return {
+        sourceId: `${last.sourceId}:end`, type: 'CONSTANTGRADIENT',
+        startDistAlong: last.startDistAlong + last.horizontalLength, horizontalLength: 0,
+        startHeight: end.height, startGradient: end.gradient, endGradient: end.gradient, radiusOfCurvature: null,
+    };
+}
+function layoutOf(params) {
+    if (params.Segments.length === 0) {
+        throw new Error('addAlignment: Vertical.Segments is empty — a vertical layout needs at least one segment');
+    }
+    // As `emitAlignment` does for the horizontal: a gap would be a mid-curve
+    // `.DISCONTINUOUS.`, which `IfcCompositeCurve.CurveContinuous` forbids for an
+    // open curve (exactly one, the last).
+    params.Segments.slice(1).forEach((next, index) => {
+        const previous = params.Segments[index];
+        const end = evaluateVertical(previous, previous.horizontalLength);
+        const distGap = Math.abs(previous.startDistAlong + previous.horizontalLength - next.startDistAlong);
+        const heightGap = Math.abs(end.height - next.startHeight);
+        if (distGap > ALIGNMENT_POSITION_TOLERANCE_M || heightGap > ALIGNMENT_POSITION_TOLERANCE_M) {
+            throw new Error(`addAlignment: vertical segment ${index + 2} starts ${distGap.toFixed(3)} m along and `
+                + `${heightGap.toFixed(3)} m in height from where segment ${index + 1} ends; `
+                + 'an open IfcGradientCurve may be discontinuous only at its last segment');
+        }
+    });
+    return [...params.Segments, terminator(params.Segments[params.Segments.length - 1])];
+}
+/**
+ * The `IfcGradientCurve` over `compositeCurveId`, one curve segment per layout
+ * segment, the last `DISCONTINUOUS` (`IfcCompositeCurve.CurveContinuous`).
+ */
+export function emitGradientCurve(ctx, params, compositeCurveId) {
+    const layout = layoutOf(params);
+    const segments = layout.map((segment, index) => curveSegment(ctx, segment, index === layout.length - 1 ? '.DISCONTINUOUS.' : transitionCode(segment, layout[index + 1])));
+    return ctx.emit('IFCGRADIENTCURVE', `(${segments.map((id) => `#${id}`).join(',')}),.F.,#${compositeCurveId},$`);
+}
+/**
+ * The semantic layout: `IfcAlignmentVertical` and its segments, nested in
+ * order. The caller nests the layout itself under the alignment, beside the
+ * horizontal one.
+ */
+export function emitVerticalLayout(ctx, params, guid) {
+    const verticalId = ctx.emit('IFCALIGNMENTVERTICAL', `'${params.GlobalId ?? guid('vertical')}',${ctx.ownerRef},${params.Name !== undefined ? `'${esc(params.Name)}'` : '$'},$,$,$,$`);
+    const segmentIds = layoutOf(params).map((segment, index) => {
+        const design = ctx.emit('IFCALIGNMENTVERTICALSEGMENT', `$,$,${num(segment.startDistAlong)},${num(segment.horizontalLength)},${num(segment.startHeight)},`
+            + `${num(segment.startGradient)},${num(segment.endGradient)},`
+            + `${segment.radiusOfCurvature === null ? '$' : num(segment.radiusOfCurvature)},.${segment.type}.`);
+        return ctx.emit('IFCALIGNMENTSEGMENT', `'${guid(`vertical:segment:${index}`)}',${ctx.ownerRef},$,$,$,$,$,#${design}`);
+    });
+    ctx.emit('IFCRELNESTS', `'${guid('nests:vertical-segments')}',${ctx.ownerRef},$,$,#${verticalId},(${segmentIds.map((id) => `#${id}`).join(',')})`);
+    return { verticalId, segmentIds };
+}
+//# sourceMappingURL=ifc-creator-alignment-vertical.js.map

package/dist/ifc-creator-alignment-vertical.js.map

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

package/dist/ifc-creator-alignment.d.ts

@@ -0,0 +1,45 @@
+import { type HorizontalSegment } from './landxml/alignment-mapping.js';
+import { type AlignmentVerticalParams } from './ifc-creator-alignment-vertical.js';
+import { type StationEquationParams } from './ifc-creator-alignment-referents.js';
+/** The creator hooks this emitter needs. */
+export interface AlignmentContext {
+    emit: (type: string, attrs: string) => number;
+    newGlobalId: () => string;
+    ownerRef: string;
+    /** `#<id>` of the `'Axis'` representation subcontext. */
+    axisContextRef: string;
+    /** `#<id>` of the world placement the alignment hangs from. */
+    placementRef: string;
+}
+export interface AlignmentParams {
+    Name: string;
+    GlobalId?: string;
+    /** Station at distance 0, metres — written to the start referent's `Pset_Stationing`. */
+    StartStation: number;
+    Segments: readonly HorizontalSegment[];
+    /**
+     * The vertical layout (mapping spec §12). When present the alignment also
+     * gets an `IfcAlignmentVertical` and an `IfcGradientCurve` 'Axis'
+     * representation, and the composite curve moves to 'FootPrint'.
+     */
+    Vertical?: AlignmentVerticalParams;
+    /** Station equations (§14), in order along the alignment; each becomes an `IfcReferent`. */
+    StationEquations?: readonly StationEquationParams[];
+    /** Deterministic GlobalId seed for this alignment's owned entities. */
+    guidFor?: (role: string) => string;
+}
+export interface AlignmentResult {
+    alignmentId: number;
+    horizontalId: number;
+    compositeCurveId: number;
+    /** `IfcAlignmentSegment` ids in order, including the terminating one. */
+    segmentIds: number[];
+    referentId: number;
+    /** Present when `Vertical` was given. */
+    verticalId?: number;
+    gradientCurveId?: number;
+    /** One `IfcReferent` per station equation, in order along the alignment. */
+    equationReferentIds: number[];
+}
+export declare function emitAlignment(params: AlignmentParams, ctx: AlignmentContext): AlignmentResult;
+//# sourceMappingURL=ifc-creator-alignment.d.ts.map

package/dist/ifc-creator-alignment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ifc-creator-alignment.d.ts","sourceRoot":"","sources":["../src/ifc-creator-alignment.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAkC,KAAK,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxG,OAAO,EAAyC,KAAK,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAC1H,OAAO,EAAkB,KAAK,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAElG,4CAA4C;AAC5C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9C,WAAW,EAAE,MAAM,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,cAAc,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yFAAyF;IACzF,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACvC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,4FAA4F;IAC5F,gBAAgB,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACpD,uEAAuE;IACvE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4EAA4E;IAC5E,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAoHD,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,EAAE,gBAAgB,GAAG,eAAe,CA8D7F"}

package/dist/ifc-creator-alignment.js

@@ -0,0 +1,173 @@
+/* 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/. */
+/**
+ * `IfcAlignment` emitter — horizontal layout (mapping spec §11), plus the
+ * vertical layout from `ifc-creator-alignment-vertical.ts` when given (§12).
+ *
+ * Writes BOTH halves IFC 4.3 defines for an alignment: the semantic layout
+ * (`IfcAlignmentHorizontal` nesting `IfcAlignmentSegment`s) and the geometry
+ * (`IfcCompositeCurve` of `IfcCurveSegment`s). The structure mirrors what
+ * IfcOpenShell 0.8.5's `alignment` API writes for the same input, and each
+ * `IfcCurveSegment` follows its `_map_alignment_horizontal_segment` exactly —
+ * so the geometry is the one a consumer would derive from the semantics.
+ *
+ * Parameters arrive already mapped (`landxml/alignment-mapping.ts`): metres,
+ * radians counter-clockwise from +X, radii positive for a counter-clockwise
+ * turn and `0` for infinite.
+ */
+import { esc, num } from './ifc-creator-math.js';
+import { ALIGNMENT_POSITION_TOLERANCE_M } from './landxml/alignment-mapping.js';
+import { emitGradientCurve, emitVerticalLayout } from './ifc-creator-alignment-vertical.js';
+import { emitStationing } from './ifc-creator-alignment-referents.js';
+/**
+ * Direction and curvature equality for the transition code use the
+ * `numpy.allclose` defaults, as IfcOpenShell's
+ * `get_curve_segment_transition_code` does. Position does NOT use its 1 mm:
+ * authored LandXML joins reproduce only to a few millimetres (lengths and
+ * radii are rounded independently of the coordinates), so 1 mm would mark
+ * an ordinary join `.DISCONTINUOUS.` in mid-curve, which
+ * `IfcCompositeCurve.CurveContinuous` forbids for an open curve (exactly one,
+ * the last). Joins are compared at the mapping's own tolerance instead, and
+ * a real gap beyond it is refused before anything is written (#5370 review).
+ */
+const POSITION_ATOL = ALIGNMENT_POSITION_TOLERANCE_M;
+const allclose = (a, b) => Math.abs(a - b) <= 1e-8 + 1e-5 * Math.abs(b);
+function transitionCode(segment, next) {
+    const samePosition = Math.hypot(segment.end[0] - next.start[0], segment.end[1] - next.start[1]) <= POSITION_ATOL;
+    if (!samePosition)
+        return '.DISCONTINUOUS.';
+    const sameGradient = allclose(Math.cos(segment.endDirection), Math.cos(next.direction))
+        && allclose(Math.sin(segment.endDirection), Math.sin(next.direction));
+    if (!sameGradient)
+        return '.CONTINUOUS.';
+    return allclose(segment.endCurvature, next.startCurvature) ? '.CONTSAMEGRADIENTSAMECURVATURE.' : '.CONTSAMEGRADIENT.';
+}
+function point2d(ctx, [x, y]) {
+    return ctx.emit('IFCCARTESIANPOINT', `(${num(x)},${num(y)})`);
+}
+function placement2d(ctx, at, direction) {
+    const location = point2d(ctx, at);
+    const ref = ctx.emit('IFCDIRECTION', `(${num(Math.cos(direction))},${num(Math.sin(direction))})`);
+    return ctx.emit('IFCAXIS2PLACEMENT2D', `#${location},#${ref}`);
+}
+/** A parent-curve `Position` at the origin along +X, as IfcOpenShell writes it. */
+function originPlacement(ctx) {
+    return placement2d(ctx, [0, 0], 0);
+}
+function unitLine(ctx) {
+    const origin = point2d(ctx, [0, 0]);
+    const dir = ctx.emit('IFCDIRECTION', '(1.,0.)');
+    const vector = ctx.emit('IFCVECTOR', `#${dir},1.`);
+    return ctx.emit('IFCLINE', `#${origin},#${vector}`);
+}
+/**
+ * `IfcCurveSegment` for one horizontal segment — IfcOpenShell's mapping.
+ *
+ * - LINE: `IfcLine` at the origin; `SegmentLength = L`.
+ * - CIRCULARARC: `IfcCircle` of radius `|R|`; `SegmentLength = L · sign(R)` —
+ *   a negative length traverses the circle clockwise.
+ * - CLOTHOID: `IfcClothoid` with `A = L / sqrt(|f|) · sign(f)`, where
+ *   `f = L/R_end − L/R_start`, and a `SegmentStart` offset so a spiral that
+ *   does not begin at infinite radius starts at the right point on the curve.
+ */
+function curveSegment(ctx, segment, transition) {
+    const placement = placement2d(ctx, segment.start, segment.direction);
+    const L = segment.length;
+    let parent;
+    let segmentStart = 0;
+    let segmentLength = L;
+    if (segment.type === 'LINE') {
+        parent = unitLine(ctx);
+    }
+    else if (segment.type === 'CIRCULARARC') {
+        parent = ctx.emit('IFCCIRCLE', `#${originPlacement(ctx)},${num(Math.abs(segment.startRadius))}`);
+        segmentLength = L * Math.sign(segment.startRadius);
+    }
+    else {
+        const r0 = segment.startRadius;
+        const r1 = segment.endRadius;
+        const f = (r1 === 0 ? 0 : L / r1) - (r0 === 0 ? 0 : L / r0);
+        const A = (L / Math.sqrt(Math.abs(f))) * Math.sign(f);
+        parent = ctx.emit('IFCCLOTHOID', `#${originPlacement(ctx)},${num(A)}`);
+        if ((Math.abs(r0) < Math.abs(r1) && r0 !== 0) || r1 === 0) {
+            segmentStart = -L - (r1 !== 0 ? (L * r0) / (r1 - r0) : 0);
+        }
+        else {
+            segmentStart = r0 !== 0 ? (L * r1) / (r0 - r1) : 0;
+        }
+    }
+    return ctx.emit('IFCCURVESEGMENT', `${transition},#${placement},IFCLENGTHMEASURE(${num(segmentStart)}),IFCLENGTHMEASURE(${num(segmentLength)}),#${parent}`);
+}
+function designParameters(ctx, segment) {
+    return ctx.emit('IFCALIGNMENTHORIZONTALSEGMENT', `$,$,#${point2d(ctx, segment.start)},${num(segment.direction)},${num(segment.startRadius)},`
+        + `${num(segment.endRadius)},${num(segment.length)},$,.${segment.type}.`);
+}
+/**
+ * The zero-length `LINE` IFC 4.3 requires at the end of every layout, placed at
+ * the alignment's end along its end tangent.
+ */
+function terminator(last) {
+    return {
+        sourceId: `${last.sourceId}:end`,
+        type: 'LINE',
+        start: last.end,
+        direction: last.endDirection,
+        startRadius: 0,
+        endRadius: 0,
+        length: 0,
+        end: last.end,
+        endDirection: last.endDirection,
+        startCurvature: 0,
+        endCurvature: 0,
+    };
+}
+export function emitAlignment(params, ctx) {
+    if (params.Segments.length === 0) {
+        throw new Error('addAlignment: Segments is empty — an alignment needs at least one horizontal segment');
+    }
+    const guid = (role) => params.guidFor?.(role) ?? ctx.newGlobalId();
+    const layout = [...params.Segments, terminator(params.Segments[params.Segments.length - 1])];
+    params.Segments.slice(1).forEach((next, index) => {
+        const previous = params.Segments[index];
+        const gap = Math.hypot(previous.end[0] - next.start[0], previous.end[1] - next.start[1]);
+        if (gap > POSITION_ATOL) {
+            throw new Error(`addAlignment: segment ${index + 2} starts ${gap.toFixed(3)} m from where segment ${index + 1} ends; `
+                + 'an open IfcCompositeCurve may be discontinuous only at its last segment');
+        }
+    });
+    // Geometry: one curve segment per layout segment, the last DISCONTINUOUS —
+    // `IfcCompositeCurve.CurveContinuous` requires exactly one for an open curve.
+    const curveSegments = layout.map((segment, index) => curveSegment(ctx, segment, index === layout.length - 1 ? '.DISCONTINUOUS.' : transitionCode(segment, layout[index + 1])));
+    const compositeCurveId = ctx.emit('IFCCOMPOSITECURVE', `(${curveSegments.map((id) => `#${id}`).join(',')}),.F.`);
+    // With a vertical layout: the composite curve as 'FootPrint' first, the
+    // gradient curve as 'Axis' — IfcOpenShell's horizontal + vertical case (§12.1).
+    const gradientCurveId = params.Vertical ? emitGradientCurve(ctx, params.Vertical, compositeCurveId) : undefined;
+    const representations = gradientCurveId === undefined
+        ? [ctx.emit('IFCSHAPEREPRESENTATION', `${ctx.axisContextRef},'Axis','Curve2D',(#${compositeCurveId})`)]
+        : [
+            ctx.emit('IFCSHAPEREPRESENTATION', `${ctx.axisContextRef},'FootPrint','Curve2D',(#${compositeCurveId})`),
+            ctx.emit('IFCSHAPEREPRESENTATION', `${ctx.axisContextRef},'Axis','Curve3D',(#${gradientCurveId})`),
+        ];
+    const shape = ctx.emit('IFCPRODUCTDEFINITIONSHAPE', `$,$,(${representations.map((id) => `#${id}`).join(',')})`);
+    const alignmentId = ctx.emit('IFCALIGNMENT', `'${params.GlobalId ?? guid('alignment')}',${ctx.ownerRef},'${esc(params.Name)}',$,$,${ctx.placementRef},#${shape},$`);
+    // Semantics: horizontal layout nested under the alignment, segments nested
+    // in order under the layout.
+    const horizontalId = ctx.emit('IFCALIGNMENTHORIZONTAL', `'${guid('horizontal')}',${ctx.ownerRef},$,$,$,$,$`);
+    const vertical = params.Vertical ? emitVerticalLayout(ctx, params.Vertical, guid) : undefined;
+    const layouts = vertical ? `#${horizontalId},#${vertical.verticalId}` : `#${horizontalId}`;
+    ctx.emit('IFCRELNESTS', `'${guid('nests:layouts')}',${ctx.ownerRef},$,$,#${alignmentId},(${layouts})`);
+    const segmentIds = layout.map((segment, index) => ctx.emit('IFCALIGNMENTSEGMENT', `'${guid(`segment:${index}`)}',${ctx.ownerRef},$,$,$,$,$,#${designParameters(ctx, segment)}`));
+    ctx.emit('IFCRELNESTS', `'${guid('nests:segments')}',${ctx.ownerRef},$,$,#${horizontalId},(${segmentIds.map((id) => `#${id}`).join(',')})`);
+    // Stationing (§11.1, §14): the start referent, then one per station
+    // equation, nested in order along the alignment.
+    const [referentId, ...equationReferentIds] = emitStationing({
+        alignmentId, compositeCurveId, segments: params.Segments, startStation: params.StartStation,
+        equations: params.StationEquations ?? [],
+    }, { emit: ctx.emit, ownerRef: ctx.ownerRef, guid });
+    return {
+        alignmentId, horizontalId, compositeCurveId, segmentIds, referentId, equationReferentIds,
+        ...(vertical ? { verticalId: vertical.verticalId, gradientCurveId } : {}),
+    };
+}
+//# sourceMappingURL=ifc-creator-alignment.js.map