@ifc-lite/create 2.8.0 → 2.9.2

package/dist/landxml/coordinate-plausibility.d.ts

@@ -0,0 +1,54 @@
+/**
+ * The northing/easting transposition check (§2.2, §9.1 of the mapping spec).
+ *
+ * LandXML `<P>`/`<CgPoint>` element text is *northing easting elevation*. A
+ * producer that writes it easting-first is a real, observed defect, and it is
+ * silent by construction: a transpose is a reflection, so the surface is still
+ * well-formed, still renders, and passes every count-based assertion. It is
+ * simply in the wrong place.
+ *
+ * This warns. It never refuses and never corrects:
+ *
+ * - A bounds test is a *plausibility* argument, not a proof. Refusing on it
+ *   would block legitimate data at the edge of a zone.
+ * - Auto-correcting would silently move a correct dataset, which is the same
+ *   class of failure it is meant to catch, in the opposite direction.
+ *
+ * It also never infers from magnitude alone. Without declared bounds there is
+ * no test — `checkCoordinateOrder` returns `null` and the caller says so.
+ */
+import type { LandXmlIfcWarning } from './result-types.js';
+/** Inclusive metre bounds for a projected CRS's two horizontal axes. */
+export interface CrsPlausibilityBounds {
+    easting: readonly [number, number];
+    northing: readonly [number, number];
+}
+/**
+ * Bounds shared by every Transverse-Mercator-family projected CRS (UTM zones,
+ * national TM grids such as SWEREF99 TM).
+ *
+ * The false easting is 500 000 m and a zone is ±500 km wide, so an easting
+ * lives in roughly 0…1 000 000 m; a northing runs the length of the hemisphere,
+ * to ~10 000 000 m. That asymmetry is the whole discriminating power of the
+ * test, and it is a property of the projection family rather than of any one
+ * EPSG code — which is why this needs no EPSG table and why §4.2's rule that
+ * the exporter must not start resolving EPSG codes is not violated.
+ *
+ * Callers opt in by passing this; nothing here sniffs a CRS name for 'UTM'.
+ */
+export declare const TRANSVERSE_MERCATOR_BOUNDS: CrsPlausibilityBounds;
+/**
+ * Test the coordinates as they are about to be written, in metres.
+ *
+ * Returns a warning only when the pair is implausible as written **and**
+ * swapping the two axes would make it plausible. Both halves matter: the first
+ * alone fires on any out-of-zone data, which is a different problem and not one
+ * this check can diagnose; the second is what makes the message's claim — that
+ * the source may be written easting-first — an inference the evidence supports.
+ *
+ * @param samples `(easting, northing)` metre pairs in the order they will be
+ *   written to `IfcCartesianPointList3D`, i.e. already converted from LandXML's
+ *   northing-first authored order.
+ */
+export declare function checkCoordinateOrder(samples: Iterable<readonly [number, number]>, bounds: CrsPlausibilityBounds, crsName: string): LandXmlIfcWarning | null;
+//# sourceMappingURL=coordinate-plausibility.d.ts.map

package/dist/landxml/coordinate-plausibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinate-plausibility.d.ts","sourceRoot":"","sources":["../../src/landxml/coordinate-plausibility.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,wEAAwE;AACxE,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,0BAA0B,EAAE,qBAGxC,CAAC;AAMF;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAC5C,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,MAAM,GACd,iBAAiB,GAAG,IAAI,CAoB1B"}

package/dist/landxml/coordinate-plausibility.js

