takumi-pdf 0.4.0 → 0.4.2

package/README.md

@@ -188,6 +188,8 @@ Omit `metadata` to keep output byte-identical across runs.
 
 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.
 
+`<table>` markup is not supported, and a table built out of flex rows carries no `Table` structure elements.
+
 `pdfa` renders archival output. Validation runs during rendering. A document that cannot conform fails with the violated rule instead of writing a broken file. Every level, and PDF/UA-1, passes [veraPDF](https://verapdf.org).
 
 ```tsx
@@ -205,6 +207,7 @@ const pdf = await render(report, {
 | `"2a"` / `"3a"`          | A tagged structure tree.              |
 | `"3b"` / `"3u"` / `"3a"` | Arbitrary file attachments.           |
 | `"4"`                    | The PDF 2.0 revision of the standard. |
+| `"4f"`                   | PDF 2.0 with file attachments.        |
 
 Invalid combinations are **TypeScript type errors**. See the [PDF/A docs](https://takumi.kane.tw/docs/pdf/pdf-a) for the structure-tree mapping and required metadata.
 

package/dist/export.cjs

@@ -2,6 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
+let _takumi_rs_helpers_html = require("@takumi-rs/helpers/html");
 let _takumi_rs_helpers_jsx = require("@takumi-rs/helpers/jsx");
 let _takumi_rs_helpers_renderer = require("@takumi-rs/helpers/renderer");
 //#region pkg/takumi_pdf_wasm.js
@@ -500,16 +501,18 @@ function isNode(value) {
 	return typeof value === "object" && value !== null && "type" in value && !("$$typeof" in value);
 }
 async function resolveNode(input) {
-	return isNode(input) ? {
+	if (isNode(input)) return {
 		node: input,
 		stylesheets: []
-	} : (0, _takumi_rs_helpers_jsx.fromJsx)(input);
+	};
+	if (typeof input === "string") return (0, _takumi_rs_helpers_html.fromHtml)(input);
+	return (0, _takumi_rs_helpers_jsx.fromJsx)(input);
 }
 /** A PDF renderer holding registered fonts. Reuse one instance across renders. */
 var PdfRenderer = class {
 	inner = new PdfRenderer$1();
 	fonts = new _takumi_rs_helpers_renderer.FontRegistry((font) => this.inner.registerFont(font));
-	/** Renders a node tree or JSX to PDF bytes. See {@link RenderOptions}. */
+	/** Renders a node tree, JSX, or an HTML string to PDF bytes. See {@link RenderOptions}. */
 	async render(node, options = {}) {
 		const { fonts, images, header, footer, stylesheets, fontFamilies, ...rest } = options;
 		const [main, headerResult, footerResult, resources] = await Promise.all([

package/dist/export.d.cts

@@ -46,8 +46,8 @@ declare module "react" {
     tw?: string;
   }
 }
-/** A document input: a takumi node tree or JSX. */
-type NodeInput = Node | ReactNode | ReactElementLike;
+/** A document input: a takumi node tree, JSX, or an HTML string. */
+type NodeInput = Node | ReactNode | ReactElementLike | string;
 /** Explicit dimensions in CSS px (96 dpi). */
 type Dimensions = {
   width: number;
@@ -213,7 +213,7 @@ type ArchivalAttachment = Attachment & {
  * Standards conformance. Invalid combinations are type errors: the `a` levels
  * imply a structure tree so `tagged: false` is rejected, PDF/A-4 is PDF 2.0
  * while PDF/UA-1 is PDF 1.7-only so they cannot combine, and only the
- * PDF/A-3 levels (or plain PDF) accept attachments.
+ * PDF/A-3 levels, PDF/A-4f (or plain PDF) accept attachments.
  */
 type ConformanceOptions = {
   pdfa?: never;
@@ -242,6 +242,10 @@ type ConformanceOptions = {
   pdfa: "4";
   tagged?: boolean;
   attachments?: never;
+} | {
+  pdfa: "4f";
+  tagged?: boolean;
+  attachments?: ArchivalAttachment[];
 };
 type RenderOptions = (PagedOptions | ViewportOptions) & ConformanceOptions & {
   /** Fonts to register before rendering, deduped across calls. */
@@ -266,7 +270,7 @@ type RenderOptions = (PagedOptions | ViewportOptions) & ConformanceOptions & {
 declare class PdfRenderer {
   private inner;
   private fonts;
-  /** Renders a node tree or JSX to PDF bytes. See {@link RenderOptions}. */
+  /** Renders a node tree, JSX, or an HTML string to PDF bytes. See {@link RenderOptions}. */
   render(node: NodeInput, options?: RenderOptions): Promise<Uint8Array>;
   /**
    * Lays out a node tree without rendering and returns its size in CSS px.

package/dist/export.d.mts

@@ -46,8 +46,8 @@ declare module "react" {
     tw?: string;
   }
 }
-/** A document input: a takumi node tree or JSX. */
-type NodeInput = Node | ReactNode | ReactElementLike;
+/** A document input: a takumi node tree, JSX, or an HTML string. */
+type NodeInput = Node | ReactNode | ReactElementLike | string;
 /** Explicit dimensions in CSS px (96 dpi). */
 type Dimensions = {
   width: number;
@@ -213,7 +213,7 @@ type ArchivalAttachment = Attachment & {
  * Standards conformance. Invalid combinations are type errors: the `a` levels
  * imply a structure tree so `tagged: false` is rejected, PDF/A-4 is PDF 2.0
  * while PDF/UA-1 is PDF 1.7-only so they cannot combine, and only the
- * PDF/A-3 levels (or plain PDF) accept attachments.
+ * PDF/A-3 levels, PDF/A-4f (or plain PDF) accept attachments.
  */
 type ConformanceOptions = {
   pdfa?: never;
@@ -242,6 +242,10 @@ type ConformanceOptions = {
   pdfa: "4";
   tagged?: boolean;
   attachments?: never;
+} | {
+  pdfa: "4f";
+  tagged?: boolean;
+  attachments?: ArchivalAttachment[];
 };
 type RenderOptions = (PagedOptions | ViewportOptions) & ConformanceOptions & {
   /** Fonts to register before rendering, deduped across calls. */
@@ -266,7 +270,7 @@ type RenderOptions = (PagedOptions | ViewportOptions) & ConformanceOptions & {
 declare class PdfRenderer {
   private inner;
   private fonts;
-  /** Renders a node tree or JSX to PDF bytes. See {@link RenderOptions}. */
+  /** Renders a node tree, JSX, or an HTML string to PDF bytes. See {@link RenderOptions}. */
   render(node: NodeInput, options?: RenderOptions): Promise<Uint8Array>;
   /**
    * Lays out a node tree without rendering and returns its size in CSS px.

package/dist/export.mjs

@@ -1,3 +1,4 @@
+import { fromHtml } from "@takumi-rs/helpers/html";
 import { fromJsx } from "@takumi-rs/helpers/jsx";
 import { FontRegistry } from "@takumi-rs/helpers/renderer";
 //#region pkg/takumi_pdf_wasm.js
@@ -496,16 +497,18 @@ function isNode(value) {
 	return typeof value === "object" && value !== null && "type" in value && !("$$typeof" in value);
 }
 async function resolveNode(input) {
-	return isNode(input) ? {
+	if (isNode(input)) return {
 		node: input,
 		stylesheets: []
-	} : fromJsx(input);
+	};
+	if (typeof input === "string") return fromHtml(input);
+	return fromJsx(input);
 }
 /** A PDF renderer holding registered fonts. Reuse one instance across renders. */
 var PdfRenderer = class {
 	inner = new PdfRenderer$1();
 	fonts = new FontRegistry((font) => this.inner.registerFont(font));
-	/** Renders a node tree or JSX to PDF bytes. See {@link RenderOptions}. */
+	/** Renders a node tree, JSX, or an HTML string to PDF bytes. See {@link RenderOptions}. */
 	async render(node, options = {}) {
 		const { fonts, images, header, footer, stylesheets, fontFamilies, ...rest } = options;
 		const [main, headerResult, footerResult, resources] = await Promise.all([

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "takumi-pdf",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "HTML/JSX to paged, selectable-text PDF, powered by takumi. WebAssembly, no Chromium.",
   "keywords": [
     "css",