@loaders.gl/splats 4.5.0-alpha.1

package/dist/lib/parse-rad.d.ts

@@ -0,0 +1,136 @@
+/** Spark RAD splat quantization and shader decode range metadata. */
+export type RADSplatEncoding = {
+    /** Minimum RGB value encoded into quantized color properties. */
+    rgbMin?: number;
+    /** Maximum RGB value encoded into quantized color properties. */
+    rgbMax?: number;
+    /** Minimum natural log scale encoded into quantized scale properties. */
+    lnScaleMin?: number;
+    /** Maximum natural log scale encoded into quantized scale properties. */
+    lnScaleMax?: number;
+    /** Maximum absolute SH degree-1 coefficient value. */
+    sh1Max?: number;
+    /** Maximum absolute SH degree-2 coefficient value. */
+    sh2Max?: number;
+    /** Maximum absolute SH degree-3 coefficient value. */
+    sh3Max?: number;
+    /** Whether opacity is encoded for LoD blending. */
+    lodOpacity?: boolean;
+    /** Additional splat-encoding properties are preserved verbatim. */
+    [key: string]: unknown;
+};
+/** One RAD chunk location in the top-level RAD chunk table. */
+export type RADChunkRange = {
+    /** Chunk byte offset relative to the top-level RAD chunk payload area. */
+    offset: number;
+    /** Chunk byte length. */
+    bytes: number;
+    /** Optional first splat index represented by this chunk. */
+    base?: number;
+    /** Optional number of splats represented by this chunk. */
+    count?: number;
+    /** Optional sidecar `.radc` filename relative to the RAD file URL. */
+    filename?: string;
+    /** Additional chunk-range properties are preserved verbatim. */
+    [key: string]: unknown;
+};
+/** Handwritten type for the JSON metadata stored in a Spark RAD header. */
+export type RADMetadataJSON = {
+    /** RAD container version. Version 1 is currently supported. */
+    version: 1;
+    /** RAD payload type. Spark currently writes `gsplat`. */
+    type: 'gsplat';
+    /** Total splat count represented by the RAD source. */
+    count: number;
+    /** Maximum spherical harmonics degree present in the chunks. */
+    maxSh?: number;
+    /** Whether the source includes LoD tree child-count and child-start properties. */
+    lodTree?: boolean;
+    /** Nominal number of splats per chunk. */
+    chunkSize?: number;
+    /** Total inline chunk byte length when present in the RAD metadata. */
+    allChunkBytes?: number;
+    /** RAD chunk table. */
+    chunks: RADChunkRange[];
+    /** Optional shared splat encoding metadata for chunk decoding. */
+    splatEncoding?: RADSplatEncoding;
+    /** Optional spherical harmonics codebook count. */
+    shCodeCount?: number;
+    /** Optional RAD writer comment. */
+    comment?: string;
+    /** Additional RAD metadata properties are preserved verbatim. */
+    [key: string]: unknown;
+};
+/** Parsed Spark RAD top-level metadata with loader-derived byte offsets. */
+export type RADMetadata = RADMetadataJSON & {
+    /** Byte length of the JSON metadata block. */
+    headerJsonByteLength: number;
+    /** Byte offset where inline RAD chunks begin. */
+    chunksByteOffset: number;
+};
+/** Known RAD chunk property names. */
+export type RADChunkPropertyName = 'center' | 'alpha' | 'rgb' | 'scales' | 'orientation' | 'sh1' | 'sh2' | 'sh3' | 'child_count' | 'child_start' | 'sh1_code' | 'sh2_code' | 'sh3_code' | 'sh_label';
+/** Known RAD chunk property encodings. */
+export type RADChunkPropertyEncoding = 'f32' | 'f16' | 'f32_lebytes' | 'f16_lebytes' | 'r8' | 'r8_delta' | 's8' | 's8_delta' | 'ln_0r8' | 'ln_f16' | 'oct88r8' | 'u16' | 'u32';
+/** Known RAD chunk property compression modes. */
+export type RADChunkPropertyCompression = 'gz';
+/** One property payload entry inside a RAD chunk. */
+export type RADChunkProperty = {
+    /** Property byte offset relative to the chunk payload area. */
+    offset: number;
+    /** Property byte length before 8-byte payload padding. */
+    bytes: number;
+    /** Property semantic name. */
+    property: RADChunkPropertyName | string;
+    /** Property encoding name. */
+    encoding: RADChunkPropertyEncoding | string;
+    /** Optional property compression mode. */
+    compression?: RADChunkPropertyCompression | string;
+    /** Optional decode minimum for quantized properties. */
+    min?: number;
+    /** Optional decode maximum for quantized properties. */
+    max?: number;
+    /** Additional chunk-property metadata is preserved verbatim. */
+    [key: string]: unknown;
+};
+/** Handwritten type for the JSON metadata stored in a Spark RADC chunk header. */
+export type RADChunkMetadataJSON = {
+    /** RAD chunk version. Version 1 is currently supported. */
+    version: 1;
+    /** First global splat index represented by this chunk. */
+    base: number;
+    /** Number of splats represented by this chunk. */
+    count: number;
+    /** Byte length of the padded property payload. */
+    payloadBytes: number;
+    /** Maximum spherical harmonics degree present in this chunk. */
+    maxSh?: number;
+    /** Whether this chunk contains LoD tree properties. */
+    lodTree?: boolean;
+    /** Optional chunk-local splat encoding metadata. */
+    splatEncoding?: RADSplatEncoding;
+    /** Property table for the chunk payload. */
+    properties: RADChunkProperty[];
+    /** Additional RADC metadata properties are preserved verbatim. */
+    [key: string]: unknown;
+};
+/** Parsed Spark RADC chunk metadata with loader-derived byte offsets. */
+export type RADChunkMetadata = RADChunkMetadataJSON & {
+    /** Byte length of the chunk JSON metadata block. */
+    headerJsonByteLength: number;
+    /** Byte offset where the chunk payload begins. */
+    payloadByteOffset: number;
+    /** Byte length of the RADC header and payload. */
+    chunkByteLength: number;
+};
+/** Returns true when the input begins with the Spark RAD magic bytes. */
+export declare function isRAD(data: ArrayBuffer | ArrayBufferView): boolean;
+/** Parses a complete or header-prefix Spark `.rad` buffer. */
+export declare function parseRADHeader(data: ArrayBuffer | ArrayBufferView): RADMetadata;
+/** Parses a Spark `.rad` header when enough bytes are available. */
+export declare function tryParseRADHeader(data: ArrayBuffer | ArrayBufferView): RADMetadata | null;
+/** Parses the metadata header from one Spark `.radc` chunk buffer. */
+export declare function parseRADChunkHeader(data: ArrayBuffer | ArrayBufferView): RADChunkMetadata;
+/** Rounds a byte length to Spark RAD's 8-byte alignment. */
+export declare function roundUpToEight(byteLength: number): number;
+//# sourceMappingURL=parse-rad.d.ts.map

