@l1yp/file-viewer 0.1.0

package/dist/lib/epl/names/idToNameMap.js

@@ -0,0 +1,130 @@
+import { DATATYPE_ANY as e, DATATYPE_BIN as t, DATATYPE_BOOL as n, DATATYPE_BYTE as r, DATATYPE_DATETIME as i, DATATYPE_DOUBLE as a, DATATYPE_FLOAT as o, DATATYPE_INT as s, DATATYPE_LAMBDA as c, DATATYPE_LONG as l, DATATYPE_METHODPTR as u, DATATYPE_SHORT as d, DATATYPE_STRING as f, MASK_NUM as p, TYPE_CLASS as m, TYPE_CLASS_MEMBER as h, TYPE_CONSTANT as g, TYPE_DLL as _, TYPE_DLL_PARAMETER as v, TYPE_FORM as y, TYPE_FORM_CLASS as b, TYPE_FORM_CONTROL as x, TYPE_FORM_MENU as S, TYPE_GLOBAL as C, TYPE_IMAGE_RESOURCE as w, TYPE_LOCAL as T, TYPE_METHOD as E, TYPE_SOUND_RESOURCE as D, TYPE_STATIC_CLASS as O, TYPE_STRUCT as k, TYPE_STRUCT_MEMBER as A, decomposeLibDataTypeId as j, getType as M, isLibDataType as N } from "../model/eplSystemId.js";
+//#region src/lib/epl/names/idToNameMap.ts
+var P = new Map([
+	[t, "字节集"],
+	[n, "逻辑型"],
+	[r, "字节型"],
+	[i, "日期时间型"],
+	[a, "双精度小数型"],
+	[o, "小数型"],
+	[s, "整数型"],
+	[l, "长整数型"],
+	[u, "子程序指针"],
+	[d, "短整数型"],
+	[f, "文本型"],
+	[e, "通用型"],
+	[c, "条件语句型"],
+	[0, ""]
+]), F = new Map([
+	[E, "Sub"],
+	[C, "Global"],
+	[O, "Mod"],
+	[_, "Dll"],
+	[h, "Mem"],
+	[x, "Control"],
+	[S, "Menu"],
+	[g, "Const"],
+	[b, "FormCls"],
+	[T, "Local"],
+	[w, "Img"],
+	[D, "Sound"],
+	[A, "StructMem"],
+	[k, "Struct"],
+	[v, "DllParam"],
+	[m, "Cls"],
+	[y, "Form"]
+]), I = /^_-@[MS]<([_A-Za-z€-￿][_0-9A-Za-z€-￿]*)>$/;
+function L(e) {
+	if (!e) return null;
+	let t = I.exec(e);
+	return t ? t[1] : null;
+}
+function R(e, t) {
+	return (e >>> 0).toString(16).toUpperCase().padStart(t, "0");
+}
+var z = class {
+	userDefinedName = /* @__PURE__ */ new Map();
+	methodIdToClassId = /* @__PURE__ */ new Map();
+	libProvider;
+	constructor(e, t = null) {
+		this.libProvider = t;
+		let n = e.code;
+		if (n) {
+			for (let e of n.methods) {
+				if (e.name) this.userDefinedName.set(e.id, e.name);
+				else {
+					let t = L(e.comment);
+					t != null && this.userDefinedName.set(e.id, t);
+				}
+				for (let t of e.parameters) this.userDefinedName.set(t.id, t.name);
+				for (let t of e.variables) this.userDefinedName.set(t.id, t.name);
+			}
+			for (let e of n.dllDeclares) {
+				this.userDefinedName.set(e.id, e.name);
+				for (let t of e.parameters) this.userDefinedName.set(t.id, t.name);
+			}
+			for (let e of n.classes) {
+				for (let t of e.methods) this.methodIdToClassId.set(t, e.id);
+				if (e.name) this.userDefinedName.set(e.id, e.name);
+				else {
+					let t = L(e.comment);
+					t != null && this.userDefinedName.set(e.id, t);
+				}
+				for (let t of e.variables) this.userDefinedName.set(t.id, t.name);
+			}
+			for (let e of n.structs) {
+				this.userDefinedName.set(e.id, e.name);
+				for (let t of e.members) this.userDefinedName.set(t.id, t.name);
+			}
+			for (let e of n.globalVariables) this.userDefinedName.set(e.id, e.name);
+		}
+		let r = e.resource;
+		if (r) {
+			for (let e of r.constants) this.userDefinedName.set(e.id, e.name);
+			for (let e of r.forms) {
+				this.userDefinedName.set(e.id, e.name);
+				for (let t of e.elements) this.userDefinedName.set(t.id, t.name);
+			}
+		}
+		let i = e.losable;
+		if (i) for (let e of i.removedItems) this.userDefinedName.has(e.id) || this.userDefinedName.set(e.id, e.name);
+		if (n && n.mainMethod !== 0) {
+			this.userDefinedName.set(n.mainMethod, "_启动子程序");
+			let e = [];
+			for (let [t, n] of this.userDefinedName) n || e.push(t);
+			for (let t of e) this.userDefinedName.delete(t);
+		}
+	}
+	getUserDefinedName(e) {
+		let t = this.userDefinedName.get(e);
+		if (t !== void 0) return t;
+		let n = M(e), r = F.get(n);
+		return r === void 0 ? n === 100663296 ? "" : `_User_0x${R(e, 8)}` : `_${r}_0x${R(e & p, 6)}`;
+	}
+	getDataTypeName(e) {
+		let t = P.get(e);
+		if (t !== void 0) return t;
+		if (N(e)) {
+			let { lib: t, type: n } = j(e);
+			return this.getLibTypeName(t, n);
+		}
+		return this.getUserDefinedName(e);
+	}
+	getLibCmdName(e, t) {
+		return this.libProvider?.cmdName(e, t) ?? `_Lib${e}Cmd${t}`;
+	}
+	getLibTypeName(e, t) {
+		return this.libProvider?.typeName(e, t) ?? `_Lib${e}Type${t}`;
+	}
+	getLibConstantName(e, t) {
+		return this.libProvider?.constantName(e, t) ?? `_Lib${e}Const${t}`;
+	}
+	getLibTypeEventName(e, t, n) {
+		return this.libProvider?.typeEventName(e, t, n) ?? `_Lib${e}Type${t}Event${n}`;
+	}
+	getLibTypeMemberName(e, t, n) {
+		return this.libProvider?.typeMemberName(e, t, n) ?? `_Lib${e}Type${t}Mem${n}`;
+	}
+};
+//#endregion
+export { z as IdToNameMap, L as parseDebugComment };

