@ifc-lite/create 2.8.0 → 3.1.0

package/dist/landxml/profile-mapping.js

@@ -0,0 +1,181 @@
+/* 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/. */
+/**
+ * Which LandXML profiles become an `IfcAlignmentVertical`, and which are
+ * refused by name (mapping spec §12.2).
+ *
+ * Like `alignment-mapping.ts`, no STEP is written here, so the export dialog's
+ * pre-flight and the export itself give the same answer. The geometry lives in
+ * `profile-geometry.ts`; this module decides linkage and runs the mapping.
+ */
+import { ALIGNMENT_POSITION_TOLERANCE_M, isAlignmentRecord } from './alignment-mapping.js';
+import { ProfileRefusal, assembleProfile, checkProfile, curveSegments, refuseProfile, } from './profile-geometry.js';
+import { profileRecordProblem } from './profile-record.js';
+import { distancesForStation } from './station-equations.js';
+function mapDesignProfile(profile, distanceOf, horizontalLength, units) {
+    if (profile.pvis.length < 2)
+        refuseProfile('it has fewer than two PVIs, so it has no grade');
+    const vertices = profile.pvis.map((pvi, index) => {
+        if (pvi.elevation === null || !Number.isFinite(pvi.elevation) || !Number.isFinite(pvi.station)) {
+            refuseProfile(`its PVI ${index + 1} has no finite station and elevation`);
+        }
+        return {
+            sourceId: pvi.sourceId,
+            distAlong: distanceOf(pvi.station, `its PVI ${index + 1}`),
+            height: pvi.elevation * units.elevationScaleToMeters,
+        };
+    });
+    vertices.slice(1).forEach((vertex, index) => {
+        if (vertex.distAlong <= vertices[index].distAlong)
+            refuseProfile(`its PVI ${index + 2} does not advance in station`);
+    });
+    const start = vertices[0].distAlong;
+    const end = vertices[vertices.length - 1].distAlong;
+    if (start < -ALIGNMENT_POSITION_TOLERANCE_M || end > horizontalLength + ALIGNMENT_POSITION_TOLERANCE_M) {
+        refuseProfile(`it runs from ${start.toFixed(3)} m to ${end.toFixed(3)} m along an alignment ${horizontalLength.toFixed(3)} m long`);
+    }
+    const gradeOf = (a, b) => (b.height - a.height) / (b.distAlong - a.distAlong);
+    const curves = vertices.map(() => []);
+    const seen = new Set();
+    profile.verticalCurves.forEach((curve, curveIndex) => {
+        const label = `vertical curve ${curveIndex + 1}`;
+        // The parser records a curve's PVI in `pvis` with the same station and
+        // elevation — the same pairing `rust/landxml`'s profile evaluator uses.
+        const index = profile.pvis.findIndex((pvi) => pvi.station === curve.station && pvi.elevation === curve.elevation);
+        if (index <= 0 || index >= vertices.length - 1) {
+            refuseProfile(`${label} is not at an interior PVI, so it has no grade on both sides`);
+        }
+        if (seen.has(index))
+            refuseProfile(`PVI ${index + 1} carries more than one vertical curve`);
+        seen.add(index);
+        const before = vertices[index - 1];
+        const pvi = vertices[index];
+        const after = vertices[index + 1];
+        curves[index] = curveSegments(curve, pvi, gradeOf(before, pvi), gradeOf(pvi, after), units, label);
+    });
+    const segments = assembleProfile(profile.sourceId, vertices, curves);
+    checkProfile(segments, vertices, curves);
+    return segments;
+}
+/**
+ * Map every profile onto the alignments `alignmentMapping` writes, and refuse
+ * the rest by name (§12.2). `alignments` is the source's raw list — a
+ * profile's link is checked against it, not only against the written ones, so
+ * a profile of a refused alignment says so rather than reading as unlinked.
+ */
+export function mapProfiles(profiles, alignments, alignmentMapping, units, stationing = new Map()) {
+    const result = { mapped: [], refused: [] };
+    const records = (alignments ?? []).filter(isAlignmentRecord);
+    const written = new Map(alignmentMapping.mapped.map((alignment) => [alignment.sourceId, alignment]));
+    const designCount = new Map();
+    const valid = [];
+    (profiles ?? []).forEach((candidate, index) => {
+        const problem = profileRecordProblem(candidate);
+        if (problem === null) {
+            valid.push(candidate);
+            return;
+        }
+        const header = candidate;
+        const named = typeof header?.sourceId === 'string' && typeof header.name === 'string';
+        result.refused.push({
+            sourceId: named ? header.sourceId : `profile[${index}]`,
+            name: named ? header.name || header.sourceId : `profile ${index + 1}`,
+            reason: problem,
+        });
+    });
+    // A profile is linked when its alignment exists and, if that alignment
+    // lists its profiles, lists this one. Only LINKED design profiles compete
+    // for the alignment's one vertical layout: an unlinked sibling is refused
+    // on its own and must not make the linked one look ambiguous (#5930 review).
+    const alignmentOf = (profile) => records.find((record) => record.sourceId === profile.parentAlignmentSourceId);
+    const isLinked = (profile) => {
+        const alignment = alignmentOf(profile);
+        const listed = alignment?.profileSourceIds ?? [];
+        return alignment !== undefined && (listed.length === 0 || listed.includes(profile.sourceId));
+    };
+    for (const profile of valid) {
+        if (profile.kind === 'design' && isLinked(profile)) {
+            designCount.set(profile.parentAlignmentSourceId, (designCount.get(profile.parentAlignmentSourceId) ?? 0) + 1);
+        }
+    }
+    for (const profile of valid) {
+        const refuse = (reason) => {
+            result.refused.push({ sourceId: profile.sourceId, name: profile.name || profile.sourceId, reason });
+        };
+        const alignment = alignmentOf(profile);
+        // An empty `profileSourceIds` declares nothing; a non-empty one must agree.
+        if (!alignment || !isLinked(profile)) {
+            refuse('it is not linked to any alignment in the file');
+            continue;
+        }
+        const alignmentName = alignment.name || alignment.sourceId;
+        const mapped = written.get(alignment.sourceId);
+        if (!mapped || units === null) {
+            refuse(`its alignment '${alignmentName}' is not written, so there is no horizontal to measure it along`);
+            continue;
+        }
+        if (profile.kind === 'sampled') {
+            refuse('it is a sampled ground profile (ProfSurf), not a design vertical layout');
+            continue;
+        }
+        const designs = designCount.get(alignment.sourceId) ?? 0;
+        if (designs > 1) {
+            refuse(`its alignment '${alignmentName}' has ${designs} design profiles, and IFC nests one vertical layout under an alignment; choosing one would be a guess`);
+            continue;
+        }
+        const horizontalLength = mapped.segments.reduce((total, segment) => total + segment.length, 0);
+        const distanceOf = profileDistances(alignment, mapped.startStation, horizontalLength, units, stationing);
+        if (typeof distanceOf === 'string') {
+            refuse(distanceOf);
+            continue;
+        }
+        try {
+            result.mapped.push({
+                sourceId: profile.sourceId,
+                name: profile.name,
+                alignmentSourceId: alignment.sourceId,
+                segments: mapDesignProfile(profile, distanceOf, horizontalLength, units),
+            });
+        }
+        catch (error) {
+            if (!(error instanceof ProfileRefusal))
+                throw error;
+            refuse(error.message);
+        }
+    }
+    return result;
+}
+/**
+ * How a profile's stations become distances along its alignment (§14.5).
+ *
+ * Without station equations, linearly from the start station. With written
+ * ones, through the displayed stationing they define: a PVI station must occur
+ * at exactly one place along the alignment, and one in a forward jump's gap or
+ * displayed twice after a backward jump is refused by name, never guessed. When
+ * the alignment's equations were themselves refused (§14.2) there is no
+ * stationing to read the profile against, so it is refused as a whole.
+ */
+function profileDistances(alignment, startStation, length, units, stationing) {
+    const scale = units.linearScaleToMeters;
+    if ((alignment.stationEquations?.length ?? 0) === 0) {
+        return (station) => station * scale - startStation;
+    }
+    const alignmentName = alignment.name || alignment.sourceId;
+    const mapping = stationing.get(alignment.sourceId);
+    if (!mapping || mapping.refusal !== null) {
+        return `its alignment '${alignmentName}' has station equations that are not written, so its stations cannot be placed along it`;
+    }
+    return (station, label) => {
+        const places = distancesForStation(station * scale, startStation, mapping.equations, length);
+        if (places.length === 0) {
+            refuseProfile(`${label} is at station ${station}, which falls in a station-equation gap of '${alignmentName}'`);
+        }
+        if (places.length > 1) {
+            refuseProfile(`${label} is at station ${station}, which '${alignmentName}' displays at ${places.length} places `
+                + `(${places.map((place) => `${place.toFixed(3)} m`).join(', ')}); choosing one would be a guess`);
+        }
+        return places[0];
+    };
+}
+//# sourceMappingURL=profile-mapping.js.map

