@l1yp/file-viewer 0.1.0

package/dist/lib/speechAudio.js

@@ -0,0 +1,85 @@
+//#region src/lib/speechAudio.ts
+var e = [
+	35,
+	33,
+	65,
+	77,
+	82,
+	10
+], t = [
+	35,
+	33,
+	65,
+	77,
+	82,
+	45,
+	87,
+	66,
+	10
+], n = [
+	35,
+	33,
+	83,
+	73,
+	76,
+	75,
+	95,
+	86,
+	51
+];
+function r(e, t, n) {
+	if (t + n.length > e.length) return !1;
+	for (let r = 0; r < n.length; r++) if (e[t + r] !== n[r]) return !1;
+	return !0;
+}
+function i(i) {
+	return r(i, 0, n) || r(i, 1, n) ? "silk" : r(i, 0, t) ? "amr-wb" : r(i, 0, e) ? "amr-nb" : null;
+}
+var a = 24e3, o = class extends Error {};
+function s(e) {
+	let t = new Uint8Array(e.length * 2), n = new DataView(t.buffer);
+	for (let t = 0; t < e.length; t++) {
+		let r = Math.max(-1, Math.min(1, e[t]));
+		n.setInt16(t * 2, r < 0 ? r * 32768 : r * 32767, !0);
+	}
+	return t;
+}
+function c(e, t, n = 1) {
+	let r = n * 2, i = new Uint8Array(44 + e.length), a = new DataView(i.buffer), o = (e, t) => {
+		for (let n = 0; n < t.length; n++) i[e + n] = t.charCodeAt(n);
+	};
+	return o(0, "RIFF"), a.setUint32(4, 36 + e.length, !0), o(8, "WAVE"), o(12, "fmt "), a.setUint32(16, 16, !0), a.setUint16(20, 1, !0), a.setUint16(22, n, !0), a.setUint32(24, t, !0), a.setUint32(28, t * r, !0), a.setUint16(32, r, !0), a.setUint16(34, 16, !0), o(36, "data"), a.setUint32(40, e.length, !0), i.set(e, 44), i;
+}
+async function l(e) {
+	let { decode: t } = await import("silk-wasm"), { data: n, duration: r } = await t(e, a);
+	if (!n.length) throw new o("SILK 解码结果为空");
+	return {
+		wav: c(n, a),
+		codec: "silk",
+		sampleRate: a,
+		channels: 1,
+		durationSec: r / 1e3
+	};
+}
+async function u(e, t) {
+	let { default: n } = await import("@audio/decode-amr"), { channelData: r, sampleRate: i } = await n(e), a = r[0];
+	if (!a || !a.length) throw new o("AMR 解码结果为空");
+	return {
+		wav: c(s(a), i),
+		codec: t,
+		sampleRate: i,
+		channels: 1,
+		durationSec: a.length / i
+	};
+}
+async function d(e) {
+	let t = e instanceof Uint8Array ? e : new Uint8Array(e), n = i(t);
+	if (!n) throw new o("不是可识别的 AMR / SILK 语音文件");
+	try {
+		return n === "silk" ? await l(t) : await u(t, n);
+	} catch (e) {
+		throw e instanceof o ? e : new o(e instanceof Error ? e.message : String(e));
+	}
+}
+//#endregion
+export { d as decodeSpeechToWav, i as sniffSpeechCodec };

package/dist/lib/sqlite.d.ts

