@file-viewer/renderer-chm 3.0.1

package/dist/model.js

@@ -0,0 +1,125 @@
+export const DEFAULT_CHM_OPTIONS = Object.freeze({
+    workerTimeoutMs: 60000,
+    maxArchiveBytes: 320 * 1024 * 1024,
+    maxEntries: 50000,
+    maxEntryBytes: 32 * 1024 * 1024,
+    maxTotalDecompressedBytes: 512 * 1024 * 1024,
+    maxHtmlBytes: 16 * 1024 * 1024,
+    maxSearchTopics: 10000,
+    maxSearchResults: 200,
+});
+const MIB = 1024 * 1024;
+export const CHM_HARD_LIMITS = Object.freeze({
+    maxArchiveBytes: 1024 * MIB,
+    maxEntries: 250000,
+    maxEntryBytes: 512 * MIB,
+    maxTotalDecompressedBytes: 8 * 1024 * MIB,
+    maxHtmlBytes: 64 * MIB,
+});
+const finiteLimit = (value, fallback, minimum, maximum = Number.MAX_SAFE_INTEGER) => {
+    if (!Number.isFinite(value) || value == null)
+        return fallback;
+    return Math.min(maximum, Math.max(minimum, Math.floor(value)));
+};
+export const resolveChmOptions = (options) => ({
+    workerTimeoutMs: finiteLimit(options === null || options === void 0 ? void 0 : options.workerTimeoutMs, DEFAULT_CHM_OPTIONS.workerTimeoutMs, 1000),
+    maxArchiveBytes: finiteLimit(options === null || options === void 0 ? void 0 : options.maxArchiveBytes, DEFAULT_CHM_OPTIONS.maxArchiveBytes, 1, CHM_HARD_LIMITS.maxArchiveBytes),
+    maxEntries: finiteLimit(options === null || options === void 0 ? void 0 : options.maxEntries, DEFAULT_CHM_OPTIONS.maxEntries, 1, CHM_HARD_LIMITS.maxEntries),
+    maxEntryBytes: finiteLimit(options === null || options === void 0 ? void 0 : options.maxEntryBytes, DEFAULT_CHM_OPTIONS.maxEntryBytes, 1, CHM_HARD_LIMITS.maxEntryBytes),
+    maxTotalDecompressedBytes: finiteLimit(options === null || options === void 0 ? void 0 : options.maxTotalDecompressedBytes, DEFAULT_CHM_OPTIONS.maxTotalDecompressedBytes, 1, CHM_HARD_LIMITS.maxTotalDecompressedBytes),
+    maxHtmlBytes: finiteLimit(options === null || options === void 0 ? void 0 : options.maxHtmlBytes, DEFAULT_CHM_OPTIONS.maxHtmlBytes, 1, CHM_HARD_LIMITS.maxHtmlBytes),
+    maxSearchTopics: finiteLimit(options === null || options === void 0 ? void 0 : options.maxSearchTopics, DEFAULT_CHM_OPTIONS.maxSearchTopics, 1),
+    maxSearchResults: finiteLimit(options === null || options === void 0 ? void 0 : options.maxSearchResults, DEFAULT_CHM_OPTIONS.maxSearchResults, 1),
+});
+const stringValue = (value) => typeof value === 'string' ? value : '';
+const numberValue = (value) => typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+const booleanValue = (value) => value === true;
+const normalizeTopic = (value) => {
+    var _a;
+    if (!value || typeof value !== 'object')
+        return null;
+    const source = value;
+    const path = stringValue(source.path || source.local || source.url);
+    if (!path)
+        return null;
+    return {
+        title: stringValue(source.title || source.name) || path,
+        path,
+        contextId: numberValue((_a = source.contextId) !== null && _a !== void 0 ? _a : source.context_id),
+    };
+};
+const normalizeNavigationNodes = (value) => {
+    if (!Array.isArray(value))
+        return [];
+    const roots = [];
+    const queue = [];
+    for (let index = value.length - 1; index >= 0; index -= 1) {
+        queue.push({ source: value[index], target: roots });
+    }
+    while (queue.length) {
+        const current = queue.pop();
+        if (!(current === null || current === void 0 ? void 0 : current.source) || typeof current.source !== 'object')
+            continue;
+        const source = current.source;
+        const children = [];
+        const node = {
+            title: stringValue(source.title || source.name || source.keyword) || stringValue(source.path || source.local),
+            path: stringValue(source.path || source.local || source.url) || undefined,
+            keyword: stringValue(source.keyword) || undefined,
+            children,
+        };
+        current.target.push(node);
+        const aliases = Array.isArray(source.locals)
+            ? source.locals.filter((item) => typeof item === 'string' && Boolean(item))
+            : [];
+        if (!node.path && aliases.length)
+            node.path = aliases[0];
+        for (let index = node.path ? 1 : 0; index < aliases.length; index += 1) {
+            children.push({ title: `${node.title} · ${index + 1}`, path: aliases[index], children: [] });
+        }
+        const sourceChildren = Array.isArray(source.children) ? source.children : [];
+        for (let index = sourceChildren.length - 1; index >= 0; index -= 1) {
+            queue.push({ source: sourceChildren[index], target: children });
+        }
+    }
+    return roots;
+};
+export const normalizeChmManifest = (value) => {
+    var _a, _b, _c, _d, _e, _f;
+    const source = value && typeof value === 'object' ? value : {};
+    const topics = Array.isArray(source.topics)
+        ? source.topics.map(normalizeTopic).filter((topic) => Boolean(topic))
+        : [];
+    return {
+        title: stringValue(source.title),
+        homePath: stringValue((_a = source.homePath) !== null && _a !== void 0 ? _a : source.home_path),
+        encoding: stringValue(source.encoding) || 'windows-1252',
+        language: stringValue(source.language) || undefined,
+        topics,
+        contents: normalizeNavigationNodes((_b = source.contents) !== null && _b !== void 0 ? _b : source.toc),
+        index: normalizeNavigationNodes((_c = source.index) !== null && _c !== void 0 ? _c : source.keywords),
+        hasBinaryToc: booleanValue((_d = source.hasBinaryToc) !== null && _d !== void 0 ? _d : source.has_binary_toc),
+        hasBinaryIndex: booleanValue((_e = source.hasBinaryIndex) !== null && _e !== void 0 ? _e : source.has_binary_index),
+        hasFullTextIndex: booleanValue((_f = source.hasFullTextIndex) !== null && _f !== void 0 ? _f : source.has_full_text_index)
+            || Boolean(source.fullTextIndex && typeof source.fullTextIndex === 'object'
+                && source.fullTextIndex.available),
+    };
+};
+export const normalizeChmEntries = (value) => {
+    if (!Array.isArray(value))
+        return [];
+    return value.flatMap(item => {
+        var _a, _b, _c, _d;
+        if (!item || typeof item !== 'object')
+            return [];
+        const source = item;
+        const path = stringValue(source.path || source.name);
+        if (!path)
+            return [];
+        return [{
+                path,
+                size: (_d = numberValue((_c = (_b = (_a = source.size) !== null && _a !== void 0 ? _a : source.length) !== null && _b !== void 0 ? _b : source.byteLength) !== null && _c !== void 0 ? _c : source.byte_length)) !== null && _d !== void 0 ? _d : 0,
+                section: numberValue(source.section),
+            }];
+    });
+};

