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

package/CHANGELOG.md

@@ -4,6 +4,40 @@ All notable changes to `@lupinum/nuxt-pdf` are recorded here. The format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the project adheres
 to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## 0.4.0-beta.5
+
+[compare changes](https://github.com/lupinum-dev/nuxt-pdf/compare/v0.4.0-beta.4...0.4.0-beta.5)
+
+### Added
+
+- **docs:** Ship versioned package guidance ([ca81a32](https://github.com/lupinum-dev/nuxt-pdf/commit/ca81a32))
+
+### Fixed
+
+- **deps:** Clear workspace advisories and update Vitest ([#59](https://github.com/lupinum-dev/nuxt-pdf/pull/59))
+
+## 0.4.0-beta.4
+
+[compare changes](https://github.com/lupinum-dev/nuxt-pdf/compare/v0.4.0-beta.3...0.4.0-beta.4)
+
+### Fixed
+
+- **deps:** Enforce quarantine in package consumers ([#48](https://github.com/lupinum-dev/nuxt-pdf/pull/48))
+- **assets:** Revalidate disk images across renders ([#49](https://github.com/lupinum-dev/nuxt-pdf/pull/49))
+- **dev:** Export registered PDF component guards ([#50](https://github.com/lupinum-dev/nuxt-pdf/pull/50))
+- **preview:** Rebuild watched templates before refreshing ([#51](https://github.com/lupinum-dev/nuxt-pdf/pull/51))
+- **release:** Bind package evidence to its source graph ([#52](https://github.com/lupinum-dev/nuxt-pdf/pull/52))
+
+### Maintenance
+
+- **maintenance:** Verify PDF commands without repeated work ([#53](https://github.com/lupinum-dev/nuxt-pdf/pull/53))
+
+### Tests
+
+- **compatibility:** Verify declared PDF consumer versions ([#54](https://github.com/lupinum-dev/nuxt-pdf/pull/54))
+- **assets:** Describe per-render disk validation ([#55](https://github.com/lupinum-dev/nuxt-pdf/pull/55))
+- **production:** Tolerate fixture text whitespace ([#56](https://github.com/lupinum-dev/nuxt-pdf/pull/56))
+
 ## 0.4.0-beta.3 - 2026-09-03
 
 ### Added

package/CONFORMANCE.md

@@ -1,11 +1,11 @@
-# Nuxt PDF 0.4.0-beta.3 conformance
+# Nuxt PDF 0.4.0-beta.5 conformance
 
 Nuxt PDF claims behavioral compatibility for a deliberately small, tested
 corpus. It does not claim full React PDF API or test-suite compatibility.
 
 ## Version boundary
 
-| Layer | 0.4.0-beta.3 boundary |
+| Layer | 0.4.0-beta.5 boundary |
 |---|---|
 | Node.js | `^22.14.0`, `^24.0.0`, or `^26.0.0` |
 | Nuxt | `^4.4.8` |
@@ -217,7 +217,7 @@ checking.
 
 ### Vue and Nuxt authoring
 
-The 0.4.0-beta.2 tests verify:
+The 0.4.0-beta.5 tests verify:
 
 - `PdfDocument`, `PdfPage`, `PdfView`, `PdfText`, `PdfImage`, `PdfLink`, and
   `PdfNote`;
@@ -261,6 +261,10 @@ The 0.4.0-beta.2 tests verify:
   content type;
 - development preview index, viewer, raw PDF, and named scenarios, backed by a
   separate internal development sidecar;
+- development guards for every global PDF component, including Nuxt
+  auto-import misuse outside a PDF template;
+- watched template rebuilds and whole-viewer refreshes that keep the selected
+  scenario and replace document bytes with their matching diagnostics;
 - a production Nitro route rendering through the generated registry;
 - structural removal of `sampleData` and `scenarios` during production SFC
   compilation, with unique fixture canaries and preview-only API tokens rejected
@@ -342,6 +346,8 @@ shows up without a restart. The tested boundary includes:
 - TTF, OTF, and WOFF2 signature/extension/structure validation,
   registration validation, source byte limits, and source-removal rendering;
 - explicit local `pdfs/assets` and `pdfs/fonts` roots;
+- independent image validation across roots and after same-size,
+  same-timestamp development edits;
 - rejection of absolute paths, traversal, missing assets, ambiguous sources,
   unsupported URLs, and symlink escapes; and
 - font rendering after its source file is removed, and image resolution from
@@ -450,7 +456,7 @@ parser, not two. Claimed:
 Verified end-to-end against a real rendered template, including assertion
 failure messages, in `test/test-utils-public.test.ts`.
 
-## Explicitly not claimed in 0.4.0-beta.2
+## Explicitly not claimed in 0.4.0-beta.5
 
 - Full React PDF component, hook, browser-helper, or test-suite parity.
 - React runtime compatibility or React-shaped dynamic callback results.

package/README.md

@@ -73,6 +73,34 @@ export default defineNuxtConfig({
 })
 ```
 
+<!-- BEGIN:consumer-onboarding -->
+
+### Use a coding agent
+
+A coding agent is a development tool that can inspect and change your project.
+After installation, copy this prompt into your coding agent:
+
+```text
+Add Nuxt PDF to this Nuxt application and render one PDF from a Vue template.
+Read the project's existing instructions first. Resolve
+@lupinum/nuxt-pdf/agent-docs from this application's directory and read its
+starting pages. Use the installed version's examples and public types. Preserve
+existing routes, security limits, conventions, and AGENTS.md instructions. Add
+or update one short Nuxt PDF pointer in AGENTS.md if the project allows it; do
+not duplicate the documentation. If the file is absent, create only that
+pointer. Report missing guidance. Verify the server route, PDF output, and one
+invalid request.
+```
+
+If the installed package has no `agent-docs` export, read its packaged README,
+types, and `CONFORMANCE.md`. Use documentation from the matching source tag when
+more detail is needed. Installing or updating the package does not edit project
+instructions. The pointer resolves the installed package, so upgrades and
+rollbacks select the matching documentation without copying it into your
+application.
+
+<!-- END:consumer-onboarding -->
+
 ## Quick start
 
 Create `pdfs/invoice.vue`:

package/dist/agent/AGENTS.md

@@ -0,0 +1,48 @@
+# @lupinum/nuxt-pdf
+
+Documentation for installed version 0.4.0-beta.5.
+
+Read the relevant local pages before changing this package’s integration.
+Project instructions govern architecture, style and permissions.
+
+## Start here
+
+- [Install Nuxt PDF](./pages/docs/getting-started/installation.md) — /docs/getting-started/installation
+- [Module options](./pages/docs/reference/module-options.md) — /docs/reference/module-options
+
+## Find a page
+
+The index below maps public documentation routes to this installed snapshot.
+For links to this documentation site, use the matching local page in manifest.json
+instead of fetching a possibly different website version. Preserve URL fragments.
+External dependencies have their own versioned contracts. Report missing guidance.
+
+- [Example gallery](./pages/docs/examples.md) — /docs/examples
+- [Supported behavior and limitations](./pages/docs/examples/supported-behavior.md) — /docs/examples/supported-behavior
+- [Overview](./pages/docs/getting-started.md) — /docs/getting-started
+- [Install Nuxt PDF](./pages/docs/getting-started/installation.md) — /docs/getting-started/installation
+- [Render your first PDF](./pages/docs/getting-started/quickstart.md) — /docs/getting-started/quickstart
+- [Add links, bookmarks, and a table of contents](./pages/docs/guides/contents-links-bookmarks.md) — /docs/guides/contents-links-bookmarks
+- [Deploy and operate](./pages/docs/guides/deployment.md) — /docs/guides/deployment
+- [Diagnose render failures](./pages/docs/guides/errors-and-debugging.md) — /docs/guides/errors-and-debugging
+- [Add images and fonts](./pages/docs/guides/images-and-fonts.md) — /docs/guides/images-and-fonts
+- [Production recipes](./pages/docs/guides/recipes.md) — /docs/guides/recipes
+- [Configure remote images](./pages/docs/guides/remote-images.md) — /docs/guides/remote-images
+- [Build reusable document components](./pages/docs/guides/reusable-components.md) — /docs/guides/reusable-components
+- [Render outside Nitro](./pages/docs/guides/standalone-node.md) — /docs/guides/standalone-node
+- [Draw SVG graphics](./pages/docs/guides/svg-graphics.md) — /docs/guides/svg-graphics
+- [Test a PDF](./pages/docs/guides/testing.md) — /docs/guides/testing
+- [The document tree](./pages/docs/learn/document-tree.md) — /docs/learn/document-tree
+- [Runtime and data loading](./pages/docs/learn/runtime-and-data.md) — /docs/learn/runtime-and-data
+- [Styling and layout](./pages/docs/learn/styling-and-layout.md) — /docs/learn/styling-and-layout
+- [Templates and the registry](./pages/docs/learn/templates-and-registry.md) — /docs/learn/templates-and-registry
+- [Composables](./pages/docs/reference/composables.md) — /docs/reference/composables
+- [definePdf](./pages/docs/reference/define-pdf.md) — /docs/reference/define-pdf
+- [Errors and limits](./pages/docs/reference/errors-and-limits.md) — /docs/reference/errors-and-limits
+- [Module options](./pages/docs/reference/module-options.md) — /docs/reference/module-options
+- [Page sizes](./pages/docs/reference/page-sizes.md) — /docs/reference/page-sizes
+- [Primitives](./pages/docs/reference/primitives.md) — /docs/reference/primitives
+- [Registry and render result](./pages/docs/reference/registry.md) — /docs/reference/registry
+- [Standalone build and runtime](./pages/docs/reference/standalone.md) — /docs/reference/standalone
+- [Styles](./pages/docs/reference/styles.md) — /docs/reference/styles
+- [Test utilities](./pages/docs/reference/test-utilities.md) — /docs/reference/test-utilities

package/dist/agent/manifest.json

@@ -0,0 +1,215 @@
+{
+  "schemaVersion": 1,
+  "name": "@lupinum/nuxt-pdf",
+  "version": "0.4.0-beta.5",
+  "entrySha256": "51269576487bbfde32f8e920ae5e3cb6915af6d39f4da33149bbe87695507ee9",
+  "startRoutes": [
+    "/docs/getting-started/installation",
+    "/docs/reference/module-options"
+  ],
+  "pages": [
+    {
+      "title": "Example gallery",
+      "route": "/docs/examples",
+      "url": "https://nuxt-pdf.lupinum.com/docs/examples",
+      "file": "pages/docs/examples.md",
+      "sha256": "ef7a42c0ce6140e02375fd4435455424d7c6cfea47a68529c6f6d2520d797c8f"
+    },
+    {
+      "title": "Supported behavior and limitations",
+      "route": "/docs/examples/supported-behavior",
+      "url": "https://nuxt-pdf.lupinum.com/docs/examples/supported-behavior",
+      "file": "pages/docs/examples/supported-behavior.md",
+      "sha256": "a6911a6f48321d1f40367de827d268aa5da563b205066f4558e23f37db96622e"
+    },
+    {
+      "title": "Overview",
+      "route": "/docs/getting-started",
+      "url": "https://nuxt-pdf.lupinum.com/docs/getting-started",
+      "file": "pages/docs/getting-started.md",
+      "sha256": "2b4b8cf86ebd7f07f4e66050e025e81e0e987ae0f102ac99a9b62e2ec70fc00d"
+    },
+    {
+      "title": "Install Nuxt PDF",
+      "route": "/docs/getting-started/installation",
+      "url": "https://nuxt-pdf.lupinum.com/docs/getting-started/installation",
+      "file": "pages/docs/getting-started/installation.md",
+      "sha256": "4f5e64077d1de654b6cf073f1dbb8bb28eb81df7955dc74ec99dcf015599f9de"
+    },
+    {
+      "title": "Render your first PDF",
+      "route": "/docs/getting-started/quickstart",
+      "url": "https://nuxt-pdf.lupinum.com/docs/getting-started/quickstart",
+      "file": "pages/docs/getting-started/quickstart.md",
+      "sha256": "a48711287b894ed1b63d4b8bf3c68afec6d855b42dc317b6d0bc25eac7b861ce"
+    },
+    {
+      "title": "Add links, bookmarks, and a table of contents",
+      "route": "/docs/guides/contents-links-bookmarks",
+      "url": "https://nuxt-pdf.lupinum.com/docs/guides/contents-links-bookmarks",
+      "file": "pages/docs/guides/contents-links-bookmarks.md",
+      "sha256": "1a1041552abf36aeebbda896890f8f0eedda9802aeeb8b35c525f0306f52827f"
+    },
+    {
+      "title": "Deploy and operate",
+      "route": "/docs/guides/deployment",
+      "url": "https://nuxt-pdf.lupinum.com/docs/guides/deployment",
+      "file": "pages/docs/guides/deployment.md",
+      "sha256": "86a74925ec588c75ba1ccc08e833203c76a279ddc2ea31936eecd6fd905f274f"
+    },
+    {
+      "title": "Diagnose render failures",
+      "route": "/docs/guides/errors-and-debugging",
+      "url": "https://nuxt-pdf.lupinum.com/docs/guides/errors-and-debugging",
+      "file": "pages/docs/guides/errors-and-debugging.md",
+      "sha256": "3353c927d400557e6e7b7e861a49abc1a6a01240fa5e9c4a8fd621cc8baa6424"
+    },
+    {
+      "title": "Add images and fonts",
+      "route": "/docs/guides/images-and-fonts",
+      "url": "https://nuxt-pdf.lupinum.com/docs/guides/images-and-fonts",
+      "file": "pages/docs/guides/images-and-fonts.md",
+      "sha256": "cc31e2b4143060aaa4eaa78092864da7a6e3321a97474815be576497e203ef9c"
+    },
+    {
+      "title": "Production recipes",
+      "route": "/docs/guides/recipes",
+      "url": "https://nuxt-pdf.lupinum.com/docs/guides/recipes",
+      "file": "pages/docs/guides/recipes.md",
+      "sha256": "5146c107305561922599290216f2eba21dc0ca887a2863376a4ca46ef176e3d9"
+    },
+    {
+      "title": "Configure remote images",
+      "route": "/docs/guides/remote-images",
+      "url": "https://nuxt-pdf.lupinum.com/docs/guides/remote-images",
+      "file": "pages/docs/guides/remote-images.md",
+      "sha256": "1b7a05b48cfac8049c89d60310c2be078b86689a07968a54f31a0530bea16ee2"
+    },
+    {
+      "title": "Build reusable document components",
+      "route": "/docs/guides/reusable-components",
+      "url": "https://nuxt-pdf.lupinum.com/docs/guides/reusable-components",
+      "file": "pages/docs/guides/reusable-components.md",
+      "sha256": "9a269143397420d8a879a4657c0ab960d303203af561648d63ba58052eb3519c"
+    },
+    {
+      "title": "Render outside Nitro",
+      "route": "/docs/guides/standalone-node",
+      "url": "https://nuxt-pdf.lupinum.com/docs/guides/standalone-node",
+      "file": "pages/docs/guides/standalone-node.md",
+      "sha256": "e88d80f0bd0d67a46e6cafad12eb167f7a1377b56015686ffd131dc0f49dc55e"
+    },
+    {
+      "title": "Draw SVG graphics",
+      "route": "/docs/guides/svg-graphics",
+      "url": "https://nuxt-pdf.lupinum.com/docs/guides/svg-graphics",
+      "file": "pages/docs/guides/svg-graphics.md",
+      "sha256": "bbec519d3597b93b61b3c9e51f1b225ddf4cdecb96a311e6320ca68db309a313"
+    },
+    {
+      "title": "Test a PDF",
+      "route": "/docs/guides/testing",
+      "url": "https://nuxt-pdf.lupinum.com/docs/guides/testing",
+      "file": "pages/docs/guides/testing.md",
+      "sha256": "6682ecc97f05cb034ca9ca3c066312b340847daf4ce96c239977d9b222310a9b"
+    },
+    {
+      "title": "The document tree",
+      "route": "/docs/learn/document-tree",
+      "url": "https://nuxt-pdf.lupinum.com/docs/learn/document-tree",
+      "file": "pages/docs/learn/document-tree.md",
+      "sha256": "68ed0fa2e2e12b4d29314be363d10cb43cb928cfff3480b0210544bfc3d0d436"
+    },
+    {
+      "title": "Runtime and data loading",
+      "route": "/docs/learn/runtime-and-data",
+      "url": "https://nuxt-pdf.lupinum.com/docs/learn/runtime-and-data",
+      "file": "pages/docs/learn/runtime-and-data.md",
+      "sha256": "9165121817b58159a1d49a2d92c98d40a30b2a78e05f95b28bb7b089ff5dbbcb"
+    },
+    {
+      "title": "Styling and layout",
+      "route": "/docs/learn/styling-and-layout",
+      "url": "https://nuxt-pdf.lupinum.com/docs/learn/styling-and-layout",
+      "file": "pages/docs/learn/styling-and-layout.md",
+      "sha256": "9d622634064c18e76e1be2e6dfe33cdff45ff42c249c655fdb5702d846deb851"
+    },
+    {
+      "title": "Templates and the registry",
+      "route": "/docs/learn/templates-and-registry",
+      "url": "https://nuxt-pdf.lupinum.com/docs/learn/templates-and-registry",
+      "file": "pages/docs/learn/templates-and-registry.md",
+      "sha256": "89cb41b292e81984bdfd087fe12a6838590b0e38a967d72823c5493a8833c564"
+    },
+    {
+      "title": "Composables",
+      "route": "/docs/reference/composables",
+      "url": "https://nuxt-pdf.lupinum.com/docs/reference/composables",
+      "file": "pages/docs/reference/composables.md",
+      "sha256": "cbd079540924ceee433d783ac43d5b4d1d35b15675f0f08f474042650fbc8b9a"
+    },
+    {
+      "title": "definePdf",
+      "route": "/docs/reference/define-pdf",
+      "url": "https://nuxt-pdf.lupinum.com/docs/reference/define-pdf",
+      "file": "pages/docs/reference/define-pdf.md",
+      "sha256": "056dc09669d8cc4ea7a9e7e6dc0021e047e39ea546c610893cdcefeca4c0dce2"
+    },
+    {
+      "title": "Errors and limits",
+      "route": "/docs/reference/errors-and-limits",
+      "url": "https://nuxt-pdf.lupinum.com/docs/reference/errors-and-limits",
+      "file": "pages/docs/reference/errors-and-limits.md",
+      "sha256": "1b762cb9222cd5f71ab28fdfdb047000bf2359c7aa6702e8fa79b220d4015ea0"
+    },
+    {
+      "title": "Module options",
+      "route": "/docs/reference/module-options",
+      "url": "https://nuxt-pdf.lupinum.com/docs/reference/module-options",
+      "file": "pages/docs/reference/module-options.md",
+      "sha256": "7bd4db4121d02c8ec95a8e36788eb769baff4c6260357e1700ce16f35f3cbaad"
+    },
+    {
+      "title": "Page sizes",
+      "route": "/docs/reference/page-sizes",
+      "url": "https://nuxt-pdf.lupinum.com/docs/reference/page-sizes",
+      "file": "pages/docs/reference/page-sizes.md",
+      "sha256": "11421ac6d9ead36da06c839022a4be259fcf75f0d6db0d6860cdc5a4acaf2fbf"
+    },
+    {
+      "title": "Primitives",
+      "route": "/docs/reference/primitives",
+      "url": "https://nuxt-pdf.lupinum.com/docs/reference/primitives",
+      "file": "pages/docs/reference/primitives.md",
+      "sha256": "10d1ab379ffd44aae6a1f28123824ab1b8708809bc503a223c27ac31c0e97236"
+    },
+    {
+      "title": "Registry and render result",
+      "route": "/docs/reference/registry",
+      "url": "https://nuxt-pdf.lupinum.com/docs/reference/registry",
+      "file": "pages/docs/reference/registry.md",
+      "sha256": "a37db3268164ecb17745c18f6ef008fd24e8e568d24eed8747bdfcd169e311fb"
+    },
+    {
+      "title": "Standalone build and runtime",
+      "route": "/docs/reference/standalone",
+      "url": "https://nuxt-pdf.lupinum.com/docs/reference/standalone",
+      "file": "pages/docs/reference/standalone.md",
+      "sha256": "cd7b4e5e68c372fb1ca4f02642abad01040d115504f6eb18ff307d94f495cf4d"
+    },
+    {
+      "title": "Styles",
+      "route": "/docs/reference/styles",
+      "url": "https://nuxt-pdf.lupinum.com/docs/reference/styles",
+      "file": "pages/docs/reference/styles.md",
+      "sha256": "b59ef442049b49504b3f0938c89baeff4ebbbe0522d36e18be2ab2a6a32d6eb8"
+    },
+    {
+      "title": "Test utilities",
+      "route": "/docs/reference/test-utilities",
+      "url": "https://nuxt-pdf.lupinum.com/docs/reference/test-utilities",
+      "file": "pages/docs/reference/test-utilities.md",
+      "sha256": "81dc793263f88b0238fcba3717afa4a2b829e8f7bbdb713ec312e2b43b44ca1a"
+    }
+  ]
+}

package/dist/agent/pages/docs/examples/supported-behavior.md

@@ -0,0 +1,75 @@
+---
+title: "Supported behavior and limitations"
+description: "The public compatibility boundary and where to find its executable evidence."
+url: "https://nuxt-pdf.lupinum.com/docs/examples/supported-behavior"
+route: "/docs/examples/supported-behavior"
+locale: "en"
+section: "Documentation"
+collection: "docs"
+source: "ginko-content"
+---
+
+# Supported behavior and limitations
+
+> The public compatibility boundary and where to find its executable evidence.
+
+Nuxt PDF supports the behavior listed in its public guides and reference pages
+against exact pinned layout, font, and serialization packages. It does not claim
+the complete React PDF API or test suite.
+
+## Supported areas
+
+The repository tests these user-facing areas:
+
+- document trees, pagination, flex layout, styles, text, and raster images;
+- local fonts and admitted local or allowlisted remote image sources;
+- metadata, links, notes, bookmarks, and destination page numbers;
+- SVG shapes, gradients, clip paths, transforms, and SVG text;
+- semantic PDF inspection and raster snapshot helpers;
+- production removal of preview routes and preview data;
+- bounded render time, tree size, image admission, page count, and output size.
+
+The detailed support status for scripts and fonts is in
+[Add images and fonts](/raw/docs/guides/images-and-fonts.md). Exact primitive and style
+support belongs to the [reference section](/raw/docs/reference/primitives.md).
+
+## Differences from React PDF
+
+Three behaviors differ where matching the pinned lower engine would produce a
+wrong or unstable public result:
+
+- A table-of-contents destination resolves to the section's first page.
+- Dynamic page text does not inherit a `lineHeight` multiplier. Apply line
+  height to static `PdfText` instead.
+- Explicit zero values keep SVG meaning for fill opacity, stroke width, and
+  supported gradient coordinates.
+
+These differences have geometry or raster regression coverage.
+
+## Outside the current boundary
+
+Nuxt PDF does not claim:
+
+- full React PDF API, hook, browser-helper, or runtime compatibility;
+- Nuxt 3, Node 20, browser rendering, or edge rendering;
+- HTML printing, browser CSS, tables, charts, forms, signing, editing, or PDF
+  merging as built-in features;
+- tagged PDF, PDF/UA, or archival compliance profiles;
+- byte-identical output across operating systems and viewers;
+- authenticated remote requests, custom headers, remote fonts, or SSRF
+  protection beyond the exact-prefix allowlist;
+- SVG image files, SVG markers, or the complete browser SVG model;
+- multi-pass resolution of values other than destination page numbers.
+
+## Evidence record
+
+This page is the public summary. Maintainers and reviewers can inspect:
+
+- [CONFORMANCE.md](https://github.com/lupinum-dev/nuxt-pdf/blob/main/CONFORMANCE.md)
+  for version pins, paired comparisons, tested fixtures, and explicit
+  non-claims;
+- [CONTRACTS.md](https://github.com/lupinum-dev/nuxt-pdf/blob/main/src/runtime/server/engine/CONTRACTS.md)
+  for the renderer's durable engine contracts.
+
+When the documentation and public source disagree, the source is authoritative
+and the documentation needs a correction.

package/dist/agent/pages/docs/examples.md

@@ -0,0 +1,163 @@
+---
+title: "Example gallery"
+description: "Six playground templates and the technique that each template demonstrates."
+url: "https://nuxt-pdf.lupinum.com/docs/examples"
+route: "/docs/examples"
+locale: "en"
+section: "Documentation"
+collection: "docs"
+source: "ginko-content"
+---
+
+# Example gallery
+
+> Six playground templates and the technique that each template demonstrates.
+
+The playground under `playground/pdfs/` ships six complete templates. Each is an
+ordinary `.vue` single-file component discovered by the module, rendered through
+the same registry in development and production, and covered by an end-to-end
+rendering test. Selected visually load-bearing showcases additionally compare
+reviewed raster baselines. Run `pnpm dev` and open `/_pdf` to browse them, or
+read each source alongside the excerpts below.
+
+<info icon="lucide:info">
+`renderPdfSfc` compiles the same nested child-SFC graph as the production Nuxt
+module. The packed-package gate exercises typed child props, a local image, and
+multiple local font faces.
+</info>
+
+## At a glance
+
+| Template | Source | Demonstrates |
+| --- | --- | --- |
+| Invoice | `pdfs/invoice.vue` | Typed props, computed totals, a fixed footer, dynamic page count |
+| Report | `pdfs/report.vue` | `usePdfPageNumbers` table of contents, internal links, bookmarks |
+| Annual report | `pdfs/annual-report.vue` | SVG bar / line / donut charts and tables drawn from Views |
+| Certificate | `pdfs/certificate.vue` | SVG ornament craft with an engraver's border and a seal |
+| E-book | `pdfs/ebook.vue` | `usePdfPageNumbers` with chapter-aware running matter |
+| Menu | `pdfs/menu.vue` | Pure typography, diacritics, dotted leaders, tabular prices |
+
+## E-book with chapter-aware running matter
+
+_The Reed Line_ is a 21-page digest novella. It reads the resolved page map from
+[`usePdfPageNumbers`](/raw/docs/reference/composables.md) twice: once to print a
+Contents page with real page numbers, and once for a running foot that names the
+**current** chapter on every page it repeats onto. The chapter is derived from
+measured pagination, never hard-coded.
+
+```vue [pdfs/ebook.vue]
+const pageNumbers = usePdfPageNumbers()
+
+// Derive the current chapter for any page from the resolved start-page map.
+const chapterAt = (pageNumber: number): Ebook['chapters'][number] => {
+  let current = ebook.chapters[0]!
+  for (const chapter of ebook.chapters) {
+    const start = pageNumbers[chapter.id]
+    if (typeof start === 'number' && start <= pageNumber) current = chapter
+  }
+  return current
+}
+```
+
+The foot is a single `fixed` node whose `:render` closes over `chapterAt`, so one
+callback prints the right chapter and folio on every page:
+
+```vue [pdfs/ebook.vue]
+<PdfText
+  fixed
+  :render="({ pageNumber }) => `${chapterAt(pageNumber).title}   ·   ${pageNumber}`"
+  :style="footStyle"
+/>
+```
+
+## Annual report with SVG charts and View tables
+
+The Fieldnote Studio annual report draws a grouped bar chart, a line chart with a
+gradient area tint, and a donut. It uses the [SVG primitives](/raw/docs/guides/svg-graphics.md),
+with every figure computed from one canonical `YearFigures` source. The donut
+segments come from a pure geometry model and render as a `v-for` of paths:
+
+```vue [pdfs/annual-report.vue]
+<PdfSvg :viewBox="`0 0 ${donut.size} ${donut.size}`" :style="{ width: donut.size, height: donut.size }">
+  <PdfPath
+    v-for="segment in donut.segments"
+    :key="segment.id"
+    :d="segment.d"
+    :fill="segment.fill"
+    :transform="segment.transform"
+  />
+</PdfSvg>
+```
+
+The financial statement has no first-class table primitive. It uses
+`View` rows with right-aligned tabular numerals, hairline rules above totals, and
+parenthesised outflows. The quarter and sector breakdowns provably sum to the
+yearly totals (asserted in the template's test).
+
+## Certificate with SVG ornaments
+
+The certificate is a single A4 landscape page whose decoration is drawn entirely
+from primitives: a double-rule engraver's border with corner diamonds, and a
+concentric seal with two rules, a 32-dot beaded coin edge, a five-point star, and a
+single bronze `RadialGradient` used once.
+
+```vue [pdfs/components/certificate/CertificateSeal.vue]
+<script setup lang="ts">
+// Evenly spaced dots in the band between the two rules.
+const beads = Array.from({ length: 32 }, (_, index) => {
+  const angle = (index / 32) * Math.PI * 2 - Math.PI / 2
+  return { cx: 50 + 45.2 * Math.cos(angle), cy: 50 + 45.2 * Math.sin(angle) }
+})
+</script>
+
+<template>
+  <PdfSvg view-box="0 0 100 100">
+    <PdfDefs>
+      <PdfRadialGradient id="seal-bronze" cx="0.5" cy="0.38" r="0.62">
+        <PdfStop offset="0" stop-color="#E7CC86" />
+        <PdfStop offset="0.55" stop-color="#C9A24B" />
+        <PdfStop offset="1" stop-color="#8A6A2F" />
+      </PdfRadialGradient>
+    </PdfDefs>
+    <PdfCircle
+      v-for="(bead, index) in beads"
+      :key="`bead-${index}`"
+      :cx="bead.cx"
+      :cy="bead.cy"
+      :r="0.75"
+    />
+  </PdfSvg>
+</template>
+```
+
+The decorative layers are absolutely positioned, so a long recipient name wraps
+at spaces to two centered lines and the page can never spill to a second sheet.
+
+## Menu with typography and diacritics
+
+The Gasthaus Alpenrose card is two A5 pages of typography without borders or
+boxes. German dish names carry their umlauts through rendering and extraction,
+and a flex-`1` dotted leader ties each name to a right-aligned tabular price:
+
+```vue [pdfs/menu.vue]
+<PdfView :style="{ alignItems: 'flex-end', flexDirection: 'row' }">
+  <PdfText :style="{ fontFamily: 'Inter', fontSize: 10, fontWeight: 600 }">
+    {{ dish.name }}
+  </PdfText>
+  <PdfView :style="{ flex: 1, marginHorizontal: 7, marginBottom: 2,
+    borderBottomWidth: 0.75, borderBottomStyle: 'dotted', borderBottomColor: leader }" />
+  <PdfText :style="{ fontFamily: 'Inter', fontSize: 10, textAlign: 'right', width: 32 }">
+    {{ formatMenuPrice(dish.price) }}
+  </PdfText>
+</PdfView>
+```
+
+Prices use the locale format. For example, `9.5` becomes `9,50`. The whole card
+is data-driven, so the `winter` scenario swaps every dish and pour without
+touching the template.
+
+<idea icon="lucide:lightbulb">
+Every template ships `sampleData` and at least one named `scenario`, so the dev
+preview at `/_pdf` can render each one without a live route. See
+[define-pdf](/raw/docs/reference/define-pdf.md) for the definition shape.
+</idea>