@ifc-lite/pointcloud 0.2.0 → 0.3.1

package/README.md

@@ -21,6 +21,34 @@ if (chunk) {
 The renderer (`@ifc-lite/renderer`) consumes `DecodedPointChunk` values via
 `Renderer.loadPointClouds()` / `Renderer.addPointCloudChunks()`.
 
+## Streaming decode worker (zero Vite config)
+
+For streaming sources (`.las`, `.laz`, `.ply`, `.pcd`, `.e57`, `.pts`, `.xyz`)
+the decoder runs in a dedicated Web Worker so the main thread stays
+responsive. The worker is **inlined into the published package** as a
+`Blob`-URL — consumers don't need to set `worker.format: 'es'` or add the
+package to `optimizeDeps.exclude` in their Vite config.
+
+```ts
+import { createDecodeWorkerSource } from '@ifc-lite/pointcloud';
+
+const source = createDecodeWorkerSource({ format: 'las', blob: file });
+const info = await source.open();
+// drive source.next(maxPoints) → DecodedPointChunk until it returns null
+```
+
+Notes:
+
+- The inlined worker bundle is lazy-loaded — consumers that only call
+  `decodeIfcxPointAttribute` (the non-worker decoder) don't pay the bytes.
+- LAZ decoding (`format: 'laz'`) pulls in `laz-perf`'s wasm at runtime via
+  `new URL(..., import.meta.url)`, which doesn't resolve from inside a
+  `Blob`-URL worker. If you need LAZ from the published package, pass a
+  custom `spawn` callback that yields a worker capable of fetching the
+  wasm (see `DecodeWorkerOptions.spawn`).
+- Strict CSPs need `script-src 'self' blob:` to allow the `Blob`-URL
+  worker.
+
 ## License
 
 [MPL-2.0](../../LICENSE)

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

@@ -0,0 +1,61 @@
+/**
+ * PTS / XYZ ASCII point reader.
+ *
+ * Both formats are line-oriented plain-text scans. They differ only
+ * in the optional first-line point count (PTS may have one; XYZ
+ * never does) and in convention rather than syntax.
+ *
+ * Supported per-line layouts (auto-detected from column count of the
+ * first data line):
+ *   3 cols  →  X Y Z
+ *   4 cols  →  X Y Z I       (intensity, normalised 0..1 or 0..255)
+ *   6 cols  →  X Y Z R G B   (RGB 0..255)
+ *   7 cols  →  X Y Z I R G B (PTS standard layout)
+ *   9 cols  →  X Y Z I R G B Nx Ny Nz  (normals dropped)
+ *
+ * Lines starting with `#`, `//`, or blank are skipped (comment
+ * support is non-standard but common in field exports).
+ *
+ * The reader is intentionally tolerant: any column count outside the
+ * known set falls through to "X Y Z plus discarded extras" so a file
+ * with weird custom columns still loads.
+ */
+import type { DecodedPointChunk } from '../types.js';
+export type AsciiPointsFormat = 'pts' | 'xyz';
+export interface AsciiPointsLayout {
+    /** Number of whitespace-separated columns per data line. */
+    columns: number;
+    /** True if the first non-comment line is a single-integer point count. */
+    hasHeaderCount: boolean;
+    /** Resolved per-column meaning for the auto-detected layout. */
+    fields: AsciiPointsField[];
+}
+export type AsciiPointsField = 'x' | 'y' | 'z' | 'i' | 'r' | 'g' | 'b' | 'skip';
+/**
+ * Probe the first ~16 KB to decide format + column layout.
+ *
+ * Looks at the first non-blank/non-comment line:
+ *   - If it's a single integer, treat as a header point count (PTS).
+ *   - Otherwise the column count of that line determines the layout.
+ *
+ * Returns null when the buffer doesn't look like ASCII point data
+ * (e.g. binary content, non-numeric tokens). Caller can then surface
+ * a clear "not a point cloud" error.
+ */
+export declare function probeAsciiPointsLayout(buffer: Uint8Array, format: AsciiPointsFormat): AsciiPointsLayout | null;
+/**
+ * Decode an entire ASCII point file into a single `DecodedPointChunk`.
+ *
+ * For multi-gigabyte scans the streaming source (`AsciiPointsStreamingSource`)
+ * should be preferred — this path materialises everything in memory.
+ *
+ * Per-channel handling:
+ *   - Intensity: if any value > 1.0, treat the column as 0..255 and
+ *     scale to u16. Otherwise treat as 0..1 and scale to u16. Mixed
+ *     ranges within one file are uncommon; we make the call once.
+ *   - RGB: if any channel > 1.0, treat the columns as 0..255. Else 0..1.
+ */
+export declare function decodeAsciiPoints(bytes: Uint8Array, format: AsciiPointsFormat): DecodedPointChunk;
+/** Same as `decodeAsciiPoints` but takes pre-decoded text. */
+export declare function decodeAsciiPointsFromText(text: string, layout: AsciiPointsLayout): DecodedPointChunk;
+//# sourceMappingURL=ascii-points.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ascii-points.d.ts","sourceRoot":"","sources":["../../src/formats/ascii-points.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAkB,MAAM,aAAa,CAAC;AAErE,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,KAAK,CAAC;AAE9C,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,cAAc,EAAE,OAAO,CAAC;IACxB,gEAAgE;IAChE,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED,MAAM,MAAM,gBAAgB,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,MAAM,CAAC;AAIhF;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,iBAAiB,GACxB,iBAAiB,GAAG,IAAI,CAgC1B;AA6CD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,iBAAiB,GACxB,iBAAiB,CAOnB;AAED,8DAA8D;AAC9D,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,iBAAiB,GACxB,iBAAiB,CAuHnB"}

package/dist/formats/ascii-points.js

@@ -0,0 +1,243 @@
+/* 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/. */
+const TEXT_DECODER = new TextDecoder();
+/**
+ * Probe the first ~16 KB to decide format + column layout.
+ *
+ * Looks at the first non-blank/non-comment line:
+ *   - If it's a single integer, treat as a header point count (PTS).
+ *   - Otherwise the column count of that line determines the layout.
+ *
+ * Returns null when the buffer doesn't look like ASCII point data
+ * (e.g. binary content, non-numeric tokens). Caller can then surface
+ * a clear "not a point cloud" error.
+ */
+export function probeAsciiPointsLayout(buffer, format) {
+    const probeLen = Math.min(16384, buffer.length);
+    const text = TEXT_DECODER.decode(buffer.subarray(0, probeLen));
+    const lines = text.split(/\r?\n/);
+    let firstDataLine = null;
+    let hasHeaderCount = false;
+    for (let i = 0; i < lines.length; i++) {
+        const trimmed = lines[i].trim();
+        if (trimmed.length === 0)
+            continue;
+        if (trimmed.startsWith('#') || trimmed.startsWith('//'))
+            continue;
+        // PTS often begins with a single integer point count. XYZ never
+        // does — but we still accept it as a header if it parses cleanly.
+        if (i === 0 || !hasHeaderCount) {
+            const tokens = trimmed.split(/\s+/);
+            if (tokens.length === 1 && /^\d+$/.test(tokens[0])) {
+                hasHeaderCount = true;
+                continue;
+            }
+        }
+        firstDataLine = trimmed;
+        break;
+    }
+    if (firstDataLine === null)
+        return null;
+    const tokens = firstDataLine.split(/\s+/);
+    const columns = tokens.length;
+    // Sanity: every token must parse as a finite number.
+    for (const t of tokens) {
+        if (!Number.isFinite(Number(t)))
+            return null;
+    }
+    const fields = layoutFromColumnCount(columns, format);
+    if (!fields)
+        return null;
+    return { columns, hasHeaderCount, fields };
+}
+/**
+ * Resolve a column count to its field roles. Returns null when the
+ * count isn't one of the known shapes — caller should surface a clear
+ * "unsupported column layout" error rather than guess.
+ */
+function layoutFromColumnCount(columns, format) {
+    switch (columns) {
+        case 3:
+            return ['x', 'y', 'z'];
+        case 4:
+            // Convention: 4-col PTS is X Y Z I; 4-col XYZ is rarer and
+            // sometimes X Y Z R (single-channel grayscale). We treat both
+            // as intensity to keep the logic shared — single-channel
+            // colour shows up greyscale anyway.
+            return ['x', 'y', 'z', 'i'];
+        case 6:
+            return ['x', 'y', 'z', 'r', 'g', 'b'];
+        case 7:
+            // Canonical PTS (X Y Z I R G B) and the most common XYZ-with-
+            // colour-and-intensity layout.
+            return ['x', 'y', 'z', 'i', 'r', 'g', 'b'];
+        case 9:
+            // X Y Z R G B Nx Ny Nz — colour but no intensity, drop normals.
+            return ['x', 'y', 'z', 'r', 'g', 'b', 'skip', 'skip', 'skip'];
+        case 10:
+            // X Y Z I R G B Nx Ny Nz — full PTS-with-normals. Drop normals.
+            return ['x', 'y', 'z', 'i', 'r', 'g', 'b', 'skip', 'skip', 'skip'];
+        default:
+            // Tolerant fallback for unknown layouts — still emit positions
+            // from the first three columns so the cloud loads. Discard the
+            // rest. Better than rejecting the whole file.
+            if (columns >= 3 && format === 'xyz') {
+                const fields = ['x', 'y', 'z'];
+                for (let i = 3; i < columns; i++)
+                    fields.push('skip');
+                return fields;
+            }
+            return null;
+    }
+}
+/**
+ * Decode an entire ASCII point file into a single `DecodedPointChunk`.
+ *
+ * For multi-gigabyte scans the streaming source (`AsciiPointsStreamingSource`)
+ * should be preferred — this path materialises everything in memory.
+ *
+ * Per-channel handling:
+ *   - Intensity: if any value > 1.0, treat the column as 0..255 and
+ *     scale to u16. Otherwise treat as 0..1 and scale to u16. Mixed
+ *     ranges within one file are uncommon; we make the call once.
+ *   - RGB: if any channel > 1.0, treat the columns as 0..255. Else 0..1.
+ */
+export function decodeAsciiPoints(bytes, format) {
+    const layout = probeAsciiPointsLayout(bytes, format);
+    if (!layout) {
+        throw new Error(`${format.toUpperCase()}: file does not look like ASCII point data`);
+    }
+    const text = TEXT_DECODER.decode(bytes);
+    return decodeAsciiPointsFromText(text, layout);
+}
+/** Same as `decodeAsciiPoints` but takes pre-decoded text. */
+export function decodeAsciiPointsFromText(text, layout) {
+    const lines = text.split(/\r?\n/);
+    // Pre-pass: count valid data lines so we can allocate exactly.
+    // Cheap (no parsing) and saves the typed-array growth dance.
+    let dataLineCount = 0;
+    let headerSkipped = !layout.hasHeaderCount;
+    for (const raw of lines) {
+        const trimmed = raw.trim();
+        if (trimmed.length === 0)
+            continue;
+        if (trimmed.startsWith('#') || trimmed.startsWith('//'))
+            continue;
+        if (!headerSkipped) {
+            headerSkipped = true;
+            continue;
+        }
+        dataLineCount++;
+    }
+    const xIdx = layout.fields.indexOf('x');
+    const yIdx = layout.fields.indexOf('y');
+    const zIdx = layout.fields.indexOf('z');
+    const iIdx = layout.fields.indexOf('i');
+    const rIdx = layout.fields.indexOf('r');
+    const gIdx = layout.fields.indexOf('g');
+    const bIdx = layout.fields.indexOf('b');
+    const hasIntensity = iIdx >= 0;
+    const hasColor = rIdx >= 0 && gIdx >= 0 && bIdx >= 0;
+    const positions = new Float32Array(dataLineCount * 3);
+    const intensitiesRaw = hasIntensity ? new Float32Array(dataLineCount) : null;
+    const colorsRaw = hasColor ? new Float32Array(dataLineCount * 3) : null;
+    let written = 0;
+    let intensityMax = 0;
+    let colorMax = 0;
+    let bboxMinX = Infinity, bboxMinY = Infinity, bboxMinZ = Infinity;
+    let bboxMaxX = -Infinity, bboxMaxY = -Infinity, bboxMaxZ = -Infinity;
+    headerSkipped = !layout.hasHeaderCount;
+    for (const raw of lines) {
+        const trimmed = raw.trim();
+        if (trimmed.length === 0)
+            continue;
+        if (trimmed.startsWith('#') || trimmed.startsWith('//'))
+            continue;
+        if (!headerSkipped) {
+            headerSkipped = true;
+            continue;
+        }
+        const tokens = trimmed.split(/\s+/);
+        if (tokens.length < layout.columns)
+            continue;
+        const x = Number(tokens[xIdx]);
+        const y = Number(tokens[yIdx]);
+        const z = Number(tokens[zIdx]);
+        if (!Number.isFinite(x) || !Number.isFinite(y) || !Number.isFinite(z))
+            continue;
+        positions[written * 3] = x;
+        positions[written * 3 + 1] = y;
+        positions[written * 3 + 2] = z;
+        if (x < bboxMinX)
+            bboxMinX = x;
+        if (x > bboxMaxX)
+            bboxMaxX = x;
+        if (y < bboxMinY)
+            bboxMinY = y;
+        if (y > bboxMaxY)
+            bboxMaxY = y;
+        if (z < bboxMinZ)
+            bboxMinZ = z;
+        if (z > bboxMaxZ)
+            bboxMaxZ = z;
+        if (intensitiesRaw) {
+            const v = Number(tokens[iIdx]);
+            const f = Number.isFinite(v) ? v : 0;
+            intensitiesRaw[written] = f;
+            if (f > intensityMax)
+                intensityMax = f;
+        }
+        if (colorsRaw) {
+            const r = Number(tokens[rIdx]);
+            const g = Number(tokens[gIdx]);
+            const b = Number(tokens[bIdx]);
+            const rf = Number.isFinite(r) ? r : 0;
+            const gf = Number.isFinite(g) ? g : 0;
+            const bf = Number.isFinite(b) ? b : 0;
+            colorsRaw[written * 3] = rf;
+            colorsRaw[written * 3 + 1] = gf;
+            colorsRaw[written * 3 + 2] = bf;
+            const m = Math.max(rf, gf, bf);
+            if (m > colorMax)
+                colorMax = m;
+        }
+        written++;
+    }
+    // Trim if some lines got rejected.
+    const trimmedPositions = written === dataLineCount ? positions : positions.subarray(0, written * 3);
+    // Normalise intensity to u16 (0..65535). Detect 0..255 vs 0..1 vs
+    // raw sensor by the observed maximum.
+    let intensities;
+    if (intensitiesRaw) {
+        intensities = new Uint16Array(written);
+        const scale = intensityMax > 1.0
+            ? (intensityMax > 255 ? 65535 / intensityMax : 65535 / 255)
+            : 65535;
+        for (let i = 0; i < written; i++) {
+            const v = intensitiesRaw[i] * scale;
+            intensities[i] = v < 0 ? 0 : v > 65535 ? 65535 : Math.round(v);
+        }
+    }
+    // Normalise colour to 0..1 floats.
+    let colors;
+    if (colorsRaw) {
+        colors = new Float32Array(written * 3);
+        const scale = colorMax > 1.0 ? 1 / 255 : 1;
+        for (let i = 0; i < written * 3; i++) {
+            const v = colorsRaw[i] * scale;
+            colors[i] = v < 0 ? 0 : v > 1 ? 1 : v;
+        }
+    }
+    const bbox = written === 0
+        ? { min: [0, 0, 0], max: [0, 0, 0] }
+        : { min: [bboxMinX, bboxMinY, bboxMinZ], max: [bboxMaxX, bboxMaxY, bboxMaxZ] };
+    return {
+        positions: written === dataLineCount ? positions : new Float32Array(trimmedPositions),
+        colors,
+        intensities,
+        pointCount: written,
+        bbox,
+    };
+}
+//# sourceMappingURL=ascii-points.js.map

package/dist/formats/ascii-points.js.map

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

package/dist/formats/e57-decode.d.ts

@@ -0,0 +1,28 @@
+/**
+ * E57 binary-section decoder for a single Data3D scan.
+ *
+ * Walks DataPackets at `entry.binaryFileOffset` (in the LOGICAL
+ * post-CRC view) and decodes per-record bytestreams as Float32 /
+ * Float64 / Integer / ScaledInteger columns. ScaledInteger is a
+ * bit-packed integer with a per-field scale + offset (E57 spec
+ * §6.3.4) — common in Faro / Trimble / Leica exports.
+ */
+import type { DecodedPointChunk, PointCloudBBox } from '../types.js';
+import { type Data3DEntry } from './e57-xml.js';
+/**
+ * Decode the binary section starting at `entry.binaryFileOffset` in the
+ * logical-bytes view. NOTE: `binaryFileOffset` here must already point
+ * at the first DataPacket (i.e. AFTER the 32-byte CompressedVector
+ * section header) — `decodeE57` does this conversion via
+ * `resolveCompressedVectorDataOffset`. Callers passing the raw XML
+ * offset directly will see a "bytestreamCount ≠ prototype length"
+ * mismatch.
+ *
+ * Supports Float (single/double), ScaledInteger (bit-packed integer
+ * with scale/offset), and Integer for cartesianX/Y/Z + colorRed/
+ * Green/Blue + intensity. Other prototype fields are honoured for
+ * stride math but discarded.
+ */
+export declare function decodeE57Scan(logical: Uint8Array, entry: Data3DEntry): DecodedPointChunk;
+export declare function computeBBox(positions: Float32Array): PointCloudBBox;
+//# sourceMappingURL=e57-decode.d.ts.map

package/dist/formats/e57-decode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"e57-decode.d.ts","sourceRoot":"","sources":["../../src/formats/e57-decode.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAa,KAAK,WAAW,EAAuB,MAAM,cAAc,CAAC;AAEhF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,iBAAiB,CAqKxF;AAuRD,wBAAgB,WAAW,CAAC,SAAS,EAAE,YAAY,GAAG,cAAc,CAsBnE"}