@ifc-lite/pointcloud 0.2.0

package/dist/streaming/pcd-source.js

@@ -0,0 +1,86 @@
+/* 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 { decodePcd } from '../formats/pcd.js';
+export class PcdStreamingSource {
+    blob;
+    downsample;
+    label;
+    chunk = null;
+    served = false;
+    constructor(blob, options = {}) {
+        this.blob = blob;
+        this.downsample = options.downsample ?? { stride: 1 };
+        this.label = options.label;
+    }
+    async open(signal) {
+        abortIfAborted(signal);
+        const buf = await this.blob.arrayBuffer();
+        abortIfAborted(signal);
+        const decoded = decodePcd(new Uint8Array(buf));
+        this.chunk = applyStride(decoded, this.downsample.stride);
+        return {
+            totalPointCount: this.chunk.pointCount,
+            bbox: this.chunk.bbox,
+            hasColor: !!this.chunk.colors,
+            hasClassification: !!this.chunk.classifications,
+            hasIntensity: !!this.chunk.intensities,
+            label: this.label,
+        };
+    }
+    async next(maxPoints, signal) {
+        abortIfAborted(signal);
+        if (!this.chunk || this.served)
+            return null;
+        void maxPoints;
+        this.served = true;
+        return this.chunk;
+    }
+    close() {
+        this.chunk = null;
+        this.served = false;
+    }
+}
+function applyStride(chunk, stride) {
+    const s = Math.max(1, stride | 0);
+    if (s === 1)
+        return chunk;
+    const newCount = Math.ceil(chunk.pointCount / s);
+    const positions = new Float32Array(newCount * 3);
+    const colors = chunk.colors ? new Float32Array(newCount * 3) : undefined;
+    // Preserve classification + intensity through downsampling — without
+    // these, the classification / intensity color modes silently lose
+    // their per-point data the moment a file crosses the soft cap.
+    const classifications = chunk.classifications ? new Uint8Array(newCount) : undefined;
+    const intensities = chunk.intensities ? new Uint16Array(newCount) : undefined;
+    let dst = 0;
+    for (let i = 0; i < chunk.pointCount; i += s) {
+        positions[dst * 3] = chunk.positions[i * 3];
+        positions[dst * 3 + 1] = chunk.positions[i * 3 + 1];
+        positions[dst * 3 + 2] = chunk.positions[i * 3 + 2];
+        if (colors && chunk.colors) {
+            colors[dst * 3] = chunk.colors[i * 3];
+            colors[dst * 3 + 1] = chunk.colors[i * 3 + 1];
+            colors[dst * 3 + 2] = chunk.colors[i * 3 + 2];
+        }
+        if (classifications && chunk.classifications)
+            classifications[dst] = chunk.classifications[i];
+        if (intensities && chunk.intensities)
+            intensities[dst] = chunk.intensities[i];
+        dst++;
+    }
+    return {
+        positions,
+        colors,
+        classifications,
+        intensities,
+        pointCount: newCount,
+        bbox: chunk.bbox,
+    };
+}
+function abortIfAborted(signal) {
+    if (signal?.aborted) {
+        throw new DOMException('Aborted', 'AbortError');
+    }
+}
+//# sourceMappingURL=pcd-source.js.map

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

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

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

@@ -0,0 +1,26 @@
+/**
+ * PLY streaming source — whole-file decode, single chunk.
+ *
+ * PLY isn't an octree format, so we don't get incremental visibility
+ * benefits from chunked decode. Reading the whole file once and emitting
+ * one chunk is simpler and correct.  Memory is still bounded by
+ * `streamPointCloud`'s 25M-point cap — for files past that, the stride
+ * downsample applies on the way out.
+ */
+import type { DecodedPointChunk } from '../types.js';
+import type { DownsampleHint, PointSourceInfo, StreamingPointSource } from './types.js';
+export declare class PlyStreamingSource 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=ply-source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ply-source.d.ts","sourceRoot":"","sources":["../../src/streaming/ply-source.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;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;IAgCpD,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAQtF,KAAK,IAAI,IAAI;CAId"}

package/dist/streaming/ply-source.js

