omni-viewer-core 0.1.0

package/dist/viewers/proto/index.js

@@ -0,0 +1,170 @@
+import { allProtoTypes, flattenProtoMessages, parseProto } from '../../parsers/proto/index.js';
+import { MountAbortedError, VIEWER_ROOT_CLASS } from '../types.js';
+import { protoViewerCss } from './styles.js';
+export { protoViewerCss } from './styles.js';
+export { parseProto } from '../../parsers/proto/index.js';
+export const PROTO_VIEWER_META = { id: 'proto', displayNameKey: 'proto.title', extensions: ['proto'], priority: 10, requiredServices: [], optionalServices: ['clipboard'], inputOwnership: 'borrows' };
+export async function mountProtoViewer(input, container, ctx, options = {}) {
+    if (options.signal?.aborted)
+        throw new MountAbortedError();
+    const source = new TextDecoder().decode(input.data);
+    const model = parseProto(source, input.fileName);
+    const t = ctx.i18n.t.bind(ctx.i18n);
+    let root;
+    if ((options.styleIsolation ?? 'shadow') === 'shadow' && typeof container.attachShadow === 'function') {
+        root = container.shadowRoot ?? container.attachShadow({ mode: 'open' });
+        const style = document.createElement('style');
+        style.textContent = protoViewerCss;
+        root.append(style);
+    }
+    else {
+        container.classList.add(VIEWER_ROOT_CLASS, 'omni-viewer--proto');
+        root = container;
+    }
+    const el = (tag, cls, text) => { const node = document.createElement(tag); if (cls)
+        node.className = cls; if (text !== undefined)
+        node.textContent = text; return node; };
+    const disposers = [];
+    const panelDisposers = [];
+    const listen = (bucket, node, type, listener) => { node.addEventListener(type, listener); bucket.push(() => node.removeEventListener(type, listener)); };
+    const on = (node, type, listener) => listen(disposers, node, type, listener);
+    const onPanel = (node, type, listener) => listen(panelDisposers, node, type, listener);
+    const frame = el('div', 'omni-proto');
+    const header = el('header', 'omni-proto__header');
+    header.append(el('strong', 'omni-proto__title', input.fileName), el('span', 'omni-proto__summary', t('proto.summary', { syntax: model.syntax || 'proto', package: model.packageName || t('proto.noPackage'), messages: model.stats.messages, services: model.stats.services })));
+    const toolbar = el('div', 'omni-proto__toolbar');
+    const search = el('input', 'omni-proto__search');
+    search.type = 'search';
+    search.placeholder = t('proto.search');
+    search.setAttribute('aria-label', t('proto.search'));
+    toolbar.append(search);
+    const panelDefs = [['tree', 'proto.panel.tree'], ['types', 'proto.panel.types'], ['relationships', 'proto.panel.relationships'], ['reverse', 'proto.panel.reverse'], ['json', 'proto.panel.json'], ['breaking', 'proto.panel.breaking'], ['imports', 'proto.panel.imports'], ['grpc', 'proto.panel.grpc'], ['docs', 'proto.panel.docs']];
+    let active = 'tree';
+    let selectedType = flattenProtoMessages(model.messages)[0]?.fullName ?? '';
+    const copy = el('button', undefined, t('proto.copyPanel'));
+    copy.type = 'button';
+    copy.disabled = !ctx.clipboard;
+    copy.title = ctx.clipboard ? '' : t('common.noClipboard');
+    toolbar.append(copy);
+    const sourceView = el('pre', 'omni-proto__source');
+    source.replace(/\r\n?|\n/g, '\n').split('\n').forEach((text, i) => { const line = el('span', 'omni-proto__line', text || ' '); line.dataset.line = String(i + 1); sourceView.append(line); });
+    const panel = el('section', 'omni-proto__panel');
+    const workspace = el('main', 'omni-proto__workspace');
+    workspace.append(sourceView, panel);
+    const reveal = (line) => { if (!line)
+        return; sourceView.querySelectorAll('.is-selected').forEach(node => node.classList.remove('is-selected')); const target = sourceView.querySelector(`[data-line="${line}"]`); target?.classList.add('is-selected'); target?.scrollIntoView({ block: 'center' }); };
+    const row = (badge, text, line) => { const node = el('div', 'omni-proto__row'); node.append(el('span', 'omni-proto__badge', badge), el('span', 'omni-proto__code', text)); node.dataset.search = `${badge} ${text}`.toLowerCase(); if (line) {
+        node.dataset.line = String(line);
+        onPanel(node, 'click', () => reveal(line));
+    } return node; };
+    const kind = (value) => t(`proto.kind.${value}`);
+    const declaration = (item) => { const wrap = el('div', 'omni-proto__card'); wrap.dataset.search = `${item.kind} ${item.fullName} ${item.documentation}`.toLowerCase(); wrap.append(row(kind(item.kind), item.fullName, item.range.startLine)); const children = el('div', 'omni-proto__children'); if (item.kind === 'message') {
+        item.fields.forEach(field => children.append(row(field.oneof ? `${kind('oneof')} ${field.oneof}` : field.repeated ? kind('repeated') : kind('field'), `${field.name}: ${field.type} = ${field.number}`, field.line)));
+        item.enums.forEach(value => children.append(declaration(value)));
+        item.messages.forEach(value => children.append(declaration(value)));
+    }
+    else if (item.kind === 'enum')
+        item.values.forEach(value => children.append(row(kind('value'), `${value.name} = ${value.number}`, value.line)));
+    else
+        item.rpcs.forEach(rpc => children.append(row(kind('rpc'), `${rpc.name}(${rpc.requestStream ? `${kind('stream')} ` : ''}${rpc.requestType}) → ${rpc.responseStream ? `${kind('stream')} ` : ''}${rpc.responseType}`, rpc.line))); wrap.append(children); return wrap; };
+    const selectType = (messagesOnly = false) => { const select = el('select'); const values = messagesOnly ? flattenProtoMessages(model.messages) : allProtoTypes(model); values.forEach(value => { const option = el('option', undefined, value.fullName); option.value = value.fullName; select.append(option); }); if (!values.some(value => value.fullName === selectedType))
+        selectedType = values[0]?.fullName ?? ''; select.value = selectedType; onPanel(select, 'change', () => { selectedType = select.value; render(); }); return select; };
+    const example = (message, seen = new Set()) => {
+        if (seen.has(message.fullName))
+            return {};
+        const next = new Set(seen).add(message.fullName);
+        const messages = flattenProtoMessages(model.messages);
+        const enums = allProtoTypes(model).filter((item) => item.kind === 'enum');
+        const scalars = { string: 'string', bytes: 'base64', bool: false, double: 0, float: 0, int32: 0, int64: '0', uint32: 0, uint64: '0', sint32: 0, sint64: '0', fixed32: 0, fixed64: '0', sfixed32: 0, sfixed64: '0' };
+        const matchesType = (candidate, type) => candidate.fullName === type || candidate.name === type || candidate.fullName.endsWith(`.${type}`);
+        return Object.fromEntries(message.fields.map(field => {
+            const type = field.type.replace(/^\./, '');
+            let value;
+            if (field.map)
+                value = { key: 'value' };
+            else if (Object.prototype.hasOwnProperty.call(scalars, type))
+                value = scalars[type];
+            else {
+                const enumType = enums.find(candidate => matchesType(candidate, type));
+                const nested = messages.find(candidate => matchesType(candidate, type));
+                value = enumType ? (enumType.values[0]?.name ?? 'ENUM_VALUE') : nested ? example(nested, next) : null;
+            }
+            return [field.name, field.repeated ? [value] : value];
+        }));
+    };
+    const breakingFindings = (previous) => { const findings = []; const currentMessages = new Map(flattenProtoMessages(model.messages).map(message => [message.fullName, message])); for (const oldMessage of flattenProtoMessages(previous.messages)) {
+        const current = currentMessages.get(oldMessage.fullName);
+        if (!current) {
+            findings.push(t('proto.breaking.messageRemoved', { name: oldMessage.fullName }));
+            continue;
+        }
+        const fields = new Map(current.fields.map(field => [field.number, field]));
+        for (const oldField of oldMessage.fields) {
+            const field = fields.get(oldField.number);
+            if (!field)
+                findings.push(t('proto.breaking.fieldRemoved', { message: oldMessage.fullName, field: oldField.name, number: oldField.number }));
+            else if (field.name !== oldField.name || field.type !== oldField.type)
+                findings.push(t('proto.breaking.fieldChanged', { message: oldMessage.fullName, number: oldField.number }));
+        }
+    } return findings; };
+    const applySearch = (query) => { const filter = (node) => { const own = !query || (node.dataset.search?.includes(query) ?? false); let childMatch = false; for (const child of node.children)
+        if (child instanceof HTMLElement)
+            childMatch = filter(child) || childMatch; const visible = own || childMatch; if (node.dataset.search !== undefined || node.classList.contains('omni-proto__card'))
+        node.style.display = visible ? '' : 'none'; return visible; }; for (const child of panel.children)
+        if (child instanceof HTMLElement)
+            filter(child); };
+    const render = () => {
+        panelDisposers.splice(0).forEach(dispose => dispose());
+        panel.replaceChildren();
+        if (active === 'tree')
+            [...model.messages, ...model.enums, ...model.services].forEach(item => panel.append(declaration(item)));
+        else if (active === 'types')
+            allProtoTypes(model).forEach(item => panel.append(declaration(item)));
+        else if (active === 'relationships')
+            model.references.forEach(ref => panel.append(row(kind(ref.fromKind), `${ref.from} → ${ref.to} (${ref.name})`, ref.line)));
+        else if (active === 'reverse') {
+            panel.append(selectType());
+            const refs = model.references.filter(ref => ref.to === selectedType || ref.to.split('.').at(-1) === selectedType.split('.').at(-1));
+            refs.forEach(ref => panel.append(row(kind(ref.fromKind), t('proto.reverseRow', { from: ref.from, to: ref.to, name: ref.name }), ref.line)));
+            if (!refs.length)
+                panel.append(el('div', 'omni-proto__empty', t('proto.noReferences', { name: selectedType })));
+        }
+        else if (active === 'json') {
+            const select = selectType(true);
+            const message = flattenProtoMessages(model.messages).find(value => value.fullName === selectedType);
+            const pre = el('pre', 'omni-proto__card omni-proto__code', message ? JSON.stringify(example(message), null, 2) : t('proto.noMessages'));
+            panel.append(select, pre);
+        }
+        else if (active === 'breaking') {
+            const textarea = el('textarea', 'omni-proto__baseline');
+            textarea.placeholder = t('proto.breaking.placeholder');
+            const compare = el('button', undefined, t('proto.breaking.compare'));
+            compare.type = 'button';
+            const result = el('div');
+            onPanel(compare, 'click', () => { const findings = breakingFindings(parseProto(textarea.value, input.fileName)); result.replaceChildren(...(findings.length ? findings.map(value => row(t('proto.breaking.breaking'), value)) : [el('div', 'omni-proto__empty', t('proto.breaking.none'))])); });
+            panel.append(textarea, compare, result);
+        }
+        else if (active === 'imports')
+            model.imports.forEach(value => panel.append(row(kind('import'), `${input.fileName} → ${value}`)));
+        else if (active === 'grpc')
+            model.services.forEach(service => panel.append(declaration(service)));
+        else
+            allProtoTypes(model).forEach(item => { const card = el('article', 'omni-proto__card'); card.dataset.search = `${item.fullName} ${item.documentation}`.toLowerCase(); card.append(el('strong', undefined, item.fullName), el('pre', 'omni-proto__muted', item.documentation || t('proto.noDocumentation'))); panel.append(card); });
+        applySearch(search.value.trim().toLowerCase());
+        if (!panel.children.length)
+            panel.append(el('div', 'omni-proto__empty', t('proto.noDeclarations')));
+    };
+    panelDefs.forEach(([key, labelKey]) => { const button = el('button', undefined, t(labelKey)); button.type = 'button'; button.dataset.panel = key; button.setAttribute('aria-pressed', String(key === active)); on(button, 'click', () => { active = key; toolbar.querySelectorAll('[data-panel]').forEach(node => node.setAttribute('aria-pressed', String(node.dataset.panel === active))); render(); }); toolbar.insertBefore(button, copy); });
+    on(search, 'input', () => applySearch(search.value.trim().toLowerCase()));
+    on(copy, 'click', () => { if (ctx.clipboard)
+        void ctx.clipboard.writeText(panel.textContent ?? '').catch(error => ctx.logger.log('error', `proto copy failed: ${String(error)}`)); });
+    frame.append(header, toolbar, workspace);
+    if (model.warnings.length)
+        frame.append(el('div', 'omni-proto__warning', model.warnings.join(' · ')));
+    root.append(frame);
+    render();
+    return { dispose() { panelDisposers.splice(0).forEach(dispose => dispose()); disposers.splice(0).forEach(dispose => dispose()); frame.remove(); if (root instanceof ShadowRoot)
+            root.replaceChildren();
+        else
+            container.classList.remove(VIEWER_ROOT_CLASS, 'omni-viewer--proto'); } };
+}

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

