omni-viewer-core 0.1.0

package/dist/viewers/archive/archive-preview-decoder.js

@@ -0,0 +1,223 @@
+const RES_XML_TYPE = 0x0003;
+const RES_STRING_POOL_TYPE = 0x0001;
+const RES_XML_START_NAMESPACE_TYPE = 0x0100;
+const RES_XML_END_NAMESPACE_TYPE = 0x0101;
+const RES_XML_START_ELEMENT_TYPE = 0x0102;
+const RES_XML_END_ELEMENT_TYPE = 0x0103;
+const NO_INDEX = 0xffffffff;
+class Reader {
+    bytes;
+    view;
+    constructor(bytes) {
+        this.bytes = bytes;
+        this.view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    }
+    u8(offset) { return offset < this.bytes.length ? this.view.getUint8(offset) : undefined; }
+    u16(offset) { return offset + 2 <= this.bytes.length ? this.view.getUint16(offset, true) : undefined; }
+    u32(offset) { return offset + 4 <= this.bytes.length ? this.view.getUint32(offset, true) : undefined; }
+}
+export function tryDecodeArchiveEntryPreview(entryPath, bytes) {
+    if (!entryPath.toLocaleLowerCase().endsWith('.xml'))
+        return null;
+    const reader = new Reader(bytes);
+    const xml = readChunkHeader(reader, 0);
+    if (!xml || xml.type !== RES_XML_TYPE || xml.headerSize < 8 || xml.size > bytes.length || readChunkHeader(reader, xml.headerSize)?.type !== RES_STRING_POOL_TYPE)
+        return null;
+    const stringPool = parseStringPool(reader);
+    if (!stringPool)
+        return null;
+    const namespaceStack = new Map();
+    const prefixByUri = new Map();
+    const pendingNamespaces = new Map();
+    const elements = [];
+    const lines = ['<?xml version="1.0" encoding="utf-8"?>'];
+    let offset = xml.headerSize;
+    while (offset + 8 <= bytes.length) {
+        const chunk = readChunkHeader(reader, offset);
+        if (!chunk || chunk.size <= 0 || offset + chunk.size > bytes.length)
+            return null;
+        if (chunk.type === RES_XML_START_NAMESPACE_TYPE || chunk.type === RES_XML_END_NAMESPACE_TYPE) {
+            if (!parseNamespace(reader, offset, stringPool, namespaceStack, prefixByUri, pendingNamespaces, chunk.type === RES_XML_START_NAMESPACE_TYPE))
+                return null;
+        }
+        else if (chunk.type === RES_XML_START_ELEMENT_TYPE) {
+            const element = parseStartElement(reader, offset, chunk, stringPool);
+            if (!element)
+                return null;
+            const parts = [qualifyName(element.namespaceUri, element.name, prefixByUri)];
+            const declarations = [...pendingNamespaces].map(([uri, prefix]) => prefix ? `xmlns:${prefix}="${escapeXml(uri)}"` : `xmlns="${escapeXml(uri)}"`);
+            pendingNamespaces.clear();
+            parts.push(...declarations, ...element.attributes.map(attribute => `${qualifyName(attribute.namespaceUri, attribute.name, prefixByUri)}="${escapeXml(attribute.value)}"`));
+            lines.push(`${'  '.repeat(elements.length)}<${parts.join(' ')}>`);
+            elements.push(element);
+        }
+        else if (chunk.type === RES_XML_END_ELEMENT_TYPE) {
+            const element = parseEndElement(reader, offset, stringPool);
+            if (!element)
+                return null;
+            const current = elements.pop();
+            if (current && (current.name !== element.name || current.namespaceUri !== element.namespaceUri))
+                return null;
+            lines.push(`${'  '.repeat(elements.length)}</${qualifyName(element.namespaceUri, element.name, prefixByUri)}>`);
+        }
+        offset += chunk.size;
+    }
+    return lines.length > 1 ? { content: lines.join('\n') } : null;
+}
+function parseStringPool(reader) {
+    const start = 8;
+    const header = readChunkHeader(reader, start);
+    if (!header || header.type !== RES_STRING_POOL_TYPE || header.headerSize < 28 || start + header.size > reader.bytes.length)
+        return null;
+    const count = reader.u32(start + 8);
+    const flags = reader.u32(start + 16);
+    const stringsStart = reader.u32(start + 20);
+    if (count === undefined || flags === undefined || stringsStart === undefined || count > (header.size - header.headerSize) / 4)
+        return null;
+    const utf8 = (flags & 0x100) !== 0;
+    const strings = [];
+    for (let index = 0; index < count; index++) {
+        const relative = reader.u32(start + header.headerSize + index * 4);
+        if (relative === undefined)
+            return null;
+        const absolute = start + stringsStart + relative;
+        if (absolute >= start + header.size)
+            return null;
+        const value = utf8 ? readUtf8String(reader, absolute, start + header.size) : readUtf16String(reader, absolute, start + header.size);
+        if (value === null)
+            return null;
+        strings.push(value);
+    }
+    return { strings };
+}
+function readUtf8String(reader, offset, limit) {
+    const chars = readLength8(reader, offset);
+    if (!chars)
+        return null;
+    const bytes = readLength8(reader, offset + chars[1]);
+    if (!bytes)
+        return null;
+    const start = offset + chars[1] + bytes[1];
+    const end = start + bytes[0];
+    return end <= limit ? new TextDecoder().decode(reader.bytes.subarray(start, end)) : null;
+}
+function readUtf16String(reader, offset, limit) {
+    const length = readLength16(reader, offset);
+    if (!length)
+        return null;
+    const start = offset + length[1];
+    const end = start + length[0] * 2;
+    return end <= limit ? new TextDecoder('utf-16le').decode(reader.bytes.subarray(start, end)) : null;
+}
+function readLength8(reader, offset) {
+    const first = reader.u8(offset);
+    if (first === undefined)
+        return null;
+    if ((first & 0x80) === 0)
+        return [first, 1];
+    const second = reader.u8(offset + 1);
+    return second === undefined ? null : [((first & 0x7f) << 8) | second, 2];
+}
+function readLength16(reader, offset) {
+    const first = reader.u16(offset);
+    if (first === undefined)
+        return null;
+    if ((first & 0x8000) === 0)
+        return [first, 2];
+    const second = reader.u16(offset + 2);
+    return second === undefined ? null : [((first & 0x7fff) << 16) | second, 4];
+}
+function parseNamespace(reader, offset, pool, stack, prefixes, pending, start) {
+    const prefixIndex = reader.u32(offset + 16);
+    const uriIndex = reader.u32(offset + 20);
+    if (prefixIndex === undefined || uriIndex === undefined)
+        return false;
+    const prefix = getString(pool, prefixIndex) ?? '';
+    const uri = getString(pool, uriIndex);
+    if (!uri)
+        return true;
+    if (start) {
+        const values = stack.get(uri) ?? [];
+        values.push(prefix);
+        stack.set(uri, values);
+        prefixes.set(uri, prefix);
+        pending.set(uri, prefix);
+    }
+    else {
+        const values = stack.get(uri);
+        values?.pop();
+        if (!values?.length) {
+            stack.delete(uri);
+            prefixes.delete(uri);
+            pending.delete(uri);
+        }
+        else
+            prefixes.set(uri, values[values.length - 1]);
+    }
+    return true;
+}
+function parseStartElement(reader, offset, header, pool) {
+    const namespaceIndex = reader.u32(offset + 16);
+    const nameIndex = reader.u32(offset + 20);
+    const attributeStart = reader.u16(offset + 24);
+    const attributeSize = reader.u16(offset + 26);
+    const count = reader.u16(offset + 28);
+    if (header.headerSize < 16 || namespaceIndex === undefined || nameIndex === undefined || attributeStart === undefined || attributeSize === undefined || count === undefined || attributeSize < 20)
+        return null;
+    const name = getString(pool, nameIndex);
+    if (!name)
+        return null;
+    const attributes = [];
+    let position = offset + 16 + attributeStart;
+    for (let index = 0; index < count; index++, position += attributeSize) {
+        if (position + attributeSize > offset + header.size)
+            return null;
+        const namespace = reader.u32(position);
+        const attributeName = reader.u32(position + 4);
+        const raw = reader.u32(position + 8);
+        const type = reader.u8(position + 15);
+        const data = reader.u32(position + 16);
+        if (namespace === undefined || attributeName === undefined || raw === undefined || type === undefined || data === undefined)
+            return null;
+        const resolvedName = getString(pool, attributeName);
+        if (!resolvedName)
+            return null;
+        attributes.push({ namespaceUri: getString(pool, namespace), name: resolvedName, value: formatTypedValue(type, data, getString(pool, raw), pool) });
+    }
+    return { namespaceUri: getString(pool, namespaceIndex), name, attributes };
+}
+function parseEndElement(reader, offset, pool) {
+    const namespace = reader.u32(offset + 16);
+    const nameIndex = reader.u32(offset + 20);
+    if (namespace === undefined || nameIndex === undefined)
+        return null;
+    const name = getString(pool, nameIndex);
+    return name ? { namespaceUri: getString(pool, namespace), name, attributes: [] } : null;
+}
+function formatTypedValue(type, data, raw, pool) {
+    if (raw)
+        return raw;
+    switch (type) {
+        case 0x00: return '';
+        case 0x01: return `@0x${data.toString(16).padStart(8, '0')}`;
+        case 0x02: return `?0x${data.toString(16).padStart(8, '0')}`;
+        case 0x03: return getString(pool, data) ?? '';
+        case 0x04: return String(bitsToFloat(data));
+        case 0x05: return formatComplex(data, ['px', 'dp', 'sp', 'pt', 'in', 'mm']);
+        case 0x06: return formatComplex(data, ['%', '%p']);
+        case 0x10: return String(data | 0);
+        case 0x11: return `0x${data.toString(16)}`;
+        case 0x12: return data ? 'true' : 'false';
+        case 0x1c:
+        case 0x1d:
+        case 0x1e:
+        case 0x1f: return `#${data.toString(16).padStart(8, '0')}`;
+        default: return `0x${data.toString(16)}`;
+    }
+}
+function bitsToFloat(data) { const view = new DataView(new ArrayBuffer(4)); view.setUint32(0, data, true); return view.getFloat32(0, true); }
+function formatComplex(data, units) { const mantissa = (data & 0xffffff00) >> 8; const radix = (data >> 4) & 3; return `${mantissa * ([1 / 2 ** 23, 1 / 2 ** 15, 1 / 2 ** 7, 1][radix] ?? 1)}${units[data & 0xf] ?? ''}`; }
+function qualifyName(uri, name, prefixes) { const prefix = uri ? prefixes.get(uri) : undefined; return prefix ? `${prefix}:${name}` : name; }
+function getString(pool, index) { return index === NO_INDEX ? null : pool.strings[index] ?? null; }
+function readChunkHeader(reader, offset) { const type = reader.u16(offset); const headerSize = reader.u16(offset + 2); const size = reader.u32(offset + 4); return type === undefined || headerSize === undefined || size === undefined ? null : { type, headerSize, size }; }
+function escapeXml(value) { return value.replace(/&/g, '&amp;').replace(/"/g, '&quot;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/'/g, '&apos;'); }

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

@@ -0,0 +1,24 @@
+import type { ArchiveEntry } from '../../parsers/archive/index.js';
+export interface ArchiveViewState {
+    query: string;
+    selectedId?: number;
+    expanded: ReadonlySet<string>;
+    entries: readonly ArchiveEntry[];
+}
+export type ArchiveAction = {
+    type: 'set-search';
+    query: string;
+} | {
+    type: 'select';
+    entryId: number;
+} | {
+    type: 'toggle-directory';
+    path: string;
+};
+export interface ArchiveController {
+    readonly state: ArchiveViewState;
+    dispatch(action: ArchiveAction): void;
+    visibleEntries(): readonly ArchiveEntry[];
+    subscribe(listener: () => void): () => void;
+}
+export declare function createArchiveController(entries: readonly ArchiveEntry[]): ArchiveController;

package/dist/viewers/archive/controller.js

@@ -0,0 +1,18 @@
+const parent = (path) => path.replace(/\/?[^/]+\/?$/, '');
+export function createArchiveController(entries) {
+    let state = { query: '', expanded: new Set(entries.filter(x => x.isDirectory).map(x => x.path)), entries };
+    const listeners = new Set();
+    const emit = () => listeners.forEach(x => x());
+    return { get state() { return state; }, dispatch(action) { if (action.type === 'set-search')
+            state = { ...state, query: action.query };
+        else if (action.type === 'select')
+            state = { ...state, selectedId: action.entryId };
+        else {
+            const expanded = new Set(state.expanded);
+            expanded.has(action.path) ? expanded.delete(action.path) : expanded.add(action.path);
+            state = { ...state, expanded };
+        } emit(); }, visibleEntries() { const q = state.query.toLocaleLowerCase(); return state.entries.filter(entry => { if (q)
+            return entry.path.toLocaleLowerCase().includes(q) || state.entries.some(x => x.path.startsWith(`${entry.path.replace(/\/$/, '')}/`) && x.path.toLocaleLowerCase().includes(q)); for (let p = parent(entry.path); p; p = parent(p))
+            if (!state.expanded.has(p) && !state.expanded.has(`${p}/`))
+                return false; return true; }); }, subscribe(listener) { listeners.add(listener); return () => listeners.delete(listener); } };
+}

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

@@ -0,0 +1,25 @@
+import type { FileSaveService, HostContext } from '../../host/index.js';
+import { type ArchiveDecoder } 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';
+export { createArchiveController } from './controller.js';
+export { archiveViewerCss } from './styles.js';
+export declare const ARCHIVE_VIEWER_META: {
+    id: string;
+    displayNameKey: string;
+    extensions: string[];
+    priority: number;
+    requiredServices: readonly [];
+    optionalServices: readonly ["save"];
+    inputOwnership: "consumes";
+};
+export interface ArchiveViewerDeps extends ArchiveDecoder {
+}
+export type ArchiveViewerContext = HostContext & {
+    save?: FileSaveService;
+};
+export interface ArchiveMountOptions extends MountOptions {
+    limits?: ResourceLimits;
+}
+export declare function mountArchiveViewer(input: ViewerInput, container: HTMLElement, ctx: ArchiveViewerContext, deps: ArchiveViewerDeps, options?: ArchiveMountOptions): Promise<ViewerHandle>;

package/dist/viewers/archive/index.js

@@ -0,0 +1,230 @@
+import { ARCHIVE_DEFAULT_LIMITS, ArchiveError, parseArchive } from '../../parsers/archive/index.js';
+import { MountAbortedError, VIEWER_ROOT_CLASS } from '../types.js';
+import { createArchiveController } from './controller.js';
+import { tryDecodeArchiveEntryPreview } from './archive-preview-decoder.js';
+import { hexPreview, isText } from './preview.js';
+import { archiveViewerCss } from './styles.js';
+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' };
+const element = (tag, className, text) => {
+    const node = document.createElement(tag);
+    if (className)
+        node.className = className;
+    if (text !== undefined)
+        node.textContent = text;
+    return node;
+};
+const formatSize = (value) => {
+    if (value === undefined || !Number.isFinite(value))
+        return '—';
+    const units = ['B', 'KB', 'MB', 'GB', 'TB'];
+    let size = value;
+    let unit = 0;
+    while (size >= 1024 && unit < units.length - 1) {
+        size /= 1024;
+        unit++;
+    }
+    const precision = size >= 100 || unit === 0 ? 0 : size >= 10 ? 1 : 2;
+    return `${size.toFixed(precision)} ${units[unit]}`;
+};
+const formatDate = (value) => {
+    if (value === undefined)
+        return '—';
+    const date = value instanceof Date ? value : new Date(value);
+    return Number.isNaN(date.getTime()) ? '—' : new Intl.DateTimeFormat(undefined, { dateStyle: 'medium', timeStyle: 'short' }).format(date);
+};
+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 = {}) {
+    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 } : {}) });
+    if (parsed.outcome.result.status === 'failed')
+        throw new Error(parsed.outcome.result.failure.messageKey);
+    if (options.signal?.aborted) {
+        await parsed.handle?.close();
+        throw new MountAbortedError();
+    }
+    let handle = parsed.handle;
+    const root = options.styleIsolation !== 'scoped' && typeof container.attachShadow === 'function' ? (container.shadowRoot ?? container.attachShadow({ mode: 'open' })) : container;
+    if (root === container)
+        container.classList.add(VIEWER_ROOT_CLASS, 'omni-viewer--archive');
+    else {
+        const style = element('style');
+        style.textContent = archiveViewerCss;
+        root.append(style);
+    }
+    const t = (key, args) => ctx.i18n.t(key, args);
+    const entries = parsed.outcome.result.document.entries;
+    const controller = createArchiveController(entries);
+    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')));
+    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)));
+    hero.append(heading, pills);
+    const controls = element('section', 'omni-archive__controls');
+    const label = element('label', 'omni-archive__search-label', t('archive.filter'));
+    const search = element('input', 'omni-archive__search');
+    search.type = 'search';
+    search.placeholder = t('archive.search');
+    label.append(search);
+    controls.append(label);
+    const stats = element('section', 'omni-archive__stats');
+    const files = entries.filter(entry => !entry.isDirectory).length;
+    const statValues = [['archive.entries', entries.length], ['archive.files', files], ['archive.directories', entries.length - files], ['archive.visible', entries.length]];
+    const visibleStat = statValues[3];
+    for (const [key, value] of statValues) {
+        const card = element('article', 'omni-archive__stat');
+        card.append(element('div', 'omni-archive__stat-label', key === 'archive.entries' ? t('archive.title') : t(key)), element('div', 'omni-archive__stat-value', value.toLocaleString()));
+        stats.append(card);
+    }
+    const workspace = element('section', 'omni-archive__workspace');
+    const tableWrap = element('div', 'omni-archive__table-wrap');
+    const table = element('table', 'omni-archive__table');
+    const thead = element('thead');
+    const headerRow = element('tr');
+    for (const key of ['archive.path', 'archive.type', 'archive.compressedSize', 'archive.originalSize', 'archive.modified'])
+        headerRow.append(element('th', '', t(key)));
+    thead.append(headerRow);
+    const tbody = element('tbody');
+    table.append(thead, tbody);
+    const empty = element('div', 'omni-archive__empty', t('archive.noMatches'));
+    empty.hidden = true;
+    tableWrap.append(table, empty);
+    const previewPanel = element('aside', 'omni-archive__preview-panel');
+    const previewHeader = element('div', 'omni-archive__preview-header');
+    const previewHeading = element('div');
+    const previewTitle = element('h2', '', t('archive.chooseFile'));
+    previewHeading.append(element('div', 'omni-archive__preview-kicker', t('archive.entryPreview')), previewTitle);
+    const previewStatus = element('span', 'omni-archive__preview-badge', t('archive.idle'));
+    previewHeader.append(previewHeading, previewStatus);
+    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 saveButton = element('button', 'omni-archive__save', t('archive.saveEntry'));
+    saveButton.type = 'button';
+    saveButton.hidden = !ctx.save;
+    saveButton.disabled = true;
+    previewPanel.append(previewHeader, previewMeta, preview, saveButton);
+    workspace.append(tableWrap, previewPanel);
+    wrap.append(hero, controls, stats, workspace);
+    root.append(wrap);
+    let ticket = 0;
+    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; };
+    const select = async (entry) => {
+        extraction?.abort();
+        extraction = undefined;
+        const local = ++ticket;
+        selectedEntry = entry;
+        saveButton.disabled = entry.isDirectory;
+        if (entry.isDirectory)
+            controller.dispatch({ type: 'toggle-directory', path: entry.path });
+        controller.dispatch({ type: 'select', entryId: entry.entryId });
+        if (entry.isDirectory) {
+            setPreview(entry, t('archive.directory'), t('archive.directoryHint'), t('archive.directoryContent'));
+            return;
+        }
+        if (!handle)
+            return;
+        extraction = new AbortController();
+        const request = extraction;
+        setPreview(entry, t('archive.loading'), t('archive.loadingHint'), t('archive.loadingContent'));
+        const maxPreview = 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;
+        }
+        try {
+            const data = await handle.extract(entry.entryId, { signal: request.signal, maxBytes: maxPreview });
+            if (local !== ticket)
+                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)));
+        }
+        catch (error) {
+            if (local === ticket && !request.signal.aborted)
+                setPreview(entry, t('archive.previewUnavailable'), t(error instanceof ArchiveError && error.code === 'limit-exceeded' ? 'diag.archive.limit-exceeded' : 'archive.previewUnavailable'), t('archive.previewUnavailable'));
+        }
+    };
+    saveButton.addEventListener('click', async () => {
+        const entry = selectedEntry;
+        const save = ctx.save;
+        if (!entry || entry.isDirectory || !save || !handle)
+            return;
+        saveExtraction?.abort();
+        saveExtraction = new AbortController();
+        const request = saveExtraction;
+        saveButton.disabled = true;
+        saveButton.textContent = t('archive.savingEntry');
+        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 });
+        }
+        catch {
+            if (!request.signal.aborted)
+                previewMeta.textContent = t('archive.saveFailed');
+        }
+        finally {
+            if (!request.signal.aborted) {
+                saveButton.disabled = false;
+                saveButton.textContent = t('archive.saveEntry');
+            }
+        }
+    });
+    const ROW_HEIGHT = 43;
+    const OVERSCAN = 8;
+    const FALLBACK_VIEWPORT_HEIGHT = 600;
+    const render = () => {
+        const visible = controller.visibleEntries();
+        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; };
+        if (start > 0)
+            tbody.append(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;
+            row.dataset.entryId = String(entry.entryId);
+            const path = element('td', 'omni-archive__path', `${entry.isDirectory ? (controller.state.expanded.has(entry.path) ? '▾ ' : '▸ ') : ''}${entry.path}`);
+            path.style.paddingInlineStart = `${Math.max(0, entry.path.split('/').filter(Boolean).length - 1) * 12 + 14}px`;
+            row.append(path, element('td', '', t(entry.isDirectory ? 'archive.directory' : 'archive.file')), element('td', '', formatSize(entry.compressedSize)), element('td', '', formatSize(entry.uncompressedSize)), element('td', '', formatDate(entry.modifiedAt)));
+            row.addEventListener('click', () => void select(entry));
+            row.addEventListener('keydown', event => { if (event.key === 'Enter' || event.key === ' ') {
+                event.preventDefault();
+                void select(entry);
+            } });
+            tbody.append(row);
+        }
+        if (end < visible.length)
+            tbody.append(spacer((visible.length - end) * ROW_HEIGHT));
+    };
+    tableWrap.addEventListener('scroll', render, { passive: true });
+    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; } };
+}

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

