@imfusion/sdk-react 0.7.0-dev.36.g68b6e3f0 → 0.7.0-dev.38.gb2cede30

package/README.md

@@ -35,12 +35,12 @@ import { useImFusion, useDataLoader, useData } from '@imfusion/sdk-react';
 
 function Viewer() {
   const imf = useImFusion();
-  const { loadUrl, isLoading, progress } = useDataLoader();
+  const { loadFileFromUrl, isLoading, progress } = useDataLoader();
   const datasets = useData();
 
   return (
     <div>
-      <button onClick={() => loadUrl('/data/scan.nii.gz')} disabled={isLoading}>
+      <button onClick={() => loadFileFromUrl('/data/scan.nii.gz')} disabled={isLoading}>
         {isLoading ? 'Loading...' : 'Load'}
       </button>
       <p>{datasets.length} dataset(s) loaded</p>

package/dist/context.d.ts

@@ -1,14 +1 @@
-import type { ImFusion } from '@imfusion/sdk';
-/**
- * Internal context value shared between provider, canvas, and hooks.
- *
- * @internal Use {@link useImFusion},
- * {@link useImFusionError}, or {@link useImFusionState} instead.
- */
-export interface ImFusionContextValue {
-    imf: ImFusion | null;
-    error: Error | null;
-    registerCanvas: (canvas: HTMLCanvasElement) => void;
-}
-/** @internal */
-export declare const ImFusionContext: import("react").Context<ImFusionContextValue | null>;
+export {};

package/dist/useDataLoader.d.ts

@@ -6,9 +6,9 @@ export interface DataLoaderProgress {
 /**
  * Provides data loading methods with reactive loading, progress, and error state.
  *
- * Wraps {@link @imfusion/sdk!ImFusion.loadUrl | ImFusion.loadUrl}, {@link @imfusion/sdk!ImFusion.loadFile | ImFusion.loadFile},
- * {@link @imfusion/sdk!ImFusion.loadBuffer | ImFusion.loadBuffer}, and {@link @imfusion/sdk!ImFusion.loadFolder | ImFusion.loadFolder} with
- * React-friendly state management.
+ * Wraps {@link @imfusion/sdk!ImFusion.loadFile | ImFusion.loadFile}, {@link @imfusion/sdk!ImFusion.loadFileFromUrl | ImFusion.loadFileFromUrl},
+ * {@link @imfusion/sdk!ImFusion.loadFolder | ImFusion.loadFolder}, {@link @imfusion/sdk!ImFusion.loadFolderFromUrls | ImFusion.loadFolderFromUrls}, and
+ * {@link @imfusion/sdk!ImFusion.loadBuffer | ImFusion.loadBuffer} with React-friendly state management.
  *
  * State (`isLoading`, `progress`, `error`) tracks a single load operation at a time.
  * Concurrent loads from the same hook instance are not supported, use separate instances if needed.
@@ -20,10 +20,10 @@ export interface DataLoaderProgress {
  * @example
  * ```tsx
  * function LoadButton() {
- *   const { loadUrl, isLoading, progress, error } = useDataLoader();
+ *   const { loadFileFromUrl, isLoading, progress, error } = useDataLoader();
  *   return (
  *     <>
- *       <button onClick={() => loadUrl('/data/ct.nii.gz')} disabled={isLoading}>
+ *       <button onClick={() => loadFileFromUrl('/data/ct.nii.gz')} disabled={isLoading}>
  *         Load CT
  *       </button>
  *       {isLoading && progress && (
@@ -39,10 +39,11 @@ export interface DataLoaderProgress {
  * @see {@link useVisibleData}
  */
 export declare function useDataLoader(): {
-    loadUrl: (url: string) => Promise<HandleArray<Data>>;
     loadFile: (file: File) => Promise<HandleArray<Data>>;
-    loadBuffer: (buffer: ArrayBufferLike, filename: string) => Promise<HandleArray<Data>>;
+    loadFileFromUrl: (url: string) => Promise<HandleArray<Data>>;
     loadFolder: (files: File[]) => Promise<HandleArray<Data>>;
+    loadFolderFromUrls: (urls: ReadonlyArray<string>) => Promise<HandleArray<Data>>;
+    loadBuffer: (buffer: ArrayBufferLike, filename: string) => Promise<HandleArray<Data>>;
     isLoading: boolean;
     progress: DataLoaderProgress | null;
     error: Error | null;

package/dist/useDataLoader.js

@@ -3,9 +3,9 @@ import { useImFusion } from './useImFusion.js';
 /**
  * Provides data loading methods with reactive loading, progress, and error state.
  *
- * Wraps {@link @imfusion/sdk!ImFusion.loadUrl | ImFusion.loadUrl}, {@link @imfusion/sdk!ImFusion.loadFile | ImFusion.loadFile},
- * {@link @imfusion/sdk!ImFusion.loadBuffer | ImFusion.loadBuffer}, and {@link @imfusion/sdk!ImFusion.loadFolder | ImFusion.loadFolder} with
- * React-friendly state management.
+ * Wraps {@link @imfusion/sdk!ImFusion.loadFile | ImFusion.loadFile}, {@link @imfusion/sdk!ImFusion.loadFileFromUrl | ImFusion.loadFileFromUrl},
+ * {@link @imfusion/sdk!ImFusion.loadFolder | ImFusion.loadFolder}, {@link @imfusion/sdk!ImFusion.loadFolderFromUrls | ImFusion.loadFolderFromUrls}, and
+ * {@link @imfusion/sdk!ImFusion.loadBuffer | ImFusion.loadBuffer} with React-friendly state management.
  *
  * State (`isLoading`, `progress`, `error`) tracks a single load operation at a time.
  * Concurrent loads from the same hook instance are not supported, use separate instances if needed.
@@ -17,10 +17,10 @@ import { useImFusion } from './useImFusion.js';
  * @example
  * ```tsx
  * function LoadButton() {
- *   const { loadUrl, isLoading, progress, error } = useDataLoader();
+ *   const { loadFileFromUrl, isLoading, progress, error } = useDataLoader();
  *   return (
  *     <>
- *       <button onClick={() => loadUrl('/data/ct.nii.gz')} disabled={isLoading}>
+ *       <button onClick={() => loadFileFromUrl('/data/ct.nii.gz')} disabled={isLoading}>
  *         Load CT
  *       </button>
  *       {isLoading && progress && (
@@ -56,15 +56,28 @@ export function useDataLoader() {
             setIsLoading(false);
         }
     }, []);
-    const loadUrl = useCallback((url) => run(() => imf.loadUrl(url, {
+    const loadFile = useCallback((file) => run(() => imf.loadFile(file)), [imf, run]);
+    const loadFileFromUrl = useCallback((url) => run(() => imf.loadFileFromUrl(url, {
         onProgress: (received, total) => setProgress({ received, total }),
     })), [imf, run]);
-    const loadFile = useCallback((file) => run(() => imf.loadFile(file)), [imf, run]);
-    const loadBuffer = useCallback((buffer, filename) => run(() => imf.loadBuffer(buffer, filename)), [imf, run]);
     const loadFolder = useCallback((files) => run(() => imf.loadFolder(files)), [imf, run]);
+    const loadFolderFromUrls = useCallback((urls) => run(() => imf.loadFolderFromUrls(urls, {
+        onProgress: (received, total) => setProgress({ received, total }),
+    })), [imf, run]);
+    const loadBuffer = useCallback((buffer, filename) => run(() => imf.loadBuffer(buffer, filename)), [imf, run]);
     const reset = useCallback(() => {
         setError(null);
         setProgress(null);
     }, []);
-    return useMemo(() => ({ loadUrl, loadFile, loadBuffer, loadFolder, isLoading, progress, error, reset }), [loadUrl, loadFile, loadBuffer, loadFolder, isLoading, progress, error, reset]);
+    return useMemo(() => ({
+        loadFile,
+        loadFileFromUrl,
+        loadFolder,
+        loadFolderFromUrls,
+        loadBuffer,
+        isLoading,
+        progress,
+        error,
+        reset,
+    }), [loadFile, loadFileFromUrl, loadFolder, loadFolderFromUrls, loadBuffer, isLoading, progress, error, reset]);
 }

package/dist/useStableHandle.d.ts

@@ -1,15 +1 @@
-import type { ClassHandle } from '@imfusion/sdk';
-/**
- * Returns a stable reference for a WASM handle, using
- * {@link @imfusion/sdk!ClassHandle.isAliasOf | isAliasOf} instead of `===` to detect
- * identity changes.
- *
- * Different JS wrapper objects can alias the same underlying C++ object.
- * This hook ensures that the returned reference only changes when the
- * underlying C++ object actually changes, making it safe to use in
- * `useEffect` dependency arrays and other identity-sensitive contexts.
- *
- * @internal
- */
-export declare function useStableHandle<T extends ClassHandle>(handle: T): T;
-export declare function useStableHandle<T extends ClassHandle>(handle: T | undefined): T | undefined;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imfusion/sdk-react",
-  "version": "0.7.0-dev.36.g68b6e3f0",
+  "version": "0.7.0-dev.38.gb2cede30",
   "description": "React bindings for ImFusion Web SDK",
   "author": "ImFusion GmbH",
   "license": "SEE LICENSE IN License.rtf",
@@ -29,7 +29,7 @@
     "License.rtf"
   ],
   "peerDependencies": {
-    "@imfusion/sdk": "0.7.0-dev.36.g68b6e3f0",
+    "@imfusion/sdk": "0.7.0-dev.38.gb2cede30",
     "react": ">=18"
   },
   "devDependencies": {