@ifc-lite/export 4.0.1 → 4.3.1

package/dist/csv-table.js

@@ -0,0 +1,39 @@
+/* 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/. */
+/**
+ * RFC 4180 CSV for a table of row OBJECTS — one header row from `columns`, then
+ * one line per row reading exactly those keys, in that order.
+ *
+ * Every table export in this repo (zones, clashes, …) had grown its own copy of
+ * the same 15-line loop around `escapeCsvCell`. The loop is not where the
+ * security lives — that is the escaper — but three copies of "null → empty,
+ * boolean → `true`/`false`, trailing newline" still drift (one forgot the
+ * trailing newline, so `cat a.csv b.csv` joined two rows). One writer, one set
+ * of rules:
+ *
+ * - `null` / `undefined` → empty cell (a spreadsheet reads `null` as text).
+ * - booleans → `true` / `false` (not `1`/`0`, which sum).
+ * - every other value → `String(value)` through {@link escapeCsvCell}, which
+ *   applies RFC 4180 quoting and the CWE-1236 formula-injection guard. A cell
+ *   whose first or last character is whitespace is quoted so an importer cannot
+ *   trim the padding away (`quoteWhitespacePadded`).
+ * - lines end with `\n` and the file ends with one.
+ */
+import { escapeCsvCell } from './csv-cell.js';
+/** Serialise one cell value under the rules documented on {@link tableToCsv}. */
+export function csvCellOf(value, delimiter = ',') {
+    if (value === null || value === undefined)
+        return '';
+    const raw = typeof value === 'boolean' ? (value ? 'true' : 'false') : String(value);
+    return escapeCsvCell(raw, { delimiter, quoteWhitespacePadded: true });
+}
+export function tableToCsv(columns, rows, options = {}) {
+    const delimiter = options.delimiter ?? ',';
+    const lines = [columns.map((column) => csvCellOf(column, delimiter)).join(delimiter)];
+    for (const row of rows) {
+        lines.push(columns.map((column) => csvCellOf(row[column], delimiter)).join(delimiter));
+    }
+    return `${lines.join('\n')}\n`;
+}
+//# sourceMappingURL=csv-table.js.map

package/dist/csv-table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv-table.js","sourceRoot":"","sources":["../src/csv-table.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAU9C,iFAAiF;AACjF,MAAM,UAAU,SAAS,CAAC,KAAc,EAAE,SAAS,GAAG,GAAG;IACvD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACrD,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACpF,OAAO,aAAa,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,OAAoC,EACpC,IAAoB,EACpB,UAA6B,EAAE;IAE/B,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,GAAG,CAAC;IAC3C,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IACtF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC"}

package/dist/effective-appearance-record.d.ts

@@ -0,0 +1,8 @@
+import { type IfcDataStore } from '@ifc-lite/parser';
+import type { MutablePropertyView } from '@ifc-lite/mutations';
+import type { EffectiveEntityIndex } from './effective-index.js';
+/** Compose the existing STEP writers; never invent a second override policy. */
+export declare function effectiveAppearanceRecord(store: IfcDataStore, view: MutablePropertyView, index: EffectiveEntityIndex, id: number): string;
+/** URLReference occupies slot 5 after the inherited IfcSurfaceTexture fields. */
+export declare function effectiveImageUri(line: string): string | undefined;
+//# sourceMappingURL=effective-appearance-record.d.ts.map

package/dist/effective-appearance-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effective-appearance-record.d.ts","sourceRoot":"","sources":["../src/effective-appearance-record.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiC,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACpF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAQjE,gFAAgF;AAChF,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,oBAAoB,EAAE,EAAE,EAAE,MAAM,GACtF,MAAM,CAuBR;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOlE"}

package/dist/effective-appearance-record.js

