@t4h.framework/pdf 0.4.6 → 0.5.1

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

@@ -1,355 +1,117 @@
 ---
 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,
-  password-protected PDFs via the `encrypt` option, and the FileSystemClaim
-  the render activity requires. Use when generating PDFs in workflows,
-  building PDF templates with JSX, registering fonts, encrypting PDFs, or
-  working in packages/pdf.
+  Guides the use of @t4h.framework/pdf to generate PDF files in T4H Framework
+  workflows: the render() function, the JSX marker components (Document, Page,
+  View, Text, Link, Image, PageNumber), styles, custom fonts, Binary image
+  sources, password protection with the encrypt option (ProtectionFlags,
+  ProtectionPresets), the FileSystemClaim that render needs, and tests with
+  TestWorkflowEnvironment and mockClaim. Use when a workflow must produce a
+  PDF, an invoice, a report or a statement, when building a PDF template in
+  JSX, or when someone mentions @react-pdf/renderer in a workflow.
 ---
 
 # @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`.
+## Render a PDF in a workflow
 
-Import surface:
-
-```typescript
-import {
-  render,
-  Document,
-  Page,
-  View,
-  Text,
-  Link,
-  Image,
-  PageNumber,
-  RenderPDFActivity,
-  ProtectionFlags,
-  ProtectionPresets,
-  type RenderPDFOptions,
-  type RenderPDFInput,
-  type EncryptPDFOptions,
-  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()`** — for everything, including encryption.
-> `@t4h.framework/core/no-framework-activity-in-app` rejects `new` and
-> `extends` on `RenderPDFActivity`.
-
-## 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): `Binary` image and font sources are read through
-   their claims and inlined as `data:` URIs on the calling thread, then the
-   resolved tree is handed to a **worker thread** (pool size
-   `PDF_RENDER_CONCURRENCY`, default `1`, created on first render, idle workers
-   unrefed) that registers fonts once per process, converts the `DocumentNode`
-   tree back into real `@react-pdf/renderer` elements and renders it to a
-   buffer. The buffer is written through **`FileSystemClaim`** at
-   `pdf/${activityId}.pdf`. With the `encrypt` option, a password-protected
-   copy (AES-128, `%PDF-1.6`) is written from the same layout at
-   `pdf/${activityId}-encrypted.pdf` — no second layout pass, no re-encryption
-   of the finished file. A render therefore blocks the event loop of the
-   calling process for milliseconds, not for the whole document.
-3. The activity returns the **`Binary`** the claim produced — a reference to
-   the stored file, not in-memory bytes. Replay-safe by construction. With
-   `encrypt`, it returns the `[original, encrypted]` pair instead, and the
-   `render` return type narrows automatically based on the options.
-
----
-
-## 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. A marker called as a
-function (`Image({ src })`) 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).
-
-**Valid tree.** `render()` throws a `TypeError` for a tree that breaks one
-of these rules:
-
-- One `Document` root, with only `Page` children.
-- Raw text only inside `Text` or `Link`.
-- Inside `Text`: only text, `Text`, `Link` and `PageNumber`.
-- Inside `Page` and `View`: only the marker components of this package.
-
-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`:
+1. Build the tree with the markers of `@t4h.framework/pdf`.
+2. Call `render` and `await` it. It returns a `Binary`, not bytes.
+3. Pass the `Binary` to the next activity (upload, e-mail, return value).
 
 ```tsx
