react-iiif-vault 1.3.6 → 1.5.0

package/dist/index.d.cts

@@ -1,31 +1,107 @@
-import { S as SimpleViewerContext, a as SimpleViewerProps } from './index-B6kdyv-j.cjs';
-export { C as CanvasPanel, c as SimpleViewerActions, d as SimpleViewerActionsType, b as SimpleViewerReducerState } from './index-B6kdyv-j.cjs';
-import * as React$1 from 'react';
-import React__default, { ReactNode, FunctionComponent, RefObject } from 'react';
+import { A as AudioComponentProps, V as VideoComponentProps, S as SimpleViewerContext, a as SimpleViewerProps } from './index-Cs7EchlV.cjs';
+export { C as CanvasPanel, c as SimpleViewerActions, d as SimpleViewerActionsType, b as SimpleViewerReducerState } from './index-Cs7EchlV.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { InternationalString, ImageService, ImageSize, AuthProbeService2, Auth2LocationResource, Auth2SubstituteResource, AuthAccessService2, AuthAccessTokenService2, AuthAccessToken2, SearchServiceQueryParams, SearchServiceSearchResponse, SearchService as SearchService$1, SearchServiceAutocomplete, Reference, Annotation } from '@iiif/presentation-3';
-import { RegionParameter, RotationParameter, SizeParameter, ImageServiceLoader, ImageCandidateRequest, ImageCandidate } from '@atlas-viewer/iiif-image-api';
+import * as React$1 from 'react';
+import React__default, { ReactNode, FunctionComponent, RefObject, Context } from 'react';
+import { R as RenderingStrategy, b as StrategyActions, M as MediaStrategy, c as SingleImageStrategy, E as EmptyStrategy, C as ComplexTimelineStrategy, I as ImageWithOptionalService, T as TimelineKeyframe, U as UnknownStrategy, d as ImageServiceLoaderType } from './useRenderingStrategy-B03X9rQS.cjs';
+export { f as AnnotationPageDescription, A as AudioSequence, n as ChoiceEvents, k as Single3DModelStrategy, S as SingleAudio, a as SingleVideo, e as SingleYouTubeVideo, i as TextContent, h as TextualContentStrategy, m as UseRenderingStrategy, o as UseRenderingStrategyOptions, V as VideoSequence, l as get3dStrategy, g as getImageStrategy, j as getTextualContentStrategy, u as useLoadImageService, p as useRenderingStrategy } from './useRenderingStrategy-B03X9rQS.cjs';
+import * as _iiif_helpers from '@iiif/helpers';
+import { ChoiceDescription, Paintables, Vault as Vault$1, ComplexChoice } from '@iiif/helpers';
+import { BoxStyle, AtlasProps, Preset } from '@atlas-viewer/atlas';
+import { InternationalString, ImageService as ImageService$1, ImageSize, AuthProbeService2, Auth2LocationResource, Auth2SubstituteResource, AuthAccessService2, AuthAccessTokenService2, AuthAccessToken2, SearchServiceQueryParams, SearchServiceSearchResponse, SearchService as SearchService$1, SearchServiceAutocomplete, Reference, Annotation } from '@iiif/presentation-3';
+import { RegionParameter, RotationParameter, SizeParameter } from '@iiif/parser/image-3';
 import * as polygon_editor from 'polygon-editor';
 import { RenderState, InputShape, SlowState } from 'polygon-editor';
-import { BoxStyle, Preset } from '@atlas-viewer/atlas';
 import * as zustand_vanilla from 'zustand/vanilla';
 import { StoreApi } from 'zustand/vanilla';
 import * as zustand from 'zustand';
 import { StoreApi as StoreApi$1 } from 'zustand';
-import { C as ComplexTimelineStrategy, T as TimelineKeyframe, U as UnknownStrategy, M as MediaStrategy, d as ImageServiceLoaderType } from './useRenderingStrategy-2EaRC2Nc.cjs';
-export { f as AnnotationPageDescription, A as AudioSequence, n as ChoiceEvents, E as EmptyStrategy, I as ImageWithOptionalService, R as RenderingStrategy, k as Single3DModelStrategy, b as SingleAudio, a as SingleImageStrategy, c as SingleVideo, e as SingleYouTubeVideo, S as StrategyActions, i as TextContent, h as TextualContentStrategy, m as UseRenderingStrategy, o as UseRenderingStrategyOptions, V as VideoSequence, l as get3dStrategy, g as getImageStrategy, j as getTextualContentStrategy, u as useLoadImageService, p as useRenderingStrategy } from './useRenderingStrategy-2EaRC2Nc.cjs';
 import * as mitt from 'mitt';
 import { Emitter, EventType, Handler } from 'mitt';
 import { Vault, VaultOptions, NormalizedEntity, IIIFStore } from '@iiif/helpers/vault';
-import * as _iiif_helpers from '@iiif/helpers';
-import { Paintables, ComplexChoice } from '@iiif/helpers';
 import { CanvasNormalized, AnnotationNormalized, AnnotationPageNormalized, CollectionNormalized, ManifestNormalized, RangeNormalized } from '@iiif/presentation-3-normalized';
+import { ImageServiceLoader, ImageCandidateRequest, ImageCandidate } from '@iiif/helpers/image-service';
 export { emptyActions, emptyStrategy, getParsedTargetSelector, getRenderingStrategy, parseSpecificResource, unknownResponse, unsupportedStrategy } from './utils.cjs';
 import { VaultZustandStore } from '@iiif/helpers/vault/store';
 import * as _iiif_helpers_painting_annotations from '@iiif/helpers/painting-annotations';
 import * as _iiif_helpers_styles from '@iiif/helpers/styles';
 export * from '@iiif/helpers/annotation-targets';
 