@@ -0,0 +1,49 @@
+/* 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, parseStepValue } from '@ifc-lite/parser';
+import { serializeEntityArgs } from './attribute-real-slots.js';
+import { applyOverlayEntityOverrides } from './step-overlay-attribute-overrides.js';
+import { applySourceLineMutations } from './step-attribute-mutations.js';
+import { readStepSlots, splitTopLevelStepArguments } from './step-argument-parser.js';
+import { retypeArgTokens } from './retype.js';
+/** Compose the existing STEP writers; never invent a second override policy. */
+export function effectiveAppearanceRecord(store, view, index, id) {
+    const record = index.get(id);
+    if (!record)
+        throw new Error('Missing IFC entity during appearance cleanup; resources were retained.');
+    const schema = store.schemaVersion || 'IFC4';
+    const named = new Map(view.getAttributeMutationsForEntity(id).map(({ name, value }) => [name, value]));
+    const created = view.getNewEntity(id);
+    if (created) {
+        const retype = view.getEntityTypeMutation(id);
+        const type = retype?.newType ?? created.type;
+        let args = serializeEntityArgs(created.type, created.attributes, schema);
+        if (retype) {
+            const slots = splitTopLevelStepArguments(args);
+            if (slots === null)
+                throw new Error('Invalid authored IFC entity during appearance cleanup; resources were retained.');
+            args = retypeArgTokens(slots, created.type, type, retype.predefinedType, schema).tokens.join(',');
+        }
+        args = applyOverlayEntityOverrides(args, type, named, view.getPositionalMutationsForEntity(id), schema);
+        return `#${id}=${type.toUpperCase()}(${args});`;
+    }
+    const source = asSourceBytes(store.source);
+    const original = source.decodeUtf8(record.byteOffset, record.byteOffset + record.byteLength);
+    const result = applySourceLineMutations(view, id, original, record.type, named, schema, true);
+    if (result.unreadable)
+        throw new Error('Unreadable edited IFC entity during appearance cleanup; resources were retained.');
+    return result.text;
+}
+/** URLReference occupies slot 5 after the inherited IfcSurfaceTexture fields. */
+export function effectiveImageUri(line) {
+    const record = readStepSlots(line);
+    if (record === null)
+        throw new Error('Unreadable IFC image during appearance cleanup; resources were retained.');
+    const argument = record.slots[5];
+    if (argument === undefined)
+        return undefined;
+    const value = parseStepValue(argument.trim());
+    return typeof value === 'string' ? value : undefined;
+}
+//# sourceMappingURL=effective-appearance-record.js.map

package/dist/effective-appearance-record.js.map

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

package/dist/ifc5-appearance.d.ts

@@ -0,0 +1,20 @@
+import type { MeshData } from '@ifc-lite/geometry';
+import { type IfcxNode, type IfcxEncodedImage } from '@ifc-lite/ifcx';
+/** Packs canonical mesh fragments without evaluating styles or changing UV mappings. */
+export declare class Ifc5AppearanceWriter {
+    private readonly occupiedPaths;
+    private readonly originals?;
+    readonly images: IfcxNode[];
+    private readonly imagePaths;
+    private readonly sourcePaths;
+    private imageBytes;
+    private nextFragment;
+    constructor(occupiedPaths: Set<string>, originals?: ReadonlyMap<string, IfcxEncodedImage> | undefined);
+    private uniquePath;
+    private image;
+    fragments(owner: IfcxNode, meshes: MeshData[], convert: (mesh: MeshData) => {
+        points: number[][];
+        faceVertexIndices: number[];
+    }): IfcxNode[];
+}
+//# sourceMappingURL=ifc5-appearance.d.ts.map

package/dist/ifc5-appearance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ifc5-appearance.d.ts","sourceRoot":"","sources":["../src/ifc5-appearance.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAgD,KAAK,QAAQ,EAAmB,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAErI,wFAAwF;AACxF,qBAAa,oBAAoB;IAOnB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAAe,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;IANpF,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAM;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA8C;IAC1E,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,YAAY,CAAK;gBAEI,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,EAAmB,SAAS,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,YAAA;IAE3H,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,KAAK;IA2Cb,SAAS,CACP,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE,QAAQ,EAAE,EAClB,OAAO,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK;QAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;QAAC,iBAAiB,EAAE,MAAM,EAAE,CAAA;KAAE,GAC/E,QAAQ,EAAE;CA0Bd"}