@@ -0,0 +1 @@
+export declare const protoViewerCss = "\n:host{display:block;height:100%;color:var(--omni-fg,#d4d4d4);background:var(--omni-bg,#1e1e1e);font:13px system-ui,sans-serif}.omni-proto{display:flex;flex-direction:column;height:100%;min-height:420px}.omni-proto__header,.omni-proto__toolbar{display:flex;align-items:center;gap:8px;padding:10px 14px;border-bottom:1px solid var(--omni-border,#3c3c3c);flex-wrap:wrap}.omni-proto__title{font-size:16px;font-weight:650;margin-right:auto}.omni-proto__summary,.omni-proto__muted{color:var(--omni-muted,#999)}.omni-proto button,.omni-proto input,.omni-proto select,.omni-proto textarea{font:inherit;color:inherit;background:var(--omni-control,#2d2d2d);border:1px solid var(--omni-border,#555);border-radius:4px;padding:5px 9px}.omni-proto button{cursor:pointer}.omni-proto button[aria-pressed=true]{background:var(--omni-accent,#0e639c);border-color:var(--omni-accent,#0e639c);color:#fff}.omni-proto__search{min-width:220px}.omni-proto__workspace{display:grid;grid-template-columns:minmax(280px,42%) 1fr;min-height:0;flex:1}.omni-proto__source,.omni-proto__panel{overflow:auto;min-width:0}.omni-proto__source{margin:0;padding:12px 0;border-right:1px solid var(--omni-border,#3c3c3c);font:12px/1.55 ui-monospace,monospace;counter-reset:line}.omni-proto__line{display:block;padding:0 12px 0 52px;white-space:pre;position:relative}.omni-proto__line:before{counter-increment:line;content:counter(line);position:absolute;left:8px;width:34px;text-align:right;color:var(--omni-muted,#777)}.omni-proto__line.is-selected{background:color-mix(in srgb,var(--omni-accent,#0e639c) 30%,transparent)}.omni-proto__panel{padding:12px}.omni-proto__row,.omni-proto__card{border:1px solid var(--omni-border,#3c3c3c);border-radius:5px;padding:8px;margin-bottom:7px}.omni-proto__row{display:flex;gap:8px;align-items:baseline}.omni-proto__row[data-line]{cursor:pointer}.omni-proto__badge{font-size:11px;color:var(--omni-accent-fg,#75beff);min-width:58px}.omni-proto__code{font-family:ui-monospace,monospace}.omni-proto__children{margin-left:18px}.omni-proto__baseline{box-sizing:border-box;width:100%;min-height:180px;display:block;margin-bottom:8px;font-family:ui-monospace,monospace}.omni-proto__warning{padding:8px 14px;color:#f0c674;border-top:1px solid var(--omni-border,#3c3c3c)}.omni-proto__empty{color:var(--omni-muted,#999);padding:20px;text-align:center}@media(max-width:760px){.omni-proto__workspace{grid-template-columns:1fr;grid-template-rows:minmax(180px,40%) 1fr}.omni-proto__source{border-right:0;border-bottom:1px solid var(--omni-border,#3c3c3c)}}";

