@file-viewer/core 2.0.0

package/dist/capabilities.d.ts

@@ -0,0 +1,24 @@
+import type { FileRenderExportAdapter, FileViewerOperationAvailability, RendererDefinition, RendererSession } from './types';
+export declare const DEFAULT_OPERATION_AVAILABILITY: FileViewerOperationAvailability;
+export declare const getRendererAvailability: (renderer: RendererDefinition | undefined, session?: RendererSession | null) => FileViewerOperationAvailability;
+export declare const createUnsupportedAvailability: (extension: string) => FileViewerOperationAvailability;
+/**
+ * 这些格式只有专属适配器准备好后才展示打印。
+ *
+ * 它们的在线预览常依赖分页引擎、虚拟渲染或 Worker 生命周期，直接克隆
+ * DOM 很容易只得到当前页或当前视口。
+ */
+export declare const ADAPTER_PRINT_REQUIRED_EXTENSIONS: readonly ["docx", "docm", "dotx", "dotm", "doc", "dot", "pdf", "typ", "typst"];
+/**
+ * 这些格式的预览结果是完整 DOM / SVG / Canvas 截图，解除滚动容器裁切后
+ * 可以稳定进入浏览器打印流程。
+ */
+export declare const DOM_PRINTABLE_EXTENSIONS: readonly ["pptx", "pptm", "potx", "potm", "ppsx", "ppsm", "ofd", "dxf", "dwg", "dwf", "dwfx", "xps", "excalidraw", "drawio", "dio", "umd", "md", "markdown", "olb", "dra", "txt", "json", "js", "mjs", "cjs", "css", "java", "py", "html", "htm", "jsx", "ts", "tsx", "xml", "log", "vue", "yaml", "yml", "ini", "sh", "bash", "sql", "go", "rs", "php", "c", "cpp", "cc", "h", "hpp", "cs", "diff", "jsonc", "json5", "ipynb", "toml", "proto", "hcl", "tex", "gv", "http", "react", "rb", "swift", "kt", "gif", "jpg", "jpeg", "bmp", "tiff", "tif", "png", "svg", "webp", "avif", "ico", "heic", "heif", "jxl"];
+/**
+ * 这些格式默认不展示打印按钮，避免导出半截内容。
+ */
+export declare const NON_PRINTABLE_EXTENSIONS: readonly ["xlsx", "xltx", "xlsm", "xlsb", "xls", "xlt", "xltm", "csv", "ods", "fods", "numbers", "zip", "zipx", "7z", "rar", "tar", "gz", "gzip", "tgz", "bz2", "bzip2", "tbz", "tbz2", "xz", "txz", "lzma", "zst", "tzst", "cab", "ar", "cpio", "iso", "xar", "lha", "lzh", "jar", "war", "ear", "apk", "cbz", "cbr", "eml", "msg", "epub", "mp4", "mp3", "mpeg", "wav", "ogg", "oga", "opus", "m4a", "aac", "flac", "weba", "glb", "gltf", "obj", "stl", "ply", "fbx", "dae", "3ds", "3mf", "amf", "usd", "usda", "usdc", "usdz", "kmz", "step", "stp", "iges", "igs", "ifc", "3dm", "pcd", "wrl", "vrml", "xyz", "vtk", "vtp"];
+export declare const needsDedicatedPrintAdapter: (extension: string) => boolean;
+export declare const isDomPrintableExtension: (extension: string) => boolean;
+export declare const isKnownNonPrintableExtension: (extension: string) => boolean;
+export declare const resolvePrintAvailability: (extension: string, adapter: FileRenderExportAdapter | null, renderedReady: boolean) => boolean;

package/dist/capabilities.js

