omni-viewer-core 0.1.0

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

@@ -0,0 +1 @@
+export declare const excelViewerCss = "\n/* Reverse-contamination guard (DESIGN.md \u00A76, ADR 40): in 'scoped' mode host\n   global element selectors (button/table/input\u2026) must be neutralized. Harmless\n   in shadow mode. Custom properties pierce 'all', so --omni-* tokens still\n   apply. Component rules below win (later + higher specificity). */\n.omni-viewer--excel {\n    all: initial;\n}\n.omni-viewer--excel :where(button, select, option, input, label,\n    table, thead, tbody, tr, th, td, pre) {\n    all: revert;\n}\n\n:host, .omni-viewer--excel {\n    display: block;\n    height: 100%;\n    box-sizing: border-box;\n    color: var(--omni-fg, #d4d4d4);\n    background: var(--omni-bg, #1e1e1e);\n    font-family: var(--omni-font, -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, sans-serif);\n    font-size: var(--omni-font-size, 13px);\n}\n.omni-excel {\n    display: flex;\n    flex-direction: column;\n    height: 100%;\n    min-height: 0;\n}\n.omni-excel__toolbar {\n    display: flex;\n    align-items: center;\n    flex-wrap: wrap;\n    gap: 8px;\n    padding: 6px 8px;\n    border-bottom: 1px solid var(--omni-border, #333);\n}\n.omni-excel__toolbar label {\n    display: inline-flex;\n    align-items: center;\n    gap: 4px;\n}\n.omni-excel__toolbar select,\n.omni-excel__search {\n    background: var(--omni-input-bg, #2a2a2a);\n    color: inherit;\n    border: 1px solid var(--omni-border, #333);\n    border-radius: 3px;\n    padding: 2px 6px;\n}\n.omni-excel__toolbar button {\n    background: var(--omni-button-bg, #333);\n    color: inherit;\n    border: 1px solid var(--omni-border, #333);\n    border-radius: 3px;\n    padding: 2px 8px;\n    cursor: pointer;\n}\n.omni-excel__toolbar button:disabled {\n    opacity: 0.5;\n    cursor: default;\n}\n.omni-excel__spacer { flex: 1 1 auto; }\n.omni-excel__meta { color: var(--omni-fg-muted, #999); white-space: nowrap; }\n.omni-excel__diagnostics {\n    padding: 4px 8px;\n    border-bottom: 1px solid var(--omni-border, #333);\n    color: var(--omni-fg-muted, #999);\n    font-size: 0.92em;\n}\n.omni-excel__diag-error { color: var(--omni-error, #f48771); }\n.omni-excel__body {\n    flex: 1 1 auto;\n    min-height: 0;\n    overflow: auto;\n}\n.omni-excel__empty {\n    padding: 24px;\n    text-align: center;\n    color: var(--omni-fg-muted, #999);\n}\n.omni-excel__raw {\n    margin: 0;\n    padding: 8px 12px;\n    white-space: pre;\n    font-family: var(--omni-font-mono, ui-monospace, SFMono-Regular, Menlo, monospace);\n}\n.omni-excel__table {\n    border-collapse: collapse;\n    width: max-content;\n    min-width: 100%;\n}\n.omni-excel__table th,\n.omni-excel__table td {\n    border: 1px solid var(--omni-border, #333);\n    padding: 3px 8px;\n    text-align: left;\n    white-space: pre;\n    vertical-align: top;\n}\n.omni-excel__table thead th {\n    position: sticky;\n    top: 0;\n    background: var(--omni-header-bg, #252525);\n    cursor: pointer;\n    user-select: none;\n}\n.omni-excel__table tbody td {\n    cursor: text;\n}\n.omni-excel__cell-input {\n    box-sizing: border-box;\n    width: 100%;\n    min-width: 80px;\n    margin: -3px -8px;\n    padding: 3px 8px;\n    border: 1px solid var(--omni-accent, #0e639c);\n    background: var(--omni-input-bg, #2a2a2a);\n    color: inherit;\n    font: inherit;\n}\n.omni-excel__resize-handle {\n    position: absolute;\n    top: 0;\n    right: 0;\n    width: 7px;\n    height: 100%;\n    cursor: col-resize;\n    user-select: none;\n    touch-action: none;\n}\n.omni-excel__resize-handle:hover {\n    background: var(--omni-accent, #0e639c);\n    opacity: 0.6;\n}\n.omni-excel__sort-indicator { margin-left: 4px; }\n.omni-excel__hit { background: var(--omni-highlight, rgba(255, 214, 0, 0.25)); }\n.omni-excel__footer {\n    display: flex;\n    align-items: center;\n    justify-content: center;\n    gap: 8px;\n    padding: 4px 8px;\n    border-top: 1px solid var(--omni-border, #333);\n}\n.omni-excel__footer button {\n    background: var(--omni-button-bg, #333);\n    color: inherit;\n    border: 1px solid var(--omni-border, #333);\n    border-radius: 3px;\n    padding: 2px 8px;\n    cursor: pointer;\n}\n.omni-excel__footer button:disabled { opacity: 0.5; cursor: default; }\n.omni-excel__toast {\n    position: absolute;\n    bottom: 12px;\n    left: 50%;\n    transform: translateX(-50%);\n    background: var(--omni-toast-bg, #333);\n    color: var(--omni-fg, #d4d4d4);\n    border: 1px solid var(--omni-border, #333);\n    border-radius: 4px;\n    padding: 6px 12px;\n    pointer-events: none;\n}\n.omni-excel__dirty { color: var(--omni-warn, #d7a017); white-space: nowrap; }\n.omni-excel__cell-input {\n    width: 100%;\n    box-sizing: border-box;\n    font: inherit;\n    color: inherit;\n    background: var(--omni-input-bg, #2a2a2a);\n    border: 1px solid var(--omni-accent, #3794ff);\n    padding: 2px 6px;\n}\n.omni-excel__menu {\n    position: absolute;\n    z-index: 10;\n    display: flex;\n    flex-direction: column;\n    min-width: 140px;\n    background: var(--omni-menu-bg, #2a2a2a);\n    border: 1px solid var(--omni-border, #333);\n    border-radius: 4px;\n    padding: 4px 0;\n    box-shadow: 0 2px 8px rgba(0, 0, 0, 0.4);\n}\n.omni-excel__menu button {\n    background: none;\n    border: none;\n    color: inherit;\n    text-align: left;\n    padding: 4px 12px;\n    cursor: pointer;\n}\n.omni-excel__menu button:hover { background: var(--omni-hover-bg, #333); }\n\n/* Grid render mode (X3): WYSIWYG. Cell inline styles (from the file) win over\n   these base rules; borders/alignment default here when the file omits them. */\n.omni-excel__grid {\n    border-collapse: collapse;\n    table-layout: fixed;\n    width: max-content;\n}\n.omni-excel__grid td {\n    border: 1px solid var(--omni-border, #333);\n    padding: 2px 6px;\n    overflow: hidden;\n    text-overflow: ellipsis;\n    white-space: nowrap;\n    vertical-align: top;\n}\n";

