@uniweb/press 0.4.18 → 1.1.0

package/README.md

@@ -87,13 +87,16 @@ For a fuller walkthrough, see the [quick start](./docs/quick-start.md).
 
 ## What's shipped
 
-Press ships three format adapters today:
+Press ships six format adapters today:
 
 - **docx** — Word documents via the [`docx`](https://docx.js.org) library. Paragraphs, headings, text runs, tables, lists, images, hyperlinks, headers/footers, page numbering. The flagship format.
 - **typst** — Typeset PDFs via the [Typst](https://typst.app) compiler. Same-source preview from `/typst` builders; whole-book compile via `compileSubtree`; `sources` mode (pure frontend, user compiles locally) and `server` mode (via a companion endpoint — see [deployment.md](./docs/architecture/deployment.md)).
 - **xlsx** — Spreadsheets via `exceljs`. Plain `{ title, headers, data }` objects, multi-sheet, preview and compiled output independent (because spreadsheets aren't typography).
+- **latex** — A LaTeX source bundle (`main.tex` and its parts, zipped) that you compile with `latexmk` or another TeX engine. Its builders at `/latex` are the `/typst` builders, so the same JSX can be registered for both.
+- **pagedjs** — Browser-paginated HTML: [Paged.js](https://pagedjs.org) lays out the pages in a browser tab, and the reader prints to PDF. It reads the fragments a foundation registers under `'html'`.
+- **epub** — Reflowable EPUB3 e-books, from the same `'html'` registrations as pagedjs.
 
-For what's next (Paged.js for browser-paginated PDFs, EPUB, slides, and a handful of speculative formats) see the [format roadmap](./docs/architecture/format-roadmap.md). For writing a custom adapter against an unsupported format, see the [custom adapter guide](./docs/guides/custom-adapter.md).
+For what's next, see the [format roadmap](./docs/design/format-roadmap.md). For writing a custom adapter against an unsupported format, see the [custom adapter guide](./docs/guides/custom-adapter.md).
 
 ## Three ways to use Press
 
@@ -152,7 +155,7 @@ Format adapters themselves (`compileDocx`, `compileTypst`, `compileXlsx`, and th
 - [Overview](./docs/architecture/overview.md) — how Press is put together under the hood, for contributors orienting to the codebase.
 - [Adding a format](./docs/architecture/adding-a-format.md) — worked examples (LaTeX, Paged.js) and the general checklist.
 - [Deployment](./docs/architecture/deployment.md) — wire protocol, reference implementations, and operational concerns for formats that need a backend.
-- [Format roadmap](./docs/architecture/format-roadmap.md) — what's shipped, what's next, what's speculative.
+- [Format roadmap](./docs/design/format-roadmap.md) — what's shipped, what's next, what's speculative.
 
 **Runnable example:**
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/press",
-  "version": "0.4.18",
+  "version": "1.1.0",
   "description": "Press your React components into downloadable files — Word, Excel, PDF. Registration-based pattern with lazy-loaded format adapters.",
   "type": "module",
   "exports": {
@@ -37,10 +37,10 @@
     "url": "https://github.com/uniweb/press/issues"
   },
   "engines": {
-    "node": ">=20.19"
+    "node": ">=22.12"
   },
   "dependencies": {
-    "docx": "^9.0.0",
+    "docx": "^9.9.0",
     "exceljs": "^4.4.0",
     "jszip": "^3.10.0",
     "parse5": "^7.2.0"

package/src/adapters/dispatch.js

@@ -18,7 +18,7 @@
  *   consumes — the store key foundations register fragments under. May
  *              differ from the output format name. Paged.js compiles
  *              'pagedjs' output but reads fragments registered under
- *              'html'; future EPUB will do the same. (See principle 6's
+ *              'html'; EPUB does the same. (See principle 6's
  *              "When the generalization is already earned" carve-out in
  *              docs/architecture/principles.md — this split was introduced
  *              with the first HTML-string adapter rather than deferred.)

package/src/adapters/docx.js

@@ -801,29 +801,25 @@ function toWidthType(v) {
 }
 
 /**
- * Build a TableCell `width` option from an IR width node.
+ * Build a TableCell (or Table) `width` option from an IR width node.
  *
  * OOXML ECMA-376 expects `w:w` to be in fiftieths of a percent when
- * `w:type="pct"` (so 50% = 2500). The docx library, when given a
- * number size with `WidthType.PERCENTAGE`, serialises it as `${n}%`
- * (e.g. `w:w="18%"`) which Word flags as a validation error and
- * auto-repairs on open. To get a plain-number output we multiply by
- * 50 and pass the value as a string — that takes the library's
- * universal-measure branch, which emits the value verbatim as a
- * plain integer while keeping `w:type="pct"`.
+ * `w:type="pct"` (so 50% = 2500). docx ≥ 9.9 writes a number size with
+ * `WidthType.PERCENTAGE` that way (50 → `w:w="2500"`), and its table
+ * column-width resolver reads the same number as a percent — so a
+ * percentage is passed as the plain number of percent.
+ *
+ * ⛔ Before 9.9 the library wrote that number as `${n}%` (`w:w="18%"`),
+ * which Word flags and repairs on open, so this passed `String(n * 50)`
+ * through the library's universal-measure branch instead. docx 9.9
+ * resolves every cell width when it builds a table and throws on that
+ * string ("Invalid universal measure '2500'"), which is why
+ * package.json requires docx ^9.9.0.
  */
 function toTableCellWidth(width) {
-    const rawSize = toInt(width.size) ?? 0
-    const t = width.type
-    if (t === 'pct' || t === 'percentage') {
-        return {
-            size: String(rawSize * 50),
-            type: WidthType.PERCENTAGE,
-        }
-    }
     return {
-        size: rawSize,
-        type: toWidthType(t),
+        size: toInt(width.size) ?? 0,
+        type: toWidthType(width.type),
     }
 }
 

package/src/compileRegistrations.js

@@ -13,8 +13,8 @@
  * Intended consumers:
  *   - Whole-book Download buttons (foundation aggregates every page's
  *     blocks into a single tree, passes it here).
- *   - Build-time compile (uniweb build --book): same aggregation run at
- *     build time rather than on click.
+ *   - Headless hosts that compile a whole site with no browser (unipress):
+ *     `compileDocument` gathers the blocks and comes through here.
  *   - Headless export pipelines (Mode 4 from the Press concepts doc).
  *
  * This function is sync in, async out — renderToStaticMarkup is sync,
@@ -51,9 +51,13 @@ import { runCompile, getAdapterDescriptor } from './adapters/dispatch.js'
  *     'typst',
  *     { basePath: website.basePath },
  *   )
- *   // hand `compiled` to the typst adapter:
- *   const { compileTypst } = await import('@uniweb/press/adapters/typst')
- *   const blob = await compileTypst(compiled, { mode: 'sources', ... })
+ *   // `compiled` is the input the typst adapter reads. The adapters are not
+ *   // exported (they stay lazy-loaded), so for the Blob call compileSubtree,
+ *   // which runs this step and the adapter:
+ *   const blob = await compileSubtree(<ChildBlocks blocks={blocks} />, 'typst', {
+ *     basePath: website.basePath,
+ *     adapterOptions: { mode: 'sources' },
+ *   })
  */
 export function compileRegistrations(elements, format, options = {}) {
     const { basePath, theme } = options

package/src/ir/compile.js

@@ -7,7 +7,7 @@
  *
  *   consumes — the store key whose fragments feed this adapter.
  *              Foundations register under this key. Multiple adapters can
- *              share the same key (e.g. pagedjs and future EPUB both read
+ *              share the same key (e.g. pagedjs and EPUB both read
  *              'html'), so a foundation writes one registration and gets
  *              both formats.
  *   ir       — whether fragments are walked to IR (true: docx/typst) or

package/src/useDocumentCompile.js

@@ -26,7 +26,7 @@ import { runCompile, getAdapterDescriptor } from './adapters/dispatch.js'
 // useDocumentCompile call in a page. Same behaviour as the off-screen
 // compileSubtree pathway — keyed on the adapter's `consumes` input shape,
 // not the output format, so a missed 'html' registration warns once total
-// even across multiple output formats (pagedjs + future epub) that share it.
+// even across multiple output formats (pagedjs + epub) that share it.
 const _emptyKeyWarned = new Set()
 function warnIfEmptyRegistrations(store, format) {
     const desc = getAdapterDescriptor(format)