@ifc-lite/parser 3.15.0 → 4.0.0

package/dist/source-bytes.js

@@ -0,0 +1,390 @@
+/* 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/. */
+/**
+ * The IFC source bytes, behind an accessor instead of a bare `Uint8Array`.
+ *
+ * Why this exists (#2183). `IfcDataStore.source` is the whole file, kept
+ * resident for the lifetime of the model because on-demand property and
+ * attribute reads slice it synchronously — during React render, in eight
+ * separate chains. On a 342 MB model that is 327 MB of the ~671 MB the
+ * viewer's main thread holds, and it is the single largest resident.
+ *
+ * The contract "here are all the bytes, contiguous, resident forever" is what
+ * blocks any cheaper representation. Replacing it with "ask for the range you
+ * need" makes every whole-file consumer visible, which is a property you
+ * cannot retrofit later, and it is the precondition for storing the source
+ * compressed in blocks.
+ *
+ * The accessor starts resident (`slice` is a `subarray`, no copy) and can
+ * switch to block-compressed storage IN PLACE via `compressInPlace`. See
+ * {@link MutableSourceBytes} for why in place rather than by replacement --
+ * that detail is the difference between a real saving and a silent no-op.
+ *
+ * Design notes that are load-bearing rather than stylistic:
+ *
+ *   - `length` is an alias of `byteLength`. It exists so the ~79 existing
+ *     `!store.source?.length` guards keep compiling AND keep meaning exactly
+ *     what they mean today. Two of them are semantic discriminators, not
+ *     defensive noise: `packages/ids/src/bridge/properties.ts` uses
+ *     source-presence to mean "WASM store, not server store", and
+ *     `material-resolver.ts` uses it to decide cache safety. Do not add new
+ *     uses; prefer `byteLength`.
+ *   - `byteLength === 0` is a real, supported state, not an error. Server
+ *     parsed stores, synthetic stores, GLB and point-cloud models all have no
+ *     source. {@link EMPTY_SOURCE_BYTES} models it.
+ *   - `contentKey` is computed lazily and memoised. It replaces two
+ *     hand-rolled hashes in the viewer, one of which walks the whole file on
+ *     every call and one of which keys a cache on `byteLength` alone (and so
+ *     collides across same-size models).
+ */
+import { safeUtf8Decode } from '@ifc-lite/data';
+import { BlockStore } from './block-store.js';
+/** FNV-1a over the whole buffer. Matches the viewer's existing source hash. */
+function fnv1a(bytes) {
+    let h = 0x811c9dc5;
+    for (let i = 0; i < bytes.length; i++) {
+        h ^= bytes[i];
+        h = Math.imul(h, 0x01000193);
+    }
+    return `${bytes.length.toString(16)}-${(h >>> 0).toString(16)}`;
+}
+/**
+ * Clamp a half-open range to `[0, len]`, tolerating reversed or wild input.
+ *
+ * Only NaN falls back to 0. Infinities are truncated and clamped like any
+ * other out-of-range number, so `decodeUtf8(2, Infinity)` means "to the end"
+ * rather than the empty string — a caller expressing an open upper bound that
+ * way should get the remainder, not silence.
+ */
+function clampRange(start, end, len) {
+    const clamp = (v) => Number.isNaN(v) ? 0 : Math.max(0, Math.min(Math.trunc(v), len));
+    const s = clamp(start);
+    const e = clamp(end);
+    return e < s ? [s, s] : [s, e];
+}
+/**
+ * The source accessor. Starts resident and can switch to block-compressed
+ * storage IN PLACE.
+ *
+ * In place, not by replacement, and this is not a style choice (#2183):
+ * `attachDataStoreAccessors` captures this object in a `BufferEntitySource`
+ * whose `EntityExtractor` holds it for the store's lifetime, so `getEntity`
+ * would keep reading the old resident view after a replacement -- the original
+ * buffer would stay alive and the memory win would be exactly zero, silently.
+ * Worse, `getProperties` goes through `extractPropertiesOnDemand`, which
+ * constructs a fresh extractor from `store.source` on EVERY call, so a
+ * replacement would split-brain the store: properties served from the
+ * compressed source, entities from the resident one, both retained.
+ *
+ * Mutating the single shared instance makes every holder -- the captured
+ * extractors, the hook closures, the partial and final stores that already
+ * share one accessor by design -- observe the switch through object identity.
+ * The whole class of stale-holder bugs cannot arise.
+ */
+class MutableSourceBytes {
+    /** Non-null exactly while resident. */
+    #view;
+    /** Non-null exactly while compressed. Never both. */
+    #blocks = null;
+    /**
+     * Depth of open {@link withMaterialized} windows, and the buffer they share.
+     *
+     * Only meaningful while compressed: a resident `withMaterialized` hands out
+     * the real view and needs no window at all.
+     */
+    #windowDepth = 0;
+    #window = null;
+    /**
+     * `undefined` = not computed yet, `string` = computed. Never `null` for a
+     * non-empty source: the constructor no longer accepts one, so the state
+     * "permanently keyed on nothing" -- which reads downstream as an overlay
+     * silently not rendering -- is unrepresentable rather than merely unused.
+     */
+    #contentKey;
+    constructor(view, contentKey) {
+        this.#view = view;
+        this.#contentKey = contentKey;
+    }
+    get isResident() { return this.#view !== null; }
+    get byteLength() {
+        return this.#view !== null ? this.#view.byteLength : this.#blocks.totalLength;
+    }
+    get length() { return this.byteLength; }
+    /** Compressed-storage stats, or null while resident. For the dev counter. */
+    get blockStats() {
+        if (this.#blocks === null)
+            return null;
+        return {
+            stored: this.#blocks.storedBytes,
+            resident: this.#blocks.residentBytes,
+            counters: this.#blocks.counters,
+        };
+    }
+    /**
+     * Switch to compressed storage, dropping the resident buffer.
+     *
+     * Synchronous and single-assignment, so no read can observe a torn state: a
+     * read either precedes the switch and sees the view, or follows it and
+     * inflates. Idempotent -- a second call is a no-op rather than a re-compress.
+     *
+     * Safe to call inside a `withMaterialized` callback. That callback holds a
+     * real `Uint8Array` reference, which stays valid and correct after the
+     * switch; it simply stops being the source's storage, and the buffer becomes
+     * collectable when the callback returns. (An earlier draft deferred the
+     * switch until the window closed. That branch was unreachable: window depth
+     * only rises while compressed, and this method returns early when compressed.
+     * Unreachable safety machinery is worse than none -- it reads as a handled
+     * case.)
+     */
+    compressInPlace(payload) {
+        // Length checked BEFORE the already-compressed short-circuit. Checking it
+        // after would skip validation exactly when a caller is confused enough to
+        // compress twice with two different payloads.
+        if (payload.totalLength !== this.byteLength) {
+            throw new Error(`compressInPlace: payload is ${payload.totalLength} bytes but the source is `
+                + `${this.byteLength}; refusing to swap in bytes that are not this source`);
+        }
+        if (this.#view === null)
+            return;
+        if (payload.totalLength !== this.#view.byteLength) {
+            throw new Error(`compressInPlace: payload is ${payload.totalLength} bytes but the source is `
+                + `${this.#view.byteLength}; refusing to swap in bytes that are not this source`);
+        }
+        this.#applyCompression(payload);
+    }
+    /**
+     * Adopt already-compressed blocks, for rebuilding a source that crossed a
+     * thread boundary. Distinct from {@link compressInPlace}, which starts from
+     * resident bytes and must guard that the payload describes THIS source;
+     * here there are no bytes to check against.
+     */
+    adoptBlocks(payload) {
+        this.#contentKey ??= payload.contentKey;
+        this.#blocks = new BlockStore(payload);
+        this.#view = null;
+    }
+    #applyCompression(payload) {
+        // Take the key from the payload: it was computed while the bytes were
+        // contiguous, which is the only cheap moment. Never recompute after.
+        this.#contentKey ??= payload.contentKey;
+        this.#blocks = new BlockStore(payload);
+        this.#view = null;
+    }
+    get contentKey() {
+        // Lazy while resident: only the callers that key a cache on identity pay
+        // for it, and they pay once. Nothing on the load path needs it.
+        //
+        // Always a string, never null: `contiguousSourceBytes` collapses a
+        // zero-length view to EMPTY_SOURCE_BYTES, so this is non-empty by
+        // construction and the "no source" key has nowhere to appear.
+        //
+        // Once compressed it is always already set -- compressInPlace takes it
+        // from the payload -- so this never inflates anything to hash it.
+        this.#contentKey ??= fnv1a(this.#view);
+        return this.#contentKey;
+    }
+    slice(start, end) {
+        const [s, e] = clampRange(start, end, this.byteLength);
+        if (this.#view !== null)
+            return this.#view.subarray(s, e);
+        return this.#blocks.read(s, e);
+    }
+    decodeUtf8(start, end) {
+        const [s, e] = clampRange(start, end, this.byteLength);
+        if (e === s)
+            return '';
+        if (this.#view !== null) {
+            // SAB-safe: the source is usually SharedArrayBuffer-backed, which raw
+            // `TextDecoder.decode` rejects.
+            return safeUtf8Decode(this.#view, s, e);
+        }
+        return this.#blocks.decodeUtf8(s, e);
+    }
+    /**
+     * While compressed this inflates the WHOLE source (~1.8 s and 343 MB on the
+     * reference model), so prefer {@link withMaterialized}, which at least
+     * scopes the buffer and shares it between nested calls.
+     *
+     * The result MAY BE SHARED: while resident it is the accessor's own view,
+     * and inside an open materialization window it is that window's buffer, so
+     * two callers can hold the same array. Treat it as read-only.
+     */
+    materialize() {
+        if (this.#view !== null)
+            return this.#view;
+        return this.#window ?? this.#blocks.materialize();
+    }
+    withMaterialized(fn) {
+        if (this.#view !== null)
+            return fn(this.#view);
+        this.#openWindow();
+        try {
+            return fn(this.#window);
+        }
+        finally {
+            this.#closeWindow();
+        }
+    }
+    async withMaterializedAsync(fn) {
+        if (this.#view !== null)
+            return fn(this.#view);
+        this.#openWindow();
+        try {
+            return await fn(this.#window);
+        }
+        finally {
+            this.#closeWindow();
+        }
+    }
+    /**
+     * Inflate once for the duration of a callback. Nested windows share the one
+     * buffer, so two overlapping consumers do not each allocate the whole file.
+     */
+    #openWindow() {
+        if (this.#windowDepth === 0)
+            this.#window = this.#blocks.materialize();
+        this.#windowDepth++;
+    }
+    #closeWindow() {
+        this.#windowDepth--;
+        if (this.#windowDepth === 0)
+            this.#window = null;
+    }
+    toTransferable() {
+        // Deliberately reads the memo FIELD, not the getter. This method exists to
+        // hand a source to a worker without paying whole-file costs on the sending
+        // thread, and `contentKey` is a full-file FNV-1a walk -- forcing it here
+        // would make the documented "without materialising" path allocate and walk
+        // the whole 342 MB source on the main thread, which is what #2183 is about.
+        // Pass the key on only when something has already computed it; a receiver
+        // that needs one computes it lazily, on its own thread, to the same value.
+        if (this.#view !== null) {
+            return { kind: 'contiguous', bytes: this.#view, contentKey: this.#contentKey ?? null };
+        }
+        // Compressed: post the BLOCKS, not the inflated file -- 67 MB instead of
+        // 343 MB on the reference model, and the receiving thread does any
+        // inflating. The key is always known by now (compressInPlace took it from
+        // the payload), which is why the blocked arm declares it required.
+        return { kind: 'blocked', ...this.#blocks.toPayload(), contentKey: this.contentKey };
+    }
+}
+/**
+ * The no-source state, shared. Frozen and stateless, so it is safe to hand the
+ * same instance to every store that has no bytes.
+ */
+class EmptySourceBytes {
+    byteLength = 0;
+    length = 0;
+    isResident = true;
+    contentKey = null;
+    // A FRESH array each call: callers occasionally write into what they get
+    // back, and a shared mutable empty would couple them.
+    slice() { return new Uint8Array(0); }
+    decodeUtf8() { return ''; }
+    materialize() { return new Uint8Array(0); }
+    withMaterialized(fn) { return fn(new Uint8Array(0)); }
+    withMaterializedAsync(fn) {
+        return fn(new Uint8Array(0));
+    }
+    toTransferable() {
+        return { kind: 'contiguous', bytes: new Uint8Array(0), contentKey: null };
+    }
+}
+/** The canonical "this model has no source" value. */
+export const EMPTY_SOURCE_BYTES = Object.freeze(new EmptySourceBytes());
+/**
+ * Wrap a resident buffer. Zero-copy: `slice` returns views into `view`.
+ *
+ * Pass `contentKey` when it is already known (e.g. carried across a worker
+ * boundary or a compression swap) so downstream caches do not invalidate.
+ */
+export function contiguousSourceBytes(view, contentKey) {
+    if (!view || view.byteLength === 0)
+        return EMPTY_SOURCE_BYTES;
+    return new MutableSourceBytes(view, contentKey);
+}
+/**
+ * Rebuild a source from {@link IfcSourceBytes.toTransferable} output.
+ *
+ * `contentKey: null` on the wire means "the sender had not computed one", NOT
+ * "the key is null" -- `toTransferable` deliberately does not force the
+ * full-file hash. So it maps to `undefined` here, which is the constructor's
+ * "not computed yet" state, and the receiver hashes lazily on its own thread if
+ * anything asks. Passing the `null` straight through would pin the key at null
+ * forever and every downstream cache would key on nothing.
+ *
+ * A non-empty source cannot legitimately have a null key: `fnv1a` always
+ * returns a string, and a zero-length view collapses to
+ * {@link EMPTY_SOURCE_BYTES} before it can reach a constructor.
+ *
+ * CONSTRAINT FOR THE BLOCKED IMPLEMENTATION. A contiguous receiver can shrug
+ * off a missing key because recomputing it is one linear pass over bytes it
+ * already holds. A blocked one cannot -- it would have to inflate every block
+ * to hash them. So the compression swap must compute and carry `contentKey`
+ * EAGERLY, at swap time, while the bytes are still contiguous. Inheriting the
+ * lazy contiguous behaviour there would turn the first cache lookup into a
+ * full decompression of the model.
+ */
+export function sourceBytesFromTransferable(transfer) {
+    if (transfer.kind === 'contiguous') {
+        return contiguousSourceBytes(transfer.bytes, transfer.contentKey ?? undefined);
+    }
+    // A blocked source rebuilds without inflating anything: the receiver gets
+    // the compressed blocks and pays only for the ranges it actually reads.
+    const rebuilt = new MutableSourceBytes(new Uint8Array(0), transfer.contentKey);
+    rebuilt.adoptBlocks(transfer);
+    return rebuilt;
+}
+/**
+ * Switch a source to block-compressed storage, in place.
+ *
+ * Returns true when the source is now compressed (or already was), false when
+ * this build cannot swap it (an empty source, or one that is not the mutable
+ * accessor). THROWS when the payload does not describe these bytes -- swapping
+ * in a different source's blocks would corrupt every subsequent read silently,
+ * which is worth a crash rather than a `false` a caller might ignore.
+ *
+ * Exported as a function rather than a method on `IfcSourceBytes`
+ * deliberately: consumers must never see a source that can change shape under
+ * them, so the capability lives with whoever owns the load, not on the read
+ * interface every hook holds.
+ */
+export function compressSourceInPlace(source, payload) {
+    if (!(source instanceof MutableSourceBytes))
+        return false;
+    source.compressInPlace(payload);
+    return true;
+}
+/** Compressed-storage stats for the dev counter, or null while resident. */
+export function sourceBlockStats(source) {
+    return source instanceof MutableSourceBytes ? source.blockStats : null;
+}
+/**
+ * Narrowing helper for the call sites that accept either shape.
+ *
+ * Checks every member EXCEPT `contentKey`, deliberately: that is a lazy getter
+ * which hashes the whole file on first read, and this predicate runs inside
+ * `asSourceBytes` — i.e. in the `EntityExtractor` constructor. Probing it here
+ * would turn a type check into a full-file scan.
+ */
+export function isSourceBytes(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const s = value;
+    return (typeof s.byteLength === 'number'
+        && typeof s.length === 'number'
+        && typeof s.isResident === 'boolean'
+        && typeof s.slice === 'function'
+        && typeof s.decodeUtf8 === 'function'
+        && typeof s.materialize === 'function'
+        && typeof s.withMaterialized === 'function'
+        && typeof s.withMaterializedAsync === 'function'
+        && typeof s.toTransferable === 'function');
+}
+/** Accept either shape and normalise. Lets a helper widen without its callers
+ *  changing, which is what keeps the migration diff small. */
+export function asSourceBytes(value) {
+    return isSourceBytes(value) ? value : contiguousSourceBytes(value);
+}
+//# sourceMappingURL=source-bytes.js.map

package/dist/source-bytes.js.map

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

package/dist/source-compress.d.ts

@@ -0,0 +1,37 @@
+import { type BlockedPayload } from './block-store.js';
+export interface CompressedSource extends BlockedPayload {
+    /**
+     * FNV-1a over the whole source.
+     *
+     * Computed HERE, during the same pass, not lazily like the contiguous
+     * accessor's. A blocked source cannot hash itself without inflating
+     * everything, so the key has to be taken while the bytes are still
+     * contiguous -- which is why the `blocked` arm of `IfcSourceTransfer`
+     * declares it required rather than nullable.
+     */
+    contentKey: string;
+}
+/**
+ * Split `source` into fixed-size blocks and deflate each one.
+ *
+ * A block is stored verbatim when deflating it does not shrink it. STEP files
+ * embed already-compressed payloads (base64 textures, for one), and without
+ * this a pathological source could compress to LARGER than it started -- which
+ * would make the whole feature impossible to gate on size honestly.
+ */
+export declare function compressSource(source: Uint8Array, blockSize?: number): CompressedSource;
+/**
+ * Whether compressing `byteLength` is worth it.
+ *
+ * The win scales with size but the risk surface (LRU, stitching, the swap,
+ * a worker) is constant, so there is a floor below which this is all cost.
+ * The threshold is deliberately the size above which the viewer already stops
+ * persisting the source to IndexedDB: above it the source is always
+ * SharedArrayBuffer-backed, so handing it to the compression worker is
+ * zero-copy. Gating lower would drag in the IndexedDB-restore path, which
+ * would hand the worker a plain ArrayBuffer and pay a full structured clone
+ * on every cache restore.
+ */
+export declare const COMPRESSION_MIN_BYTES: number;
+export declare function shouldCompressSource(byteLength: number): boolean;
+//# sourceMappingURL=source-compress.d.ts.map

package/dist/source-compress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-compress.d.ts","sourceRoot":"","sources":["../src/source-compress.ts"],"names":[],"mappings":"AAcA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAY3E,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD;;;;;;;;OAQG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAYD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,UAAU,EAClB,SAAS,GAAE,MAA2B,GACrC,gBAAgB,CAoDlB;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,QAAoB,CAAC;AAEvD,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAEhE"}

package/dist/source-compress.js

@@ -0,0 +1,104 @@
+/* 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/. */
+/**
+ * Compress an IFC source into the blocks {@link BlockStore} reads (#2183).
+ *
+ * Kept as a plain function rather than living inside the worker so it is
+ * directly testable and so the swap can be exercised synchronously in tests
+ * without a Worker at all. The worker is a thin shell around this.
+ */
+import { deflateSync } from 'fflate';
+import { DEFAULT_BLOCK_SIZE } from './block-store.js';
+/**
+ * Deflate level.
+ *
+ * 6 rather than 4: measured on the reference model it costs ~1.2 s more of
+ * one-time worker CPU and returns 2 MB, and this runs off the main thread
+ * while the viewer is already interactive. Level 9 is not worth measuring --
+ * deflate's tail is famously poor value and the input is already at 19.7%.
+ */
+const DEFLATE_LEVEL = 6;
+/** Must match `fnv1a` in source-bytes.ts, or the key changes across a swap. */
+function fnv1a(bytes) {
+    let h = 0x811c9dc5;
+    for (let i = 0; i < bytes.length; i++) {
+        h ^= bytes[i];
+        h = Math.imul(h, 0x01000193);
+    }
+    return `${bytes.length.toString(16)}-${(h >>> 0).toString(16)}`;
+}
+/**
+ * Split `source` into fixed-size blocks and deflate each one.
+ *
+ * A block is stored verbatim when deflating it does not shrink it. STEP files
+ * embed already-compressed payloads (base64 textures, for one), and without
+ * this a pathological source could compress to LARGER than it started -- which
+ * would make the whole feature impossible to gate on size honestly.
+ */
+export function compressSource(source, blockSize = DEFAULT_BLOCK_SIZE) {
+    // Integer, finite, positive. A fractional size corrupts silently rather than
+    // failing: this function slices at `i * blockSize` (truncated by subarray)
+    // while BlockStore maps offsets with Math.floor(start / blockSize), so the
+    // two disagree and reads come back wrong with no error anywhere.
+    if (!Number.isInteger(blockSize) || blockSize <= 0) {
+        throw new Error(`compressSource: blockSize must be a positive integer, got ${blockSize}`);
+    }
+    const totalLength = source.byteLength;
+    const blockCount = Math.ceil(totalLength / blockSize);
+    const index = new Uint32Array(blockCount + 1);
+    const storedMask = new Uint8Array(blockCount);
+    const parts = [];
+    let written = 0;
+    for (let i = 0; i < blockCount; i++) {
+        const start = i * blockSize;
+        const raw = source.subarray(start, Math.min(start + blockSize, totalLength));
+        const deflated = deflateSync(raw, { level: DEFLATE_LEVEL });
+        index[i] = written;
+        if (deflated.byteLength < raw.byteLength) {
+            parts.push(deflated);
+            written += deflated.byteLength;
+        }
+        else {
+            // Verbatim. Copied, because `raw` is a view into the caller's buffer and
+            // the whole point is that the caller's buffer becomes collectable.
+            const copy = new Uint8Array(raw.byteLength);
+            copy.set(raw);
+            parts.push(copy);
+            storedMask[i] = 1;
+            written += copy.byteLength;
+        }
+    }
+    index[blockCount] = written;
+    const blocks = new Uint8Array(written);
+    let at = 0;
+    for (const part of parts) {
+        blocks.set(part, at);
+        at += part.byteLength;
+    }
+    return {
+        blocks,
+        index,
+        storedMask,
+        blockSize,
+        totalLength,
+        contentKey: fnv1a(source),
+    };
+}
+/**
+ * Whether compressing `byteLength` is worth it.
+ *
+ * The win scales with size but the risk surface (LRU, stitching, the swap,
+ * a worker) is constant, so there is a floor below which this is all cost.
+ * The threshold is deliberately the size above which the viewer already stops
+ * persisting the source to IndexedDB: above it the source is always
+ * SharedArrayBuffer-backed, so handing it to the compression worker is
+ * zero-copy. Gating lower would drag in the IndexedDB-restore path, which
+ * would hand the worker a plain ArrayBuffer and pay a full structured clone
+ * on every cache restore.
+ */
+export const COMPRESSION_MIN_BYTES = 150 * 1024 * 1024;
+export function shouldCompressSource(byteLength) {
+    return byteLength >= COMPRESSION_MIN_BYTES;
+}
+//# sourceMappingURL=source-compress.js.map

package/dist/source-compress.js.map

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

package/dist/source-header.d.ts

@@ -1,9 +1,20 @@
+/**
+ * Parse the ISO 10303-21 HEADER section of a STEP/IFC file into the structured
+ * {@link IfcSourceHeader} the exporter uses to round-trip header fidelity.
+ *
+ * This is deliberately a small, self-contained, quote-aware reader rather than
+ * a reuse of the generic STEP value parser: `FILE_DESCRIPTION` items and
+ * `FILE_NAME` fields routinely contain commas and parentheses inside quoted
+ * strings (e.g. `'CoordinateReference [..., ProjectSite: Origin]'`), which a
+ * splitter that ignores quote state would mis-split.
+ */
 import type { IfcSourceHeader } from '@ifc-lite/data';
+import { type IfcSourceBytes } from './source-bytes.js';
 /**
  * Parse the HEADER section of a STEP/IFC buffer into {@link IfcSourceHeader}.
  * Returns `undefined` when no recognisable header records are present (e.g.
  * non-STEP input). Cheap: only the first {@link MAX_HEADER_BYTES} are decoded,
  * truncated at the first `ENDSEC` so the DATA section is never scanned.
  */
-export declare function parseSourceHeader(buffer: Uint8Array): IfcSourceHeader | undefined;
+export declare function parseSourceHeader(buffer: Uint8Array | IfcSourceBytes): IfcSourceHeader | undefined;
 //# sourceMappingURL=source-header.d.ts.map

package/dist/source-header.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source-header.d.ts","sourceRoot":"","sources":["../src/source-header.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AA4LtD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,eAAe,GAAG,SAAS,CA0DjF"}
+{"version":3,"file":"source-header.d.ts","sourceRoot":"","sources":["../src/source-header.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGtD,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AA2LvE;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,UAAU,GAAG,cAAc,GAClC,eAAe,GAAG,SAAS,CA2D7B"}

package/dist/source-header.js

@@ -1,18 +1,8 @@
 /* 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/. */
-/**
- * Parse the ISO 10303-21 HEADER section of a STEP/IFC file into the structured
- * {@link IfcSourceHeader} the exporter uses to round-trip header fidelity.
- *
- * This is deliberately a small, self-contained, quote-aware reader rather than
- * a reuse of the generic STEP value parser: `FILE_DESCRIPTION` items and
- * `FILE_NAME` fields routinely contain commas and parentheses inside quoted
- * strings (e.g. `'CoordinateReference [..., ProjectSite: Origin]'`), which a
- * splitter that ignores quote state would mis-split.
- */
-import { safeUtf8Decode } from '@ifc-lite/data';
 import { decodeIfcString } from '@ifc-lite/encoding';
+import { asSourceBytes } from './source-bytes.js';
 /** Headers are tiny; cap the decode so a huge file's body is never scanned. */
 const MAX_HEADER_BYTES = 64 * 1024;
 /**
@@ -217,8 +207,9 @@ function extractRecordArgs(text, keyword, fromIndex = 0) {
  * truncated at the first `ENDSEC` so the DATA section is never scanned.
  */
 export function parseSourceHeader(buffer) {
-    const cap = Math.min(buffer.length, MAX_HEADER_BYTES);
-    let text = safeUtf8Decode(buffer, 0, cap);
+    const src = asSourceBytes(buffer);
+    const cap = Math.min(src.byteLength, MAX_HEADER_BYTES);
+    let text = src.decodeUtf8(0, cap);
     const endSec = text.toUpperCase().indexOf('ENDSEC');
     if (endSec >= 0)
         text = text.slice(0, endSec);

package/dist/source-header.js.map

@@ -1 +1 @@
-{"version":3,"file":"source-header.js","sourceRoot":"","sources":["../src/source-header.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"source-header.js","sourceRoot":"","sources":["../src/source-header.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAc/D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,aAAa,EAAuB,MAAM,mBAAmB,CAAC;AAEvE,+EAA+E;AAC/E,MAAM,gBAAgB,GAAG,EAAE,GAAG,IAAI,CAAC;AAEnC;;;;GAIG;AACH,SAAS,aAAa,CAAC,KAAa;IAClC,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,IAAI,EAAE,CAAC;YACd,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBACf,IAAI,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;oBACzB,OAAO,IAAI,GAAG,CAAC;oBACf,CAAC,EAAE,CAAC;gBACN,CAAC;qBAAM,CAAC;oBACN,QAAQ,GAAG,KAAK,CAAC;gBACnB,CAAC;YACH,CAAC;YACD,SAAS;QACX,CAAC;QACD,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACf,QAAQ,GAAG,IAAI,CAAC;YAChB,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;aAAM,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACpC,KAAK,EAAE,CAAC;YACR,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;aAAM,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACpC,KAAK,EAAE,CAAC;YACR,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;aAAM,IAAI,EAAE,KAAK,GAAG,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1B,OAAO,GAAG,EAAE,CAAC;QACf,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,SAAS,kBAAkB,CAAC,GAAW;IACrC,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACtC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,GAAG,GAAG,EAAE,CAAC,CAAC,kEAAkE;IAChF,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QACxB,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACtB,gEAAgE;YAChE,uEAAuE;YACvE,IAAI,KAAK,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC;gBACnE,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC3C,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;oBACf,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;oBAC/B,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;oBACZ,SAAS;gBACX,CAAC;YACH,CAAC;iBAAM,IAAI,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;gBAChE,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,yCAAyC;gBACvE,CAAC,IAAI,CAAC,CAAC;gBACP,SAAS;YACX,CAAC;iBAAM,IAAI,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC;gBACxC,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,uBAAuB;gBACrD,CAAC,IAAI,CAAC,CAAC;gBACP,SAAS;YACX,CAAC;iBAAM,IAAI,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrD,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC7B,CAAC,IAAI,CAAC,CAAC;gBACP,SAAS;YACX,CAAC;YACD,IAAI,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC1B,GAAG,IAAI,eAAe,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;gBACnC,GAAG,GAAG,EAAE,CAAC;gBACT,CAAC,IAAI,CAAC,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;QACD,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;QAChB,CAAC,IAAI,CAAC,CAAC;IACT,CAAC;IACD,OAAO,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,GAAW;IAClC,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACrB,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG;QAAE,OAAO,SAAS,CAAC;IACzD,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1D,OAAO,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;GAGG;AACH,SAAS,gBAAgB,CAAC,GAAW;IACnC,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACrB,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG;QAAE,OAAO,EAAE,CAAC;IAClD,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3C,0DAA0D;QAC1D,MAAM,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;QAClC,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;SACjC,GAAG,CAAC,eAAe,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;AACjD,CAAC;AAED;;;;GAIG;AACH,SAAS,iBAAiB,CAAC,IAAY,EAAE,OAAe,EAAE,SAAS,GAAG,CAAC;IACrE,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC7C,IAAI,EAAE,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACxB,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAC5B,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAAE,CAAC,EAAE,CAAC;IAClD,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,KAAK,GAAG,CAAC,CAAC;IAChB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACnB,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBACf,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG;oBAAE,CAAC,EAAE,CAAC;;oBACxB,QAAQ,GAAG,KAAK,CAAC;YACxB,CAAC;YACD,SAAS;QACX,CAAC;QACD,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACf,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;aAAM,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACtB,KAAK,EAAE,CAAC;QACV,CAAC;aAAM,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACtB,KAAK,EAAE,CAAC;YACR,IAAI,KAAK,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAmC;IAEnC,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;IACvD,IAAI,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpD,IAAI,MAAM,IAAI,CAAC;QAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAE9C,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;IAC/D,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACxD,MAAM,YAAY,GAAG,iBAAiB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAE5D,IAAI,UAAU,KAAK,IAAI,IAAI,UAAU,KAAK,IAAI,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QACxE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,wDAAwD;IACxD,IAAI,WAAW,GAAa,EAAE,CAAC;IAC/B,IAAI,mBAAmB,GAAG,KAAK,CAAC;IAChC,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;QACxC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;YAAE,WAAW,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAChE,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;YAAE,mBAAmB,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC;IAClF,CAAC;IAED,yDAAyD;IACzD,uEAAuE;IACvE,IAAI,IAAwB,CAAC;IAC7B,IAAI,SAA6B,CAAC;IAClC,IAAI,MAAM,GAAa,EAAE,CAAC;IAC1B,IAAI,YAAY,GAAa,EAAE,CAAC;IAChC,IAAI,mBAAuC,CAAC;IAC5C,IAAI,iBAAqC,CAAC;IAC1C,IAAI,aAAiC,CAAC;IACtC,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;QACxC,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACvC,SAAS,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5C,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1C,YAAY,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAChD,mBAAmB,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACtD,iBAAiB,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACpD,aAAa,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,qCAAqC;IACrC,MAAM,iBAAiB,GAAG,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEtF,OAAO;QACL,WAAW;QACX,mBAAmB;QACnB,IAAI;QACJ,SAAS;QACT,MAAM;QACN,YAAY;QACZ,mBAAmB;QACnB,iBAAiB;QACjB,aAAa;QACb,iBAAiB;KAClB,CAAC;AACJ,CAAC"}