@@ -0,0 +1,95 @@
+import { ARCHIVE_EXTENSIONS, IMAGE_EXTENSIONS, MODEL_EXTENSIONS, TEXT_EXTENSIONS } from './formats.js';
+import { normalizeFileExtension } from './source.js';
+export const DEFAULT_OPERATION_AVAILABILITY = Object.freeze({
+    download: false,
+    print: false,
+    exportHtml: false,
+    zoom: false,
+    zoomIn: false,
+    zoomOut: false,
+    zoomReset: false,
+});
+const resolveBooleanCapability = (value) => {
+    return value === true || value === 'adapter' || value === 'provider';
+};
+export const getRendererAvailability = (renderer, session) => {
+    var _a, _b, _c, _d, _e, _f, _g, _h;
+    if (!renderer) {
+        return { ...DEFAULT_OPERATION_AVAILABILITY };
+    }
+    const base = {
+        download: ((_a = renderer.capabilities) === null || _a === void 0 ? void 0 : _a.download) !== false,
+        print: resolveBooleanCapability((_b = renderer.capabilities) === null || _b === void 0 ? void 0 : _b.print),
+        exportHtml: resolveBooleanCapability((_c = renderer.capabilities) === null || _c === void 0 ? void 0 : _c.exportHtml),
+        zoom: resolveBooleanCapability((_d = renderer.capabilities) === null || _d === void 0 ? void 0 : _d.zoom),
+        zoomIn: resolveBooleanCapability((_e = renderer.capabilities) === null || _e === void 0 ? void 0 : _e.zoom),
+        zoomOut: resolveBooleanCapability((_f = renderer.capabilities) === null || _f === void 0 ? void 0 : _f.zoom),
+        zoomReset: resolveBooleanCapability((_g = renderer.capabilities) === null || _g === void 0 ? void 0 : _g.zoom),
+    };
+    return {
+        ...base,
+        ...(_h = session === null || session === void 0 ? void 0 : session.getAvailability) === null || _h === void 0 ? void 0 : _h.call(session),
+    };
+};
+export const createUnsupportedAvailability = (extension) => ({
+    ...DEFAULT_OPERATION_AVAILABILITY,
+    download: normalizeFileExtension(extension).length > 0,
+});
+/**
+ * 这些格式只有专属适配器准备好后才展示打印。
+ *
+ * 它们的在线预览常依赖分页引擎、虚拟渲染或 Worker 生命周期，直接克隆
+ * DOM 很容易只得到当前页或当前视口。
+ */
+export const ADAPTER_PRINT_REQUIRED_EXTENSIONS = [
+    'docx', 'docm', 'dotx', 'dotm', 'doc', 'dot', 'pdf', 'typ', 'typst',
+];
+/**
+ * 这些格式的预览结果是完整 DOM / SVG / Canvas 截图，解除滚动容器裁切后
+ * 可以稳定进入浏览器打印流程。
+ */
+export const DOM_PRINTABLE_EXTENSIONS = [
+    'pptx', 'pptm', 'potx', 'potm', 'ppsx', 'ppsm', 'ofd', 'dxf', 'dwg', 'dwf', 'dwfx', 'xps',
+    'excalidraw', 'drawio', 'dio', 'umd', 'md', 'markdown', 'olb', 'dra',
+    ...TEXT_EXTENSIONS,
+    ...IMAGE_EXTENSIONS,
+];
+/**
+ * 这些格式默认不展示打印按钮，避免导出半截内容。
+ */
+export const NON_PRINTABLE_EXTENSIONS = [
+    'xlsx', 'xltx', 'xlsm', 'xlsb', 'xls', 'xlt', 'xltm', 'csv', 'ods', 'fods', 'numbers',
+    ...ARCHIVE_EXTENSIONS,
+    'eml', 'msg', 'epub', 'mp4',
+    'mp3', 'mpeg', 'wav', 'ogg', 'oga', 'opus', 'm4a', 'aac', 'flac', 'weba',
+    ...MODEL_EXTENSIONS,
+];
+const hasExtension = (items, extension) => {
+    return items.includes(normalizeFileExtension(extension));
+};
+export const needsDedicatedPrintAdapter = (extension) => {
+    return hasExtension(ADAPTER_PRINT_REQUIRED_EXTENSIONS, extension);
+};
+export const isDomPrintableExtension = (extension) => {
+    return hasExtension(DOM_PRINTABLE_EXTENSIONS, extension);
+};
+export const isKnownNonPrintableExtension = (extension) => {
+    return hasExtension(NON_PRINTABLE_EXTENSIONS, extension);
+};
+export const resolvePrintAvailability = (extension, adapter, renderedReady) => {
+    if (!renderedReady) {
+        return false;
+    }
+    if (adapter) {
+        if (adapter.print === false) {
+            return false;
+        }
+        if (adapter.toHtml) {
+            return true;
+        }
+    }
+    if (needsDedicatedPrintAdapter(extension) || isKnownNonPrintableExtension(extension)) {
+        return false;
+    }
+    return isDomPrintableExtension(extension);
+};

package/dist/document.d.ts

@@ -0,0 +1,9 @@
+import type { FileViewerAiOptions, FileViewerDocumentAnchor, FileViewerDocumentChunk, FileViewerSearchOptions, FileViewerSearchState, FileViewerZoomState } from './types';
+export declare const DEFAULT_FILE_VIEWER_ZOOM_SCALE = 1;
+export declare const DEFAULT_FILE_VIEWER_TEXT_CHUNK_SIZE = 1200;
+export declare const DEFAULT_FILE_VIEWER_TEXT_CHUNK_OVERLAP = 160;
+export declare const createFileViewerZoomState: (patch?: Partial<FileViewerZoomState>) => FileViewerZoomState;
+export declare const normalizeFileViewerSearchOptions: (options?: boolean | FileViewerSearchOptions) => FileViewerSearchOptions;
+export declare const createEmptyFileViewerSearchState: (query?: string) => FileViewerSearchState;
+export declare const normalizeFileViewerAiOptions: (options?: boolean | FileViewerAiOptions) => FileViewerAiOptions;
+export declare const buildFileViewerDocumentTextChunks: (anchors: FileViewerDocumentAnchor[], options?: boolean | FileViewerAiOptions) => FileViewerDocumentChunk[];