package/dist/landxml/profile-mapping.js.map

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

package/dist/landxml/profile-record.d.ts

@@ -0,0 +1,46 @@
+/**
+ * The shape of one `LandXmlIfcSource.profiles` record, and its run-time check
+ * (mapping spec §12).
+ *
+ * `profiles` stays `unknown[]` on the source (narrowing a published input type
+ * is a breaking change, #5370 review), so every record is checked here before
+ * the mapper reads it — exactly as `alignment-record.ts` does for alignments.
+ * A record that fails is refused by name, never read into.
+ *
+ * The shapes mirror the viewer's `LandXmlProfile` field for field, so the
+ * viewer's parsed document satisfies them without a translation layer.
+ */
+/** One `PVI` (or sampled station/elevation pair), in the file's declared units. */
+export interface LandXmlIfcProfilePoint {
+    sourceId: string;
+    /** A STATION, not a distance along: `staStart` has not been subtracted. */
+    station: number;
+    elevation: number | null;
+}
+/**
+ * A `ParaCurve`, `UnsymParaCurve` or `CircCurve`, anchored at its PVI. The
+ * parser also records that PVI in `pvis`, with the same station and elevation.
+ */
+export interface LandXmlIfcVerticalCurve {
+    sourceId: string;
+    kind: 'parabolic' | 'unsymmetrical_parabolic' | 'circular';
+    station: number;
+    elevation: number | null;
+    length: number | null;
+    lengthIn: number | null;
+    lengthOut: number | null;
+    radius: number | null;
+}
+/** A `ProfAlign` (`kind: 'design'`) or `ProfSurf` (`kind: 'sampled'`) under an alignment. */
+export interface LandXmlIfcProfile {
+    sourceId: string;
+    parentAlignmentSourceId: string;
+    name: string;
+    kind: 'design' | 'sampled';
+    /** Authored order. */
+    pvis: readonly LandXmlIfcProfilePoint[];
+    verticalCurves: readonly LandXmlIfcVerticalCurve[];
+}
+/** Why this record is not a `LandXmlIfcProfile`, or `null` when it is. */
+export declare function profileRecordProblem(value: unknown): string | null;
+//# sourceMappingURL=profile-record.d.ts.map