package/dist/ifc5-appearance.js

@@ -0,0 +1,106 @@
+/* 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 { encodeIfcxImage, IFCX_APPEARANCE, IFCX_IMAGE } from '@ifc-lite/ifcx';
+/** Packs canonical mesh fragments without evaluating styles or changing UV mappings. */
+export class Ifc5AppearanceWriter {
+    occupiedPaths;
+    originals;
+    images = [];
+    imagePaths = new Map();
+    sourcePaths = new WeakMap();
+    imageBytes = 0;
+    nextFragment = 0;
+    constructor(occupiedPaths, originals) {
+        this.occupiedPaths = occupiedPaths;
+        this.originals = originals;
+    }
+    uniquePath(proposed) {
+        let path = proposed;
+        for (let suffix = 1; this.occupiedPaths.has(path); suffix++)
+            path = `${proposed}-${suffix}`;
+        this.occupiedPaths.add(path);
+        return path;
+    }
+    image(mesh) {
+        const source = mesh.texture?.rgba ?? mesh.textureBitmap;
+        if (!source)
+            throw new Error('Cannot export an unresolved IFCX texture. Load its image before exporting.');
+        const dimensions = mesh.texture ?? mesh.textureBitmap;
+        const dimensionKey = `${dimensions.width}x${dimensions.height}`;
+        const original = (mesh.textureRef ? this.originals?.get(mesh.textureRef.url) : undefined)
+            ?? mesh.texture?.original;
+        const cached = !original && this.sourcePaths.get(source)?.get(dimensionKey);
+        if (cached)
+            return cached;
+        let pixels;
+        if (mesh.texture) {
+            pixels = mesh.texture;
+        }
+        else {
+            const bitmap = mesh.textureBitmap;
+            if (typeof OffscreenCanvas === 'undefined') {
+                throw new Error('IFCX bitmap export requires OffscreenCanvas; headless callers can supply decoded MeshData.texture pixels.');
+            }
+            if (bitmap.width < 1 || bitmap.height < 1 || bitmap.width > 16_384 || bitmap.height > 16_384
+                || bitmap.width * bitmap.height * 4 > 512 * 1024 * 1024)
+                throw new Error('IFCX texture exceeds the image budget.');
+            const canvas = new OffscreenCanvas(bitmap.width, bitmap.height);
+            const context = canvas.getContext('2d');
+            if (!context)
+                throw new Error('Unable to read the IFCX texture bitmap.');
+            context.drawImage(bitmap, 0, 0);
+            const data = context.getImageData(0, 0, bitmap.width, bitmap.height).data;
+            pixels = { width: bitmap.width, height: bitmap.height,
+                rgba: new Uint8Array(data.buffer, data.byteOffset, data.byteLength), repeatS: false, repeatT: false };
+        }
+        if (original)
+            pixels = { ...pixels, original };
+        const encoded = encodeIfcxImage(pixels);
+        let path = this.imagePaths.get(encoded.key);
+        if (!path) {
+            if (this.imageBytes + (pixels.rgba.length + (pixels.original?.bytes.length ?? 0)) > 512 * 1024 * 1024)
+                throw new Error('IFCX images exceed the 512 MiB file pixel budget.');
+            this.imageBytes += pixels.rgba.length + (pixels.original?.bytes.length ?? 0);
+            path = this.uniquePath(`ifclite-image-${encoded.key}`);
+            this.imagePaths.set(encoded.key, path);
+            this.images.push({ path, attributes: { [IFCX_IMAGE]: encoded.value } });
+        }
+        let sourcePaths = this.sourcePaths.get(source);
+        if (!sourcePaths)
+            this.sourcePaths.set(source, sourcePaths = new Map());
+        if (!original)
+            sourcePaths.set(dimensionKey, path);
+        return path;
+    }
+    fragments(owner, meshes, convert) {
+        const children = owner.children ??= {};
+        return meshes.map((mesh, index) => {
+            const path = this.uniquePath(`ifclite-mesh-${this.nextFragment++}`);
+            let name = `Appearance ${index + 1}`;
+            while (Object.hasOwn(children, name))
+                name += '_';
+            children[name] = path;
+            const [r, g, b, a] = mesh.color;
+            const attributes = {
+                'usd::usdgeom::mesh': convert(mesh),
+                'bsi::ifc::presentation::diffuseColor': [r, g, b],
+                'bsi::ifc::presentation::opacity': a,
+            };
+            const sampler = mesh.texture ?? mesh.textureRef;
+            if (sampler) {
+                if (typeof sampler.repeatS !== 'boolean' || typeof sampler.repeatT !== 'boolean')
+                    throw new Error('IFCX texture sampler wraps must be boolean.');
+                if (!mesh.uvs || mesh.uvs.length !== mesh.positions.length / 3 * 2
+                    || !mesh.uvs.every(Number.isFinite))
+                    throw new Error('Cannot export IFCX texture without a finite UV pair per vertex.');
+                attributes[IFCX_APPEARANCE] = {
+                    image: { ref: this.image(mesh) }, uvs: Array.from(mesh.uvs),
+                    repeatS: sampler.repeatS, repeatT: sampler.repeatT,
+                };
+            }
+            return { path, attributes };
+        });
+    }
+}
+//# sourceMappingURL=ifc5-appearance.js.map

