@file-viewer/core 2.0.0

package/dist/state.d.ts

@@ -0,0 +1,16 @@
+import type { FileViewerStateDescriptor, FileViewerStateTheme } from './types';
+export type FileViewerErrorMessageFormatter = (prefix: string, error: unknown) => string;
+export declare const FILE_VIEWER_PREVIEW_MESSAGES: Readonly<{
+    downloading: "正在下载文件资源...";
+    streamingPdf: "正在建立 PDF 流式预览...";
+    reading: "正在解析文件内容...";
+}>;
+export declare const DEFAULT_FILE_VIEWER_STATE_THEME: FileViewerStateTheme;
+export declare const DEFAULT_FILE_VIEWER_UNSUPPORTED_DESCRIPTION = "\u652F\u6301 Office\u3001PDF\u3001OFD\u3001Typst\u3001\u538B\u7F29\u5305\u3001\u90AE\u4EF6\u3001OLB/DRA\u3001CAD\u3001\u5730\u7406\u6570\u636E\u30013D \u6A21\u578B\u3001Excalidraw\u3001draw.io\u3001EPUB\u3001UMD\u3001Markdown\u3001\u4EE3\u7801/\u6587\u672C\u3001\u56FE\u7247\u3001\u97F3\u89C6\u9891\u3001\u5B57\u4F53\u548C\u6570\u636E\u8D44\u4EA7\u7684\u5728\u7EBF\u9884\u89C8";
+export declare const createFileViewerPreviewLoadingState: (extension?: string, message?: "正在解析文件内容...", theme?: FileViewerStateTheme) => FileViewerStateDescriptor;
+export declare const createFileViewerReadyState: (extension?: string, theme?: FileViewerStateTheme) => FileViewerStateDescriptor;
+export declare const createFileViewerEmptyState: (extension?: string, theme?: FileViewerStateTheme) => FileViewerStateDescriptor;
+export declare const createFileViewerUnsupportedState: (extension?: string, theme?: FileViewerStateTheme) => FileViewerStateDescriptor;
+export declare const normalizeFileViewerErrorMessage: (error: unknown) => string;
+export declare const formatFileViewerErrorMessage: FileViewerErrorMessageFormatter;
+export declare const createFileViewerErrorState: (extension?: string, error?: unknown, theme?: FileViewerStateTheme) => FileViewerStateDescriptor;

package/dist/state.js

@@ -0,0 +1,81 @@
+import { normalizeFileExtension } from './source.js';
+export const FILE_VIEWER_PREVIEW_MESSAGES = Object.freeze({
+    downloading: '正在下载文件资源...',
+    streamingPdf: '正在建立 PDF 流式预览...',
+    reading: '正在解析文件内容...',
+});
+export const DEFAULT_FILE_VIEWER_STATE_THEME = Object.freeze({
+    accent: '#5f6f82',
+    soft: 'rgba(95, 111, 130, 0.12)',
+    badge: 'DOC',
+    label: '文件内容',
+    hint: '正在整理内容结构并生成预览。',
+});
+export const DEFAULT_FILE_VIEWER_UNSUPPORTED_DESCRIPTION = '支持 Office、PDF、OFD、Typst、压缩包、邮件、OLB/DRA、CAD、地理数据、3D 模型、Excalidraw、draw.io、EPUB、UMD、Markdown、代码/文本、图片、音视频、字体和数据资产的在线预览';
+const extensionLabel = (extension) => {
+    const normalized = normalizeFileExtension(extension);
+    return normalized ? `.${normalized}` : '当前';
+};
+const createFileViewerStateDescriptor = ({ state, extension = '', title, message, description, theme = DEFAULT_FILE_VIEWER_STATE_THEME, recoverable, }) => ({
+    state,
+    extension: normalizeFileExtension(extension),
+    title,
+    message,
+    description,
+    theme,
+    recoverable,
+});
+export const createFileViewerPreviewLoadingState = (extension = '', message = FILE_VIEWER_PREVIEW_MESSAGES.reading, theme = DEFAULT_FILE_VIEWER_STATE_THEME) => createFileViewerStateDescriptor({
+    state: 'loading',
+    extension,
+    title: theme.label,
+    message,
+    description: theme.hint,
+    theme,
+    recoverable: false,
+});
+export const createFileViewerReadyState = (extension = '', theme = DEFAULT_FILE_VIEWER_STATE_THEME) => createFileViewerStateDescriptor({
+    state: 'ready',
+    extension,
+    title: '预览完成',
+    message: '文件内容已完成渲染。',
+    theme,
+    recoverable: false,
+});
+export const createFileViewerEmptyState = (extension = '', theme = DEFAULT_FILE_VIEWER_STATE_THEME) => createFileViewerStateDescriptor({
+    state: 'empty',
+    extension,
+    title: '暂无文件',
+    message: '请选择文件或提供可访问的文件地址后开始预览。',
+    theme,
+    recoverable: true,
+});
+export const createFileViewerUnsupportedState = (extension = '', theme = DEFAULT_FILE_VIEWER_STATE_THEME) => {
+    const label = extensionLabel(extension);
+    return createFileViewerStateDescriptor({
+        state: 'unsupported',
+        extension,
+        title: '暂不支持在线预览',
+        message: `不支持${label}格式的在线预览，请下载后预览或转换为支持的格式。`,
+        description: DEFAULT_FILE_VIEWER_UNSUPPORTED_DESCRIPTION,
+        theme,
+        recoverable: true,
+    });
+};
+export const normalizeFileViewerErrorMessage = (error) => {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+};
+export const formatFileViewerErrorMessage = (prefix, error) => {
+    return `${prefix}：${normalizeFileViewerErrorMessage(error)}`;
+};
+export const createFileViewerErrorState = (extension = '', error = '未知错误', theme = DEFAULT_FILE_VIEWER_STATE_THEME) => createFileViewerStateDescriptor({
+    state: 'error',
+    extension,
+    title: '预览失败',
+    message: normalizeFileViewerErrorMessage(error),
+    theme,
+    recoverable: true,
+});