package/dist/landxml/profile-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-record.d.ts","sourceRoot":"","sources":["../../src/landxml/profile-record.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AAEH,mFAAmF;AACnF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,WAAW,GAAG,yBAAyB,GAAG,UAAU,CAAC;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,6FAA6F;AAC7F,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB,EAAE,MAAM,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC3B,sBAAsB;IACtB,IAAI,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACxC,cAAc,EAAE,SAAS,uBAAuB,EAAE,CAAC;CACpD;AAqBD,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAgBlE"}

package/dist/landxml/profile-record.js

@@ -0,0 +1,38 @@
+/* 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/. */
+const isObject = (value) => typeof value === 'object' && value !== null;
+const isNumber = (value) => typeof value === 'number';
+const isOptionalNumber = (value) => value === null || isNumber(value);
+function isPoint(value) {
+    return isObject(value) && typeof value.sourceId === 'string' && isNumber(value.station)
+        && isOptionalNumber(value.elevation);
+}
+function isCurve(value) {
+    return isObject(value) && typeof value.sourceId === 'string'
+        && (value.kind === 'parabolic' || value.kind === 'unsymmetrical_parabolic' || value.kind === 'circular')
+        && isNumber(value.station) && isOptionalNumber(value.elevation)
+        && isOptionalNumber(value.length) && isOptionalNumber(value.lengthIn)
+        && isOptionalNumber(value.lengthOut) && isOptionalNumber(value.radius);
+}
+/** Why this record is not a `LandXmlIfcProfile`, or `null` when it is. */
+export function profileRecordProblem(value) {
+    if (!isObject(value)
+        || typeof value.sourceId !== 'string'
+        || typeof value.parentAlignmentSourceId !== 'string'
+        || typeof value.name !== 'string'
+        || (value.kind !== 'design' && value.kind !== 'sampled')
+        || !Array.isArray(value.pvis)
+        || !Array.isArray(value.verticalCurves)) {
+        return 'it is not a profile record (it needs a sourceId, a parentAlignmentSourceId, a name, a design or '
+            + 'sampled kind, and PVI and vertical-curve lists)';
+    }
+    const badPoint = value.pvis.findIndex((point) => !isPoint(point));
+    if (badPoint !== -1)
+        return `its PVI ${badPoint + 1} is not a station/elevation record`;
+    const badCurve = value.verticalCurves.findIndex((curve) => !isCurve(curve));
+    if (badCurve !== -1)
+        return `its vertical curve ${badCurve + 1} is not a ParaCurve, UnsymParaCurve or CircCurve record`;
+    return null;
+}
+//# sourceMappingURL=profile-record.js.map