@@ -0,0 +1,59 @@
+/* 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/. */
+/**
+ * Bounds shared by every Transverse-Mercator-family projected CRS (UTM zones,
+ * national TM grids such as SWEREF99 TM).
+ *
+ * The false easting is 500 000 m and a zone is ±500 km wide, so an easting
+ * lives in roughly 0…1 000 000 m; a northing runs the length of the hemisphere,
+ * to ~10 000 000 m. That asymmetry is the whole discriminating power of the
+ * test, and it is a property of the projection family rather than of any one
+ * EPSG code — which is why this needs no EPSG table and why §4.2's rule that
+ * the exporter must not start resolving EPSG codes is not violated.
+ *
+ * Callers opt in by passing this; nothing here sniffs a CRS name for 'UTM'.
+ */
+export const TRANSVERSE_MERCATOR_BOUNDS = {
+    easting: [0, 1_000_000],
+    northing: [0, 10_000_000],
+};
+function within(value, [low, high]) {
+    return value >= low && value <= high;
+}
+/**
+ * Test the coordinates as they are about to be written, in metres.
+ *
+ * Returns a warning only when the pair is implausible as written **and**
+ * swapping the two axes would make it plausible. Both halves matter: the first
+ * alone fires on any out-of-zone data, which is a different problem and not one
+ * this check can diagnose; the second is what makes the message's claim — that
+ * the source may be written easting-first — an inference the evidence supports.
+ *
+ * @param samples `(easting, northing)` metre pairs in the order they will be
+ *   written to `IfcCartesianPointList3D`, i.e. already converted from LandXML's
+ *   northing-first authored order.
+ */
+export function checkCoordinateOrder(samples, bounds, crsName) {
+    for (const [easting, northing] of samples) {
+        if (!Number.isFinite(easting) || !Number.isFinite(northing))
+            continue;
+        const plausibleAsWritten = within(easting, bounds.easting) && within(northing, bounds.northing);
+        if (plausibleAsWritten)
+            continue;
+        const plausibleSwapped = within(northing, bounds.easting) && within(easting, bounds.northing);
+        if (!plausibleSwapped)
+            continue;
+        return {
+            code: 'LXIFC-COORD-ORDER',
+            message: `Coordinate order looks transposed. Easting ${easting} is outside ${crsName}'s easting range `
+                + `[${bounds.easting[0]}, ${bounds.easting[1]}], but would be a valid northing — and northing `
+                + `${northing} would be a valid easting. LandXML point text is northing-first; a producer that `
+                + 'writes it easting-first yields a mirrored surface that still renders and still passes every '
+                + 'count check. Verify the source before relying on this export, or re-export it with the '
+                + 'coordinate-order override if you know the producer is at fault.',
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=coordinate-plausibility.js.map

package/dist/landxml/coordinate-plausibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinate-plausibility.js","sourceRoot":"","sources":["../../src/landxml/coordinate-plausibility.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AA8B/D;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAA0B;IAC/D,OAAO,EAAE,CAAC,CAAC,EAAE,SAAS,CAAC;IACvB,QAAQ,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC;CAC1B,CAAC;AAEF,SAAS,MAAM,CAAC,KAAa,EAAE,CAAC,GAAG,EAAE,IAAI,CAA4B;IACnE,OAAO,KAAK,IAAI,GAAG,IAAI,KAAK,IAAI,IAAI,CAAC;AACvC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAA4C,EAC5C,MAA6B,EAC7B,OAAe;IAEf,KAAK,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,OAAO,EAAE,CAAC;QAC1C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,SAAS;QACtE,MAAM,kBAAkB,GAAG,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QAChG,IAAI,kBAAkB;YAAE,SAAS;QACjC,MAAM,gBAAgB,GAAG,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC9F,IAAI,CAAC,gBAAgB;YAAE,SAAS;QAEhC,OAAO;YACL,IAAI,EAAE,mBAAmB;YACzB,OAAO,EACL,8CAA8C,OAAO,eAAe,OAAO,mBAAmB;kBAC5F,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,kDAAkD;kBAC7F,GAAG,QAAQ,mFAAmF;kBAC9F,8FAA8F;kBAC9F,yFAAyF;kBACzF,iEAAiE;SACtE,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/landxml/landxml-to-ifc.d.ts

@@ -0,0 +1,45 @@
+import { type CrsPlausibilityBounds } from './coordinate-plausibility.js';
+import type { LandXmlIfcSource } from './source-types.js';
+import type { LandXmlIfcResult } from './result-types.js';
+/** The mapping-document version this converter implements. */
+export declare const LANDXML_IFC_MAPPING_VERSION = "1.1";
+export interface LandXmlIfcOptions {
+    /** Recorded as provenance (§7); never used to decide anything. */
+    sourceFileName?: string;
+    sourceHash?: string;
+    /**
+     * Written as `IfcProjectedCRS` + `IfcMapConversion` (§4.2). Omit where the
+     * source declares no CRS: §4.2 forbids a placeholder, because a wrong CRS is
+     * worse than none.
+     */
+    crs?: {
+        Name: string;
+        Description?: string;
+        GeodeticDatum?: string;
+        VerticalDatum?: string;
+        MapProjection?: string;
+        MapZone?: string;
+        /** Enables the transposition check (§9.1). Without it there is no test. */
+        Bounds?: CrsPlausibilityBounds;
+    };
+    /**
+     * Operator-confirmed northing/easting swap for a known-faulty producer
+     * (§2.2 item 2). Recorded as provenance, exactly like the units override.
+     */
+    swapNorthingEasting?: boolean;
+    /** Fixed epoch-ms, for byte-deterministic output. */
+    timestampMs?: number;
+    Author?: string;
+    Organization?: string;
+}
+/** Deterministic GlobalId from a LandXML source id (§4.3, §10). */
+export declare function landXmlGlobalId(sourceId: string): string;
+/**
+ * Convert a parsed LandXML document to an IFC4X3 STEP file.
+ *
+ * Returns `{ status: 'refused' }` — with the refusal list intact — when the
+ * source carries nothing the mapping covers. That is not an error case to be
+ * caught; it is the honest answer for the alignment-only files §9.4 discusses.
+ */
+export declare function landXmlToIfc(source: LandXmlIfcSource, options?: LandXmlIfcOptions): LandXmlIfcResult;
+//# sourceMappingURL=landxml-to-ifc.d.ts.map

package/dist/landxml/landxml-to-ifc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"landxml-to-ifc.d.ts","sourceRoot":"","sources":["../../src/landxml/landxml-to-ifc.ts"],"names":[],"mappings":"AA6BA,OAAO,EAAwB,KAAK,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAIhG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EACgC,gBAAgB,EAC3D,MAAM,mBAAmB,CAAC;AAE3B,8DAA8D;AAC9D,eAAO,MAAM,2BAA2B,QAAQ,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IAChC,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,GAAG,CAAC,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,2EAA2E;QAC3E,MAAM,CAAC,EAAE,qBAAqB,CAAC;KAChC,CAAC;IACF;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,GAAE,iBAAsB,GAAG,gBAAgB,CA+HxG"}

package/dist/landxml/landxml-to-ifc.js

@@ -0,0 +1,197 @@
+/* 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 → IFC4X3, v1.
+ *
+ * Implements `docs/architecture/landxml-to-ifc-mapping.md` v1.0. That document
+ * is the contract; anything not written there is not in v1, and a change to the
+ * mapping is a change to that document first.
+ *
+ * Three properties this file exists to guarantee, each of which fails silently
+ * if it is got wrong:
+ *
+ * 1. **Axis order.** LandXML authors `<P>` text as *northing easting
+ *    elevation*. IFC `CoordList` entries are `(X, Y, Z)` = *easting northing
+ *    elevation*. The swap happens here, once, at {@link toIfcVertex}.
+ * 2. **Units.** Output is always metres, with `linearScaleToMeters` applied to
+ *    the plan axes and `elevationScaleToMeters` to the elevation — LandXML may
+ *    declare a different unit for each, and applying one scale to all three is
+ *    a mistake that looks fine on the common metric file.
+ * 3. **Nothing is dropped in silence.** Every out-of-scope record family is
+ *    counted and named, and a source with no mappable record refuses outright
+ *    rather than producing a valid, empty, useless IFC.
+ */
+import { uuidFromSeed, uuidToIfcGuid } from '@ifc-lite/encoding';
+import { IfcCreator } from '../ifc-creator.js';
+import { checkCoordinateOrder } from './coordinate-plausibility.js';
+import { collectRefusals, isMappableSurface, refusalReason } from './refusals.js';
+import { cogoPointResolver, mapAlignments } from './alignment-mapping.js';
+import { writeAlignments, writeSurfaces, writeSurveyPoints } from './writers.js';
+/** The mapping-document version this converter implements. */
+export const LANDXML_IFC_MAPPING_VERSION = '1.1';
+/** Deterministic GlobalId from a LandXML source id (§4.3, §10). */
+export function landXmlGlobalId(sourceId) {
+    return uuidToIfcGuid(uuidFromSeed(sourceId));
+}
+/**
+ * Convert a parsed LandXML document to an IFC4X3 STEP file.
+ *
+ * Returns `{ status: 'refused' }` — with the refusal list intact — when the
+ * source carries nothing the mapping covers. That is not an error case to be
+ * caught; it is the honest answer for the alignment-only files §9.4 discusses.
+ */
+export function landXmlToIfc(source, options = {}) {
+    const swap = options.swapNorthingEasting === true;
+    // Mapped once, and the same mapping decides both what is written and what
+    // the refusal list says was not — two passes could disagree.
+    const alignmentMapping = mapAlignments(source.alignments, source.units, swap, cogoPointResolver(source.plan?.cogoPoints));
+    const refusals = collectRefusals(source, alignmentMapping);
+    const warnings = [];
+    const mappableSurfaces = source.surfaces.filter(isMappableSurface);
+    const cogoPoints = (source.plan?.cogoPoints ?? []).filter((point) => point.point !== null);
+    const units = source.units;
+    if (units === null) {
+        // Distinct from an empty source: the file may hold a perfectly good TIN, and
+        // the operator needs to know the fix is units, not content.
+        return {
+            status: 'refused',
+            reason: 'This LandXML file declares no LandXML/Units element, so no coordinate can be scaled to '
+                + 'metres. Load it with an explicit assumed linear unit, or export the original LandXML file instead.',
+            refusals,
+            warnings,
+        };
+    }
+    if (mappableSurfaces.length === 0 && cogoPoints.length === 0 && alignmentMapping.mapped.length === 0) {
+        return { status: 'refused', reason: refusalReason(refusals), refusals, warnings };
+    }
+    if (units.assumed) {
+        warnings.push({
+            code: 'LXIFC-ASSUMED-UNIT',
+            message: `Every coordinate in this export is scaled by an ASSUMED linear unit ('${units.linearUnit}'). `
+                + 'The source declares no LandXML/Units element, so the scale was chosen by an operator, not read '
+                + 'from the file. The geometry is at that operator-chosen scale and nothing in the IFC records '
+                + 'otherwise except this file\'s provenance property set.',
+        });
+    }
+    if (!options.crs) {
+        warnings.push({
+            code: 'LXIFC-NO-CRS',
+            message: 'No coordinate reference system is declared, so no IfcProjectedCRS or IfcMapConversion is written '
+                + 'and the coordinate-order plausibility check cannot run. The coordinates are written as authored.',
+        });
+    }
+    if (options.swapNorthingEasting) {
+        warnings.push({
+            code: 'LXIFC-COORD-SWAPPED',
+            message: 'A coordinate-order override is in force: the source\'s point text is being read as '
+                + 'easting-first rather than LandXML\'s northing-first order. This is an operator assertion about '
+                + 'the producer, not something read from the file.',
+        });
+    }
+    const creator = new IfcCreator({
+        // Declared as `IFC4X3_ADD2` by `IfcCreator` itself, like all IFC4X3
+        // output (`fileSchemaIdentifier`, #5351).
+        Schema: 'IFC4X3',
+        Name: options.sourceFileName ?? 'LandXML conversion',
+        Description: `Derived from LandXML ${source.schema} by the ifc-lite LandXML→IFC mapping v${LANDXML_IFC_MAPPING_VERSION}`,
+        LengthUnit: 'METRE',
+        ...(options.timestampMs === undefined ? {} : { Timestamp: options.timestampMs }),
+        ...(options.Author === undefined ? {} : { Author: options.Author }),
+        ...(options.Organization === undefined ? {} : { Organization: options.Organization }),
+        // Content hash first: two different files exported without a name must not
+        // share project/site/relationship GlobalIds, or federating them collides.
+        GuidSource: deterministicGuidSource(options.sourceHash ?? options.sourceFileName ?? source.schema),
+    });
+    const terrain = creator.terrain();
+    if (options.crs) {
+        terrain.setGeoreferencing({
+            Name: options.crs.Name,
+            Description: options.crs.Description,
+            GeodeticDatum: options.crs.GeodeticDatum ?? source.coordinateSystem?.horizontalDatum,
+            VerticalDatum: options.crs.VerticalDatum ?? source.coordinateSystem?.verticalDatum,
+            MapProjection: options.crs.MapProjection,
+            MapZone: options.crs.MapZone,
+        });
+    }
+    const surfaceResult = writeSurfaces(terrain, source.surfaces, units, swap, landXmlGlobalId);
+    const pointResult = writeSurveyPoints(terrain, cogoPoints, units, swap, landXmlGlobalId);
+    const alignmentSamples = writeAlignments(terrain, alignmentMapping.mapped, landXmlGlobalId);
+    if (options.crs?.Bounds) {
+        const warning = checkCoordinateOrder([...surfaceResult.samples, ...pointResult.samples, ...alignmentSamples], options.crs.Bounds, options.crs.Name);
+        if (warning)
+            warnings.push(warning);
+    }
+    const coverage = {
+        surfaces: surfaceResult.surfaces,
+        surveyPoints: pointResult.count,
+        vertices: surfaceResult.vertices,
+        triangles: surfaceResult.triangles,
+        alignments: alignmentMapping.mapped.length,
+    };
+    if (coverage.surfaces === 0 && coverage.surveyPoints === 0 && (coverage.alignments ?? 0) === 0) {
+        return { status: 'refused', reason: refusalReason(refusals), refusals, warnings };
+    }
+    const provenance = {
+        sourceFileName: options.sourceFileName ?? null,
+        sourceHash: options.sourceHash ?? null,
+        mappingVersion: LANDXML_IFC_MAPPING_VERSION,
+        landXmlSchema: source.schema,
+        units,
+        assumedLinearUnit: units.assumed ? units.linearUnit : null,
+        coordinateOrderSwapped: swap,
+        refusedFamilies: refusals.map((refusal) => refusal.family),
+    };
+    writeProvenance(terrain, provenance, coverage);
+    return {
+        status: 'exported',
+        content: creator.toIfc().content,
+        coverage,
+        provenance,
+        refusals,
+        warnings,
+    };
+}
+/**
+ * GlobalIds for the entities that have no LandXML source id of their own — the
+ * project, site, building, contexts and every relationship row.
+ *
+ * Seeded from the source name and a counter so two exports of one source are
+ * byte-identical (§8.4). A random source would make every export differ, which
+ * would make `ifc-lite diff` between two conversions meaningless.
+ */
+function deterministicGuidSource(seed) {
+    let ordinal = 0;
+    return () => {
+        ordinal += 1;
+        return landXmlGlobalId(`landxml-ifc:${seed}:${ordinal}`);
+    };
+}
+/**
+ * §7 — what the file says about where it came from, as a property set on the
+ * site. It records the assumption, not just the result: an export made under an
+ * assumed unit or a coordinate-order override is indistinguishable from a
+ * declared one by its geometry alone.
+ */
+function writeProvenance(terrain, provenance, coverage) {
+    const properties = [
+        { Name: 'DerivedConversion', Value: 'true' },
+        { Name: 'MappingVersion', Value: provenance.mappingVersion },
+        { Name: 'LandXmlSchema', Value: provenance.landXmlSchema },
+        { Name: 'SourceFileName', Value: provenance.sourceFileName ?? '' },
+        { Name: 'SourceHash', Value: provenance.sourceHash ?? '' },
+        { Name: 'LinearUnit', Value: provenance.units?.linearUnit ?? '' },
+        { Name: 'ElevationUnit', Value: provenance.units?.elevationUnit ?? '' },
+        { Name: 'AssumedLinearUnit', Value: provenance.assumedLinearUnit ?? '' },
+        { Name: 'CoordinateOrderSwapped', Value: String(provenance.coordinateOrderSwapped) },
+        { Name: 'RefusedRecordFamilies', Value: provenance.refusedFamilies.join(', ') },
+        { Name: 'ExportedSurfaces', Value: String(coverage.surfaces) },
+        { Name: 'ExportedSurveyPoints', Value: String(coverage.surveyPoints) },
+        { Name: 'ExportedAlignments', Value: String(coverage.alignments ?? 0) },
+    ];
+    terrain.addPropertySet(terrain.siteId, {
+        Name: 'LandXML_Conversion',
+        Properties: properties,
+    });
+}
+//# sourceMappingURL=landxml-to-ifc.js.map

package/dist/landxml/landxml-to-ifc.js.map

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

package/dist/landxml/refusals.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 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';
+/**
+ * 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): 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;
+/**
+ * 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,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAwB,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EACgD,KAAK,gBAAgB,EAAE,KAAK,gBAAgB,EAClG,MAAM,wBAAwB,CAAC;AAmChC;;;;;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,GACxF,cAAc,EAAE,CAoClB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,GAAG,MAAM,CAOpF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,CAOzE"}

package/dist/landxml/refusals.js

@@ -0,0 +1,118 @@
+/* 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';
+/**
+ * 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: 'vertical profiles and their grade lines and vertical curves have no v1 mapping — they describe geometry along an alignment, which v1 does not carry',
+    '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': 'station equations are not written; the alignment carries 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)) {
+    // 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],
+        ['station-equations', writtenAlignments.reduce((n, a) => n + (a.stationEquations?.length ?? 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', source.profiles?.length ?? 0],
+        ['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)
+            : `${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}.`;
+}
+/**
+ * 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,73 @@
+/**
+ * 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;
+}
+/** 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;CACrB;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"}