omni-viewer-core 0.1.0 → 0.3.0

package/dist/parsers/video/index.js

@@ -1,2 +1,5 @@
 const MIME = { mp4: 'video/mp4', mts: 'video/mp2t', m2ts: 'video/mp2t', avi: 'video/x-msvideo', mov: 'video/quicktime', wmv: 'video/x-ms-wmv', flv: 'video/x-flv', webm: 'video/webm', mkv: 'video/x-matroska' };
 export function parseVideoInfo(fileName, data) { const ext = fileName.toLowerCase().split('.').pop() ?? ''; return { format: ext.toUpperCase() || 'VIDEO', mimeType: MIME[ext] ?? 'application/octet-stream', warnings: data.byteLength ? [] : ['The video file is empty.'] }; }
+/** Returns the video MIME type for a file name's extension, or undefined when
+ *  the extension is not a recognized video format. */
+export function videoMimeType(fileName) { return MIME[fileName.toLowerCase().split('.').pop() ?? '']; }

package/dist/styles/archive.css

@@ -7,4 +7,5 @@
 .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__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}
 @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}}

package/dist/styles/audio.css

@@ -55,6 +55,14 @@
 .omni-audio__spectrogram { min-height: 0; }
 .omni-audio__spectrogram--active { min-height: 200px; }
 