package/dist/lib/parse-rad.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-rad.d.ts","sourceRoot":"","sources":["../../src/lib/parse-rad.ts"],"names":[],"mappings":"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"}

package/dist/lib/parse-rad.js

@@ -0,0 +1,110 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { RADChunkMetadataJSONSchema, RADMetadataJSONSchema } from "../rad-zod-schema.js";
+const RAD_MAGIC = 0x30444152;
+const RAD_CHUNK_MAGIC = 0x43444152;
+const RAD_HEADER_BYTE_LENGTH = 8;
+const RAD_CHUNK_PAYLOAD_LENGTH_BYTE_LENGTH = 8;
+const TEXT_DECODER = new TextDecoder();
+/** Returns true when the input begins with the Spark RAD magic bytes. */
+export function isRAD(data) {
+    const bytes = getUint8Array(data);
+    if (bytes.byteLength < 4) {
+        return false;
+    }
+    return (new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength).getUint32(0, true) === RAD_MAGIC);
+}
+/** Parses a complete or header-prefix Spark `.rad` buffer. */
+export function parseRADHeader(data) {
+    const metadata = tryParseRADHeader(data);
+    if (!metadata) {
+        throw new Error('RADLoader: file must contain a complete RAD metadata header.');
+    }
+    return metadata;
+}
+/** Parses a Spark `.rad` header when enough bytes are available. */
+export function tryParseRADHeader(data) {
+    const bytes = getUint8Array(data);
+    if (bytes.byteLength < RAD_HEADER_BYTE_LENGTH) {
+        return null;
+    }
+    const dataView = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    const magic = dataView.getUint32(0, true);
+    if (magic !== RAD_MAGIC) {
+        throw new Error(`RADLoader: RAD0 magic header not found, received 0x${magic.toString(16)}.`);
+    }
+    const headerJsonByteLength = dataView.getUint32(4, true);
+    const headerJsonEnd = RAD_HEADER_BYTE_LENGTH + headerJsonByteLength;
+    if (bytes.byteLength < headerJsonEnd) {
+        return null;
+    }
+    const rawMetadata = RADMetadataJSONSchema.parse(parseJSON(bytes.subarray(RAD_HEADER_BYTE_LENGTH, headerJsonEnd), 'RADLoader: failed to parse RAD metadata JSON.'));
+    return normalizeRADMetadata(rawMetadata, headerJsonByteLength);
+}
+/** Parses the metadata header from one Spark `.radc` chunk buffer. */
+export function parseRADChunkHeader(data) {
+    const bytes = getUint8Array(data);
+    if (bytes.byteLength < RAD_HEADER_BYTE_LENGTH) {
+        throw new Error('RADLoader: RADC chunk must contain an 8-byte metadata header.');
+    }
+    const dataView = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    const magic = dataView.getUint32(0, true);
+    if (magic !== RAD_CHUNK_MAGIC) {
+        throw new Error(`RADLoader: RADC magic header not found, received 0x${magic.toString(16)}.`);
+    }
+    const headerJsonByteLength = dataView.getUint32(4, true);
+    const headerJsonEnd = RAD_HEADER_BYTE_LENGTH + headerJsonByteLength;
+    const payloadByteLengthOffset = RAD_HEADER_BYTE_LENGTH + roundUpToEight(headerJsonByteLength);
+    const payloadByteOffset = payloadByteLengthOffset + RAD_CHUNK_PAYLOAD_LENGTH_BYTE_LENGTH;
+    if (bytes.byteLength < payloadByteOffset) {
+        throw new Error('RADLoader: RADC chunk must contain a complete metadata header.');
+    }
+    const rawMetadata = RADChunkMetadataJSONSchema.parse(parseJSON(bytes.subarray(RAD_HEADER_BYTE_LENGTH, headerJsonEnd), 'RADLoader: failed to parse RADC metadata JSON.'));
+    const payloadBytes = readSafeUint64(dataView, payloadByteLengthOffset, 'RADC payload byte length');
+    return normalizeRADChunkMetadata(rawMetadata, headerJsonByteLength, payloadByteOffset, payloadBytes);
+}
+/** Rounds a byte length to Spark RAD's 8-byte alignment. */
+export function roundUpToEight(byteLength) {
+    return (byteLength + 7) & ~7;
+}
+function normalizeRADMetadata(rawMetadata, headerJsonByteLength) {
+    return {
+        ...rawMetadata,
+        headerJsonByteLength,
+        chunksByteOffset: RAD_HEADER_BYTE_LENGTH + roundUpToEight(headerJsonByteLength)
+    };
+}
+function normalizeRADChunkMetadata(rawMetadata, headerJsonByteLength, payloadByteOffset, payloadBytes) {
+    if (rawMetadata.payloadBytes !== payloadBytes) {
+        throw new Error('RADLoader: RADC metadata payload byte length does not match binary header.');
+    }
+    return {
+        ...rawMetadata,
+        payloadBytes,
+        headerJsonByteLength,
+        payloadByteOffset,
+        chunkByteLength: payloadByteOffset + payloadBytes
+    };
+}
+function parseJSON(bytes, message) {
+    try {
+        return JSON.parse(TEXT_DECODER.decode(bytes));
+    }
+    catch {
+        throw new Error(message);
+    }
+}
+function readSafeUint64(dataView, byteOffset, fieldName) {
+    const value = dataView.getBigUint64(byteOffset, true);
+    if (value > BigInt(Number.MAX_SAFE_INTEGER)) {
+        throw new Error(`RADLoader: ${fieldName} exceeds Number.MAX_SAFE_INTEGER.`);
+    }
+    return Number(value);
+}
+function getUint8Array(data) {
+    return data instanceof ArrayBuffer
+        ? new Uint8Array(data)
+        : new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+}
+//# sourceMappingURL=parse-rad.js.map

