postext-epub 0.1.0

package/dist/reflowable/index.js

@@ -0,0 +1,257 @@
+// Reflowable rendition (#396): the book as semantic XHTML, one content
+// document per chapter (and per part opener), styled by a stylesheet
+// derived from the configuration, with print page equivalence.
+//
+//   walk.ts   the laid-out pages back to a semantic model, in reading order
+//   inline.ts lines back to running text (joined, de-hyphenated)
+//   xhtml.ts  the model as EPUB 3 content documents
+//   css.ts    the stylesheet
+import { fontAssets, imageAssets, pageProgressionOf } from '../shared/assets';
+import { bookStylesheet, stylesheetOverrides, withPalette } from './css';
+import { xmlAttr, xmlText } from './inline';
+import { docLanguage, walkBook } from './walk';
+import { relativeHref, writeContentDocument } from './xhtml';
+import { isRtlLanguage, navStrings } from '../package/strings';
+export const STYLESHEET_HREF = 'styles/book.css';
+const TEXT_DIR = 'text/';
+/** The accessible name of a footnote's link back to its marker. */
+const BACK_LABELS = {
+    en: 'Back to text',
+    es: 'Volver al texto',
+    ca: 'Torna al text',
+    fr: 'Retour au texte',
+    de: 'Zurück zum Text',
+    it: 'Torna al testo',
+    pt: 'Voltar ao texto',
+    zh: '返回正文',
+    ja: '本文に戻る',
+    ar: 'العودة إلى النص',
+};
+const SUMMARIES = {
+    en: 'Reflowable text with structured headings, a navigable table of contents, page numbers of the printed edition, text alternatives for pictures and formulas, and footnotes linked both ways.',
+};
+function backLabel(lang) {
+    return BACK_LABELS[lang.toLowerCase().split('-')[0]] ?? BACK_LABELS.en;
+}
+/** Hrefs and manifest ids of the content documents: `chapter-001.xhtml`
+ *  for a chapter's first document, `chapter-001-2.xhtml` for the next
+ *  ones of the same chapter (after a part), `part-001.xhtml` for parts. */
+function nameFiles(files) {
+    let parts = 0;
+    const perDoc = new Map();
+    for (const file of files) {
+        let name;
+        if (file.kind === 'part') {
+            name = `part-${String(++parts).padStart(3, '0')}`;
+        }
+        else {
+            const n = (perDoc.get(file.doc) ?? 0) + 1;
+            perDoc.set(file.doc, n);
+            name = `chapter-${String(file.doc + 1).padStart(3, '0')}${n > 1 ? `-${n}` : ''}`;
+        }
+        file.href = `${TEXT_DIR}${name}.xhtml`;
+        file.itemId = name;
+    }
+}
+/** The navigation tree: headings nested by level (parts at the top). */
+function navTree(headings) {
+    const root = [];
+    const stack = [{ level: -1, children: root }];
+    for (const h of headings) {
+        if (!h.listed || !h.label)
+            continue;
+        while (stack.length > 1 && stack[stack.length - 1].level >= h.level)
+            stack.pop();
+        const point = { label: h.label, href: `${h.file.href}#${h.id}` };
+        stack[stack.length - 1].children.push(point);
+        point.children = [];
+        stack.push({ level: h.level, children: point.children });
+    }
+    const prune = (points) => points.map((p) => (p.children && p.children.length > 0 ? { ...p, children: prune(p.children) } : { label: p.label, href: p.href }));
+    return prune(root);
+}
+function coverDocument(imageHref, alt, title, lang, dir) {
+    const l = xmlAttr(lang);
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" xmlns:epub="http://www.idpf.org/2007/ops" lang="${l}" xml:lang="${l}"${dir ? ` dir="${dir}"` : ''}>
+<head>
+<meta charset="UTF-8"/>
+<title>${xmlText(title)}</title>
+<link rel="stylesheet" type="text/css" href="${relativeHref(`${TEXT_DIR}cover.xhtml`, STYLESHEET_HREF)}"/>
+</head>
+<body class="pt-cover">
+<section epub:type="cover">
+<img role="doc-cover" src="${xmlAttr(relativeHref(`${TEXT_DIR}cover.xhtml`, imageHref))}" alt="${xmlAttr(alt)}"/>
+</section>
+</body>
+</html>
+`;
+}
+const COVER_EXT = { 'image/jpeg': 'jpg', 'image/png': 'png', 'image/webp': 'webp', 'image/svg+xml': 'svg' };
+export async function buildReflowablePublication(docs, options) {
+    const first = docs[0];
+    if (!first)
+        throw new Error('buildReflowablePublication: no documents');
+    const { signal, onProgress } = options;
+    const warn = (w) => options.onWarning?.(w);
+    const metaTitle = typeof first.metadata.title === 'string' ? first.metadata.title : '';
+    const metadata = {
+        ...options.metadata,
+        title: options.metadata.title || metaTitle || 'Untitled',
+        language: options.metadata.language || docLanguage(first.config, 'en'),
+    };
+    // The book, in reading order.
+    const book = walkBook(docs, { language: metadata.language });
+    nameFiles(book.files);
+    signal?.throwIfAborted();
+    // Pictures and fonts. Only the pictures the text places are written
+    // (running heads and opener designs are print furniture here).
+    onProgress?.({ phase: 'resources', done: 0, total: 2 });
+    const missing = [];
+    const images = await imageAssets(docs, options.resourceBytes, (w) => missing.push(w));
+    for (const w of missing)
+        if (w.kind !== 'missingImage' || book.images.has(w.fileId))
+            warn(w);
+    const usedImages = new Set([...book.images].map((id) => images.hrefOf(id)).filter((h) => h !== undefined));
+    const fonts = fontAssets(options.fonts ?? []);
+    onProgress?.({ phase: 'resources', done: 1, total: 2 });
+    signal?.throwIfAborted();
+    const vertical = first.config.layout.writingMode === 'vertical-rl';
+    const sheetOptions = { vertical, ...(book.verse ? { verse: true } : {}) };
+    const sheet = bookStylesheet(first.config, fonts.css, sheetOptions);
+    const items = [{ id: 'css', href: STYLESHEET_HREF, mediaType: 'text/css', data: sheet.css }];
+    // The stylesheet follows the first chapter's configuration. A document
+    // whose chapter is configured otherwise (its heading styles, say), or
+    // whose part recolours the palette, links a second stylesheet with what
+    // changes, shared by the documents that change the same.
+    const families = new Set(sheet.families);
+    const overrides = new Map();
+    const sheets = new Map();
+    for (const file of book.files) {
+        const config = docs[file.doc].config;
+        if (config === first.config && !file.palette)
+            continue;
+        const key = `${file.doc}\u0000${JSON.stringify(file.palette ?? {})}`;
+        if (!overrides.has(key)) {
+            const own = bookStylesheet(withPalette(config, file.palette), '', sheetOptions);
+            for (const family of own.families)
+                families.add(family);
+            const css = stylesheetOverrides(sheet.rules, own.rules);
+            let href;
+            if (css) {
+                href = sheets.get(css);
+                if (!href) {
+                    href = `${STYLESHEET_HREF.replace(/\.css$/, '')}-${sheets.size + 2}.css`;
+                    sheets.set(css, href);
+                    items.push({ id: `css-${sheets.size + 1}`, href, mediaType: 'text/css', data: `@charset "UTF-8";\n${css}` });
+                }
+            }
+            overrides.set(key, href);
+        }
+        const href = overrides.get(key);
+        if (href)
+            file.stylesheets = [href];
+    }
+    for (const family of families) {
+        if (!fonts.families.has(family))
+            warn({ kind: 'missingFont', family });
+    }
+    onProgress?.({ phase: 'resources', done: 2, total: 2 });
+    items.push(...fonts.items);
+    items.push(...images.items.filter((i) => usedImages.has(i.href)));
+    const spine = [];
+    const landmarks = [];
+    // Landmark names: in the book's language for a right-to-left book,
+    // whose navigation document is set right to left in that language
+    // (#402); in English otherwise, as they have always been written.
+    const named = isRtlLanguage(metadata.language) ? navStrings(metadata.language) : undefined;
+    const names = {
+        cover: named?.cover ?? 'Cover',
+        toc: named?.contents ?? 'Table of contents',
+        bodymatter: named?.bodymatter ?? 'Start of content',
+        bibliography: named?.bibliography ?? 'Bibliography',
+        index: named?.index ?? 'Index',
+    };
+    // Cover.
+    if (options.cover) {
+        const ext = COVER_EXT[options.cover.mediaType] ?? 'img';
+        const href = `images/cover.${ext}`;
+        items.push({ id: 'cover-image', href, mediaType: options.cover.mediaType, data: options.cover.bytes, properties: ['cover-image'] });
+        const lang = book.files[0]?.lang ?? metadata.language;
+        items.push({
+            id: 'cover',
+            href: `${TEXT_DIR}cover.xhtml`,
+            mediaType: 'application/xhtml+xml',
+            data: coverDocument(href, options.cover.alt ?? metadata.title, metadata.title, lang, book.files[0]?.dir),
+        });
+        spine.push({ idref: 'cover' });
+        landmarks.push({ type: 'cover', label: names.cover, href: `${TEXT_DIR}cover.xhtml` });
+    }
+    // Content documents.
+    const ctx = {
+        book,
+        bookTitle: metadata.title,
+        imageHref: (fileId) => images.hrefOf(fileId),
+        stylesheet: STYLESHEET_HREF,
+        backLabel,
+    };
+    let maths = book.maths;
+    book.files.forEach((file, i) => {
+        signal?.throwIfAborted();
+        const xhtml = writeContentDocument(file, ctx);
+        if (xhtml.includes('role="math"'))
+            maths = true;
+        items.push({ id: file.itemId, href: file.href, mediaType: 'application/xhtml+xml', data: xhtml });
+        spine.push({ idref: file.itemId });
+        onProgress?.({ phase: 'documents', done: i + 1, total: book.files.length });
+    });
+    // Navigation.
+    const toc = navTree(book.headings);
+    const pageList = [...book.pages.entries()]
+        .filter(([, p]) => p.loc.id)
+        .sort(([a], [b]) => a - b)
+        .map(([, p]) => ({ label: p.label, href: `${p.loc.file.href}#${p.loc.id}` }));
+    const at = (loc) => `${loc.file.href}#${loc.id}`;
+    // The navigation document is no spine item: the landmark names the
+    // contents the book prints, when it prints them.
+    if (book.contents)
+        landmarks.push({ type: 'toc', label: names.toc, href: at(book.contents) });
+    const body = book.files.find((f) => f.kind === 'chapter') ?? book.files[0];
+    if (body)
+        landmarks.push({ type: 'bodymatter', label: names.bodymatter, href: body.href });
+    if (book.bibliography)
+        landmarks.push({ type: 'bibliography', label: names.bibliography, href: at(book.bibliography) });
+    if (book.index)
+        landmarks.push({ type: 'index', label: names.index, href: at(book.index) });
+    const features = ['structuralNavigation', 'tableOfContents', 'readingOrder', 'displayTransformability'];
+    if (book.altText || options.cover)
+        features.push('alternativeText');
+    if (maths)
+        features.push('describedMath');
+    if (pageList.length > 0)
+        features.push('pageNavigation', 'printPageNumbers');
+    if (book.index)
+        features.push('index');
+    features.push('ARIA');
+    const visual = usedImages.size > 0 || options.cover !== undefined;
+    const accessibility = {
+        accessModes: visual ? ['textual', 'visual'] : ['textual'],
+        accessModesSufficient: visual && book.missingAlt ? ['textual,visual', 'textual'] : ['textual'],
+        features,
+        hazards: ['none'],
+        summary: SUMMARIES.en,
+    };
+    return {
+        layout: 'reflowable',
+        metadata,
+        items,
+        spine,
+        toc,
+        pageList,
+        landmarks,
+        pageProgression: pageProgressionOf(docs),
+        accessibility,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/reflowable/index.js.map

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

package/dist/reflowable/inline.d.ts

@@ -0,0 +1,56 @@
+import type { MathRender, VDTLine, VDTLineSegment } from 'postext';
+import type { Format, InlineItem, LinkTarget } from './model';
+/** What turning lines into items needs to know about their document. */
+export interface InlineContext {
+    /** Index of the chapter document (footnote ids are per document). */
+    doc: number;
+    /** Language of the text: a Catalan `l·l` broken as `l-` | `l` gets its
+     *  middle dot back. */
+    lang: string;
+    /** Size (px) of the block's text, for formulas sized in ems. */
+    basePx: number;
+    /** A footnote marker was read: whether it is the note's first. */
+    noteRef(id: string): boolean;
+}
+/** Size of a CSS font shorthand in px (16 when it has none). */
+export declare function fontPx(fontString: string | undefined): number;
+/** An element id from any string: ASCII letters, digits, `-` and `_`
+ *  kept, every other character written as `_<hex>` (so two ids never
+ *  collide and the fragment needs no escaping in an href). */
+export declare function idOf(prefix: string, raw: string): string;
+/** Text safe for an XML text node. */
+export declare function xmlText(text: string): string;
+/** Text safe for an XML attribute value. */
+export declare function xmlAttr(text: string): string;
+/** A formula's SVG as XML a content document can embed: namespaces
+ *  declared, MathJax's `data-*` attributes and HTML entities gone, sized
+ *  in ems of the surrounding text so it scales with the reader's font. */
+export declare function mathSvg(render: MathRender, basePx: number, inline: boolean): string;
+export declare function round(n: number): number;
+/** `inner` inside the elements and classes of `fmt`. */
+export declare function wrapFormat(inner: string, fmt: Format): string;
+/** The text items of one line, in logical order. */
+export declare function lineItems(line: VDTLine, ctx: InlineContext, segments?: VDTLineSegment[] | undefined): InlineItem[];
+/** Text runs flowing into one paragraph (or heading, list item, cell…). */
+export interface TextSink {
+    inl: InlineItem[];
+    /** The last line appended, which decides how the next one joins. */
+    prev?: VDTLine;
+}
+/** Append a line to `sink`, joined to the line before it (or after a line
+ *  break, `hardBreak`: a line the author ended). `before` (page starts,
+ *  anchors) goes right before the line's text. */
+export declare function appendLine(sink: TextSink, line: VDTLine, ctx: InlineContext, before?: InlineItem[], segments?: VDTLineSegment[], hardBreak?: boolean): void;
+/** Append every line of a block. */
+/** Append every line of a block (or of a fragment of one). A line marked
+ *  the paragraph's last with more lines after it in the same fragment
+ *  ended at a line break the author typed. */
+export declare function appendLines(sink: TextSink, lines: readonly VDTLine[], ctx: InlineContext, beforeLine?: (line: VDTLine, i: number) => InlineItem[]): void;
+/** The plain text of inline items (labels, titles, alt text). */
+export declare function plainText(inl: readonly InlineItem[]): string;
+/** A space with no link of its own between two runs that share one takes
+ *  it, so linked words separated by spaces stay one link. */
+export declare function bridgeLinks(inl: InlineItem[]): InlineItem[];
+export declare function linkKey(link: LinkTarget | undefined): string;
+export declare function formatKey(fmt: Format): string;
+//# sourceMappingURL=inline.d.ts.map

package/dist/reflowable/inline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline.d.ts","sourceRoot":"","sources":["../../src/reflowable/inline.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAG9D,wEAAwE;AACxE,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,GAAG,EAAE,MAAM,CAAC;IACZ;2BACuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;CAC9B;AAQD,gEAAgE;AAChE,wBAAgB,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAG7D;AAED;;8DAE8D;AAC9D,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,sCAAsC;AACtC,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,4CAA4C;AAC5C,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AA4CD;;0EAE0E;AAC1E,wBAAgB,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAWnF;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvC;AA2BD,wDAAwD;AACxD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAkB7D;AAgBD,oDAAoD;AACpD,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,QAAQ,+BAAgB,GAAG,UAAU,EAAE,CAmDnG;AAED,2EAA2E;AAC3E,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,UAAU,EAAE,CAAC;IAClB,oEAAoE;IACpE,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAmBD;;kDAEkD;AAClD,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,GAAE,UAAU,EAAO,EAAE,QAAQ,CAAC,EAAE,cAAc,EAAE,EAAE,SAAS,UAAQ,GAAG,IAAI,CA0B7J;AAED,oCAAoC;AACpC;;8CAE8C;AAC9C,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,OAAO,EAAE,EAAE,GAAG,EAAE,aAAa,EAAE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,UAAU,EAAE,GAAG,IAAI,CAExJ;AAED,iEAAiE;AACjE,wBAAgB,SAAS,CAAC,GAAG,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,CAE5D;AAED;6DAC6D;AAC7D,wBAAgB,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAsB3D;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,CAS5D;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM7C"}