takumi-pdf 0.13.1 → 0.14.1

package/bundlers/browser.mjs

@@ -0,0 +1,7 @@
+import * as wasm from "../dist/export.mjs";
+import url from "./wasm-url.mjs";
+
+wasm.initSync({ module: await fetch(url).then((response) => response.arrayBuffer()) });
+
+export * from "../dist/export.mjs";
+export default wasm.default;

package/bundlers/vite.mjs

@@ -5,7 +5,7 @@ import * as wasm from "../dist/export.mjs";
 // importing server chunk, so resolve relative to import.meta.url, not the framework output dir.
 async function resolveWasm() {
   if (typeof process !== "undefined" && process.versions?.node != null) {
-    const { readFile } = await import("node:fs/promises");
+    const { readFile } = process.getBuiltinModule("node:fs/promises");
     const path = decodeURIComponent(url.replace(/[?#].*$/, ""));
 
     // Dev SSR serves an `/@fs/<abs-path>` URL.

package/dist/export.d.cts

@@ -72,6 +72,14 @@ type PageMargin = PageMarginSide | {
   bottom?: PageMarginSide;
   left?: PageMarginSide;
 };
+/**
+ * A page to keep: a 1-based page number, or an inclusive span. An unset `from`
+ * starts at the first page; an unset `to` runs to the last.
+ */
+type PageRange = number | {
+  from?: number;
+  to?: number;
+};
 /**
  * Paged output (the default): content flows across pages of `size`, like
  * Puppeteer's `page.pdf()`. The layout canvas has unbounded height, so
@@ -95,6 +103,13 @@ type PagedOptions = {
   header?: NodeInput;
   /** Band repeated at the bottom of every page; same class hooks as `header`. */
   footer?: NodeInput;
+  /**
+   * The pages the output keeps, e.g. `[1, { from: 4, to: 8 }]`, like a print
+   * dialog's page ranges. Layout and page counters still run over the whole
+   * document, so a kept page shows the numbers it would in full output.
+   * Ranges that keep no page reject the render.
+   */
+  pageRanges?: PageRange[];
 };
 /**
  * Single-page output: a fixed viewport, like an image render. Percentage
@@ -109,6 +124,7 @@ type ViewportOptions = {
   margin?: never;
   header?: never;
   footer?: never;
+  pageRanges?: never;
 };
 /**
  * Options for {@link PdfRenderer.measure}: page geometry (or a viewport) plus
@@ -316,4 +332,4 @@ declare function render(node: NodeInput, options?: RenderOptions): Promise<Uint8
 /** Measures with a lazily created shared {@link PdfRenderer}. */
 declare function measure(node: NodeInput, options?: MeasureOptions): Promise<MeasuredSize>;
 //#endregion
-export { ArchivalAttachment, Attachment, type CounterProps, type CounterStyle, Dimensions, type FontLoader, type ImagesInput, MeasureOptions, MeasuredSize, NodeInput, PageMargin, PageMarginSide, PageNumber, PageSize, PageSizeName, PdfMetadata, PdfRenderer, RenderOptions, TargetPageNumber, TotalPages, ViewportInput, XmpProperty, XmpSchema, __wbg_init as default, initSync, measure, render };
+export { ArchivalAttachment, Attachment, type CounterProps, type CounterStyle, Dimensions, type FontLoader, type ImagesInput, MeasureOptions, MeasuredSize, NodeInput, PageMargin, PageMarginSide, PageNumber, PageRange, PageSize, PageSizeName, PdfMetadata, PdfRenderer, RenderOptions, TargetPageNumber, TotalPages, ViewportInput, XmpProperty, XmpSchema, __wbg_init as default, initSync, measure, render };

package/dist/export.d.mts

@@ -72,6 +72,14 @@ type PageMargin = PageMarginSide | {
   bottom?: PageMarginSide;
   left?: PageMarginSide;
 };
+/**
+ * A page to keep: a 1-based page number, or an inclusive span. An unset `from`
+ * starts at the first page; an unset `to` runs to the last.
+ */
+type PageRange = number | {
+  from?: number;
+  to?: number;
+};
 /**
  * Paged output (the default): content flows across pages of `size`, like
  * Puppeteer's `page.pdf()`. The layout canvas has unbounded height, so
@@ -95,6 +103,13 @@ type PagedOptions = {
   header?: NodeInput;
   /** Band repeated at the bottom of every page; same class hooks as `header`. */
   footer?: NodeInput;
+  /**
+   * The pages the output keeps, e.g. `[1, { from: 4, to: 8 }]`, like a print
+   * dialog's page ranges. Layout and page counters still run over the whole
+   * document, so a kept page shows the numbers it would in full output.
+   * Ranges that keep no page reject the render.
+   */
+  pageRanges?: PageRange[];
 };
 /**
  * Single-page output: a fixed viewport, like an image render. Percentage
@@ -109,6 +124,7 @@ type ViewportOptions = {
   margin?: never;
   header?: never;
   footer?: never;
+  pageRanges?: never;
 };
 /**
  * Options for {@link PdfRenderer.measure}: page geometry (or a viewport) plus
@@ -316,4 +332,4 @@ declare function render(node: NodeInput, options?: RenderOptions): Promise<Uint8
 /** Measures with a lazily created shared {@link PdfRenderer}. */
 declare function measure(node: NodeInput, options?: MeasureOptions): Promise<MeasuredSize>;
 //#endregion
-export { ArchivalAttachment, Attachment, type CounterProps, type CounterStyle, Dimensions, type FontLoader, type ImagesInput, MeasureOptions, MeasuredSize, NodeInput, PageMargin, PageMarginSide, PageNumber, PageSize, PageSizeName, PdfMetadata, PdfRenderer, RenderOptions, TargetPageNumber, TotalPages, ViewportInput, XmpProperty, XmpSchema, __wbg_init as default, initSync, measure, render };
+export { ArchivalAttachment, Attachment, type CounterProps, type CounterStyle, Dimensions, type FontLoader, type ImagesInput, MeasureOptions, MeasuredSize, NodeInput, PageMargin, PageMarginSide, PageNumber, PageRange, PageSize, PageSizeName, PdfMetadata, PdfRenderer, RenderOptions, TargetPageNumber, TotalPages, ViewportInput, XmpProperty, XmpSchema, __wbg_init as default, initSync, measure, render };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "takumi-pdf",
-  "version": "0.13.1",
+  "version": "0.14.1",
   "description": "Render paged PDFs from JSX, HTML, and CSS. No headless browser.",
   "keywords": [
     "chromium-free",
@@ -75,6 +75,10 @@
           "default": "./bundlers/vite.mjs"
         }
       },
+      "browser": {
+        "types": "./bundlers/node.d.ts",
+        "default": "./bundlers/browser.mjs"
+      },
       "module": {
         "types": "./bundlers/node.d.ts",
         "default": "./bundlers/vite.mjs"
@@ -139,7 +143,7 @@
     "publish-lint": "attw --pack . && publint --strict ."
   },
   "dependencies": {
-    "@takumi-rs/helpers": "2.13.3"
+    "@takumi-rs/helpers": "2.13.5"
   },
   "devDependencies": {
     "@types/bun": "^1.4.0",
@@ -155,7 +159,7 @@
     }
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=20.19"
   },
   "readme": "README.md"
 }