package/dist/viewers/excel/styles.js

@@ -0,0 +1,216 @@
+// Excel viewer stylesheet. Single source for both delivery forms (DESIGN.md §6):
+// the build emits dist/styles/excel.css from this constant, and the renderer
+// injects it into the shadow root. Only --omni-* tokens (with fallbacks).
+export const excelViewerCss = `
+/* Reverse-contamination guard (DESIGN.md §6, ADR 40): in 'scoped' mode host
+   global element selectors (button/table/input…) must be neutralized. Harmless
+   in shadow mode. Custom properties pierce 'all', so --omni-* tokens still
+   apply. Component rules below win (later + higher specificity). */
+.omni-viewer--excel {
+    all: initial;
+}
+.omni-viewer--excel :where(button, select, option, input, label,
+    table, thead, tbody, tr, th, td, pre) {
+    all: revert;
+}
+
+:host, .omni-viewer--excel {
+    display: block;
+    height: 100%;
+    box-sizing: border-box;
+    color: var(--omni-fg, #d4d4d4);
+    background: var(--omni-bg, #1e1e1e);
+    font-family: var(--omni-font, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif);
+    font-size: var(--omni-font-size, 13px);
+}
+.omni-excel {
+    display: flex;
+    flex-direction: column;
+    height: 100%;
+    min-height: 0;
+}
+.omni-excel__toolbar {
+    display: flex;
+    align-items: center;
+    flex-wrap: wrap;
+    gap: 8px;
+    padding: 6px 8px;
+    border-bottom: 1px solid var(--omni-border, #333);
+}
+.omni-excel__toolbar label {
+    display: inline-flex;
+    align-items: center;
+    gap: 4px;
+}
+.omni-excel__toolbar select,
+.omni-excel__search {
+    background: var(--omni-input-bg, #2a2a2a);
+    color: inherit;
+    border: 1px solid var(--omni-border, #333);
+    border-radius: 3px;
+    padding: 2px 6px;
+}
+.omni-excel__toolbar button {
+    background: var(--omni-button-bg, #333);
+    color: inherit;
+    border: 1px solid var(--omni-border, #333);
+    border-radius: 3px;
+    padding: 2px 8px;
+    cursor: pointer;
+}
+.omni-excel__toolbar button:disabled {
+    opacity: 0.5;
+    cursor: default;
+}
+.omni-excel__spacer { flex: 1 1 auto; }
+.omni-excel__meta { color: var(--omni-fg-muted, #999); white-space: nowrap; }
+.omni-excel__diagnostics {
+    padding: 4px 8px;
+    border-bottom: 1px solid var(--omni-border, #333);
+    color: var(--omni-fg-muted, #999);
+    font-size: 0.92em;
+}
+.omni-excel__diag-error { color: var(--omni-error, #f48771); }
+.omni-excel__body {
+    flex: 1 1 auto;
+    min-height: 0;
+    overflow: auto;
+}
+.omni-excel__empty {
+    padding: 24px;
+    text-align: center;
+    color: var(--omni-fg-muted, #999);
+}
+.omni-excel__raw {
+    margin: 0;
+    padding: 8px 12px;
+    white-space: pre;
+    font-family: var(--omni-font-mono, ui-monospace, SFMono-Regular, Menlo, monospace);
+}
+.omni-excel__table {
+    border-collapse: collapse;
+    width: max-content;
+    min-width: 100%;
+}
+.omni-excel__table th,
+.omni-excel__table td {
+    border: 1px solid var(--omni-border, #333);
+    padding: 3px 8px;
+    text-align: left;
+    white-space: pre;
+    vertical-align: top;
+}
+.omni-excel__table thead th {
+    position: sticky;
+    top: 0;
+    background: var(--omni-header-bg, #252525);
+    cursor: pointer;
+    user-select: none;
+}
+.omni-excel__table tbody td {
+    cursor: text;
+}
+.omni-excel__cell-input {
+    box-sizing: border-box;
+    width: 100%;
+    min-width: 80px;
+    margin: -3px -8px;
+    padding: 3px 8px;
+    border: 1px solid var(--omni-accent, #0e639c);
+    background: var(--omni-input-bg, #2a2a2a);
+    color: inherit;
+    font: inherit;
+}
+.omni-excel__resize-handle {
+    position: absolute;
+    top: 0;
+    right: 0;
+    width: 7px;
+    height: 100%;
+    cursor: col-resize;
+    user-select: none;
+    touch-action: none;
+}
+.omni-excel__resize-handle:hover {
+    background: var(--omni-accent, #0e639c);
+    opacity: 0.6;
+}
+.omni-excel__sort-indicator { margin-left: 4px; }
+.omni-excel__hit { background: var(--omni-highlight, rgba(255, 214, 0, 0.25)); }
+.omni-excel__footer {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    gap: 8px;
+    padding: 4px 8px;
+    border-top: 1px solid var(--omni-border, #333);
+}
+.omni-excel__footer button {
+    background: var(--omni-button-bg, #333);
+    color: inherit;
+    border: 1px solid var(--omni-border, #333);
+    border-radius: 3px;
+    padding: 2px 8px;
+    cursor: pointer;
+}
+.omni-excel__footer button:disabled { opacity: 0.5; cursor: default; }
+.omni-excel__toast {
+    position: absolute;
+    bottom: 12px;
+    left: 50%;
+    transform: translateX(-50%);
+    background: var(--omni-toast-bg, #333);
+    color: var(--omni-fg, #d4d4d4);
+    border: 1px solid var(--omni-border, #333);
+    border-radius: 4px;
+    padding: 6px 12px;
+    pointer-events: none;
+}
+.omni-excel__dirty { color: var(--omni-warn, #d7a017); white-space: nowrap; }
+.omni-excel__cell-input {
+    width: 100%;
+    box-sizing: border-box;
+    font: inherit;
+    color: inherit;
+    background: var(--omni-input-bg, #2a2a2a);
+    border: 1px solid var(--omni-accent, #3794ff);
+    padding: 2px 6px;
+}
+.omni-excel__menu {
+    position: absolute;
+    z-index: 10;
+    display: flex;
+    flex-direction: column;
+    min-width: 140px;
+    background: var(--omni-menu-bg, #2a2a2a);
+    border: 1px solid var(--omni-border, #333);
+    border-radius: 4px;
+    padding: 4px 0;
+    box-shadow: 0 2px 8px rgba(0, 0, 0, 0.4);
+}
+.omni-excel__menu button {
+    background: none;
+    border: none;
+    color: inherit;
+    text-align: left;
+    padding: 4px 12px;
+    cursor: pointer;
+}
+.omni-excel__menu button:hover { background: var(--omni-hover-bg, #333); }
+
+/* Grid render mode (X3): WYSIWYG. Cell inline styles (from the file) win over
+   these base rules; borders/alignment default here when the file omits them. */
+.omni-excel__grid {
+    border-collapse: collapse;
+    table-layout: fixed;
+    width: max-content;
+}
+.omni-excel__grid td {
+    border: 1px solid var(--omni-border, #333);
+    padding: 2px 6px;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+    vertical-align: top;
+}
+`;

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

