@lupinum/nuxt-pdf 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -4,7 +4,31 @@ 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).
 
-## Unreleased
+## 0.3.1 - 2026-08-13
+
+### Fixed
+
+- Prepare the Nuxt type files before clean package and documentation builds.
+- Normalize compiler and package paths on Windows.
+- Preserve literal title markers in public documentation.
+
+### Changed
+
+- Move the package, repository, documentation, contribution, and support
+  surfaces to the shared Lupinum standard.
+- Update the documentation site to Ginko Content `0.4.0-rc.2` and Ginko Docs
+  `0.3.0-rc.5`.
+- Add privacy-friendly Plausible analytics and page feedback to the
+  documentation site.
+- Stabilize the table-of-contents raster evidence across supported runners.
+
+### Security
+
+- Replace source publishing with a protected workflow that certifies one
+  immutable tarball, publishes it through npm trusted publishing with
+  provenance, and creates the matching GitHub release.
+- Add full dependency audits, CodeQL, package previews, and explicit
+  repository policy checks.
 
 ## 0.3.0 - 2026-08-11
 

package/CONFORMANCE.md

@@ -1,11 +1,11 @@
-# Nuxt PDF 0.3.0 conformance
+# Nuxt PDF 0.3.1 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.0 boundary |
+| Layer | 0.3.1 boundary |
 |---|---|
 | Node.js | `^22.14.0`, `^24.0.0`, or `^26.0.0` |
 | Nuxt | `^4.4.8` |
@@ -202,7 +202,7 @@ checking.
 
 ### Vue and Nuxt authoring
 
-The 0.3.0 tests verify:
+The 0.3.1 tests verify:
 
 - `PdfDocument`, `PdfPage`, `PdfView`, `PdfText`, `PdfImage`, `PdfLink`, and
   `PdfNote`;
@@ -432,7 +432,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.0
+## Explicitly not claimed in 0.3.1
 
 - Full React PDF component, hook, browser-helper, or test-suite parity.
 - React runtime compatibility or React-shaped dynamic callback results.

package/README.md

@@ -19,10 +19,17 @@
 > release, but a minor release can contain documented breaking changes before
 > version 1.0.
 
+## Why use Nuxt PDF?
+
 Nuxt PDF discovers Vue Single File Components in `pdfs/`. It renders these
 components on the Node server through a PDF layout engine. The client bundle
 does not contain the renderer or document templates.
 
+This approach gives you typed document props, reusable Vue components, stable
+server output, and PDF-specific test helpers in one Nuxt module.
+
+## When to use it
+
 Use Nuxt PDF for structured documents such as invoices, reports,
 certificates, tickets, and labels.
 
@@ -38,7 +45,7 @@ edit and sign an existing PDF.
 Nuxt 3, Node 20, browser rendering, and edge rendering are outside the current
 support boundary.
 
-## Install
+## Installation
 
 Install the module in a Nuxt 4 application:
 
@@ -54,7 +61,7 @@ export default defineNuxtConfig({
 })
 ```
 
-## Render a document
+## Quick start
 
 Create `pdfs/invoice.vue`:
 
@@ -125,7 +132,7 @@ Start Nuxt. Open these development routes:
 Restart `nuxt dev` after you first enable the module. This action generates
 the typed `#pdf` registry.
 
-## Authoring model
+## How it works
 
 PDF templates use typed props, interpolation, `v-if`, keyed `v-for`, slots,
 and local Vue components. Nuxt PDF provides document, page, text, image, link,
@@ -138,11 +145,6 @@ Load request data before the render and pass it through typed props.
 Nuxt PDF supports local images and fonts. Remote images are disabled until an
 operator configures an explicit HTTPS allowlist.
 