-<Page size='A4' style={{ padding: '2cm', fontSize: 12, color: '#00513a' }}>
+import { Document, Page, Text, View, render } from '@t4h.framework/pdf'
+
+const pdf = await render(
+  <Document title='Invoice'>
+    <Page size='A4' style={{ padding: '2cm', fontSize: 12 }}>
+      {items.map(item => (
+        <View key={item.id} style={{ flexDirection: 'row' }}>
+          <Text>{item.label}</Text>
+        </View>
+      ))}
+    </Page>
+  </Document>,
+)
 ```
 
-Built-in fonts (no registration needed): Helvetica, Courier, Times-Roman —
-with `fontWeight: 'bold'` / `fontStyle: 'italic'` variants.
-
----
-
-## Rendering in a workflow
+Your own function components, fragments, `.map()` and conditionals work as in
+React.
+
+## Traps
+
+- Import `Document`, `Page`, `Text` and the other markers from
+  `@t4h.framework/pdf`, never from `@react-pdf/renderer`. A react-pdf component
+  in the tree throws a `TypeError`. Never call a marker as a function.
+- One `Document` root with only `Page` children. Raw text only in `Text` or
+  `Link`. Only text, `Text`, `Link` and `PageNumber` inside `Text`.
+- Never use `new RenderPDFActivity()` or extend it. The lint rule
+  `no-framework-activity-in-app` reports it. Use `render` for everything,
+  encryption included.
+- The runtime must provide a `FileSystemClaim` (from `@t4h.framework/fs`).
+  With no provider, `render` throws `ClaimProviderNotFoundException`.
+- Styles use the flex model only: no grid, no float. Numbers are points;
+  strings take units (`'2cm'`, `'50%'`). Put text defaults on `Page`: they
+  inherit.
+- Use a `Binary` as `Image src` or font source for private files and for
+  stable replays. A URL is fetched at each render and cannot authenticate.
+  Images: PNG or JPEG.
+- Fonts: TTF or WOFF, never WOFF2 (Google Fonts links often point to WOFF2).
+- With `encrypt`, `render` returns `[original, encrypted]`. When `protection`
+  is omitted, only `ProtectionFlags.Print` is granted. Viewers honor the
+  permission flags, but they are not cryptographic: only the password
+  protects.
+
+## Fonts and encryption
 
 ```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.
+import { ProtectionPresets, render } from '@t4h.framework/pdf'
 
----
-
-## 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 />, {
+const [original, encrypted] = await render(<Invoice />, {
   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' },
-    ],
+    Roboto: [{ src: robotoRegular }, { src: robotoBold, weight: 700 }],
   },
+  encrypt: { password: '1234', protection: ProtectionPresets.ReadOnly },
 })
 ```
 
-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.
-
----
-
-## Encryption
-
-`render(element, { encrypt })` also persists a password-protected copy and
-resolves with an `[original, encrypted]` tuple — the return type narrows
-automatically:
+## Running footer
 
 ```tsx
-const [original, encrypted] = await render(<Invoice />, {
-  encrypt: {
-    password: customer.documentNumber,
-    protection: ProtectionPresets.ReadOnly,
-  },
-})
+<PageNumber
+  fixed
+  format='{pageNumber}/{totalPages}'
+  style={{ position: 'absolute', bottom: 24, right: '2cm' }}
+/>
 ```
 
-- `password`: a bare string (same password opens and owns the file) or
-  `{ user, owner }` for a distinct owner password that bypasses permission
-  restrictions.
-- `protection`: a `ProtectionFlags` bitmask granted to whoever opens with the
-  user password. Combine flags with `|` (`Print`, `Modify`, `CopyAndExtract`,
-  `AnnotateAndFill`, `FillForms`, `ExtractForAccessibility`, `Assemble`,
-  `PrintHighResolution`) or use a preset: `ProtectionPresets.ReadOnly`
-  (view + print only — invoices, statements) or `ProtectionPresets.All`.
-- Permission flags are honored by PDF viewers, **not enforced
-  cryptographically** — the open password is the only real protection.
-- Encryption is available only through `render`'s `encrypt` option.
-
----
-
-## Testing
+## Test
 
-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. The render runs in a worker in tests too, so the first render in a
-test file pays for the thread starting up (around 400 ms).
+Mock `FileSystemClaim.write`. It receives the path (`pdf/<id>.pdf`) and the
+rendered `Buffer`; return any `Binary` stub. A class that extends `Binary` is
+allowed in test files only.
 
 ```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 write = vi.fn(async (path: string, pdf: Buffer) => storedBinary)
 const env = TestWorkflowEnvironment.create({ now: 0 })
 
