@ifc-lite/export 3.1.0 → 4.0.1

package/dist/merged-remap.js

@@ -0,0 +1,66 @@
+/* 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/. */
+/**
+ * Express-id remapping for the merged exporter: rewrite every `#N` reference of
+ * one model's STEP line into the merged file's id space.
+ *
+ * Split out of `merged-exporter.ts` (it never used `this`) so the id-rewriting
+ * rule lives in one small module next to the other merge-time line surgery
+ * (`merged-empty-containers.ts`, `merged-subcontext.ts`).
+ */
+/**
+ * Remap all #ID references in a STEP entity line.
+ * Applies offset to all IDs, then overrides with specific remappings.
+ *
+ * Only `#<digits>` tokens in code positions are rewritten; tokens inside
+ * single-quoted STEP strings (e.g. a 'Room #205' Name or a 'http://x#42'
+ * URL) are left untouched so string attribute values are not corrupted.
+ */
+export function remapEntityText(entityText, offset, sharedRemap) {
+    const remapId = (originalId) => {
+        // Check if this ID has a specific remap (project, shared infrastructure)
+        const remapped = sharedRemap.get(originalId);
+        if (remapped !== undefined) {
+            return `#${remapped}`;
+        }
+        // Apply offset
+        return `#${originalId + offset}`;
+    };
+    let out = '';
+    let inString = false;
+    for (let i = 0; i < entityText.length; i++) {
+        const char = entityText[i];
+        if (inString) {
+            out += char;
+            if (char === "'") {
+                // STEP escapes a literal quote by doubling it ('').
+                if (entityText[i + 1] === "'") {
+                    out += entityText[i + 1];
+                    i++;
+                }
+                else {
+                    inString = false;
+                }
+            }
+            continue;
+        }
+        if (char === "'") {
+            inString = true;
+            out += char;
+            continue;
+        }
+        if (char === '#' && entityText[i + 1] >= '0' && entityText[i + 1] <= '9') {
+            let j = i + 1;
+            while (j < entityText.length && entityText[j] >= '0' && entityText[j] <= '9')
+                j++;
+            const originalId = parseInt(entityText.slice(i + 1, j), 10);
+            out += remapId(originalId);
+            i = j - 1;
+            continue;
+        }
+        out += char;
+    }
+    return out;
+}
+//# sourceMappingURL=merged-remap.js.map

package/dist/merged-remap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merged-remap.js","sourceRoot":"","sources":["../src/merged-remap.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,UAAkB,EAClB,MAAc,EACd,WAAwC;IAExC,MAAM,OAAO,GAAG,CAAC,UAAkB,EAAU,EAAE;QAC7C,yEAAyE;QACzE,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,IAAI,QAAQ,EAAE,CAAC;QACxB,CAAC;QACD,eAAe;QACf,OAAO,IAAI,UAAU,GAAG,MAAM,EAAE,CAAC;IACnC,CAAC,CAAC;IAEF,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAE3B,IAAI,QAAQ,EAAE,CAAC;YACb,GAAG,IAAI,IAAI,CAAC;YACZ,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACjB,oDAAoD;gBACpD,IAAI,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;oBAC9B,GAAG,IAAI,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;oBACzB,CAAC,EAAE,CAAC;gBACN,CAAC;qBAAM,CAAC;oBACN,QAAQ,GAAG,KAAK,CAAC;gBACnB,CAAC;YACH,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,QAAQ,GAAG,IAAI,CAAC;YAChB,GAAG,IAAI,IAAI,CAAC;YACZ,SAAS;QACX,CAAC;QAED,IAAI,IAAI,KAAK,GAAG,IAAI,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,IAAI,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC;YACzE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,OAAO,CAAC,GAAG,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,IAAI,GAAG;gBAAE,CAAC,EAAE,CAAC;YAClF,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5D,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;YAC3B,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACV,SAAS;QACX,CAAC;QAED,GAAG,IAAI,IAAI,CAAC;IACd,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/merged-subcontext.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Kind-aware `IfcGeometricRepresentationSubContext` matching for
+ * {@link MergedExporter} (merge invariant lens pass 3, item 1).
+ *
+ * `MergedExporter` deduplicates a unit-compatible model's shared
+ * infrastructure — `IfcUnitAssignment`, `IfcGeometricRepresentationContext`
+ * and subcontexts — onto the primary model's instance. For subcontexts that
+ * used to mean taking the two models' subcontext id lists **positionally**:
+ * this model's first subcontext (in whatever order `entityIndex.byType`
+ * returns them) was unified onto the primary model's first subcontext, with
+ * no check that the two are the same kind.
+ *
+ * A model normally declares more than one subcontext ('Body' for solid
+ * geometry, 'Axis' for centreline geometry, sometimes 'FootPrint'/'Box'), and
+ * nothing in the IFC schema or common exporter behaviour guarantees they are
+ * always written in the same order across two different authoring tools. A
+ * positional match can therefore unify this model's 'Body' subcontext onto
+ * the primary model's 'Axis' subcontext (or vice versa): every
+ * `IfcShapeRepresentation.ContextOfItems` that pointed at the dropped 'Body'
+ * subcontext now resolves, after the remap, to a context tagged 'Axis' — the
+ * wrong kind, which many viewers filter out of the 3D view entirely (the
+ * geometry silently vanishes), with no dangling reference to reveal it.
+ *
+ * `planSubContextUnify` fixes this by matching on the subcontext's *kind*
+ * (its `ContextIdentifier` *and* `TargetView`, plus `UserDefinedTargetView`
+ * where applicable) rather than on raw array position.
+ */
+import type { IfcDataStore } from '@ifc-lite/parser';
+/** Group `ids` (a model's subcontext express ids) by {@link subContextKey}. */
+export declare function groupSubContextsByKey(dataStore: IfcDataStore, ids: readonly number[]): Map<string, number[]>;
+/**
+ * Plan this model's subcontext dedup against the primary model, key by key:
+ * a subcontext in `thisIds` is remapped+skipped only against an unclaimed
+ * primary-model subcontext with the SAME key (never a differently ordered one
+ * of a different kind or TargetView). A subcontext with no same-key match in
+ * the primary model is left un-remapped — kept as its own (offset-only)
+ * entity, exactly like today's "no shared infrastructure of this type"
+ * fallback. Mutates `sharedRemap`/`skipEntityIds`.
+ */
+export declare function planSubContextUnify(dataStore: IfcDataStore, thisIds: readonly number[], firstModelSubContextsByKey: ReadonlyMap<string, number[]>, firstModelOffset: number, sharedRemap: Map<number, number>, skipEntityIds: Set<number>): void;
+//# sourceMappingURL=merged-subcontext.d.ts.map

