wolfy-reader 0.1.0

package/dist/formats/text/index.d.ts

@@ -0,0 +1,11 @@
+import type { BookFormat } from '../../core/index.ts';
+/**
+ * Plain-text format. The seam probe (PLAN M4-1): TXT synthesizes everything the
+ * `Book` model needs — id-addressed sections, a coarse TOC, minimal metadata —
+ * from a byte stream that has no container, no manifest and no markup, proving the
+ * decoder seam is not EPUB-shaped. Sections are emitted as XHTML (paragraphs and
+ * chapter headings) so the existing view renders them untouched; the format holds
+ * no `resolve` (plain text references nothing) and no resources.
+ */
+export declare const text: BookFormat;
+//# sourceMappingURL=index.d.ts.map

package/dist/formats/text/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/formats/text/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,UAAU,EAA8C,MAAM,qBAAqB,CAAC;AAIxG;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,EAAE,UAoClB,CAAC"}

package/dist/formats/text/index.js

@@ -0,0 +1,201 @@
+/*! wolfy-reader v0.1.0 | @license MIT | (c) Vitaliy Tkachuk | github.com/vitaliy-tkachuk/wolfy-reader */
+import { sectionLookup } from '../../core/lookup.js';
+import { collapseWhitespace, escapeXmlText } from '../../core/text.js';
+/**
+ * Plain-text format. The seam probe (PLAN M4-1): TXT synthesizes everything the
+ * `Book` model needs — id-addressed sections, a coarse TOC, minimal metadata —
+ * from a byte stream that has no container, no manifest and no markup, proving the
+ * decoder seam is not EPUB-shaped. Sections are emitted as XHTML (paragraphs and
+ * chapter headings) so the existing view renders them untouched; the format holds
+ * no `resolve` (plain text references nothing) and no resources.
+ */
+export const text = {
+    name: 'text',
+    async sniff(source) {
+        // A conservative last-resort claim: reject anything that is plainly another
+        // format (zip/EPUB, PDF, an XML/HTML document like FB2/XHTML) or binary
+        // (an unmarked NUL byte), and otherwise accept. Registered after richer
+        // formats, so this only sees bytes nothing else claimed.
+        const head = await source.read(0, Math.min(source.size, 512));
+        if (head.length === 0)
+            return false;
+        if (hasBom(head))
+            return true; // a Unicode BOM is a positive text signal
+        // Zip (PK\x03\x04) and PDF (%PDF) are not text.
+        if (head[0] === 0x50 && head[1] === 0x4b && head[2] === 0x03 && head[3] === 0x04)
+            return false;
+        if (head[0] === 0x25 && head[1] === 0x50 && head[2] === 0x44 && head[3] === 0x46)
+            return false;
+        // An XML/HTML document (FB2, XHTML) opens with '<' after optional whitespace.
+        const firstGlyph = head.find((b) => b !== 0x20 && b !== 0x09 && b !== 0x0a && b !== 0x0d && b !== 0xef && b !== 0xbb && b !== 0xbf);
+        if (firstGlyph === 0x3c)
+            return false;
+        // An unmarked NUL byte means binary (or UTF-16 without a BOM we do not guess).
+        if (head.includes(0x00))
+            return false;
+        return true;
+    },
+    async decode(source) {
+        const bytes = await source.read(0, source.size);
+        const raw = decodeText(bytes);
+        const normalized = raw.replace(/\r\n?/g, '\n');
+        const metadata = readGutenbergMetadata(normalized);
+        const built = buildSections(normalized);
+        const toc = buildToc(built);
+        const sections = built.map((s) => s.section);
+        return {
+            metadata,
+            toc,
+            sections,
+            section: sectionLookup(sections),
+            resources: new Map(),
+        };
+    },
+};
+// --- encoding ---------------------------------------------------------------
+function hasBom(head) {
+    return ((head[0] === 0xef && head[1] === 0xbb && head[2] === 0xbf) || // UTF-8
+        (head[0] === 0xff && head[1] === 0xfe) || // UTF-16LE
+        (head[0] === 0xfe && head[1] === 0xff) // UTF-16BE
+    );
+}
+/**
+ * Decodes text bytes: a BOM picks the encoding outright; otherwise UTF-8 is tried
+ * strictly and windows-1252 is the legacy fallback (the codepage most non-UTF-8
+ * English/Western TXT actually uses). The BOM bytes are stripped with the decoder's
+ * default BOM handling for UTF-8/16.
+ */
+function decodeText(bytes) {
+    if (bytes[0] === 0xff && bytes[1] === 0xfe)
+        return new TextDecoder('utf-16le').decode(bytes);
+    if (bytes[0] === 0xfe && bytes[1] === 0xff)
+        return new TextDecoder('utf-16be').decode(bytes);
+    if (bytes[0] === 0xef && bytes[1] === 0xbb && bytes[2] === 0xbf) {
+        return new TextDecoder('utf-8').decode(bytes.subarray(3));
+    }
+    try {
+        return new TextDecoder('utf-8', { fatal: true }).decode(bytes);
+    }
+    catch {
+        return new TextDecoder('windows-1252').decode(bytes);
+    }
+}
+const HEADING_KEYWORD = /^(chapter|book|part|canto|letter|volume|section|prologue|epilogue|introduction|preface|foreword|afterword)\b/i;
+/**
+ * Coarse Gutenberg-style split: blocks are separated by blank lines; a short block
+ * that reads as a chapter heading (a keyword line like "CHAPTER I", or a short
+ * all-caps/titley line) starts a new section. When no heading is ever found the
+ * whole text becomes one synthetic section, so a headingless file still reads.
+ */
+function buildSections(normalized) {
+    const blocks = normalized
+        .split(/\n[ \t]*\n+/)
+        .map((b) => b.replace(/^\n+|\n+$/g, '').trim())
+        .filter((b) => b.length > 0);
+    const sections = [];
+    let heading;
+    let paragraphs = [];
+    let index = 0;
+    const flush = () => {
+        if (heading === undefined && paragraphs.length === 0)
+            return;
+        const id = `s${index}`;
+        index += 1;
+        const html = renderXhtml(heading, paragraphs);
+        const captured = heading;
+        sections.push({
+            section: {
+                id,
+                mediaType: 'application/xhtml+xml',
+                load: () => Promise.resolve(new TextEncoder().encode(html)),
+            },
+            ...(captured === undefined ? {} : { heading: captured }),
+        });
+        heading = undefined;
+        paragraphs = [];
+    };
+    for (const block of blocks) {
+        if (isHeading(block)) {
+            flush();
+            heading = collapseWhitespace(block);
+        }
+        else {
+            paragraphs.push(block);
+        }
+    }
+    flush();
+    if (sections.length === 0) {
+        // Empty or whitespace-only input still yields one (empty) readable section.
+        sections.push({
+            section: {
+                id: 's0',
+                mediaType: 'application/xhtml+xml',
+                load: () => Promise.resolve(new TextEncoder().encode(renderXhtml(undefined, []))),
+            },
+        });
+    }
+    return sections;
+}
+function isHeading(block) {
+    if (block.includes('\n'))
+        return false; // a heading is a single short line
+    const line = block.trim();
+    if (line.length === 0 || line.length > 60)
+        return false;
+    if (HEADING_KEYWORD.test(line))
+        return true;
+    // A short line in all caps (letters present, no lowercase) reads as a heading.
+    return /[A-Z]/.test(line) && !/[a-z]/.test(line) && line.length <= 48;
+}
+function buildToc(sections) {
+    const toc = [];
+    for (const s of sections) {
+        if (s.heading === undefined)
+            continue;
+        toc.push({ label: s.heading, sectionId: s.section.id, children: [] });
+    }
+    return toc;
+}
+// --- metadata ---------------------------------------------------------------
+/**
+ * Best-effort metadata from Project Gutenberg's plain-text header conventions:
+ * either the "Title: X / Author: Y" block or the "The Project Gutenberg eBook of
+ * TITLE, by AUTHOR" line. Anything not found is omitted, never set to undefined.
+ */
+function readGutenbergMetadata(normalized) {
+    const head = normalized.slice(0, 4000);
+    let title;
+    let author;
+    const titleField = head.match(/^Title:\s*(.+)$/im);
+    if (titleField?.[1] !== undefined)
+        title = collapseWhitespace(titleField[1]);
+    const authorField = head.match(/^Author:\s*(.+)$/im);
+    if (authorField?.[1] !== undefined)
+        author = collapseWhitespace(authorField[1]);
+    if (title === undefined) {
+        const banner = head.match(/Project Gutenberg eBook of\s+(.+?)(?:,\s*by\s+(.+?))?[\r\n]/i);
+        if (banner?.[1] !== undefined)
+            title = collapseWhitespace(banner[1]);
+        if (author === undefined && banner?.[2] !== undefined)
+            author = collapseWhitespace(banner[2]);
+    }
+    return {
+        ...(title === undefined ? {} : { title }),
+        ...(author === undefined ? {} : { author }),
+    };
+}
+// --- rendering --------------------------------------------------------------
+function renderXhtml(heading, paragraphs) {
+    const body = [];
+    if (heading !== undefined)
+        body.push(`<h2>${escapeXmlText(heading)}</h2>`);
+    for (const p of paragraphs) {
+        // A block's internal newlines are soft line breaks within one paragraph.
+        body.push(`<p>${escapeXmlText(collapseParagraph(p))}</p>`);
+    }
+    return `<?xml version="1.0" encoding="UTF-8"?>\n<html xmlns="http://www.w3.org/1999/xhtml"><head><meta charset="UTF-8"/></head><body>${body.join('')}</body></html>`;
+}
+function collapseParagraph(s) {
+    return s.replace(/\s*\n\s*/g, ' ').replace(/[ \t]+/g, ' ').trim();
+}
+//# sourceMappingURL=index.js.map

