@lupinum/nuxt-pdf 0.4.0-beta.3 → 0.4.0-beta.5

package/dist/agent/pages/docs/reference/define-pdf.md

@@ -0,0 +1,96 @@
+---
+title: "definePdf"
+description: "The compile-time definition for render metadata, development preview data, and the multi-pass limit."
+url: "https://nuxt-pdf.lupinum.com/docs/reference/define-pdf"
+route: "/docs/reference/define-pdf"
+locale: "en"
+section: "Documentation"
+collection: "docs"
+source: "ginko-content"
+---
+
+# definePdf
+
+> The compile-time definition for render metadata, development preview data, and the multi-pass limit.
+
+Each `pdfs/*.vue` template calls `definePdf` exactly once. It is a compile-time
+macro (like `defineProps`); it declares render metadata and development-only
+preview data and returns nothing.
+
+```ts
+definePdf<Props>({
+  title: props => `Report ${props.id}`,
+  filename: props => `report-${props.id}.pdf`,
+  language: 'en-GB',
+  maxPasses: 5,
+  sampleData: { id: 'sample' },
+  scenarios: {
+    long: { id: 'long-report' },
+  },
+})
+```
+
+## Options
+
+| Option | Type | Default | Description |
+| --- | --- | --- | --- |
+| `title` | `string \| (props) => string` | None | Document title. A static string or a function of props. |
+| `filename` | `string \| (props) => string` | None | Download filename, sanitized before use in `content-disposition`. |
+| `language` | `string` | None | Document language tag written to the info dictionary (for example `"en-US"`). |
+| `maxPasses` | `number` | `5` | Maximum layout passes before the multi-pass loop declares non-convergence and throws `PDF_LIMIT_EXCEEDED`. A positive integer. |
+| `sampleData` | `Props` | None | Props used for the default development preview. |
+| `scenarios` | `Record<string, Props>` | None | Named prop sets. Each set becomes a preview tab and a `?scenario=` query. |
+
+The `Props` type parameter ties `title`, `filename`, `sampleData`, and each
+`scenario` to the SFC's own props, so a mismatch is a type error.
+
+<info icon="lucide:info">
+`maxPasses` is only relevant to documents that read `usePdfPageNumbers()`.
+Every other document renders in a single pass regardless of the value.
+</info>
+
+## Metadata resolution
+
+`title` and `filename` functions receive the render props and must return a
+string synchronously. They are resolved at render time. When `title` or
+`language` is present, it is authoritative and overrides the corresponding prop
+authored on `PdfDocument`. When it is absent, the `PdfDocument` value remains the
+rendered fallback. The authoritative values are reapplied after every
+page-number update, so a multi-pass document cannot restore stale root metadata
+between layout passes.
+
+`resolveMetadata(props)` on the generated template handle resolves only the
+`definePdf` values without mounting the component. `filename` controls the
+default response filename; it is not a `PdfDocument` prop.
+
+## Preview data is development-only
+
+`sampleData` and `scenarios` are used only by the development preview. They are
+never exposed by the public `PdfTemplate` handle.
+
+Production compilation keeps only `title`, `filename`, `language`, and
+`maxPasses`. Preview expressions and routes are absent from the Nitro server
+output. Keep preview data representative and disposable. Do not use it as
+production runtime state or a place for secrets.
+
+`definePdf()` is module-scoped, like Vue's other hoisted compiler macros. Its
+values may be inline or imported from another module, but they cannot reference
+a variable declared locally in `<script setup>`; that fails compilation instead
+of producing a development-only `ReferenceError`. Keep imported preview-data
+modules free of side effects. Production removes an unused import only when
+evaluating that module has no required behavior.
+
+## Scenarios in the preview
+
+```ts
+definePdf<Props>({
+  sampleData: { id: 'sample' },
+  scenarios: {
+    long: { id: 'long-report' },
+    empty: { id: 'no-sections' },
+  },
+})
+```
+
+The `long` scenario is available at `/_pdf/report?scenario=long`. An unknown
+scenario name returns a 404 listing the available names.

package/dist/agent/pages/docs/reference/errors-and-limits.md

