@ifc-lite/pointcloud 0.2.0 → 0.3.0

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

@@ -0,0 +1,55 @@
+export interface PrototypeField {
+    name: string;
+    kind: 'Float' | 'ScaledInteger' | 'Integer';
+    precision?: 'single' | 'double';
+    scale?: number;
+    offset?: number;
+    minimum?: number;
+    maximum?: number;
+}
+/**
+ * Per-scan pose: rotation (unit quaternion w + xi + yj + zk) +
+ * translation (in source-frame metres). Optional because most
+ * single-scan exports don't need one — when absent we treat the
+ * scan as already in the file's global frame (identity pose).
+ */
+export interface E57Pose {
+    rotation: {
+        w: number;
+        x: number;
+        y: number;
+        z: number;
+    };
+    translation: {
+        x: number;
+        y: number;
+        z: number;
+    };
+}
+export interface Data3DEntry {
+    guid: string;
+    name?: string;
+    recordCount: number;
+    /** Logical offset into the file where the binary section begins. */
+    binaryFileOffset: number;
+    /** Field declarations in record order. */
+    prototype: PrototypeField[];
+    /**
+     * Per-Data3D pose that places the scan into the file's global
+     * frame. Applied by `decodeE57` before merging multi-scan files;
+     * single-scan files where the pose is identity / absent are no-ops.
+     */
+    pose?: E57Pose;
+}
+/**
+ * Parse the E57 XML section.
+ *
+ * Uses our own minimal SAX-style parser (`xml-mini.ts`) instead of
+ * `DOMParser` because dedicated Web Workers — where the decode runs —
+ * don't expose DOMParser. The shape we need (e57Root → data3D →
+ * vectorChild → prototype) is shallow and attribute-heavy, well within
+ * the mini parser's scope.
+ */
+export declare function parseE57Xml(xmlText: string): Data3DEntry[];
+export declare function findField(proto: PrototypeField[], name: string): PrototypeField | undefined;
+//# sourceMappingURL=e57-xml.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"e57-xml.d.ts","sourceRoot":"","sources":["../../src/formats/e57-xml.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS,CAAC;IAC5C,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzD,WAAW,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAClD;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,gBAAgB,EAAE,MAAM,CAAC;IACzB,0CAA0C;IAC1C,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAmE1D;AA0BD,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAE3F"}

package/dist/formats/e57-xml.js

