@ifc-lite/pointcloud 0.11.0 → 0.13.0

package/dist/copc/copc-info.js.map

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

package/dist/copc/copc-reader.d.ts

@@ -0,0 +1,60 @@
+/**
+ * COPC reader (#6869): header + info VLR, hierarchy pages, and per-node
+ * decode over any `RangeByteSource` (a local File, or HTTP Range).
+ *
+ * Node data is one LAZ chunk per node, decompressed with laz-perf's
+ * `ChunkDecoder` and then decoded by the SAME `decodeLasPoints` the LAS and
+ * LAZ sources use, so PDRF 6/7/8 field layout, 8-bit RGB detection and the
+ * f64 `originOffset` subtraction (#1804) have exactly one implementation.
+ *
+ * The reader holds no hierarchy state: it reads and parses pages, and the
+ * owner (worker client, LOD driver, test) keeps the `CopcHierarchy`. That
+ * lets the reader live in the decode worker while the hierarchy lives with
+ * the LOD selection on the main thread.
+ */
+import { type LasHeader } from '../formats/las.js';
+import { type LazPerfModule } from '../streaming/laz-perf-loader.js';
+import type { RangeByteSource } from '../streaming/types.js';
+import type { DecodedPointChunk, PointCloudBBox } from '../types.js';
+import { type CopcFileInfo } from './copc-info.js';
+import { type CopcHierarchyPage, type CopcNodeEntry, type CopcPageRef } from './copc-hierarchy.js';
+export interface CopcReadNodeOptions {
+    /** Keep every `stride`-th point of the node (>= 1). The whole chunk is still decompressed. */
+    stride?: number;
+    signal?: AbortSignal;
+}
+export declare class CopcReader {
+    private readonly source;
+    readonly file: CopcFileInfo;
+    readonly originOffset: readonly [number, number, number] | undefined;
+    /** Locked by the first decoded node so every node shares one colour scale. */
+    private rgbScale;
+    private constructor();
+    /** Read and validate the header and info VLR. No point data is read. */
+    static open(source: RangeByteSource, options?: {
+        originOffset?: readonly [number, number, number];
+        signal?: AbortSignal;
+    }): Promise<CopcReader>;
+    get header(): LasHeader;
+    /** The root hierarchy page's location. */
+    get rootPageRef(): CopcPageRef;
+    /** Header bounds in the decoded frame (with `originOffset` subtracted). */
+    get bbox(): PointCloudBBox;
+    /**
+     * Read and parse one page. `maxBytes` (the caller's remaining hierarchy
+     * budget) is enforced BEFORE any byte is read, so a hostile page size
+     * costs nothing.
+     */
+    readPage(ref: CopcPageRef, signal?: AbortSignal, maxBytes?: number): Promise<CopcHierarchyPage>;
+    /** Fetch and decode one node. */
+    readNode(entry: CopcNodeEntry, options?: CopcReadNodeOptions): Promise<DecodedPointChunk>;
+}
+/**
+ * Decompress a node's chunk (`pointCount` records), keeping every
+ * `stride`-th record. Wasm allocations are freed on every path.
+ */
+export declare function decompressCopcChunk(mod: LazPerfModule, compressed: Uint8Array, header: LasHeader, pointCount: number, stride: number): {
+    slab: Uint8Array;
+    count: number;
+};
+//# sourceMappingURL=copc-reader.d.ts.map

package/dist/copc/copc-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copc-reader.d.ts","sourceRoot":"","sources":["../../src/copc/copc-reader.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAA4D,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC7G,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAClF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAgC,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACjF,OAAO,EAIL,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,mBAAmB;IAClC,8FAA8F;IAC9F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,qBAAa,UAAU;IAKnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,QAAQ,CAAC,IAAI,EAAE,YAAY;IAC3B,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS;IANtE,8EAA8E;IAC9E,OAAO,CAAC,QAAQ,CAAqB;IAErC,OAAO;IAMP,wEAAwE;WAC3D,IAAI,CACf,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE;QAAE,YAAY,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GACvF,OAAO,CAAC,UAAU,CAAC;IAKtB,IAAI,MAAM,IAAI,SAAS,CAEtB;IAED,0CAA0C;IAC1C,IAAI,WAAW,IAAI,WAAW,CAM7B;IAED,2EAA2E;IAC3E,IAAI,IAAI,IAAI,cAAc,CAEzB;IAED;;;;OAIG;IACG,QAAQ,CACZ,GAAG,EAAE,WAAW,EAChB,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,GAAE,MAAmD,GAC5D,OAAO,CAAC,iBAAiB,CAAC;IAY7B,iCAAiC;IAC3B,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAsBpG;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,aAAa,EAClB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAyBrC"}