@@ -0,0 +1,89 @@
+---
+title: "Errors and limits"
+description: "Error classes, exact codes, render-budget defaults, and when each failure occurs."
+url: "https://nuxt-pdf.lupinum.com/docs/reference/errors-and-limits"
+route: "/docs/reference/errors-and-limits"
+locale: "en"
+section: "Documentation"
+collection: "docs"
+source: "ginko-content"
+---
+
+# Errors and limits
+
+> Error classes, exact codes, render-budget defaults, and when each failure occurs.
+
+Configuration and asset setup can fail before rendering starts. Public render
+failures use `NuxtPdfError` and one code from `PDF_ERROR_CODES`.
+
+## Error classes and codes
+
+| Failure | Stage | Inspect or change |
+| --- | --- | --- |
+| `TypeError` | Module setup | Read the message and correct the module option, template definition, local asset, or configured font. No render or template error code exists yet. |
+| `PDF_TEMPLATE_NOT_FOUND` | Render dispatch | Check the template's relative filename and generated registry key. |
+| `PDF_TEMPLATE_INVALID` | Template execution | Move `definePdf()` or `usePdfPageNumbers()` to its supported template/render scope. |
+| `PDF_TREE_INVALID` | Vue mount or tree validation | Correct the named root, nesting rule, primitive prop, SVG reference, or text placement. |
+| `PDF_LAYOUT_ERROR` | Layout | Check geometry and registered font family, weight, and style. |
+| `PDF_LIMIT_EXCEEDED` | Any bounded render stage | Read the named limit and cap. Reduce the input or change that one configured budget. |
+| `PDF_ASSET_INVALID` | Image admission | Replace invalid admitted PNG or JPEG bytes, dimensions, or declared format. |
+| `PDF_ASSET_BLOCKED` | Image source or request policy | Check the source form, HTTPS allowlist, redirects, and per-hop timeout. |
+| `PDF_RENDER_ERROR` | Render | Inspect the attached message and template identity for an uncategorized engine failure. |
+
+`NuxtPdfError` exposes `code`, `templateKey`, and, in development,
+`templateFile`. Its message names the template. Production leaves out the
+relative source path.
+
+`PDF_LIMIT_EXCEEDED` covers every configured time and resource budget. An
+oversized local or remote image uses this code. Allowlist and unsupported-source
+policy failures use `PDF_ASSET_BLOCKED`. Invalid bytes that passed the source
+policy use `PDF_ASSET_INVALID`.
+
+## Render limits
+
+Every field is an optional positive safe integer. Omitting the `limits` object
+or one field keeps the default below. Invalid configuration throws `TypeError`
+during module setup.
+
+| Field | Default | Bounded work |
+| --- | --- | --- |
+| `timeoutMs` | `30_000` | Metadata resolution, mount, assets, every layout pass, serialization, and output collection. |
+| `maxPages` | `2_000` | Laid-out page count. |
+| `maxNodes` | `50_000` | Mounted document-tree nodes. |
+| `maxTreeDepth` | `128` | Mounted document-tree depth. |
+| `maxTextCharacters` | `2_000_000` | Unicode code points in text nodes. |
+| `maxImages` | `256` | Image nodes. |
+| `maxImageBytes` | `10_485_760` | Source bytes for one unique image. |
+| `maxTotalImageBytes` | `33_554_432` | Source bytes across unique images. |
+| `maxImagePixels` | `25_000_000` | Decoded pixels for one unique image. |
+| `maxTotalImagePixels` | `100_000_000` | Decoded pixels across unique images. |
+| `maxRemoteRequests` | `32` | Remote requests, including redirect hops. |
+| `maxRemoteConcurrency` | `4` | Simultaneous remote requests. |
+| `maxOutputBytes` | `67_108_864` | Completed PDF bytes. |
+
+Configure overrides in `nuxt.config.ts`:
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+  pdf: {
+    limits: {
+      maxPages: 500,
+      timeoutMs: 20_000,
+    },
+  },
+})
+```
+
+The timeout is one deadline for the complete public render. It is checked
+between engine stages and cannot interrupt synchronous layout midway. A single
+stage can therefore finish after the deadline before the error is reported.
+
+Tree and content limits are checked after Vue mounts and after each destination
+page-number update. Image budgets apply before engine admission. Output is
+collected into one completed buffer and discarded if `maxOutputBytes` is
+exceeded.
+
+`maxPasses` is a per-template `definePdf()` option, not a module limit. Its
+default is `5`. A table of contents normally settles after destination numbers
+feed into the next layout pass. Geometry that keeps changing fails with
+`PDF_LIMIT_EXCEEDED`.

package/dist/agent/pages/docs/reference/module-options.md

@@ -0,0 +1,104 @@
+---
+title: "Module options"
+description: "Build-time configuration for registered fonts, remote images, and render budgets."
+url: "https://nuxt-pdf.lupinum.com/docs/reference/module-options"
+route: "/docs/reference/module-options"
+locale: "en"
+section: "Documentation"
+collection: "docs"
+source: "ginko-content"
+---
+
+# Module options
+
+> Build-time configuration for registered fonts, remote images, and render budgets.
+
+Set module options under `pdf` in `nuxt.config.ts`:
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+  modules: ['@lupinum/nuxt-pdf'],
+  pdf: {
+    fonts: [],
+    limits: {},
+    remote: undefined,
+  },
+})
+```
+
+| Option | Type | Default | Behavior |
+| --- | --- | --- | --- |
+| `fonts` | `PdfFontDeclaration[]` | `[]` | Registers local TTF, OTF, or WOFF2 faces from `pdfs/fonts`. |
+| `remote` | `RemoteAssetOptions` | `undefined` | Enables allowlisted HTTPS image requests. No remote request is admitted when absent. |
+| `limits` | `PdfLimitsOptions` | All documented defaults | Overrides individual fields in the shared render budget. See [Errors and limits](/raw/docs/reference/errors-and-limits.md). |
+
+Unknown `pdf` keys fail during module setup.
+
+## pdf.fonts
+
+Each entry registers one font face:
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+  pdf: {
+    fonts: [
+      {
+        family: 'Invoice Sans',
+        src: 'InvoiceSans-Regular.ttf',
+        fontStyle: 'normal',
+        fontWeight: 400,
+      },
+    ],
+  },
+})
+```
+
+| Field | Type | Required | Default | Behavior |
+| --- | --- | --- | --- | --- |
+| `family` | `string` | Yes | Required | Family used by the `fontFamily` style property. |
+| `src` | `string` | Yes | Required | TTF, OTF, or WOFF2 path relative to `pdfs/fonts`. |
+| `fontWeight` | `number \| PdfFontWeightName` | No | `400` | Numeric or named weight. |
+| `fontStyle` | `'normal' \| 'italic' \| 'oblique'` | No | `'normal'` | Face style. |
+
+Register each weight and style used by a document. Invalid declarations and
+font files throw `TypeError` during module setup. See
+[Add images and fonts](/raw/docs/guides/images-and-fonts.md).
+
+## pdf.remote
+
+`remote` admits HTTPS images whose URL starts with an allowed prefix:
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+  pdf: {
+    remote: {
+      allow: ['https://cdn.example.com/brand/'],
+      timeoutMs: 10_000,
+    },
+  },
+})
+```
+
+| Field | Type | Required | Default | Behavior |
+| --- | --- | --- | --- | --- |
+| `allow` | `string[]` | Yes | Required | Non-empty list of exact `https://host/path/` prefixes. |
+| `timeoutMs` | `number` | No | `10_000` | Timeout for each request or redirect hop. |
+
+Allowlist prefixes require a trailing slash. They cannot contain credentials,
+queries, fragments, wildcards, or a non-HTTPS scheme. The
+[remote-image guide](/raw/docs/guides/remote-images.md) defines request and redirect
+behavior.
+
+## Exported types
+
+Import these types from `@lupinum/nuxt-pdf`:
+
+| Export | Describes |
+| --- | --- |
+| `ModuleOptions` | Complete `pdf` module options. |
+| `PdfFontDeclaration` | One registered font face. |
+| `PdfFontStyle` | Accepted font styles. |
+| `PdfFontWeight` | Numeric or named font weight. |
+| `PdfFontWeightName` | Accepted named font weights. |
+| `RemoteAssetOptions` | Remote image allowlist and timeout. |
+| `PdfLimitsOptions` | Optional render-limit overrides. |