@@ -0,0 +1,127 @@
+/* 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/. */
+/**
+ * E57 XML model + parser.
+ *
+ * The XML carries the `data3D` structure: per-scan record counts, the
+ * binary CompressedVector fileOffset, and the prototype field
+ * declarations (`Float`, `Integer`, `ScaledInteger`) that describe the
+ * binary record layout.
+ */
+import { childByName, childrenByName, parseXml, textChild, } from '../xml-mini.js';
+/**
+ * Parse the E57 XML section.
+ *
+ * Uses our own minimal SAX-style parser (`xml-mini.ts`) instead of
+ * `DOMParser` because dedicated Web Workers — where the decode runs —
+ * don't expose DOMParser. The shape we need (e57Root → data3D →
+ * vectorChild → prototype) is shallow and attribute-heavy, well within
+ * the mini parser's scope.
+ */
+export function parseE57Xml(xmlText) {
+    const root = parseXml(xmlText);
+    if (root.name !== 'e57Root') {
+        throw new Error(`E57: XML root is not <e57Root> (saw <${root.name || '?'}>)`);
+    }
+    const data3D = childByName(root, 'data3D');
+    if (!data3D)
+        return [];
+    const entries = [];
+    for (const scan of childrenByName(data3D, 'vectorChild')) {
+        const points = childByName(scan, 'points');
+        if (!points)
+            continue;
+        if (points.attrs.get('type') !== 'CompressedVector') {
+            // Skip non-compressed-vector points (rare).
+            continue;
+        }
+        const fileOffsetAttr = points.attrs.get('fileOffset');
+        const recordCountAttr = points.attrs.get('recordCount');
+        if (!fileOffsetAttr || !recordCountAttr)
+            continue;
+        // Reject NaN / negative parses up front. Without this guard a
+        // malformed XML attribute (e.g. fileOffset="-1" or
+        // recordCount="bogus") would flow into decodeE57Scan and either
+        // overrun the bytestream walk or allocate a zero-byte position
+        // buffer — neither produces a useful diagnostic.
+        const binaryFileOffset = Number(fileOffsetAttr);
+        const recordCount = Number(recordCountAttr);
+        if (!Number.isFinite(binaryFileOffset) || binaryFileOffset < 0)
+            continue;
+        if (!Number.isFinite(recordCount) || recordCount < 0)
+            continue;
+        const proto = childByName(points, 'prototype');
+        if (!proto)
+            continue;
+        const fields = [];
+        for (const f of proto.children) {
+            const type = f.attrs.get('type') ?? '';
+            if (type === 'Float') {
+                fields.push({
+                    name: f.name,
+                    kind: 'Float',
+                    precision: f.attrs.get('precision') === 'single' ? 'single' : 'double',
+                });
+            }
+            else if (type === 'ScaledInteger') {
+                fields.push({
+                    name: f.name,
+                    kind: 'ScaledInteger',
+                    scale: Number(f.attrs.get('scale') ?? '1'),
+                    offset: Number(f.attrs.get('offset') ?? '0'),
+                    minimum: Number(f.attrs.get('minimum') ?? '0'),
+                    maximum: Number(f.attrs.get('maximum') ?? '0'),
+                });
+            }
+            else if (type === 'Integer') {
+                fields.push({
+                    name: f.name,
+                    kind: 'Integer',
+                    minimum: Number(f.attrs.get('minimum') ?? '0'),
+                    maximum: Number(f.attrs.get('maximum') ?? '0'),
+                });
+            }
+            // Other types (e.g. String) ignored — never carry point data.
+        }
+        entries.push({
+            guid: textChild(scan, 'guid') ?? '',
+            name: textChild(scan, 'name') ?? undefined,
+            recordCount,
+            binaryFileOffset,
+            prototype: fields,
+            pose: parsePoseElement(childByName(scan, 'pose')) ?? undefined,
+        });
+    }
+    return entries;
+}
+/**
+ * Parse a `<pose>` element to a quaternion + translation pair.
+ * Returns null when the element is missing or malformed (any field
+ * unparseable → fall back to identity rather than reject the file).
+ */
+function parsePoseElement(poseEl) {
+    if (!poseEl)
+        return null;
+    const rotation = childByName(poseEl, 'rotation');
+    const translation = childByName(poseEl, 'translation');
+    if (!rotation || !translation)
+        return null;
+    const qw = Number(textChild(rotation, 'w') ?? '1');
+    const qx = Number(textChild(rotation, 'x') ?? '0');
+    const qy = Number(textChild(rotation, 'y') ?? '0');
+    const qz = Number(textChild(rotation, 'z') ?? '0');
+    const tx = Number(textChild(translation, 'x') ?? '0');
+    const ty = Number(textChild(translation, 'y') ?? '0');
+    const tz = Number(textChild(translation, 'z') ?? '0');
+    if (![qw, qx, qy, qz, tx, ty, tz].every(Number.isFinite))
+        return null;
+    return {
+        rotation: { w: qw, x: qx, y: qy, z: qz },
+        translation: { x: tx, y: ty, z: tz },
+    };
+}
+export function findField(proto, name) {
+    return proto.find((p) => p.name === name);
+}
+//# sourceMappingURL=e57-xml.js.map

package/dist/formats/e57-xml.js.map

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

package/dist/formats/e57.d.ts