package/dist/lib/epl/names/libNameProvider.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Support-library name provider — turns `_Lib0Cmd13` placeholders into real names (返回 / 到文本 / 信息框 …).
+ *
+ * Backed by {@link eplLibData.json}, predumped from the actual e-language `.fne` support libraries via the C#
+ * `OpenEpl.ELibInfo` loader (keyed by library fileName, e.g. `krnln` / `iconv` / `spec`). A project's library
+ * list gives the per-index identity, so {@link buildLibNameProvider} resolves the decompiler's (libIndex, id)
+ * pairs to names. A library not in the DB (or an out-of-range id) falls back to the placeholder in IdToNameMap.
+ *
+ * To extend coverage, regenerate the JSON with the oracle's `libdump` mode over more projects (their `.fne`
+ * libraries are read from the local e-language install).
+ */
+import type { LibraryRefInfo } from '../code/structures';
+import type { LibNameProvider } from './idToNameMap';
+/** Build a {@link LibNameProvider} for a project, mapping each library index to its predumped name table. */
+export declare function buildLibNameProvider(libraries: LibraryRefInfo[]): LibNameProvider;

package/dist/lib/epl/names/libNameProvider.js

@@ -0,0 +1,18 @@
+import e from "./eplLibData.js";
+//#region src/lib/epl/names/libNameProvider.ts
+var t = e;
+function n(e, t) {
+	return e && t >= 0 && t < e.length ? e[t] : void 0;
+}
+function r(e) {
+	let r = e.map((e) => t[e.fileName.toLowerCase()]);
+	return {
+		cmdName: (e, t) => n(r[e]?.cmds, t) ?? null,
+		typeName: (e, t) => n(r[e]?.dataTypes, t)?.name ?? null,
+		constantName: (e, t) => n(r[e]?.constants, t) ?? null,
+		typeMemberName: (e, t, i) => n(n(r[e]?.dataTypes, t)?.members, i) ?? null,
+		typeEventName: (e, t, i) => n(n(r[e]?.dataTypes, t)?.events, i) ?? null
+	};
+}
+//#endregion
+export { r as buildLibNameProvider };

