omni-viewer-core 0.3.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/pptx/index.d.ts

@@ -13,4 +13,5 @@ export interface PptxParserDeps {
 export { openPptxZip } from './zip-reader.js';
 import { parsePptxVscode } from './vscode.js';
 export { parsePptxVscode };
+export declare function parsePptxLegacy(input: Uint8Array, deps: PptxParserDeps, options?: ParseOptions): Promise<ParseOutcome<SlideDeck>>;
 export declare function parsePptx(input: Uint8Array, deps: PptxParserDeps, options?: ParseOptions): Promise<ParseOutcome<SlideDeck>>;

package/dist/parsers/pptx/index.js

@@ -55,7 +55,7 @@ async function parseSlide(zip, path, n, size) { const xml = await zip.text(path)
     else
         elements.push({ ...common, type: 'shape', presetGeom: geom, fillColor: color(block, 'transparent'), borderColor: color(/<a:ln\b[\s\S]*?<\/a:ln>/.exec(block)?.[0] ?? '') });
 } return { slideNumber: n, ...size, backgroundColor: color(/<p:bg\b[\s\S]*?<\/p:bg>/.exec(xml)?.[0] ?? '', '#ffffff') ?? '#ffffff', elements }; }
-async function parsePptxLegacy(input, deps, options = {}) { const started = Date.now(), diagnostics = []; if (input.byteLength > (options.limits?.maxInputBytes ?? 50 * 1024 * 1024))
+export async function parsePptxLegacy(input, deps, options = {}) { const started = Date.now(), diagnostics = []; if (input.byteLength > (options.limits?.maxInputBytes ?? 50 * 1024 * 1024))
     return { result: { status: 'failed', failure: { code: 'limit-exceeded', retryable: false, messageKey: 'diag.limit-exceeded.input' }, diagnostics }, execution: { workerUsed: false, hardLimitEnforced: false, elapsedMillis: Date.now() - started } }; let zip; try {
     zip = await deps.openZip(input, options);
     const presentation = await zip.text('ppt/presentation.xml');

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/archive.css

@@ -4,7 +4,7 @@
 .omni-viewer--archive *{box-sizing:border-box}.omni-viewer--archive{padding:28px 20px 40px}.omni-archive__hero,.omni-archive__controls,.omni-archive__stats,.omni-archive__table-wrap,.omni-archive__preview-panel{background:var(--omni-bg-secondary,#252526);border:1px solid var(--omni-border,#3c3c3c);border-radius:18px;box-shadow:0 20px 40px rgba(0,0,0,.12)}
 .omni-archive__hero{display:flex;justify-content:space-between;gap:16px;padding:24px;align-items:flex-start}.omni-archive__eyebrow{font-size:12px;letter-spacing:.18em;text-transform:uppercase;color:var(--omni-accent,#d97706);font-weight:700}.omni-archive__hero h1{margin:8px 0 6px;font-size:clamp(26px,4vw,40px);line-height:1.1}.omni-archive__subtitle,.omni-archive__preview-meta{color:var(--omni-muted-fg,#9d9d9d);line-height:1.5}.omni-archive__pills{display:flex;gap:10px;flex-wrap:wrap;justify-content:flex-end}.omni-archive__pill{padding:10px 14px;border-radius:999px;background:color-mix(in srgb,var(--omni-accent,#d97706) 16%,transparent);border:1px solid color-mix(in srgb,var(--omni-accent,#d97706) 35%,transparent);font-weight:600;white-space:nowrap}
 .omni-archive__controls,.omni-archive__stats,.omni-archive__workspace{margin-top:16px}.omni-archive__controls{padding:16px}.omni-archive__search-label{display:block;font-weight:600}.omni-archive__search{display:block;width:100%;margin-top:8px;padding:12px 14px;border-radius:12px;border:1px solid var(--omni-border,#3c3c3c);background:var(--omni-input-bg,#3c3c3c);color:var(--omni-fg,#d4d4d4);font:inherit}.omni-archive__stats{display:grid;grid-template-columns:repeat(auto-fit,minmax(140px,1fr));gap:12px;padding:16px}.omni-archive__stat{padding:14px;border-radius:14px;background:color-mix(in srgb,var(--omni-bg-secondary,#252526) 76%,#000);border:1px solid var(--omni-border,#3c3c3c)}.omni-archive__stat-label{font-size:12px;text-transform:uppercase;letter-spacing:.08em;color:var(--omni-muted-fg,#9d9d9d);margin-bottom:6px}.omni-archive__stat-value{font-size:24px;font-weight:700}
-.omni-archive__workspace{display:grid;grid-template-columns:minmax(0,1.7fr) minmax(320px,.95fr);gap:16px;align-items:start}.omni-archive__table-wrap{overflow:auto;min-width:0;max-height:70vh}.omni-archive__table{width:100%;table-layout:fixed;border-collapse:collapse}.omni-archive__table th,.omni-archive__table td{padding:12px 14px;border-bottom:1px solid var(--omni-border,#3c3c3c);text-align:left;vertical-align:top;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.omni-archive__table th:first-child{width:42%}.omni-archive__table th{position:sticky;top:0;font-size:12px;text-transform:uppercase;letter-spacing:.08em;color:var(--omni-muted-fg,#9d9d9d);background:var(--omni-bg-secondary,#252526);z-index:1}.omni-archive__path{font-family:var(--omni-mono-font,"SFMono-Regular",Consolas,monospace)}.omni-archive__entry{height:43px;cursor:pointer;transition:background-color 120ms ease}.omni-archive__entry:hover{background:color-mix(in srgb,var(--omni-accent,#d97706) 8%,transparent)}.omni-archive__entry:focus-visible{outline:2px solid var(--omni-accent,#d97706);outline-offset:-2px}.omni-archive__entry.is-selected{background:color-mix(in srgb,var(--omni-accent,#d97706) 16%,transparent)}.omni-archive__empty{padding:26px 18px;text-align:center;color:var(--omni-muted-fg,#9d9d9d)}
+.omni-archive__workspace{display:grid;grid-template-columns:minmax(0,1.7fr) minmax(320px,.95fr);gap:16px;align-items:start}.omni-archive__table-wrap{overflow:auto;min-width:0;max-height:70vh;overflow-anchor:none}.omni-archive__table{width:100%;table-layout:fixed;border-collapse:collapse}.omni-archive__table th,.omni-archive__table td{padding:12px 14px;border-bottom:1px solid var(--omni-border,#3c3c3c);text-align:left;vertical-align:top;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.omni-archive__table th:first-child{width:42%}.omni-archive__table th{position:sticky;top:0;font-size:12px;text-transform:uppercase;letter-spacing:.08em;color:var(--omni-muted-fg,#9d9d9d);background:var(--omni-bg-secondary,#252526);z-index:1}.omni-archive__path{font-family:var(--omni-mono-font,"SFMono-Regular",Consolas,monospace)}.omni-archive__entry{height:43px;cursor:pointer;transition:background-color 120ms ease}.omni-archive__entry:hover{background:color-mix(in srgb,var(--omni-accent,#d97706) 8%,transparent)}.omni-archive__entry:focus-visible{outline:2px solid var(--omni-accent,#d97706);outline-offset:-2px}.omni-archive__entry.is-selected{background:color-mix(in srgb,var(--omni-accent,#d97706) 16%,transparent)}.omni-archive__empty{padding:26px 18px;text-align:center;color:var(--omni-muted-fg,#9d9d9d)}
 .omni-archive__preview-panel{padding:18px;min-height:420px;display:flex;flex-direction:column;gap:14px}.omni-archive__preview-header{display:flex;justify-content:space-between;gap:12px;align-items:flex-start}.omni-archive__preview-kicker{font-size:12px;letter-spacing:.08em;text-transform:uppercase;color:var(--omni-muted-fg,#9d9d9d);margin-bottom:6px}.omni-archive__preview-header h2{margin:0;font-size:18px;line-height:1.35;word-break:break-word}.omni-archive__preview-badge{border-radius:999px;padding:8px 12px;font-size:12px;font-weight:700;background:var(--omni-badge-bg,#3a3d41);white-space:nowrap}.omni-archive__preview-meta{margin:0}.omni-archive__preview{margin:0;flex:1;overflow:auto;white-space:pre-wrap;word-break:break-word;border-radius:14px;border:1px solid var(--omni-border,#3c3c3c);background:var(--omni-code-bg,#181818);padding:14px;color:var(--omni-fg,#d4d4d4);font:12px/1.55 var(--omni-mono-font,"SFMono-Regular",Consolas,monospace)}
 .omni-archive__save{align-self:flex-start;padding:8px 12px;border:1px solid var(--omni-border,#3c3c3c);border-radius:6px;background:var(--omni-button-bg,#3a3d41);color:var(--omni-fg,#d4d4d4);font:inherit;cursor:pointer}.omni-archive__save:hover:not(:disabled){background:var(--omni-button-hover-bg,#45494e)}.omni-archive__save:disabled{opacity:.55;cursor:not-allowed}.omni-archive__spacer td{padding:0!important;border:0!important}
 .omni-archive__preview-media{flex:1;display:flex;align-items:center;justify-content:center;border-radius:14px;border:1px solid var(--omni-border,#3c3c3c);background:var(--omni-code-bg,#181818);padding:14px;overflow:auto}.omni-archive__audio{width:100%}.omni-archive__video{max-width:100%;max-height:100%}.omni-archive__image{max-width:100%;max-height:100%;object-fit:contain}

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/archive/index.js

@@ -294,20 +294,57 @@ export async function mountArchiveViewer(inputOrSource, container, ctx, depsOrOp
     const ROW_HEIGHT = 43;
     const OVERSCAN = 8;
     const FALLBACK_VIEWPORT_HEIGHT = 600;
-    const render = () => {
+    let lastStart = -1;
+    let lastEnd = -1;
+    let lastLength = -1;
+    let lastQuery;
+    let lastExpanded;
+    /** `force` covers state changes (search/select/expand) that must repaint the
+     *  rows; scroll events pass `false` so an unchanged window is a no-op. */
+    const render = (force = true) => {
         const visible = controller.visibleEntries();
+        // Measure before mutating: emptying the tbody first would collapse the
+        // scroll height, so the layout flush from reading clientHeight clamps
+        // scrollTop to 0 and every scroll snaps back to the top of the list.
+        const viewportHeight = tableWrap.clientHeight || FALLBACK_VIEWPORT_HEIGHT;
+        const scrollTop = tableWrap.scrollTop;
+        const start = Math.max(0, Math.floor(scrollTop / ROW_HEIGHT) - OVERSCAN);
+        const count = Math.ceil(viewportHeight / ROW_HEIGHT) + OVERSCAN * 2;
+        const end = Math.min(visible.length, start + count);
+        // Most scroll ticks land inside the overscan margin. Rebuilding the rows
+        // anyway would destroy the focused row on every tick, and the resulting
+        // focus restore plus scroll anchoring drags the viewport around.
+        // The rendered window is fully determined by these; the controller hands
+        // out a fresh `expanded` set per toggle, so identity comparison is enough.
+        const sameWindow = start === lastStart && end === lastEnd && visible.length === lastLength
+            && controller.state.query === lastQuery && controller.state.expanded === lastExpanded;
+        // Most scroll ticks land inside the overscan margin. Rebuilding the rows
+        // anyway would destroy the focused row on every tick, and the resulting
+        // focus restore plus scroll anchoring drags the viewport around.
+        if (!force && sameWindow)
+            return;
+        // Selecting an entry only flips a class. Rebuilding every row for that is
+        // what threw the viewport back to the top the moment a row was clicked,
+        // so patch the existing rows in place and leave the scroll state alone.
+        if (sameWindow) {
+            for (const row of tbody.querySelectorAll('.omni-archive__entry'))
+                row.classList.toggle('is-selected', Number(row.dataset.entryId) === controller.state.selectedId);
+            return;
+        }
+        lastStart = start;
+        lastEnd = end;
+        lastLength = visible.length;
+        lastQuery = controller.state.query;
+        lastExpanded = controller.state.expanded;
         visibleStat[1] = visible.length;
         stats.querySelectorAll('.omni-archive__stat-value')[3].textContent = visible.length.toLocaleString();
-        tbody.replaceChildren();
         empty.hidden = visible.length !== 0;
         table.hidden = visible.length === 0;
-        const viewportHeight = tableWrap.clientHeight || FALLBACK_VIEWPORT_HEIGHT;
-        const start = Math.max(0, Math.floor(tableWrap.scrollTop / ROW_HEIGHT) - OVERSCAN);
-        const count = Math.ceil(viewportHeight / ROW_HEIGHT) + OVERSCAN * 2;
-        const end = Math.min(visible.length, start + count);
         const spacer = (height) => { const row = element('tr', 'omni-archive__spacer'); const cell = element('td'); cell.colSpan = 5; cell.style.height = `${height}px`; row.append(cell); return row; };
+        // Build off-DOM and swap once, so the tbody is never laid out empty.
+        const rows = [];
         if (start > 0)
-            tbody.append(spacer(start * ROW_HEIGHT));
+            rows.push(spacer(start * ROW_HEIGHT));
         for (const entry of visible.slice(start, end)) {
             const row = element('tr', `omni-archive__entry${controller.state.selectedId === entry.entryId ? ' is-selected' : ''}`);
             row.tabIndex = 0;
@@ -320,14 +357,26 @@ export async function mountArchiveViewer(inputOrSource, container, ctx, depsOrOp
                 event.preventDefault();
                 void select(entry);
             } });
-            tbody.append(row);
+            rows.push(row);
         }
         if (end < visible.length)
-            tbody.append(spacer((visible.length - end) * ROW_HEIGHT));
+            rows.push(spacer((visible.length - end) * ROW_HEIGHT));
+        // Recycling rows destroys the focused one; hand focus back to its
+        // replacement so keyboard navigation survives a scroll.
+        const active = (typeof ShadowRoot !== 'undefined' && root instanceof ShadowRoot ? root.activeElement : document.activeElement);
+        const focusedId = active instanceof HTMLElement && tbody.contains(active) ? active.dataset.entryId : undefined;
+        tbody.replaceChildren(...rows);
+        // Swapping the rows can still make the browser adjust the offset (focus
+        // fixup, anchoring, a transient height change). The list is virtualized,
+        // so the pre-swap offset is authoritative — put it back.
+        if (tableWrap.scrollTop !== scrollTop)
+            tableWrap.scrollTop = scrollTop;
+        if (focusedId !== undefined)
+            rows.find(row => row.dataset.entryId === focusedId)?.focus({ preventScroll: true });
     };
-    tableWrap.addEventListener('scroll', render, { passive: true });
+    tableWrap.addEventListener('scroll', () => render(false), { passive: true });
     search.addEventListener('input', () => { tableWrap.scrollTop = 0; controller.dispatch({ type: 'set-search', query: search.value }); });
-    const unsubscribe = controller.subscribe(render);
+    const unsubscribe = controller.subscribe(() => render(true));
     render();
     return { dispose() { ticket++; extraction?.abort(); saveExtraction?.abort(); clearPreviewMedia(); unsubscribe(); wrap.remove(); void handle?.close(); handle = undefined; } };
 }

package/dist/viewers/archive/styles.d.ts

@@ -1 +1 @@
-export declare const archiveViewerCss = "\n.omni-viewer--archive{all:initial}.omni-viewer--archive :where(header,section,aside,div,h1,h2,p,span,label,input,table,thead,tbody,tr,th,td,pre){all:revert}\n:host,.omni-viewer--archive{display:block;min-height:100%;box-sizing:border-box;color:var(--omni-fg,#d4d4d4);background:radial-gradient(circle at top left,color-mix(in srgb,var(--omni-accent,#d97706) 14%,transparent),transparent 28%),var(--omni-bg,#1e1e1e);font:13px var(--omni-font,-apple-system,BlinkMacSystemFont,\"Segoe UI\",sans-serif)}\n.omni-viewer--archive *{box-sizing:border-box}.omni-viewer--archive{padding:28px 20px 40px}.omni-archive__hero,.omni-archive__controls,.omni-archive__stats,.omni-archive__table-wrap,.omni-archive__preview-panel{background:var(--omni-bg-secondary,#252526);border:1px solid var(--omni-border,#3c3c3c);border-radius:18px;box-shadow:0 20px 40px rgba(0,0,0,.12)}\n.omni-archive__hero{display:flex;justify-content:space-between;gap:16px;padding:24px;align-items:flex-start}.omni-archive__eyebrow{font-size:12px;letter-spacing:.18em;text-transform:uppercase;color:var(--omni-accent,#d97706);font-weight:700}.omni-archive__hero h1{margin:8px 0 6px;font-size:clamp(26px,4vw,40px);line-height:1.1}.omni-archive__subtitle,.omni-archive__preview-meta{color:var(--omni-muted-fg,#9d9d9d);line-height:1.5}.omni-archive__pills{display:flex;gap:10px;flex-wrap:wrap;justify-content:flex-end}.omni-archive__pill{padding:10px 14px;border-radius:999px;background:color-mix(in srgb,var(--omni-accent,#d97706) 16%,transparent);border:1px solid color-mix(in srgb,var(--omni-accent,#d97706) 35%,transparent);font-weight:600;white-space:nowrap}\n.omni-archive__controls,.omni-archive__stats,.omni-archive__workspace{margin-top:16px}.omni-archive__controls{padding:16px}.omni-archive__search-label{display:block;font-weight:600}.omni-archive__search{display:block;width:100%;margin-top:8px;padding:12px 14px;border-radius:12px;border:1px solid var(--omni-border,#3c3c3c);background:var(--omni-input-bg,#3c3c3c);color:var(--omni-fg,#d4d4d4);font:inherit}.omni-archive__stats{display:grid;grid-template-columns:repeat(auto-fit,minmax(140px,1fr));gap:12px;padding:16px}.omni-archive__stat{padding:14px;border-radius:14px;background:color-mix(in srgb,var(--omni-bg-secondary,#252526) 76%,#000);border:1px solid var(--omni-border,#3c3c3c)}.omni-archive__stat-label{font-size:12px;text-transform:uppercase;letter-spacing:.08em;color:var(--omni-muted-fg,#9d9d9d);margin-bottom:6px}.omni-archive__stat-value{font-size:24px;font-weight:700}\n.omni-archive__workspace{display:grid;grid-template-columns:minmax(0,1.7fr) minmax(320px,.95fr);gap:16px;align-items:start}.omni-archive__table-wrap{overflow:auto;min-width:0;max-height:70vh}.omni-archive__table{width:100%;table-layout:fixed;border-collapse:collapse}.omni-archive__table th,.omni-archive__table td{padding:12px 14px;border-bottom:1px solid var(--omni-border,#3c3c3c);text-align:left;vertical-align:top;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.omni-archive__table th:first-child{width:42%}.omni-archive__table th{position:sticky;top:0;font-size:12px;text-transform:uppercase;letter-spacing:.08em;color:var(--omni-muted-fg,#9d9d9d);background:var(--omni-bg-secondary,#252526);z-index:1}.omni-archive__path{font-family:var(--omni-mono-font,\"SFMono-Regular\",Consolas,monospace)}.omni-archive__entry{height:43px;cursor:pointer;transition:background-color 120ms ease}.omni-archive__entry:hover{background:color-mix(in srgb,var(--omni-accent,#d97706) 8%,transparent)}.omni-archive__entry:focus-visible{outline:2px solid var(--omni-accent,#d97706);outline-offset:-2px}.omni-archive__entry.is-selected{background:color-mix(in srgb,var(--omni-accent,#d97706) 16%,transparent)}.omni-archive__empty{padding:26px 18px;text-align:center;color:var(--omni-muted-fg,#9d9d9d)}\n.omni-archive__preview-panel{padding:18px;min-height:420px;display:flex;flex-direction:column;gap:14px}.omni-archive__preview-header{display:flex;justify-content:space-between;gap:12px;align-items:flex-start}.omni-archive__preview-kicker{font-size:12px;letter-spacing:.08em;text-transform:uppercase;color:var(--omni-muted-fg,#9d9d9d);margin-bottom:6px}.omni-archive__preview-header h2{margin:0;font-size:18px;line-height:1.35;word-break:break-word}.omni-archive__preview-badge{border-radius:999px;padding:8px 12px;font-size:12px;font-weight:700;background:var(--omni-badge-bg,#3a3d41);white-space:nowrap}.omni-archive__preview-meta{margin:0}.omni-archive__preview{margin:0;flex:1;overflow:auto;white-space:pre-wrap;word-break:break-word;border-radius:14px;border:1px solid var(--omni-border,#3c3c3c);background:var(--omni-code-bg,#181818);padding:14px;color:var(--omni-fg,#d4d4d4);font:12px/1.55 var(--omni-mono-font,\"SFMono-Regular\",Consolas,monospace)}\n.omni-archive__save{align-self:flex-start;padding:8px 12px;border:1px solid var(--omni-border,#3c3c3c);border-radius:6px;background:var(--omni-button-bg,#3a3d41);color:var(--omni-fg,#d4d4d4);font:inherit;cursor:pointer}.omni-archive__save:hover:not(:disabled){background:var(--omni-button-hover-bg,#45494e)}.omni-archive__save:disabled{opacity:.55;cursor:not-allowed}.omni-archive__spacer td{padding:0!important;border:0!important}\n.omni-archive__preview-media{flex:1;display:flex;align-items:center;justify-content:center;border-radius:14px;border:1px solid var(--omni-border,#3c3c3c);background:var(--omni-code-bg,#181818);padding:14px;overflow:auto}.omni-archive__audio{width:100%}.omni-archive__video{max-width:100%;max-height:100%}.omni-archive__image{max-width:100%;max-height:100%;object-fit:contain}\n@media(max-width:720px){.omni-viewer--archive{padding:16px 10px 24px}.omni-archive__hero{flex-direction:column}.omni-archive__pills{justify-content:flex-start}.omni-archive__table th:nth-child(n+3),.omni-archive__table td:nth-child(n+3){display:none}.omni-archive__workspace{grid-template-columns:1fr}.omni-archive__preview-panel{min-height:280px}}\n";
+export declare const archiveViewerCss = "\n.omni-viewer--archive{all:initial}.omni-viewer--archive :where(header,section,aside,div,h1,h2,p,span,label,input,table,thead,tbody,tr,th,td,pre){all:revert}\n:host,.omni-viewer--archive{display:block;min-height:100%;box-sizing:border-box;color:var(--omni-fg,#d4d4d4);background:radial-gradient(circle at top left,color-mix(in srgb,var(--omni-accent,#d97706) 14%,transparent),transparent 28%),var(--omni-bg,#1e1e1e);font:13px var(--omni-font,-apple-system,BlinkMacSystemFont,\"Segoe UI\",sans-serif)}\n.omni-viewer--archive *{box-sizing:border-box}.omni-viewer--archive{padding:28px 20px 40px}.omni-archive__hero,.omni-archive__controls,.omni-archive__stats,.omni-archive__table-wrap,.omni-archive__preview-panel{background:var(--omni-bg-secondary,#252526);border:1px solid var(--omni-border,#3c3c3c);border-radius:18px;box-shadow:0 20px 40px rgba(0,0,0,.12)}\n.omni-archive__hero{display:flex;justify-content:space-between;gap:16px;padding:24px;align-items:flex-start}.omni-archive__eyebrow{font-size:12px;letter-spacing:.18em;text-transform:uppercase;color:var(--omni-accent,#d97706);font-weight:700}.omni-archive__hero h1{margin:8px 0 6px;font-size:clamp(26px,4vw,40px);line-height:1.1}.omni-archive__subtitle,.omni-archive__preview-meta{color:var(--omni-muted-fg,#9d9d9d);line-height:1.5}.omni-archive__pills{display:flex;gap:10px;flex-wrap:wrap;justify-content:flex-end}.omni-archive__pill{padding:10px 14px;border-radius:999px;background:color-mix(in srgb,var(--omni-accent,#d97706) 16%,transparent);border:1px solid color-mix(in srgb,var(--omni-accent,#d97706) 35%,transparent);font-weight:600;white-space:nowrap}\n.omni-archive__controls,.omni-archive__stats,.omni-archive__workspace{margin-top:16px}.omni-archive__controls{padding:16px}.omni-archive__search-label{display:block;font-weight:600}.omni-archive__search{display:block;width:100%;margin-top:8px;padding:12px 14px;border-radius:12px;border:1px solid var(--omni-border,#3c3c3c);background:var(--omni-input-bg,#3c3c3c);color:var(--omni-fg,#d4d4d4);font:inherit}.omni-archive__stats{display:grid;grid-template-columns:repeat(auto-fit,minmax(140px,1fr));gap:12px;padding:16px}.omni-archive__stat{padding:14px;border-radius:14px;background:color-mix(in srgb,var(--omni-bg-secondary,#252526) 76%,#000);border:1px solid var(--omni-border,#3c3c3c)}.omni-archive__stat-label{font-size:12px;text-transform:uppercase;letter-spacing:.08em;color:var(--omni-muted-fg,#9d9d9d);margin-bottom:6px}.omni-archive__stat-value{font-size:24px;font-weight:700}\n.omni-archive__workspace{display:grid;grid-template-columns:minmax(0,1.7fr) minmax(320px,.95fr);gap:16px;align-items:start}.omni-archive__table-wrap{overflow:auto;min-width:0;max-height:70vh;overflow-anchor:none}.omni-archive__table{width:100%;table-layout:fixed;border-collapse:collapse}.omni-archive__table th,.omni-archive__table td{padding:12px 14px;border-bottom:1px solid var(--omni-border,#3c3c3c);text-align:left;vertical-align:top;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.omni-archive__table th:first-child{width:42%}.omni-archive__table th{position:sticky;top:0;font-size:12px;text-transform:uppercase;letter-spacing:.08em;color:var(--omni-muted-fg,#9d9d9d);background:var(--omni-bg-secondary,#252526);z-index:1}.omni-archive__path{font-family:var(--omni-mono-font,\"SFMono-Regular\",Consolas,monospace)}.omni-archive__entry{height:43px;cursor:pointer;transition:background-color 120ms ease}.omni-archive__entry:hover{background:color-mix(in srgb,var(--omni-accent,#d97706) 8%,transparent)}.omni-archive__entry:focus-visible{outline:2px solid var(--omni-accent,#d97706);outline-offset:-2px}.omni-archive__entry.is-selected{background:color-mix(in srgb,var(--omni-accent,#d97706) 16%,transparent)}.omni-archive__empty{padding:26px 18px;text-align:center;color:var(--omni-muted-fg,#9d9d9d)}\n.omni-archive__preview-panel{padding:18px;min-height:420px;display:flex;flex-direction:column;gap:14px}.omni-archive__preview-header{display:flex;justify-content:space-between;gap:12px;align-items:flex-start}.omni-archive__preview-kicker{font-size:12px;letter-spacing:.08em;text-transform:uppercase;color:var(--omni-muted-fg,#9d9d9d);margin-bottom:6px}.omni-archive__preview-header h2{margin:0;font-size:18px;line-height:1.35;word-break:break-word}.omni-archive__preview-badge{border-radius:999px;padding:8px 12px;font-size:12px;font-weight:700;background:var(--omni-badge-bg,#3a3d41);white-space:nowrap}.omni-archive__preview-meta{margin:0}.omni-archive__preview{margin:0;flex:1;overflow:auto;white-space:pre-wrap;word-break:break-word;border-radius:14px;border:1px solid var(--omni-border,#3c3c3c);background:var(--omni-code-bg,#181818);padding:14px;color:var(--omni-fg,#d4d4d4);font:12px/1.55 var(--omni-mono-font,\"SFMono-Regular\",Consolas,monospace)}\n.omni-archive__save{align-self:flex-start;padding:8px 12px;border:1px solid var(--omni-border,#3c3c3c);border-radius:6px;background:var(--omni-button-bg,#3a3d41);color:var(--omni-fg,#d4d4d4);font:inherit;cursor:pointer}.omni-archive__save:hover:not(:disabled){background:var(--omni-button-hover-bg,#45494e)}.omni-archive__save:disabled{opacity:.55;cursor:not-allowed}.omni-archive__spacer td{padding:0!important;border:0!important}\n.omni-archive__preview-media{flex:1;display:flex;align-items:center;justify-content:center;border-radius:14px;border:1px solid var(--omni-border,#3c3c3c);background:var(--omni-code-bg,#181818);padding:14px;overflow:auto}.omni-archive__audio{width:100%}.omni-archive__video{max-width:100%;max-height:100%}.omni-archive__image{max-width:100%;max-height:100%;object-fit:contain}\n@media(max-width:720px){.omni-viewer--archive{padding:16px 10px 24px}.omni-archive__hero{flex-direction:column}.omni-archive__pills{justify-content:flex-start}.omni-archive__table th:nth-child(n+3),.omni-archive__table td:nth-child(n+3){display:none}.omni-archive__workspace{grid-template-columns:1fr}.omni-archive__preview-panel{min-height:280px}}\n";

package/dist/viewers/archive/styles.js

@@ -4,7 +4,7 @@ export const archiveViewerCss = `
 .omni-viewer--archive *{box-sizing:border-box}.omni-viewer--archive{padding:28px 20px 40px}.omni-archive__hero,.omni-archive__controls,.omni-archive__stats,.omni-archive__table-wrap,.omni-archive__preview-panel{background:var(--omni-bg-secondary,#252526);border:1px solid var(--omni-border,#3c3c3c);border-radius:18px;box-shadow:0 20px 40px rgba(0,0,0,.12)}
 .omni-archive__hero{display:flex;justify-content:space-between;gap:16px;padding:24px;align-items:flex-start}.omni-archive__eyebrow{font-size:12px;letter-spacing:.18em;text-transform:uppercase;color:var(--omni-accent,#d97706);font-weight:700}.omni-archive__hero h1{margin:8px 0 6px;font-size:clamp(26px,4vw,40px);line-height:1.1}.omni-archive__subtitle,.omni-archive__preview-meta{color:var(--omni-muted-fg,#9d9d9d);line-height:1.5}.omni-archive__pills{display:flex;gap:10px;flex-wrap:wrap;justify-content:flex-end}.omni-archive__pill{padding:10px 14px;border-radius:999px;background:color-mix(in srgb,var(--omni-accent,#d97706) 16%,transparent);border:1px solid color-mix(in srgb,var(--omni-accent,#d97706) 35%,transparent);font-weight:600;white-space:nowrap}
 .omni-archive__controls,.omni-archive__stats,.omni-archive__workspace{margin-top:16px}.omni-archive__controls{padding:16px}.omni-archive__search-label{display:block;font-weight:600}.omni-archive__search{display:block;width:100%;margin-top:8px;padding:12px 14px;border-radius:12px;border:1px solid var(--omni-border,#3c3c3c);background:var(--omni-input-bg,#3c3c3c);color:var(--omni-fg,#d4d4d4);font:inherit}.omni-archive__stats{display:grid;grid-template-columns:repeat(auto-fit,minmax(140px,1fr));gap:12px;padding:16px}.omni-archive__stat{padding:14px;border-radius:14px;background:color-mix(in srgb,var(--omni-bg-secondary,#252526) 76%,#000);border:1px solid var(--omni-border,#3c3c3c)}.omni-archive__stat-label{font-size:12px;text-transform:uppercase;letter-spacing:.08em;color:var(--omni-muted-fg,#9d9d9d);margin-bottom:6px}.omni-archive__stat-value{font-size:24px;font-weight:700}
-.omni-archive__workspace{display:grid;grid-template-columns:minmax(0,1.7fr) minmax(320px,.95fr);gap:16px;align-items:start}.omni-archive__table-wrap{overflow:auto;min-width:0;max-height:70vh}.omni-archive__table{width:100%;table-layout:fixed;border-collapse:collapse}.omni-archive__table th,.omni-archive__table td{padding:12px 14px;border-bottom:1px solid var(--omni-border,#3c3c3c);text-align:left;vertical-align:top;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.omni-archive__table th:first-child{width:42%}.omni-archive__table th{position:sticky;top:0;font-size:12px;text-transform:uppercase;letter-spacing:.08em;color:var(--omni-muted-fg,#9d9d9d);background:var(--omni-bg-secondary,#252526);z-index:1}.omni-archive__path{font-family:var(--omni-mono-font,"SFMono-Regular",Consolas,monospace)}.omni-archive__entry{height:43px;cursor:pointer;transition:background-color 120ms ease}.omni-archive__entry:hover{background:color-mix(in srgb,var(--omni-accent,#d97706) 8%,transparent)}.omni-archive__entry:focus-visible{outline:2px solid var(--omni-accent,#d97706);outline-offset:-2px}.omni-archive__entry.is-selected{background:color-mix(in srgb,var(--omni-accent,#d97706) 16%,transparent)}.omni-archive__empty{padding:26px 18px;text-align:center;color:var(--omni-muted-fg,#9d9d9d)}
+.omni-archive__workspace{display:grid;grid-template-columns:minmax(0,1.7fr) minmax(320px,.95fr);gap:16px;align-items:start}.omni-archive__table-wrap{overflow:auto;min-width:0;max-height:70vh;overflow-anchor:none}.omni-archive__table{width:100%;table-layout:fixed;border-collapse:collapse}.omni-archive__table th,.omni-archive__table td{padding:12px 14px;border-bottom:1px solid var(--omni-border,#3c3c3c);text-align:left;vertical-align:top;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.omni-archive__table th:first-child{width:42%}.omni-archive__table th{position:sticky;top:0;font-size:12px;text-transform:uppercase;letter-spacing:.08em;color:var(--omni-muted-fg,#9d9d9d);background:var(--omni-bg-secondary,#252526);z-index:1}.omni-archive__path{font-family:var(--omni-mono-font,"SFMono-Regular",Consolas,monospace)}.omni-archive__entry{height:43px;cursor:pointer;transition:background-color 120ms ease}.omni-archive__entry:hover{background:color-mix(in srgb,var(--omni-accent,#d97706) 8%,transparent)}.omni-archive__entry:focus-visible{outline:2px solid var(--omni-accent,#d97706);outline-offset:-2px}.omni-archive__entry.is-selected{background:color-mix(in srgb,var(--omni-accent,#d97706) 16%,transparent)}.omni-archive__empty{padding:26px 18px;text-align:center;color:var(--omni-muted-fg,#9d9d9d)}
 .omni-archive__preview-panel{padding:18px;min-height:420px;display:flex;flex-direction:column;gap:14px}.omni-archive__preview-header{display:flex;justify-content:space-between;gap:12px;align-items:flex-start}.omni-archive__preview-kicker{font-size:12px;letter-spacing:.08em;text-transform:uppercase;color:var(--omni-muted-fg,#9d9d9d);margin-bottom:6px}.omni-archive__preview-header h2{margin:0;font-size:18px;line-height:1.35;word-break:break-word}.omni-archive__preview-badge{border-radius:999px;padding:8px 12px;font-size:12px;font-weight:700;background:var(--omni-badge-bg,#3a3d41);white-space:nowrap}.omni-archive__preview-meta{margin:0}.omni-archive__preview{margin:0;flex:1;overflow:auto;white-space:pre-wrap;word-break:break-word;border-radius:14px;border:1px solid var(--omni-border,#3c3c3c);background:var(--omni-code-bg,#181818);padding:14px;color:var(--omni-fg,#d4d4d4);font:12px/1.55 var(--omni-mono-font,"SFMono-Regular",Consolas,monospace)}
 .omni-archive__save{align-self:flex-start;padding:8px 12px;border:1px solid var(--omni-border,#3c3c3c);border-radius:6px;background:var(--omni-button-bg,#3a3d41);color:var(--omni-fg,#d4d4d4);font:inherit;cursor:pointer}.omni-archive__save:hover:not(:disabled){background:var(--omni-button-hover-bg,#45494e)}.omni-archive__save:disabled{opacity:.55;cursor:not-allowed}.omni-archive__spacer td{padding:0!important;border:0!important}
 .omni-archive__preview-media{flex:1;display:flex;align-items:center;justify-content:center;border-radius:14px;border:1px solid var(--omni-border,#3c3c3c);background:var(--omni-code-bg,#181818);padding:14px;overflow:auto}.omni-archive__audio{width:100%}.omni-archive__video{max-width:100%;max-height:100%}.omni-archive__image{max-width:100%;max-height:100%;object-fit:contain}

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);