@@ -0,0 +1,17 @@
+import type { HostContext } from '../../host/index.js';
+import { type MountOptions, type ViewerHandle, type ViewerInput } from '../types.js';
+export { fallbackViewerCss } from './styles.js';
+export declare const FALLBACK_VIEWER_META: {
+    id: string;
+    displayNameKey: string;
+    extensions: string[];
+    priority: number;
+    requiredServices: readonly [];
+    optionalServices: readonly [];
+    inputOwnership: "borrows";
+};
+export interface FallbackMountOptions extends MountOptions {
+    /** Why the fallback is showing (catalog key), e.g. 'fallback.reason.missing-dependency'. */
+    reasonKey?: string;
+}
+export declare function mountFallbackViewer(input: ViewerInput, container: HTMLElement, ctx: HostContext, options?: FallbackMountOptions): Promise<ViewerHandle>;

package/dist/viewers/fallback/index.js

@@ -0,0 +1,130 @@
+// Shared fallback viewer — the terminal node of every fallback chain
+// (DESIGN.md §7, ADR 30). Text preview when the bytes decode as UTF-8,
+// hex dump otherwise. Identical on every platform by construction.
+import { MountAbortedError, VIEWER_ROOT_CLASS } from '../types.js';
+import { fallbackViewerCss } from './styles.js';
+export { fallbackViewerCss } from './styles.js';
+export const FALLBACK_VIEWER_META = {
+    id: 'fallback',
+    displayNameKey: 'fallback.title.text',
+    extensions: [],
+    priority: -1,
+    requiredServices: [],
+    optionalServices: [],
+    inputOwnership: 'borrows'
+};
+const TEXT_PREVIEW_BYTES = 256 * 1024;
+const HEX_PREVIEW_BYTES = 4 * 1024;
+const HEX_BYTES_PER_LINE = 16;
+export async function mountFallbackViewer(input, container, ctx, options = {}) {
+    if (options.signal?.aborted)
+        throw new MountAbortedError();
+    const isolation = options.styleIsolation ?? 'shadow';
+    let root;
+    if (isolation === 'shadow' && typeof container.attachShadow === 'function') {
+        root = container.shadowRoot ?? container.attachShadow({ mode: 'open' });
+        const style = document.createElement('style');
+        style.textContent = fallbackViewerCss;
+        root.appendChild(style);
+    }
+    else {
+        container.classList.add(VIEWER_ROOT_CLASS, 'omni-viewer--fallback');
+        root = container;
+    }
+    const t = ctx.i18n.t.bind(ctx.i18n);
+    const frame = document.createElement('div');
+    frame.className = 'omni-fallback';
+    if (options.reasonKey) {
+        const reason = document.createElement('div');
+        reason.className = 'omni-fallback__reason';
+        reason.textContent = t(options.reasonKey);
+        frame.appendChild(reason);
+    }
+    const text = tryDecodeText(input.data);
+    const title = document.createElement('div');
+    title.className = 'omni-fallback__title';
+    title.textContent =
+        text !== null ? t('fallback.title.text') : t('fallback.title.hex');
+    frame.appendChild(title);
+    const pre = document.createElement('pre');
+    pre.className = 'omni-fallback__content';
+    let truncatedAt = null;
+    if (text !== null) {
+        pre.textContent = text.content;
+        if (text.truncated)
+            truncatedAt = TEXT_PREVIEW_BYTES;
+    }
+    else {
+        pre.textContent = hexDump(input.data.subarray(0, HEX_PREVIEW_BYTES));
+        if (input.data.byteLength > HEX_PREVIEW_BYTES)
+            truncatedAt = HEX_PREVIEW_BYTES;
+    }
+    frame.appendChild(pre);
+    if (truncatedAt !== null) {
+        const note = document.createElement('div');
+        note.className = 'omni-fallback__note';
+        note.textContent = t('fallback.truncated', { bytes: truncatedAt });
+        frame.appendChild(note);
+    }
+    root.appendChild(frame);
+    return {
+        dispose() {
+            if (root instanceof ShadowRoot) {
+                root.replaceChildren();
+            }
+            else {
+                root.replaceChildren();
+                root.classList.remove(VIEWER_ROOT_CLASS, 'omni-viewer--fallback');
+            }
+        }
+    };
+}
+function tryDecodeText(data) {
+    const slice = data.subarray(0, TEXT_PREVIEW_BYTES);
+    try {
+        const content = new TextDecoder('utf-8', { fatal: true }).decode(slice);
+        // Control characters (other than tab/newline/CR) mean "not really text".
+        // eslint-disable-next-line no-control-regex
+        if (/[\u0000-\u0008\u000B\u000C\u000E-\u001F]/.test(content))
+            return null;
+        return { content, truncated: data.byteLength > TEXT_PREVIEW_BYTES };
+    }
+    catch {
+        // A multi-byte sequence cut at the slice boundary would throw; retry
+        // with a few bytes trimmed before concluding "binary".
+        if (data.byteLength > TEXT_PREVIEW_BYTES) {
+            try {
+                const trimmed = new TextDecoder('utf-8', { fatal: true }).decode(slice.subarray(0, TEXT_PREVIEW_BYTES - 4));
+                // eslint-disable-next-line no-control-regex
+                if (/[\u0000-\u0008\u000B\u000C\u000E-\u001F]/.test(trimmed))
+                    return null;
+                return { content: trimmed, truncated: true };
+            }
+            catch {
+                return null;
+            }
+        }
+        return null;
+    }
+}
+function hexDump(data) {
+    const lines = [];
+    for (let offset = 0; offset < data.byteLength; offset += HEX_BYTES_PER_LINE) {
+        const chunk = data.subarray(offset, offset + HEX_BYTES_PER_LINE);
+        const hex = [];
+        let ascii = '';
+        for (let i = 0; i < HEX_BYTES_PER_LINE; i++) {
+            const byte = chunk[i];
+            if (byte === undefined) {
+                hex.push('  ');
+                continue;
+            }
+            hex.push(byte.toString(16).padStart(2, '0'));
+            ascii += byte >= 0x20 && byte <= 0x7e ? String.fromCharCode(byte) : '.';
+        }
+        lines.push(`${offset.toString(16).padStart(8, '0')}  ${hex.slice(0, 8).join(' ')}  ${hex
+            .slice(8)
+            .join(' ')}  |${ascii}|`);
+    }
+    return lines.join('\n');
+}

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