@@ -0,0 +1,38 @@
+import type { Database, SqlJsStatic } from 'sql.js';
+/** 加载并初始化 sql.js（WASM）。多次调用复用同一实例。 */
+export declare function initSqlEngine(): Promise<SqlJsStatic>;
+/** 从 .sqlite / .db 文件字节加载一个库（一次性入内存，sql.js 全在内存运行）。 */
+export declare function loadDatabase(SQL: SqlJsStatic, bytes: Uint8Array): Database;
+export type CellValue = string | number | null;
+export interface Column {
+    name: string;
+    type: string;
+    pk?: boolean;
+    fk?: boolean;
+    idx?: boolean;
+    notnull?: boolean;
+}
+/** 一张表 / 视图的概要（不含行数据，行数据按需分页读取）。 */
+export interface TableInfo {
+    name: string;
+    kind: 'table' | 'view';
+    rowCount: number;
+    columns: Column[];
+}
+export interface QueryResult {
+    columns: string[];
+    rows: CellValue[][];
+    rowCount: number;
+    elapsedMs: number;
+    error: string;
+}
+/** 读出某表/视图的列结构（含 pk / fk / idx / notnull 徽标信息）。 */
+export declare function readColumns(db: Database, table: string): Column[];
+/** 表/视图行数（视图可能为表达式，失败回退 0）。 */
+export declare function rowCount(db: Database, table: string): number;
+/** 列出所有用户表与视图（含列结构与行数），按名称排序；排除 sqlite_ 内部表。 */
+export declare function listTables(db: Database): TableInfo[];
+/** 按页读取某表/视图的行（LIMIT/OFFSET）。仅取数据，不带列结构（列结构走 readColumns）。 */
+export declare function readPage(db: Database, table: string, limit: number, offset: number): CellValue[][];
+/** 执行任意 SQL，返回最后一个结果集；出错时 error 非空（只读预览，不强制只读但不暴露写 UI）。 */
+export declare function execSql(db: Database, sql: string): QueryResult;

package/dist/lib/sqlite.js

@@ -0,0 +1,104 @@
+import e from "sql.js";
+import t from "sql.js/dist/sql-wasm.wasm?url";
+//#region src/lib/sqlite.ts
+var n = null;
+function r() {
+	return n ||= e({ locateFile: () => t }), n;
+}
+function i(e, t) {
+	return new e.Database(t);
+}
+function a(e) {
+	return "\"" + e.replace(/"/g, "\"\"") + "\"";
+}
+function o(e) {
+	return e == null ? null : e instanceof Uint8Array ? `[BLOB ${e.length}B]` : e;
+}
+function s(e, t) {
+	let n = a(t), r = /* @__PURE__ */ new Set(), i = e.exec(`PRAGMA foreign_key_list(${n})`);
+	if (i.length) {
+		let e = i[0].columns.indexOf("from");
+		for (let t of i[0].values) r.add(String(t[e]));
+	}
+	let o = /* @__PURE__ */ new Set(), s = e.exec(`PRAGMA index_list(${n})`);
+	if (s.length) {
+		let t = s[0].columns, n = t.indexOf("name"), r = t.indexOf("origin");
+		for (let t of s[0].values) {
+			let i = String(t[n]);
+			if ((r >= 0 ? String(t[r]) : "c") === "pk") continue;
+			let s = e.exec(`PRAGMA index_info(${a(i)})`);
+			if (s.length) {
+				let e = s[0].columns.indexOf("name");
+				for (let t of s[0].values) t[e] != null && o.add(String(t[e]));
+			}
+		}
+	}
+	let c = [], l = e.exec(`PRAGMA table_info(${n})`);
+	if (l.length) {
+		let e = l[0].columns, t = e.indexOf("name"), n = e.indexOf("type"), i = e.indexOf("pk"), a = e.indexOf("notnull");
+		for (let e of l[0].values) {
+			let s = {
+				name: String(e[t]),
+				type: String(e[n] ?? "")
+			};
+			Number(e[i]) > 0 && (s.pk = !0), a >= 0 && Number(e[a]) === 1 && (s.notnull = !0), r.has(s.name) && (s.fk = !0), o.has(s.name) && (s.idx = !0), c.push(s);
+		}
+	}
+	return c;
+}
+function c(e, t) {
+	try {
+		let n = e.exec(`SELECT COUNT(*) FROM ${a(t)}`);
+		return n.length && n[0].values.length ? Number(n[0].values[0][0]) : 0;
+	} catch {
+		return 0;
+	}
+}
+function l(e) {
+	let t = e.exec("SELECT name, type FROM sqlite_master WHERE type IN ('table','view') AND name NOT LIKE 'sqlite_%' ORDER BY type, name");
+	if (!t.length) return [];
+	let n = [];
+	for (let r of t[0].values) {
+		let t = String(r[0]), i = String(r[1]) === "view" ? "view" : "table";
+		n.push({
+			name: t,
+			kind: i,
+			rowCount: c(e, t),
+			columns: s(e, t)
+		});
+	}
+	return n;
+}
+function u(e, t, n, r) {
+	let i = e.exec(`SELECT * FROM ${a(t)} LIMIT ${n} OFFSET ${r}`);
+	return i.length ? i[0].values.map((e) => e.map(o)) : [];
+}
+function d(e, t) {
+	let n = performance.now();
+	try {
+		let r = e.exec(t), i = performance.now() - n, a = r.length ? r[r.length - 1] : null;
+		return a ? {
+			columns: a.columns,
+			rows: a.values.map((e) => e.map(o)),
+			rowCount: a.values.length,
+			elapsedMs: i,
+			error: ""
+		} : {
+			columns: [],
+			rows: [],
+			rowCount: 0,
+			elapsedMs: i,
+			error: ""
+		};
+	} catch (e) {
+		return {
+			columns: [],
+			rows: [],
+			rowCount: 0,
+			elapsedMs: performance.now() - n,
+			error: e instanceof Error ? e.message : String(e)
+		};
+	}
+}
+//#endregion
+export { d as execSql, r as initSqlEngine, l as listTables, i as loadDatabase, u as readPage };