package/dist/merged-subcontext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merged-subcontext.d.ts","sourceRoot":"","sources":["../src/merged-subcontext.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA8DrD,+EAA+E;AAC/E,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,YAAY,EAAE,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAQ5G;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,YAAY,EACvB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,0BAA0B,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EACzD,gBAAgB,EAAE,MAAM,EACxB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,GACzB,IAAI,CAYN"}

package/dist/merged-subcontext.js

@@ -0,0 +1,99 @@
+/* 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 { asSourceBytes, STEP_TRIVIA } from '@ifc-lite/parser';
+import { splitTopLevelStepArguments } from './step-argument-parser.js';
+/**
+ * `#N=TYPE(...)` record, with STEP trivia (whitespace and/or a
+ * `/* ... *​/` comment, #3789) tolerated between the type name and `(` —
+ * same adjacency fix as `entity-extractor.ts`'s `extractEntity`. Without it
+ * a wrapped record's attribute is silently unreadable here (`getStepAttr`
+ * returns `null`), which reads identically to a genuinely-absent attribute.
+ */
+const RECORD_RE = new RegExp(`^#\\d+\\s*=\\s*\\w+${STEP_TRIVIA}\\(([\\s\\S]*)\\)\\s*;?\\s*$`);
+/** 0-based attribute index of `IfcGeometricRepresentationSubContext.ContextIdentifier`. */
+const CONTEXT_IDENTIFIER_ATTR = 0;
+/** 0-based attribute index of `IfcGeometricRepresentationSubContext.TargetView`. */
+const TARGET_VIEW_ATTR = 8;
+/** 0-based attribute index of `IfcGeometricRepresentationSubContext.UserDefinedTargetView`. */
+const USER_DEFINED_TARGET_VIEW_ATTR = 9;
+function decodeEntity(dataStore, expressId) {
+    const source = dataStore.source;
+    if (!source)
+        return null;
+    const ref = dataStore.entityIndex.byId.get(expressId);
+    if (!ref)
+        return null;
+    return asSourceBytes(source).decodeUtf8(ref.byteOffset, ref.byteOffset + ref.byteLength);
+}
+/** Extract one 0-based STEP attribute of `expressId`'s entity, or null if unreadable. */
+function getStepAttr(dataStore, expressId, index) {
+    const text = decodeEntity(dataStore, expressId);
+    const match = text?.match(RECORD_RE);
+    if (!match)
+        return null;
+    const args = splitTopLevelStepArguments(match[1]);
+    const raw = args?.[index];
+    return raw === undefined ? null : raw.trim();
+}
+/** Normalize a STEP string/enum token to a comparison key; `''` for unset/unreadable. */
+function normalizeLabel(raw) {
+    if (!raw || raw === '$' || raw === '*')
+        return '';
+    const quoted = raw.match(/^'([\s\S]*)'$/);
+    const inner = quoted ? quoted[1] : raw;
+    return inner.replace(/\./g, '').trim().toUpperCase();
+}
+/**
+ * The matching key of one `IfcGeometricRepresentationSubContext` combines its
+ * `ContextIdentifier` and `TargetView`: a Body representation for MODEL_VIEW
+ * is not interchangeable with one for PLAN_VIEW. `UserDefinedTargetView`
+ * distinguishes two USERDEFINED views. Empty pieces deliberately remain part
+ * of the key so identifier-less subcontexts still group by their view.
+ */
+function subContextKey(dataStore, expressId) {
+    const identifier = normalizeLabel(getStepAttr(dataStore, expressId, CONTEXT_IDENTIFIER_ATTR));
+    const targetView = normalizeLabel(getStepAttr(dataStore, expressId, TARGET_VIEW_ATTR));
+    const userDefinedTargetView = targetView === 'USERDEFINED'
+        ? normalizeLabel(getStepAttr(dataStore, expressId, USER_DEFINED_TARGET_VIEW_ATTR))
+        : '';
+    return `${identifier}\u0000${targetView}\u0000${userDefinedTargetView}`;
+}
+/** Group `ids` (a model's subcontext express ids) by {@link subContextKey}. */
+export function groupSubContextsByKey(dataStore, ids) {
+    const map = new Map();
+    for (const id of ids) {
+        const key = subContextKey(dataStore, id);
+        const bucket = map.get(key);
+        if (bucket)
+            bucket.push(id);
+        else
+            map.set(key, [id]);
+    }
+    return map;
+}
+/**
+ * Plan this model's subcontext dedup against the primary model, key by key:
+ * a subcontext in `thisIds` is remapped+skipped only against an unclaimed
+ * primary-model subcontext with the SAME key (never a differently ordered one
+ * of a different kind or TargetView). A subcontext with no same-key match in
+ * the primary model is left un-remapped — kept as its own (offset-only)
+ * entity, exactly like today's "no shared infrastructure of this type"
+ * fallback. Mutates `sharedRemap`/`skipEntityIds`.
+ */
+export function planSubContextUnify(dataStore, thisIds, firstModelSubContextsByKey, firstModelOffset, sharedRemap, skipEntityIds) {
+    const nextIndex = new Map();
+    for (const id of thisIds) {
+        const key = subContextKey(dataStore, id);
+        const pool = firstModelSubContextsByKey.get(key);
+        if (!pool || pool.length === 0)
+            continue;
+        const idx = nextIndex.get(key) ?? 0;
+        if (idx >= pool.length)
+            continue; // every same-kind primary target already claimed
+        nextIndex.set(key, idx + 1);
+        sharedRemap.set(id, pool[idx] + firstModelOffset);
+        skipEntityIds.add(id);
+    }
+}
+//# sourceMappingURL=merged-subcontext.js.map

