bdsa-react-components 0.1.21 → 0.1.25

package/dist/components/SlideViewer/SlideViewer.types.d.ts

@@ -1,52 +1,112 @@
 import { FeatureCollection } from 'geojson';
 import { Viewer as OpenSeadragonViewer, Options as OpenSeadragonOptions } from 'openseadragon';
 import { default as React } from 'react';
+import { ApiErrorHandler } from '../../utils/apiErrorHandling';
 
+/**
+ * Configuration for a slide image to display in the SlideViewer.
+ *
+ * You can provide either:
+ * - A `dziUrl` (recommended): OpenSeadragon will automatically fetch all metadata
+ * - Manual configuration: Provide `imageId`, `width`, `height`, `tileWidth`, `levels`, and `baseUrl`
+ *
+ * @example Using DZI URL (recommended)
+ * ```tsx
+ * const imageInfo = {
+ *   dziUrl: 'http://bdsa.pathology.emory.edu:8080/api/v1/item/123/tiles/dzi.dzi'
+ * }
+ * ```
+ *
+ * @example Manual configuration
+ * ```tsx
+ * const imageInfo = {
+ *   imageId: '123',
+ *   width: 40000,
+ *   height: 30000,
+ *   tileWidth: 256,
+ *   levels: 8,
+ *   baseUrl: 'http://bdsa.pathology.emory.edu:8080'
+ * }
+ * ```
+ */
 export interface SlideImageInfo {
-    /** Image ID from DSA (used if dziUrl is not provided) */
+    /** Image ID from DSA (required if dziUrl is not provided) */
     imageId?: string | number;
-    /** Image width in pixels (used if dziUrl is not provided) */
+    /** Image width in pixels (required if dziUrl is not provided) */
     width?: number;
-    /** Image height in pixels (used if dziUrl is not provided) */
+    /** Image height in pixels (required if dziUrl is not provided) */
     height?: number;
-    /** Tile width (used if dziUrl is not provided) */
+    /** Tile width in pixels (required if dziUrl is not provided) */
     tileWidth?: number;
-    /** Number of zoom levels (used if dziUrl is not provided) */
+    /** Number of zoom levels (required if dziUrl is not provided) */
     levels?: number;
-    /** Base URL for DSA tile server (used if dziUrl is not provided) */
+    /** Base URL for DSA tile server (required if dziUrl is not provided) */
     baseUrl?: string;
-    /** DZI descriptor URL (e.g., 'http://bdsa.pathology.emory.edu:8080/api/v1/item/{itemId}/tiles/dzi.dzi')
-     *  If provided, this will be used instead of manually constructing tile URLs */
+    /**
+     * DZI descriptor URL. If provided, this will be used instead of manually constructing tile URLs.
+     * OpenSeadragon will automatically fetch all metadata (width, height, levels, etc.) from the DZI file.
+     *
+     * @example 'http://bdsa.pathology.emory.edu:8080/api/v1/item/{itemId}/tiles/dzi.dzi'
+     */
     dziUrl?: string;
 }