package/dist/viewers/proto/styles.js

@@ -0,0 +1,2 @@
+export const protoViewerCss = `
+:host{display:block;height:100%;color:var(--omni-fg,#d4d4d4);background:var(--omni-bg,#1e1e1e);font:13px system-ui,sans-serif}.omni-proto{display:flex;flex-direction:column;height:100%;min-height:420px}.omni-proto__header,.omni-proto__toolbar{display:flex;align-items:center;gap:8px;padding:10px 14px;border-bottom:1px solid var(--omni-border,#3c3c3c);flex-wrap:wrap}.omni-proto__title{font-size:16px;font-weight:650;margin-right:auto}.omni-proto__summary,.omni-proto__muted{color:var(--omni-muted,#999)}.omni-proto button,.omni-proto input,.omni-proto select,.omni-proto textarea{font:inherit;color:inherit;background:var(--omni-control,#2d2d2d);border:1px solid var(--omni-border,#555);border-radius:4px;padding:5px 9px}.omni-proto button{cursor:pointer}.omni-proto button[aria-pressed=true]{background:var(--omni-accent,#0e639c);border-color:var(--omni-accent,#0e639c);color:#fff}.omni-proto__search{min-width:220px}.omni-proto__workspace{display:grid;grid-template-columns:minmax(280px,42%) 1fr;min-height:0;flex:1}.omni-proto__source,.omni-proto__panel{overflow:auto;min-width:0}.omni-proto__source{margin:0;padding:12px 0;border-right:1px solid var(--omni-border,#3c3c3c);font:12px/1.55 ui-monospace,monospace;counter-reset:line}.omni-proto__line{display:block;padding:0 12px 0 52px;white-space:pre;position:relative}.omni-proto__line:before{counter-increment:line;content:counter(line);position:absolute;left:8px;width:34px;text-align:right;color:var(--omni-muted,#777)}.omni-proto__line.is-selected{background:color-mix(in srgb,var(--omni-accent,#0e639c) 30%,transparent)}.omni-proto__panel{padding:12px}.omni-proto__row,.omni-proto__card{border:1px solid var(--omni-border,#3c3c3c);border-radius:5px;padding:8px;margin-bottom:7px}.omni-proto__row{display:flex;gap:8px;align-items:baseline}.omni-proto__row[data-line]{cursor:pointer}.omni-proto__badge{font-size:11px;color:var(--omni-accent-fg,#75beff);min-width:58px}.omni-proto__code{font-family:ui-monospace,monospace}.omni-proto__children{margin-left:18px}.omni-proto__baseline{box-sizing:border-box;width:100%;min-height:180px;display:block;margin-bottom:8px;font-family:ui-monospace,monospace}.omni-proto__warning{padding:8px 14px;color:#f0c674;border-top:1px solid var(--omni-border,#3c3c3c)}.omni-proto__empty{color:var(--omni-muted,#999);padding:20px;text-align:center}@media(max-width:760px){.omni-proto__workspace{grid-template-columns:1fr;grid-template-rows:minmax(180px,40%) 1fr}.omni-proto__source{border-right:0;border-bottom:1px solid var(--omni-border,#3c3c3c)}}`;

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