package/dist/merged-subcontext.js.map

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

package/dist/parquet-exporter-ondemand.d.ts

@@ -0,0 +1,34 @@
+/**
+ * `Properties.parquet` / `Quantities.parquet` writers for the on-demand parse
+ * path, extracted from `ParquetExporter` (`parquet-exporter.ts`) to keep that
+ * file under its module-size budget.
+ *
+ * `IfcParser.parseColumnar` (`packages/parser`'s only parse path, used by
+ * every real caller) never calls `.add()` on the `PropertyTableBuilder`/
+ * `QuantityTableBuilder` it constructs — properties and quantities are served
+ * lazily through `onDemandPropertyMap`/`onDemandQuantityMap` +
+ * `store.getProperties()`/`store.getQuantities()` instead
+ * (`extractPropertiesOnDemand`/`extractQuantitiesOnDemand`, re-parsing the
+ * source buffer on access). `ParquetExporter`'s bulk-table writers read
+ * `store.properties`/`store.quantities` directly, which is only populated
+ * when a caller builds a store some other way (e.g. this package's own
+ * hand-built test fixtures) — every store from a real parse left those two
+ * tables at zero rows, silently, alongside a fully-populated
+ * `Entities.parquet`/`Relationships.parquet`. These two functions are the
+ * on-demand fallback `ParquetExporter` calls when the bulk table is empty:
+ * one flat row per property/quantity, read through the same
+ * `store.getProperties()`/`store.getQuantities()` accessor every other
+ * consumer (the query package, the viewer's property panel) uses — never a
+ * second copy of the pset/property walk.
+ */
+import type { IfcDataStore } from '@ifc-lite/parser';
+import type { EffectiveEntityIndex } from './effective-index.js';
+export declare function writePropertiesOnDemand(store: IfcDataStore, effective: EffectiveEntityIndex | null): Promise<Uint8Array>;
+/**
+ * `Formula` is always NULL here: the on-demand quantity reader
+ * (`readQuantitySet` in `@ifc-lite/parser`) reports only
+ * `{name, type, value}` per quantity, so there is no formula string to carry
+ * — `ParquetExporter`'s bulk-table path is the only one that can populate it.
+ */
+export declare function writeQuantitiesOnDemand(store: IfcDataStore, effective: EffectiveEntityIndex | null): Promise<Uint8Array>;
+//# sourceMappingURL=parquet-exporter-ondemand.d.ts.map