package/dist/copc/copc-reader.js

@@ -0,0 +1,138 @@
+/* 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/. */
+/**
+ * COPC reader (#6869): header + info VLR, hierarchy pages, and per-node
+ * decode over any `RangeByteSource` (a local File, or HTTP Range).
+ *
+ * Node data is one LAZ chunk per node, decompressed with laz-perf's
+ * `ChunkDecoder` and then decoded by the SAME `decodeLasPoints` the LAS and
+ * LAZ sources use, so PDRF 6/7/8 field layout, 8-bit RGB detection and the
+ * f64 `originOffset` subtraction (#1804) have exactly one implementation.
+ *
+ * The reader holds no hierarchy state: it reads and parses pages, and the
+ * owner (worker client, LOD driver, test) keeps the `CopcHierarchy`. That
+ * lets the reader live in the decode worker while the hierarchy lives with
+ * the LOD selection on the main thread.
+ */
+import { bboxInDecodedFrame, decodeLasPoints, sampleMaxRgbChannel } from '../formats/las.js';
+import { loadLazPerf } from '../streaming/laz-perf-loader.js';
+import { readCopcFileInfo, voxelKeyId } from './copc-info.js';
+import { DEFAULT_COPC_HIERARCHY_LIMITS, MAX_COPC_NODE_POINTS, parseCopcHierarchyPage, } from './copc-hierarchy.js';
+export class CopcReader {
+    source;
+    file;
+    originOffset;
+    /** Locked by the first decoded node so every node shares one colour scale. */
+    rgbScale;
+    constructor(source, file, originOffset) {
+        this.source = source;
+        this.file = file;
+        this.originOffset = originOffset;
+    }
+    /** Read and validate the header and info VLR. No point data is read. */
+    static async open(source, options = {}) {
+        const file = await readCopcFileInfo(source, options.signal);
+        return new CopcReader(source, file, options.originOffset);
+    }
+    get header() {
+        return this.file.header;
+    }
+    /** The root hierarchy page's location. */
+    get rootPageRef() {
+        return {
+            key: { d: 0, x: 0, y: 0, z: 0 },
+            offset: this.file.info.rootHierOffset,
+            byteSize: this.file.info.rootHierSize,
+        };
+    }
+    /** Header bounds in the decoded frame (with `originOffset` subtracted). */
+    get bbox() {
+        return bboxInDecodedFrame(this.file.header.bbox, this.originOffset);
+    }
+    /**
+     * Read and parse one page. `maxBytes` (the caller's remaining hierarchy
+     * budget) is enforced BEFORE any byte is read, so a hostile page size
+     * costs nothing.
+     */
+    async readPage(ref, signal, maxBytes = DEFAULT_COPC_HIERARCHY_LIMITS.maxPageBytes) {
+        if (ref.offset + ref.byteSize > this.file.fileSize || ref.byteSize <= 0) {
+            throw new Error(`COPC: page ${voxelKeyId(ref.key)} lies outside the file`);
+        }
+        if (ref.byteSize > maxBytes) {
+            throw new Error(`COPC: page ${voxelKeyId(ref.key)} of ${ref.byteSize} bytes exceeds the ${maxBytes}-byte hierarchy budget`);
+        }
+        const bytes = await this.source.read(ref.offset, ref.offset + ref.byteSize, signal);
+        if (bytes.length !== ref.byteSize)
+            throw new Error(`COPC: page ${voxelKeyId(ref.key)} truncated`);
+        return parseCopcHierarchyPage(bytes, this.file.fileSize);
+    }
+    /** Fetch and decode one node. */
+    async readNode(entry, options = {}) {
+        const { header, fileSize } = this.file;
+        const id = voxelKeyId(entry.key);
+        if (!Number.isSafeInteger(entry.pointCount) || entry.pointCount < 0 || entry.pointCount > MAX_COPC_NODE_POINTS) {
+            throw new Error(`COPC: node ${id} has invalid point count ${entry.pointCount}`);
+        }
+        if (entry.pointCount === 0)
+            return emptyChunk(header);
+        if (entry.byteSize <= 0 || entry.offset < header.pointDataOffset || entry.offset + entry.byteSize > fileSize) {
+            throw new Error(`COPC: node ${id} data lies outside the point block`);
+        }
+        const compressed = await this.source.read(entry.offset, entry.offset + entry.byteSize, options.signal);
+        if (compressed.length !== entry.byteSize)
+            throw new Error(`COPC: node ${id} truncated`);
+        const mod = await loadLazPerf();
+        options.signal?.throwIfAborted();
+        const stride = Math.max(1, Math.floor(options.stride ?? 1));
+        const { slab, count } = decompressCopcChunk(mod, compressed, header, entry.pointCount, stride);
+        if (this.rgbScale === undefined) {
+            const max = sampleMaxRgbChannel(slab, { ...header, pointCount: count });
+            this.rgbScale = header.hasRgb && max > 0 && max <= 255 ? 65535 / 255 : 1;
+        }
+        return decodeLasPoints(slab, header, count, header.pointRecordLength, this.rgbScale, this.originOffset);
+    }
+}
+/**
+ * Decompress a node's chunk (`pointCount` records), keeping every
+ * `stride`-th record. Wasm allocations are freed on every path.
+ */
+export function decompressCopcChunk(mod, compressed, header, pointCount, stride) {
+    const recordLength = header.pointRecordLength;
+    const count = Math.ceil(pointCount / stride);
+    const slab = new Uint8Array(count * recordLength);
+    const dataPtr = mod._malloc(compressed.byteLength);
+    const pointPtr = mod._malloc(recordLength);
+    const decoder = new mod.ChunkDecoder();
+    try {
+        mod.HEAPU8.set(compressed, dataPtr);
+        decoder.open(header.pointDataFormatId, recordLength, dataPtr);
+        let write = 0;
+        for (let i = 0; i < pointCount; i++) {
+            decoder.getPoint(pointPtr);
+            if (i % stride === 0) {
+                // Re-read HEAPU8 each time: a wasm memory growth detaches the old view.
+                slab.set(mod.HEAPU8.subarray(pointPtr, pointPtr + recordLength), write * recordLength);
+                write++;
+            }
+        }
+        return { slab, count };
+    }
+    finally {
+        decoder.delete();
+        mod._free(pointPtr);
+        mod._free(dataPtr);
+    }
+}
+function emptyChunk(header) {
+    return {
+        positions: new Float32Array(0),
+        colors: header.hasRgb ? new Float32Array(0) : undefined,
+        normalState: 'absent',
+        classifications: new Uint8Array(0),
+        intensities: new Uint16Array(0),
+        pointCount: 0,
+        bbox: { min: [Infinity, Infinity, Infinity], max: [-Infinity, -Infinity, -Infinity] },
+    };
+}
+//# sourceMappingURL=copc-reader.js.map

