@vizij/animation-react 0.0.3 → 0.0.7

package/README.md

@@ -46,6 +46,27 @@ yarn add @vizij/animation-react @vizij/animation-wasm react react-dom
 
 During local development with linked WASM packages, ensure your bundler preserves symlinks and excludes `@vizij/animation-wasm` from pre-bundling (see the [`vizij-web` README](../../README.md#local-wasm-development) for a Vite example).
 
+> **Bundler note:** `@vizij/animation-react` depends on `@vizij/animation-wasm`, which emits a `.wasm` artefact. Enable async WebAssembly and treat `.wasm` files as emitted assets in your bundler. For Next.js:
+>
+> ```js
+> // next.config.js
+> module.exports = {
+>   webpack: (config) => {
+>     config.experiments = {
+>       ...(config.experiments ?? {}),
+>       asyncWebAssembly: true,
+>     };
+>     config.module.rules.push({
+>       test: /\.wasm$/,
+>       type: "asset/resource",
+>     });
+>     return config;
+>   },
+> };
+> ```
+>
+> When overriding the wasm location, call `init("https://.../vizij_animation_wasm_bg.wasm")` with a string URL so Webpack does not wrap it in `RelativeURL`.
+
 ---
 
 ## Peer Dependencies

package/dist/index.cjs

@@ -220,7 +220,8 @@ function AnimationProvider({
   autostart = true,
   updateHz,
   engineConfig,
-  onOutputs
+  onOutputs,
+  wasmInitInput
 }) {
   const engineRef = (0, import_react2.useRef)(null);
   const storeRef = (0, import_react2.useRef)(createAnimationStore());
@@ -353,7 +354,7 @@ function AnimationProvider({
     let cancelled = false;
     (async () => {
       try {
-        await (0, import_animation_wasm.init)();
+        await (0, import_animation_wasm.init)(wasmInitInput);
       } catch (err) {
         console.error("Failed to init @vizij/animation-wasm", err);
         return;

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { StoredAnimation, Config, OutputsWithDerivatives, Value as Value$1, Inputs, InstanceUpdate, AnimationInfo, PlayerInfo, InstanceInfo, BakingConfig, BakedAnimationData, BakedAnimationBundle, listAnimationFixtures, loadAnimationFixture, loadAnimationJson, resolveAnimationPath } from '@vizij/animation-wasm';
+import { StoredAnimation, Config, OutputsWithDerivatives, InitInput, Value as Value$1, Inputs, InstanceUpdate, AnimationInfo, PlayerInfo, InstanceInfo, BakingConfig, BakedAnimationData, BakedAnimationBundle, listAnimationFixtures, loadAnimationFixture, loadAnimationJson, resolveAnimationPath } from '@vizij/animation-wasm';
 export { listAnimationFixtures, loadAnimationFixture, loadAnimationJson, resolveAnimationPath } from '@vizij/animation-wasm';
 import { NormalizedTransform } from '@vizij/value-json';
 
@@ -34,6 +34,8 @@ type AnimationProviderProps = {
     engineConfig?: Config;
     /** Optional callback to receive raw Outputs each update (includes events and derivatives). */
     onOutputs?: (out: OutputsWithDerivatives) => void;
+    /** Optional init input passed to @vizij/animation-wasm.init for tests and SSR. */
+    wasmInitInput?: InitInput;
 };
 type AnimationContextValue = {
     ready: boolean;
@@ -101,7 +103,7 @@ type AnimationContextValue = {
     players: Record<string, number>;
 };
 
-declare function AnimationProvider({ children, animations, instances, prebind, autostart, updateHz, engineConfig, onOutputs, }: AnimationProviderProps): react_jsx_runtime.JSX.Element;
+declare function AnimationProvider({ children, animations, instances, prebind, autostart, updateHz, engineConfig, onOutputs, wasmInitInput, }: AnimationProviderProps): react_jsx_runtime.JSX.Element;
 
 declare function useAnimation(): AnimationContextValue;
 

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { StoredAnimation, Config, OutputsWithDerivatives, Value as Value$1, Inputs, InstanceUpdate, AnimationInfo, PlayerInfo, InstanceInfo, BakingConfig, BakedAnimationData, BakedAnimationBundle, listAnimationFixtures, loadAnimationFixture, loadAnimationJson, resolveAnimationPath } from '@vizij/animation-wasm';
+import { StoredAnimation, Config, OutputsWithDerivatives, InitInput, Value as Value$1, Inputs, InstanceUpdate, AnimationInfo, PlayerInfo, InstanceInfo, BakingConfig, BakedAnimationData, BakedAnimationBundle, listAnimationFixtures, loadAnimationFixture, loadAnimationJson, resolveAnimationPath } from '@vizij/animation-wasm';
 export { listAnimationFixtures, loadAnimationFixture, loadAnimationJson, resolveAnimationPath } from '@vizij/animation-wasm';
 import { NormalizedTransform } from '@vizij/value-json';
 
@@ -34,6 +34,8 @@ type AnimationProviderProps = {
     engineConfig?: Config;
     /** Optional callback to receive raw Outputs each update (includes events and derivatives). */
     onOutputs?: (out: OutputsWithDerivatives) => void;
+    /** Optional init input passed to @vizij/animation-wasm.init for tests and SSR. */
+    wasmInitInput?: InitInput;
 };
 type AnimationContextValue = {
     ready: boolean;
@@ -101,7 +103,7 @@ type AnimationContextValue = {
     players: Record<string, number>;
 };
 
-declare function AnimationProvider({ children, animations, instances, prebind, autostart, updateHz, engineConfig, onOutputs, }: AnimationProviderProps): react_jsx_runtime.JSX.Element;
+declare function AnimationProvider({ children, animations, instances, prebind, autostart, updateHz, engineConfig, onOutputs, wasmInitInput, }: AnimationProviderProps): react_jsx_runtime.JSX.Element;
 
 declare function useAnimation(): AnimationContextValue;
 

package/dist/index.js

@@ -186,7 +186,8 @@ function AnimationProvider({
   autostart = true,
   updateHz,
   engineConfig,
-  onOutputs
+  onOutputs,
+  wasmInitInput
 }) {
   const engineRef = useRef(null);
   const storeRef = useRef(createAnimationStore());
@@ -319,7 +320,7 @@ function AnimationProvider({
     let cancelled = false;
     (async () => {
       try {
-        await init();
+        await init(wasmInitInput);
       } catch (err) {
         console.error("Failed to init @vizij/animation-wasm", err);
         return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vizij/animation-react",
-  "version": "0.0.3",
+  "version": "0.0.7",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -23,7 +23,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@vizij/animation-wasm": "^0.3.1",
+    "@vizij/animation-wasm": "^0.3.5",
     "@vizij/value-json": "^0.1.0"
   },
   "peerDependencies": {