@lupinum/nuxt-pdf 0.3.1 → 0.4.0-beta.2

package/CHANGELOG.md

@@ -4,6 +4,54 @@ 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.2 - 2026-08-27
+
+[compare changes](https://github.com/lupinum-dev/nuxt-pdf/compare/v0.4.0-beta.1...v0.4.0-beta.2)
+
+### Added
+
+- **fonts:** Support WOFF2 assets ([ad50390](https://github.com/lupinum-dev/nuxt-pdf/commit/ad50390))
+- **diagnostics:** Explain unbreakable layout overflow ([a5ff0b7](https://github.com/lupinum-dev/nuxt-pdf/commit/a5ff0b7))
+
+### Fixed
+
+- **ci:** Harden on-demand Vercel reporting ([#35](https://github.com/lupinum-dev/nuxt-pdf/pull/35))
+- **release:** Repair from certified source evidence ([#36](https://github.com/lupinum-dev/nuxt-pdf/pull/36))
+- **release:** Separate publication from repair ([#37](https://github.com/lupinum-dev/nuxt-pdf/pull/37))
+- **types:** Expose PDF authoring globals ([c427310](https://github.com/lupinum-dev/nuxt-pdf/commit/c427310))
+
+### CI
+
+- **vercel:** Cut library preview build usage ([#34](https://github.com/lupinum-dev/nuxt-pdf/pull/34))
+
+## 0.4.0-beta.1 - 2026-08-22
+
+### Added
+
+- Add strict PDF primitive stubs so invalid props fail during authoring instead
+  of reaching the renderer.
+- Add safer local and remote image admission, configured-font validation, and
+  clearer development preview diagnostics.
+- Add source-derived documentation checks for primitive props, error codes,
+  page sizes, render limits, public exports, routes, and complete examples.
+
+### Changed
+
+- Rebuild the documentation around a first-render tutorial, focused task
+  guides, complete API reference, production guidance, and compatibility
+  evidence.
+- Expand the playground with reusable invoice components, production document
+  recipes, and stronger preview scenarios.
+- Refresh the documentation design with stable Ginko packages and the Nuxt
+  visual language.
+
+### Fixed
+
+- Keep release workflows tied to the exact verified artifact and independent
+  of unnecessary GitHub tokens.
+- Build documentation when no previous Vercel deployment baseline exists.
+- Prepare Nuxt-generated types before clean package and documentation builds.
+
 ## 0.3.1 - 2026-08-13
 
 ### Fixed

package/CONFORMANCE.md

@@ -1,11 +1,11 @@
-# Nuxt PDF 0.3.1 conformance
+# Nuxt PDF 0.4.0-beta.2 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.3.1 boundary |
+| Layer | 0.4.0-beta.2 boundary |
 |---|---|
 | Node.js | `^22.14.0`, `^24.0.0`, or `^26.0.0` |
 | Nuxt | `^4.4.8` |
@@ -158,7 +158,9 @@ claimed.
 **Images** (`test/corpus/images.test.ts`):
 
 - JPEG file paths, base64 `data:` URLs, and `{ data, format }` buffer sources all
-  decode and render;
+  decode in the lower-engine paired fixture. The public resource boundary
+  accepts bundled paths, admitted byte sources, and allowlisted HTTPS images;
+  it blocks `data:` URL strings on every public render path;
 - explicit width+height, single-dimension aspect scaling, and percent width
   against the page content box size the laid-out box (reviewed baseline);
 - `objectFit` `contain` letterboxes and `cover` crops while the box stays fixed
@@ -202,7 +204,7 @@ checking.
 
 ### Vue and Nuxt authoring
 
-The 0.3.1 tests verify:
+The 0.4.0-beta.2 tests verify:
 
 - `PdfDocument`, `PdfPage`, `PdfView`, `PdfText`, `PdfImage`, `PdfLink`, and
   `PdfNote`;
@@ -215,8 +217,9 @@ The 0.3.1 tests verify:
 - framework-owned `PdfStyle` and exact primitive prop types checked through a
   real Vue SFC, plus closed per-primitive runtime allowlists that reject
   unknown, DOM/event, removed, and wrong-host props without echoing values;
-- exactly one `src`/`source` for `PdfImage`, exactly one `href`/`src` for
-  `PdfLink`, and context-specific page-flow/SVG `PdfText` invariants;
+- a required `src` for `PdfImage`, a required `href` for `PdfLink` (an `href`
+  starting with `#` is an internal destination), and context-specific
+  page-flow/SVG `PdfText` invariants;
 - one completed render held behind immutable byte, buffer, and `Response`
   conversions, with exact frozen resolved metadata and one frozen, content-free
   diagnostics object shared by the public result and development preview; the
@@ -287,7 +290,7 @@ and exposes it through one composable and existing props. The tested boundary:
   `PDF_LIMIT_EXCEEDED` `NuxtPdfError` attributed to the template key and file
   through the same boundary as every other render failure.
 - **Named destinations resolve to a section's first page.** A node's `id` becomes
-  a named destination; a `PdfLink` `src="#id"` jumps to it. When the id sits on a
+  a named destination; a `PdfLink` `href="#id"` jumps to it. When the id sits on a
   node that spans a page boundary, both the printed number and the jump target
   resolve to the section's **first** page (a deliberate divergence from React PDF,
   whose last-writer-wins destination table points at the last page). This holds on
@@ -317,11 +320,13 @@ and exposes it through one composable and existing props. The tested boundary:
 
 ### Local resources
 
-The module validates and embeds configured resources during the Nuxt build.
-The tested boundary includes:
+The module validates configured resources during the Nuxt build. Production
+builds embed validated image bytes in the server bundle; development builds
+point at the source files and re-read them per render, so an edited image
+shows up without a restart. The tested boundary includes:
 
 - PNG and JPEG extension/signature validation and source byte limits;
-- TTF and OTF signature/extension/SFNT table-directory validation,
+- 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;
 - rejection of absolute paths, traversal, missing assets, ambiguous sources,
@@ -432,7 +437,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.3.1
+## Explicitly not claimed in 0.4.0-beta.2
 
 - Full React PDF component, hook, browser-helper, or test-suite parity.
 - React runtime compatibility or React-shaped dynamic callback results.
@@ -446,7 +451,7 @@ failure messages, in `test/test-utils-public.test.ts`.
 - Nuxt 3, Node 20, or versions outside the table above.
 - Authenticated remote fetches, request headers/bodies, credentialed requests,
   proxies, or private-IP/DNS-rebinding protection. Opt-in allowlisted remote
-  images and fonts are claimed above under "Opt-in remote resources".
+  images are claimed above. Remote fonts are not supported.
 - SVG image files (as an image source), SVG `Marker`, alternate gradient
   coordinate systems/transforms/inheritance, and `preserveAspectRatio` modes.
   Radial-gradient inner radius (`fr`) is also absent because the pinned renderer

package/README.md

@@ -1,21 +1,33 @@
 <p align="center">
-  <img src="docs/public/logo.svg" width="128" alt="Nuxt PDF">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="docs/public/icon-dark.svg">
+    <source media="(prefers-color-scheme: light)" srcset="docs/public/icon-light.svg">
+    <img src="docs/public/icon-light.svg" width="128" alt="Nuxt PDF icon">
+  </picture>
 </p>
 
-<h1 align="center">Nuxt PDF</h1>
+<h1 align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="docs/public/wordmark-dark.svg">
+    <source media="(prefers-color-scheme: light)" srcset="docs/public/wordmark-light.svg">
+    <img src="docs/public/wordmark-light.svg" width="256" alt="Nuxt PDF">
+  </picture>
+</h1>
 
 <p align="center">
   Author and render PDFs with Vue components in Nuxt.
 </p>
 
 <p align="center">
-  <a href="https://www.npmjs.com/package/@lupinum/nuxt-pdf"><img src="https://img.shields.io/npm/v/@lupinum/nuxt-pdf?color=315d3b" alt="npm version"></a>
+  <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-315d3b" alt="MIT license"></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://deepwiki.com/lupinum-dev/nuxt-pdf"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
 </p>
 
 > [!IMPORTANT]
-> Nuxt PDF is an external alpha. Its tested behavior is stable within each
+> Nuxt PDF is in public beta. Its tested behavior is stable within each
 > release, but a minor release can contain documented breaking changes before
 > version 1.0.
 
@@ -65,7 +77,7 @@ export default defineNuxtConfig({
 
 Create `pdfs/invoice.vue`:
 
-```vue
+```vue [pdfs/invoice.vue]
 <script setup lang="ts">
 type InvoiceProps = {
   invoice: {
@@ -80,6 +92,7 @@ const props = defineProps<InvoiceProps>()
 definePdf<InvoiceProps>({
   title: ({ invoice }) => `Invoice ${invoice.number}`,
   filename: ({ invoice }) => `invoice-${invoice.number}.pdf`,
+  language: 'en-GB',
   sampleData: {
     invoice: {
       customer: 'Ada Lovelace',
@@ -123,14 +136,42 @@ export default defineEventHandler(async () => {
 })
 ```
 
-Start Nuxt. Open these development routes:
+Start Nuxt:
+
+```bash
+pnpm dev
+```
+
+Download the PDF from a second terminal:
+
+```bash
+curl -o invoice.pdf http://localhost:3000/api/invoice
+```
+
+Open these development routes:
 
 - `/_pdf` lists the discovered templates.
 - `/_pdf/invoice` shows the document preview.
 - `/api/invoice` returns the production-style PDF response.
 
-Restart `nuxt dev` after you first enable the module. This action generates
-the typed `#pdf` registry.
+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.
+
+## 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">
+    <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">
+      <img src="docs/public/discord-light.svg" width="500" alt="Join the Lupinum OSS Discord">
+    </picture>
+  </a>
+</p>
 
 ## How it works
 
@@ -181,6 +222,10 @@ assets, links, bookmarks, tables of contents, testing, and the complete API
 reference. Read [CONFORMANCE.md](./CONFORMANCE.md) for the exact tested behavior
 and known limitations.
 
+Coding agents should start with
+[`/llms.txt`](https://nuxt-pdf.lupinum.com/llms.txt). It links to concise raw
+Markdown for common tasks, reference pages, errors, and compatibility evidence.
+
 ## Contributing and development
 
 ```bash

package/dist/module.json

@@ -1,10 +1,11 @@
 {
-  "name": "nuxt-pdf",
+  "name": "@lupinum/nuxt-pdf",
+  "version": "0.4.0-beta.2",
   "configKey": "pdf",
+  "docs": "https://nuxt-pdf.lupinum.com",
   "compatibility": {
-    "nuxt": "^4.4.8"
+    "nuxt": ">=4.4.8"
   },
-  "version": "0.3.1",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "unknown"

package/dist/module.mjs

@@ -1,11 +1,12 @@
 import { stat } from 'node:fs/promises';
-import { join, isAbsolute, resolve } from 'node:path';
-import { defineNuxtModule, createResolver, getLayerDirectories, createIsIgnored, addServerTemplate, addTemplate, addImports, addTypeTemplate, addServerHandler } from '@nuxt/kit';
-import { d as discoverPdfTemplates, a as discoverPdfComponentFiles, b as discoverPdfImageFiles, c as bundlePdfFonts, e as createPdfSfcPlugin, f as classifyPdfWatchEvent } from './shared/nuxt-pdf.D2ZziYn4.mjs';
 import { Buffer } from 'node:buffer';
+import { join, isAbsolute, resolve, relative } from 'node:path';
+import { defineNuxtModule, createResolver, getLayerDirectories, createIsIgnored, addServerTemplate, addTemplate, addImports, addTypeTemplate, logger, addServerHandler, addComponent } from '@nuxt/kit';
 import { joinURL } from 'ufo';
+import { d as discoverPdfTemplates, a as discoverPdfComponentFiles, b as discoverPdfImageFiles, c as bundlePdfFonts, e as createPdfSfcPlugin, f as classifyPdfWatchEvent } from './shared/nuxt-pdf.D0zmsct0.mjs';
+import { pdfImageFormatFromKey, loadPdfImageAsset } from '../dist/runtime/server/assets/resolve-asset.js';
+import { PDF_STUB_NAMES } from '../dist/runtime/components/stubs.js';
 import { normalizeRemoteAssetPolicy } from '../dist/runtime/server/assets/remote.js';
-import { loadPdfImageAsset } from '../dist/runtime/server/assets/resolve-asset.js';
 import { normalizePdfLimits, DEFAULT_PDF_RENDER_LIMITS } from '../dist/runtime/server/render-limits.js';
 import 'node:fs';
 import '@vue/compiler-sfc';
@@ -14,6 +15,8 @@ import 'esbuild';
 import 'unimport';
 import '../dist/runtime/shared/template.js';
 
+const version = "0.4.0-beta.2";
+
 const compareText = (left, right) => {
   if (left < right) return -1;
   if (left > right) return 1;
@@ -31,14 +34,20 @@ const runtimeOptionsSource = (options) => {
   const assets = options.assets ?? [];
   const fonts = options.fonts ?? [];
   const { remote, limits } = options;
+  for (const asset of assets) {
+    if (asset.root !== void 0 === (asset.dataB64 !== void 0)) {
+      throw new TypeError(
+        `PDF image asset "${asset.key}" must declare exactly one of root or dataB64.`
+      );
+    }
+  }
   if (assets.length === 0 && fonts.length === 0 && !remote && !limits) return [];
   const lines = ["", "const __pdfRuntimeOptions = Object.freeze({"];
   if (assets.length > 0) {
     lines.push("  assets: Object.freeze({");
     for (const asset of assets) {
-      lines.push(
-        `    ${quote$1(asset.key)}: Object.freeze({ data: __pdfBuffer.from(${quote$1(Buffer.from(asset.data).toString("base64"))}, 'base64'), format: ${quote$1(asset.format)} }),`
-      );
+      const entry = asset.root !== void 0 ? `{ format: ${quote$1(asset.format)}, root: ${quote$1(asset.root)} }` : `{ dataB64: ${quote$1(asset.dataB64 ?? "")}, format: ${quote$1(asset.format)} }`;
+      lines.push(`    ${quote$1(asset.key)}: Object.freeze(${entry}),`);
     }
     lines.push("  }),");
   }
@@ -86,9 +95,6 @@ const generatePdfRuntimeRegistry = (templates, options) => {
   const lines = [
     `import { ${runtimeImports} } from ${quote$1(options.runtimeImport)}`
   ];
-  if ((options.assets?.length ?? 0) > 0) {
-    lines.push("import { Buffer as __pdfBuffer } from 'node:buffer'");
-  }
   ordered.forEach((template, index) => {
     lines.push(
       `import __pdfTemplate${index} from ${quote$1(importPath(template.filePath))}`
@@ -188,7 +194,12 @@ const existingDirectories = async (directories) => {
   }
   return result;
 };
-const generateAuthoringTypes = (componentsImport) => `declare module 'vue' {
+const generateAuthoringTypes = (componentsImport, composablesImport, definePdfImport) => `declare global {
+  const definePdf: typeof import(${quote(definePdfImport)})['definePdf']
+  const usePdfPageNumbers: typeof import(${quote(composablesImport)})['usePdfPageNumbers']
+}
+
+declare module 'vue' {
   interface GlobalComponents {
     PdfDocument: typeof import(${quote(componentsImport)})['PdfDocument']
     PdfImage: typeof import(${quote(componentsImport)})['PdfImage']
@@ -219,10 +230,12 @@ export {}
 `;
 const module$1 = defineNuxtModule({
   meta: {
-    name: "nuxt-pdf",
+    name: "@lupinum/nuxt-pdf",
+    version: version,
     configKey: "pdf",
+    docs: "https://nuxt-pdf.lupinum.com",
     compatibility: {
-      nuxt: "^4.4.8"
+      nuxt: ">=4.4.8"
     }
   },
   defaults: {
@@ -248,13 +261,24 @@ const module$1 = defineNuxtModule({
     const limits = normalizePdfLimits(options.limits);
     const resolvedLimits = limits ?? DEFAULT_PDF_RENDER_LIMITS;
     const imageFiles = await discoverPdfImageFiles(layers, isIgnored);
-    const assets = await Promise.all(imageFiles.map(
-      (image) => loadPdfImageAsset(image.key, {
-        roots: [image.rootDir],
-        maxBytes: resolvedLimits.maxImageBytes,
-        maxPixels: resolvedLimits.maxImagePixels
-      })
-    ));
+    const assetEntries = [];
+    for (const image of imageFiles) {
+      const format = pdfImageFormatFromKey(image.key);
+      if (nuxt.options.dev) {
+        assetEntries.push({ format, key: image.key, root: image.rootDir });
+      } else {
+        const loaded = await loadPdfImageAsset(image.key, {
+          roots: [image.rootDir],
+          maxBytes: resolvedLimits.maxImageBytes,
+          maxPixels: resolvedLimits.maxImagePixels
+        });
+        assetEntries.push({
+          dataB64: Buffer.from(loaded.data).toString("base64"),
+          format,
+          key: image.key
+        });
+      }
+    }
     const fontRoots = await existingDirectories(
       layers.map((layer) => join(layer.rootDir, "pdfs", "fonts"))
     );
@@ -272,7 +296,7 @@ const module$1 = defineNuxtModule({
     addServerTemplate({
       filename: "#pdf",
       getContents: () => generatePdfRuntimeRegistry(templates, {
-        assets,
+        assets: assetEntries,
         development: nuxt.options.dev,
         fonts,
         remote,
@@ -312,7 +336,9 @@ const module$1 = defineNuxtModule({
     addTypeTemplate({
       filename: "types/nuxt-pdf-authoring.d.ts",
       getContents: () => generateAuthoringTypes(
-        componentsImport
+        componentsImport,
+        composablesImport,
+        definePdfImport
       ),
       write: true
     }, { nitro: true, node: true, nuxt: true });
@@ -342,6 +368,9 @@ const module$1 = defineNuxtModule({
           isIgnored
         );
         if (action === "restart") {
+          logger.info(
+            `nuxt-pdf: ${relative(nuxt.options.rootDir, absolutePath) || absolutePath} changed; restarting to rebuild the PDF registry\u2026`
+          );
           await nuxt.callHook("restart");
           return;
         }
@@ -361,6 +390,21 @@ const module$1 = defineNuxtModule({
       });
       addServerHandler({ route: "/_pdf", handler: previewHandler });
       addServerHandler({ route: "/_pdf/**", handler: previewHandler });
+      nuxt.hook("devtools:customTabs", (tabs) => {
+        tabs.push({
+          name: "nuxt-pdf",
+          title: "PDF",
+          icon: "i-lucide-file-text",
+          view: { type: "iframe", src: joinURL(nuxt.options.app.baseURL || "/", "_pdf") }
+        });
+      });
+      for (const name of PDF_STUB_NAMES) {
+        addComponent({
+          name,
+          export: name,
+          filePath: resolver.resolve("./runtime/components/stubs")
+        });
+      }
     }
   }
 });

package/dist/runtime/components/_props.d.ts

@@ -71,22 +71,16 @@ export type PdfImageSource = string | Uint8Array | ArrayBuffer | {
     uri: string;
     format?: 'png' | 'jpg';
 };
-type PdfImageSourceProp = {
+export type PdfImageProps = PdfBaseProps & PdfBookmarkProp & {
+    /** Local bundled path, remote allowlisted URL, or inline bytes. */
     src: PdfImageSource;
-    source?: never;
-} | {
-    src?: never;
-    source: PdfImageSource;
 };
-export type PdfImageProps = PdfBaseProps & PdfBookmarkProp & PdfImageSourceProp;
-type PdfLinkTarget = {
+export type PdfLinkProps = PdfBaseProps & {
+    /**
+     * Link target. A string starting with `#` jumps to the element whose `id`
+     * matches the rest of the string; every other value opens as an external URL.
+     */
     href: string;
-    src?: never;
-} | {
-    href?: never;
-    src: string;
-};
-export type PdfLinkProps = PdfBaseProps & PdfLinkTarget & {
     wrap?: boolean;
     hitSlop?: {
         top?: number;

package/dist/runtime/components/stubs.d.ts

@@ -0,0 +1,10 @@
+import { defineComponent } from 'vue';
+/**
+ * Development-only guards for the global `Pdf*` component names. Types declare
+ * these names globally so `pdfs/*.vue` templates typecheck, which means an
+ * accidental `<PdfText>` inside an ordinary app component also typechecks —
+ * while resolving to nothing at runtime. Registering these stubs turns that
+ * silent failure into an immediate, actionable error.
+ */
+export declare const PDF_STUB_NAMES: readonly ["PdfCircle", "PdfClipPath", "PdfDefs", "PdfDocument", "PdfEllipse", "PdfG", "PdfImage", "PdfLine", "PdfLinearGradient", "PdfLink", "PdfNote", "PdfPage", "PdfPath", "PdfPolygon", "PdfPolyline", "PdfRadialGradient", "PdfRect", "PdfStop", "PdfSvg", "PdfText", "PdfTspan", "PdfView"];
+export declare const createPdfStubs: () => Record<string, ReturnType<typeof defineComponent>>;

package/dist/runtime/components/stubs.js

@@ -0,0 +1,37 @@
+import { defineComponent } from "vue";
+import { NuxtPdfError, PDF_ERROR_CODES } from "../shared/errors.js";
+export const PDF_STUB_NAMES = [
+  "PdfCircle",
+  "PdfClipPath",
+  "PdfDefs",
+  "PdfDocument",
+  "PdfEllipse",
+  "PdfG",
+  "PdfImage",
+  "PdfLine",
+  "PdfLinearGradient",
+  "PdfLink",
+  "PdfNote",
+  "PdfPage",
+  "PdfPath",
+  "PdfPolygon",
+  "PdfPolyline",
+  "PdfRadialGradient",
+  "PdfRect",
+  "PdfStop",
+  "PdfSvg",
+  "PdfText",
+  "PdfTspan",
+  "PdfView"
+];
+const stubMessage = (name) => `<${name}> only works inside a discovered pdfs/*.vue template rendered by @lupinum/nuxt-pdf. Move this component under pdfs/, or replace it with ordinary Vue/HTML components.`;
+const createPdfStub = (name) => defineComponent({
+  name,
+  setup() {
+    throw new NuxtPdfError(PDF_ERROR_CODES.TemplateInvalid, stubMessage(name));
+  },
+  render: () => null
+});
+export const createPdfStubs = () => Object.fromEntries(
+  PDF_STUB_NAMES.map((name) => [name, createPdfStub(name)])
+);

package/dist/runtime/fonts.d.ts

@@ -7,7 +7,7 @@ export interface PdfFontDeclaration {
     fontStyle?: PdfFontStyle;
     fontWeight?: PdfFontWeight;
 }
-export type PdfFontDataUrl = `data:font/${'otf' | 'ttf'};base64,${string}`;
+export type PdfFontDataUrl = `data:font/${'otf' | 'ttf' | 'woff2'};base64,${string}`;
 export interface BundledPdfFontDescriptor {
     family: string;
     src: PdfFontDataUrl;

package/dist/runtime/renderer/index.d.ts

@@ -1,3 +1,4 @@
 export { mountPdfComponent } from './render-component.js';
+export { PDF_PRIMITIVE_NAMES } from './types.js';
 export type { MountedPdfComponent, PdfComponentProps, } from './render-component.js';
 export type { PdfDocumentNode, PdfElementNode, PdfNode, PdfRoot, PdfTextInstance, } from './types.js';

package/dist/runtime/renderer/index.js

@@ -1 +1,2 @@
 export { mountPdfComponent } from "./render-component.js";
+export { PDF_PRIMITIVE_NAMES } from "./types.js";

package/dist/runtime/renderer/patch-prop.d.ts

@@ -1,3 +1,5 @@
 import type { RendererOptions } from 'vue';
-import { type PdfHostElement, type PdfHostNode } from './types.js';
+import { type PdfElementType, type PdfHostElement, type PdfHostNode } from './types.js';
+/** Closed runtime prop surface; TypeScript alone cannot reject Vue attrs. */
+export declare const PDF_PROP_KEYS: Record<PdfElementType, ReadonlySet<string>>;
 export declare const patchPdfProp: RendererOptions<PdfHostNode, PdfHostElement>['patchProp'];

package/dist/runtime/renderer/patch-prop.js

@@ -26,7 +26,7 @@ const SVG_PRESENTATION_PROP_NAMES = [
   "strokeWidth",
   "transform"
 ];
-const PDF_PROP_KEYS = {
+export const PDF_PROP_KEYS = {
   [PDF_PRIMITIVES.Document]: exactPropNames()([
     "author",
     "creationDate",
@@ -67,14 +67,12 @@ const PDF_PROP_KEYS = {
   [PDF_PRIMITIVES.Image]: exactPropNames()([
     ...BASE_PROP_NAMES,
     ...BOOKMARK_PROP_NAMES,
-    "source",
     "src"
   ]),
   [PDF_PRIMITIVES.Link]: exactPropNames()([
     ...BASE_PROP_NAMES,
     "hitSlop",
     "href",
-    "src",
     "wrap"
   ]),
   [PDF_PRIMITIVES.Note]: exactPropNames()(BASE_PROP_NAMES),

package/dist/runtime/renderer/validate-tree.js

@@ -256,18 +256,15 @@ const validatePage = (node) => {
 };
 const validateLinkAndImageSources = (node) => {
   if (node.type === PDF_PRIMITIVES.Image) {
-    if (hasProp(node, "src") === hasProp(node, "source")) {
-      treeInvalid('<PdfImage> requires exactly one of "src" or "source".');
+    if (!hasProp(node, "src")) {
+      treeInvalid('<PdfImage> requires a "src" prop.');
     }
   }
   if (node.type === PDF_PRIMITIVES.Link) {
-    const hasHref = hasProp(node, "href");
-    const hasSrc = hasProp(node, "src");
-    if (hasHref === hasSrc) {
-      treeInvalid('<PdfLink> requires exactly one of "href" or "src".');
+    if (!hasProp(node, "href")) {
+      treeInvalid('<PdfLink> requires an "href" prop.');
     }
-    const target = hasHref ? node.props.href : node.props.src;
-    if (typeof target !== "string" || target.trim() === "") {
+    if (typeof node.props.href !== "string" || node.props.href.trim() === "") {
       treeInvalid("<PdfLink> targets must be non-empty strings.");
     }
   }

package/dist/runtime/server/assets/resolve-asset.d.ts

@@ -4,14 +4,23 @@ import { type RemoteAssetPolicy, type RemoteRequestState } from './remote.js';
 import { type RenderLimits } from '../render-limits.js';
 export { PDF_ASSET_ERROR_CODES, PdfAssetError, type PdfAssetErrorCode, } from './errors.js';
 export type PdfImageFormat = 'jpg' | 'png';
-export type PdfImageAsset = Readonly<{
-    data: Uint8Array;
+/**
+ * One discovered local image. In development the entry points at the source
+ * file on disk so edits show up without a restart; in production the validated
+ * bytes travel as base64 inside the server bundle so every Nitro preset stays
+ * self-contained. Both forms resolve through the same validation boundary.
+ */
+export type PdfImageAssetEntry = Readonly<{
+    format: PdfImageFormat;
+    root: string;
+} | {
+    dataB64: string;
     format: PdfImageFormat;
 }>;
-export type LoadedPdfImageAsset = PdfImageAsset & Readonly<{
+export type PdfImageAssetMap = Readonly<Record<string, PdfImageAssetEntry>>;
+export type LoadedPdfImageAsset = Readonly<{
     key: string;
-}>;
-export type PdfImageAssetMap = Readonly<Record<string, PdfImageAsset>>;
+}> & ResolvedPdfImageAsset;
 export interface LoadPdfImageAssetOptions {
     roots: readonly string[];
     maxBytes?: number;
@@ -28,6 +37,13 @@ export interface ResolvePdfImageAssetsOptions {
      */
     state?: PdfImageResolutionState;
 }
+type ResolvedPdfImageAsset = Readonly<{
+    data: Buffer;
+    format: PdfImageFormat;
+    height: number;
+    pixels: number;
+    width: number;
+}>;
 type ImageBudgetState = {
     bytes: number;
     pixels: number;
@@ -39,6 +55,8 @@ export interface PdfImageResolutionState {
     readonly remote: RemoteRequestState;
     readonly resolved: ImageResolutionCache;
 }
+/** Format for a discovered asset key, validated at module setup time. */
+export declare const pdfImageFormatFromKey: (key: string) => PdfImageFormat;
 /**
  * Loads and validates one local image while the Nuxt module still has access to
  * source files. Generated server code should store the returned bytes under