@nxgt/material 2.3.0 → 2.4.0

package/README.md

@@ -127,6 +127,7 @@ into a tarball. A missing sheet renders nothing, with no error and no fallback.
 | `@nxgt/material/print` | PDF documents over `@react-pdf/renderer`: the `PrintDocument` page shell, the print blocks, and `PrintDataTable`, `PrintKeyValue` and `PrintMetric` from column definitions and plain rows; documents as plain data (`pdfDocument` and its builders); `downloadPdf`, `openPdf`, `usePdfFile` and `pdfResponse` to get the file in one call — **its own entry, and not in the barrel above** ([printing guide](https://cdn.jsdelivr.net/npm/@nxgt/material@2/docs/guides/printing.md)) |
 | `@nxgt/material/map` | Leaflet maps, markers, a location field — **its own entry, not in the barrel, and browser-only** ([maps guide](https://cdn.jsdelivr.net/npm/@nxgt/material@2/docs/guides/maps.md)) |
 | `@nxgt/material/vite` | build-time helpers for consumers: `pdfkitStandardFonts()` ([printing guide](https://cdn.jsdelivr.net/npm/@nxgt/material@2/docs/guides/printing.md)) |
+| `@nxgt/material/next` | `withNxgtPrint(nextConfig)`: the `next.config.ts` a Next.js route handler that imports `/print` needs, `output: 'standalone'` included. Node only, no dependency on `next` ([printing guide](https://cdn.jsdelivr.net/npm/@nxgt/material@2/docs/guides/printing.md#nextjs-serverexternalpackages-and-output-standalone)) |
 | `@nxgt/material/hooks` | `useTheme`, `useIsClient`, `useIsMobile`, `useLocalizedDate`, … ([helpers](https://cdn.jsdelivr.net/npm/@nxgt/material@2/docs/guides/helpers.md#nxgtmaterialhooks)) |
 | `@nxgt/material/dnd` | `@dnd-kit` primitives ([helpers](https://cdn.jsdelivr.net/npm/@nxgt/material@2/docs/guides/helpers.md#nxgtmaterialdnd)) |
 | `@nxgt/material/i18n` | `I18nProvider`, `mergeResources`, `createTranslator` ([i18n guide](https://cdn.jsdelivr.net/npm/@nxgt/material@2/docs/guides/i18n.md)) |
@@ -218,6 +219,21 @@ watermark. Its `language` is a prop, because the PDF renders outside your
 current, and a document can also be plain data built with `pdfDocument`
 (experimental). More: [Printing](https://cdn.jsdelivr.net/npm/@nxgt/material@2/docs/guides/printing.md#rendering-the-document).
 
+In Next.js, a route handler that calls `pdfResponse` needs its
+`next.config.ts` wrapped:
+
+```ts
+// next.config.ts
+import { withNxgtPrint } from '@nxgt/material/next';
+
+export default withNxgtPrint({ output: 'standalone' });
+```
+
+It adds `'@nxgt/material'` to `serverExternalPackages` and, when
+`@react-pdf/renderer` is installed, pdfkit's `.cjs` fonts to
+`outputFileTracingIncludes`, merged with what your config already has. More:
+[Next.js](https://cdn.jsdelivr.net/npm/@nxgt/material@2/docs/guides/printing.md#nextjs-serverexternalpackages-and-output-standalone).
+
 ## Guides
 
 Each area a consumer starts from has its own page under `docs/guides/`.
@@ -228,7 +244,7 @@ Each area a consumer starts from has its own page under `docs/guides/`.
 | [i18n](https://cdn.jsdelivr.net/npm/@nxgt/material@2/docs/guides/i18n.md) | adding your strings next to the package's, switching language, translated Zod messages, SSR without a text mismatch |
 | [App shell](https://cdn.jsdelivr.net/npm/@nxgt/material@2/docs/guides/app-shell.md) | laying out an app with `ActivityLayout`, its `items`, the active entry and breadcrumbs (needs a data router) |
 | [Theming](https://cdn.jsdelivr.net/npm/@nxgt/material@2/docs/guides/theming.md) | changing colours, radius or fonts, dark mode, using the compiled CSS without Tailwind |
-| [Printing](https://cdn.jsdelivr.net/npm/@nxgt/material@2/docs/guides/printing.md) | producing PDFs with `@nxgt/material/print` and getting the file in one call (download, new tab, preview, server `Response`) — its own entry since 2.0.0, with optional peers and a bundling trap on SSR servers |
+| [Printing](https://cdn.jsdelivr.net/npm/@nxgt/material@2/docs/guides/printing.md) | producing PDFs with `@nxgt/material/print` and getting the file in one call (download, new tab, preview, server `Response`) — its own entry since 2.0.0, with optional peers, a bundling trap on SSR servers, and the `next.config.ts` a Next.js route handler (and `output: 'standalone'`) needs |
 | [Maps](https://cdn.jsdelivr.net/npm/@nxgt/material@2/docs/guides/maps.md) | using `@nxgt/material/map` — browser-only, optional leaflet peers, `map.css` |
 | [SSR](https://cdn.jsdelivr.net/npm/@nxgt/material@2/docs/guides/ssr.md) | rendering on a server: what the barrels guarantee, and `import()` + `clientOnly` for browser-only code |
 | [Helpers](https://cdn.jsdelivr.net/npm/@nxgt/material@2/docs/guides/helpers.md) | the non-component subpaths: `/lib`, `/hooks`, `/i18n`, `/models`, `/types`, `/dnd` |
@@ -495,6 +511,8 @@ The ones that cost the most time. Every error message, with its fix, is in
 | `ERESOLVE` / `Conflicting peer dependency: @react-pdf/renderer` after upgrading | `bun add @react-pdf/renderer@^4.9` ([troubleshooting](https://cdn.jsdelivr.net/npm/@nxgt/material@2/docs/troubleshooting.md#conflicting-peer-dependency-react-pdfrenderer)) |
 | `renderToBuffer is a Node specific API` on a server, or PDFs fail on an edge runtime | render on Node 18+ or Bun, with react-pdf's Node build ([troubleshooting](https://cdn.jsdelivr.net/npm/@nxgt/material@2/docs/troubleshooting.md#rendertobuffer-is-a-node-specific-api)) |
 | `Cannot find module '#standard-fonts/Helvetica'` on a built server | leave the library external, or `pdfkitStandardFonts()` ([printing](https://cdn.jsdelivr.net/npm/@nxgt/material@2/docs/guides/printing.md#bundling-print-into-an-ssr-server)) |
+| `(0 , t.createContext) is not a function` in `next build`, for a route handler that imports `/print` | `export default withNxgtPrint(config)` from `@nxgt/material/next`, or `serverExternalPackages: ['@nxgt/material']` by hand ([troubleshooting](https://cdn.jsdelivr.net/npm/@nxgt/material@2/docs/troubleshooting.md#typeerror-0--tcreatecontext-is-not-a-function-in-a-nextjs-route-handler)) |
+| Next.js `output: 'standalone'`: the PDF route answers `500`, `Cannot find module '…/pdfkit/js/standard-fonts/Helvetica.cjs'` | `withNxgtPrint(config)` from `@nxgt/material/next`, or pdfkit's `.cjs` fonts in `outputFileTracingIncludes` by hand ([printing](https://cdn.jsdelivr.net/npm/@nxgt/material@2/docs/guides/printing.md#nextjs-serverexternalpackages-and-output-standalone)) |
 
 ## Documentation
 

package/dist/{_Uint8Array-BDK6FjpM.js → _Uint8Array-DEXn42kj.js}

@@ -1,4 +1,4 @@
-import { S as e, T as t, d as n, g as r, l as i, u as a, v as o, w as s, x as c } from "./translator-BfyVF7Ej.js";
+import { S as e, T as t, d as n, g as r, l as i, u as a, v as o, w as s, x as c } from "./translator-Cfug7hC5.js";
 //#region ../../node_modules/lodash-es/_isIndex.js
 var l = 9007199254740991, u = /^(?:0|[1-9]\d*)$/;
 function d(e, t) {

package/dist/{blockDiagram-BEXU5L5S-C8q-lXgt.js → blockDiagram-BEXU5L5S-BfTOHIiP.js}

@@ -1,4 +1,4 @@
-import { t as e } from "./graphlib-DovxbouT.js";
+import { t as e } from "./graphlib-xC_C3Pqu.js";
 import { n as t, t as n } from "./src-CJ8DNrI1.js";
 import { A as r, B as i, C as a, D as o, E as s, F as c, G as l, H as u, I as d, L as f, M as p, N as m, O as h, P as g, R as _, T as v, U as ee, V as y, W as b, b as x, j as S, k as C, l as w, v as T, w as E, z as D } from "./chunk-ZIGJFQKS-HDJ6e6OJ.js";
 import { n as O } from "./chunk-Y2CYZVJY-BAad7w_K.js";
@@ -12,7 +12,7 @@ import "./chunk-7PRAP22T-DIiYRAce.js";
 import { i as se, n as ce, o as le, r as ue, s as de } from "./chunk-J5ZVWO5B-DmRRmhon.js";
 import "./chunk-7INBJB4K-Dg64CbhT.js";
 import { i as fe, r as pe } from "./chunk-5DYCD2WN-Bqi3iL5i.js";
-import { a as me, c as he, i as ge, l as _e } from "./chunk-Z7XXMR3K-CJmPL4k9.js";
+import { a as me, c as he, i as ge, l as _e } from "./chunk-Z7XXMR3K-_29B1gGc.js";
 //#region ../../node_modules/es-toolkit/dist/compat/predicate/isArray.mjs
 function ve(e) {
 	return Array.isArray(e);

package/dist/{chunk-3FUC2YCW-BGpNbruY.js → chunk-3FUC2YCW-CvWadu3l.js}

@@ -1,11 +1,11 @@
-import { t as e } from "./graphlib-DovxbouT.js";
+import { t as e } from "./graphlib-xC_C3Pqu.js";
 import { n as t } from "./src-CJ8DNrI1.js";
 import { g as n } from "./chunk-ZIGJFQKS-HDJ6e6OJ.js";
 import { n as r } from "./chunk-Y2CYZVJY-BAad7w_K.js";
 import { b as i, x as a } from "./chunk-O7XYJQB3-C87zK8E5.js";
 import { o } from "./chunk-7INBJB4K-Dg64CbhT.js";
 import { i as s, n as c, r as l, t as u } from "./chunk-5DYCD2WN-Bqi3iL5i.js";
-import { a as d, c as f, i as p, n as m, r as h, t as g, u as _ } from "./chunk-Z7XXMR3K-CJmPL4k9.js";
+import { a as d, c as f, i as p, n as m, r as h, t as g, u as _ } from "./chunk-Z7XXMR3K-_29B1gGc.js";
 import { r as v, t as y } from "./chunk-UA2S7LBM-B0LGFGu3.js";
 //#region ../../node_modules/mermaid/dist/chunks/mermaid.core/chunk-3FUC2YCW.mjs
 function b(e, { edgePathsClass: t = "edges edgePaths" } = {}) {

package/dist/{chunk-7M6MHVWA-_-i4Sb1c.js → chunk-7M6MHVWA-C5InBPBS.js}

@@ -9,7 +9,7 @@ import { a as b } from "./chunk-7INBJB4K-Dg64CbhT.js";
 import { t as x } from "./chunk-GWA4HPMP-CmsxMX3A.js";
 import { t as S } from "./chunk-XXDRQBXY-Bq4sFnO2.js";
 import { t as C } from "./chunk-WEXAMYUT-C-QP0DFq.js";
-import { r as w, t as T } from "./chunk-GNY47TPC-BJperC1X.js";
+import { r as w, t as T } from "./chunk-GNY47TPC-DmuI3Pyt.js";
 import { n as E, t as D } from "./chunk-LNGE3PJU-DJjGTS7O.js";
 //#region ../../node_modules/mermaid/dist/chunks/mermaid.core/chunk-7M6MHVWA.mjs
 var ie = "flowchart-", ae = class {

package/dist/{chunk-GNY47TPC-BJperC1X.js → chunk-GNY47TPC-DmuI3Pyt.js}

@@ -5,7 +5,7 @@ import { b as r, s as i } from "./chunk-O7XYJQB3-C87zK8E5.js";
 import { t as a } from "./chunk-DUW6YSOI-9R-v-IIp.js";
 import { o } from "./chunk-7INBJB4K-Dg64CbhT.js";
 import { r as s } from "./chunk-5DYCD2WN-Bqi3iL5i.js";
-import { a as c, c as l, i as u, l as d } from "./chunk-Z7XXMR3K-CJmPL4k9.js";
+import { a as c, c as l, i as u, l as d } from "./chunk-Z7XXMR3K-_29B1gGc.js";
 import { r as f } from "./chunk-UA2S7LBM-B0LGFGu3.js";
 //#region ../../node_modules/mermaid/dist/chunks/mermaid.core/chunk-GNY47TPC.mjs
 var p = {
@@ -30,7 +30,7 @@ var p = {
 ], h = /* @__PURE__ */ Object.create(null), g = /* @__PURE__ */ n((e) => {
 	for (let t of e) h[t.name] = t;
 }, "registerLayoutLoaders"), _ = /* @__PURE__ */ n(() => {
-	let e = /* @__PURE__ */ n(async () => await import("./elk-276RUBZZ-BALenDhN.js"), "loader");
+	let e = /* @__PURE__ */ n(async () => await import("./elk-276RUBZZ-wlL5a_cu.js"), "loader");
 	return [{
 		name: "elk",
 		loader: e,
@@ -45,11 +45,11 @@ var p = {
 	g([
 		{
 			name: "dagre",
-			loader: /* @__PURE__ */ n(async () => await import("./dagre-6A5THRUB-B11jdkPL.js"), "loader")
+			loader: /* @__PURE__ */ n(async () => await import("./dagre-6A5THRUB-XYMZ_mQX.js"), "loader")
 		},
 		{
 			name: "swimlane",
-			loader: /* @__PURE__ */ n(async () => await import("./swimlanes-2SLR337P-C406S8ui.js"), "loader")
+			loader: /* @__PURE__ */ n(async () => await import("./swimlanes-2SLR337P-D-5l9rBg.js"), "loader")
 		},
 		{
 			name: "cose-bilkent",

package/dist/{chunk-NETBCI7D-D0kbMnm0.js → chunk-NETBCI7D-otG0icF9.js}

@@ -1,5 +1,5 @@
 import { n as e } from "./chunk-Y2CYZVJY-BAad7w_K.js";
-import { o as t } from "./chunk-Z7XXMR3K-CJmPL4k9.js";
+import { o as t } from "./chunk-Z7XXMR3K-_29B1gGc.js";
 //#region ../../node_modules/mermaid/dist/chunks/mermaid.core/chunk-NETBCI7D.mjs
 var n = 5, r = 1e-5, i = 2, a = .6, o = 1e-6;
 function s(e) {

package/dist/{chunk-Z7XXMR3K-CJmPL4k9.js → chunk-Z7XXMR3K-_29B1gGc.js}

@@ -1,4 +1,4 @@
-import { st as e } from "./components-CRrswCsD.js";
+import { st as e } from "./components-BE6V-CHu.js";
 import { n as t, t as n } from "./src-CJ8DNrI1.js";
 import { _ as r, a as i, i as a, n as o, o as s, p as c, r as l, t as u, u as d, v as f } from "./step-Dt43c9X4.js";
 import { K as p, g as m, q as h, u as g } from "./chunk-ZIGJFQKS-HDJ6e6OJ.js";

package/dist/{classDiagram-v2-NBCMYWYE-DRoCWiaP.js → classDiagram-v2-NBCMYWYE-Cx_UQarg.js}

@@ -9,12 +9,12 @@ import "./chunk-7PRAP22T-DIiYRAce.js";
 import { i as v, n as y, o as b, r as x } from "./chunk-J5ZVWO5B-DmRRmhon.js";
 import "./chunk-7INBJB4K-Dg64CbhT.js";
 import "./chunk-5DYCD2WN-Bqi3iL5i.js";
-import "./chunk-Z7XXMR3K-CJmPL4k9.js";
+import "./chunk-Z7XXMR3K-_29B1gGc.js";
 import { t as S } from "./chunk-GWA4HPMP-CmsxMX3A.js";
 import { t as C } from "./chunk-XXDRQBXY-Bq4sFnO2.js";
 import { t as w } from "./chunk-WEXAMYUT-C-QP0DFq.js";
 import "./chunk-UA2S7LBM-B0LGFGu3.js";
-import { r as T, t as E } from "./chunk-GNY47TPC-BJperC1X.js";
+import { r as T, t as E } from "./chunk-GNY47TPC-DmuI3Pyt.js";
 //#region ../../node_modules/mermaid/dist/chunks/mermaid.core/classDiagram-v2-NBCMYWYE.mjs
 var D = (function() {
 	var e = /* @__PURE__ */ i(function(e, t, n, r) {

package/dist/{client-only.utils-qMX_CMiw.js → client-only.utils-DhcBUmau.js}

@@ -1,5 +1,5 @@
-import { C as e, S as t, h as n, l as r, m as i, p as a, u as o, v as s, w as c, x as l } from "./translator-BfyVF7Ej.js";
-import { a as u, c as d, d as f, i as p, n as m, r as h, t as g, u as _ } from "./_Uint8Array-BDK6FjpM.js";
+import { C as e, S as t, h as n, l as r, m as i, p as a, u as o, v as s, w as c, x as l } from "./translator-Cfug7hC5.js";
+import { a as u, c as d, d as f, i as p, n as m, r as h, t as g, u as _ } from "./_Uint8Array-DEXn42kj.js";
 import { L as v } from "./number.utils-BiBN2hWJ.js";
 import { Suspense as y, createContext as b, createElement as x, useContext as ee, useEffect as te, useMemo as S, useReducer as ne, useState as re, useSyncExternalStore as ie } from "react";
 //#region ../../node_modules/lodash-es/_WeakMap.js