package/dist/lib/parse-rad.js.map

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

package/dist/lib/parse-splat.d.ts

@@ -0,0 +1,7 @@
+import type { MeshArrowTable } from '@loaders.gl/schema';
+import type { GaussianSplats } from "../types.js";
+/** Parses a raw `.splat` ArrayBuffer into a Mesh Arrow table. */
+export declare function parseSPLAT(data: ArrayBuffer): MeshArrowTable;
+/** Parses a raw `.splat` ArrayBuffer into decoded Gaussian splat values. */
+export declare function parseSPLATToGaussianSplats(data: ArrayBuffer): GaussianSplats;
+//# sourceMappingURL=parse-splat.d.ts.map

package/dist/lib/parse-splat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-splat.d.ts","sourceRoot":"","sources":["../../src/lib/parse-splat.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAC,cAAc,EAAC,oBAAiB;AAU7C,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,cAAc,CAE5D;AAED,4EAA4E;AAC5E,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,WAAW,GAAG,cAAc,CAuD5E"}

package/dist/lib/parse-splat.js

@@ -0,0 +1,58 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { makeGaussianSplatsArrowTable } from "./splats-arrow-table.js";
+import { convertAlphaByteToLinearOpacity, decodeQuaternionByte, normalizeQuaternion } from "./splat-utils.js";
+const SPLAT_ROW_BYTE_LENGTH = 32;
+/** Parses a raw `.splat` ArrayBuffer into a Mesh Arrow table. */
+export function parseSPLAT(data) {
+    return makeGaussianSplatsArrowTable(parseSPLATToGaussianSplats(data));
+}
+/** Parses a raw `.splat` ArrayBuffer into decoded Gaussian splat values. */
+export function parseSPLATToGaussianSplats(data) {
+    if (data.byteLength % SPLAT_ROW_BYTE_LENGTH !== 0) {
+        throw new Error(`SPLATLoader: byte length must be a multiple of ${SPLAT_ROW_BYTE_LENGTH}.`);
+    }
+    const splatCount = data.byteLength / SPLAT_ROW_BYTE_LENGTH;
+    const dataView = new DataView(data);
+    const positions = new Float32Array(splatCount * 3);
+    const scales = new Float32Array(splatCount * 3);
+    const rotations = new Float32Array(splatCount * 4);
+    const colors = new Uint8Array(splatCount * 3);
+    const opacities = new Float32Array(splatCount);
+    for (let splatIndex = 0; splatIndex < splatCount; splatIndex++) {
+        const byteOffset = splatIndex * SPLAT_ROW_BYTE_LENGTH;
+        const positionOffset = splatIndex * 3;
+        const rotationOffset = splatIndex * 4;
+        positions[positionOffset + 0] = dataView.getFloat32(byteOffset + 0, true);
+        positions[positionOffset + 1] = dataView.getFloat32(byteOffset + 4, true);
+        positions[positionOffset + 2] = dataView.getFloat32(byteOffset + 8, true);
+        scales[positionOffset + 0] = dataView.getFloat32(byteOffset + 12, true);
+        scales[positionOffset + 1] = dataView.getFloat32(byteOffset + 16, true);
+        scales[positionOffset + 2] = dataView.getFloat32(byteOffset + 20, true);
+        colors[positionOffset + 0] = dataView.getUint8(byteOffset + 24);
+        colors[positionOffset + 1] = dataView.getUint8(byteOffset + 25);
+        colors[positionOffset + 2] = dataView.getUint8(byteOffset + 26);
+        opacities[splatIndex] = convertAlphaByteToLinearOpacity(dataView.getUint8(byteOffset + 27));
+        const [w, x, y, z] = normalizeQuaternion(decodeQuaternionByte(dataView.getUint8(byteOffset + 28)), decodeQuaternionByte(dataView.getUint8(byteOffset + 29)), decodeQuaternionByte(dataView.getUint8(byteOffset + 30)), decodeQuaternionByte(dataView.getUint8(byteOffset + 31)));
+        rotations[rotationOffset + 0] = w;
+        rotations[rotationOffset + 1] = x;
+        rotations[rotationOffset + 2] = y;
+        rotations[rotationOffset + 3] = z;
+    }
+    return {
+        format: 'splat',
+        splatCount,
+        positions,
+        scales,
+        rotations,
+        colors,
+        opacities,
+        loaderData: {
+            format: 'splat',
+            splatCount,
+            rowByteLength: SPLAT_ROW_BYTE_LENGTH
+        }
+    };
+}
+//# sourceMappingURL=parse-splat.js.map

package/dist/lib/parse-splat.js.map

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

package/dist/lib/parse-spz.d.ts

