@ifc-lite/create 2.8.0 → 3.1.0

package/dist/landxml/source-types.d.ts

@@ -0,0 +1,169 @@
+/**
+ * The structural view of a parsed LandXML document that the IFC mapping reads.
+ *
+ * Declared here rather than imported from the viewer on purpose: a converter
+ * that cannot be unit-tested without mounting the viewer is not a converter.
+ * The viewer's `LandXmlTinDocument` satisfies these shapes structurally, so the
+ * adaptation is a type assignment and not a translation layer that could drift.
+ *
+ * Everything the mapping refuses (§5, §11.5 of the mapping spec) appears here as an
+ * opaque `readonly unknown[]`. That is deliberate: the converter must *count and
+ * name* those records to refuse them honestly, and must not be able to read
+ * into them, which is what would let a refusal quietly become a partial export.
+ */
+/** A TIN vertex, in LandXML's own authored order. */
+export interface LandXmlIfcPoint {
+    /** Document-local id, e.g. `landxml:surface:3:point:41`. Seeds the GlobalId. */
+    sourceId: string;
+    /** The `<P id="...">` attribute, which `<F>` entries reference. */
+    id: string;
+    northing: number;
+    easting: number;
+    elevation: number;
+}
+export interface LandXmlIfcSurface {
+    sourceId: string;
+    name: string;
+    kind: string;
+    /** Only `'rendered'` is in scope; anything else is refused by name (§5). */
+    renderState: string;
+    points: readonly LandXmlIfcPoint[];
+    /** Triples of `<P>` ids, as authored. */
+    faces: readonly (readonly [string, string, string])[];
+    /** Per-face; a `false` entry is an authored `<F i="true">`. */
+    faceVisibility?: readonly boolean[];
+    boundaries?: readonly unknown[];
+    breaklines?: readonly unknown[];
+    contours?: readonly unknown[];
+}
+/** A `<CgPoint>` location. `elevation` is genuinely optional in LandXML. */
+export interface LandXmlIfcPlanPoint {
+    northing: number;
+    easting: number;
+    elevation: number | null;
+}
+export interface LandXmlIfcCgPoint {
+    sourceId: string;
+    name: string | null;
+    code: string | null;
+    description: string | null;
+    point: LandXmlIfcPlanPoint | null;
+}
+export interface LandXmlIfcPlan {
+    cogoPoints?: readonly LandXmlIfcCgPoint[];
+    monuments?: readonly unknown[];
+    planFeatures?: readonly unknown[];
+    parcels?: readonly unknown[];
+}
+/**
+ * Units as the parser resolved them. `null` only for a source that declares
+ * none — which a renderable TIN cannot be (LXML009), so `null` here means the
+ * document carries no numeric surface at all.
+ */
+export interface LandXmlIfcUnits {
+    linearUnit: string;
+    elevationUnit: string;
+    linearScaleToMeters: number;
+    /** LandXML may declare a different unit for elevation than for plan. */
+    elevationScaleToMeters: number;
+    /** True when an operator supplied the unit for an undeclared source (§2.1). */
+    assumed: boolean;
+}
+/** A plan location: authored coordinates, or a reference to a `CgPoint` by name. */
+export type LandXmlIfcLocation = {
+    kind: 'coordinates';
+    point: {
+        northing: number;
+        easting: number;
+    };
+} | {
+    kind: 'point_reference';
+    pntRef: string;
+};
+/** `'infinite'` is LandXML's `INF` radius — a straight end of a spiral. */
+export type LandXmlIfcRadius = number | 'infinite';
+export type LandXmlIfcRotation = 'clockwise' | 'counter_clockwise';
+/**
+ * One `CoordGeom` element, in the authored northing-first plan. Mirrors the
+ * viewer's `LandXmlAlignmentPrimitive` field for field, so the viewer's
+ * document assigns to this without a translation layer.
+ */
+export type LandXmlIfcAlignmentPrimitive = {
+    kind: 'line';
+    start: LandXmlIfcLocation;
+    end: LandXmlIfcLocation;
+    declaredLength: number | null;
+} | {
+    kind: 'irregular_line';
+    start: LandXmlIfcLocation;
+    end: LandXmlIfcLocation;
+    declaredLength: number | null;
+} | {
+    kind: 'curve';
+    start: LandXmlIfcLocation;
+    center: LandXmlIfcLocation;
+    end: LandXmlIfcLocation;
+    rotation: LandXmlIfcRotation;
+    radius: number | null;
+    declaredLength: number | null;
+} | {
+    kind: 'spiral' | 'unsupported_spiral';
+    start: LandXmlIfcLocation;
+    pi: LandXmlIfcLocation;
+    end: LandXmlIfcLocation;
+    spiType: string;
+    radiusStart?: LandXmlIfcRadius;
+    radiusEnd?: LandXmlIfcRadius;
+    rotation?: LandXmlIfcRotation;
+    declaredLength: number;
+};
+export interface LandXmlIfcAlignmentSegment {
+    sourceId: string;
+    ordinal: number;
+    primitive: LandXmlIfcAlignmentPrimitive;
+}
+/**
+ * A horizontal alignment (§11). Only the horizontal geometry is read; the
+ * vertical, cant and superelevation records are counted so they can be
+ * refused by name, never read into.
+ */
+export interface LandXmlIfcAlignment {
+    sourceId: string;
+    name: string;
+    /** Station at the start, in the declared linear unit. */
+    staStart: number;
+    segments: readonly LandXmlIfcAlignmentSegment[];
+    profileSourceIds?: readonly string[];
+    stationEquations?: readonly unknown[];
+    cant?: unknown;
+    cantStations?: readonly unknown[];
+    superelevations?: readonly unknown[];
+}
+export interface LandXmlIfcSource {
+    schema: string;
+    version: string;
+    units: LandXmlIfcUnits | null;
+    coordinateSystem?: {
+        horizontalDatum?: string;
+        verticalDatum?: string;
+    };
+    surfaces: readonly LandXmlIfcSurface[];
+    /**
+     * Horizontal alignments. Typed `unknown[]` on purpose: v1.0 published this
+     * field as opaque, and narrowing an input type is a breaking change (#5370
+     * review). Each record is checked at run time instead — `isAlignmentRecord`
+     * in `alignment-mapping.ts` — and one that is not a `LandXmlIfcAlignment` is
+     * refused by name, never read into. The viewer's parsed document satisfies
+     * `LandXmlIfcAlignment`; that is the shape to produce.
+     */
+    alignments?: readonly unknown[];
+    profiles?: readonly unknown[];
+    crossSections?: readonly unknown[];
+    crossSectionSurfaces?: readonly unknown[];
+    roadways?: readonly unknown[];
+    plan?: LandXmlIfcPlan;
+    pipeNetworks?: {
+        networks?: readonly unknown[];
+    } | null;
+}
+//# sourceMappingURL=source-types.d.ts.map

