omni-viewer-core 0.1.0

package/dist/host/index.d.ts

@@ -0,0 +1,133 @@
+/** Required minimal contract every viewer receives. */
+export interface HostContext {
+    assets: AssetService;
+    i18n: I18nService;
+    logger: LoggerService;
+}
+export interface AssetService {
+    /**
+     * Resolve a bundled asset (wasm, worker, font) to a loadable URL.
+     * vscode: webview.asWebviewUri / chrome: chrome.runtime.getURL /
+     * obsidian: bundled bytes -> blob URL / web: static path.
+     * Always a Promise: a dual sync/async return type only complicates
+     * call sites (ADR 32).
+     */
+    resolveAssetUrl(assetPath: string): Promise<string>;
+}
+export interface I18nService {
+    /**
+     * Key + args lookup. The lookup mechanism may be the platform's i18n,
+     * but the source of truth for message text (all locales) is the core
+     * catalog (DESIGN.md §3-③, ADR 28). Inline English fallbacks at call
+     * sites are forbidden.
+     */
+    t(key: string, args?: Record<string, string | number>): string;
+}
+export type LogLevel = 'info' | 'warn' | 'error';
+export interface LoggerService {
+    log(level: LogLevel, message: string): void;
+}
+export interface FileSaveService {
+    /** Creates a new file. Implementations present the platform's save
+     *  destination picker (or browser-equivalent download prompt) so the
+     *  user chooses the target path and may change the suggested name. */
+    saveFile(name: string, data: Uint8Array, mimeType: string): Promise<void>;
+}
+export interface ClipboardService {
+    writeText(text: string): Promise<void>;
+}
+/** Prints the viewer surface selected by the platform adapter. */
+export interface PrintService {
+    print(): void | Promise<void>;
+}
+export interface FileWritebackService {
+    /**
+     * Overwrite the currently open source file. Distinct from FileSaveService
+     * (new files); takes no path — the adapter binds it to the open file via
+     * closure, ruling out arbitrary-path writes.
+     */
+    write(data: Uint8Array): Promise<void>;
+}
+/** Lets an editing viewer ask the host for one user-selected input file. */
+export interface FilePickService {
+    pickFile(options: {
+        accept: readonly string[];
+        maxBytes?: number;
+    }): Promise<{
+        fileName: string;
+        data: Uint8Array;
+        mimeType?: string;
+    } | undefined>;
+}
+export interface NavigationService {
+    /** Open an external link. Scheme allow-list is checked by core before this call. */
+    openExternalUrl(url: string): Promise<void>;
+}
+/** Resolves a relative asset referenced by the document currently being viewed. */
+export interface DocumentAssetsService {
+    resolve(path: string): Promise<ResolvedDocumentAsset | null>;
+}
+export interface ResolvedDocumentAsset {
+    url: string;
+    /** Releases a transient URL (for example a blob URL). */
+    dispose(): void;
+}
+export interface WorkerFactoryService {
+    /** Create a Worker for a core-defined worker entry. URL resolution and
+     *  module/classic choice are the adapter's responsibility. The adapter
+     *  must be able to terminate() it (hard limits, DESIGN.md §3-①). */
+    createWorker(entry: string): Worker;
+}
+/**
+ * Plain RGBA pixel buffer used to hand images to/from model-backed services
+ * (docs/viewers/image.md §2). Deliberately not an ImageBitmap: a data buffer is
+ * Worker-transferable, unit-testable, and keeps the image viewer's state model
+ * DOM-free (§3-②). `data` is row-major RGBA with `length === width * height * 4`.
+ */
+export interface RgbaImage {
+    width: number;
+    height: number;
+    data: Uint8ClampedArray;
+}
+/**
+ * Background removal (currently Web's Transformers.js). Model acquisition,
+ * network use and WASM/Worker creation are the adapter's responsibility; core
+ * only consumes the result and its failure/cancel/dispose (image.md I8).
+ */
+export interface ImageBackgroundRemovalService {
+    /** Returns an RGBA cutout (background alpha = 0). Rejects on abort. */
+    removeBackground(source: RgbaImage, options?: {
+        signal?: AbortSignal;
+    }): Promise<RgbaImage>;
+    /** Release any model/Worker/WASM the service holds. */
+    dispose?(): void;
+}
+/** One detected sprite contour in source pixel coordinates. Core crops and
+ *  composes the object PNG from these — the service returns geometry only. */
+export interface SpriteContour {
+    box: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** Overlay polygon (source px). */
+    polygon?: readonly {
+        x: number;
+        y: number;
+    }[];
+}
+/**
+ * Sprite outline detection (currently Web's OpenCV Canny/contour). Worker/WASM,
+ * CDN and bundled-asset choices belong to the providing adapter (image.md I8).
+ */
+export interface ImageSpriteDetectionService {
+    detectSprites(source: RgbaImage, options?: {
+        signal?: AbortSignal;
+    }): Promise<readonly SpriteContour[]>;
+    dispose?(): void;
+}
+/** Identifiers for optional services, used in viewer metadata. */
+export type ServiceId = 'save' | 'writeback' | 'clipboard' | 'navigation' | 'workerFactory' | 'filePick' | 'backgroundRemoval' | 'spriteDetection' | 'documentAssets' | 'print';
+/** URL schemes viewers may open via NavigationService (DESIGN.md §3-③). */
+export declare const ALLOWED_LINK_SCHEMES: readonly string[];

package/dist/host/index.js

