@quario/pdf 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -7,6 +7,40 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-09-05
+
+### Added
+
+- **A spanning cell draws as one box** across the columns it covers, through
+  `@quario/layout`. It takes no part in measuring them, and a spanning row that
+  slices across pages or page-column strips follows the geometry of the strip
+  each slice lands in.
+- **`valign`** on table cells and split slots, through `@quario/layout`: middle
+  and bottom place the content in the height its row or split leaves over it.
+
+### Changed
+
+- **A row's box is drawn by the row's cells**, through `@quario/layout`. A box
+  declared on a table row used to be one rect across the columns; each covered
+  cell now draws its own. A row's `borderBottom` still reads as one continuous
+  edge, a row's `borderLeft` becomes an edge on every cell rather than one at
+  the row's outer left, and a bordered row is taller by its border's width,
+  since a border occupies height as a cell's always has.
+
+- **Embedding TrueType fonts now needs `fontkit`, not `@pdf-lib/fontkit`.**
+  Install `fontkit` instead; nothing else about `options.fonts` changes. The
+  old package's bundle crashed with a bare `ReferenceError` on any OpenType
+  face needing a shaping state machine — which is every Devanagari, Bengali,
+  Tamil, Khmer or Myanmar webfont in practice, and some fifty further scripts
+  besides. Those faces now measure, embed and draw. Which scripts a face
+  supports remains the font's and the parser's to answer, not this package's.
+
+- **`pdf-lib` is now `@cantoo/pdf-lib`.** A maintained fork, and what
+  `fontkit`'s subsetting requires. Rendered documents are unchanged in what
+  they draw: every drawn string is identical and every filled area lands in
+  the same place, but the file's bytes differ, so a host comparing digests
+  against stored output will see them move once.
+
 ## [0.4.0] - 2026-09-03
 
 ### Changed

package/README.md

@@ -5,7 +5,7 @@ definition straight to a paginated PDF. No headless browser, no print CSS, deter
 
 quario does the typesetting — pagination, keep-together, tables, fonts, the document outline —
 through `@quario/layout`, the same layout the viewer paints on screen, so the preview and the
