@ifc-lite/pointcloud 0.2.0

package/dist/streaming/host.js

@@ -0,0 +1,120 @@
+/* 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 { createDecodeWorkerSource, } from './worker-client.js';
+const DEFAULT_MAX_POINTS = 25_000_000;
+const DEFAULT_MAX_FILE = 4 * 1024 * 1024 * 1024; // 4 GB
+const DEFAULT_CHUNK = 200_000;
+export function streamPointCloud(opts) {
+    const maxPoints = opts.maxPointsInMemory ?? DEFAULT_MAX_POINTS;
+    const maxFile = opts.maxFileSize ?? DEFAULT_MAX_FILE;
+    const chunkSize = opts.chunkSize ?? DEFAULT_CHUNK;
+    // chunkSize <= 0 would let the source.next() loop emit empty chunks
+    // forever without advancing its cursor. Fail loudly so callers can't
+    // accidentally lock up the worker.
+    if (!Number.isFinite(chunkSize) || chunkSize <= 0) {
+        throw new Error(`streamPointCloud: chunkSize must be a positive finite number (got ${chunkSize})`);
+    }
+    const localAbort = new AbortController();
+    const composed = composeAbort(opts.signal, localAbort.signal);
+    const done = (async () => {
+        if (opts.blob.size > maxFile) {
+            throw new Error(`Point cloud rejected: file is ${(opts.blob.size / 1e6).toFixed(0)} MB, ` +
+                `exceeds maxFileSize ${(maxFile / 1e6).toFixed(0)} MB`);
+        }
+        const probeFactory = opts.createSource ?? createDecodeWorkerSource;
+        let source;
+        let totalEmitted = 0;
+        let bboxMin = [Infinity, Infinity, Infinity];
+        let bboxMax = [-Infinity, -Infinity, -Infinity];
+        let info = null;
+        try {
+            // First open with stride=1 to learn the true point count, then
+            // re-open with the right stride if we need to downsample.
+            let stride = 1;
+            source = probeFactory({
+                format: opts.format,
+                blob: opts.blob,
+                label: opts.label,
+                stride: 1,
+            });
+            info = await source.open(composed);
+            if (info.totalPointCount > maxPoints) {
+                stride = Math.ceil(info.totalPointCount / maxPoints);
+                source.close();
+                source = probeFactory({
+                    format: opts.format,
+                    blob: opts.blob,
+                    label: opts.label,
+                    stride,
+                });
+                info = await source.open(composed);
+            }
+            opts.onOpen?.({ ...info, stride });
+            while (true) {
+                if (composed.aborted)
+                    break;
+                const chunk = await source.next(chunkSize, composed);
+                if (!chunk)
+                    break;
+                opts.onChunk(chunk);
+                totalEmitted += chunk.pointCount;
+                if (chunk.bbox.min[0] < bboxMin[0])
+                    bboxMin[0] = chunk.bbox.min[0];
+                if (chunk.bbox.min[1] < bboxMin[1])
+                    bboxMin[1] = chunk.bbox.min[1];
+                if (chunk.bbox.min[2] < bboxMin[2])
+                    bboxMin[2] = chunk.bbox.min[2];
+                if (chunk.bbox.max[0] > bboxMax[0])
+                    bboxMax[0] = chunk.bbox.max[0];
+                if (chunk.bbox.max[1] > bboxMax[1])
+                    bboxMax[1] = chunk.bbox.max[1];
+                if (chunk.bbox.max[2] > bboxMax[2])
+                    bboxMax[2] = chunk.bbox.max[2];
+                opts.onProgress?.(totalEmitted, info.totalPointCount);
+            }
+        }
+        finally {
+            // Catches probe + open + onOpen + decode failures uniformly so
+            // worker-backed sources don't leak the decoder on bad files.
+            source?.close();
+        }
+        if (!composed.aborted && info) {
+            const bbox = Number.isFinite(bboxMin[0])
+                ? { min: bboxMin, max: bboxMax }
+                : info.bbox;
+            opts.onComplete?.(bbox, totalEmitted);
+        }
+    })().catch((err) => {
+        if (composed.aborted)
+            return; // expected on cancel
+        opts.onError?.(err instanceof Error ? err : new Error(String(err)));
+        throw err;
+    });
+    return {
+        cancel: () => localAbort.abort(),
+        done,
+    };
+}
+function composeAbort(...signals) {
+    // Native AbortSignal.any was added in widely-shipping browsers in 2024.
+    // Use the polyfilled fallback so tests in older Node still work.
+    const filtered = signals.filter((s) => s !== undefined);
+    if (filtered.length === 0)
+        return new AbortController().signal;
+    if (filtered.length === 1)
+        return filtered[0];
+    const anyApi = AbortSignal.any;
+    if (typeof anyApi === 'function')
+        return anyApi(filtered);
+    const ctrl = new AbortController();
+    for (const s of filtered) {
+        if (s.aborted) {
+            ctrl.abort(s.reason);
+            break;
+        }
+        s.addEventListener('abort', () => ctrl.abort(s.reason), { once: true });
+    }
+    return ctrl.signal;
+}
+//# sourceMappingURL=host.js.map

package/dist/streaming/host.js.map

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

package/dist/streaming/las-source.d.ts

@@ -0,0 +1,28 @@
+/**
+ * LAS streaming source.
+ *
+ * Implements `StreamingPointSource` over a `BlobByteSource`. Reads the
+ * 227-byte public header on `open()`, then yields chunks of decoded
+ * points on each `next()`. Stride-based downsampling is supported
+ * natively: when `stride > 1`, the source advances by `stride * recordLen`
+ * bytes per emitted point.
+ */
+import type { DecodedPointChunk } from '../types.js';
+import type { DownsampleHint, PointSourceInfo, StreamingPointSource } from './types.js';
+export declare class LasStreamingSource implements StreamingPointSource {
+    private bytes;
+    private header;
+    private cursor;
+    private rgbScale;
+    private downsample;
+    private label?;
+    constructor(blob: Blob, options?: {
+        label?: string;
+        downsample?: DownsampleHint;
+    });
+    open(signal?: AbortSignal): Promise<PointSourceInfo>;
+    next(maxPoints: number, signal?: AbortSignal): Promise<DecodedPointChunk | null>;
+    close(): void;
+    private toInfo;
+}
+//# sourceMappingURL=las-source.d.ts.map

