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

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

@@ -1,10 +1,22 @@
-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>>;
+export declare const PdfCircle: import("vue").DefineComponent<{}, never, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export declare const PdfClipPath: import("vue").DefineComponent<{}, never, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export declare const PdfDefs: import("vue").DefineComponent<{}, never, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export declare const PdfDocument: import("vue").DefineComponent<{}, never, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export declare const PdfEllipse: import("vue").DefineComponent<{}, never, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export declare const PdfG: import("vue").DefineComponent<{}, never, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export declare const PdfImage: import("vue").DefineComponent<{}, never, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export declare const PdfLine: import("vue").DefineComponent<{}, never, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export declare const PdfLinearGradient: import("vue").DefineComponent<{}, never, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export declare const PdfLink: import("vue").DefineComponent<{}, never, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export declare const PdfNote: import("vue").DefineComponent<{}, never, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export declare const PdfPage: import("vue").DefineComponent<{}, never, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export declare const PdfPath: import("vue").DefineComponent<{}, never, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export declare const PdfPolygon: import("vue").DefineComponent<{}, never, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export declare const PdfPolyline: import("vue").DefineComponent<{}, never, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export declare const PdfRadialGradient: import("vue").DefineComponent<{}, never, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export declare const PdfRect: import("vue").DefineComponent<{}, never, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export declare const PdfStop: import("vue").DefineComponent<{}, never, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export declare const PdfSvg: import("vue").DefineComponent<{}, never, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export declare const PdfText: import("vue").DefineComponent<{}, never, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export declare const PdfTspan: import("vue").DefineComponent<{}, never, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export declare const PdfView: import("vue").DefineComponent<{}, never, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/runtime/components/stubs.js

@@ -1,29 +1,5 @@
 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,
@@ -32,6 +8,25 @@ const createPdfStub = (name) => defineComponent({
   },
   render: () => null
 });
-export const createPdfStubs = () => Object.fromEntries(
-  PDF_STUB_NAMES.map((name) => [name, createPdfStub(name)])
-);
+export const PdfCircle = createPdfStub("PdfCircle");
+export const PdfClipPath = createPdfStub("PdfClipPath");
+export const PdfDefs = createPdfStub("PdfDefs");
+export const PdfDocument = createPdfStub("PdfDocument");
+export const PdfEllipse = createPdfStub("PdfEllipse");
+export const PdfG = createPdfStub("PdfG");
+export const PdfImage = createPdfStub("PdfImage");
+export const PdfLine = createPdfStub("PdfLine");
+export const PdfLinearGradient = createPdfStub("PdfLinearGradient");
+export const PdfLink = createPdfStub("PdfLink");
+export const PdfNote = createPdfStub("PdfNote");
+export const PdfPage = createPdfStub("PdfPage");
+export const PdfPath = createPdfStub("PdfPath");
+export const PdfPolygon = createPdfStub("PdfPolygon");
+export const PdfPolyline = createPdfStub("PdfPolyline");
+export const PdfRadialGradient = createPdfStub("PdfRadialGradient");
+export const PdfRect = createPdfStub("PdfRect");
+export const PdfStop = createPdfStub("PdfStop");
+export const PdfSvg = createPdfStub("PdfSvg");
+export const PdfText = createPdfStub("PdfText");
+export const PdfTspan = createPdfStub("PdfTspan");
+export const PdfView = createPdfStub("PdfView");

package/dist/runtime/server/assets/resolve-asset.js

@@ -276,29 +276,7 @@ export const loadPdfImageAsset = async (relativePath, options) => {
     "The local PDF image was not found in a configured asset root."
   );
 };
-const RESOLVED_IMAGE_CACHE_BYTES = 32 * 1024 * 1024;
-const resolvedImageCache = /* @__PURE__ */ new Map();
-let resolvedImageCacheBytes = 0;
 const embeddedImageCache = /* @__PURE__ */ new WeakMap();
