@nxgt/material-vue 0.22.0 → 0.23.1

package/dist/{utils-Cy-ByIEo.js → utils-CykWQ0iJ.js}

@@ -1,4 +1,4 @@
-//#region node_modules/clsx/dist/clsx.mjs
+//#region ../../node_modules/clsx/dist/clsx.mjs
 function e(t) {
 	var n, r, i = "";
 	if (typeof t == "string" || typeof t == "number") i += t;
@@ -13,7 +13,7 @@ function t() {
 	return i;
 }
 //#endregion
-//#region node_modules/tailwind-merge/dist/bundle-mjs.mjs
+//#region ../../node_modules/tailwind-merge/dist/bundle-mjs.mjs
 var n = (e, t) => {
 	let n = Array(e.length + t.length);
 	for (let t = 0; t < e.length; t++) n[t] = e[t];

package/dist/{vennDiagram-UO4OBE2U-B22Jhju8.js → vennDiagram-UO4OBE2U-DC4GDZLl.js}

@@ -1,10 +1,10 @@
-import { n as e } from "./chunk-Y2CYZVJY-i11wjrBe.js";
-import { p as t } from "./src-CNRY2AUH.js";
-import { H as n, U as r, a as i, b as a, c as o, f as s, it as c, nt as l, q as u, rt as d, tt as f, v as p, w as m, y as h } from "./chunk-O7XYJQB3-WMQqqzRb.js";
-import { i as g } from "./chunk-ZIGJFQKS-DBdWb0bj.js";
-import { t as _ } from "./chunk-6AEJRKK7-D9IaQdwq.js";
-import { t as v } from "./rough.esm-rcMoXTJj.js";
-//#region node_modules/khroma/dist/methods/transparentize.js
+import { n as e } from "./chunk-Y2CYZVJY-BAad7w_K.js";
+import { p as t } from "./src-Pe71xVTz.js";
+import { H as n, U as r, a as i, b as a, c as o, f as s, it as c, nt as l, q as u, rt as d, tt as f, v as p, w as m, y as h } from "./chunk-O7XYJQB3-BDucxjeL.js";
+import { i as g } from "./chunk-ZIGJFQKS-JoSqKBE3.js";
+import { t as _ } from "./chunk-6AEJRKK7-D1W4b1Ir.js";
+import { t as v } from "./rough.esm-Cvc79rxE.js";
+//#region ../../node_modules/khroma/dist/methods/transparentize.js
 var y = (e, t) => d(e, "a", -t), b = 1e-10;
 function x(e, t) {
 	let n = C(e), r = n.filter((t) => S(t, e)), i = 0, a = 0, o = [];
@@ -908,7 +908,7 @@ function we(e, t = {}) {
 	}));
 }
 //#endregion
