Files
readest/apps/readest-app/src/utils/txt.ts
T
Huang Xin ae42dcb53a fix(txt): parse author from txt filename and use edited metadata on fallback cover (#4095) (#4102)
When importing a `.txt` file the author field stayed empty unless the
text content itself contained an `作者:…` header, even when the filename
already encoded it. Common Chinese naming patterns like `《书名》作者:张三.txt`,
`《书名》[张三].txt`, or `《书名》张三.txt` now contribute the author when
the file body doesn't.

- Added `extractTxtFilenameMetadata` in `utils/txt.ts` and replaced the
  ad-hoc `extractBookTitle` regex used by both convertSmallFile and
  convertLargeFile. Content-extracted author still wins; the filename
  author is the next fallback before the caller-provided one.
- `BookCover` now reads `book.author || book.metadata?.author` so the
  author typed into the metadata edit dialog shows on auto-generated
  fallback covers when the original `book.author` was empty.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-09 05:34:56 +02:00

1030 lines
33 KiB
TypeScript
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import { partialMD5 } from './md5';
import { getBaseFilename } from './path';
import { detectLanguage } from './lang';
import { configureZip } from './zip';
interface Metadata {
bookTitle: string;
author: string;
language: string;
identifier: string;
}
// Pull a title and (optionally) an author out of a TXT filename. Recognized
// patterns center on Chinese conventions where books are named with the title
// in 《》 and an author tacked on, e.g. 《书名》作者:张三.txt, 《书名》[张三].txt,
// 《书名》张三.txt. Falls back to the base filename as the title when no
// 《》 are present.
export const extractTxtFilenameMetadata = (
filename: string,
): { title: string; author?: string } => {
const base = getBaseFilename(filename);
const cjkMatch = base.match(/《([^》]+)》(.*)/);
if (!cjkMatch) {
return { title: base };
}
const title = cjkMatch[1]!.trim();
const rest = (cjkMatch[2] ?? '').trim();
const author = parseAuthorFragment(rest);
return author ? { title, author } : { title };
};
const parseAuthorFragment = (text: string): string => {
if (!text) return '';
// 作者:X / 作者:X / 作者 X — labeled author wins
const labeled = text.match(/作者\s*[:\s]\s*(.+)$/);
if (labeled) return stripWrappingPunctuation(labeled[1]!);
// [X] (X) 【X】 X)[X — bracketed author
const bracketed = text.match(/[[((【[]\s*([^\]))】]]+?)\s*[\]))】]]/);
if (bracketed) return stripWrappingPunctuation(bracketed[1]!);
// bare token — strip any leading separator like " - " / "·" / "-"
return stripWrappingPunctuation(text);
};
const stripWrappingPunctuation = (text: string): string => {
const trimmed = text.trim();
try {
return trimmed.replace(/^[\p{P}\p{S}\s]+|[\p{P}\p{S}\s]+$/gu, '');
} catch {
return trimmed;
}
};
interface Chapter {
title: string;
content: string;
isVolume: boolean;
}
interface Txt2EpubOptions {
file: File;
author?: string;
language?: string;
}
interface ExtractChapterOptions {
linesBetweenSegments: number;
fallbackParagraphsPerChapter: number;
}
export interface ConversionResult {
file: File;
bookTitle: string;
chapterCount: number;
language: string;
}
const zipWriteOptions = {
lastAccessDate: new Date(0),
lastModDate: new Date(0),
};
const LARGE_TXT_THRESHOLD_BYTES = 8 * 1024 * 1024;
const HEADER_TEXT_MAX_CHARS = 1024;
const HEADER_TEXT_MAX_BYTES = 128 * 1024;
const ENCODING_HEAD_SAMPLE_BYTES = 64 * 1024;
const ENCODING_MID_SAMPLE_BYTES = 8192;
const escapeXml = (str: string) => {
if (!str) return '';
return str
.replace(/&/g, '&amp;')
.replace(/</g, '&lt;')
.replace(/>/g, '&gt;')
.replace(/"/g, '&quot;')
.replace(/'/g, '&apos;');
};
export class TxtToEpubConverter {
public async convert(options: Txt2EpubOptions): Promise<ConversionResult> {
if (options.file.size <= LARGE_TXT_THRESHOLD_BYTES) {
return await this.convertSmallFile(options);
}
return await this.convertLargeFile(options);
}
private async convertSmallFile(options: Txt2EpubOptions): Promise<ConversionResult> {
const { file: txtFile, author: providedAuthor, language: providedLanguage } = options;
const fileContent = await txtFile.arrayBuffer();
const detectedEncoding = this.detectEncoding(fileContent) || 'utf-8';
const runtimeEncoding = this.resolveSupportedEncoding(detectedEncoding);
// console.log(`Detected encoding: ${detectedEncoding}, runtime encoding: ${runtimeEncoding}`);
const decoder = new TextDecoder(runtimeEncoding);
const txtContent = decoder.decode(fileContent).trim();
const filenameMeta = extractTxtFilenameMetadata(txtFile.name);
const bookTitle = filenameMeta.title;
const fileName = `${bookTitle}.epub`;
const fileHeader = txtContent.slice(0, 1024);
const authorMatch =
fileHeader.match(/[【\[]?作者[】\]]?[:\s]\s*(.+)\r?\n/) ||
fileHeader.match(/[【\[]?\s*(.+)\s+著\s*[】\]]?\r?\n/);
let matchedAuthor = authorMatch ? authorMatch[1]!.trim() : '';
try {
matchedAuthor = matchedAuthor.replace(/^[\p{P}\p{S}]+|[\p{P}\p{S}]+$/gu, '');
} catch {}
const author = matchedAuthor || filenameMeta.author || providedAuthor || '';
const language = providedLanguage || detectLanguage(fileHeader);
// console.log(`Detected language: ${language}`);
const identifier = await partialMD5(txtFile);
const metadata = { bookTitle, author, language, identifier };
const fallbackParagraphsPerChapter = 100;
let chapters = this.extractChapters(txtContent, metadata, {
linesBetweenSegments: 8,
fallbackParagraphsPerChapter,
});
if (chapters.length === 0) {
throw new Error('No chapters detected.');
}
if (chapters.length <= 1) {
const probeChapterCount = this.probeChapterCount(txtContent, metadata, {
linesBetweenSegments: 7,
fallbackParagraphsPerChapter,
});
chapters = this.extractChapters(txtContent, metadata, {
linesBetweenSegments: probeChapterCount > 1 ? 7 : 6,
fallbackParagraphsPerChapter,
});
}
const blob = await this.createEpub(chapters, metadata);
return {
file: new File([blob], fileName),
bookTitle,
chapterCount: chapters.length,
language,
};
}
private async convertLargeFile(options: Txt2EpubOptions): Promise<ConversionResult> {
const { file: txtFile, author: providedAuthor, language: providedLanguage } = options;
const detectedEncoding = (await this.detectEncodingFromFile(txtFile)) || 'utf-8';
const runtimeEncoding = this.resolveSupportedEncoding(detectedEncoding);
// console.log(`Detected encoding: ${detectedEncoding}, runtime encoding: ${runtimeEncoding}`);
const filenameMeta = extractTxtFilenameMetadata(txtFile.name);
const bookTitle = filenameMeta.title;
const fileName = `${bookTitle}.epub`;
const fileHeader = await this.readHeaderTextFromFile(
txtFile,
runtimeEncoding,
HEADER_TEXT_MAX_CHARS,
HEADER_TEXT_MAX_BYTES,
);
const { author, language } = this.extractAuthorAndLanguage(
fileHeader,
filenameMeta.author ?? providedAuthor,
providedLanguage,
);
// console.log(`Detected language: ${language}`);
const identifier = await partialMD5(txtFile);
const metadata = { bookTitle, author, language, identifier };
const fallbackParagraphsPerChapter = 100;
let chapters = await this.extractChaptersFromFileBySegments(
txtFile,
runtimeEncoding,
metadata,
{
linesBetweenSegments: 8,
fallbackParagraphsPerChapter,
},
);
if (chapters.length === 0) {
throw new Error('No chapters detected.');
}
if (chapters.length <= 1) {
const probeChapterCount = await this.probeChapterCountFromFileBySegments(
txtFile,
runtimeEncoding,
metadata,
{
linesBetweenSegments: 7,
fallbackParagraphsPerChapter,
},
);
chapters = await this.extractChaptersFromFileBySegments(txtFile, runtimeEncoding, metadata, {
linesBetweenSegments: probeChapterCount > 1 ? 7 : 6,
fallbackParagraphsPerChapter,
});
}
const blob = await this.createEpub(chapters, metadata);
return {
file: new File([blob], fileName),
bookTitle,
chapterCount: chapters.length,
language,
};
}
private extractChapters(
txtContent: string,
metadata: Metadata,
option: ExtractChapterOptions,
): Chapter[] {
const { linesBetweenSegments } = option;
const segmentRegex = this.createSegmentRegex(linesBetweenSegments);
const chapters: Chapter[] = [];
const segments = txtContent.split(segmentRegex);
for (const segment of segments) {
const segmentChapters = this.extractChaptersFromSegment(
segment,
metadata,
option,
chapters.length,
);
chapters.push(...segmentChapters);
}
return chapters;
}
private probeChapterCount(
txtContent: string,
metadata: Metadata,
option: ExtractChapterOptions,
): number {
const { linesBetweenSegments } = option;
const segmentRegex = this.createSegmentRegex(linesBetweenSegments);
let chapterCount = 0;
const segments = txtContent.split(segmentRegex);
for (const segment of segments) {
chapterCount += this.probeChapterCountFromSegment(segment, metadata, option);
if (chapterCount > 1) {
return chapterCount;
}
}
return chapterCount;
}
private async extractChaptersFromFileBySegments(
txtFile: File,
encoding: string,
metadata: Metadata,
option: ExtractChapterOptions,
): Promise<Chapter[]> {
const chapters: Chapter[] = [];
for await (const segment of this.iterateSegmentsFromFile(
txtFile,
encoding,
option.linesBetweenSegments,
)) {
const segmentChapters = this.extractChaptersFromSegment(
segment,
metadata,
option,
chapters.length,
);
chapters.push(...segmentChapters);
}
return chapters;
}
private async probeChapterCountFromFileBySegments(
txtFile: File,
encoding: string,
metadata: Metadata,
option: ExtractChapterOptions,
): Promise<number> {
let chapterCount = 0;
for await (const segment of this.iterateSegmentsFromFile(
txtFile,
encoding,
option.linesBetweenSegments,
)) {
chapterCount += this.probeChapterCountFromSegment(segment, metadata, option);
if (chapterCount > 1) {
return chapterCount;
}
}
return chapterCount;
}
private async detectEncodingFromFile(file: File): Promise<string | undefined> {
const headSampleSize = Math.min(file.size, ENCODING_HEAD_SAMPLE_BYTES);
const headBuffer = await file.slice(0, headSampleSize).arrayBuffer();
const headSample = new Uint8Array(headBuffer);
try {
this.assertStrictUtf8Sample(headSample);
if (file.size > headSampleSize * 2) {
const midSampleSize = Math.min(ENCODING_MID_SAMPLE_BYTES, file.size - headSampleSize);
const midSampleStart = Math.floor((file.size - midSampleSize) / 2);
const midBuffer = await file
.slice(midSampleStart, midSampleStart + midSampleSize)
.arrayBuffer();
this.assertStrictUtf8Sample(new Uint8Array(midBuffer));
}
return 'utf-8';
} catch {
let validBytes = 0;
let checkedBytes = 0;
const sampleSize = Math.min(headSample.length, 10000);
for (let i = 0; i < sampleSize; i++) {
try {
new TextDecoder('utf-8', { fatal: true }).decode(headSample.slice(i, i + 100));
validBytes += 100;
checkedBytes += 100;
i += 99;
} catch {
checkedBytes++;
}
}
const validPercentage = checkedBytes > 0 ? (validBytes / checkedBytes) * 100 : 0;
console.log(`UTF-8 validity: ${validPercentage.toFixed(2)}%`);
if (validPercentage > 80) {
console.log('Treating as UTF-8 despite some invalid sequences');
return 'utf-8';
}
}
if (headSample[0] === 0xff && headSample[1] === 0xfe) {
return 'utf-16le';
}
if (headSample[0] === 0xfe && headSample[1] === 0xff) {
return 'utf-16be';
}
if (headSample[0] === 0xef && headSample[1] === 0xbb && headSample[2] === 0xbf) {
return 'utf-8';
}
const sample = headSample.slice(0, Math.min(1024, headSample.length));
let highByteCount = 0;
for (let i = 0; i < sample.length; i++) {
if (sample[i]! >= 0x80) {
highByteCount++;
}
}
const highByteRatio = sample.length > 0 ? highByteCount / sample.length : 0;
if (highByteRatio > 0.3) {
return 'gbk';
}
if (highByteRatio > 0.1) {
let sjisPattern = false;
for (let i = 0; i < sample.length - 1; i++) {
const b1 = sample[i]!;
const b2 = sample[i + 1]!;
if (
((b1 >= 0x81 && b1 <= 0x9f) || (b1 >= 0xe0 && b1 <= 0xfc)) &&
((b2 >= 0x40 && b2 <= 0x7e) || (b2 >= 0x80 && b2 <= 0xfc))
) {
sjisPattern = true;
break;
}
}
if (sjisPattern) {
return 'shift-jis';
}
return 'gb18030';
}
return 'utf-8';
}
private async readHeaderTextFromFile(
file: File,
encoding: string,
maxChars: number,
maxBytes: number,
): Promise<string> {
const decoder = new TextDecoder(encoding);
const headerBytes = await file.slice(0, Math.min(file.size, maxBytes)).arrayBuffer();
return decoder.decode(headerBytes).slice(0, maxChars).trim();
}
private async *iterateSegmentsFromFile(
file: File,
encoding: string,
linesBetweenSegments: number,
): AsyncGenerator<string> {
const reader = file.stream().getReader();
const decoder = new TextDecoder(encoding);
const segmentRegex = this.createSegmentRegex(linesBetweenSegments);
let pending = '';
let completed = false;
try {
while (true) {
const { value, done } = await reader.read();
if (done) {
completed = true;
break;
}
if (!value) continue;
pending += decoder.decode(value, { stream: true });
const consumed = this.consumeCompleteSegments(pending, segmentRegex);
pending = consumed.pending;
for (const segment of consumed.segments) {
yield segment;
}
}
pending += decoder.decode();
const consumed = this.consumeCompleteSegments(pending, segmentRegex);
for (const segment of consumed.segments) {
yield segment;
}
if (consumed.pending) {
yield consumed.pending;
}
} finally {
if (!completed) {
try {
await reader.cancel();
} catch {}
}
reader.releaseLock();
}
}
*iterateSegmentsFromTextChunks(
chunks: Iterable<string>,
linesBetweenSegments: number,
): Generator<string> {
const segmentRegex = this.createSegmentRegex(linesBetweenSegments);
let pending = '';
for (const chunk of chunks) {
pending += chunk;
const consumed = this.consumeCompleteSegments(pending, segmentRegex);
pending = consumed.pending;
for (const segment of consumed.segments) {
yield segment;
}
}
if (pending) {
yield pending;
}
}
private consumeCompleteSegments(
pending: string,
segmentRegex: RegExp,
): { segments: string[]; pending: string } {
const segments: string[] = [];
let match = segmentRegex.exec(pending);
while (match) {
segments.push(pending.slice(0, match.index));
pending = pending.slice(match.index + match[0].length);
segmentRegex.lastIndex = 0;
match = segmentRegex.exec(pending);
}
return { segments, pending };
}
private extractAuthorAndLanguage(
fileHeader: string,
providedAuthor?: string,
providedLanguage?: string,
): { author: string; language: string } {
const authorMatch =
fileHeader.match(/[【\[]?作者[】\]]?[:\s]\s*(.+)\r?\n/) ||
fileHeader.match(/[【\[]?\s*(.+)\s+著\s*[】\]]?\r?\n/);
let matchedAuthor = authorMatch ? authorMatch[1]!.trim() : providedAuthor || '';
try {
matchedAuthor = matchedAuthor.replace(/^[\p{P}\p{S}]+|[\p{P}\p{S}]+$/gu, '');
} catch {}
const author = matchedAuthor || providedAuthor || '';
const language = providedLanguage || detectLanguage(fileHeader);
return { author, language };
}
private extractChaptersFromSegment(
segment: string,
metadata: Metadata,
option: ExtractChapterOptions,
chapterOffset: number,
): Chapter[] {
const { language } = metadata;
const { fallbackParagraphsPerChapter } = option;
let sanitizedSegment = segment;
let previousSegment: string;
do {
previousSegment = sanitizedSegment;
sanitizedSegment = sanitizedSegment.replace(/<!--.*?-->/gs, '');
} while (sanitizedSegment !== previousSegment);
const trimmedSegment = sanitizedSegment.trim();
if (!trimmedSegment) return [];
const chapterRegexps = this.createChapterRegexps(language);
let matches: string[] = [];
for (const chapterRegex of chapterRegexps) {
const tryMatches = trimmedSegment.split(chapterRegex);
if (this.isGoodMatches(tryMatches)) {
matches = this.joinAroundUndefined(tryMatches);
break;
}
}
if (matches.length === 0 && fallbackParagraphsPerChapter > 0) {
const chapters: Chapter[] = [];
const paragraphs = trimmedSegment.split(/\n+/);
const totalParagraphs = paragraphs.length;
for (let i = 0; i < totalParagraphs; i += fallbackParagraphsPerChapter) {
const chunks = paragraphs.slice(i, i + fallbackParagraphsPerChapter);
const formattedSegment = this.formatSegment(chunks.join('\n'));
const title = `${chapterOffset + chapters.length + 1}`;
const content = `<h2>${title}</h2><p>${formattedSegment}</p>`;
chapters.push({ title, content, isVolume: false });
}
return chapters;
}
const segmentChapters: Chapter[] = [];
for (let j = 1; j < matches.length; j += 2) {
const title = matches[j]?.trim() || '';
const content = matches[j + 1]?.trim() || '';
let isVolume = false;
if (language === 'zh') {
isVolume = /第[零〇一二三四五六七八九十百千万0-9]+(卷|本|册|部)/.test(title);
} else {
isVolume = /\b(Part|Volume|Book)\b/i.test(title);
}
const headTitle = isVolume ? `<h1>${title}</h1>` : `<h2>${title}</h2>`;
const formattedSegment = this.formatSegment(content);
segmentChapters.push({
title: escapeXml(title),
content: `${headTitle}<p>${formattedSegment}</p>`,
isVolume,
});
}
if (matches[0] && matches[0].trim()) {
const initialContent = matches[0].trim();
const firstLine = initialContent.split('\n')[0]!.trim();
const segmentTitle =
(firstLine.length > 16 ? initialContent.split(/[\n\s\p{P}]/u)[0]!.trim() : firstLine) ||
initialContent.slice(0, 16);
const formattedSegment = this.formatSegment(initialContent);
segmentChapters.unshift({
title: escapeXml(segmentTitle),
content: `<h3></h3><p>${formattedSegment}</p>`,
isVolume: false,
});
}
return segmentChapters;
}
private probeChapterCountFromSegment(
segment: string,
metadata: Metadata,
option: ExtractChapterOptions,
): number {
const { language } = metadata;
const { fallbackParagraphsPerChapter } = option;
let sanitizedSegment = segment;
let previousSegment: string;
do {
previousSegment = sanitizedSegment;
sanitizedSegment = sanitizedSegment.replace(/<!--.*?-->/gs, '');
} while (sanitizedSegment !== previousSegment);
const trimmedSegment = sanitizedSegment.trim();
if (!trimmedSegment) return 0;
const chapterRegexps = this.createChapterRegexps(language);
let matches: string[] = [];
for (const chapterRegex of chapterRegexps) {
const tryMatches = trimmedSegment.split(chapterRegex);
if (this.isGoodMatches(tryMatches)) {
matches = this.joinAroundUndefined(tryMatches);
break;
}
}
if (matches.length === 0 && fallbackParagraphsPerChapter > 0) {
const paragraphs = trimmedSegment.split(/\n+/);
return Math.ceil(paragraphs.length / fallbackParagraphsPerChapter);
}
let chapterCount = Math.floor(matches.length / 2);
if (matches[0] && matches[0].trim()) {
chapterCount++;
}
return chapterCount;
}
private createSegmentRegex(linesBetweenSegments: number): RegExp {
return new RegExp(`(?:\\r?\\n){${linesBetweenSegments},}|-{8,}\r?\n`);
}
private formatSegment(segment: string): string {
segment = escapeXml(segment);
return segment
.replace(/-{8,}|_{8,}/g, '\n')
.split(/\n+/)
.map((line) => line.trim())
.filter((line) => line)
.join('</p><p>');
}
private joinAroundUndefined(arr: (string | undefined)[]): string[] {
return arr.reduce<string[]>((acc, curr, i, src) => {
if (
curr === undefined &&
i > 0 &&
i < src.length - 1 &&
src[i - 1] !== undefined &&
src[i + 1] !== undefined
) {
acc[acc.length - 1] += src[i + 1]!;
return acc;
}
if (curr !== undefined && (i === 0 || src[i - 1] !== undefined)) {
acc.push(curr);
}
return acc;
}, []);
}
private isGoodMatches(matches: string[], maxLength: number = 100000): boolean {
const meaningfulParts = matches.filter((part) => part && part.trim().length > 0);
if (meaningfulParts.length <= 1) return false;
const hasLongParts = meaningfulParts.some((part) => part.length > maxLength);
return !hasLongParts;
}
private createChapterRegexps(language: string): RegExp[] {
const chapterRegexps: RegExp[] = [];
if (language === 'zh') {
chapterRegexps.push(
new RegExp(
String.raw`(?:^|\n)\s*` +
'(' +
[
String.raw`第[  零〇一二三四五六七八九十0-9][  零〇一二三四五六七八九十百千万0-9]*(?:[章卷节回讲篇封本册部话])(?:[::、  \(\)0-9]*[^\n-]{0,36})(?!\S)`,
String.raw`(?:楔子|前言|简介|引言|序言|序章|总论|概论|后记|番外篇|番外|外传)(?:[:  ][^\n-]{0,36})?(?!\S)`,
String.raw`chapter[\s.]*[0-9]+(?:[:.  ]+[^\n-]{0,50})?(?!\S)`,
].join('|') +
')',
'gui',
),
);
chapterRegexps.push(
new RegExp(
String.raw`(?:^|\n)\s*` +
'(' +
[
String.raw`[一二三四五六七八九十][零〇一二三四五六七八九十百千万]?[::、  ][^\n-]{0,36}(?=\n|$)`,
String.raw`[0-9]+[^\n]{0,16}(?=\n|$)`,
].join('|') +
')',
'gu',
),
);
return chapterRegexps;
}
const chapterKeywords = ['Chapter', 'Part', 'Section', 'Book', 'Volume', 'Act'];
const prefaceKeywords = [
'Prologue',
'Epilogue',
'Introduction',
'Foreword',
'Preface',
'Afterword',
];
const numberPattern = String.raw`(?:\d+|(?:[IVXLCDM]{2,}|V|X|L|C|D|M)\b)`;
const dotNumberPattern = String.raw`\.\d{1,4}`;
const titlePattern = String.raw`[^\n]{0,50}`;
const normalChapterPattern = chapterKeywords
.map(
(k) =>
String.raw`${k}\s*(?:${numberPattern}|${dotNumberPattern})(?:[:.\-–—]?\s*${titlePattern})?`,
)
.join('|');
const prefacePattern = prefaceKeywords
.map((k) => String.raw`${k}(?:[:.\-–—]?\s*${titlePattern})?`)
.join('|');
const combinedPattern = String.raw`(?:^|\n)(${normalChapterPattern}|${prefacePattern})(?=\s|$)`;
chapterRegexps.push(new RegExp(combinedPattern, 'gi'));
// Second-tier: bare numbered headings like "1.1The Elements" or "1Building Data"
// Dotted numbers (1.1, 1.2.3) allow an optional space before the title.
// Single bare digits (1, 2) require the title to start immediately (no space)
// to avoid matching footnotes like "1 The Lisp...".
const numberedHeadingPattern = String.raw`(?:^|\n)(\d+\.\d+(?:\.\d+)* ?[A-Z][^\n]{0,80}|\d+[A-Z][^\n]{0,80})`;
chapterRegexps.push(new RegExp(numberedHeadingPattern, 'g'));
return chapterRegexps;
}
private async createEpub(chapters: Chapter[], metadata: Metadata): Promise<Blob> {
await configureZip();
const { BlobWriter, TextReader, ZipWriter } = await import('@zip.js/zip.js');
const { bookTitle, author, language, identifier } = metadata;
const zipWriter = new ZipWriter(new BlobWriter('application/epub+zip'), {
extendedTimestamp: false,
});
await zipWriter.add('mimetype', new TextReader('application/epub+zip'), zipWriteOptions);
// Add META-INF/container.xml
const containerXml = `<?xml version="1.0" encoding="UTF-8"?>
<container xmlns="urn:oasis:names:tc:opendocument:xmlns:container" version="1.0">
<rootfiles>
<rootfile full-path="content.opf" media-type="application/oebps-package+xml"/>
</rootfiles>
</container>`.trim();
await zipWriter.add('META-INF/container.xml', new TextReader(containerXml), zipWriteOptions);
// Create navigation points for TOC
let isNested = false;
let navPoints = ``;
for (let i = 0; i < chapters.length; i++) {
const id = `chapter${i + 1}`;
const playOrder = i + 1;
if (chapters[i]!.isVolume && isNested) {
navPoints += `</navPoint>\n`;
isNested = !isNested;
}
navPoints +=
`<navPoint id="navPoint-${id}" playOrder="${playOrder}">\n` +
`<navLabel><text>${chapters[i]!.title}</text></navLabel>\n` +
`<content src="./OEBPS/${id}.xhtml" />\n`;
if (chapters[i]!.isVolume && !isNested) {
isNested = !isNested;
} else {
navPoints += `</navPoint>\n`;
}
}
if (isNested) {
navPoints += `</navPoint>`;
}
// Add NCX file (table of contents)
const tocNcx = `<?xml version="1.0" encoding="UTF-8"?>
<ncx xmlns="http://www.daisy.org/z3986/2005/ncx/" version="2005-1">
<head>
<meta name="dtb:uid" content="book-id" />
<meta name="dtb:depth" content="1" />
<meta name="dtb:totalPageCount" content="0" />
<meta name="dtb:maxPageNumber" content="0" />
</head>
<docTitle>
<text>${escapeXml(bookTitle)}</text>
</docTitle>
<docAuthor>
<text>${escapeXml(author)}</text>
</docAuthor>
<navMap>
${navPoints}
</navMap>
</ncx>`.trim();
await zipWriter.add('toc.ncx', new TextReader(tocNcx), zipWriteOptions);
// Create manifest and spine items
const manifest = chapters
.map(
(_, index) => `
<item id="chap${index + 1}" href="OEBPS/chapter${index + 1}.xhtml" media-type="application/xhtml+xml"/>
`,
)
.join('\n')
.trim();
const spine = chapters
.map(
(_, index) => `
<itemref idref="chap${index + 1}"/>`,
)
.join('\n')
.trim();
// Add CSS stylesheet
const css = `
body { line-height: 1.6; font-size: 1em; font-family: 'Arial', sans-serif; text-align: justify; }
p { text-indent: 2em; margin: 0; }
`;
await zipWriter.add('style.css', new TextReader(css), zipWriteOptions);
// Add chapter files
for (let i = 0; i < chapters.length; i++) {
const chapter = chapters[i]!;
const lang = language;
const chapterContent = `<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="${lang}" xml:lang="${lang}">
<head>
<title>${chapter.title}</title>
<link rel="stylesheet" type="text/css" href="../style.css"/>
</head>
<body>${chapter.content}</body>
</html>`.trim();
await zipWriter.add(
`OEBPS/chapter${i + 1}.xhtml`,
new TextReader(chapterContent),
zipWriteOptions,
);
}
const tocManifest = `<item id="ncx" href="toc.ncx" media-type="application/x-dtbncx+xml"/>`;
const styleManifest = `<item id="css" href="style.css" media-type="text/css"/>`;
// Add content.opf file
const contentOpf = `<?xml version="1.0" encoding="UTF-8"?>
<package xmlns="http://www.idpf.org/2007/opf" unique-identifier="book-id" version="2.0">
<metadata xmlns:dc="http://purl.org/dc/elements/1.1/">
<dc:title>${escapeXml(bookTitle)}</dc:title>
<dc:language>${language}</dc:language>
<dc:creator>${escapeXml(author)}</dc:creator>
<dc:identifier id="book-id">${identifier}</dc:identifier>
</metadata>
<manifest>
${manifest}
${tocManifest}
${styleManifest}
</manifest>
<spine toc="ncx">
${spine}
</spine>
</package>`.trim();
await zipWriter.add('content.opf', new TextReader(contentOpf), zipWriteOptions);
return await zipWriter.close();
}
private detectEncoding(buffer: ArrayBuffer): string | undefined {
const utf8HeadSampleSize = Math.min(buffer.byteLength, 64 * 1024);
const utf8HeadSample = buffer.slice(0, utf8HeadSampleSize);
try {
this.assertStrictUtf8Sample(new Uint8Array(utf8HeadSample));
if (buffer.byteLength > utf8HeadSampleSize * 2) {
const midSampleSize = Math.min(8192, buffer.byteLength - utf8HeadSampleSize);
const midSampleStart = Math.floor((buffer.byteLength - midSampleSize) / 2);
const midSample = buffer.slice(midSampleStart, midSampleStart + midSampleSize);
this.assertStrictUtf8Sample(new Uint8Array(midSample));
}
return 'utf-8';
} catch {
const uint8Array = new Uint8Array(buffer);
// Try tolerant UTF-8 detection - check if most of it is valid UTF-8
let validBytes = 0;
let checkedBytes = 0;
const sampleSize = Math.min(uint8Array.length, 10000);
for (let i = 0; i < sampleSize; i++) {
try {
new TextDecoder('utf-8', { fatal: true }).decode(uint8Array.slice(i, i + 100));
validBytes += 100;
checkedBytes += 100;
i += 99;
} catch {
checkedBytes++;
}
}
const validPercentage = checkedBytes > 0 ? (validBytes / checkedBytes) * 100 : 0;
console.log(`UTF-8 validity: ${validPercentage.toFixed(2)}%`);
// If more than 80% is valid UTF-8, consider it UTF-8 with some corruption
if (validPercentage > 80) {
console.log('Treating as UTF-8 despite some invalid sequences');
return 'utf-8';
}
// If UTF-8 decoding fails, try to detect other encodings
}
const headerBytes = new Uint8Array(buffer.slice(0, 4));
if (headerBytes[0] === 0xff && headerBytes[1] === 0xfe) {
return 'utf-16le';
}
if (headerBytes[0] === 0xfe && headerBytes[1] === 0xff) {
return 'utf-16be';
}
if (headerBytes[0] === 0xef && headerBytes[1] === 0xbb && headerBytes[2] === 0xbf) {
return 'utf-8';
}
// Analyze a sample of the content to guess between common East Asian encodings
// If the content has a high ratio of bytes in the 0x80-0xFF range, it's likely GBK/GB18030
const sample = new Uint8Array(buffer.slice(0, Math.min(1024, buffer.byteLength)));
let highByteCount = 0;
for (let i = 0; i < sample.length; i++) {
if (sample[i]! >= 0x80) {
highByteCount++;
}
}
const highByteRatio = highByteCount / sample.length;
if (highByteRatio > 0.3) {
return 'gbk';
}
if (highByteRatio > 0.1) {
let sjisPattern = false;
for (let i = 0; i < sample.length - 1; i++) {
const b1 = sample[i]!;
const b2 = sample[i + 1]!;
if (
((b1 >= 0x81 && b1 <= 0x9f) || (b1 >= 0xe0 && b1 <= 0xfc)) &&
((b2 >= 0x40 && b2 <= 0x7e) || (b2 >= 0x80 && b2 <= 0xfc))
) {
sjisPattern = true;
break;
}
}
if (sjisPattern) {
return 'shift-jis';
}
return 'gb18030';
}
return 'utf-8';
}
private assertStrictUtf8Sample(sample: Uint8Array): void {
const decoder = new TextDecoder('utf-8', { fatal: true });
try {
decoder.decode(sample);
return;
} catch {
// Sampling may start/end inside a multibyte code point.
// Retry a few boundary offsets while keeping most bytes untouched.
const maxOffset = Math.min(3, sample.length - 1);
for (let startOffset = 0; startOffset <= maxOffset; startOffset++) {
for (let endOffset = 0; endOffset <= maxOffset; endOffset++) {
if (startOffset === 0 && endOffset === 0) continue;
const end = sample.length - endOffset;
if (end - startOffset < 16) continue;
try {
decoder.decode(sample.subarray(startOffset, end));
return;
} catch {
// continue trying other offsets
}
}
}
throw new Error('invalid utf-8 sample');
}
}
private isEncodingSupported(encoding: string): boolean {
try {
new TextDecoder(encoding);
return true;
} catch {
return false;
}
}
private resolveSupportedEncoding(detectedEncoding: string): string {
const normalized = detectedEncoding.toLowerCase();
const candidates = [
normalized,
...(normalized === 'gbk' ? ['gb18030', 'gb2312'] : []),
...(normalized === 'gb18030' ? ['gbk', 'gb2312'] : []),
...(normalized === 'shift-jis' ? ['shift_jis', 'sjis'] : []),
...(normalized === 'utf-16' ? ['utf-16le', 'utf-16be'] : []),
'utf-8',
];
for (const encoding of candidates) {
if (this.isEncodingSupported(encoding)) {
return encoding;
}
}
return 'utf-8';
}
}