@@ -1,129 +1,41 @@
 /**
- * E57 (ASTM E2807-11) reader — point cloud subset.
+ * E57 (ASTM E2807-11) reader — top-level orchestrator.
  *
- * Scope:
- *   - File header (48 bytes) — magic + xmlPhysicalOffset/Length + pageSize.
- *   - Physical → logical view: every 1024-byte page ends with a 4-byte
- *     CRC32-C; we strip those to get the logical byte stream the XML +
- *     binary indices reference. CRCs are NOT validated (faster + still
- *     correct for well-formed files).
- *   - XML parsed with DOMParser to find Data3D entries with FloatNodes
- *     for cartesianX / cartesianY / cartesianZ and optional colorRed /
- *     colorGreen / colorBlue / intensity.
- *   - Binary section: walk DataPackets at the prototype's CompressedVector
- *     fileOffset, decode bytestreams as raw Float32 / Float64 columns.
- *
- * What we don't yet support:
- *   - ScaledIntegerNode encoding (bit-packed integers with scale/offset)
- *     — this is the more compact format; we throw a clear error so the
- *     caller can guide the user to a Float-encoded export.
- *   - Spherical coordinates (most files use cartesian).
- *   - Per-scan pose transforms — points come back in scan-local space.
+ * Pulls the file-header / page-CRC handling from `e57-page.ts`, the
+ * XML model from `e57-xml.ts`, and the per-scan binary decoder from
+ * `e57-decode.ts`. Re-exports the public surface so existing callers
+ * (`@ifc-lite/pointcloud` index, the streaming source, tests) keep
+ * working.
  *
- * That subset still covers a large fraction of real-world E57 files
- * (Faro, Leica, Trimble, generic exports) and gives a clean error
- * message on the rest.
+ * Scope:
+ *   - Single-scan + multi-scan files. Per-Data3D pose (quaternion +
+ *     translation) is applied before merging so registered scans
+ *     line up in the file's global frame.
+ *   - Float (single/double) AND ScaledInteger (bit-packed integer
+ *     with scale/offset per E57 §6.3.4) for cartesian fields.
+ *   - Integer / Float / ScaledInteger colour + intensity channels.
+ *
+ * Out of scope (deferred — see issue #611):
+ *   - Spherical coordinate prototypes.
  */
 import type { DecodedPointChunk } from '../types.js';