package/dist/landxml/source-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-types.d.ts","sourceRoot":"","sources":["../../src/landxml/source-types.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;GAYG;AAEH,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,gFAAgF;IAChF,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IACnC,yCAAyC;IACzC,KAAK,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;IACtD,+DAA+D;IAC/D,cAAc,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IACpC,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAChC,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CAC/B;AAED,4EAA4E;AAC5E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC1C,SAAS,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC/B,YAAY,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAClC,OAAO,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,wEAAwE;IACxE,sBAAsB,EAAE,MAAM,CAAC;IAC/B,+EAA+E;IAC/E,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,oFAAoF;AACpF,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhD,2EAA2E;AAC3E,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,UAAU,CAAC;AAEnD,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,mBAAmB,CAAC;AAEnE;;;;GAIG;AACH,MAAM,MAAM,4BAA4B,GACpC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,kBAAkB,CAAC;IAAC,GAAG,EAAE,kBAAkB,CAAC;IAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACnG;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,kBAAkB,CAAC;IAAC,GAAG,EAAE,kBAAkB,CAAC;IAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC7G;IACA,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,kBAAkB,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAC;IAAC,GAAG,EAAE,kBAAkB,CAAC;IAC9F,QAAQ,EAAE,kBAAkB,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CACpF,GACC;IACA,IAAI,EAAE,QAAQ,GAAG,oBAAoB,CAAC;IAAC,KAAK,EAAE,kBAAkB,CAAC;IAAC,EAAE,EAAE,kBAAkB,CAAC;IACzF,GAAG,EAAE,kBAAkB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IACvG,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;CACvD,CAAC;AAEJ,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,4BAA4B,CAAC;CACzC;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,SAAS,0BAA0B,EAAE,CAAC;IAChD,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,gBAAgB,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IACtC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,YAAY,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAClC,eAAe,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IAC9B,gBAAgB,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxE,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACvC;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC9B,aAAa,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IACnC,oBAAoB,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC1C,QAAQ,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC9B,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,YAAY,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,SAAS,OAAO,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;CACzD"}