@@ -0,0 +1,98 @@
+/* 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 { decodePly, parsePlyHeader } from '../formats/ply.js';
+export class PlyStreamingSource {
+    blob;
+    downsample;
+    label;
+    chunk = null;
+    served = false;
+    constructor(blob, options = {}) {
+        this.blob = blob;
+        this.downsample = options.downsample ?? { stride: 1 };
+        this.label = options.label;
+    }
+    async open(signal) {
+        abortIfAborted(signal);
+        const buf = await this.blob.arrayBuffer();
+        abortIfAborted(signal);
+        const bytes = new Uint8Array(buf);
+        // Header probe first — gives us the count + capabilities so the
+        // host can decide on downsampling stride before the full decode.
+        const header = parsePlyHeader(bytes);
+        const vertex = header.elements.find((e) => e.name === 'vertex');
+        if (!vertex)
+            throw new Error('PLY: no vertex element');
+        const hasRgb = !!vertex.properties.find((p) => p.name === 'red' || p.name === 'r')
+            && !!vertex.properties.find((p) => p.name === 'green' || p.name === 'g')
+            && !!vertex.properties.find((p) => p.name === 'blue' || p.name === 'b');
+        const hasIntensity = !!vertex.properties.find((p) => p.name === 'intensity' || p.name === 'scalar_Intensity');
+        // Decode now (we already have all bytes). The cost is amortised over
+        // the next() call — caller perceives no extra latency.
+        const fullChunk = decodePly(bytes);
+        this.chunk = applyStride(fullChunk, this.downsample.stride);
+        return {
+            totalPointCount: this.chunk.pointCount,
+            bbox: this.chunk.bbox,
+            hasColor: hasRgb,
+            hasClassification: false,
+            hasIntensity,
+            label: this.label,
+        };
+    }
+    async next(maxPoints, signal) {
+        abortIfAborted(signal);
+        if (!this.chunk || this.served)
+            return null;
+        void maxPoints; // Whole-file decode: ignore chunk-size hint.
+        this.served = true;
+        return this.chunk;
+    }
+    close() {
+        this.chunk = null;
+        this.served = false;
+    }
+}
+function applyStride(chunk, stride) {
+    const s = Math.max(1, stride | 0);
+    if (s === 1)
+        return chunk;
+    const newCount = Math.ceil(chunk.pointCount / s);
+    const positions = new Float32Array(newCount * 3);
+    const colors = chunk.colors ? new Float32Array(newCount * 3) : undefined;
+    const classifications = chunk.classifications ? new Uint8Array(newCount) : undefined;
+    const intensities = chunk.intensities ? new Uint16Array(newCount) : undefined;
+    let dst = 0;
+    for (let i = 0; i < chunk.pointCount; i += s) {
+        positions[dst * 3] = chunk.positions[i * 3];
+        positions[dst * 3 + 1] = chunk.positions[i * 3 + 1];
+        positions[dst * 3 + 2] = chunk.positions[i * 3 + 2];
+        if (colors && chunk.colors) {
+            colors[dst * 3] = chunk.colors[i * 3];
+            colors[dst * 3 + 1] = chunk.colors[i * 3 + 1];
+            colors[dst * 3 + 2] = chunk.colors[i * 3 + 2];
+        }
+        if (classifications && chunk.classifications) {
+            classifications[dst] = chunk.classifications[i];
+        }
+        if (intensities && chunk.intensities) {
+            intensities[dst] = chunk.intensities[i];
+        }
+        dst++;
+    }
+    return {
+        positions,
+        colors,
+        classifications,
+        intensities,
+        pointCount: newCount,
+        bbox: chunk.bbox,
+    };
+}
+function abortIfAborted(signal) {
+    if (signal?.aborted) {
+        throw new DOMException('Aborted', 'AbortError');
+    }
+}
+//# sourceMappingURL=ply-source.js.map

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

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

package/dist/streaming/protocol.d.ts

@@ -0,0 +1,62 @@
+/**
+ * postMessage protocol shared between the main thread and decode-worker.
+ *
+ * Direction is encoded by message kind. Typed arrays are always carried
+ * in transferable buffers so we don't double-allocate.
+ */
+import type { DecodedPointChunk, PointCloudBBox } from '../types.js';
+import type { PointSourceInfo } from './types.js';
+export type WorkerSourceFormat = 'las' | 'laz' | 'ply' | 'pcd' | 'e57';
+/** main → worker */
+export type WorkerRequest = {
+    kind: 'open';
+    requestId: number;
+    format: WorkerSourceFormat;
+    blob: Blob;
+    label?: string;
+    stride: number;
+} | {
+    kind: 'next';
+    requestId: number;
+    sourceId: number;
+    maxPoints: number;
+} | {
+    kind: 'close';
+    sourceId: number;
+} | {
+    kind: 'abort';
+    sourceId: number;
+};
+/** worker → main */
+export type WorkerResponse = {
+    kind: 'opened';
+    requestId: number;
+    sourceId: number;
+    info: PointSourceInfo;
+} | {
+    kind: 'chunk';
+    requestId: number;
+    sourceId: number;
+    chunk: SerializedChunk | null;
+} | {
+    kind: 'error';
+    requestId: number;
+    message: string;
+};
+/** Wire-friendly chunk: typed-array views replaced by their underlying buffers. */
+export interface SerializedChunk {
+    positions: ArrayBuffer;
+    colors?: ArrayBuffer;
+    classifications?: ArrayBuffer;
+    intensities?: ArrayBuffer;
+    pointCount: number;
+    bbox: PointCloudBBox;
+}
+/** Convert a chunk into a transferable wire payload + transfer list. */
+export declare function chunkToWire(chunk: DecodedPointChunk): {
+    payload: SerializedChunk;
+    transfer: ArrayBuffer[];
+};
+/** Inverse of `chunkToWire`. */
+export declare function chunkFromWire(payload: SerializedChunk): DecodedPointChunk;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/streaming/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/streaming/protocol.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAEvE,oBAAoB;AACpB,MAAM,MAAM,aAAa,GACrB;IACE,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEN,oBAAoB;AACpB,MAAM,MAAM,cAAc,GACtB;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,eAAe,CAAC;CACvB,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;CAC/B,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN,mFAAmF;AACnF,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,WAAW,CAAC;IACvB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,eAAe,CAAC,EAAE,WAAW,CAAC;IAC9B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,cAAc,CAAC;CACtB;AAED,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,KAAK,EAAE,iBAAiB,GAAG;IACrD,OAAO,EAAE,eAAe,CAAC;IACzB,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB,CA4BA;AAED,gCAAgC;AAChC,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,iBAAiB,CASzE"}

