@t4h.framework/pdf 0.0.0

package/.ai/skills/framework-pdf/SKILL.md

@@ -0,0 +1,310 @@
+---
+name: framework-pdf
+description: >-
+  Guides correct use of @t4h.framework/pdf in T4H Framework workflows: the
+  `render()` helper, PDF marker components (Document, Page, View, Text, Link,
+  Image, PageNumber), custom fonts, Binary image sources, styling, and the
+  FileSystemClaim the render activity requires. Use when generating PDFs in
+  workflows, building PDF templates with JSX, registering fonts, or working
+  in packages/pdf.
+---
+
+# @t4h.framework/pdf
+
+Declarative PDF rendering for workflows, backed by `@react-pdf/renderer`.
+Package path: `framework/packages/pdf`. Peer dependencies:
+`@t4h.framework/core`, `@t4h.framework/fs`. Regular dependencies: `react`,
+`@react-pdf/renderer`.
+
+Import surface (from `src/pdf.ts` only — the `helpers/` modules are internal):
+
+```typescript
+import {
+  render,
+  Document,
+  Page,
+  View,
+  Text,
+  Link,
+  Image,
+  PageNumber,
+  RenderPDFActivity,
+  type RenderPDFOptions,
+  type RenderPDFInput,
+  type DocumentProps,
+  type PageProps,
+  type ViewProps,
+  type TextProps,
+  type LinkProps,
+  type ImageProps,
+  type PageNumberProps,
+  type DocumentNode,
+  type PDFNode,
+  type PDFStyle,
+} from '@t4h.framework/pdf'
+```
+
+> Workflows use **`render()`**. The package also exports the underlying
+> `RenderPDFActivity`, but workflow code never imports, instantiates, or
+> extends it.
+
+## Architecture
+
+`Workflow` → `render(<Document>…</Document>, options?)`
+(`History.reconciler(RenderPDFActivity)`) →
+
+1. **`toInput`** (workflow side): the JSX tree is serialized into a plain
+   `DocumentNode` JSON tree that is stored in the workflow history. User
+   function components, fragments, arrays, and conditionals are flattened
+   here; only marker components and strings remain.
+2. **`run`** (activity side): fonts are registered, the `DocumentNode` tree is
+   converted back into real `@react-pdf/renderer` elements (`Binary` image
+   sources become `data:` URIs), rendered to a buffer, and written through
+   **`FileSystemClaim`** at `pdf/${activityId}.pdf`.
+3. The activity returns the **`Binary`** the claim produced — a reference to
+   the stored file, not in-memory bytes. Replay-safe by construction.
+
+---
+
+## Claims
+
+### FileSystemClaim (required)
+
+The render activity persists the PDF through `fs`. Any workflow that calls
+`render()` needs a `FileSystemClaim` provider:
+
+```typescript
+{ provide: FileSystemClaim, value: new MyFileSystemClaimImpl() }
+```
+
+Tests mock its `write` to return a `Binary` (see **Testing**).
+
+---
+
+## Marker components
+
+The components exported by this package are **markers**: they exist only as
+type-safe JSX tags inside a tree passed to `render()`. JSX never invokes
+them — the serializer recognizes them by reference. Calling one directly
+(`Image({ src })`) or rendering them with another renderer throws.
+
+| Component | Props (beyond `NodeProps`) | Notes |
+|-----------|---------------------------|-------|
+| `Document` | `title? author? subject? creator? producer? language?` | Root. Children must be `Page` elements |
+| `Page` | `size? orientation? style? wrap? dpi?` | `size` defaults to A4. Overflowing content paginates automatically |
+| `View` | — | Flex container, analogous to a `<div>` |
+| `Text` | — | All raw strings must live inside a `Text` |
+| `Link` | `href` (required) | Hyperlink; serialized `href` becomes react-pdf's `src` internally |
+| `Image` | `src: string \| Binary` (required) | URL, `data:` URI, or `Binary` with an image `contentType` |
+| `PageNumber` | `format?` | Resolves at layout time. Tokens: `{pageNumber}`, `{totalPages}`. Default `'{pageNumber}'`. Combine with `fixed` for running footers |
+
+`NodeProps` (shared by every node inside a page): `style`, `fixed` (repeat on
+every page — headers/footers), `break` (force page break before the node),
+`wrap` (allow splitting across pages, default `true`), `minPresenceAhead`
+(move to next page unless this many points remain — avoids orphaned headings).
+
+**Tree rules enforced at serialization** (violations throw `TypeError`):
+
+- The tree must resolve to a single `Document` root.
+- `Document` children must be `Page` elements.
+- Raw text must be wrapped in `Text` (`"x"` directly inside `View`/`Page` throws).
+- Only `Text`, `Link`, and `PageNumber` are allowed inside `Text`.
+- `Image` is not allowed inside `Text`.
+
+User function components, `.map()` arrays, fragments, and conditional
+rendering (`null` / `false` / `undefined`) work exactly like normal React —
+they are evaluated and flattened during serialization.
+
+---
+
+## Styling
+
+`PDFStyle` is a loose camelCase record (`fontSize`, `flexDirection`,
+`marginTop`, …). Layout is the CSS **flex model only** — no grid, no float.
+Values: numbers are points; strings accept units (`'2cm'`, `'5mm'`, `'50%'`).
+`style` also accepts an array of styles.
+
+Text styles (`color`, `fontSize`, `fontFamily`, …) **inherit** through the
+tree, so defaults belong on `Page`:
+
+```tsx
+<Page size='A4' style={{ padding: '2cm', fontSize: 12, color: '#00513a' }}>
+```
+
+Built-in fonts (no registration needed): Helvetica, Courier, Times-Roman —
+with `fontWeight: 'bold'` / `fontStyle: 'italic'` variants.
+
+---
+
+## Rendering in a workflow
+
+```tsx
+import { Workflow } from '@t4h.framework/core'
+import { Document, Page, PageNumber, Text, View, render } from '@t4h.framework/pdf'
+
+function Header({ title }: { title: string }) {
+  return (
+    <View style={{ borderBottom: '1 solid #333', marginBottom: 16 }}>
+      <Text style={{ fontSize: 18 }}>{title}</Text>
+    </View>
+  )
+}
+
+export const invoice = new Workflow({ id: 'invoice' }, async () => {
+  const pdf = await render(
+    <Document title='Invoice'>
+      <Page size='A4' style={{ padding: '2cm', fontSize: 12 }}>
+        <Header title='Invoice #42' />
+        {items.map(item => (
+          <View key={item.id} style={{ flexDirection: 'row', justifyContent: 'space-between' }}>
+            <Text>{item.label}</Text>
+            <Text>{item.total}</Text>
+          </View>
+        ))}
+        <PageNumber
+          fixed
+          format='{pageNumber}/{totalPages}'
+          style={{ position: 'absolute', bottom: 24, right: '2cm' }}
+        />
+      </Page>
+    </Document>,
+  )
+
+  // pdf is a Binary — pass it to other activities, e.g. an http form upload:
+  // await http.post(url, { form: { file: pdf } })
+})
+```
+
+The returned `Binary` exposes `contentType` (`application/pdf`),
+`contentLength`, and `stream()`.
+
+---
+
+## Images
+
+`Image src` accepts three shapes:
+
+- **URL string** — fetched by react-pdf at layout time. Simple, but the fetch
+  happens on every render/replay and cannot authenticate.
+- **`data:` URI string** — for small assets bundled with the app.
+- **`Binary`** — the replay-safe choice for anything private or that must stay
+  byte-identical across replays. The bytes are inlined as a `data:` URI on the
+  activity side. Typical source: an `http` response body
+  (`response.body.binary`) or any other claim-produced `Binary`.
+
+Supported formats: PNG and JPEG.
+
+---
+
+## Fonts
+
+`render(element, { fonts })` — an object keyed by **family name**. The value
+is either a bare source (registers the regular 400/normal variant) or an
+array of variants:
+
+```tsx
+const pdf = await render(<Doc />, {
+  fonts: {
+    // bare source: string URL or Binary
+    Inter: 'https://cdn.example.com/Inter-Regular.ttf',
+    Geometric: fontResponse.body.binary,
+
+    // multiple weights/styles under one family
+    Roboto: [
+      { src: robotoRegular.body.binary },
+      { src: robotoBold.body.binary, weight: 700 },
+      { src: robotoItalic.body.binary, style: 'italic' },
+    ],
+  },
+})
+```
+
+Select variants in styles with `fontFamily` + `fontWeight` + `fontStyle`.
+Weights are `100–900`; styles `'normal' | 'italic'`.
+
+Rules of thumb:
+
+- **TTF and WOFF only** — react-pdf cannot parse WOFF2 (Google Fonts links
+  often point to WOFF2; pick the TTF URL).
+- Prefer `Binary` for private/licensed fonts and replay stability; a URL is a
+  mutable external reference fetched at layout time.
+- Fonts registered per render; same-family re-registration is safe.
+
+---
+
+## Testing
+
+Test the **workflow** with `TestWorkflowEnvironment` from
+`@t4h.framework/core/testing`, mocking the single claim the render activity
+uses: `FileSystemClaim`. See the **framework-workflow-testing** skill for the
+harness API.
+
+```typescript
+import { Readable } from 'node:stream'
+import { Binary } from '@t4h.framework/core'
+import { TestWorkflowEnvironment, mockClaim } from '@t4h.framework/core/testing'
+import { FileSystemClaim } from '@t4h.framework/fs'
+
+class MockBinary extends Binary {
+  public readonly contentType = 'application/pdf'
+  public readonly contentLength: number
+
+  constructor(private readonly data: Buffer) {
+    super()
+    this.contentLength = data.byteLength
+  }
+
+  public stream() {
+    return Readable.from(this.data)
+  }
+}
+
+const mockWrite = vi.fn().mockImplementation(async (_path, pdf: Buffer) => {
+  return new MockBinary(pdf)
+})
+
+const env = TestWorkflowEnvironment.create({ now: 0 })
+
+await env.execute(workflow, input, {
+  claims: [mockClaim(FileSystemClaim, { write: mockWrite, read: vi.fn() })],
+})
+
+// The activity hands the rendered buffer to fs.write — assert on it:
+const [path, pdf] = mockWrite.mock.calls[0]
+expect(path).toMatch(/^pdf\/.+\.pdf$/)
+expect(pdf.subarray(0, 5).toString()).toBe('%PDF-')
+```
+
+For helper-level tests (serialization, element mapping, fonts), see
+`src/helpers/__tests__/` — they assert on the `DocumentNode` JSON shape and on
+react-pdf element trees without rendering.
+
+---
+
+## Checklist for agents
+
+1. In workflows, **always** use **`render()`** — never define, extend, or
+   hand-instantiate `RenderPDFActivity`.
+2. Build templates with the **marker components from this package** — never
+   import `Document`/`Page`/etc. from `@react-pdf/renderer` in workflow code,
+   and never call a marker as a function.
+3. Wrap every raw string in **`Text`**; only `Text`/`Link`/`PageNumber` go
+   inside `Text`; `Document` children are `Page` only.
+4. Ensure the runtime provides **`FileSystemClaim`** (or mock it in tests) —
+   the rendered PDF is persisted through it and returned as a `Binary`.
+5. Prefer **`Binary`** sources for images and fonts that must be private or
+   replay-stable; URLs are fetched at layout time on every render.
+6. Fonts: object keyed by family, **TTF/WOFF only**, select variants via
+   `fontFamily`/`fontWeight`/`fontStyle`.
+7. Style with the **flex model** (`PDFStyle`, camelCase, points or unit
+   strings); put inheritable text defaults on `Page`.
+8. Use `fixed` + absolute positioning for running headers/footers and
+   `PageNumber` for pagination stamps.
+9. Test workflows with **`TestWorkflowEnvironment`** + **`mockClaim`**,
+   asserting the `%PDF-` magic bytes on the `fs.write` call.
+10. Do not document or import APIs not exported from `@t4h.framework/pdf`
+    (the `helpers/` modules are internal).
+
+See also: **framework-workflow-testing** for the test harness;
+**framework-fs** for `FileSystemClaim`; **framework-http** for fetching
+`Binary` assets (images, fonts) used in templates.

