@ifc-lite/export 3.0.0 → 3.1.0

package/dist/step-map-unit.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Map-unit resolution for the georeferencing phase: the `IfcNamedUnit` an
+ * `IfcProjectedCRS.MapUnit` points at, and the reuse-or-synthesise decision
+ * behind it.
+ *
+ * Split out of `step-georeferencing.ts` in #3274 rather than grown in place —
+ * the question it answers is a different one from "which georeferencing
+ * entities does this export write", it has a second caller in
+ * `step-property-sets.ts` (property units reach `findLengthUnitReference`
+ * through `findUnitId`), and the module-size budget is not a thing to raise.
+ *
+ * THE RULE THIS MODULE EXISTS TO KEEP: a unit name is compared WHOLE. The
+ * defect it was extracted for was a substring test — `normalized.includes('METRE')`
+ * — which `MILLIMETRE`, `CENTIMETRE` and `KILOMETRE` all satisfy, so every one
+ * of them was written into the file as a plain `.METRE.`. The map unit is the
+ * scale of the entire coordinate reference system, so that is a silent 1000x
+ * error in the one attribute another team uses to place the model on the
+ * earth, and it is invisible in the output: a millimetre request produced
+ * bytes identical to a metre request.
+ *
+ * And a unit this module cannot express is REFUSED, not approximated.
+ * `IfcProjectedCRS.MapUnit` is `OPTIONAL IfcNamedUnit` with
+ * `IsLengthUnit : NOT(EXISTS(MapUnit)) OR (MapUnit.UnitType = LENGTHUNIT)`, so
+ * an absent MapUnit is schema-valid; a MapUnit naming the wrong unit is not
+ * merely lossy, it is false, and nothing downstream can tell it from a true
+ * one.
+ */
+import type { EffectiveEntityIndex } from './effective-index.js';
+import type { GeorefContext, GeorefLookupContext } from './step-georeferencing.js';
+/**
+ * Message for the refusal when a requested map unit is one this exporter
+ * cannot express as an `IfcNamedUnit`. `MapUnit` is optional, so it is left
+ * absent rather than filled with a unit that is not the one asked for (#3274).
+ */
+export declare function mapUnitUnsupportedWarning(unitName: string): string;
+/** Record a map unit the exporter refused to guess at. */
+export declare function reportMapUnitUnsupported(warnings: string[], unitName: string): void;
+export declare function resolveMapUnitReference(unitName: string, newGeorefLines: string[], effective: EffectiveEntityIndex, ctx: GeorefContext): number | null;
+/**
+ * Canonicalize a map-unit label to the spelling the rest of this module
+ * compares against: American `METER` to `METRE`, the foot spellings to `FOOT`,
+ * the US survey foot to `US SURVEY FOOT`, and an SI prefix kept rather than
+ * swallowed. Anything not recognised is returned normalised-but-unchanged, for
+ * the caller to REFUSE rather than guess at.
+ *
+ * The label is NORMALISED and then matched EXACTLY — never substring-matched.
+ *
+ * What the normalisation accepts:
+ * - any case and any separators: `metres`, `Meters`, `MILLI-METRE`;
+ * - `METRE` and `METER`, each carrying any `IfcSIPrefix` member;
+ * - `FOOT` and `FEET`;
+ * - one English plural suffix, stripped once and re-matched exactly;
+ * - the US survey foot, glued or separated in any word order.
+ *
+ * What it REFUSES, by leaving the label alone so `resolveMapUnitReference`
+ * returns `null` and `MapUnit` stays `$` with a warning:
+ * - a label that merely CONTAINS a unit. `MILLIMETRE`, `CENTIMETRE` and
+ *   `KILOMETRE` all contain `METRE`, and an `includes('METRE')` test wrote all
+ *   three into the file as a plain `.METRE.` — a silent 1000x error in the CRS
+ *   scale (#3274). The foot half of that same test was `includes('FOOT')`, and
+ *   it was satisfied by `FOOTCANDLE` (an illuminance), `FOOT-POUND` (an
+ *   energy), `FOOTPRINT`, and by `SQUARE FOOT` and `CUBIC FEET` — an area and
+ *   a volume written as a LENGTH unit, which is a wrong DIMENSION rather than
+ *   a wrong magnitude, and no scale factor can be right for it;
+ * - a survey foot with no nationality: `SURVEY FOOT`, `CLARKE'S FOOT`,
+ *   `INDIAN FOOT`, `SEARS FOOT`, `BRITISH FOOT (1936)` are five different
+ *   ratios, and `includes('FOOT')` gave every one of them the international
+ *   0.3048;
+ * - `INCH`, `YARD`, `MILE` and anything else this exporter cannot express.
+ *
+ * Normalising a recognisable spelling onto a table entry is NOT that
+ * approximation: the answer is still one exact table hit, so `MILLIMETERS`
+ * resolves to `MILLIMETRE` and not to `METRE`.
+ *
+ * Sibling of `inferMapUnitScaleFromLabel` in
+ * packages/parser/src/map-unit-label.ts and `infer_map_unit_scale` in
+ * rust/core/src/unit_labels.rs, which apply these same rules on the reading
+ * side. This exporter's accepted set is the smaller one — it writes only what
+ * it can express as an `IfcNamedUnit` — but no spelling may be accepted here
+ * that those refuse, or refused here that those accept as a length.
+ */
+export declare function normalizeMapUnitName(unitName: string): string;
+/**
+ * `effective` filters the candidates the same way the georef reads above do:
+ * returning a tombstoned unit id hands the caller a `#id` for a line the
+ * export never writes. Returning null instead makes `resolveMapUnitReference`
+ * synthesise a fresh unit, which is the outcome a deleted unit deserves.
+ */
+export declare function findLengthUnitReference(preferredUnitName: string, effective: EffectiveEntityIndex, ctx: GeorefLookupContext): number | null;
+//# sourceMappingURL=step-map-unit.d.ts.map