package/dist/agent/pages/docs/reference/page-sizes.md

@@ -0,0 +1,54 @@
+---
+title: "Page sizes"
+description: "Named and custom page dimensions accepted by PdfPage."
+url: "https://nuxt-pdf.lupinum.com/docs/reference/page-sizes"
+route: "/docs/reference/page-sizes"
+locale: "en"
+section: "Documentation"
+collection: "docs"
+source: "ginko-content"
+---
+
+# Page sizes
+
+> Named and custom page dimensions accepted by PdfPage.
+
+Set `PdfPage.size` to an uppercase named size or to explicit dimensions. The
+default is `A4`.
+
+```vue
+<PdfPage size="LETTER">
+  <PdfText>Letter page</PdfText>
+</PdfPage>
+```
+
+Page-size names are case-sensitive:
+
+| Family | Accepted names |
+| --- | --- |
+| ISO A | `4A0`, `2A0`, `A0`, `A1`, `A2`, `A3`, `A4`, `A5`, `A6`, `A7`, `A8`, `A9`, `A10` |
+| ISO B | `B0`, `B1`, `B2`, `B3`, `B4`, `B5`, `B6`, `B7`, `B8`, `B9`, `B10` |
+| ISO C | `C0`, `C1`, `C2`, `C3`, `C4`, `C5`, `C6`, `C7`, `C8`, `C9`, `C10` |
+| Raw format | `RA0`, `RA1`, `RA2`, `RA3`, `RA4` |
+| Supplementary raw format | `SRA0`, `SRA1`, `SRA2`, `SRA3`, `SRA4` |
+| North American and other | `EXECUTIVE`, `FOLIO`, `LEGAL`, `LETTER`, `TABLOID`, `ID1` |
+
+## Custom dimensions
+
+Use a two-value tuple or a width/height object. A unitless number is a PDF
+point. String dimensions accept `pt`, `in`, `mm`, `cm`, or `px`:
+
+```vue
+<PdfPage :size="['210mm', '297mm']">
+  <PdfText>Custom A4 dimensions</PdfText>
+</PdfPage>
+```
+
+```vue
+<PdfPage :size="{ width: '4in', height: '6in' }">
+  <PdfText>Shipping label</PdfText>
+</PdfPage>
+```
+
+`px` uses the page's `dpi` prop. The default DPI is `72`. Use `orientation` to
+swap portrait and landscape dimensions without reversing the size tuple.