package/dist/formats/text/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/formats/text/index.ts"],"names":[],"mappings":"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"}

package/dist/formats/xml.d.ts

@@ -0,0 +1,33 @@
+export interface XmlElement {
+    readonly name: string;
+    readonly localName: string;
+    readonly attributes: ReadonlyMap<string, string>;
+    readonly children: readonly XmlElement[];
+    /** Child elements and text chunks in document order. */
+    readonly content: readonly (XmlElement | string)[];
+    /** Concatenated direct text content, entity-decoded, CDATA included. */
+    readonly text: string;
+}
+export declare function decodeXml(bytes: Uint8Array): string;
+export declare function localNameOf(name: string): string;
+/** Attribute by exact name first, then by local name ignoring any prefix. */
+export declare function attribute(element: XmlElement, name: string): string | undefined;
+export declare function childrenNamed(element: XmlElement, localName: string): readonly XmlElement[];
+export declare function firstChildNamed(element: XmlElement, localName: string): XmlElement | undefined;
+/** All text within the element in document order, entity-decoded. */
+export declare function deepText(element: XmlElement): string;
+export declare function descendantsNamed(element: XmlElement, localName: string): readonly XmlElement[];
+export interface ParseXmlOptions {
+    /**
+     * Recover from light well-formedness slips instead of throwing: a valueless
+     * (HTML-boolean-style) attribute becomes an empty-string attribute, an unquoted
+     * attribute value reads to the next whitespace or tag end, a close tag that
+     * mismatches the open stack closes the nearest matching ancestor (or is ignored
+     * when nothing matches), and elements left open at end of input are auto-closed.
+     * Strict is the default; tolerance is opt-in per caller so strict guarantees
+     * (EPUB's container/OPF/nav parsing) are unchanged.
+     */
+    readonly tolerant?: boolean;
+}
+export declare function parseXml(input: string, options?: ParseXmlOptions): XmlElement;
+//# sourceMappingURL=xml.d.ts.map