package/dist/lib/subtitle.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Hand-rolled, zero-dependency subtitle parser for the side viewer.
+ *
+ * Parses the three common caption formats into a uniform cue list:
+ *  - SubRip (.srt):        block = optional index line, `HH:MM:SS,mmm --> HH:MM:SS,mmm`, then text lines
+ *  - WebVTT (.vtt):        a `WEBVTT` header, optional cue ids / NOTE / STYLE / REGION blocks, and
+ *                          `HH:MM:SS.mmm --> HH:MM:SS.mmm <settings>` timing lines; inline tags stripped
+ *  - SubStation Alpha (.ass/.ssa): an `[Events]` section with a `Format:` line + `Dialogue:` rows;
+ *                          override tags `{\…}` and the `\N` / `\h` escapes are handled
+ *
+ * The viewer only needs start/end/text (plus an optional speaker from the ASS Name field), so styling,
+ * positioning, karaoke timing, etc. are intentionally discarded — this is a readable transcript, not a
+ * pixel-accurate renderer. Times are normalized to milliseconds.
+ */
+export interface SubtitleCue {
+    start: number;
+    end: number;
+    text: string;
+    speaker?: string;
+}
+export interface ParsedSubtitle {
+    format: 'srt' | 'vtt' | 'ass';
+    cues: SubtitleCue[];
+}
+/** Parse subtitle source text into a sorted cue list. `ext` (when known) disambiguates the format. */
+export declare function parseSubtitle(input: string, ext?: string): ParsedSubtitle;

package/dist/lib/subtitle.js

