chore: update package version to 1.3.4 and replace fzstd with @ioai/wasm-zstd

Bump the package version to 1.3.4. Update the NOTICE file to reflect the new source URL for the wasm-hdf5 repository. Replace the deprecated fzstd library with @ioai/wasm-zstd for Zstandard decompression, and update relevant documentation to ensure clarity on the new library usage.

Author: joaner

NOTICE

@@ -62,7 +62,7 @@ react-intl
   Copyright 2026 IO-AI Tech
   Licensed under the MIT License; third-party notices ship with the npm package (see node_modules/@ioai/hdf5/THIRD_PARTY_NOTICES.md after install).
   https://www.npmjs.com/package/@ioai/hdf5
-  Source: https://github.com/ioai-tech/hdf5-wasm
+  Source: https://github.com/ioai-tech/wasm-hdf5
 
 fflate
   Copyright 2020-2024 Arjun Barrett

docs/ARCHITECTURE.md

@@ -283,7 +283,7 @@ Fixed-width sidebar (collapsible) on the left with three tabs:
 | Library | Purpose |
 |---------|---------|
 | fflate | General compression/decompression (gzip/deflate/zlib) |
-| fzstd | Browser-safe Zstandard decompression for MCAP chunk compression |
+| @ioai/wasm-zstd | Vite-friendly WebAssembly Zstandard decompression for MCAP chunk compression |
 | lz4js | Browser-safe LZ4 decompression for MCAP/ROS1 chunk compression |
 
 ---

docs/ARCHITECTURE.zh.md

@@ -276,7 +276,7 @@
 | 库 | 说明 |
 |----|------|
 | fflate | 通用压缩/解压（gzip/deflate/zlib） |
-| fzstd | 浏览器安全的 Zstandard 解压（MCAP chunk 压缩） |
+| @ioai/wasm-zstd | Vite 友好的 WebAssembly Zstandard 解压（MCAP chunk 压缩） |
 | lz4js | 浏览器安全的 LZ4 解压（MCAP/ROS1 chunk 压缩） |
 
 ---
@@ -901,7 +901,7 @@ rosview/
 
     "fflate": "^0.8.2",
     "@mcap/browser": "^1.1.0",
-    "fzstd": "^0.1.1",
+    "@ioai/wasm-zstd": "^1.1.0",
     "lz4js": "^0.2.0",
 
     "zustand": "^5.0.0",

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@ioai/rosview",
-  "version": "1.3.3",
+  "version": "1.3.4",
   "description": "High-performance robotics data visualization for MCAP, ROS bag, ROS2 db3, HDF5 and BVH — embeddable React component and standalone SPA",
   "keywords": [
     "ros",
@@ -97,8 +97,9 @@
     "@foxglove/rosmsg-serialization": "^2.0.4",
     "@foxglove/rosmsg2-serialization": "^3.0.3",
     "@ioai/hdf5": "^1.0.0",
-    "@mcap/core": "^2.0.2",
+    "@ioai/wasm-zstd": "^1.1.0",
     "@mcap/browser": "^1.1.0",
+    "@mcap/core": "^2.0.2",
     "@playwright/test": "^1.59.1",
     "@radix-ui/react-collapsible": "^1.1.12",
     "@radix-ui/react-dialog": "^1.1.5",
@@ -134,7 +135,6 @@
     "eventemitter3": "^5.0.1",
     "fflate": "^0.8.2",
     "flatbuffers": "^25.9.23",
-    "fzstd": "^0.1.1",
     "globals": "^17.4.0",
     "happy-dom": "^20.9.0",
     "intervals-fn": "^3.0.3",

package.json

@@ -1,18 +1,21 @@
 import type { McapTypes } from "@mcap/core";
-import { decompress as fzstdDecompress } from "fzstd";
+import { decompress as zstdDecompress, init as initZstd } from "@ioai/wasm-zstd";
+import zstdWasmUrl from "@ioai/wasm-zstd/wasm-zstd.wasm?url";
 import * as lz4js from "lz4js";
 
-// @mcap/support currently pulls CommonJS wasm loaders that fail in Vite's
-// ES module worker build, so keep these browser-safe ESM handlers local.
+// Load the zstd wasm module explicitly so Vite owns the wasm asset URL in both
+// dev and production worker bundles.
 
 let handlersPromise: Promise<McapTypes.DecompressHandlers> | undefined;
 
 export async function loadDecompressHandlers(): Promise<McapTypes.DecompressHandlers> {
   return await (handlersPromise ??= _loadDecompressHandlers());
 }
 
-function _loadDecompressHandlers(): Promise<McapTypes.DecompressHandlers> {
-  return Promise.resolve({
+async function _loadDecompressHandlers(): Promise<McapTypes.DecompressHandlers> {
+  await initZstd({ wasmUrl: zstdWasmUrl });
+
+  return {
     lz4: (buffer, decompressedSize) => {
       const output = new Uint8Array(Number(decompressedSize));
       const result = lz4js.decompressBlock(buffer, output, 0, buffer.byteLength, 0);
@@ -22,8 +25,7 @@ function _loadDecompressHandlers(): Promise<McapTypes.DecompressHandlers> {
       return output;
     },
     zstd: (buffer, decompressedSize) => {
-      const output = new Uint8Array(Number(decompressedSize));
-      return fzstdDecompress(buffer, output);
+      return zstdDecompress(buffer, Number(decompressedSize));
     },
-  });
+  };
 }

src/infra/sources/decompressHandlers.ts

@@ -56,11 +56,11 @@ export default defineConfig({
       '@foxglove/rosmsg',
       '@foxglove/rosmsg-serialization',
       '@foxglove/rosmsg2-serialization',
+      '@ioai/wasm-zstd',
       '@mcap/browser',
       '@mcap/core',
       'eventemitter3',
       'flatbuffers/js/flexbuffers.js',
-      'fzstd',
       'intervals-fn',
       'lz4js',
       'protobufjs',