package/dist/copc/copc-reader.js.map

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

package/dist/copc/copc-worker-client.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Main-thread COPC client (#6869). Range reads and LAZ decoding run in the
+ * shared decode worker; the hierarchy lives here, next to the LOD selection
+ * that walks it. Each page/node read is individually cancellable, so a
+ * camera move can drop fetches it no longer wants.
+ */
+import { type CopcSourceDescriptor } from '../streaming/protocol.js';
+import { type DecodeWorkerOptions } from '../streaming/worker-client.js';
+import type { DecodedPointChunk } from '../types.js';
+import { type CopcFileInfo } from './copc-info.js';
+import { CopcHierarchy, type CopcHierarchyLimits, type CopcHierarchyPage, type CopcNodeEntry, type CopcPageRef } from './copc-hierarchy.js';
+export interface OpenCopcOptions extends DecodeWorkerOptions {
+    source: CopcSourceDescriptor;
+    /** Native offset subtracted in f64 before narrowing to f32 (#1804). */
+    originOffset?: readonly [number, number, number];
+    hierarchyLimits?: CopcHierarchyLimits;
+    signal?: AbortSignal;
+}
+export interface CopcWorkerReader {
+    readonly file: CopcFileInfo;
+    /** Root page loaded on open; further pages via `loadPage`. */
+    readonly hierarchy: CopcHierarchy;
+    readonly originOffset?: readonly [number, number, number];
+    /** Read and parse a page without admitting it (see `loadPendingCopcPages`). */
+    readPage(ref: CopcPageRef, signal?: AbortSignal): Promise<CopcHierarchyPage>;
+    /** Read a pending page and admit it to `hierarchy`; concurrent calls share one read. */
+    loadPage(ref: CopcPageRef, signal?: AbortSignal): Promise<void>;
+    /** Fetch and decode one node, keeping every `stride`-th point. */
+    readNode(node: CopcNodeEntry, options?: {
+        stride?: number;
+        signal?: AbortSignal;
+    }): Promise<DecodedPointChunk>;
+    close(): void;
+}
+/** Open a COPC file in the decode worker and load its root hierarchy page. */
+export declare function openCopcWorkerReader(options: OpenCopcOptions): Promise<CopcWorkerReader>;
+//# sourceMappingURL=copc-worker-client.d.ts.map

package/dist/copc/copc-worker-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copc-worker-client.d.ts","sourceRoot":"","sources":["../../src/copc/copc-worker-client.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AAEH,OAAO,EAAiB,KAAK,oBAAoB,EAAuB,MAAM,0BAA0B,CAAC;AACzG,OAAO,EAAkC,KAAK,mBAAmB,EAAsB,MAAM,+BAA+B,CAAC;AAC7H,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EACL,aAAa,EAEb,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,eAAgB,SAAQ,mBAAmB;IAC1D,MAAM,EAAE,oBAAoB,CAAC;IAC7B,uEAAuE;IACvE,YAAY,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1D,+EAA+E;IAC/E,QAAQ,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC7E,wFAAwF;IACxF,QAAQ,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC/G,KAAK,IAAI,IAAI,CAAC;CACf;AA4DD,8EAA8E;AAC9E,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA4F9F"}

package/dist/copc/copc-worker-client.js

@@ -0,0 +1,154 @@
+/* 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/. */
+/**
+ * Main-thread COPC client (#6869). Range reads and LAZ decoding run in the
+ * shared decode worker; the hierarchy lives here, next to the LOD selection
+ * that walks it. Each page/node read is individually cancellable, so a
+ * camera move can drop fetches it no longer wants.
+ */
+import { chunkFromWire } from '../streaming/protocol.js';
+import { defaultSpawn, getSharedSession } from '../streaming/worker-client.js';
+import { voxelKeyId } from './copc-info.js';
+import { CopcHierarchy, DEFAULT_COPC_HIERARCHY_LIMITS, } from './copc-hierarchy.js';
+/**
+ * Send one request, forwarding `signal` to the worker as `copc-cancel`. A
+ * response that races the abort is discarded, as for stream chunks;
+ * `onDiscard` releases anything it carried (an opened reader's sourceId).
+ */
+async function cancellable(session, signal, build, onDiscard) {
+    signal?.throwIfAborted();
+    let requestId = -1;
+    const onAbort = () => session.notify({ kind: 'copc-cancel', targetRequestId: requestId });
+    signal?.addEventListener('abort', onAbort, { once: true });
+    try {
+        const resp = await session.send(build, [], (id) => { requestId = id; });
+        if (signal?.aborted) {
+            onDiscard?.(resp);
+            signal.throwIfAborted();
+        }
+        return resp;
+    }
+    finally {
+        signal?.removeEventListener('abort', onAbort);
+    }
+}
+/** Wait for `shared`, rejecting early (for this caller only) when `signal` aborts. */
+function joinSharedLoad(shared, signal, onAllGone) {
+    shared.waiters++;
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const leave = () => {
+            if (settled)
+                return false;
+            settled = true;
+            shared.waiters--;
+            signal?.removeEventListener('abort', onAbort);
+            return true;
+        };
+        function onAbort() {
+            if (!leave())
+                return;
+            if (shared.waiters === 0)
+                onAllGone();
+            reject(signal?.reason ?? new DOMException('Aborted', 'AbortError'));
+        }
+        signal?.addEventListener('abort', onAbort, { once: true });
+        shared.promise.then(() => { if (leave())
+            resolve(); }, (err) => { if (leave())
+            reject(err); });
+    });
+}
+/** Open a COPC file in the decode worker and load its root hierarchy page. */
+export async function openCopcWorkerReader(options) {
+    const session = await getSharedSession(options.spawn ?? defaultSpawn);
+    const limits = options.hierarchyLimits ?? DEFAULT_COPC_HIERARCHY_LIMITS;
+    const opened = await cancellable(session, options.signal, (requestId) => ({
+        kind: 'copc-open', requestId, source: options.source, originOffset: options.originOffset, maxPageBytes: limits.maxPageBytes,
+    }), 
+    // Opened in the worker just as the caller gave up: nobody else knows
+    // this sourceId, so close it here or the reader lives forever.
+    (late) => session.notify({ kind: 'close', sourceId: late.sourceId }));
+    const sourceId = opened.sourceId;
+    const hierarchy = new CopcHierarchy(limits);
+    const rootRef = { offset: opened.file.info.rootHierOffset, byteSize: opened.file.info.rootHierSize };
+    try {
+        hierarchy.addPage(rootRef, opened.rootPage);
+    }
+    catch (err) {
+        session.notify({ kind: 'close', sourceId });
+        throw err;
+    }
+    let closed = false;
+    const assertOpen = () => {
+        if (closed)
+            throw new Error('COPC reader is closed');
+    };
+    const readPage = async (ref, signal) => {
+        assertOpen();
+        const maxBytes = hierarchy.remainingPageBytes;
+        const resp = await cancellable(session, signal, (requestId) => ({ kind: 'copc-page', requestId, sourceId, page: ref, maxBytes }));
+        return resp.page;
+    };
+    const pageLoads = new Map();
+    return {
+        file: opened.file,
+        hierarchy,
+        originOffset: options.originOffset,
+        readPage,
+        loadPage(ref, signal) {
+            if (signal?.aborted)
+                return Promise.reject(signal.reason ?? new DOMException('Aborted', 'AbortError'));
+            const id = voxelKeyId(ref.key);
+            let shared = pageLoads.get(id);
+            if (!shared) {
+                if (!hierarchy.pendingPages.has(id))
+                    return Promise.resolve();
+                try {
+                    hierarchy.assertCanLoad(ref);
+                }
+                catch (err) {
+                    return Promise.reject(err);
+                }
+                // One read per page, owned by no single caller: each waiter races
+                // its own signal, and the read is cancelled only when all have gone.
+                const abort = new AbortController();
+                const load = { promise: Promise.resolve(), waiters: 0, abort };
+                load.promise = readPage(ref, abort.signal)
+                    .then((page) => {
+                    if (hierarchy.pendingPages.has(id))
+                        hierarchy.addPage(ref, page);
+                })
+                    .finally(() => {
+                    if (pageLoads.get(id) === load)
+                        pageLoads.delete(id);
+                });
+                // Waiters observe the outcome; this keeps an all-abandoned load quiet.
+                load.promise.catch(() => undefined);
+                pageLoads.set(id, load);
+                shared = load;
+            }
+            const joined = shared;
+            return joinSharedLoad(joined, signal, () => {
+                // Forget it first so a later caller starts afresh instead of joining a cancelled read.
+                if (pageLoads.get(id) === joined)
+                    pageLoads.delete(id);
+                joined.abort.abort();
+            });
+        },
+        async readNode(node, opts = {}) {
+            assertOpen();
+            const resp = await cancellable(session, opts.signal, (requestId) => ({ kind: 'copc-node', requestId, sourceId, node, stride: Math.max(1, Math.floor(opts.stride ?? 1)) }));
+            if (!resp.chunk)
+                throw new Error('COPC: worker returned no chunk for a node');
+            return chunkFromWire(resp.chunk);
+        },
+        close() {
+            if (closed)
+                return;
+            closed = true;
+            session.notify({ kind: 'close', sourceId });
+        },
+    };
+}
+//# sourceMappingURL=copc-worker-client.js.map