package/dist/lib/epl/program.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Structured program model for the IDE-style viewer — turns the parsed {@link EplDocument} + {@link IdToNameMap}
+ * into the shape the Vue components render directly: classes (each as 程序集 / 窗口程序集 / 类) with their
+ * member-variable rows + methods (header fields, parameter rows, local rows, decompiled code lines), plus the
+ * project-level tables (全局变量 / 自定义数据类型 / Dll命令 / 常量表 / 资源表 / 模块引用表).
+ *
+ * Names/types resolve through {@link IdToNameMap}; code bodies through {@link methodCodeLines}. This sits on top
+ * of the already-validated parse + decompile layers — it only reshapes, it does not re-parse.
+ */
+import { type CodeLine } from './code/codeLines';
+import type { EplVarKind } from './code/variable';
+import type { EplDocument } from './eplDocument';
+/** 程序集 (static) / 窗口程序集 (form) / 类 (class) — decided by the high byte of the class id. */
+export type EplClassKind = 'static' | 'form' | 'class';
+/** A single variable row (parameter / local / member / global / struct member / DLL parameter). */
+export interface EplVarRow {
+    kind: EplVarKind;
+    name: string;
+    type: string;
+    /** 公开 (global flag 0x100). */
+    isPublic: boolean;
+    /** 静态 (local flag 0x1). */
+    isStatic: boolean;
+    /** 传址 (struct member / DLL parameter flag 0x2). */
+    byAddress: boolean;
+    /** 参考 (method parameter flag 0x2). */
+    byReference: boolean;
+    /** 可空 (method parameter flag 0x4). */
+    nullable: boolean;
+    /** Array bounds spec for variables/members (`""` scalar, `"0"` dynamic, `"3,4"` fixed). */
+    arrayBound: string;
+    /** 数组 checkbox for parameters/DLL parameters (flag 0x8). */
+    isArray: boolean;
+    comment: string;
+}
+export interface EplMethodView {
+    id: number;
+    name: string;
+    returnType: string;
+    isPublic: boolean;
+    comment: string;
+    parameters: EplVarRow[];
+    locals: EplVarRow[];
+    lines: CodeLine[];
+}
+export interface EplClassView {
+    id: number;
+    kind: EplClassKind;
+    name: string;
+    /** Base-class name (类 only); `""` when none. */
+    baseName: string;
+    comment: string;
+    members: EplVarRow[];
+    methods: EplMethodView[];
+}
+export interface EplStructView {
+    id: number;
+    name: string;
+    isPublic: boolean;
+    comment: string;
+    members: EplVarRow[];
+}
+export interface EplDllView {
+    id: number;
+    name: string;
+    returnType: string;
+    isPublic: boolean;
+    comment: string;
+    libraryName: string;
+    entryPoint: string;
+    parameters: EplVarRow[];
+}
+export interface EplConstantRow {
+    id: number;
+    name: string;
+    /** Scalar value pre-formatted to the code view's literal style (number / 真·假 / [日期时间] / “文本”). */
+    value: string;
+    comment: string;
+}
+/**
+ * An 图片 / 声音 resource (a constant whose id high-nibble is 2 / 3). Shown on its own 图片/声音 page, not in the
+ * constant table. `bytes` is the raw resource payload; the component sniffs / decodes it (a 图片组 is a Windows
+ * ImageList — see {@link parseEplImageList}; a plain image is rendered inline; a sound gets an audio player).
+ */
+export interface EplResourceRow {
+    id: number;
+    name: string;
+    comment: string;
+    kind: 'image' | 'sound';
+    bytes: Uint8Array;
+}
+export interface EplFormElementView {
+    id: number;
+    name: string;
+    type: string;
+}
+export interface EplFormView {
+    id: number;
+    name: string;
+    className: string;
+    comment: string;
+    elements: EplFormElementView[];
+}
+export interface EplLibraryView {
+    name: string;
+    fileName: string;
+    version: string;
+}
+export interface EplProgram {
+    classes: EplClassView[];
+    globals: EplVarRow[];
+    structs: EplStructView[];
+    dllDeclares: EplDllView[];
+    constants: EplConstantRow[];
+    resources: EplResourceRow[];
+    forms: EplFormView[];
+    libraries: EplLibraryView[];
+}
+/** Build the structured model for the viewer. Returns empty tables when a `.e`/`.ec` has no code section. */
+export declare function buildProgram(doc: EplDocument): EplProgram;