@@ -0,0 +1,7 @@
+import type { MeshArrowTable } from '@loaders.gl/schema';
+import type { GaussianSplats, SplatsLoaderOptions } from "../types.js";
+/** Parses a Niantic Spatial `.spz` ArrayBuffer into a Mesh Arrow table. */
+export declare function parseSPZ(data: ArrayBuffer, options?: SplatsLoaderOptions): Promise<MeshArrowTable>;
+/** Parses a Niantic Spatial `.spz` ArrayBuffer into decoded Gaussian splat values. */
+export declare function parseSPZToGaussianSplats(data: ArrayBuffer, options?: SplatsLoaderOptions): Promise<GaussianSplats>;
+//# sourceMappingURL=parse-spz.d.ts.map

package/dist/lib/parse-spz.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-spz.d.ts","sourceRoot":"","sources":["../../src/lib/parse-spz.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAC,cAAc,EAAE,mBAAmB,EAAC,oBAAiB;AA6BlE,2EAA2E;AAC3E,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,WAAW,EACjB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,cAAc,CAAC,CAEzB;AAED,sFAAsF;AACtF,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,WAAW,EACjB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,cAAc,CAAC,CAezB"}

package/dist/lib/parse-spz.js

@@ -0,0 +1,268 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { ZstdCompression } from '@loaders.gl/compression';
+import { makeGaussianSplatsArrowTable } from "./splats-arrow-table.js";
+import { normalizeQuaternion } from "./splat-utils.js";
+const SPZ_HEADER_BYTE_LENGTH = 32;
+const SPZ_MAGIC = 0x5053474e;
+const SPZ_VERSION = 4;
+const SPZ_EXTENSION_FLAG = 0x2;
+const SPZ_COLOR_SCALE = 0.15;
+const SPZ_ROTATION_COMPONENT_SCALE = Math.SQRT1_2;
+const SPZ_ROTATION_COMPONENT_MASK = (1 << 9) - 1;
+/** Parses a Niantic Spatial `.spz` ArrayBuffer into a Mesh Arrow table. */
+export async function parseSPZ(data, options) {
+    return makeGaussianSplatsArrowTable(await parseSPZToGaussianSplats(data, options));
+}
+/** Parses a Niantic Spatial `.spz` ArrayBuffer into decoded Gaussian splat values. */
+export async function parseSPZToGaussianSplats(data, options) {
+    const header = parseSPZHeader(data);
+    const streamInfos = parseSPZStreamInfos(data, header, getSPZStreamByteLengths(header));
+    const compressedStreams = streamInfos.map((streamInfo) => data.slice(streamInfo.compressedOffset, streamInfo.compressedOffset + streamInfo.compressedSize));
+    const compression = new ZstdCompression({ modules: options?.modules });
+    const streams = await Promise.all(compressedStreams.map((compressedStream, streamIndex) => compression.decompress(compressedStream, streamInfos[streamIndex].uncompressedSize)));
+    validateSPZStreamLengths(streams, streamInfos);
+    return decodeSPZStreams(header, streams, data);
+}
+/** Parses and validates the SPZ v4 plaintext header. */
+function parseSPZHeader(data) {
+    if (data.byteLength < SPZ_HEADER_BYTE_LENGTH) {
+        throw new Error(`SPZLoader: file must contain a ${SPZ_HEADER_BYTE_LENGTH}-byte header.`);
+    }
+    const dataView = new DataView(data);
+    const header = {
+        magic: dataView.getUint32(0, true),
+        version: dataView.getUint32(4, true),
+        numPoints: dataView.getUint32(8, true),
+        shDegree: dataView.getUint8(12),
+        fractionalBits: dataView.getUint8(13),
+        flags: dataView.getUint8(14),
+        numStreams: dataView.getUint8(15),
+        tocByteOffset: dataView.getUint32(16, true)
+    };
+    if (header.magic !== SPZ_MAGIC) {
+        throw new Error('SPZLoader: NGSP magic header not found.');
+    }
+    if (header.version !== SPZ_VERSION) {
+        throw new Error(`SPZLoader: version ${header.version} is not supported.`);
+    }
+    if (header.shDegree > 4) {
+        throw new Error(`SPZLoader: spherical harmonics degree ${header.shDegree} is not supported.`);
+    }
+    if (header.tocByteOffset < SPZ_HEADER_BYTE_LENGTH || header.tocByteOffset > data.byteLength) {
+        throw new Error('SPZLoader: invalid table of contents byte offset.');
+    }
+    return header;
+}
+/** Parses the SPZ stream table of contents and validates expected stream sizes. */
+function parseSPZStreamInfos(data, header, expectedUncompressedSizes) {
+    if (header.numStreams !== expectedUncompressedSizes.length) {
+        throw new Error(`SPZLoader: expected ${expectedUncompressedSizes.length} streams, found ${header.numStreams}.`);
+    }
+    const tocByteLength = header.numStreams * 16;
+    const tocEnd = header.tocByteOffset + tocByteLength;
+    if (tocEnd > data.byteLength) {
+        throw new Error('SPZLoader: table of contents exceeds file byte length.');
+    }
+    const dataView = new DataView(data);
+    let compressedOffset = tocEnd;
+    const streamInfos = [];
+    for (let streamIndex = 0; streamIndex < header.numStreams; streamIndex++) {
+        const tocOffset = header.tocByteOffset + streamIndex * 16;
+        const compressedSize = readSafeUint64(dataView, tocOffset);
+        const uncompressedSize = readSafeUint64(dataView, tocOffset + 8);
+        const expectedUncompressedSize = expectedUncompressedSizes[streamIndex];
+        if (uncompressedSize !== expectedUncompressedSize) {
+            throw new Error(`SPZLoader: stream ${streamIndex} has ${uncompressedSize} uncompressed bytes, expected ${expectedUncompressedSize}.`);
+        }
+        if (compressedOffset + compressedSize > data.byteLength) {
+            throw new Error(`SPZLoader: stream ${streamIndex} exceeds file byte length.`);
+        }
+        streamInfos.push({ compressedSize, uncompressedSize, compressedOffset });
+        compressedOffset += compressedSize;
+    }
+    if (compressedOffset !== data.byteLength) {
+        throw new Error('SPZLoader: compressed stream byte lengths do not match file byte length.');
+    }
+    return streamInfos;
+}
+/** Converts a little-endian uint64 to a safe JavaScript number. */
+function readSafeUint64(dataView, byteOffset) {
+    const value = dataView.getBigUint64(byteOffset, true);
+    if (value > BigInt(Number.MAX_SAFE_INTEGER)) {
+        throw new Error('SPZLoader: stream byte length exceeds Number.MAX_SAFE_INTEGER.');
+    }
+    return Number(value);
+}
+/** Returns expected SPZ v4 stream byte lengths, skipping zero-length SH data. */
+function getSPZStreamByteLengths(header) {
+    return [
+        header.numPoints * 9,
+        header.numPoints,
+        header.numPoints * 3,
+        header.numPoints * 3,
+        header.numPoints * 4,
+        header.numPoints * getSphericalHarmonicsComponentCount(header.shDegree)
+    ].filter((byteLength) => byteLength > 0);
+}
+/** Validates that decompressed stream lengths match the TOC. */
+function validateSPZStreamLengths(streams, streamInfos) {
+    for (let streamIndex = 0; streamIndex < streams.length; streamIndex++) {
+        if (streams[streamIndex].byteLength !== streamInfos[streamIndex].uncompressedSize) {
+            throw new Error(`SPZLoader: decompressed stream ${streamIndex} has unexpected byte length.`);
+        }
+    }
+}
+/** Decodes decompressed SPZ streams into shared Gaussian splat arrays. */
+function decodeSPZStreams(header, streams, sourceData) {
+    const splatCount = header.numPoints;
+    const positions = new Float32Array(splatCount * 3);
+    const scales = new Float32Array(splatCount * 3);
+    const rotations = new Float32Array(splatCount * 4);
+    const colors = new Uint8Array(splatCount * 3);
+    const sphericalHarmonicDcs = new Float32Array(splatCount * 3);
+    const opacities = new Float32Array(splatCount);
+    const sphericalHarmonicsComponentCount = getSphericalHarmonicsComponentCount(header.shDegree);
+    const sphericalHarmonics = sphericalHarmonicsComponentCount
+        ? new Float32Array(splatCount * sphericalHarmonicsComponentCount)
+        : undefined;
+    const [positionStream, alphaStream, colorStream, scaleStream, rotationStream, sphericalHarmonicsStream] = streams.map((stream) => new Uint8Array(stream));
+    decodeSPZPositions(positionStream, positions, header.fractionalBits);
+    decodeSPZScales(scaleStream, scales);
+    decodeSPZRotations(rotationStream, rotations);
+    decodeSPZColors(colorStream, colors, sphericalHarmonicDcs);
+    decodeSPZOpacities(alphaStream, opacities);
+    if (sphericalHarmonics && sphericalHarmonicsStream) {
+        decodeSPZSphericalHarmonics(sphericalHarmonicsStream, sphericalHarmonics);
+    }
+    return {
+        format: 'spz',
+        splatCount,
+        positions,
+        scales,
+        rotations,
+        colors,
+        sphericalHarmonicDcs,
+        opacities,
+        sphericalHarmonics,
+        sphericalHarmonicsComponentCount,
+        loaderData: {
+            format: 'spz',
+            ...header,
+            antialiased: Boolean(header.flags & 0x1),
+            extensionByteLength: getSPZExtensionByteLength(header),
+            extensionBytes: getSPZExtensionBytes(sourceData, header)
+        }
+    };
+}
+/** Decodes 24-bit signed fixed-point SPZ positions. */
+function decodeSPZPositions(positionStream, positions, fractionalBits) {
+    const scale = 1 / 2 ** fractionalBits;
+    for (let componentIndex = 0; componentIndex < positions.length; componentIndex++) {
+        const byteOffset = componentIndex * 3;
+        let fixed32 = positionStream[byteOffset] |
+            (positionStream[byteOffset + 1] << 8) |
+            (positionStream[byteOffset + 2] << 16);
+        fixed32 |= fixed32 & 0x800000 ? 0xff000000 : 0;
+        positions[componentIndex] = fixed32 * scale;
+    }
+}
+/** Decodes SPZ log-encoded scales to linear standard deviations. */
+function decodeSPZScales(scaleStream, scales) {
+    for (let componentIndex = 0; componentIndex < scales.length; componentIndex++) {
+        scales[componentIndex] = Math.exp(scaleStream[componentIndex] / 16 - 10);
+    }
+}
+/** Decodes SPZ smallest-three quaternion rotations into `[w, x, y, z]` order. */
+function decodeSPZRotations(rotationStream, rotations) {
+    for (let splatIndex = 0; splatIndex < rotations.length / 4; splatIndex++) {
+        const byteOffset = splatIndex * 4;
+        const component = rotationStream[byteOffset] |
+            (rotationStream[byteOffset + 1] << 8) |
+            (rotationStream[byteOffset + 2] << 16) |
+            (rotationStream[byteOffset + 3] << 24);
+        const xyzw = decodeSPZQuaternion(component >>> 0);
+        const [w, x, y, z] = normalizeQuaternion(xyzw[3], xyzw[0], xyzw[1], xyzw[2]);
+        const rotationOffset = splatIndex * 4;
+        rotations[rotationOffset + 0] = w;
+        rotations[rotationOffset + 1] = x;
+        rotations[rotationOffset + 2] = y;
+        rotations[rotationOffset + 3] = z;
+    }
+}
+/** Decodes one SPZ smallest-three quaternion into `[x, y, z, w]` order. */
+function decodeSPZQuaternion(component) {
+    const rotation = [0, 0, 0, 0];
+    const largestComponent = component >>> 30;
+    let remainingBits = component;
+    let sumSquares = 0;
+    for (let componentIndex = 3; componentIndex >= 0; componentIndex--) {
+        if (componentIndex !== largestComponent) {
+            const magnitude = remainingBits & SPZ_ROTATION_COMPONENT_MASK;
+            const isNegative = (remainingBits >>> 9) & 0x1;
+            remainingBits >>>= 10;
+            let value = (SPZ_ROTATION_COMPONENT_SCALE * magnitude) / SPZ_ROTATION_COMPONENT_MASK;
+            if (isNegative) {
+                value = -value;
+            }
+            rotation[componentIndex] = value;
+            sumSquares += value * value;
+        }
+    }
+    rotation[largestComponent] = Math.sqrt(Math.max(0, 1 - sumSquares));
+    return rotation;
+}
+/** Decodes SPZ color bytes into display RGB bytes and direct SH DC coefficients. */
+function decodeSPZColors(colorStream, colors, sphericalHarmonicDcs) {
+    for (let componentIndex = 0; componentIndex < colors.length; componentIndex++) {
+        sphericalHarmonicDcs[componentIndex] =
+            (colorStream[componentIndex] / 255 - 0.5) / SPZ_COLOR_SCALE;
+        colors[componentIndex] = normalizeColorByte(sphericalHarmonicDcs[componentIndex]);
+    }
+}
+/** Decodes SPZ alpha bytes into linear opacity. */
+function decodeSPZOpacities(alphaStream, opacities) {
+    for (let splatIndex = 0; splatIndex < opacities.length; splatIndex++) {
+        opacities[splatIndex] = alphaStream[splatIndex] / 255;
+    }
+}
+/** Decodes SPZ quantized SH rest coefficients. */
+function decodeSPZSphericalHarmonics(sphericalHarmonicsStream, sphericalHarmonics) {
+    for (let componentIndex = 0; componentIndex < sphericalHarmonics.length; componentIndex++) {
+        sphericalHarmonics[componentIndex] = (sphericalHarmonicsStream[componentIndex] - 128) / 128;
+    }
+}
+/** Converts an SH DC coefficient to a fallback RGB byte for preview paths. */
+function normalizeColorByte(sphericalHarmonicDc) {
+    return Math.min(Math.max(Math.round((sphericalHarmonicDc * SPZ_COLOR_SCALE + 0.5) * 255), 0), 255);
+}
+/** Returns the number of SH rest coefficients per splat for an SPZ degree. */
+function getSphericalHarmonicsComponentCount(shDegree) {
+    switch (shDegree) {
+        case 0:
+            return 0;
+        case 1:
+            return 9;
+        case 2:
+            return 24;
+        case 3:
+            return 45;
+        case 4:
+            return 72;
+        default:
+            throw new Error(`SPZLoader: spherical harmonics degree ${shDegree} is not supported.`);
+    }
+}
+/** Returns the plaintext SPZ extension byte count. */
+function getSPZExtensionByteLength(header) {
+    return header.flags & SPZ_EXTENSION_FLAG ? header.tocByteOffset - SPZ_HEADER_BYTE_LENGTH : 0;
+}
+/** Returns a copy of plaintext SPZ extension bytes when extension records are present. */
+function getSPZExtensionBytes(data, header) {
+    const extensionByteLength = getSPZExtensionByteLength(header);
+    return extensionByteLength
+        ? new Uint8Array(data.slice(SPZ_HEADER_BYTE_LENGTH, header.tocByteOffset))
+        : undefined;
+}
+//# sourceMappingURL=parse-spz.js.map