@@ -0,0 +1,99 @@
+//#region src/lib/subtitle.ts
+var e = /(?:(\d+):)?(\d{1,2}):(\d{1,2})[.,](\d{1,3})/;
+function t(t) {
+	let n = t.match(e);
+	if (!n) return null;
+	let r = n[1] ? parseInt(n[1], 10) : 0, i = parseInt(n[2], 10), a = parseInt(n[3], 10), o = parseInt(n[4].padEnd(3, "0").slice(0, 3), 10);
+	return ((r * 60 + i) * 60 + a) * 1e3 + o;
+}
+function n(e) {
+	return e.replace(/<[^>]*>/g, "").replace(/\{\\[^}]*\}/g, "").replace(/[ \t]+\n/g, "\n").trim();
+}
+function r(e, r) {
+	let i = [];
+	for (let a of e.split(/\n{2,}/)) {
+		if (r && /^\s*(WEBVTT|NOTE|STYLE|REGION)\b/.test(a)) continue;
+		let e = a.split("\n"), o = e.findIndex((e) => e.includes("-->"));
+		if (o < 0) continue;
+		let [s, c = ""] = e[o].split("-->"), l = t(s), u = t(c);
+		if (l === null || u === null) continue;
+		let d = e.slice(o + 1).join("\n").trim();
+		i.push({
+			start: l,
+			end: u,
+			text: n(d)
+		});
+	}
+	return i;
+}
+var i = [
+	"layer",
+	"start",
+	"end",
+	"style",
+	"name",
+	"marginl",
+	"marginr",
+	"marginv",
+	"effect",
+	"text"
+];
+function a(e, t) {
+	if (t <= 1) return [e];
+	let n = [], r = 0;
+	for (let i = 0; i < t - 1; i++) {
+		let t = e.indexOf(",", r);
+		if (t < 0) break;
+		n.push(e.slice(r, t)), r = t + 1;
+	}
+	return n.push(e.slice(r)), n;
+}
+function o(e) {
+	return e.replace(/\{[^}]*\}/g, "").replace(/\\N/gi, "\n").replace(/\\h/gi, " ").trim();
+}
+function s(e) {
+	let n = [], r = !1, s = [];
+	for (let c of e.split("\n")) {
+		let e = c.trim();
+		if (e.startsWith("[")) {
+			r = /^\[events\]/i.test(e);
+			continue;
+		}
+		if (!(!r || !e)) {
+			if (/^format\s*:/i.test(e)) {
+				s = e.slice(e.indexOf(":") + 1).split(",").map((e) => e.trim().toLowerCase());
+				continue;
+			}
+			if (/^dialogue\s*:/i.test(e)) {
+				let r = s.length ? s : i, c = a(e.slice(e.indexOf(":") + 1), r.length), l = (e) => {
+					let t = r.indexOf(e);
+					return t >= 0 ? c[t] ?? "" : "";
+				}, u = t(l("start")), d = t(l("end"));
+				if (u === null || d === null) continue;
+				let f = l("name").trim();
+				n.push({
+					start: u,
+					end: d,
+					text: o(l("text") || c[c.length - 1] || ""),
+					speaker: f || void 0
+				});
+			}
+		}
+	}
+	return n;
+}
+function c(e, t) {
+	let n = (e.charCodeAt(0) === 65279 ? e.slice(1) : e).replace(/\r\n?/g, "\n"), i = (t || "").toLowerCase(), a;
+	return a = i === "ass" || i === "ssa" || /^\s*\[script info\]/i.test(n) ? {
+		format: "ass",
+		cues: s(n)
+	} : i === "vtt" || /^\s*WEBVTT/.test(n) ? {
+		format: "vtt",
+		cues: r(n, !0)
+	} : {
+		format: "srt",
+		cues: r(n, !1)
+	}, a.cues.sort((e, t) => e.start - t.start || e.end - t.end), a;
+}
+//#endregion
+export { c as parseSubtitle };

package/dist/lib/tarball.d.ts

