@files-preview-app/preview-file 1.3.1 → 1.3.3

package/dist/index.d.cts

@@ -1,20 +1,3228 @@
-import { FilePreviewViewer as FilePreviewViewer$1, PreviewPlugin } from '@patel.sumit51/core';
-export * from '@patel.sumit51/core';
-export { pdfPlugin } from '@patel.sumit51/plugin-pdf';
-export { mediaPlugin } from '@patel.sumit51/plugin-media';
-export { docxPlugin } from '@patel.sumit51/plugin-docx';
-export { excelPlugin } from '@patel.sumit51/plugin-excel';
-export { csvPlugin } from '@patel.sumit51/plugin-csv';
-export { codePlugin } from '@patel.sumit51/plugin-code';
-export { archivePlugin } from '@patel.sumit51/plugin-archive';
-export { markdownPlugin } from '@patel.sumit51/plugin-markdown';
-export { pptxPlugin } from '@patel.sumit51/plugin-pptx';
-export { threeDPlugin } from '@patel.sumit51/plugin-3d';
-export { rtfPlugin } from '@patel.sumit51/plugin-rtf';
-export { htmlPreviewPlugin } from '@patel.sumit51/plugin-html-preview';
-export { openDocumentPlugin } from '@patel.sumit51/plugin-opendocument';
-export { docPlugin } from '@patel.sumit51/plugin-doc';
-export { pptPlugin } from '@patel.sumit51/plugin-ppt';
+import { c as FilePreviewViewer$1, P as PreviewPlugin$f } from './index.d-B79v0jxi.cjs';
+export { C as CfbfEntry, d as CfbfReader, E as EventEmitter, e as EventHandler, f as FileInfo, g as FileMetadata, F as FileSource, h as PreviewEvent, b as PreviewInstance, a as PreviewViewerOptions, R as RenderContext, T as Thumbnail, i as ThumbnailPanel, j as ToolbarAction, k as ToolbarActionType, l as ToolbarConfig, m as ToolbarController, n as ToolbarGroup, o as TransferPayload, U as Unsubscribe, p as clamp, q as createElement, r as debounce, s as detectMagicBytes, t as detectOoxmlType, u as downloadFile, v as extractExtension, w as formatFileSize, x as getTransferPayload, y as mimeFromExtension, z as printElement, A as sanitizeHTML, B as sanitizeSVG, D as saveTransferPayload, G as sourceToArrayBuffer } from './index.d-B79v0jxi.cjs';
+
+/**
+ * Supported file input sources.
+ * Accepts URL strings, File objects, Blobs, ArrayBuffers, or Uint8Arrays.
+ */
+type FileSource$e = string | File | Blob | ArrayBuffer | Uint8Array;
+/** Metadata extracted from a file source */
+interface FileMetadata$e {
+    /** Original filename (if available) */
+    name?: string;
+    /** File size in bytes */
+    size?: number;
+    /** Detected MIME type */
+    mimeType?: string;
+    /** File extension (lowercase, with dot, e.g. '.pdf') */
+    extension?: string;
+}
+/** Information about a resolved file, ready for plugin matching */
+interface FileInfo$e {
+    metadata: FileMetadata$e;
+    buffer: ArrayBuffer;
+}
+/** Toolbar action types */
+type ToolbarActionType$e = 'button' | 'toggle' | 'range' | 'input' | 'separator' | 'page-nav';
+/** Toolbar action group names for visual grouping */
+type ToolbarGroup$e = 'navigation' | 'zoom' | 'view' | 'actions';
+/** Represents a single toolbar action/control */
+interface ToolbarAction$e {
+    /** Unique action identifier */
+    id: string;
+    /** SVG icon markup string */
+    icon: string;
+    /** Accessible label */
+    label: string;
+    /** Type of control to render */
+    type: ToolbarActionType$e;
+    /** Visual group placement */
+    group: ToolbarGroup$e;
+    /** Whether the action is currently enabled */
+    enabled?: boolean;
+    /** Whether a toggle is currently active */
+    active?: boolean;
+    /** Execute the action */
+    execute: (...args: unknown[]) => void;
+    /** For 'range' type: min/max/step/value */
+    min?: number;
+    max?: number;
+    step?: number;
+    value?: number;
+}
+/** Represents a thumbnail in the sidebar */
+interface Thumbnail$e {
+    /** Page/sheet/frame index */
+    index: number;
+    /** Display label (e.g., "Page 1", "Sheet: Revenue") */
+    label: string;
+    /** Renders the thumbnail into a canvas element */
+    render: (canvas: HTMLCanvasElement) => Promise<void>;
+}
+/** Instance returned after a file is rendered — exposes controls */
+interface PreviewInstance$e {
+    /** Clean up all resources */
+    destroy(): void;
+    zoomIn?(): void;
+    zoomOut?(): void;
+    getZoom?(): number;
+    setZoom?(level: number): void;
+    fitToPage?(): void;
+    fitToWidth?(): void;
+    goToPage?(page: number): void;
+    getPageCount?(): number;
+    getCurrentPage?(): number;
+    rotateCW?(): void;
+    rotateCCW?(): void;
+    getRotation?(): number;
+    play?(): void;
+    pause?(): void;
+    isPlaying?(): boolean;
+    fastForward?(seconds?: number): void;
+    rewind?(seconds?: number): void;
+    setPlaybackRate?(rate: number): void;
+    getPlaybackRate?(): number;
+    getThumbnails?(): Thumbnail$e[] | Promise<Thumbnail$e[]>;
+    toggleThumbnails?(): void;
+    download?(): void;
+    print?(): void;
+    [key: string]: unknown;
+}
+/** Context passed to a plugin's render function */
+interface RenderContext$e {
+    /** The container DOM element to render into */
+    container: HTMLElement;
+    /** Original file source */
+    source: FileSource$e;
+    /** Resolved file metadata */
+    metadata: FileMetadata$e;
+    /** File content as ArrayBuffer */
+    buffer: ArrayBuffer;
+    /** Viewer options */
+    options: PreviewViewerOptions$e;
+    /** AbortSignal for cancellation */
+    signal: AbortSignal;
+    /** Emit an event to the viewer */
+    emit: (event: string, payload?: unknown) => void;
+}
+/** Plugin interface — each file format renderer implements this */
+interface PreviewPlugin$e {
+    /** Unique plugin identifier */
+    id: string;
+    /** Human-readable plugin name */
+    name: string;
+    /** File extensions this plugin handles (e.g., ['.pdf']) */
+    extensions: string[];
+    /** MIME types this plugin handles */
+    mimeTypes: string[];
+    /** Priority when multiple plugins match (higher = preferred) */
+    weight?: number;
+    /** Check if this plugin can handle the given file */
+    supports(file: FileInfo$e): boolean | Promise<boolean>;
+    /** Return toolbar actions for the rendered instance */
+    getToolbarActions(instance: PreviewInstance$e): ToolbarAction$e[];
+    /** Render the file into the container */
+    render(ctx: RenderContext$e): Promise<PreviewInstance$e>;
+}
+/** Configuration to selectively enable or disable individual toolbar functions/buttons */
+interface ToolbarConfig$e {
+    /** Page navigation (< [1] / N >) */
+    pageNav?: boolean;
+    pagination?: boolean;
+    prevPage?: boolean;
+    nextPage?: boolean;
+    /** Zoom controls */
+    zoomIn?: boolean;
+    zoomOut?: boolean;
+    fitPage?: boolean;
+    fitToPage?: boolean;
+    fitWidth?: boolean;
+    zoomReset?: boolean;
+    /** View controls */
+    rotate?: boolean;
+    rotateCW?: boolean;
+    rotateCCW?: boolean;
+    fullscreen?: boolean;
+    thumbnails?: boolean;
+    /** Action controls */
+    download?: boolean;
+    print?: boolean;
+    openWindow?: boolean;
+    openSeparateWindow?: boolean;
+    copy?: boolean;
+    /** Media controls */
+    play?: boolean;
+    pause?: boolean;
+    fastForward?: boolean;
+    rewind?: boolean;
+    speed?: boolean;
+}
+/** Viewer configuration options */
+interface PreviewViewerOptions$e extends ToolbarConfig$e {
+    /** Color theme */
+    theme?: 'light' | 'dark' | 'auto';
+    /** Locale for UI labels */
+    locale?: string;
+    /** Initial zoom level (1.0 = 100%) */
+    zoom?: number;
+    /** Initial page number (1-based) */
+    page?: number;
+    /** Show the toolbar */
+    showToolbar?: boolean;
+    /** Detailed toolbar configuration (or boolean to show/hide entire toolbar) */
+    toolbar?: boolean | (ToolbarConfig$e & Record<string, boolean | undefined>);
+    /** Toolbar position */
+    toolbarPosition?: 'top' | 'bottom';
+    /** Fit mode: 'page' (fill frame width with minimal margins) or 'width' */
+    fitMode?: 'page' | 'width';
+    /** Show thumbnail sidebar initially */
+    showThumbnails?: boolean;
+    /** Whether to display the file name / title bar above the toolbar in the preview panel (defaults to true) */
+    showFileName?: boolean;
+    /** Custom file name / title override to display */
+    fileName?: string;
+    /** Custom CSS class for the container */
+    className?: string;
+    /** Plugin-specific options */
+    pluginOptions?: Record<string, unknown>;
+    /** Optional file metadata overrides (name, extension, mimeType, etc.) */
+    metadata?: FileMetadata$e;
+    /** Custom URL to navigate when "Open in Separate Full Window" is clicked */
+    standaloneViewerUrl?: string;
+    /** Custom handler for opening preview in a separate window */
+    onOpenSeparateWindow?: (payload: {
+        buffer: ArrayBuffer;
+        metadata: FileMetadata$e;
+        options: PreviewViewerOptions$e;
+    }) => Window | null;
+    /** Internal flag: true when viewer is rendered inside separate full window */
+    _isSeparateWindow?: boolean;
+    /** Allow custom/plugin-specific options */
+    [key: string]: unknown;
+}
+
+declare class PdfPlugin implements PreviewPlugin$e {
+    id: string;
+    name: string;
+    extensions: string[];
+    mimeTypes: string[];
+    weight: number;
+    supports(file: FileInfo$e): boolean;
+    getToolbarActions(instance: PreviewInstance$e): ToolbarAction$e[];
+    render(ctx: RenderContext$e): Promise<PreviewInstance$e>;
+}
+declare function pdfPlugin(): PdfPlugin;
+
+/**
+ * Supported file input sources.
+ * Accepts URL strings, File objects, Blobs, ArrayBuffers, or Uint8Arrays.
+ */
+type FileSource$d = string | File | Blob | ArrayBuffer | Uint8Array;
+/** Metadata extracted from a file source */
+interface FileMetadata$d {
+    /** Original filename (if available) */
+    name?: string;
+    /** File size in bytes */
+    size?: number;
+    /** Detected MIME type */
+    mimeType?: string;
+    /** File extension (lowercase, with dot, e.g. '.pdf') */
+    extension?: string;
+}
+/** Information about a resolved file, ready for plugin matching */
+interface FileInfo$d {
+    metadata: FileMetadata$d;
+    buffer: ArrayBuffer;
+}
+/** Toolbar action types */
+type ToolbarActionType$d = 'button' | 'toggle' | 'range' | 'input' | 'separator' | 'page-nav';
+/** Toolbar action group names for visual grouping */
+type ToolbarGroup$d = 'navigation' | 'zoom' | 'view' | 'actions';
+/** Represents a single toolbar action/control */
+interface ToolbarAction$d {
+    /** Unique action identifier */
+    id: string;
+    /** SVG icon markup string */
+    icon: string;
+    /** Accessible label */
+    label: string;
+    /** Type of control to render */
+    type: ToolbarActionType$d;
+    /** Visual group placement */
+    group: ToolbarGroup$d;
+    /** Whether the action is currently enabled */
+    enabled?: boolean;
+    /** Whether a toggle is currently active */
+    active?: boolean;
+    /** Execute the action */
+    execute: (...args: unknown[]) => void;
+    /** For 'range' type: min/max/step/value */
+    min?: number;
+    max?: number;
+    step?: number;
+    value?: number;
+}
+/** Represents a thumbnail in the sidebar */
+interface Thumbnail$d {
+    /** Page/sheet/frame index */
+    index: number;
+    /** Display label (e.g., "Page 1", "Sheet: Revenue") */
+    label: string;
+    /** Renders the thumbnail into a canvas element */
+    render: (canvas: HTMLCanvasElement) => Promise<void>;
+}
+/** Instance returned after a file is rendered — exposes controls */
+interface PreviewInstance$d {
+    /** Clean up all resources */
+    destroy(): void;
+    zoomIn?(): void;
+    zoomOut?(): void;
+    getZoom?(): number;
+    setZoom?(level: number): void;
+    fitToPage?(): void;
+    fitToWidth?(): void;
+    goToPage?(page: number): void;
+    getPageCount?(): number;
+    getCurrentPage?(): number;
+    rotateCW?(): void;
+    rotateCCW?(): void;
+    getRotation?(): number;
+    play?(): void;
+    pause?(): void;
+    isPlaying?(): boolean;
+    fastForward?(seconds?: number): void;
+    rewind?(seconds?: number): void;
+    setPlaybackRate?(rate: number): void;
+    getPlaybackRate?(): number;
+    getThumbnails?(): Thumbnail$d[] | Promise<Thumbnail$d[]>;
+    toggleThumbnails?(): void;
+    download?(): void;
+    print?(): void;
+    [key: string]: unknown;
+}
+/** Context passed to a plugin's render function */
+interface RenderContext$d {
+    /** The container DOM element to render into */
+    container: HTMLElement;
+    /** Original file source */
+    source: FileSource$d;
+    /** Resolved file metadata */
+    metadata: FileMetadata$d;
+    /** File content as ArrayBuffer */
+    buffer: ArrayBuffer;
+    /** Viewer options */
+    options: PreviewViewerOptions$d;
+    /** AbortSignal for cancellation */
+    signal: AbortSignal;
+    /** Emit an event to the viewer */
+    emit: (event: string, payload?: unknown) => void;
+}
+/** Plugin interface — each file format renderer implements this */
+interface PreviewPlugin$d {
+    /** Unique plugin identifier */
+    id: string;
+    /** Human-readable plugin name */
+    name: string;
+    /** File extensions this plugin handles (e.g., ['.pdf']) */
+    extensions: string[];
+    /** MIME types this plugin handles */
+    mimeTypes: string[];
+    /** Priority when multiple plugins match (higher = preferred) */
+    weight?: number;
+    /** Check if this plugin can handle the given file */
+    supports(file: FileInfo$d): boolean | Promise<boolean>;
+    /** Return toolbar actions for the rendered instance */
+    getToolbarActions(instance: PreviewInstance$d): ToolbarAction$d[];
+    /** Render the file into the container */
+    render(ctx: RenderContext$d): Promise<PreviewInstance$d>;
+}
+/** Configuration to selectively enable or disable individual toolbar functions/buttons */
+interface ToolbarConfig$d {
+    /** Page navigation (< [1] / N >) */
+    pageNav?: boolean;
+    pagination?: boolean;
+    prevPage?: boolean;
+    nextPage?: boolean;
+    /** Zoom controls */
+    zoomIn?: boolean;
+    zoomOut?: boolean;
+    fitPage?: boolean;
+    fitToPage?: boolean;
+    fitWidth?: boolean;
+    zoomReset?: boolean;
+    /** View controls */
+    rotate?: boolean;
+    rotateCW?: boolean;
+    rotateCCW?: boolean;
+    fullscreen?: boolean;
+    thumbnails?: boolean;
+    /** Action controls */
+    download?: boolean;
+    print?: boolean;
+    openWindow?: boolean;
+    openSeparateWindow?: boolean;
+    copy?: boolean;
+    /** Media controls */
+    play?: boolean;
+    pause?: boolean;
+    fastForward?: boolean;
+    rewind?: boolean;
+    speed?: boolean;
+}
+/** Viewer configuration options */
+interface PreviewViewerOptions$d extends ToolbarConfig$d {
+    /** Color theme */
+    theme?: 'light' | 'dark' | 'auto';
+    /** Locale for UI labels */
+    locale?: string;
+    /** Initial zoom level (1.0 = 100%) */
+    zoom?: number;
+    /** Initial page number (1-based) */
+    page?: number;
+    /** Show the toolbar */
+    showToolbar?: boolean;
+    /** Detailed toolbar configuration (or boolean to show/hide entire toolbar) */
+    toolbar?: boolean | (ToolbarConfig$d & Record<string, boolean | undefined>);
+    /** Toolbar position */
+    toolbarPosition?: 'top' | 'bottom';
+    /** Fit mode: 'page' (fill frame width with minimal margins) or 'width' */
+    fitMode?: 'page' | 'width';
+    /** Show thumbnail sidebar initially */
+    showThumbnails?: boolean;
+    /** Whether to display the file name / title bar above the toolbar in the preview panel (defaults to true) */
+    showFileName?: boolean;
+    /** Custom file name / title override to display */
+    fileName?: string;
+    /** Custom CSS class for the container */
+    className?: string;
+    /** Plugin-specific options */
+    pluginOptions?: Record<string, unknown>;
+    /** Optional file metadata overrides (name, extension, mimeType, etc.) */
+    metadata?: FileMetadata$d;
+    /** Custom URL to navigate when "Open in Separate Full Window" is clicked */
+    standaloneViewerUrl?: string;
+    /** Custom handler for opening preview in a separate window */
+    onOpenSeparateWindow?: (payload: {
+        buffer: ArrayBuffer;
+        metadata: FileMetadata$d;
+        options: PreviewViewerOptions$d;
+    }) => Window | null;
+    /** Internal flag: true when viewer is rendered inside separate full window */
+    _isSeparateWindow?: boolean;
+    /** Allow custom/plugin-specific options */
+    [key: string]: unknown;
+}
+
+declare class MediaPlugin implements PreviewPlugin$d {
+    id: string;
+    name: string;
+    extensions: string[];
+    mimeTypes: string[];
+    weight: number;
+    supports(file: FileInfo$d): boolean;
+    getToolbarActions(instance: PreviewInstance$d): ToolbarAction$d[];
+    render(ctx: RenderContext$d): Promise<PreviewInstance$d>;
+}
+declare function mediaPlugin(): MediaPlugin;
+
+/**
+ * Supported file input sources.
+ * Accepts URL strings, File objects, Blobs, ArrayBuffers, or Uint8Arrays.
+ */
+type FileSource$c = string | File | Blob | ArrayBuffer | Uint8Array;
+/** Metadata extracted from a file source */
+interface FileMetadata$c {
+    /** Original filename (if available) */
+    name?: string;
+    /** File size in bytes */
+    size?: number;
+    /** Detected MIME type */
+    mimeType?: string;
+    /** File extension (lowercase, with dot, e.g. '.pdf') */
+    extension?: string;
+}
+/** Information about a resolved file, ready for plugin matching */
+interface FileInfo$c {
+    metadata: FileMetadata$c;
+    buffer: ArrayBuffer;
+}
+/** Toolbar action types */
+type ToolbarActionType$c = 'button' | 'toggle' | 'range' | 'input' | 'separator' | 'page-nav';
+/** Toolbar action group names for visual grouping */
+type ToolbarGroup$c = 'navigation' | 'zoom' | 'view' | 'actions';
+/** Represents a single toolbar action/control */
+interface ToolbarAction$c {
+    /** Unique action identifier */
+    id: string;
+    /** SVG icon markup string */
+    icon: string;
+    /** Accessible label */
+    label: string;
+    /** Type of control to render */
+    type: ToolbarActionType$c;
+    /** Visual group placement */
+    group: ToolbarGroup$c;
+    /** Whether the action is currently enabled */
+    enabled?: boolean;
+    /** Whether a toggle is currently active */
+    active?: boolean;
+    /** Execute the action */
+    execute: (...args: unknown[]) => void;
+    /** For 'range' type: min/max/step/value */
+    min?: number;
+    max?: number;
+    step?: number;
+    value?: number;
+}
+/** Represents a thumbnail in the sidebar */
+interface Thumbnail$c {
+    /** Page/sheet/frame index */
+    index: number;
+    /** Display label (e.g., "Page 1", "Sheet: Revenue") */
+    label: string;
+    /** Renders the thumbnail into a canvas element */
+    render: (canvas: HTMLCanvasElement) => Promise<void>;
+}
+/** Instance returned after a file is rendered — exposes controls */
+interface PreviewInstance$c {
+    /** Clean up all resources */
+    destroy(): void;
+    zoomIn?(): void;
+    zoomOut?(): void;
+    getZoom?(): number;
+    setZoom?(level: number): void;
+    fitToPage?(): void;
+    fitToWidth?(): void;
+    goToPage?(page: number): void;
+    getPageCount?(): number;
+    getCurrentPage?(): number;
+    rotateCW?(): void;
+    rotateCCW?(): void;
+    getRotation?(): number;
+    play?(): void;
+    pause?(): void;
+    isPlaying?(): boolean;
+    fastForward?(seconds?: number): void;
+    rewind?(seconds?: number): void;
+    setPlaybackRate?(rate: number): void;
+    getPlaybackRate?(): number;
+    getThumbnails?(): Thumbnail$c[] | Promise<Thumbnail$c[]>;
+    toggleThumbnails?(): void;
+    download?(): void;
+    print?(): void;
+    [key: string]: unknown;
+}
+/** Context passed to a plugin's render function */
+interface RenderContext$c {
+    /** The container DOM element to render into */
+    container: HTMLElement;
+    /** Original file source */
+    source: FileSource$c;
+    /** Resolved file metadata */
+    metadata: FileMetadata$c;
+    /** File content as ArrayBuffer */
+    buffer: ArrayBuffer;
+    /** Viewer options */
+    options: PreviewViewerOptions$c;
+    /** AbortSignal for cancellation */
+    signal: AbortSignal;
+    /** Emit an event to the viewer */
+    emit: (event: string, payload?: unknown) => void;
+}
+/** Plugin interface — each file format renderer implements this */
+interface PreviewPlugin$c {
+    /** Unique plugin identifier */
+    id: string;
+    /** Human-readable plugin name */
+    name: string;
+    /** File extensions this plugin handles (e.g., ['.pdf']) */
+    extensions: string[];
+    /** MIME types this plugin handles */
+    mimeTypes: string[];
+    /** Priority when multiple plugins match (higher = preferred) */
+    weight?: number;
+    /** Check if this plugin can handle the given file */
+    supports(file: FileInfo$c): boolean | Promise<boolean>;
+    /** Return toolbar actions for the rendered instance */
+    getToolbarActions(instance: PreviewInstance$c): ToolbarAction$c[];
+    /** Render the file into the container */
+    render(ctx: RenderContext$c): Promise<PreviewInstance$c>;
+}
+/** Configuration to selectively enable or disable individual toolbar functions/buttons */
+interface ToolbarConfig$c {
+    /** Page navigation (< [1] / N >) */
+    pageNav?: boolean;
+    pagination?: boolean;
+    prevPage?: boolean;
+    nextPage?: boolean;
+    /** Zoom controls */
+    zoomIn?: boolean;
+    zoomOut?: boolean;
+    fitPage?: boolean;
+    fitToPage?: boolean;
+    fitWidth?: boolean;
+    zoomReset?: boolean;
+    /** View controls */
+    rotate?: boolean;
+    rotateCW?: boolean;
+    rotateCCW?: boolean;
+    fullscreen?: boolean;
+    thumbnails?: boolean;
+    /** Action controls */
+    download?: boolean;
+    print?: boolean;
+    openWindow?: boolean;
+    openSeparateWindow?: boolean;
+    copy?: boolean;
+    /** Media controls */
+    play?: boolean;
+    pause?: boolean;
+    fastForward?: boolean;
+    rewind?: boolean;
+    speed?: boolean;
+}
+/** Viewer configuration options */
+interface PreviewViewerOptions$c extends ToolbarConfig$c {
+    /** Color theme */
+    theme?: 'light' | 'dark' | 'auto';
+    /** Locale for UI labels */
+    locale?: string;
+    /** Initial zoom level (1.0 = 100%) */
+    zoom?: number;
+    /** Initial page number (1-based) */
+    page?: number;
+    /** Show the toolbar */
+    showToolbar?: boolean;
+    /** Detailed toolbar configuration (or boolean to show/hide entire toolbar) */
+    toolbar?: boolean | (ToolbarConfig$c & Record<string, boolean | undefined>);
+    /** Toolbar position */
+    toolbarPosition?: 'top' | 'bottom';
+    /** Fit mode: 'page' (fill frame width with minimal margins) or 'width' */
+    fitMode?: 'page' | 'width';
+    /** Show thumbnail sidebar initially */
+    showThumbnails?: boolean;
+    /** Whether to display the file name / title bar above the toolbar in the preview panel (defaults to true) */
+    showFileName?: boolean;
+    /** Custom file name / title override to display */
+    fileName?: string;
+    /** Custom CSS class for the container */
+    className?: string;
+    /** Plugin-specific options */
+    pluginOptions?: Record<string, unknown>;
+    /** Optional file metadata overrides (name, extension, mimeType, etc.) */
+    metadata?: FileMetadata$c;
+    /** Custom URL to navigate when "Open in Separate Full Window" is clicked */
+    standaloneViewerUrl?: string;
+    /** Custom handler for opening preview in a separate window */
+    onOpenSeparateWindow?: (payload: {
+        buffer: ArrayBuffer;
+        metadata: FileMetadata$c;
+        options: PreviewViewerOptions$c;
+    }) => Window | null;
+    /** Internal flag: true when viewer is rendered inside separate full window */
+    _isSeparateWindow?: boolean;
+    /** Allow custom/plugin-specific options */
+    [key: string]: unknown;
+}
+
+declare class DocxPlugin implements PreviewPlugin$c {
+    id: string;
+    name: string;
+    extensions: string[];
+    mimeTypes: string[];
+    weight: number;
+    supports(file: FileInfo$c): boolean;
+    getToolbarActions(instance: PreviewInstance$c): ToolbarAction$c[];
+    render(ctx: RenderContext$c): Promise<PreviewInstance$c>;
+    private renderXmlFallback;
+    private extractParagraphHtml;
+    private extractParagraphChunks;
+    private renderBinaryDocFallback;
+    private extractReadableStrings;
+    private parseAndRenderChartSvg;
+}
+declare function docxPlugin(): DocxPlugin;
+
+/**
+ * Supported file input sources.
+ * Accepts URL strings, File objects, Blobs, ArrayBuffers, or Uint8Arrays.
+ */
+type FileSource$b = string | File | Blob | ArrayBuffer | Uint8Array;
+/** Metadata extracted from a file source */
+interface FileMetadata$b {
+    /** Original filename (if available) */
+    name?: string;
+    /** File size in bytes */
+    size?: number;
+    /** Detected MIME type */
+    mimeType?: string;
+    /** File extension (lowercase, with dot, e.g. '.pdf') */
+    extension?: string;
+}
+/** Information about a resolved file, ready for plugin matching */
+interface FileInfo$b {
+    metadata: FileMetadata$b;
+    buffer: ArrayBuffer;
+}
+/** Toolbar action types */
+type ToolbarActionType$b = 'button' | 'toggle' | 'range' | 'input' | 'separator' | 'page-nav';
+/** Toolbar action group names for visual grouping */
+type ToolbarGroup$b = 'navigation' | 'zoom' | 'view' | 'actions';
+/** Represents a single toolbar action/control */
+interface ToolbarAction$b {
+    /** Unique action identifier */
+    id: string;
+    /** SVG icon markup string */
+    icon: string;
+    /** Accessible label */
+    label: string;
+    /** Type of control to render */
+    type: ToolbarActionType$b;
+    /** Visual group placement */
+    group: ToolbarGroup$b;
+    /** Whether the action is currently enabled */
+    enabled?: boolean;
+    /** Whether a toggle is currently active */
+    active?: boolean;
+    /** Execute the action */
+    execute: (...args: unknown[]) => void;
+    /** For 'range' type: min/max/step/value */
+    min?: number;
+    max?: number;
+    step?: number;
+    value?: number;
+}
+/** Represents a thumbnail in the sidebar */
+interface Thumbnail$b {
+    /** Page/sheet/frame index */
+    index: number;
+    /** Display label (e.g., "Page 1", "Sheet: Revenue") */
+    label: string;
+    /** Renders the thumbnail into a canvas element */
+    render: (canvas: HTMLCanvasElement) => Promise<void>;
+}
+/** Instance returned after a file is rendered — exposes controls */
+interface PreviewInstance$b {
+    /** Clean up all resources */
+    destroy(): void;
+    zoomIn?(): void;
+    zoomOut?(): void;
+    getZoom?(): number;
+    setZoom?(level: number): void;
+    fitToPage?(): void;
+    fitToWidth?(): void;
+    goToPage?(page: number): void;
+    getPageCount?(): number;
+    getCurrentPage?(): number;
+    rotateCW?(): void;
+    rotateCCW?(): void;
+    getRotation?(): number;
+    play?(): void;
+    pause?(): void;
+    isPlaying?(): boolean;
+    fastForward?(seconds?: number): void;
+    rewind?(seconds?: number): void;
+    setPlaybackRate?(rate: number): void;
+    getPlaybackRate?(): number;
+    getThumbnails?(): Thumbnail$b[] | Promise<Thumbnail$b[]>;
+    toggleThumbnails?(): void;
+    download?(): void;
+    print?(): void;
+    [key: string]: unknown;
+}
+/** Context passed to a plugin's render function */
+interface RenderContext$b {
+    /** The container DOM element to render into */
+    container: HTMLElement;
+    /** Original file source */
+    source: FileSource$b;
+    /** Resolved file metadata */
+    metadata: FileMetadata$b;
+    /** File content as ArrayBuffer */
+    buffer: ArrayBuffer;
+    /** Viewer options */
+    options: PreviewViewerOptions$b;
+    /** AbortSignal for cancellation */
+    signal: AbortSignal;
+    /** Emit an event to the viewer */
+    emit: (event: string, payload?: unknown) => void;
+}
+/** Plugin interface — each file format renderer implements this */
+interface PreviewPlugin$b {
+    /** Unique plugin identifier */
+    id: string;
+    /** Human-readable plugin name */
+    name: string;
+    /** File extensions this plugin handles (e.g., ['.pdf']) */
+    extensions: string[];
+    /** MIME types this plugin handles */
+    mimeTypes: string[];
+    /** Priority when multiple plugins match (higher = preferred) */
+    weight?: number;
+    /** Check if this plugin can handle the given file */
+    supports(file: FileInfo$b): boolean | Promise<boolean>;
+    /** Return toolbar actions for the rendered instance */
+    getToolbarActions(instance: PreviewInstance$b): ToolbarAction$b[];
+    /** Render the file into the container */
+    render(ctx: RenderContext$b): Promise<PreviewInstance$b>;
+}
+/** Configuration to selectively enable or disable individual toolbar functions/buttons */
+interface ToolbarConfig$b {
+    /** Page navigation (< [1] / N >) */
+    pageNav?: boolean;
+    pagination?: boolean;
+    prevPage?: boolean;
+    nextPage?: boolean;
+    /** Zoom controls */
+    zoomIn?: boolean;
+    zoomOut?: boolean;
+    fitPage?: boolean;
+    fitToPage?: boolean;
+    fitWidth?: boolean;
+    zoomReset?: boolean;
+    /** View controls */
+    rotate?: boolean;
+    rotateCW?: boolean;
+    rotateCCW?: boolean;
+    fullscreen?: boolean;
+    thumbnails?: boolean;
+    /** Action controls */
+    download?: boolean;
+    print?: boolean;
+    openWindow?: boolean;
+    openSeparateWindow?: boolean;
+    copy?: boolean;
+    /** Media controls */
+    play?: boolean;
+    pause?: boolean;
+    fastForward?: boolean;
+    rewind?: boolean;
+    speed?: boolean;
+}
+/** Viewer configuration options */
+interface PreviewViewerOptions$b extends ToolbarConfig$b {
+    /** Color theme */
+    theme?: 'light' | 'dark' | 'auto';
+    /** Locale for UI labels */
+    locale?: string;
+    /** Initial zoom level (1.0 = 100%) */
+    zoom?: number;
+    /** Initial page number (1-based) */
+    page?: number;
+    /** Show the toolbar */
+    showToolbar?: boolean;
+    /** Detailed toolbar configuration (or boolean to show/hide entire toolbar) */
+    toolbar?: boolean | (ToolbarConfig$b & Record<string, boolean | undefined>);
+    /** Toolbar position */
+    toolbarPosition?: 'top' | 'bottom';
+    /** Fit mode: 'page' (fill frame width with minimal margins) or 'width' */
+    fitMode?: 'page' | 'width';
+    /** Show thumbnail sidebar initially */
+    showThumbnails?: boolean;
+    /** Whether to display the file name / title bar above the toolbar in the preview panel (defaults to true) */
+    showFileName?: boolean;
+    /** Custom file name / title override to display */
+    fileName?: string;
+    /** Custom CSS class for the container */
+    className?: string;
+    /** Plugin-specific options */
+    pluginOptions?: Record<string, unknown>;
+    /** Optional file metadata overrides (name, extension, mimeType, etc.) */
+    metadata?: FileMetadata$b;
+    /** Custom URL to navigate when "Open in Separate Full Window" is clicked */
+    standaloneViewerUrl?: string;
+    /** Custom handler for opening preview in a separate window */
+    onOpenSeparateWindow?: (payload: {
+        buffer: ArrayBuffer;
+        metadata: FileMetadata$b;
+        options: PreviewViewerOptions$b;
+    }) => Window | null;
+    /** Internal flag: true when viewer is rendered inside separate full window */
+    _isSeparateWindow?: boolean;
+    /** Allow custom/plugin-specific options */
+    [key: string]: unknown;
+}
+
+declare class ExcelPlugin implements PreviewPlugin$b {
+    id: string;
+    name: string;
+    extensions: string[];
+    mimeTypes: string[];
+    weight: number;
+    supports(file: FileInfo$b): boolean;
+    getToolbarActions(instance: PreviewInstance$b): ToolbarAction$b[];
+    render(ctx: RenderContext$b): Promise<PreviewInstance$b>;
+}
+declare function excelPlugin(): ExcelPlugin;
+
+/**
+ * Supported file input sources.
+ * Accepts URL strings, File objects, Blobs, ArrayBuffers, or Uint8Arrays.
+ */
+type FileSource$a = string | File | Blob | ArrayBuffer | Uint8Array;
+/** Metadata extracted from a file source */
+interface FileMetadata$a {
+    /** Original filename (if available) */
+    name?: string;
+    /** File size in bytes */
+    size?: number;
+    /** Detected MIME type */
+    mimeType?: string;
+    /** File extension (lowercase, with dot, e.g. '.pdf') */
+    extension?: string;
+}
+/** Information about a resolved file, ready for plugin matching */
+interface FileInfo$a {
+    metadata: FileMetadata$a;
+    buffer: ArrayBuffer;
+}
+/** Toolbar action types */
+type ToolbarActionType$a = 'button' | 'toggle' | 'range' | 'input' | 'separator' | 'page-nav';
+/** Toolbar action group names for visual grouping */
+type ToolbarGroup$a = 'navigation' | 'zoom' | 'view' | 'actions';
+/** Represents a single toolbar action/control */
+interface ToolbarAction$a {
+    /** Unique action identifier */
+    id: string;
+    /** SVG icon markup string */
+    icon: string;
+    /** Accessible label */
+    label: string;
+    /** Type of control to render */
+    type: ToolbarActionType$a;
+    /** Visual group placement */
+    group: ToolbarGroup$a;
+    /** Whether the action is currently enabled */
+    enabled?: boolean;
+    /** Whether a toggle is currently active */
+    active?: boolean;
+    /** Execute the action */
+    execute: (...args: unknown[]) => void;
+    /** For 'range' type: min/max/step/value */
+    min?: number;
+    max?: number;
+    step?: number;
+    value?: number;
+}
+/** Represents a thumbnail in the sidebar */
+interface Thumbnail$a {
+    /** Page/sheet/frame index */
+    index: number;
+    /** Display label (e.g., "Page 1", "Sheet: Revenue") */
+    label: string;
+    /** Renders the thumbnail into a canvas element */
+    render: (canvas: HTMLCanvasElement) => Promise<void>;
+}
+/** Instance returned after a file is rendered — exposes controls */
+interface PreviewInstance$a {
+    /** Clean up all resources */
+    destroy(): void;
+    zoomIn?(): void;
+    zoomOut?(): void;
+    getZoom?(): number;
+    setZoom?(level: number): void;
+    fitToPage?(): void;
+    fitToWidth?(): void;
+    goToPage?(page: number): void;
+    getPageCount?(): number;
+    getCurrentPage?(): number;
+    rotateCW?(): void;
+    rotateCCW?(): void;
+    getRotation?(): number;
+    play?(): void;
+    pause?(): void;
+    isPlaying?(): boolean;
+    fastForward?(seconds?: number): void;
+    rewind?(seconds?: number): void;
+    setPlaybackRate?(rate: number): void;
+    getPlaybackRate?(): number;
+    getThumbnails?(): Thumbnail$a[] | Promise<Thumbnail$a[]>;
+    toggleThumbnails?(): void;
+    download?(): void;
+    print?(): void;
+    [key: string]: unknown;
+}
+/** Context passed to a plugin's render function */
+interface RenderContext$a {
+    /** The container DOM element to render into */
+    container: HTMLElement;
+    /** Original file source */
+    source: FileSource$a;
+    /** Resolved file metadata */
+    metadata: FileMetadata$a;
+    /** File content as ArrayBuffer */
+    buffer: ArrayBuffer;
+    /** Viewer options */
+    options: PreviewViewerOptions$a;
+    /** AbortSignal for cancellation */
+    signal: AbortSignal;
+    /** Emit an event to the viewer */
+    emit: (event: string, payload?: unknown) => void;
+}
+/** Plugin interface — each file format renderer implements this */
+interface PreviewPlugin$a {
+    /** Unique plugin identifier */
+    id: string;
+    /** Human-readable plugin name */
+    name: string;
+    /** File extensions this plugin handles (e.g., ['.pdf']) */
+    extensions: string[];
+    /** MIME types this plugin handles */
+    mimeTypes: string[];
+    /** Priority when multiple plugins match (higher = preferred) */
+    weight?: number;
+    /** Check if this plugin can handle the given file */
+    supports(file: FileInfo$a): boolean | Promise<boolean>;
+    /** Return toolbar actions for the rendered instance */
+    getToolbarActions(instance: PreviewInstance$a): ToolbarAction$a[];
+    /** Render the file into the container */
+    render(ctx: RenderContext$a): Promise<PreviewInstance$a>;
+}
+/** Configuration to selectively enable or disable individual toolbar functions/buttons */
+interface ToolbarConfig$a {
+    /** Page navigation (< [1] / N >) */
+    pageNav?: boolean;
+    pagination?: boolean;
+    prevPage?: boolean;
+    nextPage?: boolean;
+    /** Zoom controls */
+    zoomIn?: boolean;
+    zoomOut?: boolean;
+    fitPage?: boolean;
+    fitToPage?: boolean;
+    fitWidth?: boolean;
+    zoomReset?: boolean;
+    /** View controls */
+    rotate?: boolean;
+    rotateCW?: boolean;
+    rotateCCW?: boolean;
+    fullscreen?: boolean;
+    thumbnails?: boolean;
+    /** Action controls */
+    download?: boolean;
+    print?: boolean;
+    openWindow?: boolean;
+    openSeparateWindow?: boolean;
+    copy?: boolean;
+    /** Media controls */
+    play?: boolean;
+    pause?: boolean;
+    fastForward?: boolean;
+    rewind?: boolean;
+    speed?: boolean;
+}
+/** Viewer configuration options */
+interface PreviewViewerOptions$a extends ToolbarConfig$a {
+    /** Color theme */
+    theme?: 'light' | 'dark' | 'auto';
+    /** Locale for UI labels */
+    locale?: string;
+    /** Initial zoom level (1.0 = 100%) */
+    zoom?: number;
+    /** Initial page number (1-based) */
+    page?: number;
+    /** Show the toolbar */
+    showToolbar?: boolean;
+    /** Detailed toolbar configuration (or boolean to show/hide entire toolbar) */
+    toolbar?: boolean | (ToolbarConfig$a & Record<string, boolean | undefined>);
+    /** Toolbar position */
+    toolbarPosition?: 'top' | 'bottom';
+    /** Fit mode: 'page' (fill frame width with minimal margins) or 'width' */
+    fitMode?: 'page' | 'width';
+    /** Show thumbnail sidebar initially */
+    showThumbnails?: boolean;
+    /** Whether to display the file name / title bar above the toolbar in the preview panel (defaults to true) */
+    showFileName?: boolean;
+    /** Custom file name / title override to display */
+    fileName?: string;
+    /** Custom CSS class for the container */
+    className?: string;
+    /** Plugin-specific options */
+    pluginOptions?: Record<string, unknown>;
+    /** Optional file metadata overrides (name, extension, mimeType, etc.) */
+    metadata?: FileMetadata$a;
+    /** Custom URL to navigate when "Open in Separate Full Window" is clicked */
+    standaloneViewerUrl?: string;
+    /** Custom handler for opening preview in a separate window */
+    onOpenSeparateWindow?: (payload: {
+        buffer: ArrayBuffer;
+        metadata: FileMetadata$a;
+        options: PreviewViewerOptions$a;
+    }) => Window | null;
+    /** Internal flag: true when viewer is rendered inside separate full window */
+    _isSeparateWindow?: boolean;
+    /** Allow custom/plugin-specific options */
+    [key: string]: unknown;
+}
+
+declare class CsvPlugin implements PreviewPlugin$a {
+    id: string;
+    name: string;
+    extensions: string[];
+    mimeTypes: string[];
+    weight: number;
+    supports(file: FileInfo$a): boolean;
+    getToolbarActions(instance: PreviewInstance$a): ToolbarAction$a[];
+    render(ctx: RenderContext$a): Promise<PreviewInstance$a>;
+}
+declare function csvPlugin(): CsvPlugin;
+
+/**
+ * Supported file input sources.
+ * Accepts URL strings, File objects, Blobs, ArrayBuffers, or Uint8Arrays.
+ */
+type FileSource$9 = string | File | Blob | ArrayBuffer | Uint8Array;
+/** Metadata extracted from a file source */
+interface FileMetadata$9 {
+    /** Original filename (if available) */
+    name?: string;
+    /** File size in bytes */
+    size?: number;
+    /** Detected MIME type */
+    mimeType?: string;
+    /** File extension (lowercase, with dot, e.g. '.pdf') */
+    extension?: string;
+}
+/** Information about a resolved file, ready for plugin matching */
+interface FileInfo$9 {
+    metadata: FileMetadata$9;
+    buffer: ArrayBuffer;
+}
+/** Toolbar action types */
+type ToolbarActionType$9 = 'button' | 'toggle' | 'range' | 'input' | 'separator' | 'page-nav';
+/** Toolbar action group names for visual grouping */
+type ToolbarGroup$9 = 'navigation' | 'zoom' | 'view' | 'actions';
+/** Represents a single toolbar action/control */
+interface ToolbarAction$9 {
+    /** Unique action identifier */
+    id: string;
+    /** SVG icon markup string */
+    icon: string;
+    /** Accessible label */
+    label: string;
+    /** Type of control to render */
+    type: ToolbarActionType$9;
+    /** Visual group placement */
+    group: ToolbarGroup$9;
+    /** Whether the action is currently enabled */
+    enabled?: boolean;
+    /** Whether a toggle is currently active */
+    active?: boolean;
+    /** Execute the action */
+    execute: (...args: unknown[]) => void;
+    /** For 'range' type: min/max/step/value */
+    min?: number;
+    max?: number;
+    step?: number;
+    value?: number;
+}
+/** Represents a thumbnail in the sidebar */
+interface Thumbnail$9 {
+    /** Page/sheet/frame index */
+    index: number;
+    /** Display label (e.g., "Page 1", "Sheet: Revenue") */
+    label: string;
+    /** Renders the thumbnail into a canvas element */
+    render: (canvas: HTMLCanvasElement) => Promise<void>;
+}
+/** Instance returned after a file is rendered — exposes controls */
+interface PreviewInstance$9 {
+    /** Clean up all resources */
+    destroy(): void;
+    zoomIn?(): void;
+    zoomOut?(): void;
+    getZoom?(): number;
+    setZoom?(level: number): void;
+    fitToPage?(): void;
+    fitToWidth?(): void;
+    goToPage?(page: number): void;
+    getPageCount?(): number;
+    getCurrentPage?(): number;
+    rotateCW?(): void;
+    rotateCCW?(): void;
+    getRotation?(): number;
+    play?(): void;
+    pause?(): void;
+    isPlaying?(): boolean;
+    fastForward?(seconds?: number): void;
+    rewind?(seconds?: number): void;
+    setPlaybackRate?(rate: number): void;
+    getPlaybackRate?(): number;
+    getThumbnails?(): Thumbnail$9[] | Promise<Thumbnail$9[]>;
+    toggleThumbnails?(): void;
+    download?(): void;
+    print?(): void;
+    [key: string]: unknown;
+}
+/** Context passed to a plugin's render function */
+interface RenderContext$9 {
+    /** The container DOM element to render into */
+    container: HTMLElement;
+    /** Original file source */
+    source: FileSource$9;
+    /** Resolved file metadata */
+    metadata: FileMetadata$9;
+    /** File content as ArrayBuffer */
+    buffer: ArrayBuffer;
+    /** Viewer options */
+    options: PreviewViewerOptions$9;
+    /** AbortSignal for cancellation */
+    signal: AbortSignal;
+    /** Emit an event to the viewer */
+    emit: (event: string, payload?: unknown) => void;
+}
+/** Plugin interface — each file format renderer implements this */
+interface PreviewPlugin$9 {
+    /** Unique plugin identifier */
+    id: string;
+    /** Human-readable plugin name */
+    name: string;
+    /** File extensions this plugin handles (e.g., ['.pdf']) */
+    extensions: string[];
+    /** MIME types this plugin handles */
+    mimeTypes: string[];
+    /** Priority when multiple plugins match (higher = preferred) */
+    weight?: number;
+    /** Check if this plugin can handle the given file */
+    supports(file: FileInfo$9): boolean | Promise<boolean>;
+    /** Return toolbar actions for the rendered instance */
+    getToolbarActions(instance: PreviewInstance$9): ToolbarAction$9[];
+    /** Render the file into the container */
+    render(ctx: RenderContext$9): Promise<PreviewInstance$9>;
+}
+/** Configuration to selectively enable or disable individual toolbar functions/buttons */
+interface ToolbarConfig$9 {
+    /** Page navigation (< [1] / N >) */
+    pageNav?: boolean;
+    pagination?: boolean;
+    prevPage?: boolean;
+    nextPage?: boolean;
+    /** Zoom controls */
+    zoomIn?: boolean;
+    zoomOut?: boolean;
+    fitPage?: boolean;
+    fitToPage?: boolean;
+    fitWidth?: boolean;
+    zoomReset?: boolean;
+    /** View controls */
+    rotate?: boolean;
+    rotateCW?: boolean;
+    rotateCCW?: boolean;
+    fullscreen?: boolean;
+    thumbnails?: boolean;
+    /** Action controls */
+    download?: boolean;
+    print?: boolean;
+    openWindow?: boolean;
+    openSeparateWindow?: boolean;
+    copy?: boolean;
+    /** Media controls */
+    play?: boolean;
+    pause?: boolean;
+    fastForward?: boolean;
+    rewind?: boolean;
+    speed?: boolean;
+}
+/** Viewer configuration options */
+interface PreviewViewerOptions$9 extends ToolbarConfig$9 {
+    /** Color theme */
+    theme?: 'light' | 'dark' | 'auto';
+    /** Locale for UI labels */
+    locale?: string;
+    /** Initial zoom level (1.0 = 100%) */
+    zoom?: number;
+    /** Initial page number (1-based) */
+    page?: number;
+    /** Show the toolbar */
+    showToolbar?: boolean;
+    /** Detailed toolbar configuration (or boolean to show/hide entire toolbar) */
+    toolbar?: boolean | (ToolbarConfig$9 & Record<string, boolean | undefined>);
+    /** Toolbar position */
+    toolbarPosition?: 'top' | 'bottom';
+    /** Fit mode: 'page' (fill frame width with minimal margins) or 'width' */
+    fitMode?: 'page' | 'width';
+    /** Show thumbnail sidebar initially */
+    showThumbnails?: boolean;
+    /** Whether to display the file name / title bar above the toolbar in the preview panel (defaults to true) */
+    showFileName?: boolean;
+    /** Custom file name / title override to display */
+    fileName?: string;
+    /** Custom CSS class for the container */
+    className?: string;
+    /** Plugin-specific options */
+    pluginOptions?: Record<string, unknown>;
+    /** Optional file metadata overrides (name, extension, mimeType, etc.) */
+    metadata?: FileMetadata$9;
+    /** Custom URL to navigate when "Open in Separate Full Window" is clicked */
+    standaloneViewerUrl?: string;
+    /** Custom handler for opening preview in a separate window */
+    onOpenSeparateWindow?: (payload: {
+        buffer: ArrayBuffer;
+        metadata: FileMetadata$9;
+        options: PreviewViewerOptions$9;
+    }) => Window | null;
+    /** Internal flag: true when viewer is rendered inside separate full window */
+    _isSeparateWindow?: boolean;
+    /** Allow custom/plugin-specific options */
+    [key: string]: unknown;
+}
+
+declare class CodePlugin implements PreviewPlugin$9 {
+    id: string;
+    name: string;
+    extensions: string[];
+    mimeTypes: string[];
+    weight: number;
+    supports(file: FileInfo$9): boolean;
+    getToolbarActions(instance: PreviewInstance$9): ToolbarAction$9[];
+    render(ctx: RenderContext$9): Promise<PreviewInstance$9>;
+}
+declare function codePlugin(): CodePlugin;
+
+/**
+ * Supported file input sources.
+ * Accepts URL strings, File objects, Blobs, ArrayBuffers, or Uint8Arrays.
+ */
+type FileSource$8 = string | File | Blob | ArrayBuffer | Uint8Array;
+/** Metadata extracted from a file source */
+interface FileMetadata$8 {
+    /** Original filename (if available) */
+    name?: string;
+    /** File size in bytes */
+    size?: number;
+    /** Detected MIME type */
+    mimeType?: string;
+    /** File extension (lowercase, with dot, e.g. '.pdf') */
+    extension?: string;
+}
+/** Information about a resolved file, ready for plugin matching */
+interface FileInfo$8 {
+    metadata: FileMetadata$8;
+    buffer: ArrayBuffer;
+}
+/** Toolbar action types */
+type ToolbarActionType$8 = 'button' | 'toggle' | 'range' | 'input' | 'separator' | 'page-nav';
+/** Toolbar action group names for visual grouping */
+type ToolbarGroup$8 = 'navigation' | 'zoom' | 'view' | 'actions';
+/** Represents a single toolbar action/control */
+interface ToolbarAction$8 {
+    /** Unique action identifier */
+    id: string;
+    /** SVG icon markup string */
+    icon: string;
+    /** Accessible label */
+    label: string;
+    /** Type of control to render */
+    type: ToolbarActionType$8;
+    /** Visual group placement */
+    group: ToolbarGroup$8;
+    /** Whether the action is currently enabled */
+    enabled?: boolean;
+    /** Whether a toggle is currently active */
+    active?: boolean;
+    /** Execute the action */
+    execute: (...args: unknown[]) => void;
+    /** For 'range' type: min/max/step/value */
+    min?: number;
+    max?: number;
+    step?: number;
+    value?: number;
+}
+/** Represents a thumbnail in the sidebar */
+interface Thumbnail$8 {
+    /** Page/sheet/frame index */
+    index: number;
+    /** Display label (e.g., "Page 1", "Sheet: Revenue") */
+    label: string;
+    /** Renders the thumbnail into a canvas element */
+    render: (canvas: HTMLCanvasElement) => Promise<void>;
+}
+/** Instance returned after a file is rendered — exposes controls */
+interface PreviewInstance$8 {
+    /** Clean up all resources */
+    destroy(): void;
+    zoomIn?(): void;
+    zoomOut?(): void;
+    getZoom?(): number;
+    setZoom?(level: number): void;
+    fitToPage?(): void;
+    fitToWidth?(): void;
+    goToPage?(page: number): void;
+    getPageCount?(): number;
+    getCurrentPage?(): number;
+    rotateCW?(): void;
+    rotateCCW?(): void;
+    getRotation?(): number;
+    play?(): void;
+    pause?(): void;
+    isPlaying?(): boolean;
+    fastForward?(seconds?: number): void;
+    rewind?(seconds?: number): void;
+    setPlaybackRate?(rate: number): void;
+    getPlaybackRate?(): number;
+    getThumbnails?(): Thumbnail$8[] | Promise<Thumbnail$8[]>;
+    toggleThumbnails?(): void;
+    download?(): void;
+    print?(): void;
+    [key: string]: unknown;
+}
+/** Context passed to a plugin's render function */
+interface RenderContext$8 {
+    /** The container DOM element to render into */
+    container: HTMLElement;
+    /** Original file source */
+    source: FileSource$8;
+    /** Resolved file metadata */
+    metadata: FileMetadata$8;
+    /** File content as ArrayBuffer */
+    buffer: ArrayBuffer;
+    /** Viewer options */
+    options: PreviewViewerOptions$8;
+    /** AbortSignal for cancellation */
+    signal: AbortSignal;
+    /** Emit an event to the viewer */
+    emit: (event: string, payload?: unknown) => void;
+}
+/** Plugin interface — each file format renderer implements this */
+interface PreviewPlugin$8 {
+    /** Unique plugin identifier */
+    id: string;
+    /** Human-readable plugin name */
+    name: string;
+    /** File extensions this plugin handles (e.g., ['.pdf']) */
+    extensions: string[];
+    /** MIME types this plugin handles */
+    mimeTypes: string[];
+    /** Priority when multiple plugins match (higher = preferred) */
+    weight?: number;
+    /** Check if this plugin can handle the given file */
+    supports(file: FileInfo$8): boolean | Promise<boolean>;
+    /** Return toolbar actions for the rendered instance */
+    getToolbarActions(instance: PreviewInstance$8): ToolbarAction$8[];
+    /** Render the file into the container */
+    render(ctx: RenderContext$8): Promise<PreviewInstance$8>;
+}
+/** Configuration to selectively enable or disable individual toolbar functions/buttons */
+interface ToolbarConfig$8 {
+    /** Page navigation (< [1] / N >) */
+    pageNav?: boolean;
+    pagination?: boolean;
+    prevPage?: boolean;
+    nextPage?: boolean;
+    /** Zoom controls */
+    zoomIn?: boolean;
+    zoomOut?: boolean;
+    fitPage?: boolean;
+    fitToPage?: boolean;
+    fitWidth?: boolean;
+    zoomReset?: boolean;
+    /** View controls */
+    rotate?: boolean;
+    rotateCW?: boolean;
+    rotateCCW?: boolean;
+    fullscreen?: boolean;
+    thumbnails?: boolean;
+    /** Action controls */
+    download?: boolean;
+    print?: boolean;
+    openWindow?: boolean;
+    openSeparateWindow?: boolean;
+    copy?: boolean;
+    /** Media controls */
+    play?: boolean;
+    pause?: boolean;
+    fastForward?: boolean;
+    rewind?: boolean;
+    speed?: boolean;
+}
+/** Viewer configuration options */
+interface PreviewViewerOptions$8 extends ToolbarConfig$8 {
+    /** Color theme */
+    theme?: 'light' | 'dark' | 'auto';
+    /** Locale for UI labels */
+    locale?: string;
+    /** Initial zoom level (1.0 = 100%) */
+    zoom?: number;
+    /** Initial page number (1-based) */
+    page?: number;
+    /** Show the toolbar */
+    showToolbar?: boolean;
+    /** Detailed toolbar configuration (or boolean to show/hide entire toolbar) */
+    toolbar?: boolean | (ToolbarConfig$8 & Record<string, boolean | undefined>);
+    /** Toolbar position */
+    toolbarPosition?: 'top' | 'bottom';
+    /** Fit mode: 'page' (fill frame width with minimal margins) or 'width' */
+    fitMode?: 'page' | 'width';
+    /** Show thumbnail sidebar initially */
+    showThumbnails?: boolean;
+    /** Whether to display the file name / title bar above the toolbar in the preview panel (defaults to true) */
+    showFileName?: boolean;
+    /** Custom file name / title override to display */
+    fileName?: string;
+    /** Custom CSS class for the container */
+    className?: string;
+    /** Plugin-specific options */
+    pluginOptions?: Record<string, unknown>;
+    /** Optional file metadata overrides (name, extension, mimeType, etc.) */
+    metadata?: FileMetadata$8;
+    /** Custom URL to navigate when "Open in Separate Full Window" is clicked */
+    standaloneViewerUrl?: string;
+    /** Custom handler for opening preview in a separate window */
+    onOpenSeparateWindow?: (payload: {
+        buffer: ArrayBuffer;
+        metadata: FileMetadata$8;
+        options: PreviewViewerOptions$8;
+    }) => Window | null;
+    /** Internal flag: true when viewer is rendered inside separate full window */
+    _isSeparateWindow?: boolean;
+    /** Allow custom/plugin-specific options */
+    [key: string]: unknown;
+}
+
+declare class ArchivePlugin implements PreviewPlugin$8 {
+    id: string;
+    name: string;
+    extensions: string[];
+    mimeTypes: string[];
+    weight: number;
+    supports(file: FileInfo$8): boolean;
+    getToolbarActions(instance: PreviewInstance$8): ToolbarAction$8[];
+    render(ctx: RenderContext$8): Promise<PreviewInstance$8>;
+}
+declare function archivePlugin(): ArchivePlugin;
+
+/**
+ * Supported file input sources.
+ * Accepts URL strings, File objects, Blobs, ArrayBuffers, or Uint8Arrays.
+ */
+type FileSource$7 = string | File | Blob | ArrayBuffer | Uint8Array;
+/** Metadata extracted from a file source */
+interface FileMetadata$7 {
+    /** Original filename (if available) */
+    name?: string;
+    /** File size in bytes */
+    size?: number;
+    /** Detected MIME type */
+    mimeType?: string;
+    /** File extension (lowercase, with dot, e.g. '.pdf') */
+    extension?: string;
+}
+/** Information about a resolved file, ready for plugin matching */
+interface FileInfo$7 {
+    metadata: FileMetadata$7;
+    buffer: ArrayBuffer;
+}
+/** Toolbar action types */
+type ToolbarActionType$7 = 'button' | 'toggle' | 'range' | 'input' | 'separator' | 'page-nav';
+/** Toolbar action group names for visual grouping */
+type ToolbarGroup$7 = 'navigation' | 'zoom' | 'view' | 'actions';
+/** Represents a single toolbar action/control */
+interface ToolbarAction$7 {
+    /** Unique action identifier */
+    id: string;
+    /** SVG icon markup string */
+    icon: string;
+    /** Accessible label */
+    label: string;
+    /** Type of control to render */
+    type: ToolbarActionType$7;
+    /** Visual group placement */
+    group: ToolbarGroup$7;
+    /** Whether the action is currently enabled */
+    enabled?: boolean;
+    /** Whether a toggle is currently active */
+    active?: boolean;
+    /** Execute the action */
+    execute: (...args: unknown[]) => void;
+    /** For 'range' type: min/max/step/value */
+    min?: number;
+    max?: number;
+    step?: number;
+    value?: number;
+}
+/** Represents a thumbnail in the sidebar */
+interface Thumbnail$7 {
+    /** Page/sheet/frame index */
+    index: number;
+    /** Display label (e.g., "Page 1", "Sheet: Revenue") */
+    label: string;
+    /** Renders the thumbnail into a canvas element */
+    render: (canvas: HTMLCanvasElement) => Promise<void>;
+}
+/** Instance returned after a file is rendered — exposes controls */
+interface PreviewInstance$7 {
+    /** Clean up all resources */
+    destroy(): void;
+    zoomIn?(): void;
+    zoomOut?(): void;
+    getZoom?(): number;
+    setZoom?(level: number): void;
+    fitToPage?(): void;
+    fitToWidth?(): void;
+    goToPage?(page: number): void;
+    getPageCount?(): number;
+    getCurrentPage?(): number;
+    rotateCW?(): void;
+    rotateCCW?(): void;
+    getRotation?(): number;
+    play?(): void;
+    pause?(): void;
+    isPlaying?(): boolean;
+    fastForward?(seconds?: number): void;
+    rewind?(seconds?: number): void;
+    setPlaybackRate?(rate: number): void;
+    getPlaybackRate?(): number;
+    getThumbnails?(): Thumbnail$7[] | Promise<Thumbnail$7[]>;
+    toggleThumbnails?(): void;
+    download?(): void;
+    print?(): void;
+    [key: string]: unknown;
+}
+/** Context passed to a plugin's render function */
+interface RenderContext$7 {
+    /** The container DOM element to render into */
+    container: HTMLElement;
+    /** Original file source */
+    source: FileSource$7;
+    /** Resolved file metadata */
+    metadata: FileMetadata$7;
+    /** File content as ArrayBuffer */
+    buffer: ArrayBuffer;
+    /** Viewer options */
+    options: PreviewViewerOptions$7;
+    /** AbortSignal for cancellation */
+    signal: AbortSignal;
+    /** Emit an event to the viewer */
+    emit: (event: string, payload?: unknown) => void;
+}
+/** Plugin interface — each file format renderer implements this */
+interface PreviewPlugin$7 {
+    /** Unique plugin identifier */
+    id: string;
+    /** Human-readable plugin name */
+    name: string;
+    /** File extensions this plugin handles (e.g., ['.pdf']) */
+    extensions: string[];
+    /** MIME types this plugin handles */
+    mimeTypes: string[];
+    /** Priority when multiple plugins match (higher = preferred) */
+    weight?: number;
+    /** Check if this plugin can handle the given file */
+    supports(file: FileInfo$7): boolean | Promise<boolean>;
+    /** Return toolbar actions for the rendered instance */
+    getToolbarActions(instance: PreviewInstance$7): ToolbarAction$7[];
+    /** Render the file into the container */
+    render(ctx: RenderContext$7): Promise<PreviewInstance$7>;
+}
+/** Configuration to selectively enable or disable individual toolbar functions/buttons */
+interface ToolbarConfig$7 {
+    /** Page navigation (< [1] / N >) */
+    pageNav?: boolean;
+    pagination?: boolean;
+    prevPage?: boolean;
+    nextPage?: boolean;
+    /** Zoom controls */
+    zoomIn?: boolean;
+    zoomOut?: boolean;
+    fitPage?: boolean;
+    fitToPage?: boolean;
+    fitWidth?: boolean;
+    zoomReset?: boolean;
+    /** View controls */
+    rotate?: boolean;
+    rotateCW?: boolean;
+    rotateCCW?: boolean;
+    fullscreen?: boolean;
+    thumbnails?: boolean;
+    /** Action controls */
+    download?: boolean;
+    print?: boolean;
+    openWindow?: boolean;
+    openSeparateWindow?: boolean;
+    copy?: boolean;
+    /** Media controls */
+    play?: boolean;
+    pause?: boolean;
+    fastForward?: boolean;
+    rewind?: boolean;
+    speed?: boolean;
+}
+/** Viewer configuration options */
+interface PreviewViewerOptions$7 extends ToolbarConfig$7 {
+    /** Color theme */
+    theme?: 'light' | 'dark' | 'auto';
+    /** Locale for UI labels */
+    locale?: string;
+    /** Initial zoom level (1.0 = 100%) */
+    zoom?: number;
+    /** Initial page number (1-based) */
+    page?: number;
+    /** Show the toolbar */
+    showToolbar?: boolean;
+    /** Detailed toolbar configuration (or boolean to show/hide entire toolbar) */
+    toolbar?: boolean | (ToolbarConfig$7 & Record<string, boolean | undefined>);
+    /** Toolbar position */
+    toolbarPosition?: 'top' | 'bottom';
+    /** Fit mode: 'page' (fill frame width with minimal margins) or 'width' */
+    fitMode?: 'page' | 'width';
+    /** Show thumbnail sidebar initially */
+    showThumbnails?: boolean;
+    /** Whether to display the file name / title bar above the toolbar in the preview panel (defaults to true) */
+    showFileName?: boolean;
+    /** Custom file name / title override to display */
+    fileName?: string;
+    /** Custom CSS class for the container */
+    className?: string;
+    /** Plugin-specific options */
+    pluginOptions?: Record<string, unknown>;
+    /** Optional file metadata overrides (name, extension, mimeType, etc.) */
+    metadata?: FileMetadata$7;
+    /** Custom URL to navigate when "Open in Separate Full Window" is clicked */
+    standaloneViewerUrl?: string;
+    /** Custom handler for opening preview in a separate window */
+    onOpenSeparateWindow?: (payload: {
+        buffer: ArrayBuffer;
+        metadata: FileMetadata$7;
+        options: PreviewViewerOptions$7;
+    }) => Window | null;
+    /** Internal flag: true when viewer is rendered inside separate full window */
+    _isSeparateWindow?: boolean;
+    /** Allow custom/plugin-specific options */
+    [key: string]: unknown;
+}
+
+declare class MarkdownPlugin implements PreviewPlugin$7 {
+    id: string;
+    name: string;
+    extensions: string[];
+    mimeTypes: string[];
+    weight: number;
+    supports(file: FileInfo$7): boolean;
+    getToolbarActions(instance: PreviewInstance$7): ToolbarAction$7[];
+    render(ctx: RenderContext$7): Promise<PreviewInstance$7>;
+}
+declare function markdownPlugin(): MarkdownPlugin;
+
+/**
+ * Supported file input sources.
+ * Accepts URL strings, File objects, Blobs, ArrayBuffers, or Uint8Arrays.
+ */
+type FileSource$6 = string | File | Blob | ArrayBuffer | Uint8Array;
+/** Metadata extracted from a file source */
+interface FileMetadata$6 {
+    /** Original filename (if available) */
+    name?: string;
+    /** File size in bytes */
+    size?: number;
+    /** Detected MIME type */
+    mimeType?: string;
+    /** File extension (lowercase, with dot, e.g. '.pdf') */
+    extension?: string;
+}
+/** Information about a resolved file, ready for plugin matching */
+interface FileInfo$6 {
+    metadata: FileMetadata$6;
+    buffer: ArrayBuffer;
+}
+/** Toolbar action types */
+type ToolbarActionType$6 = 'button' | 'toggle' | 'range' | 'input' | 'separator' | 'page-nav';
+/** Toolbar action group names for visual grouping */
+type ToolbarGroup$6 = 'navigation' | 'zoom' | 'view' | 'actions';
+/** Represents a single toolbar action/control */
+interface ToolbarAction$6 {
+    /** Unique action identifier */
+    id: string;
+    /** SVG icon markup string */
+    icon: string;
+    /** Accessible label */
+    label: string;
+    /** Type of control to render */
+    type: ToolbarActionType$6;
+    /** Visual group placement */
+    group: ToolbarGroup$6;
+    /** Whether the action is currently enabled */
+    enabled?: boolean;
+    /** Whether a toggle is currently active */
+    active?: boolean;
+    /** Execute the action */
+    execute: (...args: unknown[]) => void;
+    /** For 'range' type: min/max/step/value */
+    min?: number;
+    max?: number;
+    step?: number;
+    value?: number;
+}
+/** Represents a thumbnail in the sidebar */
+interface Thumbnail$6 {
+    /** Page/sheet/frame index */
+    index: number;
+    /** Display label (e.g., "Page 1", "Sheet: Revenue") */
+    label: string;
+    /** Renders the thumbnail into a canvas element */
+    render: (canvas: HTMLCanvasElement) => Promise<void>;
+}
+/** Instance returned after a file is rendered — exposes controls */
+interface PreviewInstance$6 {
+    /** Clean up all resources */
+    destroy(): void;
+    zoomIn?(): void;
+    zoomOut?(): void;
+    getZoom?(): number;
+    setZoom?(level: number): void;
+    fitToPage?(): void;
+    fitToWidth?(): void;
+    goToPage?(page: number): void;
+    getPageCount?(): number;
+    getCurrentPage?(): number;
+    rotateCW?(): void;
+    rotateCCW?(): void;
+    getRotation?(): number;
+    play?(): void;
+    pause?(): void;
+    isPlaying?(): boolean;
+    fastForward?(seconds?: number): void;
+    rewind?(seconds?: number): void;
+    setPlaybackRate?(rate: number): void;
+    getPlaybackRate?(): number;
+    getThumbnails?(): Thumbnail$6[] | Promise<Thumbnail$6[]>;
+    toggleThumbnails?(): void;
+    download?(): void;
+    print?(): void;
+    [key: string]: unknown;
+}
+/** Context passed to a plugin's render function */
+interface RenderContext$6 {
+    /** The container DOM element to render into */
+    container: HTMLElement;
+    /** Original file source */
+    source: FileSource$6;
+    /** Resolved file metadata */
+    metadata: FileMetadata$6;
+    /** File content as ArrayBuffer */
+    buffer: ArrayBuffer;
+    /** Viewer options */
+    options: PreviewViewerOptions$6;
+    /** AbortSignal for cancellation */
+    signal: AbortSignal;
+    /** Emit an event to the viewer */
+    emit: (event: string, payload?: unknown) => void;
+}
+/** Plugin interface — each file format renderer implements this */
+interface PreviewPlugin$6 {
+    /** Unique plugin identifier */
+    id: string;
+    /** Human-readable plugin name */
+    name: string;
+    /** File extensions this plugin handles (e.g., ['.pdf']) */
+    extensions: string[];
+    /** MIME types this plugin handles */
+    mimeTypes: string[];
+    /** Priority when multiple plugins match (higher = preferred) */
+    weight?: number;
+    /** Check if this plugin can handle the given file */
+    supports(file: FileInfo$6): boolean | Promise<boolean>;
+    /** Return toolbar actions for the rendered instance */
+    getToolbarActions(instance: PreviewInstance$6): ToolbarAction$6[];
+    /** Render the file into the container */
+    render(ctx: RenderContext$6): Promise<PreviewInstance$6>;
+}
+/** Configuration to selectively enable or disable individual toolbar functions/buttons */
+interface ToolbarConfig$6 {
+    /** Page navigation (< [1] / N >) */
+    pageNav?: boolean;
+    pagination?: boolean;
+    prevPage?: boolean;
+    nextPage?: boolean;
+    /** Zoom controls */
+    zoomIn?: boolean;
+    zoomOut?: boolean;
+    fitPage?: boolean;
+    fitToPage?: boolean;
+    fitWidth?: boolean;
+    zoomReset?: boolean;
+    /** View controls */
+    rotate?: boolean;
+    rotateCW?: boolean;
+    rotateCCW?: boolean;
+    fullscreen?: boolean;
+    thumbnails?: boolean;
+    /** Action controls */
+    download?: boolean;
+    print?: boolean;
+    openWindow?: boolean;
+    openSeparateWindow?: boolean;
+    copy?: boolean;
+    /** Media controls */
+    play?: boolean;
+    pause?: boolean;
+    fastForward?: boolean;
+    rewind?: boolean;
+    speed?: boolean;
+}
+/** Viewer configuration options */
+interface PreviewViewerOptions$6 extends ToolbarConfig$6 {
+    /** Color theme */
+    theme?: 'light' | 'dark' | 'auto';
+    /** Locale for UI labels */
+    locale?: string;
+    /** Initial zoom level (1.0 = 100%) */
+    zoom?: number;
+    /** Initial page number (1-based) */
+    page?: number;
+    /** Show the toolbar */
+    showToolbar?: boolean;
+    /** Detailed toolbar configuration (or boolean to show/hide entire toolbar) */
+    toolbar?: boolean | (ToolbarConfig$6 & Record<string, boolean | undefined>);
+    /** Toolbar position */
+    toolbarPosition?: 'top' | 'bottom';
+    /** Fit mode: 'page' (fill frame width with minimal margins) or 'width' */
+    fitMode?: 'page' | 'width';
+    /** Show thumbnail sidebar initially */
+    showThumbnails?: boolean;
+    /** Whether to display the file name / title bar above the toolbar in the preview panel (defaults to true) */
+    showFileName?: boolean;
+    /** Custom file name / title override to display */
+    fileName?: string;
+    /** Custom CSS class for the container */
+    className?: string;
+    /** Plugin-specific options */
+    pluginOptions?: Record<string, unknown>;
+    /** Optional file metadata overrides (name, extension, mimeType, etc.) */
+    metadata?: FileMetadata$6;
+    /** Custom URL to navigate when "Open in Separate Full Window" is clicked */
+    standaloneViewerUrl?: string;
+    /** Custom handler for opening preview in a separate window */
+    onOpenSeparateWindow?: (payload: {
+        buffer: ArrayBuffer;
+        metadata: FileMetadata$6;
+        options: PreviewViewerOptions$6;
+    }) => Window | null;
+    /** Internal flag: true when viewer is rendered inside separate full window */
+    _isSeparateWindow?: boolean;
+    /** Allow custom/plugin-specific options */
+    [key: string]: unknown;
+}
+
+declare class PptxPlugin implements PreviewPlugin$6 {
+    id: string;
+    name: string;
+    extensions: string[];
+    mimeTypes: string[];
+    weight: number;
+    supports(file: FileInfo$6): boolean;
+    getToolbarActions(instance: PreviewInstance$6): ToolbarAction$6[];
+    render(ctx: RenderContext$6): Promise<PreviewInstance$6>;
+}
+declare function pptxPlugin(): PptxPlugin;
+
+/**
+ * Supported file input sources.
+ * Accepts URL strings, File objects, Blobs, ArrayBuffers, or Uint8Arrays.
+ */
+type FileSource$5 = string | File | Blob | ArrayBuffer | Uint8Array;
+/** Metadata extracted from a file source */
+interface FileMetadata$5 {
+    /** Original filename (if available) */
+    name?: string;
+    /** File size in bytes */
+    size?: number;
+    /** Detected MIME type */
+    mimeType?: string;
+    /** File extension (lowercase, with dot, e.g. '.pdf') */
+    extension?: string;
+}
+/** Information about a resolved file, ready for plugin matching */
+interface FileInfo$5 {
+    metadata: FileMetadata$5;
+    buffer: ArrayBuffer;
+}
+/** Toolbar action types */
+type ToolbarActionType$5 = 'button' | 'toggle' | 'range' | 'input' | 'separator' | 'page-nav';
+/** Toolbar action group names for visual grouping */
+type ToolbarGroup$5 = 'navigation' | 'zoom' | 'view' | 'actions';
+/** Represents a single toolbar action/control */
+interface ToolbarAction$5 {
+    /** Unique action identifier */
+    id: string;
+    /** SVG icon markup string */
+    icon: string;
+    /** Accessible label */
+    label: string;
+    /** Type of control to render */
+    type: ToolbarActionType$5;
+    /** Visual group placement */
+    group: ToolbarGroup$5;
+    /** Whether the action is currently enabled */
+    enabled?: boolean;
+    /** Whether a toggle is currently active */
+    active?: boolean;
+    /** Execute the action */
+    execute: (...args: unknown[]) => void;
+    /** For 'range' type: min/max/step/value */
+    min?: number;
+    max?: number;
+    step?: number;
+    value?: number;
+}
+/** Represents a thumbnail in the sidebar */
+interface Thumbnail$5 {
+    /** Page/sheet/frame index */
+    index: number;
+    /** Display label (e.g., "Page 1", "Sheet: Revenue") */
+    label: string;
+    /** Renders the thumbnail into a canvas element */
+    render: (canvas: HTMLCanvasElement) => Promise<void>;
+}
+/** Instance returned after a file is rendered — exposes controls */
+interface PreviewInstance$5 {
+    /** Clean up all resources */
+    destroy(): void;
+    zoomIn?(): void;
+    zoomOut?(): void;
+    getZoom?(): number;
+    setZoom?(level: number): void;
+    fitToPage?(): void;
+    fitToWidth?(): void;
+    goToPage?(page: number): void;
+    getPageCount?(): number;
+    getCurrentPage?(): number;
+    rotateCW?(): void;
+    rotateCCW?(): void;
+    getRotation?(): number;
+    play?(): void;
+    pause?(): void;
+    isPlaying?(): boolean;
+    fastForward?(seconds?: number): void;
+    rewind?(seconds?: number): void;
+    setPlaybackRate?(rate: number): void;
+    getPlaybackRate?(): number;
+    getThumbnails?(): Thumbnail$5[] | Promise<Thumbnail$5[]>;
+    toggleThumbnails?(): void;
+    download?(): void;
+    print?(): void;
+    [key: string]: unknown;
+}
+/** Context passed to a plugin's render function */
+interface RenderContext$5 {
+    /** The container DOM element to render into */
+    container: HTMLElement;
+    /** Original file source */
+    source: FileSource$5;
+    /** Resolved file metadata */
+    metadata: FileMetadata$5;
+    /** File content as ArrayBuffer */
+    buffer: ArrayBuffer;
+    /** Viewer options */
+    options: PreviewViewerOptions$5;
+    /** AbortSignal for cancellation */
+    signal: AbortSignal;
+    /** Emit an event to the viewer */
+    emit: (event: string, payload?: unknown) => void;
+}
+/** Plugin interface — each file format renderer implements this */
+interface PreviewPlugin$5 {
+    /** Unique plugin identifier */
+    id: string;
+    /** Human-readable plugin name */
+    name: string;
+    /** File extensions this plugin handles (e.g., ['.pdf']) */
+    extensions: string[];
+    /** MIME types this plugin handles */
+    mimeTypes: string[];
+    /** Priority when multiple plugins match (higher = preferred) */
+    weight?: number;
+    /** Check if this plugin can handle the given file */
+    supports(file: FileInfo$5): boolean | Promise<boolean>;
+    /** Return toolbar actions for the rendered instance */
+    getToolbarActions(instance: PreviewInstance$5): ToolbarAction$5[];
+    /** Render the file into the container */
+    render(ctx: RenderContext$5): Promise<PreviewInstance$5>;
+}
+/** Configuration to selectively enable or disable individual toolbar functions/buttons */
+interface ToolbarConfig$5 {
+    /** Page navigation (< [1] / N >) */
+    pageNav?: boolean;
+    pagination?: boolean;
+    prevPage?: boolean;
+    nextPage?: boolean;
+    /** Zoom controls */
+    zoomIn?: boolean;
+    zoomOut?: boolean;
+    fitPage?: boolean;
+    fitToPage?: boolean;
+    fitWidth?: boolean;
+    zoomReset?: boolean;
+    /** View controls */
+    rotate?: boolean;
+    rotateCW?: boolean;
+    rotateCCW?: boolean;
+    fullscreen?: boolean;
+    thumbnails?: boolean;
+    /** Action controls */
+    download?: boolean;
+    print?: boolean;
+    openWindow?: boolean;
+    openSeparateWindow?: boolean;
+    copy?: boolean;
+    /** Media controls */
+    play?: boolean;
+    pause?: boolean;
+    fastForward?: boolean;
+    rewind?: boolean;
+    speed?: boolean;
+}
+/** Viewer configuration options */
+interface PreviewViewerOptions$5 extends ToolbarConfig$5 {
+    /** Color theme */
+    theme?: 'light' | 'dark' | 'auto';
+    /** Locale for UI labels */
+    locale?: string;
+    /** Initial zoom level (1.0 = 100%) */
+    zoom?: number;
+    /** Initial page number (1-based) */
+    page?: number;
+    /** Show the toolbar */
+    showToolbar?: boolean;
+    /** Detailed toolbar configuration (or boolean to show/hide entire toolbar) */
+    toolbar?: boolean | (ToolbarConfig$5 & Record<string, boolean | undefined>);
+    /** Toolbar position */
+    toolbarPosition?: 'top' | 'bottom';
+    /** Fit mode: 'page' (fill frame width with minimal margins) or 'width' */
+    fitMode?: 'page' | 'width';
+    /** Show thumbnail sidebar initially */
+    showThumbnails?: boolean;
+    /** Whether to display the file name / title bar above the toolbar in the preview panel (defaults to true) */
+    showFileName?: boolean;
+    /** Custom file name / title override to display */
+    fileName?: string;
+    /** Custom CSS class for the container */
+    className?: string;
+    /** Plugin-specific options */
+    pluginOptions?: Record<string, unknown>;
+    /** Optional file metadata overrides (name, extension, mimeType, etc.) */
+    metadata?: FileMetadata$5;
+    /** Custom URL to navigate when "Open in Separate Full Window" is clicked */
+    standaloneViewerUrl?: string;
+    /** Custom handler for opening preview in a separate window */
+    onOpenSeparateWindow?: (payload: {
+        buffer: ArrayBuffer;
+        metadata: FileMetadata$5;
+        options: PreviewViewerOptions$5;
+    }) => Window | null;
+    /** Internal flag: true when viewer is rendered inside separate full window */
+    _isSeparateWindow?: boolean;
+    /** Allow custom/plugin-specific options */
+    [key: string]: unknown;
+}
+
+declare class ThreeDPlugin implements PreviewPlugin$5 {
+    id: string;
+    name: string;
+    extensions: string[];
+    mimeTypes: string[];
+    weight: number;
+    supports(file: FileInfo$5): boolean;
+    getToolbarActions(instance: PreviewInstance$5): ToolbarAction$5[];
+    render(ctx: RenderContext$5): Promise<PreviewInstance$5>;
+}
+declare function threeDPlugin(): ThreeDPlugin;
+
+/**
+ * Supported file input sources.
+ * Accepts URL strings, File objects, Blobs, ArrayBuffers, or Uint8Arrays.
+ */
+type FileSource$4 = string | File | Blob | ArrayBuffer | Uint8Array;
+/** Metadata extracted from a file source */
+interface FileMetadata$4 {
+    /** Original filename (if available) */
+    name?: string;
+    /** File size in bytes */
+    size?: number;
+    /** Detected MIME type */
+    mimeType?: string;
+    /** File extension (lowercase, with dot, e.g. '.pdf') */
+    extension?: string;
+}
+/** Information about a resolved file, ready for plugin matching */
+interface FileInfo$4 {
+    metadata: FileMetadata$4;
+    buffer: ArrayBuffer;
+}
+/** Toolbar action types */
+type ToolbarActionType$4 = 'button' | 'toggle' | 'range' | 'input' | 'separator' | 'page-nav';
+/** Toolbar action group names for visual grouping */
+type ToolbarGroup$4 = 'navigation' | 'zoom' | 'view' | 'actions';
+/** Represents a single toolbar action/control */
+interface ToolbarAction$4 {
+    /** Unique action identifier */
+    id: string;
+    /** SVG icon markup string */
+    icon: string;
+    /** Accessible label */
+    label: string;
+    /** Type of control to render */
+    type: ToolbarActionType$4;
+    /** Visual group placement */
+    group: ToolbarGroup$4;
+    /** Whether the action is currently enabled */
+    enabled?: boolean;
+    /** Whether a toggle is currently active */
+    active?: boolean;
+    /** Execute the action */
+    execute: (...args: unknown[]) => void;
+    /** For 'range' type: min/max/step/value */
+    min?: number;
+    max?: number;
+    step?: number;
+    value?: number;
+}
+/** Represents a thumbnail in the sidebar */
+interface Thumbnail$4 {
+    /** Page/sheet/frame index */
+    index: number;
+    /** Display label (e.g., "Page 1", "Sheet: Revenue") */
+    label: string;
+    /** Renders the thumbnail into a canvas element */
+    render: (canvas: HTMLCanvasElement) => Promise<void>;
+}
+/** Instance returned after a file is rendered — exposes controls */
+interface PreviewInstance$4 {
+    /** Clean up all resources */
+    destroy(): void;
+    zoomIn?(): void;
+    zoomOut?(): void;
+    getZoom?(): number;
+    setZoom?(level: number): void;
+    fitToPage?(): void;
+    fitToWidth?(): void;
+    goToPage?(page: number): void;
+    getPageCount?(): number;
+    getCurrentPage?(): number;
+    rotateCW?(): void;
+    rotateCCW?(): void;
+    getRotation?(): number;
+    play?(): void;
+    pause?(): void;
+    isPlaying?(): boolean;
+    fastForward?(seconds?: number): void;
+    rewind?(seconds?: number): void;
+    setPlaybackRate?(rate: number): void;
+    getPlaybackRate?(): number;
+    getThumbnails?(): Thumbnail$4[] | Promise<Thumbnail$4[]>;
+    toggleThumbnails?(): void;
+    download?(): void;
+    print?(): void;
+    [key: string]: unknown;
+}
+/** Context passed to a plugin's render function */
+interface RenderContext$4 {
+    /** The container DOM element to render into */
+    container: HTMLElement;
+    /** Original file source */
+    source: FileSource$4;
+    /** Resolved file metadata */
+    metadata: FileMetadata$4;
+    /** File content as ArrayBuffer */
+    buffer: ArrayBuffer;
+    /** Viewer options */
+    options: PreviewViewerOptions$4;
+    /** AbortSignal for cancellation */
+    signal: AbortSignal;
+    /** Emit an event to the viewer */
+    emit: (event: string, payload?: unknown) => void;
+}
+/** Plugin interface — each file format renderer implements this */
+interface PreviewPlugin$4 {
+    /** Unique plugin identifier */
+    id: string;
+    /** Human-readable plugin name */
+    name: string;
+    /** File extensions this plugin handles (e.g., ['.pdf']) */
+    extensions: string[];
+    /** MIME types this plugin handles */
+    mimeTypes: string[];
+    /** Priority when multiple plugins match (higher = preferred) */
+    weight?: number;
+    /** Check if this plugin can handle the given file */
+    supports(file: FileInfo$4): boolean | Promise<boolean>;
+    /** Return toolbar actions for the rendered instance */
+    getToolbarActions(instance: PreviewInstance$4): ToolbarAction$4[];
+    /** Render the file into the container */
+    render(ctx: RenderContext$4): Promise<PreviewInstance$4>;
+}
+/** Configuration to selectively enable or disable individual toolbar functions/buttons */
+interface ToolbarConfig$4 {
+    /** Page navigation (< [1] / N >) */
+    pageNav?: boolean;
+    pagination?: boolean;
+    prevPage?: boolean;
+    nextPage?: boolean;
+    /** Zoom controls */
+    zoomIn?: boolean;
+    zoomOut?: boolean;
+    fitPage?: boolean;
+    fitToPage?: boolean;
+    fitWidth?: boolean;
+    zoomReset?: boolean;
+    /** View controls */
+    rotate?: boolean;
+    rotateCW?: boolean;
+    rotateCCW?: boolean;
+    fullscreen?: boolean;
+    thumbnails?: boolean;
+    /** Action controls */
+    download?: boolean;
+    print?: boolean;
+    openWindow?: boolean;
+    openSeparateWindow?: boolean;
+    copy?: boolean;
+    /** Media controls */
+    play?: boolean;
+    pause?: boolean;
+    fastForward?: boolean;
+    rewind?: boolean;
+    speed?: boolean;
+}
+/** Viewer configuration options */
+interface PreviewViewerOptions$4 extends ToolbarConfig$4 {
+    /** Color theme */
+    theme?: 'light' | 'dark' | 'auto';
+    /** Locale for UI labels */
+    locale?: string;
+    /** Initial zoom level (1.0 = 100%) */
+    zoom?: number;
+    /** Initial page number (1-based) */
+    page?: number;
+    /** Show the toolbar */
+    showToolbar?: boolean;
+    /** Detailed toolbar configuration (or boolean to show/hide entire toolbar) */
+    toolbar?: boolean | (ToolbarConfig$4 & Record<string, boolean | undefined>);
+    /** Toolbar position */
+    toolbarPosition?: 'top' | 'bottom';
+    /** Fit mode: 'page' (fill frame width with minimal margins) or 'width' */
+    fitMode?: 'page' | 'width';
+    /** Show thumbnail sidebar initially */
+    showThumbnails?: boolean;
+    /** Whether to display the file name / title bar above the toolbar in the preview panel (defaults to true) */
+    showFileName?: boolean;
+    /** Custom file name / title override to display */
+    fileName?: string;
+    /** Custom CSS class for the container */
+    className?: string;
+    /** Plugin-specific options */
+    pluginOptions?: Record<string, unknown>;
+    /** Optional file metadata overrides (name, extension, mimeType, etc.) */
+    metadata?: FileMetadata$4;
+    /** Custom URL to navigate when "Open in Separate Full Window" is clicked */
+    standaloneViewerUrl?: string;
+    /** Custom handler for opening preview in a separate window */
+    onOpenSeparateWindow?: (payload: {
+        buffer: ArrayBuffer;
+        metadata: FileMetadata$4;
+        options: PreviewViewerOptions$4;
+    }) => Window | null;
+    /** Internal flag: true when viewer is rendered inside separate full window */
+    _isSeparateWindow?: boolean;
+    /** Allow custom/plugin-specific options */
+    [key: string]: unknown;
+}
+
+declare class RtfPlugin implements PreviewPlugin$4 {
+    id: string;
+    name: string;
+    extensions: string[];
+    mimeTypes: string[];
+    weight: number;
+    supports(file: FileInfo$4): boolean;
+    getToolbarActions(instance: PreviewInstance$4): ToolbarAction$4[];
+    render(ctx: RenderContext$4): Promise<PreviewInstance$4>;
+}
+declare function rtfPlugin(): RtfPlugin;
+
+/**
+ * Supported file input sources.
+ * Accepts URL strings, File objects, Blobs, ArrayBuffers, or Uint8Arrays.
+ */
+type FileSource$3 = string | File | Blob | ArrayBuffer | Uint8Array;
+/** Metadata extracted from a file source */
+interface FileMetadata$3 {
+    /** Original filename (if available) */
+    name?: string;
+    /** File size in bytes */
+    size?: number;
+    /** Detected MIME type */
+    mimeType?: string;
+    /** File extension (lowercase, with dot, e.g. '.pdf') */
+    extension?: string;
+}
+/** Information about a resolved file, ready for plugin matching */
+interface FileInfo$3 {
+    metadata: FileMetadata$3;
+    buffer: ArrayBuffer;
+}
+/** Toolbar action types */
+type ToolbarActionType$3 = 'button' | 'toggle' | 'range' | 'input' | 'separator' | 'page-nav';
+/** Toolbar action group names for visual grouping */
+type ToolbarGroup$3 = 'navigation' | 'zoom' | 'view' | 'actions';
+/** Represents a single toolbar action/control */
+interface ToolbarAction$3 {
+    /** Unique action identifier */
+    id: string;
+    /** SVG icon markup string */
+    icon: string;
+    /** Accessible label */
+    label: string;
+    /** Type of control to render */
+    type: ToolbarActionType$3;
+    /** Visual group placement */
+    group: ToolbarGroup$3;
+    /** Whether the action is currently enabled */
+    enabled?: boolean;
+    /** Whether a toggle is currently active */
+    active?: boolean;
+    /** Execute the action */
+    execute: (...args: unknown[]) => void;
+    /** For 'range' type: min/max/step/value */
+    min?: number;
+    max?: number;
+    step?: number;
+    value?: number;
+}
+/** Represents a thumbnail in the sidebar */
+interface Thumbnail$3 {
+    /** Page/sheet/frame index */
+    index: number;
+    /** Display label (e.g., "Page 1", "Sheet: Revenue") */
+    label: string;
+    /** Renders the thumbnail into a canvas element */
+    render: (canvas: HTMLCanvasElement) => Promise<void>;
+}
+/** Instance returned after a file is rendered — exposes controls */
+interface PreviewInstance$3 {
+    /** Clean up all resources */
+    destroy(): void;
+    zoomIn?(): void;
+    zoomOut?(): void;
+    getZoom?(): number;
+    setZoom?(level: number): void;
+    fitToPage?(): void;
+    fitToWidth?(): void;
+    goToPage?(page: number): void;
+    getPageCount?(): number;
+    getCurrentPage?(): number;
+    rotateCW?(): void;
+    rotateCCW?(): void;
+    getRotation?(): number;
+    play?(): void;
+    pause?(): void;
+    isPlaying?(): boolean;
+    fastForward?(seconds?: number): void;
+    rewind?(seconds?: number): void;
+    setPlaybackRate?(rate: number): void;
+    getPlaybackRate?(): number;
+    getThumbnails?(): Thumbnail$3[] | Promise<Thumbnail$3[]>;
+    toggleThumbnails?(): void;
+    download?(): void;
+    print?(): void;
+    [key: string]: unknown;
+}
+/** Context passed to a plugin's render function */
+interface RenderContext$3 {
+    /** The container DOM element to render into */
+    container: HTMLElement;
+    /** Original file source */
+    source: FileSource$3;
+    /** Resolved file metadata */
+    metadata: FileMetadata$3;
+    /** File content as ArrayBuffer */
+    buffer: ArrayBuffer;
+    /** Viewer options */
+    options: PreviewViewerOptions$3;
+    /** AbortSignal for cancellation */
+    signal: AbortSignal;
+    /** Emit an event to the viewer */
+    emit: (event: string, payload?: unknown) => void;
+}
+/** Plugin interface — each file format renderer implements this */
+interface PreviewPlugin$3 {
+    /** Unique plugin identifier */
+    id: string;
+    /** Human-readable plugin name */
+    name: string;
+    /** File extensions this plugin handles (e.g., ['.pdf']) */
+    extensions: string[];
+    /** MIME types this plugin handles */
+    mimeTypes: string[];
+    /** Priority when multiple plugins match (higher = preferred) */
+    weight?: number;
+    /** Check if this plugin can handle the given file */
+    supports(file: FileInfo$3): boolean | Promise<boolean>;
+    /** Return toolbar actions for the rendered instance */
+    getToolbarActions(instance: PreviewInstance$3): ToolbarAction$3[];
+    /** Render the file into the container */
+    render(ctx: RenderContext$3): Promise<PreviewInstance$3>;
+}
+/** Configuration to selectively enable or disable individual toolbar functions/buttons */
+interface ToolbarConfig$3 {
+    /** Page navigation (< [1] / N >) */
+    pageNav?: boolean;
+    pagination?: boolean;
+    prevPage?: boolean;
+    nextPage?: boolean;
+    /** Zoom controls */
+    zoomIn?: boolean;
+    zoomOut?: boolean;
+    fitPage?: boolean;
+    fitToPage?: boolean;
+    fitWidth?: boolean;
+    zoomReset?: boolean;
+    /** View controls */
+    rotate?: boolean;
+    rotateCW?: boolean;
+    rotateCCW?: boolean;
+    fullscreen?: boolean;
+    thumbnails?: boolean;
+    /** Action controls */
+    download?: boolean;
+    print?: boolean;
+    openWindow?: boolean;
+    openSeparateWindow?: boolean;
+    copy?: boolean;
+    /** Media controls */
+    play?: boolean;
+    pause?: boolean;
+    fastForward?: boolean;
+    rewind?: boolean;
+    speed?: boolean;
+}
+/** Viewer configuration options */
+interface PreviewViewerOptions$3 extends ToolbarConfig$3 {
+    /** Color theme */
+    theme?: 'light' | 'dark' | 'auto';
+    /** Locale for UI labels */
+    locale?: string;
+    /** Initial zoom level (1.0 = 100%) */
+    zoom?: number;
+    /** Initial page number (1-based) */
+    page?: number;
+    /** Show the toolbar */
+    showToolbar?: boolean;
+    /** Detailed toolbar configuration (or boolean to show/hide entire toolbar) */
+    toolbar?: boolean | (ToolbarConfig$3 & Record<string, boolean | undefined>);
+    /** Toolbar position */
+    toolbarPosition?: 'top' | 'bottom';
+    /** Fit mode: 'page' (fill frame width with minimal margins) or 'width' */
+    fitMode?: 'page' | 'width';
+    /** Show thumbnail sidebar initially */
+    showThumbnails?: boolean;
+    /** Whether to display the file name / title bar above the toolbar in the preview panel (defaults to true) */
+    showFileName?: boolean;
+    /** Custom file name / title override to display */
+    fileName?: string;
+    /** Custom CSS class for the container */
+    className?: string;
+    /** Plugin-specific options */
+    pluginOptions?: Record<string, unknown>;
+    /** Optional file metadata overrides (name, extension, mimeType, etc.) */
+    metadata?: FileMetadata$3;
+    /** Custom URL to navigate when "Open in Separate Full Window" is clicked */
+    standaloneViewerUrl?: string;
+    /** Custom handler for opening preview in a separate window */
+    onOpenSeparateWindow?: (payload: {
+        buffer: ArrayBuffer;
+        metadata: FileMetadata$3;
+        options: PreviewViewerOptions$3;
+    }) => Window | null;
+    /** Internal flag: true when viewer is rendered inside separate full window */
+    _isSeparateWindow?: boolean;
+    /** Allow custom/plugin-specific options */
+    [key: string]: unknown;
+}
+
+declare class HtmlPreviewPlugin implements PreviewPlugin$3 {
+    id: string;
+    name: string;
+    extensions: string[];
+    mimeTypes: string[];
+    weight: number;
+    supports(file: FileInfo$3): boolean;
+    getToolbarActions(instance: PreviewInstance$3): ToolbarAction$3[];
+    render(ctx: RenderContext$3): Promise<PreviewInstance$3>;
+}
+declare function htmlPreviewPlugin(): HtmlPreviewPlugin;
+
+/**
+ * Supported file input sources.
+ * Accepts URL strings, File objects, Blobs, ArrayBuffers, or Uint8Arrays.
+ */
+type FileSource$2 = string | File | Blob | ArrayBuffer | Uint8Array;
+/** Metadata extracted from a file source */
+interface FileMetadata$2 {
+    /** Original filename (if available) */
+    name?: string;
+    /** File size in bytes */
+    size?: number;
+    /** Detected MIME type */
+    mimeType?: string;
+    /** File extension (lowercase, with dot, e.g. '.pdf') */
+    extension?: string;
+}
+/** Information about a resolved file, ready for plugin matching */
+interface FileInfo$2 {
+    metadata: FileMetadata$2;
+    buffer: ArrayBuffer;
+}
+/** Toolbar action types */
+type ToolbarActionType$2 = 'button' | 'toggle' | 'range' | 'input' | 'separator' | 'page-nav';
+/** Toolbar action group names for visual grouping */
+type ToolbarGroup$2 = 'navigation' | 'zoom' | 'view' | 'actions';
+/** Represents a single toolbar action/control */
+interface ToolbarAction$2 {
+    /** Unique action identifier */
+    id: string;
+    /** SVG icon markup string */
+    icon: string;
+    /** Accessible label */
+    label: string;
+    /** Type of control to render */
+    type: ToolbarActionType$2;
+    /** Visual group placement */
+    group: ToolbarGroup$2;
+    /** Whether the action is currently enabled */
+    enabled?: boolean;
+    /** Whether a toggle is currently active */
+    active?: boolean;
+    /** Execute the action */
+    execute: (...args: unknown[]) => void;
+    /** For 'range' type: min/max/step/value */
+    min?: number;
+    max?: number;
+    step?: number;
+    value?: number;
+}
+/** Represents a thumbnail in the sidebar */
+interface Thumbnail$2 {
+    /** Page/sheet/frame index */
+    index: number;
+    /** Display label (e.g., "Page 1", "Sheet: Revenue") */
+    label: string;
+    /** Renders the thumbnail into a canvas element */
+    render: (canvas: HTMLCanvasElement) => Promise<void>;
+}
+/** Instance returned after a file is rendered — exposes controls */
+interface PreviewInstance$2 {
+    /** Clean up all resources */
+    destroy(): void;
+    zoomIn?(): void;
+    zoomOut?(): void;
+    getZoom?(): number;
+    setZoom?(level: number): void;
+    fitToPage?(): void;
+    fitToWidth?(): void;
+    goToPage?(page: number): void;
+    getPageCount?(): number;
+    getCurrentPage?(): number;
+    rotateCW?(): void;
+    rotateCCW?(): void;
+    getRotation?(): number;
+    play?(): void;
+    pause?(): void;
+    isPlaying?(): boolean;
+    fastForward?(seconds?: number): void;
+    rewind?(seconds?: number): void;
+    setPlaybackRate?(rate: number): void;
+    getPlaybackRate?(): number;
+    getThumbnails?(): Thumbnail$2[] | Promise<Thumbnail$2[]>;
+    toggleThumbnails?(): void;
+    download?(): void;
+    print?(): void;
+    [key: string]: unknown;
+}
+/** Context passed to a plugin's render function */
+interface RenderContext$2 {
+    /** The container DOM element to render into */
+    container: HTMLElement;
+    /** Original file source */
+    source: FileSource$2;
+    /** Resolved file metadata */
+    metadata: FileMetadata$2;
+    /** File content as ArrayBuffer */
+    buffer: ArrayBuffer;
+    /** Viewer options */
+    options: PreviewViewerOptions$2;
+    /** AbortSignal for cancellation */
+    signal: AbortSignal;
+    /** Emit an event to the viewer */
+    emit: (event: string, payload?: unknown) => void;
+}
+/** Plugin interface — each file format renderer implements this */
+interface PreviewPlugin$2 {
+    /** Unique plugin identifier */
+    id: string;
+    /** Human-readable plugin name */
+    name: string;
+    /** File extensions this plugin handles (e.g., ['.pdf']) */
+    extensions: string[];
+    /** MIME types this plugin handles */
+    mimeTypes: string[];
+    /** Priority when multiple plugins match (higher = preferred) */
+    weight?: number;
+    /** Check if this plugin can handle the given file */
+    supports(file: FileInfo$2): boolean | Promise<boolean>;
+    /** Return toolbar actions for the rendered instance */
+    getToolbarActions(instance: PreviewInstance$2): ToolbarAction$2[];
+    /** Render the file into the container */
+    render(ctx: RenderContext$2): Promise<PreviewInstance$2>;
+}
+/** Configuration to selectively enable or disable individual toolbar functions/buttons */
+interface ToolbarConfig$2 {
+    /** Page navigation (< [1] / N >) */
+    pageNav?: boolean;
+    pagination?: boolean;
+    prevPage?: boolean;
+    nextPage?: boolean;
+    /** Zoom controls */
+    zoomIn?: boolean;
+    zoomOut?: boolean;
+    fitPage?: boolean;
+    fitToPage?: boolean;
+    fitWidth?: boolean;
+    zoomReset?: boolean;
+    /** View controls */
+    rotate?: boolean;
+    rotateCW?: boolean;
+    rotateCCW?: boolean;
+    fullscreen?: boolean;
+    thumbnails?: boolean;
+    /** Action controls */
+    download?: boolean;
+    print?: boolean;
+    openWindow?: boolean;
+    openSeparateWindow?: boolean;
+    copy?: boolean;
+    /** Media controls */
+    play?: boolean;
+    pause?: boolean;
+    fastForward?: boolean;
+    rewind?: boolean;
+    speed?: boolean;
+}
+/** Viewer configuration options */
+interface PreviewViewerOptions$2 extends ToolbarConfig$2 {
+    /** Color theme */
+    theme?: 'light' | 'dark' | 'auto';
+    /** Locale for UI labels */
+    locale?: string;
+    /** Initial zoom level (1.0 = 100%) */
+    zoom?: number;
+    /** Initial page number (1-based) */
+    page?: number;
+    /** Show the toolbar */
+    showToolbar?: boolean;
+    /** Detailed toolbar configuration (or boolean to show/hide entire toolbar) */
+    toolbar?: boolean | (ToolbarConfig$2 & Record<string, boolean | undefined>);
+    /** Toolbar position */
+    toolbarPosition?: 'top' | 'bottom';
+    /** Fit mode: 'page' (fill frame width with minimal margins) or 'width' */
+    fitMode?: 'page' | 'width';
+    /** Show thumbnail sidebar initially */
+    showThumbnails?: boolean;
+    /** Whether to display the file name / title bar above the toolbar in the preview panel (defaults to true) */
+    showFileName?: boolean;
+    /** Custom file name / title override to display */
+    fileName?: string;
+    /** Custom CSS class for the container */
+    className?: string;
+    /** Plugin-specific options */
+    pluginOptions?: Record<string, unknown>;
+    /** Optional file metadata overrides (name, extension, mimeType, etc.) */
+    metadata?: FileMetadata$2;
+    /** Custom URL to navigate when "Open in Separate Full Window" is clicked */
+    standaloneViewerUrl?: string;
+    /** Custom handler for opening preview in a separate window */
+    onOpenSeparateWindow?: (payload: {
+        buffer: ArrayBuffer;
+        metadata: FileMetadata$2;
+        options: PreviewViewerOptions$2;
+    }) => Window | null;
+    /** Internal flag: true when viewer is rendered inside separate full window */
+    _isSeparateWindow?: boolean;
+    /** Allow custom/plugin-specific options */
+    [key: string]: unknown;
+}
+
+declare class OpenDocumentPlugin implements PreviewPlugin$2 {
+    id: string;
+    name: string;
+    extensions: string[];
+    mimeTypes: string[];
+    weight: number;
+    supports(file: FileInfo$2): boolean;
+    getToolbarActions(instance: PreviewInstance$2): ToolbarAction$2[];
+    render(ctx: RenderContext$2): Promise<PreviewInstance$2>;
+    private getPageDimensions;
+    private extractStyles;
+    private renderOdfBody;
+    private renderSpans;
+    private renderSlides;
+}
+declare function openDocumentPlugin(): OpenDocumentPlugin;
+
+/**
+ * Supported file input sources.
+ * Accepts URL strings, File objects, Blobs, ArrayBuffers, or Uint8Arrays.
+ */
+type FileSource$1 = string | File | Blob | ArrayBuffer | Uint8Array;
+/** Metadata extracted from a file source */
+interface FileMetadata$1 {
+    /** Original filename (if available) */
+    name?: string;
+    /** File size in bytes */
+    size?: number;
+    /** Detected MIME type */
+    mimeType?: string;
+    /** File extension (lowercase, with dot, e.g. '.pdf') */
+    extension?: string;
+}
+/** Information about a resolved file, ready for plugin matching */
+interface FileInfo$1 {
+    metadata: FileMetadata$1;
+    buffer: ArrayBuffer;
+}
+/** Toolbar action types */
+type ToolbarActionType$1 = 'button' | 'toggle' | 'range' | 'input' | 'separator' | 'page-nav';
+/** Toolbar action group names for visual grouping */
+type ToolbarGroup$1 = 'navigation' | 'zoom' | 'view' | 'actions';
+/** Represents a single toolbar action/control */
+interface ToolbarAction$1 {
+    /** Unique action identifier */
+    id: string;
+    /** SVG icon markup string */
+    icon: string;
+    /** Accessible label */
+    label: string;
+    /** Type of control to render */
+    type: ToolbarActionType$1;
+    /** Visual group placement */
+    group: ToolbarGroup$1;
+    /** Whether the action is currently enabled */
+    enabled?: boolean;
+    /** Whether a toggle is currently active */
+    active?: boolean;
+    /** Execute the action */
+    execute: (...args: unknown[]) => void;
+    /** For 'range' type: min/max/step/value */
+    min?: number;
+    max?: number;
+    step?: number;
+    value?: number;
+}
+/** Represents a thumbnail in the sidebar */
+interface Thumbnail$1 {
+    /** Page/sheet/frame index */
+    index: number;
+    /** Display label (e.g., "Page 1", "Sheet: Revenue") */
+    label: string;
+    /** Renders the thumbnail into a canvas element */
+    render: (canvas: HTMLCanvasElement) => Promise<void>;
+}
+/** Instance returned after a file is rendered — exposes controls */
+interface PreviewInstance$1 {
+    /** Clean up all resources */
+    destroy(): void;
+    zoomIn?(): void;
+    zoomOut?(): void;
+    getZoom?(): number;
+    setZoom?(level: number): void;
+    fitToPage?(): void;
+    fitToWidth?(): void;
+    goToPage?(page: number): void;
+    getPageCount?(): number;
+    getCurrentPage?(): number;
+    rotateCW?(): void;
+    rotateCCW?(): void;
+    getRotation?(): number;
+    play?(): void;
+    pause?(): void;
+    isPlaying?(): boolean;
+    fastForward?(seconds?: number): void;
+    rewind?(seconds?: number): void;
+    setPlaybackRate?(rate: number): void;
+    getPlaybackRate?(): number;
+    getThumbnails?(): Thumbnail$1[] | Promise<Thumbnail$1[]>;
+    toggleThumbnails?(): void;
+    download?(): void;
+    print?(): void;
+    [key: string]: unknown;
+}
+/** Context passed to a plugin's render function */
+interface RenderContext$1 {
+    /** The container DOM element to render into */
+    container: HTMLElement;
+    /** Original file source */
+    source: FileSource$1;
+    /** Resolved file metadata */
+    metadata: FileMetadata$1;
+    /** File content as ArrayBuffer */
+    buffer: ArrayBuffer;
+    /** Viewer options */
+    options: PreviewViewerOptions$1;
+    /** AbortSignal for cancellation */
+    signal: AbortSignal;
+    /** Emit an event to the viewer */
+    emit: (event: string, payload?: unknown) => void;
+}
+/** Plugin interface — each file format renderer implements this */
+interface PreviewPlugin$1 {
+    /** Unique plugin identifier */
+    id: string;
+    /** Human-readable plugin name */
+    name: string;
+    /** File extensions this plugin handles (e.g., ['.pdf']) */
+    extensions: string[];
+    /** MIME types this plugin handles */
+    mimeTypes: string[];
+    /** Priority when multiple plugins match (higher = preferred) */
+    weight?: number;
+    /** Check if this plugin can handle the given file */
+    supports(file: FileInfo$1): boolean | Promise<boolean>;
+    /** Return toolbar actions for the rendered instance */
+    getToolbarActions(instance: PreviewInstance$1): ToolbarAction$1[];
+    /** Render the file into the container */
+    render(ctx: RenderContext$1): Promise<PreviewInstance$1>;
+}
+/** Configuration to selectively enable or disable individual toolbar functions/buttons */
+interface ToolbarConfig$1 {
+    /** Page navigation (< [1] / N >) */
+    pageNav?: boolean;
+    pagination?: boolean;
+    prevPage?: boolean;
+    nextPage?: boolean;
+    /** Zoom controls */
+    zoomIn?: boolean;
+    zoomOut?: boolean;
+    fitPage?: boolean;
+    fitToPage?: boolean;
+    fitWidth?: boolean;
+    zoomReset?: boolean;
+    /** View controls */
+    rotate?: boolean;
+    rotateCW?: boolean;
+    rotateCCW?: boolean;
+    fullscreen?: boolean;
+    thumbnails?: boolean;
+    /** Action controls */
+    download?: boolean;
+    print?: boolean;
+    openWindow?: boolean;
+    openSeparateWindow?: boolean;
+    copy?: boolean;
+    /** Media controls */
+    play?: boolean;
+    pause?: boolean;
+    fastForward?: boolean;
+    rewind?: boolean;
+    speed?: boolean;
+}
+/** Viewer configuration options */
+interface PreviewViewerOptions$1 extends ToolbarConfig$1 {
+    /** Color theme */
+    theme?: 'light' | 'dark' | 'auto';
+    /** Locale for UI labels */
+    locale?: string;
+    /** Initial zoom level (1.0 = 100%) */
+    zoom?: number;
+    /** Initial page number (1-based) */
+    page?: number;
+    /** Show the toolbar */
+    showToolbar?: boolean;
+    /** Detailed toolbar configuration (or boolean to show/hide entire toolbar) */
+    toolbar?: boolean | (ToolbarConfig$1 & Record<string, boolean | undefined>);
+    /** Toolbar position */
+    toolbarPosition?: 'top' | 'bottom';
+    /** Fit mode: 'page' (fill frame width with minimal margins) or 'width' */
+    fitMode?: 'page' | 'width';
+    /** Show thumbnail sidebar initially */
+    showThumbnails?: boolean;
+    /** Whether to display the file name / title bar above the toolbar in the preview panel (defaults to true) */
+    showFileName?: boolean;
+    /** Custom file name / title override to display */
+    fileName?: string;
+    /** Custom CSS class for the container */
+    className?: string;
+    /** Plugin-specific options */
+    pluginOptions?: Record<string, unknown>;
+    /** Optional file metadata overrides (name, extension, mimeType, etc.) */
+    metadata?: FileMetadata$1;
+    /** Custom URL to navigate when "Open in Separate Full Window" is clicked */
+    standaloneViewerUrl?: string;
+    /** Custom handler for opening preview in a separate window */
+    onOpenSeparateWindow?: (payload: {
+        buffer: ArrayBuffer;
+        metadata: FileMetadata$1;
+        options: PreviewViewerOptions$1;
+    }) => Window | null;
+    /** Internal flag: true when viewer is rendered inside separate full window */
+    _isSeparateWindow?: boolean;
+    /** Allow custom/plugin-specific options */
+    [key: string]: unknown;
+}
+
+declare class DocPlugin implements PreviewPlugin$1 {
+    id: string;
+    name: string;
+    extensions: string[];
+    mimeTypes: string[];
+    weight: number;
+    supports(file: FileInfo$1): boolean;
+    getToolbarActions(instance: PreviewInstance$1): ToolbarAction$1[];
+    render(ctx: RenderContext$1): Promise<PreviewInstance$1>;
+    /**
+     * Extract document text from WordDocument stream and Table stream
+     */
+    private extractDocText;
+    /**
+     * Parse the CLX and Piece Table (Plcfpcd) according to [MS-DOC]
+     */
+    private parsePieceTable;
+    private readPlcfpcd;
+    /**
+     * Scans a byte array for continuous sequences of readable characters (ANSI and UTF-16LE)
+     */
+    private extractStringsFromBytes;
+    private heuristicTextExtraction;
+    /**
+     * Parses an embedded OpenDocument Chart package into a vector SVG bar/column chart
+     */
+    private parseOdfChartToSvg;
+    private cleanWordDocFields;
+    private splitIntoPages;
+    /**
+     * Format cleaned extracted text into attractive HTML paragraphs, headings, and lists
+     */
+    private formatDocToHtml;
+}
+declare function docPlugin(): DocPlugin;
+
+/**
+ * Supported file input sources.
+ * Accepts URL strings, File objects, Blobs, ArrayBuffers, or Uint8Arrays.
+ */
+type FileSource = string | File | Blob | ArrayBuffer | Uint8Array;
+/** Metadata extracted from a file source */
+interface FileMetadata {
+    /** Original filename (if available) */
+    name?: string;
+    /** File size in bytes */
+    size?: number;
+    /** Detected MIME type */
+    mimeType?: string;
+    /** File extension (lowercase, with dot, e.g. '.pdf') */
+    extension?: string;
+}
+/** Information about a resolved file, ready for plugin matching */
+interface FileInfo {
+    metadata: FileMetadata;
+    buffer: ArrayBuffer;
+}
+/** Toolbar action types */
+type ToolbarActionType = 'button' | 'toggle' | 'range' | 'input' | 'separator' | 'page-nav';
+/** Toolbar action group names for visual grouping */
+type ToolbarGroup = 'navigation' | 'zoom' | 'view' | 'actions';
+/** Represents a single toolbar action/control */
+interface ToolbarAction {
+    /** Unique action identifier */
+    id: string;
+    /** SVG icon markup string */
+    icon: string;
+    /** Accessible label */
+    label: string;
+    /** Type of control to render */
+    type: ToolbarActionType;
+    /** Visual group placement */
+    group: ToolbarGroup;
+    /** Whether the action is currently enabled */
+    enabled?: boolean;
+    /** Whether a toggle is currently active */
+    active?: boolean;
+    /** Execute the action */
+    execute: (...args: unknown[]) => void;
+    /** For 'range' type: min/max/step/value */
+    min?: number;
+    max?: number;
+    step?: number;
+    value?: number;
+}
+/** Represents a thumbnail in the sidebar */
+interface Thumbnail {
+    /** Page/sheet/frame index */
+    index: number;
+    /** Display label (e.g., "Page 1", "Sheet: Revenue") */
+    label: string;
+    /** Renders the thumbnail into a canvas element */
+    render: (canvas: HTMLCanvasElement) => Promise<void>;
+}
+/** Instance returned after a file is rendered — exposes controls */
+interface PreviewInstance {
+    /** Clean up all resources */
+    destroy(): void;
+    zoomIn?(): void;
+    zoomOut?(): void;
+    getZoom?(): number;
+    setZoom?(level: number): void;
+    fitToPage?(): void;
+    fitToWidth?(): void;
+    goToPage?(page: number): void;
+    getPageCount?(): number;
+    getCurrentPage?(): number;
+    rotateCW?(): void;
+    rotateCCW?(): void;
+    getRotation?(): number;
+    play?(): void;
+    pause?(): void;
+    isPlaying?(): boolean;
+    fastForward?(seconds?: number): void;
+    rewind?(seconds?: number): void;
+    setPlaybackRate?(rate: number): void;
+    getPlaybackRate?(): number;
+    getThumbnails?(): Thumbnail[] | Promise<Thumbnail[]>;
+    toggleThumbnails?(): void;
+    download?(): void;
+    print?(): void;
+    [key: string]: unknown;
+}
+/** Context passed to a plugin's render function */
+interface RenderContext {
+    /** The container DOM element to render into */
+    container: HTMLElement;
+    /** Original file source */
+    source: FileSource;
+    /** Resolved file metadata */
+    metadata: FileMetadata;
+    /** File content as ArrayBuffer */
+    buffer: ArrayBuffer;
+    /** Viewer options */
+    options: PreviewViewerOptions;
+    /** AbortSignal for cancellation */
+    signal: AbortSignal;
+    /** Emit an event to the viewer */
+    emit: (event: string, payload?: unknown) => void;
+}
+/** Plugin interface — each file format renderer implements this */
+interface PreviewPlugin {
+    /** Unique plugin identifier */
+    id: string;
+    /** Human-readable plugin name */
+    name: string;
+    /** File extensions this plugin handles (e.g., ['.pdf']) */
+    extensions: string[];
+    /** MIME types this plugin handles */
+    mimeTypes: string[];
+    /** Priority when multiple plugins match (higher = preferred) */
+    weight?: number;
+    /** Check if this plugin can handle the given file */
+    supports(file: FileInfo): boolean | Promise<boolean>;
+    /** Return toolbar actions for the rendered instance */
+    getToolbarActions(instance: PreviewInstance): ToolbarAction[];
+    /** Render the file into the container */
+    render(ctx: RenderContext): Promise<PreviewInstance>;
+}
+/** Configuration to selectively enable or disable individual toolbar functions/buttons */
+interface ToolbarConfig {
+    /** Page navigation (< [1] / N >) */
+    pageNav?: boolean;
+    pagination?: boolean;
+    prevPage?: boolean;
+    nextPage?: boolean;
+    /** Zoom controls */
+    zoomIn?: boolean;
+    zoomOut?: boolean;
+    fitPage?: boolean;
+    fitToPage?: boolean;
+    fitWidth?: boolean;
+    zoomReset?: boolean;
+    /** View controls */
+    rotate?: boolean;
+    rotateCW?: boolean;
+    rotateCCW?: boolean;
+    fullscreen?: boolean;
+    thumbnails?: boolean;
+    /** Action controls */
+    download?: boolean;
+    print?: boolean;
+    openWindow?: boolean;
+    openSeparateWindow?: boolean;
+    copy?: boolean;
+    /** Media controls */
+    play?: boolean;
+    pause?: boolean;
+    fastForward?: boolean;
+    rewind?: boolean;
+    speed?: boolean;
+}
+/** Viewer configuration options */
+interface PreviewViewerOptions extends ToolbarConfig {
+    /** Color theme */
+    theme?: 'light' | 'dark' | 'auto';
+    /** Locale for UI labels */
+    locale?: string;
+    /** Initial zoom level (1.0 = 100%) */
+    zoom?: number;
+    /** Initial page number (1-based) */
+    page?: number;
+    /** Show the toolbar */
+    showToolbar?: boolean;
+    /** Detailed toolbar configuration (or boolean to show/hide entire toolbar) */
+    toolbar?: boolean | (ToolbarConfig & Record<string, boolean | undefined>);
+    /** Toolbar position */
+    toolbarPosition?: 'top' | 'bottom';
+    /** Fit mode: 'page' (fill frame width with minimal margins) or 'width' */
+    fitMode?: 'page' | 'width';
+    /** Show thumbnail sidebar initially */
+    showThumbnails?: boolean;
+    /** Whether to display the file name / title bar above the toolbar in the preview panel (defaults to true) */
+    showFileName?: boolean;
+    /** Custom file name / title override to display */
+    fileName?: string;
+    /** Custom CSS class for the container */
+    className?: string;
+    /** Plugin-specific options */
+    pluginOptions?: Record<string, unknown>;
+    /** Optional file metadata overrides (name, extension, mimeType, etc.) */
+    metadata?: FileMetadata;
+    /** Custom URL to navigate when "Open in Separate Full Window" is clicked */
+    standaloneViewerUrl?: string;
+    /** Custom handler for opening preview in a separate window */
+    onOpenSeparateWindow?: (payload: {
+        buffer: ArrayBuffer;
+        metadata: FileMetadata;
+        options: PreviewViewerOptions;
+    }) => Window | null;
+    /** Internal flag: true when viewer is rendered inside separate full window */
+    _isSeparateWindow?: boolean;
+    /** Allow custom/plugin-specific options */
+    [key: string]: unknown;
+}
+
+declare class PptPlugin implements PreviewPlugin {
+    id: string;
+    name: string;
+    extensions: string[];
+    mimeTypes: string[];
+    weight: number;
+    supports(file: FileInfo): boolean;
+    getToolbarActions(instance: PreviewInstance): ToolbarAction[];
+    render(ctx: RenderContext): Promise<PreviewInstance>;
+    /**
+     * Extract PNG and JPEG images from the Pictures stream
+     */
+    private extractPictures;
+    /**
+     * Traverse PowerPoint binary stream records ([MS-PPT]) and extract text chunks per slide
+     */
+    private extractSlides;
+}
+declare function pptPlugin(): PptPlugin;
 
 /**
  * Returns all built-in default preview plugins:
@@ -25,7 +3233,7 @@ export { pptPlugin } from '@patel.sumit51/plugin-ppt';
  * Sandboxed HTML, CSV/TSV, ZIP Archives, Markdown, 3D Models (STL/OBJ),
  * Media (Images/Video/Audio/SVG), and Code/Text (190+ languages).
  */
-declare function getDefaultPlugins(): PreviewPlugin[];
+declare function getDefaultPlugins(): PreviewPlugin$f[];
 /**
  * Universal File Preview Viewer.
  * Pre-loads all format plugins by default so 50+ file formats can be previewed immediately.
@@ -36,4 +3244,4 @@ declare class FilePreviewViewer extends FilePreviewViewer$1 {
     });
 }
 
-export { FilePreviewViewer, getDefaultPlugins };
+export { FilePreviewViewer, PreviewPlugin$f as PreviewPlugin, archivePlugin, codePlugin, csvPlugin, docPlugin, docxPlugin, excelPlugin, getDefaultPlugins, htmlPreviewPlugin, markdownPlugin, mediaPlugin, openDocumentPlugin, pdfPlugin, pptPlugin, pptxPlugin, rtfPlugin, threeDPlugin };