@@ -0,0 +1,27 @@
+import type { HostContext } from '../../host/index.js';
+import { type PsdHeader } from '../../parsers/psd/index.js';
+import { type MountOptions, type ViewerHandle, type ViewerInput } from '../types.js';
+export { parsePsdHeader } from '../../parsers/psd/index.js';
+export { psdViewerCss } from './styles.js';
+export type PsdViewerContext = HostContext;
+export interface DecodedPsd {
+    element?: HTMLCanvasElement | HTMLImageElement;
+    layerCount?: number;
+    warnings?: string[];
+}
+export interface PsdMountOptions extends MountOptions {
+    decode?(data: Uint8Array, header: PsdHeader): Promise<DecodedPsd>;
+    maxBytes?: number;
+    maxPixels?: number;
+    maxLayers?: number;
+}
+export declare const PSD_VIEWER_META: {
+    id: string;
+    displayNameKey: string;
+    extensions: string[];
+    priority: number;
+    requiredServices: readonly [];
+    optionalServices: readonly [];
+    inputOwnership: "borrows";
+};
+export declare function mountPsdViewer(input: ViewerInput, container: HTMLElement, _ctx: PsdViewerContext, options?: PsdMountOptions): Promise<ViewerHandle>;

package/dist/viewers/psd/index.js

