@ifc-lite/pointcloud 0.2.0

package/dist/from-ifcx-attributes.d.ts

@@ -0,0 +1,10 @@
+import type { DecodedPointChunk } from './types.js';
+export declare const POINTCLOUD_ATTR: {
+    readonly PCD_BASE64: "pcd::base64";
+    readonly POINTS_ARRAY: "points::array";
+    readonly POINTS_BASE64: "points::base64";
+};
+/** Set of attribute keys that signal a point cloud node. */
+export declare const POINTCLOUD_ATTR_KEYS: ReadonlySet<string>;
+export declare function decodeIfcxPointAttribute(attributes: ReadonlyMap<string, unknown>): DecodedPointChunk | null;
+//# sourceMappingURL=from-ifcx-attributes.d.ts.map

package/dist/from-ifcx-attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"from-ifcx-attributes.d.ts","sourceRoot":"","sources":["../src/from-ifcx-attributes.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,eAAO,MAAM,eAAe;;;;CAIlB,CAAC;AAEX,4DAA4D;AAC5D,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAA2C,CAAC;AAEjG,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,GACvC,iBAAiB,GAAG,IAAI,CAc1B"}

package/dist/from-ifcx-attributes.js

@@ -0,0 +1,49 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * Adapter: given a node's attribute map (already composed by IFCx), pick
+ * the appropriate decoder for the three buildingSMART point cloud schemas
+ * and produce a DecodedPointChunk.
+ *
+ * Returns null if the node carries none of the supported attributes.
+ */
+import { decodePcd } from './formats/pcd.js';
+import { decodePointsArray, decodePointsBase64, } from './formats/ifcx-points.js';
+export const POINTCLOUD_ATTR = {
+    PCD_BASE64: 'pcd::base64',
+    POINTS_ARRAY: 'points::array',
+    POINTS_BASE64: 'points::base64',
+};
+/** Set of attribute keys that signal a point cloud node. */
+export const POINTCLOUD_ATTR_KEYS = new Set(Object.values(POINTCLOUD_ATTR));
+export function decodeIfcxPointAttribute(attributes) {
+    const pcd = attributes.get(POINTCLOUD_ATTR.PCD_BASE64);
+    if (typeof pcd === 'string' && pcd.length > 0) {
+        return decodePcd(base64ToBytes(pcd));
+    }
+    const arr = attributes.get(POINTCLOUD_ATTR.POINTS_ARRAY);
+    if (arr && typeof arr === 'object') {
+        return decodePointsArray(arr);
+    }
+    const b64 = attributes.get(POINTCLOUD_ATTR.POINTS_BASE64);
+    if (b64 && typeof b64 === 'object') {
+        return decodePointsBase64(b64);
+    }
+    return null;
+}
+function base64ToBytes(b64) {
+    if (typeof atob === 'function') {
+        const binary = atob(b64);
+        const out = new Uint8Array(binary.length);
+        for (let i = 0; i < binary.length; i++)
+            out[i] = binary.charCodeAt(i);
+        return out;
+    }
+    const buf = globalThis.Buffer;
+    if (buf && typeof buf.from === 'function') {
+        return new Uint8Array(buf.from(b64, 'base64'));
+    }
+    throw new Error('No base64 decoder available in this environment');
+}
+//# sourceMappingURL=from-ifcx-attributes.js.map