package/dist/streaming/protocol.js

@@ -0,0 +1,45 @@
+/* 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/. */
+/** Convert a chunk into a transferable wire payload + transfer list. */
+export function chunkToWire(chunk) {
+    // We construct every typed array in this package via `new Float32Array(N)` /
+    // friends, so `.buffer` is always a plain `ArrayBuffer`. The `as ArrayBuffer`
+    // cast is safe and required because TS widens the type to `ArrayBufferLike`
+    // (which formally includes `SharedArrayBuffer`).
+    const positions = chunk.positions.buffer;
+    const transfer = [positions];
+    const payload = {
+        positions,
+        pointCount: chunk.pointCount,
+        bbox: chunk.bbox,
+    };
+    if (chunk.colors) {
+        const buf = chunk.colors.buffer;
+        payload.colors = buf;
+        transfer.push(buf);
+    }
+    if (chunk.classifications) {
+        const buf = chunk.classifications.buffer;
+        payload.classifications = buf;
+        transfer.push(buf);
+    }
+    if (chunk.intensities) {
+        const buf = chunk.intensities.buffer;
+        payload.intensities = buf;
+        transfer.push(buf);
+    }
+    return { payload, transfer };
+}
+/** Inverse of `chunkToWire`. */
+export function chunkFromWire(payload) {
+    return {
+        positions: new Float32Array(payload.positions),
+        colors: payload.colors ? new Float32Array(payload.colors) : undefined,
+        classifications: payload.classifications ? new Uint8Array(payload.classifications) : undefined,
+        intensities: payload.intensities ? new Uint16Array(payload.intensities) : undefined,
+        pointCount: payload.pointCount,
+        bbox: payload.bbox,
+    };
+}
+//# sourceMappingURL=protocol.js.map