package/dist/parquet-exporter-ondemand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parquet-exporter-ondemand.d.ts","sourceRoot":"","sources":["../src/parquet-exporter-ondemand.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAKjE,wBAAsB,uBAAuB,CACzC,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,oBAAoB,GAAG,IAAI,GACvC,OAAO,CAAC,UAAU,CAAC,CA4CrB;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CACzC,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,oBAAoB,GAAG,IAAI,GACvC,OAAO,CAAC,UAAU,CAAC,CA+BrB"}

package/dist/parquet-exporter-ondemand.js

@@ -0,0 +1,89 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+import { PropertyValueType } from '@ifc-lite/data';
+import { columnsToParquet } from './columns-to-parquet.js';
+import { PARQUET_UINT32_COLUMNS } from './parquet-uint32-columns.js';
+import { propertyValueTypeToString, quantityTypeToString } from './parquet-type-strings.js';
+export async function writePropertiesOnDemand(store, effective) {
+    const entityIdCol = [];
+    const psetNameCol = [];
+    const psetGlobalIdCol = [];
+    const propNameCol = [];
+    const propTypeCol = [];
+    const valueStringCol = [];
+    // `IfcPropertyBoundedValue` is surfaced as a display string but retains
+    // the REAL type tag. Only a scalar numeric value belongs in ValueReal;
+    // writing 0 for the display-string form fabricates a measurement.
+    const valueRealCol = [];
+    const valueIntCol = [];
+    const valueBoolCol = [];
+    for (const id of store.onDemandPropertyMap.keys()) {
+        if (effective?.isDeleted(id))
+            continue;
+        const psets = store.getProperties(id);
+        for (const pset of psets) {
+            for (const prop of pset.properties) {
+                entityIdCol.push(id);
+                psetNameCol.push(pset.name);
+                psetGlobalIdCol.push(pset.globalId ?? '');
+                propNameCol.push(prop.name);
+                propTypeCol.push(prop.type);
+                const v = prop.value;
+                valueStringCol.push(typeof v === 'string' ? v : null);
+                valueRealCol.push(prop.type === PropertyValueType.Real && typeof v === 'number' ? v : null);
+                valueIntCol.push(prop.type === PropertyValueType.Integer && typeof v === 'number' ? v : 0);
+                valueBoolCol.push(typeof v === 'boolean' ? v : null);
+            }
+        }
+    }
+    return columnsToParquet({
+        EntityId: entityIdCol,
+        PsetName: psetNameCol,
+        PsetGlobalId: psetGlobalIdCol,
+        PropName: propNameCol,
+        PropType: propTypeCol.map(t => propertyValueTypeToString(t)),
+        ValueString: valueStringCol,
+        ValueReal: valueRealCol,
+        ValueInt: valueIntCol,
+        ValueBool: valueBoolCol,
+    }, new Set(['ValueReal']), PARQUET_UINT32_COLUMNS);
+}
+/**
+ * `Formula` is always NULL here: the on-demand quantity reader
+ * (`readQuantitySet` in `@ifc-lite/parser`) reports only
+ * `{name, type, value}` per quantity, so there is no formula string to carry
+ * — `ParquetExporter`'s bulk-table path is the only one that can populate it.
+ */
+export async function writeQuantitiesOnDemand(store, effective) {
+    const entityIdCol = [];
+    const qsetNameCol = [];
+    const quantityNameCol = [];
+    const quantityTypeCol = [];
+    const valueCol = [];
+    const formulaCol = [];
+    for (const id of store.onDemandQuantityMap.keys()) {
+        if (effective?.isDeleted(id))
+            continue;
+        const qsets = store.getQuantities(id);
+        for (const qset of qsets) {
+            for (const q of qset.quantities) {
+                entityIdCol.push(id);
+                qsetNameCol.push(qset.name);
+                quantityNameCol.push(q.name);
+                quantityTypeCol.push(q.type);
+                valueCol.push(q.value);
+                formulaCol.push(q.formula ?? null);
+            }
+        }
+    }
+    return columnsToParquet({
+        EntityId: entityIdCol,
+        QsetName: qsetNameCol,
+        QuantityName: quantityNameCol,
+        QuantityType: quantityTypeCol.map(t => quantityTypeToString(t)),
+        Value: valueCol,
+        Formula: formulaCol,
+    }, new Set(['Value']), PARQUET_UINT32_COLUMNS);
+}
+//# sourceMappingURL=parquet-exporter-ondemand.js.map