-await env.execute(workflow, input, {
-  claims: [mockClaim(FileSystemClaim, { write: mockWrite, read: vi.fn() })],
+await env.execute(invoice, undefined, {
+  claims: [mockClaim(FileSystemClaim, { write })],
 })
 
-// The activity hands the rendered buffer to fs.write — assert on it:
-const [path, pdf] = mockWrite.mock.calls[0]
-expect(path).toMatch(/^pdf\/.+\.pdf$/)
+const [, pdf] = write.mock.calls[0]
 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
+The render runs in a worker thread, so the first render in a test file takes
+about 400 ms.
 
-1. In workflows, **always** use **`render()`**.
-2. Build templates with the **marker components from this package**.
-   `render()` throws a `TypeError` for a `@react-pdf/renderer` component, a
-   marker called as a function throws, and the **Valid tree** rules above
-   apply.
-3. Provide **`FileSystemClaim`** in the runtime (or mock it in tests). A
-   missing provider throws `ClaimProviderNotFoundException`.
-4. Prefer **`Binary`** sources for images and fonts that must be private or
-   replay-stable; URLs are fetched at layout time on every render.
-5. Fonts: object keyed by family, **TTF/WOFF only**, select variants via
-   `fontFamily`/`fontWeight`/`fontStyle`.
-6. Style with the **flex model** (`PDFStyle`, camelCase, points or unit
-   strings); put inheritable text defaults on `Page`.
-7. Use `fixed` + absolute positioning for running headers/footers and
-   `PageNumber` for pagination stamps.
-8. Password-protect PDFs via `render`'s `encrypt` option — it returns
-   `[original, encrypted]`. Permission flags are viewer-honored, not
-   cryptographic.
-9. Test workflows with **`TestWorkflowEnvironment`** + **`mockClaim`**,
-   asserting the `%PDF-` magic bytes on the `fs.write` call.
-10. The package exports only its entry, so a deep import into `helpers/` or
-    `tools/` fails in `tsc`.
+## Reference
 
-See also: **framework-workflow-testing** for the test harness;
-**framework-fs** for `FileSystemClaim`; **framework-http** for fetching
-`Binary` assets (images, fonts) used in templates.
+- Guide: https://tech4humans-brasil.github.io/framework/pdf/
+- `FileSystemClaim`: https://tech4humans-brasil.github.io/framework/fs/
+- Workflow testing: https://tech4humans-brasil.github.io/framework/core/testing
+- Types: `node_modules/@t4h.framework/pdf/dist/pdf.d.ts`

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @t4h.framework/pdf
 
+## 0.5.1
+
+### Patch Changes
+
+- [#276](https://github.com/tech4humans-brasil/framework/pull/276) [`7b38934`](https://github.com/tech4humans-brasil/framework/commit/7b38934e8f9207c98c33afcd76e3a7a4da7e8b14) Thanks [@gusteycamargo](https://github.com/gusteycamargo)! - The docs give the `ReadOnly` flags, the JSX setup and the Node.js version. The test sample compiles.
+
+## 0.5.0
+
+### Minor Changes
+
+- [#274](https://github.com/tech4humans-brasil/framework/pull/274) [`7d7d4ec`](https://github.com/tech4humans-brasil/framework/commit/7d7d4ec27e55262f3f0353a7253a95e12d24de9b) Thanks [@gusteycamargo](https://github.com/gusteycamargo)! - Adds the `./eslint` entry. It declares `requires: { jsx: true }`, so `framework()` of `@t4h.framework/eslint-config` turns on the JSX config in a project that uses `pdf`.
+
+### Patch Changes
+
+- [#271](https://github.com/tech4humans-brasil/framework/pull/271) [`a2763a2`](https://github.com/tech4humans-brasil/framework/commit/a2763a26fbc466009293389c76036af75070a945) Thanks [@gusteycamargo](https://github.com/gusteycamargo)! - Replaces the double casts, `as never` and the conditional spreads in the source with real types and type guards. The behavior and the public API do not change.
+
+## 0.4.7
+
+### Patch Changes
+
+- [#257](https://github.com/tech4humans-brasil/framework/pull/257) [`586bfb4`](https://github.com/tech4humans-brasil/framework/commit/586bfb4663f4a478527ee0c8db360603f034d615) Thanks [@gusteycamargo](https://github.com/gusteycamargo)! - The pdf README is now short and links to the site, and the skill keeps only the traps and the default steps. The docs no longer describe a `PDF_RENDER_CONCURRENCY` variable, and they give the default `protection` of `encrypt`.
+
 ## 0.4.6
 
 ### Patch Changes

package/README.md

@@ -1,25 +1,18 @@
 # @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).
+Declarative PDF rendering for T4H Framework workflows. You write the document
+as JSX with the marker components of this package, and `render` gives back a
+`Binary` that it stores through the `FileSystemClaim` of `@t4h.framework/fs`.
 
-## Claim
+## Install
 
-### 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() }
+```bash
+npm install @t4h.framework/pdf
 ```
 
-## Rendering
-
-### render
+Peer dependencies: `@t4h.framework/core` and `@t4h.framework/fs`.
 
-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.
+## Usage
 
 ```tsx
 import { Workflow } from '@t4h.framework/core'
@@ -34,146 +27,10 @@ export const invoice = new Workflow({ id: 'invoice' }, async () => {
     </Document>,
   )
 
-  // pdf is a Binary — hand it to other activities, e.g. an upload:
-  // await http.post(url, { form: { file: pdf } })
+  return 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
+## Documentation
 
-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'`).
-
-Each variant reaches the process-wide font store once, keyed by family, weight, style and the file's digest, so passing `fonts` on every render costs nothing after the first.
-
-## Encryption
-
-Pass `encrypt` to also persist a password-protected copy — `render` then resolves with an `[original, encrypted]` pair (the return type narrows automatically). `password` is a bare string or `{ user, owner }`; `protection` is a `ProtectionFlags` bitmask (defaults follow the viewer; use `ProtectionPresets.ReadOnly` for view-and-print documents). Permission flags are honored by viewers, not enforced cryptographically.
-
-The encrypted copy is written with pdfkit's own encryption (AES-128, PDF 1.6) from the layout the first render already produced, so neither a re-encryption pass over the finished file nor a second layout is paid for.
-
-```tsx
-import { ProtectionPresets, render } from '@t4h.framework/pdf'
-
-const [original, encrypted] = await render(<Invoice />, {
-  encrypt: { password: '12345678900', protection: ProtectionPresets.ReadOnly },
-})
-```
-
-## 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-')
-```
+https://tech4humans-brasil.github.io/framework/pdf/

package/dist/eslint.d.ts

@@ -0,0 +1,10 @@
+declare const _default: {
+    configs: {
+        recommended: never[];
+    };
+    requires: {
+        jsx: boolean;
+    };
+};
+export default _default;
+//# sourceMappingURL=eslint.d.ts.map

package/dist/eslint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eslint.d.ts","sourceRoot":"","sources":["../src/eslint.ts"],"names":[],"mappings":";;;;;;;;AAAA,wBAGC"}

package/dist/eslint.js

@@ -0,0 +1,5 @@
+export default {
+    configs: { recommended: [] },
+    requires: { jsx: true },
+};
+//# sourceMappingURL=eslint.js.map

package/dist/eslint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eslint.js","sourceRoot":"","sources":["../src/eslint.ts"],"names":[],"mappings":"AAAA,eAAe;IACb,OAAO,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;IAC5B,QAAQ,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE;CACxB,CAAA"}

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

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

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

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

package/dist/helpers/render-document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-document.d.ts","sourceRoot":"","sources":["../../src/helpers/render-document.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExE,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,OAAO,CAAA;AAEvD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AA6CtE,wBAAsB,cAAc,CAClC,OAAO,EAAE,YAAY,CAAC,aAAa,CAAC,EACpC,UAAU,CAAC,EAAE,uBAAuB,GACnC,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA4B9C"}
+{"version":3,"file":"render-document.d.ts","sourceRoot":"","sources":["../../src/helpers/render-document.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExE,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,OAAO,CAAA;AAEvD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AAoCtE,wBAAsB,cAAc,CAClC,OAAO,EAAE,YAAY,CAAC,aAAa,CAAC,EACpC,UAAU,CAAC,EAAE,uBAAuB,GACnC,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA6B9C"}

package/dist/helpers/render-document.js

@@ -1,8 +1,9 @@
+import { buffer } from 'node:stream/consumers';
 import renderPDF from '@react-pdf/render';
 import { renderToBuffer } from '@react-pdf/renderer';
 import { PDFDocument } from 'pdfkit';
 import { cloneElement } from 'react';
-function toContext(props, encryption) {
+function toPDFDocument(props, encryption) {
     const info = {};
     const put = (key, value) => {
         if (value !== undefined)
@@ -24,12 +25,6 @@ function toContext(props, encryption) {
         ...encryption,
     });
 }
-async function toBuffer(context) {
-    const chunks = [];
-    for await (const chunk of context)
-        chunks.push(chunk);
-    return Buffer.concat(chunks);
-}
 export async function renderDocument(element, encryption) {
     if (!encryption)
         return { pdf: await renderToBuffer(element) };
@@ -46,9 +41,8 @@ export async function renderDocument(element, encryption) {
     }));
     if (!layout)
         throw new Error('Rendering exposed no document layout. @react-pdf/renderer and @react-pdf/render are likely out of step.');
-    return {
-        pdf,
-        encrypted: await toBuffer(renderPDF(toContext(props, encryption), layout)),
-    };
+    const document = toPDFDocument(props, encryption);
+    renderPDF(document, layout);
+    return { pdf, encrypted: await buffer(document) };
 }
 //# sourceMappingURL=render-document.js.map

package/dist/helpers/render-document.js.map

@@ -1 +1 @@
-{"version":3,"file":"render-document.js","sourceRoot":"","sources":["../../src/helpers/render-document.ts"],"names":[],"mappings":"AAEA,OAAO,SAAS,MAAM,mBAAmB,CAAA;AACzC,OAAO,EAAE,cAAc,EAAsB,MAAM,qBAAqB,CAAA;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AACpC,OAAO,EAAE,YAAY,EAAqB,MAAM,OAAO,CAAA;AAUvD,SAAS,SAAS,CAChB,KAAoB,EACpB,UAAoC;IAEpC,MAAM,IAAI,GAAkC,EAAE,CAAA;IAE9C,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,KAAgC,EAAE,EAAE;QAC5D,IAAI,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;IAC5C,CAAC,CAAA;IAED,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IACzB,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IAC3B,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;IAC7B,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,IAAI,WAAW,CAAC,CAAA;IAC5C,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,IAAI,WAAW,CAAC,CAAA;IAC9C,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,YAAY,CAAC,CAAA;IACvC,GAAG,CAAC,kBAAkB,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAA;IAE/C,OAAO,IAAI,WAAW,CAAC;QACrB,QAAQ,EAAE,IAAI;QACd,YAAY,EAAE,IAAI;QAClB,aAAa,EAAE,KAAK;QACpB,IAAI,EAAE,KAAK,CAAC,QAAQ;QACpB,IAAI;QACJ,GAAG,UAAU;KACd,CAA+B,CAAA;AAClC,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,OAAwB;IAC9C,MAAM,MAAM,GAAa,EAAE,CAAA;IAE3B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAA8B;QACtD,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,CAAA;IAE9B,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;AAC9B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAoC,EACpC,UAAoC;IAEpC,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC,OAAO,CAAC,EAAE,CAAA;IAE9D,MAAM,KAAK,GAAkB;QAC3B,GAAG,OAAO,CAAC,KAAK;QAChB,YAAY,EAAE,OAAO,CAAC,KAAK,CAAC,YAAY,IAAI,IAAI,IAAI,EAAE;KACvD,CAAA;IAED,IAAI,MAAkC,CAAA;IAEtC,MAAM,GAAG,GAAG,MAAM,cAAc,CAC9B,YAAY,CAAC,OAAO,EAAE;QACpB,GAAG,KAAK;QACR,QAAQ,EAAE,QAAQ,CAAC,EAAE;YACnB,MAAM,GAAI,QAA6B,CAAC,wBAAwB,CAAA;QAClE,CAAC;KACF,CAAC,CACH,CAAA;IAED,IAAI,CAAC,MAAM;QACT,MAAM,IAAI,KAAK,CACb,yGAAyG,CAC1G,CAAA;IAEH,OAAO;QACL,GAAG;QACH,SAAS,EAAE,MAAM,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC;KAC3E,CAAA;AACH,CAAC"}
+{"version":3,"file":"render-document.js","sourceRoot":"","sources":["../../src/helpers/render-document.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAE9C,OAAO,SAAS,MAAM,mBAAmB,CAAA;AACzC,OAAO,EAAE,cAAc,EAAsB,MAAM,qBAAqB,CAAA;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AACpC,OAAO,EAAE,YAAY,EAAqB,MAAM,OAAO,CAAA;AAUvD,SAAS,aAAa,CACpB,KAAoB,EACpB,UAAoC;IAEpC,MAAM,IAAI,GAAkC,EAAE,CAAA;IAE9C,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,KAAgC,EAAE,EAAE;QAC5D,IAAI,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;IAC5C,CAAC,CAAA;IAED,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IACzB,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IAC3B,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;IAC7B,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,IAAI,WAAW,CAAC,CAAA;IAC5C,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,IAAI,WAAW,CAAC,CAAA;IAC9C,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,YAAY,CAAC,CAAA;IACvC,GAAG,CAAC,kBAAkB,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAA;IAE/C,OAAO,IAAI,WAAW,CAAC;QACrB,QAAQ,EAAE,IAAI;QACd,YAAY,EAAE,IAAI;QAClB,aAAa,EAAE,KAAK;QACpB,IAAI,EAAE,KAAK,CAAC,QAAQ;QACpB,IAAI;QACJ,GAAG,UAAU;KACd,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAoC,EACpC,UAAoC;IAEpC,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC,OAAO,CAAC,EAAE,CAAA;IAE9D,MAAM,KAAK,GAAkB;QAC3B,GAAG,OAAO,CAAC,KAAK;QAChB,YAAY,EAAE,OAAO,CAAC,KAAK,CAAC,YAAY,IAAI,IAAI,IAAI,EAAE;KACvD,CAAA;IAED,IAAI,MAAkC,CAAA;IAEtC,MAAM,GAAG,GAAG,MAAM,cAAc,CAC9B,YAAY,CAAC,OAAO,EAAE;QACpB,GAAG,KAAK;QACR,QAAQ,EAAE,QAAQ,CAAC,EAAE;YACnB,MAAM,GAAI,QAA6B,CAAC,wBAAwB,CAAA;QAClE,CAAC;KACF,CAAC,CACH,CAAA;IAED,IAAI,CAAC,MAAM;QACT,MAAM,IAAI,KAAK,CACb,yGAAyG,CAC1G,CAAA;IAEH,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,EAAE,UAAU,CAAC,CAAA;IAEjD,SAAS,CAAC,QAAsC,EAAE,MAAM,CAAC,CAAA;IAEzD,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAA;AACnD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t4h.framework/pdf",
-  "version": "0.4.6",
+  "version": "0.5.1",
   "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",
@@ -13,8 +13,14 @@
   "author": "Tech4Humans <contact@tech4h.com.br> (https://tech4h.com.br)",
   "type": "module",
   "exports": {
-    "types": "./dist/pdf.d.ts",
-    "import": "./dist/pdf.js"
+    ".": {
+      "types": "./dist/pdf.d.ts",
+      "import": "./dist/pdf.js"
+    },
+    "./eslint": {
+      "types": "./dist/eslint.d.ts",
+      "import": "./dist/eslint.js"
+    }
   },
   "module": "./dist/pdf.js",
   "types": "./dist/pdf.d.ts",
@@ -33,8 +39,8 @@
     "test:watch": "vitest"
   },
   "devDependencies": {
-    "@t4h.framework/core": "^0.20.0",
-    "@t4h.framework/fs": "^0.13.1",
+    "@t4h.framework/core": "^0.21.2",
+    "@t4h.framework/fs": "^0.14.2",
     "@types/react": "^19.2.17",
     "muhammara": "^6.0.5",
     "typescript": "^5.9.3",