@@ -0,0 +1,10 @@
+// Host service contracts (DESIGN.md §3-③).
+//
+// The host contract is deliberately split into small service interfaces
+// instead of one large `PlatformHost`: most viewers need only the required
+// trio in `HostContext`, and optional capabilities are requested per-viewer
+// through the mount signature's intersection type. Behavior when an optional
+// service is absent is a core contract (degraded mode), not adapter
+// discretion.
+/** URL schemes viewers may open via NavigationService (DESIGN.md §3-③). */
+export const ALLOWED_LINK_SCHEMES = ['https:', 'http:', 'mailto:'];

package/dist/i18n/catalog.en.d.ts

@@ -0,0 +1 @@
+export declare const CATALOG_EN: Record<string, string>;

package/dist/i18n/catalog.en.js

@@ -0,0 +1,411 @@
+// English message catalog — the single source of truth for message text
+// (DESIGN.md §3-③, ADR 28). Substitution syntax is `{name}` only; platform
+// message files (chrome _locales, vscode l10n bundles) are generated from
+// this catalog at build time. Diagnostics (§3-① messageKey) and viewer UI
+// strings share this key space.
+export const CATALOG_EN = {
+    'audio.title': 'Audio', 'video.title': 'Video', 'dbc.title': 'CAN database',
+    'audio.play': 'Play', 'audio.pause': 'Pause', 'audio.stop': 'Stop',
+    'audio.loop': 'Loop', 'audio.clearRegions': 'Clear regions', 'audio.volume': 'Volume',
+    'audio.zoom': 'Zoom', 'audio.zoomIn': 'Zoom in', 'audio.zoomOut': 'Zoom out', 'audio.zoomFit': 'Fit',
+    'audio.visualization': 'View', 'audio.vis.waveform': 'Waveform', 'audio.vis.spectrogram': 'Spectrogram',
+    'audio.info.duration': 'Duration', 'audio.info.sampleRate': 'Sample rate', 'audio.info.channels': 'Channels',
+    'audio.info.bitDepth': 'Bit depth', 'audio.info.format': 'Format', 'audio.info.fileSize': 'File size',
+    'audio.loading': 'Decoding audio…',
+    'audio.status.region': 'Region {start} – {end} ({duration}s)',
+    'audio.status.looping': 'looping region', 'audio.status.loopTrack': 'Looping track',
+    'audio.fallback': 'Waveform engine unavailable — using the basic player.',
+    'audio.error.decode': 'The browser could not decode this audio codec. Try a host with the required codec or transcode the file.',
+    'video.play': 'Play', 'video.pause': 'Pause', 'video.stop': 'Stop',
+    'video.skipBack': '⏪ -{seconds}s', 'video.skipForward': '⏩ +{seconds}s',
+    'video.speed': 'Speed', 'video.zoom': 'Zoom', 'video.zoomIn': 'Zoom in',
+    'video.zoomOut': 'Zoom out', 'video.zoomFit': 'Fit',
+    'video.info.duration': 'Duration', 'video.info.resolution': 'Resolution',
+    'video.info.format': 'Format', 'video.info.fileSize': 'File size',
+    'video.error.empty': 'The media file is empty.',
+    'video.error.tooLarge': 'The file exceeds the {limit} browser preview limit.',
+    'video.error.source': 'This environment cannot create a browser media source.',
+    'video.error.decode': 'The browser could not decode this video codec. Try a host with the required codec or transcode the file.',
+    'arxml.title': 'AUTOSAR XML', 'a2l.title': 'ASAM A2L', 'asc.title': 'Vector ASC log',
+    'blf.title': 'Vector BLF log', 'mf4.title': 'ASAM MDF 4', 'pcap.title': 'PCAP capture',
+    'pcapng.title': 'PCAPNG capture', 'mermaid.title': 'Mermaid diagram',
+    'plantuml.title': 'PlantUML diagram', 'shapefile.title': 'ESRI Shapefile', 'psd.title': 'Photoshop document',
+    'shapefile.zoomIn': 'Zoom in', 'shapefile.zoomOut': 'Zoom out', 'shapefile.reset': 'Reset view',
+    'shapefile.projection': 'Projection: {name}', 'shapefile.attributes': 'Feature attributes',
+    'shapefile.featureLabel': 'Feature {id}',
+    'shapefile.noSelection': 'Click a feature on the map to inspect its attributes.',
+    'shapefile.noAttributes': 'No attribute table (.dbf) was provided for this shapefile.',
+    'shapefile.noRecord': 'This feature has no matching attribute record.',
+    'shapefile.dbfFailed': 'The attribute table (.dbf) could not be read:',
+    'shapefile.reprojectFailed': 'Reprojection failed — coordinates are shown in the native projection.',
+    'avro.title': 'Apache Avro', 'bag.title': 'ROS bag', 'stp.title': 'STEP model',
+    'db3.title': 'SQLite database', 'reqif.title': 'Requirements Interchange Format',
+    'automotive.search': 'Search tables…', 'automotive.copyJson': 'Copy JSON',
+    'automotive.rawPreview': 'Raw Preview', 'automotive.noData': 'No data available.',
+    'automotive.rowsShown': '{shown} / {total} rows shown',
+    'mat.title': 'MATLAB MAT-file', 'mat.search': 'Search variables and metadata…',
+    'mat.copyJson': 'Copy JSON', 'mat.rawPreview': 'Raw preview',
+    'mat.noMatches': 'No rows match the current search.', 'mat.rowsShown': '{shown} / {total} rows shown',
+    'hdf5.title': 'HDF5', 'hdf5.search': 'Search tables…', 'hdf5.copyJson': 'Copy JSON',
+    'hdf5.structure': 'Structure', 'hdf5.noData': 'No data available.',
+    'hdf5.matchingRows': '{count} matching rows',
+    'hdf5.matchingRowsLimited': '{visible} / {total} matching rows shown',
+    'proto.title': 'Protocol Buffer', 'proto.summary': '{syntax} · {package} · {messages} messages · {services} services',
+    'proto.noPackage': 'no package', 'proto.search': 'Search message, field, enum, RPC', 'proto.copyPanel': 'Copy panel',
+    'proto.panel.tree': 'Message Tree', 'proto.panel.types': 'Types', 'proto.panel.relationships': 'Relationships',
+    'proto.panel.reverse': 'Who Uses This?', 'proto.panel.json': 'JSON Example', 'proto.panel.breaking': 'Breaking Changes',
+    'proto.panel.imports': 'Imports', 'proto.panel.grpc': 'gRPC', 'proto.panel.docs': 'Docs',
+    'proto.kind.message': 'message', 'proto.kind.enum': 'enum', 'proto.kind.service': 'service', 'proto.kind.field': 'field',
+    'proto.kind.repeated': 'repeated', 'proto.kind.oneof': 'oneof', 'proto.kind.value': 'value', 'proto.kind.rpc': 'rpc',
+    'proto.kind.stream': 'stream', 'proto.kind.import': 'import',
+    'proto.reverseRow': '{from} uses {to} via {name}', 'proto.noReferences': 'No references found for {name}.',
+    'proto.noMessages': 'No messages found.', 'proto.noDocumentation': 'No documentation comment.',
+    'proto.noDeclarations': 'No declarations found.', 'proto.breaking.placeholder': 'Paste previous .proto content here',
+    'proto.breaking.compare': 'Compare', 'proto.breaking.breaking': 'breaking',
+    'proto.breaking.none': 'No breaking changes detected by structural comparison.',
+    'proto.breaking.messageRemoved': 'Message removed: {name}.',
+    'proto.breaking.fieldRemoved': 'Field removed: {message}.{field} (number {number}).',
+    'proto.breaking.fieldChanged': 'Field number {number} changed name or type in {message}.',
+    'parquet.title': 'Parquet', 'parquet.search': 'Search rows…', 'parquet.raw': 'Raw', 'parquet.table': 'Table', 'parquet.copyJson': 'Copy JSON', 'parquet.exportJson': 'Export JSON', 'parquet.loadMore': 'Load Next {count} Rows', 'parquet.loading': 'Loading…', 'parquet.loadFailed': 'Could not load more rows: {message}', 'parquet.rows': 'rows', 'parquet.columns': 'columns', 'parquet.limited': 'Large file preview: {loaded} / {total} rows loaded.', 'parquet.copyCell': 'Copy cell value', 'parquet.copyRow': 'Copy row as JSON', 'parquet.copyColumn': 'Copy column values', 'parquet.autoFit': 'Auto fit column', 'parquet.resize': 'Drag to resize · double-click to auto fit', 'parquet.copyTable': 'Copy table', 'parquet.copied': 'Copied to clipboard',
+    'word.title': 'Word document', 'word.zoomIn': 'Zoom in', 'word.zoomOut': 'Zoom out',
+    'word.reset': 'Reset', 'word.print': 'Print', 'word.printUnavailable': 'Printing is not available on this platform.',
+    'word.empty': 'This document has no readable text.',
+    'diag.word.invalid-format': 'This file could not be read as a Word document.',
+    'diag.word.missing-dependency': 'DOCX rendering is not installed on this platform.',
+    'diag.word.limit-exceeded': 'This Word document exceeds the 50 MB limit.',
+    'diag.word.decompression-limit': 'This Word document declares more uncompressed data than can be safely opened.',
+    'diag.word.legacy-partial': 'Some legacy Word formatting could not be displayed.',
+    'diag.word.embedded-partial': 'Some embedded Word objects could not be displayed.', 'word.image': 'Embedded image',
+    'hwp.title': 'HWP document', 'hwp.zoomIn': 'Zoom in', 'hwp.zoomOut': 'Zoom out',
+    'hwp.reset': 'Reset', 'hwp.pages': '{count} pages', 'hwp.pageLabel': 'Page {page}', 'hwp.empty': 'This document has no pages.', 'hwp.loadMorePages': 'Load next pages', 'hwp.loading': 'Loading HWP/HWPX with rhwp…',
+    'diag.hwp.missing-dependency': 'HWP rendering is not installed on this platform.',
+    'diag.hwp.invalid-format': 'This file could not be read as an HWP document.',
+    'diag.hwp.corrupted': 'This HWP document is damaged or contains invalid page data.',
+    'diag.hwp.limit-exceeded': 'This HWP document exceeds the 50 MB limit.',
+    'diag.hwp.page-limit': 'Large document preview: rendered the first {rendered} of {total} pages.',
+    'ppt.title': 'PowerPoint', 'ppt.previous': 'Previous slide', 'ppt.next': 'Next slide',
+    'ppt.jump': 'Go to slide', 'ppt.mode.single': 'Single slide', 'ppt.mode.continuous': 'Continuous',
+    'ppt.empty': 'This presentation contains no slides.',
+    'diag.ppt.invalid-format': 'This file could not be read as a PowerPoint presentation.',
+    'diag.ppt.empty': 'This presentation contains no renderable slides.',
+    'diag.ppt.pdf-missing-dependency': 'PDF fallback requires PDF.js on this platform.',
+    'diag.ppt.limit-exceeded': 'Only part of this presentation could be loaded.',
+    'markdown.title': 'Markdown', 'markdown.preview': 'Preview', 'markdown.split': 'Split', 'markdown.source': 'Source',
+    'markdown.render': 'Render', 'markdown.copyHtml': 'Copy HTML', 'markdown.copySource': 'Copy Source',
+    'markdown.undo': 'Undo', 'markdown.redo': 'Redo', 'markdown.ready': 'Ready',
+    'markdown.rendering': 'Rendering', 'markdown.rendered': 'Rendered', 'markdown.renderFailed': 'Render failed',
+    'markdown.invalid': 'Invalid', 'markdown.modified': 'Modified', 'markdown.editable': 'Editable',
+    'markdown.edited': 'Edited', 'markdown.htmlCopied': 'HTML copied', 'markdown.sourceCopied': 'Source copied',
+    'markdown.summary': '{lines} lines, {words} words', 'markdown.renderedDiagrams': 'Rendered · {count} diagram(s)',
+    'markdown.diagramFailed': 'Unable to render diagram.', 'markdown.toc': 'Contents',
+    'markdown.copyCode': 'Copy code', 'markdown.assetUnavailable': 'Image unavailable',
+    'diag.markdown.limit-exceeded': 'The Markdown document exceeds a supported limit.',
+    'archive.title': 'Archive', 'archive.search': 'Search entries', 'archive.entries': '{count} entries',
+    'archive.previewUnavailable': 'Preview unavailable', 'archive.mediaUnsupported': 'Media preview is unsupported.',
+    'archive.encrypted': 'This archive is encrypted.', 'diag.archive.invalid-format': 'This file could not be read as an archive.',
+    'diag.archive.limit-exceeded': 'The archive exceeds a supported limit.',
+    'archive.preview': 'Archive Preview', 'archive.summary': 'Browsing the archive structure in read-only preview mode.',
+    'archive.filter': 'Filter', 'archive.path': 'Path', 'archive.type': 'Type',
+    'archive.compressedSize': 'Compressed Size', 'archive.originalSize': 'Original Size', 'archive.modified': 'Modified',
+    'archive.files': 'Files', 'archive.directories': 'Directories', 'archive.visible': 'Visible',
+    'archive.file': 'FILE', 'archive.directory': 'DIR', 'archive.noMatches': 'No matching entries found.',
+    'archive.entryPreview': 'Entry Preview', 'archive.chooseFile': 'Choose a file', 'archive.idle': 'Idle',
+    'archive.selectHint': 'Select an archive entry to inspect its content here.', 'archive.noSelection': 'No file selected.',
+    'archive.loading': 'Loading', 'archive.loadingHint': 'Fetching file content from the archive for a quick preview.',
+    'archive.loadingContent': 'Loading preview…', 'archive.ready': 'Ready',
+    'archive.textReady': 'Rendered as plain text from the selected archive entry.',
+    'archive.binaryReady': 'Rendered as a hexadecimal preview from the selected archive entry.',
+    'archive.androidBinaryXmlReady': 'Decoded from Android binary XML.',
+    'archive.directoryHint': 'Directory entries do not have inline file content.',
+    'archive.directoryContent': 'This entry contains child items rather than file content.',
+    'archive.saveEntry': 'Save entry', 'archive.savingEntry': 'Saving entry…',
+    'archive.saveFailed': 'The selected entry could not be saved.',
+    'diag.toml.invalid-table': 'Invalid TOML table declaration.',
+    'diag.toml.invalid-assignment': 'Expected a TOML key/value assignment.',
+    'diag.toml.invalid-key': 'Invalid TOML key.',
+    'diag.toml.invalid-inline-table': 'Invalid TOML inline table entry.',
+    'diag.toml.duplicate-key': 'Duplicate TOML key.',
+    'diag.toml.max-depth': 'TOML nesting is too deep.',
+    'diag.toml.node-limit': 'The TOML node limit was reached.',
+    'diag.toml.table-limit': 'The TOML table limit was reached.',
+    'diag.toml.array-limit': 'The TOML array limit was reached.',
+    'diag.toml.duplicate-table': 'Duplicate TOML table.',
+    'diag.toml.unclosed-value': 'A TOML value was not closed.',
+    'diag.jsonl.invalid-line': 'Line {line} is not valid JSON.',
+    'diag.jsonl.line-limit': 'Line {line} exceeds the JSONL line limit.',
+    'diag.yaml.missing-dependency': 'YAML parsing is not installed on this platform.',
+    'diag.yaml.invalid': 'This file could not be parsed as YAML.',
+    'diag.yaml.document-limit': 'Only the first {count} YAML documents were parsed.',
+    'diag.yaml.node-limit': 'The YAML node limit was reached.',
+    'diag.yaml.depth-limit': 'The YAML nesting depth limit was reached.',
+    'diag.yaml.alias-limit': 'The YAML alias limit was reached.',
+    'structured.tree': 'Tree', 'structured.flat': 'Flat', 'structured.json': 'JSON', 'structured.raw': 'Raw', 'structured.expandAll': 'Expand all',
+    'structured.collapseAll': 'Collapse all', 'structured.expand': 'Expand', 'structured.collapse': 'Collapse',
+    'structured.search': 'Search', 'structured.copy': 'Copy', 'structured.copyPath': 'Path',
+    'structured.copyValue': 'Value', 'structured.copyJson': 'JSON',
+    'structured.source': 'Source', 'structured.sourceDescription': 'Editable original text',
+    'structured.treeDescription': 'Structured preview',
+    'toml.treeView': 'TOML', 'yaml.treeView': 'YAML', 'jsonl.title': 'JSON Lines',
+    'jsonl.loadMore': 'Load more', 'jsonl.loadAll': 'Load all', 'jsonl.save': 'Save',
+    'jsonl.editUnavailable': 'Editing requires the complete file.', 'diag.jsonl.load-failed': 'Could not load more JSON Lines data.',
+    'jsonl.add': 'Add line', 'jsonl.delete': 'Delete selected', 'jsonl.edit': 'Edit', 'jsonl.apply': 'Apply',
+    'jsonl.cancel': 'Cancel', 'jsonl.preview': 'Search and selection apply only to the loaded preview.',
+    'jsonl.showMore': 'Show 5,000 more lines', 'jsonl.invalidSave': 'Fix invalid edited lines before saving.',
+    'jsonl.rowValid': 'Line {line}, valid JSON', 'jsonl.rowInvalid': 'Line {line}, invalid JSON',
+    // Generic diagnostics
+    'diag.limit-exceeded.rows': 'Only the first {count} rows were parsed (row limit reached).',
+    'diag.limit-exceeded.input': 'The file exceeds the maximum supported size ({maxBytes} bytes).',
+    'diag.limit-exceeded.decompressed': 'The archive declares more uncompressed data than the supported limit ({maxBytes} bytes).',
+    'diag.aborted': 'Parsing was cancelled.',
+    'diag.csv.ragged-rows': '{count} row(s) had a different number of columns and were padded or truncated.',
+    // JSON parser diagnostics (docs/parsers/json.md)
+    'diag.limit-exceeded.nodes': 'Only the first {count} nodes were parsed (node limit reached).',
+    'diag.json.invalid': 'This file could not be parsed as JSON.',
+    'diag.json.invalid-token': 'Unexpected character in JSON; parsing stopped here.',
+    'diag.json.unexpected-eof': 'The JSON ended unexpectedly.',
+    'diag.json.unterminated-string': 'A string was not closed before the end of the input.',
+    'diag.json.duplicate-key': 'Duplicate key "{key}"; both entries are kept.',
+    'diag.json.trailing-content': 'Extra content after the JSON value was ignored.',
+    'diag.json.max-depth': 'Nesting is too deep; parsing stopped at the depth limit.',
+    'diag.json.invalid-escape': 'Invalid escape sequence in a string.',
+    'diag.json.invalid-unicode-escape': 'Invalid \\u escape; four hex digits are required.',
+    'diag.json.control-char': 'Unescaped control character in a string.',
+    // Excel parser diagnostics (docs/viewers/excel.md)
+    'diag.limit-exceeded.cells': 'Only the first {count} cells were parsed (cell limit reached).',
+    'diag.excel.invalid-format': 'This file could not be read as a spreadsheet.',
+    'diag.excel.password-required': 'This spreadsheet is password-protected.',
+    'diag.excel.empty-workbook': 'The workbook has no data.',
+    'diag.excel.missing-dependency': 'The spreadsheet engine could not be loaded on this platform.',
+    // Common viewer chrome
+    'common.rows': '{count} rows',
+    'common.columns': '{count} columns',
+    'common.page': 'Page {page} / {pages}',
+    'common.prevPage': 'Previous page',
+    'common.nextPage': 'Next page',
+    'common.rowsMatched': '{matched} / {total} rows match',
+    'common.copied': 'Copied to clipboard',
+    'common.noClipboard': 'Copy is unavailable on this platform',
+    'common.copyTooLarge': 'Too large to copy to the clipboard ({size} bytes). Use file export instead.',
+    'common.noFileSave': 'Saving files is unavailable on this platform',
+    'common.saved': 'Saved {name}',
+    'common.savedToOriginal': 'Saved',
+    'common.saveFailed': 'Save failed',
+    'common.unsaved': 'Unsaved changes',
+    'common.noWriteback': 'Saving to the original file is unavailable here — use Export file.',
+    // CSV viewer
+    'csv.delimiter': 'Delimiter',
+    'csv.delimiter.auto': 'Auto detect',
+    'csv.delimiter.comma': 'Comma (,)',
+    'csv.delimiter.semicolon': 'Semicolon (;)',
+    'csv.delimiter.tab': 'Tab',
+    'csv.delimiter.pipe': 'Pipe (|)',
+    'csv.copyTsv': 'Copy as TSV',
+    'csv.copyJson': 'Copy as JSON',
+    'csv.exportFile': 'Export',
+    'csv.exportFile.hint': 'Save the current search and sorted results as a new file',
+    'csv.editUnavailable': 'Editing requires a fully parsed file',
+    'csv.addRow': 'Add row',
+    'csv.addColumn': 'Add column',
+    'csv.insertRowBelow': 'Insert row below',
+    'csv.deleteRow': 'Delete row',
+    'csv.insertColumnLeft': 'Insert column left',
+    'csv.insertColumnRight': 'Insert column right',
+    'csv.deleteColumn': 'Delete column',
+    'csv.undo': 'Undo',
+    'csv.redo': 'Redo',
+    'csv.save': 'Save',
+    'csv.saveAs': 'Save as',
+    'csv.statistics': 'Statistics',
+    'csv.rawView': 'Raw',
+    'csv.tableView': 'Table',
+    'csv.sort.hint': 'Click to sort',
+    'csv.header.hint': 'Click to sort · double-click to rename',
+    'csv.resizeColumn': 'Drag to resize · double-click to reset',
+    'csv.search': 'Search',
+    'csv.noMatches': 'No matching rows in the loaded range.',
+    'csv.rowNumbers': 'Row numbers',
+    'csv.pageSize': 'Rows per page',
+    'csv.stats.compact.count': 'n={count}',
+    'csv.stats.compact.nulls': 'null {percent}',
+    'csv.stats.compact.numeric': 'μ{mean} · {min}~{max}',
+    'csv.stats.count': 'Count',
+    'csv.stats.nulls': 'Nulls',
+    'csv.stats.mean': 'Mean',
+    'csv.stats.min': 'Min',
+    'csv.stats.max': 'Max',
+    'csv.empty': 'This file has no rows.',
+    // Excel viewer
+    'excel.tableView': 'Spreadsheet',
+    'excel.sheet': 'Sheet',
+    'excel.search': 'Search in sheet…',
+    'excel.viewMode': 'View',
+    'excel.tableViewLabel': 'Table',
+    'excel.gridView': 'Grid',
+    'excel.rawView': 'Raw',
+    'excel.gridTruncated': 'Large sheet — showing the first {count} rows only.',
+    'excel.tableViewToggle': 'Table view',
+    'excel.copyTsv': 'Copy as TSV',
+    'excel.copyJson': 'Copy as JSON',
+    'excel.export': 'Export XLSX',
+    'excel.matchedCells': '{count} matched cells',
+    'excel.sortHint': 'Click to sort · double-click to rename',
+    'excel.resizeColumn': 'Drag to resize · double-click to reset',
+    'excel.editHint': 'Double-click to edit',
+    'excel.editUnavailable': 'Editing requires a fully parsed spreadsheet.',
+    'excel.undo': 'Undo',
+    'excel.redo': 'Redo',
+    'excel.insertRowBelow': 'Insert row below',
+    'excel.deleteRow': 'Delete row',
+    'excel.empty': 'This sheet has no cells.',
+    // JSON viewer
+    'json.treeView': 'JSON',
+    'json.view.tree': 'Tree',
+    'json.view.source': 'Source',
+    'json.save': 'Save',
+    'json.saveAs': 'Save as',
+    'json.editor.title': 'Editor',
+    'json.editor.description': 'Edit source text and apply actions',
+    'json.preview.title': 'Preview',
+    'json.preview.description': 'Syntax highlighted JSON',
+    'json.form.verbatim': 'Original',
+    'json.form.pretty': 'Pretty',
+    'json.form.minified': 'Minified',
+    'json.expandAll': 'Expand all',
+    'json.collapseAll': 'Collapse all',
+    'json.expandNode': 'Expand',
+    'json.collapseNode': 'Collapse',
+    'json.search': 'Search',
+    'json.matchInfo': '{current} / {total}',
+    'json.noMatches': 'No matches',
+    'json.prevMatch': 'Previous match',
+    'json.nextMatch': 'Next match',
+    'json.copyPath': 'Path',
+    'json.copyValue': 'Value',
+    'json.stats': '{total} nodes · depth {depth}',
+    'json.empty': 'Empty',
+    // Toolbox button labels
+    'json.tool.format': 'Format',
+    'json.tool.minify': 'Minify',
+    'json.tool.sort': 'Sort keys',
+    'json.tool.validate': 'Validate',
+    'json.tool.escape': 'Escape',
+    'json.tool.unescape': 'Unescape',
+    'json.tool.base64Encode': 'Base64 →',
+    'json.tool.base64Decode': 'Base64 ←',
+    'json.tool.toCsv': '→ CSV',
+    'json.tool.toXml': '→ XML',
+    'json.tool.toYaml': '→ YAML',
+    // Toolbox result messages
+    'json.tool.formatted': 'Formatted',
+    'json.tool.minified': 'Minified',
+    'json.tool.sorted': 'Keys sorted',
+    'json.tool.escaped': 'Escaped',
+    'json.tool.unescaped': 'Unescaped',
+    'json.tool.base64Encoded': 'Base64 encoded',
+    'json.tool.base64Decoded': 'Base64 decoded',
+    'json.tool.valid': 'Valid JSON: {summary}',
+    'json.tool.invalid': 'Invalid JSON',
+    'json.tool.applied': 'Applied to editor',
+    'json.tool.failed': 'Operation failed',
+    'json.tool.unescapeFailed': 'Could not unescape the text',
+    'json.tool.base64Failed': 'The text is not valid Base64',
+    'json.tool.csvRequiresObjects': 'CSV needs an object or an array of objects',
+    'json.tool.csvOutput': 'CSV output',
+    'json.tool.xmlOutput': 'XML output',
+    'json.tool.yamlOutput': 'YAML output',
+    'json.result.copy': 'Copy',
+    'json.result.replace': 'Replace editor',
+    'json.result.close': 'Close',
+    // PDF viewer
+    'pdf.title': 'PDF',
+    'pdf.loading': 'Loading PDF…',
+    'pdf.loadFailed': 'Unable to load this PDF.',
+    'pdf.pages': 'pages',
+    'pdf.goToPage': 'Go to page',
+    'pdf.zoomIn': 'Zoom in',
+    'pdf.zoomOut': 'Zoom out',
+    'pdf.viewOptions': 'View options',
+    'pdf.fitWidth': 'Fit to width',
+    'pdf.fitHeight': 'Fit to height',
+    'pdf.singlePage': 'Single page',
+    'pdf.twoPagesOdd': 'Two pages (odd pages left)',
+    'pdf.twoPagesEven': 'Two pages (even pages left)',
+    'pdf.matchTheme': 'Match theme colors',
+    'pdf.resetPages': 'Reset pages',
+    'pdf.annotationText': 'Add text',
+    'pdf.annotationSize': 'Text size',
+    'pdf.annotationColor': 'Text color',
+    'pdf.save': 'Save',
+    'pdf.saveAs': 'Save as',
+    'pdf.merge': 'Merge PDF',
+    'pdf.merging': 'Merging PDF…',
+    'pdf.mergeComplete': 'PDF merged. Save or Save as to keep the changes.',
+    'pdf.mergeFailed': 'Unable to merge this PDF.',
+    'pdf.signature': 'Signature',
+    'pdf.signatureColor': 'Signature color',
+    'pdf.signatureClear': 'Clear',
+    'pdf.signatureUse': 'Use signature',
+    'pdf.signaturePlace': 'Click a page to place the signature.',
+    'pdf.highlight': 'Highlight',
+    'pdf.highlightColor': 'Highlight color',
+    'pdf.highlightSelect': 'Select text to highlight it.',
+    'pdf.markupOptions': 'Text markup options',
+    'pdf.underline': 'Underline',
+    'pdf.underlineColor': 'Underline color',
+    'pdf.strikeout': 'Strikethrough',
+    'pdf.strikeoutColor': 'Strikethrough color',
+    'pdf.cancel': 'Cancel',
+    'pdf.textPlace': 'Click a page to place the text.',
+    'pdf.deletePage': 'Delete page',
+    'pdf.deleteAnnotation': 'Delete annotation',
+    'pdf.password': 'Password',
+    'pdf.passwordRequired': 'This PDF requires a password.',
+    'pdf.passwordIncorrect': 'Incorrect password. Try again.',
+    'pdf.passwordSubmit': 'Open',
+    'pdf.editingUnavailable': 'PDF editing is unavailable on this platform',
+    'pdf.noFilePick': 'Choosing a file to merge is unavailable on this platform',
+    // Image viewer (docs/viewers/image.md)
+    'image.title': 'Image',
+    'image.loading': 'Loading image…',
+    'image.loadFailed': 'Unable to display this image.',
+    'image.status': 'Zoom {zoom}%, rotation {rotation} degrees',
+    // Toolbar
+    'image.zoomIn': 'Zoom in',
+    'image.zoomOut': 'Zoom out',
+    'image.fit': 'Fit',
+    'image.rotate': 'Rotate 90°',
+    'image.flipH': 'Flip horizontal',
+    'image.flipV': 'Flip vertical',
+    'image.grid': 'Grid',
+    'image.reset': 'Reset',
+    'image.filter': 'Filter',
+    'image.preset.original': 'Original',
+    'image.preset.bright': 'Bright',
+    'image.preset.dark': 'Dark',
+    'image.preset.vintage': 'Vintage',
+    'image.preset.bw': 'B&W',
+    // Diagnostics
+    'diag.image.invalid-format': 'This file could not be decoded as an image.',
+    'diag.image.corrupted': 'The image data is damaged and could not be fully decoded.',
+    'diag.image.animated-first-frame': 'Animated image — showing the first frame only.',
+    'diag.image.svg-external-blocked': 'External references in this SVG were blocked for safety.',
+    'diag.image.limit-exceeded.pixels': 'The image is too large; showing a downscaled preview.',
+    'diag.image.limit-exceeded.canvas': 'The image is too large to edit or export on this platform.',
+    // Optional service tools (image.md I8)
+    'image.tool.removeBackground': 'Remove background',
+    'image.tool.removeBackground.unavailable': 'Background removal is unavailable on this platform',
+    'image.bgRemoval.working': 'Removing background…',
+    'image.bgRemoval.failed': 'Background removal failed.',
+    'image.tool.detectSprites': 'Detect sprites',
+    'image.tool.detectSprites.unavailable': 'Sprite detection is unavailable on this platform',
+    'image.spriteDetection.working': 'Detecting sprites…',
+    'image.spriteDetection.failed': 'Sprite detection failed.',
+    'image.saveAsPng': 'Save as PNG',
+    'image.saveAsPng.note': 'The edited image is saved as PNG (.png).',
+    // Fallback viewer
+    'fallback.title.text': 'Text preview',
+    'fallback.title.hex': 'Hex preview',
+    'fallback.truncated': 'Preview truncated to the first {bytes} bytes.',
+    'fallback.reason.missing-dependency': 'The full viewer could not be loaded on this platform.',
+    'fallback.reason.unsupported': 'No viewer is available for this file type.'
+};