package/dist/landxml/profile-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-record.js","sourceRoot":"","sources":["../../src/landxml/profile-record.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAmD/D,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AAClG,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAW,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;AACxE,MAAM,gBAAgB,GAAG,CAAC,KAAc,EAAW,EAAE,CAAC,KAAK,KAAK,IAAI,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC;AAExF,SAAS,OAAO,CAAC,KAAc;IAC7B,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC;WAClF,gBAAgB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,OAAO,CAAC,KAAc;IAC7B,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ;WACvD,CAAC,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,IAAI,KAAK,yBAAyB,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC;WACrG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,gBAAgB,CAAC,KAAK,CAAC,SAAS,CAAC;WAC5D,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC;WAClE,gBAAgB,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC3E,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;WACf,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ;WAClC,OAAO,KAAK,CAAC,uBAAuB,KAAK,QAAQ;WACjD,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;WAC9B,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC;WACrD,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;WAC1B,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC;QAC1C,OAAO,kGAAkG;cACrG,iDAAiD,CAAC;IACxD,CAAC;IACD,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAClE,IAAI,QAAQ,KAAK,CAAC,CAAC;QAAE,OAAO,WAAW,QAAQ,GAAG,CAAC,oCAAoC,CAAC;IACxF,MAAM,QAAQ,GAAG,KAAK,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5E,IAAI,QAAQ,KAAK,CAAC,CAAC;QAAE,OAAO,sBAAsB,QAAQ,GAAG,CAAC,yDAAyD,CAAC;IACxH,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/landxml/refusals.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Enumerate the LandXML record families a source carries that v1 does not map.
+ *
+ * §5 of the mapping spec: named, never silently dropped. The point of counting
+ * them is that "this file has 14 alignments and none of them are in your IFC"
+ * is actionable, while a missing record is not even noticeable.
+ */
+import type { LandXmlIfcSource, LandXmlIfcSurface } from './source-types.js';
+import type { LandXmlRefusal } from './result-types.js';
+import { type AlignmentMapping, type RefusedAlignment } from './alignment-mapping.js';
+import { type ProfileMapping, type RefusedProfile } from './profile-mapping.js';
+import { type StationEquationMapping } from './station-equations.js';
+/**
+ * A surface v1 can write: a rendered TIN with vertices and at least one
+ * VISIBLE face. A surface whose every face is an authored `<F i="true">` draws
+ * nothing, so it is refused by name like any other non-rendered surface rather
+ * than vanishing from an otherwise successful export.
+ */
+export declare function isMappableSurface(surface: LandXmlIfcSurface): boolean;
+/**
+ * Every out-of-scope family the source actually contains, with its count.
+ *
+ * A family with zero records is absent from the list rather than present with
+ * `count: 0` — a refusal the user cannot act on is noise, and "0 parcels were
+ * not exported" is exactly that.
+ */
+/** The alignment mapping for a source, computed the one way both the plan and the export use. */
+export declare function alignmentMappingOf(source: LandXmlIfcSource): AlignmentMapping;
+export declare function collectRefusals(source: LandXmlIfcSource, alignmentMapping?: AlignmentMapping, profileMapping?: ProfileMapping, stationing?: ReadonlyMap<string, StationEquationMapping>): LandXmlRefusal[];
+/**
+ * Name each refused alignment and why. A count alone ("2 alignments") leaves
+ * the operator unable to tell a spiral type from a gap from a sign problem.
+ */
+export declare function alignmentRefusalMessage(refused: readonly RefusedAlignment[]): string;
+/** Name each refused profile and why (§12.6), as alignments are. */
+export declare function profileRefusalMessage(refused: readonly RefusedProfile[]): string;
+/**
+ * The sentence shown when nothing in the source is mappable.
+ *
+ * It names what the file *does* hold. A bare "nothing to export" leaves the
+ * operator to guess whether the file is empty, unsupported, or broken — and
+ * for the alignment-only files §9.4 is about, the answer is none of those.
+ */
+export declare function refusalReason(refusals: readonly LandXmlRefusal[]): string;
+//# sourceMappingURL=refusals.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"refusals.d.ts","sourceRoot":"","sources":["../../src/landxml/refusals.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAuB,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAClG,OAAO,KAAK,EAAE,cAAc,EAAwB,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EACgD,KAAK,gBAAgB,EAAE,KAAK,gBAAgB,EAClG,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAe,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC7F,OAAO,EAAsB,KAAK,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAmCzF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAIrE;AAED;;;;;;GAMG;AACH,iGAAiG;AACjG,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAE7E;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,GAAE,gBAA6C,EACzF,cAAc,GAAE,cAEf,EACD,UAAU,GAAE,WAAW,CAAC,MAAM,EAAE,sBAAsB,CAAgD,GACrG,cAAc,EAAE,CA2ClB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,GAAG,MAAM,CAOpF;AAED,oEAAoE;AACpE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,CAKhF;AAcD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,CAOzE"}