@@ -0,0 +1,39 @@
+import { parsePsdHeader } from '../../parsers/psd/index.js';
+import { MountAbortedError, VIEWER_ROOT_CLASS } from '../types.js';
+import { psdViewerCss } from './styles.js';
+export { parsePsdHeader } from '../../parsers/psd/index.js';
+export { psdViewerCss } from './styles.js';
+export const PSD_VIEWER_META = { id: 'psd', displayNameKey: 'psd.title', extensions: ['psd'], priority: 20, requiredServices: [], optionalServices: [], inputOwnership: 'borrows' };
+export async function mountPsdViewer(input, container, _ctx, options = {}) { if (options.signal?.aborted)
+    throw new MountAbortedError(); const header = parsePsdHeader(input.data, { ...(options.maxBytes ? { maxBytes: options.maxBytes } : {}), ...(options.maxPixels ? { maxPixels: options.maxPixels } : {}) }); const root = options.styleIsolation !== 'scoped' && container.attachShadow ? (container.shadowRoot ?? container.attachShadow({ mode: 'open' })) : container; if (root === container)
+    container.classList.add(VIEWER_ROOT_CLASS, 'omni-viewer--psd');
+else {
+    const style = document.createElement('style');
+    style.textContent = psdViewerCss;
+    root.append(style);
+} const shell = document.createElement('section'); shell.className = `${VIEWER_ROOT_CLASS} omni-psd`; const bar = document.createElement('header'); bar.className = 'omni-psd__header'; const title = document.createElement('div'); title.className = 'omni-psd__title'; title.textContent = input.fileName; const meta = document.createElement('div'); meta.textContent = `${header.width}×${header.height} · ${header.colorModeName} · ${header.depth}-bit`; bar.append(title, meta); const stage = document.createElement('main'); stage.className = 'omni-psd__stage'; const warning = document.createElement('div'); warning.className = 'omni-psd__warning'; warning.hidden = true; shell.append(bar, stage, warning); root.append(shell); let disposed = false; const messages = [...header.warnings]; if (!options.decode)
+    messages.push('PSD rendering requires the optional ag-psd decoder. Header metadata is available, but no composite preview was rendered.');
+else
+    try {
+        const decoded = await abortable(options.decode(input.data, header), options.signal);
+        if ((decoded.layerCount ?? 0) > (options.maxLayers ?? 10_000))
+            messages.push(`Layer list exceeds the ${(options.maxLayers ?? 10_000).toLocaleString()} layer limit and was not expanded.`);
+        messages.push(...(decoded.warnings ?? []));
+        if (decoded.element && !disposed)
+            stage.append(decoded.element);
+        else
+            messages.push('The decoder did not return a composite preview.');
+    }
+    catch (error) {
+        messages.push(`PSD decoding failed: ${error instanceof Error ? error.message : String(error)}`);
+    } warning.hidden = messages.length === 0; warning.textContent = messages.join('\n'); if (options.signal?.aborted) {
+    disposed = true;
+    shell.remove();
+    throw new MountAbortedError();
+} return { dispose() { disposed = true; shell.remove(); if (root === container)
+        container.classList.remove(VIEWER_ROOT_CLASS, 'omni-viewer--psd');
+    else
+        root.replaceChildren(); } }; }
+function abortable(promise, signal) { if (!signal)
+    return promise; if (signal.aborted)
+    return Promise.reject(new MountAbortedError()); return new Promise((resolve, reject) => { const abort = () => reject(new MountAbortedError()); signal.addEventListener('abort', abort, { once: true }); promise.then(value => { signal.removeEventListener('abort', abort); resolve(value); }, error => { signal.removeEventListener('abort', abort); reject(error); }); }); }