@@ -0,0 +1 @@
+export declare const fallbackViewerCss = "\n/* Reverse-contamination guard for 'scoped' mode \u2014 see csv/styles.ts. */\n.omni-viewer--fallback {\n    all: initial;\n}\n.omni-viewer--fallback :where(pre, code, div) {\n    all: revert;\n}\n\n:host, .omni-viewer--fallback {\n    display: block;\n    height: 100%;\n    box-sizing: border-box;\n    color: var(--omni-fg, #d4d4d4);\n    background: var(--omni-bg, #1e1e1e);\n    font-family: var(--omni-font, -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, sans-serif);\n    font-size: var(--omni-font-size, 13px);\n}\n.omni-fallback {\n    display: flex;\n    flex-direction: column;\n    height: 100%;\n    min-height: 0;\n}\n.omni-fallback__reason {\n    padding: 6px 8px;\n    color: var(--omni-warning-fg, #cca700);\n    border-bottom: 1px solid var(--omni-border, #3c3c3c);\n}\n.omni-fallback__title {\n    padding: 6px 8px;\n    color: var(--omni-fg-muted, #9d9d9d);\n    border-bottom: 1px solid var(--omni-border, #3c3c3c);\n}\n.omni-fallback__content {\n    flex: 1;\n    min-height: 0;\n    overflow: auto;\n    margin: 0;\n    padding: 8px;\n    font-family: var(--omni-font-mono, \"SF Mono\", Monaco, Menlo, Consolas, monospace);\n    white-space: pre;\n}\n.omni-fallback__note {\n    padding: 4px 8px;\n    color: var(--omni-fg-muted, #9d9d9d);\n    border-top: 1px solid var(--omni-border, #3c3c3c);\n}\n";