package/dist/formats/xml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml.d.ts","sourceRoot":"","sources":["../../src/formats/xml.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAC;IACzC,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,UAAU,GAAG,MAAM,CAAC,EAAE,CAAC;IACnD,wEAAwE;IACxE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAWD,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAmBnD;AAaD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAO/E;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,UAAU,EAAE,CAE3F;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAE9F;AAED,qEAAqE;AACrE,wBAAgB,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAMpD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,UAAU,EAAE,CAU9F;AAID,MAAM,WAAW,eAAe;IAC9B;;;;;;;;OAQG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,UAAU,CAkL7E"}

package/dist/formats/xml.js

@@ -0,0 +1,321 @@
+export function decodeXml(bytes) {
+    if (bytes.length >= 2) {
+        if (bytes[0] === 0xff && bytes[1] === 0xfe)
+            return new TextDecoder('utf-16le').decode(bytes);
+        if (bytes[0] === 0xfe && bytes[1] === 0xff)
+            return new TextDecoder('utf-16be').decode(bytes);
+    }
+    // A BOM decides outright; otherwise honor the XML declaration's encoding label
+    // for non-Unicode codepages — real FB2 is frequently windows-1251, and assuming
+    // UTF-8 would mojibake every Cyrillic character. The label is read from the
+    // prolog as Latin-1 (one byte → one char) so it is legible before the true
+    // encoding is known. An unknown label falls back to UTF-8.
+    const label = encodingFromProlog(bytes);
+    if (label !== undefined && !/^utf-?8$/i.test(label) && !/^utf-?16/i.test(label)) {
+        try {
+            return new TextDecoder(label).decode(bytes);
+        }
+        catch {
+            // Unsupported label — fall through to UTF-8.
+        }
+    }
+    return new TextDecoder().decode(bytes);
+}
+function encodingFromProlog(bytes) {
+    const head = bytes.subarray(0, Math.min(bytes.length, 200));
+    let prolog = '';
+    for (let i = 0; i < head.length; i += 1)
+        prolog += String.fromCharCode(head[i]);
+    if (!prolog.startsWith('<?xml'))
+        return undefined;
+    const end = prolog.indexOf('?>');
+    if (end === -1)
+        return undefined;
+    const match = prolog.slice(0, end).match(/encoding\s*=\s*["']([^"']+)["']/i);
+    return match?.[1];
+}
+export function localNameOf(name) {
+    const colon = name.indexOf(':');
+    return colon === -1 ? name : name.slice(colon + 1);
+}
+/** Attribute by exact name first, then by local name ignoring any prefix. */
+export function attribute(element, name) {
+    const exact = element.attributes.get(name);
+    if (exact !== undefined)
+        return exact;
+    for (const [key, value] of element.attributes) {
+        if (localNameOf(key) === name)
+            return value;
+    }
+    return undefined;
+}
+export function childrenNamed(element, localName) {
+    return element.children.filter((child) => child.localName === localName);
+}
+export function firstChildNamed(element, localName) {
+    return element.children.find((child) => child.localName === localName);
+}
+/** All text within the element in document order, entity-decoded. */
+export function deepText(element) {
+    let out = '';
+    for (const node of element.content) {
+        out += typeof node === 'string' ? node : deepText(node);
+    }
+    return out;
+}
+export function descendantsNamed(element, localName) {
+    const found = [];
+    const walk = (parent) => {
+        for (const child of parent.children) {
+            if (child.localName === localName)
+                found.push(child);
+            walk(child);
+        }
+    };
+    walk(element);
+    return found;
+}
+const NAME_END = new Set([' ', '\t', '\n', '\r', '>', '/', '=']);
+export function parseXml(input, options) {
+    const tolerant = options?.tolerant === true;
+    let pos = input.charCodeAt(0) === 0xfeff ? 1 : 0;
+    let root;
+    const stack = [];
+    const fail = (message) => {
+        throw new Error(`malformed XML at offset ${pos}: ${message}`);
+    };
+    const skipWhitespace = () => {
+        while (pos < input.length && isWhitespace(input[pos]))
+            pos++;
+    };
+    const readName = () => {
+        const start = pos;
+        while (pos < input.length && !NAME_END.has(input[pos]))
+            pos++;
+        if (pos === start)
+            fail('expected a name');
+        return input.slice(start, pos);
+    };
+    const skipPast = (terminator, what) => {
+        const end = input.indexOf(terminator, pos);
+        if (end === -1)
+            fail(`unterminated ${what}`);
+        pos = end + terminator.length;
+    };
+    const skipMarkupDeclaration = () => {
+        let depth = 0;
+        for (; pos < input.length; pos++) {
+            const ch = input[pos];
+            if (ch === '[')
+                depth++;
+            else if (ch === ']')
+                depth--;
+            else if (ch === '>' && depth <= 0) {
+                pos++;
+                return;
+            }
+        }
+        fail('unterminated markup declaration');
+    };
+    const readAttributes = (element) => {
+        for (;;) {
+            skipWhitespace();
+            if (pos >= input.length) {
+                if (!tolerant)
+                    fail(`unterminated <${element.name}> tag`);
+                return false;
+            }
+            if (input[pos] === '>') {
+                pos++;
+                return false;
+            }
+            if (input[pos] === '/') {
+                pos++;
+                if (input[pos] !== '>') {
+                    if (!tolerant)
+                        fail(`expected "/>" in <${element.name}>`);
+                    continue; // stray slash inside the tag — drop it
+                }
+                pos++;
+                return true;
+            }
+            const name = readName();
+            skipWhitespace();
+            if (input[pos] !== '=') {
+                if (!tolerant)
+                    fail(`attribute ${name} has no value`);
+                // Valueless (HTML-boolean-style) attribute — keep it as an empty string.
+                element.attributes.set(name, '');
+                continue;
+            }
+            pos++;
+            skipWhitespace();
+            const quote = input[pos];
+            if (quote !== '"' && quote !== "'") {
+                if (!tolerant)
+                    fail(`attribute ${name} value is not quoted`);
+                // Unquoted value — read to the next whitespace or tag end.
+                const start = pos;
+                while (pos < input.length && !isWhitespace(input[pos]) && input[pos] !== '>')
+                    pos++;
+                let raw = input.slice(start, pos);
+                if (raw.endsWith('/') && input[pos] === '>') {
+                    raw = raw.slice(0, -1);
+                    pos -= 1; // leave "/>" for the self-closing check
+                }
+                element.attributes.set(name, decodeEntities(raw));
+                continue;
+            }
+            pos++;
+            const end = input.indexOf(quote, pos);
+            if (end === -1) {
+                if (!tolerant)
+                    fail(`unterminated value for attribute ${name}`);
+                // Unterminated quote — take what is there up to the tag end.
+                const gt = input.indexOf('>', pos);
+                const stop = gt === -1 ? input.length : gt;
+                element.attributes.set(name, decodeEntities(input.slice(pos, stop)));
+                pos = stop;
+                continue;
+            }
+            element.attributes.set(name, decodeEntities(input.slice(pos, end)));
+            pos = end + 1;
+        }
+    };
+    while (pos < input.length) {
+        const lt = input.indexOf('<', pos);
+        if (lt === -1)
+            break;
+        if (lt > pos) {
+            const parent = stack[stack.length - 1];
+            if (parent !== undefined)
+                appendText(parent, decodeEntities(input.slice(pos, lt)));
+        }
+        pos = lt;
+        if (input.startsWith('<?', pos)) {
+            pos += 2;
+            skipPast('?>', 'processing instruction');
+        }
+        else if (input.startsWith('<!--', pos)) {
+            pos += 4;
+            skipPast('-->', 'comment');
+        }
+        else if (input.startsWith('<![CDATA[', pos)) {
+            pos += 9;
+            const end = input.indexOf(']]>', pos);
+            if (end === -1)
+                fail('unterminated CDATA section');
+            const parent = stack[stack.length - 1];
+            if (parent !== undefined)
+                appendText(parent, input.slice(pos, end));
+            pos = end + 3;
+        }
+        else if (input.startsWith('<!', pos)) {
+            pos += 2;
+            skipMarkupDeclaration();
+        }
+        else if (input.startsWith('</', pos)) {
+            pos += 2;
+            const name = readName();
+            skipWhitespace();
+            if (input[pos] !== '>') {
+                if (!tolerant)
+                    fail(`unterminated </${name}>`);
+                const gt = input.indexOf('>', pos);
+                pos = gt === -1 ? input.length : gt + 1;
+            }
+            else
+                pos++;
+            const open = stack.pop();
+            if (open === undefined) {
+                // Tolerant: a stray close with nothing open is ignored.
+                if (!tolerant)
+                    fail(`</${name}> has no matching open tag`);
+            }
+            else if (open.name !== name) {
+                if (!tolerant)
+                    fail(`</${name}> closes <${open.name}>`);
+                if (stack.some((el) => el.name === name)) {
+                    // Close the nearest matching ancestor, auto-closing what it skipped
+                    // (children were attached at open time, so popping loses nothing).
+                    while (stack.length > 0 && stack[stack.length - 1].name !== name)
+                        stack.pop();
+                    stack.pop();
+                }
+                else {
+                    // No matching open tag anywhere above — ignore the stray close.
+                    stack.push(open);
+                }
+            }
+        }
+        else {
+            pos++;
+            const name = readName();
+            const element = {
+                name,
+                localName: localNameOf(name),
+                attributes: new Map(),
+                children: [],
+                content: [],
+                text: '',
+            };
+            const selfClosing = readAttributes(element);
+            const parent = stack[stack.length - 1];
+            if (parent !== undefined) {
+                parent.children.push(element);
+                parent.content.push(element);
+            }
+            else if (root === undefined)
+                root = element;
+            else if (!tolerant)
+                fail(`second root element <${name}>`);
+            // Tolerant: trailing junk after the root parses but is discarded.
+            if (!selfClosing)
+                stack.push(element);
+        }
+    }
+    const open = stack[stack.length - 1];
+    // Tolerant: elements left open at end of input are auto-closed.
+    if (open !== undefined && !tolerant)
+        fail(`unclosed element <${open.name}>`);
+    if (root === undefined)
+        fail('no root element');
+    return root;
+}
+function appendText(parent, text) {
+    parent.text += text;
+    const last = parent.content[parent.content.length - 1];
+    if (typeof last === 'string')
+        parent.content[parent.content.length - 1] = last + text;
+    else
+        parent.content.push(text);
+}
+function isWhitespace(ch) {
+    return ch === ' ' || ch === '\t' || ch === '\n' || ch === '\r';
+}
+// nbsp is the one HTML entity that shows up in real nav-document labels.
+const NAMED_ENTITIES = {
+    amp: '&',
+    lt: '<',
+    gt: '>',
+    quot: '"',
+    apos: "'",
+    nbsp: ' ',
+};
+function decodeEntities(text) {
+    if (!text.includes('&'))
+        return text;
+    return text.replace(/&(#x[0-9a-fA-F]+|#[0-9]+|[a-zA-Z][a-zA-Z0-9]*);/g, (match, body) => {
+        if (body.startsWith('#')) {
+            const code = body[1] === 'x' ? Number.parseInt(body.slice(2), 16) : Number.parseInt(body.slice(1), 10);
+            try {
+                return String.fromCodePoint(code);
+            }
+            catch {
+                return match;
+            }
+        }
+        return NAMED_ENTITIES[body] ?? match;
+    });
+}
+//# sourceMappingURL=xml.js.map