package/dist/viewers/psd/self-loading.d.ts

@@ -0,0 +1,10 @@
+import type { PsdMountOptions } from './index.js';
+interface AgPsdModule {
+    readPsd?(buffer: ArrayBuffer, options?: Record<string, unknown>): {
+        canvas?: HTMLCanvasElement;
+        children?: unknown[];
+    };
+}
+export declare function createPsdDecoder(mod: AgPsdModule): Pick<PsdMountOptions, 'decode'>;
+export declare function loadPsdDecoder(): Promise<Pick<PsdMountOptions, 'decode'>>;
+export {};

package/dist/viewers/psd/self-loading.js

@@ -0,0 +1,20 @@
+export function createPsdDecoder(mod) {
+    if (!mod.readPsd)
+        throw new Error('ag-psd decoder is unavailable.');
+    return {
+        decode: async (data) => {
+            const copy = data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength);
+            // The preview consumes ag-psd's composite canvas. `useImageData`
+            // redirects that bitmap to psd.imageData and therefore must not be
+            // enabled here. Layer pixels are unnecessary for this preview.
+            const psd = mod.readPsd(copy, { skipLayerImageData: true, skipThumbnail: true });
+            return {
+                ...(psd.canvas ? { element: psd.canvas } : {}),
+                layerCount: psd.children?.length ?? 0
+            };
+        }
+    };
+}
+export async function loadPsdDecoder() {
+    return createPsdDecoder(await import('ag-psd'));
+}

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