package/dist/lib/epl/program.js

@@ -0,0 +1,134 @@
+import { decoderForLanguage as e } from "./io/encoding.js";
+import { getType as t } from "./model/eplSystemId.js";
+import { formatNumber as n, formatOADate as r } from "./code/textCode.js";
+import { methodCodeLines as i } from "./code/codeLines.js";
+import { IdToNameMap as a, parseDebugComment as o } from "./names/idToNameMap.js";
+import { buildLibNameProvider as s } from "./names/libNameProvider.js";
+//#region src/lib/epl/program.ts
+function c(e) {
+	return e.length === 0 ? "" : e.length === 1 && e[0] === 0 ? "0" : e.map((e) => e === 0 ? "" : String(e)).join(",");
+}
+function l(e) {
+	return o(e) == null ? e : "";
+}
+function u(e) {
+	switch (e.kind) {
+		case "double": return n(e.value);
+		case "bool": return e.value ? "真" : "假";
+		case "datetime": return "[" + r(e.oa) + "]";
+		case "string": return "“" + e.value + "”";
+		default: return "";
+	}
+}
+function d(e, t) {
+	return {
+		kind: e.kind,
+		name: t.getUserDefinedName(e.id),
+		type: t.getDataTypeName(e.dataType),
+		isPublic: (e.flags & 256) != 0,
+		isStatic: (e.flags & 1) != 0,
+		byAddress: (e.flags & 2) != 0,
+		byReference: (e.flags & 2) != 0,
+		nullable: (e.flags & 4) != 0,
+		arrayBound: c(e.uBound),
+		isArray: (e.flags & 8) != 0,
+		comment: l(e.comment)
+	};
+}
+function f(e) {
+	let n = t(e);
+	return n === 1224736768 ? "class" : n === 419430400 ? "form" : "static";
+}
+function p(e, t, n) {
+	return {
+		id: e.id,
+		name: t.getUserDefinedName(e.id),
+		returnType: t.getDataTypeName(e.returnDataType),
+		isPublic: (e.flags & 8) != 0,
+		comment: l(e.comment),
+		parameters: e.parameters.map((e) => d(e, t)),
+		locals: e.variables.map((e) => d(e, t)),
+		lines: i(e.codeData.expressionData, t, n)
+	};
+}
+function m(e, t) {
+	return {
+		id: e.id,
+		name: t.getUserDefinedName(e.id),
+		isPublic: (e.flags & 1) != 0,
+		comment: l(e.comment),
+		members: e.members.map((e) => d(e, t))
+	};
+}
+function h(e, t) {
+	return {
+		id: e.id,
+		name: t.getUserDefinedName(e.id),
+		returnType: t.getDataTypeName(e.returnDataType),
+		isPublic: (e.flags & 2) != 0,
+		comment: l(e.comment),
+		libraryName: e.libraryName,
+		entryPoint: e.entryPoint,
+		parameters: e.parameters.map((e) => d(e, t))
+	};
+}
+function g(n) {
+	let r = e(n.systemInfo?.language ?? 1), i = new a(n, n.code ? s(n.code.libraries) : null), o = n.code, c = /* @__PURE__ */ new Map();
+	if (o) for (let e of o.methods) c.set(e.id, e);
+	let g = (o?.classes ?? []).map((e) => {
+		let t = e.baseClass === 0 || e.baseClass === -1 ? "" : i.getUserDefinedName(e.baseClass), n = [];
+		for (let t of e.methods) {
+			let e = c.get(t);
+			e && n.push(p(e, i, r));
+		}
+		return {
+			id: e.id,
+			kind: f(e.id),
+			name: i.getUserDefinedName(e.id),
+			baseName: t,
+			comment: e.comment,
+			members: e.variables.map((e) => d(e, i)),
+			methods: n
+		};
+	}), _ = n.resource, v = _?.constants ?? [], y = v.filter((e) => t(e.id) === 402653184 && e.name).map((e) => ({
+		id: e.id,
+		name: i.getUserDefinedName(e.id),
+		value: u(e.value),
+		comment: l(e.comment)
+	})), b = v.filter((e) => {
+		let n = t(e.id);
+		return (n === 671088640 || n === 939524096) && e.name;
+	}).map((e) => ({
+		id: e.id,
+		name: i.getUserDefinedName(e.id),
+		comment: l(e.comment),
+		kind: t(e.id) === 671088640 ? "image" : "sound",
+		bytes: e.value.kind === "image" || e.value.kind === "sound" ? e.value.bytes : new Uint8Array()
+	})), x = (_?.forms ?? []).map((e) => ({
+		id: e.id,
+		name: i.getUserDefinedName(e.id),
+		className: e.classId ? i.getUserDefinedName(e.classId) : "",
+		comment: l(e.comment),
+		elements: e.elements.map((e) => ({
+			id: e.id,
+			name: i.getUserDefinedName(e.id),
+			type: i.getDataTypeName(e.dataType)
+		}))
+	}));
+	return {
+		classes: g,
+		globals: (o?.globalVariables ?? []).map((e) => d(e, i)),
+		structs: (o?.structs ?? []).map((e) => m(e, i)),
+		dllDeclares: (o?.dllDeclares ?? []).map((e) => h(e, i)),
+		constants: y,
+		resources: b,
+		forms: x,
+		libraries: (o?.libraries ?? []).map((e) => ({
+			name: e.name,
+			fileName: e.fileName,
+			version: e.version.join(".")
+		}))
+	};
+}
+//#endregion
+export { g as buildProgram };