package/dist/streaming/las-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"las-source.d.ts","sourceRoot":"","sources":["../../src/streaming/las-source.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAQrD,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAMpB,qBAAa,kBAAmB,YAAW,oBAAoB;IAC7D,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,UAAU,CAAiB;IACnC,OAAO,CAAC,KAAK,CAAC,CAAS;gBAEX,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,cAAc,CAAA;KAAO;IAM/E,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;IAsCpD,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAoDtF,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,MAAM;CAWf"}

package/dist/streaming/las-source.js

@@ -0,0 +1,117 @@
+/* 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 { decodeLasPoints, parseLasHeader, sampleMaxRgbChannel, } from '../formats/las.js';
+import { BlobByteSource } from './blob-source.js';
+const HEADER_PROBE_BYTES = 1024;
+/** RGB-detection probe: read up to 256 KB worth of point records. */
+const RGB_PROBE_RECORDS = 4096;
+export class LasStreamingSource {
+    bytes;
+    header = null;
+    cursor = 0; // index of NEXT point to emit (0..header.pointCount)
+    rgbScale = 1;
+    downsample;
+    label;
+    constructor(blob, options = {}) {
+        this.bytes = new BlobByteSource(blob);
+        this.downsample = options.downsample ?? { stride: 1 };
+        this.label = options.label;
+    }
+    async open(signal) {
+        if (this.header) {
+            return this.toInfo(this.header);
+        }
+        abortIfAborted(signal);
+        const headerBytes = await this.bytes.read(0, HEADER_PROBE_BYTES);
+        abortIfAborted(signal);
+        // Use locals through the whole probe so a partial failure (abort
+        // mid-RGB-probe, parse error) doesn't leave `this.header` set —
+        // otherwise a retry returns the cached info without re-running the
+        // RGB-scale detection and silently uses the wrong scale.
+        const header = parseLasHeader(headerBytes);
+        let rgbScale = 1;
+        if (header.hasRgb) {
+            const probeSize = Math.min(RGB_PROBE_RECORDS * header.pointRecordLength, Math.max(0, this.bytes.size - header.pointDataOffset));
+            if (probeSize > 0) {
+                const probe = await this.bytes.read(header.pointDataOffset, header.pointDataOffset + probeSize);
+                abortIfAborted(signal);
+                const max = sampleMaxRgbChannel(probe, header);
+                // Threshold matches PDAL / cloudcompare behaviour: ≤ 255 → assume
+                // 8-bit-in-u16 and rescale on decode so values reach 0..1 in float.
+                rgbScale = max > 0 && max <= 255 ? 65535 / 255 : 1;
+            }
+        }
+        this.header = header;
+        this.rgbScale = rgbScale;
+        this.cursor = 0;
+        return this.toInfo(header);
+    }
+    async next(maxPoints, signal) {
+        abortIfAborted(signal);
+        if (!Number.isFinite(maxPoints) || maxPoints <= 0) {
+            // 0/negative would emit empty chunks without advancing the cursor,
+            // creating a non-terminating loop in the host.
+            throw new Error(`LasStreamingSource: maxPoints must be > 0 (got ${maxPoints})`);
+        }
+        if (!this.header) {
+            throw new Error('LasStreamingSource: open() must be awaited before next()');
+        }
+        const stride = Math.max(1, this.downsample.stride | 0);
+        if (this.cursor >= this.header.pointCount)
+            return null;
+        if (stride === 1) {
+            const remaining = this.header.pointCount - this.cursor;
+            const take = Math.min(maxPoints, remaining);
+            const startByte = this.header.pointDataOffset + this.cursor * this.header.pointRecordLength;
+            const endByte = startByte + take * this.header.pointRecordLength;
+            const slab = await this.bytes.read(startByte, endByte);
+            abortIfAborted(signal);
+            const chunk = decodeLasPoints(slab, this.header, take, this.header.pointRecordLength, this.rgbScale);
+            this.cursor += take;
+            return chunk;
+        }
+        // Strided reads: pull a packed slab covering `take * stride` source
+        // records, then decode every Nth record.
+        const remainingSource = this.header.pointCount - this.cursor;
+        const sourceTake = Math.min(maxPoints * stride, remainingSource);
+        const decodedCount = Math.ceil(sourceTake / stride);
+        const startByte = this.header.pointDataOffset + this.cursor * this.header.pointRecordLength;
+        const endByte = startByte + sourceTake * this.header.pointRecordLength;
+        const slab = await this.bytes.read(startByte, endByte);
+        abortIfAborted(signal);
+        // Build a compacted slab that contains only the records we want, then
+        // hand it to decodeLasPoints with stride === recordLen.
+        const compact = new Uint8Array(decodedCount * this.header.pointRecordLength);
+        let writeOff = 0;
+        for (let i = 0; i < decodedCount; i++) {
+            const srcOff = i * stride * this.header.pointRecordLength;
+            compact.set(slab.subarray(srcOff, srcOff + this.header.pointRecordLength), writeOff);
+            writeOff += this.header.pointRecordLength;
+        }
+        const chunk = decodeLasPoints(compact, this.header, decodedCount, this.header.pointRecordLength, this.rgbScale);
+        this.cursor += sourceTake;
+        return chunk;
+    }
+    close() {
+        this.header = null;
+        this.cursor = 0;
+    }
+    toInfo(header) {
+        const stride = Math.max(1, this.downsample.stride | 0);
+        return {
+            totalPointCount: stride === 1 ? header.pointCount : Math.ceil(header.pointCount / stride),
+            bbox: header.bbox,
+            hasColor: header.hasRgb,
+            hasClassification: true,
+            hasIntensity: true,
+            label: this.label,
+        };
+    }
+}
+function abortIfAborted(signal) {
+    if (signal?.aborted) {
+        throw new DOMException('Aborted', 'AbortError');
+    }
+}
+//# sourceMappingURL=las-source.js.map