package/dist/landxml/source-types.js

@@ -0,0 +1,5 @@
+/* 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/. */
+export {};
+//# sourceMappingURL=source-types.js.map

package/dist/landxml/source-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-types.js","sourceRoot":"","sources":["../../src/landxml/source-types.ts"],"names":[],"mappings":"AAAA;;+DAE+D"}

package/dist/landxml/station-equations.d.ts

@@ -0,0 +1,69 @@
+/**
+ * LandXML `StaEquation` → `IfcReferent` / `Pset_Stationing` parameters
+ * (mapping spec §14).
+ *
+ * Pure numbers, like `alignment-mapping.ts`: the export dialog's pre-flight
+ * and the export itself run this same function, so the refusal the dialog
+ * shows is the refusal the export gives.
+ *
+ * An alignment's equations are mapped ALL OR NONE (§14.2). Stationing is
+ * cumulative, so writing some and dropping one would make every station after
+ * the dropped one wrong in a file that looks complete.
+ */
+import { type AlignmentMapping, type MappedAlignment } from './alignment-mapping.js';
+import type { LandXmlIfcAlignment, LandXmlIfcSource, LandXmlIfcUnits } from './source-types.js';
+/**
+ * A `StaEquation` as the parser delivers it. `LandXmlIfcAlignment.stationEquations`
+ * stays `unknown[]` (narrowing a published input type is a breaking change), so
+ * each record is checked against this shape at run time instead.
+ */
+export interface LandXmlIfcStationEquation {
+    sourceId: string;
+    /** Where, in the alignment's continuous stationing (`staStart` + distance along). */
+    staInternal: number;
+    /** The station from here on. */
+    staAhead: number;
+    /** The station arriving here, when authored. */
+    staBack: number | null;
+    /** `'increasing'` / `'decreasing'` — the direction of stationing after this point. */
+    staIncrement: string | null;
+}
+/** One station equation, in metres, ready for `Pset_Stationing`. */
+export interface MappedStationEquation {
+    sourceId: string;
+    /** Distance along the alignment's basis curve from its start. */
+    distanceAlong: number;
+    /** `Pset_Stationing.Station` — the ahead station. */
+    station: number;
+    /** `Pset_Stationing.IncomingStation` — authored `staBack`, or derived (§14.1). */
+    incomingStation: number;
+    /** `Pset_Stationing.HasIncreasingStation`; `null` when `staIncrement` was not authored. */
+    increasing: boolean | null;
+}
+export interface StationEquationMapping {
+    /** Written equations, in order along the alignment. Empty when refused. */
+    equations: MappedStationEquation[];
+    /** How many equations the source carries on this alignment. */
+    count: number;
+    /** Why they were all refused, or `null` when they are written. */
+    refusal: string | null;
+}
+/** Map one WRITTEN alignment's station equations, all or none (§14.2). */
+export declare function mapStationEquations(record: LandXmlIfcAlignment, alignment: MappedAlignment, units: LandXmlIfcUnits): StationEquationMapping;
+/**
+ * The station-equation mapping of every WRITTEN alignment, by source id. A
+ * refused alignment takes its equations with it and is absent here: counting
+ * them again would misstate what is missing.
+ */
+export declare function stationEquationsOf(source: LandXmlIfcSource, alignmentMapping: AlignmentMapping): Map<string, StationEquationMapping>;
+/**
+ * Every distance along the alignment at which the DISPLAYED `station` (metres)
+ * occurs, given its written station equations — `rust/landxml`'s
+ * `distances_for_station`, over the mapped (metre) values.
+ *
+ * Empty: the station falls in a forward jump's gap. More than one: a backward
+ * jump (or a change of direction) displays it twice. Only exactly one is a
+ * place (§12.2, §14.5).
+ */
+export declare function distancesForStation(station: number, startStation: number, equations: readonly MappedStationEquation[], length: number): number[];
+//# sourceMappingURL=station-equations.d.ts.map