package/dist/copc/copc-worker-client.js.map

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

package/dist/copc/copc-worker-host.d.ts

@@ -0,0 +1,11 @@
+import { type WorkerRequest, type WorkerResponse } from '../streaming/protocol.js';
+type Post = (msg: WorkerResponse, transfer?: Transferable[]) => void;
+type CopcRequest = Extract<WorkerRequest, {
+    kind: 'copc-open' | 'copc-page' | 'copc-node' | 'copc-cancel';
+}>;
+/** Handle one COPC request; `allocateId` hands out ids shared with the stream sources. */
+export declare function handleCopcRequest(msg: CopcRequest, post: Post, allocateId: () => number): Promise<void>;
+/** Close a COPC reader; returns false when `sourceId` is not one. */
+export declare function closeCopcSource(sourceId: number): boolean;
+export {};
+//# sourceMappingURL=copc-worker-host.d.ts.map

package/dist/copc/copc-worker-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copc-worker-host.d.ts","sourceRoot":"","sources":["../../src/copc/copc-worker-host.ts"],"names":[],"mappings":"AAaA,OAAO,EAA0C,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAI3H,KAAK,IAAI,GAAG,CAAC,GAAG,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,KAAK,IAAI,CAAC;AACrE,KAAK,WAAW,GAAG,OAAO,CAAC,aAAa,EAAE;IAAE,IAAI,EAAE,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,aAAa,CAAA;CAAE,CAAC,CAAC;AAc7G,0FAA0F;AAC1F,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmC7G;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAMzD"}

