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

package/dist/agent/pages/docs/reference/styles.md

@@ -0,0 +1,176 @@
+---
+title: "Styles"
+description: "Accepted style keys, values, units, inheritance, and primitive support."
+url: "https://nuxt-pdf.lupinum.com/docs/reference/styles"
+route: "/docs/reference/styles"
+locale: "en"
+section: "Documentation"
+collection: "docs"
+source: "ginko-content"
+---
+
+# Styles
+
+> Accepted style keys, values, units, inheritance, and primitive support.
+
+`PdfStyle` is Nuxt PDF's framework-owned authoring contract. It
+contains the behavior this package tests and supports; it does not re-export
+the wider upstream stylesheet types and it is not browser CSS.
+
+```ts
+import type { PdfStyle } from '@lupinum/nuxt-pdf'
+
+const pageStyle = {
+  color: '#18251d',
+  fontFamily: 'Invoice Sans',
+  fontSize: 10,
+  paddingHorizontal: 48,
+  paddingVertical: 40,
+} satisfies PdfStyle
+```
+
+Use `satisfies`, not a type assertion. It preserves the object's useful
+inferred type while making `vue-tsc` reject unknown keys, invalid enums, and
+unsupported units.
+
+`PdfStyle` belongs to page-flow layout and text metrics. SVG paint and geometry
+use direct props: `PdfG` and shapes do not accept `style`, `PdfSvg.style` places
+the SVG root in page flow, and SVG `PdfText.style` controls text metrics while
+its direct `fill` prop controls paint.
+
+## Values and units
+
+| Type | Accepted values | Notes |
+| --- | --- | --- |
+| `PdfLength` | A number, or `pt`, `px`, `in`, `mm`, `cm`, `rem`, `vh`, or `vw` (for example `12`, `'12pt'`, `'4mm'`) | A unitless number is a PDF point. `px` uses the page DPI; the default is 72. |
+| `PdfPercentage` | A numeric percentage string such as `'50%'` | Accepted only by properties whose type includes percentages. |
+| Color | A color string such as `'#18251d'`, `'rgb(24, 37, 29)'`, or `'red'` | There are no CSS variables or global cascade. |
+| Enum | One of the literals listed below | Browser-only values are rejected even when a similarly named CSS property exists. |
+
+`rem` uses the engine's 18-point base. `vw` and `vh` resolve against the PDF
+page container, not a browser window. Percentages resolve against the relevant
+parent dimension.
+
+`em`, `ch`, `ex`, `calc()`, `var()`, container queries, and arbitrary CSS
+strings are not part of the contract.
+
+## Dimensions and positioning
+
+These keys are valid on page-flow primitives (`PdfPage`, `PdfView`, `PdfText`,
+`PdfImage`, `PdfLink`, and `PdfNote`). `width` and `height` also size `PdfSvg`
+inside page flow.
+
+| Property | Accepted value | Inherited | Behavior |
+| --- | --- | --- | --- |
+| `width`, `height` | `PdfLength \| PdfPercentage` | No | Sets the resolved box size. |
+| `minWidth`, `minHeight`, `maxWidth`, `maxHeight` | `PdfLength \| PdfPercentage` | No | Constrains the resolved box size. |
+| `position` | `'relative' \| 'absolute'` | No | Use the component `fixed` prop to repeat content across pages. Browser `fixed` and `static` values are not accepted. |
+| `top`, `right`, `bottom`, `left` | `PdfLength \| PdfPercentage` | No | Offsets a positioned node. |
+
+## Flex layout
+
+Flex properties primarily belong on `PdfPage` and `PdfView`. Text, links,
+images, notes, and SVGs can be flex items. The engine defaults to a `column`
+direction.
+
+| Property | Accepted value | Inherited | Behavior |
+| --- | --- | --- | --- |
+| `flexDirection` | `'row' \| 'row-reverse' \| 'column' \| 'column-reverse'` | No | Controls the main axis. The default is `column`. |
+| `flex`, `flexGrow`, `flexShrink` | `number` | No | Controls available-space growth and shrinkage. |
+| `flexBasis` | `PdfLength \| PdfPercentage \| 'auto'` | No | Sets the initial main-axis size. |
+| `flexWrap` | `'nowrap' \| 'wrap' \| 'wrap-reverse'` | No | Controls flex-line wrapping. |
+| `alignItems` | `'flex-start' \| 'flex-end' \| 'center' \| 'stretch' \| 'baseline'` | No | Aligns children on the cross axis. |
+| `justifyContent` | `'flex-start' \| 'flex-end' \| 'center' \| 'space-between' \| 'space-around' \| 'space-evenly'` | No | Distributes children on the main axis. |
+| `gap` | `PdfLength` | No | Adds space between flex children. |
+
+There is no grid, browser block layout, floats, selectors, or CSS cascade.
+
+## Box model
+
+The box model is valid on page-flow primitives. Percentages resolve through
+the engine's PDF layout container, not a browser viewport.
+
+| Property | Accepted value | Inherited | Behavior |
+| --- | --- | --- | --- |
+| `margin`, `marginHorizontal`, `marginVertical`, `marginTop`, `marginRight`, `marginBottom`, `marginLeft` | `PdfLength \| PdfPercentage \| 'auto'` | No | Sets space outside the box. |
+| `padding`, `paddingHorizontal`, `paddingVertical`, `paddingTop`, `paddingRight`, `paddingBottom`, `paddingLeft` | `PdfLength \| PdfPercentage` | No | Sets space inside the box. Padding does not accept `auto`. |
+
+## Borders and paint
+
+| Property | Accepted value | Inherited | Behavior |
+| --- | --- | --- | --- |
+| `backgroundColor` | color string | Only through nested `PdfText` runs | Paints the page-flow box background. |
+| `color` | color string | Yes | Sets text color on text-bearing primitives. |
+| `opacity` | `number` | Yes | Sets node opacity. |
+| `borderWidth`, `borderTopWidth`, `borderRightWidth`, `borderBottomWidth`, `borderLeftWidth` | `PdfLength` | No | Sets all or individual border widths. |
+| `borderColor`, `borderTopColor`, `borderRightColor`, `borderBottomColor`, `borderLeftColor` | color string | No | Sets all or individual border colors. |
+| `borderStyle`, `borderTopStyle`, `borderRightStyle`, `borderBottomStyle`, `borderLeftStyle` | `'solid' \| 'dashed' \| 'dotted'` | No | Sets all or individual border styles. |
+| `borderRadius` | `PdfLength` | No | Page-flow primitives. Percent shorthand is not accepted because the engine requires a resolved number. |
+| `borderTopLeftRadius`, `borderTopRightRadius`, `borderBottomRightRadius`, `borderBottomLeftRadius` | `PdfLength \| PdfPercentage` | No | Page-flow primitives; edge radii are resolved independently. |
+
+Full CSS border strings such as `'1px solid red'` are not public authoring
+syntax. Use the explicit width, style, and color keys so invalid values remain
+type-checkable.
+
+## Text
+
+Text keys apply to `PdfText` and `PdfLink`. They may be set on ancestor
+`PdfPage`/`PdfView` nodes when the table marks them inherited.
+
+| Property | Accepted value | Inherited | Behavior |
+| --- | --- | --- | --- |
+| `fontFamily` | `string` | Yes | Selects one registered family or a built-in engine family. |
+| `fontSize` | `PdfLength` | Yes | Sets glyph size. |
+| `fontStyle` | `'normal' \| 'italic' \| 'oblique'` | Yes | Selects the matching registered face. |
+| `fontWeight` | `number` or `thin`, `hairline`, `ultralight`, `extralight`, `light`, `normal`, `medium`, `semibold`, `demibold`, `bold`, `ultrabold`, `extrabold`, `heavy`, `black` | Yes | Selects the matching registered numeric weight. |
+| `letterSpacing` | `PdfLength` | Yes | Adds space between glyphs and affects wrapping. |
+| `lineHeight` | unitless multiplier, `PdfLength`, or `PdfPercentage` | Yes for static text | Static text supports it. Dynamic `render` text uses font-default line spacing; see [Supported behavior](/raw/docs/examples/supported-behavior.md). |
+| `maxLines` | `number` | No | Limits rendered lines. Use `textOverflow: 'ellipsis'` for an ellipsis. |
+| `textAlign` | `'left' \| 'right' \| 'center' \| 'justify'` | Yes | Aligns text inside its line box. |
+| `textDecoration` | `'none' \| 'underline' \| 'line-through'` or both decoration names separated by a space | Yes | Applies one or both decorations. |
+| `textDecorationColor` | color string | No | `PdfText` and `PdfLink`. |
+| `textDecorationStyle` | `'solid' \| 'dashed' \| 'dotted'` | No | `PdfText` and `PdfLink`. |
+| `textOverflow` | `'ellipsis'` | No | Adds an ellipsis when `maxLines` truncates text. |
+| `textTransform` | `'none' \| 'capitalize' \| 'lowercase' \| 'uppercase'` | Yes | Transforms rendered text casing. |
+
+`wordSpacing` is not supported. The pinned text layout pipeline accepts
+the key but does not apply it to glyph advances or wrapping. Nuxt PDF does not
+type a no-op as supported authoring; use `letterSpacing` instead.
+
+## Images and transforms
+
+| Property | Accepted value | Inherited | Behavior |
+| --- | --- | --- | --- |
+| `objectFit` | `'contain' \| 'cover'` | No | Fits a `PdfImage` inside its resolved box. |
+| `transform` | One to three space-separated `rotate(...)`, `scale(...)`, or `translate(...)` operations | No | Applies to page-flow primitives. Rotate accepts degrees or radians. Translate uses unitless PDF points. SVG transforms remain direct SVG props. |
+
+## Style arrays
+
+`PdfStyleValue` is either one `PdfStyle` or a recursively nested readonly array.
+Arrays merge left-to-right. `false`, `null`, and `undefined` entries are ignored,
+which makes Vue conditionals direct and type-safe:
+
+```ts
+import type { PdfStyle, PdfStyleValue } from '@lupinum/nuxt-pdf'
+
+const base = { fontSize: 10 } satisfies PdfStyle
+const total = { fontWeight: 700 } satisfies PdfStyle
+
+const style = [base, [isTotal && total], null] satisfies PdfStyleValue
+```
+
+Numbers, strings, `true`, functions, and arbitrary objects are not valid array
+entries.
+
+## Exported style types
+
+Import these types from `@lupinum/nuxt-pdf`:
+
+| Export | Describes |
+| --- | --- |
+| `PdfStyle` | One style object |
+| `PdfStyleValue` | One style object or a nested style array |
+| `PdfStyleEntry` | One accepted entry in a style array |
+| `PdfLength` | A point number or supported length string |
+| `PdfPercentage` | A numeric percentage string |
+| `PdfLengthOrPercentage` | A supported length or percentage |

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

