takumi-pdf 0.5.0 → 0.6.0

package/README.md

@@ -3,9 +3,9 @@
 
 # takumi-pdf
 
-**Render JSX to paged, selectable-text PDF. WebAssembly, no Chromium.**
+**Render paged PDFs from JSX, HTML, and CSS. No headless browser.**
 
-Invoices, reports, and receipts from the Takumi renderer, with CSS layout and vector PDF output.
+Build invoices and reports with CSS or Tailwind. The renderer writes vector PDF with selectable text.
 
 [Documentation](https://takumi.kane.tw/docs/) · [Playground](https://takumi.kane.tw/playground)
 
@@ -13,9 +13,9 @@ Invoices, reports, and receipts from the Takumi renderer, with CSS layout and ve
 
 ## Why
 
-Browser-based PDF generation brings the Chromium serverless tax: browser cold starts, browser memory, a large browser binary, and headless-browser work before a document can render. It is a capable screenshot pipeline, but it is still a browser.
+Browser-based PDF generation starts a browser process and ships a Chrome installation. `takumi-pdf` compiles Takumi's layout and PDF code to WebAssembly.
 
-`takumi-pdf` uses Takumi's own layout and PDF rendering primitives, compiled to WebAssembly. There is no browser process. Render JSX or a Takumi node tree with CSS and Tailwind classes, then receive vector PDF bytes with selectable, searchable text and embedded subset fonts.
+Pass JSX or a Takumi node tree with CSS. The renderer returns vector PDF bytes with searchable text and embedded subset fonts.
 
 ## Install
 
@@ -168,7 +168,7 @@ const pdf = await render(
 
 ## Links, outline, and metadata
 
-Anchors with an `href` become clickable link annotations. `outline: true` builds PDF bookmarks from `h1`–`h6` headings. `metadata` fills the document properties:
+Anchors with an `href` become clickable link annotations. `outline: true` builds PDF bookmarks from `h1` through `h6` headings. `metadata` fills the document properties:
 
 ```tsx
 const pdf = await render(report, {
@@ -186,7 +186,7 @@ Omit `metadata` to keep output byte-identical across runs.
 
 ## Tagged output and PDF/A
 
-Output is **tagged by default**: HTML semantics (`h1`–`h6`, `p`, `img` with `alt`, `a`, lists) become a PDF structure tree, like Chromium's print-to-PDF. Set `tagged: "ua1"` to validate against PDF/UA-1, or `tagged: false` to drop the tree when file size matters more than accessibility.
+Output is **tagged by default**: HTML semantics (`h1` through `h6`, `p`, `img` with `alt`, `a`, lists) become a PDF structure tree, like Chromium's print-to-PDF. Set `tagged: "ua1"` to validate against PDF/UA-1, or `tagged: false` to drop the tree when file size matters more than accessibility.
 
 `<table>` markup is not supported, and a table built out of flex rows carries no `Table` structure elements.
 

package/dist/export.cjs

@@ -104,6 +104,32 @@ var PdfRenderer$1 = class {
 	}
 };
 if (Symbol.dispose) PdfRenderer$1.prototype[Symbol.dispose] = PdfRenderer$1.prototype.free;
+/**
+* The characters the page counters named by these class names can produce.
+*
+* A counter's characters appear nowhere in the document, so a caller choosing
+* which faces to load has no other way to learn it needs, say, Thai digits.
+* @param {string[]} classes
+* @returns {string}
+*/
+function counterCharacters(classes) {
+	let deferred2_0;
+	let deferred2_1;
+	try {
+		const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+		const ptr0 = passArrayJsValueToWasm0(classes, wasm.__wbindgen_export);
+		const len0 = WASM_VECTOR_LEN;
+		wasm.counterCharacters(retptr, ptr0, len0);
+		var r0 = getDataViewMemory0().getInt32(retptr + 0, true);
+		var r1 = getDataViewMemory0().getInt32(retptr + 4, true);
+		deferred2_0 = r0;
+		deferred2_1 = r1;
+		return getStringFromWasm0(r0, r1);
+	} finally {
+		wasm.__wbindgen_add_to_stack_pointer(16);
+		wasm.__wbindgen_export4(deferred2_0, deferred2_1, 1);
+	}
+}
 function __wbg_get_imports() {
 	return {
 		__proto__: null,
@@ -383,6 +409,13 @@ let heap_next = heap.length;
 function isLikeNone(x) {
 	return x === void 0 || x === null;
 }
+function passArrayJsValueToWasm0(array, malloc) {
+	const ptr = malloc(array.length * 4, 4) >>> 0;
+	const mem = getDataViewMemory0();
+	for (let i = 0; i < array.length; i++) mem.setUint32(ptr + 4 * i, addHeapObject(array[i]), true);
+	WASM_VECTOR_LEN = array.length;
+	return ptr;
+}
 function passStringToWasm0(arg, malloc, realloc) {
 	if (realloc === void 0) {
 		const buf = cachedTextEncoder.encode(arg);
@@ -498,8 +531,18 @@ async function __wbg_init(module_or_path) {
 }
 //#endregion
 //#region src/export.ts
-/** Every character a page counter can produce, so subsetting keeps the fonts a band needs. */
-const COUNTER_DIGITS = "0123456789";
+/** Every class name in a tree, so the renderer can say what its counters draw. */
+function classNames(node) {
+	const into = [];
+	collectClassNames(node, into);
+	return into;
+}
+function collectClassNames(node, into) {
+	if (typeof node !== "object" || node === null) return;
+	const { className, children } = node;
+	if (typeof className === "string") into.push(...className.split(/\s+/).filter(Boolean));
+	if (Array.isArray(children)) for (const child of children) collectClassNames(child, into);
+}
 function isNode(value) {
 	return typeof value === "object" && value !== null && "type" in value && !("$$typeof" in value);
 }
@@ -526,11 +569,11 @@ var PdfRenderer = class {
 		const bands = [headerResult?.node, footerResult?.node].filter((band) => band !== void 0);
 		const resources = await this.fonts.resolveResources(fonts && (0, _takumi_rs_helpers.subsetFonts)({
 			fonts,
-			source: bands.length > 0 ? [
+			source: [
 				main.node,
 				...bands,
-				COUNTER_DIGITS
-			] : main.node
+				counterCharacters([main.node, ...bands].flatMap((tree) => classNames(tree)))
+			]
 		}), images, fontFamilies);
 		const sheets = [
 			...stylesheets ?? [],
@@ -563,7 +606,7 @@ var PdfRenderer = class {
 		const main = await resolveNode(node);
 		const resources = await this.fonts.resolveResources(fonts && (0, _takumi_rs_helpers.subsetFonts)({
 			fonts,
-			source: [main.node, COUNTER_DIGITS]
+			source: [main.node, counterCharacters(classNames(main.node))]
 		}), images, fontFamilies);
 		const sheets = [...stylesheets ?? [], ...main.stylesheets];
 		return this.inner.measure(main.node, {

package/dist/export.d.cts

@@ -6,6 +6,7 @@ type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Modul
 interface InitOutput {
   readonly memory: WebAssembly.Memory;
   readonly __wbg_pdfrenderer_free: (a: number, b: number) => void;
+  readonly counterCharacters: (a: number, b: number, c: number) => void;
   readonly pdfrenderer_measure: (a: number, b: number, c: number, d: number) => void;
   readonly pdfrenderer_new: (a: number) => void;
   readonly pdfrenderer_registerFont: (a: number, b: number, c: number) => void;

package/dist/export.d.mts

@@ -6,6 +6,7 @@ type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Modul
 interface InitOutput {
   readonly memory: WebAssembly.Memory;
   readonly __wbg_pdfrenderer_free: (a: number, b: number) => void;
+  readonly counterCharacters: (a: number, b: number, c: number) => void;
   readonly pdfrenderer_measure: (a: number, b: number, c: number, d: number) => void;
   readonly pdfrenderer_new: (a: number) => void;
   readonly pdfrenderer_registerFont: (a: number, b: number, c: number) => void;

package/dist/export.mjs

@@ -100,6 +100,32 @@ var PdfRenderer$1 = class {
 	}
 };
 if (Symbol.dispose) PdfRenderer$1.prototype[Symbol.dispose] = PdfRenderer$1.prototype.free;
+/**
+* The characters the page counters named by these class names can produce.
+*
+* A counter's characters appear nowhere in the document, so a caller choosing
+* which faces to load has no other way to learn it needs, say, Thai digits.
+* @param {string[]} classes
+* @returns {string}
+*/
+function counterCharacters(classes) {
+	let deferred2_0;
+	let deferred2_1;
+	try {
+		const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+		const ptr0 = passArrayJsValueToWasm0(classes, wasm.__wbindgen_export);
+		const len0 = WASM_VECTOR_LEN;
+		wasm.counterCharacters(retptr, ptr0, len0);
+		var r0 = getDataViewMemory0().getInt32(retptr + 0, true);
+		var r1 = getDataViewMemory0().getInt32(retptr + 4, true);
+		deferred2_0 = r0;
+		deferred2_1 = r1;
+		return getStringFromWasm0(r0, r1);
+	} finally {
+		wasm.__wbindgen_add_to_stack_pointer(16);
+		wasm.__wbindgen_export4(deferred2_0, deferred2_1, 1);
+	}
+}
 function __wbg_get_imports() {
 	return {
 		__proto__: null,
@@ -379,6 +405,13 @@ let heap_next = heap.length;
 function isLikeNone(x) {
 	return x === void 0 || x === null;
 }
+function passArrayJsValueToWasm0(array, malloc) {
+	const ptr = malloc(array.length * 4, 4) >>> 0;
+	const mem = getDataViewMemory0();
+	for (let i = 0; i < array.length; i++) mem.setUint32(ptr + 4 * i, addHeapObject(array[i]), true);
+	WASM_VECTOR_LEN = array.length;
+	return ptr;
+}
 function passStringToWasm0(arg, malloc, realloc) {
 	if (realloc === void 0) {
 		const buf = cachedTextEncoder.encode(arg);
@@ -494,8 +527,18 @@ async function __wbg_init(module_or_path) {
 }
 //#endregion
 //#region src/export.ts
-/** Every character a page counter can produce, so subsetting keeps the fonts a band needs. */
-const COUNTER_DIGITS = "0123456789";
+/** Every class name in a tree, so the renderer can say what its counters draw. */
+function classNames(node) {
+	const into = [];
+	collectClassNames(node, into);
+	return into;
+}
+function collectClassNames(node, into) {
+	if (typeof node !== "object" || node === null) return;
+	const { className, children } = node;
+	if (typeof className === "string") into.push(...className.split(/\s+/).filter(Boolean));
+	if (Array.isArray(children)) for (const child of children) collectClassNames(child, into);
+}
 function isNode(value) {
 	return typeof value === "object" && value !== null && "type" in value && !("$$typeof" in value);
 }
@@ -522,11 +565,11 @@ var PdfRenderer = class {
 		const bands = [headerResult?.node, footerResult?.node].filter((band) => band !== void 0);
 		const resources = await this.fonts.resolveResources(fonts && subsetFonts({
 			fonts,
-			source: bands.length > 0 ? [
+			source: [
 				main.node,
 				...bands,
-				COUNTER_DIGITS
-			] : main.node
+				counterCharacters([main.node, ...bands].flatMap((tree) => classNames(tree)))
+			]
 		}), images, fontFamilies);
 		const sheets = [
 			...stylesheets ?? [],
@@ -559,7 +602,7 @@ var PdfRenderer = class {
 		const main = await resolveNode(node);
 		const resources = await this.fonts.resolveResources(fonts && subsetFonts({
 			fonts,
-			source: [main.node, COUNTER_DIGITS]
+			source: [main.node, counterCharacters(classNames(main.node))]
 		}), images, fontFamilies);
 		const sheets = [...stylesheets ?? [], ...main.stylesheets];
 		return this.inner.measure(main.node, {

package/package.json

@@ -1,14 +1,19 @@
 {
   "name": "takumi-pdf",
-  "version": "0.5.0",
-  "description": "HTML/JSX to paged, selectable-text PDF, powered by takumi. WebAssembly, no Chromium.",
+  "version": "0.6.0",
+  "description": "Render paged PDFs from JSX, HTML, and CSS. No headless browser.",
   "keywords": [
+    "chromium-free",
+    "cjk",
     "css",
+    "html-to-pdf",
     "invoice",
     "jsx",
     "pdf",
+    "pdf-generation",
     "react",
-    "rendering",
+    "receipt",
+    "tailwind",
     "webassembly"
   ],
   "homepage": "https://takumi.kane.tw/docs/",
@@ -83,7 +88,7 @@
     "publish-lint": "attw --pack . && publint --strict ."
   },
   "dependencies": {
-    "@takumi-rs/helpers": "2.6.0"
+    "@takumi-rs/helpers": "2.6.1"
   },
   "devDependencies": {
     "@types/bun": "^1.3.14",

package/pkg/takumi_pdf_wasm_bg.wasm.d.ts

@@ -2,6 +2,7 @@
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
 export const __wbg_pdfrenderer_free: (a: number, b: number) => void;
+export const counterCharacters: (a: number, b: number, c: number) => void;
 export const pdfrenderer_measure: (a: number, b: number, c: number, d: number) => void;
 export const pdfrenderer_new: (a: number) => void;
 export const pdfrenderer_registerFont: (a: number, b: number, c: number) => void;