package/dist/copc/copc-worker-host.js

@@ -0,0 +1,73 @@
+/* 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/. */
+/**
+ * Worker-side COPC handlers (#6869). The decode worker forwards every
+ * `copc-*` request here. Readers are kept per `sourceId`; every page/node
+ * request gets its own AbortController so the LOD driver can cancel a
+ * fetch the camera no longer needs (`copc-cancel`).
+ */
+import { BlobByteSource } from '../streaming/blob-source.js';
+import { HttpRangeSource } from '../streaming/http-range-source.js';
+import { chunkToWire } from '../streaming/protocol.js';
+import { CopcReader } from './copc-reader.js';
+const readers = new Map();
+const inFlight = new Map();
+async function openSource(desc, signal) {
+    if (desc.kind === 'blob')
+        return new BlobByteSource(desc.blob);
+    return HttpRangeSource.open(desc.url, { headers: desc.headers, signal });
+}
+function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+/** Handle one COPC request; `allocateId` hands out ids shared with the stream sources. */
+export async function handleCopcRequest(msg, post, allocateId) {
+    if (msg.kind === 'copc-cancel') {
+        inFlight.get(msg.targetRequestId)?.abort();
+        return;
+    }
+    const abort = new AbortController();
+    inFlight.set(msg.requestId, abort);
+    try {
+        if (msg.kind === 'copc-open') {
+            const source = await openSource(msg.source, abort.signal);
+            const reader = await CopcReader.open(source, { originOffset: msg.originOffset, signal: abort.signal });
+            const rootPage = await reader.readPage(reader.rootPageRef, abort.signal, msg.maxPageBytes);
+            const sourceId = allocateId();
+            // Same ordering as the stream sources: report first, register after,
+            // so a failed post cannot leave an unreachable reader behind.
+            post({ kind: 'copc-opened', requestId: msg.requestId, sourceId, file: reader.file, rootPage });
+            readers.set(sourceId, { reader, closed: new AbortController() });
+            return;
+        }
+        const entry = readers.get(msg.sourceId);
+        if (!entry)
+            throw new Error(`Unknown COPC sourceId ${msg.sourceId}`);
+        const signal = AbortSignal.any([abort.signal, entry.closed.signal]);
+        if (msg.kind === 'copc-page') {
+            const page = await entry.reader.readPage(msg.page, signal, msg.maxBytes);
+            post({ kind: 'copc-page', requestId: msg.requestId, page });
+            return;
+        }
+        const chunk = await entry.reader.readNode(msg.node, { stride: msg.stride, signal });
+        const { payload, transfer } = chunkToWire(chunk);
+        post({ kind: 'chunk', requestId: msg.requestId, sourceId: msg.sourceId, chunk: payload }, transfer);
+    }
+    catch (err) {
+        post({ kind: 'error', requestId: msg.requestId, message: errorMessage(err) });
+    }
+    finally {
+        inFlight.delete(msg.requestId);
+    }
+}
+/** Close a COPC reader; returns false when `sourceId` is not one. */
+export function closeCopcSource(sourceId) {
+    const entry = readers.get(sourceId);
+    if (!entry)
+        return false;
+    entry.closed.abort();
+    readers.delete(sourceId);
+    return true;
+}
+//# sourceMappingURL=copc-worker-host.js.map