package/dist/streaming/las-source.js.map

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

package/dist/streaming/laz-source.d.ts

@@ -0,0 +1,35 @@
+/**
+ * LAZ streaming source backed by `laz-perf` (Apache-2.0).
+ *
+ * Phase 2 v1: load the whole .laz file into memory, decompress through
+ * `LASZip`, and emit chunks of decoded points. Memory-bounded callers
+ * apply `streamPointCloud`'s downsampling cap before reaching here.
+ *
+ * The wasm module is loaded lazily on first `open()` so files that
+ * never need LAZ don't pay the wasm-instantiation cost.
+ */
+import type { DecodedPointChunk } from '../types.js';
+import type { DownsampleHint, PointSourceInfo, StreamingPointSource } from './types.js';
+export declare class LazStreamingSource implements StreamingPointSource {
+    private blob;
+    private downsample;
+    private label?;
+    private mod;
+    private laszip;
+    private header;
+    private fileBytes;
+    private filePtr;
+    private pointPtr;
+    private pointBuffer;
+    private cursor;
+    private rgbScale;
+    constructor(blob: Blob, options?: {
+        label?: string;
+        downsample?: DownsampleHint;
+    });
+    open(signal?: AbortSignal): Promise<PointSourceInfo>;
+    next(maxPoints: number, signal?: AbortSignal): Promise<DecodedPointChunk | null>;
+    close(): void;
+    private toInfo;
+}
+//# sourceMappingURL=laz-source.d.ts.map