@@ -0,0 +1,20 @@
+/**
+ * In-browser reader for the tar family — `.tar` and its compressed wrappers `.gz`/`.tgz`, `.xz`/`.txz`,
+ * `.bz2`/`.tbz2`, `.br`/`.tar.br` — plus a lone compressed file (`foo.json.gz`). No dependency beyond the
+ * browser's native gzip; xz reuses the project's hand-rolled LZMA2 decoder ({@link lib/lzma}), bzip2 its BWT
+ * decoder ({@link lib/bzip2}), and Brotli a lazily-loaded WASM decoder ({@link lib/brotli}).
+ *
+ * Unlike ZIP/7z (random-access central directories), a tar is solid: the whole stream is decompressed to
+ * memory once, then tar headers are walked to index each file as an (offset, size) slice into that buffer —
+ * so extraction is a cheap, synchronous sub-array copy. The result is exposed through the shared
+ * {@link OpenedArchive} interface so {@link components/ArchiveBrowser} can browse it like any other archive.
+ *
+ * If the decompressed bytes aren't a tar (a bare `foo.txt.gz`), the archive is presented as a single entry
+ * named by stripping the compression suffix.
+ */
+import type { OpenedArchive } from '@/lib/archive';
+/**
+ * Open a tar-family archive: decompress the outer wrapper (gzip/xz/bzip2, by magic) if present, then either
+ * index it as a tar or, failing that, surface the single decompressed file.
+ */
+export declare function openTarball(buf: ArrayBuffer, name: string): Promise<OpenedArchive>;

package/dist/lib/tarball.js