package/dist/viewers/fallback/styles.js

@@ -0,0 +1,49 @@
+export const fallbackViewerCss = `
+/* Reverse-contamination guard for 'scoped' mode — see csv/styles.ts. */
+.omni-viewer--fallback {
+    all: initial;
+}
+.omni-viewer--fallback :where(pre, code, div) {
+    all: revert;
+}
+
+:host, .omni-viewer--fallback {
+    display: block;
+    height: 100%;
+    box-sizing: border-box;
+    color: var(--omni-fg, #d4d4d4);
+    background: var(--omni-bg, #1e1e1e);
+    font-family: var(--omni-font, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif);
+    font-size: var(--omni-font-size, 13px);
+}
+.omni-fallback {
+    display: flex;
+    flex-direction: column;
+    height: 100%;
+    min-height: 0;
+}
+.omni-fallback__reason {
+    padding: 6px 8px;
+    color: var(--omni-warning-fg, #cca700);
+    border-bottom: 1px solid var(--omni-border, #3c3c3c);
+}
+.omni-fallback__title {
+    padding: 6px 8px;
+    color: var(--omni-fg-muted, #9d9d9d);
+    border-bottom: 1px solid var(--omni-border, #3c3c3c);
+}
+.omni-fallback__content {
+    flex: 1;
+    min-height: 0;
+    overflow: auto;
+    margin: 0;
+    padding: 8px;
+    font-family: var(--omni-font-mono, "SF Mono", Monaco, Menlo, Consolas, monospace);
+    white-space: pre;
+}
+.omni-fallback__note {
+    padding: 4px 8px;
+    color: var(--omni-fg-muted, #9d9d9d);
+    border-top: 1px solid var(--omni-border, #3c3c3c);
+}
+`;

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

@@ -0,0 +1,19 @@
+import type { ClipboardService, HostContext } from '../../host/index.js';
+import { type Hdf5Document } from '../../parsers/hdf5/index.js';
+import { type MountOptions, type ViewerHandle, type ViewerInput } from '../types.js';
+export { hdf5ViewerCss } from './styles.js';
+export declare const HDF5_VIEWER_META: {
+    id: string;
+    displayNameKey: string;
+    extensions: string[];
+    priority: number;
+    requiredServices: readonly [];
+    optionalServices: readonly ["clipboard"];
+    inputOwnership: "borrows";
+};
+export type Hdf5ViewerContext = HostContext & {
+    clipboard?: ClipboardService;
+};
+export declare function mountHdf5Viewer(input: ViewerInput, container: HTMLElement, ctx: Hdf5ViewerContext, options?: MountOptions): Promise<ViewerHandle>;
+/** Mount a pre-parsed model, allowing Node adapters to retain random-access parsing. */
+export declare function mountHdf5Document(document: Hdf5Document, fileName: string, container: HTMLElement, ctx: Hdf5ViewerContext, options?: MountOptions): ViewerHandle;

package/dist/viewers/hdf5/index.js