package/dist/landxml/refusals.js

@@ -0,0 +1,141 @@
+/* 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 { cogoPointResolver, isAlignmentRecord, mapAlignments, } from './alignment-mapping.js';
+import { mapProfiles } from './profile-mapping.js';
+import { stationEquationsOf } from './station-equations.js';
+/**
+ * Why each family is out of scope, in the operator's terms.
+ *
+ * Kept as one table rather than inline strings so the export dialog, the
+ * provenance property set and the refusal report cannot drift apart on what
+ * the same family is called.
+ */
+const FAMILY_REASONS = {
+    alignments: 'an alignment is written only when every horizontal segment is a line, circular arc or clothoid that reproduces its authored end point; one that does not is refused whole, because a gap would make every later station wrong',
+    profiles: 'a profile is written, as IfcAlignmentVertical, only when it is the one design profile of a written alignment and its grades and vertical curves reproduce every authored PVI; one that does not is refused whole',
+    'cross-sections': 'cross sections have no v1 mapping — they are sampled along an alignment, which v1 does not carry',
+    roadways: 'roadways have no v1 mapping — they compose alignments and surfaces, and v1 carries only the surfaces',
+    parcels: 'parcel boundaries have no v1 mapping',
+    monuments: 'survey monuments have no v1 mapping; only CgPoints become IfcAnnotation/.SURVEY.',
+    'plan-features': 'plan features have no v1 mapping',
+    'pipe-networks': 'pipe networks, structures and pipes have no v1 mapping',
+    'surface-boundaries': 'surface boundary polylines are not written; only the triangulated surface itself is',
+    'surface-breaklines': 'surface breaklines are not written; only the triangulated surface itself is',
+    'surface-contours': 'surface contour lines are not written; only the triangulated surface itself is',
+    'non-rendered-surfaces': 'surfaces that carry no numeric, renderable triangulation (or whose every face is hidden) cannot become an IfcTriangulatedIrregularNetwork',
+    'unlocated-cgpoints': 'CgPoints that carry only a point reference and no coordinates of their own have nothing to place',
+    'station-equations': "an alignment's station equations are written all or none, because a dropped one would make every later station wrong; the alignment is still written, with its start station only",
+    cant: 'cant (rail superelevation) has no mapping; the alignment is written with its horizontal layout only',
+    superelevation: 'road superelevation has no mapping; the alignment is written with its horizontal layout only',
+};
+function countAcrossSurfaces(surfaces, pick) {
+    return surfaces.reduce((total, surface) => total + (pick(surface)?.length ?? 0), 0);
+}
+/**
+ * A surface v1 can write: a rendered TIN with vertices and at least one
+ * VISIBLE face. A surface whose every face is an authored `<F i="true">` draws
+ * nothing, so it is refused by name like any other non-rendered surface rather
+ * than vanishing from an otherwise successful export.
+ */
+export function isMappableSurface(surface) {
+    return surface.renderState === 'rendered'
+        && surface.points.length > 0
+        && surface.faces.some((_, ordinal) => surface.faceVisibility?.[ordinal] !== false);
+}
+/**
+ * Every out-of-scope family the source actually contains, with its count.
+ *
+ * A family with zero records is absent from the list rather than present with
+ * `count: 0` — a refusal the user cannot act on is noise, and "0 parcels were
+ * not exported" is exactly that.
+ */
+/** The alignment mapping for a source, computed the one way both the plan and the export use. */
+export function alignmentMappingOf(source) {
+    return mapAlignments(source.alignments, source.units, false, cogoPointResolver(source.plan?.cogoPoints));
+}
+export function collectRefusals(source, alignmentMapping = alignmentMappingOf(source), profileMapping = mapProfiles(source.profiles, source.alignments, alignmentMapping, source.units, stationEquationsOf(source, alignmentMapping)), stationing = stationEquationsOf(source, alignmentMapping)) {
+    // Only the alignments that are WRITTEN carry these on into the IFC; a
+    // refused alignment takes its station equations and cant with it, and
+    // counting them twice would misstate what is missing.
+    const written = new Set(alignmentMapping.mapped.map((alignment) => alignment.sourceId));
+    const writtenAlignments = (source.alignments ?? [])
+        .filter(isAlignmentRecord)
+        .filter((alignment) => written.has(alignment.sourceId));
+    const counts = [
+        ['alignments', alignmentMapping.refused.length],
+        // Written as IfcReferents (§14) unless refused, all or none, per alignment.
+        ['station-equations', writtenAlignments.reduce((n, a) => n + (stationing.get(a.sourceId)?.refusal ? (a.stationEquations?.length ?? 0) : 0), 0)],
+        ['cant', writtenAlignments.filter((a) => a.cant || (a.cantStations?.length ?? 0) > 0).length],
+        ['superelevation', writtenAlignments.reduce((n, a) => n + (a.superelevations?.length ?? 0), 0)],
+        ['profiles', profileMapping.refused.length],
+        ['cross-sections', (source.crossSections?.length ?? 0) + (source.crossSectionSurfaces?.length ?? 0)],
+        ['roadways', source.roadways?.length ?? 0],
+        ['parcels', source.plan?.parcels?.length ?? 0],
+        ['monuments', source.plan?.monuments?.length ?? 0],
+        ['plan-features', source.plan?.planFeatures?.length ?? 0],
+        ['pipe-networks', source.pipeNetworks?.networks?.length ?? 0],
+        ['surface-boundaries', countAcrossSurfaces(source.surfaces, (s) => s.boundaries)],
+        ['surface-breaklines', countAcrossSurfaces(source.surfaces, (s) => s.breaklines)],
+        ['surface-contours', countAcrossSurfaces(source.surfaces, (s) => s.contours)],
+        ['non-rendered-surfaces', source.surfaces.filter((s) => !isMappableSurface(s)).length],
+        ['unlocated-cgpoints', (source.plan?.cogoPoints ?? []).filter((point) => point.point === null).length],
+    ];
+    return counts
+        .filter(([, count]) => count > 0)
+        .map(([family, count]) => ({
+        family,
+        count,
+        message: family === 'alignments'
+            ? alignmentRefusalMessage(alignmentMapping.refused)
+            : family === 'profiles'
+                ? profileRefusalMessage(profileMapping.refused)
+                : family === 'station-equations'
+                    ? stationEquationRefusalMessage(count, writtenAlignments, stationing)
+                    : `${count} ${family.replace(/-/g, ' ')} record${count === 1 ? '' : 's'} will not be included: ${FAMILY_REASONS[family]}.`,
+    }));
+}
+/**
+ * Name each refused alignment and why. A count alone ("2 alignments") leaves
+ * the operator unable to tell a spiral type from a gap from a sign problem.
+ */
+export function alignmentRefusalMessage(refused) {
+    // Every one is named: an alignment left out as "and N more" is one the
+    // operator cannot find or fix (#5370 review).
+    const count = refused.length;
+    const named = refused.map((entry) => `'${entry.name}': ${entry.reason}`);
+    return `${count} alignment record${count === 1 ? '' : 's'} will not be included (${named.join('; ')}). `
+        + `${FAMILY_REASONS.alignments}.`;
+}
+/** Name each refused profile and why (§12.6), as alignments are. */
+export function profileRefusalMessage(refused) {
+    const count = refused.length;
+    const named = refused.map((entry) => `'${entry.name}': ${entry.reason}`);
+    return `${count} profile record${count === 1 ? '' : 's'} will not be included (${named.join('; ')}). `
+        + `${FAMILY_REASONS.profiles}.`;
+}
+/** Name each alignment whose station equations were refused, and why (§14.2). */
+function stationEquationRefusalMessage(count, alignments, stationing) {
+    const named = alignments.flatMap((alignment) => {
+        const reason = stationing.get(alignment.sourceId)?.refusal;
+        return reason ? [`'${alignment.name || alignment.sourceId}': ${reason}`] : [];
+    });
+    return `${count} station equation record${count === 1 ? '' : 's'} will not be included (${named.join('; ')}). `
+        + `${FAMILY_REASONS['station-equations']}.`;
+}
+/**
+ * The sentence shown when nothing in the source is mappable.
+ *
+ * It names what the file *does* hold. A bare "nothing to export" leaves the
+ * operator to guess whether the file is empty, unsupported, or broken — and
+ * for the alignment-only files §9.4 is about, the answer is none of those.
+ */
+export function refusalReason(refusals) {
+    if (refusals.length === 0) {
+        return 'This LandXML file carries no triangulated surface, no CgPoints and no alignment, so there is nothing the IFC mapping can write.';
+    }
+    const families = refusals.map((refusal) => `${refusal.count} ${refusal.family.replace(/-/g, ' ')}`).join(', ');
+    return `This LandXML file carries no record the IFC mapping covers. It contains ${families}, `
+        + 'none of which has a v1 mapping. Export the original LandXML file instead.';
+}
+//# sourceMappingURL=refusals.js.map