package/dist/copc/copc-worker-host.js.map

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

package/dist/formats/ifcx-points.d.ts

@@ -12,6 +12,7 @@
  * The PCD schema (pcd::base64) is decoded by formats/pcd.ts; the adapter
  * that picks between these three lives in `from-ifcx-attributes.ts`.
  */
+import type { IfcxPointSource } from '../point-source.js';
 import type { DecodedPointChunk } from '../types.js';
 export interface PointsArrayAttribute {
     positions: number[][];
@@ -22,5 +23,7 @@ export interface PointsBase64Attribute {
     colors?: string;
 }
 export declare function decodePointsArray(attr: PointsArrayAttribute): DecodedPointChunk;
+export declare function decodePointsArraySource(attr: PointsArrayAttribute): IfcxPointSource;
 export declare function decodePointsBase64(attr: PointsBase64Attribute): DecodedPointChunk;
+export declare function decodePointsBase64Source(attr: PointsBase64Attribute): IfcxPointSource;
 //# sourceMappingURL=ifcx-points.d.ts.map

package/dist/formats/ifcx-points.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ifcx-points.d.ts","sourceRoot":"","sources":["../../src/formats/ifcx-points.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAkB,MAAM,aAAa,CAAC;AAErE,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,oBAAoB,GAAG,iBAAiB,CAgD/E;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,qBAAqB,GAAG,iBAAiB,CAkCjF"}
+{"version":3,"file":"ifcx-points.d.ts","sourceRoot":"","sources":["../../src/formats/ifcx-points.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAkB,MAAM,aAAa,CAAC;AAErE,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,oBAAoB,GAAG,iBAAiB,CAO/E;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,oBAAoB,GAAG,eAAe,CA+CnF;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,qBAAqB,GAAG,iBAAiB,CAGjF;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,qBAAqB,GAAG,eAAe,CAOrF"}

package/dist/formats/ifcx-points.js

@@ -2,6 +2,14 @@
  * 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/. */
 export function decodePointsArray(attr) {
+    const source = decodePointsArraySource(attr);
+    const positions = new Float32Array(source.positions);
+    return {
+        positions, colors: source.colors ? new Float32Array(source.colors) : undefined,
+        normalState: 'absent', pointCount: source.pointCount, bbox: computeBBox(positions),
+    };
+}
+export function decodePointsArraySource(attr) {
     if (!Array.isArray(attr.positions)) {
         throw new Error('points::array: positions must be an array of [x,y,z] triples');
     }
@@ -12,7 +20,7 @@ export function decodePointsArray(attr) {
         // instead of returning a sentinel "empty cloud".
         throw new Error('points::array: positions must contain at least one point');
     }
-    const positions = new Float32Array(count * 3);
+    const positions = new Float64Array(count * 3);
     for (let i = 0; i < count; i++) {
         const p = attr.positions[i];
         if (!Array.isArray(p) || p.length < 3) {
@@ -31,7 +39,7 @@ export function decodePointsArray(attr) {
             throw new Error(`points::array: colors length (${attr.colors.length}) ` +
                 `does not match positions length (${count})`);
         }
-        colors = new Float32Array(count * 3);
+        colors = new Float64Array(count * 3);
         for (let i = 0; i < count; i++) {
             const c = attr.colors[i];
             if (!Array.isArray(c) || c.length < 3) {
@@ -45,12 +53,23 @@ export function decodePointsArray(attr) {
     return {
         positions,
         colors,
-        normalState: 'absent',
+        sourcePrecision: 'f64', sourceEncoding: 'points-array',
         pointCount: count,
-        bbox: computeBBox(positions),
     };
 }
 export function decodePointsBase64(attr) {
+    const channels = decodeBase64Channels(attr);
+    return { ...channels, normalState: 'absent', bbox: computeBBox(channels.positions) };
+}
+export function decodePointsBase64Source(attr) {
+    const channels = decodeBase64Channels(attr);
+    return {
+        positions: new Float64Array(channels.positions),
+        colors: channels.colors ? new Float64Array(channels.colors) : undefined,
+        pointCount: channels.pointCount, sourcePrecision: 'f32', sourceEncoding: 'points-base64',
+    };
+}
+function decodeBase64Channels(attr) {
     if (typeof attr.positions !== 'string' || attr.positions.length === 0) {
         throw new Error('points::base64: positions must be a non-empty base64 string');
     }
@@ -80,9 +99,7 @@ export function decodePointsBase64(attr) {
     return {
         positions,
         colors,
-        normalState: 'absent',
         pointCount: count,
-        bbox: computeBBox(positions),
     };
 }
 // ─── helpers ────────────────────────────────────────────────────────────────
@@ -106,7 +123,6 @@ function base64ToBytes(b64) {
             out[i] = binary.charCodeAt(i);
         return out;
     }
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     const buf = globalThis.Buffer;
     if (buf && typeof buf.from === 'function') {
         return new Uint8Array(buf.from(b64, 'base64'));