-Read the [documentation](https://nuxt-pdf.lupinum.com) for authoring, 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.
-
 ## Test a document
 
 Install the optional test dependencies:
@@ -172,16 +174,24 @@ expectPdf(parsed)
 The test entry can also inspect links, bookmarks, page geometry, and raster
 baselines.
 
-## Develop Nuxt PDF
+## Documentation
+
+Read the [Nuxt PDF documentation](https://nuxt-pdf.lupinum.com) for authoring,
+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.
+
+## Contributing and development
 
 ```bash
 pnpm install --frozen-lockfile
 pnpm dev
-pnpm check
+pnpm verify
 ```
 
-Use `pnpm docs:dev` to run the documentation site. Use
-`pnpm release:verify` only for release preparation.
+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.
 
 Read [CONTRIBUTING.md](./CONTRIBUTING.md) before you open a pull request.
 Maintainers use [MAINTAINING.md](./MAINTAINING.md) for release and recovery
@@ -191,8 +201,10 @@ procedures.
 
 - Read the [documentation](https://nuxt-pdf.lupinum.com).
 - Join the [Lupinum OSS Discord](https://discord.gg/RPH6SeA36N).
-- Open a [GitHub issue](https://github.com/lupinum-dev/nuxt-pdf/issues) for a
-  reproducible defect.
+- Open a [bug report](https://github.com/lupinum-dev/nuxt-pdf/issues/new?template=bug.md)
+  for a reproducible defect.
+- Open a [feature request](https://github.com/lupinum-dev/nuxt-pdf/issues/new?template=proposal.md)
+  before you plan a larger change.
 - Follow [SECURITY.md](./SECURITY.md) for a private vulnerability report.
 
 ## License

package/dist/module.json

@@ -4,7 +4,7 @@
   "compatibility": {
     "nuxt": "^4.4.8"
   },
-  "version": "0.3.0",
+  "version": "0.3.1",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "unknown"

package/dist/runtime/composables/use-pdf-page-numbers.js

@@ -3,7 +3,7 @@ import {
   readonly
 } from "vue";
 import { NuxtPdfError, PDF_ERROR_CODES } from "../shared/errors.js";
-export const PDF_PAGE_NUMBERS_KEY = Symbol.for("@lupinum/nuxt-pdf:page-numbers");
+export const PDF_PAGE_NUMBERS_KEY = /* @__PURE__ */ Symbol.for("@lupinum/nuxt-pdf:page-numbers");
 export const usePdfPageNumbers = () => {
   const context = inject(PDF_PAGE_NUMBERS_KEY, null);
   if (!context) {

package/dist/runtime/renderer/types.js

@@ -25,7 +25,7 @@ export const PDF_PRIMITIVE_NAMES = {
   [PDF_PRIMITIVES.RadialGradient]: "PdfRadialGradient",
   [PDF_PRIMITIVES.Stop]: "PdfStop"
 };
-export const PDF_COMMENT = Symbol("nuxt-pdf-comment");
+export const PDF_COMMENT = /* @__PURE__ */ Symbol("nuxt-pdf-comment");
 const ELEMENT_TYPES = /* @__PURE__ */ new Set([
   PDF_PRIMITIVES.Document,
   PDF_PRIMITIVES.Page,

package/dist/test.mjs

@@ -268,7 +268,6 @@ async function withPdfDocument(data, read) {
   const loadingTask = pdfJs.getDocument({
     CanvasFactory: NapiCanvasFactory,
     data: copyPdfData(data),
-    isEvalSupported: false,
     stopAtErrors: true,
     useWorkerFetch: false,
     verbosity: 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lupinum/nuxt-pdf",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Author and render PDFs with Vue components in Nuxt",
   "keywords": [
     "nuxt",
@@ -55,15 +55,19 @@
     "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",
-    "docs:build": "pnpm --dir docs build",
+    "changelog": "changelogen --no-output",
+    "docs:build": "pnpm build && pnpm --dir docs build",
+    "docs:build:vercel": "node scripts/build-docs-vercel.mjs",
     "docs:dev": "pnpm --dir docs dev",
     "format": "eslint . --fix",
     "format:check": "eslint .",
     "lint": "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:verify": "pnpm check && pnpm release:pack",
+    "release:prepare": "changelogen --bump --clean",
+    "release:verify": "pnpm verify && pnpm release:pack",
     "test:artifact": "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",
@@ -75,14 +79,18 @@
     "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",
+    "check:vercel": "node scripts/check-vercel-config.mjs",
     "test:serverless": "vitest run --config vitest.serverless.config.ts",
     "test:watch": "vitest watch",
     "typecheck": "nuxt prepare && vue-tsc --noEmit && nuxt prepare test/fixtures/basic && vue-tsc --noEmit -p test/fixtures/basic/tsconfig.json && pnpm test:prepare && pnpm --dir playground exec vue-tsc --noEmit",
-    "check": "pnpm format:check && pnpm typecheck && pnpm test:docs && pnpm test:version-headings && pnpm test:dependencies && pnpm test && pnpm test:production && pnpm test:serverless && pnpm build && pnpm test:package-metadata && pnpm dev:build && pnpm test:artifact"
+    "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"
   },
   "dependencies": {
     "@jridgewell/remapping": "2.3.5",
-    "@nuxt/kit": "^4.4.8",
+    "@nuxt/kit": "^4.5.2",
     "@react-pdf/font": "4.0.8",
     "@react-pdf/layout": "4.6.1",
     "@react-pdf/pdfkit": "5.1.1",
@@ -97,7 +105,7 @@
   "peerDependencies": {
     "@napi-rs/canvas": "^0.1.97",
     "nuxt": "^4.4.8",
-    "pdfjs-dist": "^5.6.205",
+    "pdfjs-dist": "^5.6.205 || ^6.2.108",
     "vue": "^3.5.0"
   },
   "peerDependenciesMeta": {
@@ -112,18 +120,19 @@
     "@arethetypeswrong/cli": "^0.18.5",
     "@jridgewell/trace-mapping": "0.3.31",
     "@napi-rs/canvas": "0.1.97",
-    "@nuxt/devtools": "^3.2.4",
+    "@nuxt/devtools": "^3.3.1",
     "@nuxt/eslint-config": "^1.15.2",
     "@nuxt/module-builder": "^1.0.2",
-    "@nuxt/schema": "^4.4.8",
+    "@nuxt/schema": "^4.5.2",
     "@nuxt/test-utils": "^4.0.3",
     "@react-pdf/renderer": "4.5.1",
     "@types/node": "26.1.1",
     "@types/react": "19.2.14",
-    "changelogen": "^0.6.2",
+    "changelogen": "0.6.2",
     "eslint": "^10.4.1",
-    "nuxt": "^4.4.8",
-    "pdfjs-dist": "5.6.205",
+    "nuxt": "^4.5.2",
+    "pdfjs-dist": "6.2.108",
+    "pkg-pr-new": "0.0.87",
     "publint": "^0.3.21",
     "react": "19.2.0",
     "source-code-pro": "2.42.0",