package/dist/document.js

@@ -0,0 +1,86 @@
+export const DEFAULT_FILE_VIEWER_ZOOM_SCALE = 1;
+export const DEFAULT_FILE_VIEWER_TEXT_CHUNK_SIZE = 1200;
+export const DEFAULT_FILE_VIEWER_TEXT_CHUNK_OVERLAP = 160;
+export const createFileViewerZoomState = (patch = {}) => {
+    var _a, _b, _c;
+    const scale = Number.isFinite(patch.scale) && patch.scale ? Number(patch.scale) : DEFAULT_FILE_VIEWER_ZOOM_SCALE;
+    return {
+        scale,
+        label: patch.label || `${Math.round(scale * 100)}%`,
+        canZoomIn: (_a = patch.canZoomIn) !== null && _a !== void 0 ? _a : false,
+        canZoomOut: (_b = patch.canZoomOut) !== null && _b !== void 0 ? _b : false,
+        canReset: (_c = patch.canReset) !== null && _c !== void 0 ? _c : false,
+        minScale: patch.minScale,
+        maxScale: patch.maxScale,
+    };
+};
+export const normalizeFileViewerSearchOptions = (options) => {
+    if (options === false) {
+        return { enabled: false };
+    }
+    if (options === true || options === undefined) {
+        return {};
+    }
+    return options;
+};
+export const createEmptyFileViewerSearchState = (query = '') => ({
+    query,
+    total: 0,
+    currentIndex: -1,
+    current: null,
+    matches: [],
+});
+export const normalizeFileViewerAiOptions = (options) => {
+    if (options === false) {
+        return { enabled: false, collectText: false };
+    }
+    if (options === true || options === undefined) {
+        return {};
+    }
+    return options;
+};
+export const buildFileViewerDocumentTextChunks = (anchors, options) => {
+    var _a;
+    const normalized = normalizeFileViewerAiOptions(options);
+    if (normalized.enabled === false || normalized.collectText === false) {
+        return [];
+    }
+    const chunkSize = Math.max(200, normalized.chunkSize || DEFAULT_FILE_VIEWER_TEXT_CHUNK_SIZE);
+    const overlap = Math.max(0, Math.min(chunkSize - 1, (_a = normalized.chunkOverlap) !== null && _a !== void 0 ? _a : DEFAULT_FILE_VIEWER_TEXT_CHUNK_OVERLAP));
+    const maxTextLength = Math.max(0, normalized.maxTextLength || 0);
+    const chunks = [];
+    anchors.forEach(anchor => {
+        const source = maxTextLength ? anchor.text.slice(0, maxTextLength) : anchor.text;
+        if (!source) {
+            return;
+        }
+        if (source.length <= chunkSize) {
+            chunks.push({
+                id: `${anchor.id}-chunk-1`,
+                text: source,
+                anchor,
+                startLine: anchor.line,
+                endLine: anchor.line,
+            });
+            return;
+        }
+        let offset = 0;
+        let chunkIndex = 1;
+        while (offset < source.length) {
+            const text = source.slice(offset, offset + chunkSize);
+            chunks.push({
+                id: `${anchor.id}-chunk-${chunkIndex}`,
+                text,
+                anchor,
+                startLine: anchor.line,
+                endLine: anchor.line,
+            });
+            if (offset + chunkSize >= source.length) {
+                break;
+            }
+            offset += chunkSize - overlap;
+            chunkIndex += 1;
+        }
+    });
+    return chunks;
+};

package/dist/documentDom/anchors.d.ts

@@ -0,0 +1,7 @@
+import type { FileViewerDocumentAnchor } from '../types';
+export declare const DEFAULT_FILE_VIEWER_ANCHOR_SELECTOR: string;
+export declare const DEFAULT_FILE_VIEWER_ANCHOR_EXCLUDE_SELECTOR: string;
+export declare const collectFileViewerDocumentAnchors: (root: HTMLElement | null) => FileViewerDocumentAnchor[];
+export declare const findFileViewerAnchorForElement: (element: Element | null, anchors: FileViewerDocumentAnchor[], root?: HTMLElement | null) => FileViewerDocumentAnchor | null;
+export declare const getCurrentFileViewerDocumentAnchor: (root: HTMLElement | null, anchors: FileViewerDocumentAnchor[]) => FileViewerDocumentAnchor | null;
+export declare const scrollToFileViewerDocumentAnchor: (root: HTMLElement | null, anchor: FileViewerDocumentAnchor | string | number | null | undefined) => boolean;