package/dist/from-ifcx-attributes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"from-ifcx-attributes.js","sourceRoot":"","sources":["../src/from-ifcx-attributes.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EACL,iBAAiB,EACjB,kBAAkB,GAGnB,MAAM,0BAA0B,CAAC;AAGlC,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,UAAU,EAAE,aAAa;IACzB,YAAY,EAAE,eAAe;IAC7B,aAAa,EAAE,gBAAgB;CACvB,CAAC;AAEX,4DAA4D;AAC5D,MAAM,CAAC,MAAM,oBAAoB,GAAwB,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC;AAEjG,MAAM,UAAU,wBAAwB,CACtC,UAAwC;IAExC,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;IACvD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,OAAO,SAAS,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;IACvC,CAAC;IACD,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;IACzD,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACnC,OAAO,iBAAiB,CAAC,GAA2B,CAAC,CAAC;IACxD,CAAC;IACD,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;IAC1D,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACnC,OAAO,kBAAkB,CAAC,GAA4B,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,aAAa,CAAC,GAAW;IAChC,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QACzB,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACtE,OAAO,GAAG,CAAC;IACb,CAAC;IACD,MAAM,GAAG,GAAI,UAAqF,CAAC,MAAM,CAAC;IAC1G,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC1C,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;AACrE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @ifc-lite/pointcloud — point cloud decoders, streaming sources, and
+ * a worker-backed host for off-main-thread decoding.
+ *
+ * Phase 0: IFCx schemas (`pcd::base64`, `points::array`, `points::base64`).
+ * Phase 1: streaming `.las` from local Files / fetched Blobs.
+ * Phase 2: streaming `.laz` (laz-perf in the worker).
+ */
+export type { DecodedPointChunk, PointCloudBBox } from './types.js';
+export { decodePcd } from './formats/pcd.js';
+export { decodePointsArray, decodePointsBase64, type PointsArrayAttribute, type PointsBase64Attribute, } from './formats/ifcx-points.js';
+export { decompressLZF } from './lzf.js';
+export { POINTCLOUD_ATTR, POINTCLOUD_ATTR_KEYS, decodeIfcxPointAttribute, } from './from-ifcx-attributes.js';
+export { parseLasHeader, decodeLasPoints, sampleMaxRgbChannel, type LasHeader, } from './formats/las.js';
+export type { StreamingPointSource, PointSourceInfo, DownsampleHint, } from './streaming/types.js';
+export { LasStreamingSource } from './streaming/las-source.js';
+export { LazStreamingSource } from './streaming/laz-source.js';
+export { PlyStreamingSource } from './streaming/ply-source.js';
+export { PcdStreamingSource } from './streaming/pcd-source.js';
+export { E57StreamingSource } from './streaming/e57-source.js';
+export { parsePlyHeader } from './formats/ply.js';
+export { parseE57FileHeader, parseE57Xml, stripPageCrc as stripE57PageCrc, decodeE57, decodeE57Scan, type E57FileHeader, type Data3DEntry, } from './formats/e57.js';
+export { BlobByteSource } from './streaming/blob-source.js';
+export { createDecodeWorkerSource, type CreateDecodeWorkerSourceOptions, type DecodeWorkerOptions, type DecodeWorkerFormat, } from './streaming/worker-client.js';
+export { streamPointCloud, type StreamPointCloudOptions, type StreamHandle, } from './streaming/host.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AAEH,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGpE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,KAAK,SAAS,GACf,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,YAAY,IAAI,eAAe,EAC/B,SAAS,EACT,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,WAAW,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EACL,wBAAwB,EACxB,KAAK,+BAA+B,EACpC,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,YAAY,GAClB,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+/* 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/. */
+// Inline / IFCx decoders (Phase 0)
+export { decodePcd } from './formats/pcd.js';
+export { decodePointsArray, decodePointsBase64, } from './formats/ifcx-points.js';
+export { decompressLZF } from './lzf.js';
+export { POINTCLOUD_ATTR, POINTCLOUD_ATTR_KEYS, decodeIfcxPointAttribute, } from './from-ifcx-attributes.js';
+// LAS reader primitives
+export { parseLasHeader, decodeLasPoints, sampleMaxRgbChannel, } from './formats/las.js';
+export { LasStreamingSource } from './streaming/las-source.js';
+export { LazStreamingSource } from './streaming/laz-source.js';
+export { PlyStreamingSource } from './streaming/ply-source.js';
+export { PcdStreamingSource } from './streaming/pcd-source.js';
+export { E57StreamingSource } from './streaming/e57-source.js';
+export { parsePlyHeader } from './formats/ply.js';
+export { parseE57FileHeader, parseE57Xml, stripPageCrc as stripE57PageCrc, decodeE57, decodeE57Scan, } from './formats/e57.js';
+export { BlobByteSource } from './streaming/blob-source.js';
+export { createDecodeWorkerSource, } from './streaming/worker-client.js';
+export { streamPointCloud, } from './streaming/host.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAa/D,mCAAmC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EACL,iBAAiB,EACjB,kBAAkB,GAGnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,2BAA2B,CAAC;AAEnC,wBAAwB;AACxB,OAAO,EACL,cAAc,EACd,eAAe,EACf,mBAAmB,GAEpB,MAAM,kBAAkB,CAAC;AAQ1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,YAAY,IAAI,eAAe,EAC/B,SAAS,EACT,aAAa,GAGd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EACL,wBAAwB,GAIzB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,gBAAgB,GAGjB,MAAM,qBAAqB,CAAC"}

package/dist/lzf.d.ts

@@ -0,0 +1,10 @@
+/**
+ * LZF decompressor — Marc Lehmann's algorithm.
+ *
+ * Used by PCL's PCD `binary_compressed` data section. Pure decompression:
+ * we never need to encode. Algorithm reference: liblzf 3.x lzf_d.c.
+ *
+ * Throws if the bitstream over-runs the input or the declared output length.
+ */
+export declare function decompressLZF(input: Uint8Array, outputSize: number): Uint8Array;
+//# sourceMappingURL=lzf.d.ts.map

package/dist/lzf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lzf.d.ts","sourceRoot":"","sources":["../src/lzf.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,UAAU,CAqD/E"}

package/dist/lzf.js

@@ -0,0 +1,64 @@
+/* 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/. */
+/**
+ * LZF decompressor — Marc Lehmann's algorithm.
+ *
+ * Used by PCL's PCD `binary_compressed` data section. Pure decompression:
+ * we never need to encode. Algorithm reference: liblzf 3.x lzf_d.c.
+ *
+ * Throws if the bitstream over-runs the input or the declared output length.
+ */
+export function decompressLZF(input, outputSize) {
+    const output = new Uint8Array(outputSize);
+    let ip = 0; // input cursor
+    let op = 0; // output cursor
+    const ie = input.length;
+    while (ip < ie) {
+        let ctrl = input[ip++];
+        if (ctrl < 0x20) {
+            // Literal run: copy ctrl+1 bytes verbatim
+            const run = ctrl + 1;
+            if (ip + run > ie) {
+                throw new Error('LZF: literal run exceeds input bounds');
+            }
+            if (op + run > outputSize) {
+                throw new Error('LZF: literal run exceeds output bounds');
+            }
+            output.set(input.subarray(ip, ip + run), op);
+            ip += run;
+            op += run;
+        }
+        else {
+            // Back reference
+            let len = ctrl >> 5;
+            if (len === 7) {
+                if (ip >= ie)
+                    throw new Error('LZF: truncated extended length');
+                len += input[ip++];
+            }
+            len += 2;
+            if (ip >= ie)
+                throw new Error('LZF: truncated back-reference offset');
+            const ref = op - ((ctrl & 0x1f) << 8) - input[ip++] - 1;
+            if (ref < 0) {
+                throw new Error('LZF: back-reference points before output start');
+            }
+            if (op + len > outputSize) {
+                throw new Error('LZF: back-reference exceeds output bounds');
+            }
+            // The reference can overlap the current write position — the original
+            // C code uses byte-by-byte copy for that exact reason (run-length
+            // expansion). Mirror that.
+            for (let i = 0; i < len; i++) {
+                output[op + i] = output[ref + i];
+            }
+            op += len;
+        }
+    }
+    if (op !== outputSize) {
+        throw new Error(`LZF: decompressed ${op} bytes, expected ${outputSize}`);
+    }
+    return output;
+}
+//# sourceMappingURL=lzf.js.map

package/dist/lzf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lzf.js","sourceRoot":"","sources":["../src/lzf.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,KAAiB,EAAE,UAAkB;IACjE,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,EAAE,GAAG,CAAC,CAAC,CAAa,eAAe;IACvC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAa,gBAAgB;IACxC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC;IAExB,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC;QACf,IAAI,IAAI,GAAG,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QAEvB,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;YAChB,0CAA0C;YAC1C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC;YACrB,IAAI,EAAE,GAAG,GAAG,GAAG,EAAE,EAAE,CAAC;gBAClB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;YAC3D,CAAC;YACD,IAAI,EAAE,GAAG,GAAG,GAAG,UAAU,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;YAC5D,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,GAAG,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7C,EAAE,IAAI,GAAG,CAAC;YACV,EAAE,IAAI,GAAG,CAAC;QACZ,CAAC;aAAM,CAAC;YACN,iBAAiB;YACjB,IAAI,GAAG,GAAG,IAAI,IAAI,CAAC,CAAC;YACpB,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC;gBACd,IAAI,EAAE,IAAI,EAAE;oBAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;gBAChE,GAAG,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;YACrB,CAAC;YACD,GAAG,IAAI,CAAC,CAAC;YAET,IAAI,EAAE,IAAI,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;YACtE,MAAM,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;YACxD,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;YACpE,CAAC;YACD,IAAI,EAAE,GAAG,GAAG,GAAG,UAAU,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;YAC/D,CAAC;YAED,sEAAsE;YACtE,kEAAkE;YAClE,2BAA2B;YAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC7B,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;YACnC,CAAC;YACD,EAAE,IAAI,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,IAAI,EAAE,KAAK,UAAU,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,qBAAqB,EAAE,oBAAoB,UAAU,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * Byte-range reader backed by a Blob.
+ *
+ * Works for both browser `File` objects (drag-and-drop) and `fetch()`
+ * responses materialised via `await response.blob()`. Reads return
+ * `Uint8Array` — the underlying ArrayBuffer is owned by the caller and
+ * safe to transfer across postMessage boundaries.
+ */
+export declare class BlobByteSource {
+    private readonly blob;
+    constructor(blob: Blob);
+    get size(): number;
+    read(start: number, end: number): Promise<Uint8Array>;
+}
+//# sourceMappingURL=blob-source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blob-source.d.ts","sourceRoot":"","sources":["../../src/streaming/blob-source.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,IAAI;IAEvC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAEK,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CAQ5D"}

package/dist/streaming/blob-source.js

@@ -0,0 +1,30 @@
+/* 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/. */
+/**
+ * Byte-range reader backed by a Blob.
+ *
+ * Works for both browser `File` objects (drag-and-drop) and `fetch()`
+ * responses materialised via `await response.blob()`. Reads return
+ * `Uint8Array` — the underlying ArrayBuffer is owned by the caller and
+ * safe to transfer across postMessage boundaries.
+ */
+export class BlobByteSource {
+    blob;
+    constructor(blob) {
+        this.blob = blob;
+    }
+    get size() {
+        return this.blob.size;
+    }
+    async read(start, end) {
+        const safeStart = Math.max(0, start);
+        const safeEnd = Math.min(end, this.blob.size);
+        if (safeEnd <= safeStart)
+            return new Uint8Array(0);
+        const slice = this.blob.slice(safeStart, safeEnd);
+        const buf = await slice.arrayBuffer();
+        return new Uint8Array(buf);
+    }
+}
+//# sourceMappingURL=blob-source.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blob-source.js","sourceRoot":"","sources":["../../src/streaming/blob-source.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;GAOG;AACH,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,IAAU;QAAV,SAAI,GAAJ,IAAI,CAAM;IAAG,CAAC;IAE3C,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAa,EAAE,GAAW;QACnC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,OAAO,IAAI,SAAS;YAAE,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;QACnD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAClD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,WAAW,EAAE,CAAC;QACtC,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;CACF"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=decode-worker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decode-worker.d.ts","sourceRoot":"","sources":["../../src/streaming/decode-worker.ts"],"names":[],"mappings":""}

package/dist/streaming/decode-worker.js

@@ -0,0 +1,131 @@
+/* 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 { chunkToWire, } from './protocol.js';
+import { LasStreamingSource } from './las-source.js';
+import { LazStreamingSource } from './laz-source.js';
+import { PlyStreamingSource } from './ply-source.js';
+import { PcdStreamingSource } from './pcd-source.js';
+import { E57StreamingSource } from './e57-source.js';
+const sources = new Map();
+let nextSourceId = 1;
+self.onmessage = (event) => {
+    const msg = event.data;
+    switch (msg.kind) {
+        case 'open':
+            void handleOpen(msg);
+            return;
+        case 'next':
+            void handleNext(msg);
+            return;
+        case 'close':
+            handleClose(msg.sourceId);
+            return;
+        case 'abort':
+            handleAbort(msg.sourceId);
+            return;
+    }
+};
+async function handleOpen(msg) {
+    try {
+        const source = createSource(msg.format, msg.blob, {
+            label: msg.label,
+            downsample: { stride: Math.max(1, msg.stride | 0) },
+        });
+        const abort = new AbortController();
+        const info = await source.open(abort.signal);
+        const sourceId = nextSourceId++;
+        sources.set(sourceId, { source, abort });
+        post({
+            kind: 'opened',
+            requestId: msg.requestId,
+            sourceId,
+            info,
+        });
+    }
+    catch (err) {
+        post({
+            kind: 'error',
+            requestId: msg.requestId,
+            message: errMessage(err),
+        });
+    }
+}
+async function handleNext(msg) {
+    const open = sources.get(msg.sourceId);
+    if (!open) {
+        post({
+            kind: 'error',
+            requestId: msg.requestId,
+            message: `Unknown sourceId ${msg.sourceId}`,
+        });
+        return;
+    }
+    try {
+        const chunk = await open.source.next(msg.maxPoints, open.abort.signal);
+        if (!chunk) {
+            post({
+                kind: 'chunk',
+                requestId: msg.requestId,
+                sourceId: msg.sourceId,
+                chunk: null,
+            });
+            return;
+        }
+        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: errMessage(err),
+        });
+    }
+}
+function handleClose(sourceId) {
+    const open = sources.get(sourceId);
+    if (!open)
+        return;
+    try {
+        open.abort.abort();
+        open.source.close();
+    }
+    catch (err) {
+        console.warn('[decode-worker] close failed:', errMessage(err));
+    }
+    sources.delete(sourceId);
+}
+function handleAbort(sourceId) {
+    const open = sources.get(sourceId);
+    if (!open)
+        return;
+    open.abort.abort();
+}
+function createSource(format, blob, opts) {
+    if (format === 'las')
+        return new LasStreamingSource(blob, opts);
+    if (format === 'laz')
+        return new LazStreamingSource(blob, opts);
+    if (format === 'ply')
+        return new PlyStreamingSource(blob, opts);
+    if (format === 'pcd')
+        return new PcdStreamingSource(blob, opts);
+    if (format === 'e57')
+        return new E57StreamingSource(blob, opts);
+    throw new Error(`decode-worker: unknown format "${format}"`);
+}
+function post(msg, transfer = []) {
+    self.postMessage(msg, transfer);
+}
+function errMessage(err) {
+    if (err instanceof Error)
+        return err.message;
+    return String(err);
+}
+//# sourceMappingURL=decode-worker.js.map

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

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

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

@@ -0,0 +1,17 @@
+import type { DecodedPointChunk } from '../types.js';
+import type { DownsampleHint, PointSourceInfo, StreamingPointSource } from './types.js';
+export declare class E57StreamingSource 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=e57-source.d.ts.map

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

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

@@ -0,0 +1,83 @@
+/* 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 { decodeE57 } from '../formats/e57.js';
+export class E57StreamingSource {
+    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 = decodeE57(new Uint8Array(buf));
+        if (!decoded) {
+            throw new Error('E57: file contains no Data3D scans');
+        }
+        this.chunk = applyStride(decoded, this.downsample.stride);
+        return {
+            totalPointCount: this.chunk.pointCount,
+            bbox: this.chunk.bbox,
+            hasColor: !!this.chunk.colors,
+            hasClassification: false,
+            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;
+    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 (intensities && chunk.intensities) {
+            intensities[dst] = chunk.intensities[i];
+        }
+        dst++;
+    }
+    return {
+        positions,
+        colors,
+        intensities,
+        pointCount: newCount,
+        bbox: chunk.bbox,
+    };
+}
+function abortIfAborted(signal) {
+    if (signal?.aborted) {
+        throw new DOMException('Aborted', 'AbortError');
+    }
+}
+//# sourceMappingURL=e57-source.js.map

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

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

package/dist/streaming/host.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Host-side helper that drives a `StreamingPointSource` to completion,
+ * applies a memory-cap downsampling policy, and emits decoded chunks
+ * to a callback.
+ *
+ * Renderers consume this directly: pass `onChunk` as your "upload to
+ * GPU" callback and the host takes care of pacing, abort, and the
+ * end-of-stream `onComplete` notification.
+ */
+import type { DecodedPointChunk, PointCloudBBox } from '../types.js';
+import { type CreateDecodeWorkerSourceOptions, type DecodeWorkerFormat } from './worker-client.js';
+import type { PointSourceInfo, StreamingPointSource } from './types.js';
+export interface StreamPointCloudOptions {
+    /** Source format. */
+    format: DecodeWorkerFormat;
+    /** File or remote-fetched blob. */
+    blob: Blob;
+    /** Optional label (filename, URL) for diagnostics. */
+    label?: string;
+    /**
+     * Soft memory cap measured in points. When the source declares more
+     * than this, the host applies stride-based downsampling so the chunks
+     * fit. Default: 25 million (~600 MB GPU at the 24-byte/point format).
+     */
+    maxPointsInMemory?: number;
+    /** Hard size ceiling — if `blob.size` exceeds, the call rejects. */
+    maxFileSize?: number;
+    /** Points per chunk during streaming decode. Default: 200_000. */
+    chunkSize?: number;
+    /** Called once after the source's header parses. */
+    onOpen?: (info: PointSourceInfo & {
+        stride: number;
+    }) => void;
+    /** Called for each decoded chunk. */
+    onChunk: (chunk: DecodedPointChunk) => void;
+    /** Periodic progress signal in 0..1. */
+    onProgress?: (loaded: number, total: number) => void;
+    /** Called once with the aggregated bbox once the stream finishes. */
+    onComplete?: (bbox: PointCloudBBox, totalEmitted: number) => void;
+    /** Called if the source errors mid-stream. */
+    onError?: (err: Error) => void;
+    /** Abort signal for the whole stream. */
+    signal?: AbortSignal;
+    /** Override the source factory (used by tests). */
+    createSource?: (opts: CreateDecodeWorkerSourceOptions) => StreamingPointSource;
+}
+export interface StreamHandle {
+    /** Cancel pending and future decode work. */
+    cancel(): void;
+    /** Resolves once the stream finishes successfully or is cancelled. */
+    done: Promise<void>;
+}
+export declare function streamPointCloud(opts: StreamPointCloudOptions): StreamHandle;
+//# sourceMappingURL=host.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/streaming/host.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAEL,KAAK,+BAA+B,EACpC,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAExE,MAAM,WAAW,uBAAuB;IACtC,qBAAqB;IACrB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,mCAAmC;IACnC,IAAI,EAAE,IAAI,CAAC;IACX,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,oDAAoD;IACpD,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC9D,qCAAqC;IACrC,OAAO,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC5C,wCAAwC;IACxC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,qEAAqE;IACrE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IAClE,8CAA8C;IAC9C,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;IAE/B,yCAAyC;IACzC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,mDAAmD;IACnD,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,+BAA+B,KAAK,oBAAoB,CAAC;CAChF;AAMD,MAAM,WAAW,YAAY;IAC3B,6CAA6C;IAC7C,MAAM,IAAI,IAAI,CAAC;IACf,sEAAsE;IACtE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CACrB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,uBAAuB,GAAG,YAAY,CA2F5E"}