package/dist/lib/epl/projectFileReader.d.ts

@@ -0,0 +1,23 @@
+import type { RawSection } from './model/section';
+export type EplCryptoType = 'estd' | 'ec' | 'unknown';
+/**
+ * The file carries an encryption header. Decryption (RC4 / EStd / EC) is a later milestone; the loader
+ * surfaces this so the UI can explain it. The EC branch still reads the password-hint string into {@link tip}.
+ */
+export declare class EplEncryptedError extends Error {
+    readonly cryptoType: EplCryptoType;
+    readonly tip?: string | undefined;
+    constructor(cryptoType: EplCryptoType, tip?: string | undefined);
+}
+/** The bytes aren't an e-language project file (main magic mismatch). */
+export declare class NotEplFileError extends Error {
+    constructor(message?: string);
+}
+export declare class ProjectFileReader {
+    private readonly r;
+    isFinish: boolean;
+    /** Set once EC decryption is wired up (later milestone); flips a few section layouts + dataLength. */
+    cryptEC: boolean;
+    constructor(bytes: Uint8Array);
+    readSection(): RawSection;
+}

package/dist/lib/epl/projectFileReader.js

@@ -0,0 +1,65 @@
+import { gbk as e } from "./io/encoding.js";
+import { BinaryReader as t } from "./io/binaryReader.js";
+//#region src/lib/epl/projectFileReader.ts
+var n = 353465113, r = 117469977, i = 1162630231, a = 1415007811, o = 1196576837, s = class extends Error {
+	cryptoType;
+	tip;
+	constructor(e, t) {
+		super("加密的易语言工程文件（暂未支持解密）"), this.cryptoType = e, this.tip = t, this.name = "EplEncryptedError";
+	}
+}, c = class extends Error {
+	constructor(e = "不是易语言工程文件") {
+		super(e), this.name = "NotEplFileError";
+	}
+}, l = class {
+	r;
+	isFinish = !1;
+	cryptEC = !1;
+	constructor(n) {
+		this.r = new t(n, e());
+		let r = this.r.readInt32(), l = this.r.readInt32();
+		if (r === i) {
+			if (l === 1) throw new s("estd");
+			if (l === 131073) {
+				let t = this.r.readInt32();
+				throw new s("ec", this.r.readStringWithFixedLength(t, e()));
+			}
+			throw new s("unknown");
+		}
+		if (r !== a || l !== o) throw new c();
+	}
+	readSection() {
+		if (this.isFinish) throw Error("已到文件末尾");
+		if (this.r.readInt32() !== n) throw Error("段 Magic 错误");
+		this.r.readInt32();
+		let e = this.r.readInt32(), t = u(e, this.r.readBytes(30));
+		this.r.readInt16(), this.r.readInt32();
+		let i = this.r.readInt32() !== 0;
+		this.r.readInt32();
+		let a = this.r.readInt32();
+		this.cryptEC && (a ^= 1), this.r.skip(40);
+		let o = this.r.readBytes(a);
+		return e === r && (this.isFinish = !0), {
+			key: e,
+			name: t,
+			isOptional: i,
+			data: o
+		};
+	}
+};
+function u(t, n) {
+	let i = n.slice();
+	if (t !== r) {
+		let e = [
+			t & 255,
+			t >> 8 & 255,
+			t >> 16 & 255,
+			t >> 24 & 255
+		];
+		for (let t = 0; t < i.length; t++) i[t] ^= e[(t + 1) % 4];
+	}
+	let a = i.indexOf(0);
+	return a === -1 && (a = i.length), e().decode(i.subarray(0, a));
+}
+//#endregion
+export { s as EplEncryptedError, c as NotEplFileError, l as ProjectFileReader };

