omni-viewer-core 0.10.0 → 0.11.0

package/README.md

@@ -13,7 +13,7 @@ models, viewers mount into a DOM element, and everything host-specific
 ## Supported formats
 
 - **Documents** — PDF, Word (DOCX and legacy DOC), HWP, PowerPoint (PPTX and
-  legacy PPT), Markdown
+  legacy PPT), Markdown, LaTeX (structure and math preview, not typesetting)
 - **Data & spreadsheets** — Excel, CSV/TSV, JSON, JSONL/NDJSON, YAML, TOML,
   Parquet, Avro, HDF5, MATLAB MAT, Safetensors, Protocol Buffers, ReqIF, SQLite
 - **Media & graphics** — audio (waveform/spectrogram), video, images,

package/dist/i18n/catalog.en.js

@@ -123,9 +123,43 @@ export const CATALOG_EN = {
     'markdown.invalid': 'Invalid', 'markdown.modified': 'Modified', 'markdown.editable': 'Editable',
     'markdown.edited': 'Edited', 'markdown.htmlCopied': 'HTML copied', 'markdown.sourceCopied': 'Source copied',
     'markdown.summary': '{lines} lines, {words} words', 'markdown.renderedDiagrams': 'Rendered · {count} diagram(s)',
-    'markdown.diagramFailed': 'Unable to render diagram.', 'markdown.toc': 'Contents',
+    'markdown.diagramFailed': 'Unable to render diagram.', 'markdown.toc': 'Outline',
     'markdown.copyCode': 'Copy code', 'markdown.assetUnavailable': 'Image unavailable',
     'diag.markdown.limit-exceeded': 'The Markdown document exceeds a supported limit.',
+    'latex.title': 'LaTeX', 'latex.preview': 'Preview', 'latex.split': 'Split', 'latex.source': 'Source',
+    'latex.outline': 'Outline', 'latex.outlineEmpty': 'No sections found',
+    'latex.render': 'Render', 'latex.undo': 'Undo', 'latex.redo': 'Redo',
+    'latex.copySource': 'Copy source', 'latex.sourceCopied': 'Source copied',
+    'latex.ready': 'Ready', 'latex.parsed': 'Parsed', 'latex.invalid': 'Invalid',
+    'latex.editable': 'Editable', 'latex.edited': 'Edited',
+    'latex.partialRender': 'Partial preview — structure and math only, not typeset output',
+    'latex.documentClass': 'Class: {name}', 'latex.sectionCount': '{count} section(s)',
+    'latex.unsupportedEnvironment': '{environment} — not rendered',
+    'latex.unresolvedInput': '\\{command} — external file not resolved',
+    'latex.floatCaptionOnly': '{environment} — caption only',
+    'latex.parseFailed': 'This file could not be read as a LaTeX document.',
+    'latex.mathNotInstalled': 'Math renderer not installed — formulas are shown as TeX',
+    'latex.mathFailed': 'This formula could not be rendered; its TeX source is shown.',
+    'latex.includedFrom': 'Included from {path}',
+    'latex.goToReference': 'Go to {target}',
+    'diag.latex.include-blocked': 'The include path {path} was refused because it leaves the document folder.',
+    'diag.latex.include-missing': 'The included file {path} could not be read.',
+    'diag.latex.include-cycle': 'The included file {path} was skipped because it is already part of this document.',
+    'diag.latex.include-depth-exceeded': 'Included files are nested deeper than the supported limit.',
+    'diag.latex.include-limit-exceeded': 'The included files exceed a supported limit.',
+    'diag.latex.include-unreadable': 'The included file {path} could not be read as LaTeX.',
+    'latex.linkBlocked': 'This link scheme is not allowed.',
+    'latex.navigationUnavailable': 'Opening links is unavailable on this platform',
+    'diag.latex.not-latex': 'No \\documentclass was found, so the document structure was not interpreted.',
+    'diag.latex.no-document-environment': 'The document environment was not found; the file was read as a fragment.',
+    'diag.latex.unsupported-environment': 'The {environment} environment is not rendered; its source is shown instead.',
+    'diag.latex.unsupported-command': 'The \\{command} command could not be read and was left as source.',
+    'diag.latex.unresolved-input': '\\{command} ({path}) was not resolved — external files are never read.',
+    'diag.latex.unbalanced-environment': 'The {environment} environment is missing its \\end.',
+    'diag.latex.limit-exceeded': 'The LaTeX document exceeds a supported limit.',
+    'diag.latex.depth-exceeded': 'The LaTeX document nests deeper than the supported limit.',
+    'diag.latex.math-limit-exceeded': 'A formula exceeds the supported size and is shown as source.',
+    'diag.latex.float-caption-only': 'Only the caption of the {environment} environment is shown.',
     'archive.title': 'Archive', 'archive.search': 'Search entries', 'archive.entries': '{count} entries',
     'archive.previewUnavailable': 'Preview unavailable', 'archive.mediaUnsupported': 'Media preview is unsupported.',
     'archive.encrypted': 'This archive is encrypted.', 'archive.encryptedEntries': 'This archive contains {count} encrypted entries.',

package/dist/i18n/catalog.ja.js

@@ -130,6 +130,40 @@ export const CATALOG_JA = {
     'markdown.diagramFailed': 'ダイアグラムをレンダリングできません。', 'markdown.toc': '目次',
     'markdown.copyCode': 'コードをコピー', 'markdown.assetUnavailable': '画像を利用できません',
     'diag.markdown.limit-exceeded': 'Markdown文書が対応上限を超えています。',
+    'latex.title': 'LaTeX', 'latex.preview': 'プレビュー', 'latex.split': '分割', 'latex.source': 'ソース',
+    'latex.outline': 'アウトライン', 'latex.outlineEmpty': 'セクションが見つかりません',
+    'latex.render': 'レンダー', 'latex.undo': '元に戻す', 'latex.redo': 'やり直し',
+    'latex.copySource': 'ソースをコピー', 'latex.sourceCopied': 'ソースをコピーしました',
+    'latex.ready': '準備完了', 'latex.parsed': '解析済み', 'latex.invalid': '無効',
+    'latex.editable': '編集可能', 'latex.edited': '編集済み',
+    'latex.partialRender': '部分プレビュー — 構造と数式のみで、組版結果ではありません',
+    'latex.documentClass': 'クラス: {name}', 'latex.sectionCount': 'セクション {count} 個',
+    'latex.unsupportedEnvironment': '{environment} — レンダーしません',
+    'latex.unresolvedInput': '\\{command} — 外部ファイルは解決しません',
+    'latex.floatCaptionOnly': '{environment} — キャプションのみ',
+    'latex.parseFailed': 'このファイルはLaTeX文書として読み取れませんでした。',
+    'latex.mathNotInstalled': '数式レンダラーが未インストールのため、数式をTeXソースで表示します',
+    'latex.mathFailed': 'この数式をレンダーできなかったため、TeXソースを表示します。',
+    'latex.includedFrom': '{path}から取り込み',
+    'latex.goToReference': '{target}へ移動',
+    'diag.latex.include-blocked': '{path}は文書フォルダーの外に出るため取り込みませんでした。',
+    'diag.latex.include-missing': '取り込んだファイル{path}を読み取れませんでした。',
+    'diag.latex.include-cycle': '取り込んだファイル{path}は既にこの文書に含まれているためスキップしました。',
+    'diag.latex.include-depth-exceeded': '取り込んだファイルの入れ子が対応上限より深くなっています。',
+    'diag.latex.include-limit-exceeded': '取り込んだファイルが対応上限を超えています。',
+    'diag.latex.include-unreadable': '取り込んだファイル{path}をLaTeXとして読み取れませんでした。',
+    'latex.linkBlocked': 'このリンクスキームは許可されていません。',
+    'latex.navigationUnavailable': 'このプラットフォームではリンクを開けません',
+    'diag.latex.not-latex': '\\documentclassがないため、文書構造を解釈しませんでした。',
+    'diag.latex.no-document-environment': 'document環境がないため、断片として読み取りました。',
+    'diag.latex.unsupported-environment': '{environment}環境はレンダーせず、ソースをそのまま表示します。',
+    'diag.latex.unsupported-command': '\\{command}コマンドを読み取れず、ソースのまま残しました。',
+    'diag.latex.unresolved-input': '\\{command} ({path}) は解決しませんでした — 外部ファイルは読み取りません。',
+    'diag.latex.unbalanced-environment': '{environment}環境に\\endがありません。',
+    'diag.latex.limit-exceeded': 'LaTeX文書が対応上限を超えています。',
+    'diag.latex.depth-exceeded': 'LaTeX文書の入れ子が対応上限より深くなっています。',
+    'diag.latex.math-limit-exceeded': '数式が対応サイズを超えたため、ソースとして表示します。',
+    'diag.latex.float-caption-only': '{environment}環境はキャプションのみ表示します。',
     'archive.title': 'アーカイブ', 'archive.search': '項目を検索', 'archive.entries': '{count}項目',
     'archive.previewUnavailable': 'プレビューできません', 'archive.mediaUnsupported': 'メディアのプレビューには対応していません。',
     'archive.encrypted': 'このアーカイブは暗号化されています。', 'archive.encryptedEntries': 'このアーカイブには暗号化された項目が{count}件あります。',

package/dist/i18n/catalog.ko.js

@@ -126,6 +126,40 @@ export const CATALOG_KO = {
     'markdown.diagramFailed': '다이어그램을 렌더링할 수 없습니다.', 'markdown.toc': '목차',
     'markdown.copyCode': '코드 복사', 'markdown.assetUnavailable': '이미지를 사용할 수 없음',
     'diag.markdown.limit-exceeded': 'Markdown 문서가 지원 한도를 초과합니다.',
+    'latex.title': 'LaTeX', 'latex.preview': '미리보기', 'latex.split': '분할', 'latex.source': '원문',
+    'latex.outline': '개요', 'latex.outlineEmpty': '절을 찾지 못했습니다',
+    'latex.render': '렌더', 'latex.undo': '실행 취소', 'latex.redo': '다시 실행',
+    'latex.copySource': '원문 복사', 'latex.sourceCopied': '원문을 복사했습니다',
+    'latex.ready': '준비됨', 'latex.parsed': '해석됨', 'latex.invalid': '잘못됨',
+    'latex.editable': '편집 가능', 'latex.edited': '편집함',
+    'latex.partialRender': '부분 미리보기 — 구조와 수식만, 조판 결과가 아닙니다',
+    'latex.documentClass': '클래스: {name}', 'latex.sectionCount': '절 {count}개',
+    'latex.unsupportedEnvironment': '{environment} — 렌더하지 않음',
+    'latex.unresolvedInput': '\\{command} — 외부 파일을 해석하지 않음',
+    'latex.floatCaptionOnly': '{environment} — 캡션만 표시',
+    'latex.parseFailed': 'LaTeX 문서로 읽을 수 없는 파일입니다.',
+    'latex.mathNotInstalled': '수식 렌더러가 설치되지 않아 수식을 TeX 원문으로 표시합니다',
+    'latex.mathFailed': '이 수식을 렌더하지 못해 TeX 원문을 표시합니다.',
+    'latex.includedFrom': '{path}에서 포함됨',
+    'latex.goToReference': '{target}(으)로 이동',
+    'diag.latex.include-blocked': '{path}는 문서 폴더를 벗어나므로 포함하지 않았습니다.',
+    'diag.latex.include-missing': '포함된 파일 {path}를 읽지 못했습니다.',
+    'diag.latex.include-cycle': '포함된 파일 {path}는 이미 이 문서에 포함되어 있어 건너뛰었습니다.',
+    'diag.latex.include-depth-exceeded': '포함된 파일의 중첩이 지원 한도보다 깊습니다.',
+    'diag.latex.include-limit-exceeded': '포함된 파일이 지원 한도를 초과합니다.',
+    'diag.latex.include-unreadable': '포함된 파일 {path}를 LaTeX으로 읽지 못했습니다.',
+    'latex.linkBlocked': '허용되지 않는 링크 스킴입니다.',
+    'latex.navigationUnavailable': '이 플랫폼에서는 링크를 열 수 없습니다',
+    'diag.latex.not-latex': '\\documentclass가 없어 문서 구조를 해석하지 않았습니다.',
+    'diag.latex.no-document-environment': 'document 환경이 없어 문서 조각으로 읽었습니다.',
+    'diag.latex.unsupported-environment': '{environment} 환경은 렌더하지 않으며 원문을 그대로 표시합니다.',
+    'diag.latex.unsupported-command': '\\{command} 명령을 읽지 못해 원문으로 남겼습니다.',
+    'diag.latex.unresolved-input': '\\{command} ({path})를 해석하지 않았습니다 — 외부 파일은 읽지 않습니다.',
+    'diag.latex.unbalanced-environment': '{environment} 환경에 \\end가 없습니다.',
+    'diag.latex.limit-exceeded': 'LaTeX 문서가 지원 한도를 초과합니다.',
+    'diag.latex.depth-exceeded': 'LaTeX 문서의 중첩이 지원 한도보다 깊습니다.',
+    'diag.latex.math-limit-exceeded': '수식이 지원 크기를 초과하여 원문으로 표시합니다.',
+    'diag.latex.float-caption-only': '{environment} 환경은 캡션만 표시합니다.',
     'archive.title': '압축 파일', 'archive.search': '항목 검색', 'archive.entries': '항목 {count}개',
     'archive.previewUnavailable': '미리보기를 사용할 수 없음', 'archive.mediaUnsupported': '미디어 미리보기는 지원되지 않습니다.',
     'archive.encrypted': '이 압축 파일은 암호화되어 있습니다.', 'archive.encryptedEntries': '이 압축 파일에는 암호화된 항목이 {count}개 있습니다.',

package/dist/i18n/catalog.zh-cn.js

@@ -123,6 +123,40 @@ export const CATALOG_ZH_CN = {
     'markdown.diagramFailed': '无法渲染图表。', 'markdown.toc': '目录',
     'markdown.copyCode': '复制代码', 'markdown.assetUnavailable': '图像不可用',
     'diag.markdown.limit-exceeded': 'Markdown 文档超过支持的限制。',
+    'latex.title': 'LaTeX', 'latex.preview': '预览', 'latex.split': '分栏', 'latex.source': '源代码',
+    'latex.outline': '大纲', 'latex.outlineEmpty': '未找到章节',
+    'latex.render': '渲染', 'latex.undo': '撤销', 'latex.redo': '重做',
+    'latex.copySource': '复制源代码', 'latex.sourceCopied': '已复制源代码',
+    'latex.ready': '就绪', 'latex.parsed': '已解析', 'latex.invalid': '无效',
+    'latex.editable': '可编辑', 'latex.edited': '已编辑',
+    'latex.partialRender': '部分预览 — 仅结构与公式，并非排版结果',
+    'latex.documentClass': '文档类：{name}', 'latex.sectionCount': '{count} 个章节',
+    'latex.unsupportedEnvironment': '{environment} — 不渲染',
+    'latex.unresolvedInput': '\\{command} — 不解析外部文件',
+    'latex.floatCaptionOnly': '{environment} — 仅显示题注',
+    'latex.parseFailed': '无法将此文件作为 LaTeX 文档读取。',
+    'latex.mathNotInstalled': '未安装公式渲染器 — 公式以 TeX 源代码显示',
+    'latex.mathFailed': '无法渲染此公式，改为显示其 TeX 源代码。',
+    'latex.includedFrom': '引入自 {path}',
+    'latex.goToReference': '跳转到 {target}',
+    'diag.latex.include-blocked': '{path} 超出文档目录，已拒绝引入。',
+    'diag.latex.include-missing': '无法读取引入的文件 {path}。',
+    'diag.latex.include-cycle': '引入的文件 {path} 已包含在此文档中，已跳过。',
+    'diag.latex.include-depth-exceeded': '引入文件的嵌套超过支持的深度限制。',
+    'diag.latex.include-limit-exceeded': '引入的文件超过支持的限制。',
+    'diag.latex.include-unreadable': '无法将引入的文件 {path} 作为 LaTeX 读取。',
+    'latex.linkBlocked': '不允许此链接协议。',
+    'latex.navigationUnavailable': '此平台无法打开链接',
+    'diag.latex.not-latex': '未找到 \\documentclass，因此未解释文档结构。',
+    'diag.latex.no-document-environment': '未找到 document 环境，已按文档片段读取。',
+    'diag.latex.unsupported-environment': '{environment} 环境不渲染，改为显示其源代码。',
+    'diag.latex.unsupported-command': '无法读取 \\{command} 命令，已保留为源代码。',
+    'diag.latex.unresolved-input': '\\{command}（{path}）未解析 — 从不读取外部文件。',
+    'diag.latex.unbalanced-environment': '{environment} 环境缺少 \\end。',
+    'diag.latex.limit-exceeded': 'LaTeX 文档超过支持的限制。',
+    'diag.latex.depth-exceeded': 'LaTeX 文档的嵌套超过支持的深度限制。',
+    'diag.latex.math-limit-exceeded': '公式超过支持的大小，改为显示源代码。',
+    'diag.latex.float-caption-only': '{environment} 环境仅显示题注。',
     'archive.title': '压缩包', 'archive.search': '搜索条目', 'archive.entries': '{count} 个条目',
     'archive.previewUnavailable': '无法预览', 'archive.mediaUnsupported': '不支持媒体预览。',
     'archive.encrypted': '此压缩包已加密。', 'archive.encryptedEntries': '此压缩包包含 {count} 个加密条目。',

package/dist/parsers/latex/index.d.ts

@@ -0,0 +1,198 @@
+import { type ParseOptions, type ParseOutcome } from '../types.js';
+export interface LatexSpan {
+    start: number;
+    end: number;
+}
+export interface LatexPackage {
+    name: string;
+    options: string[];
+}
+export interface LatexPreamble {
+    documentClass?: string;
+    classOptions: string[];
+    packages: LatexPackage[];
+    /**
+     * Argument-less `\newcommand{\R}{\mathbb{R}}` substitutions only, keyed
+     * without the leading backslash. Stage 2 passes these to KaTeX as `macros`.
+     * Macros taking arguments are intentionally absent — expanding them is the
+     * interpreter this parser refuses to be (§2).
+     */
+    macros: Record<string, string>;
+    /**
+     * `\newtheorem{thm}{Theorem}` declarations, keyed by environment name with
+     * the printed title as value. Theorem-like environments are document
+     * defined, so without this map they are indistinguishable from any other
+     * unknown environment and their prose would be dumped as source.
+     */
+    theorems: Record<string, string>;
+    /**
+     * Characters `\MakeShortVerb` turned into inline-verbatim delimiters, as in
+     * the `doc` package's `\MakeShortVerb{\|}`. Package documentation writes
+     * `|\newcommand{\x}{…}|` to *show* code; without this the scanner would
+     * execute what the author meant to display.
+     */
+    shortVerbs: string[];
+    /**
+     * `\input`/`\include` targets declared in the preamble. Documents routinely
+     * keep their macros in a separate file, and those definitions decide whether
+     * the body's formulas render, so the paths are surfaced for the viewer's
+     * resolver even though the preamble itself produces no blocks.
+     */
+    inputs: string[];
+    /** Verbatim preamble source, for display. */
+    raw: string;
+}
+export type LatexEmphasis = 'it' | 'bf' | 'tt';
+export type LatexInline = {
+    kind: 'text';
+    value: string;
+} | {
+    kind: 'math';
+    source: string;
+    display: false;
+} | {
+    kind: 'emphasis';
+    style: LatexEmphasis;
+    content: LatexInline[];
+} | {
+    kind: 'ref';
+    target: string;
+} | {
+    kind: 'cite';
+    keys: string[];
+} | {
+    kind: 'link';
+    url: string;
+    text: string;
+} | {
+    kind: 'unsupported';
+    source: string;
+};
+export type LatexBlock = {
+    kind: 'heading';
+    level: number;
+    id: string;
+    title: LatexInline[];
+    label?: string;
+    span: LatexSpan;
+} | {
+    kind: 'paragraph';
+    content: LatexInline[];
+    span: LatexSpan;
+} | {
+    kind: 'math';
+    source: string;
+    display: boolean;
+    label?: string;
+    span: LatexSpan;
+} | {
+    kind: 'list';
+    ordered: boolean;
+    items: LatexBlock[][];
+    span: LatexSpan;
+} | {
+    kind: 'theorem';
+    environment: string;
+    title: string;
+    note?: LatexInline[];
+    body: LatexBlock[];
+    label?: string;
+    span: LatexSpan;
+} | {
+    kind: 'table';
+    columns: LatexColumnAlign[];
+    rows: LatexTableCell[][];
+    span: LatexSpan;
+} | {
+    kind: 'verbatim';
+    source: string;
+    span: LatexSpan;
+} | {
+    kind: 'float';
+    environment: string;
+    caption?: LatexInline[];
+    span: LatexSpan;
+} | {
+    kind: 'unresolved';
+    command: string;
+    path: string;
+    span: LatexSpan;
+}
+/** A resolved `\input`/`\include`. Never produced by the parser — the core
+ *  has no filesystem (L4); the viewer builds these from an injected
+ *  resolver, so `blocks` carry spans into the *included* file, not this one. */
+ | {
+    kind: 'include';
+    command: string;
+    path: string;
+    blocks: LatexBlock[];
+    span: LatexSpan;
+} | {
+    kind: 'unsupported';
+    environment: string;
+    source: string;
+    span: LatexSpan;
+};
+export type LatexColumnAlign = 'left' | 'center' | 'right';
+export interface LatexTableCell {
+    content: LatexInline[];
+    /** `\multicolumn{n}{…}{…}` — cells spanning one column omit this. */
+    span?: number;
+}
+export interface LatexHeading {
+    level: number;
+    text: string;
+    id: string;
+    span: LatexSpan;
+    /** Set when the heading came from an included file (span is into that file). */
+    source?: string;
+}
+export interface LatexDocument {
+    /** Complete decoded source, retained for source view / edit / writeback. */
+    text: string;
+    preamble: LatexPreamble;
+    body: LatexBlock[];
+    /** Flat outline in source order (§3 navigation). */
+    outline: LatexHeading[];
+    /** Region of `text` the block scanner covered. */
+    bodySpan: LatexSpan;
+}
+export interface LatexStructuralLimits {
+    maxBlocks: number;
+    maxOutline: number;
+    maxMathSegments: number;
+    maxInlineMathLength: number;
+    maxDisplayMathLength: number;
+    maxDepth: number;
+}
+/** docs/viewers/latex.md §4. Inline/display math lengths match the markdown
+ *  viewer's existing constants so the two paths agree on what is "a formula". */
+export declare const LATEX_DEFAULT_LIMITS: {
+    readonly maxInputBytes: number;
+    readonly maxBlocks: 200000;
+    readonly maxOutline: 10000;
+    readonly maxMathSegments: 5000;
+    readonly maxInlineMathLength: 1000;
+    readonly maxDisplayMathLength: 5000;
+    readonly maxDepth: 64;
+};
+export interface LatexParseOptions extends ParseOptions {
+    latexLimits?: Partial<LatexStructuralLimits>;
+    /**
+     * Parse a body fragment that has no `\documentclass` of its own — an
+     * `\input`ed chapter file. Without this the parser refuses to guess at the
+     * structure of a `.tex` file that might be plain TeX (§1); with it the
+     * caller is asserting the file is a LaTeX fragment. Spans stay relative to
+     * the fragment's own text, which is why this exists instead of wrapping the
+     * source in a synthetic document.
+     */
+    fragment?: boolean;
+}
+/**
+ * Structure-only LaTeX parse. Input-caused problems never throw: unparseable
+ * bytes become `failed`, everything the scanner cannot model becomes a
+ * diagnostic plus an `unsupported`/`unresolved` block and a `partial` status.
+ */
+export declare function parseLatex(data: Uint8Array, options?: LatexParseOptions): ParseOutcome<LatexDocument>;
+/** Flattened text of inline nodes — outline labels, link text, copy output. */
+export declare function plainText(nodes: readonly LatexInline[]): string;