package/dist/agent/pages/docs/reference/primitives.md

@@ -0,0 +1,216 @@
+---
+title: "Primitives"
+description: "Prop tables for every document and SVG primitive, drawn from the shipped type definitions."
+url: "https://nuxt-pdf.lupinum.com/docs/reference/primitives"
+route: "/docs/reference/primitives"
+locale: "en"
+section: "Documentation"
+collection: "docs"
+source: "ginko-content"
+---
+
+# Primitives
+
+> Prop tables for every document and SVG primitive, drawn from the shipped type definitions.
+
+Every primitive is an auto-registered global component. The tables below are
+drawn from the shipped prop types. `style` values use Nuxt PDF's framework-owned
+`PdfStyle` contract, not CSS or the wider upstream stylesheet types (see
+[Styling and layout](/raw/docs/learn/styling-and-layout.md).
+
+The same surface is enforced after Vue mounts the tree. Each primitive has a
+closed runtime prop allowlist; unknown props, DOM/event attributes, and props
+used on the wrong primitive fail with `PDF_TREE_INVALID` rather than passing
+through or silently doing nothing.
+
+## Shared base props
+
+`PdfPage`, `PdfView`, page-flow `PdfText`, `PdfImage`, `PdfLink`, and `PdfNote`
+share these:
+
+| Prop | Type | Default | Description |
+| --- | --- | --- | --- |
+| `id` | `string` | None | Makes the node a named destination for `#id` links and page-number resolution. |
+| `fixed` | `boolean` | `false` | Repeats the node on every page of its flow. |
+| `break` | `boolean` | `false` | Forces a page break before the node. |
+| `minPresenceAhead` | `number` | `0` | Minimum space in points that must follow, or the node moves to the next page. |
+| `debug` | `boolean` | `false` | Draws the node's layout box for debugging. |
+| `style` | `PdfStyleValue` | None | A style object or nested array. `false`, `null`, and `undefined` entries are ignored. |
+
+`PdfPage`, `PdfView`, `PdfText`, and `PdfImage` additionally accept `bookmark`
+(`string`, or `{ title, expanded? }`) to build the outline.
+
+## PdfDocument
+
+The root. Carries document metadata; takes no base props.
+
+| Prop | Type | Default | Description |
+| --- | --- | --- | --- |
+| `title`, `author`, `subject`, `keywords` | `string` | None | Info-dictionary metadata. |
+| `creator`, `producer` | `string` | `'nuxt-pdf'` | Info-dictionary producer metadata. |
+| `language` | `string` | None | Document language tag. |
+| `creationDate` | `Date` | Current render date | Info-dictionary creation date. |
+| `pdfVersion` | `'1.3'` through `'1.7'` or `'1.7ext3'` | `'1.3'` | PDF version written to the catalog. |
+| `pageLayout` | `'singlePage' \| 'oneColumn' \| 'twoColumnLeft' \| 'twoColumnRight' \| 'twoPageLeft' \| 'twoPageRight'` | None | Reader page layout. |
+
+Reader page mode, encryption passwords, and PDF permission flags are not public
+props. Their serialized behavior is not part of the current public contract.
+
+`modificationDate` is also absent. The pinned engine writes its
+upstream prop under a non-standard custom key rather than the PDF `ModDate`
+entry, so exposing it would promise metadata that common readers do not see.
+
+When `definePdf` supplies `title` or `language`, that value is authoritative and
+overrides the corresponding `PdfDocument` prop. Without a definition value, the
+root prop is preserved as the rendered fallback. Nuxt PDF reapplies the
+authoritative values after each page-number update in a multi-pass render.
+
+## PdfPage
+
+| Prop | Type | Default | Description |
+| --- | --- | --- | --- |
+| `size` | `PdfPageSizeName \| [w, h] \| { width, height }` | `'A4'` | Uppercase named size or explicit dimensions. See [Page sizes](/raw/docs/reference/page-sizes.md). |
+| `orientation` | `'portrait' \| 'landscape'` | `'portrait'` | Page orientation. |
+| `dpi` | `number` | `72` | DPI used for `px` dimensions. |
+| `wrap` | `boolean` | `true` | Paginates content. `false` grows the page to fit. |
+
+Plus the base and bookmark props.
+
+## PdfView
+
+The flexbox container. Base and bookmark props, plus:
+
+| Prop | Type | Default | Description |
+| --- | --- | --- | --- |
+| `wrap` | `boolean` | `true` | Allows the view to split across a page boundary. |
+
+## PdfText
+
+The only container for text has two context-specific prop branches.
+
+In normal page flow it accepts the base and bookmark props, plus:
+
+| Prop | Type | Default | Description |
+| --- | --- | --- | --- |
+| `wrap` | `boolean` | `true` | Allows text to split across pages. |
+| `widows` | `number` | `2` | Minimum lines kept together at a page top. |
+| `orphans` | `number` | `2` | Minimum lines kept together at a page bottom. |
+| `render` | `({ pageNumber, totalPages, subPageNumber, subPageTotalPages }) => string \| number \| null \| undefined` | None | Synchronous dynamic text. |
+| `hyphenationCallback` | `(word: string) => string[]` | Engine default | Returns custom hyphenation break points. |
+
+Inside `PdfSvg`, it instead accepts:
+
+| Prop | Type | Default | Description |
+| --- | --- | --- | --- |
+| `x`, `y` | `PdfSvgLength` | Required | SVG text coordinates. |
+| `fill` | `string` | None | Direct SVG text paint color. |
+| `style` | `PdfStyleValue` | None | Text metrics such as font family and size. `color` is not SVG paint. |
+| `hyphenationCallback` | `(word: string) => string[]` | Engine default | Returns custom hyphenation break points. |
+
+SVG text rejects page-flow-only props such as `id`, `bookmark`, `fixed`,
+`break`, `wrap`, `widows`, `orphans`, and `render`.
+
+## PdfImage
+
+Base and bookmark props, plus:
+
+| Prop | Type | Default | Description |
+| --- | --- | --- | --- |
+| `src` | `PdfImageSource` | Required | Image source. |
+
+`PdfImageSource` is a `pdfs/assets`-relative path, a `Uint8Array`/`ArrayBuffer`,
+`{ data, format: 'png' \| 'jpg' }`, or `{ uri, format? }`.
+
+## PdfLink
+
+Base props (no bookmark), plus:
+
+| Prop | Type | Default | Description |
+| --- | --- | --- | --- |
+| `href` | `string` | Required | External `https:` or `mailto:` URL, or a `#id` internal destination. |
+| `wrap` | `boolean` | `true` | Allows the link to split across pages. |
+| `hitSlop` | `{ top?, right?, bottom?, left? }` | None | Expands the clickable area. |
+
+## PdfNote
+
+A sticky-note annotation. Base props only; its text comes from its content.
+
+---
+
+## SVG primitives
+
+SVG primitives render inside a `PdfSvg`. Paint, geometry, clipping, and
+transforms are direct props. `PdfG` and the shape primitives have no generic
+`style` prop, so there is no style-precedence path; kebab-case Vue attributes
+are normalized to the equivalent camelCase key. See
+[SVG graphics](/raw/docs/guides/svg-graphics.md).
+
+`PdfSvgNumber` is a finite number or numeric string. `PdfSvgLength` additionally
+accepts a numeric percentage string where the individual prop permits it.
+`strokeWidth` is never a percentage. Non-negative geometry and unit-interval
+opacity/stop ranges are checked at runtime.
+
+### Shared SVG presentation props
+
+Available on `PdfG`, `PdfPath`, `PdfRect`, `PdfCircle`, `PdfEllipse`, `PdfLine`,
+`PdfPolyline`, and `PdfPolygon`:
+
+| Prop | Type |
+| --- | --- |
+| `fill`, `stroke` | `string` |
+| `fillOpacity`, `strokeOpacity` | `PdfSvgLength` (0 to 1 or 0% to 100%) |
+| `strokeWidth` | `PdfSvgNumber` (non-negative) |
+| `strokeLinecap` | `'butt' \| 'round' \| 'square'` |
+| `strokeLinejoin` | `'miter' \| 'round' \| 'bevel'` |
+| `transform` | `PdfSvgTransform`. One to three unitless `translate(...)` or `rotate(...)` operations. |
+| `clipPath` | `string` with the value `url(#id)` |
+
+### Geometry props
+
+| Component | Own props |
+| --- | --- |
+| `PdfSvg` | `viewBox`, `width`, `height`, plus page-flow `style` (not SVG presentation) |
+| `PdfG` | _(presentation props only)_ |
+| `PdfPath` | `d` **(required)** |
+| `PdfRect` | `x`, `y`, `width` **(required)**, `height` **(required)**, `rx`, `ry` |
+| `PdfCircle` | `cx`, `cy`, `r` **(required)** |
+| `PdfEllipse` | `cx`, `cy`, `rx` **(required)**, `ry` **(required)** |
+| `PdfLine` | `x1`, `y1`, `x2`, `y2` **(all required)** |
+| `PdfPolyline` / `PdfPolygon` | `points` **(required)** |
+| `PdfDefs` | None. It holds definitions that other elements can reference. |
+| `PdfClipPath` | `id` **(required)** |
+| `PdfLinearGradient` | `id` **(required)**, `x1`, `y1`, `x2`, `y2` |
+| `PdfRadialGradient` | `id` **(required)**, `cx`, `cy`, `r`, `fx`, `fy` |
+| `PdfStop` | `offset` **(required)**, `stopColor` **(required)**, `stopOpacity` |
+| `PdfTspan` | `x`, `y`, `fill` only |
+
+Alternate gradient coordinate systems, transforms, inheritance, and SVG
+`preserveAspectRatio` modes are not public props. See
+[Supported behavior and limitations](/raw/docs/examples/supported-behavior.md).
+
+Each `PdfSvg` accepts at most one direct `PdfDefs` child. Definition ids are
+safe, unique, and scoped to that one SVG. `fill="url(#id)"` must resolve to a
+linear or radial gradient; `clipPath="url(#id)"` must resolve to a
+`PdfClipPath`. Missing, malformed, or incompatible references fail with
+`PDF_TREE_INVALID`.
+
+Explicit zero has SVG semantics: zero fill opacity is transparent, zero stroke
+width removes the stroke instead of requesting a PDF hairline, and supported
+gradient coordinates remain zero. The engine repairs upstream truthiness
+fallbacks after layout and before serialization.
+
+## Exported primitive types
+
+Import prop and value types from `@lupinum/nuxt-pdf` when you type reusable
+document components:
+
+| Area | Exports |
+| --- | --- |
+| Shared | `PdfBaseProps`, `PdfBookmark` |
+| Document flow | `PdfDocumentProps`, `PdfPageProps`, `PdfViewProps`, `PdfTextProps`, `PdfImageProps`, `PdfLinkProps`, `PdfNoteProps` |
+| Images | `PdfImageSource` |
+| Page dimensions | `PdfPageDimension`, `PdfPageSize`, `PdfPageSizeName`, `PdfPageUnit` |
+| SVG containers | `PdfSvgProps`, `PdfGProps`, `PdfDefsProps`, `PdfClipPathProps` |
+| SVG shapes | `PdfPathProps`, `PdfRectProps`, `PdfCircleProps`, `PdfEllipseProps`, `PdfLineProps`, `PdfPolylineProps`, `PdfPolygonProps` |
+| SVG gradients and text | `PdfLinearGradientProps`, `PdfRadialGradientProps`, `PdfStopProps`, `PdfTspanProps` |
+| SVG values | `PdfSvgNumber`, `PdfSvgLength`, `PdfSvgPresentationProps`, `PdfSvgTransform`, `PdfSvgTransformOperation` |