@@ -0,0 +1,248 @@
+import { decodeFileNameBytes as e } from "./encoding.js";
+import { bcjX86Decode as t, lzma2Decode as n } from "./lzma.js";
+import { bzip2Decode as r } from "./bzip2.js";
+//#region src/lib/tarball.ts
+var i = [31, 139], a = [
+	253,
+	55,
+	122,
+	88,
+	90,
+	0
+], o = [
+	66,
+	90,
+	104
+];
+function s(e, t, n = 0) {
+	return e.length < n + t.length ? !1 : t.every((t, r) => e[n + r] === t);
+}
+async function c(e) {
+	if (typeof DecompressionStream > "u") throw Error("当前浏览器不支持解压 gzip（缺少 DecompressionStream）");
+	let t = new Blob([e]).stream().pipeThrough(new DecompressionStream("gzip"));
+	return new Uint8Array(await new Response(t).arrayBuffer());
+}
+var l = [
+	0,
+	4,
+	4,
+	4,
+	8,
+	8,
+	8,
+	16,
+	16,
+	16,
+	32,
+	32,
+	32,
+	64,
+	64,
+	64
+];
+function u(e, t) {
+	let n = 0, r = 0, i = t;
+	for (;;) {
+		let t = e[i++];
+		if (n += (t & 127) * 2 ** r, !(t & 128)) break;
+		if (r += 7, r > 63) throw Error("xz VLI 过长");
+	}
+	return {
+		value: n,
+		next: i
+	};
+}
+function d(e, t) {
+	let n = t, r = 0;
+	for (;;) {
+		let t = e[n++];
+		if (t === 0) break;
+		if (t >= 128) {
+			let i = ((t & 31) << 16) + (e[n] << 8) + e[n + 1] + 1;
+			n += 2;
+			let a = (e[n] << 8) + e[n + 1] + 1;
+			n += 2, (t >> 5 & 3) >= 2 && n++, n += a, r += i;
+		} else {
+			if (t > 2) throw Error(`xz LZMA2 非法控制字节 0x${t.toString(16)}`);
+			let i = (e[n] << 8) + e[n + 1] + 1;
+			n += 2, n += i, r += i;
+		}
+	}
+	return {
+		compLen: n - t,
+		uncompSize: r
+	};
+}
+function f(e) {
+	if (!s(e, a)) throw Error("不是有效的 xz 文件");
+	let r = l[e[7] & 15], i = [], o = 12;
+	for (; o < e.length;) {
+		let a = e[o];
+		if (a === 0) break;
+		let s = (a + 1) * 4, c = e[o + 1], l = (c & 3) + 1, f = o + 2;
+		c & 64 && (f = u(e, f).next);
+		let p = -1;
+		if (c & 128) {
+			let t = u(e, f);
+			p = t.value, f = t.next;
+		}
+		let m = new Uint8Array(), h = !1;
+		for (let t = 0; t < l; t++) {
+			let t = u(e, f);
+			f = t.next;
+			let n = u(e, f);
+			f = n.next;
+			let r = e.subarray(f, f + n.value);
+			if (f += n.value, t.value === 33) m = r.slice();
+			else if (t.value === 4) h = !0;
+			else throw Error(`xz 不支持的过滤器 0x${t.value.toString(16)}`);
+		}
+		let g = o + s, { compLen: _, uncompSize: v } = d(e, g), y = p >= 0 ? p : v, b = n(e.subarray(g, g + _), m, y);
+		h && t(b), i.push(b);
+		let x = g + _;
+		x += (4 - _ % 4) % 4, x += r, o = x;
+	}
+	let c = 0;
+	for (let e of i) c += e.length;
+	let f = new Uint8Array(c), p = 0;
+	for (let e of i) f.set(e, p), p += e.length;
+	return f;
+}
+var p = new TextDecoder("utf-8");
+function m(e, t, n) {
+	let r = t;
+	for (; r < t + n && e[r] !== 0;) r++;
+	return p.decode(e.subarray(t, r));
+}
+function h(t, n, r) {
+	let i = n;
+	for (; i < n + r && t[i] !== 0;) i++;
+	return e(t.subarray(n, i));
+}
+function g(e, t, n) {
+	if (e[t] & 128) {
+		let r = e[t] & 127;
+		for (let i = 1; i < n; i++) r = r * 256 + e[t + i];
+		return r;
+	}
+	let r = m(e, t, n).trim();
+	return r && parseInt(r, 8) || 0;
+}
+function _(e) {
+	let t = {}, n = 0;
+	for (; n < e.length;) {
+		let r = e.indexOf(" ", n);
+		if (r < 0) break;
+		let i = parseInt(e.slice(n, r), 10);
+		if (!i || i <= 0) break;
+		let a = e.slice(r + 1, n + i - 1), o = a.indexOf("=");
+		if (o > 0) {
+			let e = a.slice(0, o), n = a.slice(o + 1);
+			e === "path" ? t.path = n : e === "size" && (t.size = parseInt(n, 10) || 0);
+		}
+		n += i;
+	}
+	return t;
+}
+var v = (e) => e + 511 & -512;
+function y(e) {
+	let t = [], n = 0, r = "", i = {};
+	for (; n + 512 <= e.length;) {
+		let a = e.subarray(n, n + 512), o = !0;
+		for (let e = 0; e < 512; e++) if (a[e] !== 0) {
+			o = !1;
+			break;
+		}
+		if (o) break;
+		let s = h(a, 0, 100), c = h(a, 345, 155), l = String.fromCharCode(a[156]), u = g(a, 124, 12), d = n + 512;
+		if (l === "L") {
+			r = h(e.subarray(d, d + u), 0, u), n = d + v(u);
+			continue;
+		}
+		if (l === "K") {
+			n = d + v(u);
+			continue;
+		}
+		if (l === "x" || l === "g") {
+			i = _(p.decode(e.subarray(d, d + u))), n = d + v(u);
+			continue;
+		}
+		let f = r || i.path || (c ? `${c}/${s}` : s);
+		i.size !== void 0 && (u = i.size), r = "", i = {};
+		let m = l === "5" || f.endsWith("/");
+		f = f.replace(/\/+$/, ""), f && t.push({
+			path: f,
+			name: f.split("/").pop() ?? f,
+			size: m ? 0 : u,
+			isDir: m,
+			offset: d
+		}), n = d + (m ? 0 : v(u));
+	}
+	return t;
+}
+function b(e) {
+	return e.length >= 512 && m(e.subarray(257, 263), 0, 5) === "ustar";
+}
+function x(e) {
+	let t = e.toLowerCase();
+	for (let [n, r] of [
+		[".tar.gz", ".tar"],
+		[".tar.xz", ".tar"],
+		[".tar.bz2", ".tar"],
+		[".tgz", ".tar"],
+		[".txz", ".tar"],
+		[".tbz2", ".tar"],
+		[".tbz", ".tar"],
+		[".tar.br", ".tar"],
+		[".tbr", ".tar"]
+	]) if (t.endsWith(n)) return e.slice(0, -n.length) + r;
+	for (let n of [
+		".gz",
+		".xz",
+		".bz2",
+		".bz",
+		".br"
+	]) if (t.endsWith(n)) return e.slice(0, -n.length);
+	return `${e}.out`;
+}
+async function S(e, t) {
+	let n = new Uint8Array(e);
+	if (s(n, i)) n = await c(n);
+	else if (s(n, a)) n = f(n);
+	else if (s(n, o)) n = r(n);
+	else if (!b(n)) {
+		let { brotliDecode: e } = await import("./brotli.js");
+		n = await e(n);
+	}
+	if (b(n)) {
+		let e = y(n), t = e.map((e, t) => ({
+			path: e.path,
+			name: e.name,
+			size: e.size,
+			isDir: e.isDir,
+			ref: t
+		})), r = n;
+		return {
+			entries: t,
+			extract(t) {
+				let n = e[t.ref];
+				return !n || n.isDir ? new Uint8Array() : r.subarray(n.offset, n.offset + n.size).slice();
+			}
+		};
+	}
+	let l = x(t), u = n;
+	return {
+		entries: [{
+			path: l,
+			name: l,
+			size: u.length,
+			isDir: !1,
+			ref: 0
+		}],
+		extract() {
+			return u;
+		}
+	};
+}
+//#endregion
+export { S as openTarball };