package/dist/lib/epl/sections/code.d.ts

@@ -0,0 +1,20 @@
+import type { SectionBase, SectionType } from '../model/section';
+import { type EplVariable } from '../code/variable';
+import { type ClassInfo, type DllDeclareInfo, type LibraryRefInfo, type MethodInfo, type StructInfo } from '../code/structures';
+export interface CodeSection extends SectionBase {
+    kind: 'code';
+    /** Max allocated Id number (new Ids are this + 1); defaults to 0xFFFF. */
+    allocatedIdNum: number;
+    libraries: LibraryRefInfo[];
+    flag: number;
+    /** "_启动子程序" Id (EC files without editor info). */
+    mainMethod: number;
+    iconData: Uint8Array;
+    debugCommandParameters: string;
+    classes: ClassInfo[];
+    methods: MethodInfo[];
+    globalVariables: EplVariable[];
+    structs: StructInfo[];
+    dllDeclares: DllDeclareInfo[];
+}
+export declare const CodeSectionKey: SectionType<CodeSection>;

package/dist/lib/epl/sections/esystemInfo.d.ts

@@ -0,0 +1,14 @@
+import type { SectionBase, SectionType } from '../model/section';
+export interface ESystemInfoSection extends SectionBase {
+    kind: 'systemInfo';
+    /** [major, minor] of the e-language system that wrote the file. */
+    esystemVersion: [number, number];
+    /** 1=中文(GBK), 2=英语(ASCII), 3=中文(BIG5), 4=日文(SJIS). Drives {@link decoderForLanguage}. */
+    language: number;
+    /** [major, minor] of the .e project format. */
+    eprojectFormatVersion: [number, number];
+    /** 1=源码(.e), 3=模块(.ec). */
+    fileType: number;
+    projectType: number;
+}
+export declare const ESystemInfoKey: SectionType<ESystemInfoSection>;