@@ -0,0 +1,170 @@
+import { parseHdf5 } from '../../parsers/hdf5/index.js';
+import { MountAbortedError, VIEWER_ROOT_CLASS } from '../types.js';
+import { hdf5ViewerCss } from './styles.js';
+export { hdf5ViewerCss } from './styles.js';
+export const HDF5_VIEWER_META = {
+    id: 'hdf5',
+    displayNameKey: 'hdf5.title',
+    extensions: ['h5', 'hdf5', 'he5'],
+    priority: 20,
+    requiredServices: [],
+    optionalServices: ['clipboard'],
+    inputOwnership: 'borrows'
+};
+export async function mountHdf5Viewer(input, container, ctx, options = {}) {
+    if (options.signal?.aborted)
+        throw new MountAbortedError();
+    const document = parseHdf5(input.data);
+    if (options.signal?.aborted)
+        throw new MountAbortedError();
+    return mountHdf5Document(document, input.fileName, container, ctx, options);
+}
+/** Mount a pre-parsed model, allowing Node adapters to retain random-access parsing. */
+export function mountHdf5Document(document, fileName, container, ctx, options = {}) {
+    if (options.signal?.aborted)
+        throw new MountAbortedError();
+    let root = container;
+    let injectedStyle;
+    if ((options.styleIsolation ?? 'shadow') === 'shadow' && container.attachShadow) {
+        root = container.shadowRoot ?? container.attachShadow({ mode: 'open' });
+        const style = element('style');
+        style.textContent = hdf5ViewerCss;
+        root.append(style);
+        injectedStyle = style;
+    }
+    else {
+        container.classList.add(VIEWER_ROOT_CLASS, 'omni-viewer--hdf5');
+    }
+    const frame = element('div', 'omni-hdf5');
+    const header = element('header', 'omni-hdf5__header');
+    const heading = element('div');
+    heading.append(element('div', 'omni-hdf5__eyebrow', document.format), element('h1', undefined, fileName), element('div', 'omni-hdf5__subtitle', `${document.title} · ${document.fileSize}`));
+    header.append(heading);
+    const summary = element('section', 'omni-hdf5__summary');
+    for (const item of document.summary) {
+        const card = element('div', 'omni-hdf5__summary-item');
+        card.append(element('div', 'omni-hdf5__summary-value', String(item.value)), element('div', 'omni-hdf5__summary-label', item.label));
+        summary.append(card);
+    }
+    const toolbar = element('div', 'omni-hdf5__toolbar');
+    const search = element('input', 'omni-hdf5__search');
+    search.type = 'search';
+    search.placeholder = ctx.i18n.t('hdf5.search');
+    search.setAttribute('aria-label', ctx.i18n.t('hdf5.search'));
+    const tabs = element('div', 'omni-hdf5__tabs');
+    const copy = element('button', undefined, ctx.i18n.t('hdf5.copyJson'));
+    copy.type = 'button';
+    if (!ctx.clipboard) {
+        copy.disabled = true;
+        copy.title = ctx.i18n.t('common.noClipboard');
+    }
+    toolbar.append(search, tabs, copy);
+    const warnings = element('section', 'omni-hdf5__warnings');
+    warnings.setAttribute('role', 'status');
+    for (const warning of document.warnings)
+        warnings.append(element('div', undefined, warning));
+    if (document.warnings.length === 0)
+        warnings.hidden = true;
+    const content = element('main', 'omni-hdf5__content');
+    frame.append(header, summary, toolbar, warnings, content);
+    root.append(frame);
+    let activeTab = 0;
+    let raw = false;
+    let copyResetTimer;
+    const disposers = [];
+    const on = (target, type, listener) => {
+        target.addEventListener(type, listener);
+        disposers.push(() => target.removeEventListener(type, listener));
+    };
+    const renderTabs = () => {
+        tabs.replaceChildren();
+        document.tables.forEach((table, index) => {
+            const button = element('button', undefined, table.title);
+            button.type = 'button';
+            button.setAttribute('aria-pressed', String(!raw && activeTab === index));
+            button.onclick = () => { activeTab = index; raw = false; renderTabs(); renderContent(); };
+            tabs.append(button);
+        });
+        if (document.rawPreview) {
+            const button = element('button', undefined, ctx.i18n.t('hdf5.structure'));
+            button.type = 'button';
+            button.setAttribute('aria-pressed', String(raw));
+            button.onclick = () => { raw = true; renderTabs(); renderContent(); };
+            tabs.append(button);
+        }
+    };
+    const matchingRows = (table) => {
+        const query = search.value.trim().toLowerCase();
+        if (!query)
+            return table.rows;
+        return table.rows.filter(row => row.some(cell => String(cell).toLowerCase().includes(query)));
+    };
+    const renderContent = () => {
+        content.replaceChildren();
+        if (raw) {
+            content.append(element('pre', undefined, document.rawPreview ?? ''));
+            return;
+        }
+        const table = document.tables[activeTab];
+        if (!table) {
+            content.append(element('div', 'omni-hdf5__empty', ctx.i18n.t('hdf5.noData')));
+            return;
+        }
+        const rows = matchingRows(table);
+        const visible = rows.slice(0, 1000);
+        const panelHeader = element('div', 'omni-hdf5__panel-header');
+        panelHeader.append(element('h2', undefined, table.title), element('span', undefined, ctx.i18n.t(rows.length > visible.length ? 'hdf5.matchingRowsLimited' : 'hdf5.matchingRows', rows.length > visible.length ? { visible: visible.length, total: rows.length } : { count: rows.length })));
+        const wrap = element('div', 'omni-hdf5__table-wrap');
+        const tableElement = element('table');
+        const head = element('thead');
+        const headerRow = element('tr');
+        for (const label of table.headers)
+            headerRow.append(element('th', undefined, label));
+        head.append(headerRow);
+        const body = element('tbody');
+        for (const row of visible) {
+            const tr = element('tr');
+            for (const cell of row) {
+                const value = String(cell);
+                const td = element('td', undefined, value);
+                td.title = value;
+                tr.append(td);
+            }
+            body.append(tr);
+        }
+        tableElement.append(head, body);
+        wrap.append(tableElement);
+        content.append(panelHeader, wrap);
+    };
+    on(search, 'input', () => renderContent());
+    on(copy, 'click', () => {
+        if (!ctx.clipboard)
+            return;
+        void ctx.clipboard.writeText(JSON.stringify(document, null, 2));
+        copy.textContent = ctx.i18n.t('common.copied');
+        if (copyResetTimer !== undefined)
+            clearTimeout(copyResetTimer);
+        copyResetTimer = setTimeout(() => { copy.textContent = ctx.i18n.t('hdf5.copyJson'); }, 1200);
+    });
+    renderTabs();
+    renderContent();
+    return {
+        dispose() {
+            if (copyResetTimer !== undefined)
+                clearTimeout(copyResetTimer);
+            disposers.splice(0).forEach(dispose => dispose());
+            frame.remove();
+            injectedStyle?.remove();
+            if (!(root instanceof ShadowRoot))
+                container.classList.remove(VIEWER_ROOT_CLASS, 'omni-viewer--hdf5');
+        }
+    };
+}
+function element(tag, className, text) {
+    const node = document.createElement(tag);
+    if (className)
+        node.className = className;
+    if (text !== undefined)
+        node.textContent = text;
+    return node;
+}

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

