@eternalheart/react-file-preview 1.3.13 → 1.4.0

package/lib/hooks/useBookRenderer.d.ts

@@ -0,0 +1,14 @@
+export interface UseBookRendererReturn<T> {
+    ref: React.RefObject<T | null>;
+    current: number;
+    total: number;
+    fullWidth: boolean;
+    setFullWidth: React.Dispatch<React.SetStateAction<boolean>>;
+    handleChapterChange: (current: number, total: number) => void;
+}
+/**
+ * 书籍渲染器（EPUB/Mobi）通用逻辑 hook
+ * 统一 ref、状态管理和章节变化回调
+ */
+export declare function useBookRenderer<T>(onChapterChange?: (current: number, total: number) => void): UseBookRendererReturn<T>;
+//# sourceMappingURL=useBookRenderer.d.ts.map

package/lib/hooks/useBookRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBookRenderer.d.ts","sourceRoot":"","sources":["../../src/hooks/useBookRenderer.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5D,mBAAmB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GACzD,qBAAqB,CAAC,CAAC,CAAC,CAuB1B"}

package/lib/hooks/useFilePreviewState.d.ts

@@ -0,0 +1,10 @@
+import type { RendererState, RendererAction } from './types';
+/**
+ * 文件预览状态管理 hook
+ * 自动在 currentIndex 改变时重置所有状态
+ */
+export declare function useFilePreviewState(currentIndex: number): {
+    state: RendererState;
+    dispatch: React.Dispatch<RendererAction>;
+};
+//# sourceMappingURL=useFilePreviewState.d.ts.map

package/lib/hooks/useFilePreviewState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFilePreviewState.d.ts","sourceRoot":"","sources":["../../src/hooks/useFilePreviewState.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE7D;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG;IACzD,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;CAC1C,CAQA"}

package/lib/hooks/useImageAutoFit.d.ts

@@ -0,0 +1,13 @@
+export interface UseImageAutoFitParams {
+    enabled: boolean;
+    naturalWidth: number;
+    naturalHeight: number;
+    containerRef: React.RefObject<HTMLDivElement | null>;
+    onZoomChange: (zoom: number) => void;
+}
+/**
+ * 图片自动适应窗口 hook
+ * 当图片加载完成后，自动计算适应窗口的缩放比例
+ */
+export declare function useImageAutoFit({ enabled, naturalWidth, naturalHeight, containerRef, onZoomChange, }: UseImageAutoFitParams): void;
+//# sourceMappingURL=useImageAutoFit.d.ts.map

package/lib/hooks/useImageAutoFit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useImageAutoFit.d.ts","sourceRoot":"","sources":["../../src/hooks/useImageAutoFit.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACrD,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,EAC9B,OAAO,EACP,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,YAAY,GACb,EAAE,qBAAqB,GAAG,IAAI,CAa9B"}

package/lib/hooks/useKeyboardNavigation.d.ts

@@ -0,0 +1,15 @@
+export interface UseKeyboardNavigationParams {
+    mode: 'modal' | 'embed';
+    currentIndex: number;
+    totalFiles: number;
+    onNavigate?: (index: number) => void;
+    onClose?: () => void;
+    rootRef?: React.RefObject<HTMLDivElement | null>;
+}
+/**
+ * 键盘导航 hook
+ * - modal 模式：监听 window 的 keydown 事件
+ * - embed 模式：仅监听根容器的 keydown 事件（需要容器获得焦点）
+ */
+export declare function useKeyboardNavigation({ mode, currentIndex, totalFiles, onNavigate, onClose, rootRef, }: UseKeyboardNavigationParams): void;
+//# sourceMappingURL=useKeyboardNavigation.d.ts.map

package/lib/hooks/useKeyboardNavigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeyboardNavigation.d.ts","sourceRoot":"","sources":["../../src/hooks/useKeyboardNavigation.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;CAClD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,IAAI,EACJ,YAAY,EACZ,UAAU,EACV,UAAU,EACV,OAAO,EACP,OAAO,GACR,EAAE,2BAA2B,GAAG,IAAI,CA8BpC"}

package/lib/hooks/useThemeMode.d.ts

@@ -0,0 +1,7 @@
+import type { Theme } from '@eternalheart/file-preview-core';
+/**
+ * 主题模式 hook
+ * 处理 auto 主题时的系统偏好监听
+ */
+export declare function useThemeMode(theme: Theme): 'light' | 'dark';
+//# sourceMappingURL=useThemeMode.d.ts.map

package/lib/hooks/useThemeMode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useThemeMode.d.ts","sourceRoot":"","sources":["../../src/hooks/useThemeMode.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAE7D;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,CAiB3D"}

package/lib/hooks/useToolbarConfig.d.ts

@@ -0,0 +1,25 @@
+import type { ToolbarGroup } from '../renderers/toolbar.types';
+import type { Translator } from '@eternalheart/file-preview-core';
+import type { CustomRenderer, CustomRendererContext, PreviewFile } from '../types';
+import type { RendererState } from './types';
+import { type ToolbarFactoryContext } from '../toolbar/registry';
+/**
+ * useToolbarConfig 所需的 handlers（不含 state/t/fileName，由 hook 内部合并）
+ */
+export type ToolbarConfigHandlers = Omit<ToolbarFactoryContext, 'state' | 't' | 'fileName'>;
+export interface UseToolbarConfigParams {
+    fileType: string;
+    fileName: string;
+    state: RendererState;
+    handlers: ToolbarConfigHandlers;
+    t: Translator;
+    customRenderer?: CustomRenderer | null;
+    currentFile: PreviewFile;
+    customRendererContext: CustomRendererContext;
+}
+/**
+ * 工具栏配置 hook
+ * 根据文件类型和自定义渲染器返回工具栏配置
+ */
+export declare function useToolbarConfig({ fileType, fileName, state, handlers, t, customRenderer, currentFile, customRendererContext, }: UseToolbarConfigParams): ToolbarGroup[];
+//# sourceMappingURL=useToolbarConfig.d.ts.map

package/lib/hooks/useToolbarConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useToolbarConfig.d.ts","sourceRoot":"","sources":["../../src/hooks/useToolbarConfig.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACnF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAoB,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEnF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,qBAAqB,EAAE,OAAO,GAAG,GAAG,GAAG,UAAU,CAAC,CAAC;AAE5F,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,qBAAqB,CAAC;IAChC,CAAC,EAAE,UAAU,CAAC;IACd,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IACvC,WAAW,EAAE,WAAW,CAAC;IACzB,qBAAqB,EAAE,qBAAqB,CAAC;CAC9C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,CAAC,EACD,cAAc,EACd,WAAW,EACX,qBAAqB,GACtB,EAAE,sBAAsB,GAAG,YAAY,EAAE,CAezC"}