package/dist/types.d.ts

@@ -0,0 +1,446 @@
+export type FileViewerSourceKind = 'file' | 'url' | 'buffer' | 'empty';
+export type FileViewerThemeMode = 'light' | 'dark' | 'system';
+export type FileViewerFileRef = File | Blob | ArrayBuffer;
+export type FileViewerToolbarPosition = 'auto' | 'top' | 'bottom-right';
+export type FileViewerLifecyclePhase = 'load-start' | 'load-complete' | 'unload-start' | 'unload-complete';
+export type FileViewerOperationType = 'download' | 'print' | 'export-html' | 'zoom-in' | 'zoom-out' | 'zoom-reset';
+export type FileViewerRenderStateKind = 'idle' | 'loading' | 'ready' | 'empty' | 'unsupported' | 'error';
+export type FileViewerRendererCategory = 'office' | 'document' | 'archive' | 'email' | 'eda' | 'cad' | 'model' | 'geo' | 'drawing' | 'ebook' | 'image' | 'markdown' | 'code' | 'media' | 'asset' | 'fallback';
+export interface FileViewerWatermarkOptions {
+    enabled?: boolean;
+    text?: string;
+    image?: string;
+    opacity?: number;
+    rotate?: number;
+    gapX?: number;
+    gapY?: number;
+    width?: number;
+    height?: number;
+    fontSize?: number;
+    color?: string;
+    fontFamily?: string;
+}
+export interface FileViewerToolbarOptions {
+    download?: boolean;
+    print?: boolean;
+    exportHtml?: boolean;
+    zoom?: boolean;
+    position?: FileViewerToolbarPosition;
+    beforeOperation?: FileViewerBeforeOperation;
+    beforeDownload?: FileViewerBeforeOperation;
+    beforePrint?: FileViewerBeforeOperation;
+    beforeExportHtml?: FileViewerBeforeOperation;
+}
+export interface FileViewerArchiveOptions {
+    workerUrl?: string;
+    wasmUrl?: string;
+    workerTimeoutMs?: number;
+    cache?: boolean;
+    maxArchiveSize?: number;
+    maxEntryPreviewSize?: number;
+}
+export interface FileViewerPdfOptions {
+    toolbar?: boolean;
+    navigation?: boolean;
+    defaultNavigationVisible?: boolean;
+    rotation?: number;
+    streaming?: boolean | 'same-origin';
+    rangeChunkSize?: number;
+    withCredentials?: boolean;
+    workerUrl?: string;
+}
+export interface FileViewerDocxOptions {
+    worker?: boolean;
+    workerUrl?: string;
+    progressive?: boolean;
+    visualPagination?: boolean;
+    workerTimeout?: number;
+}
+export interface FileViewerSpreadsheetOptions {
+    worker?: boolean;
+    workerUrl?: string;
+}
+export type FileRenderExportMode = 'export' | 'print';
+export interface FileRenderExportOptions {
+    mode: FileRenderExportMode;
+    title: string;
+}
+export interface FileRenderExportAdapter {
+    print?: boolean;
+    exportHtml?: boolean;
+    includeDocumentStyles?: boolean;
+    beforeSnapshot?: () => Promise<void> | void;
+    printStyle?: string | ((options: FileRenderExportOptions) => Promise<string> | string);
+    toHtml?: (options: FileRenderExportOptions) => Promise<string> | string;
+}
+export interface FileRenderContext {
+    filename?: string;
+    url?: string;
+    streamUrl?: string;
+    options?: FileViewerOptions;
+    registerExportAdapter?: (adapter: FileRenderExportAdapter | null) => void;
+    onProgressiveRender?: () => void;
+    renderNestedBuffer?: (buffer: ArrayBuffer, type: string, target: HTMLDivElement, context?: FileRenderContext) => Promise<FileViewerRenderedInstance | undefined>;
+}
+export type FileRenderHandler<Rendered = unknown, Target extends HTMLElement = HTMLElement> = (buffer: ArrayBuffer, target: Target, type?: string, context?: FileRenderContext) => Promise<Rendered>;
+export interface FileRenderHandlerComposite<Rendered = unknown, Target extends HTMLElement = HTMLElement> {
+    accepts: Array<string>;
+    handler: FileRenderHandler<Rendered, Target>;
+}
+/**
+ * Framework-neutral instance returned by a renderer after it mounts content.
+ *
+ * Vue, React legacy, Web Components or imperative renderers may expose different
+ * teardown names, but wrappers can share this single contract when bridging old
+ * renderer handlers into the core registry.
+ */
+export type FileViewerRenderedInstance = {
+    $el?: Node;
+    unmount: () => void | Promise<void>;
+} | {
+    $el?: Node;
+    $destroy: () => void | Promise<void>;
+} | {
+    $el?: Node;
+    destroy: () => void | Promise<void>;
+};
+export interface FileViewerTypstOptions {
+    compilerWasmUrl?: string;
+    rendererWasmUrl?: string;
+}
+export interface FileViewerDataOptions {
+    sqlWasmUrl?: string;
+}
+export type FileViewerCadRenderer = 'auto' | 'webgl' | 'canvas2d';
+export type FileViewerCadDwfLineWeightMode = 'adaptive' | 'physical' | 'hairline';
+export interface FileViewerCadOptions {
+    wasmPath?: string;
+    workerUrl?: string | URL;
+    dwfWasmUrl?: string;
+    dxfEncoding?: string;
+    useWorker?: boolean;
+    workerTimeoutMs?: number;
+    renderer?: FileViewerCadRenderer;
+    preferDwgWasm?: boolean;
+    includePaperSpace?: boolean;
+    maxInsertDepth?: number;
+    keepRaw?: boolean;
+    preloadDwg?: boolean;
+    dwfPreferWebgl?: boolean;
+    dwfPreferWasm?: boolean;
+    dwfBackground?: string;
+    dwfMaxDevicePixelRatio?: number;
+    dwfMaxCanvasPixels?: number;
+    dwfMaxGpuCacheBytes?: number;
+    dwfMaxCachedScenes?: number;
+    dwfLineWeightMode?: FileViewerCadDwfLineWeightMode;
+    dwfMinStrokeCssPx?: number;
+    dwfMaxOverviewStrokeCssPx?: number;
+    dwfMinTextCssPx?: number;
+    dwfMinFilledAreaCssPx?: number;
+    canvasOptions?: Record<string, unknown>;
+}
+export interface FileViewerSearchOptions {
+    enabled?: boolean;
+    caseSensitive?: boolean;
+    wholeWord?: boolean;
+    maxMatches?: number;
+    debounce?: number;
+    className?: string;
+    activeClassName?: string;
+}
+export interface FileViewerAiOptions {
+    enabled?: boolean;
+    collectText?: boolean;
+    maxTextLength?: number;
+    chunkSize?: number;
+    chunkOverlap?: number;
+}
+export interface FileViewerOptions {
+    theme?: FileViewerThemeMode;
+    watermark?: boolean | FileViewerWatermarkOptions;
+    toolbar?: boolean | FileViewerToolbarOptions;
+    search?: boolean | FileViewerSearchOptions;
+    ai?: boolean | FileViewerAiOptions;
+    archive?: FileViewerArchiveOptions;
+    pdf?: FileViewerPdfOptions;
+    docx?: FileViewerDocxOptions;
+    spreadsheet?: FileViewerSpreadsheetOptions;
+    typst?: FileViewerTypstOptions;
+    data?: FileViewerDataOptions;
+    cad?: FileViewerCadOptions;
+    hooks?: FileViewerLifecycleHooks;
+    beforeOperation?: FileViewerBeforeOperation;
+}
+export interface FileViewerLifecycleContext {
+    phase: FileViewerLifecyclePhase;
+    type: string;
+    filename: string;
+    source: FileViewerSourceKind;
+    url?: string;
+    file?: File;
+    size?: number;
+    version: number;
+    timestamp: number;
+    duration?: number;
+    reason?: 'replace' | 'reset' | 'component-unmount';
+}
+export interface FileViewerLifecycleHooks {
+    onLoadStart?: (context: FileViewerLifecycleContext) => void | Promise<void>;
+    onLoadComplete?: (context: FileViewerLifecycleContext) => void | Promise<void>;
+    onUnloadStart?: (context: FileViewerLifecycleContext) => void | Promise<void>;
+    onUnloadComplete?: (context: FileViewerLifecycleContext) => void | Promise<void>;
+}
+export interface FileViewerOperationContext extends Omit<FileViewerLifecycleContext, 'phase'> {
+    operation: FileViewerOperationType;
+    label: string;
+}
+export type FileViewerBeforeOperation = (context: FileViewerOperationContext) => boolean | void | Promise<boolean | void>;
+export interface FileViewerOperationAvailability {
+    download: boolean;
+    print: boolean;
+    exportHtml: boolean;
+    zoom: boolean;
+    zoomIn: boolean;
+    zoomOut: boolean;
+    zoomReset: boolean;
+}
+export interface FileViewerStateTheme {
+    accent: string;
+    badge: string;
+    hint: string;
+    label: string;
+    soft: string;
+}
+export interface FileViewerStateDescriptor {
+    state: FileViewerRenderStateKind;
+    extension: string;
+    title: string;
+    message: string;
+    description?: string;
+    theme: FileViewerStateTheme;
+    recoverable: boolean;
+}
+export interface FileViewerZoomState {
+    scale: number;
+    label: string;
+    canZoomIn: boolean;
+    canZoomOut: boolean;
+    canReset: boolean;
+    minScale?: number;
+    maxScale?: number;
+}
+export interface FileViewerZoomProvider {
+    zoomIn: () => FileViewerZoomState | Promise<FileViewerZoomState>;
+    zoomOut: () => FileViewerZoomState | Promise<FileViewerZoomState>;
+    resetZoom: () => FileViewerZoomState | Promise<FileViewerZoomState>;
+    setZoom?: (scale: number) => FileViewerZoomState | Promise<FileViewerZoomState>;
+    getState: () => FileViewerZoomState;
+    subscribe?: (listener: () => void) => () => void;
+}
+export interface FileViewerSearchMatch {
+    id: string;
+    index: number;
+    text: string;
+    anchor: FileViewerDocumentAnchor | null;
+    line?: number;
+    page?: number;
+}
+export interface FileViewerSearchState {
+    query: string;
+    total: number;
+    currentIndex: number;
+    current: FileViewerSearchMatch | null;
+    matches: FileViewerSearchMatch[];
+}
+export interface FileViewerSearchProvider {
+    search: (query: string, options?: FileViewerSearchOptions) => FileViewerSearchState | Promise<FileViewerSearchState>;
+    next?: () => FileViewerSearchState | Promise<FileViewerSearchState>;
+    previous?: () => FileViewerSearchState | Promise<FileViewerSearchState>;
+    clear?: () => FileViewerSearchState | Promise<FileViewerSearchState>;
+    getState?: () => FileViewerSearchState;
+}
+export interface FileViewerDocumentAnchor {
+    id: string;
+    index: number;
+    line: number;
+    type: 'page' | 'line' | 'block';
+    label: string;
+    text: string;
+    page?: number;
+    top: number;
+    left: number;
+    width: number;
+    height: number;
+}
+export interface FileViewerDocumentChunk {
+    id: string;
+    text: string;
+    anchor: FileViewerDocumentAnchor;
+    startLine: number;
+    endLine: number;
+}
+export interface FileViewerComponentProps {
+    file?: FileViewerFileRef;
+    url?: string;
+    options?: FileViewerOptions;
+}
+export interface FileViewerComponentEventMap {
+    'load-start': FileViewerLifecycleContext;
+    'load-complete': FileViewerLifecycleContext;
+    'unload-start': FileViewerLifecycleContext;
+    'unload-complete': FileViewerLifecycleContext;
+    'operation-before': FileViewerOperationContext;
+    'operation-cancel': FileViewerOperationContext;
+    'operation-availability-change': FileViewerOperationAvailability;
+    'search-change': FileViewerSearchState;
+    'location-change': FileViewerDocumentAnchor | null;
+    'zoom-change': FileViewerZoomState;
+}
+export type FileViewerEventType = keyof FileViewerComponentEventMap;
+export type FileViewerEvent = {
+    [EventType in FileViewerEventType]: {
+        type: EventType;
+        payload: FileViewerComponentEventMap[EventType];
+    };
+}[FileViewerEventType];
+export type FileViewerEventHandler = (event: FileViewerEvent) => void;
+export interface FileViewerComponentEmits {
+    (event: 'load-start', context: FileViewerComponentEventMap['load-start']): void;
+    (event: 'load-complete', context: FileViewerComponentEventMap['load-complete']): void;
+    (event: 'unload-start', context: FileViewerComponentEventMap['unload-start']): void;
+    (event: 'unload-complete', context: FileViewerComponentEventMap['unload-complete']): void;
+    (event: 'operation-before', context: FileViewerComponentEventMap['operation-before']): void;
+    (event: 'operation-cancel', context: FileViewerComponentEventMap['operation-cancel']): void;
+    (event: 'operation-availability-change', availability: FileViewerComponentEventMap['operation-availability-change']): void;
+    (event: 'search-change', state: FileViewerComponentEventMap['search-change']): void;
+    (event: 'location-change', anchor: FileViewerComponentEventMap['location-change']): void;
+    (event: 'zoom-change', state: FileViewerComponentEventMap['zoom-change']): void;
+}
+export interface FileViewerPublicApi {
+    downloadOriginalFile(): Promise<void>;
+    printRenderedHtml(): Promise<void>;
+    exportRenderedHtml(): Promise<void>;
+    zoomIn(): Promise<FileViewerZoomState>;
+    zoomOut(): Promise<FileViewerZoomState>;
+    resetZoom(): Promise<FileViewerZoomState>;
+    getZoomState(): FileViewerZoomState;
+    getOperationAvailability(): FileViewerOperationAvailability;
+    getScrollContainer(): HTMLElement | null;
+    searchDocument(query: string): Promise<FileViewerSearchState>;
+    clearDocumentSearch(): Promise<FileViewerSearchState>;
+    nextSearchResult(): Promise<FileViewerSearchState>;
+    previousSearchResult(): Promise<FileViewerSearchState>;
+    getSearchState(): FileViewerSearchState;
+    collectDocumentAnchors(): Promise<FileViewerDocumentAnchor[]>;
+    scrollToAnchor(anchor: FileViewerDocumentAnchor | string): Promise<boolean>;
+    scrollToLine(line: number): Promise<boolean>;
+    getDocumentTextChunks(): FileViewerDocumentChunk[];
+}
+export interface FileViewerDownloadOptions {
+    filename?: string;
+}
+export interface FileViewerExportHtmlOptions {
+    download?: boolean;
+    filename?: string;
+    title?: string;
+    watermarkInlineStyle?: string;
+}
+export interface FileViewerPrintOptions {
+    autoPrint?: boolean;
+    openWindow?: () => Window | null;
+    printWindow?: Window | null;
+    title?: string;
+    watermarkInlineStyle?: string;
+}
+export interface FileViewerSource {
+    url?: string;
+    file?: File | Blob;
+    buffer?: ArrayBuffer;
+    filename?: string;
+    type?: string;
+    size?: number;
+}
+export interface NormalizedFileViewerSource {
+    kind: FileViewerSourceKind;
+    filename: string;
+    extension: string;
+    url?: string;
+    file?: File | Blob;
+    buffer?: ArrayBuffer;
+    size?: number;
+}
+export interface RenderSurface {
+    container: HTMLElement;
+    shadowRoot?: ShadowRoot;
+}
+export interface RendererCapability {
+    download?: boolean;
+    print?: boolean | 'adapter';
+    exportHtml?: boolean | 'adapter';
+    zoom?: boolean | 'provider';
+    search?: boolean | 'provider';
+}
+export interface RendererDefinition {
+    id: string;
+    label: string;
+    category: FileViewerRendererCategory;
+    extensions: readonly string[];
+    async?: boolean;
+    capabilities?: RendererCapability;
+    load?: RendererLoader;
+}
+export type RendererPlugin = RendererDefinition;
+export type ViewerLifecycleContext = FileViewerLifecycleContext;
+export type ViewerOperationContext = FileViewerOperationContext;
+export type ViewerCapabilityState = FileViewerOperationAvailability;
+export interface RendererLoadContext {
+    source: NormalizedFileViewerSource;
+    surface: RenderSurface;
+    options: FileViewerOptions;
+    signal?: AbortSignal;
+    registerExportAdapter?: (adapter: FileRenderExportAdapter | null) => void;
+    renderContext?: FileRenderContext;
+}
+export interface RendererSession {
+    destroy?: () => void | Promise<void>;
+    getAvailability?: () => Partial<FileViewerOperationAvailability>;
+}
+export type RendererLoader = (context: RendererLoadContext) => RendererSession | Promise<RendererSession>;
+export interface RendererRegistry {
+    register(definition: RendererDefinition): void;
+    unregister(id: string): boolean;
+    getById(id: string): RendererDefinition | undefined;
+    getByExtension(extension: string): RendererDefinition | undefined;
+    hasExtension(extension: string): boolean;
+    list(): RendererDefinition[];
+    listExtensions(): string[];
+}
+export interface FileViewerInstance {
+    readonly container: HTMLElement;
+    load(source: FileViewerSource): Promise<RendererSession | null>;
+    destroy(reason?: FileViewerLifecycleContext['reason']): Promise<void>;
+    updateOptions(options: Partial<FileViewerOptions>): void;
+    getCapabilities(extension?: string): FileViewerOperationAvailability;
+    getRenderer(extension?: string): RendererDefinition | undefined;
+    getSource(): NormalizedFileViewerSource | null;
+    registerExportAdapter(adapter: FileRenderExportAdapter | null): void;
+    getExportAdapter(): FileRenderExportAdapter | null;
+    download(options?: FileViewerDownloadOptions): Promise<void>;
+    exportHtml(options?: FileViewerExportHtmlOptions): Promise<string>;
+    print(options?: FileViewerPrintOptions): Promise<void>;
+    zoomIn(): Promise<FileViewerZoomState>;
+    zoomOut(): Promise<FileViewerZoomState>;
+    resetZoom(): Promise<FileViewerZoomState>;
+    getZoomState(): FileViewerZoomState;
+    search(query: string): Promise<FileViewerSearchState>;
+    nextSearchResult(): Promise<FileViewerSearchState>;
+    previousSearchResult(): Promise<FileViewerSearchState>;
+    clearSearch(): Promise<FileViewerSearchState>;
+    getSearchState(): FileViewerSearchState;
+    collectDocumentAnchors(): Promise<FileViewerDocumentAnchor[]>;
+    getCurrentDocumentAnchor(): FileViewerDocumentAnchor | null;
+    scrollToDocumentAnchor(anchor: FileViewerDocumentAnchor | string | number | null | undefined): boolean;
+    scrollToLine(line: number): Promise<boolean>;
+    getDocumentTextChunks(options?: boolean | FileViewerAiOptions): FileViewerDocumentChunk[];
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/viewer.d.ts

@@ -0,0 +1,8 @@
+import type { FileViewerEventHandler, FileViewerInstance, FileViewerOptions, RendererRegistry } from './types';
+export interface CreateViewerOptions {
+    registry?: RendererRegistry;
+    options?: FileViewerOptions;
+    signal?: AbortSignal;
+    onEvent?: FileViewerEventHandler;
+}
+export declare const createViewer: (container: HTMLElement, createOptions?: CreateViewerOptions) => FileViewerInstance;