+/* Keep the WaveSurfer playhead (cursor + played-region overlay) pinned to the
+   waveform strip. Some wavesurfer spectrogram builds render the spectrogram
+   inside the main wrapper instead of our dedicated container; without this the
+   full-height playhead sweeps down across the spectrogram ("progress bar"
+   running along the bottom) rather than staying with the waveform at the top. */
+.omni-audio__waveform ::part(cursor),
+.omni-audio__waveform ::part(progress) { height: 128px !important; }
+
 .omni-audio__status { color: var(--omni-muted, #9d9d9d); font-size: 12px; min-height: 16px; }
 
 .omni-audio__loading { display: flex; justify-content: center; align-items: center; min-height: 120px; color: var(--omni-muted, #9d9d9d); }

package/dist/styles/ppt.css

@@ -1 +1 @@
-:host,.omni-viewer--ppt{color:var(--omni-fg,#ddd);font:13px system-ui}.omni-ppt{height:100%;display:flex;flex-direction:column;background:var(--omni-bg,#181818)}.omni-ppt__toolbar{display:flex;gap:6px;align-items:center;padding:8px;border-bottom:1px solid var(--omni-border,#444)}.omni-ppt__toolbar button,.omni-ppt__toolbar select{background:var(--omni-control-bg,#292929);color:inherit;border:1px solid var(--omni-border,#555);border-radius:4px;padding:4px 8px}.omni-ppt__viewport{overflow:auto;flex:1;padding:20px}.omni-ppt__slides{display:flex;flex-direction:column;align-items:center;gap:20px}.omni-ppt__slide{position:relative;overflow:hidden;box-shadow:0 2px 12px #0008;transform-origin:top center;flex:none}.omni-ppt__element{position:absolute;box-sizing:border-box;overflow:hidden}.omni-ppt__text{white-space:pre-wrap}.omni-ppt__text p{margin:0}.omni-ppt__image{width:100%;height:100%;object-fit:contain}.omni-ppt__table{border-collapse:collapse;width:100%;height:100%;color:#111}.omni-ppt__table td{border:1px solid #777;padding:3px}.omni-ppt__shape{width:100%;height:100%}.omni-ppt__empty{padding:32px;text-align:center}
+:host,.omni-viewer--ppt{color:var(--omni-fg,#ddd);font:13px system-ui}.omni-ppt{height:100%;display:flex;flex-direction:column;background:var(--omni-bg,#181818)}.omni-ppt__toolbar{display:flex;gap:6px;align-items:center;padding:8px;border-bottom:1px solid var(--omni-border,#444)}.omni-ppt__toolbar button,.omni-ppt__toolbar select{background:var(--omni-control-bg,#292929);color:inherit;border:1px solid var(--omni-border,#555);border-radius:4px;padding:4px 8px}.omni-ppt__viewport{overflow:auto;flex:1;padding:20px}.omni-ppt__slides{display:flex;flex-direction:column;align-items:center;gap:20px}.omni-ppt__slide{position:relative;overflow:hidden;border-radius:6px;box-shadow:0 2px 12px #0008;transform-origin:top center;flex:none}.omni-ppt__element{position:absolute;box-sizing:border-box;overflow:hidden}.omni-ppt__text{padding:2px;white-space:pre-wrap;word-break:break-word}.omni-ppt__text p{margin:0 0 4px}.omni-ppt__text[data-text-preset="cover-title"] .omni-ppt__text-line,.omni-ppt__text[data-text-preset="cover-subtitle"] .omni-ppt__text-line{margin-bottom:0}.omni-ppt__image{width:100%;height:100%;object-fit:cover;object-position:center}.omni-ppt__table-frame{background:#fff;border:1px solid #bdbdbd;overflow:auto}.omni-ppt__table{border-collapse:collapse;width:100%;font-size:12px;color:#111}.omni-ppt__table th,.omni-ppt__table td{border:1px solid #d3d3d3;padding:4px 6px;vertical-align:top}.omni-ppt__chart{display:flex;flex-direction:column;align-items:center;justify-content:center;text-align:center;background:#f7f7f7;border:1px dashed #9a9a9a;color:#333}.omni-ppt__chart--rendered{background:transparent;border:0}.omni-ppt__chart-title{font-size:14px;font-weight:700;margin-bottom:4px}.omni-ppt__chart-subtitle{font-size:12px;opacity:.8}.omni-ppt__shape{width:100%;height:100%}.omni-ppt__empty{padding:32px;text-align:center}

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

@@ -1,5 +1,5 @@
 import type { FileSaveService, HostContext } from '../../host/index.js';
-import { type ArchiveDecoder } from '../../parsers/archive/index.js';
+import { type ArchiveDecoder, type ArchiveEntrySaver, type ArchiveStreamDecoder } from '../../parsers/archive/index.js';
 import type { ResourceLimits } from '../../parsers/types.js';
 import { type MountOptions, type ViewerHandle, type ViewerInput } from '../types.js';
 export * from '../../parsers/archive/index.js';
@@ -17,9 +17,25 @@ export declare const ARCHIVE_VIEWER_META: {
 export interface ArchiveViewerDeps extends ArchiveDecoder {
 }
 export type ArchiveViewerContext = HostContext & {
+    /** Buffered save: core extracts the entry and hands over its bytes. */
     save?: FileSaveService;
+    /** Streaming save: the adapter pipes the entry to disk itself, so a
+     *  multi-GB entry is never materialized in memory. Preferred over `save`
+     *  when present. */
+    saveEntry?: ArchiveEntrySaver;
 };
 export interface ArchiveMountOptions extends MountOptions {
     limits?: ResourceLimits;
+    createObjectUrl?(blob: Blob): string;
+    revokeObjectUrl?(url: string): void;
+}
+/** Lazy streaming input: the adapter's path-based decoder opens the archive
+ *  without core ever holding the full file bytes (opt-in, opposite the buffered
+ *  {@link ViewerInput} path used by vscode/chrome/web). */
+export interface ArchiveStreamingSource extends ArchiveStreamDecoder {
+    fileName: string;
+    totalSize?: number;
+    lastModified?: number;
 }
 export declare function mountArchiveViewer(input: ViewerInput, container: HTMLElement, ctx: ArchiveViewerContext, deps: ArchiveViewerDeps, options?: ArchiveMountOptions): Promise<ViewerHandle>;
+export declare function mountArchiveViewer(source: ArchiveStreamingSource, container: HTMLElement, ctx: ArchiveViewerContext, options?: ArchiveMountOptions): Promise<ViewerHandle>;

package/dist/viewers/archive/index.js

@@ -1,4 +1,7 @@
-import { ARCHIVE_DEFAULT_LIMITS, ArchiveError, parseArchive } from '../../parsers/archive/index.js';
+import { ARCHIVE_DEFAULT_LIMITS, ArchiveError, openArchiveStream, parseArchive } from '../../parsers/archive/index.js';
+import { audioMimeType } from '../../parsers/audio/index.js';
+import { videoMimeType } from '../../parsers/video/index.js';
+import { detectImageMime } from '../image/decode.js';
 import { MountAbortedError, VIEWER_ROOT_CLASS } from '../types.js';
 import { createArchiveController } from './controller.js';
 import { tryDecodeArchiveEntryPreview } from './archive-preview-decoder.js';
@@ -8,6 +11,17 @@ export * from '../../parsers/archive/index.js';
 export { createArchiveController } from './controller.js';
 export { archiveViewerCss } from './styles.js';
 export const ARCHIVE_VIEWER_META = { id: 'archive', displayNameKey: 'archive.title', extensions: ['zip', 'jar', 'apk', 'tar', 'tgz', 'tar.gz', 'tbz', 'tbz2', 'tar.bz2', 'txz', 'tar.xz', 'gz', 'bz2', 'xz', '7z', 'rar', 'dmg'], priority: 5, requiredServices: [], optionalServices: ['save'], inputOwnership: 'consumes' };
+/** Ceiling for extracting an audio entry into memory for inline playback.
+ *  Larger than the text/hex preview budget, but bounded to avoid huge allocations. */
+const ARCHIVE_AUDIO_PREVIEW_BYTES = 64 * 1024 * 1024;
+/** Ceiling for extracting an image entry into memory for inline preview. */
+const ARCHIVE_IMAGE_PREVIEW_BYTES = 32 * 1024 * 1024;
+/** Ceiling for extracting a video entry into memory for inline playback. The
+ *  whole entry is buffered into a blob URL, so this is the largest of the caps. */
+const ARCHIVE_VIDEO_PREVIEW_BYTES = 128 * 1024 * 1024;
+const IMAGE_EXTENSIONS = new Set(['jpg', 'jpeg', 'png', 'gif', 'bmp', 'webp', 'svg']);
+const hasImageExtension = (path) => IMAGE_EXTENSIONS.has(path.toLowerCase().split('.').pop() ?? '');
+const blobPart = (data) => (data.buffer instanceof ArrayBuffer ? data : new Uint8Array(data));
 const element = (tag, className, text) => {
     const node = document.createElement(tag);
     if (className)
@@ -39,10 +53,26 @@ const archiveFormat = (name) => {
     const lower = name.toLocaleLowerCase();
     return ['tar.gz', 'tar.bz2', 'tar.xz'].find(ext => lower.endsWith(`.${ext}`))?.toUpperCase() ?? (lower.split('.').pop()?.toUpperCase() || 'ARCHIVE');
 };
-export async function mountArchiveViewer(input, container, ctx, deps, options = {}) {
+export async function mountArchiveViewer(inputOrSource, container, ctx, depsOrOptions, maybeOptions) {
+    const streaming = !('data' in inputOrSource);
+    const options = (streaming ? depsOrOptions : maybeOptions) ?? {};
     if (options.signal?.aborted)
         throw new MountAbortedError();
-    const parsed = await parseArchive(input.data, deps, { fileName: input.fileName, ...(options.signal ? { signal: options.signal } : {}), ...(options.limits ? { limits: options.limits } : {}) });
+    let fileName;
+    let totalBytes;
+    let parsed;
+    if (streaming) {
+        const source = inputOrSource;
+        fileName = source.fileName;
+        totalBytes = source.totalSize;
+        parsed = await openArchiveStream(source, { fileName, ...(source.totalSize !== undefined ? { totalSize: source.totalSize } : {}), ...(options.signal ? { signal: options.signal } : {}), ...(options.limits ? { limits: options.limits } : {}) });
+    }
+    else {
+        const input = inputOrSource;
+        fileName = input.fileName;
+        totalBytes = input.data.byteLength;
+        parsed = await parseArchive(input.data, depsOrOptions, { fileName, ...(options.signal ? { signal: options.signal } : {}), ...(options.limits ? { limits: options.limits } : {}) });
+    }
     if (parsed.outcome.result.status === 'failed')
         throw new Error(parsed.outcome.result.failure.messageKey);
     if (options.signal?.aborted) {
@@ -64,9 +94,9 @@ export async function mountArchiveViewer(input, container, ctx, deps, options =
     const wrap = element('section', `${VIEWER_ROOT_CLASS} omni-viewer--archive`);
     const hero = element('header', 'omni-archive__hero');
     const heading = element('div');
-    heading.append(element('div', 'omni-archive__eyebrow', t('archive.preview')), element('h1', '', input.fileName), element('p', 'omni-archive__subtitle', t('archive.summary')));
+    heading.append(element('div', 'omni-archive__eyebrow', t('archive.preview')), element('h1', '', fileName), element('p', 'omni-archive__subtitle', t('archive.summary')));
     const pills = element('div', 'omni-archive__pills');
-    pills.append(element('span', 'omni-archive__pill', archiveFormat(input.fileName)), element('span', 'omni-archive__pill', t('archive.entries', { count: entries.length })), element('span', 'omni-archive__pill', formatSize(input.data.byteLength)));
+    pills.append(element('span', 'omni-archive__pill', archiveFormat(fileName)), element('span', 'omni-archive__pill', t('archive.entries', { count: entries.length })), element('span', 'omni-archive__pill', formatSize(totalBytes)));
     hero.append(heading, pills);
     const controls = element('section', 'omni-archive__controls');
     const label = element('label', 'omni-archive__search-label', t('archive.filter'));
@@ -107,11 +137,13 @@ export async function mountArchiveViewer(input, container, ctx, deps, options =
     const previewMeta = element('p', 'omni-archive__preview-meta', t('archive.selectHint'));
     const preview = element('pre', 'omni-archive__preview', t('archive.noSelection'));
     preview.setAttribute('aria-live', 'polite');
+    const previewMedia = element('div', 'omni-archive__preview-media');
+    previewMedia.style.display = 'none';
     const saveButton = element('button', 'omni-archive__save', t('archive.saveEntry'));
     saveButton.type = 'button';
-    saveButton.hidden = !ctx.save;
+    saveButton.hidden = !ctx.save && !ctx.saveEntry;
     saveButton.disabled = true;
-    previewPanel.append(previewHeader, previewMeta, preview, saveButton);
+    previewPanel.append(previewHeader, previewMeta, preview, previewMedia, saveButton);
     workspace.append(tableWrap, previewPanel);
     wrap.append(hero, controls, stats, workspace);
     root.append(wrap);
@@ -119,7 +151,52 @@ export async function mountArchiveViewer(input, container, ctx, deps, options =
     let extraction;
     let saveExtraction;
     let selectedEntry;
-    const setPreview = (entry, status, meta, content) => { previewTitle.textContent = entry?.path ?? t('archive.chooseFile'); previewStatus.textContent = status; previewMeta.textContent = meta; preview.textContent = content; };
+    let previewUrl;
+    const createUrl = options.createObjectUrl ?? URL.createObjectURL.bind(URL);
+    const revokeUrl = options.revokeObjectUrl ?? URL.revokeObjectURL.bind(URL);
+    // Inline display beats author CSS (.omni-archive__preview-media sets display:flex,
+    // which would otherwise override the [hidden] attribute), so the text preview and
+    // the media preview stay reliably mutually exclusive.
+    const clearPreviewMedia = () => { if (previewUrl) {
+        revokeUrl(previewUrl);
+        previewUrl = undefined;
+    } previewMedia.replaceChildren(); previewMedia.style.display = 'none'; preview.style.display = ''; };
+    const setPreview = (entry, status, meta, content) => { clearPreviewMedia(); previewTitle.textContent = entry?.path ?? t('archive.chooseFile'); previewStatus.textContent = status; previewMeta.textContent = meta; preview.textContent = content; };
+    const MEDIA_META = { audio: 'archive.audioReady', image: 'archive.imageReady', video: 'archive.videoReady' };
+    const showMediaPreview = (entry, data, kind, mimeType) => {
+        clearPreviewMedia();
+        let objectUrl;
+        try {
+            objectUrl = createUrl(new Blob([blobPart(data)], { type: mimeType }));
+        }
+        catch {
+            setPreview(entry, t('archive.previewUnavailable'), t('archive.mediaUnsupported'), t('archive.previewUnavailable'));
+            return;
+        }
+        previewUrl = objectUrl;
+        let node;
+        if (kind === 'image') {
+            const img = document.createElement('img');
+            img.className = 'omni-archive__image';
+            img.alt = entry.path;
+            img.src = objectUrl;
+            node = img;
+        }
+        else {
+            const media = document.createElement(kind);
+            media.controls = true;
+            media.preload = 'metadata';
+            media.className = `omni-archive__${kind}`;
+            media.src = objectUrl;
+            node = media;
+        }
+        previewMedia.replaceChildren(node);
+        previewMedia.style.display = 'flex';
+        preview.style.display = 'none';
+        previewTitle.textContent = entry.path;
+        previewStatus.textContent = t('archive.ready');
+        previewMeta.textContent = t(MEDIA_META[kind]);
+    };
     const select = async (entry) => {
         extraction?.abort();
         extraction = undefined;
@@ -138,7 +215,10 @@ export async function mountArchiveViewer(input, container, ctx, deps, options =
         extraction = new AbortController();
         const request = extraction;
         setPreview(entry, t('archive.loading'), t('archive.loadingHint'), t('archive.loadingContent'));
-        const maxPreview = ARCHIVE_DEFAULT_LIMITS.maxPreviewBytes;
+        const audioMime = audioMimeType(entry.path);
+        const videoMime = !audioMime ? videoMimeType(entry.path) : undefined;
+        const imageCandidate = !audioMime && !videoMime && hasImageExtension(entry.path);
+        const maxPreview = audioMime ? ARCHIVE_AUDIO_PREVIEW_BYTES : videoMime ? ARCHIVE_VIDEO_PREVIEW_BYTES : imageCandidate ? ARCHIVE_IMAGE_PREVIEW_BYTES : ARCHIVE_DEFAULT_LIMITS.maxPreviewBytes;
         if (entry.uncompressedSize !== undefined && entry.uncompressedSize > maxPreview) {
             setPreview(entry, t('archive.previewUnavailable'), t('diag.archive.limit-exceeded'), t('archive.previewUnavailable'));
             return;
@@ -147,6 +227,21 @@ export async function mountArchiveViewer(input, container, ctx, deps, options =
             const data = await handle.extract(entry.entryId, { signal: request.signal, maxBytes: maxPreview });
             if (local !== ticket)
                 return;
+            if (audioMime) {
+                showMediaPreview(entry, data, 'audio', audioMime);
+                return;
+            }
+            if (videoMime) {
+                showMediaPreview(entry, data, 'video', videoMime);
+                return;
+            }
+            if (imageCandidate) {
+                const imageMime = detectImageMime(data, entry.path);
+                if (imageMime) {
+                    showMediaPreview(entry, data, 'image', imageMime);
+                    return;
+                }
+            }
             const decoded = tryDecodeArchiveEntryPreview(entry.path, data);
             const text = isText(data);
             setPreview(entry, t('archive.ready'), t(decoded ? 'archive.androidBinaryXmlReady' : text ? 'archive.textReady' : 'archive.binaryReady'), decoded?.content ?? (text ? new TextDecoder().decode(data) : hexPreview(data)));
@@ -158,24 +253,32 @@ export async function mountArchiveViewer(input, container, ctx, deps, options =
     };
     saveButton.addEventListener('click', async () => {
         const entry = selectedEntry;
-        const save = ctx.save;
-        if (!entry || entry.isDirectory || !save || !handle)
+        if (!entry || entry.isDirectory || !handle || (!ctx.save && !ctx.saveEntry))
             return;
         saveExtraction?.abort();
         saveExtraction = new AbortController();
         const request = saveExtraction;
         saveButton.disabled = true;
         saveButton.textContent = t('archive.savingEntry');
+        const suggestedName = entry.path.split('/').filter(Boolean).pop() ?? 'archive-entry';
         try {
-            const configuredLimit = options.limits?.maxDecompressedBytes ?? ARCHIVE_DEFAULT_LIMITS.maxDecompressedBytes;
-            const maxBytes = Math.max(1, Math.min(entry.uncompressedSize ?? configuredLimit, configuredLimit));
-            const data = await handle.extract(entry.entryId, { signal: request.signal, maxBytes });
-            if (request.signal.aborted)
-                return;
-            const suggestedName = entry.path.split('/').filter(Boolean).pop() ?? 'archive-entry';
-            await save.saveFile(suggestedName, data, entry.mimeType ?? 'application/octet-stream');
-            if (!request.signal.aborted)
-                previewMeta.textContent = t('common.saved', { name: suggestedName });
+            // Streaming save (adapter pipes the entry to disk) is preferred: a
+            // multi-GB entry never lands in memory. Buffered save is the fallback.
+            if (ctx.saveEntry) {
+                const savedName = await ctx.saveEntry.saveEntry(entry, { signal: request.signal });
+                if (!request.signal.aborted && savedName)
+                    previewMeta.textContent = t('common.saved', { name: savedName });
+            }
+            else {
+                const configuredLimit = options.limits?.maxDecompressedBytes ?? ARCHIVE_DEFAULT_LIMITS.maxDecompressedBytes;
+                const maxBytes = Math.max(1, Math.min(entry.uncompressedSize ?? configuredLimit, configuredLimit));
+                const data = await handle.extract(entry.entryId, { signal: request.signal, maxBytes });
+                if (request.signal.aborted)
+                    return;
+                await ctx.save.saveFile(suggestedName, data, entry.mimeType ?? 'application/octet-stream');
+                if (!request.signal.aborted)
+                    previewMeta.textContent = t('common.saved', { name: suggestedName });
+            }
         }
         catch {
             if (!request.signal.aborted)
@@ -226,5 +329,5 @@ export async function mountArchiveViewer(input, container, ctx, deps, options =
     search.addEventListener('input', () => { tableWrap.scrollTop = 0; controller.dispatch({ type: 'set-search', query: search.value }); });
     const unsubscribe = controller.subscribe(render);
     render();
-    return { dispose() { ticket++; extraction?.abort(); saveExtraction?.abort(); unsubscribe(); wrap.remove(); void handle?.close(); handle = undefined; } };
+    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@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}.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

@@ -7,5 +7,6 @@ export const archiveViewerCss = `
 .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__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}
 @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}}
 `;

package/dist/viewers/audio/styles.js

@@ -61,6 +61,14 @@ export const audioViewerCss = mediaViewerCss + `
 .omni-audio__spectrogram { min-height: 0; }
 .omni-audio__spectrogram--active { min-height: 200px; }
 
+/* Keep the WaveSurfer playhead (cursor + played-region overlay) pinned to the
+   waveform strip. Some wavesurfer spectrogram builds render the spectrogram
+   inside the main wrapper instead of our dedicated container; without this the
+   full-height playhead sweeps down across the spectrogram ("progress bar"
+   running along the bottom) rather than staying with the waveform at the top. */
+.omni-audio__waveform ::part(cursor),
+.omni-audio__waveform ::part(progress) { height: 128px !important; }
+
 .omni-audio__status { color: var(--omni-muted, #9d9d9d); font-size: 12px; min-height: 16px; }
 
 .omni-audio__loading { display: flex; justify-content: center; align-items: center; min-height: 120px; color: var(--omni-muted, #9d9d9d); }

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

@@ -2,7 +2,7 @@ import { type PdfAnnotation, type PdfViewState } from './controller.js';
 /** Type-only reference — erased at compile time. */
 export type PdfLibModule = typeof import('pdf-lib');
 export declare const SIDECAR_LAYER_NAME = "omni-viewer-layer.json";
-export declare const SIDECAR_ORIGINAL_NAME = "omni-viewer-original.pdf";
+export declare const SIDECAR_BASE_NAME = "omni-viewer-base.pdf";
 /** Result of parsing a sidecar's layer JSON. */
 export interface ParsedLayer {
     pageOrder: number[];
@@ -14,9 +14,11 @@ export declare function buildEditedPdf(pdfLib: PdfLibModule, source: Uint8Array,
 /**
  * Like {@link buildEditedPdf}, but also embeds the hybrid sidecar so the
  * omni viewer can rehydrate a removable overlay layer on reopen:
- *   - the pristine (unflattened) source, and
- *   - the layer JSON `{ version, pageOrder, annotations }`.
- * External readers only ever see the flattened pages.
+ *   - a re-editable base (kept pages only, signatures flattened in), and
+ *   - the layer JSON `{ version, pageOrder, annotations }` for text/markup,
+ *     with page references remapped onto the kept-pages base.
+ * Deleted pages and signatures are unrecoverable; external readers only ever
+ * see the flattened pages.
  */
 export declare function buildSavedPdf(pdfLib: PdfLibModule, pristine: Uint8Array, state: PdfViewState): Promise<Uint8Array>;
 /** Parse and validate a sidecar layer JSON string; null if unusable. */

package/dist/viewers/pdf/editing.js

@@ -5,13 +5,16 @@
 // imports). Callers inject the loaded module; `viewers/pdf/self-loading`
 // provides the dynamic-import loader for platforms whose bundler resolves it.
 import { mergeHighlightRects } from './controller.js';
-// Hybrid sidecar: saved PDFs keep flattened (portable) pages while embedding
-// the pristine source + a layer JSON, so the omni viewer can restore a
-// removable overlay layer on reopen. External readers only see the flat pages.
+// Hybrid sidecar: saved PDFs keep flattened (portable) pages for external
+// readers while embedding a re-editable base + a layer JSON, so the omni
+// viewer can restore a removable overlay layer on reopen. The embedded base
+// holds only the kept pages (deleted pages are gone for good) with signatures
+// permanently flattened in; text/markup stay out so they remain editable.
+// External readers only ever see the flat pages.
 export const SIDECAR_LAYER_NAME = 'omni-viewer-layer.json';
-export const SIDECAR_ORIGINAL_NAME = 'omni-viewer-original.pdf';
+export const SIDECAR_BASE_NAME = 'omni-viewer-base.pdf';
 /** Bumped when the sidecar shape changes; older/newer versions are ignored. */
-const SIDECAR_VERSION = 1;
+const SIDECAR_VERSION = 2;
 /** Defensive ceilings — the sidecar is untrusted input on reopen. */
 const MAX_ANNOTATIONS = 2000;
 const MAX_TEXT_LENGTH = 10_000;
@@ -104,16 +107,39 @@ async function stamp(pdfLib, page, annotation) {
         height: annotation.height
     });
 }
-/** Reorder/delete pages and stamp the overlays into a fresh (unsaved) doc. */
-async function flattenInto(pdfLib, source, state) {
+/** Copy the kept pages (in display order) from `source` into a fresh doc. */
+async function copyKeptPages(pdfLib, source, pageOrder) {
     const original = await pdfLib.PDFDocument.load(source);
     const output = await pdfLib.PDFDocument.create();
-    const indices = state.pageOrder
+    const indices = pageOrder
         .map((page) => page - 1)
         .filter((page) => page >= 0 && page < original.getPageCount());
     const copied = await output.copyPages(original, indices);
     copied.forEach((page) => output.addPage(page));
+    return output;
+}
+/** Reorder/delete pages and stamp the overlays into a fresh (unsaved) doc. */
+async function flattenInto(pdfLib, source, state) {
+    const output = await copyKeptPages(pdfLib, source, state.pageOrder);
+    for (const annotation of state.annotations) {
+        const outputIndex = state.pageOrder.indexOf(annotation.page);
+        const page = output.getPages()[outputIndex];
+        if (page)
+            await stamp(pdfLib, page, annotation);
+    }
+    return output;
+}
+/**
+ * The re-editable base embedded in a saved PDF: the kept pages (unflattened)
+ * with ONLY signatures permanently stamped in. Text/markup are deliberately
+ * left out so the omni viewer can restore them as a removable layer, while
+ * signatures — and any pages the user deleted — cannot be recovered.
+ */
+async function buildEditableBase(pdfLib, pristine, state) {
+    const output = await copyKeptPages(pdfLib, pristine, state.pageOrder);
     for (const annotation of state.annotations) {
+        if (annotation.kind !== 'signature')
+            continue;
         const outputIndex = state.pageOrder.indexOf(annotation.page);
         const page = output.getPages()[outputIndex];
         if (page)
@@ -130,21 +156,29 @@ export async function buildEditedPdf(pdfLib, source, state) {
 /**
  * Like {@link buildEditedPdf}, but also embeds the hybrid sidecar so the
  * omni viewer can rehydrate a removable overlay layer on reopen:
- *   - the pristine (unflattened) source, and
- *   - the layer JSON `{ version, pageOrder, annotations }`.
- * External readers only ever see the flattened pages.
+ *   - a re-editable base (kept pages only, signatures flattened in), and
+ *   - the layer JSON `{ version, pageOrder, annotations }` for text/markup,
+ *     with page references remapped onto the kept-pages base.
+ * Deleted pages and signatures are unrecoverable; external readers only ever
+ * see the flattened pages.
  */
 export async function buildSavedPdf(pdfLib, pristine, state) {
     const output = await flattenInto(pdfLib, pristine, state);
+    const base = await buildEditableBase(pdfLib, pristine, state);
+    // The base is already in display order, so its pages number 1..keptCount.
+    // Remap each overlay's page reference (an original page number) onto that.
+    const remap = new Map(state.pageOrder.map((page, index) => [page, index + 1]));
     const layer = JSON.stringify({
         version: SIDECAR_VERSION,
-        pageOrder: state.pageOrder,
+        pageOrder: base.getPages().map((_, index) => index + 1),
         annotations: state.annotations
+            .filter((annotation) => annotation.kind !== 'signature')
+            .map((annotation) => ({ ...annotation, page: remap.get(annotation.page) ?? annotation.page }))
     });
     await output.attach(new TextEncoder().encode(layer), SIDECAR_LAYER_NAME, {
         mimeType: 'application/json'
     });
-    await output.attach(pristine, SIDECAR_ORIGINAL_NAME, {
+    await output.attach(await base.save(), SIDECAR_BASE_NAME, {
         mimeType: 'application/pdf'
     });
     return output.save();

package/dist/viewers/pdf/index.js

@@ -11,7 +11,7 @@
 // annotations use an inline input overlay instead.
 import { MountAbortedError, VIEWER_ROOT_CLASS } from '../types.js';
 import { createPdfController, mergeHighlightRects, PDF_ZOOM_LEVELS } from './controller.js';
-import { buildSavedPdf, mergePdfBytes, parseLayer, savedPdfName, SIDECAR_LAYER_NAME, SIDECAR_ORIGINAL_NAME } from './editing.js';
+import { buildSavedPdf, mergePdfBytes, parseLayer, savedPdfName, SIDECAR_LAYER_NAME, SIDECAR_BASE_NAME } from './editing.js';
 import { pdfViewerCss } from './styles.js';
 export { createPdfController, PDF_ZOOM_LEVELS } from './controller.js';
 export { pdfViewerCss } from './styles.js';
@@ -176,7 +176,7 @@ export async function mountPdfViewer(input, container, ctx, deps, options = {})
         }
     }
     /**
-     * Read the hybrid sidecar (pristine source + layer JSON) from a document's
+     * Read the hybrid sidecar (re-editable base + layer JSON) from a document's
      * attachments. Returns null unless BOTH parts are present and the layer
      * parses — a lone layer over already-flattened pages would double up.
      */
@@ -185,19 +185,19 @@ export async function mountPdfViewer(input, container, ctx, deps, options = {})
             const attachments = await d.getAttachments?.();
             if (!attachments)
                 return null;
-            let pristine;
+            let base;
             let layerText;
             for (const entry of Object.values(attachments)) {
-                if (entry.filename === SIDECAR_ORIGINAL_NAME)
-                    pristine = entry.content;
+                if (entry.filename === SIDECAR_BASE_NAME)
+                    base = entry.content;
                 else if (entry.filename === SIDECAR_LAYER_NAME) {
                     layerText = new TextDecoder().decode(entry.content);
                 }
             }
-            if (!pristine || layerText === undefined)
+            if (!base || layerText === undefined)
                 return null;
             const layer = parseLayer(layerText);
-            return layer ? { pristine, layer } : null;
+            return layer ? { base, layer } : null;
         }
         catch {
             return null;
@@ -1374,12 +1374,13 @@ export async function mountPdfViewer(input, container, ctx, deps, options = {})
     }
     throwIfAborted();
     // Hybrid rehydration: if this file was saved by us, its visible pages are
-    // flattened but it carries the pristine source + layer JSON. Render/edit
-    // from the pristine base and restore the overlays as a removable layer.
+    // flattened but it carries a re-editable base (kept pages, signatures baked
+    // in) + layer JSON. Render/edit from that base and restore the text/markup
+    // overlays as a removable layer.
     const sidecar = await readSidecar(doc);
     if (sidecar) {
         await doc.destroy();
-        sourceBytes = sidecar.pristine;
+        sourceBytes = sidecar.base;
         doc = await loadDocument(sourceBytes, password);
         throwIfAborted();
         adoptController(createPdfController(doc.numPages, sidecar.layer));