package/dist/security.d.ts

@@ -0,0 +1,33 @@
+export declare const MAX_CHM_HTML_TEXT_LENGTH: number;
+export declare const MAX_CHM_HTML_MARKUP_TOKENS = 100000;
+export declare const MAX_CHM_SVG_TEXT_LENGTH: number;
+export declare const MAX_CHM_SVG_MARKUP_TOKENS = 50000;
+export declare const MAX_CHM_CSS_TEXT_LENGTH: number;
+export declare const MAX_CHM_SEARCH_TEXT_LENGTH: number;
+export interface ChmResolvedReference {
+    kind: 'internal' | 'fragment' | 'external' | 'data' | 'blocked';
+    path?: string;
+    fragment?: string;
+    url?: string;
+}
+export interface SanitizedChmHtmlDocument {
+    document: Document;
+    html: string;
+    title: string;
+    resourcePaths: string[];
+}
+export declare const assertChmMarkupBudget: (source: string, maxLength: number, maxTokens: number, kind: "HTML" | "SVG") => void;
+export declare const assertChmSvgSourceSafety: (source: string) => void;
+export declare const normalizeChmPath: (input: string) => string | null;
+export declare const resolveChmReference: (basePath: string, rawUrl: string) => ChmResolvedReference;
+export declare const decodeChmText: (bytes: Uint8Array, fallbackEncoding?: string) => string;
+/** Extract searchable topic text without DOM APIs or backtracking regular expressions. */
+export declare const extractChmSearchText: (html: string, maxOutputLength?: number) => string;
+export declare const MAX_CHM_TOPIC_RESOURCE_PATHS = 2048;
+export declare const MAX_CHM_CSS_RESOURCE_PATHS = 1024;
+export declare const sanitizeChmCss: (css: string, basePath: string, maxResourcePaths?: number) => {
+    css: string;
+    resourcePaths: string[];
+};
+export declare const sanitizeChmHtmlDocument: (html: string, basePath: string, serialize?: boolean) => SanitizedChmHtmlDocument;
+export declare const CHM_INTERNAL_RESOURCE_SCHEME = "chm-internal:";