package/dist/streaming/laz-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"laz-source.d.ts","sourceRoot":"","sources":["../../src/streaming/laz-source.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAOrD,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAsDpB,qBAAa,kBAAmB,YAAW,oBAAoB;IAC7D,OAAO,CAAC,IAAI,CAAO;IACnB,OAAO,CAAC,UAAU,CAAiB;IACnC,OAAO,CAAC,KAAK,CAAC,CAAS;IAGvB,OAAO,CAAC,GAAG,CAA8B;IACzC,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAK;gBAET,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,cAAc,CAAA;KAAO;IAM/E,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;IAwEpD,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAoCtF,KAAK,IAAI,IAAI;IAsBb,OAAO,CAAC,MAAM;CAWf"}

package/dist/streaming/laz-source.js

@@ -0,0 +1,205 @@
+/* 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 { decodeLasPoints, parseLasHeader, sampleMaxRgbChannel, } from '../formats/las.js';
+let modulePromise = null;
+async function loadLazPerf() {
+    if (!modulePromise) {
+        modulePromise = (async () => {
+            // Dynamic import keeps `laz-perf` out of bundles that don't touch
+            // LAZ. The package is shipped as CommonJS (`lib/{node,web}/index.js`),
+            // and Vite/webpack wrap CJS imports under `.default` — but the way
+            // they do that varies, so probe every shape we might see:
+            //   • { createLazPerf }                     — pure-ESM build
+            //   • { default: { createLazPerf } }        — Vite default-wrapper
+            //   • { default: createLazPerf }            — esModuleInterop on a fn
+            //   • module-as-function (legacy UMD)        — `lazPerf` IS the factory
+            const ns = (await import('laz-perf'));
+            const dflt = ns.default;
+            const candidates = [
+                ns.createLazPerf,
+                typeof dflt === 'object' && dflt !== null ? dflt.createLazPerf : undefined,
+                dflt,
+                // Some bundlers expose the CJS module as the namespace object itself.
+                ns,
+            ];
+            const factory = candidates.find((c) => typeof c === 'function');
+            if (!factory) {
+                const keys = Object.keys(ns).join(', ');
+                throw new Error(`laz-perf: could not find createLazPerf factory (saw keys: ${keys || '<empty>'})`);
+            }
+            return factory();
+        })();
+    }
+    return modulePromise;
+}
+export class LazStreamingSource {
+    blob;
+    downsample;
+    label;
+    // Populated by open()
+    mod = null;
+    laszip = null;
+    header = null;
+    fileBytes = null;
+    filePtr = 0;
+    pointPtr = 0;
+    pointBuffer = null;
+    cursor = 0;
+    rgbScale = 1;
+    constructor(blob, options = {}) {
+        this.blob = blob;
+        this.downsample = options.downsample ?? { stride: 1 };
+        this.label = options.label;
+    }
+    async open(signal) {
+        if (this.header)
+            return this.toInfo(this.header);
+        abortIfAborted(signal);
+        // All allocations happen against locals first; only commit them to
+        // `this.*` after every step succeeds. On failure (abort, parse,
+        // wasm load), the catch frees the partial state so a retry doesn't
+        // hit the early-return at line 1 with a half-open instance.
+        let mod;
+        let filePtr = 0;
+        let pointPtr = 0;
+        let laszip;
+        try {
+            const buf = await this.blob.arrayBuffer();
+            abortIfAborted(signal);
+            const bytes = new Uint8Array(buf);
+            const header = parseLasHeader(bytes);
+            mod = await loadLazPerf();
+            abortIfAborted(signal);
+            filePtr = mod._malloc(bytes.byteLength);
+            mod.HEAPU8.set(bytes, filePtr);
+            laszip = new mod.LASZip();
+            laszip.open(filePtr, bytes.byteLength);
+            const pointSize = laszip.getPointLength();
+            pointPtr = mod._malloc(pointSize);
+            const pointBuffer = new Uint8Array(pointSize);
+            let rgbScale = 1;
+            if (header.hasRgb) {
+                // Forward-only iterator: probe the first ~4096 points, then
+                // reset by recreating the LASZip handle.
+                const probe = Math.min(4096, header.pointCount);
+                const tempBuf = new Uint8Array(probe * pointSize);
+                for (let i = 0; i < probe; i++) {
+                    laszip.getPoint(pointPtr);
+                    tempBuf.set(mod.HEAPU8.subarray(pointPtr, pointPtr + pointSize), i * pointSize);
+                }
+                const max = sampleMaxRgbChannel(tempBuf, header);
+                rgbScale = max > 0 && max <= 255 ? 65535 / 255 : 1;
+                laszip.delete();
+                laszip = new mod.LASZip();
+                laszip.open(filePtr, bytes.byteLength);
+            }
+            // Commit — every allocation succeeded.
+            this.fileBytes = bytes;
+            this.mod = mod;
+            this.filePtr = filePtr;
+            this.laszip = laszip;
+            this.pointPtr = pointPtr;
+            this.pointBuffer = pointBuffer;
+            this.rgbScale = rgbScale;
+            this.header = header;
+            this.cursor = 0;
+            return this.toInfo(header);
+        }
+        catch (err) {
+            // Partial allocations — free what we got before throwing.
+            try {
+                laszip?.delete();
+            }
+            catch { /* cleanup — safe to ignore */ }
+            if (mod && pointPtr) {
+                try {
+                    mod._free(pointPtr);
+                }
+                catch { /* cleanup — safe to ignore */ }
+            }
+            if (mod && filePtr) {
+                try {
+                    mod._free(filePtr);
+                }
+                catch { /* cleanup — safe to ignore */ }
+            }
+            throw err;
+        }
+    }
+    async next(maxPoints, signal) {
+        abortIfAborted(signal);
+        if (!Number.isFinite(maxPoints) || maxPoints <= 0) {
+            throw new Error(`LazStreamingSource: maxPoints must be > 0 (got ${maxPoints})`);
+        }
+        if (!this.header || !this.mod || !this.laszip || !this.pointBuffer) {
+            throw new Error('LazStreamingSource: open() must be awaited before next()');
+        }
+        const stride = Math.max(1, this.downsample.stride | 0);
+        if (this.cursor >= this.header.pointCount)
+            return null;
+        const pointSize = this.pointBuffer.byteLength;
+        const remainingSource = this.header.pointCount - this.cursor;
+        const sourceTake = stride === 1
+            ? Math.min(maxPoints, remainingSource)
+            : Math.min(maxPoints * stride, remainingSource);
+        const decodedCount = stride === 1 ? sourceTake : Math.ceil(sourceTake / stride);
+        const slab = new Uint8Array(decodedCount * pointSize);
+        let writeIdx = 0;
+        for (let i = 0; i < sourceTake; i++) {
+            this.laszip.getPoint(this.pointPtr);
+            // For strided reads, only keep every Nth point.
+            if (stride === 1 || i % stride === 0) {
+                slab.set(this.mod.HEAPU8.subarray(this.pointPtr, this.pointPtr + pointSize), writeIdx * pointSize);
+                writeIdx++;
+            }
+        }
+        this.cursor += sourceTake;
+        return decodeLasPoints(slab, this.header, decodedCount, pointSize, this.rgbScale);
+    }
+    close() {
+        try {
+            this.laszip?.delete();
+        }
+        catch {
+            /* cleanup — safe to ignore */
+        }
+        if (this.mod && this.pointPtr) {
+            try {
+                this.mod._free(this.pointPtr);
+            }
+            catch { /* cleanup — safe to ignore */ }
+        }
+        if (this.mod && this.filePtr) {
+            try {
+                this.mod._free(this.filePtr);
+            }
+            catch { /* cleanup — safe to ignore */ }
+        }
+        this.laszip = null;
+        this.mod = null;
+        this.header = null;
+        this.fileBytes = null;
+        this.pointBuffer = null;
+        this.filePtr = 0;
+        this.pointPtr = 0;
+        this.cursor = 0;
+    }
+    toInfo(header) {
+        const stride = Math.max(1, this.downsample.stride | 0);
+        return {
+            totalPointCount: stride === 1 ? header.pointCount : Math.ceil(header.pointCount / stride),
+            bbox: header.bbox,
+            hasColor: header.hasRgb,
+            hasClassification: true,
+            hasIntensity: true,
+            label: this.label,
+        };
+    }
+}
+function abortIfAborted(signal) {
+    if (signal?.aborted) {
+        throw new DOMException('Aborted', 'AbortError');
+    }
+}
+//# sourceMappingURL=laz-source.js.map