+/**
+ * Represents an annotation feature to be rendered on a slide image.
+ * Supports both rectangle annotations and polyline annotations.
+ *
+ * @example Rectangle annotation
+ * ```tsx
+ * const annotation: AnnotationFeature = {
+ *   id: 'ann-1',
+ *   left: 1000,
+ *   top: 2000,
+ *   width: 500,
+ *   height: 300,
+ *   color: '#ff0000',
+ *   label: 'Region of Interest'
+ * }
+ * ```
+ *
+ * @example Polyline annotation
+ * ```tsx
+ * const polyline: AnnotationFeature = {
+ *   id: 'poly-1',
+ *   annotationType: 'polyline',
+ *   points: [[100, 200], [300, 400], [500, 200]],
+ *   closed: true,
+ *   color: '#00ff00',
+ *   fillColor: 'rgba(0, 255, 0, 0.2)'
+ * }
+ * ```
+ */
 export interface AnnotationFeature {
     /** Unique identifier for the annotation */
     id?: string | number;
-    /** Left coordinate in pixels */
+    /** Left coordinate in pixels (for rectangle annotations) */
     left: number;
-    /** Top coordinate in pixels */
+    /** Top coordinate in pixels (for rectangle annotations) */
     top: number;
-    /** Width in pixels */
+    /** Width in pixels (for rectangle annotations) */
     width: number;
-    /** Height in pixels */
+    /** Height in pixels (for rectangle annotations) */
     height: number;
-    /** Optional color for the annotation stroke */
+    /** Optional color for the annotation stroke (CSS color string) */
     color?: string;
-    /** Optional group identifier */
+    /** Optional group identifier for organizing related annotations */
     group?: string | number;
-    /** Optional label */
+    /** Optional label to display with the annotation */
     label?: string;
-    /** Type of annotation (rectangle, polyline, etc.) */
+    /** Type of annotation - 'rectangle' for bounding boxes, 'polyline' for paths */
     annotationType?: 'rectangle' | 'polyline';
-    /** Points array for polyline annotations */
+    /** Array of [x, y] coordinate pairs for polyline annotations */
     points?: Array<[number, number]>;
-    /** Whether polyline is closed */
+    /** Whether the polyline should be closed (connect last point to first) */
     closed?: boolean;
-    /** Fill color for polyline */
+    /** Fill color for polyline annotations (CSS color string) */
     fillColor?: string;
-    /** Store full element for rendering */
+    /** Internal: Store full element for rendering (used internally) */
     element?: unknown;
-    /** Optional additional properties */
+    /** Optional additional properties (e.g., documentId, properties from DSA API) */
     [key: string]: unknown;
 }
 export interface AnnotationInfoProperty {
@@ -78,15 +138,40 @@ export interface AnnotationInfoConfig {
     /** Custom header text */
     headerText?: string;
 }
+/**
+ * Interface for annotation caching implementations.
+ *
+ * Provides a cache-aside pattern for annotation documents to reduce API calls
+ * and improve performance. Implementations can use IndexedDB, memory, or other storage.
+ *
+ * @example Using IndexedDBAnnotationCache
+ * ```tsx
+ * import { IndexedDBAnnotationCache } from 'bdsa-react-components'
+ *
+ * const cache = new IndexedDBAnnotationCache()
+ *
+ * <SlideViewer
+ *   imageInfo={imageInfo}
+ *   annotationIds={['123', '456']}
+ *   annotationCache={cache}
+ * />
+ * ```
+ */
 export interface AnnotationCache {
+    /** Get an annotation from cache by ID and optional version hash */
     get(annotationId: string | number, versionHash?: string): Promise<unknown | null>;
+    /** Store an annotation in cache with optional TTL and version hash */
     set(annotationId: string | number, data: unknown, options?: {
         ttl?: number;
         versionHash?: string;
     }): Promise<void>;
+    /** Check if an annotation exists in cache */
     has(annotationId: string | number, versionHash?: string): Promise<boolean>;
+    /** Delete an annotation from cache */
     delete(annotationId: string | number): Promise<void>;
+    /** Clear all annotations from cache */
     clear(): Promise<void>;
+    /** Get cache statistics (optional - may not be implemented by all caches) */
     getStats?(): Promise<{
         size: number;
         hits?: number;
@@ -94,6 +179,78 @@ export interface AnnotationCache {
         hitRate?: number;
     }>;
 }
+/**
+ * Viewport bounds in normalized coordinates (0-1) relative to the full image.
+ * These coordinates are consistent across different image sizes.
+ */
+export interface ViewportBounds {
+    /** Left edge of viewport (0-1, normalized) */
+    x: number;
+    /** Top edge of viewport (0-1, normalized) */
+    y: number;
+    /** Width of viewport (0-1, normalized) */
+    width: number;
+    /** Height of viewport (0-1, normalized) */
+    height: number;
+    /** Current zoom level (e.g., 1.0 = 100%, 2.0 = 200%) */
+    zoom: number;
+}
+/**
+ * Configuration for an overlay tile source that can be dynamically added to the viewer.
+ * Overlay tile sources are rendered on top of the base image and can be positioned, scaled, and have their opacity controlled.
+ *
+ * @example Base64 image overlay
+ * ```tsx
+ * const overlay: OverlayTileSource = {
+ *   id: 'overlay-1',
+ *   tileSource: 'data:image/png;base64,iVBORw0KGgoAAAANS...',
+ *   x: 0.2,  // Position at 20% from left
+ *   y: 0.3,  // Position at 30% from top
+ *   width: 0.5,  // 50% of base image width
+ *   height: 0.5,  // 50% of base image height
+ *   opacity: 0.7,
+ * }
+ * ```
+ *
+ * @example DZI URL overlay
+ * ```tsx
+ * const overlay: OverlayTileSource = {
+ *   id: 'overlay-2',
+ *   tileSource: 'http://bdsa.pathology.emory.edu:8080/api/v1/item/123/tiles/dzi.dzi',
+ *   x: 0,
+ *   y: 0,
+ *   opacity: 0.5,
+ * }
+ * ```
+ */
+export interface OverlayTileSource {
+    /** Unique identifier for this overlay tile source */
+    id: string | number;
+    /**
+     * Tile source for the overlay. Can be:
+     * - Base64 data URL: `'data:image/png;base64,...'`
+     * - DZI URL: `'http://.../dzi.dzi'`
+     * - Simple image URL: `'http://.../image.jpg'`
+     * - OpenSeadragon tile source object
+     */
+    tileSource: string | unknown;
+    /** X position in image coordinates (0 = left edge, 1 = right edge). Default: 0 */
+    x?: number;
+    /** Y position in image coordinates (0 = top edge, 1 = bottom edge). Default: 0 */
+    y?: number;
+    /** Width in image coordinates (0-1, normalized). If not provided, uses tile source's natural width. */
+    width?: number;
+    /** Height in image coordinates (0-1, normalized). If not provided, uses tile source's natural height. */
+    height?: number;
+    /** Opacity (0-1). Default: 1 */
+    opacity?: number;
+    /** Rotation in degrees. Default: 0 */
+    rotation?: number;
+    /** Composite operation (e.g., 'multiply', 'screen', 'overlay'). Default: 'source-over' */
+    compositeOperation?: string;
+    /** Whether the overlay is visible. Default: true */
+    visible?: boolean;
+}
 export interface SlideViewerProps {
     /** Image information for the slide to display */
     imageInfo: SlideImageInfo;
@@ -169,6 +326,82 @@ export interface SlideViewerProps {
      *  Typically obtained from AnnotationManager: `annotations.map(ann => [ann._id, ann])` or similar.
      *  If not provided, cache will work but version-based invalidation will be disabled. */
     annotationHeaders?: Map<string | number, unknown> | Record<string, unknown>;
+    /** Callback that fires whenever the viewport changes (pan, zoom, resize).
+     *  Provides normalized coordinates (0-1) relative to the full image for consistency across image sizes.
+     *
+     *  @example
+     *  ```tsx
+     *  <SlideViewer
+     *    imageInfo={{ dziUrl: '...' }}
+     *    onViewportChange={(bounds) => {
+     *      console.log('Viewport:', bounds)
+     *      // bounds: { x: 0.25, y: 0.3, width: 0.5, height: 0.4, zoom: 2.0 }
+     *      setViewportState(bounds)
+     *    }}
+     *  />
+     *  ```
+     *
+     *  Use cases:
+     *  - Display current viewport coordinates in UI
+     *  - Capture a region of the image based on current viewport
+     *  - Save/restore viewport state
+     *  - Sync viewport across multiple viewers
+     *  - Generate viewport-based annotations
+     */
+    onViewportChange?: (bounds: ViewportBounds) => void;
+    /**
+     * Callback when an API error occurs.
+     * Provides error details and a retry function for transient failures.
+     *
+     * @param error - The error that occurred
+     * @param retry - Function to retry the failed operation
+     * @param context - Additional context about the error (endpoint, operation type, etc.)
+     *
+     * @example
+     * ```tsx
+     * <SlideViewer
+     *   imageInfo={imageInfo}
+     *   annotationIds={['ann-1', 'ann-2']}
+     *   apiBaseUrl="http://bdsa.pathology.emory.edu:8080/api/v1"
+     *   onApiError={(error, retry, context) => {
+     *     if (error.status === 401) {
+     *       // Token expired, refresh and retry
+     *       refreshToken().then(() => retry())
+     *     } else if (error.isRetryable) {
+     *       // Retry with delay
+     *       setTimeout(() => retry(), 2000)
+     *     } else {
+     *       // Show error to user
+     *       showErrorNotification(error.message)
+     *     }
+     *   }}
+     * />
+     * ```
+     */
+    onApiError?: ApiErrorHandler;
+    /**
+     * Array of overlay tile sources to display on top of the base image.
+     * Overlays can be dynamically added, removed, or updated by changing this array.
+     *
+     * @example
+     * ```tsx
+     * <SlideViewer
+     *   imageInfo={imageInfo}
+     *   overlayTileSources={[
+     *     {
+     *       id: 'overlay-1',
+     *       tileSource: 'data:image/png;base64,iVBORw0KGgo...',
+     *       x: 0.2,
+     *       y: 0.3,
+     *       width: 0.5,
+     *       height: 0.5,
+     *       opacity: 0.7,
+     *     }
+     *   ]}
+     * />
+     * ```
+     */
+    overlayTileSources?: OverlayTileSource[];
     /** If true, enables debug logging to console. Default: false */
     debug?: boolean;
 }

package/dist/components/SlideViewer/SlideViewer.types.d.ts.map

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

package/dist/components/SlideViewer/hooks/index.d.ts

@@ -2,4 +2,6 @@ export { useAnnotationFetching, type UseAnnotationFetchingResult } from './useAn
 export { useAnnotationRendering } from './useAnnotationRendering';
 export { useAnnotationOpacity } from './useAnnotationOpacity';
 export { useSlideViewerInitialization } from './useSlideViewerInitialization';
+export { useViewportChange } from './useViewportChange';
+export { useOverlayTileSources } from './useOverlayTileSources';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/SlideViewer/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/SlideViewer/hooks/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,KAAK,2BAA2B,EAAE,MAAM,yBAAyB,CAAA;AACjG,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/SlideViewer/hooks/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,KAAK,2BAA2B,EAAE,MAAM,yBAAyB,CAAA;AACjG,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAA;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA"}

package/dist/components/SlideViewer/hooks/useAnnotationFetching.d.ts

@@ -1,5 +1,6 @@
 import { default as React } from 'react';
 import { AnnotationFeature } from '../SlideViewer.types';
+import { ApiErrorHandler } from '../../../utils/apiErrorHandling';
 
 export interface UseAnnotationFetchingResult {
     fetchedAnnotations: AnnotationFeature[];
@@ -19,5 +20,5 @@ export declare function useAnnotationFetching(annotationIds: (string | number)[]
         versionHash?: string;
     }): Promise<void>;
     delete(annotationId: string | number): Promise<void>;
-} | null, annotationHeaders: Map<string | number, unknown> | Record<string, unknown> | undefined, apiHeaders: HeadersInit | undefined, isMountedRef: React.MutableRefObject<boolean>, debug: boolean): UseAnnotationFetchingResult;
+} | null, annotationHeaders: Map<string | number, unknown> | Record<string, unknown> | undefined, apiHeaders: HeadersInit | undefined, isMountedRef: React.MutableRefObject<boolean>, debug: boolean, onApiError?: ApiErrorHandler): UseAnnotationFetchingResult;
 //# sourceMappingURL=useAnnotationFetching.d.ts.map