package/dist/documentDom/anchors.js

@@ -0,0 +1,196 @@
+export const DEFAULT_FILE_VIEWER_ANCHOR_SELECTOR = [
+    '[data-viewer-anchor-id]',
+    '.pdfViewer .page',
+    '.docx-wrapper section',
+    '.docx p',
+    '.docx li',
+    '.docx table',
+    '.markdown-body h1',
+    '.markdown-body h2',
+    '.markdown-body h3',
+    '.markdown-body h4',
+    '.markdown-body h5',
+    '.markdown-body h6',
+    '.markdown-body p',
+    '.markdown-body li',
+    '.markdown-body pre',
+    '.markdown-body table',
+    'article h1',
+    'article h2',
+    'article h3',
+    'article h4',
+    'article h5',
+    'article h6',
+    'article p',
+    'article li',
+    'article pre',
+    'article table',
+    'pre code',
+    'p',
+    'li',
+    'tr',
+    'h1',
+    'h2',
+    'h3',
+    'h4',
+    'h5',
+    'h6',
+    'pre',
+    'table',
+].join(',');
+export const DEFAULT_FILE_VIEWER_ANCHOR_EXCLUDE_SELECTOR = [
+    '.viewer-actions',
+    '.viewer-watermark',
+    '.state-panel',
+    '.pdf-toolbar',
+    '.pdf-nav-pane',
+    '.flyfish-search-match',
+].join(',');
+const cssEscape = (value) => {
+    if (typeof CSS !== 'undefined' && typeof CSS.escape === 'function') {
+        return CSS.escape(value);
+    }
+    return value.replace(/["\\]/g, '\\$&');
+};
+const trimText = (value, maxLength = 160) => {
+    const normalized = value.replace(/\s+/g, ' ').trim();
+    return normalized.length > maxLength ? `${normalized.slice(0, maxLength - 1)}…` : normalized;
+};
+const isElementVisible = (element) => {
+    const rect = element.getBoundingClientRect();
+    return rect.width > 0 || rect.height > 0;
+};
+const shouldSkipAnchorElement = (element) => {
+    return !!element.closest(DEFAULT_FILE_VIEWER_ANCHOR_EXCLUDE_SELECTOR);
+};
+const getPageNumber = (element) => {
+    const pageElement = element.closest('[data-page-number], [data-page]');
+    const rawPage = (pageElement === null || pageElement === void 0 ? void 0 : pageElement.dataset.pageNumber) || (pageElement === null || pageElement === void 0 ? void 0 : pageElement.dataset.page);
+    const page = rawPage ? Number.parseInt(rawPage, 10) : Number.NaN;
+    return Number.isFinite(page) ? page : undefined;
+};
+const getAnchorType = (element) => {
+    if (element.matches('.pdfViewer .page, [data-page-number], [data-page]')) {
+        return 'page';
+    }
+    if (element.matches('p, li, tr, pre, code')) {
+        return 'line';
+    }
+    return 'block';
+};
+const isNestedInAcceptedElement = (element, acceptedElements) => {
+    let parent = element.parentElement;
+    while (parent) {
+        if (acceptedElements.has(parent)) {
+            return true;
+        }
+        parent = parent.parentElement;
+    }
+    return false;
+};
+export const collectFileViewerDocumentAnchors = (root) => {
+    if (!root) {
+        return [];
+    }
+    const rootRect = root.getBoundingClientRect();
+    const acceptedElements = new Set();
+    const anchors = [];
+    const candidates = Array.from(root.querySelectorAll(DEFAULT_FILE_VIEWER_ANCHOR_SELECTOR));
+    candidates.forEach(element => {
+        if (shouldSkipAnchorElement(element) || !isElementVisible(element)) {
+            return;
+        }
+        const text = trimText(element.textContent || '', 1000);
+        if (!text) {
+            return;
+        }
+        if (isNestedInAcceptedElement(element, acceptedElements) && !element.matches('p, li, tr, pre, code')) {
+            return;
+        }
+        acceptedElements.add(element);
+        const id = element.dataset.viewerAnchorId || `viewer-anchor-${anchors.length + 1}`;
+        element.dataset.viewerAnchorId = id;
+        element.dataset.viewerLine = String(anchors.length + 1);
+        const rect = element.getBoundingClientRect();
+        anchors.push({
+            id,
+            index: anchors.length,
+            line: anchors.length + 1,
+            type: getAnchorType(element),
+            label: trimText(text, 96),
+            text,
+            page: getPageNumber(element),
+            top: rect.top - rootRect.top + root.scrollTop,
+            left: rect.left - rootRect.left + root.scrollLeft,
+            width: rect.width,
+            height: rect.height,
+        });
+    });
+    return anchors;
+};
+export const findFileViewerAnchorForElement = (element, anchors, root) => {
+    if (!element) {
+        return null;
+    }
+    const anchorElement = element.closest('[data-viewer-anchor-id]');
+    if (anchorElement === null || anchorElement === void 0 ? void 0 : anchorElement.dataset.viewerAnchorId) {
+        const anchor = anchors.find(item => item.id === anchorElement.dataset.viewerAnchorId);
+        if (anchor) {
+            return anchor;
+        }
+    }
+    if (!root) {
+        return null;
+    }
+    const rootRect = root.getBoundingClientRect();
+    const rect = element.getBoundingClientRect();
+    const top = rect.top - rootRect.top + root.scrollTop;
+    let fallback = null;
+    for (const anchor of anchors) {
+        if (anchor.top <= top + 1) {
+            fallback = anchor;
+            continue;
+        }
+        break;
+    }
+    return fallback;
+};
+export const getCurrentFileViewerDocumentAnchor = (root, anchors) => {
+    if (!root || !anchors.length) {
+        return null;
+    }
+    const viewportMiddle = root.scrollTop + root.clientHeight * 0.42;
+    let current = anchors[0];
+    for (const anchor of anchors) {
+        if (anchor.top <= viewportMiddle) {
+            current = anchor;
+            continue;
+        }
+        break;
+    }
+    return current;
+};
+export const scrollToFileViewerDocumentAnchor = (root, anchor) => {
+    if (!root || anchor === null || anchor === undefined) {
+        return false;
+    }
+    const selector = typeof anchor === 'object'
+        ? `[data-viewer-anchor-id="${cssEscape(anchor.id)}"]`
+        : typeof anchor === 'number'
+            ? `[data-viewer-line="${anchor}"]`
+            : `[data-viewer-anchor-id="${cssEscape(anchor)}"]`;
+    const target = root.querySelector(selector);
+    if (target) {
+        target.scrollIntoView({ block: 'center', inline: 'nearest' });
+        return true;
+    }
+    if (typeof anchor === 'object') {
+        root.scrollTo({
+            top: Math.max(0, anchor.top - root.clientHeight * 0.18),
+            left: Math.max(0, Math.min(anchor.left, root.scrollWidth - root.clientWidth)),
+            behavior: 'smooth',
+        });
+        return true;
+    }
+    return false;
+};

package/dist/documentDom/index.d.ts

@@ -0,0 +1,5 @@
+export { DEFAULT_FILE_VIEWER_ANCHOR_EXCLUDE_SELECTOR, DEFAULT_FILE_VIEWER_ANCHOR_SELECTOR, collectFileViewerDocumentAnchors, findFileViewerAnchorForElement, getCurrentFileViewerDocumentAnchor, scrollToFileViewerDocumentAnchor, } from './anchors';
+export { findFileViewerSearchProvider, findFileViewerZoomProvider, registerFileViewerSearchProvider, registerFileViewerZoomProvider, unregisterFileViewerSearchProvider, unregisterFileViewerZoomProvider, } from './providers';
+export type { FileViewerSearchProviderHost, FileViewerZoomProviderHost, } from './providers';
+export { DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_CANDIDATE_SELECTOR, DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_SELECTOR, DEFAULT_FILE_VIEWER_SCROLLABLE_OVERFLOW_VALUES, getFileViewerScrollableRange, isFileViewerScrollableElement, resolveFileViewerScrollContainer, } from './scroll';
+export type { ResolveFileViewerScrollContainerOptions, } from './scroll';

package/dist/documentDom/index.js

@@ -0,0 +1,3 @@
+export { DEFAULT_FILE_VIEWER_ANCHOR_EXCLUDE_SELECTOR, DEFAULT_FILE_VIEWER_ANCHOR_SELECTOR, collectFileViewerDocumentAnchors, findFileViewerAnchorForElement, getCurrentFileViewerDocumentAnchor, scrollToFileViewerDocumentAnchor, } from './anchors.js';
+export { findFileViewerSearchProvider, findFileViewerZoomProvider, registerFileViewerSearchProvider, registerFileViewerZoomProvider, unregisterFileViewerSearchProvider, unregisterFileViewerZoomProvider, } from './providers.js';
+export { DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_CANDIDATE_SELECTOR, DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_SELECTOR, DEFAULT_FILE_VIEWER_SCROLLABLE_OVERFLOW_VALUES, getFileViewerScrollableRange, isFileViewerScrollableElement, resolveFileViewerScrollContainer, } from './scroll.js';

package/dist/documentDom/providers.d.ts

@@ -0,0 +1,13 @@
+import type { FileViewerSearchProvider, FileViewerZoomProvider } from '../types';
+export interface FileViewerSearchProviderHost extends HTMLElement {
+    __flyfishViewerSearchProvider?: FileViewerSearchProvider;
+}
+export interface FileViewerZoomProviderHost extends HTMLElement {
+    __flyfishViewerZoomProvider?: FileViewerZoomProvider;
+}
+export declare const registerFileViewerSearchProvider: (host: HTMLElement, provider: FileViewerSearchProvider) => void;
+export declare const unregisterFileViewerSearchProvider: (host: HTMLElement | null | undefined) => void;
+export declare const findFileViewerSearchProvider: (root: HTMLElement | null | undefined) => FileViewerSearchProvider | null;
+export declare const registerFileViewerZoomProvider: (host: HTMLElement, provider: FileViewerZoomProvider) => void;
+export declare const unregisterFileViewerZoomProvider: (host: HTMLElement | null | undefined) => void;
+export declare const findFileViewerZoomProvider: (root: HTMLElement | null | undefined) => FileViewerZoomProvider | null;

package/dist/documentDom/providers.js

@@ -0,0 +1,52 @@
+const searchProviderRegistry = new WeakMap();
+const zoomProviderRegistry = new WeakMap();
+export const registerFileViewerSearchProvider = (host, provider) => {
+    searchProviderRegistry.set(host, provider);
+    host.__flyfishViewerSearchProvider = provider;
+};
+export const unregisterFileViewerSearchProvider = (host) => {
+    if (!host) {
+        return;
+    }
+    searchProviderRegistry.delete(host);
+    delete host.__flyfishViewerSearchProvider;
+};
+export const findFileViewerSearchProvider = (root) => {
+    if (!root) {
+        return null;
+    }
+    const direct = searchProviderRegistry.get(root) || root.__flyfishViewerSearchProvider;
+    if (direct) {
+        return direct;
+    }
+    const host = root.querySelector('[data-viewer-search-provider]');
+    return host
+        ? searchProviderRegistry.get(host) || host.__flyfishViewerSearchProvider || null
+        : null;
+};
+export const registerFileViewerZoomProvider = (host, provider) => {
+    zoomProviderRegistry.set(host, provider);
+    host.dataset.viewerZoomProvider = host.dataset.viewerZoomProvider || 'custom';
+    host.__flyfishViewerZoomProvider = provider;
+};
+export const unregisterFileViewerZoomProvider = (host) => {
+    if (!host) {
+        return;
+    }
+    zoomProviderRegistry.delete(host);
+    delete host.dataset.viewerZoomProvider;
+    delete host.__flyfishViewerZoomProvider;
+};
+export const findFileViewerZoomProvider = (root) => {
+    if (!root) {
+        return null;
+    }
+    const direct = zoomProviderRegistry.get(root) || root.__flyfishViewerZoomProvider;
+    if (direct) {
+        return direct;
+    }
+    const host = root.querySelector('[data-viewer-zoom-provider]');
+    return host
+        ? zoomProviderRegistry.get(host) || host.__flyfishViewerZoomProvider || null
+        : null;
+};

package/dist/documentDom/scroll.d.ts

@@ -0,0 +1,12 @@
+export declare const DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_SELECTOR = "[data-viewer-scroll-container], .pdf-wrapper";
+export declare const DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_CANDIDATE_SELECTOR = "div, section, article, pre";
+export declare const DEFAULT_FILE_VIEWER_SCROLLABLE_OVERFLOW_VALUES: readonly ["auto", "scroll", "overlay"];
+export interface ResolveFileViewerScrollContainerOptions {
+    preferredSelector?: string;
+    candidateSelector?: string;
+    overflowValues?: readonly string[];
+    minScrollRange?: number;
+}
+export declare const getFileViewerScrollableRange: (element: HTMLElement) => number;
+export declare const isFileViewerScrollableElement: (element: HTMLElement, options?: ResolveFileViewerScrollContainerOptions) => boolean;
+export declare const resolveFileViewerScrollContainer: (root: HTMLElement | null | undefined, options?: ResolveFileViewerScrollContainerOptions) => HTMLElement | null;

package/dist/documentDom/scroll.js

@@ -0,0 +1,42 @@
+export const DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_SELECTOR = '[data-viewer-scroll-container], .pdf-wrapper';
+export const DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_CANDIDATE_SELECTOR = 'div, section, article, pre';
+export const DEFAULT_FILE_VIEWER_SCROLLABLE_OVERFLOW_VALUES = ['auto', 'scroll', 'overlay'];
+export const getFileViewerScrollableRange = (element) => {
+    return Math.max(0, element.scrollHeight - element.clientHeight);
+};
+export const isFileViewerScrollableElement = (element, options = {}) => {
+    var _a, _b;
+    const minScrollRange = (_a = options.minScrollRange) !== null && _a !== void 0 ? _a : 2;
+    if (getFileViewerScrollableRange(element) <= minScrollRange) {
+        return false;
+    }
+    const ownerView = (_b = element.ownerDocument) === null || _b === void 0 ? void 0 : _b.defaultView;
+    const view = (ownerView === null || ownerView === void 0 ? void 0 : ownerView.getComputedStyle)
+        ? ownerView
+        : (typeof window !== 'undefined' ? window : undefined);
+    if (!(view === null || view === void 0 ? void 0 : view.getComputedStyle)) {
+        return false;
+    }
+    const style = view.getComputedStyle(element);
+    const overflowY = style.overflowY || style.overflow;
+    const overflowValues = options.overflowValues || DEFAULT_FILE_VIEWER_SCROLLABLE_OVERFLOW_VALUES;
+    return overflowValues.includes(overflowY);
+};
+export const resolveFileViewerScrollContainer = (root, options = {}) => {
+    if (!root) {
+        return null;
+    }
+    const preferredSelector = options.preferredSelector || DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_SELECTOR;
+    const candidateSelector = options.candidateSelector || DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_CANDIDATE_SELECTOR;
+    const preferred = root.querySelector(preferredSelector);
+    if (preferred && isFileViewerScrollableElement(preferred, options)) {
+        return preferred;
+    }
+    if (isFileViewerScrollableElement(root, options)) {
+        return root;
+    }
+    const scrollableChildren = Array.from(root.querySelectorAll(candidateSelector))
+        .filter(element => isFileViewerScrollableElement(element, options))
+        .sort((a, b) => getFileViewerScrollableRange(b) - getFileViewerScrollableRange(a));
+    return scrollableChildren[0] || preferred || root;
+};

package/dist/documentDom.d.ts

@@ -0,0 +1,5 @@
+export { DEFAULT_FILE_VIEWER_ANCHOR_EXCLUDE_SELECTOR, DEFAULT_FILE_VIEWER_ANCHOR_SELECTOR, collectFileViewerDocumentAnchors, findFileViewerAnchorForElement, getCurrentFileViewerDocumentAnchor, scrollToFileViewerDocumentAnchor, } from './documentDom/anchors';
+export { findFileViewerSearchProvider, findFileViewerZoomProvider, registerFileViewerSearchProvider, registerFileViewerZoomProvider, unregisterFileViewerSearchProvider, unregisterFileViewerZoomProvider, } from './documentDom/providers';
+export type { FileViewerSearchProviderHost, FileViewerZoomProviderHost, } from './documentDom/providers';
+export { DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_CANDIDATE_SELECTOR, DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_SELECTOR, DEFAULT_FILE_VIEWER_SCROLLABLE_OVERFLOW_VALUES, getFileViewerScrollableRange, isFileViewerScrollableElement, resolveFileViewerScrollContainer, } from './documentDom/scroll';
+export type { ResolveFileViewerScrollContainerOptions, } from './documentDom/scroll';

package/dist/documentDom.js

@@ -0,0 +1,3 @@
+export { DEFAULT_FILE_VIEWER_ANCHOR_EXCLUDE_SELECTOR, DEFAULT_FILE_VIEWER_ANCHOR_SELECTOR, collectFileViewerDocumentAnchors, findFileViewerAnchorForElement, getCurrentFileViewerDocumentAnchor, scrollToFileViewerDocumentAnchor, } from './documentDom/anchors.js';
+export { findFileViewerSearchProvider, findFileViewerZoomProvider, registerFileViewerSearchProvider, registerFileViewerZoomProvider, unregisterFileViewerSearchProvider, unregisterFileViewerZoomProvider, } from './documentDom/providers.js';
+export { DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_CANDIDATE_SELECTOR, DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_SELECTOR, DEFAULT_FILE_VIEWER_SCROLLABLE_OVERFLOW_VALUES, getFileViewerScrollableRange, isFileViewerScrollableElement, resolveFileViewerScrollContainer, } from './documentDom/scroll.js';

package/dist/documentEvents.d.ts

@@ -0,0 +1,73 @@
+import { type FileViewerDomSearchControllerStateTarget } from './documentSearch';
+import type { FileViewerAiOptions, FileViewerDocumentAnchor, FileViewerDocumentChunk, FileViewerSearchOptions, FileViewerSearchState } from './types';
+export interface ResolveFileViewerLocationChangeAnchorInput {
+    root: HTMLElement | null | undefined;
+    anchors: FileViewerDocumentAnchor[];
+}
+export interface CreateFileViewerDocumentChangeSnapshotInput extends ResolveFileViewerLocationChangeAnchorInput {
+    searchState: FileViewerSearchState;
+}
+export interface FileViewerDocumentChangeSnapshot {
+    searchState: FileViewerSearchState;
+    locationAnchor: FileViewerDocumentAnchor | null;
+}
+export interface DispatchFileViewerSearchChangeInput {
+    state: FileViewerSearchState;
+    onChange?: (state: FileViewerSearchState) => void;
+}
+export interface DispatchFileViewerLocationChangeInput {
+    anchor: FileViewerDocumentAnchor | null;
+    onChange?: (anchor: FileViewerDocumentAnchor | null) => void;
+}
+export interface FileViewerDocumentFeatureActionOptions {
+    notify?: boolean;
+}
+export interface FileViewerDocumentFeatureSearchController {
+    getAnchors(): FileViewerDocumentAnchor[];
+    getSearchState(): FileViewerSearchState;
+    observe(): void;
+    refreshAnchors(): Promise<FileViewerDocumentAnchor[]>;
+    search(query: string): Promise<unknown>;
+    clear(): Promise<unknown>;
+    next(): Promise<unknown>;
+    previous(): Promise<unknown>;
+}
+export interface CreateFileViewerDocumentFeatureActionsInput {
+    root: () => HTMLElement | null | undefined;
+    searchController: FileViewerDocumentFeatureSearchController;
+    getAiOptions?: () => boolean | FileViewerAiOptions | undefined;
+    onSearchChange?: (state: FileViewerSearchState) => void;
+    onLocationChange?: (anchor: FileViewerDocumentAnchor | null) => void;
+}
+export interface FileViewerDocumentFeatureActions {
+    refreshDocumentIndex(options?: FileViewerDocumentFeatureActionOptions): Promise<FileViewerDocumentAnchor[]>;
+    clearDocumentState(): Promise<FileViewerSearchState>;
+    getScrollContainer(): HTMLElement | null;
+    searchDocument(query: string): Promise<FileViewerSearchState>;
+    clearDocumentSearch(): Promise<FileViewerSearchState>;
+    nextSearchResult(): Promise<FileViewerSearchState>;
+    previousSearchResult(): Promise<FileViewerSearchState>;
+    getSearchState(): FileViewerSearchState;
+    collectDocumentAnchors(options?: FileViewerDocumentFeatureActionOptions): Promise<FileViewerDocumentAnchor[]>;
+    getCurrentDocumentAnchor(): FileViewerDocumentAnchor | null;
+    scrollToLoadedAnchor(anchor: FileViewerDocumentAnchor | string | number | null | undefined, options?: FileViewerDocumentFeatureActionOptions): boolean;
+    scrollToAnchor(anchor: FileViewerDocumentAnchor | string | number | null | undefined, options?: FileViewerDocumentFeatureActionOptions): Promise<boolean>;
+    scrollToLine(line: number, options?: FileViewerDocumentFeatureActionOptions): Promise<boolean>;
+    getDocumentTextChunks(options?: boolean | FileViewerAiOptions): FileViewerDocumentChunk[];
+}
+export interface CreateFileViewerDocumentFeatureControllerActionHandlersInput extends Omit<CreateFileViewerDocumentFeatureActionsInput, 'searchController'> {
+    searchTarget: FileViewerDomSearchControllerStateTarget;
+    searchOptions?: () => boolean | FileViewerSearchOptions | undefined;
+    waitForDomUpdate?: () => Promise<void> | void;
+    preferredScrollContainer?: () => HTMLElement | null | undefined;
+}
+export interface FileViewerDocumentFeatureControllerActionHandlers extends FileViewerDocumentFeatureActions {
+    destroyDocumentFeatures(): FileViewerSearchState;
+}
+export declare const createFileViewerSearchChangeState: (state: FileViewerSearchState) => FileViewerSearchState;
+export declare const resolveFileViewerLocationChangeAnchor: ({ root, anchors, }: ResolveFileViewerLocationChangeAnchorInput) => FileViewerDocumentAnchor | null;
+export declare const createFileViewerDocumentChangeSnapshot: ({ root, anchors, searchState, }: CreateFileViewerDocumentChangeSnapshotInput) => FileViewerDocumentChangeSnapshot;
+export declare const createFileViewerDocumentFeatureControllerActionHandlers: ({ root, searchTarget, searchOptions, waitForDomUpdate, preferredScrollContainer, getAiOptions, onSearchChange, onLocationChange, }: CreateFileViewerDocumentFeatureControllerActionHandlersInput) => FileViewerDocumentFeatureControllerActionHandlers;
+export declare const dispatchFileViewerSearchChange: ({ state, onChange, }: DispatchFileViewerSearchChangeInput) => boolean;
+export declare const dispatchFileViewerLocationChange: ({ anchor, onChange, }: DispatchFileViewerLocationChangeInput) => boolean;
+export declare const createFileViewerDocumentFeatureActions: ({ root, searchController, getAiOptions, onSearchChange, onLocationChange, }: CreateFileViewerDocumentFeatureActionsInput) => FileViewerDocumentFeatureActions;