package/dist/parquet-exporter-ondemand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parquet-exporter-ondemand.js","sourceRoot":"","sources":["../src/parquet-exporter-ondemand.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AA2B/D,OAAO,EAAE,iBAAiB,EAAqB,MAAM,gBAAgB,CAAC;AAEtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAE5F,MAAM,CAAC,KAAK,UAAU,uBAAuB,CACzC,KAAmB,EACnB,SAAsC;IAEtC,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,eAAe,GAAa,EAAE,CAAC;IACrC,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,WAAW,GAAwB,EAAE,CAAC;IAC5C,MAAM,cAAc,GAAsB,EAAE,CAAC;IAC7C,wEAAwE;IACxE,uEAAuE;IACvE,kEAAkE;IAClE,MAAM,YAAY,GAAsB,EAAE,CAAC;IAC3C,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,YAAY,GAAuB,EAAE,CAAC;IAE5C,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,mBAAoB,CAAC,IAAI,EAAE,EAAE,CAAC;QACjD,IAAI,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC;YAAE,SAAS;QACvC,MAAM,KAAK,GAAG,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QACtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACjC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACrB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC5B,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;gBAC1C,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC5B,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;gBACrB,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBACtD,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,iBAAiB,CAAC,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC5F,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,iBAAiB,CAAC,OAAO,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC3F,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACzD,CAAC;QACL,CAAC;IACL,CAAC;IAED,OAAO,gBAAgB,CAAC;QACpB,QAAQ,EAAE,WAAW;QACrB,QAAQ,EAAE,WAAW;QACrB,YAAY,EAAE,eAAe;QAC7B,QAAQ,EAAE,WAAW;QACrB,QAAQ,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC;QAC5D,WAAW,EAAE,cAAc;QAC3B,SAAS,EAAE,YAAY;QACvB,QAAQ,EAAE,WAAW;QACrB,SAAS,EAAE,YAAY;KAC1B,EAAE,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,EAAE,sBAAsB,CAAC,CAAC;AACvD,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CACzC,KAAmB,EACnB,SAAsC;IAEtC,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,eAAe,GAAa,EAAE,CAAC;IACrC,MAAM,eAAe,GAAmB,EAAE,CAAC;IAC3C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,UAAU,GAAsB,EAAE,CAAC;IAEzC,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,mBAAoB,CAAC,IAAI,EAAE,EAAE,CAAC;QACjD,IAAI,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC;YAAE,SAAS;QACvC,MAAM,KAAK,GAAG,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QACtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBAC9B,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACrB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC5B,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC7B,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC7B,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;gBACvB,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC;YACvC,CAAC;QACL,CAAC;IACL,CAAC;IAED,OAAO,gBAAgB,CAAC;QACpB,QAAQ,EAAE,WAAW;QACrB,QAAQ,EAAE,WAAW;QACrB,YAAY,EAAE,eAAe;QAC7B,YAAY,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;QAC/D,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE,UAAU;KACtB,EAAE,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,sBAAsB,CAAC,CAAC;AACnD,CAAC"}

package/dist/parquet-exporter.d.ts

@@ -2,7 +2,6 @@
 import type { IfcDataStore } from '@ifc-lite/parser';
 import type { GeometryResult } from '@ifc-lite/geometry';
 import type { MutablePropertyView } from '@ifc-lite/mutations';
-import { QuantityType } from '@ifc-lite/data';
 export interface ParquetExportOptions {
     includeGeometry?: boolean;
 }
@@ -58,35 +57,8 @@ export declare class ParquetExporter {
     private writeMeshes;
     private writeSpatialHierarchy;
     private writeMetadata;
-    /**
-     * Column names whose domain is an unsigned 32-bit integer.
-     *
-     * Every one carries an IFC EXPRESS ID or an index into a geometry buffer,
-     * and both are `u32` everywhere else in this codebase - `Uint32Array` in
-     * the parser's entity index and its transports, `u32` in the Rust crates.
-     * Arrow's content inference reaches for Int32 on any whole number, so an
-     * express id at or above 2_147_483_648 came out NEGATIVE: an id-shaped
-     * number that joins to nothing. STEP puts no upper bound on an entity id
-     * below the `u32` the readers use, so that is reachable input rather than a
-     * hypothetical.
-     */
-    private static readonly UINT32_COLUMNS;
-    /**
-     * NOT in the set above, deliberately: `BuildingId`, `SiteId` and `SpaceId`
-     * in `SpatialHierarchy.parquet` carry **-1 as "none"** (see
-     * `writeSpatialHierarchy` - a storey directly under the project has no
-     * building). Declaring those unsigned turned that sentinel into
-     * 4294967295: an id-shaped number where an obviously-absent marker used to
-     * be, which is the exact failure this class of change exists to prevent.
-     *
-     * The residual gap is the narrower one: a building or site id at or above
-     * 2^31 still wraps negative in those three columns. Fixing that properly
-     * means writing NULL rather than -1 for "none", which changes what every
-     * consumer reads for an absent parent and is a separate decision from the
-     * id width.
-     */
     private toParquet;
     private createZipArchive;
 }
