takumi-pdf 0.13.0 → 0.14.0

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.0",
+  "version": "0.14.0",
   "description": "Render paged PDFs from JSX, HTML, and CSS. No headless browser.",
   "keywords": [
     "chromium-free",
@@ -139,7 +139,7 @@
     "publish-lint": "attw --pack . && publint --strict ."
   },
   "dependencies": {
-    "@takumi-rs/helpers": "2.13.2"
+    "@takumi-rs/helpers": "2.13.4"
   },
   "devDependencies": {
     "@types/bun": "^1.4.0",