package/dist/ifc5-appearance.js.map

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

package/dist/ifc5-export-helpers.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Property names that have official IFC5 schema definitions in prop@v5a.ifcx.
+ * Source: https://github.com/buildingSMART/ifcx.dev/blob/main/@standards.buildingsmart.org/ifc/core/prop@v5a.ifcx
+ *
+ * IFC4 properties NOT in this set (e.g. Reference, LoadBearing, ExtendToStructure)
+ * must be omitted from IFC5 export — the viewer reports "Missing schema" errors for them.
+ *
+ * Name and Description are handled separately (always exported), so they're excluded here.
+ */
+export declare const IFC5_KNOWN_PROP_NAMES: Set<string>;
 /** IFCX node in output, matching the shape `collectRequiredImports` scans. */
 interface IfcxNodeOutputLike {
     attributes?: Record<string, unknown>;
@@ -28,5 +38,14 @@ export declare function generateUuid(id: number): string;
  * Uses the IFC type enum lookup for canonical casing (e.g. "IfcRelAggregates", not "Ifcrelaggregates").
  */
 export declare function stepTypeToClassName(stepType: string): string;
+/**
+ * The exported node path of an entity whose GlobalId is a namespaced path
+ * (#4444): a store reconstructed from a shared room keys its entities by room
+ * path, `/<slotId>/<GlobalId>`, and an exported file must not carry the
+ * room-internal slot. Removes `prefix` when the GlobalId is under it
+ * (`/m1/<GlobalId>` → `/<GlobalId>`); any other GlobalId is returned verbatim,
+ * so an owner's own STEP-parsed store (bare GlobalIds) is unaffected.
+ */
+export declare function stripNodePathPrefix(globalId: string, prefix: string | undefined): string;
 export {};
 //# sourceMappingURL=ifc5-export-helpers.d.ts.map

package/dist/ifc5-export-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ifc5-export-helpers.d.ts","sourceRoot":"","sources":["../src/ifc5-export-helpers.ts"],"names":[],"mappings":"AAWA,8EAA8E;AAC9E,UAAU,kBAAkB;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,qFAAqF;AACrF,eAAO,MAAM,mBAAmB;IAC9B,wGAAwG;;IAExG,wCAAwC;;IAExC,mFAAmF;;CAE3E,CAAC;AAEX;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,EAAE,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,CAmCrF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAU5D"}
+{"version":3,"file":"ifc5-export-helpers.d.ts","sourceRoot":"","sources":["../src/ifc5-export-helpers.ts"],"names":[],"mappings":"AAWA;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,aAkBhC,CAAC;AAEH,8EAA8E;AAC9E,UAAU,kBAAkB;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,qFAAqF;AACrF,eAAO,MAAM,mBAAmB;IAC9B,wGAAwG;;IAExG,wCAAwC;;IAExC,mFAAmF;;CAE3E,CAAC;AAEX;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,EAAE,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,CAmCrF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAU5D;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAGxF"}

package/dist/ifc5-export-helpers.js

@@ -6,6 +6,34 @@
  * keep ifc5-exporter.ts under its module-size budget; no behavior change.
  */
 import { IfcTypeEnumToString, IfcTypeEnumFromString } from '@ifc-lite/data';
+/**
+ * Property names that have official IFC5 schema definitions in prop@v5a.ifcx.
+ * Source: https://github.com/buildingSMART/ifcx.dev/blob/main/@standards.buildingsmart.org/ifc/core/prop@v5a.ifcx
+ *
+ * IFC4 properties NOT in this set (e.g. Reference, LoadBearing, ExtendToStructure)
+ * must be omitted from IFC5 export — the viewer reports "Missing schema" errors for them.
+ *
+ * Name and Description are handled separately (always exported), so they're excluded here.
+ */
+export const IFC5_KNOWN_PROP_NAMES = new Set([
+    'UsageType',
+    'TypeName',
+    'IsExternal',
+    'RefElevation',
+    'ElevationOfRefHeight',
+    'ElevationOfTerrain',
+    'NumberOfStoreys',
+    'Height',
+    'Width',
+    'Length',
+    'Depth',
+    'Volume',
+    'NetVolume',
+    'NetArea',
+    'NetSideArea',
+    'CrossSectionArea',
+    'Station',
+]);
 /** Standard IFC5 schema package URIs, keyed by the attribute prefix they provide. */
 export const IFCX_SCHEMA_IMPORTS = {
     /** Core IFC: bsi::ifc::class, bsi::ifc::presentation::*, bsi::ifc::material, bsi::ifc::spaceBoundary */
@@ -81,4 +109,17 @@ export function stepTypeToClassName(stepType) {
     }
     return stepType;
 }
+/**
+ * The exported node path of an entity whose GlobalId is a namespaced path
+ * (#4444): a store reconstructed from a shared room keys its entities by room
+ * path, `/<slotId>/<GlobalId>`, and an exported file must not carry the
+ * room-internal slot. Removes `prefix` when the GlobalId is under it
+ * (`/m1/<GlobalId>` → `/<GlobalId>`); any other GlobalId is returned verbatim,
+ * so an owner's own STEP-parsed store (bare GlobalIds) is unaffected.
+ */
+export function stripNodePathPrefix(globalId, prefix) {
+    if (!prefix || !globalId.startsWith(`${prefix}/`))
+        return globalId;
+    return globalId.slice(prefix.length);
+}
 //# sourceMappingURL=ifc5-export-helpers.js.map

package/dist/ifc5-export-helpers.js.map

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

package/dist/ifc5-exporter.d.ts

@@ -13,18 +13,11 @@
 import type { IfcDataStore } from '@ifc-lite/parser';
 import type { MutablePropertyView } from '@ifc-lite/mutations';
 import type { GeometryResult } from '@ifc-lite/geometry';
-/**
- * Property names that have official IFC5 schema definitions in prop@v5a.ifcx.
- * Source: https://github.com/buildingSMART/ifcx.dev/blob/main/@standards.buildingsmart.org/ifc/core/prop@v5a.ifcx
- *
- * IFC4 properties NOT in this set (e.g. Reference, LoadBearing, ExtendToStructure)
- * must be omitted from IFC5 export — the viewer reports "Missing schema" errors for them.
- *
- * Name and Description are handled separately (always exported), so they're excluded here.
- */
-export declare const IFC5_KNOWN_PROP_NAMES: Set<string>;
+import { type IfcxEncodedImage } from '@ifc-lite/ifcx';
 /** Options for IFC5 export */
 export interface Ifc5ExportOptions {
+    /** Original image bytes keyed by exact MeshTextureRef.url; retained in IFCX without recompression. */
+    textureSources?: ReadonlyMap<string, IfcxEncodedImage>;
     /** Author name */
     author?: string;
     /** Data version identifier */
@@ -51,6 +44,14 @@ export interface Ifc5ExportOptions {
      *  When true, relationship entities (IfcRel*), type objects, materials,
      *  and other non-spatial entities are excluded from the output. */
     onlyTreeEntities?: boolean;
+    /**
+     * A namespace prefix to remove from GlobalId-derived node paths (#4444). A
+     * store reconstructed from a shared room keys its entities by room path,
+     * `/<slotId>/<GlobalId>`; the slot is the room's namespace, not the
+     * model's, so the exported file carries `/<GlobalId>` — the same paths a
+     * single-model room exports. GlobalIds outside the prefix are untouched.
+     */
+    stripPathPrefix?: string;
 }
 /** Result of IFC5 export */
 export interface Ifc5ExportResult {
@@ -121,6 +122,7 @@ export declare class Ifc5Exporter {
      *   will NOT be emitted as a node (deleted, hidden, or outside the exported
      *   tree). Every step below is driven by it rather than by the deletion
      *   check alone, so the maps can never describe a node `export` never wrote.
+     * @param stripPathPrefix see {@link Ifc5ExportOptions.stripPathPrefix}.
      */
     private buildEntityMaps;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"ifc5-exporter.d.ts","sourceRoot":"","sources":["../src/ifc5-exporter.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAY,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAoBnE;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,aAkBhC,CAAC;AAMH,8BAA8B;AAC9B,MAAM,WAAW,iBAAiB;IAChC,kBAAkB;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,yCAAyC;IACzC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gEAAgE;IAChE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,wCAAwC;IACxC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,mCAAmC;IACnC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2CAA2C;IAC3C,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,kEAAkE;IAClE,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACvC;;yEAEqE;IACrE,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;uEAEmE;IACnE,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,4BAA4B;AAC5B,MAAM,WAAW,gBAAgB;IAC/B,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB;IACjB,KAAK,EAAE;QACL,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AA4BD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,cAAc,CAAwB;IAC9C,OAAO,CAAC,QAAQ,CAAS;IACzB,6EAA6E;IAC7E,OAAO,CAAC,UAAU,CAA6B;IAC/C,yEAAyE;IACzE,OAAO,CAAC,gBAAgB,CAA6B;IACrD,0CAA0C;IAC1C,OAAO,CAAC,WAAW,CAA6B;IAChD;;;;;;OAMG;IACH,OAAO,CAAC,UAAU,CAA2C;IAC7D;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,iBAAiB,CAAqB;gBAG5C,SAAS,EAAE,YAAY,EACvB,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI,EACtC,YAAY,CAAC,EAAE,mBAAmB,EAClC,QAAQ,CAAC,EAAE,MAAM;IAQnB;;OAEG;IACH,MAAM,CAAC,OAAO,GAAE,iBAAsB,GAAG,gBAAgB;IA2NzD,yDAAyD;IACzD,OAAO,CAAC,eAAe;IAYvB;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,eAAe;IAqJvB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA8B9B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAoB5B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAiC5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAkBvB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IA+CxB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IA2B1B;;OAEG;IACH,OAAO,CAAC,eAAe;CAsBxB"}
+{"version":3,"file":"ifc5-exporter.d.ts","sourceRoot":"","sources":["../src/ifc5-exporter.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAY,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAUnE,OAAO,EAA2B,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAsBhF,8BAA8B;AAC9B,MAAM,WAAW,iBAAiB;IAChC,sGAAsG;IACtG,cAAc,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACvD,kBAAkB;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,yCAAyC;IACzC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gEAAgE;IAChE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,wCAAwC;IACxC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,mCAAmC;IACnC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2CAA2C;IAC3C,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,kEAAkE;IAClE,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACvC;;yEAEqE;IACrE,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;uEAEmE;IACnE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,4BAA4B;AAC5B,MAAM,WAAW,gBAAgB;IAC/B,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB;IACjB,KAAK,EAAE;QACL,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AA4BD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,cAAc,CAAwB;IAC9C,OAAO,CAAC,QAAQ,CAAS;IACzB,6EAA6E;IAC7E,OAAO,CAAC,UAAU,CAA6B;IAC/C,yEAAyE;IACzE,OAAO,CAAC,gBAAgB,CAA6B;IACrD,0CAA0C;IAC1C,OAAO,CAAC,WAAW,CAA6B;IAChD;;;;;;OAMG;IACH,OAAO,CAAC,UAAU,CAA2C;IAC7D;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,iBAAiB,CAAqB;gBAG5C,SAAS,EAAE,YAAY,EACvB,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI,EACtC,YAAY,CAAC,EAAE,mBAAmB,EAClC,QAAQ,CAAC,EAAE,MAAM;IAQnB;;OAEG;IACH,MAAM,CAAC,OAAO,GAAE,iBAAsB,GAAG,gBAAgB;IAmOzD,yDAAyD;IACzD,OAAO,CAAC,eAAe;IAYvB;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,eAAe;IAqJvB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA8B9B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAoB5B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAiC5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAkBvB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IA+CxB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IA2B1B;;OAEG;IACH,OAAO,CAAC,eAAe;CAsBxB"}

package/dist/ifc5-exporter.js

@@ -4,37 +4,11 @@
 import { IfcTypeEnumToString, PropertyValueType, IFCX_VERSION, } from '@ifc-lite/data';
 import { convertEntityType } from './schema-converter.js';
 import { getEffectiveEntityIndex } from './effective-index.js';
+import { Ifc5AppearanceWriter } from './ifc5-appearance.js';
+import { IFCX_APPEARANCE_SCHEMAS } from '@ifc-lite/ifcx';
 import { buildMaterialAttribute } from './ifc5-material.js';
-import { collectRequiredImports, generateUuid, stepTypeToClassName } from './ifc5-export-helpers.js';
+import { collectRequiredImports, generateUuid, IFC5_KNOWN_PROP_NAMES, stepTypeToClassName, stripNodePathPrefix, } from './ifc5-export-helpers.js';
 import { addClassificationAttribute } from './ifc5-classification.js';
-/**
- * Property names that have official IFC5 schema definitions in prop@v5a.ifcx.
- * Source: https://github.com/buildingSMART/ifcx.dev/blob/main/@standards.buildingsmart.org/ifc/core/prop@v5a.ifcx
- *
- * IFC4 properties NOT in this set (e.g. Reference, LoadBearing, ExtendToStructure)
- * must be omitted from IFC5 export — the viewer reports "Missing schema" errors for them.
- *
- * Name and Description are handled separately (always exported), so they're excluded here.
- */
-export const IFC5_KNOWN_PROP_NAMES = new Set([
-    'UsageType',
-    'TypeName',
-    'IsExternal',
-    'RefElevation',
-    'ElevationOfRefHeight',
-    'ElevationOfTerrain',
-    'NumberOfStoreys',
-    'Height',
-    'Width',
-    'Length',
-    'Depth',
-    'Volume',
-    'NetVolume',
-    'NetArea',
-    'NetSideArea',
-    'CrossSectionArea',
-    'Station',
-]);
 // ============================================================================
 // Exporter
 // ============================================================================
@@ -111,9 +85,10 @@ export class Ifc5Exporter {
             || (visibleIds !== null && !visibleIds.has(id))
             || (treeIds !== null && !treeIds.has(id));
         // Build UUID paths and child-name maps from spatial hierarchy
-        this.buildEntityMaps(isOmitted);
+        this.buildEntityMaps(isOmitted, options.stripPathPrefix);
         // Build mesh lookup by expressId
         const meshByEntity = this.buildMeshLookup(options);
+        const appearance = new Ifc5AppearanceWriter(new Set(this.entityUuids.values()), options.textureSources);
         // Collect nodes
         const nodes = [];
         /** expressIds that actually became nodes — the root node may only point at these. */
@@ -184,15 +159,21 @@ export class Ifc5Exporter {
             if (options.includeGeometry !== false) {
                 const meshes = meshByEntity.get(expressId);
                 if (meshes && meshes.length > 0) {
-                    const usdMesh = this.convertToUsdMesh(meshes);
-                    attributes['usd::usdgeom::mesh'] = usdMesh;
-                    // Color/presentation
-                    const [r, g, b, a] = meshes[0].color;
-                    attributes['bsi::ifc::presentation::diffuseColor'] = [r, g, b];
-                    if (a < 1.0) {
-                        attributes['bsi::ifc::presentation::opacity'] = a;
+                    if (meshes.some((mesh) => mesh.texture || mesh.textureRef)) {
+                        nodes.push(...appearance.fragments(node, meshes, (mesh) => this.convertToUsdMesh([mesh])));
+                        meshCount += meshes.length;
+                    }
+                    else {
+                        const usdMesh = this.convertToUsdMesh(meshes);
+                        attributes['usd::usdgeom::mesh'] = usdMesh;
+                        // Color/presentation
+                        const [r, g, b, a] = meshes[0].color;
+                        attributes['bsi::ifc::presentation::diffuseColor'] = [r, g, b];
+                        if (a < 1.0) {
+                            attributes['bsi::ifc::presentation::opacity'] = a;
+                        }
+                        meshCount++;
                     }
-                    meshCount++;
                 }
             }
             if (Object.keys(attributes).length > 0)
@@ -238,6 +219,7 @@ export class Ifc5Exporter {
                 attributes: {},
             });
         }
+        nodes.push(...appearance.images);
         // Determine required imports by scanning which attribute namespaces are used
         const imports = collectRequiredImports(nodes);
         // Assemble IFCX file
@@ -250,7 +232,7 @@ export class Ifc5Exporter {
                 timestamp: new Date().toISOString(),
             },
             imports,
-            schemas: {},
+            schemas: appearance.images.length ? IFCX_APPEARANCE_SCHEMAS : {},
             data: nodes,
         };
         const content = options.prettyPrint !== false
@@ -291,8 +273,9 @@ export class Ifc5Exporter {
      *   will NOT be emitted as a node (deleted, hidden, or outside the exported
      *   tree). Every step below is driven by it rather than by the deletion
      *   check alone, so the maps can never describe a node `export` never wrote.
+     * @param stripPathPrefix see {@link Ifc5ExportOptions.stripPathPrefix}.
      */
-    buildEntityMaps(isOmitted) {
+    buildEntityMaps(isOmitted, stripPathPrefix) {
         const { spatialHierarchy, entities, strings } = this.dataStore;
         // --- 1. Assign UUID paths ---
         // An omitted entity gets no UUID entry. `getChildrenForEntity`'s `addChild`
@@ -308,7 +291,7 @@ export class Ifc5Exporter {
                 continue;
             // Use IFC GlobalId if available, otherwise generate a deterministic UUID
             const globalId = strings.get(entities.globalId[i]);
-            this.entityUuids.set(id, globalId || generateUuid(id));
+            this.entityUuids.set(id, globalId ? stripNodePathPrefix(globalId, stripPathPrefix) : generateUuid(id));
         }
         // --- 2. Build parent→children and spatial maps ---
         const parentOf = new Map();