package/dist/lib/epl/sections/losable.d.ts

@@ -0,0 +1,11 @@
+import type { SectionBase, SectionType } from '../model/section';
+export interface RemovedItem {
+    id: number;
+    name: string;
+}
+export interface LosableSection extends SectionBase {
+    kind: 'losable';
+    outFile: string;
+    removedItems: RemovedItem[];
+}
+export declare const LosableSectionKey: SectionType<LosableSection>;

package/dist/lib/epl/sections/projectConfig.d.ts

@@ -0,0 +1,23 @@
+import type { SectionBase, SectionType } from '../model/section';
+export interface ProjectConfigSection extends SectionBase {
+    kind: 'projectConfig';
+    /** Project name (NOT the section name). */
+    name: string;
+    description: string;
+    author: string;
+    zipCode: string;
+    address: string;
+    telephoneNumber: string;
+    faxNumber: string;
+    email: string;
+    homepage: string;
+    copyright: string;
+    /** [major, minor, build, revision]. */
+    version: [number, number, number, number];
+    /** Whether the compiled output writes the version resource (C#: stored as `ReadInt32() == 0`). */
+    writeVersion: boolean;
+    /** Compile-plugins field (fixed 20-byte string). */
+    compilePlugins: string;
+    exportPublicClassMethod: boolean;
+}
+export declare const ProjectConfigKey: SectionType<ProjectConfigSection>;

package/dist/lib/epl/sections/resource.d.ts

@@ -0,0 +1,57 @@
+import type { SectionBase, SectionType } from '../model/section';
+/**
+ * A constant's typed value. The high nibble of the constant `id` picks the family: 1 ⇒ 普通常量 (a type-tagged
+ * scalar — null / double / bool / DateTime / text), 2 ⇒ 图片资源, 3 ⇒ 声音资源 (both raw resource bytes).
+ */
+export type EplConstantValue = {
+    kind: 'null';
+} | {
+    kind: 'double';
+    value: number;
+} | {
+    kind: 'bool';
+    value: boolean;
+}
+/** OLE Automation date (days since 1899-12-30), rendered to `yyyy年MM月dd日…` for display. */
+ | {
+    kind: 'datetime';
+    oa: number;
+} | {
+    kind: 'string';
+    value: string;
+} | {
+    kind: 'image';
+    bytes: Uint8Array;
+} | {
+    kind: 'sound';
+    bytes: Uint8Array;
+};
+/** A project constant / image / sound resource (the high nibble of `id` distinguishes them). */
+export interface EplConstant {
+    id: number;
+    flags: number;
+    name: string;
+    comment: string;
+    value: EplConstantValue;
+}
+/** A control or menu on a form (only id/dataType/name kept — enough for name resolution). */
+export interface EplFormElement {
+    id: number;
+    dataType: number;
+    name: string;
+}
+export interface EplForm {
+    id: number;
+    memoryAddress: number;
+    /** The associated window class id. */
+    classId: number;
+    name: string;
+    comment: string;
+    elements: EplFormElement[];
+}
+export interface ResourceSection extends SectionBase {
+    kind: 'resource';
+    forms: EplForm[];
+    constants: EplConstant[];
+}
+export declare const ResourceSectionKey: SectionType<ResourceSection>;

package/dist/lib/fb2.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Hand-rolled, zero-dependency FictionBook 2 (.fb2) parser for the side viewer.
+ *
+ * FB2 is an XML e-book format. This walks the `<body>` tree, mapping the FB2 elements to a small whitelist of
+ * HTML tags (everything else falls through to its inner content), resolves `<image>` references to the inline
+ * `<binary>` base64 blobs as data URLs, and returns a COMPLETE, self-contained HTML document string ready to
+ * drop into a sandboxed iframe — it carries a `script-src 'none'` CSP and only ever emits known tags with
+ * escaped text, so the book's markup can't inject anything executable.
+ */
+export interface ParsedFb2 {
+    title: string;
+    html: string;
+}
+export declare function parseFb2(text: string): ParsedFb2;