@ifc-lite/pointcloud 0.7.2 → 0.9.0

package/dist/streaming/pcd-source.js

@@ -76,6 +76,7 @@ function applyStride(chunk, stride) {
     return {
         positions,
         colors,
+        normalState: chunk.normalState,
         classifications,
         intensities,
         pointCount: newCount,

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

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

@@ -1,27 +1,19 @@
-/**
- * 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 PlyStreamInstrumentation } from './ply-stream-decode.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;
-    /** See `decodePly`'s `originOffset` param (extends #1804's LAS/LAZ
-     *  pattern). */
-    private originOffset?;
+    private readonly blob;
+    private readonly downsample;
+    private readonly label?;
+    private readonly originOffset?;
+    private readonly instrumentation?;
+    private reader;
     constructor(blob: Blob, options?: {
         label?: string;
         downsample?: DownsampleHint;
         originOffset?: readonly [number, number, number];
+        /** @internal Regression instrumentation; production callers omit it. */
+        instrumentation?: PlyStreamInstrumentation;
     });
     open(signal?: AbortSignal): Promise<PointSourceInfo>;
     next(maxPoints: number, signal?: AbortSignal): Promise<DecodedPointChunk | null>;

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

@@ -1 +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;IACvB;oBACgB;IAChB,OAAO,CAAC,YAAY,CAAC,CAAoC;gBAGvD,IAAI,EAAE,IAAI,EACV,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,cAAc,CAAC;QAC5B,YAAY,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;KAC7C;IAQF,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"}
+{"version":3,"file":"ply-source.d.ts","sourceRoot":"","sources":["../../src/streaming/ply-source.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAiC,KAAK,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAEtG,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAKxF,qBAAa,kBAAmB,YAAW,oBAAoB;IAQ3D,OAAO,CAAC,QAAQ,CAAC,IAAI;IAPvB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiB;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAoC;IAClE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAA2B;IAC5D,OAAO,CAAC,MAAM,CAA+B;gBAG1B,IAAI,EAAE,IAAI,EAC3B,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,cAAc,CAAC;QAC5B,YAAY,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACjD,wEAAwE;QACxE,eAAe,CAAC,EAAE,wBAAwB,CAAC;KACvC;IAQF,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;IA0BpD,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAKtF,KAAK,IAAI,IAAI;CAGd"}

package/dist/streaming/ply-source.js

@@ -1,102 +1,72 @@
 /* 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';
+/**
+ * PLY streaming source.
+ *
+ * `open()` scans header and bounds in fixed-size byte windows without
+ * allocating point channels. `next()` decodes directly into a bounded output
+ * chunk and skips unretained stride rows before allocation. A cap probe and
+ * its downsampled reopen therefore never materialise full-count XYZ/RGB/normal
+ * arrays.
+ */
+import { inspectPlyVertex, parsePlyHeader } from '../formats/ply.js';
+import { PlyChunkReader, scanPlyBounds } from './ply-stream-decode.js';
+import { normalizePointStride } from './stride.js';
+const HEADER_BYTES = 65_536;
+const HEADER_DECODER = new TextDecoder();
 export class PlyStreamingSource {
     blob;
     downsample;
     label;
-    chunk = null;
-    served = false;
-    /** See `decodePly`'s `originOffset` param (extends #1804's LAS/LAZ
-     *  pattern). */
     originOffset;
+    instrumentation;
+    reader = null;
     constructor(blob, options = {}) {
         this.blob = blob;
         this.downsample = options.downsample ?? { stride: 1 };
         this.label = options.label;
         this.originOffset = options.originOffset;
+        this.instrumentation = options.instrumentation;
     }
     async open(signal) {
+        this.close();
         abortIfAborted(signal);
-        const buf = await this.blob.arrayBuffer();
+        const headerBytes = new Uint8Array(await this.blob.slice(0, Math.min(HEADER_BYTES, this.blob.size)).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.originOffset);
-        this.chunk = applyStride(fullChunk, this.downsample.stride);
+        if (headerBytes.byteLength === HEADER_BYTES && !hasCompleteHeader(headerBytes)) {
+            throw new Error(`PLY: header exceeds the bounded ${HEADER_BYTES}-byte streaming limit`);
+        }
+        const header = parsePlyHeader(headerBytes);
+        const layout = inspectPlyVertex(header);
+        const scan = await scanPlyBounds(this.blob, header, layout, this.originOffset, signal);
+        const stride = normalizePointStride(this.downsample.stride);
+        this.reader = new PlyChunkReader(this.blob, header, layout, stride, this.originOffset, scan.normalState, scan.floatColorsUseByteRange, this.instrumentation);
+        const properties = layout.vertex.properties;
+        const has = (...names) => properties.some((property) => names.includes(property.name));
         return {
-            totalPointCount: this.chunk.pointCount,
-            bbox: this.chunk.bbox,
-            hasColor: hasRgb,
+            totalPointCount: Math.ceil(layout.vertex.count / stride),
+            bbox: scan.bbox,
+            hasColor: has('red', 'r') && has('green', 'g') && has('blue', 'b'),
             hasClassification: false,
-            hasIntensity,
+            hasIntensity: has('intensity', 'scalar_Intensity'),
             label: this.label,
         };
     }
     async next(maxPoints, signal) {
-        abortIfAborted(signal);
-        if (!this.chunk || this.served)
+        if (!this.reader)
             return null;
-        void maxPoints; // Whole-file decode: ignore chunk-size hint.
-        this.served = true;
-        return this.chunk;
+        return this.reader.next(maxPoints, signal);
     }
     close() {
-        this.chunk = null;
-        this.served = false;
+        this.reader = null;
     }
 }
-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 hasCompleteHeader(bytes) {
+    return /(?:^|\n)[\t ]*end_header[\t ]*\r?\n/.test(HEADER_DECODER.decode(bytes));
 }
 function abortIfAborted(signal) {
-    if (signal?.aborted) {
+    if (signal?.aborted)
         throw new DOMException('Aborted', 'AbortError');
-    }
 }
 //# sourceMappingURL=ply-source.js.map

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

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

package/dist/streaming/ply-stream-decode.d.ts

@@ -0,0 +1,32 @@
+import type { DecodedPointChunk, PointCloudBBox, PointNormalState } from '../types.js';
+import type { PlyHeader, PlyVertexLayout } from '../formats/ply.js';
+export declare const PLY_STREAM_READ_BYTES: number;
+export interface PlyStreamInstrumentation {
+    /** Test-only observation of output channel capacity; no source-count buffer is allocated. */
+    onOutputAllocation?: (pointCapacity: number) => void;
+}
+export declare function scanPlyBounds(blob: Blob, header: PlyHeader, layout: PlyVertexLayout, origin: readonly [number, number, number] | undefined, signal?: AbortSignal): Promise<{
+    bbox: PointCloudBBox;
+    normalState: PointNormalState;
+    floatColorsUseByteRange: boolean;
+}>;
+export declare class PlyChunkReader {
+    private readonly blob;
+    private readonly header;
+    private readonly layout;
+    private readonly stride;
+    private readonly origin;
+    private readonly normalState;
+    private readonly floatColorsUseByteRange;
+    private readonly instrumentation?;
+    private sourceRow;
+    private readonly ascii;
+    private readonly channels;
+    private readonly variableBinary;
+    constructor(blob: Blob, header: PlyHeader, layout: PlyVertexLayout, stride: number, origin: readonly [number, number, number] | undefined, normalState: PointNormalState, floatColorsUseByteRange: boolean, instrumentation?: PlyStreamInstrumentation | undefined);
+    next(maxPoints: number, signal?: AbortSignal): Promise<DecodedPointChunk | null>;
+    private readBinary;
+    private readVariableBinary;
+    private readAscii;
+}
+//# sourceMappingURL=ply-stream-decode.d.ts.map

package/dist/streaming/ply-stream-decode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ply-stream-decode.d.ts","sourceRoot":"","sources":["../../src/streaming/ply-stream-decode.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACvF,OAAO,KAAK,EAAE,SAAS,EAAmB,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGrF,eAAO,MAAM,qBAAqB,QAAkB,CAAC;AAQrD,MAAM,WAAW,wBAAwB;IACvC,6FAA6F;IAC7F,kBAAkB,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,IAAI,CAAC;CACtD;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACrD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,WAAW,EAAE,gBAAgB,CAAC;IAAC,uBAAuB,EAAE,OAAO,CAAA;CAAE,CAAC,CA2DpG;AAED,qBAAa,cAAc;IAOvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,uBAAuB;IACxC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IAbnC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA4B;gBAGxC,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACrD,WAAW,EAAE,gBAAgB,EAC7B,uBAAuB,EAAE,OAAO,EAChC,eAAe,CAAC,EAAE,wBAAwB,YAAA;IAQvD,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;YAexE,UAAU;YA2BV,kBAAkB;YAUlB,SAAS;CAkBxB"}

package/dist/streaming/ply-stream-decode.js

@@ -0,0 +1,363 @@
+/* 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 { floatColorSelectsByteRange, normalizeColorChannel } from '../formats/ply-color.js';
+import { readPlyScalar } from '../formats/ply-scalar.js';
+import { parseAsciiVariableRow, writeVariablePlyRow } from '../formats/ply-variable-row.js';
+import { BinaryPlyRowCursor } from './ply-variable-stream.js';
+export const PLY_STREAM_READ_BYTES = 4 * 1024 * 1024;
+const TEXT_DECODER = new TextDecoder();
+export async function scanPlyBounds(blob, header, layout, origin, signal) {
+    if (!Number.isSafeInteger(layout.vertex.count) || layout.vertex.count < 0) {
+        throw new Error(`PLY: invalid vertex count ${layout.vertex.count}`);
+    }
+    const bounds = emptyBounds();
+    let normalState = layout.normalState;
+    let floatColorsUseByteRange = false;
+    const channels = findChannels(layout);
+    if (header.format === 'ascii') {
+        const cursor = new AsciiLineCursor(blob, header.bodyOffset);
+        const indices = positionColumns(layout);
+        for (let row = 0; row < layout.vertex.count; row++) {
+            abortIfAborted(signal);
+            const line = await cursor.next(signal);
+            if (line === null)
+                throw new Error(`PLY ascii: expected ${layout.vertex.count} vertex lines, got ${row}`);
+            const parts = line.split(/\s+/);
+            if (layout.vertex.hasListProperty) {
+                const values = parseAsciiVariableRow(parts, layout.vertex.propertyOrder, row);
+                extendBounds(bounds, (values.get('x') ?? Number.NaN) - (origin?.[0] ?? 0), (values.get('y') ?? Number.NaN) - (origin?.[1] ?? 0), (values.get('z') ?? Number.NaN) - (origin?.[2] ?? 0));
+                normalState = observeValues(values, normalState);
+                floatColorsUseByteRange ||= valuesUseByteColors(values, channels);
+            }
+            else {
+                requireColumns(parts, layout.vertex.properties.length, row);
+                extendBounds(bounds, Number(parts[indices[0]]) - (origin?.[0] ?? 0), Number(parts[indices[1]]) - (origin?.[1] ?? 0), Number(parts[indices[2]]) - (origin?.[2] ?? 0));
+                normalState = observeAsciiRow(parts, layout, channels, normalState);
+                floatColorsUseByteRange ||= asciiUsesByteColors(parts, layout, channels);
+            }
+        }
+    }
+    else {
+        if (layout.vertex.hasListProperty) {
+            const cursor = new BinaryPlyRowCursor(blob, header.bodyOffset, header.format === 'binary_little_endian');
+            for (let row = 0; row < layout.vertex.count; row++) {
+                const values = await cursor.row(layout.vertex.propertyOrder, row, signal);
+                extendBounds(bounds, (values.get('x') ?? Number.NaN) - (origin?.[0] ?? 0), (values.get('y') ?? Number.NaN) - (origin?.[1] ?? 0), (values.get('z') ?? Number.NaN) - (origin?.[2] ?? 0));
+                normalState = observeValues(values, normalState);
+                floatColorsUseByteRange ||= valuesUseByteColors(values, channels);
+            }
+            return { bbox: bounds, normalState, floatColorsUseByteRange };
+        }
+        const recordSize = layout.vertex.recordSize;
+        const bodyBytes = layout.vertex.count * recordSize;
+        const requiredEnd = header.bodyOffset + bodyBytes;
+        if (!Number.isSafeInteger(bodyBytes) || !Number.isSafeInteger(requiredEnd))
+            throw new Error('PLY: binary vertex byte span exceeds the safe integer range');
+        if (blob.size < requiredEnd)
+            throw new Error(`PLY binary: expected ${layout.vertex.count * recordSize} body bytes, got ${blob.size - header.bodyOffset}`);
+        const recordsPerRead = Math.max(1, Math.floor(PLY_STREAM_READ_BYTES / recordSize));
+        for (let first = 0; first < layout.vertex.count; first += recordsPerRead) {
+            abortIfAborted(signal);
+            const count = Math.min(recordsPerRead, layout.vertex.count - first);
+            const bytes = await readSlice(blob, header.bodyOffset + first * recordSize, count * recordSize, signal);
+            const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+            for (let row = 0; row < count; row++) {
+                const base = row * recordSize;
+                extendBinaryBounds(bounds, view, base, layout, header, origin);
+                normalState = observeBinaryRow(view, base, layout, header, normalState);
+                floatColorsUseByteRange ||= binaryUsesByteColors(view, base, layout, channels, header);
+            }
+        }
+    }
+    return { bbox: bounds, normalState, floatColorsUseByteRange };
+}
+export class PlyChunkReader {
+    blob;
+    header;
+    layout;
+    stride;
+    origin;
+    normalState;
+    floatColorsUseByteRange;
+    instrumentation;
+    sourceRow = 0;
+    ascii;
+    channels;
+    variableBinary;
+    constructor(blob, header, layout, stride, origin, normalState, floatColorsUseByteRange, instrumentation) {
+        this.blob = blob;
+        this.header = header;
+        this.layout = layout;
+        this.stride = stride;
+        this.origin = origin;
+        this.normalState = normalState;
+        this.floatColorsUseByteRange = floatColorsUseByteRange;
+        this.instrumentation = instrumentation;
+        this.ascii = header.format === 'ascii' ? new AsciiLineCursor(blob, header.bodyOffset) : null;
+        this.variableBinary = header.format !== 'ascii' && layout.vertex.hasListProperty
+            ? new BinaryPlyRowCursor(blob, header.bodyOffset, header.format === 'binary_little_endian') : null;
+        this.channels = findChannels(layout);
+    }
+    async next(maxPoints, signal) {
+        abortIfAborted(signal);
+        if (this.sourceRow >= this.layout.vertex.count)
+            return null;
+        const limit = Math.max(1, Math.floor(maxPoints));
+        const remainingOutput = countRetainedRows(this.sourceRow, this.layout.vertex.count, this.stride);
+        if (remainingOutput === 0)
+            return null;
+        const capacity = Math.min(limit, remainingOutput);
+        this.instrumentation?.onOutputAllocation?.(capacity);
+        const output = allocateChunk(capacity, this.layout, this.channels, this.normalState);
+        const written = this.ascii
+            ? await this.readAscii(output, capacity, signal)
+            : await this.readBinary(output, capacity, signal);
+        return finishChunk(output, written, this.channels, this.floatColorsUseByteRange);
+    }
+    async readBinary(output, capacity, signal) {
+        if (this.variableBinary)
+            return this.readVariableBinary(output, capacity, signal);
+        const recordSize = this.layout.vertex.recordSize;
+        const recordsPerRead = Math.max(1, Math.floor(PLY_STREAM_READ_BYTES / recordSize));
+        let written = 0;
+        while (written < capacity && this.sourceRow < this.layout.vertex.count) {
+            this.sourceRow += (this.stride - (this.sourceRow % this.stride)) % this.stride;
+            if (this.sourceRow >= this.layout.vertex.count)
+                break;
+            const sourceTake = Math.min(recordsPerRead, this.layout.vertex.count - this.sourceRow);
+            const bytes = await readSlice(this.blob, this.header.bodyOffset + this.sourceRow * recordSize, sourceTake * recordSize, signal);
+            if (bytes.byteLength !== sourceTake * recordSize) {
+                throw new Error(`PLY binary: expected ${sourceTake * recordSize} body bytes, got ${bytes.byteLength}`);
+            }
+            const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+            let processed = 0;
+            while (processed < sourceTake && written < capacity) {
+                const globalRow = this.sourceRow + processed;
+                if (globalRow % this.stride === 0) {
+                    writeBinaryRow(output, written++, view, processed * recordSize, this.layout, this.channels, this.header, this.origin);
+                }
+                processed++;
+            }
+            this.sourceRow += processed;
+        }
+        return written;
+    }
+    async readVariableBinary(output, capacity, signal) {
+        let written = 0;
+        while (written < capacity && this.sourceRow < this.layout.vertex.count) {
+            const values = await this.variableBinary.row(this.layout.vertex.propertyOrder, this.sourceRow, signal);
+            if (this.sourceRow % this.stride === 0)
+                writeVariablePlyRow(values, written++, { ...output, originOffset: this.origin });
+            this.sourceRow++;
+        }
+        return written;
+    }
+    async readAscii(output, capacity, signal) {
+        const columns = asciiColumns(this.layout, this.channels);
+        let written = 0;
+        while (written < capacity && this.sourceRow < this.layout.vertex.count) {
+            const line = await this.ascii.next(signal);
+            if (line === null)
+                throw new Error(`PLY ascii: expected ${this.layout.vertex.count} vertex lines, got ${this.sourceRow}`);
+            const parts = line.split(/\s+/);
+            if (this.layout.vertex.hasListProperty) {
+                const values = parseAsciiVariableRow(parts, this.layout.vertex.propertyOrder, this.sourceRow);
+                if (this.sourceRow % this.stride === 0)
+                    writeVariablePlyRow(values, written++, { ...output, originOffset: this.origin });
+            }
+            else {
+                requireColumns(parts, this.layout.vertex.properties.length, this.sourceRow);
+                if (this.sourceRow % this.stride === 0)
+                    writeAsciiRow(output, written++, parts, columns, this.origin);
+            }
+            this.sourceRow++;
+        }
+        return written;
+    }
+}
+class AsciiLineCursor {
+    blob;
+    byteOffset;
+    pending = '';
+    pendingOffset = 0;
+    eof = false;
+    constructor(blob, bodyOffset) {
+        this.blob = blob;
+        this.byteOffset = bodyOffset;
+    }
+    async next(signal) {
+        while (true) {
+            const newline = this.pending.indexOf('\n', this.pendingOffset);
+            if (newline >= 0) {
+                const line = this.pending.slice(this.pendingOffset, newline).trim();
+                this.pendingOffset = newline + 1;
+                this.compact();
+                if (line)
+                    return line;
+                continue;
+            }
+            if (this.eof) {
+                const line = this.pending.slice(this.pendingOffset).trim();
+                this.pendingOffset = this.pending.length;
+                return line || null;
+            }
+            if (this.pending.length - this.pendingOffset >= PLY_STREAM_READ_BYTES * 2) {
+                throw new Error('PLY ascii: vertex row exceeds the bounded 8 MiB line limit');
+            }
+            abortIfAborted(signal);
+            const end = Math.min(this.blob.size, this.byteOffset + PLY_STREAM_READ_BYTES);
+            const bytes = await readSlice(this.blob, this.byteOffset, end - this.byteOffset, signal);
+            this.byteOffset = end;
+            this.pending += TEXT_DECODER.decode(bytes);
+            this.eof = end >= this.blob.size;
+        }
+    }
+    compact() {
+        if (this.pendingOffset < PLY_STREAM_READ_BYTES)
+            return;
+        this.pending = this.pending.slice(this.pendingOffset);
+        this.pendingOffset = 0;
+    }
+}
+function allocateChunk(capacity, layout, channels, normalState) {
+    return {
+        positions: new Float32Array(capacity * 3),
+        colors: channels.r && channels.g && channels.b ? new Float32Array(capacity * 3) : undefined,
+        normals: layout.nxProp && layout.nyProp && layout.nzProp ? new Float32Array(capacity * 3) : undefined,
+        normalState,
+        intensities: channels.intensity ? new Uint16Array(capacity) : undefined,
+        pointCount: capacity,
+        bbox: emptyBounds(),
+    };
+}
+function finishChunk(output, written, channels, floatColorsUseByteRange) {
+    if (output.colors && channels.r && channels.g && channels.b) {
+        const types = [channels.r.type, channels.g.type, channels.b.type];
+        for (let i = 0; i < output.colors.length; i++)
+            output.colors[i] = normalizeColorChannel(output.colors[i], types[i % 3], floatColorsUseByteRange);
+    }
+    output.pointCount = written;
+    output.bbox = computeBounds(output.positions, written);
+    if (written === output.positions.length / 3)
+        return output;
+    output.positions = output.positions.slice(0, written * 3);
+    if (output.colors)
+        output.colors = output.colors.slice(0, written * 3);
+    if (output.normals)
+        output.normals = output.normals.slice(0, written * 3);
+    if (output.intensities)
+        output.intensities = output.intensities.slice(0, written);
+    return output;
+}
+function writeBinaryRow(output, dst, view, base, layout, channels, header, origin) {
+    const le = header.format === 'binary_little_endian';
+    output.positions[dst * 3] = scalar(view, base, layout.xProp, le) - (origin?.[0] ?? 0);
+    output.positions[dst * 3 + 1] = scalar(view, base, layout.yProp, le) - (origin?.[1] ?? 0);
+    output.positions[dst * 3 + 2] = scalar(view, base, layout.zProp, le) - (origin?.[2] ?? 0);
+    if (output.colors && channels.r && channels.g && channels.b) {
+        output.colors[dst * 3] = scalar(view, base, channels.r, le);
+        output.colors[dst * 3 + 1] = scalar(view, base, channels.g, le);
+        output.colors[dst * 3 + 2] = scalar(view, base, channels.b, le);
+    }
+    if (output.normals && layout.nxProp && layout.nyProp && layout.nzProp) {
+        output.normals[dst * 3] = scalar(view, base, layout.nxProp, le);
+        output.normals[dst * 3 + 1] = scalar(view, base, layout.nyProp, le);
+        output.normals[dst * 3 + 2] = scalar(view, base, layout.nzProp, le);
+    }
+    if (output.intensities && channels.intensity)
+        output.intensities[dst] = clampIntensity(scalar(view, base, channels.intensity, le));
+}
+function writeAsciiRow(output, dst, parts, columns, origin) {
+    output.positions[dst * 3] = Number(parts[columns.x]) - (origin?.[0] ?? 0);
+    output.positions[dst * 3 + 1] = Number(parts[columns.y]) - (origin?.[1] ?? 0);
+    output.positions[dst * 3 + 2] = Number(parts[columns.z]) - (origin?.[2] ?? 0);
+    if (output.colors) {
+        output.colors[dst * 3] = Number(parts[columns.r]);
+        output.colors[dst * 3 + 1] = Number(parts[columns.g]);
+        output.colors[dst * 3 + 2] = Number(parts[columns.b]);
+    }
+    if (output.normals) {
+        output.normals[dst * 3] = Number(parts[columns.nx]);
+        output.normals[dst * 3 + 1] = Number(parts[columns.ny]);
+        output.normals[dst * 3 + 2] = Number(parts[columns.nz]);
+    }
+    if (output.intensities)
+        output.intensities[dst] = clampIntensity(Number(parts[columns.intensity]));
+}
+function extendBinaryBounds(bounds, view, base, layout, header, origin) {
+    const le = header.format === 'binary_little_endian';
+    extendBounds(bounds, readPlyScalar(view, base + layout.xProp.offset, layout.xProp, le) - (origin?.[0] ?? 0), readPlyScalar(view, base + layout.yProp.offset, layout.yProp, le) - (origin?.[1] ?? 0), readPlyScalar(view, base + layout.zProp.offset, layout.zProp, le) - (origin?.[2] ?? 0));
+}
+function findChannels(layout) {
+    const find = (...names) => layout.vertex.properties.find((property) => names.includes(property.name));
+    return { r: find('red', 'r'), g: find('green', 'g'), b: find('blue', 'b'), intensity: find('intensity', 'scalar_Intensity') };
+}
+function usableNormal(x, y, z) {
+    const stored = [Math.fround(x), Math.fround(y), Math.fround(z)];
+    return stored.every(Number.isFinite) && stored.some(value => value !== 0);
+}
+function observeValues(values, state) {
+    if (state !== 'supplied')
+        return state;
+    return usableNormal(values.get('nx') ?? Number.NaN, values.get('ny') ?? Number.NaN, values.get('nz') ?? Number.NaN) ? state : 'invalid';
+}
+function valuesUseByteColors(values, channels) {
+    return [channels.r, channels.g, channels.b].some(property => property
+        && floatColorSelectsByteRange(values.get(property.name) ?? Number.NaN, property.type));
+}
+function observeAsciiRow(parts, layout, _channels, state) {
+    if (state !== 'supplied' || !layout.nxProp || !layout.nyProp || !layout.nzProp)
+        return state;
+    const index = (property) => layout.vertex.properties.indexOf(property);
+    return usableNormal(Number(parts[index(layout.nxProp)]), Number(parts[index(layout.nyProp)]), Number(parts[index(layout.nzProp)])) ? state : 'invalid';
+}
+function observeBinaryRow(view, base, layout, header, state) {
+    if (state !== 'supplied' || !layout.nxProp || !layout.nyProp || !layout.nzProp)
+        return state;
+    const le = header.format === 'binary_little_endian';
+    return usableNormal(scalar(view, base, layout.nxProp, le), scalar(view, base, layout.nyProp, le), scalar(view, base, layout.nzProp, le)) ? state : 'invalid';
+}
+function asciiUsesByteColors(parts, layout, channels) {
+    return [channels.r, channels.g, channels.b].some((property) => property
+        && floatColorSelectsByteRange(Number(parts[layout.vertex.properties.indexOf(property)]), property.type));
+}
+function binaryUsesByteColors(view, base, layout, channels, header) {
+    const le = header.format === 'binary_little_endian';
+    return [channels.r, channels.g, channels.b].some((property) => property
+        && floatColorSelectsByteRange(scalar(view, base, property, le), property.type));
+}
+function positionColumns(layout) { return [layout.vertex.properties.indexOf(layout.xProp), layout.vertex.properties.indexOf(layout.yProp), layout.vertex.properties.indexOf(layout.zProp)]; }
+function asciiColumns(layout, channels) {
+    const index = (property) => property ? layout.vertex.properties.indexOf(property) : -1;
+    return { x: index(layout.xProp), y: index(layout.yProp), z: index(layout.zProp), r: index(channels.r), g: index(channels.g), b: index(channels.b), nx: index(layout.nxProp), ny: index(layout.nyProp), nz: index(layout.nzProp), intensity: index(channels.intensity) };
+}
+function requireColumns(parts, count, row) { if (parts.length < count)
+    throw new Error(`PLY ascii: vertex row ${row + 1} has ${parts.length} values; expected ${count}`); }
+function clampIntensity(value) { return Math.min(65535, Math.max(0, value | 0)); }
+function scalar(view, base, property, le) { return readPlyScalar(view, base + property.offset, property, le); }
+function countRetainedRows(first, count, stride) {
+    const aligned = first + ((stride - (first % stride)) % stride);
+    return aligned >= count ? 0 : Math.floor((count - 1 - aligned) / stride) + 1;
+}
+function emptyBounds() { return { min: [Infinity, Infinity, Infinity], max: [-Infinity, -Infinity, -Infinity] }; }
+function extendBounds(bounds, x, y, z) {
+    if (x < bounds.min[0])
+        bounds.min[0] = x;
+    if (x > bounds.max[0])
+        bounds.max[0] = x;
+    if (y < bounds.min[1])
+        bounds.min[1] = y;
+    if (y > bounds.max[1])
+        bounds.max[1] = y;
+    if (z < bounds.min[2])
+        bounds.min[2] = z;
+    if (z > bounds.max[2])
+        bounds.max[2] = z;
+}
+function computeBounds(positions, count) { const bounds = emptyBounds(); for (let i = 0; i < count; i++)
+    extendBounds(bounds, positions[i * 3], positions[i * 3 + 1], positions[i * 3 + 2]); return bounds; }
+async function readSlice(blob, offset, length, signal) { abortIfAborted(signal); const bytes = new Uint8Array(await blob.slice(offset, offset + length).arrayBuffer()); abortIfAborted(signal); return bytes; }
+function abortIfAborted(signal) { if (signal?.aborted)
+    throw new DOMException('Aborted', 'AbortError'); }
+//# sourceMappingURL=ply-stream-decode.js.map