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

package/CHANGELOG.md

@@ -4,6 +4,12 @@ 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.6
+
+### Patch Changes
+
+- [#68](https://github.com/lupinum-dev/nuxt-pdf/pull/68) [`11d711a`](https://github.com/lupinum-dev/nuxt-pdf/commit/11d711ac83c69d3f468fb7983a15075398fa100e) Thanks [@Mat4m0](https://github.com/Mat4m0)! - Fix `renderPdfSfc()` to use the fonts from the application's Nuxt configuration, including inherited layers, when the test passes no `fonts` option.
+
 ## 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)

package/CONFORMANCE.md

@@ -1,11 +1,11 @@
-# Nuxt PDF 0.4.0-beta.5 conformance
+# Nuxt PDF 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.5 boundary |
+| Layer | Tested 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.5 tests verify:
+The tests verify:
 
 - `PdfDocument`, `PdfPage`, `PdfView`, `PdfText`, `PdfImage`, `PdfLink`, and
   `PdfNote`;
@@ -456,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.5
+## Explicitly not claimed
 
 - Full React PDF component, hook, browser-helper, or test-suite parity.
 - React runtime compatibility or React-shaped dynamic callback results.

package/README.md

@@ -22,7 +22,7 @@
   <a href="https://www.npmjs.com/package/@lupinum/nuxt-pdf"><img src="https://img.shields.io/npm/v/@lupinum/nuxt-pdf?color=00DC82" alt="npm version"></a>
   <a href="https://github.com/lupinum-dev/nuxt-pdf/actions/workflows/ci.yml"><img src="https://github.com/lupinum-dev/nuxt-pdf/actions/workflows/ci.yml/badge.svg" alt="CI status"></a>
   <a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-00DC82" alt="MIT license"></a>
-  <a href="https://discord.gg/RPH6SeA36N"><img src="https://img.shields.io/badge/Discord-18181B?logo=discord" alt="Discord"></a>
+  <a href="https://discord.lupinum.com"><img src="https://img.shields.io/badge/Discord-18181B?logo=discord" alt="Discord"></a>
   <a href="https://deepwiki.com/lupinum-dev/nuxt-pdf"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
 </p>
 
@@ -73,34 +73,6 @@ 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`:
@@ -186,13 +158,58 @@ Nuxt PDF regenerates the typed `#pdf` registry whenever templates change. If
 your editor still shows `#pdf` as untyped, run `nuxt prepare` once to refresh
 the generated types.
 
+## Agent setup
+
+`@lupinum/nuxt-pdf` ships its documentation inside the package for coding
+agents such as Claude Code, Codex and Cursor. The pages match the installed
+version, so an agent does not follow the website for a different version.
+
+To set it up, give your coding agent this task:
+
+```text
+Set up @lupinum/nuxt-pdf for coding agents as described under "Agent setup" in its README.
+```
+
+### Steps for the agent
+
+1. Find `node_modules/@lupinum/nuxt-pdf/dist/agent/AGENTS.md`. Look in the
+   directory of the project that depends on `@lupinum/nuxt-pdf` first, then
+   in its parent directories up to the repository root (workspaces can hoist
+   packages). Read it; it lists the documentation pages.
+2. Add the section below to the project's agent instructions: `AGENTS.md`, or
+   `CLAUDE.md` if the project has only that file. If it has neither, create
+   `AGENTS.md`. Write the path relative to the repository root, through
+   `node_modules/@lupinum/nuxt-pdf` (for example
+   `apps/web/node_modules/@lupinum/nuxt-pdf/...` in a workspace). Never write
+   a resolved path such as `node_modules/.pnpm/...`: it contains the version and
+   breaks after an upgrade. If a section for `@lupinum/nuxt-pdf` already
+   exists, leave it as it is.
+
+   Use the path you found in place of the sample path:
+
+   ```md
+   ## @lupinum/nuxt-pdf
+
+   Before you change code that uses @lupinum/nuxt-pdf, read
+   `node_modules/@lupinum/nuxt-pdf/dist/agent/AGENTS.md` and the pages it
+   lists. They document the installed version. Prefer them over what you
+   remember about this package and over the website.
+   ```
+
+3. Do not copy the documentation into the project and do not install a skill.
+   The section points into the installed package, so it stays correct after
+   every upgrade or downgrade.
+
+If the file does not exist, the installed version has no packaged
+documentation. Read the package README and its TypeScript types instead.
+
 ## Discord
 
 Join the Lupinum OSS community to discuss Nuxt PDF, ask questions, and share
 what you build.
 
 <p align="center">
-  <a href="https://discord.gg/RPH6SeA36N">
+  <a href="https://discord.lupinum.com">
     <picture>
       <source media="(prefers-color-scheme: dark)" srcset="docs/public/discord-dark.svg">
       <source media="(prefers-color-scheme: light)" srcset="docs/public/discord-light.svg">
@@ -262,23 +279,20 @@ pnpm dev
 pnpm verify
 ```
 
-Use `pnpm docs:dev` to run the documentation site. Run `pnpm docs:build` before
-you hand off a documentation change. Use `pnpm release:verify` only for release
-preparation.
+Use `pnpm docs:dev` to run the documentation site. `pnpm verify` runs the same
+checks as CI.
 
-Read [CONTRIBUTING.md](./CONTRIBUTING.md) before you open a pull request.
-Maintainers use [MAINTAINING.md](./MAINTAINING.md) for release and recovery
-procedures.
+Read [CONTRIBUTING.md](.github/CONTRIBUTING.md) before you open a pull request.
 
 ## Support and security
 
 - Read the [documentation](https://nuxt-pdf.lupinum.com).
-- Join the [Lupinum OSS Discord](https://discord.gg/RPH6SeA36N).
-- Open a [bug report](https://github.com/lupinum-dev/nuxt-pdf/issues/new?template=bug.md)
+- Join the [Lupinum OSS Discord](https://discord.lupinum.com).
+- Open a [bug report](https://github.com/lupinum-dev/nuxt-pdf/issues/new?template=bug.yml)
   for a reproducible defect.
-- Open a [feature request](https://github.com/lupinum-dev/nuxt-pdf/issues/new?template=proposal.md)
+- Open a [feature request](https://github.com/lupinum-dev/nuxt-pdf/issues/new?template=feature.yml)
   before you plan a larger change.
-- Follow [SECURITY.md](./SECURITY.md) for a private vulnerability report.
+- Follow [SECURITY.md](.github/SECURITY.md) for a private vulnerability report.
 
 ## License
 

package/dist/agent/AGENTS.md

@@ -1,48 +1,44 @@
-# @lupinum/nuxt-pdf
+# @lupinum/nuxt-pdf 0.4.0-beta.6 documentation
 
-Documentation for installed version 0.4.0-beta.5.
+These pages document the installed version 0.4.0-beta.6. Prefer them over what you
+remember about this package and over the website, which may describe another version.
+Read the pages that match the task before you write code. If they do not answer a question,
+the user can ask in the Lupinum OSS Discord: https://discord.lupinum.com
 
-Read the relevant local pages before changing this package’s integration.
-Project instructions govern architecture, style and permissions.
+> Author and render PDFs with Vue components in Nuxt.
 
-## Start here
+## When to use
 
-- [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
+Use this site to author and render PDF documents with Nuxt PDF.
 
-## Find a page
+## Documentation
 
-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
+- [Overview](./pages/docs/getting-started.md): Decide whether Nuxt PDF fits the document you need to create.
+- [Install Nuxt PDF](./pages/docs/getting-started/installation.md): Add server-side PDF rendering to an existing Nuxt 4 application.
+- [Render your first PDF](./pages/docs/getting-started/quickstart.md): Create, download, and preview a small invoice in a Nuxt application.
+- [Templates and the registry](./pages/docs/learn/templates-and-registry.md): How files under pdfs become typed server-side render functions.
+- [The document tree](./pages/docs/learn/document-tree.md): PDF primitives, valid nesting, Vue composition, and dynamic text.
+- [Styling and layout](./pages/docs/learn/styling-and-layout.md): The PDF style model, flex layout, units, inheritance, and shared geometry.
+- [Runtime and data loading](./pages/docs/learn/runtime-and-data.md): Where PDF templates execute and how data enters a render.
+- [Build reusable document components](./pages/docs/guides/reusable-components.md): Organize repeated PDF sections without creating a second component system.
+- [Add images and fonts](./pages/docs/guides/images-and-fonts.md): Bundle local PNG, JPEG, TTF, OTF, and WOFF2 resources with a PDF template.
+- [Configure remote images](./pages/docs/guides/remote-images.md): Admit specific HTTPS image paths and understand the request boundary.
+- [Add links, bookmarks, and a table of contents](./pages/docs/guides/contents-links-bookmarks.md): usePdfPageNumbers, the multi-pass layout loop, convergence and maxPasses, internal links, and the bookmark outline.
+- [Draw SVG graphics](./pages/docs/guides/svg-graphics.md): The SVG primitive set, direct presentation props, scoped definitions, SVG text, and the supported numeric boundary.
+- [Test a PDF](./pages/docs/guides/testing.md): Assert against your own templates with a real render using @lupinum/nuxt-pdf/test, plus a realistic Vitest example.
+- [Diagnose render failures](./pages/docs/guides/errors-and-debugging.md): Use template attribution, preview diagnostics, and exact error messages to recover from a failed render.
+- [Deploy and operate](./pages/docs/guides/deployment.md): Size, cache, queue, and monitor PDF rendering on a tested Node target.
+- [Production recipes](./pages/docs/guides/recipes.md): Copyable Vue patterns for invoices, statements, reports, repeating matter, and payment QR codes.
+- [Render outside Nitro](./pages/docs/guides/standalone-node.md): Compile PDF templates once and render the generated registry in a Node worker.
+- [Module options](./pages/docs/reference/module-options.md): Build-time configuration for registered fonts, remote images, and render budgets.
+- [definePdf](./pages/docs/reference/define-pdf.md): The compile-time definition for render metadata, development preview data, and the multi-pass limit.
+- [Registry and render result](./pages/docs/reference/registry.md): The typed #pdf server module, runtime dispatch, and completed render conversions.
+- [Primitives](./pages/docs/reference/primitives.md): Prop tables for every document and SVG primitive, drawn from the shipped type definitions.
+- [Styles](./pages/docs/reference/styles.md): Accepted style keys, values, units, inheritance, and primitive support.
+- [Page sizes](./pages/docs/reference/page-sizes.md): Named and custom page dimensions accepted by PdfPage.
+- [Composables](./pages/docs/reference/composables.md): The auto-imported usePdfPageNumbers map that activates multi-pass layout.
+- [Errors and limits](./pages/docs/reference/errors-and-limits.md): Error classes, exact codes, render-budget defaults, and when each failure occurs.
+- [Test utilities](./pages/docs/reference/test-utilities.md): The render, parse, assert, and snapshot exports of @lupinum/nuxt-pdf/test.
+- [Standalone build and runtime](./pages/docs/reference/standalone.md): Production registry generation and Node runtime exports outside Nitro.
+- [Example gallery](./pages/docs/examples.md): Six playground templates and the technique that each template demonstrates.
+- [Supported behavior and limitations](./pages/docs/examples/supported-behavior.md): The public compatibility boundary and where to find its executable evidence.

package/dist/agent/pages/docs/getting-started/installation.md

@@ -42,30 +42,15 @@ export default defineNuxtConfig({
 })
 ```
 
-### Use a coding agent
+### Set up your 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:
+Nuxt PDF ships its documentation inside the package, so coding agents read the
+pages that match the installed version. Give your coding agent this task:
 
 ```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.
+Set up @lupinum/nuxt-pdf for coding agents as described under "Agent setup" in its README.
 ```
 
-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.
-
 The module now discovers Vue templates under `pdfs/`, generates the typed
 server-only `#pdf` registry, and adds the `/_pdf` development preview.
 

package/dist/agent/pages/docs/getting-started.md

@@ -59,3 +59,5 @@ contains the maintainer-grade evidence.
 
 <card title="Render your first PDF" description="Create and download a small invoice." icon="lucide:rocket" to="/docs/getting-started/quickstart" />
 </cards>
+
+Questions? Ask in the [Lupinum OSS Discord](https://discord.lupinum.com).

package/dist/agent/pages/docs/reference/test-utilities.md

@@ -36,9 +36,7 @@ attribution are registry internals and are not public test configuration.
 ## renderPdfSfc
 
 ```ts
-const rendered = await renderPdfSfc('./pdfs/invoice.vue', props, {
-  fonts: [{ family: 'Invoice Sans', src: 'InvoiceSans-Regular.ttf' }],
-})
+const rendered = await renderPdfSfc('./pdfs/invoice.vue', props)
 ```
 
 Compiles a real template and its nested child SFCs with the production
@@ -48,6 +46,12 @@ the application root and template identity are inferred from the `pdfs/*.vue`
 path. `loadPdfSfc` exposes only the compile step when a test needs the Vue
 component separately.
 
+When `fonts` is omitted, the helper reads `pdf.fonts` from the application's
+Nuxt configuration, including its layers. It does not start Nuxt modules or
+load dotenv files. Explicit `fonts` replaces that list; pass `fonts: []` for
+built-in fonts only. Invalid configured fonts fail the test. The helper still
+takes `remote` and `limits` explicitly.
+
 ## parsePdf
 
 ```ts

package/dist/module.json

@@ -1,6 +1,6 @@
 {
   "name": "@lupinum/nuxt-pdf",
-  "version": "0.4.0-beta.5",
+  "version": "0.4.0-beta.6",
   "configKey": "pdf",
   "docs": "https://nuxt-pdf.lupinum.com",
   "compatibility": {

package/dist/module.mjs

@@ -16,7 +16,7 @@ import 'unimport';
 import '../dist/runtime/shared/template.js';
 import '../dist/runtime/server/assets/resolve-asset.js';
 
-const version = "0.4.0-beta.5";
+const version = "0.4.0-beta.6";
 
 const existingDirectories = async (directories) => {
   const result = [];

package/dist/test.mjs

@@ -10,6 +10,7 @@ import { mkdir, writeFile, rm, readFile, readdir } from 'node:fs/promises';
 import { resolve, dirname, join, relative, basename } from 'node:path';
 import { pathToFileURL, fileURLToPath } from 'node:url';
 import { build } from 'esbuild';
+import { loadNuxtConfig } from '@nuxt/kit';
 import { t as templateKeyFromRelativePath, a as discoverPdfImageFiles, b as bundlePdfFonts, c as compilePdfSfc } from './shared/nuxt-pdf.C-E8MM_K.mjs';
 import { pdfImageFormatFromKey } from '../dist/runtime/server/assets/resolve-asset.js';
 import '@vue/compiler-sfc';
@@ -571,10 +572,21 @@ async function renderPdfSfc(filename, props, options = {}) {
     throw new Error(`PDF SFC ${JSON.stringify(entry)} must be a template directly inside pdfs/ or one of its feature directories.`);
   }
   const normalizedLimits = normalizePdfLimits(options.limits);
+  const config = options.fonts === void 0 ? await loadNuxtConfig({ cwd: rootDir, dotenv: false, globalRc: false }) : void 0;
+  const pdfConfig = config && "pdf" in config ? config.pdf : void 0;
+  if (pdfConfig !== void 0 && (typeof pdfConfig !== "object" || pdfConfig === null || Array.isArray(pdfConfig))) {
+    throw new TypeError("pdf configuration must be an object.");
+  }
+  const configuredFonts = pdfConfig && "fonts" in pdfConfig ? pdfConfig.fonts : void 0;
+  const declaredFonts = options.fonts ?? (configuredFonts === void 0 ? [] : configuredFonts);
+  if (!Array.isArray(declaredFonts)) {
+    throw new TypeError("pdf.fonts must be an array of local font declarations.");
+  }
+  const fontRoots = (config?._layers.map((layer) => layer.config.rootDir || layer.cwd) ?? [rootDir]).map((directory) => join(directory, "pdfs", "fonts")).filter((directory) => existsSync(directory));
   const [component, imageFiles, fonts] = await Promise.all([
     loadPdfSfc(entry),
     discoverPdfImageFiles([{ name: "test", rootDir }]),
-    bundlePdfFonts(options.fonts ?? [], { fontRoots: [join(rootDir, "pdfs", "fonts")] })
+    bundlePdfFonts(declaredFonts, { fontRoots })
   ]);
   const assets = Object.fromEntries(imageFiles.map((image) => [
     image.key,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lupinum/nuxt-pdf",
-  "version": "0.4.0-beta.5",
+  "version": "0.4.0-beta.6",
   "description": "Author and render PDFs with Vue components in Nuxt",
   "keywords": [
     "nuxt",
@@ -19,7 +19,6 @@
   },
   "author": "Lupinum OG <info@lupinum.com> (https://lupinum.com)",
   "license": "MIT",
-  "packageManager": "pnpm@11.21.0",
   "type": "module",
   "sideEffects": false,
   "exports": {
@@ -56,51 +55,6 @@
   "engines": {
     "node": "^22.14.0 || ^24.0.0 || ^26.0.0"
   },
-  "scripts": {
-    "prepack": "pnpm docs:build && pnpm docs:package",
-    "prepublishOnly": "node scripts/block-source-publish.mjs",
-    "dev": "npm run dev:prepare && nuxt dev playground",
-    "dev:build": "nuxt build playground",
-    "dev:prepare": "nuxt-module-build build --stub && nuxt-module-build prepare && nuxt prepare playground",
-    "build": "nuxt prepare && nuxt-module-build build",
-    "api:write": "node scripts/check-api-report.mjs --write",
-    "changelog": "changelogen --no-output",
-    "docs:build": "pnpm docs:theme && pnpm build && pnpm --dir docs build",
-    "docs:build:vercel": "node scripts/build-docs-vercel.mjs",
-    "docs:dev": "pnpm --dir docs dev",
-    "docs:onboarding": "node scripts/sync-consumer-onboarding.mjs --write",
-    "docs:package": "node scripts/build-agent-docs.mjs",
-    "docs:theme": "node scripts/check-docs-theme.mjs",
-    "format": "eslint . --fix",
-    "format:check": "node scripts/sync-consumer-onboarding.mjs && eslint .",
-    "lint": "node scripts/sync-consumer-onboarding.mjs && eslint .",
-    "test": "pnpm test:prepare && vitest run",
-    "test:api": "node scripts/check-api-report.mjs",
-    "release:notes": "node scripts/write-release-notes.mjs",
-    "release:pack": "pnpm docs:build && pnpm docs:package && node scripts/check-release-artifact.mjs release-artifacts",
-    "release:prepare": "changelogen --bump --prerelease beta --clean",
-    "release:verify": "pnpm check:dependencies && pnpm audit:all && pnpm check:source && pnpm docs:build && pnpm docs:package && node scripts/check-release-artifact.mjs release-artifacts",
-    "test:artifact": "pnpm docs:build && pnpm docs:package && node scripts/check-release-artifact.mjs",
-    "test:dependencies": "node scripts/check-production-dependencies.mjs",
-    "test:docs": "node scripts/check-documentation.mjs && pnpm --dir docs check",
-    "test:package": "node scripts/check-package.mjs",
-    "test:performance": "node --expose-gc ./node_modules/vitest/vitest.mjs run --config vitest.performance.config.ts",
-    "test:prepare": "pnpm dev:prepare && nuxt prepare test/fixtures/layers",
-    "test:production": "pnpm build && vitest run --config vitest.production.config.ts",
-    "test:quickstart": "node scripts/test-package-quickstart.mjs",
-    "test:raster": "vitest run --config vitest.raster.config.ts",
-    "test:version-headings": "node scripts/check-version-headings.mjs",
-    "test:workflows": "node scripts/check-workflow-policy.mjs && node scripts/test-npm-recovery.mjs && node scripts/test-release-recovery.mjs",
-    "check:vercel": "node scripts/check-vercel-config.mjs",
-    "test:serverless": "vitest run --config vitest.serverless.config.ts",
-    "test:watch": "vitest watch",
-    "typecheck": "pnpm test:prepare && nuxt prepare && vue-tsc --noEmit && nuxt prepare test/fixtures/basic && vue-tsc --noEmit -p test/fixtures/basic/tsconfig.json && pnpm --dir playground exec vue-tsc --noEmit",
-    "audit:all": "pnpm audit",
-    "check:dependencies": "node scripts/check-dependency-policy.mjs",
-    "verify": "pnpm check:dependencies && pnpm audit:all && pnpm check",
-    "check": "pnpm check:source && pnpm test:artifact",
-    "check:source": "pnpm format:check && pnpm check:vercel && pnpm typecheck && pnpm test:docs && pnpm test:version-headings && pnpm test:workflows && pnpm test:dependencies && pnpm test && pnpm test:production && pnpm test:serverless && pnpm build && pnpm test:api && pnpm dev:build"
-  },
   "dependencies": {
     "@jridgewell/remapping": "2.3.5",
     "@nuxt/kit": "^4.5.2",
@@ -133,6 +87,8 @@
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
+    "@changesets/changelog-github": "1.0.1",
+    "@changesets/cli": "3.0.3",
     "@jridgewell/trace-mapping": "0.3.31",
     "@napi-rs/canvas": "0.1.97",
     "@nuxt/devtools": "^3.3.1",
@@ -143,7 +99,6 @@
     "@react-pdf/renderer": "4.5.1",
     "@types/node": "26.1.1",
     "@types/react": "19.2.14",
-    "changelogen": "0.6.2",
     "eslint": "^10.4.1",
     "nuxt": "^4.5.2",
     "pdfjs-dist": "6.2.108",
@@ -154,5 +109,26 @@
     "vitest": "^4.1.8",
     "vue": "3.5.42",
     "yaml": "2.9.0"
+  },
+  "scripts": {
+    "dev": "pnpm dev:prepare && nuxt dev playground",
+    "dev:prepare": "nuxt-module-build build --stub && nuxt-module-build prepare && nuxt prepare playground",
+    "build": "nuxt-module-build prepare && nuxt-module-build build && pnpm docs:build && node scripts/agent-docs.mjs && publint",
+    "lint": "eslint . && node scripts/lint-changesets.mjs",
+    "format": "eslint . --fix",
+    "typecheck": "pnpm test:prepare && nuxt prepare && vue-tsc --noEmit && nuxt prepare test/fixtures/basic && vue-tsc --noEmit -p test/fixtures/basic/tsconfig.json && pnpm --dir playground exec vue-tsc --noEmit",
+    "test": "pnpm test:prepare && vitest run",
+    "test:prepare": "pnpm dev:prepare && nuxt prepare test/fixtures/layers",
+    "test:production": "nuxt-module-build prepare && nuxt-module-build build && vitest run --config vitest.production.config.ts && vitest run --config vitest.serverless.config.ts && nuxt build playground",
+    "test:raster": "vitest run --config vitest.raster.config.ts",
+    "test:performance": "node --expose-gc ./node_modules/vitest/vitest.mjs run --config vitest.performance.config.ts",
+    "test:docs": "node scripts/check-docs-snippets.mjs && node scripts/check-docs-contracts.mjs && pnpm --dir docs check",
+    "test:api": "node scripts/check-api-report.mjs",
+    "test:packed": "node scripts/check-package.mjs && node scripts/test-package-quickstart.mjs",
+    "api:write": "node scripts/check-api-report.mjs --write",
+    "docs:dev": "pnpm --dir docs dev",
+    "docs:build": "nuxt-module-build prepare && pnpm --dir docs build",
+    "verify": "pnpm lint && pnpm typecheck && pnpm test:docs && pnpm test && pnpm test:production && pnpm build && pnpm test:api && pnpm test:packed && node scripts/audit-deps.mjs",
+    "changeset": "changeset"
   }
-}
+}

package/dist/agent/manifest.json

@@ -1,215 +0,0 @@
-{
-  "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"
-    }
-  ]
-}