package/README.md

@@ -0,0 +1,163 @@
+# @t4h.framework/pdf
+
+Declarative PDF rendering for workflows. Build documents with JSX components, render them replay-safely through the workflow history, and get back a `Binary` persisted via the filesystem claim. Backed by [`@react-pdf/renderer`](https://react-pdf.org).
+
+## Claim
+
+### FileSystemClaim
+
+The render activity persists the generated PDF through `FileSystemClaim` (from `@t4h.framework/fs`) and returns the resulting `Binary`. The runtime must provide a concrete implementation.
+
+```typescript
+import { FileSystemClaim } from '@t4h.framework/fs'
+
+// the runtime provides this:
+// { provide: FileSystemClaim, value: new MyFileSystemClaimImpl() }
+```
+
+## Rendering
+
+### render
+
+Renders a JSX tree to a PDF `Binary` through the workflow history. The tree is serialized into the history on the workflow side and rendered on the activity side, so the step is replay-safe.
+
+```tsx
+import { Workflow } from '@t4h.framework/core'
+import { Document, Page, Text, render } from '@t4h.framework/pdf'
+
+export const invoice = new Workflow({ id: 'invoice' }, async () => {
+  const pdf = await render(
+    <Document title='Invoice'>
+      <Page size='A4' style={{ padding: '2cm', fontSize: 12 }}>
+        <Text>Hello world</Text>
+      </Page>
+    </Document>,
+  )
+
+  // pdf is a Binary — hand it to other activities, e.g. an upload:
+  // await http.post(url, { form: { file: pdf } })
+})
+```
+
+The returned `Binary` exposes `contentType` (`application/pdf`), `contentLength`, and `stream()`.
+
+## Components
+
+The components exported by this package are **markers**: type-safe JSX tags that only exist inside a tree passed to `render()`. They are never invoked as functions — calling one directly or rendering it with another renderer throws.
+
+| Component | Key props | Description |
+|-----------|-----------|-------------|
+| `Document` | `title`, `author`, `subject`, `language` | Root of the PDF. Children must be `Page` elements |
+| `Page` | `size` (default `A4`), `orientation`, `style`, `dpi` | A page. Overflowing content paginates automatically |
+| `View` | — | Flex container, analogous to a `<div>` |
+| `Text` | — | Text content. All raw strings must live inside a `Text` |
+| `Link` | `href` | Hyperlink |
+| `Image` | `src` | Image from a URL, `data:` URI, or `Binary` |
+| `PageNumber` | `format` | Text resolved to the current page number at layout time |
+
+Every node inside a page also accepts: `style`, `fixed` (repeat on every page), `break` (force a page break), `wrap` (allow splitting across pages, default `true`), and `minPresenceAhead`.
+
+User function components, `.map()` arrays, fragments, and conditional rendering work exactly like normal React:
+
+```tsx
+function LineItem({ label, value }: { label: string; value: string }) {
+  return (
+    <View style={{ flexDirection: 'row', justifyContent: 'space-between' }}>
+      <Text>{label}</Text>
+      <Text>{value}</Text>
+    </View>
+  )
+}
+
+const pdf = await render(
+  <Document>
+    <Page size='A4'>
+      {items.map(item => (
+        <LineItem key={item.id} {...item} />
+      ))}
+      {showFooter && <Text>Footer</Text>}
+    </Page>
+  </Document>,
+)
+```
+
+Tree rules enforced at serialization (violations throw):
+
+- The tree must resolve to a single `Document` root, and `Document` children must be `Page` elements.
+- Raw text must be wrapped in `Text`.
+- Only `Text`, `Link`, and `PageNumber` are allowed inside `Text`.
+
+## Styling
+
+Styles are camelCase records following the CSS **flex model** (no grid, no float). Numbers are points; strings accept units (`'2cm'`, `'5mm'`, `'50%'`). Text styles inherit through the tree, so defaults belong on `Page`.
+
+```tsx
+<Page size='A4' style={{ padding: '2cm', fontSize: 12, color: '#00513a' }}>
+  <View style={{ flexDirection: 'row', gap: 8 }}>
+    <Text style={{ fontWeight: 'bold' }}>Bold</Text>
+    <Text style={[{ fontSize: 10 }, { color: '#666' }]}>Small and gray</Text>
+  </View>
+</Page>
+```
+
+The standard PDF fonts (Helvetica, Courier, Times-Roman) are available with no registration, including `bold` and `italic` variants.
+
+## Images
+
+`Image src` accepts a URL, a `data:` URI, or a `Binary` whose `contentType` is an image type (PNG or JPEG). Prefer `Binary` for anything private or that must stay byte-identical across replays — URLs are fetched at layout time on every render.
+
+```tsx
+const logo = await http.get('https://cdn.example.com/logo.png')
+
+<Image src={logo.body.binary} style={{ width: 120 }} />
+```
+
+## Fonts
+
+Register custom fonts per render with an object keyed by family name. Values are a bare source — a URL string or a `Binary` — for the regular variant, or an array of variants with `weight` / `style`. TTF and WOFF only (no WOFF2).
+
+```tsx
+const pdf = await render(<Doc />, {
+  fonts: {
+    Inter: 'https://cdn.example.com/Inter-Regular.ttf',
+    Roboto: [
+      { src: robotoRegular.body.binary },
+      { src: robotoBold.body.binary, weight: 700 },
+      { src: robotoItalic.body.binary, style: 'italic' },
+    ],
+  },
+})
+```
+
+Select variants in styles with `fontFamily`, `fontWeight` (`100–900`), and `fontStyle` (`'normal' | 'italic'`).
+
+## Page numbers
+
+`PageNumber` resolves at layout time. The `format` string may reference `{pageNumber}` and `{totalPages}`; combine with `fixed` and absolute positioning for running footers.
+
+```tsx
+<PageNumber
+  fixed
+  format='{pageNumber}/{totalPages}'
+  style={{ position: 'absolute', bottom: 24, right: '2cm' }}
+/>
+```
+
+## Testing
+
+Test workflows with `TestWorkflowEnvironment` from `@t4h.framework/core/testing`, mocking `FileSystemClaim` — the rendered buffer is handed to `fs.write`, so assert on the `%PDF-` magic bytes there:
+
+```typescript
+import { TestWorkflowEnvironment, mockClaim } from '@t4h.framework/core/testing'
+import { FileSystemClaim } from '@t4h.framework/fs'
+
+const mockWrite = vi.fn().mockImplementation(async (_path, pdf) => new MockBinary(pdf))
+
+const env = TestWorkflowEnvironment.create({ now: 0 })
+
+await env.execute(workflow, input, {
+  claims: [mockClaim(FileSystemClaim, { write: mockWrite, read: vi.fn() })],
+})
+
+expect(mockWrite.mock.calls[0][1].subarray(0, 5).toString()).toBe('%PDF-')
+```

package/dist/activities/RenderPDFActivity.d.ts

@@ -0,0 +1,19 @@
+import { Binary, SyncActivity } from '@t4h.framework/core';
+import type { ReactElement } from 'react';
+import { type Fonts } from '../helpers/register-fonts.js';
+import type { DocumentNode } from '../typings/pdf.js';
+export type RenderPDFOptions = {
+    fonts?: Fonts;
+};
+export type RenderPDFInput = {
+    document: DocumentNode;
+    fonts?: Fonts;
+};
+export declare class RenderPDFActivity extends SyncActivity<readonly [element: ReactElement, options?: RenderPDFOptions], RenderPDFInput, Binary, Binary> {
+    private readonly claims;
+    toInput(element: ReactElement, options?: RenderPDFOptions): RenderPDFInput;
+    run(input: RenderPDFInput): Promise<Binary>;
+    toOutput(output: Binary): Binary;
+}
+export declare function render(element: ReactElement, options?: RenderPDFOptions): Promise<Binary>;
+//# sourceMappingURL=RenderPDFActivity.d.ts.map

package/dist/activities/RenderPDFActivity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderPDFActivity.d.ts","sourceRoot":"","sources":["../../src/activities/RenderPDFActivity.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAkB,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAE1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAIzC,OAAO,EAAiB,KAAK,KAAK,EAAE,MAAM,8BAA8B,CAAA;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,CAAC,EAAE,KAAK,CAAA;CACd,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,YAAY,CAAA;IACtB,KAAK,CAAC,EAAE,KAAK,CAAA;CACd,CAAA;AAED,qBAAa,iBAAkB,SAAQ,YAAY,CACjD,SAAS,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,gBAAgB,CAAC,EAC5D,cAAc,EACd,MAAM,EACN,MAAM,CACP;IACC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAErD,OAAO,CACZ,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE,gBAAgB,GACzB,cAAc;IAOJ,GAAG,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAUjD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CAGxC;AAED,wBAAsB,MAAM,CAC1B,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,MAAM,CAAC,CAEjB"}

package/dist/activities/RenderPDFActivity.js

@@ -0,0 +1,29 @@
+import { renderToBuffer } from '@react-pdf/renderer';
+import { Binary, Claim, History, SyncActivity } from '@t4h.framework/core';
+import { FileSystemClaim } from '@t4h.framework/fs';
+import { documentToElement } from '../helpers/document-to-element.js';
+import { elementToDocument } from '../helpers/element-to-document.js';
+import { registerFonts } from '../helpers/register-fonts.js';
+export class RenderPDFActivity extends SyncActivity {
+    claims = new Claim({ fs: FileSystemClaim });
+    toInput(element, options) {
+        return {
+            document: elementToDocument(element),
+            ...(options?.fonts ? { fonts: options.fonts } : {}),
+        };
+    }
+    async run(input) {
+        if (input.fonts)
+            await registerFonts(input.fonts);
+        const element = await documentToElement(input.document);
+        const pdf = await renderToBuffer(element);
+        return await this.claims.fs.write(`pdf/${this.id}.pdf`, pdf);
+    }
+    toOutput(output) {
+        return output;
+    }
+}
+export async function render(element, options) {
+    return await History.reconciler(RenderPDFActivity, element, options);
+}
+//# sourceMappingURL=RenderPDFActivity.js.map

package/dist/activities/RenderPDFActivity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderPDFActivity.js","sourceRoot":"","sources":["../../src/activities/RenderPDFActivity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAGnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAA;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAA;AACrE,OAAO,EAAE,aAAa,EAAc,MAAM,8BAA8B,CAAA;AAYxE,MAAM,OAAO,iBAAkB,SAAQ,YAKtC;IACkB,MAAM,GAAG,IAAI,KAAK,CAAC,EAAE,EAAE,EAAE,eAAe,EAAE,CAAC,CAAA;IAErD,OAAO,CACZ,OAAqB,EACrB,OAA0B;QAE1B,OAAO;YACL,QAAQ,EAAE,iBAAiB,CAAC,OAAO,CAAC;YACpC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACpD,CAAA;IACH,CAAC;IAEM,KAAK,CAAC,GAAG,CAAC,KAAqB;QACpC,IAAI,KAAK,CAAC,KAAK;YAAE,MAAM,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QAEjD,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;QAEvD,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAA;QAEzC,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,CAAA;IAC9D,CAAC;IAEM,QAAQ,CAAC,MAAc;QAC5B,OAAO,MAAM,CAAA;IACf,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,OAAqB,EACrB,OAA0B;IAE1B,OAAO,MAAM,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;AACtE,CAAC"}

package/dist/components.d.ts

@@ -0,0 +1,50 @@
+import type { Binary } from '@t4h.framework/core';
+import type { ReactElement, ReactNode } from 'react';
+import type { DocumentNode, NodeProps, PageNode } from './typings/pdf.js';
+export type DocumentProps = NonNullable<DocumentNode['props']> & {
+    children?: ReactNode;
+};
+export type PageProps = NonNullable<PageNode['props']> & {
+    children?: ReactNode;
+};
+export type ViewProps = NodeProps & {
+    children?: ReactNode;
+};
+export type TextProps = NodeProps & {
+    children?: ReactNode;
+};
+export type LinkProps = NodeProps & {
+    href: string;
+    children?: ReactNode;
+};
+export type ImageProps = NodeProps & {
+    src: string | Binary;
+};
+export type PageNumberProps = NodeProps & {
+    /**
+     * May reference `{pageNumber}` and `{totalPages}`. Defaults to
+     * `'{pageNumber}'`.
+     */
+    format?: string;
+};
+/** Root of a PDF. Children must be {@link Page} elements. */
+export declare function Document(props: DocumentProps): ReactElement;
+/** A page. Content overflowing the page height paginates automatically. */
+export declare function Page(props: PageProps): ReactElement;
+/** A flex container, analogous to a `<div>`. */
+export declare function View(props: ViewProps): ReactElement;
+/** Text content. All raw strings must live inside a {@link Text}. */
+export declare function Text(props: TextProps): ReactElement;
+/** A hyperlink. */
+export declare function Link(props: LinkProps): ReactElement;
+/**
+ * An image. `src` may be a URL, a `data:image/...;base64,` URI, or a
+ * {@link Binary} whose `contentType` is an image type.
+ */
+export declare function Image(props: ImageProps): ReactElement;
+/**
+ * Text resolved to the current page number at layout time. Combine with
+ * `fixed` for running footers.
+ */
+export declare function PageNumber(props: PageNumberProps): ReactElement;
+//# sourceMappingURL=components.d.ts.map

package/dist/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../src/components.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEpD,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAEzE,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,GAAG;IAC/D,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,GAAG;IACvD,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG;IAAE,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,CAAA;AAE5D,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG;IAAE,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,CAAA;AAE5D,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,CAAA;AAE1E,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG;IAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAA;AAE7D,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG;IACxC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAWD,6DAA6D;AAC7D,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,YAAY,CAE3D;AAED,2EAA2E;AAC3E,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,YAAY,CAEnD;AAED,gDAAgD;AAChD,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,YAAY,CAEnD;AAED,qEAAqE;AACrE,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,YAAY,CAEnD;AAED,mBAAmB;AACnB,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,YAAY,CAEnD;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,YAAY,CAErD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,YAAY,CAE/D"}

package/dist/components.js

@@ -0,0 +1,41 @@
+function marker(name) {
+    throw new Error(`<${name}> is a PDF marker component — it only exists inside a document ` +
+        'tree passed to render() and cannot be invoked as a regular component');
+}
+/* eslint-disable @typescript-eslint/no-unused-vars */
+/** Root of a PDF. Children must be {@link Page} elements. */
+export function Document(props) {
+    marker('Document');
+}
+/** A page. Content overflowing the page height paginates automatically. */
+export function Page(props) {
+    marker('Page');
+}
+/** A flex container, analogous to a `<div>`. */
+export function View(props) {
+    marker('View');
+}
+/** Text content. All raw strings must live inside a {@link Text}. */
+export function Text(props) {
+    marker('Text');
+}
+/** A hyperlink. */
+export function Link(props) {
+    marker('Link');
+}
+/**
+ * An image. `src` may be a URL, a `data:image/...;base64,` URI, or a
+ * {@link Binary} whose `contentType` is an image type.
+ */
+export function Image(props) {
+    marker('Image');
+}
+/**
+ * Text resolved to the current page number at layout time. Combine with
+ * `fixed` for running footers.
+ */
+export function PageNumber(props) {
+    marker('PageNumber');
+}
+/* eslint-enable @typescript-eslint/no-unused-vars */
+//# sourceMappingURL=components.js.map

package/dist/components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.js","sourceRoot":"","sources":["../src/components.ts"],"names":[],"mappings":"AA6BA,SAAS,MAAM,CAAC,IAAY;IAC1B,MAAM,IAAI,KAAK,CACb,IAAI,IAAI,iEAAiE;QACvE,sEAAsE,CACzE,CAAA;AACH,CAAC;AAED,sDAAsD;AAEtD,6DAA6D;AAC7D,MAAM,UAAU,QAAQ,CAAC,KAAoB;IAC3C,MAAM,CAAC,UAAU,CAAC,CAAA;AACpB,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,IAAI,CAAC,KAAgB;IACnC,MAAM,CAAC,MAAM,CAAC,CAAA;AAChB,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,IAAI,CAAC,KAAgB;IACnC,MAAM,CAAC,MAAM,CAAC,CAAA;AAChB,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,IAAI,CAAC,KAAgB;IACnC,MAAM,CAAC,MAAM,CAAC,CAAA;AAChB,CAAC;AAED,mBAAmB;AACnB,MAAM,UAAU,IAAI,CAAC,KAAgB;IACnC,MAAM,CAAC,MAAM,CAAC,CAAA;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,KAAK,CAAC,KAAiB;IACrC,MAAM,CAAC,OAAO,CAAC,CAAA;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,KAAsB;IAC/C,MAAM,CAAC,YAAY,CAAC,CAAA;AACtB,CAAC;AAED,qDAAqD"}

package/dist/helpers/document-to-element.d.ts

@@ -0,0 +1,5 @@
+import { Document } from '@react-pdf/renderer';
+import { type ComponentProps, type ReactElement } from 'react';
+import type { DocumentNode } from '../typings/pdf.js';
+export declare function documentToElement(document: DocumentNode): Promise<ReactElement<ComponentProps<typeof Document>>>;
+//# sourceMappingURL=document-to-element.d.ts.map

package/dist/helpers/document-to-element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-to-element.d.ts","sourceRoot":"","sources":["../../src/helpers/document-to-element.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAiC,MAAM,qBAAqB,CAAA;AAE7E,OAAO,EAAiB,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,OAAO,CAAA;AAE7E,OAAO,KAAK,EACV,YAAY,EAIb,MAAM,mBAAmB,CAAA;AAyF1B,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,YAAY,GACrB,OAAO,CAAC,YAAY,CAAC,cAAc,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAMxD"}

package/dist/helpers/document-to-element.js

@@ -0,0 +1,52 @@
+import { buffer } from 'node:stream/consumers';
+import { Document, Image, Link, Page, Text, View } from '@react-pdf/renderer';
+import { createElement } from 'react';
+async function resolveImageSrc(src) {
+    if (typeof src === 'string')
+        return src;
+    const data = await buffer(await src.stream());
+    return `data:${src.contentType};base64,${data.toString('base64')}`;
+}
+async function toTextChildren(children) {
+    if (children === undefined)
+        return [];
+    if (typeof children === 'string')
+        return [children];
+    return Promise.all(children.map(child => typeof child === 'string' ? child : nodeToElement(child)));
+}
+const DEFAULT_PAGE_NUMBER_FORMAT = '{pageNumber}';
+async function nodeToElement(node) {
+    switch (node.type) {
+        case 'view':
+            return createElement(View, { ...node.props }, ...(await Promise.all((node.children ?? []).map(nodeToElement))));
+        case 'text':
+            return createElement(Text, { ...node.props }, ...(await toTextChildren(node.children)));
+        case 'link': {
+            const { href, ...props } = node.props;
+            return createElement(Link, { ...props, src: href }, ...(await toTextChildren(node.children)));
+        }
+        case 'image': {
+            const { src, ...props } = node.props;
+            return createElement(Image, {
+                ...props,
+                src: await resolveImageSrc(src),
+            });
+        }
+        case 'page-number': {
+            const { format = DEFAULT_PAGE_NUMBER_FORMAT, ...props } = node.props ?? {};
+            return createElement(Text, {
+                ...props,
+                render: ({ pageNumber, totalPages, }) => format
+                    .replaceAll('{pageNumber}', String(pageNumber))
+                    .replaceAll('{totalPages}', String(totalPages ?? '')),
+            });
+        }
+    }
+}
+async function pageToElement(page) {
+    return createElement(Page, { ...page.props }, ...(await Promise.all((page.children ?? []).map(nodeToElement))));
+}
+export async function documentToElement(document) {
+    return createElement(Document, { ...document.props }, ...(await Promise.all(document.children.map(pageToElement))));
+}
+//# sourceMappingURL=document-to-element.js.map

package/dist/helpers/document-to-element.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-to-element.js","sourceRoot":"","sources":["../../src/helpers/document-to-element.ts"],"names":[],"mappings":"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"}

package/dist/helpers/element-to-document.d.ts

@@ -0,0 +1,4 @@
+import { type ReactElement } from 'react';
+import type { DocumentNode } from '../pdf.js';
+export declare function elementToDocument(element: ReactElement): DocumentNode;
+//# sourceMappingURL=element-to-document.d.ts.map

package/dist/helpers/element-to-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-to-document.d.ts","sourceRoot":"","sources":["../../src/helpers/element-to-document.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,YAAY,EAAkB,MAAM,OAAO,CAAA;AAWnE,OAAO,KAAK,EACV,YAAY,EAMb,MAAM,WAAW,CAAA;AA8JlB,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,CA0BrE"}

package/dist/helpers/element-to-document.js

@@ -0,0 +1,135 @@
+import { Fragment } from 'react';
+import { Document, Image, Link, Page, PageNumber, Text, View, } from '../components.js';
+const MARKERS = new Set([
+    Document,
+    Page,
+    View,
+    Text,
+    Link,
+    Image,
+    PageNumber,
+]);
+function isElement(node) {
+    return (typeof node === 'object' &&
+        node !== null &&
+        'type' in node &&
+        'props' in node);
+}
+function resolveChildren(node) {
+    const resolved = [];
+    const visit = (child) => {
+        if (child === null || child === undefined || typeof child === 'boolean')
+            return;
+        if (typeof child === 'string') {
+            resolved.push(child);
+            return;
+        }
+        if (typeof child === 'number' || typeof child === 'bigint') {
+            resolved.push(String(child));
+            return;
+        }
+        if (Array.isArray(child))
+            return child.forEach(item => visit(item));
+        if (isElement(child)) {
+            if (child.type === Fragment) {
+                visit(child.props.children);
+                return;
+            }
+            if (typeof child.type === 'function' && !MARKERS.has(child.type)) {
+                visit(child.type(child.props));
+                return;
+            }
+            resolved.push(child);
+            return;
+        }
+        throw new TypeError('Unsupported node');
+    };
+    visit(node);
+    return resolved;
+}
+function toTextChildren(children) {
+    return resolveChildren(children).map((child) => {
+        if (typeof child === 'string')
+            return child;
+        const node = toPDFNode(child);
+        if (node.type === 'text')
+            return node;
+        if (node.type === 'link')
+            return node;
+        if (node.type === 'page-number')
+            return node;
+        throw new TypeError(`<${nameOf(child)}> is not allowed inside <Text>`);
+    });
+}
+function nameOf(element) {
+    return typeof element.type === 'function'
+        ? element.type.name
+        : String(element.type);
+}
+function toPDFNode(element) {
+    const { children, ...props } = element.props;
+    switch (element.type) {
+        case View:
+            return {
+                type: 'view',
+                props,
+                children: resolveChildren(children).map(child => {
+                    if (typeof child === 'string')
+                        throw new TypeError(`Raw text ${JSON.stringify(child)} must be wrapped in <Text>`);
+                    return toPDFNode(child);
+                }),
+            };
+        case Text:
+            return {
+                type: 'text',
+                props,
+                children: toTextChildren(children),
+            };
+        case Link:
+            return {
+                type: 'link',
+                props: props,
+                children: toTextChildren(children),
+            };
+        case Image:
+            return { type: 'image', props };
+        case PageNumber:
+            return { type: 'page-number', props };
+        default:
+            throw new TypeError(`<${nameOf(element)}> is not allowed inside a <Page>`);
+    }
+}
+function toPageNode(element) {
+    if (element.type !== Page)
+        throw new TypeError(`<Document> children must be <Page> elements, got <${nameOf(element)}>`);
+    const { children, ...props } = element.props;
+    return {
+        type: 'page',
+        props,
+        children: resolveChildren(children).map(child => {
+            if (typeof child === 'string')
+                throw new TypeError(`Raw text ${JSON.stringify(child)} must be wrapped in <Text>`);
+            return toPDFNode(child);
+        }),
+    };
+}
+export function elementToDocument(element) {
+    const roots = resolveChildren(element);
+    const root = roots[0];
+    if (root === undefined ||
+        roots.length !== 1 ||
+        typeof root === 'string' ||
+        root.type !== Document)
+        throw new TypeError('The PDF tree must resolve to a single <Document> root');
+    const { children, ...props } = root.props;
+    return {
+        type: 'document',
+        props,
+        children: resolveChildren(children).map(child => {
+            if (typeof child === 'string')
+                throw new TypeError('Raw text is not allowed directly inside <Document>');
+            return toPageNode(child);
+        }),
+    };
+}
+//# sourceMappingURL=element-to-document.js.map

package/dist/helpers/element-to-document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-to-document.js","sourceRoot":"","sources":["../../src/helpers/element-to-document.ts"],"names":[],"mappings":"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"}

package/dist/helpers/register-fonts.d.ts

@@ -0,0 +1,14 @@
+import { Binary } from '@t4h.framework/core';
+export type FontWeight = 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+export type FontStyle = 'normal' | 'italic';
+export type FontSource = string | Binary;
+export type FontVariant = {
+    src: FontSource;
+    weight?: FontWeight;
+    style?: FontStyle;
+};
+export type Fonts = {
+    [name: string]: FontSource | readonly FontVariant[];
+};
+export declare function registerFonts(raw: Fonts): Promise<void>;
+//# sourceMappingURL=register-fonts.d.ts.map

package/dist/helpers/register-fonts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-fonts.d.ts","sourceRoot":"","sources":["../../src/helpers/register-fonts.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAE5C,MAAM,MAAM,UAAU,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;AAE5E,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAE3C,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,CAAA;AAExC,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,UAAU,CAAA;IACf,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,KAAK,CAAC,EAAE,SAAS,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,KAAK,GAAG;IAClB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,WAAW,EAAE,CAAA;CACpD,CAAA;AAQD,wBAAsB,aAAa,CAAC,GAAG,EAAE,KAAK,iBA6C7C"}

package/dist/helpers/register-fonts.js

@@ -0,0 +1,40 @@
+import { buffer } from 'node:stream/consumers';
+import { Font } from '@react-pdf/renderer';
+import { Binary } from '@t4h.framework/core';
+function toDataUrl(data) {
+    const bytes = Buffer.isBuffer(data) ? data : Buffer.from(data);
+    return `data:font/ttf;base64,${bytes.toString('base64')}`;
+}
+export async function registerFonts(raw) {
+    const fonts = await Promise.all(Object.entries(raw ?? {}).flatMap(([name, source]) => {
+        const variants = [];
+        if (typeof source === 'string' || source instanceof Binary)
+            variants.push({ src: source });
+        if (Array.isArray(source))
+            variants.push(...source);
+        return variants.map(async (variant) => {
+            const src = typeof variant.src === 'string'
+                ? variant.src
+                : await buffer(await variant.src.stream());
+            return {
+                name,
+                src,
+                weight: variant.weight,
+                style: variant.style,
+            };
+        });
+    }));
+    const families = new Map();
+    for (const font of fonts) {
+        const variants = families.get(font.name) ?? [];
+        variants.push({
+            src: typeof font.src === 'string' ? font.src : toDataUrl(font.src),
+            fontWeight: font.weight ?? 400,
+            fontStyle: font.style ?? 'normal',
+        });
+        families.set(font.name, variants);
+    }
+    for (const [family, variants] of families)
+        Font.register({ family, fonts: variants });
+}
+//# sourceMappingURL=register-fonts.js.map

package/dist/helpers/register-fonts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-fonts.js","sourceRoot":"","sources":["../../src/helpers/register-fonts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAE9C,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAkB5C,SAAS,SAAS,CAAC,IAA0B;IAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAE9D,OAAO,wBAAwB,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAA;AAC3D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAU;IAC5C,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAC7B,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE;QACnD,MAAM,QAAQ,GAAkB,EAAE,CAAA;QAElC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,YAAY,MAAM;YACxD,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAA;QAEhC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAA;QAEnD,OAAO,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAC,OAAO,EAAC,EAAE;YAClC,MAAM,GAAG,GACP,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ;gBAC7B,CAAC,CAAC,OAAO,CAAC,GAAG;gBACb,CAAC,CAAC,MAAM,MAAM,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAA;YAE9C,OAAO;gBACL,IAAI;gBACJ,GAAG;gBACH,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,KAAK,EAAE,OAAO,CAAC,KAAK;aACrB,CAAA;QACH,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CACH,CAAA;IAED,MAAM,QAAQ,GAAG,IAAI,GAAG,EAGrB,CAAA;IAEH,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;QAE9C,QAAQ,CAAC,IAAI,CAAC;YACZ,GAAG,EAAE,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC;YAClE,UAAU,EAAE,IAAI,CAAC,MAAM,IAAI,GAAG;YAC9B,SAAS,EAAE,IAAI,CAAC,KAAK,IAAI,QAAQ;SAClC,CAAC,CAAA;QAEF,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IACnC,CAAC;IAED,KAAK,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,QAAQ;QACvC,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAW,CAAC,CAAA;AACvD,CAAC"}

package/dist/pdf.d.ts

@@ -0,0 +1,4 @@
+export * from './activities/RenderPDFActivity.js';
+export * from './components.js';
+export * from './typings/pdf.js';
+//# sourceMappingURL=pdf.d.ts.map

package/dist/pdf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf.d.ts","sourceRoot":"","sources":["../src/pdf.ts"],"names":[],"mappings":"AAAA,cAAc,mCAAmC,CAAA;AACjD,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA"}

package/dist/pdf.js

@@ -0,0 +1,4 @@
+export * from './activities/RenderPDFActivity.js';
+export * from './components.js';
+export * from './typings/pdf.js';
+//# sourceMappingURL=pdf.js.map

package/dist/pdf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf.js","sourceRoot":"","sources":["../src/pdf.ts"],"names":[],"mappings":"AAAA,cAAc,mCAAmC,CAAA;AACjD,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA"}

package/dist/typings/pdf.d.ts

@@ -0,0 +1,85 @@
+import type { Binary } from '@t4h.framework/core';
+export type PDFStyle = {
+    [property: string]: string | number | undefined;
+};
+export type PageSize = string | readonly [width: number, height: number];
+/** Props shared by every node inside a page. */
+export type NodeProps = {
+    style?: PDFStyle | readonly PDFStyle[];
+    /** Repeat on every page (headers/footers). */
+    fixed?: boolean;
+    /** Force a page break before this node. */
+    break?: boolean;
+    /** Allow the node to split across pages. Defaults to true. */
+    wrap?: boolean;
+    /**
+     * Move the node to the next page unless at least this many points of space
+     * remain below it (avoids orphaned headings).
+     */
+    minPresenceAhead?: number;
+};
+export type ViewNode = {
+    type: 'view';
+    props?: NodeProps;
+    children?: readonly PDFNode[];
+};
+export type TextNode = {
+    type: 'text';
+    props?: NodeProps;
+    children?: string | readonly TextChild[];
+};
+export type LinkNode = {
+    type: 'link';
+    props: NodeProps & {
+        href: string;
+    };
+    children?: string | readonly TextChild[];
+};
+/**
+ * An image. `src` may be a URL, a `data:image/...;base64,` URI, or a
+ * {@link Binary} whose `contentType` is an image type (`image/png`,
+ * `image/jpeg`).
+ */
+export type ImageNode = {
+    type: 'image';
+    props: NodeProps & {
+        src: string | Binary;
+    };
+};
+/**
+ * Text that resolves to the current page number at layout time. `format`
+ * may reference `{pageNumber}` and `{totalPages}`; defaults to
+ * `'{pageNumber}'`. Combine with `fixed: true` for running footers.
+ */
+export type PageNumberNode = {
+    type: 'page-number';
+    props?: NodeProps & {
+        format?: string;
+    };
+};
+export type TextChild = string | TextNode | LinkNode | PageNumberNode;
+export type PDFNode = ViewNode | TextNode | LinkNode | ImageNode | PageNumberNode;
+export type PageNode = {
+    type: 'page';
+    props?: {
+        size?: PageSize;
+        orientation?: 'portrait' | 'landscape';
+        style?: PDFStyle | readonly PDFStyle[];
+        wrap?: boolean;
+        dpi?: number;
+    };
+    children?: readonly PDFNode[];
+};
+export type DocumentNode = {
+    type: 'document';
+    props?: {
+        title?: string;
+        author?: string;
+        subject?: string;
+        creator?: string;
+        producer?: string;
+        language?: string;
+    };
+    children: readonly PageNode[];
+};
+//# sourceMappingURL=pdf.d.ts.map

package/dist/typings/pdf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf.d.ts","sourceRoot":"","sources":["../../src/typings/pdf.ts"],"names":[],"mappings":"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"}

package/dist/typings/pdf.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pdf.js.map

package/dist/typings/pdf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf.js","sourceRoot":"","sources":["../../src/typings/pdf.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@t4h.framework/pdf",
+  "version": "0.0.0",
+  "description": "Declarative PDF rendering module for the T4H Framework",
+  "homepage": "https://github.com/tech4humans-brasil/framework/tree/main/packages/pdf",
+  "bugs": "https://github.com/tech4humans-brasil/framework/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tech4humans-brasil/framework.git",
+    "directory": "packages/pdf"
+  },
+  "license": "MIT",
+  "author": "Tech4Humans <contact@tech4h.com.br> (https://tech4h.com.br)",
+  "type": "module",
+  "exports": {
+    "types": "./dist/pdf.d.ts",
+    "import": "./dist/pdf.js"
+  },
+  "module": "./dist/pdf.js",
+  "types": "./dist/pdf.d.ts",
+  "files": [
+    "dist",
+    "LICENSE",
+    ".ai"
+  ],
+  "scripts": {
+    "build": "tsc --project tsconfig.build.json",
+    "check-types": "tsc --noEmit",
+    "lint": "eslint .",
+    "prepublishOnly": "yarn build",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "devDependencies": {
+    "@t4h.framework/core": "^0.9.0",
+    "@t4h.framework/fs": "^0.7.0",
+    "@types/react": "^19.2.17",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "peerDependencies": {
+    "@t4h.framework/core": "^0.9.0",
+    "@t4h.framework/fs": "^0.7.0"
+  },
+  "packageManager": "yarn@4.12.0",
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "@react-pdf/renderer": "^4.5.1",
+    "react": "^19.2.8"
+  }
+}