-document break their pages in the same places. [pdf-lib](https://pdf-lib.js.org) writes the file. You get typesetting plus pdf-lib: no Chromium
+document break their pages in the same places. [`@cantoo/pdf-lib`](https://github.com/Cantoo-Scribe/pdf-lib) writes the file. You get typesetting plus pdf-lib: no Chromium
 in your container, no page-load race, no fonts-not-ready flake.
 
 ## Install
@@ -14,13 +14,13 @@ in your container, no page-load race, no fonts-not-ready flake.
 npm install quario @quario/pdf
 ```
 
-pdf-lib comes along as a dependency; the engine is a peer, installed beside it. ESM-only, Node 22+, and browser-ready through
+`@cantoo/pdf-lib` comes along as a dependency; the engine is a peer, installed beside it. ESM-only, Node 22+, and browser-ready through
 any standards-based ESM bundler. The renderer returns bytes, so the host decides where they go.
 
 Embedding TrueType fonts also needs the optional peer:
 
 ```bash
-npm install @pdf-lib/fontkit
+npm install fontkit
 ```
 
 It loads only when you pass `fonts` to the factory. The base-14 families need nothing extra.

package/lib/embed.js

@@ -11,27 +11,18 @@
  * variants indexed by `bold + 2 * italic`, a missing variant falling back to
  * the family's regular — so a `FaceRef` on the list names one font here.
  */
-import { StandardFonts } from "pdf-lib";
+import { StandardFonts } from "@cantoo/pdf-lib";
 
+// A family's four names are one stem plus the weight and slant suffixes that
+// family spells, so each family names its two and the four are walked out of
+// them rather than written twelve times over.
+/** @type {(stem: string, slant: string) => string[]} */
+let variants = (stem, slant) =>
+  ["", "Bold", slant, "Bold" + slant].map((v) => /** @type {any} */ (StandardFonts)[stem + v]);
 let BASE = {
-  sans: [
-    StandardFonts.Helvetica,
-    StandardFonts.HelveticaBold,
-    StandardFonts.HelveticaOblique,
-    StandardFonts.HelveticaBoldOblique,
-  ],
-  serif: [
-    StandardFonts.TimesRoman,
-    StandardFonts.TimesRomanBold,
-    StandardFonts.TimesRomanItalic,
-    StandardFonts.TimesRomanBoldItalic,
-  ],
-  mono: [
-    StandardFonts.Courier,
-    StandardFonts.CourierBold,
-    StandardFonts.CourierOblique,
-    StandardFonts.CourierBoldOblique,
-  ],
+  sans: variants("Helvetica", "Oblique"),
+  serif: variants("TimesRoman", "Italic"),
+  mono: variants("Courier", "Oblique"),
 };
 
 /** @typedef {{ families: Record<string, any[]> }} Fonts */
@@ -43,9 +34,9 @@ let BASE = {
 let useFontkit = async (doc) => {
   let fontkit;
   try {
-    fontkit = (await import("@pdf-lib/fontkit")).default;
+    fontkit = await import("fontkit");
   } catch {
-    throw Error("options.fonts: install @pdf-lib/fontkit to embed TrueType families");
+    throw Error("options.fonts: install fontkit to embed TrueType families");
   }
   doc.registerFontkit(fontkit);
 };

package/lib/index.d.ts

@@ -21,7 +21,7 @@ export interface PdfOptions {
   /**
    * TrueType families to embed (subset), selected from styles by
    * `family: '<name>'`. Fonts are trusted host assets. Requires the optional
-   * peer `@pdf-lib/fontkit`; the base-14 families need nothing extra.
+   * peer `fontkit`; the base-14 families need nothing extra.
    */
   fonts?: Record<string, PdfFontFamily>;
 }

package/lib/index.js

@@ -13,7 +13,7 @@
  * sibling modules, which ship beside it — the package publishes `lib/`
  * verbatim.
  */
-import { PDFDocument } from "pdf-lib";
+import { PDFDocument } from "@cantoo/pdf-lib";
 import { layout } from "@quario/layout";
 import { embedFonts } from "./embed.js";
 import { outline } from "./outline.js";

package/lib/outline.js

@@ -7,7 +7,7 @@
  * own position. pdf-lib has no bookmark API, so the objects are built through
  * its low-level context — the only place in this target that does.
  */
-import { PDFHexString, PDFName, PDFNumber } from "pdf-lib";
+import { PDFHexString, PDFName, PDFNumber } from "@cantoo/pdf-lib";
 
 // A PDF *text string*: UTF-16BE with a BOM, so a title survives whatever the
 // author wrote. `PDFHexString.fromText` encodes exactly that.

package/lib/painter.js

@@ -10,11 +10,11 @@
  * image can never cover it (LICENSE section 6).
  */
 import { breathe } from "quario";
-import { degrees, drawImage, drawText, rgb } from "pdf-lib";
+import { degrees, drawImage, drawText, rgb } from "@cantoo/pdf-lib";
 import { fontFor } from "./embed.js";
 
-/** @typedef {import('pdf-lib').PDFPage} PDFPage */
-/** @typedef {import('pdf-lib').PDFName} PDFName */
+/** @typedef {import('@cantoo/pdf-lib').PDFPage} PDFPage */
+/** @typedef {import('@cantoo/pdf-lib').PDFName} PDFName */
 
 // The operator builder wants explicit rotation and skew; report text has none.
 let NO_TURN = degrees(0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quario/pdf",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "The browserless, paginated PDF render target for quario — in the makings, not yet released",
   "homepage": "https://getquario.com",
   "license": "SEE LICENSE IN LICENSE",
@@ -36,23 +36,24 @@
     "postpack": "node -e \"require('fs').rmSync('LICENSE',{force:true})\""
   },
   "dependencies": {
-    "@quario/layout": "^0.1.0",
-    "pdf-lib": "^1.17.1"
+    "@cantoo/pdf-lib": "^2.9.1",
+    "@quario/layout": "^0.2.0"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.3",
-    "@pdf-lib/fontkit": "^1.1.1",
     "@size-limit/preset-small-lib": "^13.0.3",
-    "quario": "^0.4.0",
+    "@types/fontkit": "^2.0.9",
+    "fontkit": "^2.0.4",
+    "quario": "^0.5.0",
     "size-limit": "^13.0.3",
     "typescript": "^7.0.2"
   },
   "peerDependencies": {
-    "@pdf-lib/fontkit": "^1.1.1",
-    "quario": "^0.4.0"
+    "fontkit": "^2.0.4",
+    "quario": "^0.5.0"
   },
   "peerDependenciesMeta": {
-    "@pdf-lib/fontkit": {
+    "fontkit": {
       "optional": true
     }
   },
@@ -62,7 +63,7 @@
       "ignore": [
         "quario",
         "@quario/layout",
-        "pdf-lib"
+        "@cantoo/pdf-lib"
       ],
       "limit": "6 kB"
     }