package/dist/components/SlideViewer/hooks/useAnnotationFetching.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAnnotationFetching.d.ts","sourceRoot":"","sources":["../../../../src/components/SlideViewer/hooks/useAnnotationFetching.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAI7D,MAAM,WAAW,2BAA2B;IACxC,kBAAkB,EAAE,iBAAiB,EAAE,CAAA;IACvC,mBAAmB,EAAE,KAAK,CAAC;QACvB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;QACnB,YAAY,EAAE,MAAM,CAAA;QACpB,WAAW,EAAE,MAAM,CAAA;QACnB,KAAK,EAAE,MAAM,EAAE,CAAA;QACf,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,cAAc,CAAC,EAAE,MAAM,CAAA;KAC1B,CAAC,CAAA;CACL;AAED,wBAAgB,qBAAqB,CACjC,aAAa,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,SAAS,EAC9C,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,sBAAsB,EAAE,MAAM,EAC9B,sBAAsB,EAAE,MAAM,EAC9B,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,EACvE,KAAK,EAAE;IACH,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IACjF,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClH,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACvD,GAAG,IAAI,EACR,iBAAiB,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACtF,UAAU,EAAE,WAAW,GAAG,SAAS,EACnC,YAAY,EAAE,KAAK,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAC7C,KAAK,EAAE,OAAO,GACf,2BAA2B,CA4M7B"}
+{"version":3,"file":"useAnnotationFetching.d.ts","sourceRoot":"","sources":["../../../../src/components/SlideViewer/hooks/useAnnotationFetching.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAG7D,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,iCAAiC,CAAA;AAEtF,MAAM,WAAW,2BAA2B;IACxC,kBAAkB,EAAE,iBAAiB,EAAE,CAAA;IACvC,mBAAmB,EAAE,KAAK,CAAC;QACvB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;QACnB,YAAY,EAAE,MAAM,CAAA;QACpB,WAAW,EAAE,MAAM,CAAA;QACnB,KAAK,EAAE,MAAM,EAAE,CAAA;QACf,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,cAAc,CAAC,EAAE,MAAM,CAAA;KAC1B,CAAC,CAAA;CACL;AAED,wBAAgB,qBAAqB,CACjC,aAAa,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,SAAS,EAC9C,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,sBAAsB,EAAE,MAAM,EAC9B,sBAAsB,EAAE,MAAM,EAC9B,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,EACvE,KAAK,EAAE;IACH,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IACjF,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClH,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACvD,GAAG,IAAI,EACR,iBAAiB,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACtF,UAAU,EAAE,WAAW,GAAG,SAAS,EACnC,YAAY,EAAE,KAAK,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAC7C,KAAK,EAAE,OAAO,EACd,UAAU,CAAC,EAAE,eAAe,GAC7B,2BAA2B,CA+N7B"}

package/dist/components/SlideViewer/hooks/useOverlayTileSources.d.ts

@@ -0,0 +1,9 @@
+import { Viewer as OpenSeadragonViewer } from 'openseadragon';
+import { OverlayTileSource } from '../SlideViewer.types';
+import { DebugLogger } from '../../../utils/debugLog';
+
+/**
+ * Hook to manage overlay tile sources (dynamically add/remove/update tile sources on top of base image)
+ */
+export declare function useOverlayTileSources(viewer: OpenSeadragonViewer | null, overlayTileSources: OverlayTileSource[], baseImageWidth: number | null, baseImageHeight: number | null, debugLog: DebugLogger): void;
+//# sourceMappingURL=useOverlayTileSources.d.ts.map

package/dist/components/SlideViewer/hooks/useOverlayTileSources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOverlayTileSources.d.ts","sourceRoot":"","sources":["../../../../src/components/SlideViewer/hooks/useOverlayTileSources.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,IAAI,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAElE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAE1D;;GAEG;AACH,wBAAgB,qBAAqB,CACjC,MAAM,EAAE,mBAAmB,GAAG,IAAI,EAClC,kBAAkB,EAAE,iBAAiB,EAAE,EACvC,cAAc,EAAE,MAAM,GAAG,IAAI,EAC7B,eAAe,EAAE,MAAM,GAAG,IAAI,EAC9B,QAAQ,EAAE,WAAW,QAuYxB"}

package/dist/components/SlideViewer/hooks/useViewportChange.d.ts

@@ -0,0 +1,14 @@
+import { Viewer as OpenSeadragonViewer } from 'openseadragon';
+import { ViewportBounds } from '../SlideViewer.types';
+import { DebugLogger } from '../../../utils/debugLog';
+
+/**
+ * Hook to handle viewport change callbacks from OpenSeadragon viewer.
+ * Fires callback whenever viewport changes (pan, zoom, resize) with normalized coordinates.
+ */
+export declare function useViewportChange(viewer: OpenSeadragonViewer | null, onViewportChange: ((bounds: ViewportBounds) => void) | undefined, imageInfo: {
+    width?: number;
+    height?: number;
+    dziUrl?: string;
+}, debugLog: DebugLogger): void;
+//# sourceMappingURL=useViewportChange.d.ts.map

package/dist/components/SlideViewer/hooks/useViewportChange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useViewportChange.d.ts","sourceRoot":"","sources":["../../../../src/components/SlideViewer/hooks/useViewportChange.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,IAAI,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAE1D;;;GAGG;AACH,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,mBAAmB,GAAG,IAAI,EAClC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC,GAAG,SAAS,EAChE,SAAS,EAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;CAClB,EACD,QAAQ,EAAE,WAAW,QA+QxB"}

package/dist/components/ThumbnailGrid/ThumbnailGrid.d.ts

@@ -1,5 +1,6 @@
 import { default as React } from 'react';
 import { Item } from '../../utils/itemUtils';
+import { ApiErrorHandler } from '../../utils/apiErrorHandling';
 
 export interface ThumbnailGridProps {
     /** DSA folder ID to fetch items from */
@@ -42,6 +43,35 @@ export interface ThumbnailGridProps {
     getDatasetType?: (itemId: string) => 'train' | 'val' | 'test' | null;
     /** Callback when thumbnail is clicked */
     onThumbnailClick?: (item: Item) => void;
+    /**
+     * Callback when an API error occurs.
+     * Provides error details and a retry function for transient failures.
+     *
+     * @param error - The error that occurred
+     * @param retry - Function to retry the failed operation
+     * @param context - Additional context about the error (endpoint, operation type, etc.)
+     *
+     * @example
+     * ```tsx
+     * <ThumbnailGrid
+     *   apiBaseUrl="http://bdsa.pathology.emory.edu:8080/api/v1"
+     *   folderId="folder-123"
+     *   onApiError={(error, retry, context) => {
+     *     if (error.status === 401) {
+     *       // Token expired, refresh and retry
+     *       refreshToken().then(() => retry())
+     *     } else if (error.isRetryable) {
+     *       // Retry with delay
+     *       setTimeout(() => retry(), 2000)
+     *     } else {
+     *       // Show error to user
+     *       showErrorNotification(error.message)
+     *     }
+     *   }}
+     * />
+     * ```
+     */
+    onApiError?: ApiErrorHandler;
     /** Debug mode for logging */
     debug?: boolean;
     /** Custom CSS class */

package/dist/components/ThumbnailGrid/ThumbnailGrid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ThumbnailGrid.d.ts","sourceRoot":"","sources":["../../../src/components/ThumbnailGrid/ThumbnailGrid.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4D,MAAM,OAAO,CAAA;AAChF,OAAO,EAAgC,KAAK,IAAI,EAAE,MAAM,uBAAuB,CAAA;AAE/E,OAAO,qBAAqB,CAAA;AAE5B,MAAM,WAAW,kBAAkB;IAE/B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,gDAAgD;IAChD,KAAK,CAAC,EAAE,IAAI,EAAE,CAAA;IAGd,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAA;IAClB,mGAAmG;IACnG,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,4CAA4C;IAC5C,UAAU,CAAC,EAAE,WAAW,CAAA;IACxB,gHAAgH;IAChH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;yBAEqB;IACrB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;IAGnE,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,CAAA;IACtC,mHAAmH;IACnH,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAG3B,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gCAAgC;IAChC,gBAAgB,CAAC,EAAE;QACf,KAAK,EAAE,MAAM,EAAE,CAAA;QACf,GAAG,EAAE,MAAM,EAAE,CAAA;QACb,IAAI,EAAE,MAAM,EAAE,CAAA;KACjB,CAAA;IAGD,4CAA4C;IAC5C,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,IAAI,CAAA;IAC3C,yCAAyC;IACzC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,IAAI,CAAA;IACpE,yCAAyC;IACzC,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAA;IAGvC,6BAA6B;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AAYD;;;GAGG;AACH,eAAO,MAAM,aAAa,2FA2bzB,CAAA"}
+{"version":3,"file":"ThumbnailGrid.d.ts","sourceRoot":"","sources":["../../../src/components/ThumbnailGrid/ThumbnailGrid.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4D,MAAM,OAAO,CAAA;AAChF,OAAO,EAAgC,KAAK,IAAI,EAAE,MAAM,uBAAuB,CAAA;AAE/E,OAAO,EAAkB,KAAK,eAAe,EAAiB,MAAM,8BAA8B,CAAA;AAClG,OAAO,qBAAqB,CAAA;AAE5B,MAAM,WAAW,kBAAkB;IAE/B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,gDAAgD;IAChD,KAAK,CAAC,EAAE,IAAI,EAAE,CAAA;IAGd,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAA;IAClB,mGAAmG;IACnG,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,4CAA4C;IAC5C,UAAU,CAAC,EAAE,WAAW,CAAA;IACxB,gHAAgH;IAChH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;yBAEqB;IACrB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;IAGnE,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,CAAA;IACtC,mHAAmH;IACnH,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAG3B,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gCAAgC;IAChC,gBAAgB,CAAC,EAAE;QACf,KAAK,EAAE,MAAM,EAAE,CAAA;QACf,GAAG,EAAE,MAAM,EAAE,CAAA;QACb,IAAI,EAAE,MAAM,EAAE,CAAA;KACjB,CAAA;IAGD,4CAA4C;IAC5C,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,IAAI,CAAA;IAC3C,yCAAyC;IACzC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,IAAI,CAAA;IACpE,yCAAyC;IACzC,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAA;IAGvC;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,UAAU,CAAC,EAAE,eAAe,CAAA;IAC5B,6BAA6B;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AAYD;;;GAGG;AACH,eAAO,MAAM,aAAa,2FA+gBzB,CAAA"}