omni-viewer-core 0.5.0 → 0.6.0

package/README.md

@@ -15,7 +15,7 @@ models, viewers mount into a DOM element, and everything host-specific
 - **Documents** — PDF, Word (DOCX and legacy DOC), HWP, PowerPoint (PPTX and
   legacy PPT), Markdown
 - **Data & spreadsheets** — Excel, CSV/TSV, JSON, JSONL/NDJSON, YAML, TOML,
-  Parquet, Avro, HDF5, MATLAB MAT, Protocol Buffers, ReqIF, SQLite
+  Parquet, Avro, HDF5, MATLAB MAT, Safetensors, Protocol Buffers, ReqIF, SQLite
 - **Media & graphics** — audio (waveform/spectrogram), video, images,
   Photoshop PSD
 - **Engineering & automotive** — CAN DBC, AUTOSAR ARXML, ASAM A2L, Vector

package/dist/i18n/catalog.en.js

@@ -50,6 +50,10 @@ export const CATALOG_EN = {
     'hdf5.structure': 'Structure', 'hdf5.noData': 'No data available.',
     'hdf5.matchingRows': '{count} matching rows',
     'hdf5.matchingRowsLimited': '{visible} / {total} matching rows shown',
+    'safetensors.title': 'Safetensors', 'safetensors.search': 'Search tensors…', 'safetensors.copyJson': 'Copy JSON',
+    'safetensors.structure': 'Structure', 'safetensors.noData': 'No data available.',
+    'safetensors.matchingRows': '{count} matching rows',
+    'safetensors.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',
@@ -149,6 +153,9 @@ export const CATALOG_EN = {
     'structured.copyValue': 'Value', 'structured.copyJson': 'JSON',
     'structured.source': 'Source', 'structured.sourceDescription': 'Editable original text',
     'structured.treeDescription': 'Structured preview',
+    'structured.scopeLabel': 'Search in', 'structured.scope.all': 'All', 'structured.scope.key': 'Key',
+    'structured.scope.path': 'Path', 'structured.scope.value': 'Value',
+    'structured.matchCount': '{count} matches', 'structured.keyCount': '{count} keys', 'structured.itemCount': '{count} items',
     '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.',
@@ -328,6 +335,7 @@ export const CATALOG_EN = {
     'pdf.goToPage': 'Go to page',
     'pdf.zoomIn': 'Zoom in',
     'pdf.zoomOut': 'Zoom out',
+    'pdf.thumbnails': 'Page thumbnails',
     'pdf.viewOptions': 'View options',
     'pdf.fitWidth': 'Fit to width',
     'pdf.fitHeight': 'Fit to height',
@@ -369,6 +377,11 @@ export const CATALOG_EN = {
     'pdf.textPlace': 'Click a page to place the text.',
     'pdf.deletePage': 'Delete page',
     'pdf.deleteAnnotation': 'Delete annotation',
+    'pdf.markupList': 'Annotations',
+    'pdf.closeMarkupList': 'Close annotations',
+    'pdf.changeColor': 'Change color',
+    'pdf.copyText': 'Copy text',
+    'pdf.noMarkups': 'No highlights, underlines, or strikethroughs yet.',
     'pdf.password': 'Password',
     'pdf.passwordRequired': 'This PDF requires a password.',
     'pdf.passwordIncorrect': 'Incorrect password. Try again.',

package/dist/i18n/catalog.ja.js

@@ -46,6 +46,10 @@ export const CATALOG_JA = {
     'hdf5.structure': '構造', 'hdf5.noData': '表示できるデータがありません。',
     'hdf5.matchingRows': '一致する行: {count}件',
     'hdf5.matchingRowsLimited': '一致する{total}行中{visible}行を表示',
+    'safetensors.title': 'Safetensors', 'safetensors.search': 'テンソルを検索…', 'safetensors.copyJson': 'JSONをコピー',
+    'safetensors.structure': '構造', 'safetensors.noData': '表示できるデータがありません。',
+    'safetensors.matchingRows': '一致する行: {count}件',
+    'safetensors.matchingRowsLimited': '一致する{total}行中{visible}行を表示',
     'proto.title': 'Protocol Buffer', 'proto.summary': '{syntax} · {package} · メッセージ{messages}件 · サービス{services}件',
     'proto.noPackage': 'パッケージなし', 'proto.search': 'メッセージ、フィールド、列挙型、RPCを検索', 'proto.copyPanel': 'パネルをコピー',
     'proto.panel.tree': 'メッセージツリー', 'proto.panel.types': '型', 'proto.panel.relationships': '関係',
@@ -153,6 +157,9 @@ export const CATALOG_JA = {
     'structured.copyValue': '値', 'structured.copyJson': 'JSON',
     'structured.source': 'ソース', 'structured.sourceDescription': '編集可能な元のテキスト',
     'structured.treeDescription': '構造化プレビュー',
+    'structured.scopeLabel': '検索対象', 'structured.scope.all': 'すべて', 'structured.scope.key': 'キー',
+    'structured.scope.path': 'パス', 'structured.scope.value': '値',
+    'structured.matchCount': '{count} 件一致', 'structured.keyCount': '{count} 個のキー', 'structured.itemCount': '{count} 個の項目',
     'toml.treeView': 'TOML', 'yaml.treeView': 'YAML', 'jsonl.title': 'JSON Lines',
     'jsonl.loadMore': 'さらに読み込む', 'jsonl.loadAll': 'すべて読み込む', 'jsonl.save': '保存',
     'jsonl.editUnavailable': '編集には完全なファイルが必要です。', 'diag.jsonl.load-failed': 'JSON Linesデータを追加で読み込めませんでした。',
@@ -243,6 +250,7 @@ export const CATALOG_JA = {
     'json.result.copy': 'コピー', 'json.result.replace': 'エディターを置換', 'json.result.close': '閉じる',
     'pdf.title': 'PDF', 'pdf.loading': 'PDFを読み込み中…', 'pdf.loadFailed': 'このPDFを読み込めません。',
     'pdf.pages': 'ページ', 'pdf.goToPage': 'ページへ移動', 'pdf.zoomIn': '拡大', 'pdf.zoomOut': '縮小',
+    'pdf.thumbnails': 'ページサムネイル',
     'pdf.viewOptions': '表示オプション', 'pdf.fitWidth': '幅に合わせる', 'pdf.fitHeight': '高さに合わせる',
     'pdf.singlePage': '単一ページ', 'pdf.twoPagesOdd': '見開き（奇数ページを左）',
     'pdf.twoPagesEven': '見開き（偶数ページを左）', 'pdf.matchTheme': 'テーマの色に合わせる',
@@ -265,7 +273,11 @@ export const CATALOG_JA = {
     'pdf.markupOptions': 'テキストマークアップのオプション', 'pdf.underline': '下線',
     'pdf.underlineColor': '下線の色', 'pdf.strikeout': '取り消し線', 'pdf.strikeoutColor': '取り消し線の色',
     'pdf.cancel': 'キャンセル', 'pdf.textPlace': 'ページをクリックしてテキストを配置してください。',
-    'pdf.deletePage': 'ページを削除', 'pdf.deleteAnnotation': '注釈を削除', 'pdf.password': 'パスワード',
+    'pdf.deletePage': 'ページを削除', 'pdf.deleteAnnotation': '注釈を削除',
+    'pdf.markupList': '注釈一覧', 'pdf.closeMarkupList': '注釈一覧を閉じる',
+    'pdf.changeColor': '色を変更', 'pdf.copyText': 'テキストをコピー',
+    'pdf.noMarkups': 'ハイライト・下線・取り消し線はまだありません。',
+    'pdf.password': 'パスワード',
     'pdf.passwordRequired': 'このPDFにはパスワードが必要です。',
     'pdf.passwordIncorrect': 'パスワードが正しくありません。もう一度お試しください。',
     'pdf.passwordSubmit': '開く', 'pdf.editingUnavailable': 'この環境ではPDFを編集できません',

package/dist/i18n/catalog.ko.js

@@ -48,6 +48,10 @@ export const CATALOG_KO = {
     'hdf5.structure': '구조', 'hdf5.noData': '표시할 데이터가 없습니다.',
     'hdf5.matchingRows': '일치하는 행 {count}개',
     'hdf5.matchingRowsLimited': '전체 {total}행 중 일치하는 {visible}행 표시',
+    'safetensors.title': 'Safetensors', 'safetensors.search': '텐서 검색…', 'safetensors.copyJson': 'JSON 복사',
+    'safetensors.structure': '구조', 'safetensors.noData': '표시할 데이터가 없습니다.',
+    'safetensors.matchingRows': '일치하는 행 {count}개',
+    'safetensors.matchingRowsLimited': '전체 {total}행 중 일치하는 {visible}행 표시',
     'proto.title': 'Protocol Buffer', 'proto.summary': '{syntax} · {package} · 메시지 {messages}개 · 서비스 {services}개',
     'proto.noPackage': '패키지 없음', 'proto.search': '메시지, 필드, enum, RPC 검색', 'proto.copyPanel': '패널 복사',
     'proto.panel.tree': '메시지 트리', 'proto.panel.types': '타입', 'proto.panel.relationships': '관계',
@@ -149,6 +153,9 @@ export const CATALOG_KO = {
     'structured.copyValue': '값', 'structured.copyJson': 'JSON',
     'structured.source': '소스', 'structured.sourceDescription': '편집 가능한 원본 텍스트',
     'structured.treeDescription': '구조화된 미리보기',
+    'structured.scopeLabel': '검색 범위', 'structured.scope.all': '전체', 'structured.scope.key': '키',
+    'structured.scope.path': '경로', 'structured.scope.value': '값',
+    'structured.matchCount': '{count}개 일치', 'structured.keyCount': '키 {count}개', 'structured.itemCount': '항목 {count}개',
     'toml.treeView': 'TOML', 'yaml.treeView': 'YAML', 'jsonl.title': 'JSON Lines',
     'jsonl.loadMore': '더 불러오기', 'jsonl.loadAll': '모두 불러오기', 'jsonl.save': '저장',
     'jsonl.editUnavailable': '편집하려면 전체 파일이 필요합니다.', 'diag.jsonl.load-failed': 'JSON Lines 데이터를 더 불러올 수 없습니다.',
@@ -328,6 +335,7 @@ export const CATALOG_KO = {
     'pdf.goToPage': '페이지 이동',
     'pdf.zoomIn': '확대',
     'pdf.zoomOut': '축소',
+    'pdf.thumbnails': '페이지 썸네일',
     'pdf.viewOptions': '보기 옵션',
     'pdf.fitWidth': '너비 맞춤',
     'pdf.fitHeight': '높이 맞춤',
@@ -369,6 +377,11 @@ export const CATALOG_KO = {
     'pdf.textPlace': '페이지를 클릭하여 텍스트를 배치하세요.',
     'pdf.deletePage': '페이지 삭제',
     'pdf.deleteAnnotation': '주석 삭제',
+    'pdf.markupList': '주석 목록',
+    'pdf.closeMarkupList': '주석 목록 닫기',
+    'pdf.changeColor': '색상 변경',
+    'pdf.copyText': '텍스트 복사',
+    'pdf.noMarkups': '아직 하이라이트, 밑줄, 취소선이 없습니다.',
     'pdf.password': '암호',
     'pdf.passwordRequired': '이 PDF에는 암호가 필요합니다.',
     'pdf.passwordIncorrect': '암호가 올바르지 않습니다. 다시 시도하세요.',

package/dist/i18n/catalog.zh-cn.js

@@ -40,6 +40,9 @@ export const CATALOG_ZH_CN = {
     'hdf5.title': 'HDF5', 'hdf5.search': '搜索表格…', 'hdf5.copyJson': '复制 JSON',
     'hdf5.structure': '结构', 'hdf5.noData': '没有可用数据。',
     'hdf5.matchingRows': '{count} 个匹配行', 'hdf5.matchingRowsLimited': '显示 {visible} / {total} 个匹配行',
+    'safetensors.title': 'Safetensors', 'safetensors.search': '搜索张量…', 'safetensors.copyJson': '复制 JSON',
+    'safetensors.structure': '结构', 'safetensors.noData': '没有可用数据。',
+    'safetensors.matchingRows': '{count} 个匹配行', 'safetensors.matchingRowsLimited': '显示 {visible} / {total} 个匹配行',
     'proto.title': 'Protocol Buffer', 'proto.summary': '{syntax} · {package} · {messages} 条消息 · {services} 个服务',
     'proto.noPackage': '无软件包', 'proto.search': '搜索消息、字段、枚举或 RPC', 'proto.copyPanel': '复制面板',
     'proto.panel.tree': '消息树', 'proto.panel.types': '类型', 'proto.panel.relationships': '关系',
@@ -141,6 +144,9 @@ export const CATALOG_ZH_CN = {
     'structured.copy': '复制', 'structured.copyPath': '路径', 'structured.copyValue': '值', 'structured.copyJson': 'JSON',
     'structured.source': '源代码', 'structured.sourceDescription': '可编辑的原始文本',
     'structured.treeDescription': '结构化预览',
+    'structured.scopeLabel': '搜索范围', 'structured.scope.all': '全部', 'structured.scope.key': '键',
+    'structured.scope.path': '路径', 'structured.scope.value': '值',
+    'structured.matchCount': '{count} 项匹配', 'structured.keyCount': '{count} 个键', 'structured.itemCount': '{count} 个项目',
     'toml.treeView': 'TOML', 'yaml.treeView': 'YAML', 'jsonl.title': 'JSON Lines',
     'jsonl.loadMore': '加载更多', 'jsonl.loadAll': '全部加载', 'jsonl.save': '保存',
     'jsonl.editUnavailable': '编辑需要完整文件。', 'diag.jsonl.load-failed': '无法加载更多 JSON Lines 数据。',
@@ -227,6 +233,7 @@ export const CATALOG_ZH_CN = {
     'json.result.copy': '复制', 'json.result.replace': '替换编辑器内容', 'json.result.close': '关闭',
     'pdf.title': 'PDF', 'pdf.loading': '正在加载 PDF…', 'pdf.loadFailed': '无法加载此 PDF。',
     'pdf.pages': '页', 'pdf.goToPage': '转到页面', 'pdf.zoomIn': '放大', 'pdf.zoomOut': '缩小',
+    'pdf.thumbnails': '页面缩略图',
     'pdf.viewOptions': '视图选项', 'pdf.fitWidth': '适合宽度', 'pdf.fitHeight': '适合高度',
     'pdf.singlePage': '单页', 'pdf.twoPagesOdd': '双页（奇数页在左）', 'pdf.twoPagesEven': '双页（偶数页在左）',
     'pdf.matchTheme': '匹配主题颜色', 'pdf.resetPages': '重置页面',
@@ -245,6 +252,9 @@ export const CATALOG_ZH_CN = {
     'pdf.markupOptions': '文本标记选项', 'pdf.underline': '下划线', 'pdf.underlineColor': '下划线颜色',
     'pdf.strikeout': '删除线', 'pdf.strikeoutColor': '删除线颜色', 'pdf.cancel': '取消',
     'pdf.textPlace': '点击页面以放置文本。', 'pdf.deletePage': '删除页面', 'pdf.deleteAnnotation': '删除批注',
+    'pdf.markupList': '批注列表', 'pdf.closeMarkupList': '关闭批注列表',
+    'pdf.changeColor': '更改颜色', 'pdf.copyText': '复制文本',
+    'pdf.noMarkups': '尚无高亮、下划线或删除线。',
     'pdf.password': '密码', 'pdf.passwordRequired': '此 PDF 需要密码。',
     'pdf.passwordIncorrect': '密码错误，请重试。', 'pdf.passwordSubmit': '打开',
     'pdf.editingUnavailable': '此平台无法编辑 PDF', 'pdf.noFilePick': '此平台无法选择要合并的文件',

package/dist/parsers/safetensors/index.d.ts

@@ -0,0 +1,34 @@
+export interface SafetensorsSummaryItem {
+    label: string;
+    value: string | number;
+}
+export interface SafetensorsTable {
+    title: string;
+    headers: string[];
+    rows: Array<Array<string | number>>;
+}
+export interface SafetensorsDocument {
+    format: 'safetensors';
+    title: string;
+    fileSize: string;
+    summary: SafetensorsSummaryItem[];
+    tables: SafetensorsTable[];
+    rawPreview?: string | undefined;
+    warnings: string[];
+}
+/** One tensor as declared in the safetensors header. */
+export interface SafetensorsTensor {
+    name: string;
+    dtype: string;
+    shape: number[];
+    /** [begin, end) byte range inside the tensor data buffer. */
+    dataOffsets: [number, number];
+    /** Product of `shape` (1 for a scalar / empty shape). */
+    elements: number;
+    /** `end - begin`, the bytes the tensor occupies. */
+    byteLength: number;
+}
+export declare function parseSafetensors(input: Uint8Array, fileSize?: string): SafetensorsDocument;
+/** Compact parameter counts, e.g. 1.20B, 350.0M, 12.3K. */
+export declare function formatCount(count: number): string;
+export declare function formatFileSize(bytes: number): string;

package/dist/parsers/safetensors/index.js

@@ -0,0 +1,233 @@
+/**
+ * Minimal safetensors (.safetensors) header reader.
+ *
+ * The format is a fixed 8-byte little-endian header length, followed by a UTF-8
+ * JSON header (tensor name → {dtype, shape, data_offsets}, plus an optional
+ * "__metadata__" string map), followed by the raw tensor buffer. Only the header
+ * is decoded here — the tensor payloads are never read, so inspecting a
+ * multi-gigabyte checkpoint stays cheap.
+ *
+ * Reference: https://github.com/huggingface/safetensors
+ */
+const HEADER_LENGTH_BYTES = 8;
+// A safetensors header is JSON metadata only; real files stay well under this.
+// The cap guards against a corrupt length field claiming gigabytes of "header".
+const MAX_HEADER_BYTES = 100_000_000;
+const METADATA_KEY = '__metadata__';
+/** Bits per element for the dtypes supported by safetensors 0.8. */
+const DTYPE_BITS = {
+    F64: 64, C64: 64, I64: 64, U64: 64,
+    F32: 32, I32: 32, U32: 32,
+    F16: 16, BF16: 16, I16: 16, U16: 16,
+    I8: 8, U8: 8, BOOL: 8,
+    F8_E4M3: 8, F8_E5M2: 8, F8_E8M0: 8,
+    F8_E4M3FNUZ: 8, F8_E5M2FNUZ: 8,
+    F6_E2M3: 6, F6_E3M2: 6, F4: 4
+};
+export function parseSafetensors(input, fileSize = formatFileSize(input.byteLength)) {
+    const warnings = [];
+    if (input.byteLength < HEADER_LENGTH_BYTES) {
+        return invalid(fileSize, 'File is too small to contain a safetensors header.');
+    }
+    const view = new DataView(input.buffer, input.byteOffset, input.byteLength);
+    const headerLength = Number(view.getBigUint64(0, true));
+    if (!Number.isSafeInteger(headerLength) || headerLength <= 0 || headerLength > MAX_HEADER_BYTES) {
+        return invalid(fileSize, 'Header length is out of range; the file is not a valid safetensors file.');
+    }
+    const headerEnd = HEADER_LENGTH_BYTES + headerLength;
+    if (headerEnd > input.byteLength) {
+        return invalid(fileSize, 'Declared header length extends past the end of the file.');
+    }
+    const headerBytes = input.subarray(HEADER_LENGTH_BYTES, headerEnd);
+    if (headerBytes[0] !== 0x7b) {
+        return invalid(fileSize, 'The safetensors header must begin with a JSON object.');
+    }
+    let header;
+    try {
+        const json = new TextDecoder('utf-8', { fatal: true }).decode(headerBytes);
+        const parsed = JSON.parse(json);
+        if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            return invalid(fileSize, 'The safetensors header is not a JSON object.');
+        }
+        header = parsed;
+    }
+    catch {
+        return invalid(fileSize, 'The safetensors header is not valid JSON.');
+    }
+    const metadata = {};
+    const rawMeta = header[METADATA_KEY];
+    let metadataIssue = false;
+    if (rawMeta !== undefined) {
+        if (rawMeta !== null && typeof rawMeta === 'object' && !Array.isArray(rawMeta)) {
+            for (const [key, value] of Object.entries(rawMeta)) {
+                if (typeof value === 'string')
+                    metadata[key] = value;
+                else
+                    metadataIssue = true;
+            }
+        }
+        else {
+            metadataIssue = true;
+        }
+    }
+    if (metadataIssue)
+        warnings.push('Some "__metadata__" values are not strings and were ignored.');
+    const dataBufferSize = input.byteLength - headerEnd;
+    const tensors = [];
+    const dtypeCounts = new Map();
+    let totalElements = 0;
+    let unknownDtype = false;
+    let entryIssue = false;
+    let rangeIssue = false;
+    const validRanges = [];
+    for (const [name, rawValue] of Object.entries(header)) {
+        if (name === METADATA_KEY)
+            continue;
+        const entry = rawValue;
+        const dtypeValid = typeof entry?.dtype === 'string';
+        const dtype = dtypeValid ? entry.dtype : 'unknown';
+        const shapeValid = Array.isArray(entry?.shape)
+            && entry.shape.every(n => Number.isSafeInteger(n) && n >= 0);
+        const shape = shapeValid ? entry.shape : [];
+        const offsets = Array.isArray(entry?.data_offsets) ? entry.data_offsets : [];
+        const offsetsValid = offsets.length === 2
+            && offsets.every(n => Number.isSafeInteger(n) && n >= 0);
+        const begin = offsetsValid ? offsets[0] : 0;
+        const end = offsetsValid ? offsets[1] : 0;
+        if (!dtypeValid || !shapeValid || !offsetsValid)
+            entryIssue = true;
+        const elements = safeElementCount(shape);
+        if (elements === undefined)
+            entryIssue = true;
+        const elementCount = elements ?? 0;
+        const byteLength = Math.max(0, end - begin);
+        tensors.push({ name, dtype, shape, dataOffsets: [begin, end], elements: elementCount, byteLength });
+        totalElements += elementCount;
+        dtypeCounts.set(dtype, (dtypeCounts.get(dtype) ?? 0) + 1);
+        const bits = DTYPE_BITS[dtype];
+        if (bits === undefined) {
+            unknownDtype = true;
+        }
+        else if (elements !== undefined) {
+            const expectedBits = BigInt(elements) * BigInt(bits);
+            if (expectedBits % 8n !== 0n || expectedBits / 8n !== BigInt(byteLength))
+                rangeIssue = true;
+        }
+        if (!offsetsValid || end < begin || end > dataBufferSize) {
+            rangeIssue = true;
+        }
+        else {
+            validRanges.push([begin, end]);
+        }
+    }
+    // Header keys have no defined order; sort tensors by their data offset so the
+    // table reads in storage order.
+    tensors.sort((a, b) => a.dataOffsets[0] - b.dataOffsets[0] || a.dataOffsets[1] - b.dataOffsets[1]);
+    // A valid safetensors data buffer is packed from byte zero to EOF without
+    // holes or overlaps. Empty tensors may repeat the current offset.
+    validRanges.sort((a, b) => a[0] - b[0] || a[1] - b[1]);
+    let coveredUntil = 0;
+    for (const [begin, end] of validRanges) {
+        if (begin !== coveredUntil)
+            rangeIssue = true;
+        coveredUntil = Math.max(coveredUntil, end);
+    }
+    if (coveredUntil !== dataBufferSize)
+        rangeIssue = true;
+    if (entryIssue)
+        warnings.push('Some tensor entries have an invalid dtype, shape, or data offset declaration.');
+    if (unknownDtype)
+        warnings.push('Some tensors use a dtype this viewer does not recognize.');
+    if (rangeIssue)
+        warnings.push('Some tensor byte ranges are inconsistent with their dtype and shape.');
+    const dtypeList = [...dtypeCounts.keys()].sort();
+    const summary = [
+        { label: 'Tensors', value: tensors.length },
+        { label: 'Parameters', value: formatCount(totalElements) },
+        { label: 'Data types', value: dtypeList.length ? dtypeList.join(', ') : '—' }
+    ];
+    if (Object.keys(metadata).length) {
+        summary.push({ label: 'Metadata keys', value: Object.keys(metadata).length });
+    }
+    const tables = [
+        {
+            title: `Tensors (${tensors.length})`,
+            headers: ['Name', 'Dtype', 'Shape', 'Parameters', 'Size'],
+            rows: tensors.map(tensor => [
+                tensor.name,
+                tensor.dtype,
+                tensor.shape.length ? tensor.shape.join(' × ') : 'scalar',
+                tensor.elements,
+                formatFileSize(tensor.byteLength)
+            ])
+        }
+    ];
+    if (Object.keys(metadata).length) {
+        tables.push({
+            title: `Metadata (${Object.keys(metadata).length})`,
+            headers: ['Key', 'Value'],
+            rows: Object.entries(metadata).map(([key, value]) => [key, value])
+        });
+    }
+    const rawPreview = tensors.length
+        ? tensors
+            .map(tensor => `${tensor.name}  [${tensor.shape.length ? tensor.shape.join(' × ') : 'scalar'}]  ${tensor.dtype}`)
+            .join('\n')
+        : undefined;
+    return {
+        format: 'safetensors',
+        title: 'Safetensors tensor collection',
+        fileSize,
+        summary,
+        tables,
+        rawPreview,
+        warnings
+    };
+}
+function safeElementCount(shape) {
+    let count = 1;
+    for (const dimension of shape) {
+        if (!Number.isSafeInteger(dimension) || dimension < 0)
+            return undefined;
+        if (dimension !== 0 && count > Number.MAX_SAFE_INTEGER / dimension)
+            return undefined;
+        count *= dimension;
+    }
+    return count;
+}
+function invalid(fileSize, message) {
+    return {
+        format: 'safetensors',
+        title: 'Safetensors tensor collection',
+        fileSize,
+        summary: [{ label: 'Status', value: 'invalid' }],
+        tables: [],
+        rawPreview: undefined,
+        warnings: [message]
+    };
+}
+/** Compact parameter counts, e.g. 1.20B, 350.0M, 12.3K. */
+export function formatCount(count) {
+    if (count < 1000)
+        return String(count);
+    const units = [[1e9, 'B'], [1e6, 'M'], [1e3, 'K']];
+    for (const [threshold, suffix] of units) {
+        if (count >= threshold) {
+            const value = count / threshold;
+            return value.toFixed(value >= 100 ? 0 : value >= 10 ? 1 : 2) + suffix;
+        }
+    }
+    return String(count);
+}
+export function formatFileSize(bytes) {
+    if (bytes < 1024)
+        return String(bytes) + ' bytes';
+    const units = ['KB', 'MB', 'GB', 'TB'];
+    let value = bytes / 1024;
+    let unit = units[0];
+    for (let i = 1; i < units.length && value >= 1024; i++) {
+        value /= 1024;
+        unit = units[i];
+    }
+    return value.toFixed(value >= 10 ? 1 : 2) + ' ' + unit;
+}

package/dist/parsers/toml/model.d.ts

@@ -1,4 +1,10 @@
 export type TomlValueKind = 'table' | 'array' | 'string' | 'integer' | 'float' | 'boolean' | 'datetime';
+/** Half-open character offsets into `TomlDocument.text`, so a host can map a
+ * node onto a text selection and a caret offset back onto a node. */
+export interface TomlRange {
+    start: number;
+    end: number;
+}
 export interface TomlNode {
     kind: TomlValueKind;
     key: string;
@@ -6,6 +12,10 @@ export interface TomlNode {
     value?: string | boolean;
     raw: string;
     line: number;
+    /** `#` comments attached to the node: the run directly above it plus any
+     * trailing comment on the declaration line, `#` and padding removed. */
+    comment?: string;
+    range?: TomlRange;
     children?: TomlNode[];
 }
 export interface TomlDocument {