package/dist/step-map-unit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-map-unit.d.ts","sourceRoot":"","sources":["../src/step-map-unit.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEnF;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,0DAA0D;AAC1D,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAInF;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,oBAAoB,EAAE,GAAG,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAwCtJ;AA8FD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAkB7D;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,iBAAiB,EAAE,MAAM,EAAE,SAAS,EAAE,oBAAoB,EAAE,GAAG,EAAE,mBAAmB,GAAG,MAAM,GAAG,IAAI,CAwD3I"}

package/dist/step-map-unit.js

@@ -0,0 +1,277 @@
+/* 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 { toStepReal } from './step-serialization.js';
+/**
+ * Message for the refusal when a requested map unit is one this exporter
+ * cannot express as an `IfcNamedUnit`. `MapUnit` is optional, so it is left
+ * absent rather than filled with a unit that is not the one asked for (#3274).
+ */
+export function mapUnitUnsupportedWarning(unitName) {
+    return `Cannot express map unit ${JSON.stringify(unitName)} as an IfcNamedUnit: only metres (with any SI prefix), FOOT and US SURVEY FOOT are supported. IfcProjectedCRS.MapUnit was left unset rather than declared as metres.`;
+}
+/** Record a map unit the exporter refused to guess at. */
+export function reportMapUnitUnsupported(warnings, unitName) {
+    const message = mapUnitUnsupportedWarning(unitName);
+    warnings.push(message);
+    console.warn(`[StepExporter] ${message}`);
+}
+export function resolveMapUnitReference(unitName, newGeorefLines, effective, ctx) {
+    const normalized = normalizeMapUnitName(unitName);
+    const existing = findLengthUnitReference(normalized, effective, ctx);
+    if (existing !== null) {
+        return existing;
+    }
+    // A metre, with or without an SI prefix. `MILLIMETRE` KEEPS its prefix: the
+    // map unit is the scale of the entire coordinate reference system, so
+    // writing `.METRE.` for a millimetre map is a silent 1000x error in the one
+    // attribute another team relies on to place the model (#3274).
+    const prefix = siPrefixOf(normalized);
+    if (prefix !== undefined) {
+        const unitId = ctx.allocateExpressId();
+        const prefixToken = prefix === null ? '$' : `.${prefix}.`;
+        newGeorefLines.push(`#${unitId}=IFCSIUNIT(*,.LENGTHUNIT.,${prefixToken},.METRE.);`);
+        return unitId;
+    }
+    if (normalized === 'FOOT' || normalized === 'US SURVEY FOOT') {
+        const dimId = ctx.allocateExpressId();
+        const siUnitId = ctx.allocateExpressId();
+        const measureId = ctx.allocateExpressId();
+        const convUnitId = ctx.allocateExpressId();
+        const factor = normalized === 'US SURVEY FOOT' ? 1200 / 3937 : 0.3048;
+        const name = normalized === 'US SURVEY FOOT' ? 'US SURVEY FOOT' : 'FOOT';
+        newGeorefLines.push(`#${dimId}=IFCDIMENSIONALEXPONENTS(1,0,0,0,0,0,0);`);
+        newGeorefLines.push(`#${siUnitId}=IFCSIUNIT(*,.LENGTHUNIT.,$,.METRE.);`);
+        newGeorefLines.push(`#${measureId}=IFCMEASUREWITHUNIT(IFCLENGTHMEASURE(${toStepReal(factor)}),#${siUnitId});`);
+        newGeorefLines.push(`#${convUnitId}=IFCCONVERSIONBASEDUNIT(#${dimId},.LENGTHUNIT.,'${name}',#${measureId});`);
+        return convUnitId;
+    }
+    // A unit this exporter cannot express. It must NOT claim to be metres: that
+    // is the coordinate reference system's scale, and a wrong one is worse than
+    // an absent one. `IfcProjectedCRS.MapUnit` is `OPTIONAL IfcNamedUnit`, and
+    // the WHERE rule is `NOT(EXISTS(MapUnit)) OR MapUnit.UnitType = LENGTHUNIT`,
+    // so omitting it is schema-valid. Refuse, and let the caller say so in
+    // `stats.warnings` the way the two map-conversion refusals do (#3274).
+    return null;
+}
+/** Every `IfcSIPrefix` member, longest first so `MILLI` cannot shadow `MILLIMICRO`-style
+ *  compounds and `DECA` cannot shadow `DECI`. */
+const SI_PREFIXES = [
+    'FEMTO', 'MICRO', 'HECTO', 'CENTI', 'MILLI',
+    'EXA', 'PETA', 'TERA', 'GIGA', 'MEGA', 'KILO', 'DECA', 'DECI', 'NANO', 'PICO', 'ATTO',
+];
+/**
+ * The `IfcSIPrefix` token for a normalized metre name — `null` for a bare
+ * `METRE`, the prefix for a prefixed one, and `undefined` when the name is not
+ * a metre at all.
+ *
+ * Three-valued deliberately: `null` and `undefined` are the two answers a bare
+ * boolean would merge, and merging them is the defect — `MILLIMETRE` reaching
+ * the "plain metre" arm is exactly what {@link normalizeMapUnitName}'s old
+ * `includes('METRE')` test did.
+ */
+function siPrefixOf(normalized) {
+    if (normalized === 'METRE')
+        return null;
+    for (const prefix of SI_PREFIXES) {
+        if (normalized === `${prefix}METRE`)
+            return prefix;
+    }
+    return undefined;
+}
+/** Split a map-unit label into upper-cased alphanumeric tokens. */
+function tokenizeUnitLabel(label) {
+    return label.toUpperCase().split(/[^A-Z0-9]+/).filter((token) => token.length > 0);
+}
+/** The foot/feet spellings a US-survey qualifier may be attached to. */
+const FOOT_TOKENS = new Set(['FOOT', 'FEET', 'FT']);
+/**
+ * Order-insensitive recogniser for the separated US-survey foot spellings —
+ * `foot (US survey)`, `SURVEY FEET (US)`, `US survey foot`. The glued
+ * spellings (`USSURVEYFOOT`, `FTUS`, …) are in {@link MAP_UNIT_CANONICAL_NAME}
+ * and matched exactly there; once an exporter puts separators in, the word
+ * order varies and gluing alone cannot see it.
+ *
+ * Accepts exactly one foot token plus either `US` (or the glued `USSURVEY`)
+ * or both `US` and `SURVEY`. A bare `SURVEY FOOT` without `US` is REFUSED:
+ * other national survey feet exist and are different ratios — Clarke's foot is
+ * 0.3047972654 m, the Indian foot 0.304799514 m — so the qualifier alone does
+ * not identify a value. `US FOOT` on its own IS accepted: EPSG 9003 is the
+ * only US foot, so the nationality does identify it.
+ *
+ * The requirement that exactly ONE foot token be present, with nothing else
+ * beside the qualifier, is what refuses `SQUARE US SURVEY FOOT` (an area) and
+ * `NON-US SURVEY FOOT` (a label that says it is not this unit).
+ *
+ * Sibling of `isUsSurveyFootTokens` in packages/parser/src/map-unit-label.ts
+ * and `is_us_survey_foot_tokens` in rust/core/src/unit_labels.rs — those two
+ * answer a metre scale for the georeferencing READER, this one answers the
+ * canonical name the STEP writer emits, but the accepted spellings are the
+ * same set and must stay the same set.
+ */
+function isUsSurveyFootTokens(tokens) {
+    const feet = tokens.filter((token) => FOOT_TOKENS.has(token));
+    if (feet.length !== 1)
+        return false;
+    const rest = tokens.filter((token) => !FOOT_TOKENS.has(token));
+    if (rest.length === 1)
+        return rest[0] === 'US' || rest[0] === 'USSURVEY';
+    return rest.length === 2 && rest.includes('US') && rest.includes('SURVEY');
+}
+/**
+ * Exact-match table from a folded label to the canonical unit name the rest of
+ * this module compares against. DERIVED rather than hand-written: the two base
+ * spellings crossed with {@link SI_PREFIXES} — the same list {@link siPrefixOf}
+ * reads, so the two cannot drift — plus the foot spellings this exporter can
+ * write as an `IfcConversionBasedUnit`.
+ *
+ * A `Map` rather than an object literal so a label like `CONSTRUCTOR` cannot
+ * resolve through `Object.prototype`.
+ */
+const MAP_UNIT_CANONICAL_NAME = (() => {
+    const table = new Map();
+    for (const spelling of ['METRE', 'METER']) {
+        table.set(spelling, 'METRE');
+        for (const prefix of SI_PREFIXES)
+            table.set(`${prefix}${spelling}`, `${prefix}METRE`);
+    }
+    for (const foot of ['FOOT', 'FEET'])
+        table.set(foot, 'FOOT');
+    // The US survey foot is a different ratio from the international foot
+    // (1200/3937 vs 0.3048) and is spelled several ways in the wild. These are
+    // the accepted glued spellings, matched exactly rather than sniffed for; the
+    // separated ones go through {@link isUsSurveyFootTokens}.
+    for (const alias of ['USSURVEYFOOT', 'USSURVEYFEET', 'USSURVEYFT', 'USFOOT', 'USFEET', 'USFT', 'FTUS']) {
+        table.set(alias, 'US SURVEY FOOT');
+    }
+    return table;
+})();
+/**
+ * Canonicalize a map-unit label to the spelling the rest of this module
+ * compares against: American `METER` to `METRE`, the foot spellings to `FOOT`,
+ * the US survey foot to `US SURVEY FOOT`, and an SI prefix kept rather than
+ * swallowed. Anything not recognised is returned normalised-but-unchanged, for
+ * the caller to REFUSE rather than guess at.
+ *
+ * The label is NORMALISED and then matched EXACTLY — never substring-matched.
+ *
+ * What the normalisation accepts:
+ * - any case and any separators: `metres`, `Meters`, `MILLI-METRE`;
+ * - `METRE` and `METER`, each carrying any `IfcSIPrefix` member;
+ * - `FOOT` and `FEET`;
+ * - one English plural suffix, stripped once and re-matched exactly;
+ * - the US survey foot, glued or separated in any word order.
+ *
+ * What it REFUSES, by leaving the label alone so `resolveMapUnitReference`
+ * returns `null` and `MapUnit` stays `$` with a warning:
+ * - a label that merely CONTAINS a unit. `MILLIMETRE`, `CENTIMETRE` and
+ *   `KILOMETRE` all contain `METRE`, and an `includes('METRE')` test wrote all
+ *   three into the file as a plain `.METRE.` — a silent 1000x error in the CRS
+ *   scale (#3274). The foot half of that same test was `includes('FOOT')`, and
+ *   it was satisfied by `FOOTCANDLE` (an illuminance), `FOOT-POUND` (an
+ *   energy), `FOOTPRINT`, and by `SQUARE FOOT` and `CUBIC FEET` — an area and
+ *   a volume written as a LENGTH unit, which is a wrong DIMENSION rather than
+ *   a wrong magnitude, and no scale factor can be right for it;
+ * - a survey foot with no nationality: `SURVEY FOOT`, `CLARKE'S FOOT`,
+ *   `INDIAN FOOT`, `SEARS FOOT`, `BRITISH FOOT (1936)` are five different
+ *   ratios, and `includes('FOOT')` gave every one of them the international
+ *   0.3048;
+ * - `INCH`, `YARD`, `MILE` and anything else this exporter cannot express.
+ *
+ * Normalising a recognisable spelling onto a table entry is NOT that
+ * approximation: the answer is still one exact table hit, so `MILLIMETERS`
+ * resolves to `MILLIMETRE` and not to `METRE`.
+ *
+ * Sibling of `inferMapUnitScaleFromLabel` in
+ * packages/parser/src/map-unit-label.ts and `infer_map_unit_scale` in
+ * rust/core/src/unit_labels.rs, which apply these same rules on the reading
+ * side. This exporter's accepted set is the smaller one — it writes only what
+ * it can express as an `IfcNamedUnit` — but no spelling may be accepted here
+ * that those refuse, or refused here that those accept as a length.
+ */
+export function normalizeMapUnitName(unitName) {
+    const normalized = unitName.trim().toUpperCase().replace(/\s+/g, ' ');
+    const tokens = tokenizeUnitLabel(normalized);
+    if (tokens.length === 0)
+        return normalized;
+    if (isUsSurveyFootTokens(tokens))
+        return 'US SURVEY FOOT';
+    const key = tokens.join('');
+    const exact = MAP_UNIT_CANONICAL_NAME.get(key);
+    if (exact !== undefined)
+        return exact;
+    // One English plural suffix, removed once and re-matched exactly. `ES`
+    // covers spellings whose singular is not reachable by dropping a single `S`.
+    for (const suffix of ['S', 'ES']) {
+        if (!key.endsWith(suffix))
+            continue;
+        const singular = MAP_UNIT_CANONICAL_NAME.get(key.slice(0, -suffix.length));
+        if (singular !== undefined)
+            return singular;
+    }
+    return normalized;
+}
+/**
+ * `effective` filters the candidates the same way the georef reads above do:
+ * returning a tombstoned unit id hands the caller a `#id` for a line the
+ * export never writes. Returning null instead makes `resolveMapUnitReference`
+ * synthesise a fresh unit, which is the outcome a deleted unit deserves.
+ */
+export function findLengthUnitReference(preferredUnitName, effective, ctx) {
+    if (!ctx.entityExtractor)
+        return null;
+    // An empty label is not a unit name, and it is reachable: the caller guards
+    // `crs.mapUnit !== undefined`, not `!== ''`, and `normalizeMapUnitName('')`
+    // is `''`. Both comparisons below fold a non-string Name attribute to `''`
+    // too, so without this an empty MapUnit binds to whichever unit happens to
+    // have a malformed name rather than to nothing.
+    if (preferredUnitName === '')
+        return null;
+    // Only source records carry the bytes `extractEntity` reads, so an
+    // overlay-created project is skipped rather than shadowing the file's own.
+    const projectId = (effective.byType.get('IFCPROJECT') ?? []).find((id) => ctx.dataStore.entityIndex.byId.has(id));
+    const projectRef = projectId !== undefined ? ctx.dataStore.entityIndex.byId.get(projectId) : undefined;
+    const project = projectRef ? ctx.entityExtractor.extractEntity(projectRef) : null;
+    const unitAssignmentId = project?.attributes?.[8];
+    if (typeof unitAssignmentId !== 'number' || effective.isDeleted(unitAssignmentId))
+        return null;
+    const unitAssignmentRef = ctx.dataStore.entityIndex.byId.get(unitAssignmentId);
+    const unitAssignment = unitAssignmentRef ? ctx.entityExtractor.extractEntity(unitAssignmentRef) : null;
+    const units = unitAssignment?.attributes?.[0];
+    if (!Array.isArray(units))
+        return null;
+    for (const unitId of units) {
+        if (typeof unitId !== 'number' || effective.isDeleted(unitId))
+            continue;
+        const unitRef = ctx.dataStore.entityIndex.byId.get(unitId);
+        const unit = unitRef ? ctx.entityExtractor.extractEntity(unitRef) : null;
+        if (!unit)
+            continue;
+        const typeName = unit.type.toUpperCase();
+        const attrs = unit.attributes ?? [];
+        const unitType = typeof attrs[1] === 'string' ? attrs[1].replace(/\./g, '').toUpperCase() : '';
+        if (unitType !== 'LENGTHUNIT')
+            continue;
+        if (typeName === 'IFCSIUNIT') {
+            const prefix = typeof attrs[2] === 'string' ? attrs[2].replace(/\./g, '').toUpperCase() : '';
+            const name = typeof attrs[3] === 'string' ? attrs[3].replace(/\./g, '').toUpperCase() : '';
+            // The prefix is part of the unit, so it is part of the comparison. The
+            // old test asked only whether the preferred name was `METRE` and the
+            // file's unit was a metre of any prefix, which both missed a reusable
+            // `.MILLI.` unit and would have matched one for a plain-metre request
+            // had `combined` been read (#3274).
+            const combined = prefix ? `${prefix}${name}` : name;
+            if (normalizeMapUnitName(combined) === preferredUnitName) {
+                return unitId;
+            }
+        }
+        if (typeName === 'IFCCONVERSIONBASEDUNIT') {
+            const name = typeof attrs[2] === 'string' ? normalizeMapUnitName(attrs[2]) : '';
+            if (name === preferredUnitName) {
+                return unitId;
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=step-map-unit.js.map

package/dist/step-map-unit.js.map

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

package/dist/step-overlay-attribute-overrides.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Apply overlay attribute + positional overrides to an OVERLAY-CREATED
+ * entity's argument list (#2006) — the sibling of `step-attribute-
+ * mutations.ts`'s source-buffer pipeline that shares its two serialize
+ * helpers (`step-attribute-serializers.ts`). Split out of
+ * `step-attribute-mutations.ts` (#3184).
+ */
+import type { IfcAttributeValue } from '@ifc-lite/parser';
+import type { IfcSchemaVersion } from './schema-converter.js';
+/**
+ * Apply overlay attribute + positional overrides to an OVERLAY-CREATED
+ * entity's argument list (#2006).
+ *
+ * Distinct from {@link applyAttributeMutations} / {@link applyPositionalMutations},
+ * which rewrite a line read out of the source buffer. Here the whole line is
+ * ours: it was serialized moments ago from the creation payload, so the
+ * argument list is the authoring payload's, not the file's. That difference
+ * is why this PADS — `entity_create` takes whatever positional list the
+ * caller passes, so a wall authored with three arguments still has a real
+ * `Tag` slot at index 7, and dropping the edit because the payload was short
+ * would be the very data loss this fixes. The source-buffer path must not
+ * pad: there a short line means a different schema, and growing a record we
+ * did not author would corrupt it.
+ *
+ * Named and positional overrides resolve to a slot index up front and share
+ * ONE padding rule. Two padding rules on one record is how the next bug
+ * starts, and the argument for padding — the class is fixed at creation time,
+ * so a short payload is partial authoring — never depended on which of the
+ * two APIs queued the edit.
+ */
+export declare function applyOverlayEntityOverrides(argsText: string, entityType: string, attributeOverrides: Map<string, string> | null, positionalOverrides: Map<number, IfcAttributeValue> | null, schemaVersion: IfcSchemaVersion, onRejected?: (attrName: string, value: string) => void): string;
+//# sourceMappingURL=step-overlay-attribute-overrides.d.ts.map

package/dist/step-overlay-attribute-overrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-overlay-attribute-overrides.d.ts","sourceRoot":"","sources":["../src/step-overlay-attribute-overrides.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAK1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,EAC9C,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,IAAI,EAC1D,aAAa,EAAE,gBAAgB,EAC/B,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GACrD,MAAM,CAoER"}

package/dist/step-overlay-attribute-overrides.js

@@ -0,0 +1,83 @@
+/* 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 { getAttributeNamesAcrossSchemas } from '@ifc-lite/parser';
+import { splitTopLevelArgs } from './step-argument-parser.js';
+import { getRealTypedSlots } from './attribute-real-slots.js';
+import { serializeNamedAttribute, serializePositionalOverride } from './step-attribute-serializers.js';
+/**
+ * Apply overlay attribute + positional overrides to an OVERLAY-CREATED
+ * entity's argument list (#2006).
+ *
+ * Distinct from {@link applyAttributeMutations} / {@link applyPositionalMutations},
+ * which rewrite a line read out of the source buffer. Here the whole line is
+ * ours: it was serialized moments ago from the creation payload, so the
+ * argument list is the authoring payload's, not the file's. That difference
+ * is why this PADS — `entity_create` takes whatever positional list the
+ * caller passes, so a wall authored with three arguments still has a real
+ * `Tag` slot at index 7, and dropping the edit because the payload was short
+ * would be the very data loss this fixes. The source-buffer path must not
+ * pad: there a short line means a different schema, and growing a record we
+ * did not author would corrupt it.
+ *
+ * Named and positional overrides resolve to a slot index up front and share
+ * ONE padding rule. Two padding rules on one record is how the next bug
+ * starts, and the argument for padding — the class is fixed at creation time,
+ * so a short payload is partial authoring — never depended on which of the
+ * two APIs queued the edit.
+ */
+export function applyOverlayEntityOverrides(argsText, entityType, attributeOverrides, positionalOverrides, schemaVersion, onRejected) {
+    const args = argsText.length > 0 ? splitTopLevelArgs(argsText) : [];
+    const attrNames = getAttributeNamesAcrossSchemas(entityType);
+    const named = [];
+    for (const [attrName, value] of attributeOverrides ?? []) {
+        const index = attrNames.indexOf(attrName);
+        if (index >= 0)
+            named.push([index, value]);
+    }
+    // Grow to the class's FULL declared arity as soon as any override names a
+    // declared slot the creation payload never reached. Growing only as far as
+    // the edited slot would emit eight arguments for an IfcWall that declares
+    // nine: this parser tolerates the truncated record, a schema-validating
+    // consumer rejects the file.
+    //
+    // An index PAST the declared layout is not a slot at all, so it cannot
+    // justify growing the record and stays dropped — as does any override on a
+    // class neither schema source knows, where there is no arity to grow to.
+    let needsPad = named.some(([index]) => index >= args.length);
+    if (!needsPad && positionalOverrides) {
+        for (const [index] of positionalOverrides) {
+            if (index >= args.length && index < attrNames.length) {
+                needsPad = true;
+                break;
+            }
+        }
+    }
+    if (needsPad) {
+        while (args.length < attrNames.length)
+            args.push('$');
+    }
+    // Every `named` index is < attrNames.length by construction, and padding
+    // has taken args.length to at least that, so each one lands.
+    const realSlots = getRealTypedSlots(entityType, schemaVersion);
+    for (const [index, value] of named) {
+        const serialized = serializeNamedAttribute(entityType, index, value, args[index], realSlots);
+        // Overlay-created entities take the same rejection: a non-numeric REAL is
+        // invalid STEP whoever authored the record. The slot keeps the `$` this
+        // path padded it with, rather than gaining a quoted string.
+        if (serialized === null) {
+            onRejected?.(attrNames[index] ?? `#${index}`, value);
+            continue;
+        }
+        args[index] = serialized;
+    }
+    if (positionalOverrides && positionalOverrides.size > 0) {
+        for (const [index, value] of positionalOverrides) {
+            if (index < 0 || index >= args.length)
+                continue;
+            args[index] = serializePositionalOverride(entityType, index, value, args[index], realSlots, schemaVersion);
+        }
+    }
+    return args.join(',');
+}
+//# sourceMappingURL=step-overlay-attribute-overrides.js.map

package/dist/step-overlay-attribute-overrides.js.map

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

package/dist/step-overlay-entities.d.ts

@@ -21,8 +21,8 @@
  * `step-source-iteration.ts` already injects, not duplicated here.
  * `applyOverlayEntityOverrides` is injected as `OverlayEntitiesContext`'s
  * field even though, since #2475's "remaining private helpers" step, it is
- * an ordinary export of `step-attribute-mutations.ts` this file could import
- * directly — kept as an injected field for symmetry with the other two and
+ * an ordinary export of `step-overlay-attribute-overrides.ts` this file could
+ * import directly — kept as an injected field for symmetry with the other two and
  * because `StepExporter.overlayEntitiesContext()` is still the one
  * construction site for this context, exactly as before that step.
  *
@@ -41,7 +41,7 @@ import type { ExportPass, StepExportOptions } from './step-exporter.js';
  */
 export interface OverlayEntitiesContext {
     readonly mutationView: MutablePropertyView | null;
-    /** `step-attribute-mutations.ts`'s `applyOverlayEntityOverrides`: resolves
+    /** `step-overlay-attribute-overrides.ts`'s `applyOverlayEntityOverrides`: resolves
      *  named/positional overrides against the overlay-created entity's
      *  EFFECTIVE class. */
     readonly applyOverlayEntityOverrides: (argsText: string, entityType: string, attributeOverrides: Map<string, string> | null, positionalOverrides: Map<number, IfcAttributeValue> | null, schemaVersion: ExportPass['sourceSchema'], onRejected?: (attrName: string, value: string) => void) => string;

package/dist/step-pass-builder.d.ts

@@ -23,9 +23,10 @@ import type { ExportPass, StepExportOptions } from './step-export-types.js';
 /**
  * Everything the pass literal reads that is not its own field.
  *
- * The first three are the exporter's, injected rather than reached for.
- * `isGeometryEntity` is passed as a bound callback for the same reason it is a
- * method there: it closes over the exporter's own type set.
+ * `dataStore` and `mutationView` are the exporter's, injected rather than
+ * reached for. `isGeometryEntity` arrives as a parameter for a different
+ * reason: it is the free function in `step-geometry-types.ts`, so taking it
+ * here keeps this builder independent of the exporter AND of that module.
  */
 export interface PassBuildInput {
     readonly dataStore: IfcDataStore;

package/dist/step-pass-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"step-pass-builder.d.ts","sourceRoot":"","sources":["../src/step-pass-builder.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAqB,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACzF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAM5E;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAClD,QAAQ,CAAC,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACrD,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,eAAe,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,UAAU,CA2QjE"}
+{"version":3,"file":"step-pass-builder.d.ts","sourceRoot":"","sources":["../src/step-pass-builder.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAqB,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACzF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAM5E;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAClD,QAAQ,CAAC,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACrD,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,eAAe,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,UAAU,CA2QjE"}

package/dist/step-pass-builder.js.map

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

package/dist/step-property-set-collection.d.ts

@@ -0,0 +1,24 @@
+import { type PropertySetContext } from './step-property-set-readers.js';
+import type { ExportPass, StepExportOptions } from './step-exporter.js';
+/** The mutation groupings `export()` builds before the collection phase runs. */
+export interface PropertyMutationGroups {
+    readonly entityPropMutations: Map<number, Set<string>>;
+    readonly entityQuantMutations: Map<number, Set<string>>;
+    readonly relDefinesByEntity: Map<number, Array<{
+        relId: number;
+        psetId: number;
+    }>>;
+}
+/**
+ * Collect what the overlay's property-set and quantity-set edits mean for this
+ * export: which sets to regenerate (`pass.newPropertySets` /
+ * `pass.newQuantitySets`), which source records to withhold
+ * (`pass.skipPropertySetIds` / `pass.skipRelationshipIds`), and which type
+ * objects need their `HasPropertySets` resolved later
+ * (`pass.typeOwnedPsetNamesByEntity`, `…IdsByEntity`, `pass.rewrittenEntityIds`).
+ *
+ * The caller owns the `mutationView && options.applyMutations !== false` gate;
+ * reaching here means overlay edits were both present and enabled.
+ */
+export declare function collectPropertyAndQuantitySetMutations(pass: ExportPass, options: StepExportOptions, groups: PropertyMutationGroups, ctx: PropertySetContext): void;
+//# sourceMappingURL=step-property-set-collection.d.ts.map

package/dist/step-property-set-collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-property-set-collection.d.ts","sourceRoot":"","sources":["../src/step-property-set-collection.ts"],"names":[],"mappings":"AAkBA,OAAO,EACL,KAAK,kBAAkB,EAKxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAExE,iFAAiF;AACjF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACvD,QAAQ,CAAC,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACxD,QAAQ,CAAC,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;CACpF;AAkBD;;;;;;;;;;GAUG;AACH,wBAAgB,sCAAsC,CACpD,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,sBAAsB,EAC9B,GAAG,EAAE,kBAAkB,GACtB,IAAI,CAqQN"}