-export interface E57FileHeader {
-    majorVersion: number;
-    minorVersion: number;
-    fileLogicalSize: number;
-    xmlLogicalOffset: number;
-    xmlLogicalLength: number;
-    pageSize: number;
-}
-/** Read the 48-byte FileHeader. Throws on bad magic. */
-export declare function parseE57FileHeader(bytes: Uint8Array): E57FileHeader;
-/**
- * Strip the 4-byte CRC tail from each `pageSize`-byte physical page.
- *
- * Returns a freshly-allocated buffer of "logical" bytes — the form that
- * XML offsets and CompressedVector data offsets reference.
- *
- * `pageSize` is read from the header and is conventionally 1024.
- */
-export declare function stripPageCrc(bytes: Uint8Array, pageSize: number): Uint8Array;
-/**
- * Read a CompressedVector binary-section header (E57 spec §6.4.2) and
- * return the LOGICAL byte offset where its DataPackets actually start.
- *
- * Layout (32 bytes):
- *   [ 0]  u8     sectionId           (must == 1 for CompressedVector)
- *   [ 1]  u8[7]  reserved
- *   [ 8]  u64 LE sectionLogicalLength
- *   [16]  u64 LE dataPhysicalOffset
- *   [24]  u64 LE indexPhysicalOffset
- *
- * The XML's `points@fileOffset` points at this section header — NOT at
- * the first DataPacket. Reading packets straight at `fileOffset` puts
- * the parser ~32 bytes off and the first u16 it reads is the low half
- * of `sectionLogicalLength`, which usually decodes as a bytestreamCount
- * of 0 (matched the user-reported `bytestreamCount (0) ≠ prototype
- * length (7)` error exactly).
- */
-export declare function resolveCompressedVectorDataOffset(logical: Uint8Array, physicalSectionOffset: number, pageSize: number): number;
-interface PrototypeField {
-    name: string;
-    kind: 'Float' | 'ScaledInteger' | 'Integer';
-    precision?: 'single' | 'double';
-    scale?: number;
-    offset?: number;
-    minimum?: number;
-    maximum?: number;
-}
-export interface Data3DEntry {
-    guid: string;
-    name?: string;
-    recordCount: number;
-    /** Logical offset into the file where the binary section begins. */
-    binaryFileOffset: number;
-    /** Field declarations in record order. */
-    prototype: PrototypeField[];
-    /**
-     * Whether this Data3D defines a `pose` element (translation +
-     * rotation that places the scan in the file's global frame). We
-     * don't apply the transform yet — single-scan files don't need it,
-     * and multi-scan files with poses are rejected upfront so we never
-     * silently merge in scan-local space.
-     */
-    hasPose?: boolean;
-}
-/**
- * Parse the E57 XML section.
- *
- * Uses our own minimal SAX-style parser (`xml-mini.ts`) instead of
- * `DOMParser` because dedicated Web Workers — where the decode runs —
- * don't expose DOMParser. The shape we need (e57Root → data3D →
- * vectorChild → prototype) is shallow and attribute-heavy, well within
- * the mini parser's scope.
- */
-export declare function parseE57Xml(xmlText: string): Data3DEntry[];
-/**
- * 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.
- *
- * Returns one DecodedPointChunk per scan; caller can concatenate or
- * emit them as separate streaming chunks.
- *
- * Limitations (Phase-1 E57):
- *   - Only Float (single/double) prototype fields are decoded. Files
- *     using ScaledInteger throw a clear error so the host can fall back
- *     gracefully.
- *   - Reads only cartesianX/Y/Z + colorRed/Green/Blue + intensity when
- *     present. Other fields are honoured for stride math but discarded.
- */
-export declare function decodeE57Scan(logical: Uint8Array, entry: Data3DEntry): DecodedPointChunk;
+import { type E57Pose } from './e57-xml.js';
 /**
  * Decode all Data3D scans in an E57 file. Combines them into a single
  * DecodedPointChunk (positions concatenated). Returns null when the
  * file has no scans.
  */
 export declare function decodeE57(bytes: Uint8Array): DecodedPointChunk | null;
-export {};
+/**
+ * Apply a per-scan pose (rotation quaternion + translation) to a
+ * positions buffer in place: `out = R · in + T`.
+ *
+ * Quaternion is in Hamilton convention (w + xi + yj + zk); we derive
+ * the 3×3 rotation matrix once and reuse across every point in the
+ * chunk. Translation is added after rotation.
+ */
+export declare function applyPoseInPlace(positions: Float32Array, pointCount: number, pose: E57Pose): void;
+export { parseE57FileHeader, stripPageCrc, resolveCompressedVectorDataOffset, type E57FileHeader, } from './e57-page.js';
+export { parseE57Xml, type Data3DEntry, type E57Pose, } from './e57-xml.js';
+export { decodeE57Scan } from './e57-decode.js';
 //# sourceMappingURL=e57.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"e57.d.ts","sourceRoot":"","sources":["../../src/formats/e57.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAkB,MAAM,aAAa,CAAC;AAUrE,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wDAAwD;AACxD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,aAAa,CAiBnE;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAoB5E;AAUD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,UAAU,EACnB,qBAAqB,EAAE,MAAM,EAC7B,QAAQ,EAAE,MAAM,GACf,MAAM,CAgBR;AAID,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS,CAAC;IAC5C,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,gBAAgB,EAAE,MAAM,CAAC;IACzB,0CAA0C;IAC1C,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAID;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CA0D1D;AAID;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,iBAAiB,CAqLxF;AAmFD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,iBAAiB,GAAG,IAAI,CA+DrE"}
+{"version":3,"file":"e57.d.ts","sourceRoot":"","sources":["../../src/formats/e57.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAMrD,OAAO,EAAe,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAKzD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,iBAAiB,GAAG,IAAI,CAsDrE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,YAAY,EACvB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,OAAO,GACZ,IAAI,CAsBN;AAGD,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,iCAAiC,EACjC,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,OAAO,GACb,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}