@@ -0,0 +1,2 @@
+export declare function isText(data: Uint8Array): boolean;
+export declare function hexPreview(data: Uint8Array, max?: number): string;

package/dist/viewers/archive/preview.js

@@ -0,0 +1,2 @@
+export function isText(data) { return !data.some(x => x === 0 || (x < 9) || (x > 13 && x < 32)); }
+export function hexPreview(data, max = 4096) { return Array.from(data.subarray(0, max), x => x.toString(16).padStart(2, '0')).join(' ') + (data.length > max ? ' …' : ''); }

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

@@ -0,0 +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";

package/dist/viewers/archive/styles.js

@@ -0,0 +1,11 @@
+export const archiveViewerCss = `
+.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}
+: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)}
+.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__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}
+@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/arxml/index.d.ts

@@ -0,0 +1,15 @@
+import type { AutomotiveViewerContext } from '../automotive/index.js';
+import type { MountOptions, ViewerHandle, ViewerInput } from '../types.js';
+export { parseArxml } from '../../parsers/arxml/index.js';
+export { automotiveViewerCss as arxmlViewerCss } from '../automotive/styles.js';
+export type ArxmlViewerContext = AutomotiveViewerContext;
+export declare const ARXML_VIEWER_META: {
+    id: string;
+    displayNameKey: string;
+    extensions: string[];
+    priority: number;
+    requiredServices: readonly [];
+    optionalServices: readonly ["clipboard"];
+    inputOwnership: "borrows";
+};
+export declare const mountArxmlViewer: (input: ViewerInput, container: HTMLElement, ctx: ArxmlViewerContext, options?: MountOptions) => Promise<ViewerHandle>;

package/dist/viewers/arxml/index.js

@@ -0,0 +1,5 @@
+import { mountAutomotiveViewer } from '../automotive/index.js';
+export { parseArxml } from '../../parsers/arxml/index.js';
+export { automotiveViewerCss as arxmlViewerCss } from '../automotive/styles.js';
+export const ARXML_VIEWER_META = { id: 'arxml', displayNameKey: 'arxml.title', extensions: ['arxml'], priority: 20, requiredServices: [], optionalServices: ['clipboard'], inputOwnership: 'borrows' };
+export const mountArxmlViewer = (input, container, ctx, options = {}) => mountAutomotiveViewer('arxml', input, container, ctx, options);

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

@@ -0,0 +1,15 @@
+import type { AutomotiveViewerContext } from '../automotive/index.js';
+import type { MountOptions, ViewerHandle, ViewerInput } from '../types.js';
+export { parseAsc } from '../../parsers/asc/index.js';
+export { automotiveViewerCss as ascViewerCss } from '../automotive/styles.js';
+export type AscViewerContext = AutomotiveViewerContext;
+export declare const ASC_VIEWER_META: {
+    id: string;
+    displayNameKey: string;
+    extensions: string[];
+    priority: number;
+    requiredServices: readonly [];
+    optionalServices: readonly ["clipboard"];
+    inputOwnership: "borrows";
+};
+export declare const mountAscViewer: (input: ViewerInput, container: HTMLElement, ctx: AscViewerContext, options?: MountOptions) => Promise<ViewerHandle>;

package/dist/viewers/asc/index.js

@@ -0,0 +1,5 @@
+import { mountAutomotiveViewer } from '../automotive/index.js';
+export { parseAsc } from '../../parsers/asc/index.js';
+export { automotiveViewerCss as ascViewerCss } from '../automotive/styles.js';
+export const ASC_VIEWER_META = { id: 'asc', displayNameKey: 'asc.title', extensions: ['asc'], priority: 20, requiredServices: [], optionalServices: ['clipboard'], inputOwnership: 'borrows' };
+export const mountAscViewer = (input, container, ctx, options = {}) => mountAutomotiveViewer('asc', input, container, ctx, options);

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

@@ -0,0 +1,33 @@
+export declare const AUDIO_MIN_ZOOM = 1;
+export declare const AUDIO_MAX_ZOOM = 32;
+export declare const AUDIO_VOLUME_STEPS = 100;
+export type AudioVisualization = 'waveform' | 'spectrogram';
+export interface AudioViewState {
+    /** Horizontal zoom multiplier over the fit-to-width pixel density. */
+    zoom: number;
+    /** 0..1 */
+    volume: number;
+    loop: boolean;
+    visualization: AudioVisualization;
+}
+export type AudioAction = {
+    type: 'zoom-in';
+} | {
+    type: 'zoom-out';
+} | {
+    type: 'zoom-fit';
+} | {
+    type: 'set-volume';
+    volume: number;
+} | {
+    type: 'toggle-loop';
+} | {
+    type: 'set-visualization';
+    visualization: AudioVisualization;
+};
+export interface AudioController {
+    readonly state: AudioViewState;
+    dispatch(action: AudioAction): void;
+    subscribe(listener: (state: AudioViewState) => void): () => void;
+}
+export declare function createAudioController(): AudioController;