package/dist/streaming/laz-source.js.map

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

package/dist/streaming/pcd-source.d.ts

@@ -0,0 +1,25 @@
+/**
+ * PCD (PCL) streaming source — whole-file decode, single chunk.
+ *
+ * Like PLY, PCD isn't an octree format. The decoder lives in
+ * `formats/pcd.ts` and handles ASCII / binary / binary_compressed
+ * (LZF). For files past the 25M-point soft cap, `streamPointCloud`
+ * applies stride downsampling on the way out.
+ */
+import type { DecodedPointChunk } from '../types.js';
+import type { DownsampleHint, PointSourceInfo, StreamingPointSource } from './types.js';
+export declare class PcdStreamingSource implements StreamingPointSource {
+    private blob;
+    private downsample;
+    private label?;
+    private chunk;
+    private served;
+    constructor(blob: Blob, options?: {
+        label?: string;
+        downsample?: DownsampleHint;
+    });
+    open(signal?: AbortSignal): Promise<PointSourceInfo>;
+    next(maxPoints: number, signal?: AbortSignal): Promise<DecodedPointChunk | null>;
+    close(): void;
+}
+//# sourceMappingURL=pcd-source.d.ts.map

package/dist/streaming/pcd-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pcd-source.d.ts","sourceRoot":"","sources":["../../src/streaming/pcd-source.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB,qBAAa,kBAAmB,YAAW,oBAAoB;IAC7D,OAAO,CAAC,IAAI,CAAO;IACnB,OAAO,CAAC,UAAU,CAAiB;IACnC,OAAO,CAAC,KAAK,CAAC,CAAS;IACvB,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,MAAM,CAAS;gBAEX,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,cAAc,CAAA;KAAO;IAM/E,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;IAgBpD,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAQtF,KAAK,IAAI,IAAI;CAId"}