@ifc-lite/export 3.0.1 → 4.0.0

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":"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"}

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,EAAsC,MAAM,gBAAgB,CAAC;AAI/H,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"}