-const rememberResolvedImage = (cacheKey, image) => {
-  if (resolvedImageCache.has(cacheKey)) return;
-  resolvedImageCache.set(cacheKey, image);
-  resolvedImageCacheBytes += image.data.byteLength;
-  while (resolvedImageCacheBytes > RESOLVED_IMAGE_CACHE_BYTES && resolvedImageCache.size > 1) {
-    const oldest = resolvedImageCache.keys().next().value;
-    if (oldest === void 0) break;
-    resolvedImageCacheBytes -= resolvedImageCache.get(oldest).data.byteLength;
-    resolvedImageCache.delete(oldest);
-  }
-};
-const cachedResolvedImage = (cacheKey) => {
-  const cached = resolvedImageCache.get(cacheKey);
-  if (!cached) return void 0;
-  return {
-    ...cached,
-    data: Buffer.from(cached.data)
-  };
-};
 const resolveLocalImage = async (source, assets, maxBytes, maxPixels, declaredFormat) => {
   const key = canonicalAssetKey(source);
   const pathFormat = formatFromExtension(key);
@@ -328,8 +306,8 @@ const resolveLocalImage = async (source, assets, maxBytes, maxPixels, declaredFo
       byLimits = /* @__PURE__ */ new Map();
       embeddedImageCache.set(entry, byLimits);
     }
-    const cached2 = byLimits.get(limitsKey);
-    if (cached2) return { ...cached2, data: Buffer.from(cached2.data) };
+    const cached = byLimits.get(limitsKey);
+    if (cached) return { ...cached, data: Buffer.from(cached.data) };
     const resolved2 = validateImageBytes(
       Buffer.from(entry.dataB64, "base64"),
       maxBytes,
@@ -339,21 +317,6 @@ const resolveLocalImage = async (source, assets, maxBytes, maxPixels, declaredFo
     byLimits.set(limitsKey, resolved2);
     return { ...resolved2, data: Buffer.from(resolved2.data) };
   }
-  let fileStat;
-  try {
-    fileStat = await stat(resolve(entry.root, ...key.split("/")));
-  } catch (error) {
-    if (isMissingFileError(error)) {
-      return invalid(`The local PDF image "${key}" was not found under pdfs/assets.`);
-    }
-    return invalid("The local PDF image cannot be inspected.", error);
-  }
-  if (!fileStat.isFile()) {
-    return invalid("The local PDF image is not a regular file.");
-  }
-  const cacheKey = `disk\0${key}\0${fileStat.mtimeMs}\0${fileStat.size}\0${maxBytes}\0${maxPixels}`;
-  const cached = cachedResolvedImage(cacheKey);
-  if (cached) return cached;
   const loaded = await loadPdfImageAsset(key, {
     roots: [entry.root],
     maxBytes,
@@ -366,7 +329,6 @@ const resolveLocalImage = async (source, assets, maxBytes, maxPixels, declaredFo
     pixels: loaded.pixels,
     width: loaded.width
   });
-  rememberResolvedImage(cacheKey, resolved);
   return { ...resolved, data: Buffer.from(resolved.data) };
 };
 const isRemoteCandidate = (source) => /^https?:/i.test(source);

package/dist/runtime/server/preview.js

@@ -233,7 +233,7 @@ const viewerPage = async (template, props, rootPath, scenario, hmrClientPath2 =
   }
   return htmlResponse(
     title,
-    `<header><h1>${escapeHtml(title)}</h1>${actions}</header>${nav}${body}<script type="module">import { createHotContext } from ${JSON.stringify(hmrClientPath2)};createHotContext('/_pdf').on('nuxt-pdf:update',()=>{const frame=document.querySelector('iframe');if(frame&&frame.contentWindow){frame.contentWindow.location.reload();}else{location.reload();}});<\/script>`
+    `<header><h1>${escapeHtml(title)}</h1>${actions}</header>${nav}${body}<script type="module">import { createHotContext } from ${JSON.stringify(hmrClientPath2)};createHotContext('/_pdf').on('nuxt-pdf:update',()=>{location.reload();});<\/script>`
   );
 };
 export const renderPdfPreview = async (registry, request = {}) => {

package/dist/shared/{nuxt-pdf.DMC_Rdsz.mjs → nuxt-pdf.C-E8MM_K.mjs}

@@ -540,6 +540,7 @@ const createPdfSfcPlugin = (options) => ({
     if (!filename) return null;
     const kind = options.files.get(filename);
     if (!kind) return null;
+    this.addWatchFile(filename);
     return compilePdfSfc(
       await readFile(filename, "utf8"),
       filename,

package/dist/shared/{nuxt-pdf.D3hUPqOJ.mjs → nuxt-pdf.CjVyPF31.mjs}

@@ -1,4 +1,4 @@
-import { PDF_STUB_NAMES } from '../../dist/runtime/components/stubs.js';
+import * as pdfStubs from '../../dist/runtime/components/stubs.js';
 import { joinURL } from 'ufo';
 import { Buffer } from 'node:buffer';
 import { pdfImageFormatFromKey, loadPdfImageAsset } from '../../dist/runtime/server/assets/resolve-asset.js';
@@ -10,7 +10,7 @@ const generateAuthoringTypes = (componentsImport, composablesImport, definePdfIm
 
 declare module 'vue' {
   interface GlobalComponents {
-${PDF_STUB_NAMES.map((name) => `    ${name}: typeof import(${JSON.stringify(componentsImport)})['${name}']`).join("\n")}
+${Object.keys(pdfStubs).map((name) => `    ${name}: typeof import(${JSON.stringify(componentsImport)})['${name}']`).join("\n")}
   }
 }
 

package/dist/test.mjs

@@ -10,7 +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 { t as templateKeyFromRelativePath, a as discoverPdfImageFiles, b as bundlePdfFonts, c as compilePdfSfc } from './shared/nuxt-pdf.DMC_Rdsz.mjs';
+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';
 import '@jridgewell/remapping';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lupinum/nuxt-pdf",
-  "version": "0.4.0-beta.3",
+  "version": "0.4.0-beta.5",
   "description": "Author and render PDFs with Vue components in Nuxt",
   "keywords": [
     "nuxt",
@@ -38,7 +38,8 @@
     "./server": {
       "types": "./dist/server.d.mts",
       "import": "./dist/server.mjs"
-    }
+    },
+    "./agent-docs": "./dist/agent/AGENTS.md"
   },
   "main": "./dist/module.mjs",
   "types": "./dist/types.d.mts",
@@ -56,7 +57,7 @@
     "node": "^22.14.0 || ^24.0.0 || ^26.0.0"
   },
   "scripts": {
-    "prepack": "pnpm build",
+    "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",
@@ -67,21 +68,22 @@
     "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": "eslint .",
-    "lint": "eslint .",
+    "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 build && node scripts/check-release-artifact.mjs release-artifacts",
-    "release:prepare": "changelogen --bump --clean",
-    "release:verify": "pnpm verify && pnpm release:pack",
-    "test:artifact": "node scripts/check-release-artifact.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 docs:theme && pnpm --dir docs check",
+    "test:docs": "node scripts/check-documentation.mjs && pnpm --dir docs check",
     "test:package": "node scripts/check-package.mjs",
-    "test:package-metadata": "node scripts/check-api-report.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",
@@ -94,8 +96,10 @@
     "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",
-    "verify": "pnpm audit:all && pnpm check",
-    "check": "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:package-metadata && pnpm dev:build && pnpm test:artifact"
+    "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",