@@ -0,0 +1,128 @@
+---
+title: "Test utilities"
+description: "The render, parse, assert, and snapshot exports of @lupinum/nuxt-pdf/test."
+url: "https://nuxt-pdf.lupinum.com/docs/reference/test-utilities"
+route: "/docs/reference/test-utilities"
+locale: "en"
+section: "Documentation"
+collection: "docs"
+source: "ginko-content"
+---
+
+# Test utilities
+
+> The render, parse, assert, and snapshot exports of @lupinum/nuxt-pdf/test.
+
+`@lupinum/nuxt-pdf/test` exposes the helpers Nuxt PDF is tested with. They are
+runner-agnostic (they throw `PdfAssertionError`, not Vitest/Jest matchers) and
+load `pdfjs-dist` and `@napi-rs/canvas` lazily. See
+[Testing your PDFs](/raw/docs/guides/testing.md) for a worked example.
+
+## renderPdfTemplate
+
+```ts
+const { bytes, parsed } = await renderPdfTemplate(Component, props)
+```
+
+Renders a Vue PDF component through the real registry pipeline, with or without
+a `definePdf` block. Returns the raw `bytes`, immutable `result`, and a `parsed`
+document. Options use the same input shapes as `pdf.remote` and `pdf.limits`, so
+partial limits and URL-prefix allowlists can be shared with `nuxt.config`.
+
+Use `renderPdfSfc` when the document depends on discovered local images or
+custom font files. Prepared asset maps, embedded font descriptors, and template
+attribution are registry internals and are not public test configuration.
+
+## renderPdfSfc
+
+```ts
+const rendered = await renderPdfSfc('./pdfs/invoice.vue', props)
+```
+
+Compiles a real template and its nested child SFCs with the production
+compiler, discovers and validates `pdfs/assets`, and bundles the declared faces
+from `pdfs/fonts`. Its options mirror `pdf.fonts`, `pdf.remote`, and `pdf.limits`;
+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
+const parsed = await parsePdf(input)
+```
+
+Accepts PDF bytes (`Uint8Array`/`ArrayBuffer`/`Buffer`) **or** a
+`PdfRenderResult` straight from the `#pdf` registry. Returns page text, page
+count, flattened link annotations (named destination or external URL), and the
+outline hierarchy with its initial expanded/collapsed state.
+
+## expectPdf
+
+```ts
+expectPdf(parsed)
+  .toHavePageCount(2)
+  .toContainText('Invoice for Acme Corp', { page: 1 })
+  .toHaveLink({ destination: 'terms', page: 1 })
+  .toHaveLink({ url: 'https://example.com/' })
+  .toHaveOutline([{ title: 'Terms', expanded: true }])
+```
+
+A chainable expectation that throws `PdfAssertionError` with an actionable
+message on failure.
+
+| Method | Checks |
+| --- | --- |
+| `toHavePageCount(n)` | Page count equals `n` |
+| `toContainText(text, { page? })` | Extracted text contains `text` |
+| `toHaveLink({ destination?, url?, page? })` | A matching link annotation exists |
+| `toHaveOutline(shape)` | The outline matches the title hierarchy and any requested expansion states |
+
+## rasterizePdf and comparePdfSnapshot
+
+```ts
+await comparePdfSnapshot(bytes, './test/baselines/invoice')
+```
+
+`rasterizePdf` renders pages to PNGs; `comparePdfSnapshot` implements the
+reviewed-baseline flow. It writes per-page baselines when
+`UPDATE_PDF_BASELINES=1` (or `{ update: true }`) and otherwise compares within a
+pixel threshold.
+
+`parsePdf` also returns page dimensions and normalized `textRuns` with text,
+position, size, font name, direction, width, and height. Use tolerant numeric
+assertions for geometry because font and raster backends can vary slightly
+between supported environments.
+
+When a raster comparison fails, the helper checks every page and writes
+`expected`, `actual`, and `diff` PNGs plus a machine-readable `metrics.json` to
+`reports/pdf-snapshots/<baseline-name>`. Pass `{ artifactDir }` to choose a
+different CI artifact directory.
+
+## All exports
+
+| Export | Kind | Purpose |
+| --- | --- | --- |
+| `renderPdfTemplate` | function | Render a component through the real pipeline |
+| `renderPdfSfc` | function | Compile and render a real nested `pdfs/*.vue` graph |
+| `loadPdfSfc` | function | Compile a PDF SFC graph into a Vue component |
+| `parsePdf` | function | Parse bytes or a render result into a `ParsedPdf` |
+| `rasterizePdf` | function | Render pages to PNG images |
+| `comparePdfSnapshot` | function | Reviewed-baseline raster comparison |
+| `toPdfBytes` | function | Normalize inputs to PDF bytes |
+| `expectPdf` | function | Fluent, runner-agnostic assertions |
+| `PdfAssertionError` | class | Thrown by assertions on failure |
+| `PdfComponentProps`, `RenderedPdfTemplate`, `RenderPdfTemplateOptions`, `RenderPdfSfcOptions` | types | Typed component props and render results/options |
+| `ParsedPdf`, `ParsedPdfPage`, `ParsedPdfTextRun`, `ParsedPdfLink`, `PdfOutlineItem`, `PdfInput`, `PdfPageImage` | types | Parsed PDF structures |
+| `PdfExpectation`, `LinkQuery`, `OutlineShape`, `ToContainTextOptions` | types | Assertion inputs and chain type |
+| `RasterizePdfOptions`, `ComparePdfSnapshotOptions`, `PdfSnapshotResult` | types | Raster and snapshot options/results |
+
+`pdfjs-dist` and `@napi-rs/canvas` are optional peer dependencies; install them
+in the project under test. They are absent from the module's production
+dependency graph.

package/dist/module.json

@@ -1,6 +1,6 @@
 {
   "name": "@lupinum/nuxt-pdf",
-  "version": "0.4.0-beta.4",
+  "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.4";
+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.4",
+  "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": {
@@ -38,7 +37,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",
@@ -55,49 +55,6 @@
   "engines": {
     "node": "^22.14.0 || ^24.0.0 || ^26.0.0"
   },
-  "scripts": {
-    "prepack": "pnpm build",
-    "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:theme": "node scripts/check-docs-theme.mjs",
-    "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:prepare": "changelogen --bump --clean",
-    "release:verify": "pnpm check:dependencies && pnpm audit:all && pnpm check:source && node scripts/check-release-artifact.mjs release-artifacts",
-    "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",
-    "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",
@@ -130,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",
@@ -140,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",
@@ -151,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"
   }
-}
+}