package/dist/lib/parse-spz.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-spz.js","sourceRoot":"","sources":["../../src/lib/parse-spz.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAEpC,OAAO,EAAC,eAAe,EAAC,MAAM,yBAAyB,CAAC;AAGxD,OAAO,EAAC,4BAA4B,EAAC,gCAA6B;AAClE,OAAO,EAAC,mBAAmB,EAAC,yBAAsB;AAElD,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAClC,MAAM,SAAS,GAAG,UAAU,CAAC;AAC7B,MAAM,WAAW,GAAG,CAAC,CAAC;AACtB,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAC/B,MAAM,eAAe,GAAG,IAAI,CAAC;AAC7B,MAAM,4BAA4B,GAAG,IAAI,CAAC,OAAO,CAAC;AAClD,MAAM,2BAA2B,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;AAmBjD,2EAA2E;AAC3E,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAiB,EACjB,OAA6B;IAE7B,OAAO,4BAA4B,CAAC,MAAM,wBAAwB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AACrF,CAAC;AAED,sFAAsF;AACtF,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,IAAiB,EACjB,OAA6B;IAE7B,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,WAAW,GAAG,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC;IACvF,MAAM,iBAAiB,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CACvD,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,gBAAgB,EAAE,UAAU,CAAC,gBAAgB,GAAG,UAAU,CAAC,cAAc,CAAC,CACjG,CAAC;IACF,MAAM,WAAW,GAAG,IAAI,eAAe,CAAC,EAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAC,CAAC,CAAC;IACrE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,iBAAiB,CAAC,GAAG,CAAC,CAAC,gBAAgB,EAAE,WAAW,EAAE,EAAE,CACtD,WAAW,CAAC,UAAU,CAAC,gBAAgB,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC,gBAAgB,CAAC,CACpF,CACF,CAAC;IAEF,wBAAwB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC/C,OAAO,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;AACjD,CAAC;AAED,wDAAwD;AACxD,SAAS,cAAc,CAAC,IAAiB;IACvC,IAAI,IAAI,CAAC,UAAU,GAAG,sBAAsB,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,kCAAkC,sBAAsB,eAAe,CAAC,CAAC;IAC3F,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,MAAM,GAAc;QACxB,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC;QAClC,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC;QACpC,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC;QACtC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/B,cAAc,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjC,aAAa,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC;KAC5C,CAAC;IAEF,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,sBAAsB,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,yCAAyC,MAAM,CAAC,QAAQ,oBAAoB,CAAC,CAAC;IAChG,CAAC;IACD,IAAI,MAAM,CAAC,aAAa,GAAG,sBAAsB,IAAI,MAAM,CAAC,aAAa,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAC5F,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,mFAAmF;AACnF,SAAS,mBAAmB,CAC1B,IAAiB,EACjB,MAAiB,EACjB,yBAAmC;IAEnC,IAAI,MAAM,CAAC,UAAU,KAAK,yBAAyB,CAAC,MAAM,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CACb,uBAAuB,yBAAyB,CAAC,MAAM,mBAAmB,MAAM,CAAC,UAAU,GAAG,CAC/F,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,GAAG,EAAE,CAAC;IAC7C,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,GAAG,aAAa,CAAC;IACpD,IAAI,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,gBAAgB,GAAG,MAAM,CAAC;IAC9B,MAAM,WAAW,GAAoB,EAAE,CAAC;IACxC,KAAK,IAAI,WAAW,GAAG,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC,UAAU,EAAE,WAAW,EAAE,EAAE,CAAC;QACzE,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,GAAG,WAAW,GAAG,EAAE,CAAC;QAC1D,MAAM,cAAc,GAAG,cAAc,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAC3D,MAAM,gBAAgB,GAAG,cAAc,CAAC,QAAQ,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC;QACjE,MAAM,wBAAwB,GAAG,yBAAyB,CAAC,WAAW,CAAC,CAAC;QAExE,IAAI,gBAAgB,KAAK,wBAAwB,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CACb,qBAAqB,WAAW,QAAQ,gBAAgB,iCAAiC,wBAAwB,GAAG,CACrH,CAAC;QACJ,CAAC;QACD,IAAI,gBAAgB,GAAG,cAAc,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CAAC,qBAAqB,WAAW,4BAA4B,CAAC,CAAC;QAChF,CAAC;QAED,WAAW,CAAC,IAAI,CAAC,EAAC,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAC,CAAC,CAAC;QACvE,gBAAgB,IAAI,cAAc,CAAC;IACrC,CAAC;IAED,IAAI,gBAAgB,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;IAC9F,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,mEAAmE;AACnE,SAAS,cAAc,CAAC,QAAkB,EAAE,UAAkB;IAC5D,MAAM,KAAK,GAAG,QAAQ,CAAC,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACtD,IAAI,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,iFAAiF;AACjF,SAAS,uBAAuB,CAAC,MAAiB;IAChD,OAAO;QACL,MAAM,CAAC,SAAS,GAAG,CAAC;QACpB,MAAM,CAAC,SAAS;QAChB,MAAM,CAAC,SAAS,GAAG,CAAC;QACpB,MAAM,CAAC,SAAS,GAAG,CAAC;QACpB,MAAM,CAAC,SAAS,GAAG,CAAC;QACpB,MAAM,CAAC,SAAS,GAAG,mCAAmC,CAAC,MAAM,CAAC,QAAQ,CAAC;KACxE,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,gEAAgE;AAChE,SAAS,wBAAwB,CAAC,OAAsB,EAAE,WAA4B;IACpF,KAAK,IAAI,WAAW,GAAG,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,CAAC;QACtE,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC,UAAU,KAAK,WAAW,CAAC,WAAW,CAAC,CAAC,gBAAgB,EAAE,CAAC;YAClF,MAAM,IAAI,KAAK,CAAC,kCAAkC,WAAW,8BAA8B,CAAC,CAAC;QAC/F,CAAC;IACH,CAAC;AACH,CAAC;AAED,0EAA0E;AAC1E,SAAS,gBAAgB,CACvB,MAAiB,EACjB,OAAsB,EACtB,UAAuB;IAEvB,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC;IACpC,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IAC9C,MAAM,oBAAoB,GAAG,IAAI,YAAY,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IAC9D,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,UAAU,CAAC,CAAC;IAC/C,MAAM,gCAAgC,GAAG,mCAAmC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC9F,MAAM,kBAAkB,GAAG,gCAAgC;QACzD,CAAC,CAAC,IAAI,YAAY,CAAC,UAAU,GAAG,gCAAgC,CAAC;QACjE,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,CACJ,cAAc,EACd,WAAW,EACX,WAAW,EACX,WAAW,EACX,cAAc,EACd,wBAAwB,CACzB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAEpD,kBAAkB,CAAC,cAAc,EAAE,SAAS,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;IACrE,eAAe,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACrC,kBAAkB,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;IAC9C,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAC3D,kBAAkB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAC3C,IAAI,kBAAkB,IAAI,wBAAwB,EAAE,CAAC;QACnD,2BAA2B,CAAC,wBAAwB,EAAE,kBAAkB,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO;QACL,MAAM,EAAE,KAAK;QACb,UAAU;QACV,SAAS;QACT,MAAM;QACN,SAAS;QACT,MAAM;QACN,oBAAoB;QACpB,SAAS;QACT,kBAAkB;QAClB,gCAAgC;QAChC,UAAU,EAAE;YACV,MAAM,EAAE,KAAK;YACb,GAAG,MAAM;YACT,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC;YACxC,mBAAmB,EAAE,yBAAyB,CAAC,MAAM,CAAC;YACtD,cAAc,EAAE,oBAAoB,CAAC,UAAU,EAAE,MAAM,CAAC;SACzD;KACF,CAAC;AACJ,CAAC;AAED,uDAAuD;AACvD,SAAS,kBAAkB,CACzB,cAA0B,EAC1B,SAAuB,EACvB,cAAsB;IAEtB,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,IAAI,cAAc,CAAC;IACtC,KAAK,IAAI,cAAc,GAAG,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,CAAC;QACjF,MAAM,UAAU,GAAG,cAAc,GAAG,CAAC,CAAC;QACtC,IAAI,OAAO,GACT,cAAc,CAAC,UAAU,CAAC;YAC1B,CAAC,cAAc,CAAC,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;YACrC,CAAC,cAAc,CAAC,UAAU,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACzC,OAAO,IAAI,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/C,SAAS,CAAC,cAAc,CAAC,GAAG,OAAO,GAAG,KAAK,CAAC;IAC9C,CAAC;AACH,CAAC;AAED,oEAAoE;AACpE,SAAS,eAAe,CAAC,WAAuB,EAAE,MAAoB;IACpE,KAAK,IAAI,cAAc,GAAG,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,CAAC;QAC9E,MAAM,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC;AAED,iFAAiF;AACjF,SAAS,kBAAkB,CAAC,cAA0B,EAAE,SAAuB;IAC7E,KAAK,IAAI,UAAU,GAAG,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,UAAU,EAAE,EAAE,CAAC;QACzE,MAAM,UAAU,GAAG,UAAU,GAAG,CAAC,CAAC;QAClC,MAAM,SAAS,GACb,cAAc,CAAC,UAAU,CAAC;YAC1B,CAAC,cAAc,CAAC,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;YACrC,CAAC,cAAc,CAAC,UAAU,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;YACtC,CAAC,cAAc,CAAC,UAAU,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,mBAAmB,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC;QAClD,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7E,MAAM,cAAc,GAAG,UAAU,GAAG,CAAC,CAAC;QACtC,SAAS,CAAC,cAAc,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QAClC,SAAS,CAAC,cAAc,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QAClC,SAAS,CAAC,cAAc,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QAClC,SAAS,CAAC,cAAc,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAED,2EAA2E;AAC3E,SAAS,mBAAmB,CAAC,SAAiB;IAC5C,MAAM,QAAQ,GAAqC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAChE,MAAM,gBAAgB,GAAG,SAAS,KAAK,EAAE,CAAC;IAC1C,IAAI,aAAa,GAAG,SAAS,CAAC;IAC9B,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,KAAK,IAAI,cAAc,GAAG,CAAC,EAAE,cAAc,IAAI,CAAC,EAAE,cAAc,EAAE,EAAE,CAAC;QACnE,IAAI,cAAc,KAAK,gBAAgB,EAAE,CAAC;YACxC,MAAM,SAAS,GAAG,aAAa,GAAG,2BAA2B,CAAC;YAC9D,MAAM,UAAU,GAAG,CAAC,aAAa,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC;YAC/C,aAAa,MAAM,EAAE,CAAC;YACtB,IAAI,KAAK,GAAG,CAAC,4BAA4B,GAAG,SAAS,CAAC,GAAG,2BAA2B,CAAC;YACrF,IAAI,UAAU,EAAE,CAAC;gBACf,KAAK,GAAG,CAAC,KAAK,CAAC;YACjB,CAAC;YACD,QAAQ,CAAC,cAAc,CAAC,GAAG,KAAK,CAAC;YACjC,UAAU,IAAI,KAAK,GAAG,KAAK,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,QAAQ,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IACpE,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,oFAAoF;AACpF,SAAS,eAAe,CACtB,WAAuB,EACvB,MAAkB,EAClB,oBAAkC;IAElC,KAAK,IAAI,cAAc,GAAG,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,CAAC;QAC9E,oBAAoB,CAAC,cAAc,CAAC;YAClC,CAAC,WAAW,CAAC,cAAc,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,GAAG,eAAe,CAAC;QAC9D,MAAM,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC,CAAC;IACpF,CAAC;AACH,CAAC;AAED,mDAAmD;AACnD,SAAS,kBAAkB,CAAC,WAAuB,EAAE,SAAuB;IAC1E,KAAK,IAAI,UAAU,GAAG,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC;QACrE,SAAS,CAAC,UAAU,CAAC,GAAG,WAAW,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC;IACxD,CAAC;AACH,CAAC;AAED,kDAAkD;AAClD,SAAS,2BAA2B,CAClC,wBAAoC,EACpC,kBAAgC;IAEhC,KAAK,IAAI,cAAc,GAAG,CAAC,EAAE,cAAc,GAAG,kBAAkB,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,CAAC;QAC1F,kBAAkB,CAAC,cAAc,CAAC,GAAG,CAAC,wBAAwB,CAAC,cAAc,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;IAC9F,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,SAAS,kBAAkB,CAAC,mBAA2B;IACrD,OAAO,IAAI,CAAC,GAAG,CACb,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,mBAAmB,GAAG,eAAe,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,EAC5E,GAAG,CACJ,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,SAAS,mCAAmC,CAAC,QAAgB;IAC3D,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,CAAC;YACJ,OAAO,CAAC,CAAC;QACX,KAAK,CAAC;YACJ,OAAO,CAAC,CAAC;QACX,KAAK,CAAC;YACJ,OAAO,EAAE,CAAC;QACZ,KAAK,CAAC;YACJ,OAAO,EAAE,CAAC;QACZ,KAAK,CAAC;YACJ,OAAO,EAAE,CAAC;QACZ;YACE,MAAM,IAAI,KAAK,CAAC,yCAAyC,QAAQ,oBAAoB,CAAC,CAAC;IAC3F,CAAC;AACH,CAAC;AAED,sDAAsD;AACtD,SAAS,yBAAyB,CAAC,MAAiB;IAClD,OAAO,MAAM,CAAC,KAAK,GAAG,kBAAkB,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/F,CAAC;AAED,0FAA0F;AAC1F,SAAS,oBAAoB,CAAC,IAAiB,EAAE,MAAiB;IAChE,MAAM,mBAAmB,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAC9D,OAAO,mBAAmB;QACxB,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,sBAAsB,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;QAC1E,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC"}