@@ -0,0 +1 @@
+export declare const psdViewerCss = ".omni-psd{box-sizing:border-box;min-height:100%;padding:16px;background:var(--omni-bg,#1e1e1e);color:var(--omni-fg,#ddd);font:14px/1.45 system-ui,sans-serif}.omni-psd *{box-sizing:border-box}.omni-psd__header{display:flex;justify-content:space-between;gap:16px;margin-bottom:12px}.omni-psd__title{font-size:18px;font-weight:650}.omni-psd__stage{display:grid;place-items:center;min-height:300px;overflow:auto;padding:16px;border:1px solid var(--omni-border,#444);border-radius:8px;background:repeating-conic-gradient(#ddd 0 25%,#fff 0 50%) 50%/20px 20px}.omni-psd__stage canvas,.omni-psd__stage img{max-width:100%;height:auto}.omni-psd__warning{margin-top:10px;padding:10px;border:1px solid #b98b2f;border-radius:6px;background:#3b2d10;color:#ffd98a;white-space:pre-wrap}";

package/dist/viewers/psd/styles.js

@@ -0,0 +1 @@
+export const psdViewerCss = `.omni-psd{box-sizing:border-box;min-height:100%;padding:16px;background:var(--omni-bg,#1e1e1e);color:var(--omni-fg,#ddd);font:14px/1.45 system-ui,sans-serif}.omni-psd *{box-sizing:border-box}.omni-psd__header{display:flex;justify-content:space-between;gap:16px;margin-bottom:12px}.omni-psd__title{font-size:18px;font-weight:650}.omni-psd__stage{display:grid;place-items:center;min-height:300px;overflow:auto;padding:16px;border:1px solid var(--omni-border,#444);border-radius:8px;background:repeating-conic-gradient(#ddd 0 25%,#fff 0 50%) 50%/20px 20px}.omni-psd__stage canvas,.omni-psd__stage img{max-width:100%;height:auto}.omni-psd__warning{margin-top:10px;padding:10px;border:1px solid #b98b2f;border-radius:6px;background:#3b2d10;color:#ffd98a;white-space:pre-wrap}`;

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

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

package/dist/viewers/reqif/index.js

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

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

@@ -0,0 +1,35 @@
+import type { HostContext } from '../../host/index.js';
+import { type CoordinateConverter } from '../../parsers/shapefile/reproject.js';
+import { type MountOptions, type ViewerHandle, type ViewerInput } from '../types.js';
+export { parseShapefile } from '../../parsers/shapefile/index.js';
+export { parseDbf, type DbfField, type DbfTable, type DbfValue } from '../../parsers/shapefile/dbf.js';
+export { isGeographicWkt, projectionName, reprojectModel, type CoordinateConverter } from '../../parsers/shapefile/reproject.js';
+export { shapefileViewerCss } from './styles.js';
+export type ShapefileViewerContext = HostContext;
+/** Sidecar files that accompany a .shp. The core receives one file as
+ *  ViewerInput; the adapter reads the neighbours and passes them here. */
+export interface ShapefileSidecars {
+    /** .dbf attribute table bytes. */
+    dbf?: Uint8Array;
+    /** .prj WKT text. */
+    prj?: string;
+}
+export interface ShapefileMountOptions extends MountOptions {
+    maxBytes?: number;
+    maxFeatures?: number;
+    maxVertices?: number;
+    sidecars?: ShapefileSidecars;
+    /** proj4-style converter factory (projected WKT → WGS84 lon/lat).
+     *  Optional peer; see viewers/shapefile/self-loading.ts. */
+    createReprojector?(wkt: string): CoordinateConverter | null;
+}
+export declare const SHAPEFILE_VIEWER_META: {
+    id: string;
+    displayNameKey: string;
+    extensions: string[];
+    priority: number;
+    requiredServices: readonly [];
+    optionalServices: readonly [];
+    inputOwnership: "borrows";
+};
+export declare function mountShapefileViewer(input: ViewerInput, container: HTMLElement, ctx: ShapefileViewerContext, options?: ShapefileMountOptions): Promise<ViewerHandle>;