@uniweb/press 0.4.12 → 0.4.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/press",
-  "version": "0.4.12",
+  "version": "0.4.14",
   "description": "Press your React components into downloadable files — Word, Excel, PDF. Registration-based pattern with lazy-loaded format adapters.",
   "type": "module",
   "exports": {

package/src/adapters/epub.js

@@ -31,7 +31,7 @@
 import JSZip from 'jszip'
 import { parseFragment } from 'parse5'
 import { fetchAssets } from '../assets/fetch.js'
-import { MATH_CSS } from './math-css.js'
+import { MATH_CSS, numberEquations } from './math-css.js'
 
 // ============================================================================
 // Public API
@@ -63,14 +63,30 @@ export async function compileEpub(input, options = {}) {
     const { meta = {}, stylesheet, identifier, cover, loadAsset } = options
 
     const resolvedMeta = { ...(metadata || {}), ...meta }
-    const css = stylesheet || DEFAULT_STYLESHEET
+    // Math CSS is emitted ahead of the design stylesheet, not inside it.
+    // Temml's MathML needs these rules to lay out at all -- without them a
+    // pmatrix's rows touch and an aligned environment's = signs drift -- and a
+    // foundation that supplies its own `stylesheet` REPLACES the default, so
+    // folding them into DEFAULT_STYLESHEET meant customizing the design
+    // silently broke the maths. Emitting first also leaves the foundation's
+    // sheet able to override any of it.
+    const css = `${MATH_CSS}\n${stylesheet || DEFAULT_STYLESHEET}`
     const id = identifier || resolvedMeta.identifier || generateUuid()
     const coverUrl = cover || resolvedMeta.cover || resolvedMeta.coverImage
 
     // Walk each HTML fragment, collect image URLs, capture a chapter title.
     // The parsed tree is kept so we can re-serialize as XHTML after
     // rewriting <img src> to manifest-relative paths.
-    const chapters = sections.map((html, i) => buildChapter(html, i))
+    // Numbered straight through the book rather than restarting per chapter,
+    // and as text rather than a CSS counter — reader support for counters is
+    // not something an EPUB can find out.
+    let eqnNo = 1
+    const numbered = sections.map((html) => {
+        const result = numberEquations(html, eqnNo)
+        eqnNo = result.next
+        return result.html
+    })
+    const chapters = numbered.map((html, i) => buildChapter(html, i))
 
     // Deduplicate image URLs across all chapters — and the cover, if any —
     // and fetch them in parallel. Failed fetches are logged and the original
@@ -626,5 +642,4 @@ pre {
   overflow: auto;
   white-space: pre-wrap;
 }
-${MATH_CSS}
 `

package/src/adapters/math-css.js

@@ -43,12 +43,21 @@ export const MATH_CSS = `/* Temml's own class hooks — without these an aligned
    MathML-Core default here; Temml's own CSS only adjusts it for jot. */
 math mtd { padding-top: 0.5ex; padding-bottom: 0.5ex; }
 math mtable.tml-jot mtd { padding-top: 0.7ex; padding-bottom: 0.7ex; }
-/* AMS auto-numbering. Which equations number is the AUTHOR's choice, made in
+/* AMS auto-numbering, for lanes that keep our CSS counter.
+
+   Scoped to :empty because the document lanes cannot rely on it -- Paged.js
+   rewrites counters for its own pagination and strips counter-increment, so
+   every equation rendered as "(0)" (measured 2026-07-31; the declaration
+   survives intact without the polyfill). press therefore writes the numbers
+   into the spans as text, and a span carrying a number is no longer :empty, so
+   the two can never both fire.
+
+   AMS auto-numbering. Which equations number is the AUTHOR's choice, made in
    LaTeX: align and equation number, aligned and the starred forms do not.
    Without these two rules that choice was discarded -- align and align-star
    rendered identically, so an author who asked for numbers silently got none.
    (No backticks in here: this string is a JS template literal.) */
-.tml-eqn::before {
+.tml-eqn:empty::before {
   counter-increment: tmlEqnNo;
   content: "(" counter(tmlEqnNo) ")";
 }
@@ -74,3 +83,35 @@ math.tml-display:has(.tml-eqn) {
   display: block !important;
   width: 100%;
 }`
+
+/**
+ * Write equation numbers into Temml's tag spans as text.
+ *
+ * Temml leaves `<span class="tml-eqn"></span>` empty and expects a CSS counter
+ * to draw the number. That works in a browser and not in a document: Paged.js
+ * rewrites counters for its own pagination and strips `counter-increment`, so
+ * every equation renders as "(0)" -- measured, and confirmed by the declaration
+ * surviving intact once the polyfill is removed. EPUB readers vary at least as
+ * widely, and neither lane offers a way to find out.
+ *
+ * So the document lanes stop asking CSS to count. A span that carries its
+ * number is no longer `:empty`, and the stylesheet's counter rule is scoped to
+ * `:empty`, so the two can never both fire and double up.
+ *
+ * A regex rather than a parse: Temml emits this span in exactly one shape, and
+ * the epub adapter would otherwise have to thread a counter through its parse5
+ * tree for no gain.
+ *
+ * @param {string} html
+ * @param {number} [start=1] - First number to use; lets a caller continue the
+ *   sequence across sections so a book numbers straight through.
+ * @returns {{ html: string, next: number }}
+ */
+export function numberEquations(html, start = 1) {
+  let n = start
+  const out = String(html ?? '').replace(
+    /<span class="tml-eqn"><\/span>/g,
+    () => `<span class="tml-eqn">(${n++})</span>`,
+  )
+  return { html: out, next: n }
+}

package/src/adapters/pagedjs.js

@@ -129,9 +129,21 @@ async function compileServerSide(htmlDoc, options = {}) {
  * want to inspect the emitted document before handing it to a browser.
  */
 export function emitDocument({ body = '', meta = {}, stylesheet, polyfillUrl } = {}) {
+    // Equation numbers are written in as text rather than left to the CSS
+    // counter: Paged.js strips counter-increment while rewriting counters for
+    // its own pagination, which rendered every equation as "(0)".
+    body = numberEquations(body).html
+
     const lang = meta.language ?? 'en'
     const title = meta.title ?? 'Book'
-    const css = stylesheet || DEFAULT_STYLESHEET
+    // Math CSS is emitted ahead of the design stylesheet, not inside it.
+    // Temml's MathML needs these rules to lay out at all -- without them a
+    // pmatrix's rows touch and an aligned environment's = signs drift -- and a
+    // foundation that supplies its own `stylesheet` REPLACES the default, so
+    // folding them into DEFAULT_STYLESHEET meant customizing the design
+    // silently broke the maths. Emitting first also leaves the foundation's
+    // sheet able to override any of it.
+    const css = `${MATH_CSS}\n${stylesheet || DEFAULT_STYLESHEET}`
     const polyfill = polyfillUrl || DEFAULT_POLYFILL_URL
 
     return `<!doctype html>
@@ -231,7 +243,7 @@ export const DEFAULT_POLYFILL_URL =
  * book PDF without a custom foundation stylesheet. Foundations override by
  * passing `options.stylesheet`.
  */
-import { MATH_CSS } from './math-css.js'
+import { MATH_CSS, numberEquations } from './math-css.js'
 
 export const DEFAULT_STYLESHEET = `
 /* Hidden metadata block — the DOM carries it for CSS string-set / string() */
@@ -294,5 +306,4 @@ blockquote {
 }
 ul, ol { margin: 0.5em 0 0.75em 1.5em; }
 figure { break-inside: avoid; }
-${MATH_CSS}
 `