package/dist/landxml/station-equations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"station-equations.d.ts","sourceRoot":"","sources":["../../src/landxml/station-equations.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AAEH,OAAO,EAC8C,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAC/F,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEhG;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,qFAAqF;IACrF,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,sFAAsF;IACtF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,oEAAoE;AACpE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,aAAa,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,eAAe,EAAE,MAAM,CAAC;IACxB,2FAA2F;IAC3F,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,2EAA2E;IAC3E,SAAS,EAAE,qBAAqB,EAAE,CAAC;IACnC,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAsED,0EAA0E;AAC1E,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,mBAAmB,EAAE,SAAS,EAAE,eAAe,EAAE,KAAK,EAAE,eAAe,GAC9E,sBAAsB,CASxB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,GAC3D,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAYrC;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,qBAAqB,EAAE,EAAE,MAAM,EAAE,MAAM,GACjG,MAAM,EAAE,CAcV"}

package/dist/landxml/station-equations.js

@@ -0,0 +1,140 @@
+/* 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/. */
+/**
+ * LandXML `StaEquation` → `IfcReferent` / `Pset_Stationing` parameters
+ * (mapping spec §14).
+ *
+ * Pure numbers, like `alignment-mapping.ts`: the export dialog's pre-flight
+ * and the export itself run this same function, so the refusal the dialog
+ * shows is the refusal the export gives.
+ *
+ * An alignment's equations are mapped ALL OR NONE (§14.2). Stationing is
+ * cumulative, so writing some and dropping one would make every station after
+ * the dropped one wrong in a file that looks complete.
+ */
+import { ALIGNMENT_POSITION_TOLERANCE_M, isAlignmentRecord, } from './alignment-mapping.js';
+class Refusal extends Error {
+}
+function refuse(message) {
+    throw new Refusal(message);
+}
+const finite = (value) => typeof value === 'number' && Number.isFinite(value);
+function checkRecord(value, label) {
+    const record = (typeof value === 'object' && value !== null ? value : {});
+    const increment = record.staIncrement;
+    if (typeof record.sourceId !== 'string' || !finite(record.staInternal) || !finite(record.staAhead)
+        || !(record.staBack === null || record.staBack === undefined || finite(record.staBack))
+        || !(increment === null || increment === undefined || increment === 'increasing' || increment === 'decreasing')) {
+        refuse(`${label} is not a station-equation record (it needs a finite staInternal and staAhead, `
+            + 'and a finite staBack and an increasing/decreasing staIncrement where given)');
+    }
+    return {
+        sourceId: record.sourceId,
+        staInternal: record.staInternal,
+        staAhead: record.staAhead,
+        staBack: finite(record.staBack) ? record.staBack : null,
+        staIncrement: typeof increment === 'string' ? increment : null,
+    };
+}
+function mapAll(records, alignment, units) {
+    const scale = units.linearScaleToMeters;
+    const length = alignment.segments.reduce((total, segment) => total + segment.length, 0);
+    const out = [];
+    // The running stationing, exactly as `rust/landxml`'s `station_mapping`
+    // walks it: the display value and direction in force since the last equation.
+    let previousDistance = 0;
+    let displayed = alignment.startStation;
+    let direction = 1;
+    records.forEach((value, index) => {
+        const label = `station equation ${index + 1}`;
+        const equation = checkRecord(value, label);
+        const distanceAlong = equation.staInternal * scale - alignment.startStation;
+        if (distanceAlong <= ALIGNMENT_POSITION_TOLERANCE_M) {
+            refuse(`${label} is at internal station ${equation.staInternal}, at or before the alignment's start`);
+        }
+        if (distanceAlong > length + ALIGNMENT_POSITION_TOLERANCE_M) {
+            refuse(`${label} is ${(distanceAlong - length).toFixed(3)} m beyond the alignment's end`);
+        }
+        if (index > 0 && distanceAlong <= previousDistance) {
+            refuse(`${label} is not after station equation ${index} along the alignment`);
+        }
+        const along = Math.min(distanceAlong, length);
+        const incomingStation = equation.staBack !== null
+            ? equation.staBack * scale
+            : displayed + direction * (along - previousDistance);
+        out.push({
+            sourceId: equation.sourceId,
+            distanceAlong: along,
+            station: equation.staAhead * scale,
+            incomingStation,
+            increasing: equation.staIncrement === null ? null : equation.staIncrement === 'increasing',
+        });
+        previousDistance = along;
+        displayed = equation.staAhead * scale;
+        direction = equation.staIncrement === 'decreasing' ? -1 : 1;
+    });
+    return out;
+}
+/** Map one WRITTEN alignment's station equations, all or none (§14.2). */
+export function mapStationEquations(record, alignment, units) {
+    const records = record.stationEquations ?? [];
+    if (records.length === 0)
+        return { equations: [], count: 0, refusal: null };
+    try {
+        return { equations: mapAll(records, alignment, units), count: records.length, refusal: null };
+    }
+    catch (error) {
+        if (!(error instanceof Refusal))
+            throw error;
+        return { equations: [], count: records.length, refusal: error.message };
+    }
+}
+/**
+ * The station-equation mapping of every WRITTEN alignment, by source id. A
+ * refused alignment takes its equations with it and is absent here: counting
+ * them again would misstate what is missing.
+ */
+export function stationEquationsOf(source, alignmentMapping) {
+    const out = new Map();
+    if (source.units === null)
+        return out;
+    const records = new Map();
+    for (const candidate of source.alignments ?? []) {
+        if (isAlignmentRecord(candidate) && !records.has(candidate.sourceId))
+            records.set(candidate.sourceId, candidate);
+    }
+    for (const alignment of alignmentMapping.mapped) {
+        const record = records.get(alignment.sourceId);
+        if (record)
+            out.set(alignment.sourceId, mapStationEquations(record, alignment, source.units));
+    }
+    return out;
+}
+/**
+ * Every distance along the alignment at which the DISPLAYED `station` (metres)
+ * occurs, given its written station equations — `rust/landxml`'s
+ * `distances_for_station`, over the mapped (metre) values.
+ *
+ * Empty: the station falls in a forward jump's gap. More than one: a backward
+ * jump (or a change of direction) displays it twice. Only exactly one is a
+ * place (§12.2, §14.5).
+ */
+export function distancesForStation(station, startStation, equations, length) {
+    const tolerance = ALIGNMENT_POSITION_TOLERANCE_M;
+    const boundaries = [0, ...equations.map((equation) => equation.distanceAlong), length];
+    const out = [];
+    for (let index = 0; index + 1 < boundaries.length; index += 1) {
+        const previous = index === 0 ? null : equations[index - 1];
+        const displayStart = previous ? previous.station : startStation;
+        const direction = previous?.increasing === false ? -1 : 1;
+        const candidate = boundaries[index] + (station - displayStart) / direction;
+        if (candidate < boundaries[index] - tolerance || candidate > boundaries[index + 1] + tolerance)
+            continue;
+        const distance = Math.min(Math.max(candidate, 0), length);
+        if (out.length === 0 || Math.abs(distance - out[out.length - 1]) > tolerance)
+            out.push(distance);
+    }
+    return out;
+}
+//# sourceMappingURL=station-equations.js.map

