@edrlab/thorium-web 1.2.0 → 1.3.0

package/dist/useReaderTransitions-JDzlBFsu.d.mts

@@ -0,0 +1,530 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React__default, { RefObject, ReactNode } from 'react';
+import { t as ThActionsTriggerVariant, a as ThSheetHeaderVariant, s as ThCollapsibilityVisibility, h as ThActionEntry, g as ThActionsKeys, T as ThDockingKeys, e as ThSheetTypes } from './actions-BLAr0oaM.mjs';
+import { TooltipProps, Heading, HeadingProps, PopoverProps } from 'react-aria-components';
+import { T as ThActionButtonProps, f as ThMenuItemProps, a as ThCollapsibleActionsBarProps, v as ThSettingsEntry, W as WithRef, t as ThDropdownProps, h as ThNumberFieldProps, k as ThRadioGroupProps, m as ThSliderProps, o as ThSliderWithPresetsProps, q as ThSwitchProps } from './ThSettingsWrapper-BXuRgdqp.mjs';
+import { h as ThTextSettingsKeys, b as ThSpacingSettingsKeys, j as ThSettingsGroupPref, a as ThSpacingPresetKeys, T as ThLineHeightOptions } from './useContrast-2t429O9O.mjs';
+import { PressEvent } from 'react-aria';
+import { A as ActionsStateKeys } from './actionsReducer-BhG1wicI.mjs';
+import { d as ThPreferences, D as DefaultKeys, C as CustomizableKeys, c as ThPreferencesAdapter } from './ThPreferencesAdapter-D0rzsGRl.mjs';
+import * as _readium_navigator from '@readium/navigator';
+import { EpubSettings, WebPubSettings, FXLFrameManager, FrameManager, WebPubFrameManager } from '@readium/navigator';
+import * as _readium_shared from '@readium/shared';
+import { Locator, Link, Publication, Fetcher } from '@readium/shared';
+import { E as EpubNavigatorLoadProps, W as WebPubNavigatorLoadProps, A as AudioNavigatorLoadProps, c as AudioSettings, a as useEpubNavigator, b as useWebPubNavigator, u as useAudioNavigator } from './useAudioNavigator-C5aW4-eT.mjs';
+import { a as ThAudioPreferences, c as ThAudioPreferencesAdapter } from './usePreferences-VaBf46eP.mjs';
+import { InitOptions } from 'i18next';
+import { ReaderProfile } from './lib/index.mjs';
+import { P as ProcessedError } from './errorHandler-CL2YIfQY.mjs';
+
+interface StatefulActionsMapObject {
+    Trigger: React.ComponentType<StatefulActionTriggerProps>;
+    Target?: React.ComponentType<StatefulActionContainerProps>;
+}
+interface StatefulActionTriggerProps {
+    variant: ThActionsTriggerVariant;
+    associatedKey?: ActionsStateKeys;
+    ref?: React.Ref<HTMLButtonElement>;
+}
+interface StatefulActionContainerProps {
+    triggerRef: RefObject<HTMLElement | null>;
+    placement?: "top" | "bottom";
+}
+
+declare const StatefulFullscreenTrigger: ({ variant }: StatefulActionTriggerProps) => react_jsx_runtime.JSX.Element | null;
+
+declare const StatefulJumpToPositionContainer: ({ triggerRef }: StatefulActionContainerProps) => react_jsx_runtime.JSX.Element | null;
+
+declare const StatefulJumpToPositionTrigger: ({ variant }: StatefulActionTriggerProps) => react_jsx_runtime.JSX.Element | null;
+
+interface StatefulSettingsWrapperProps extends StatefulActionContainerProps {
+    heading: string;
+    headerVariant: ThSheetHeaderVariant;
+    onClosePress: () => void;
+    dismissEscapeKeyClose?: boolean;
+    resetFocus?: unknown;
+    onReset?: () => void;
+    children: ReactNode;
+}
+declare const StatefulSettingsWrapper: ({ triggerRef, heading, headerVariant, onClosePress, dismissEscapeKeyClose, resetFocus, onReset, children }: StatefulSettingsWrapperProps) => react_jsx_runtime.JSX.Element;
+
+declare const StatefulAudioSettingsContainer: ({ triggerRef }: StatefulActionContainerProps) => react_jsx_runtime.JSX.Element;
+
+declare const StatefulVisualSettingsContainer: ({ triggerRef }: StatefulActionContainerProps) => react_jsx_runtime.JSX.Element;
+
+declare const StatefulSettingsTrigger: ({ variant }: StatefulActionTriggerProps) => react_jsx_runtime.JSX.Element;
+
+declare const StatefulTocContainer: ({ triggerRef }: StatefulActionContainerProps) => react_jsx_runtime.JSX.Element;
+
+declare const StatefulTocTrigger: ({ variant }: StatefulActionTriggerProps) => react_jsx_runtime.JSX.Element;
+
+interface StatefulActionIconProps extends ThActionButtonProps {
+    visibility?: ThCollapsibilityVisibility;
+    placement?: TooltipProps["placement"];
+    tooltipLabel?: string;
+}
+declare const StatefulActionIcon: ({ ref: externalRef, visibility, placement, tooltipLabel, children, ...props }: StatefulActionIconProps) => react_jsx_runtime.JSX.Element;
+
+interface StatefulOverflowMenuItemProps extends Omit<ThMenuItemProps, "shortcut"> {
+    shortcut?: string | null;
+}
+declare const StatefulOverflowMenuItem: ({ id, label, SVGIcon, shortcut, ...props }: StatefulOverflowMenuItemProps) => react_jsx_runtime.JSX.Element;
+
+interface StatefulCollapsibleActionsBarProps extends ThCollapsibleActionsBarProps {
+    items: ThActionEntry<string | ThActionsKeys | ThDockingKeys>[];
+    overflowMenuClassName?: string;
+}
+declare const StatefulCollapsibleActionsBar: ({ id, items, overflowMenuClassName, ...props }: StatefulCollapsibleActionsBarProps) => react_jsx_runtime.JSX.Element;
+
+interface StatefulOverflowMenuProps {
+    id: string;
+    items: ThActionEntry<string | ThActionsKeys | ThDockingKeys>[];
+    triggerRef: RefObject<HTMLElement | null>;
+    className?: string;
+    children?: ReactNode;
+}
+declare const StatefulOverflowMenu: ({ id, className, items, triggerRef }: StatefulOverflowMenuProps) => react_jsx_runtime.JSX.Element | undefined;
+
+declare const useDocking: <T extends string>(key: T) => {
+    getDocker: () => ThDockingKeys[];
+    sheetType: ThSheetTypes;
+};
+
+type ActionComponent = StatefulActionsMapObject;
+interface SettingComponent extends ThSettingsEntry {
+    type?: "text" | "spacing";
+    props?: any;
+}
+interface ThPlugin {
+    id: string;
+    name: string;
+    description?: string;
+    version?: string;
+    components: {
+        actions?: Record<string, ActionComponent>;
+        settings?: Record<string, SettingComponent>;
+        primaryAudioActions?: Record<string, ActionComponent>;
+    };
+}
+
+declare const createDefaultPlugin: () => ThPlugin;
+
+declare const createAudioDefaultPlugin: () => ThPlugin;
+
+interface StatefulGroupWrapperProps<T extends string = ThTextSettingsKeys | ThSpacingSettingsKeys> {
+    label: string;
+    moreLabel: string;
+    moreTooltip: string;
+    onPressMore: (e: PressEvent) => void;
+    componentsMap: Record<string, SettingComponent>;
+    prefs?: ThSettingsGroupPref<T>;
+    defaultPrefs: {
+        main: T[];
+        subPanel: T[];
+    };
+    isDisabled?: boolean;
+    compounds?: {
+        /**
+         * Custom heading. Can be either:
+         * - A React element that will be rendered directly
+         * - Props that will be spread onto the default Heading component
+         */
+        heading?: React.ReactElement<typeof Heading> | WithRef<HeadingProps, HTMLHeadingElement>;
+    };
+}
+declare const StatefulGroupWrapper: <T extends string = ThTextSettingsKeys | ThSpacingSettingsKeys>({ label, moreLabel, moreTooltip, onPressMore, componentsMap, prefs, defaultPrefs, isDisabled, compounds }: StatefulGroupWrapperProps<T>) => react_jsx_runtime.JSX.Element;
+
+interface StatefulDropdownProps extends Omit<ThDropdownProps, "classNames"> {
+    standalone?: boolean;
+}
+declare const StatefulDropdown: ({ standalone, label, className, compounds, ...props }: StatefulDropdownProps) => react_jsx_runtime.JSX.Element;
+
+interface StatefulNumberFieldProps extends Omit<ThNumberFieldProps, "classNames"> {
+    standalone?: boolean;
+    resetLabel?: string;
+    placeholder?: string;
+}
+declare const StatefulNumberField: ({ standalone, label, placeholder, value, resetLabel, ...props }: StatefulNumberFieldProps) => react_jsx_runtime.JSX.Element;
+
+interface StatefulRadioGroupProps extends Omit<ThRadioGroupProps, "classNames"> {
+    standalone?: boolean;
+    useGraphicalNavigation?: boolean;
+    onEscape?: () => void;
+}
+declare const StatefulRadioGroup: ({ ref, standalone, useGraphicalNavigation, label, items, value, children, onChange, onEscape, ...props }: StatefulRadioGroupProps) => react_jsx_runtime.JSX.Element;
+
+interface StatefulSliderProps extends Omit<ThSliderProps, "classNames"> {
+    standalone?: boolean;
+    placeholder?: string;
+    resetLabel?: string;
+    displayTicks?: boolean;
+}
+declare const StatefulSlider: ({ standalone, label, placeholder, displayTicks, value, resetLabel, ...props }: StatefulSliderProps) => react_jsx_runtime.JSX.Element;
+
+interface StatefulSliderWithPresetsProps extends Omit<ThSliderWithPresetsProps, "compounds"> {
+    standalone?: boolean;
+    placeholder?: string;
+    resetLabel?: string;
+    displayTicks?: boolean;
+    hideOutput?: boolean;
+    onEscape?: () => void;
+}
+declare const StatefulSliderWithPresets: ({ standalone, label, placeholder, displayTicks, hideOutput, value, resetLabel, presets, formatValue, onEscape, ...props }: StatefulSliderWithPresetsProps) => react_jsx_runtime.JSX.Element;
+
+interface StatefulSwitchProps extends Omit<ThSwitchProps, "classNames"> {
+    standalone?: boolean;
+}
+declare const StatefulSwitch: ({ standalone, label, heading, ...props }: StatefulSwitchProps) => react_jsx_runtime.JSX.Element;
+
+interface EffectiveRangeResult {
+    range: [number, number];
+    presets?: number[];
+}
+/**
+ * Returns the effective range and presets to use for a range setting, clamped
+ * to the navigator's supported range when provided. Falls back to the preferred
+ * range if it fits within the supported range, otherwise uses the supported
+ * range directly. Presets outside the effective range are filtered out.
+ */
+declare const useEffectiveRange: (preferred: [number, number], supportedRange: [number, number] | undefined, presets?: number[]) => EffectiveRangeResult;
+
+interface useGridNavigationProps {
+    containerRef: React__default.RefObject<HTMLDivElement | null>;
+    items: React__default.RefObject<any[]>;
+    currentValue: any;
+    onChange: (value: any) => void;
+    isRTL?: boolean;
+    onEscape?: () => void;
+    onFocus?: (value: string) => void;
+}
+declare const useGridNavigation: ({ containerRef, items, currentValue, onChange, isRTL, onEscape, onFocus }: useGridNavigationProps) => {
+    onKeyDown: (e: React__default.KeyboardEvent) => void;
+};
+
+declare const useGridTemplate: (ref: React.RefObject<HTMLDivElement | null>, type?: "columns" | "rows") => number | null;
+
+interface StatefulSettingsItemProps {
+    standalone?: boolean;
+}
+
+declare const StatefulLetterSpacing: ({ standalone }: StatefulSettingsItemProps) => react_jsx_runtime.JSX.Element;
+
+declare const StatefulLineHeight: ({ standalone }: StatefulSettingsItemProps) => react_jsx_runtime.JSX.Element;
+
+declare const StatefulParagraphIndent: ({ standalone }: StatefulSettingsItemProps) => react_jsx_runtime.JSX.Element;
+
+declare const StatefulParagraphSpacing: ({ standalone }: StatefulSettingsItemProps) => react_jsx_runtime.JSX.Element;
+
+declare const StatefulSpacingGroup: () => react_jsx_runtime.JSX.Element;
+declare const StatefulSpacingGroupContainer: () => react_jsx_runtime.JSX.Element;
+
+declare const StatefulSpacingPresets: ({ standalone }: StatefulSettingsItemProps) => react_jsx_runtime.JSX.Element | null;
+
+declare const StatefulWordSpacing: ({ standalone }: StatefulSettingsItemProps) => react_jsx_runtime.JSX.Element;
+
+/**
+ * Hook that returns a mapping of line height options to their actual numeric values
+ * This eliminates code duplication across spacing components
+ */
+declare const useLineHeight: () => {
+    publisher: null;
+    small: any;
+    medium: any;
+    large: any;
+};
+
+/**
+ * Hook to determine if preset system should be active
+ * Only active when component is both registered AND displayed
+ * This allows us to correctly handle overrides for presets,
+ * and states for spacing components
+ */
+declare const useSpacingPresets: () => {
+    currentPreset: ThSpacingPresetKeys;
+    getPresetValues: (presetKey: ThSpacingPresetKeys) => {
+        letterSpacing: any;
+        lineHeight: any;
+        paragraphIndent: any;
+        paragraphSpacing: any;
+        wordSpacing: any;
+    };
+    getEffectiveSpacingValue: {
+        (key: ThSpacingSettingsKeys.letterSpacing): number | null;
+        (key: ThSpacingSettingsKeys.lineHeight): ThLineHeightOptions | null;
+        (key: ThSpacingSettingsKeys.paragraphIndent): number | null;
+        (key: ThSpacingSettingsKeys.paragraphSpacing): number | null;
+        (key: ThSpacingSettingsKeys.wordSpacing): number | null;
+    };
+    getSpacingResetValue: {
+        (key: ThSpacingSettingsKeys.letterSpacing): number | null;
+        (key: ThSpacingSettingsKeys.lineHeight): ThLineHeightOptions | null;
+        (key: ThSpacingSettingsKeys.paragraphIndent): number | null;
+        (key: ThSpacingSettingsKeys.paragraphSpacing): number | null;
+        (key: ThSpacingSettingsKeys.wordSpacing): number | null;
+    };
+    canBeReset: (key: ThSpacingSettingsKeys) => boolean;
+    setLetterSpacing: (value: number | null) => void;
+    setLineHeight: (value: ThLineHeightOptions) => void;
+    setParagraphIndent: (value: number | null) => void;
+    setParagraphSpacing: (value: number | null) => void;
+    setWordSpacing: (value: number | null) => void;
+    setPublisherStyles: (value: boolean) => void;
+};
+
+declare const StatefulFontFamily: ({ standalone }: StatefulSettingsItemProps & {
+    publicationLanguage?: string;
+}) => react_jsx_runtime.JSX.Element;
+
+declare const UnstableStatefulFontWeight: ({ standalone }: StatefulSettingsItemProps) => react_jsx_runtime.JSX.Element;
+
+declare const StatefulHyphens: ({ standalone }: StatefulSettingsItemProps) => react_jsx_runtime.JSX.Element;
+
+declare const StatefulTextAlign: ({ standalone }: StatefulSettingsItemProps) => react_jsx_runtime.JSX.Element;
+
+declare const StatefulTextGroup: () => react_jsx_runtime.JSX.Element;
+declare const StatefulTextGroupContainer: () => react_jsx_runtime.JSX.Element;
+
+declare const StatefulTextNormalize: ({ standalone }: StatefulSettingsItemProps) => react_jsx_runtime.JSX.Element;
+
+declare const StatefulPublisherStyles: ({ standalone }: StatefulSettingsItemProps) => react_jsx_runtime.JSX.Element;
+
+declare const StatefulTheme: () => react_jsx_runtime.JSX.Element;
+
+declare const StatefulZoom: () => react_jsx_runtime.JSX.Element;
+
+interface StatefulSheet {
+    id: ActionsStateKeys;
+    triggerRef: RefObject<HTMLElement | null>;
+    heading: string;
+    headerVariant?: ThSheetHeaderVariant;
+    className?: string;
+    underlayClassName?: string;
+    headerClassName?: string;
+    isOpen: boolean;
+    onOpenChange: (isOpen: boolean) => void;
+    onClosePress: () => void;
+    docker?: ThDockingKeys[];
+    children?: ReactNode;
+    resetFocus?: unknown;
+    focusWithinRef?: RefObject<HTMLElement | null>;
+    focusSelector?: string;
+    scrollTopOnFocus?: boolean;
+    dismissEscapeKeyClose?: boolean;
+}
+
+interface StatefulBottomSheetProps extends StatefulSheet {
+}
+interface ScrimPref {
+    active: boolean;
+    override?: string;
+}
+declare const StatefulBottomSheet: ({ id, heading, headerVariant, className, isOpen, onOpenChange, onClosePress, children, resetFocus, focusWithinRef, focusSelector, scrollTopOnFocus, dismissEscapeKeyClose }: StatefulBottomSheetProps) => react_jsx_runtime.JSX.Element | undefined;
+
+interface StatefulCompactPopoverSheetProps extends StatefulSheet {
+    placement?: PopoverProps["placement"];
+}
+declare const StatefulCompactPopoverSheet: ({ id, triggerRef, heading, className, isOpen, onOpenChange, placement, children, resetFocus, focusWithinRef, focusSelector, scrollTopOnFocus, dismissEscapeKeyClose }: StatefulCompactPopoverSheetProps) => react_jsx_runtime.JSX.Element | undefined;
+
+interface StatefulDockedSheetProps extends StatefulSheet {
+    flow: ThDockingKeys.start | ThDockingKeys.end | null;
+}
+declare const StatefulDockedSheet: ({ id, heading, headerVariant, className, isOpen, onClosePress, docker, flow, children, resetFocus, focusSelector, focusWithinRef, scrollTopOnFocus }: StatefulDockedSheetProps) => react_jsx_runtime.JSX.Element | undefined;
+
+interface StatefulFullScreenSheetProps extends StatefulSheet {
+}
+declare const StatefulFullScreenSheet: (props: StatefulFullScreenSheetProps) => react_jsx_runtime.JSX.Element;
+
+interface StatefulModalSheetProps extends StatefulSheet {
+}
+declare const StatefulModalSheet: (props: StatefulModalSheetProps) => react_jsx_runtime.JSX.Element;
+
+interface StatefulPopoverSheetProps extends StatefulSheet {
+    placement?: PopoverProps["placement"];
+}
+declare const StatefulPopoverSheet: ({ id, triggerRef, heading, headerVariant, className, headerClassName, isOpen, onOpenChange, onClosePress, placement, docker, children, resetFocus, focusWithinRef, focusSelector, scrollTopOnFocus, dismissEscapeKeyClose }: StatefulPopoverSheetProps) => react_jsx_runtime.JSX.Element | undefined;
+
+interface StatefulModalBaseProps extends StatefulSheet {
+    sheetClassName: string;
+    dialogClassName?: string;
+}
+declare const StatefulModalBase: ({ id, heading, headerVariant, className, sheetClassName, dialogClassName, isOpen, onOpenChange, onClosePress, docker, children, resetFocus, focusWithinRef, focusSelector, scrollTopOnFocus, dismissEscapeKeyClose }: StatefulModalBaseProps) => react_jsx_runtime.JSX.Element | undefined;
+
+declare const StatefulSheetWrapper: ({ sheetType, sheetProps, children }: {
+    sheetType: ThSheetTypes;
+    sheetProps: StatefulPopoverSheetProps | StatefulModalSheetProps | StatefulFullScreenSheetProps | StatefulDockedSheetProps | StatefulBottomSheetProps;
+    children: ReactNode;
+}) => react_jsx_runtime.JSX.Element;
+
+declare const StatefulPreferencesProvider: ({ children, initialPreferences }: {
+    children: ReactNode;
+    initialPreferences?: ThPreferences<DefaultKeys>;
+}) => react_jsx_runtime.JSX.Element;
+
+type VisualNavigator = ReturnType<typeof useEpubNavigator> | ReturnType<typeof useWebPubNavigator>;
+type MediaNavigator = ReturnType<typeof useAudioNavigator>;
+type AllVisualSettings = EpubSettings & WebPubSettings;
+type NavigationCallback = (ok: boolean) => void;
+interface UnifiedNavigator {
+    go(locator: Locator, animated: boolean, callback: NavigationCallback): void;
+    goLink(link: Link, animated: boolean, callback: NavigationCallback): void;
+    currentLocator(): Locator | undefined;
+    previousLocator(): Locator | null;
+    nextLocator(): Locator | null;
+    goForward(animated: boolean, callback: NavigationCallback): void;
+    goBackward(animated: boolean, callback: NavigationCallback): void;
+    isVisual(): boolean;
+    getCframes?(): (FXLFrameManager | FrameManager | WebPubFrameManager | undefined)[] | undefined;
+    underlying: VisualNavigator | MediaNavigator;
+}
+declare const useNavigator: () => {
+    readonly visual: {
+        getSetting: <K extends keyof AllVisualSettings>(settingKey: K) => AllVisualSettings[K];
+        EpubNavigatorLoad: (config: EpubNavigatorLoadProps, cb: Function, fxlCallback?: (locator: Locator) => void) => void;
+        EpubNavigatorDestroy: (cb: Function) => void;
+        goRight: (animated: boolean, callback: (ok: boolean) => void) => void;
+        goLeft: (animated: boolean, callback: (ok: boolean) => void) => void;
+        goBackward: (animated: boolean, callback: (ok: boolean) => void) => void;
+        goForward: (animated: boolean, callback: (ok: boolean) => void) => void;
+        goLink: (link: Link, animated: boolean, callback: (ok: boolean) => void) => void;
+        go: (locator: Locator, animated: boolean, callback: (ok: boolean) => void) => void;
+        navLayout: () => _readium_shared.Layout | undefined;
+        currentLocator: () => Locator | undefined;
+        previousLocator: () => Locator | null | undefined;
+        nextLocator: () => Locator | null | undefined;
+        currentPositions: () => number[] | null | undefined;
+        canGoBackward: () => boolean | undefined;
+        canGoForward: () => boolean | undefined;
+        isScrollStart: () => boolean | undefined;
+        isScrollEnd: () => boolean | undefined;
+        preferencesEditor: _readium_navigator.EpubPreferencesEditor | undefined;
+        submitPreferences: (preferences: _readium_navigator.IEpubPreferences) => Promise<void>;
+        getCframes: () => (FXLFrameManager | FrameManager | undefined)[] | undefined;
+        onFXLPositionChange: (cb: (locator: Locator) => void) => void;
+    } | {
+        getSetting: <K extends keyof AllVisualSettings>(settingKey: K) => AllVisualSettings[K];
+        WebPubNavigatorLoad: (config: WebPubNavigatorLoadProps, cb: Function) => void;
+        WebPubNavigatorDestroy: (cb: Function) => void;
+        goRight: (animated: boolean, callback: (ok: boolean) => void) => void;
+        goLeft: (animated: boolean, callback: (ok: boolean) => void) => void;
+        goBackward: (animated: boolean, callback: (ok: boolean) => void) => void;
+        goForward: (animated: boolean, callback: (ok: boolean) => void) => void;
+        goLink: (link: Link, animated: boolean, callback: (ok: boolean) => void) => void;
+        go: (locator: Locator, animated: boolean, callback: (ok: boolean) => void) => void;
+        currentLocator: () => Locator | undefined;
+        previousLocator: () => Locator | null | undefined;
+        nextLocator: () => Locator | null | undefined;
+        currentPositions: () => number[] | null | undefined;
+        canGoBackward: () => boolean | undefined;
+        canGoForward: () => boolean | undefined;
+        isScrollStart: () => boolean | undefined;
+        isScrollEnd: () => boolean | undefined;
+        preferencesEditor: _readium_navigator.WebPubPreferencesEditor | undefined;
+        submitPreferences: (preferences: _readium_navigator.IWebPubPreferences) => Promise<void>;
+        getCframes: () => (WebPubFrameManager | undefined)[] | undefined;
+    };
+    readonly media: {
+        AudioNavigatorLoad: (config: AudioNavigatorLoadProps, cb: Function) => void;
+        AudioNavigatorDestroy: (cb: Function) => void;
+        play: () => void;
+        pause: () => void;
+        stop: () => void;
+        seek: (time: number) => void;
+        jump: (seconds: number) => void;
+        skipForward: () => void;
+        skipBackward: () => void;
+        go: (locator: Locator, animated: boolean, callback: (ok: boolean) => void) => void;
+        goLink: (link: Link, animated: boolean, callback: (ok: boolean) => void) => void;
+        goForward: (animated: boolean, callback: (ok: boolean) => void) => void;
+        goBackward: (animated: boolean, callback: (ok: boolean) => void) => void;
+        currentLocator: () => Locator | undefined;
+        canGoBackward: () => boolean;
+        canGoForward: () => boolean;
+        isTrackStart: () => boolean;
+        isTrackEnd: () => boolean;
+        isPlaying: () => boolean;
+        isPaused: () => boolean;
+        duration: () => number;
+        currentTime: () => number;
+        preferencesEditor: _readium_navigator.AudioPreferencesEditor | undefined;
+        remotePlayback: RemotePlayback | undefined;
+        getSetting: <K extends keyof AudioSettings>(settingKey: K) => number | boolean | undefined;
+        submitPreferences: (preferences: _readium_navigator.IAudioPreferences) => Promise<void>;
+        timeline: () => _readium_shared.Timeline | undefined;
+    };
+    readonly unified: UnifiedNavigator;
+};
+
+interface PositionStorage {
+    get: () => Locator | undefined;
+    set: (locator: Locator) => void | Promise<void>;
+}
+interface StatefulReaderProps {
+    publication: Publication;
+    localDataKey: string | null;
+    plugins?: ThPlugin[];
+    positionStorage?: PositionStorage;
+}
+type ThPluginFactory = () => ThPlugin[] | Promise<ThPlugin[]>;
+interface ReaderPlugins {
+    epub?: ThPluginFactory;
+    webPub?: ThPluginFactory;
+    audio?: ThPluginFactory;
+}
+interface ReaderComponentProps<P extends "epub" | "webPub" | "audio" | undefined | null = undefined, K extends CustomizableKeys = {}> {
+    profile: P;
+    publication: Publication;
+    localDataKey: string | null;
+    isLoading?: boolean;
+    positionStorage?: PositionStorage;
+    plugins?: ReaderPlugins;
+    i18n?: Partial<InitOptions>;
+    preferences?: P extends "audio" ? {
+        initialPreferences?: ThAudioPreferences<K>;
+        adapter?: ThAudioPreferencesAdapter<K>;
+    } : P extends "epub" | "webPub" ? {
+        initialPreferences?: ThPreferences<K>;
+        adapter?: ThPreferencesAdapter<K>;
+    } : never;
+}
+declare const StatefulReaderWrapper: ({ profile, plugins, isLoading, preferences, i18n: i18nOptions, ...props }: ReaderComponentProps<any, any>) => react_jsx_runtime.JSX.Element | null;
+
+interface UsePublicationOptions {
+    url: string;
+    onError?: (error: ProcessedError) => void;
+    fetcher?: Fetcher;
+}
+interface UsePublicationReturn {
+    isLoading: boolean;
+    error: ProcessedError | null;
+    publication: Publication | null;
+    manifest: object | null;
+    selfLink: string | null;
+    localDataKey: string | null;
+    profile: ReaderProfile | null;
+    isRTL: boolean;
+    isFXL: boolean;
+    hasDisplayTransformability: boolean;
+}
+declare const usePublication: ({ url, onError, fetcher: customFetcher }: UsePublicationOptions) => UsePublicationReturn;
+
+interface ReaderTransitions {
+    isImmersive: boolean;
+    isFullscreen: boolean;
+    isScroll: boolean;
+    hasUserNavigated: boolean;
+    wasImmersive: boolean;
+    wasFullscreen: boolean;
+    wasScroll: boolean;
+    wasUserNavigated: boolean;
+    fromImmersive: boolean;
+    toImmersive: boolean;
+    fromFullscreen: boolean;
+    toFullscreen: boolean;
+    fromScroll: boolean;
+    toScroll: boolean;
+    fromUserNavigation: boolean;
+    toUserNavigation: boolean;
+}
+declare const useReaderTransitions: () => ReaderTransitions;
+
+export { StatefulWordSpacing as $, StatefulGroupWrapper as A, type StatefulDropdownProps as B, StatefulDropdown as C, type StatefulNumberFieldProps as D, StatefulNumberField as E, type StatefulRadioGroupProps as F, StatefulRadioGroup as G, type StatefulSliderProps as H, StatefulSlider as I, type StatefulSliderWithPresetsProps as J, StatefulSliderWithPresets as K, type StatefulSwitchProps as L, StatefulSwitch as M, useEffectiveRange as N, type useGridNavigationProps as O, useGridNavigation as P, useGridTemplate as Q, type StatefulSettingsItemProps as R, type StatefulActionsMapObject as S, type ThPlugin as T, StatefulLetterSpacing as U, StatefulLineHeight as V, StatefulParagraphIndent as W, StatefulParagraphSpacing as X, StatefulSpacingGroup as Y, StatefulSpacingGroupContainer as Z, StatefulSpacingPresets as _, usePublication as a, useLineHeight as a0, useSpacingPresets as a1, StatefulFontFamily as a2, UnstableStatefulFontWeight as a3, StatefulHyphens as a4, StatefulTextAlign as a5, StatefulTextGroup as a6, StatefulTextGroupContainer as a7, StatefulTextNormalize as a8, StatefulPublisherStyles as a9, StatefulTheme as aa, StatefulZoom as ab, type StatefulBottomSheetProps as ac, type ScrimPref as ad, StatefulBottomSheet as ae, type StatefulCompactPopoverSheetProps as af, StatefulCompactPopoverSheet as ag, type StatefulDockedSheetProps as ah, StatefulDockedSheet as ai, type StatefulFullScreenSheetProps as aj, StatefulFullScreenSheet as ak, type StatefulModalSheetProps as al, StatefulModalSheet as am, type StatefulPopoverSheetProps as an, StatefulPopoverSheet as ao, type StatefulModalBaseProps as ap, StatefulModalBase as aq, StatefulSheetWrapper as ar, type StatefulSheet as as, StatefulPreferencesProvider as at, type PositionStorage as au, type StatefulReaderProps as av, type ThPluginFactory as aw, type ReaderPlugins as ax, type ReaderComponentProps as ay, StatefulReaderWrapper as az, useReaderTransitions as b, type StatefulActionTriggerProps as c, type StatefulActionContainerProps as d, StatefulFullscreenTrigger as e, StatefulJumpToPositionContainer as f, StatefulJumpToPositionTrigger as g, StatefulSettingsWrapper as h, StatefulAudioSettingsContainer as i, StatefulVisualSettingsContainer as j, StatefulSettingsTrigger as k, StatefulTocContainer as l, StatefulTocTrigger as m, type StatefulActionIconProps as n, StatefulActionIcon as o, type StatefulOverflowMenuItemProps as p, StatefulOverflowMenuItem as q, type StatefulCollapsibleActionsBarProps as r, StatefulCollapsibleActionsBar as s, type StatefulOverflowMenuProps as t, useNavigator as u, StatefulOverflowMenu as v, useDocking as w, createDefaultPlugin as x, createAudioDefaultPlugin as y, type StatefulGroupWrapperProps as z };