package/dist/streaming/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/streaming/protocol.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAqE/D,wEAAwE;AACxE,MAAM,UAAU,WAAW,CAAC,KAAwB;IAIlD,6EAA6E;IAC7E,8EAA8E;IAC9E,4EAA4E;IAC5E,iDAAiD;IACjD,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,MAAqB,CAAC;IACxD,MAAM,QAAQ,GAAkB,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAoB;QAC/B,SAAS;QACT,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;KACjB,CAAC;IACF,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,MAAqB,CAAC;QAC/C,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC;QACrB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IACD,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,KAAK,CAAC,eAAe,CAAC,MAAqB,CAAC;QACxD,OAAO,CAAC,eAAe,GAAG,GAAG,CAAC;QAC9B,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IACD,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,KAAK,CAAC,WAAW,CAAC,MAAqB,CAAC;QACpD,OAAO,CAAC,WAAW,GAAG,GAAG,CAAC;QAC1B,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC/B,CAAC;AAED,gCAAgC;AAChC,MAAM,UAAU,aAAa,CAAC,OAAwB;IACpD,OAAO;QACL,SAAS,EAAE,IAAI,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC;QAC9C,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;QACrE,eAAe,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,SAAS;QAC9F,WAAW,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS;QACnF,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,IAAI,EAAE,OAAO,CAAC,IAAI;KACnB,CAAC;AACJ,CAAC"}

package/dist/streaming/types.d.ts