@@ -0,0 +1 @@
+export declare const hdf5ViewerCss = "\n.omni-hdf5{height:100%;min-height:0;display:flex;flex-direction:column;background:var(--omni-bg,#fff);color:var(--omni-fg,#222);font:13px system-ui,sans-serif}.omni-hdf5__header{display:flex;align-items:flex-start;justify-content:space-between;gap:16px;padding:18px 20px 12px;border-bottom:1px solid var(--omni-border,#ddd);background:var(--omni-panel-bg,#f7f7f7)}.omni-hdf5__eyebrow{color:var(--omni-muted,#666);font-size:12px;text-transform:uppercase}.omni-hdf5 h1{margin:2px 0 4px;font-size:20px}.omni-hdf5__subtitle{color:var(--omni-muted,#666);font-size:12px}.omni-hdf5__summary{display:grid;grid-template-columns:repeat(auto-fit,minmax(140px,1fr));gap:1px;background:var(--omni-border,#ddd);border-bottom:1px solid var(--omni-border,#ddd)}.omni-hdf5__summary-item{min-height:64px;padding:12px 14px;background:var(--omni-bg,#fff)}.omni-hdf5__summary-value{font-size:20px;font-weight:650}.omni-hdf5__summary-label{margin-top:4px;color:var(--omni-muted,#666);font-size:12px}.omni-hdf5__toolbar{display:flex;align-items:center;gap:8px;padding:10px 12px;border-bottom:1px solid var(--omni-border,#ddd);background:var(--omni-toolbar-bg,#f5f5f5)}.omni-hdf5__search{width:min(320px,36vw);min-width:180px;border:1px solid var(--omni-border,#ccc);background:var(--omni-input-bg,#fff);color:inherit;padding:7px 9px;border-radius:4px}.omni-hdf5__tabs{display:flex;flex-wrap:wrap;gap:4px;flex:1}.omni-hdf5 button{border:1px solid var(--omni-border,#ccc);border-radius:4px;background:var(--omni-button-bg,#eee);color:inherit;cursor:pointer;padding:7px 10px}.omni-hdf5 button:hover{background:var(--omni-hover,#e5e5e5)}.omni-hdf5 button[aria-pressed=true]{background:var(--omni-accent,#0e639c);color:var(--omni-accent-fg,#fff)}.omni-hdf5 button:disabled{opacity:.5;cursor:default}.omni-hdf5__warnings{padding:10px 14px;border-bottom:1px solid var(--omni-border,#ddd);background:var(--omni-warning-bg,#fff4ce);color:var(--omni-warning-fg,#5f4700)}.omni-hdf5__content{min-height:0;flex:1;overflow:auto}.omni-hdf5__panel-header{position:sticky;top:0;z-index:1;display:flex;align-items:center;justify-content:space-between;gap:12px;padding:10px 14px;border-bottom:1px solid var(--omni-border,#ddd);background:var(--omni-bg,#fff)}.omni-hdf5__panel-header h2{margin:0;font-size:15px}.omni-hdf5__panel-header span{color:var(--omni-muted,#666);font-size:12px}.omni-hdf5__table-wrap{overflow:auto}.omni-hdf5 table{width:100%;border-collapse:collapse}.omni-hdf5 th,.omni-hdf5 td{border-bottom:1px solid var(--omni-border,#ddd);padding:7px 9px;text-align:left;vertical-align:top;white-space:nowrap}.omni-hdf5 th{background:var(--omni-header-bg,#f5f5f5);font-weight:650}.omni-hdf5 td{max-width:520px;overflow:hidden;text-overflow:ellipsis}.omni-hdf5 tr:hover td{background:var(--omni-hover,#f4f4f4)}.omni-hdf5 pre{margin:0;padding:14px;font:13px/1.45 ui-monospace,SFMono-Regular,Consolas,monospace;white-space:pre-wrap}.omni-hdf5__empty{padding:24px;color:var(--omni-muted,#666)}\n@media(max-width:720px){.omni-hdf5__header,.omni-hdf5__toolbar{align-items:stretch;flex-direction:column}.omni-hdf5__search{width:auto}}\n";