package/dist/formats/xml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml.js","sourceRoot":"","sources":["../../src/formats/xml.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The package root: the browser-facing reader facade plus the headless core it
+ * operates on.
+ *
+ *   import { open, render } from 'wolfy-reader';
+ *   import { epub } from 'wolfy-reader/epub';
+ *
+ * Core travels with the facade because `render` takes a `Book` and `open` is the
+ * only public way to make one — splitting them would make the common case a
+ * three-import dance, and the facade's own surface already names `Position`,
+ * `TocItem` and `SentenceRange` in its signatures.
+ *
+ * Both re-exports resolve to the same emitted modules as `wolfy-reader/core`, so
+ * there is one `open`, one `Position` model and one set of error constructors
+ * however a consumer reaches them — `instanceof BookError` holds across entries.
+ *
+ * Headless consumers should import `wolfy-reader/core` instead. This root reaches
+ * `src/layout` and `src/view`; it is import-safe under Node today and the pack
+ * fidelity check keeps it that way, but only `/core` carries the guarantee.
+ *
+ * Format decoders are deliberately absent: each is its own subpath because their
+ * closures differ by an order of magnitude — only `epub` pulls the ZIP reader —
+ * and `open(input, { formats })` takes an explicit list by design.
+ */
+export * from './core/index.ts';
+export * from './reader/index.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}