@@ -0,0 +1,41 @@
+import type { DecodedPointChunk, PointCloudBBox } from '../types.js';
+/** Aggregate metadata returned from `StreamingPointSource.open()`. */
+export interface PointSourceInfo {
+    /** Total points the source will emit if it streams to completion. */
+    totalPointCount: number;
+    /** Source-wide bbox in source-native coordinates. */
+    bbox: PointCloudBBox;
+    /** True if the source carries per-point RGB. */
+    hasColor: boolean;
+    /** True if the source carries per-point classification. */
+    hasClassification: boolean;
+    /** True if the source carries per-point intensity. */
+    hasIntensity: boolean;
+    /** Free-form display label (filename, URL, etc.). */
+    label?: string;
+}
+/**
+ * Renderer-agnostic streaming source.
+ *
+ * `open()` reads only enough bytes to discover header metadata.
+ * Callers then drive `next()` repeatedly until it returns null.
+ * Implementations should respect `signal` to abort cleanly between chunks.
+ */
+export interface StreamingPointSource {
+    open(signal?: AbortSignal): Promise<PointSourceInfo>;
+    next(maxPoints: number, signal?: AbortSignal): Promise<DecodedPointChunk | null>;
+    close(): void;
+}
+/**
+ * Stride-based downsampling control.
+ *
+ * When the host applies a memory cap, it can request the source to skip
+ * every `stride` points (always > 0) so a large file produces a coarser,
+ * but still-valid, chunk stream. Sources that don't support this can
+ * decode normally and ignore the hint — the host will downsample on the
+ * receiving end.
+ */
+export interface DownsampleHint {
+    stride: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/streaming/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/streaming/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAErE,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,eAAe,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,IAAI,EAAE,cAAc,CAAC;IACrB,gDAAgD;IAChD,QAAQ,EAAE,OAAO,CAAC;IAClB,2DAA2D;IAC3D,iBAAiB,EAAE,OAAO,CAAC;IAC3B,sDAAsD;IACtD,YAAY,EAAE,OAAO,CAAC;IACtB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACrD,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IACjF,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/streaming/types.js

@@ -0,0 +1,5 @@
+/* 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/. */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/streaming/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/streaming/types.ts"],"names":[],"mappings":"AAAA;;+DAE+D"}

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

@@ -0,0 +1,20 @@
+import type { StreamingPointSource } from './types.js';
+export type DecodeWorkerFormat = 'las' | 'laz' | 'ply' | 'pcd' | 'e57';
+export interface DecodeWorkerOptions {
+    /** Override the worker constructor — useful for tests or custom bundlers. */
+    spawn?: () => Worker;
+}
+export interface CreateDecodeWorkerSourceOptions extends DecodeWorkerOptions {
+    format: DecodeWorkerFormat;
+    blob: Blob;
+    label?: string;
+    /** stride>1 → drop every Nth point on decode for memory bounds. */
+    stride?: number;
+}
+/**
+ * Build a `StreamingPointSource` that runs decode work in the shared
+ * worker. The caller drives `open()` / `next()` / `close()` exactly
+ * like the in-process `LasStreamingSource`.
+ */
+export declare function createDecodeWorkerSource(opts: CreateDecodeWorkerSourceOptions): StreamingPointSource;
+//# sourceMappingURL=worker-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worker-client.d.ts","sourceRoot":"","sources":["../../src/streaming/worker-client.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAEV,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAEvE,MAAM,WAAW,mBAAmB;IAClC,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAqFD,MAAM,WAAW,+BAAgC,SAAQ,mBAAmB;IAC1E,MAAM,EAAE,kBAAkB,CAAC;IAC3B,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,+BAA+B,GACpC,oBAAoB,CAsEtB"}

package/dist/streaming/worker-client.js

@@ -0,0 +1,152 @@
+/* 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 { chunkFromWire, } from './protocol.js';
+/** Pool a single worker per page; the host can spawn additional workers
+ *  with `createDecodeWorkerSource({ spawn })` when concurrent decoding is
+ *  desirable (e.g. multiple federated scans). */
+let sharedWorker = null;
+function defaultSpawn() {
+    // The bare-`.js` form works against the built dist but Vite's
+    // worker-import-meta-url plugin can't resolve it through the source
+    // alias used in the viewer dev build. Geometry uses `.worker.ts` for
+    // the same reason — Vite happily rewrites the suffix on dist builds.
+    return new Worker(new URL('./decode-worker.js', import.meta.url), {
+        type: 'module',
+        name: 'ifclite-pointcloud-decode',
+    });
+}
+function getSharedWorker(spawn) {
+    if (!sharedWorker) {
+        sharedWorker = spawn();
+    }
+    return sharedWorker;
+}
+class WorkerSession {
+    worker;
+    requests = new Map();
+    nextRequestId = 1;
+    listener;
+    constructor(worker) {
+        this.worker = worker;
+        this.listener = (event) => {
+            const msg = event.data;
+            if (!('requestId' in msg))
+                return;
+            const pending = this.requests.get(msg.requestId);
+            if (!pending)
+                return;
+            this.requests.delete(msg.requestId);
+            if (msg.kind === 'error') {
+                pending.reject(new Error(msg.message));
+            }
+            else {
+                pending.resolve(msg);
+            }
+        };
+        worker.addEventListener('message', this.listener);
+    }
+    /** Send a request that expects a single response by `requestId`. */
+    send(build, transfer = []) {
+        const requestId = this.nextRequestId++;
+        const req = build(requestId);
+        return new Promise((resolve, reject) => {
+            this.requests.set(requestId, {
+                resolve: (resp) => resolve(resp),
+                reject,
+            });
+            this.worker.postMessage(req, transfer);
+        });
+    }
+    /** Send a fire-and-forget message (close / abort). */
+    notify(req) {
+        this.worker.postMessage(req);
+    }
+}
+let sharedSession = null;
+function getSharedSession(spawn) {
+    if (!sharedSession) {
+        sharedSession = new WorkerSession(getSharedWorker(spawn));
+    }
+    return sharedSession;
+}
+/**
+ * Build a `StreamingPointSource` that runs decode work in the shared
+ * worker. The caller drives `open()` / `next()` / `close()` exactly
+ * like the in-process `LasStreamingSource`.
+ */
+export function createDecodeWorkerSource(opts) {
+    const session = getSharedSession(opts.spawn ?? defaultSpawn);
+    let sourceId = null;
+    let info = null;
+    return {
+        async open(signal) {
+            if (info)
+                return info;
+            abortIfAborted(signal);
+            const resp = await session.send((requestId) => ({
+                kind: 'open',
+                requestId,
+                format: opts.format,
+                blob: opts.blob,
+                label: opts.label,
+                stride: Math.max(1, opts.stride ?? 1),
+            }));
+            sourceId = resp.sourceId;
+            info = resp.info;
+            return info;
+        },
+        async next(maxPoints, signal) {
+            if (sourceId === null) {
+                throw new Error('decode-worker source not opened');
+            }
+            abortIfAborted(signal);
+            const id = sourceId;
+            // Propagate aborts that fire WHILE the worker is decoding —
+            // without this, cancel() returns immediately to the caller but
+            // the worker keeps grinding on a soon-to-be-discarded chunk.
+            const abortListener = () => {
+                session.notify({ kind: 'abort', sourceId: id });
+            };
+            signal?.addEventListener('abort', abortListener, { once: true });
+            try {
+                const resp = await session.send((requestId) => ({
+                    kind: 'next',
+                    requestId,
+                    sourceId: id,
+                    maxPoints,
+                }));
+                // Race: if the signal fired *while* the worker was finishing a
+                // chunk, the response can still arrive after the host has
+                // moved on. Treat a late completion as cancelled so the host's
+                // `onChunk` doesn't run after `cancel()` returned to the caller.
+                if (signal?.aborted) {
+                    throw new DOMException('Aborted', 'AbortError');
+                }
+                if (!resp.chunk)
+                    return null;
+                return chunkFromWire(resp.chunk);
+            }
+            finally {
+                signal?.removeEventListener('abort', abortListener);
+            }
+        },
+        close() {
+            if (sourceId !== null) {
+                session.notify({ kind: 'close', sourceId });
+                sourceId = null;
+            }
+            // Clear cached open()-result too so a subsequent open() actually
+            // re-opens the worker source instead of returning stale info
+            // alongside a now-null sourceId (which would make next() throw
+            // "decode-worker source not opened").
+            info = null;
+        },
+    };
+}
+function abortIfAborted(signal) {
+    if (signal?.aborted) {
+        throw new DOMException('Aborted', 'AbortError');
+    }
+}
+//# sourceMappingURL=worker-client.js.map

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

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

package/dist/types.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Renderer-agnostic point cloud types.
+ *
+ * Decoders in this package produce DecodedPointChunks; the renderer (and
+ * any other consumer) shapes them into GPU buffers. No WebGPU, no three.js.
+ */
+export interface PointCloudBBox {
+    min: [number, number, number];
+    max: [number, number, number];
+}
+/**
+ * A decoded chunk of points ready for upload to a GPU buffer.
+ *
+ * Coordinates are in the source's native space. Any z-up→y-up swap and
+ * RTC offset is the renderer's responsibility (it already owns those for
+ * triangle meshes). Optional 4x4 transform on the asset is applied per-vertex
+ * in the vertex shader.
+ *
+ * Color channel layout: 0..1 floats per channel. RGB only — alpha is solid.
+ * Classification (LAS-style) is a per-point u8.
+ */
+export interface DecodedPointChunk {
+    /** [x,y,z, x,y,z, ...] */
+    positions: Float32Array;
+    /** [r,g,b, r,g,b, ...] in 0..1 — undefined when source has no color */
+    colors?: Float32Array;
+    /** Per-point u8 classification — undefined when source has none */
+    classifications?: Uint8Array;
+    /** Per-point u16 intensity — undefined when source has none */
+    intensities?: Uint16Array;
+    /** Number of points in this chunk (positions.length / 3) */
+    pointCount: number;
+    /** Local bbox of this chunk's positions (pre-transform) */
+    bbox: PointCloudBBox;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AAEH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,SAAS,EAAE,YAAY,CAAC;IACxB,uEAAuE;IACvE,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,mEAAmE;IACnE,eAAe,CAAC,EAAE,UAAU,CAAC;IAC7B,+DAA+D;IAC/D,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,IAAI,EAAE,cAAc,CAAC;CACtB"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/* 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/. */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;+DAE+D"}