package/dist/lib/viewerFormats.d.ts

@@ -0,0 +1,35 @@
+/**
+ * The "open with" formatter set — the universal escape hatch for the side viewer.
+ *
+ * Auto-detection ({@link classifyViewerFile}) routes a file to a specialized viewer by extension/mime, but that
+ * guess can be wrong (a mislabeled file, a `.voice` blob that's really SILK, bytes worth eyeballing as hex).
+ * Each formatter here REINTERPRETS the same name/url/size/content as a different {@link ViewerFile}, so it
+ * applies to ANY file regardless of what detection picked. The list is shared by:
+ *   - {@link FileViewerPanel} — renders the header "打开方式" menu (available for every file), and
+ *   - {@link FileViewerBody} — applies the choice and also offers the same chips on its unpreviewable-binary
+ *     card (the archive-browser context, where there is no host header).
+ *
+ * These are deliberately the GENERIC reinterpretations that work on raw bytes — hex / text / markdown / html /
+ * svg / image / audio / video. The heavy structured viewers (docx / xlsx / zip / …) stay auto-detected only:
+ * forcing arbitrary bytes through them just errors, so they'd be noise in a "force open as" list.
+ */
+import type { StrokeIconName } from '@/components/icons/iconPaths';
+import type { ViewerFile } from '@/composables/useFileViewer';
+export interface ViewerFormatter {
+    /** Stable id (used for the active-selection highlight and the body↔header sync). */
+    key: string;
+    label: string;
+    icon: StrokeIconName;
+    /** Merged onto the base file to force this interpretation; `lang` is always set (it drives the source view). */
+    patch: Partial<ViewerFile> & {
+        lang: string;
+    };
+}
+export declare const VIEWER_FORMATTERS: ViewerFormatter[];
+/** Look a formatter up by its {@link ViewerFormatter.key}; undefined for an unknown key. */
+export declare function findFormatter(key: string): ViewerFormatter | undefined;
+/**
+ * Build the EFFECTIVE file for a chosen formatter: same name/url/size/content as the original, but only the
+ * formatter's flags (no carried-over detection flags), so the body's dispatch re-runs cleanly as that format.
+ */
+export declare function applyFormatter(file: ViewerFile, f: ViewerFormatter): ViewerFile;