@file-viewer/renderer-chm 3.0.1

package/dist/chm.js

@@ -0,0 +1,593 @@
+import { assertChmSvgSourceSafety, decodeChmText, MAX_CHM_CSS_TEXT_LENGTH, MAX_CHM_CSS_RESOURCE_PATHS, MAX_CHM_SVG_TEXT_LENGTH, MAX_CHM_TOPIC_RESOURCE_PATHS, normalizeChmPath, sanitizeChmCss, sanitizeChmHtmlDocument, } from './security.js';
+import { chmViewerStyle } from './style.js';
+import { ChmWorkerClient } from './workerClient.js';
+const MAX_RENDERED_NAVIGATION_ITEMS = 12000;
+const MAX_LOADED_RESOURCE_PATHS = 4096;
+const HTML_EXTENSIONS = new Set(['htm', 'html', 'xhtml', 'shtml']);
+const messages = {
+    'zh-CN': {
+        contents: '目录', index: '索引', search: '搜索', searchPlaceholder: '搜索主题和正文',
+        loading: '正在打开 CHM…', wasm: '正在加载本地 WASM…', directory: '正在读取 CHM 目录…',
+        manifest: '正在构建帮助目录…', searching: '正在搜索…', noContents: '没有可显示的目录。',
+        noIndex: '没有可显示的关键词索引。', searchHint: '输入至少两个字符搜索当前 CHM。',
+        noResults: '没有找到匹配内容。', truncated: '结果已按安全与性能上限截断。',
+        error: 'CHM 预览失败', topics: '个主题', ready: '离线安全预览', binaryToc: '二进制目录',
+        fullText: '全文索引', menu: '目录', opening: '正在打开主题…', unavailable: '没有找到可打开的主题。',
+    },
+    'en-US': {
+        contents: 'Contents', index: 'Index', search: 'Search', searchPlaceholder: 'Search topics and text',
+        loading: 'Opening CHM…', wasm: 'Loading local WASM…', directory: 'Reading the CHM directory…',
+        manifest: 'Building help navigation…', searching: 'Searching…', noContents: 'No table of contents is available.',
+        noIndex: 'No keyword index is available.', searchHint: 'Enter at least two characters to search this CHM.',
+        noResults: 'No matching content was found.', truncated: 'Results were truncated at the configured safety limit.',
+        error: 'CHM preview failed', topics: 'topics', ready: 'Safe offline preview', binaryToc: 'Binary TOC',
+        fullText: 'Full-text index', menu: 'Menu', opening: 'Opening topic…', unavailable: 'No readable topic was found.',
+    },
+};
+const resolveLocale = (context) => {
+    var _a;
+    const configured = (_a = context === null || context === void 0 ? void 0 : context.options) === null || _a === void 0 ? void 0 : _a.locale;
+    const candidate = configured && configured !== 'auto'
+        ? configured
+        : typeof navigator === 'undefined' ? 'en-US' : navigator.language;
+    return candidate.toLowerCase().startsWith('zh') ? 'zh-CN' : 'en-US';
+};
+const createElement = (tag, className, text) => {
+    const element = document.createElement(tag);
+    if (className)
+        element.className = className;
+    if (text != null)
+        element.textContent = text;
+    return element;
+};
+const extensionOf = (path) => {
+    const filename = path.split('/').pop() || '';
+    const index = filename.lastIndexOf('.');
+    return index >= 0 ? filename.slice(index + 1).toLowerCase() : '';
+};
+const mimeTypeForPath = (path) => {
+    const extension = extensionOf(path);
+    const types = {
+        css: 'text/css;charset=utf-8', gif: 'image/gif', jpeg: 'image/jpeg', jpg: 'image/jpeg',
+        png: 'image/png', webp: 'image/webp', avif: 'image/avif', bmp: 'image/bmp', ico: 'image/x-icon',
+        svg: 'image/svg+xml', mp3: 'audio/mpeg', wav: 'audio/wav', ogg: 'audio/ogg', mp4: 'video/mp4',
+        webm: 'video/webm', woff: 'font/woff', woff2: 'font/woff2', ttf: 'font/ttf', otf: 'font/otf',
+    };
+    return types[extension] || 'application/octet-stream';
+};
+const sanitizeEmbeddedSvgCss = (value) => sanitizeChmCss(value, '/', 0).css;
+const sanitizeSvg = (source) => {
+    assertChmSvgSourceSafety(source);
+    const document = new DOMParser().parseFromString(source, 'image/svg+xml');
+    if (document.querySelector('parsererror'))
+        return '';
+    document.querySelectorAll('script,foreignObject,iframe,object,embed').forEach(element => element.remove());
+    document.querySelectorAll('style').forEach(style => {
+        style.textContent = sanitizeEmbeddedSvgCss(style.textContent || '');
+    });
+    document.querySelectorAll('*').forEach(element => {
+        for (const attribute of Array.from(element.attributes)) {
+            const name = attribute.name.toLowerCase();
+            const value = attribute.value.trim();
+            if (name.startsWith('on')) {
+                element.removeAttribute(attribute.name);
+                continue;
+            }
+            if ((name === 'href' || name === 'xlink:href')
+                && !value.startsWith('#')
+                && !/^data:image\/(?:avif|bmp|gif|jpeg|png|webp);/i.test(value)) {
+                element.removeAttribute(attribute.name);
+                continue;
+            }
+            if (name !== 'href' && name !== 'xlink:href'
+                && /(?:url\s*\(|@import\b|expression\s*\(|behavior\s*:|-moz-binding|\\|\/\*)/i.test(value)) {
+                element.setAttribute(attribute.name, sanitizeEmbeddedSvgCss(value));
+            }
+        }
+    });
+    return new XMLSerializer().serializeToString(document.documentElement);
+};
+const INTERNAL_CSS_RESOURCE_PATTERN = /url\("chm-internal:([^"]+)"\)/g;
+const loadResourceMap = async (paths, loadResource, ancestry, maxResourcePaths = MAX_CHM_CSS_RESOURCE_PATHS) => {
+    const uniquePaths = Array.from(new Set(paths)).slice(0, maxResourcePaths);
+    const replacements = new Map();
+    let cursor = 0;
+    const runners = Array.from({ length: Math.min(8, uniquePaths.length) }, async () => {
+        while (cursor < uniquePaths.length) {
+            const path = uniquePaths[cursor++];
+            const normalized = normalizeChmPath(path);
+            const url = normalized && normalized !== '/'
+                ? await loadResource(normalized, ancestry)
+                : null;
+            if (normalized)
+                replacements.set(normalized.toLocaleLowerCase(), url || '');
+        }
+    });
+    await Promise.all(runners);
+    return replacements;
+};
+const replaceInternalCssResourceUrls = (css, replacements) => css.replace(INTERNAL_CSS_RESOURCE_PATTERN, (_match, encoded) => {
+    let path = '';
+    try {
+        path = decodeURIComponent(encoded);
+    }
+    catch {
+        return 'url("")';
+    }
+    const normalized = normalizeChmPath(path);
+    return `url("${normalized ? replacements.get(normalized.toLocaleLowerCase()) || '' : ''}")`;
+});
+const replaceCssResourceUrls = async (css, resourcePaths, loadResource, ancestry) => replaceInternalCssResourceUrls(css, await loadResourceMap(resourcePaths, loadResource, ancestry));
+const flatNavigation = (nodes) => {
+    const output = [];
+    const stack = nodes.slice().reverse().map(node => ({ node, depth: 0 }));
+    while (stack.length && output.length < MAX_RENDERED_NAVIGATION_ITEMS) {
+        const current = stack.pop();
+        if (!current)
+            continue;
+        output.push(current);
+        for (let index = current.node.children.length - 1; index >= 0; index -= 1) {
+            stack.push({ node: current.node.children[index], depth: current.depth + 1 });
+        }
+    }
+    return output;
+};
+const highlightSnippet = (target, text, query) => {
+    const index = text.toLocaleLowerCase().indexOf(query.toLocaleLowerCase());
+    if (index < 0) {
+        target.textContent = text;
+        return;
+    }
+    target.append(document.createTextNode(text.slice(0, index)), createElement('mark', undefined, text.slice(index, index + query.length)), document.createTextNode(text.slice(index + query.length)));
+};
+export default async function renderChm(buffer, target, _type, context) {
+    var _a, _b, _c, _d;
+    const locale = resolveLocale(context);
+    const t = (key) => messages[locale][key];
+    const options = (_a = context === null || context === void 0 ? void 0 : context.options) === null || _a === void 0 ? void 0 : _a.chm;
+    const abortController = new AbortController();
+    const objectUrls = new Set();
+    const resourceUrls = new Map();
+    const listeners = [];
+    let client;
+    let destroyed = false;
+    let manifest;
+    let entries = [];
+    let entryLookup = new Map();
+    let currentHtml = '';
+    let topicGeneration = 0;
+    let searchGeneration = 0;
+    let searchTimer;
+    const style = createElement('style');
+    style.textContent = chmViewerStyle;
+    const root = createElement('section', 'chm-viewer');
+    root.dataset.chmReady = 'false';
+    const theme = ((_b = context === null || context === void 0 ? void 0 : context.options) === null || _b === void 0 ? void 0 : _b.theme) || 'light';
+    target.dataset.viewerTheme = theme;
+    const header = createElement('header', 'chm-header');
+    const sidebarToggle = createElement('button', 'chm-sidebar-toggle', '☰');
+    sidebarToggle.type = 'button';
+    sidebarToggle.title = t('menu');
+    sidebarToggle.setAttribute('aria-label', t('menu'));
+    const heading = createElement('div', 'chm-heading');
+    const title = createElement('h2', undefined, (context === null || context === void 0 ? void 0 : context.filename) || 'CHM');
+    const subtitle = createElement('p', undefined, t('loading'));
+    heading.append(title, subtitle);
+    const badges = createElement('div', 'chm-badges');
+    header.append(sidebarToggle, heading, badges);
+    const body = createElement('div', 'chm-body');
+    const sidebar = createElement('aside', 'chm-sidebar');
+    const tabs = createElement('div', 'chm-tabs');
+    const panels = createElement('div', 'chm-sidebar-panels');
+    const contentsPanel = createElement('section', 'chm-panel');
+    contentsPanel.dataset.chmPanel = 'contents';
+    const indexPanel = createElement('section', 'chm-panel');
+    indexPanel.dataset.chmPanel = 'index';
+    indexPanel.hidden = true;
+    const searchPanel = createElement('section', 'chm-panel chm-search');
+    searchPanel.dataset.chmPanel = 'search';
+    searchPanel.hidden = true;
+    const searchBox = createElement('div', 'chm-search-box');
+    const searchInput = createElement('input');
+    searchInput.type = 'search';
+    searchInput.placeholder = t('searchPlaceholder');
+    searchInput.setAttribute('aria-label', t('search'));
+    const searchMeta = createElement('div', 'chm-search-meta', t('searchHint'));
+    const searchResults = createElement('div', 'chm-search-results');
+    searchBox.append(searchInput);
+    searchPanel.append(searchBox, searchMeta, searchResults);
+    panels.append(contentsPanel, indexPanel, searchPanel);
+    sidebar.append(tabs, panels);
+    const topic = createElement('main', 'chm-topic');
+    const topicBar = createElement('div', 'chm-topic-bar');
+    const topicTitle = createElement('strong', undefined, t('loading'));
+    const topicPath = createElement('span', 'chm-topic-path');
+    topicBar.append(topicTitle, topicPath);
+    const frame = createElement('iframe', 'chm-topic-frame');
+    frame.setAttribute('sandbox', 'allow-same-origin');
+    frame.setAttribute('referrerpolicy', 'no-referrer');
+    frame.title = (context === null || context === void 0 ? void 0 : context.filename) || 'CHM topic';
+    topic.append(topicBar, frame);
+    body.append(sidebar, topic);
+    const state = createElement('div', 'chm-state');
+    const spinner = createElement('span', 'chm-spinner');
+    const stateText = createElement('p', undefined, t('loading'));
+    state.append(spinner, stateText);
+    const errorPanel = createElement('div', 'chm-error');
+    errorPanel.hidden = true;
+    errorPanel.append(createElement('strong', undefined, t('error')), createElement('p'));
+    root.append(header, body, state);
+    target.replaceChildren(style, root);
+    const listen = (node, type, handler) => {
+        node.addEventListener(type, handler);
+        listeners.push(() => node.removeEventListener(type, handler));
+    };
+    const showState = (text, visible = true) => {
+        stateText.textContent = text;
+        state.hidden = !visible;
+    };
+    const showError = (error) => {
+        showState('', false);
+        const paragraph = errorPanel.querySelector('p');
+        if (paragraph)
+            paragraph.textContent = error instanceof Error ? error.message : String(error);
+        errorPanel.hidden = false;
+        if (!errorPanel.isConnected)
+            root.append(errorPanel);
+    };
+    const onProgress = (progress) => {
+        if (root.dataset.chmReady === 'true') {
+            if (progress.phase === 'search')
+                searchMeta.textContent = t('searching');
+            return;
+        }
+        if (progress.phase === 'wasm')
+            showState(t('wasm'));
+        else if (progress.phase === 'directory')
+            showState(t('directory'));
+        else if (progress.phase === 'manifest')
+            showState(t('manifest'));
+    };
+    const resolveEntryPath = (path) => {
+        const normalized = normalizeChmPath(path);
+        if (!normalized)
+            return null;
+        return entryLookup.get(normalized.toLocaleLowerCase()) || null;
+    };
+    const loadResource = async (path, ancestry = new Set()) => {
+        const actualPath = resolveEntryPath(path);
+        if (!actualPath || !client || destroyed)
+            return null;
+        const key = actualPath.toLocaleLowerCase();
+        if (ancestry.has(key))
+            return null;
+        const cached = resourceUrls.get(key);
+        if (cached)
+            return cached;
+        if (resourceUrls.size >= MAX_LOADED_RESOURCE_PATHS)
+            return null;
+        const promise = (async () => {
+            try {
+                const bytes = await (client === null || client === void 0 ? void 0 : client.read(actualPath, abortController.signal));
+                if (!bytes || bytes.byteLength > ((client === null || client === void 0 ? void 0 : client.options.maxEntryBytes) || 0))
+                    return null;
+                const extension = extensionOf(actualPath);
+                let blob;
+                if (extension === 'css') {
+                    // @import is removed by the sanitizer. A CSS file referenced from a
+                    // CSS url() is a non-renderable resource and must not start a graph.
+                    if (ancestry.size > 0)
+                        return null;
+                    if (bytes.byteLength > MAX_CHM_CSS_TEXT_LENGTH)
+                        return null;
+                    const nextAncestry = new Set(ancestry);
+                    nextAncestry.add(key);
+                    const sanitizedCss = sanitizeChmCss(decodeChmText(bytes, manifest === null || manifest === void 0 ? void 0 : manifest.encoding), actualPath);
+                    const css = await replaceCssResourceUrls(sanitizedCss.css, sanitizedCss.resourcePaths, loadResource, nextAncestry);
+                    blob = new Blob([css], { type: 'text/css;charset=utf-8' });
+                }
+                else if (extension === 'svg') {
+                    if (bytes.byteLength > MAX_CHM_SVG_TEXT_LENGTH)
+                        return null;
+                    const svg = sanitizeSvg(decodeChmText(bytes, 'utf-8'));
+                    if (!svg)
+                        return null;
+                    blob = new Blob([svg], { type: 'image/svg+xml' });
+                }
+                else {
+                    const copy = new Uint8Array(bytes.byteLength);
+                    copy.set(bytes);
+                    blob = new Blob([copy.buffer], { type: mimeTypeForPath(actualPath) });
+                }
+                const url = URL.createObjectURL(blob);
+                objectUrls.add(url);
+                return url;
+            }
+            catch {
+                return null;
+            }
+        })();
+        resourceUrls.set(key, promise);
+        return promise;
+    };
+    const hydrateTopic = async (html, basePath) => {
+        const sanitized = sanitizeChmHtmlDocument(html, basePath, false);
+        const { document } = sanitized;
+        const replacements = await loadResourceMap(sanitized.resourcePaths, loadResource, new Set(), MAX_CHM_TOPIC_RESOURCE_PATHS);
+        const resourceAttributes = ['src', 'poster', 'href', 'xlink-href', 'background', 'lowsrc', 'dynsrc'];
+        for (const attribute of resourceAttributes) {
+            document.querySelectorAll(`[data-chm-resource-${attribute}]`).forEach(element => {
+                const dataAttribute = `data-chm-resource-${attribute}`;
+                const path = normalizeChmPath(element.getAttribute(dataAttribute) || '');
+                const url = path ? replacements.get(path.toLocaleLowerCase()) : '';
+                element.removeAttribute(dataAttribute);
+                if (!url)
+                    return;
+                if (attribute === 'xlink-href')
+                    element.setAttributeNS('http://www.w3.org/1999/xlink', 'href', url);
+                else
+                    element.setAttribute(attribute, url);
+            });
+        }
+        for (const style of Array.from(document.querySelectorAll('style'))) {
+            style.textContent = replaceInternalCssResourceUrls(style.textContent || '', replacements);
+        }
+        for (const element of Array.from(document.querySelectorAll('[style]'))) {
+            element.setAttribute('style', replaceInternalCssResourceUrls(element.getAttribute('style') || '', replacements));
+        }
+        return {
+            html: `<!doctype html>${document.documentElement.outerHTML}`,
+            title: sanitized.title,
+        };
+    };
+    const syncActiveNavigation = (path) => {
+        root.querySelectorAll('[data-chm-path].is-active').forEach(element => element.classList.remove('is-active'));
+        const folded = path.toLocaleLowerCase();
+        root.querySelectorAll('[data-chm-path]').forEach(element => {
+            if ((element.dataset.chmPath || '').toLocaleLowerCase() === folded)
+                element.classList.add('is-active');
+        });
+    };
+    const scrollToFragment = (fragment) => {
+        if (!fragment)
+            return;
+        const document = frame.contentDocument;
+        const target = (document === null || document === void 0 ? void 0 : document.getElementById(fragment)) || (document === null || document === void 0 ? void 0 : document.getElementsByName(fragment)[0]);
+        target === null || target === void 0 ? void 0 : target.scrollIntoView({ block: 'start' });
+    };
+    const openTopic = async (path, fragment) => {
+        var _a, _b;
+        const generation = ++topicGeneration;
+        const actualPath = resolveEntryPath(path);
+        if (!actualPath || !client)
+            throw new Error(`CHM_ENTRY_NOT_FOUND: ${path}`);
+        showState(t('opening'));
+        try {
+            const bytes = await client.read(actualPath, abortController.signal);
+            if (bytes.byteLength > client.options.maxHtmlBytes) {
+                throw new Error(`CHM_LIMIT_EXCEEDED: topic ${actualPath} is too large to render safely.`);
+            }
+            const hydrated = await hydrateTopic(decodeChmText(bytes, manifest === null || manifest === void 0 ? void 0 : manifest.encoding), actualPath);
+            if (destroyed || generation !== topicGeneration)
+                return;
+            currentHtml = hydrated.html;
+            const canonicalPath = normalizeChmPath(actualPath) || actualPath;
+            topicTitle.textContent = hydrated.title || ((_a = manifest === null || manifest === void 0 ? void 0 : manifest.topics.find(item => { var _a; return ((_a = normalizeChmPath(item.path)) === null || _a === void 0 ? void 0 : _a.toLocaleLowerCase()) === canonicalPath.toLocaleLowerCase(); })) === null || _a === void 0 ? void 0 : _a.title) || actualPath;
+            topicPath.textContent = canonicalPath;
+            frame.srcdoc = hydrated.html;
+            frame.onload = () => {
+                if (destroyed || generation !== topicGeneration)
+                    return;
+                const frameDocument = frame.contentDocument;
+                if (frameDocument) {
+                    frameDocument.addEventListener('click', event => {
+                        const eventTarget = event.target;
+                        const anchor = eventTarget instanceof Element ? eventTarget.closest('a[data-chm-link-kind],area[data-chm-link-kind]') : null;
+                        if (!anchor)
+                            return;
+                        event.preventDefault();
+                        const kind = anchor.dataset.chmLinkKind;
+                        const nextPath = anchor.dataset.chmPath;
+                        const nextFragment = anchor.dataset.chmFragment;
+                        if (kind === 'fragment')
+                            scrollToFragment(nextFragment);
+                        else if (kind === 'internal' && nextPath)
+                            void openTopic(nextPath, nextFragment).catch(showError);
+                    });
+                }
+                scrollToFragment(fragment);
+            };
+            syncActiveNavigation(canonicalPath);
+            root.classList.remove('is-sidebar-open');
+            errorPanel.remove();
+            errorPanel.hidden = true;
+            showState('', false);
+            (_b = context === null || context === void 0 ? void 0 : context.onProgressiveRender) === null || _b === void 0 ? void 0 : _b.call(context);
+        }
+        catch (error) {
+            if (generation === topicGeneration && !destroyed)
+                showError(error);
+            throw error;
+        }
+    };
+    const appendNavigation = (panel, nodes, emptyText) => {
+        panel.replaceChildren();
+        const flattened = flatNavigation(nodes);
+        if (!flattened.length) {
+            panel.append(createElement('p', 'chm-panel-note', emptyText));
+            return;
+        }
+        const list = createElement('ul', 'chm-navigation');
+        const parentByDepth = new Map([[0, list]]);
+        for (const { node, depth } of flattened) {
+            const parent = parentByDepth.get(depth) || list;
+            const item = createElement('li');
+            const normalizedPath = node.path ? normalizeChmPath(node.path) : null;
+            const label = normalizedPath
+                ? createElement('button', 'chm-nav-button', node.title || normalizedPath)
+                : createElement('div', 'chm-nav-label', node.title);
+            if (label instanceof HTMLButtonElement && normalizedPath) {
+                label.type = 'button';
+                label.dataset.chmPath = normalizedPath;
+            }
+            item.append(label);
+            if (node.children.length) {
+                const children = createElement('ul');
+                item.append(children);
+                parentByDepth.set(depth + 1, children);
+            }
+            else {
+                parentByDepth.delete(depth + 1);
+            }
+            parent.append(item);
+        }
+        panel.append(list);
+        if (flattened.length >= MAX_RENDERED_NAVIGATION_ITEMS) {
+            panel.append(createElement('p', 'chm-panel-note', t('truncated')));
+        }
+    };
+    const selectTab = (name) => {
+        tabs.querySelectorAll('.chm-tab').forEach(button => button.classList.toggle('is-active', button.dataset.chmTab === name));
+        panels.querySelectorAll('.chm-panel').forEach(panel => { panel.hidden = panel.dataset.chmPanel !== name; });
+        if (name === 'search')
+            searchInput.focus();
+    };
+    ['contents', 'index', 'search'].forEach((name, index) => {
+        const button = createElement('button', `chm-tab${index === 0 ? ' is-active' : ''}`, t(name));
+        button.type = 'button';
+        button.dataset.chmTab = name;
+        button.setAttribute('aria-label', t(name));
+        tabs.append(button);
+    });
+    const renderSearchHits = (hits, query, truncated) => {
+        searchResults.replaceChildren();
+        if (!hits.length) {
+            searchMeta.textContent = t('noResults');
+            return;
+        }
+        searchMeta.textContent = truncated ? `${hits.length} · ${t('truncated')}` : String(hits.length);
+        for (const hit of hits) {
+            const button = createElement('button', 'chm-search-result');
+            button.type = 'button';
+            button.dataset.chmSearchResult = 'true';
+            button.dataset.chmPath = hit.path;
+            const heading = createElement('strong');
+            highlightSnippet(heading, hit.title, query);
+            const snippet = createElement('span');
+            highlightSnippet(snippet, hit.snippet || hit.path, query);
+            button.append(heading, snippet);
+            searchResults.append(button);
+        }
+    };
+    const runSearch = async () => {
+        const query = searchInput.value.trim();
+        const generation = ++searchGeneration;
+        if (query.length < 2 || !client) {
+            searchResults.replaceChildren();
+            searchMeta.textContent = t('searchHint');
+            return;
+        }
+        searchMeta.textContent = t('searching');
+        try {
+            const result = await client.search(query, abortController.signal);
+            if (!destroyed && generation === searchGeneration)
+                renderSearchHits(result.hits, query, result.truncated);
+        }
+        catch (error) {
+            if (!destroyed && generation === searchGeneration)
+                searchMeta.textContent = error instanceof Error ? error.message : String(error);
+        }
+    };
+    listen(sidebarToggle, 'click', () => root.classList.toggle('is-sidebar-open'));
+    listen(tabs, 'click', event => {
+        const button = event.target instanceof Element ? event.target.closest('[data-chm-tab]') : null;
+        const name = button === null || button === void 0 ? void 0 : button.dataset.chmTab;
+        if (name === 'contents' || name === 'index' || name === 'search')
+            selectTab(name);
+    });
+    listen(panels, 'click', event => {
+        const button = event.target instanceof Element ? event.target.closest('[data-chm-path]') : null;
+        if (button === null || button === void 0 ? void 0 : button.dataset.chmPath)
+            void openTopic(button.dataset.chmPath).catch(() => undefined);
+    });
+    listen(searchInput, 'input', () => {
+        if (searchTimer)
+            clearTimeout(searchTimer);
+        searchTimer = setTimeout(() => void runSearch(), 350);
+    });
+    const destroy = () => {
+        var _a;
+        if (destroyed)
+            return;
+        destroyed = true;
+        topicGeneration += 1;
+        searchGeneration += 1;
+        if (searchTimer)
+            clearTimeout(searchTimer);
+        abortController.abort();
+        frame.onload = null;
+        listeners.splice(0).forEach(dispose => dispose());
+        client === null || client === void 0 ? void 0 : client.destroy();
+        client = undefined;
+        for (const url of objectUrls)
+            URL.revokeObjectURL(url);
+        objectUrls.clear();
+        resourceUrls.clear();
+        (_a = context === null || context === void 0 ? void 0 : context.registerExportAdapter) === null || _a === void 0 ? void 0 : _a.call(context, null);
+        root.remove();
+        style.remove();
+    };
+    const abortFromContext = () => destroy();
+    (_c = context === null || context === void 0 ? void 0 : context.signal) === null || _c === void 0 ? void 0 : _c.addEventListener('abort', abortFromContext, { once: true });
+    listeners.push(() => { var _a; return (_a = context === null || context === void 0 ? void 0 : context.signal) === null || _a === void 0 ? void 0 : _a.removeEventListener('abort', abortFromContext); });
+    (_d = context === null || context === void 0 ? void 0 : context.registerExportAdapter) === null || _d === void 0 ? void 0 : _d.call(context, {
+        print: true,
+        exportHtml: true,
+        includeDocumentStyles: true,
+        toHtml: () => currentHtml || root.outerHTML,
+        printStyle: '.chm-sidebar,.chm-header,.chm-topic-bar{display:none!important}.chm-topic-frame{height:auto!important}',
+    });
+    try {
+        client = new ChmWorkerClient(options, onProgress);
+        const result = await client.open(buffer, abortController.signal);
+        if (destroyed)
+            return { $el: root, destroy };
+        manifest = result.manifest;
+        entries = result.entries;
+        entryLookup = new Map(entries.flatMap(entry => {
+            const normalized = normalizeChmPath(entry.path);
+            return normalized ? [[normalized.toLocaleLowerCase(), entry.path]] : [];
+        }));
+        title.textContent = manifest.title || (context === null || context === void 0 ? void 0 : context.filename) || 'CHM';
+        subtitle.textContent = `${manifest.topics.length} ${t('topics')}`;
+        badges.replaceChildren(createElement('span', 'chm-badge', t('ready')));
+        if (manifest.hasBinaryToc)
+            badges.append(createElement('span', 'chm-badge is-muted', t('binaryToc')));
+        if (manifest.hasFullTextIndex)
+            badges.append(createElement('span', 'chm-badge is-muted', t('fullText')));
+        const fallbackContents = manifest.topics.map(item => ({ title: item.title, path: item.path, children: [] }));
+        appendNavigation(contentsPanel, manifest.contents.length ? manifest.contents : fallbackContents, t('noContents'));
+        appendNavigation(indexPanel, manifest.index, t('noIndex'));
+        const candidates = [manifest.homePath, ...manifest.topics.map(item => item.path), ...entries
+                .filter(entry => HTML_EXTENSIONS.has(extensionOf(entry.path))).map(entry => entry.path)];
+        const homePath = candidates.find(candidate => Boolean(candidate && resolveEntryPath(candidate)));
+        if (!homePath)
+            throw new Error(`CHM_NO_TOPIC: ${t('unavailable')}`);
+        await openTopic(homePath);
+        if (destroyed)
+            return { $el: root, destroy };
+        root.dataset.chmReady = 'true';
+        errorPanel.remove();
+        errorPanel.hidden = true;
+        root.dispatchEvent(new CustomEvent('file-viewer:chm-ready', {
+            bubbles: true,
+            composed: true,
+            detail: { title: manifest.title, homePath: normalizeChmPath(homePath), topicCount: manifest.topics.length },
+        }));
+    }
+    catch (error) {
+        if (!destroyed)
+            showError(error);
+    }
+    return { $el: root, destroy };
+}

package/dist/chm.worker.d.ts

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

package/dist/chm.worker.js

@@ -0,0 +1,2 @@
+var H=/[\u0000-\u001f\u007f]/;var re=16*1024*1024;var ie=8*1024*1024;var oe=4*1024*1024,W=4*1024*1024,X=(e=Number.POSITIVE_INFINITY)=>{let t=[],n="",r=0;return{append:o=>{if(!o||r>=e)return;let a=e-r,s=o.length>a?o.slice(0,a):o;if(r+=s.length,n.length+s.length<=16384){n+=s;return}n&&t.push(n),s.length>16384?(t.push(s),n=""):n=s},get length(){return r},finish:()=>(n&&t.push(n),t.join(""))}};var j=e=>{try{return decodeURIComponent(e)}catch{return e}},A=e=>{if(typeof e!="string"||H.test(e))return null;let t=e.trim();if(!t||t.length>4096)return null;let n=j(t);if(/^(?:[a-z]:[\\/]|[\\/]{2})/i.test(n))return null;let r=n.replace(/\\/g,"/"),i=[];for(let o of r.split("/"))if(!(!o||o===".")){if(o===".."){if(!i.length)return null;i.pop();continue}if(H.test(o))return null;i.push(o)}return`/${i.join("/")}`};var L=e=>{let t=(e||"").trim().toLowerCase().replace(/_/g,"-");return t?t==="utf8"?"utf-8":t==="gbk"||t==="cp936"?"gb18030":t==="big5-hkscs"?"big5":t==="shift-jis"||t==="sjis"||t==="cp932"?"shift_jis":t==="euc-kr"||t==="cp949"?"euc-kr":/^windows-?\d+$/.test(t)?t.replace(/^windows-?/,"windows-"):/^cp\d+$/.test(t)?t.replace(/^cp/,"windows-"):t:""},F=e=>{let t=e.subarray(0,Math.min(e.byteLength,8192)),n="";for(let i=0;i<t.byteLength;i+=1){let o=t[i];n+=o>=32&&o<=126?String.fromCharCode(o):" "}let r=n.match(/<meta\b[^>]*\bcharset\s*=\s*["']?\s*([^\s"'/>;]+)/i)||n.match(/<meta\b[^>]*\bcontent\s*=\s*["'][^"']*charset\s*=\s*([^\s"'/>;]+)/i);return L(r?.[1])},b=(e,t)=>{try{return new TextDecoder(t,{fatal:!1}).decode(e)}catch{return""}},v=(e,t="windows-1252")=>{if(e.byteLength>=3&&e[0]===239&&e[1]===187&&e[2]===191)return b(e.subarray(3),"utf-8");if(e.byteLength>=2&&e[0]===255&&e[1]===254)return b(e.subarray(2),"utf-16le");if(e.byteLength>=2&&e[0]===254&&e[1]===255){let r=new Uint8Array(e.byteLength-2);for(let i=2;i+1<e.byteLength;i+=2)r[i-2]=e[i+1],r[i-1]=e[i];return b(r,"utf-16le")}let n=[F(e),L(t),"utf-8","windows-1252"];for(let r of n){if(!r)continue;let i=b(e,r);if(i)return i.replace(/^\ufeff/,"")}return""},E=e=>e===" "||e==="	"||e===`
+`||e==="\f"||e==="\r",I=e=>{if(!e)return!1;let t=e.charCodeAt(0);return t>=48&&t<=57||t>=65&&t<=90||t>=97&&t<=122||e===":"||e==="_"||e==="-"},q=(e,t,n)=>{if(t+n.length>e.length)return!1;for(let r=0;r<n.length;r+=1){let i=e.charCodeAt(t+r),o=n.charCodeAt(r);if((i>=65&&i<=90?i+32:i)!==o)return!1}return!0},B=(e,t)=>{let n=t,r="";for(;n<e.length;){let i=e[n];if(r)i===r&&(r="");else if(i==='"'||i==="'")r=i;else if(i===">")return n+1;n+=1}return e.length},V=(e,t,n)=>{let r=t;for(;r<e.length;){if(e[r]==="<"&&e[r+1]==="/"&&q(e,r+2,n)&&!I(e[r+2+n.length]))return B(e,r+2+n.length);r+=1}return e.length},G=(e,t)=>{let n=t+1,r=Math.min(e.length,t+13);for(;n<r&&e[n]!==";";){if(e[n]==="&"||e[n]==="<"||E(e[n]))return null;n+=1}if(n>=r||e[n]!==";")return null;let i=e.slice(t+1,n).toLowerCase(),o={amp:"&",apos:"'",gt:">",lt:"<",nbsp:" ",quot:'"'};if(o[i]!=null)return{end:n+1,value:o[i]};let a=i.startsWith("#x")?Number.parseInt(i.slice(2),16):i.startsWith("#")?Number.parseInt(i.slice(1),10):Number.NaN;return!Number.isFinite(a)||a<=0||a>1114111||a>=55296&&a<=57343?null:{end:n+1,value:String.fromCodePoint(a)}},N=(e,t=W)=>{let n=X(Math.max(0,t)),r=0,i=!1,o=a=>{if(a){if(E(a)){i=n.length>0;return}i&&n.length<t&&n.append(" "),i=!1,n.append(a)}};for(;r<e.length;){let a=e[r];if(a==="<"){if(i=n.length>0,e.startsWith("<!--",r)){let m=e.indexOf("-->",r+4);r=m<0?e.length:m+3;continue}let s=r+1,l=e[s]==="/";for(l&&(s+=1);E(e[s]);)s+=1;let c=s;for(;I(e[s]);)s+=1;let u=e.slice(c,s).toLowerCase(),g=B(e,s);r=!l&&(u==="script"||u==="style")?V(e,g,u):g;continue}if(a==="&"){let s=G(e,r);if(s){o(s.value),r=s.end;continue}}o(a),r+=1}return n.finish().trim()};var ae=Object.freeze({workerTimeoutMs:6e4,maxArchiveBytes:335544320,maxEntries:5e4,maxEntryBytes:33554432,maxTotalDecompressedBytes:536870912,maxHtmlBytes:16777216,maxSearchTopics:1e4,maxSearchResults:200}),C=1024*1024,ce=Object.freeze({maxArchiveBytes:1024*C,maxEntries:25e4,maxEntryBytes:512*C,maxTotalDecompressedBytes:8*1024*C,maxHtmlBytes:64*C});var f=e=>typeof e=="string"?e:"",_=e=>typeof e=="number"&&Number.isFinite(e)?e:void 0,k=e=>e===!0,K=e=>{if(!e||typeof e!="object")return null;let t=e,n=f(t.path||t.local||t.url);return n?{title:f(t.title||t.name)||n,path:n,contextId:_(t.contextId??t.context_id)}:null},R=e=>{if(!Array.isArray(e))return[];let t=[],n=[];for(let r=e.length-1;r>=0;r-=1)n.push({source:e[r],target:t});for(;n.length;){let r=n.pop();if(!r?.source||typeof r.source!="object")continue;let i=r.source,o=[],a={title:f(i.title||i.name||i.keyword)||f(i.path||i.local),path:f(i.path||i.local||i.url)||void 0,keyword:f(i.keyword)||void 0,children:o};r.target.push(a);let s=Array.isArray(i.locals)?i.locals.filter(c=>typeof c=="string"&&!!c):[];!a.path&&s.length&&(a.path=s[0]);for(let c=a.path?1:0;c<s.length;c+=1)o.push({title:`${a.title} \xB7 ${c+1}`,path:s[c],children:[]});let l=Array.isArray(i.children)?i.children:[];for(let c=l.length-1;c>=0;c-=1)n.push({source:l[c],target:o})}return t},D=e=>{let t=e&&typeof e=="object"?e:{},n=Array.isArray(t.topics)?t.topics.map(K).filter(r=>!!r):[];return{title:f(t.title),homePath:f(t.homePath??t.home_path),encoding:f(t.encoding)||"windows-1252",language:f(t.language)||void 0,topics:n,contents:R(t.contents??t.toc),index:R(t.index??t.keywords),hasBinaryToc:k(t.hasBinaryToc??t.has_binary_toc),hasBinaryIndex:k(t.hasBinaryIndex??t.has_binary_index),hasFullTextIndex:k(t.hasFullTextIndex??t.has_full_text_index)||!!(t.fullTextIndex&&typeof t.fullTextIndex=="object"&&t.fullTextIndex.available)}},O=e=>Array.isArray(e)?e.flatMap(t=>{if(!t||typeof t!="object")return[];let n=t,r=f(n.path||n.name);return r?[{path:r,size:_(n.size??n.length??n.byteLength??n.byte_length)??0,section:_(n.section)}]:[]}):[];var $=self,h,y,w,M=0,T=new Set,p=(e,t=[])=>{$.postMessage(e,t)},d=(e,t,n)=>{p({id:0,ok:!0,type:"progress",phase:e,current:t,total:n})},S=()=>{if(h)try{h.dispose?.()}finally{try{h.free?.()}catch{}h=void 0,y=void 0,w=void 0,M=0,T.clear()}},Y=e=>e.match(/^([A-Z][A-Z0-9_]+):/)?.[1],Z=e=>{let t=e instanceof Error?e.message:String(e);return{name:e instanceof Error?e.name:"Error",message:t,code:Y(t)}},J=async(e,t)=>{d("wasm",0,1);let n=await import(e);if(typeof n.default=="function"&&await n.default({module_or_path:t}),typeof n.ChmArchive!="function")throw new Error("CHM_WASM_API_MISMATCH: ChmArchive is not exported by the WASM module.");return d("wasm",1,1),n},Q=async e=>{if(S(),e.buffer.byteLength>e.limits.maxArchiveBytes)throw new Error(`CHM_LIMIT_EXCEEDED: source is ${e.buffer.byteLength} bytes; limit is ${e.limits.maxArchiveBytes}.`);let t=await J(e.moduleUrl,e.wasmUrl);d("directory",0,1),h=new t.ChmArchive(new Uint8Array(e.buffer),e.limits),w=e.limits;let n=O(h.entries());if(n.length>e.limits.maxEntries)throw new Error(`CHM_LIMIT_EXCEEDED: ${n.length} entries exceed limit ${e.limits.maxEntries}.`);return d("directory",1,1),d("manifest",0,1),y=D(h.manifest()),d("manifest",1,1),{manifest:y,entries:n}},z=()=>{if(!h||!y||!w)throw new Error("CHM_NOT_OPEN: no CHM archive is active in this Worker.");return{archive:h,manifest:y,limits:w}},P=e=>{let t=z(),n=t.archive.read(e);if(n.byteLength>t.limits.maxEntryBytes)throw new Error(`CHM_LIMIT_EXCEEDED: entry ${e} exceeds ${t.limits.maxEntryBytes} bytes.`);let r=e.toLocaleLowerCase();if(!T.has(r)){let i=M+n.byteLength;if(i>t.limits.maxTotalDecompressedBytes)throw new Error(`CHM_LIMIT_EXCEEDED: unique decoded content exceeds ${t.limits.maxTotalDecompressedBytes} bytes.`);T.add(r),M=i}return n},ee=e=>{let t=A(e);if(!t)throw new Error("CHM_BAD_PATH: the requested entry path is invalid.");let n=P(t);return n.byteOffset===0&&n.byteLength===n.buffer.byteLength?n:n.slice()},te=(e,t)=>{let r=e.toLocaleLowerCase().indexOf(t);if(r<0)return"";let i=Math.max(0,r-72),o=Math.min(e.length,r+t.length+128);return`${i?"\u2026":""}${e.slice(i,o).trim()}${o<e.length?"\u2026":""}`},ne=(e,t,n)=>{let r=z(),i=e.trim().toLocaleLowerCase();if(!i)return{hits:[],inspected:0,truncated:!1};let o=[],a=new Set,s=r.manifest.topics.slice(0,Math.max(1,n)),l=0;d("search",0,s.length);for(let c of s){if(o.length>=t)break;let u=A(c.path);if(!u||a.has(u.toLocaleLowerCase()))continue;a.add(u.toLocaleLowerCase()),l+=1;let g=c.title.toLocaleLowerCase().includes(i),m="";try{let x=P(u),U=N(v(x,r.manifest.encoding));m=te(U,i)}catch(x){if(x instanceof Error&&x.message.startsWith("CHM_LIMIT_EXCEEDED:"))throw x}(g||m)&&o.push({title:c.title||u,path:u,snippet:m,titleMatch:g}),l%64===0&&d("search",l,s.length)}return d("search",l,s.length),{hits:o,inspected:l,truncated:s.length<r.manifest.topics.length||o.length>=t}};$.addEventListener("message",async e=>{let t=e.data;try{if(t.type==="open"){let n=await Q(t);p({id:t.id,ok:!0,type:"open",...n});return}if(t.type==="read"){let n=ee(t.path);p({id:t.id,ok:!0,type:"read",data:n},[n.buffer]);return}if(t.type==="search"){let n=ne(t.query,Math.max(1,t.limit),Math.max(1,t.maxTopics));p({id:t.id,ok:!0,type:"search",...n});return}S(),p({id:t.id,ok:!0,type:"close"})}catch(n){t.type==="open"&&S(),p({id:t.id,ok:!1,type:t.type,error:Z(n)})}});