@loaders.gl/splats 5.0.0-alpha.2 → 5.0.0-alpha.3

package/dist/spz-loader-types.js

@@ -4,7 +4,7 @@
 import { SPZFormat } from "./splats-format.js";
 // __VERSION__ is injected by babel-plugin-version-inline
 // @ts-ignore TS2304: Cannot find name '__VERSION__'.
-const VERSION = typeof "5.0.0-alpha.2" !== 'undefined' ? "5.0.0-alpha.2" : 'latest';
+const VERSION = typeof "5.0.0-alpha.3" !== 'undefined' ? "5.0.0-alpha.3" : 'latest';
 /** Preloads the parser-bearing SPZ loader implementation. */
 async function preload() {
     const { SPZLoaderWithParser } = await import("./spz-loader.js");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loaders.gl/splats",
-  "version": "5.0.0-alpha.2",
+  "version": "5.0.0-alpha.3",
   "description": "Framework-independent loaders for Gaussian splat formats",
   "license": "MIT",
   "type": "module",
@@ -78,9 +78,9 @@
     "build-bundle-dev": "ocular-bundle ./bundle.ts --env=dev --output=dist/dist.dev.js"
   },
   "dependencies": {
-    "@loaders.gl/compression": "5.0.0-alpha.2",
-    "@loaders.gl/loader-utils": "5.0.0-alpha.2",
-    "@loaders.gl/schema": "5.0.0-alpha.2",
+    "@loaders.gl/compression": "5.0.0-alpha.3",
+    "@loaders.gl/loader-utils": "5.0.0-alpha.3",
+    "@loaders.gl/schema": "5.0.0-alpha.3",
     "apache-arrow": ">= 17.0.0",
     "zod": "^4.1.12"
   },
@@ -90,5 +90,5 @@
   "peerDependencies": {
     "@loaders.gl/core": "~5.0.0-alpha.0"
   },
-  "gitHead": "27bcc0db684abb66a83003263c9d1cafd9e5b2dd"
+  "gitHead": "6e6f532b04a2798191ee2d9a932ca73b7c7f3c8d"
 }

package/src/lib/parse-rad-chunk.ts

@@ -2,7 +2,7 @@
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
 
-import {DeflateCompression} from '@loaders.gl/compression';
+import {DeflateDecompressor} from '@loaders.gl/compression/deflate-decompressor';
 import type {MeshArrowTable} from '@loaders.gl/schema';
 import type {GaussianSplats, SplatsLoaderOptions} from '../types';
 import {
@@ -15,8 +15,8 @@ import {
 import {makeGaussianSplatsArrowTable} from './splats-arrow-table';
 import {decodeFloat16, normalizeQuaternion, SH_C0} from './splat-utils';
 
-const RAD_PROPERTY_DEFLATE = new DeflateCompression();
-const RAD_PROPERTY_RAW_DEFLATE = new DeflateCompression({raw: true});
+const RAD_PROPERTY_DEFLATE = new DeflateDecompressor({useNative: false});
+const RAD_PROPERTY_RAW_DEFLATE = new DeflateDecompressor({raw: true, useNative: false});
 
 /** Options for decoding one Spark RADC chunk payload. */
 export type RADChunkDecodeOptions = SplatsLoaderOptions & {

package/src/lib/parse-spz.ts

@@ -2,8 +2,7 @@
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
 
-import {decompressWithNativeDecompressionStream} from '@loaders.gl/compression/native-decompression';
-import {getJSModuleOrNull, registerJSModules} from '@loaders.gl/loader-utils';
+import {ZstdDecompressor} from '@loaders.gl/compression';
 import type {MeshArrowTable} from '@loaders.gl/schema';
 import type {GaussianSplats, SplatsLoaderOptions} from '../types';
 import {makeGaussianSplatsArrowTable} from './splats-arrow-table';
@@ -52,24 +51,10 @@ export async function parseSPZToGaussianSplats(
   const compressedStreams = streamInfos.map(streamInfo =>
     data.slice(streamInfo.compressedOffset, streamInfo.compressedOffset + streamInfo.compressedSize)
   );
-  registerJSModules(options?.modules);
-  const useNativeDecompressionStream = !getJSModuleOrNull('zstd-codec');
-  let compressionPromise:
-    | Promise<{
-        decompress(input: ArrayBuffer, size?: number): Promise<ArrayBuffer>;
-      }>
-    | undefined;
+  const decompressor = new ZstdDecompressor({modules: options?.modules});
   const streams = await Promise.all(
     compressedStreams.map((compressedStream, streamIndex) =>
-      decompressSPZStream(
-        compressedStream,
-        streamInfos[streamIndex].uncompressedSize,
-        useNativeDecompressionStream,
-        () => {
-          compressionPromise ||= createZstdCompression(options?.modules);
-          return compressionPromise;
-        }
-      )
+      decompressor.decompress(compressedStream, streamInfos[streamIndex].uncompressedSize)
     )
   );
 
@@ -77,45 +62,6 @@ export async function parseSPZToGaussianSplats(
   return decodeSPZStreams(header, streams, data);
 }
 
-/**
- * Decompresses one SPZ stream natively when available, then lazily loads the codec fallback.
- *
- * @param compressedStream Compressed Zstandard stream.
- * @param uncompressedSize Expected uncompressed byte length.
- * @param useNativeDecompressionStream Whether no provided codec should take precedence.
- * @param getCompression Lazily resolves the codec-backed Zstandard implementation.
- * @returns Decompressed stream bytes.
- */
-async function decompressSPZStream(
-  compressedStream: ArrayBuffer,
-  uncompressedSize: number,
-  useNativeDecompressionStream: boolean,
-  getCompression: () => Promise<{
-    decompress(input: ArrayBuffer, size?: number): Promise<ArrayBuffer>;
-  }>
-): Promise<ArrayBuffer> {
-  if (useNativeDecompressionStream) {
-    const nativeOutput = await decompressWithNativeDecompressionStream(compressedStream, 'zstd');
-    if (nativeOutput) {
-      return nativeOutput;
-    }
-  }
-
-  const compression = await getCompression();
-  return await compression.decompress(compressedStream, uncompressedSize);
-}
-
-/**
- * Dynamically loads the codec-backed Zstandard class for unsupported native runtimes.
- *
- * @param modules Optional registered codec modules.
- * @returns Codec-backed Zstandard implementation.
- */
-async function createZstdCompression(modules?: {[key: string]: any}) {
-  const {ZstdCompression} = await import('@loaders.gl/compression/zstd-compression');
-  return new ZstdCompression({modules});
-}
-
 /** Parses and validates the SPZ v4 plaintext header. */
 function parseSPZHeader(data: ArrayBuffer): SPZHeader {
   if (data.byteLength < SPZ_HEADER_BYTE_LENGTH) {