+interface CanvasStrategyProviderProps {
+    onChoiceChange?: (choice?: ChoiceDescription) => void;
+    strategies?: Array<RenderingStrategy['type']>;
+    registerActions?: (actions: StrategyActions) => void;
+    defaultChoices?: Array<{
+        id: string;
+        opacity?: number;
+    }>;
+    children: ReactNode;
+    renderMediaControls?: (strategy: MediaStrategy) => ReactNode;
+    viewControlsDeps?: any[];
+    renderViewerControls?: (strategy: SingleImageStrategy | EmptyStrategy) => ReactNode;
+    renderComplexTimelineControls?: (strategy: ComplexTimelineStrategy) => ReactNode;
+    complexTimelineControlsDeps?: any[];
+    mediaControlsDeps?: any[];
+    throwOnUnknown?: boolean;
+}
+declare function CanvasStrategyProvider({ strategies, registerActions, defaultChoices, onChoiceChange, mediaControlsDeps, renderMediaControls, renderViewerControls, viewControlsDeps, renderComplexTimelineControls, complexTimelineControlsDeps, throwOnUnknown, children, }: CanvasStrategyProviderProps): react_jsx_runtime.JSX.Element;
+
+interface CanvasWorldObjectProps {
+    x?: number;
+    y?: number;
+    keepCanvasScale?: boolean;
+    children?: ReactNode;
+}
+declare function CanvasWorldObject({ x, y, keepCanvasScale, children }: CanvasWorldObjectProps): react_jsx_runtime.JSX.Element | null;
+
+declare function ThumbnailFallbackImage({ x, y }: {
+    x?: number;
+    y?: number;
+}): react_jsx_runtime.JSX.Element | null;
+
+interface RenderEmptyStrategyProps {
+    backgroundStyle?: BoxStyle;
+    alwaysShowBackground?: boolean;
+}
+declare function RenderEmptyStrategy({ backgroundStyle, alwaysShowBackground }: RenderEmptyStrategyProps): react_jsx_runtime.JSX.Element | null;
+
+declare function RenderComplexTimelineStrategy(): react_jsx_runtime.JSX.Element | null;
+
+interface TextualContextStrategyProps {
+    onClickPaintingAnnotation?: (id: string, e: any) => void;
+    children?: ReactNode;
+}
+declare function RenderTextualContentStrategy({ onClickPaintingAnnotation, children }: TextualContextStrategyProps): react_jsx_runtime.JSX.Element | null;
+
+interface ImageStrategyProps {
+    isStatic?: boolean;
+    enableSizes?: boolean;
+    onClickPaintingAnnotation?: (id: string, image: ImageWithOptionalService, e: any) => void;
+    children?: ReactNode;
+}
+declare function RenderImageStrategy({ isStatic, enableSizes, onClickPaintingAnnotation, children, }: ImageStrategyProps): react_jsx_runtime.JSX.Element | null;
+
+declare function Render3DModelStrategy(): react_jsx_runtime.JSX.Element | null;
+
+interface AnnotationStrategyProps {
+    children?: ReactNode;
+}
+declare function RenderAnnotationStrategy({ children }: AnnotationStrategyProps): react_jsx_runtime.JSX.Element | null;
+
+interface RenderAudioStrategyProps {
+    as?: React.ComponentType<AudioComponentProps>;
+}
+declare function RenderAudioStrategy({ as: CustomAudio }: RenderAudioStrategyProps): react_jsx_runtime.JSX.Element | null;
+
+declare function RenderAccompanyingCanvas(): react_jsx_runtime.JSX.Element;
+
+interface RenderVideoStrategyProps {
+    as?: React__default.ComponentType<VideoComponentProps>;
+}
+declare function RenderVideoStrategy({ as: CustomVideo }: RenderVideoStrategyProps): react_jsx_runtime.JSX.Element | null;
+
+declare function RenderYouTubeStrategy(): react_jsx_runtime.JSX.Element | null;
+
 declare const CanvasAnnotations: React$1.ForwardRefExoticComponent<{
     canvasId?: string | undefined;
 } & React$1.RefAttributes<{
@@ -79,7 +155,7 @@ type CombinedMetadataProps = Omit<MetadataProps, 'metadata'>;
 declare function CombinedMetadata(props: CombinedMetadataProps): react_jsx_runtime.JSX.Element;
 
 interface ImageProps {
-    src: string | ImageService;
+    src: string | ImageService$1;
     alt?: string;
     size?: Partial<ImageSize>;
     region?: RegionParameter;
@@ -314,6 +390,21 @@ interface PolygonSelectorProps {
 }
 declare function PolygonSelector(props: PolygonSelectorProps): react_jsx_runtime.JSX.Element | null;
 
+interface ImageServiceProps {
+    src: string;
+    atlas?: AtlasProps;
+    errorFallback?: React__default.FC;
+    interactive?: boolean;
+    skipSizes?: boolean;
+    renderViewerControls?: (strategy: SingleImageStrategy | EmptyStrategy) => ReactNode;
+    viewControlsDeps?: any[];
+    fluid?: boolean;
+    x?: number;
+    y?: number;
+    children?: React__default.ReactNode;
+}
+declare function ImageService({ src, errorFallback, interactive, skipSizes, children, renderViewerControls, viewControlsDeps, fluid, x, y, ...atlasProps }: ImageServiceProps & Omit<AtlasProps, 'children'>): react_jsx_runtime.JSX.Element | null;
+
 declare function AnnotationContext({ annotation, children }: {
     annotation: string;
     children: ReactNode;
@@ -599,6 +690,20 @@ interface Search1Store {
     nextResult: () => void;
 }
 
+declare function useCustomContextBridge(): Record<string, {
+    value: any;
+    Provider: React__default.Provider<any>;
+}>;
+declare function CustomContextBridge(props: Record<string, {
+    value: any;
+    Provider: React__default.Provider<any>;
+}> & {
+    children: React__default.ReactNode;
+}): ReactNode;
+declare function CustomContextBridgeProvider(props: {
+    providers: Record<string, Context<any>>;
+    children: React__default.ReactNode;
+}): react_jsx_runtime.JSX.Element;
 declare function useContextBridge(): {
     VaultContext: {
         vault: _iiif_helpers.Vault | null;
@@ -615,6 +720,7 @@ declare function useContextBridge(): {
 };
 declare function ContextBridge(props: {
     bridge: ReturnType<typeof useContextBridge>;
+    custom?: ReturnType<typeof useCustomContextBridge>;
     children: ReactNode;
 }): react_jsx_runtime.JSX.Element;
 
@@ -727,9 +833,27 @@ declare function AnnotationStyleProvider({ theme, children, }: {
     children: React.ReactNode;
 }): react_jsx_runtime.JSX.Element;
 
-declare function getVideoStrategy(canvas: CanvasNormalized, paintables: Paintables): UnknownStrategy | MediaStrategy;
+interface StrategyContext {
+    strategy: RenderingStrategy;
+    choices: ChoiceDescription | null;
+}
+declare const StrategyReactContext: React$1.Context<StrategyContext | null>;
+declare function useStrategy(): StrategyContext;
+
+interface ControlsContext {
+    renderMediaControls?: (strategy: MediaStrategy) => ReactNode;
+    viewControlsDeps: any[];
+    renderViewerControls?: (strategy: SingleImageStrategy | EmptyStrategy) => ReactNode;
+    mediaControlsDeps: any[];
+    renderComplexTimelineControls?: (strategy: ComplexTimelineStrategy) => ReactNode;
+    complexTimelineControlsDeps: any[];
+}
+declare const ControlsReactContext: React$1.Context<ControlsContext | null>;
+declare function useRenderControls(): ControlsContext;
+
+declare function getVideoStrategy(canvas: CanvasNormalized, paintables: Paintables, vault: Vault$1): UnknownStrategy | MediaStrategy;
 
-declare function getComplexTimelineStrategy(canvas: CanvasNormalized, paintables: Paintables, loadImageService: ImageServiceLoaderType): ComplexTimelineStrategy;
+declare function getComplexTimelineStrategy(canvas: CanvasNormalized, paintables: Paintables, loadImageService: ImageServiceLoaderType, vault: Vault$1): ComplexTimelineStrategy;
 
 declare function useAnnotation(options?: {
     id: string;
@@ -850,7 +974,7 @@ declare function useExternalManifest(idOrRef: string | {
     manifest?: ManifestNormalized;
 };
 
-declare function useImage(service: ImageService | undefined, data?: {
+declare function useImage(service: ImageService$1 | undefined, data?: {
     size?: Partial<ImageSize>;
     selector?: RegionParameter;
     rotation?: number | RotationParameter;
@@ -868,7 +992,7 @@ interface ImageServiceRequestOptions {
  * @note It is better to use the hook useRenderingStrategy for rendering.
  */
 declare function useImageService({ cacheKey }?: ImageServiceRequestOptions): {
-    data: ImageService | undefined;
+    data: ImageService$1 | undefined;
     isFetching: boolean;
     status: 'error' | 'success' | 'loading' | 'idle';
 };
@@ -879,7 +1003,7 @@ declare function useImageTile(): {
         id: string | undefined;
         width: number | null | undefined;
         height: number | null | undefined;
-        imageService: ImageService;
+        imageService: ImageService$1;
         thumbnail: undefined;
     } | null;
 };
@@ -1120,4 +1244,4 @@ declare function findAllCanvasesInRange(vault: Vault, range: RangeNormalized): A
 declare function findManifestSelectedRange(vault: Vault, manifest: ManifestNormalized, canvasId: string): null | RangeNormalized;
 declare function findSelectedRange(vault: Vault, range: RangeNormalized, canvasId: string): null | RangeNormalized;
 
-export { AnnotationContext, AnnotationPageContext, AnnotationStyleProvider, type AnnotationStyles, type AnnotationThemeDefinition, Auth, type AuthAccessState, type AuthContextActions, type AuthContextCurrentActions, type AuthContextState, AuthProvider, AuthRContext, AuthReactContext, AuthReactContextActions, type AuthState, CanvasAnnotations, CanvasContext, CollectionContext, CombinedMetadata, ComplexTimelineProvider, ComplexTimelineStrategy, ContextBridge, CreateCustomShape, type CreateCustomShapeProps, EventsProvider, Image, type ImageProps, ImageServiceLoaderContext, ImageServiceLoaderType, type ImageServiceRequestOptions, InnerViewerProvider, LanguageProvider, LanguageString, LocaleString, ManifestContext, ManifestMetadata, type MediaPlayerActions, MediaPlayerProvider, type MediaPlayerState, MediaStrategy, Metadata, type MetadataProps, PolygonSelector, type PolygonSelectorProps, type ProbeStore, RangeContext, ReactEventContext, ReactVaultContext, RenderSvgEditorControls, type ResourceContextType, ResourceProvider, ResourceReactContext, type ResourceRequestOptions, SelectorControllerProvider, type SelectorHelperEventTypes, SequenceThumbnails, SimpleViewerContext, SimpleViewerProps, SimpleViewerProvider, SimpleViewerReactContext, SingleCanvasThumbnail, type SvgTheme, TimelineKeyframe, TranslationProvider, TransliterationProvider, UnknownStrategy, type VaultActivatedAnnotation, VaultProvider, ViewerPresetContext, VirtualAnnotationProvider, VisibleCanvasReactContext, authDetailsForResource, createAuthStateStore, createProbe, defaultEmitter, findAllCanvasesInRange, findFirstCanvasFromRange, findManifestSelectedRange, findSelectedRange, flattenAnnotationPageIds, formatTime, getComplexTimelineStrategy, getDefaultAnnotationStyles, getManifestSequence, getVideoStrategy, getVisibleCanvasesFromCanvasId, hasAuth, makeAccessServiceRequest, makeAccessTokenRequest, svgThemes, useAnnotation, useAnnotationPage, useAnnotationPageManager, useAnnotationStyles, useAnnotationsAtTime, useAuthActions, useAuthService, useAuthStore, useAuthToken, useAuthTokens, useCanvas, useCanvasChoices, useCanvasClock, useCanvasSequence, useCanvasStartTime, useCanvasSubset, useClosestLanguage, useCollection, useComplexTimeline, useContextBridge, useCreateLocaleString, useCurrentAuth, useDispatch, useEventEmitter, useEventListener, useExistingVault, useExternalCollection, useExternalManifest, useExternalResource, useIIIFLanguage, useImage, useImageService, useImageServiceLoader, useImageTile, useIsAuthEnabled, useLocaleString, useManifest, useMediaActions, useMediaElements, useMediaState, usePaintables, usePaintingAnnotations, usePolygonHelper, useRange, useResourceContext, useResourceEvents, useResources, useSearchService, useSelectorController, useSelectorEmitter, useSelectorEvents, useSelectorHelper, useSimpleMediaPlayer, useSimpleViewer, useStyleHelper, useStyles, useSvgEditor, useThumbnail, useTranslations, useTransliteration, useVault, useVaultEffect, useVaultSelector, useViewerPreset, useVirtualAnnotationPage, useVirtualAnnotationPageContext, useVisibleCanvases };
+export { AnnotationContext, AnnotationPageContext, type AnnotationStrategyProps, AnnotationStyleProvider, type AnnotationStyles, type AnnotationThemeDefinition, Auth, type AuthAccessState, type AuthContextActions, type AuthContextCurrentActions, type AuthContextState, AuthProvider, AuthRContext, AuthReactContext, AuthReactContextActions, type AuthState, CanvasAnnotations, CanvasContext, CanvasStrategyProvider, CanvasWorldObject, CollectionContext, CombinedMetadata, ComplexTimelineProvider, ComplexTimelineStrategy, ContextBridge, type ControlsContext, ControlsReactContext, CreateCustomShape, type CreateCustomShapeProps, CustomContextBridge, CustomContextBridgeProvider, EmptyStrategy, EventsProvider, Image, type ImageProps, ImageService, ImageServiceLoaderContext, ImageServiceLoaderType, type ImageServiceRequestOptions, type ImageStrategyProps, ImageWithOptionalService, InnerViewerProvider, LanguageProvider, LanguageString, LocaleString, ManifestContext, ManifestMetadata, type MediaPlayerActions, MediaPlayerProvider, type MediaPlayerState, MediaStrategy, Metadata, type MetadataProps, PolygonSelector, type PolygonSelectorProps, type ProbeStore, RangeContext, ReactEventContext, ReactVaultContext, Render3DModelStrategy, RenderAccompanyingCanvas, RenderAnnotationStrategy, RenderAudioStrategy, RenderComplexTimelineStrategy, RenderEmptyStrategy, RenderImageStrategy, RenderSvgEditorControls, RenderTextualContentStrategy, RenderVideoStrategy, RenderYouTubeStrategy, RenderingStrategy, type ResourceContextType, ResourceProvider, ResourceReactContext, type ResourceRequestOptions, SelectorControllerProvider, type SelectorHelperEventTypes, SequenceThumbnails, SimpleViewerContext, SimpleViewerProps, SimpleViewerProvider, SimpleViewerReactContext, SingleCanvasThumbnail, SingleImageStrategy, StrategyActions, type StrategyContext, StrategyReactContext, type SvgTheme, ThumbnailFallbackImage, TimelineKeyframe, TranslationProvider, TransliterationProvider, UnknownStrategy, type VaultActivatedAnnotation, VaultProvider, ViewerPresetContext, VirtualAnnotationProvider, VisibleCanvasReactContext, authDetailsForResource, createAuthStateStore, createProbe, defaultEmitter, findAllCanvasesInRange, findFirstCanvasFromRange, findManifestSelectedRange, findSelectedRange, flattenAnnotationPageIds, formatTime, getComplexTimelineStrategy, getDefaultAnnotationStyles, getManifestSequence, getVideoStrategy, getVisibleCanvasesFromCanvasId, hasAuth, makeAccessServiceRequest, makeAccessTokenRequest, svgThemes, useAnnotation, useAnnotationPage, useAnnotationPageManager, useAnnotationStyles, useAnnotationsAtTime, useAuthActions, useAuthService, useAuthStore, useAuthToken, useAuthTokens, useCanvas, useCanvasChoices, useCanvasClock, useCanvasSequence, useCanvasStartTime, useCanvasSubset, useClosestLanguage, useCollection, useComplexTimeline, useContextBridge, useCreateLocaleString, useCurrentAuth, useCustomContextBridge, useDispatch, useEventEmitter, useEventListener, useExistingVault, useExternalCollection, useExternalManifest, useExternalResource, useIIIFLanguage, useImage, useImageService, useImageServiceLoader, useImageTile, useIsAuthEnabled, useLocaleString, useManifest, useMediaActions, useMediaElements, useMediaState, usePaintables, usePaintingAnnotations, usePolygonHelper, useRange, useRenderControls, useResourceContext, useResourceEvents, useResources, useSearchService, useSelectorController, useSelectorEmitter, useSelectorEvents, useSelectorHelper, useSimpleMediaPlayer, useSimpleViewer, useStrategy, useStyleHelper, useStyles, useSvgEditor, useThumbnail, useTranslations, useTransliteration, useVault, useVaultEffect, useVaultSelector, useViewerPreset, useVirtualAnnotationPage, useVirtualAnnotationPageContext, useVisibleCanvases };

package/dist/index.d.ts

@@ -1,31 +1,107 @@
-import { S as SimpleViewerContext, a as SimpleViewerProps } from './index-D1lST-Xy.js';
-export { C as CanvasPanel, c as SimpleViewerActions, d as SimpleViewerActionsType, b as SimpleViewerReducerState } from './index-D1lST-Xy.js';
-import * as React$1 from 'react';
-import React__default, { ReactNode, FunctionComponent, RefObject } from 'react';
+import { A as AudioComponentProps, V as VideoComponentProps, S as SimpleViewerContext, a as SimpleViewerProps } from './index-DZK6q9iO.js';
+export { C as CanvasPanel, c as SimpleViewerActions, d as SimpleViewerActionsType, b as SimpleViewerReducerState } from './index-DZK6q9iO.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { InternationalString, ImageService, ImageSize, AuthProbeService2, Auth2LocationResource, Auth2SubstituteResource, AuthAccessService2, AuthAccessTokenService2, AuthAccessToken2, SearchServiceQueryParams, SearchServiceSearchResponse, SearchService as SearchService$1, SearchServiceAutocomplete, Reference, Annotation } from '@iiif/presentation-3';
-import { RegionParameter, RotationParameter, SizeParameter, ImageServiceLoader, ImageCandidateRequest, ImageCandidate } from '@atlas-viewer/iiif-image-api';
+import * as React$1 from 'react';
+import React__default, { ReactNode, FunctionComponent, RefObject, Context } from 'react';
+import { R as RenderingStrategy, b as StrategyActions, M as MediaStrategy, c as SingleImageStrategy, E as EmptyStrategy, C as ComplexTimelineStrategy, I as ImageWithOptionalService, T as TimelineKeyframe, U as UnknownStrategy, d as ImageServiceLoaderType } from './useRenderingStrategy-B03X9rQS.js';
+export { f as AnnotationPageDescription, A as AudioSequence, n as ChoiceEvents, k as Single3DModelStrategy, S as SingleAudio, a as SingleVideo, e as SingleYouTubeVideo, i as TextContent, h as TextualContentStrategy, m as UseRenderingStrategy, o as UseRenderingStrategyOptions, V as VideoSequence, l as get3dStrategy, g as getImageStrategy, j as getTextualContentStrategy, u as useLoadImageService, p as useRenderingStrategy } from './useRenderingStrategy-B03X9rQS.js';
+import * as _iiif_helpers from '@iiif/helpers';
+import { ChoiceDescription, Paintables, Vault as Vault$1, ComplexChoice } from '@iiif/helpers';
+import { BoxStyle, AtlasProps, Preset } from '@atlas-viewer/atlas';
+import { InternationalString, ImageService as ImageService$1, ImageSize, AuthProbeService2, Auth2LocationResource, Auth2SubstituteResource, AuthAccessService2, AuthAccessTokenService2, AuthAccessToken2, SearchServiceQueryParams, SearchServiceSearchResponse, SearchService as SearchService$1, SearchServiceAutocomplete, Reference, Annotation } from '@iiif/presentation-3';
+import { RegionParameter, RotationParameter, SizeParameter } from '@iiif/parser/image-3';
 import * as polygon_editor from 'polygon-editor';
 import { RenderState, InputShape, SlowState } from 'polygon-editor';
-import { BoxStyle, Preset } from '@atlas-viewer/atlas';
 import * as zustand_vanilla from 'zustand/vanilla';
 import { StoreApi } from 'zustand/vanilla';
 import * as zustand from 'zustand';
 import { StoreApi as StoreApi$1 } from 'zustand';
-import { C as ComplexTimelineStrategy, T as TimelineKeyframe, U as UnknownStrategy, M as MediaStrategy, d as ImageServiceLoaderType } from './useRenderingStrategy-2EaRC2Nc.js';
-export { f as AnnotationPageDescription, A as AudioSequence, n as ChoiceEvents, E as EmptyStrategy, I as ImageWithOptionalService, R as RenderingStrategy, k as Single3DModelStrategy, b as SingleAudio, a as SingleImageStrategy, c as SingleVideo, e as SingleYouTubeVideo, S as StrategyActions, i as TextContent, h as TextualContentStrategy, m as UseRenderingStrategy, o as UseRenderingStrategyOptions, V as VideoSequence, l as get3dStrategy, g as getImageStrategy, j as getTextualContentStrategy, u as useLoadImageService, p as useRenderingStrategy } from './useRenderingStrategy-2EaRC2Nc.js';
 import * as mitt from 'mitt';
 import { Emitter, EventType, Handler } from 'mitt';
 import { Vault, VaultOptions, NormalizedEntity, IIIFStore } from '@iiif/helpers/vault';
-import * as _iiif_helpers from '@iiif/helpers';
-import { Paintables, ComplexChoice } from '@iiif/helpers';
 import { CanvasNormalized, AnnotationNormalized, AnnotationPageNormalized, CollectionNormalized, ManifestNormalized, RangeNormalized } from '@iiif/presentation-3-normalized';
+import { ImageServiceLoader, ImageCandidateRequest, ImageCandidate } from '@iiif/helpers/image-service';
 export { emptyActions, emptyStrategy, getParsedTargetSelector, getRenderingStrategy, parseSpecificResource, unknownResponse, unsupportedStrategy } from './utils.js';
 import { VaultZustandStore } from '@iiif/helpers/vault/store';
 import * as _iiif_helpers_painting_annotations from '@iiif/helpers/painting-annotations';
 import * as _iiif_helpers_styles from '@iiif/helpers/styles';
 export * from '@iiif/helpers/annotation-targets';
 
+interface CanvasStrategyProviderProps {
+    onChoiceChange?: (choice?: ChoiceDescription) => void;
+    strategies?: Array<RenderingStrategy['type']>;
+    registerActions?: (actions: StrategyActions) => void;
+    defaultChoices?: Array<{
+        id: string;
+        opacity?: number;
+    }>;
+    children: ReactNode;
+    renderMediaControls?: (strategy: MediaStrategy) => ReactNode;
+    viewControlsDeps?: any[];
+    renderViewerControls?: (strategy: SingleImageStrategy | EmptyStrategy) => ReactNode;
+    renderComplexTimelineControls?: (strategy: ComplexTimelineStrategy) => ReactNode;
+    complexTimelineControlsDeps?: any[];
+    mediaControlsDeps?: any[];
+    throwOnUnknown?: boolean;
+}
+declare function CanvasStrategyProvider({ strategies, registerActions, defaultChoices, onChoiceChange, mediaControlsDeps, renderMediaControls, renderViewerControls, viewControlsDeps, renderComplexTimelineControls, complexTimelineControlsDeps, throwOnUnknown, children, }: CanvasStrategyProviderProps): react_jsx_runtime.JSX.Element;
+
+interface CanvasWorldObjectProps {
+    x?: number;
+    y?: number;
+    keepCanvasScale?: boolean;
+    children?: ReactNode;
+}
+declare function CanvasWorldObject({ x, y, keepCanvasScale, children }: CanvasWorldObjectProps): react_jsx_runtime.JSX.Element | null;
+
+declare function ThumbnailFallbackImage({ x, y }: {
+    x?: number;
+    y?: number;
+}): react_jsx_runtime.JSX.Element | null;
+
+interface RenderEmptyStrategyProps {
+    backgroundStyle?: BoxStyle;
+    alwaysShowBackground?: boolean;
+}
+declare function RenderEmptyStrategy({ backgroundStyle, alwaysShowBackground }: RenderEmptyStrategyProps): react_jsx_runtime.JSX.Element | null;
+
+declare function RenderComplexTimelineStrategy(): react_jsx_runtime.JSX.Element | null;
+
+interface TextualContextStrategyProps {
+    onClickPaintingAnnotation?: (id: string, e: any) => void;
+    children?: ReactNode;
+}
+declare function RenderTextualContentStrategy({ onClickPaintingAnnotation, children }: TextualContextStrategyProps): react_jsx_runtime.JSX.Element | null;
+
+interface ImageStrategyProps {
+    isStatic?: boolean;
+    enableSizes?: boolean;
+    onClickPaintingAnnotation?: (id: string, image: ImageWithOptionalService, e: any) => void;
+    children?: ReactNode;
+}
+declare function RenderImageStrategy({ isStatic, enableSizes, onClickPaintingAnnotation, children, }: ImageStrategyProps): react_jsx_runtime.JSX.Element | null;
+
+declare function Render3DModelStrategy(): react_jsx_runtime.JSX.Element | null;
+
+interface AnnotationStrategyProps {
+    children?: ReactNode;
+}
+declare function RenderAnnotationStrategy({ children }: AnnotationStrategyProps): react_jsx_runtime.JSX.Element | null;
+
+interface RenderAudioStrategyProps {
+    as?: React.ComponentType<AudioComponentProps>;
+}
+declare function RenderAudioStrategy({ as: CustomAudio }: RenderAudioStrategyProps): react_jsx_runtime.JSX.Element | null;
+
+declare function RenderAccompanyingCanvas(): react_jsx_runtime.JSX.Element;
+
+interface RenderVideoStrategyProps {
+    as?: React__default.ComponentType<VideoComponentProps>;
+}
+declare function RenderVideoStrategy({ as: CustomVideo }: RenderVideoStrategyProps): react_jsx_runtime.JSX.Element | null;
+
+declare function RenderYouTubeStrategy(): react_jsx_runtime.JSX.Element | null;
+
 declare const CanvasAnnotations: React$1.ForwardRefExoticComponent<{
     canvasId?: string | undefined;
 } & React$1.RefAttributes<{
@@ -79,7 +155,7 @@ type CombinedMetadataProps = Omit<MetadataProps, 'metadata'>;
 declare function CombinedMetadata(props: CombinedMetadataProps): react_jsx_runtime.JSX.Element;
 
 interface ImageProps {
-    src: string | ImageService;
+    src: string | ImageService$1;
     alt?: string;
     size?: Partial<ImageSize>;
     region?: RegionParameter;
@@ -314,6 +390,21 @@ interface PolygonSelectorProps {
 }
 declare function PolygonSelector(props: PolygonSelectorProps): react_jsx_runtime.JSX.Element | null;
 
+interface ImageServiceProps {
+    src: string;
+    atlas?: AtlasProps;
+    errorFallback?: React__default.FC;
+    interactive?: boolean;
+    skipSizes?: boolean;
+    renderViewerControls?: (strategy: SingleImageStrategy | EmptyStrategy) => ReactNode;
+    viewControlsDeps?: any[];
+    fluid?: boolean;
+    x?: number;
+    y?: number;
+    children?: React__default.ReactNode;
+}
+declare function ImageService({ src, errorFallback, interactive, skipSizes, children, renderViewerControls, viewControlsDeps, fluid, x, y, ...atlasProps }: ImageServiceProps & Omit<AtlasProps, 'children'>): react_jsx_runtime.JSX.Element | null;
+
 declare function AnnotationContext({ annotation, children }: {
     annotation: string;
     children: ReactNode;
@@ -599,6 +690,20 @@ interface Search1Store {
     nextResult: () => void;
 }
 
+declare function useCustomContextBridge(): Record<string, {
+    value: any;
+    Provider: React__default.Provider<any>;
+}>;
+declare function CustomContextBridge(props: Record<string, {
+    value: any;
+    Provider: React__default.Provider<any>;
+}> & {
+    children: React__default.ReactNode;
+}): ReactNode;
+declare function CustomContextBridgeProvider(props: {
+    providers: Record<string, Context<any>>;
+    children: React__default.ReactNode;
+}): react_jsx_runtime.JSX.Element;
 declare function useContextBridge(): {
     VaultContext: {
         vault: _iiif_helpers.Vault | null;
@@ -615,6 +720,7 @@ declare function useContextBridge(): {
 };
 declare function ContextBridge(props: {
     bridge: ReturnType<typeof useContextBridge>;
+    custom?: ReturnType<typeof useCustomContextBridge>;
     children: ReactNode;
 }): react_jsx_runtime.JSX.Element;
 
@@ -727,9 +833,27 @@ declare function AnnotationStyleProvider({ theme, children, }: {
     children: React.ReactNode;
 }): react_jsx_runtime.JSX.Element;
 
-declare function getVideoStrategy(canvas: CanvasNormalized, paintables: Paintables): UnknownStrategy | MediaStrategy;
+interface StrategyContext {
+    strategy: RenderingStrategy;
+    choices: ChoiceDescription | null;
+}
+declare const StrategyReactContext: React$1.Context<StrategyContext | null>;
+declare function useStrategy(): StrategyContext;
+
+interface ControlsContext {
+    renderMediaControls?: (strategy: MediaStrategy) => ReactNode;
+    viewControlsDeps: any[];
+    renderViewerControls?: (strategy: SingleImageStrategy | EmptyStrategy) => ReactNode;
+    mediaControlsDeps: any[];
+    renderComplexTimelineControls?: (strategy: ComplexTimelineStrategy) => ReactNode;
+    complexTimelineControlsDeps: any[];
+}
+declare const ControlsReactContext: React$1.Context<ControlsContext | null>;
+declare function useRenderControls(): ControlsContext;
+
+declare function getVideoStrategy(canvas: CanvasNormalized, paintables: Paintables, vault: Vault$1): UnknownStrategy | MediaStrategy;
 
-declare function getComplexTimelineStrategy(canvas: CanvasNormalized, paintables: Paintables, loadImageService: ImageServiceLoaderType): ComplexTimelineStrategy;
+declare function getComplexTimelineStrategy(canvas: CanvasNormalized, paintables: Paintables, loadImageService: ImageServiceLoaderType, vault: Vault$1): ComplexTimelineStrategy;
 
 declare function useAnnotation(options?: {
     id: string;
@@ -850,7 +974,7 @@ declare function useExternalManifest(idOrRef: string | {
     manifest?: ManifestNormalized;
 };
 
-declare function useImage(service: ImageService | undefined, data?: {
+declare function useImage(service: ImageService$1 | undefined, data?: {
     size?: Partial<ImageSize>;
     selector?: RegionParameter;
     rotation?: number | RotationParameter;
@@ -868,7 +992,7 @@ interface ImageServiceRequestOptions {
  * @note It is better to use the hook useRenderingStrategy for rendering.
  */
 declare function useImageService({ cacheKey }?: ImageServiceRequestOptions): {
-    data: ImageService | undefined;
+    data: ImageService$1 | undefined;
     isFetching: boolean;
     status: 'error' | 'success' | 'loading' | 'idle';
 };
@@ -879,7 +1003,7 @@ declare function useImageTile(): {
         id: string | undefined;
         width: number | null | undefined;
         height: number | null | undefined;
-        imageService: ImageService;
+        imageService: ImageService$1;
         thumbnail: undefined;
     } | null;
 };
@@ -1120,4 +1244,4 @@ declare function findAllCanvasesInRange(vault: Vault, range: RangeNormalized): A
 declare function findManifestSelectedRange(vault: Vault, manifest: ManifestNormalized, canvasId: string): null | RangeNormalized;
 declare function findSelectedRange(vault: Vault, range: RangeNormalized, canvasId: string): null | RangeNormalized;
 
-export { AnnotationContext, AnnotationPageContext, AnnotationStyleProvider, type AnnotationStyles, type AnnotationThemeDefinition, Auth, type AuthAccessState, type AuthContextActions, type AuthContextCurrentActions, type AuthContextState, AuthProvider, AuthRContext, AuthReactContext, AuthReactContextActions, type AuthState, CanvasAnnotations, CanvasContext, CollectionContext, CombinedMetadata, ComplexTimelineProvider, ComplexTimelineStrategy, ContextBridge, CreateCustomShape, type CreateCustomShapeProps, EventsProvider, Image, type ImageProps, ImageServiceLoaderContext, ImageServiceLoaderType, type ImageServiceRequestOptions, InnerViewerProvider, LanguageProvider, LanguageString, LocaleString, ManifestContext, ManifestMetadata, type MediaPlayerActions, MediaPlayerProvider, type MediaPlayerState, MediaStrategy, Metadata, type MetadataProps, PolygonSelector, type PolygonSelectorProps, type ProbeStore, RangeContext, ReactEventContext, ReactVaultContext, RenderSvgEditorControls, type ResourceContextType, ResourceProvider, ResourceReactContext, type ResourceRequestOptions, SelectorControllerProvider, type SelectorHelperEventTypes, SequenceThumbnails, SimpleViewerContext, SimpleViewerProps, SimpleViewerProvider, SimpleViewerReactContext, SingleCanvasThumbnail, type SvgTheme, TimelineKeyframe, TranslationProvider, TransliterationProvider, UnknownStrategy, type VaultActivatedAnnotation, VaultProvider, ViewerPresetContext, VirtualAnnotationProvider, VisibleCanvasReactContext, authDetailsForResource, createAuthStateStore, createProbe, defaultEmitter, findAllCanvasesInRange, findFirstCanvasFromRange, findManifestSelectedRange, findSelectedRange, flattenAnnotationPageIds, formatTime, getComplexTimelineStrategy, getDefaultAnnotationStyles, getManifestSequence, getVideoStrategy, getVisibleCanvasesFromCanvasId, hasAuth, makeAccessServiceRequest, makeAccessTokenRequest, svgThemes, useAnnotation, useAnnotationPage, useAnnotationPageManager, useAnnotationStyles, useAnnotationsAtTime, useAuthActions, useAuthService, useAuthStore, useAuthToken, useAuthTokens, useCanvas, useCanvasChoices, useCanvasClock, useCanvasSequence, useCanvasStartTime, useCanvasSubset, useClosestLanguage, useCollection, useComplexTimeline, useContextBridge, useCreateLocaleString, useCurrentAuth, useDispatch, useEventEmitter, useEventListener, useExistingVault, useExternalCollection, useExternalManifest, useExternalResource, useIIIFLanguage, useImage, useImageService, useImageServiceLoader, useImageTile, useIsAuthEnabled, useLocaleString, useManifest, useMediaActions, useMediaElements, useMediaState, usePaintables, usePaintingAnnotations, usePolygonHelper, useRange, useResourceContext, useResourceEvents, useResources, useSearchService, useSelectorController, useSelectorEmitter, useSelectorEvents, useSelectorHelper, useSimpleMediaPlayer, useSimpleViewer, useStyleHelper, useStyles, useSvgEditor, useThumbnail, useTranslations, useTransliteration, useVault, useVaultEffect, useVaultSelector, useViewerPreset, useVirtualAnnotationPage, useVirtualAnnotationPageContext, useVisibleCanvases };
+export { AnnotationContext, AnnotationPageContext, type AnnotationStrategyProps, AnnotationStyleProvider, type AnnotationStyles, type AnnotationThemeDefinition, Auth, type AuthAccessState, type AuthContextActions, type AuthContextCurrentActions, type AuthContextState, AuthProvider, AuthRContext, AuthReactContext, AuthReactContextActions, type AuthState, CanvasAnnotations, CanvasContext, CanvasStrategyProvider, CanvasWorldObject, CollectionContext, CombinedMetadata, ComplexTimelineProvider, ComplexTimelineStrategy, ContextBridge, type ControlsContext, ControlsReactContext, CreateCustomShape, type CreateCustomShapeProps, CustomContextBridge, CustomContextBridgeProvider, EmptyStrategy, EventsProvider, Image, type ImageProps, ImageService, ImageServiceLoaderContext, ImageServiceLoaderType, type ImageServiceRequestOptions, type ImageStrategyProps, ImageWithOptionalService, InnerViewerProvider, LanguageProvider, LanguageString, LocaleString, ManifestContext, ManifestMetadata, type MediaPlayerActions, MediaPlayerProvider, type MediaPlayerState, MediaStrategy, Metadata, type MetadataProps, PolygonSelector, type PolygonSelectorProps, type ProbeStore, RangeContext, ReactEventContext, ReactVaultContext, Render3DModelStrategy, RenderAccompanyingCanvas, RenderAnnotationStrategy, RenderAudioStrategy, RenderComplexTimelineStrategy, RenderEmptyStrategy, RenderImageStrategy, RenderSvgEditorControls, RenderTextualContentStrategy, RenderVideoStrategy, RenderYouTubeStrategy, RenderingStrategy, type ResourceContextType, ResourceProvider, ResourceReactContext, type ResourceRequestOptions, SelectorControllerProvider, type SelectorHelperEventTypes, SequenceThumbnails, SimpleViewerContext, SimpleViewerProps, SimpleViewerProvider, SimpleViewerReactContext, SingleCanvasThumbnail, SingleImageStrategy, StrategyActions, type StrategyContext, StrategyReactContext, type SvgTheme, ThumbnailFallbackImage, TimelineKeyframe, TranslationProvider, TransliterationProvider, UnknownStrategy, type VaultActivatedAnnotation, VaultProvider, ViewerPresetContext, VirtualAnnotationProvider, VisibleCanvasReactContext, authDetailsForResource, createAuthStateStore, createProbe, defaultEmitter, findAllCanvasesInRange, findFirstCanvasFromRange, findManifestSelectedRange, findSelectedRange, flattenAnnotationPageIds, formatTime, getComplexTimelineStrategy, getDefaultAnnotationStyles, getManifestSequence, getVideoStrategy, getVisibleCanvasesFromCanvasId, hasAuth, makeAccessServiceRequest, makeAccessTokenRequest, svgThemes, useAnnotation, useAnnotationPage, useAnnotationPageManager, useAnnotationStyles, useAnnotationsAtTime, useAuthActions, useAuthService, useAuthStore, useAuthToken, useAuthTokens, useCanvas, useCanvasChoices, useCanvasClock, useCanvasSequence, useCanvasStartTime, useCanvasSubset, useClosestLanguage, useCollection, useComplexTimeline, useContextBridge, useCreateLocaleString, useCurrentAuth, useCustomContextBridge, useDispatch, useEventEmitter, useEventListener, useExistingVault, useExternalCollection, useExternalManifest, useExternalResource, useIIIFLanguage, useImage, useImageService, useImageServiceLoader, useImageTile, useIsAuthEnabled, useLocaleString, useManifest, useMediaActions, useMediaElements, useMediaState, usePaintables, usePaintingAnnotations, usePolygonHelper, useRange, useRenderControls, useResourceContext, useResourceEvents, useResources, useSearchService, useSelectorController, useSelectorEmitter, useSelectorEvents, useSelectorHelper, useSimpleMediaPlayer, useSimpleViewer, useStrategy, useStyleHelper, useStyles, useSvgEditor, useThumbnail, useTranslations, useTransliteration, useVault, useVaultEffect, useVaultSelector, useViewerPreset, useVirtualAnnotationPage, useVirtualAnnotationPageContext, useVisibleCanvases };