package/dist/landxml/station-equations.js.map

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

package/dist/landxml/writers.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The per-record writers `landXmlToIfc` composes: TIN surfaces, survey points
+ * and alignments. Split out of `landxml-to-ifc.ts` so the orchestrator reads
+ * as the sequence it is — refuse, warn, write, record provenance — and each
+ * record family's conversion can be read on its own.
+ *
+ * `toIfcVertex` is the one place a surface or survey point's axes are
+ * reordered (alignments do theirs in `alignment-mapping.ts`'s `planPoint`).
+ */
+import type { TerrainWriter } from '../ifc-creator-terrain.js';
+import type { MappedAlignment } from './alignment-mapping.js';
+import type { MappedProfile } from './profile-mapping.js';
+import type { StationEquationMapping } from './station-equations.js';
+import type { LandXmlIfcCgPoint, LandXmlIfcSurface, LandXmlIfcUnits } from './source-types.js';
+/** Deterministic GlobalId from a LandXML source id, passed in to avoid an import cycle. */
+export type GlobalIdOf = (sourceId: string) => string;
+export declare function writeSurfaces(terrain: TerrainWriter, surfaces: readonly LandXmlIfcSurface[], units: LandXmlIfcUnits, swap: boolean, landXmlGlobalId: GlobalIdOf): {
+    surfaces: number;
+    vertices: number;
+    triangles: number;
+    samples: Array<[number, number]>;
+};
+export declare function writeSurveyPoints(terrain: TerrainWriter, points: readonly LandXmlIfcCgPoint[], units: LandXmlIfcUnits, swap: boolean, landXmlGlobalId: GlobalIdOf): {
+    count: number;
+    samples: Array<[number, number]>;
+};
+/**
+ * Write each mapped alignment (§11). GlobalIds derive from the alignment's
+ * source id and the role of each owned entity, so a re-export of an unchanged
+ * alignment is byte-identical (§4.3).
+ */
+export declare function writeAlignments(terrain: TerrainWriter, alignments: readonly MappedAlignment[], landXmlGlobalId: GlobalIdOf, profiles?: readonly MappedProfile[], stationing?: ReadonlyMap<string, StationEquationMapping>): Array<[number, number]>;
+//# sourceMappingURL=writers.d.ts.map

package/dist/landxml/writers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writers.d.ts","sourceRoot":"","sources":["../../src/landxml/writers.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE/F,2FAA2F;AAC3F,MAAM,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;AA6EtD,wBAAgB,aAAa,CAC3B,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,iBAAiB,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,EACrG,eAAe,EAAE,UAAU,GAC1B;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAAE,CAwB7F;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,iBAAiB,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,EACnG,eAAe,EAAE,UAAU,GAC1B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAAE,CAyBrD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,eAAe,EAAE,EAAE,eAAe,EAAE,UAAU,EAC3F,QAAQ,GAAE,SAAS,aAAa,EAAO,EACvC,UAAU,GAAE,WAAW,CAAC,MAAM,EAAE,sBAAsB,CAAa,GAClE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA8BzB"}

package/dist/landxml/writers.js

@@ -0,0 +1,160 @@
+/* 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 { isMappableSurface } from './refusals.js';
+/**
+ * LandXML's authored `(northing, easting, elevation)` → IFC's
+ * `(X, Y, Z) = (easting, northing, elevation)`, in metres.
+ *
+ * The one place the axes are reordered. `swap` is the operator's confirmed
+ * override for a producer that wrote its point text easting-first; it reverses
+ * this function's own swap, so a swapped source and an unswapped one produce
+ * the same IFC.
+ */
+function toIfcVertex(northing, easting, elevation, units, swap) {
+    const plan = units.linearScaleToMeters;
+    const [x, y] = swap ? [northing, easting] : [easting, northing];
+    return [x * plan, y * plan, elevation * units.elevationScaleToMeters];
+}
+function surfaceVertices(surface, units, swap) {
+    const coordinates = [];
+    const indexById = new Map();
+    for (const point of surface.points) {
+        // `CoordIndex` is 1-based, so the index recorded here is `length` *after*
+        // the push — not before.
+        coordinates.push(toIfcVertex(point.northing, point.easting, point.elevation, units, swap));
+        // First writer wins on a duplicate `<P id>`: a later duplicate would
+        // silently repoint every face authored against the earlier one.
+        if (!indexById.has(point.id))
+            indexById.set(point.id, coordinates.length);
+    }
+    return { coordinates, indexById };
+}
+function surfaceTriangles(surface, indexById) {
+    const visibility = surface.faceVisibility;
+    const triangles = [];
+    surface.faces.forEach((face, ordinal) => {
+        // An authored `<F i="true">` is a hidden face: it is part of the source
+        // record but draws nothing, and writing it would add a triangle the source
+        // says is not there.
+        if (visibility && visibility[ordinal] === false)
+            return;
+        const resolved = face.map((pointId) => indexById.get(pointId));
+        if (resolved.some((index) => index === undefined)) {
+            throw new Error(`landXmlToIfc: surface '${surface.name}' face ${ordinal} references point id `
+                + `'${face.find((id) => !indexById.has(id))}', which the surface does not define`);
+        }
+        triangles.push(resolved);
+    });
+    return triangles;
+}
+/** Non-empty text properties of one CgPoint, in a stable order. */
+function surveyProperties(point, location) {
+    const entries = [
+        { Name: 'SourceId', Value: point.sourceId },
+    ];
+    if (point.name)
+        entries.push({ Name: 'Name', Value: point.name });
+    if (point.code)
+        entries.push({ Name: 'Code', Value: point.code });
+    if (point.description)
+        entries.push({ Name: 'Description', Value: point.description });
+    entries.push({ Name: 'Easting', Value: String(location[0]) }, { Name: 'Northing', Value: String(location[1]) });
+    // A 2D CgPoint is placed at Z = 0 because a placement needs a number, but
+    // the property set must not claim an elevation the source never authored.
+    if (point.point?.elevation !== null && point.point?.elevation !== undefined) {
+        entries.push({ Name: 'Elevation', Value: String(location[2]) });
+    }
+    return entries;
+}
+export function writeSurfaces(terrain, surfaces, units, swap, landXmlGlobalId) {
+    let written = 0;
+    let vertices = 0;
+    let triangles = 0;
+    const samples = [];
+    for (const surface of surfaces) {
+        if (!isMappableSurface(surface))
+            continue;
+        const { coordinates, indexById } = surfaceVertices(surface, units, swap);
+        const faces = surfaceTriangles(surface, indexById);
+        // Unreachable for an all-hidden surface — `isMappableSurface` refuses it by
+        // name first. Kept as a guard because CoordIndex is LIST [1:?].
+        if (faces.length === 0)
+            continue;
+        terrain.addSurface({
+            Name: surface.name,
+            GlobalId: landXmlGlobalId(surface.sourceId),
+            Coordinates: coordinates,
+            Triangles: faces,
+        });
+        written += 1;
+        vertices += coordinates.length;
+        triangles += faces.length;
+        for (const [x, y] of coordinates)
+            samples.push([x, y]);
+    }
+    return { surfaces: written, vertices, triangles, samples };
+}
+export function writeSurveyPoints(terrain, points, units, swap, landXmlGlobalId) {
+    let count = 0;
+    const samples = [];
+    for (const point of points) {
+        // A CgPoint may carry only a `pntRef`, with no coordinates of its own.
+        // `collectRefusals` names those as `unlocated-cgpoints`.
+        if (!point.point)
+            continue;
+        const location = toIfcVertex(point.point.northing, point.point.easting, point.point.elevation ?? 0, units, swap);
+        const annotationId = terrain.addSurveyPoint({
+            Name: point.name,
+            Description: point.description,
+            GlobalId: landXmlGlobalId(point.sourceId),
+            Location: location,
+        });
+        terrain.addPropertySet(annotationId, {
+            Name: 'LandXML_CgPoint',
+            GlobalId: landXmlGlobalId(`${point.sourceId}:pset`),
+            Properties: surveyProperties(point, location),
+        });
+        count += 1;
+        samples.push([location[0], location[1]]);
+    }
+    return { count, samples };
+}
+/**
+ * Write each mapped alignment (§11). GlobalIds derive from the alignment's
+ * source id and the role of each owned entity, so a re-export of an unchanged
+ * alignment is byte-identical (§4.3).
+ */
+export function writeAlignments(terrain, alignments, landXmlGlobalId, profiles = [], stationing = new Map()) {
+    const samples = [];
+    for (const alignment of alignments) {
+        // At most one: `mapProfiles` refuses every design profile of an alignment
+        // that has more than one (§12.2).
+        const profile = profiles.find((candidate) => candidate.alignmentSourceId === alignment.sourceId);
+        terrain.addAlignment({
+            ...(profile ? {
+                Vertical: { Name: profile.name, GlobalId: landXmlGlobalId(profile.sourceId), Segments: profile.segments },
+            } : {}),
+            Name: alignment.name,
+            GlobalId: landXmlGlobalId(alignment.sourceId),
+            StartStation: alignment.startStation,
+            Segments: alignment.segments,
+            // §14: each written equation is an IfcReferent whose GlobalId derives
+            // from the equation's own source id.
+            StationEquations: (stationing.get(alignment.sourceId)?.equations ?? []).map((equation) => ({
+                DistanceAlong: equation.distanceAlong,
+                Station: equation.station,
+                IncomingStation: equation.incomingStation,
+                HasIncreasingStation: equation.increasing,
+                Role: equation.sourceId.startsWith(`${alignment.sourceId}:`)
+                    ? equation.sourceId.slice(alignment.sourceId.length + 1)
+                    : equation.sourceId,
+            })),
+            guidFor: (role) => landXmlGlobalId(`${alignment.sourceId}:${role}`),
+        });
+        for (const segment of alignment.segments)
+            samples.push([segment.start[0], segment.start[1]]);
+    }
+    return samples;
+}
+//# sourceMappingURL=writers.js.map

package/dist/landxml/writers.js.map

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

package/dist/types.d.ts

@@ -414,12 +414,23 @@ export interface ProxyParams extends ElementAttributes {
     ProxyType?: string;
 }
 /** IFC property value types */
-export type PropertyType = 'IfcLabel' | 'IfcText' | 'IfcIdentifier' | 'IfcReal' | 'IfcInteger' | 'IfcBoolean' | 'IfcLogical';
+/**
+ * A numeric measure type -- `IfcThermalTransmittanceMeasure`,
+ * `IfcPositiveLengthMeasure`, `IfcCountMeasure`, `IfcPlaneAngleMeasure`, ...
+ * Standard property sets declare their values in these (Pset_WallCommon's
+ * ThermalTransmittance is an IfcThermalTransmittanceMeasure, not an IfcReal),
+ * and an IDS check on the data type fails a value written as the wrong one.
+ */
+export type PropertyMeasureType = `Ifc${string}Measure`;
+export type PropertyType = 'IfcLabel' | 'IfcText' | 'IfcIdentifier' | 'IfcReal' | 'IfcInteger' | 'IfcBoolean' | 'IfcLogical' | PropertyMeasureType;
 /** Single property definition */
 export interface PropertyDef {
     Name: string;
     NominalValue: string | number | boolean;
-    /** Defaults to IfcLabel for strings, IfcReal for numbers, IfcBoolean for booleans */
+    /**
+     * Defaults to IfcLabel for strings, IfcInteger/IfcReal for numbers, IfcBoolean
+     * for booleans. A numeric value may declare any measure type and is written as it.
+     */
     Type?: PropertyType;
 }
 /** Property set to attach to an element */