-//#region node_modules/mermaid/dist/chunks/mermaid.core/vennDiagram-UO4OBE2U.mjs
+//#region ../../node_modules/mermaid/dist/chunks/mermaid.core/vennDiagram-UO4OBE2U.mjs
 var W = (function() {
 	var t = /* @__PURE__ */ e(function(e, t, n, r) {
 		for (n ||= {}, r = e.length; r--; n[e[r]] = t);

package/dist/vite.js

@@ -1,18 +1,2 @@
-//#region lib/vite/index.ts
-function e() {
-	let e = /[A-Za-z_$][\w$]*\(\s*(['"])#standard-fonts\/(\w+)\1\s*\)/g;
-	return {
-		name: "nxgt-material:pdfkit-standard-fonts",
-		enforce: "pre",
-		transform(t, n) {
-			if (!n.includes("pdfkit") || !t.includes("#standard-fonts/")) return null;
-			let r = /* @__PURE__ */ new Set(), i = t.replace(e, (e, t, n) => (r.add(n), `__stdFont_${n}`));
-			return i.includes("#standard-fonts/") && this.error(`${n} still references '#standard-fonts/' after the transform — pdfkit changed how it loads its standard fonts. See the doc comment on pdfkitStandardFonts() in the /vite entry.`), {
-				code: `${[...r].map((e) => `import __stdFont_${e} from './standard-fonts/${e}.mjs';`).join("\n")}\n${i}`,
-				map: null
-			};
-		}
-	};
-}
-//#endregion
+import { pdfkitStandardFonts as e } from "@nxgt/material-core/vite";
 export { e as pdfkitStandardFonts };

package/dist/wardley-WFR3VGLG-DnLHjx6k.js

@@ -0,0 +1,3 @@
+import "./chunk-FOHPRMQF-DBc3Omt0.js";
+import { i as e } from "./mermaid-parser.core-BXD_TD1T.js";
+export { e as createWardleyServices };

package/dist/{wardleyDiagram-VNRHLVJA-Dw4YgRiQ.js → wardleyDiagram-VNRHLVJA-CZHdSrpN.js}

@@ -1,11 +1,11 @@
-import { n as e } from "./mermaid-parser.core-Cz-MfB4Z.js";
-import { n as t } from "./chunk-Y2CYZVJY-i11wjrBe.js";
-import { m as n } from "./src-CNRY2AUH.js";
-import { D as r, H as i, U as a, a as o, b as s, c, q as l, v as u, w as d, x as f, y as p } from "./chunk-O7XYJQB3-WMQqqzRb.js";
-import { i as m } from "./chunk-ZIGJFQKS-DBdWb0bj.js";
-import { t as h } from "./chunk-6AEJRKK7-D9IaQdwq.js";
-import { t as g } from "./chunk-JWPE2WC7-Ccb0QaC8.js";
-//#region node_modules/mermaid/dist/chunks/mermaid.core/wardleyDiagram-VNRHLVJA.mjs
+import { n as e } from "./mermaid-parser.core-BXD_TD1T.js";
+import { n as t } from "./chunk-Y2CYZVJY-BAad7w_K.js";
+import { m as n } from "./src-Pe71xVTz.js";
+import { D as r, H as i, U as a, a as o, b as s, c, q as l, v as u, w as d, x as f, y as p } from "./chunk-O7XYJQB3-BDucxjeL.js";
+import { i as m } from "./chunk-ZIGJFQKS-JoSqKBE3.js";
+import { t as h } from "./chunk-6AEJRKK7-D1W4b1Ir.js";
+import { t as g } from "./chunk-JWPE2WC7-BGVSGRTC.js";
+//#region ../../node_modules/mermaid/dist/chunks/mermaid.core/wardleyDiagram-VNRHLVJA.mjs
 var _ = /* @__PURE__ */ t((e, t) => {
 	let n = e <= 1 ? e * 100 : e;
 	if (n < 0 || n > 100) throw Error(`${t} must be between 0-1 (decimal) or 0-100 (percentage). Received: ${e}`);

package/dist/{xychartDiagram-PMCCYNJV-DtuDs9I7.js → xychartDiagram-PMCCYNJV-CYfbQA4q.js}

@@ -1,22 +1,22 @@
-import { n as e } from "./chunk-Y2CYZVJY-i11wjrBe.js";
-import { m as t } from "./src-CNRY2AUH.js";
-import { D as n, H as r, U as i, a, b as o, c as s, f as c, q as l, v as u, w as d, y as f, z as p } from "./chunk-O7XYJQB3-WMQqqzRb.js";
-import { t as m } from "./linear-bD_QoED_.js";
-import { t as h } from "./ordinal-D_ZgubzR.js";
-import { t as g } from "./init-MwSGRDIl.js";
-import { i as _ } from "./chunk-ZIGJFQKS-DBdWb0bj.js";
-import { t as v } from "./line-UP6dkL36.js";
-import { t as y } from "./chunk-6AEJRKK7-D9IaQdwq.js";
-import "./chunk-742MDFTN-BIhVe9GR.js";
-import { t as b } from "./chunk-MBY4JIJT-HYVRUG_P.js";
-//#region node_modules/d3-array/src/range.js
+import { n as e } from "./chunk-Y2CYZVJY-BAad7w_K.js";
+import { m as t } from "./src-Pe71xVTz.js";
+import { D as n, H as r, U as i, a, b as o, c as s, f as c, q as l, v as u, w as d, y as f, z as p } from "./chunk-O7XYJQB3-BDucxjeL.js";
+import { t as m } from "./linear-CobEklb6.js";
+import { t as h } from "./ordinal-BCmOO3Sy.js";
+import { t as g } from "./init-O6p85zx5.js";
+import { i as _ } from "./chunk-ZIGJFQKS-JoSqKBE3.js";
+import { t as v } from "./line-CAYWvrRN.js";
+import { t as y } from "./chunk-6AEJRKK7-D1W4b1Ir.js";
+import "./chunk-742MDFTN-Bh_u1X2k.js";
+import { t as b } from "./chunk-MBY4JIJT-ODeZ1ugd.js";
+//#region ../../node_modules/d3-array/src/range.js
 function x(e, t, n) {
 	e = +e, t = +t, n = (i = arguments.length) < 2 ? (t = e, e = 0, 1) : i < 3 ? 1 : +n;
 	for (var r = -1, i = Math.max(0, Math.ceil((t - e) / n)) | 0, a = Array(i); ++r < i;) a[r] = e + r * n;
 	return a;
 }
 //#endregion
-//#region node_modules/d3-scale/src/band.js
+//#region ../../node_modules/d3-scale/src/band.js
 function S() {
 	var e = h().unknown(void 0), t = e.domain, n = e.range, r = 0, i = 1, a, o, s = !1, c = 0, l = 0, u = .5;
 	delete e.unknown;
@@ -53,7 +53,7 @@ function S() {
 	}, g.apply(d(), arguments);
 }
 //#endregion
-//#region node_modules/mermaid/dist/chunks/mermaid.core/xychartDiagram-PMCCYNJV.mjs
+//#region ../../node_modules/mermaid/dist/chunks/mermaid.core/xychartDiagram-PMCCYNJV.mjs
 var C = (function() {
 	var t = /* @__PURE__ */ e(function(e, t, n, r) {
 		for (n ||= {}, r = e.length; r--; n[e[r]] = t);

package/docs/getting-started.md

@@ -187,7 +187,10 @@ The module also:
 - adds the package to `build.transpile`, so it is bundled into the server
   build ([SSR](guides/ssr.md#nuxt));
 - installs Pinia when the app has none;
-- pre-bundles the CommonJS dependency `jsbarcode` for Vite.
+- pre-bundles the CommonJS dependency `jsbarcode` for Vite;
+- adds pdfkit's standard-font files to `nitro.externals.traceInclude`, so a
+  production server renders PDFs from `.output` alone
+  ([troubleshooting](troubleshooting.md#cannot-find-module-pdfkitjsstandard-fontshelveticacjs)).
 
 It does **not** add the stylesheet: import it yourself as in [Styles](#styles).
 It does **not** register what is outside `/components`: `I18nProvider`, the
@@ -382,3 +385,23 @@ buttons, `Filter` shows its inline actions and trigger label, and
 `Notifications`, `Gallery`, `ImageCropperDialog` and `PaneLayout` open from
 their trigger without `v-model:open`. `LocationMarker` shows a "You are here"
 tooltip. Update visual snapshots accordingly.
+
+### 0.23.0: `@nxgt/material-core` comes with it
+
+The PDF model and renderer, the print formatters and the other
+framework-free helpers now live in `@nxgt/material-core`, which
+`@nxgt/material-vue` depends on and re-exports at the same subpaths. Nothing
+changes in your imports or your `package.json`: your install adds
+`@nxgt/material-core` as a dependency.
+
+The one thing to check: a server bundle that inlines `@nxgt/material-vue`
+(`ssr.noExternal`, or a bundle step with an `--external` list), or that runs
+without `node_modules`, must include `@nxgt/material-core` as well
+([details](troubleshooting.md#cannot-find-package-nxgtmaterial-core)):
+
+```ts
+// vite.config.ts
+export default defineConfig({
+  ssr: { noExternal: ['@nxgt/material-vue', '@nxgt/material-core'] },
+});
+```

package/docs/guides/pdf.md

@@ -271,8 +271,11 @@ as `invoicePdf(invoice, language)` does above.
 
 The PDFs use the fourteen standard PDF fonts, loaded by pdfkit at runtime from
 a specifier no bundler resolves. Nitro keeps `@react-pdf/renderer` external by
-default, where that works. When the runtime image has **no `node_modules`**
-(the server inlined into one artifact), bundle the fonts in:
+default, where that works: the Nuxt module adds pdfkit's font files to what
+Nitro copies into `.output/server/node_modules`, which its tracer would miss
+([troubleshooting](../troubleshooting.md#cannot-find-module-pdfkitjsstandard-fontshelveticacjs)).
+When the runtime image has **no `node_modules`** (the server inlined into one
+artifact, `nitro: { noExternals: true }`), bundle the fonts in:
 
 ```ts
 // nuxt.config.ts
@@ -288,10 +291,14 @@ import { pdfkitStandardFonts } from '@nxgt/material-vue/vite';
 
 export default defineConfig({
   plugins: [pdfkitStandardFonts()],
-  ssr: { noExternal: ['@nxgt/material-vue'] },
+  ssr: { noExternal: ['@nxgt/material-vue', '@nxgt/material-core'] },
 });
 ```
 
+`@nxgt/material-core`, which the library's built code imports by name, is
+bundled with it: leave it out and the server fails at boot with
+[`Cannot find package '@nxgt/material-core'`](../troubleshooting.md#cannot-find-package-nxgtmaterial-core).
+
 The plugin fails the build if a reference survives, rather than the first
 request ([troubleshooting](../troubleshooting.md#cannot-find-module-standard-fontshelvetica)).
 

package/docs/guides/ssr.md

@@ -14,10 +14,15 @@ import { defineConfig } from 'vite';
 
 export default defineConfig({
   plugins: [vue()],
-  ssr: { noExternal: ['@nxgt/material-vue'] },
+  ssr: { noExternal: ['@nxgt/material-vue', '@nxgt/material-core'] },
 });
 ```
 
+`@nxgt/material-core` is a dependency of this package that its built code
+imports by name: bundle it together with `@nxgt/material-vue`, or a server run
+without it in `node_modules` fails at boot with
+[`Cannot find package '@nxgt/material-core'`](../troubleshooting.md#cannot-find-package-nxgtmaterial-core).
+
 With that, **every module the barrels reach is evaluated when the server
 boots**, whether or not a page renders the component. A browser global touched
 at import time would crash the server before it answers anything.
@@ -262,6 +267,7 @@ export default defineNuxtPlugin((nuxtApp) => {
 | --- | --- | --- |
 | `ReferenceError: window is not defined` at server boot | `leaflet` (or another browser-only module) imported statically by your server code | Import maps from `@nxgt/material-vue/map` only, never `leaflet` directly; `clientOnly(defineAsyncComponent(() => import('./MapView.vue')))` for your own |
 | `ReferenceError: DOMMatrix is not defined` at server boot | a static `pdfjs-dist` import in your own code | `import()` + `clientOnly`, or use `PdfReader` |
+| Built server fails at boot with `Cannot find package '@nxgt/material-core'` | the library bundled into the server, its core left out | Add `@nxgt/material-core` wherever `@nxgt/material-vue` is in `ssr.noExternal` or `--external` ([troubleshooting](../troubleshooting.md#cannot-find-package-nxgtmaterial-core)) |
 | Built server answers nothing on every route; its log names a module it cannot find | a bundled dependency whose loader resolves paths at runtime | Keep such a dependency out of your server bundle (`import()` + `clientOnly`), or leave it external |
 | A map renders as an empty box on the first paint | leaflet initialises in the browser only | Expected: wrap it in `<ClientOnly>` ([maps](maps.md#browser-only)) |
 | `getActivePinia()` was called but there was no active Pinia | a widget rendered on the server before Pinia was installed | `app.use(createPinia())` in the server entry too; in Nuxt the module does it |

package/docs/roadmap.md

@@ -88,6 +88,15 @@ Nothing in progress right now; see Next.
 
 ## Shipped
 
+- **One copy of the framework-free code, shared with `@nxgt/material`** —
+  the PDF document model and renderer, the print formatters, the PDF file
+  helpers, `PdfReader`'s page geometry, scroll spy and search, the
+  `CurrencyField` decimals, the fields' blur rule and `pdfkitStandardFonts()`
+  now come from `@nxgt/material-core`, which your install adds on its own.
+  Every entry exports the same names with the same types, so nothing changes
+  in your imports or your Nuxt config; a server bundled without
+  `node_modules` bundles `@nxgt/material-core` too. 0.23.0.
+  ([troubleshooting](troubleshooting.md#cannot-find-package-nxgtmaterial-core))
 - **PdfReader, turned pages and a steady zoom** — a page the PDF turns
   (`/Rotate`) shows the right way up, the fit zoom settles once when the
   document opens instead of moving while you read, `@page-change` also reports

package/docs/troubleshooting.md

@@ -38,6 +38,7 @@ words in your error.
 - [`ReferenceError: localStorage is not defined`](#referenceerror-localstorage-is-not-defined)
 - [`Hydration completed but contains mismatches.`](#hydration-completed-but-contains-mismatches)
 - [`Failed to resolve component: LocationFormField`](#failed-to-resolve-component-locationformfield)
+- [`Cannot find package '@nxgt/material-core'`](#cannot-find-package-nxgtmaterial-core)
 
 **Pinia, router & forms**
 
@@ -58,6 +59,7 @@ words in your error.
 **PDF documents**
 
 - [`Cannot find module '#standard-fonts/Helvetica'`](#cannot-find-module-standard-fontshelvetica)
+- [`Cannot find module '…/pdfkit/js/standard-fonts/Helvetica.cjs'`](#cannot-find-module-pdfkitjsstandard-fontshelveticacjs)
 - [`still references '#standard-fonts/' after the transform`](#still-references-standard-fonts-after-the-transform)
 - [`renderToStream is a Node specific API` / `renderToBuffer is a Node specific API`](#rendertostream-is-a-node-specific-api--rendertobuffer-is-a-node-specific-api)
 - [PDF rendering fails on an edge runtime](#pdf-rendering-fails-on-an-edge-runtime)
@@ -724,6 +726,37 @@ import { I18nProvider } from '@nxgt/material-vue/i18n';
 </script>
 ```
 
+### `Cannot find package '@nxgt/material-core'`
+
+**When:** a built SSR server fails at boot, before it answers anything. Bun
+prints `Cannot find module '@nxgt/material-core'` (or one of its subpaths),
+for the same cause.
+**Why:** `@nxgt/material-vue` depends on `@nxgt/material-core` and its built
+code imports it by name. A server that inlines `@nxgt/material-vue`
+(`ssr.noExternal`, or a bundle step that inlines all but an `--external`
+list) but not its core keeps that import, and a runtime without
+`node_modules` (or with a pruned one that holds only your app's direct
+dependencies) cannot resolve it.
+**Fix:** treat the two as one. Bundle both:
+
+```ts
+// vite.config.ts
+import { defineConfig } from 'vite';
+
+export default defineConfig({
+  ssr: { noExternal: ['@nxgt/material-vue', '@nxgt/material-core'] },
+});
+```
+
+or leave both external, with a `node_modules` that keeps
+`@nxgt/material-vue`'s dependencies:
+`--external @nxgt/material-vue --external @nxgt/material-core`.
+
+In Nuxt there is nothing to do: the module transpiles `@nxgt/material-vue`,
+and Nitro traces `@nxgt/material-core` into `.output/server/node_modules`
+like any dependency — or inlines it with everything else under
+`nitro: { noExternals: true }`.
+
 ## Pinia, router & forms
 
 ### `"getActivePinia()" was called but there was no active Pinia`
@@ -976,8 +1009,9 @@ single artifact that runs without `node_modules`.
 **Why:** pdfkit, under `@react-pdf/renderer`, loads its standard fonts with a
 runtime `require('#standard-fonts/<name>')`, a specifier private to pdfkit
 that no bundler resolves. Inlined into your server, the call looks for it next
-to your build output. Nitro keeps the renderer external by default, where
-pdfkit finds its fonts; this appears when it is inlined.
+to your build output. Nitro keeps the renderer external by default, and the
+Nuxt module has it copy the fonts into `.output/server/node_modules`; this
+appears when the renderer is inlined.
 **Fix:** bundle the fonts in. In Nuxt:
 
 ```ts
@@ -997,16 +1031,60 @@ import { pdfkitStandardFonts } from '@nxgt/material-vue/vite';
 
 export default defineConfig({
   plugins: [pdfkitStandardFonts()],
-  ssr: { noExternal: ['@nxgt/material-vue'] },
+  ssr: { noExternal: ['@nxgt/material-vue', '@nxgt/material-core'] },
 });
 ```
 
+`@nxgt/material-core` is inlined with the library, which imports it by name
+([SSR & build](#cannot-find-package-nxgtmaterial-core)).
 When the runtime image keeps `node_modules`, leaving the renderer external
 works too, and keeps pdfkit out of the artifact. A `resolve.alias` for
 `#standard-fonts/` does not help: the specifier is a string passed to
 `require` at runtime, never seen by the resolver. See
 [PDF documents](guides/pdf.md#fonts-on-a-fully-inlined-server).
 
+### `Cannot find module '…/pdfkit/js/standard-fonts/Helvetica.cjs'`
+
+**When:** on every PDF a Nuxt or Nitro production server renders
+(`node .output/server/index.mjs`), while `nuxi dev` renders fine. The path
+points into `.output/server/node_modules/pdfkit/`.
+**Why:** Nitro copies the server's external dependencies into
+`.output/server/node_modules`, keeping only the files its tracer finds.
+pdfkit loads its fonts with a runtime `require('#standard-fonts/<name>')`,
+which resolves to a `.cjs` file the tracer never sees, so pdfkit is copied
+without them.
+**Fix:** use the Nuxt module (`modules: ['@nxgt/material-vue/nuxt']`), which
+adds pdfkit's font files to Nitro's trace. A Nitro server without Nuxt adds
+them itself:
+
+```ts
+// nitro.config.ts
+import { createRequire } from 'node:module';
+
+const require = createRequire(import.meta.url);
+const fromRenderer = createRequire(require.resolve('@react-pdf/renderer'));
+const fonts = ['Courier', 'CourierBold', 'CourierBoldOblique', 'CourierOblique',
+  'Helvetica', 'HelveticaBold', 'HelveticaBoldOblique', 'HelveticaOblique',
+  'Symbol', 'TimesBold', 'TimesBoldItalic', 'TimesItalic', 'TimesRoman',
+  'ZapfDingbats'];
+
+export default defineNitroConfig({
+  externals: {
+    // require.resolve picks pdfkit's `require` export: the .cjs it loads.
+    traceInclude: fonts.map((font) =>
+      fromRenderer.resolve(`pdfkit/standard-fonts/${font}`)),
+  },
+});
+```
+
+With `nitro.externals` set to a boolean, the module leaves Nitro's trace
+alone: add the `traceInclude` above yourself (as an `externals` object), or
+inline the server and use `bundleStandardFonts`. A server built with
+`noExternals` has no `node_modules` to trace into: use
+`bundleStandardFonts` instead ([above](#cannot-find-module-standard-fontshelvetica)).
+When the module cannot resolve pdfkit's fonts although `@react-pdf/renderer`
+is installed, `nuxi build` prints a `pdf fonts:` warning naming what failed.
+
 ### `still references '#standard-fonts/' after the transform`
 
 **When:** at build, from the `nxgt-material:pdfkit-standard-fonts` plugin

package/lib/nuxt/module.ts

@@ -5,10 +5,15 @@ import {
 	createResolver,
 	defineNuxtModule,
 	extendViteConfig,
+	useLogger,
 } from '@nuxt/kit';
 import { COMPOSABLE_IMPORTS, I18N_IMPORTS } from './auto-imports';
 import { COMPONENT_NAMES } from './component-names';
-import { addPdfFontsPlugin } from './pdf-fonts';
+import {
+	addPdfFontsPlugin,
+	addPdfFontsTrace,
+	pdfkitStandardFontFiles,
+} from './pdf-fonts';
 
 export type ModuleOptions = {
 	/** Prepended to auto-imported component names. Empty by default. */
@@ -21,7 +26,9 @@ export type ModuleOptions = {
 		/**
 		 * Bundle pdfkit's standard fonts into the Nitro server, for
 		 * `@nxgt/material-vue/pdf` in a server whose runtime image has no
-		 * `node_modules`. Default false: Nitro keeps the renderer external.
+		 * `node_modules` (`nitro.noExternals`). Default false: Nitro keeps the
+		 * renderer external, and the module adds pdfkit's font files to what
+		 * Nitro traces into `.output/server/node_modules`.
 		 */
 		bundleStandardFonts?: boolean;
 	};
@@ -48,7 +55,7 @@ export default defineNuxtModule<ModuleOptions>({
 	setup(
 		options: ModuleOptions,
 		nuxt: {
-			options: { build: { transpile: string[] } };
+			options: { rootDir: string; build: { transpile: string[] } };
 			hook: (name: 'nitro:config', fn: (config: object) => void) => void;
 		},
 	) {
@@ -91,9 +98,19 @@ export default defineNuxtModule<ModuleOptions>({
 			}
 		}
 
-		if (options.pdf?.bundleStandardFonts) {
-			nuxt.hook('nitro:config', (config) => addPdfFontsPlugin(config));
-		}
+		// @nxgt/material-core is not transpiled: Nitro traces it into
+		// .output/server/node_modules like any external, and inlines it with
+		// everything else under noExternals.
+		nuxt.hook('nitro:config', (config) => {
+			const logger = useLogger('@nxgt/material-vue');
+			addPdfFontsTrace(
+				config,
+				pdfkitStandardFontFiles(nuxt.options.rootDir, (message) =>
+					logger.warn(`pdf fonts: ${message}`),
+				),
+			);
+			if (options.pdf?.bundleStandardFonts) addPdfFontsPlugin(config);
+		});
 
 		addPlugin(resolver.resolve('./runtime/plugin'));
 	},

package/lib/nuxt/pdf-fonts.ts

@@ -1,14 +1,18 @@
+import { createRequire } from 'node:module';
+import { join } from 'node:path';
 import { pdfkitStandardFonts } from '../vite/index';
 
 type NitroConfigLike = {
 	rollupConfig?: { plugins?: unknown };
+	externals?: boolean | { traceInclude?: string[] };
 };
 
 /**
  * Adds `pdfkitStandardFonts()` to a Nitro config's Rollup plugins, for the
  * `pdf.bundleStandardFonts` module option. Only a fully inlined server
  * (no `node_modules` in the runtime image) needs it: Nitro keeps
- * `@react-pdf/renderer` external by default, where pdfkit finds its fonts.
+ * `@react-pdf/renderer` external by default, and `addPdfFontsTrace` copies
+ * the fonts pdfkit loads into `.output/server/node_modules`.
  */
 export function addPdfFontsPlugin(config: NitroConfigLike): void {
 	config.rollupConfig ??= {};
@@ -16,3 +20,99 @@ export function addPdfFontsPlugin(config: NitroConfigLike): void {
 	const plugins = Array.isArray(current) ? current : current ? [current] : [];
 	config.rollupConfig.plugins = [...plugins, pdfkitStandardFonts()];
 }
+
+/** The fourteen standard PDF fonts, as pdfkit exports them. */
+export const PDFKIT_STANDARD_FONTS = [
+	'Courier',
+	'CourierBold',
+	'CourierBoldOblique',
+	'CourierOblique',
+	'Helvetica',
+	'HelveticaBold',
+	'HelveticaBoldOblique',
+	'HelveticaOblique',
+	'Symbol',
+	'TimesBold',
+	'TimesBoldItalic',
+	'TimesItalic',
+	'TimesRoman',
+	'ZapfDingbats',
+] as const;
+
+const isNotFound = (error: unknown) =>
+	(error as { code?: string } | null)?.code === 'MODULE_NOT_FOUND';
+
+/**
+ * pdfkit's standard-font modules as the app at `rootDir` loads them: through
+ * pdfkit's own `standard-fonts/<Name>` exports under the `require` condition
+ * (the `.cjs` files its runtime `require('#standard-fonts/<Name>')` reads),
+ * for the pdfkit `@react-pdf/renderer` depends on and the one
+ * `@react-pdf/font` depends on, without duplicates.
+ *
+ * None, silently, when the app does not install `@react-pdf/renderer` (an
+ * optional peer). Any other failure is passed to `warn` — a font that
+ * cannot be resolved here is a PDF route that fails in production.
+ */
+export function pdfkitStandardFontFiles(
+	rootDir: string,
+	warn: (message: string) => void = () => {},
+): string[] {
+	let renderer: string;
+	try {
+		renderer = createRequire(join(rootDir, 'package.json')).resolve(
+			'@react-pdf/renderer',
+		);
+	} catch (error) {
+		if (!isNotFound(error)) {
+			warn(`could not resolve @react-pdf/renderer: ${String(error)}`);
+		}
+		return [];
+	}
+	const fromRenderer = createRequire(renderer);
+	const owners: [string, ReturnType<typeof createRequire>][] = [
+		['@react-pdf/renderer', fromRenderer],
+	];
+	try {
+		owners.push([
+			'@react-pdf/font',
+			createRequire(fromRenderer.resolve('@react-pdf/font')),
+		]);
+	} catch (error) {
+		warn(`could not resolve @react-pdf/font: ${String(error)}`);
+	}
+	const files = new Set<string>();
+	for (const [owner, from] of owners) {
+		for (const font of PDFKIT_STANDARD_FONTS) {
+			try {
+				files.add(from.resolve(`pdfkit/standard-fonts/${font}`));
+			} catch (error) {
+				warn(
+					`could not resolve pdfkit's ${font} font for ${owner}: ${String(error)}`,
+				);
+			}
+		}
+	}
+	return [...files];
+}
+
+/**
+ * Adds pdfkit's standard fonts to what Nitro traces into
+ * `.output/server/node_modules`. pdfkit loads them with a runtime
+ * `require('#standard-fonts/<name>')`, which resolves to a `.cjs` file its
+ * tracer never sees: without this, a default Nuxt build copies pdfkit but not
+ * those files, and every PDF rendered on the server fails with
+ * `Cannot find module '…/pdfkit/js/standard-fonts/Helvetica.cjs'`.
+ * Nothing changes for a server built with `noExternals`, which traces nothing,
+ * nor for an `externals` set to a boolean, which is left as it is.
+ */
+export function addPdfFontsTrace(
+	config: NitroConfigLike,
+	fontFiles: string[],
+): void {
+	if (fontFiles.length === 0 || typeof config.externals === 'boolean') return;
+	config.externals ??= {};
+	config.externals.traceInclude = [
+		...(config.externals.traceInclude ?? []),
+		...fontFiles,
+	];
+}