package/dist/landxml/refusals.js.map

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

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

@@ -0,0 +1,78 @@
+/**
+ * What a LandXML→IFC conversion returns.
+ *
+ * The result is a discriminated union rather than a string plus an error
+ * channel, because §6 of the mapping makes refusal a first-class outcome: a
+ * source with no in-scope record must refuse outright, not hand back a valid,
+ * empty, useless IFC. A caller cannot reach `content` without having seen
+ * which of the two happened.
+ */
+import type { LandXmlIfcUnits } from './source-types.js';
+/**
+ * A LandXML record family the v1 mapping does not cover (§5).
+ *
+ * Named, never silently dropped — the family names are the vocabulary the
+ * export dialog shows the user before they commit.
+ */
+export type LandXmlRefusedFamily = 'alignments' | 'profiles' | 'cross-sections' | 'roadways' | 'parcels' | 'monuments' | 'plan-features' | 'pipe-networks' | 'surface-boundaries' | 'surface-breaklines' | 'surface-contours' | 'non-rendered-surfaces' | 'unlocated-cgpoints' | 'station-equations' | 'cant' | 'superelevation';
+export interface LandXmlRefusal {
+    family: LandXmlRefusedFamily;
+    /** How many records of this family the source holds. Always ≥ 1. */
+    count: number;
+    /** One sentence, addressed to the operator, saying what is left out and why. */
+    message: string;
+}
+/** A condition worth surfacing that does not stop the export (§9.1). */
+export interface LandXmlIfcWarning {
+    /** Stable code so the UI can style or suppress by kind, never by text. */
+    code: 'LXIFC-COORD-ORDER' | 'LXIFC-ASSUMED-UNIT' | 'LXIFC-NO-CRS' | 'LXIFC-COORD-SWAPPED';
+    message: string;
+}
+export interface LandXmlIfcCoverage {
+    /** TIN surfaces written as `IfcGeographicElement`/`.TERRAIN.`. */
+    surfaces: number;
+    /** `<CgPoint>` records written as `IfcAnnotation`/`.SURVEY.`. */
+    surveyPoints: number;
+    /** Vertices across all written surfaces. */
+    vertices: number;
+    /** Triangles across all written surfaces. */
+    triangles: number;
+    /**
+     * Horizontal alignments written as `IfcAlignment` (§11). `landXmlToIfc`
+     * always sets it; it is optional only so that adding it is not a breaking
+     * change to an interface v1.0 may already have published (#5370 review) —
+     * read it as `coverage.alignments ?? 0`.
+     */
+    alignments?: number;
+    /**
+     * Design profiles written as `IfcAlignmentVertical` (§12). Optional for the
+     * same reason as `alignments`: read it as `coverage.profiles ?? 0`.
+     */
+    profiles?: number;
+}
+/** What the produced file records about where it came from (§7). */
+export interface LandXmlIfcProvenance {
+    sourceFileName: string | null;
+    sourceHash: string | null;
+    mappingVersion: string;
+    landXmlSchema: string;
+    units: LandXmlIfcUnits | null;
+    assumedLinearUnit: string | null;
+    coordinateOrderSwapped: boolean;
+    refusedFamilies: readonly LandXmlRefusedFamily[];
+}
+export type LandXmlIfcResult = {
+    status: 'exported';
+    content: string;
+    coverage: LandXmlIfcCoverage;
+    provenance: LandXmlIfcProvenance;
+    refusals: readonly LandXmlRefusal[];
+    warnings: readonly LandXmlIfcWarning[];
+} | {
+    status: 'refused';
+    /** Why nothing could be written, naming what the source does contain. */
+    reason: string;
+    refusals: readonly LandXmlRefusal[];
+    warnings: readonly LandXmlIfcWarning[];
+};
+//# sourceMappingURL=result-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"result-types.d.ts","sourceRoot":"","sources":["../../src/landxml/result-types.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAC5B,YAAY,GACZ,UAAU,GACV,gBAAgB,GAChB,UAAU,GACV,SAAS,GACT,WAAW,GACX,eAAe,GACf,eAAe,GACf,oBAAoB,GACpB,oBAAoB,GACpB,kBAAkB,GAClB,uBAAuB,GACvB,oBAAoB,GACpB,mBAAmB,GACnB,MAAM,GACN,gBAAgB,CAAC;AAErB,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wEAAwE;AACxE,MAAM,WAAW,iBAAiB;IAChC,0EAA0E;IAC1E,IAAI,EAAE,mBAAmB,GAAG,oBAAoB,GAAG,cAAc,GAAG,qBAAqB,CAAC;IAC1F,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,YAAY,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,oEAAoE;AACpE,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IAC9B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,sBAAsB,EAAE,OAAO,CAAC;IAChC,eAAe,EAAE,SAAS,oBAAoB,EAAE,CAAC;CAClD;AAED,MAAM,MAAM,gBAAgB,GACxB;IACA,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,UAAU,EAAE,oBAAoB,CAAC;IACjC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IACpC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACxC,GACC;IACA,MAAM,EAAE,SAAS,CAAC;IAClB,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IACpC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACxC,CAAC"}

package/dist/landxml/result-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=result-types.js.map

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

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