-export declare function QuantityTypeToString(type: QuantityType): string;
+export { quantityTypeToString as QuantityTypeToString } from './parquet-type-strings.js';
 //# sourceMappingURL=parquet-exporter.d.ts.map

package/dist/parquet-exporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parquet-exporter.d.ts","sourceRoot":"","sources":["../src/parquet-exporter.ts"],"names":[],"mappings":"AAIA,uDAAuD;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAA+C,YAAY,EAAqD,MAAM,gBAAgB,CAAC;AAI9I,MAAM,WAAW,oBAAoB;IACjC,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;GAGG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,YAAY,CAA6B;IAEjD;;;;;;;;;;;;;;;;;OAiBG;gBACS,KAAK,EAAE,YAAY,EAAE,cAAc,CAAC,EAAE,cAAc,EAAE,YAAY,CAAC,EAAE,mBAAmB;IAMpG;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACG,SAAS,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,UAAU,CAAC;IA4BxE;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;YAkB3C,aAAa;YAoDb,eAAe;YAsBf,eAAe;YAiBf,kBAAkB;YAkClB,YAAY;YAkBZ,iBAAiB;YA+DjB,gBAAgB;YA6BhB,WAAW;YAyCX,qBAAqB;IAuFnC,OAAO,CAAC,aAAa;IA6BrB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAKnC;IAEH;;;;;;;;;;;;;OAaG;YAEW,SAAS;YAIT,gBAAgB;CAUjC;AA6CD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAW/D"}
+{"version":3,"file":"parquet-exporter.d.ts","sourceRoot":"","sources":["../src/parquet-exporter.ts"],"names":[],"mappings":"AAIA,uDAAuD;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAQ/D,MAAM,WAAW,oBAAoB;IACjC,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;GAGG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,YAAY,CAA6B;IAEjD;;;;;;;;;;;;;;;;;OAiBG;gBACS,KAAK,EAAE,YAAY,EAAE,cAAc,CAAC,EAAE,cAAc,EAAE,YAAY,CAAC,EAAE,mBAAmB;IAMpG;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACG,SAAS,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,UAAU,CAAC;IA4BxE;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;YAkB3C,aAAa;YAoDb,eAAe;YAuCf,eAAe;YA0Bf,kBAAkB;YAwClB,YAAY;YAkBZ,iBAAiB;YA+DjB,gBAAgB;YA6BhB,WAAW;YAyCX,qBAAqB;IAuFnC,OAAO,CAAC,aAAa;YA6BP,SAAS;YAIT,gBAAgB;CAUjC;AAgCD,OAAO,EAAE,oBAAoB,IAAI,oBAAoB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/parquet-exporter.js

@@ -1,9 +1,12 @@
 /* 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 { IfcTypeEnum, EntityFlags, PropertyValueType, QuantityType, RelationshipType, IFC_ENTITY_NAMES, exactTypeName } from '@ifc-lite/data';
+import { IfcTypeEnum, EntityFlags, RelationshipType, IFC_ENTITY_NAMES, exactTypeName, flattenRelationshipEdges } from '@ifc-lite/data';
 import { getEffectiveEntityIndex } from './effective-index.js';
 import { columnsToParquet } from './columns-to-parquet.js';
+import { PARQUET_UINT32_COLUMNS } from './parquet-uint32-columns.js';
+import { writePropertiesOnDemand, writeQuantitiesOnDemand } from './parquet-exporter-ondemand.js';
+import { propertyValueTypeToString, quantityTypeToString } from './parquet-type-strings.js';
 /**
  * Export to ara3d BIM Open Schema compatible Parquet files.
  * Creates a .bos archive (ZIP of Parquet files).
@@ -148,6 +151,22 @@ export class ParquetExporter {
     async writeProperties() {
         const { properties, strings } = this.store;
         const effective = this.getEffective();
+        // `IfcParser.parseColumnar` (the sole parse path every real caller of
+        // this exporter goes through — `packages/parser`'s `parseLite`) never
+        // populates `store.properties`: it builds a `PropertyTableBuilder` but
+        // never calls `.add()` on it, relying instead on lazy per-entity
+        // extraction via `onDemandPropertyMap` + `store.getProperties()`
+        // (`extractPropertiesOnDemand`, re-parsing the source buffer on
+        // access). Reading `store.properties` directly here — the bulk table
+        // — silently wrote a zero-row `Properties.parquet` for every model
+        // parsed the normal way, geometry/relationships/entities tables full
+        // alongside it. `store.properties` only carries real rows when a
+        // caller builds a store some other way (e.g. hand-built fixtures in
+        // this file's own tests). Route through the on-demand path first;
+        // fall back to the bulk table when it was actually populated.
+        if (properties.entityId.length === 0 && this.store.onDemandPropertyMap && this.store.onDemandPropertyMap.size > 0) {
+            return writePropertiesOnDemand(this.store, effective);
+        }
         const entityId = Array.from(properties.entityId);
         // A property row belongs to the entity named in its own EntityId
         // column, not to its own row index — filter on that, not on ExpressId.
@@ -157,7 +176,7 @@ export class ParquetExporter {
             PsetName: mapTypedArray(properties.psetName, i => strings.get(i)),
             PsetGlobalId: mapTypedArray(properties.psetGlobalId, i => strings.get(i)),
             PropName: mapTypedArray(properties.propName, i => strings.get(i)),
-            PropType: mapTypedArray(properties.propType, t => PropertyValueTypeToString(t)),
+            PropType: mapTypedArray(properties.propType, t => propertyValueTypeToString(t)),
             ValueString: mapTypedArray(properties.valueString, i => i >= 0 && i < strings.count ? strings.get(i) : null),
             ValueReal: Array.from(properties.valueReal),
             ValueInt: Array.from(properties.valueInt),
@@ -167,40 +186,54 @@ export class ParquetExporter {
     async writeQuantities() {
         const { quantities, strings } = this.store;
         const effective = this.getEffective();
+        // Same gap as `writeProperties`: `store.quantities` is only ever
+        // populated when a caller bulk-builds it directly (this file's own
+        // tests); the real `parseColumnar` path leaves it empty and serves
+        // quantities lazily through `onDemandQuantityMap` +
+        // `store.getQuantities()`.
+        if (quantities.entityId.length === 0 && this.store.onDemandQuantityMap && this.store.onDemandQuantityMap.size > 0) {
+            return writeQuantitiesOnDemand(this.store, effective);
+        }
         const entityId = Array.from(quantities.entityId);
         const keep = effective ? entityId.map((id) => !effective.isDeleted(id)) : null;
         return this.toParquet(filterColumns({
             EntityId: entityId,
             QsetName: mapTypedArray(quantities.qsetName, i => strings.get(i)),
             QuantityName: mapTypedArray(quantities.quantityName, i => strings.get(i)),
-            QuantityType: mapTypedArray(quantities.quantityType, t => QuantityTypeToString(t)),
+            QuantityType: mapTypedArray(quantities.quantityType, t => quantityTypeToString(t)),
             Value: Array.from(quantities.value),
             Formula: mapTypedArray(quantities.formula, i => i > 0 ? strings.get(i) : null),
         }, keep), new Set(['Value']));
     }
     async writeRelationships() {
         const { relationships } = this.store;
-        const edges = relationships.forward;
         const effective = this.getEffective();
-        // Flatten CSR format to row-based
+        // One row per `IfcRel*` STEP record, including any collapsed into
+        // an edge's `shadowedRelationshipIds` (#3760/#3782) — not one row
+        // per deduped edge; see `flattenRelationshipEdges`'s doc comment.
         const sourceIds = [];
         const targetIds = [];
         const relTypes = [];
         const relIds = [];
-        for (const [sourceId, offset] of edges.offsets) {
-            const count = edges.counts.get(sourceId);
-            for (let i = offset; i < offset + count; i++) {
-                const targetId = edges.edgeTargets[i];
-                // An edge naming a tombstoned entity on either end no longer
-                // has a live entity to relate — drop the row rather than
-                // leave a dangling SourceId/TargetId in the export.
-                if (effective && (effective.isDeleted(sourceId) || effective.isDeleted(targetId)))
-                    continue;
-                sourceIds.push(sourceId);
-                targetIds.push(targetId);
-                relTypes.push(RelationshipTypeToString(edges.edgeTypes[i]));
-                relIds.push(edges.edgeRelIds[i]);
-            }
+        for (const row of flattenRelationshipEdges(relationships.forward)) {
+            // An edge naming a tombstoned entity on either end no longer
+            // has a live entity to relate — drop the row rather than
+            // leave a dangling SourceId/TargetId in the export.
+            //
+            // `relationshipId` gets the same treatment: an `IfcRel*` record
+            // is itself a row in Entities.parquet (the columnar parser
+            // indexes it like any other line), so emitting a RelId for a
+            // deleted one leaves a dangling reference too. Because each
+            // shadowed id is its own row here, this drops exactly the
+            // deleted record and keeps a live sibling — the same rule
+            // `edgeSurvives` applies to the CLI/MCP `related()` path
+            // (#3782 review).
+            if (effective && (effective.isDeleted(row.sourceId) || effective.isDeleted(row.targetId) || effective.isDeleted(row.relationshipId)))
+                continue;
+            sourceIds.push(row.sourceId);
+            targetIds.push(row.targetId);
+            relTypes.push(RelationshipTypeToString(row.type));
+            relIds.push(row.relationshipId);
         }
         return this.toParquet({
             SourceId: sourceIds,
@@ -437,40 +470,8 @@ export class ParquetExporter {
     // ═══════════════════════════════════════════════════════════════
     // UTILITIES
     // ═══════════════════════════════════════════════════════════════
-    /**
-     * Column names whose domain is an unsigned 32-bit integer.
-     *
-     * Every one carries an IFC EXPRESS ID or an index into a geometry buffer,
-     * and both are `u32` everywhere else in this codebase - `Uint32Array` in
-     * the parser's entity index and its transports, `u32` in the Rust crates.
-     * Arrow's content inference reaches for Int32 on any whole number, so an
-     * express id at or above 2_147_483_648 came out NEGATIVE: an id-shaped
-     * number that joins to nothing. STEP puts no upper bound on an entity id
-     * below the `u32` the readers use, so that is reachable input rather than a
-     * hypothetical.
-     */
-    static UINT32_COLUMNS = new Set([
-        'ExpressId', 'EntityId', 'SourceId', 'TargetId', 'RelId',
-        'ElementId', 'StoreyId',
-        'Index0', 'Index1', 'Index2',
-        'VertexStart', 'VertexCount', 'IndexStart', 'IndexCount',
-    ]);
-    /**
-     * NOT in the set above, deliberately: `BuildingId`, `SiteId` and `SpaceId`
-     * in `SpatialHierarchy.parquet` carry **-1 as "none"** (see
-     * `writeSpatialHierarchy` - a storey directly under the project has no
-     * building). Declaring those unsigned turned that sentinel into
-     * 4294967295: an id-shaped number where an obviously-absent marker used to
-     * be, which is the exact failure this class of change exists to prevent.
-     *
-     * The residual gap is the narrower one: a building or site id at or above
-     * 2^31 still wraps negative in those three columns. Fixing that properly
-     * means writing NULL rather than -1 for "none", which changes what every
-     * consumer reads for an absent parent and is a separate decision from the
-     * id width.
-     */
     async toParquet(columns, floatColumns) {
-        return columnsToParquet(columns, floatColumns, ParquetExporter.UINT32_COLUMNS);
+        return columnsToParquet(columns, floatColumns, PARQUET_UINT32_COLUMNS);
     }
     async createZipArchive(files) {
         const JSZip = (await import('jszip')).default;
@@ -503,35 +504,12 @@ function filterColumns(columns, keep) {
     }
     return out;
 }
-function PropertyValueTypeToString(type) {
-    const names = {
-        [PropertyValueType.String]: 'String',
-        [PropertyValueType.Real]: 'Real',
-        [PropertyValueType.Integer]: 'Integer',
-        [PropertyValueType.Boolean]: 'Boolean',
-        [PropertyValueType.Logical]: 'Logical',
-        [PropertyValueType.Label]: 'Label',
-        [PropertyValueType.Identifier]: 'Identifier',
-        [PropertyValueType.Text]: 'Text',
-        [PropertyValueType.Enum]: 'Enum',
-        [PropertyValueType.Reference]: 'Reference',
-        [PropertyValueType.List]: 'List',
-    };
-    return names[type] || 'Unknown';
-}
-// Quantity type conversion - exported for future use when quantities are implemented
-export function QuantityTypeToString(type) {
-    const names = {
-        [QuantityType.Length]: 'Length',
-        [QuantityType.Area]: 'Area',
-        [QuantityType.Volume]: 'Volume',
-        [QuantityType.Count]: 'Count',
-        [QuantityType.Weight]: 'Weight',
-        [QuantityType.Time]: 'Time',
-        [QuantityType.Number]: 'Number',
-    };
-    return names[type] || 'Unknown';
-}
+// Kept exported under its original name here (moved to `parquet-type-strings.ts`
+// so the on-demand writers can share it without importing this file, which
+// imports them): nothing in-repo imports it from this path — index.ts never
+// re-exported it — but it was public `export function` surface before the
+// module split, so a re-export costs nothing to keep.
+export { quantityTypeToString as QuantityTypeToString } from './parquet-type-strings.js';
 function RelationshipTypeToString(type) {
     const names = {
         [RelationshipType.ContainsElements]: 'IfcRelContainedInSpatialStructure',