omni-viewer-core 0.4.0 → 0.5.0

package/README.md

@@ -63,6 +63,34 @@ Viewers follow the same pattern — a `mount*Viewer(input, container, ctx,
 deps)` entry per format, plus `self-loading` variants that dynamically import
 their own dependencies for hosts that don't want to wire them manually.
 
+### PDF host integration
+
+The PDF viewer asks `ctx.assets.resolveAssetUrl` for the exact key
+`assets/pdfjs/pdf.worker.min.mjs`. The published package also exposes that
+worker at `omni-viewer-core/assets/pdfjs/pdf.worker.min.mjs`; a host may return
+its own compatible `pdfjs-dist` worker URL instead, or pass `workerSrc` in the
+PDF mount options. `isEvalSupported` defaults to `false` for CSP-safe hosts.
+
+PDF mount options are additive and optional. `saveMode` is `hybrid` by default
+(editable text/markup sidecar; signatures and deleted pages are permanent) and
+may be set to `flattened` for smaller output. `toolbarActions` adds host-owned
+buttons without exposing platform APIs to core. `zoomLevels`, `maxMergeBytes`,
+and `onSaveAsComplete` configure navigation and host save behavior.
+
+Large save and merge work can be delegated through the optional
+`PdfViewerDeps.processing` service. VS Code extension-host and Web Worker
+adapters can implement `buildPdf` and/or `mergePdfs`; each receives an
+`AbortSignal` and progress callback. When the service is absent, the default
+`auto` mode preserves the browser `pdf-lib` fallback. `host` requires the
+service and `browser` forces the fallback. `PdfViewerHandle.operation` reports
+running, succeeded, failed, and cancelled states, and `cancelOperation()`
+requests cancellation.
+
+`FileSaveService.saveFile` may continue resolving `void` for compatibility.
+New adapters should return `{ status: 'cancelled' }` when a Save As picker is
+dismissed, or `{ status: 'saved', fileName?, uri? }` after any host post-save
+work (for example opening the new file or showing a notification) completes.
+
 Parsers never throw on malformed input; they return a
 `ParseOutcome` with a typed failure and diagnostics, and they enforce
 resource limits (input size, cell/row/entry counts, declared decompressed

package/dist/host/index.d.ts

@@ -27,11 +27,23 @@ export type LogLevel = 'info' | 'warn' | 'error';
 export interface LoggerService {
     log(level: LogLevel, message: string): void;
 }
+export type FileSaveResult = {
+    status: 'saved';
+    fileName?: string;
+    uri?: string;
+} | {
+    status: 'cancelled';
+};
 export interface FileSaveService {
     /** Creates a new file. Implementations present the platform's save
      *  destination picker (or browser-equivalent download prompt) so the
-     *  user chooses the target path and may change the suggested name. */
-    saveFile(name: string, data: Uint8Array, mimeType: string): Promise<void>;
+     *  user chooses the target path and may change the suggested name.
+     *
+     * Existing implementations may continue returning `void` (treated as a
+     * successful save). New implementations should return `cancelled` when the
+     * picker is dismissed, and may open the saved file or show host UI before
+     * resolving `saved`. */
+    saveFile(name: string, data: Uint8Array, mimeType: string): Promise<void | FileSaveResult>;
 }
 export interface ClipboardService {
     writeText(text: string): Promise<void>;

package/dist/i18n/catalog.en.js

@@ -142,6 +142,7 @@ export const CATALOG_EN = {
     'diag.yaml.node-limit': 'The YAML node limit was reached.',
     'diag.yaml.depth-limit': 'The YAML nesting depth limit was reached.',
     'diag.yaml.alias-limit': 'The YAML alias limit was reached.',
+    'diag.yaml.duplicate-key': 'Duplicate key "{key}"; the last value is used.',
     'structured.tree': 'Tree', 'structured.flat': 'Flat', 'structured.json': 'JSON', 'structured.raw': 'Raw', 'structured.expandAll': 'Expand all',
     'structured.collapseAll': 'Collapse all', 'structured.expand': 'Expand', 'structured.collapse': 'Collapse',
     'structured.search': 'Search', 'structured.copy': 'Copy', 'structured.copyPath': 'Path',
@@ -340,6 +341,13 @@ export const CATALOG_EN = {
     'pdf.annotationColor': 'Text color',
     'pdf.save': 'Save',
     'pdf.saveAs': 'Save as',
+    'pdf.saving': 'Saving PDF…',
+    'pdf.operationCancelled': 'PDF operation cancelled.',
+    'pdf.workerLoadFailed': 'Unable to load the PDF worker asset.',
+    'pdf.saveModeHybrid': 'Editable',
+    'pdf.saveModeHybridTitle': 'Hybrid save: text markup remains editable; signatures and deleted pages cannot be recovered.',
+    'pdf.saveModeFlattened': 'Compact',
+    'pdf.saveModeFlattenedTitle': 'Flattened save: smaller output without an editable sidecar.',
     'pdf.merge': 'Merge PDF',
     'pdf.merging': 'Merging PDF…',
     'pdf.mergeComplete': 'PDF merged. Save or Save as to keep the changes.',

package/dist/i18n/catalog.ja.js

@@ -146,6 +146,7 @@ export const CATALOG_JA = {
     'diag.yaml.node-limit': 'YAMLノードの上限に達しました。',
     'diag.yaml.depth-limit': 'YAMLのネスト深度上限に達しました。',
     'diag.yaml.alias-limit': 'YAMLエイリアスの上限に達しました。',
+    'diag.yaml.duplicate-key': 'キー「{key}」が重複しています。最後の値が使用されます。',
     'structured.tree': 'ツリー', 'structured.flat': 'フラット', 'structured.json': 'JSON', 'structured.raw': 'RAW', 'structured.expandAll': 'すべて展開',
     'structured.collapseAll': 'すべて折りたたむ', 'structured.expand': '展開', 'structured.collapse': '折りたたむ',
     'structured.search': '検索', 'structured.copy': 'コピー', 'structured.copyPath': 'パス',
@@ -247,7 +248,14 @@ export const CATALOG_JA = {
     'pdf.twoPagesEven': '見開き（偶数ページを左）', 'pdf.matchTheme': 'テーマの色に合わせる',
     'pdf.resetPages': 'ページをリセット', 'pdf.annotationText': 'テキストを追加',
     'pdf.annotationSize': 'テキストサイズ', 'pdf.annotationColor': 'テキストの色',
-    'pdf.save': '保存', 'pdf.saveAs': '名前を付けて保存', 'pdf.merge': 'PDFを結合',
+    'pdf.save': '保存', 'pdf.saveAs': '名前を付けて保存', 'pdf.saving': 'PDFを保存中…',
+    'pdf.operationCancelled': 'PDFの処理をキャンセルしました。',
+    'pdf.workerLoadFailed': 'PDF Workerアセットを読み込めません。',
+    'pdf.saveModeHybrid': '編集可能',
+    'pdf.saveModeHybridTitle': 'ハイブリッド保存：テキストマークアップは再編集できます。署名と削除したページは復元できません。',
+    'pdf.saveModeFlattened': 'コンパクト',
+    'pdf.saveModeFlattenedTitle': 'フラット化保存：編集用サイドカーを含まない小さいファイルです。',
+    'pdf.merge': 'PDFを結合',
     'pdf.merging': 'PDFを結合中…', 'pdf.mergeComplete': 'PDFを結合しました。変更を保持するには保存してください。',
     'pdf.mergeFailed': 'このPDFを結合できません。', 'pdf.signature': '署名', 'pdf.signatureColor': '署名の色',
     'pdf.signatureClear': 'クリア', 'pdf.signatureUse': '署名を使用',

package/dist/i18n/catalog.ko.js

@@ -142,6 +142,7 @@ export const CATALOG_KO = {
     'diag.yaml.node-limit': 'YAML 노드 한도에 도달했습니다.',
     'diag.yaml.depth-limit': 'YAML 중첩 깊이 한도에 도달했습니다.',
     'diag.yaml.alias-limit': 'YAML 별칭 한도에 도달했습니다.',
+    'diag.yaml.duplicate-key': '중복된 키 "{key}"; 마지막 값이 사용됩니다.',
     'structured.tree': '트리', 'structured.flat': '평면', 'structured.json': 'JSON', 'structured.raw': '원시', 'structured.expandAll': '모두 펼치기',
     'structured.collapseAll': '모두 접기', 'structured.expand': '펼치기', 'structured.collapse': '접기',
     'structured.search': '검색', 'structured.copy': '복사', 'structured.copyPath': '경로',
@@ -340,6 +341,13 @@ export const CATALOG_KO = {
     'pdf.annotationColor': '텍스트 색상',
     'pdf.save': '저장',
     'pdf.saveAs': '다른 이름으로 저장',
+    'pdf.saving': 'PDF 저장 중…',
+    'pdf.operationCancelled': 'PDF 작업이 취소되었습니다.',
+    'pdf.workerLoadFailed': 'PDF Worker 자산을 불러올 수 없습니다.',
+    'pdf.saveModeHybrid': '재편집 가능',
+    'pdf.saveModeHybridTitle': '하이브리드 저장: 텍스트 마크업은 재편집할 수 있으며 서명과 삭제한 페이지는 복구할 수 없습니다.',
+    'pdf.saveModeFlattened': '용량 우선',
+    'pdf.saveModeFlattenedTitle': '평면화 저장: 편집용 sidecar 없이 더 작은 파일로 저장합니다.',
     'pdf.merge': 'PDF 병합',
     'pdf.merging': 'PDF 병합 중…',
     'pdf.mergeComplete': 'PDF가 병합되었습니다. 저장 또는 다른 이름으로 저장하여 변경 사항을 유지하세요.',

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

@@ -134,6 +134,7 @@ export const CATALOG_ZH_CN = {
     'diag.yaml.document-limit': '仅解析了前 {count} 个 YAML 文档。',
     'diag.yaml.node-limit': '已达到 YAML 节点限制。', 'diag.yaml.depth-limit': '已达到 YAML 嵌套深度限制。',
     'diag.yaml.alias-limit': '已达到 YAML 别名限制。',
+    'diag.yaml.duplicate-key': '键 "{key}" 重复；将使用最后一个值。',
     'structured.tree': '树', 'structured.flat': '平铺', 'structured.json': 'JSON', 'structured.raw': '原始',
     'structured.expandAll': '全部展开', 'structured.collapseAll': '全部折叠',
     'structured.expand': '展开', 'structured.collapse': '折叠', 'structured.search': '搜索',
@@ -230,7 +231,13 @@ export const CATALOG_ZH_CN = {
     'pdf.singlePage': '单页', 'pdf.twoPagesOdd': '双页（奇数页在左）', 'pdf.twoPagesEven': '双页（偶数页在左）',
     'pdf.matchTheme': '匹配主题颜色', 'pdf.resetPages': '重置页面',
     'pdf.annotationText': '添加文本', 'pdf.annotationSize': '文本大小', 'pdf.annotationColor': '文本颜色',
-    'pdf.save': '保存', 'pdf.saveAs': '另存为', 'pdf.merge': '合并 PDF', 'pdf.merging': '正在合并 PDF…',
+    'pdf.save': '保存', 'pdf.saveAs': '另存为', 'pdf.saving': '正在保存 PDF…',
+    'pdf.operationCancelled': 'PDF 操作已取消。', 'pdf.workerLoadFailed': '无法加载 PDF Worker 资源。',
+    'pdf.saveModeHybrid': '可重新编辑',
+    'pdf.saveModeHybridTitle': '混合保存：文本标记可重新编辑；签名和已删除页面无法恢复。',
+    'pdf.saveModeFlattened': '精简',
+    'pdf.saveModeFlattenedTitle': '扁平化保存：不含编辑 sidecar，文件更小。',
+    'pdf.merge': '合并 PDF', 'pdf.merging': '正在合并 PDF…',
     'pdf.mergeComplete': 'PDF 已合并。请保存或另存为以保留更改。', 'pdf.mergeFailed': '无法合并此 PDF。',
     'pdf.signature': '签名', 'pdf.signatureColor': '签名颜色', 'pdf.signatureClear': '清除',
     'pdf.signatureUse': '使用签名', 'pdf.signaturePlace': '点击页面以放置签名。',

package/dist/parsers/yaml/index.js

@@ -18,6 +18,7 @@ export function parseYaml(input, options = {}) {
         const ast = options.deps.parse(text);
         const maxDocs = options.limits?.maxDocuments ?? 100;
         const docs = [];
+        const duplicates = [];
         for (let i = 0; i < Math.min(ast.length, maxDocs); i++) {
             if (options.signal?.aborted)
                 return finish(docs.length ? { status: 'partial', document: { text, documents: docs }, diagnostics: [...diagnostics, { severity: 'warning', code: 'yaml.aborted', messageKey: 'diag.aborted' }] } : { status: 'failed', failure: { code: 'aborted', retryable: true, messageKey: 'diag.aborted' }, diagnostics });
@@ -28,11 +29,13 @@ export function parseYaml(input, options = {}) {
                 diagnostics.push({ severity: 'error', code: 'yaml.invalid', messageKey: 'diag.yaml.invalid', location: pos ? `line:${pos.line}:${pos.col}` : `document:${i + 1}` });
             }
             const node = options.deps.normalize ? options.deps.normalize(sourceDoc, i) : normalizeUnknown(sourceDoc, `$doc[${i}]`);
-            const violation = validateTree(node, options.limits?.maxEntries ?? 100_000, options.limits?.maxDepth ?? 100, options.limits?.maxAliases ?? 10_000);
+            const violation = validateTree(node, options.limits?.maxEntries ?? 100_000, options.limits?.maxDepth ?? 100, options.limits?.maxAliases ?? 10_000, duplicates);
             if (violation)
                 diagnostics.push({ severity: 'warning', code: violation, messageKey: `diag.${violation}`, location: `document:${i + 1}` });
             docs.push(node);
         }
+        for (const duplicate of duplicates)
+            diagnostics.push({ severity: 'warning', code: 'yaml.duplicate-key', messageKey: 'diag.yaml.duplicate-key', args: { key: duplicate.key }, location: duplicate.path });
         if (ast.length > maxDocs)
             diagnostics.push({ severity: 'warning', code: 'yaml.document-limit', messageKey: 'diag.yaml.document-limit', args: { count: maxDocs } });
         return finish(diagnostics.length ? { status: 'partial', document: { text, documents: docs }, diagnostics } : { status: 'ok', document: { text, documents: docs }, diagnostics });
@@ -44,7 +47,8 @@ export function parseYaml(input, options = {}) {
 function normalizeUnknown(value, path, key = '$') { if (Array.isArray(value))
     return { kind: 'seq', key, path, children: value.map((v, i) => normalizeUnknown(v, `${path}[${i}]`, String(i))) }; if (value !== null && typeof value === 'object')
     return { kind: 'map', key, path, children: Object.entries(value).map(([k, v]) => normalizeUnknown(v, `${path}.${k}`, k)) }; return { kind: 'scalar', key, path, value: value, raw: String(value) }; }
-function validateTree(root, maxNodes, maxDepth, maxAliases) { let nodes = 0, aliases = 0; const stack = [{ node: root, depth: 0 }]; while (stack.length) {
+const MAX_DUPLICATE_KEY_DIAGNOSTICS = 20;
+function validateTree(root, maxNodes, maxDepth, maxAliases, duplicates) { let nodes = 0, aliases = 0; const stack = [{ node: root, depth: 0 }]; while (stack.length) {
     const item = stack.pop();
     nodes++;
     if (nodes > maxNodes)
@@ -53,6 +57,14 @@ function validateTree(root, maxNodes, maxDepth, maxAliases) { let nodes = 0, ali
         return 'yaml.depth-limit';
     if (item.node.kind === 'alias' && ++aliases > maxAliases)
         return 'yaml.alias-limit';
+    if (item.node.kind === 'map' && item.node.children) {
+        const seen = new Set();
+        for (const child of item.node.children) {
+            if (seen.has(child.key) && duplicates.length < MAX_DUPLICATE_KEY_DIAGNOSTICS && !duplicates.some(d => d.path === item.node.path && d.key === child.key))
+                duplicates.push({ path: item.node.path, key: child.key });
+            seen.add(child.key);
+        }
+    }
     for (const child of item.node.children ?? [])
         stack.push({ node: child, depth: item.depth + 1 });
 } return null; }

package/dist/parsers/yaml/self-loading.js

@@ -1,19 +1,31 @@
 /** Dynamic optional-peer loader; base parser/viewer modules never import yaml. */
 export async function loadYamlParserDeps() {
     const yaml = await import('yaml');
-    const normalize = (node, path, key = '$') => {
-        const n = node;
-        if (n.contents !== undefined)
-            return normalize(n.contents, path, key);
-        const common = { key, path, range: n.range, anchorId: n.anchor };
-        if (n.type === 'ALIAS' || n.constructor?.name === 'Alias')
-            return { ...common, kind: 'alias', aliasOf: String(n.source ?? '') };
-        if (Array.isArray(n.items)) {
-            const pairs = n.items.every(item => item && typeof item === 'object' && 'key' in item);
-            return { ...common, kind: pairs ? 'map' : 'seq', children: n.items.map((item, i) => { const pair = item; const childKey = pairs ? String(pair.key?.value ?? pair.key?.source ?? i) : String(i); return normalize(pairs ? pair.value : item, pairs ? `${path}.${childKey}` : `${path}[${i}]`, childKey); }) };
-        }
-        const value = n.value ?? node;
-        return { ...common, kind: 'scalar', value: value, raw: n.source === undefined ? String(value) : String(n.source) };
+    const normalizeDocument = (document, index) => {
+        const anchors = new Map();
+        const record = (node) => { if (node.anchorId)
+            anchors.set(node.anchorId, node); return node; };
+        const normalize = (node, path, key = '$') => {
+            const n = node;
+            if (n.contents !== undefined)
+                return normalize(n.contents, path, key);
+            const common = { key, path, range: n.range, anchorId: n.anchor };
+            if (n.type === 'ALIAS' || n.constructor?.name === 'Alias') {
+                const name = String(n.source ?? '');
+                const target = anchors.get(name);
+                if (target?.kind !== 'scalar')
+                    return { ...common, kind: 'alias', aliasOf: name, raw: `*${name}` };
+                return { ...common, kind: 'alias', aliasOf: name, value: target.value ?? null, raw: target.raw ?? `*${name}` };
+            }
+            if (Array.isArray(n.items)) {
+                const pairs = n.items.every(item => item && typeof item === 'object' && 'key' in item);
+                const seen = new Map();
+                return record({ ...common, kind: pairs ? 'map' : 'seq', children: n.items.map((item, i) => { const pair = item; const keyValue = typeof pair.key?.value === 'symbol' ? pair.key?.source ?? '<<' : pair.key?.value; const childKey = pairs ? String(keyValue ?? pair.key?.source ?? i) : String(i); const occurrence = (seen.get(childKey) ?? 0) + 1; seen.set(childKey, occurrence); return normalize(pairs ? pair.value : item, pairs ? `${path}.${childKey}${occurrence > 1 ? `#${occurrence}` : ''}` : `${path}[${i}]`, childKey); }) });
+            }
+            const value = n.value ?? node;
+            return record({ ...common, kind: 'scalar', value: value, raw: n.source === undefined ? String(value) : String(n.source) });
+        };
+        return normalize(document, `$doc[${index}]`);
     };
-    return { parse: (text) => yaml.parseAllDocuments(text, { schema: 'core', customTags: [] }), normalize: (document, index) => normalize(document, `$doc[${index}]`) };
+    return { parse: (text) => yaml.parseAllDocuments(text, { schema: 'core', customTags: [], uniqueKeys: false, merge: true }), normalize: normalizeDocument };
 }

package/dist/registry/index.js

@@ -162,7 +162,7 @@ export const IMAGE_VIEWER_DESCRIPTOR = {
 export const MARKDOWN_VIEWER_DESCRIPTOR = {
     id: 'markdown', displayNameKey: 'markdown.title',
     extensions: ['md', 'markdown', 'mdown', 'mkdn', 'mkd'], priority: 10,
-    requiredServices: [], optionalServices: ['clipboard', 'navigation', 'documentAssets', 'writeback']
+    requiredServices: [], optionalServices: ['clipboard', 'navigation', 'documentAssets', 'writeback', 'save']
 };
 export const ARCHIVE_MAGIC_SIGNATURES = [
     [{ offset: 0, bytes: [0x50, 0x4b, 0x03, 0x04] }], [{ offset: 0, bytes: [0x50, 0x4b, 0x05, 0x06] }],

package/dist/styles/pdf.css

@@ -51,6 +51,14 @@
     color: var(--omni-fg-muted, #9d9d9d);
     margin-right: 8px;
 }
+.omni-pdf__save-mode {
+    padding: 2px 6px;
+    color: var(--omni-fg-muted, #9d9d9d);
+    border: 1px solid var(--omni-border, #3c3c3c);
+    border-radius: 999px;
+    font-size: 11px;
+    white-space: nowrap;
+}
 .omni-pdf__page-input {
     width: 52px;
     padding: 3px 5px;
@@ -265,10 +273,28 @@
 .omni-pdf__thumb.drop-before::before { top: -6px; }
 .omni-pdf__thumb.drop-after::after { bottom: -6px; }
 .omni-pdf__thumb canvas {
+    display: block;
     max-width: 100%;
     background: #ffffff;
     box-shadow: 0 1px 3px rgba(0, 0, 0, 0.5);
 }
+.omni-pdf__thumb-page {
+    position: relative;
+    max-width: 100%;
+}
+.omni-pdf__thumb-annotation {
+    position: absolute;
+    z-index: 1;
+    overflow: hidden;
+    pointer-events: none;
+    color: #111111; /* ink on paper */
+    white-space: nowrap;
+}
+.omni-pdf__thumb-annotation img { display: block; }
+.omni-pdf__thumb-annotation.omni-pdf__underline::after,
+.omni-pdf__thumb-annotation.omni-pdf__strikeout::after {
+    height: 1px;
+}
 .omni-pdf__thumb-label {
     font-family: var(--omni-font-mono, Monaco, Menlo, monospace);
     font-size: 10px;

package/dist/styles/toml.css

@@ -1 +1 @@
-:host,.omni-viewer--toml,.omni-viewer--yaml{display:block;height:100%;color:var(--omni-fg,#ddd);background:var(--omni-bg,#1e1e1e);font:13px var(--omni-font,system-ui)}.omni-structured{height:100%;display:flex;flex-direction:column;box-sizing:border-box}.omni-structured__bar{display:flex;gap:5px;align-items:center;padding:6px;border-bottom:1px solid var(--omni-border,#444)}.omni-structured button,.omni-structured input,.omni-structured select{font:inherit;background:var(--omni-button-bg,#333);color:inherit;border:1px solid var(--omni-border,#555);border-radius:3px;padding:3px 7px}.omni-structured button:disabled{opacity:.5}.omni-structured__search{min-width:180px}.omni-structured__diagnostics{white-space:pre-wrap;color:var(--omni-error,#f48771);padding:6px;border-bottom:1px solid var(--omni-border,#444)}.omni-structured__workspace{display:grid;grid-template-columns:minmax(0,1fr) minmax(0,1fr);grid-template-rows:minmax(0,1fr);gap:12px;flex:1;min-height:0;padding:12px}.omni-structured__pane{display:flex;flex-direction:column;min-width:0;min-height:0;border:1px solid var(--omni-border,#444);border-radius:8px;overflow:hidden;background:var(--omni-input-bg,#171717)}.omni-structured__pane-header{display:flex;justify-content:space-between;gap:12px;padding:10px 12px;border-bottom:1px solid var(--omni-border,#444)}.omni-structured__pane-header span{color:var(--omni-fg-muted,#999)}.omni-structured__editor,.omni-structured__tree{box-sizing:border-box;flex:1;min-height:0;padding:10px;background:transparent;color:inherit;font:inherit;font-family:var(--omni-font-mono,ui-monospace,monospace)}.omni-structured__editor{resize:none;border:0;outline:none;line-height:1.5;white-space:pre;overflow:auto}.omni-structured__source-surface{position:relative;flex:1;min-height:0;overflow:hidden}.omni-structured__source-highlight{position:absolute;inset:0;box-sizing:border-box;margin:0;padding:10px;overflow:auto;pointer-events:none;font:inherit;font-family:var(--omni-font-mono,ui-monospace,monospace);line-height:1.5;white-space:pre}.omni-structured__pane--highlighted-source .omni-structured__editor{position:relative;z-index:1;width:100%;height:100%;padding:10px;color:transparent;caret-color:var(--omni-fg,#ddd);-webkit-text-fill-color:transparent}.omni-structured__source-key{color:#9cdcfe}.omni-structured__source-value{color:#ce9178}.omni-structured__source-table{color:#c586c0}.omni-structured__source-comment{color:var(--omni-fg-muted,#999)}.omni-structured__tree{overflow:auto}.omni-structured__node{display:flex;gap:6px;align-items:baseline;min-height:25px}.omni-structured__toggle{width:24px;padding:0!important;border:0!important;background:transparent!important}.omni-structured__key{color:var(--omni-accent,#5aa9e6)}.omni-structured__kind{color:var(--omni-fg-muted,#999)}.omni-structured__value{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.omni-structured__actions{margin-left:auto;display:flex;gap:4px;opacity:0}.omni-structured__node:hover .omni-structured__actions,.omni-structured__actions:focus-within{opacity:1}.omni-structured__raw-preview,.omni-structured__json-preview{flex:1;min-height:0;margin:0;padding:10px;overflow:auto;font-family:var(--omni-font-mono,ui-monospace,monospace);line-height:1.5}.omni-structured__flat-row .omni-structured__key{flex-shrink:0}@media(max-width:720px){.omni-structured__workspace{grid-template-columns:1fr;overflow:auto}.omni-structured__pane{min-height:320px}}
+:host,.omni-viewer--toml,.omni-viewer--yaml{display:block;height:100%;color:var(--omni-fg,#ddd);background:var(--omni-bg,#1e1e1e);font:13px var(--omni-font,system-ui)}.omni-structured{height:100%;display:flex;flex-direction:column;box-sizing:border-box}.omni-structured__bar{display:flex;gap:5px;align-items:center;padding:6px;border-bottom:1px solid var(--omni-border,#444)}.omni-structured button,.omni-structured input,.omni-structured select{font:inherit;background:var(--omni-button-bg,#333);color:inherit;border:1px solid var(--omni-border,#555);border-radius:3px;padding:3px 7px}.omni-structured button:disabled{opacity:.5}.omni-structured__search{min-width:180px}.omni-structured__diagnostics{white-space:pre-wrap;color:var(--omni-error,#f48771);padding:6px;border-bottom:1px solid var(--omni-border,#444)}.omni-structured__workspace{display:grid;grid-template-columns:minmax(0,1fr) minmax(0,1fr);grid-template-rows:minmax(0,1fr);gap:12px;flex:1;min-height:0;padding:12px}.omni-structured__pane{display:flex;flex-direction:column;min-width:0;min-height:0;border:1px solid var(--omni-border,#444);border-radius:8px;overflow:hidden;background:var(--omni-input-bg,#171717)}.omni-structured__pane-header{display:flex;justify-content:space-between;gap:12px;padding:10px 12px;border-bottom:1px solid var(--omni-border,#444)}.omni-structured__pane-header span{color:var(--omni-fg-muted,#999)}.omni-structured__editor,.omni-structured__tree{box-sizing:border-box;flex:1;min-height:0;padding:10px;background:transparent;color:inherit;font:inherit;font-family:var(--omni-font-mono,ui-monospace,monospace)}.omni-structured__editor{resize:none;border:0;outline:none;line-height:1.5;white-space:pre;overflow:auto}.omni-structured__source-surface{position:relative;flex:1;min-height:0;overflow:hidden}.omni-structured__source-highlight{position:absolute;inset:0;box-sizing:border-box;margin:0;padding:10px;overflow:auto;pointer-events:none;font:inherit;font-family:var(--omni-font-mono,ui-monospace,monospace);line-height:1.5;white-space:pre}.omni-structured__pane--highlighted-source .omni-structured__editor{position:relative;z-index:1;width:100%;height:100%;padding:10px;color:transparent;caret-color:var(--omni-fg,#ddd);-webkit-text-fill-color:transparent}.omni-structured__source-key{color:#9cdcfe}.omni-structured__source-value{color:#ce9178}.omni-structured__source-table{color:#c586c0}.omni-structured__source-comment{color:var(--omni-fg-muted,#999)}.omni-structured__tree{overflow:auto}.omni-structured__preview-body{position:relative;flex:1;min-height:200px}.omni-structured__preview-body>.omni-structured__tree,.omni-structured__preview-body>.omni-structured__json-preview,.omni-structured__preview-body>.omni-structured__raw-preview{position:absolute;inset:0}.omni-structured__node{display:flex;gap:6px;align-items:baseline;min-height:25px}.omni-structured__toggle{width:24px;padding:0!important;border:0!important;background:transparent!important}.omni-structured__key{color:var(--omni-accent,#5aa9e6)}.omni-structured__kind{color:var(--omni-fg-muted,#999)}.omni-structured__value{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.omni-structured__actions{margin-left:auto;display:flex;gap:4px;opacity:0}.omni-structured__node:hover .omni-structured__actions,.omni-structured__actions:focus-within{opacity:1}.omni-structured__raw-preview,.omni-structured__json-preview{flex:1;min-height:0;margin:0;padding:10px;overflow:auto;font-family:var(--omni-font-mono,ui-monospace,monospace);line-height:1.5}.omni-structured__flat-row .omni-structured__key{flex-shrink:0}@media(max-width:720px){.omni-structured__workspace{grid-template-columns:1fr;overflow:auto}.omni-structured__pane{min-height:320px}}

package/dist/styles/yaml.css

@@ -1 +1 @@
-:host,.omni-viewer--toml,.omni-viewer--yaml{display:block;height:100%;color:var(--omni-fg,#ddd);background:var(--omni-bg,#1e1e1e);font:13px var(--omni-font,system-ui)}.omni-structured{height:100%;display:flex;flex-direction:column;box-sizing:border-box}.omni-structured__bar{display:flex;gap:5px;align-items:center;padding:6px;border-bottom:1px solid var(--omni-border,#444)}.omni-structured button,.omni-structured input,.omni-structured select{font:inherit;background:var(--omni-button-bg,#333);color:inherit;border:1px solid var(--omni-border,#555);border-radius:3px;padding:3px 7px}.omni-structured button:disabled{opacity:.5}.omni-structured__search{min-width:180px}.omni-structured__diagnostics{white-space:pre-wrap;color:var(--omni-error,#f48771);padding:6px;border-bottom:1px solid var(--omni-border,#444)}.omni-structured__workspace{display:grid;grid-template-columns:minmax(0,1fr) minmax(0,1fr);grid-template-rows:minmax(0,1fr);gap:12px;flex:1;min-height:0;padding:12px}.omni-structured__pane{display:flex;flex-direction:column;min-width:0;min-height:0;border:1px solid var(--omni-border,#444);border-radius:8px;overflow:hidden;background:var(--omni-input-bg,#171717)}.omni-structured__pane-header{display:flex;justify-content:space-between;gap:12px;padding:10px 12px;border-bottom:1px solid var(--omni-border,#444)}.omni-structured__pane-header span{color:var(--omni-fg-muted,#999)}.omni-structured__editor,.omni-structured__tree{box-sizing:border-box;flex:1;min-height:0;padding:10px;background:transparent;color:inherit;font:inherit;font-family:var(--omni-font-mono,ui-monospace,monospace)}.omni-structured__editor{resize:none;border:0;outline:none;line-height:1.5;white-space:pre;overflow:auto}.omni-structured__source-surface{position:relative;flex:1;min-height:0;overflow:hidden}.omni-structured__source-highlight{position:absolute;inset:0;box-sizing:border-box;margin:0;padding:10px;overflow:auto;pointer-events:none;font:inherit;font-family:var(--omni-font-mono,ui-monospace,monospace);line-height:1.5;white-space:pre}.omni-structured__pane--highlighted-source .omni-structured__editor{position:relative;z-index:1;width:100%;height:100%;padding:10px;color:transparent;caret-color:var(--omni-fg,#ddd);-webkit-text-fill-color:transparent}.omni-structured__source-key{color:#9cdcfe}.omni-structured__source-value{color:#ce9178}.omni-structured__source-table{color:#c586c0}.omni-structured__source-comment{color:var(--omni-fg-muted,#999)}.omni-structured__tree{overflow:auto}.omni-structured__node{display:flex;gap:6px;align-items:baseline;min-height:25px}.omni-structured__toggle{width:24px;padding:0!important;border:0!important;background:transparent!important}.omni-structured__key{color:var(--omni-accent,#5aa9e6)}.omni-structured__kind{color:var(--omni-fg-muted,#999)}.omni-structured__value{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.omni-structured__actions{margin-left:auto;display:flex;gap:4px;opacity:0}.omni-structured__node:hover .omni-structured__actions,.omni-structured__actions:focus-within{opacity:1}.omni-structured__raw-preview,.omni-structured__json-preview{flex:1;min-height:0;margin:0;padding:10px;overflow:auto;font-family:var(--omni-font-mono,ui-monospace,monospace);line-height:1.5}.omni-structured__flat-row .omni-structured__key{flex-shrink:0}@media(max-width:720px){.omni-structured__workspace{grid-template-columns:1fr;overflow:auto}.omni-structured__pane{min-height:320px}}
+:host,.omni-viewer--toml,.omni-viewer--yaml{display:block;height:100%;color:var(--omni-fg,#ddd);background:var(--omni-bg,#1e1e1e);font:13px var(--omni-font,system-ui)}.omni-structured{height:100%;display:flex;flex-direction:column;box-sizing:border-box}.omni-structured__bar{display:flex;gap:5px;align-items:center;padding:6px;border-bottom:1px solid var(--omni-border,#444)}.omni-structured button,.omni-structured input,.omni-structured select{font:inherit;background:var(--omni-button-bg,#333);color:inherit;border:1px solid var(--omni-border,#555);border-radius:3px;padding:3px 7px}.omni-structured button:disabled{opacity:.5}.omni-structured__search{min-width:180px}.omni-structured__diagnostics{white-space:pre-wrap;color:var(--omni-error,#f48771);padding:6px;border-bottom:1px solid var(--omni-border,#444)}.omni-structured__workspace{display:grid;grid-template-columns:minmax(0,1fr) minmax(0,1fr);grid-template-rows:minmax(0,1fr);gap:12px;flex:1;min-height:0;padding:12px}.omni-structured__pane{display:flex;flex-direction:column;min-width:0;min-height:0;border:1px solid var(--omni-border,#444);border-radius:8px;overflow:hidden;background:var(--omni-input-bg,#171717)}.omni-structured__pane-header{display:flex;justify-content:space-between;gap:12px;padding:10px 12px;border-bottom:1px solid var(--omni-border,#444)}.omni-structured__pane-header span{color:var(--omni-fg-muted,#999)}.omni-structured__editor,.omni-structured__tree{box-sizing:border-box;flex:1;min-height:0;padding:10px;background:transparent;color:inherit;font:inherit;font-family:var(--omni-font-mono,ui-monospace,monospace)}.omni-structured__editor{resize:none;border:0;outline:none;line-height:1.5;white-space:pre;overflow:auto}.omni-structured__source-surface{position:relative;flex:1;min-height:0;overflow:hidden}.omni-structured__source-highlight{position:absolute;inset:0;box-sizing:border-box;margin:0;padding:10px;overflow:auto;pointer-events:none;font:inherit;font-family:var(--omni-font-mono,ui-monospace,monospace);line-height:1.5;white-space:pre}.omni-structured__pane--highlighted-source .omni-structured__editor{position:relative;z-index:1;width:100%;height:100%;padding:10px;color:transparent;caret-color:var(--omni-fg,#ddd);-webkit-text-fill-color:transparent}.omni-structured__source-key{color:#9cdcfe}.omni-structured__source-value{color:#ce9178}.omni-structured__source-table{color:#c586c0}.omni-structured__source-comment{color:var(--omni-fg-muted,#999)}.omni-structured__tree{overflow:auto}.omni-structured__preview-body{position:relative;flex:1;min-height:200px}.omni-structured__preview-body>.omni-structured__tree,.omni-structured__preview-body>.omni-structured__json-preview,.omni-structured__preview-body>.omni-structured__raw-preview{position:absolute;inset:0}.omni-structured__node{display:flex;gap:6px;align-items:baseline;min-height:25px}.omni-structured__toggle{width:24px;padding:0!important;border:0!important;background:transparent!important}.omni-structured__key{color:var(--omni-accent,#5aa9e6)}.omni-structured__kind{color:var(--omni-fg-muted,#999)}.omni-structured__value{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.omni-structured__actions{margin-left:auto;display:flex;gap:4px;opacity:0}.omni-structured__node:hover .omni-structured__actions,.omni-structured__actions:focus-within{opacity:1}.omni-structured__raw-preview,.omni-structured__json-preview{flex:1;min-height:0;margin:0;padding:10px;overflow:auto;font-family:var(--omni-font-mono,ui-monospace,monospace);line-height:1.5}.omni-structured__flat-row .omni-structured__key{flex-shrink:0}@media(max-width:720px){.omni-structured__workspace{grid-template-columns:1fr;overflow:auto}.omni-structured__pane{min-height:320px}}

package/dist/viewers/json/controller.js

@@ -187,27 +187,16 @@ export function createJsonController(input, options = {}) {
         state.statusMessage = { key: messageKey };
     };
     const requireValidRoot = () => state.status === 'ok' && state.root ? state.root : null;
-    /** Show raw-text conversions for review without overwriting the editor. */
-    const runRawResult = (action, result) => {
+    /** Raw-text transforms replace the scratchpad immediately (J11, vscode
+     * routing) so they chain naturally; failures surface as status messages. */
+    const runRawTransform = (action, result) => {
         const transformed = typeof result === 'string' ? { ok: true, output: result } : result;
-        state.toolResult = {
-            action,
-            titleKey: TOOL_MESSAGE[action],
-            output: transformed.ok ? transformed.output : '',
-            ...(transformed.ok
-                ? {}
-                : { error: { key: TRANSFORM_ERROR[transformed.error] ?? 'json.tool.failed' } })
-        };
-    };
-    /** Chain Base64 operations through their latest successful result while
-     * leaving the editor's original JSON untouched. */
-    const base64Input = () => {
-        const previous = state.toolResult;
-        return previous
-            && !previous.error
-            && (previous.action === 'base64-encode' || previous.action === 'base64-decode')
-            ? previous.output
-            : state.scratchpad;
+        if (transformed.ok) {
+            replaceScratchpad(transformed.output, TOOL_MESSAGE[action]);
+        }
+        else {
+            state.statusMessage = { key: TRANSFORM_ERROR[transformed.error] ?? 'json.tool.failed' };
+        }
     };
     const runConverter = (action, convert) => {
         const root = requireValidRoot();
@@ -269,16 +258,16 @@ export function createJsonController(input, options = {}) {
                 break;
             }
             case 'escape':
-                runRawResult('escape', escapeText(state.scratchpad));
+                runRawTransform('escape', escapeText(state.scratchpad));
                 break;
             case 'unescape':
-                runRawResult('unescape', unescapeText(state.scratchpad));
+                runRawTransform('unescape', unescapeText(state.scratchpad));
                 break;
             case 'base64-encode':
-                runRawResult('base64-encode', base64Encode(base64Input()));
+                runRawTransform('base64-encode', base64Encode(state.scratchpad));
                 break;
             case 'base64-decode':
-                runRawResult('base64-decode', base64Decode(base64Input()));
+                runRawTransform('base64-decode', base64Decode(state.scratchpad));
                 break;
             case 'to-csv':
                 runConverter('to-csv', jsonToCsv);

package/dist/viewers/json/index.js

@@ -246,10 +246,13 @@ export async function mountJsonViewer(input, container, ctx, options = {}) {
         copyResultBtn.disabled = true;
         copyResultBtn.title = t('common.noClipboard');
     }
+    const replaceResultBtn = el('button', undefined, t('json.result.replace'));
+    replaceResultBtn.type = 'button';
+    on(replaceResultBtn, 'click', () => controller.dispatch({ type: 'apply-result-to-editor' }));
     const closeResultBtn = el('button', undefined, t('json.result.close'));
     closeResultBtn.type = 'button';
     on(closeResultBtn, 'click', () => controller.dispatch({ type: 'dismiss-result' }));
-    resultActions.append(copyResultBtn, closeResultBtn);
+    resultActions.append(copyResultBtn, replaceResultBtn, closeResultBtn);
     resultPanel.append(resultTitle, resultOutput, resultMarkup, resultTableWrap, resultActions);
     frame.append(toolbar, statusBar, diagnosticsBar, resultPanel, body);
     root.appendChild(frame);
@@ -475,6 +478,7 @@ export async function mountJsonViewer(input, container, ctx, options = {}) {
             if (isMarkup)
                 renderMarkupResult(state.toolResult.action, state.toolResult.output);
             copyResultBtn.disabled = !clipboard || !!state.toolResult.error;
+            replaceResultBtn.disabled = !!state.toolResult.error;
         }
         else {
             resultPanel.style.display = 'none';

package/dist/viewers/markdown/index.d.ts

@@ -1,4 +1,4 @@
-import type { ClipboardService, DocumentAssetsService, FileWritebackService, HostContext, NavigationService } from '../../host/index.js';
+import type { ClipboardService, DocumentAssetsService, FileSaveService, FileWritebackService, HostContext, NavigationService } from '../../host/index.js';
 import { type MarkdownParseOptions } from '../../parsers/markdown/index.js';
 import type { ResourceLimits } from '../../parsers/types.js';
 import { type MountOptions, type ViewerHandle, type ViewerInput } from '../types.js';
@@ -12,7 +12,7 @@ export declare const MARKDOWN_VIEWER_META: {
     extensions: string[];
     priority: number;
     requiredServices: readonly [];
-    optionalServices: readonly ["clipboard", "navigation", "documentAssets", "writeback"];
+    optionalServices: readonly ["clipboard", "navigation", "documentAssets", "writeback", "save"];
     inputOwnership: "borrows";
 };
 export interface MarkdownRenderer {
@@ -56,6 +56,7 @@ export type MarkdownViewerContext = HostContext & {
     navigation?: NavigationService;
     documentAssets?: DocumentAssetsService;
     writeback?: FileWritebackService;
+    save?: FileSaveService;
 };
 export interface MarkdownMountOptions extends MountOptions {
     limits?: ResourceLimits;

package/dist/viewers/markdown/index.js

@@ -12,7 +12,7 @@ export const MARKDOWN_VIEWER_META = {
     id: 'markdown', displayNameKey: 'markdown.title',
     extensions: ['md', 'markdown', 'mdown', 'mkdn', 'mkd'], priority: 10,
     requiredServices: [],
-    optionalServices: ['clipboard', 'navigation', 'documentAssets', 'writeback'],
+    optionalServices: ['clipboard', 'navigation', 'documentAssets', 'writeback', 'save'],
     inputOwnership: 'borrows'
 };
 const SANITIZE = {
@@ -323,22 +323,37 @@ export async function mountMarkdownViewer(input, container, ctx, deps, options =
         }
     };
     const saveSource = async () => {
-        if (!ctx.writeback) {
-            showMessage(t('common.noWriteback'));
-            setStatus('common.saveFailed', 'invalid');
+        const bytes = new TextEncoder().encode(controller.state.source);
+        if (ctx.writeback) {
+            try {
+                await ctx.writeback.write(bytes);
+                controller.dispatch({ type: 'mark-saved' });
+                setStatus('common.savedToOriginal', 'valid');
+                sourceCaption.textContent = t('common.savedToOriginal');
+            }
+            catch (error) {
+                ctx.logger.log('error', `markdown save failed: ${String(error)}`);
+                setStatus('common.saveFailed', 'invalid');
+                showMessage(errorText(error, t('common.saveFailed')));
+            }
             return;
         }
-        try {
-            await ctx.writeback.write(new TextEncoder().encode(controller.state.source));
-            controller.dispatch({ type: 'mark-saved' });
-            setStatus('common.savedToOriginal', 'valid');
-            sourceCaption.textContent = t('common.savedToOriginal');
-        }
-        catch (error) {
-            ctx.logger.log('error', `markdown save failed: ${String(error)}`);
-            setStatus('common.saveFailed', 'invalid');
-            showMessage(errorText(error, t('common.saveFailed')));
+        if (ctx.save) {
+            // Download fallback saves a copy, not the original — the dirty
+            // state is intentionally kept (no mark-saved).
+            try {
+                await ctx.save.saveFile(input.fileName, bytes, 'text/markdown');
+                setStatus('common.savedToOriginal', 'valid');
+            }
+            catch (error) {
+                ctx.logger.log('error', `markdown save failed: ${String(error)}`);
+                setStatus('common.saveFailed', 'invalid');
+                showMessage(errorText(error, t('common.saveFailed')));
+            }
+            return;
         }
+        showMessage(t('common.noWriteback'));
+        setStatus('common.saveFailed', 'invalid');
     };
     const copy = async (value, successKey) => {
         if (!ctx.clipboard)

package/dist/viewers/pdf/controller.d.ts

@@ -1,4 +1,6 @@
-export declare const PDF_ZOOM_LEVELS: readonly [50, 75, 100, 125, 150, 200, 300];
+export declare const PDF_ZOOM_LEVELS: readonly [50, 75, 100, 125, 150, 175, 200, 225, 250, 275, 300];
+export declare const PDF_MIN_ZOOM = 25;
+export declare const PDF_MAX_ZOOM = 400;
 export type PdfZoom = number;
 export interface PdfTextAnnotation {
     id: string;
@@ -109,12 +111,22 @@ export type PdfAction = {
 };
 export interface PdfController {
     readonly state: PdfViewState;
+    /** Ordered button steps used by zoom-in/zoom-out. */
+    readonly zoomLevels: readonly number[];
+    readonly minZoom: number;
+    readonly maxZoom: number;
     dispatch(action: PdfAction): void;
     subscribe(listener: (state: PdfViewState) => void): () => void;
 }
+export interface PdfControllerOptions {
+    /** Custom button steps. Fit-to-width/height may still set an intermediate value. */
+    zoomLevels?: readonly number[];
+    minZoom?: number;
+    maxZoom?: number;
+}
 /** Persisted layer used to restore an editing session (sidecar rehydration). */
 export interface PdfControllerSeed {
     pageOrder?: readonly number[];
     annotations?: readonly PdfAnnotation[];
 }
-export declare function createPdfController(pageCount: number, seed?: PdfControllerSeed): PdfController;
+export declare function createPdfController(pageCount: number, seed?: PdfControllerSeed, options?: PdfControllerOptions): PdfController;