package/dist/viewers/hdf5/styles.js

@@ -0,0 +1,4 @@
+export const hdf5ViewerCss = `
+.omni-hdf5{height:100%;min-height:0;display:flex;flex-direction:column;background:var(--omni-bg,#fff);color:var(--omni-fg,#222);font:13px system-ui,sans-serif}.omni-hdf5__header{display:flex;align-items:flex-start;justify-content:space-between;gap:16px;padding:18px 20px 12px;border-bottom:1px solid var(--omni-border,#ddd);background:var(--omni-panel-bg,#f7f7f7)}.omni-hdf5__eyebrow{color:var(--omni-muted,#666);font-size:12px;text-transform:uppercase}.omni-hdf5 h1{margin:2px 0 4px;font-size:20px}.omni-hdf5__subtitle{color:var(--omni-muted,#666);font-size:12px}.omni-hdf5__summary{display:grid;grid-template-columns:repeat(auto-fit,minmax(140px,1fr));gap:1px;background:var(--omni-border,#ddd);border-bottom:1px solid var(--omni-border,#ddd)}.omni-hdf5__summary-item{min-height:64px;padding:12px 14px;background:var(--omni-bg,#fff)}.omni-hdf5__summary-value{font-size:20px;font-weight:650}.omni-hdf5__summary-label{margin-top:4px;color:var(--omni-muted,#666);font-size:12px}.omni-hdf5__toolbar{display:flex;align-items:center;gap:8px;padding:10px 12px;border-bottom:1px solid var(--omni-border,#ddd);background:var(--omni-toolbar-bg,#f5f5f5)}.omni-hdf5__search{width:min(320px,36vw);min-width:180px;border:1px solid var(--omni-border,#ccc);background:var(--omni-input-bg,#fff);color:inherit;padding:7px 9px;border-radius:4px}.omni-hdf5__tabs{display:flex;flex-wrap:wrap;gap:4px;flex:1}.omni-hdf5 button{border:1px solid var(--omni-border,#ccc);border-radius:4px;background:var(--omni-button-bg,#eee);color:inherit;cursor:pointer;padding:7px 10px}.omni-hdf5 button:hover{background:var(--omni-hover,#e5e5e5)}.omni-hdf5 button[aria-pressed=true]{background:var(--omni-accent,#0e639c);color:var(--omni-accent-fg,#fff)}.omni-hdf5 button:disabled{opacity:.5;cursor:default}.omni-hdf5__warnings{padding:10px 14px;border-bottom:1px solid var(--omni-border,#ddd);background:var(--omni-warning-bg,#fff4ce);color:var(--omni-warning-fg,#5f4700)}.omni-hdf5__content{min-height:0;flex:1;overflow:auto}.omni-hdf5__panel-header{position:sticky;top:0;z-index:1;display:flex;align-items:center;justify-content:space-between;gap:12px;padding:10px 14px;border-bottom:1px solid var(--omni-border,#ddd);background:var(--omni-bg,#fff)}.omni-hdf5__panel-header h2{margin:0;font-size:15px}.omni-hdf5__panel-header span{color:var(--omni-muted,#666);font-size:12px}.omni-hdf5__table-wrap{overflow:auto}.omni-hdf5 table{width:100%;border-collapse:collapse}.omni-hdf5 th,.omni-hdf5 td{border-bottom:1px solid var(--omni-border,#ddd);padding:7px 9px;text-align:left;vertical-align:top;white-space:nowrap}.omni-hdf5 th{background:var(--omni-header-bg,#f5f5f5);font-weight:650}.omni-hdf5 td{max-width:520px;overflow:hidden;text-overflow:ellipsis}.omni-hdf5 tr:hover td{background:var(--omni-hover,#f4f4f4)}.omni-hdf5 pre{margin:0;padding:14px;font:13px/1.45 ui-monospace,SFMono-Regular,Consolas,monospace;white-space:pre-wrap}.omni-hdf5__empty{padding:24px;color:var(--omni-muted,#666)}
+@media(max-width:720px){.omni-hdf5__header,.omni-hdf5__toolbar{align-items:stretch;flex-direction:column}.omni-hdf5__search{width:auto}}
+`;

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

@@ -0,0 +1,19 @@
+export interface HwpViewState {
+    zoom: number;
+}
+export type HwpAction = {
+    type: 'zoom-in';
+} | {
+    type: 'zoom-out';
+} | {
+    type: 'reset-zoom';
+};
+export interface HwpController {
+    readonly state: HwpViewState;
+    dispatch(action: HwpAction): void;
+    subscribe(listener: (state: HwpViewState) => void): () => void;
+}
+export declare const HWP_MIN_ZOOM = 0.25;
+export declare const HWP_MAX_ZOOM = 2.5;
+export declare const HWP_ZOOM_STEP = 0.1;
+export declare function createHwpController(): HwpController;