package/dist/i18n/catalog.ko.d.ts

@@ -0,0 +1 @@
+export declare const CATALOG_KO: Record<string, string>;

package/dist/i18n/catalog.ko.js

@@ -0,0 +1,68 @@
+// Korean messages owned by core. Missing keys intentionally fall back to the
+// English source catalog in i18n/index.ts.
+export const CATALOG_KO = {
+    'audio.title': '오디오', 'video.title': '비디오', 'dbc.title': 'CAN 데이터베이스',
+    'audio.play': '재생', 'audio.pause': '일시정지', 'audio.stop': '정지',
+    'audio.loop': '반복', 'audio.clearRegions': '구간 지우기', 'audio.volume': '음량',
+    'audio.zoom': '확대/축소', 'audio.zoomIn': '확대', 'audio.zoomOut': '축소', 'audio.zoomFit': '맞춤',
+    'audio.visualization': '보기', 'audio.vis.waveform': '파형', 'audio.vis.spectrogram': '스펙트로그램',
+    'audio.info.duration': '재생 시간', 'audio.info.sampleRate': '샘플레이트', 'audio.info.channels': '채널',
+    'audio.info.bitDepth': '비트 깊이', 'audio.info.format': '형식', 'audio.info.fileSize': '파일 크기',
+    'audio.loading': '오디오 디코딩 중…',
+    'audio.status.region': '구간 {start} – {end} ({duration}초)',
+    'audio.status.looping': '구간 반복 중', 'audio.status.loopTrack': '전체 반복 중',
+    'audio.fallback': '파형 엔진을 사용할 수 없어 기본 플레이어로 표시합니다.',
+    'audio.error.decode': '브라우저가 이 오디오 코덱을 디코딩할 수 없습니다. 코덱을 지원하는 호스트를 사용하거나 파일을 변환해 주세요.',
+    'video.play': '재생', 'video.pause': '일시정지', 'video.stop': '정지',
+    'video.skipBack': '⏪ -{seconds}초', 'video.skipForward': '⏩ +{seconds}초',
+    'video.speed': '배속', 'video.zoom': '확대/축소', 'video.zoomIn': '확대',
+    'video.zoomOut': '축소', 'video.zoomFit': '맞춤',
+    'video.info.duration': '재생 시간', 'video.info.resolution': '해상도',
+    'video.info.format': '형식', 'video.info.fileSize': '파일 크기',
+    'video.error.empty': '미디어 파일이 비어 있습니다.',
+    'video.error.tooLarge': '파일이 브라우저 미리보기 한도({limit})를 초과합니다.',
+    'video.error.source': '이 환경에서는 브라우저 미디어 소스를 만들 수 없습니다.',
+    'video.error.decode': '브라우저가 이 비디오 코덱을 디코딩할 수 없습니다. 코덱을 지원하는 호스트를 사용하거나 파일을 변환해 주세요.',
+    'arxml.title': 'AUTOSAR XML', 'a2l.title': 'ASAM A2L', 'asc.title': 'Vector ASC 로그',
+    'blf.title': 'Vector BLF 로그', 'mf4.title': 'ASAM MDF 4', 'pcap.title': 'PCAP 캡처',
+    'pcapng.title': 'PCAPNG 캡처', 'mermaid.title': 'Mermaid 다이어그램',
+    'plantuml.title': 'PlantUML 다이어그램', 'shapefile.title': 'ESRI Shapefile', 'psd.title': 'Photoshop 문서',
+    'shapefile.zoomIn': '확대', 'shapefile.zoomOut': '축소', 'shapefile.reset': '보기 초기화',
+    'shapefile.projection': '좌표계: {name}', 'shapefile.attributes': '피처 속성',
+    'shapefile.featureLabel': '피처 {id}',
+    'shapefile.noSelection': '지도에서 피처를 클릭하면 속성을 확인할 수 있습니다.',
+    'shapefile.noAttributes': '이 shapefile에는 속성 테이블(.dbf)이 제공되지 않았습니다.',
+    'shapefile.noRecord': '이 피처와 일치하는 속성 레코드가 없습니다.',
+    'shapefile.dbfFailed': '속성 테이블(.dbf)을 읽을 수 없습니다:',
+    'shapefile.reprojectFailed': '재투영에 실패하여 원본 좌표계로 표시합니다.',
+    'avro.title': 'Apache Avro',
+    'bag.title': 'ROS bag',
+    'stp.title': 'STEP 모델',
+    'db3.title': 'SQLite 데이터베이스',
+    'reqif.title': '요구사항 교환 형식',
+    'automotive.search': '표 검색…',
+    'automotive.copyJson': 'JSON 복사',
+    'automotive.rawPreview': '원문 미리보기',
+    'automotive.noData': '표시할 데이터가 없습니다.',
+    'automotive.rowsShown': '전체 {total}행 중 {shown}행 표시',
+    'mat.title': 'MATLAB MAT 파일',
+    'mat.search': '변수와 메타데이터 검색…',
+    'mat.copyJson': 'JSON 복사',
+    'mat.rawPreview': '원시 미리보기',
+    'mat.noMatches': '검색 조건과 일치하는 행이 없습니다.',
+    'mat.rowsShown': '전체 {total}행 중 {shown}행 표시',
+    'hwp.title': '한글 문서',
+    'hwp.zoomIn': '확대',
+    'hwp.zoomOut': '축소',
+    'hwp.reset': '초기화',
+    'hwp.pages': '{count}페이지',
+    'hwp.pageLabel': '{page}페이지',
+    'hwp.empty': '표시할 페이지가 없습니다.',
+    'hwp.loadMorePages': '다음 페이지 불러오기',
+    'hwp.loading': 'rhwp로 HWP/HWPX 파일을 불러오는 중…',
+    'diag.hwp.missing-dependency': '이 환경에 HWP 렌더러가 설치되어 있지 않습니다.',
+    'diag.hwp.invalid-format': 'HWP 문서를 읽을 수 없습니다.',
+    'diag.hwp.corrupted': 'HWP 문서가 손상되었거나 페이지 데이터가 올바르지 않습니다.',
+    'diag.hwp.limit-exceeded': '50MB를 초과하는 HWP 문서는 열 수 없습니다.',
+    'diag.hwp.page-limit': '전체 {total}페이지 중 {rendered}페이지를 불러왔습니다.'
+};