package/dist/{useTimeline-DyMx_aWY.d.mts → useTimeline-DCZ1qoCO.d.mts}

@@ -7,6 +7,8 @@ interface TocItem {
     children?: TocItem[];
     position?: number;
 }
+type TocEntryRef = Omit<TocItem, "children">;
+
 interface TimelineItem {
     href: string;
     readingOrderIndex?: number;
@@ -34,7 +36,7 @@ interface UnstableTimeline {
     };
     toc?: {
         tree?: TocItem[];
-        currentEntry?: string | null;
+        currentEntry?: TocEntryRef | null;
     };
     currentItem?: TimelineItem | null;
     previousItem?: TimelineItem | null;
@@ -50,4 +52,4 @@ declare const useTimeline: ({ publication, currentLocation, currentPositions, po
     onChange?: (timeline: UnstableTimeline) => void;
 }) => UnstableTimeline;
 
-export { type TocItem as T, type UnstableTimeline as U, type TimelineItem as a, type TimelineProgression as b, timelineInstance as t, useTimeline as u };
+export { type TimelineItem as T, type UnstableTimeline as U, type TimelineProgression as a, type TocItem as b, type TocEntryRef as c, timelineInstance as t, useTimeline as u };

package/package.json

@@ -20,7 +20,7 @@
   "bugs": {
     "url": "https://github.com/edrlab/thorium-web/issues"
   },
-  "version": "1.2.0",
+  "version": "1.3.0",
   "private": false,
   "files": [
     "./dist"
@@ -32,9 +32,11 @@
     "./core/components": "./dist/core/Components/index.mjs",
     "./core/helpers": "./dist/core/Helpers/index.mjs",
     "./core/hooks": "./dist/core/Hooks/index.mjs",
-    "./core/i18n": "./dist/core/i18n/index.mjs",
+    "./core/i18n": "./dist/i18n/index.mjs",
     "./core/lib": "./dist/lib/index.mjs",
     "./core/preferences": "./dist/preferences/index.mjs",
+    "./audio": "./dist/components/Audio/index.mjs",
+    "./audio/styles": "./dist/components/Audio/index.css",
     "./epub": "./dist/components/Epub/index.mjs",
     "./epub/styles": "./dist/components/Epub/index.css",
     "./misc": "./dist/components/Misc/index.mjs",
@@ -58,13 +60,14 @@
     "extract-locales": "node scripts/extract-locales.mjs",
     "check-locales": "node scripts/check-locales.mjs",
     "update-locales": "pnpm remove @edrlab/thorium-locales && pnpm add @edrlab/thorium-locales@github:edrlab/thorium-locales && pnpm extract-locales && pnpm check-locales --summary --show-missing",
-    "bundle": "pnpm extract-locales && tsup --config tsup.config.ts && pnpm copy-locales && pnpm copy-fonts"
+    "bundle": "pnpm extract-locales && tsup --config tsup.config.ts && pnpm copy-locales && pnpm copy-fonts",
+    "increment": "node scripts/increment.mjs"
   },
   "peerDependencies": {
-    "@readium/css": "^2.0.0",
-    "@readium/navigator": "2.3.1",
-    "@readium/navigator-html-injectables": "2.3.0",
-    "@readium/shared": "2.1.5",
+    "@readium/css": "^2.0.1",
+    "@readium/navigator": "2.4.0",
+    "@readium/navigator-html-injectables": "2.3.1",
+    "@readium/shared": "2.2.0",
     "@reduxjs/toolkit": "^2.11.2",
     "i18next": "^25.8.13",
     "i18next-browser-languagedetector": "^8.2.1",
@@ -82,12 +85,13 @@
   },
   "dependencies": {
     "@edrlab/thorium-locales": "github:edrlab/thorium-locales",
-    "@readium/css": "^2.0.0",
-    "@readium/navigator": "2.3.1",
-    "@readium/navigator-html-injectables": "2.3.0",
-    "@readium/shared": "2.1.5",
+    "@readium/css": "^2.0.1",
+    "@readium/navigator": "2.4.0",
+    "@readium/navigator-html-injectables": "2.3.1",
+    "@readium/shared": "2.2.0",
     "@reduxjs/toolkit": "^2.11.2",
     "classnames": "^2.5.1",
+    "colorthief": "^3.3.1",
     "debounce": "^3.0.0",
     "i18next": "^25.8.13",
     "i18next-browser-languagedetector": "^8.2.1",