@nxgt/material-core 0.1.0

package/dist/pdf-viewer/pdf-scroll-spy.d.ts

@@ -0,0 +1,43 @@
+/** A vertical extent on screen, as `getBoundingClientRect` gives it. */
+export type PdfBox = {
+    top: number;
+    bottom: number;
+};
+/**
+ * The page with the most of itself on screen, the first one on a tie; once
+ * scrolled to the end, the last page on screen, however little of it shows.
+ */
+export declare function mostVisiblePage(view: PdfBox & {
+    atEnd: boolean;
+}, pages: Iterable<readonly [number, PdfBox]>): number | null;
+/**
+ * Scrolls the page area around `node`, and nothing else: `scrollIntoView`
+ * would scroll the host page too. `block` puts `node` at the area's top or
+ * centre.
+ */
+export declare function scrollIntoArea(node: Element, block: 'start' | 'center', behavior?: ScrollBehavior): void;
+/**
+ * Keeps `node` at the top of the page area while the pages above it change
+ * size (the zoom fitting to page sizes still arriving), until the user
+ * scrolls, taps, clicks or types in the page area, or the returned function
+ * is called. `beforeScroll` runs before each correction.
+ */
+export declare function pinToPage(node: () => Element | null | undefined, beforeScroll: () => void): () => void;
+/**
+ * Reports the page most on screen as the reader's page area (`root`)
+ * scrolls. `hold`
+ * ignores scrolling until it has stopped for `idleMs`: the reader calls it
+ * before scrolling to a page itself, so the pages it passes on the way are
+ * not reported.
+ */
+export declare function createScrollSpy(root: () => HTMLElement | null | undefined, pages: () => ReadonlyMap<number, HTMLElement>, onPage: (page: number) => void, idleMs?: number): {
+    hold(): void;
+    stop(): void;
+};
+/**
+ * Scrolls a page's match to the middle of the page area once the page has
+ * drawn its mark, polling each frame for up to `timeout` ms; `beforeScroll`
+ * runs first. Returns a function that stops waiting.
+ */
+export declare function revealHit(findPage: () => ParentNode | null | undefined, hit: number, beforeScroll?: () => void, timeout?: number): () => void;
+//# sourceMappingURL=pdf-scroll-spy.d.ts.map

package/dist/pdf-viewer/pdf-scroll-spy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-scroll-spy.d.ts","sourceRoot":"","sources":["../../src/pdf-viewer/pdf-scroll-spy.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,MAAM,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAErD;;;GAGG;AACH,wBAAgB,eAAe,CAC9B,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,EACjC,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACxC,MAAM,GAAG,IAAI,CAkBf;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC7B,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,OAAO,GAAG,QAAQ,EACzB,QAAQ,GAAE,cAAyB,QASnC;AAUD;;;;;GAKG;AACH,wBAAgB,SAAS,CACxB,IAAI,EAAE,MAAM,OAAO,GAAG,IAAI,GAAG,SAAS,EACtC,YAAY,EAAE,MAAM,IAAI,cA4BxB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC9B,IAAI,EAAE,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,EAC1C,KAAK,EAAE,MAAM,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,EAC7C,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAC9B,MAAM,SAAM;;;EAiEZ;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACxB,QAAQ,EAAE,MAAM,UAAU,GAAG,IAAI,GAAG,SAAS,EAC7C,GAAG,EAAE,MAAM,EACX,YAAY,GAAE,MAAM,IAAe,EACnC,OAAO,SAAO,cAgBd"}

package/dist/pdf-viewer/pdf-text-search.d.ts

@@ -0,0 +1,26 @@
+/** One item of `page.getTextContent()`: marked-content items have no `str`. */
+export type PdfTextItem = {
+    str?: string;
+    hasEOL?: boolean;
+};
+/** A page's text, and where each text item starts in it. */
+export type PdfPageText = {
+    text: string;
+    starts: number[];
+};
+/** A match in a page's text: `end` is exclusive. */
+export type PdfTextRange = {
+    start: number;
+    end: number;
+};
+/** Joins the items' text, a line break after each item that ends a line. */
+export declare function pageTextFromItems(items: readonly PdfTextItem[]): PdfPageText;
+/** Every match of `query` in `text`, ignoring case, accents and spacing. */
+export declare function findTextMatches(text: string, query: string): PdfTextRange[];
+/**
+ * One text item's HTML, its part of each match wrapped in
+ * `<mark class="pdf-highlight" data-hit="…">`. A match across items gets a
+ * mark in each; the current one also carries `data-current`.
+ */
+export declare function highlightItemHtml(str: string, itemStart: number, matches: readonly PdfTextRange[], current?: number): string;
+//# sourceMappingURL=pdf-text-search.d.ts.map

package/dist/pdf-viewer/pdf-text-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-text-search.d.ts","sourceRoot":"","sources":["../../src/pdf-viewer/pdf-text-search.ts"],"names":[],"mappings":"AAEA,+EAA+E;AAC/E,MAAM,MAAM,WAAW,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAE7D,4DAA4D;AAC5D,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE7D,oDAAoD;AACpD,MAAM,MAAM,YAAY,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,GAAG,WAAW,CAS5E;AAiCD,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE,CAa3E;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAChC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,OAAO,SAAK,UAgBZ"}

package/dist/vite/index.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Build-time helpers for the apps that consume this library.
+ *
+ * This entry is the odd one out: everything else here runs in a browser or in
+ * an SSR server, and the `/vite` entry is Node code that runs inside a
+ * consumer's `vite.config.ts` (or a Nuxt app's Nitro build). It is here anyway
+ * because the problem it solves is this package's to own — a consumer should
+ * not have to rediscover it — and because there is exactly one copy of the fix
+ * to maintain, shared by `@nxgt/material` and `@nxgt/material-vue`.
+ *
+ * It imports nothing at runtime: `Plugin` is a type, erased by the compiler, so
+ * the built `dist/vite.js` has no dependency on `vite` at all.
+ */
+import type { Plugin } from 'vite';
+/**
+ * Bundles pdfkit's fourteen standard fonts instead of leaving them to a
+ * `require` that cannot work in a bundle.
+ *
+ * **Only needed by an app that renders PDFs** (`@nxgt/material/print`, or
+ * `@nxgt/material-vue/pdf`). No other entry reaches `@react-pdf/renderer`, so
+ * an app that does not print never sees this at all.
+ * If you do print, read on, because the failure is spectacular and silent until
+ * production.
+ *
+ * Both are built on `@react-pdf/renderer`, which is built on
+ * `pdfkit`, whose node build ends with:
+ *
+ * ```js
+ * const require$1 = createRequire(import.meta.url);
+ * registerStdFontLoaders({ Helvetica: () => require$1('#standard-fonts/Helvetica'), … });
+ * ```
+ *
+ * `#standard-fonts/*` is a package-`imports` entry **private to pdfkit**, and
+ * that is a RUNTIME call, not an import — so no bundler resolves it. Bundle
+ * pdfkit into an SSR server (`ssr.noExternal`) and the literal survives into the
+ * output, where `createRequire` is rooted at the build directory and the importer
+ * is no longer inside pdfkit. The server then throws on **every request**,
+ * `/health` included:
+ *
+ * ```
+ * error: Cannot find module '#standard-fonts/Helvetica' from '…/build/app.js'
+ * ```
+ *
+ * A compose healthcheck that fetches a route never goes healthy either, so the
+ * container looks like it is failing to start rather than failing to serve.
+ *
+ * This plugin rewrites those calls into static imports of
+ * `./standard-fonts/<name>.mjs`, so the font data lands in the bundle and the
+ * server stays self-contained. Use it when the runtime image has **no
+ * `node_modules`** — a single-file `bun build` artifact copied alone into the
+ * image. When the image does keep `node_modules`, the lighter answer is to leave
+ * the library external instead (`--external` it in the bundle step, and keep it
+ * out of `ssr.noExternal`), which also keeps ~12 MB of
+ * pdfkit out of the artifact. In Nuxt, `nxgtMaterial: { pdf: {
+ * bundleStandardFonts: true } }` adds this plugin to the Nitro build.
+ *
+ * ```ts
+ * // `@nxgt/material/vite` in a React app: the same function
+ * import { pdfkitStandardFonts } from '@nxgt/material-vue/vite';
+ * import { defineConfig } from 'vite';
+ *
+ * export default defineConfig({
+ *   plugins: [pdfkitStandardFonts()],
+ *   ssr: { noExternal: ['@nxgt/material-vue', '@nxgt/material-core'] },
+ * });
+ * ```
+ *
+ * Two things that look like fixes and are not:
+ *
+ * - **`resolve.alias`** mapping `#standard-fonts/` to `pdfkit/standard-fonts/`.
+ *   An alias rewrites specifiers the resolver is *asked* about; this one is a
+ *   string handed to `createRequire` at runtime, which the resolver never sees.
+ * - **`--external pdfkit`**. It is a transitive dependency, so the runtime cannot
+ *   resolve it from the app's own directory: `Cannot find package 'pdfkit'`.
+ *
+ * The plugin throws if a `#standard-fonts/` reference survives the rewrite, so a
+ * future pdfkit that changes the shape of those calls fails the build instead of
+ * the first request.
+ */
+export declare function pdfkitStandardFonts(): Plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/vite/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vite/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CA6C5C"}

package/dist/vite/index.js

@@ -0,0 +1,31 @@
+// src/vite/index.ts
+function pdfkitStandardFonts() {
+  const CALL = /[A-Za-z_$][\w$]*\(\s*(['"])#standard-fonts\/(\w+)\1\s*\)/g;
+  return {
+    name: "nxgt-material:pdfkit-standard-fonts",
+    enforce: "pre",
+    transform(code, id) {
+      if (!id.includes("pdfkit") || !code.includes("#standard-fonts/")) {
+        return null;
+      }
+      const fonts = new Set;
+      const out = code.replace(CALL, (_match, _quote, font) => {
+        fonts.add(font);
+        return `__stdFont_${font}`;
+      });
+      if (out.includes("#standard-fonts/")) {
+        this.error(`${id} 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.");
+      }
+      const imports = [...fonts].map((font) => `import __stdFont_${font} from './standard-fonts/${font}.mjs';`).join(`
+`);
+      return { code: `${imports}
+${out}`, map: null };
+    }
+  };
+}
+export {
+  pdfkitStandardFonts
+};
+
+//# debugId=03891F2267D73DE964756E2164756E21
+//# sourceMappingURL=index.js.map

package/dist/vite/index.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/vite/index.ts"],
+  "sourcesContent": [
+    "/**\n * Build-time helpers for the apps that consume this library.\n *\n * This entry is the odd one out: everything else here runs in a browser or in\n * an SSR server, and the `/vite` entry is Node code that runs inside a\n * consumer's `vite.config.ts` (or a Nuxt app's Nitro build). It is here anyway\n * because the problem it solves is this package's to own — a consumer should\n * not have to rediscover it — and because there is exactly one copy of the fix\n * to maintain, shared by `@nxgt/material` and `@nxgt/material-vue`.\n *\n * It imports nothing at runtime: `Plugin` is a type, erased by the compiler, so\n * the built `dist/vite.js` has no dependency on `vite` at all.\n */\n\nimport type { Plugin } from 'vite';\n\n/**\n * Bundles pdfkit's fourteen standard fonts instead of leaving them to a\n * `require` that cannot work in a bundle.\n *\n * **Only needed by an app that renders PDFs** (`@nxgt/material/print`, or\n * `@nxgt/material-vue/pdf`). No other entry reaches `@react-pdf/renderer`, so\n * an app that does not print never sees this at all.\n * If you do print, read on, because the failure is spectacular and silent until\n * production.\n *\n * Both are built on `@react-pdf/renderer`, which is built on\n * `pdfkit`, whose node build ends with:\n *\n * ```js\n * const require$1 = createRequire(import.meta.url);\n * registerStdFontLoaders({ Helvetica: () => require$1('#standard-fonts/Helvetica'), … });\n * ```\n *\n * `#standard-fonts/*` is a package-`imports` entry **private to pdfkit**, and\n * that is a RUNTIME call, not an import — so no bundler resolves it. Bundle\n * pdfkit into an SSR server (`ssr.noExternal`) and the literal survives into the\n * output, where `createRequire` is rooted at the build directory and the importer\n * is no longer inside pdfkit. The server then throws on **every request**,\n * `/health` included:\n *\n * ```\n * error: Cannot find module '#standard-fonts/Helvetica' from '…/build/app.js'\n * ```\n *\n * A compose healthcheck that fetches a route never goes healthy either, so the\n * container looks like it is failing to start rather than failing to serve.\n *\n * This plugin rewrites those calls into static imports of\n * `./standard-fonts/<name>.mjs`, so the font data lands in the bundle and the\n * server stays self-contained. Use it when the runtime image has **no\n * `node_modules`** — a single-file `bun build` artifact copied alone into the\n * image. When the image does keep `node_modules`, the lighter answer is to leave\n * the library external instead (`--external` it in the bundle step, and keep it\n * out of `ssr.noExternal`), which also keeps ~12 MB of\n * pdfkit out of the artifact. In Nuxt, `nxgtMaterial: { pdf: {\n * bundleStandardFonts: true } }` adds this plugin to the Nitro build.\n *\n * ```ts\n * // `@nxgt/material/vite` in a React app: the same function\n * import { pdfkitStandardFonts } from '@nxgt/material-vue/vite';\n * import { defineConfig } from 'vite';\n *\n * export default defineConfig({\n *   plugins: [pdfkitStandardFonts()],\n *   ssr: { noExternal: ['@nxgt/material-vue', '@nxgt/material-core'] },\n * });\n * ```\n *\n * Two things that look like fixes and are not:\n *\n * - **`resolve.alias`** mapping `#standard-fonts/` to `pdfkit/standard-fonts/`.\n *   An alias rewrites specifiers the resolver is *asked* about; this one is a\n *   string handed to `createRequire` at runtime, which the resolver never sees.\n * - **`--external pdfkit`**. It is a transitive dependency, so the runtime cannot\n *   resolve it from the app's own directory: `Cannot find package 'pdfkit'`.\n *\n * The plugin throws if a `#standard-fonts/` reference survives the rewrite, so a\n * future pdfkit that changes the shape of those calls fails the build instead of\n * the first request.\n */\nexport function pdfkitStandardFonts(): Plugin {\n\t/**\n\t * Any call whose only argument is that literal. Deliberately not pinned to\n\t * `require$1`, which is a name rollup generated for pdfkit's own build and is\n\t * free to change on any release — there is nothing else one can do with a\n\t * `#standard-fonts/*` specifier but require it.\n\t */\n\tconst CALL = /[A-Za-z_$][\\w$]*\\(\\s*(['\"])#standard-fonts\\/(\\w+)\\1\\s*\\)/g;\n\n\treturn {\n\t\tname: 'nxgt-material:pdfkit-standard-fonts',\n\t\tenforce: 'pre',\n\t\ttransform(code, id) {\n\t\t\tif (!id.includes('pdfkit') || !code.includes('#standard-fonts/')) {\n\t\t\t\treturn null;\n\t\t\t}\n\n\t\t\tconst fonts = new Set<string>();\n\t\t\tconst out = code.replace(CALL, (_match, _quote, font: string) => {\n\t\t\t\tfonts.add(font);\n\t\t\t\treturn `__stdFont_${font}`;\n\t\t\t});\n\n\t\t\t// Fail the build rather than ship a server that dies on its first\n\t\t\t// request: an unmatched occurrence means pdfkit changed the shape of\n\t\t\t// these calls, and the whole point of this plugin is that nothing\n\t\t\t// downstream notices the difference until runtime.\n\t\t\tif (out.includes('#standard-fonts/')) {\n\t\t\t\tthis.error(\n\t\t\t\t\t`${id} still references '#standard-fonts/' after the transform — ` +\n\t\t\t\t\t\t'pdfkit changed how it loads its standard fonts. See the doc ' +\n\t\t\t\t\t\t'comment on pdfkitStandardFonts() in the /vite entry.',\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tconst imports = [...fonts]\n\t\t\t\t.map(\n\t\t\t\t\t(font) =>\n\t\t\t\t\t\t`import __stdFont_${font} from './standard-fonts/${font}.mjs';`,\n\t\t\t\t)\n\t\t\t\t.join('\\n');\n\n\t\t\treturn { code: `${imports}\\n${out}`, map: null };\n\t\t},\n\t};\n}\n"
+  ],
+  "mappings": ";AAiFO,SAAS,mBAAmB,GAAW;AAAA,EAO7C,MAAM,OAAO;AAAA,EAEb,OAAO;AAAA,IACN,MAAM;AAAA,IACN,SAAS;AAAA,IACT,SAAS,CAAC,MAAM,IAAI;AAAA,MACnB,IAAI,CAAC,GAAG,SAAS,QAAQ,KAAK,CAAC,KAAK,SAAS,kBAAkB,GAAG;AAAA,QACjE,OAAO;AAAA,MACR;AAAA,MAEA,MAAM,QAAQ,IAAI;AAAA,MAClB,MAAM,MAAM,KAAK,QAAQ,MAAM,CAAC,QAAQ,QAAQ,SAAiB;AAAA,QAChE,MAAM,IAAI,IAAI;AAAA,QACd,OAAO,aAAa;AAAA,OACpB;AAAA,MAMD,IAAI,IAAI,SAAS,kBAAkB,GAAG;AAAA,QACrC,KAAK,MACJ,GAAG,kEACF,iEACA,sDACF;AAAA,MACD;AAAA,MAEA,MAAM,UAAU,CAAC,GAAG,KAAK,EACvB,IACA,CAAC,SACA,oBAAoB,+BAA+B,YACrD,EACC,KAAK;AAAA,CAAI;AAAA,MAEX,OAAO,EAAE,MAAM,GAAG;AAAA,EAAY,OAAO,KAAK,KAAK;AAAA;AAAA,EAEjD;AAAA;",
+  "debugId": "03891F2267D73DE964756E2164756E21",
+  "names": []
+}

package/docs/README.md

@@ -0,0 +1,9 @@
+# Documentation
+
+`@nxgt/material-core`'s pages beyond the [README](../README.md), which has
+one example per subpath.
+
+| Page | Read it when |
+| --- | --- |
+| [Troubleshooting](troubleshooting.md) | an import, a render or a build fails with a message: the message is the heading |
+| [Roadmap](roadmap.md) | you want to know what is coming, or whether something was already ruled out |

package/docs/roadmap.md

@@ -0,0 +1,35 @@
+# Roadmap
+
+Where `@nxgt/material-core` is going. A direction, not a commitment: the
+version an item shipped in is the only number on this page.
+
+## Now
+
+- **A first release, 0.1.0.** What `@nxgt/material` and `@nxgt/material-vue`
+  shared file by file — the PDF model and renderer, the print formatters, the
+  PDF file helpers, the PDF reader's framework-free modules (`/pdf-viewer`:
+  search, geometry, page sizes, scroll spy), the currency digits, the fields'
+  blur layers and the fonts plugin — is this one package, and both libraries
+  depend on it.
+
+## Next
+
+- **What the two libraries still keep twice.** The upload constraints (once
+  their translation function no longer names each library's own message
+  keys), pdf.js's inlined note icons (they need an asset build core does not
+  have yet) and the `material.*` translation bundle, which still differs by
+  one prefix (`doc.callout.*`, React only).
+
+## Later
+
+- **1.0**, once the model's `version: 1` is frozen: when another renderer
+  draws the same documents, as the React printing guide (`@nxgt/material`'s
+  `docs/guides/printing.md`) says.
+
+## Not planned
+
+- **Components.** This package stays framework-free: React components are in
+  `@nxgt/material`, Vue ones in `@nxgt/material-vue`.
+- **Test helpers.** Reading a rendered PDF back and the fake DOM the
+  libraries' tests use are the repository's own, in a private package that is
+  never published.

package/docs/troubleshooting.md

@@ -0,0 +1,105 @@
+# Troubleshooting
+
+Every heading is the message as it is printed; a name inside it (a node, a
+file) is an example — search for the words around it.
+
+**Install**
+
+- [`Cannot find package '@react-pdf/renderer'`](#cannot-find-package-react-pdfrenderer)
+
+**Rendering**
+
+- [`[pdf] Unknown node type "chart".`](#pdf-unknown-node-type-chart)
+- [`[pdf] No renderer for the custom node "signature": …`](#pdf-no-renderer-for-the-custom-node-signature-)
+- [`[pdf] Unsupported document version 2: this version renders version 1.`](#pdf-unsupported-document-version-2-this-version-renders-version-1)
+
+**PDF files**
+
+- [`PdfReader cannot open …: pass a URL, a Blob, an ArrayBuffer, a Uint8Array or { url, httpHeaders }.`](#pdfreader-cannot-open--pass-a-url-a-blob-an-arraybuffer-a-uint8array-or--url-httpheaders-)
+
+**Build**
+
+- [`… still references '#standard-fonts/' after the transform — …`](#-still-references-standard-fonts-after-the-transform--)
+- [`Cannot find module '#standard-fonts/Helvetica' from '…'`](#cannot-find-module-standard-fontshelvetica-from-)
+
+## Install
+
+### `Cannot find package '@react-pdf/renderer'`
+
+**When:** importing `@nxgt/material-core/pdf` or `/pdf/render`, before any of
+your code runs. Node prints `Cannot find package '@react-pdf/renderer'
+imported from …`, Bun `Cannot find module '@react-pdf/renderer' from '…'`;
+with the renderer installed and `react` missing, the name is `'react'`.
+**Why:** `react` and `@react-pdf/renderer` are optional peers, so no install
+adds them, and the renderer imports both statically. The other subpaths,
+`/pdf/model` included, import neither.
+**Fix:** install them where you render, or import only the model where you
+build documents:
+
+```sh
+bun add react @react-pdf/renderer@^4.9
+```
+
+```ts
+import { pdfDocument, text } from '@nxgt/material-core/pdf/model'; // no peer needed
+```
+
+## Rendering
+
+### `[pdf] Unknown node type "chart".`
+
+The renderer met a node whose `type` it does not know: a document built by a
+newer version of the model, or a typo in hand-written JSON. Build documents
+with the builders of `@nxgt/material-core/pdf/model` (or the libraries'
+`/print` and `/pdf`), which only make known nodes, or use a `custom` node for
+your own:
+
+```ts
+import { pdfDocument } from '@nxgt/material-core/pdf/model';
+
+pdfDocument({ pages: [{ body: [{ type: 'custom', name: 'chart', props: { id: 7 } }] }] });
+```
+
+### `[pdf] No renderer for the custom node "signature": …`
+
+A `{ type: 'custom', name: 'signature' }` node was rendered without a
+renderer of that name. Pass one in `custom` when rendering:
+
+```ts
+renderPdfElement(doc, {
+	custom: { signature: (props, ctx) => /* react-pdf elements */ null },
+});
+```
+
+### `[pdf] Unsupported document version 2: this version renders version 1.`
+
+The document's `version` is not 1. Documents are versioned so that one sent
+as JSON and rendered elsewhere is refused instead of mis-rendered; build it
+with `pdfDocument()`, which sets the version this renderer reads.
+
+## PDF files
+
+### `PdfReader cannot open …: pass a URL, a Blob, an ArrayBuffer, a Uint8Array or { url, httpHeaders }.`
+
+`toPdfjsSource` (behind both libraries' `PdfReader`) was given something that
+is not a PDF source — often `undefined` from a query that has not answered
+yet, or a `Response` instead of its bytes:
+
+```ts
+const bytes = await (await fetch(url)).arrayBuffer(); // not the Response
+```
+
+## Build
+
+### `… still references '#standard-fonts/' after the transform — …`
+
+`pdfkitStandardFonts()` found a `#standard-fonts/` reference it could not
+rewrite: pdfkit changed how it loads its fonts. The build fails on purpose,
+rather than the server at its first request. Pin the previous
+`@react-pdf/renderer` (and so pdfkit) and open an issue.
+
+### `Cannot find module '#standard-fonts/Helvetica' from '…'`
+
+A server bundle that contains pdfkit, run without `node_modules`. Add
+`pdfkitStandardFonts()` to that build (see the README's `/vite` section), or
+keep the library external so pdfkit loads from `node_modules`.

package/package.json

@@ -0,0 +1,187 @@
+{
+	"name": "@nxgt/material-core",
+	"version": "0.1.0",
+	"description": "The framework-free core of @nxgt/material and @nxgt/material-vue: the PDF document model and its react-pdf renderer, print formatters, PDF file helpers, the PDF viewer's pure modules, the currency digits, the field-blur layers and the pdfkit fonts Vite plugin",
+	"license": "MIT",
+	"bugs": {
+		"email": "stevegires@gmail.com"
+	},
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"files": [
+		"dist",
+		"docs",
+		"README.md",
+		"package.json",
+		"LICENSE"
+	],
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"default": "./dist/index.js"
+		},
+		"./pdf": {
+			"types": "./dist/pdf/index.d.ts",
+			"import": "./dist/pdf/index.js",
+			"default": "./dist/pdf/index.js"
+		},
+		"./pdf/model": {
+			"types": "./dist/pdf/model/index.d.ts",
+			"import": "./dist/pdf/model/index.js",
+			"default": "./dist/pdf/model/index.js"
+		},
+		"./pdf/render": {
+			"types": "./dist/pdf/render/index.d.ts",
+			"import": "./dist/pdf/render/index.js",
+			"default": "./dist/pdf/render/index.js"
+		},
+		"./pdf/http": {
+			"types": "./dist/pdf/http.d.ts",
+			"import": "./dist/pdf/http.js",
+			"default": "./dist/pdf/http.js"
+		},
+		"./pdf/file-loader": {
+			"types": "./dist/pdf/file-loader.d.ts",
+			"import": "./dist/pdf/file-loader.js",
+			"default": "./dist/pdf/file-loader.js"
+		},
+		"./print-format": {
+			"types": "./dist/lib/print-format.utils.d.ts",
+			"import": "./dist/lib/print-format.utils.js",
+			"default": "./dist/lib/print-format.utils.js"
+		},
+		"./print-fraction-digits": {
+			"types": "./dist/lib/print-fraction-digits.d.ts",
+			"import": "./dist/lib/print-fraction-digits.js",
+			"default": "./dist/lib/print-fraction-digits.js"
+		},
+		"./print-value": {
+			"types": "./dist/lib/print-value.utils.d.ts",
+			"import": "./dist/lib/print-value.utils.js",
+			"default": "./dist/lib/print-value.utils.js"
+		},
+		"./print-table": {
+			"types": "./dist/lib/print-table.utils.d.ts",
+			"import": "./dist/lib/print-table.utils.js",
+			"default": "./dist/lib/print-table.utils.js"
+		},
+		"./pdf-source": {
+			"types": "./dist/lib/pdf-source.d.ts",
+			"import": "./dist/lib/pdf-source.js",
+			"default": "./dist/lib/pdf-source.js"
+		},
+		"./pdf-file-name": {
+			"types": "./dist/lib/pdf-file-name.d.ts",
+			"import": "./dist/lib/pdf-file-name.js",
+			"default": "./dist/lib/pdf-file-name.js"
+		},
+		"./pdf-download": {
+			"types": "./dist/lib/pdf-download.d.ts",
+			"import": "./dist/lib/pdf-download.js",
+			"default": "./dist/lib/pdf-download.js"
+		},
+		"./currency-digits": {
+			"types": "./dist/lib/currency-digits.d.ts",
+			"import": "./dist/lib/currency-digits.js",
+			"default": "./dist/lib/currency-digits.js"
+		},
+		"./field-blur-layers": {
+			"types": "./dist/lib/field-blur-layers.d.ts",
+			"import": "./dist/lib/field-blur-layers.js",
+			"default": "./dist/lib/field-blur-layers.js"
+		},
+		"./pdf-viewer": {
+			"types": "./dist/pdf-viewer/index.d.ts",
+			"import": "./dist/pdf-viewer/index.js",
+			"default": "./dist/pdf-viewer/index.js"
+		},
+		"./vite": {
+			"types": "./dist/vite/index.d.ts",
+			"import": "./dist/vite/index.js",
+			"default": "./dist/vite/index.js"
+		},
+		"./package.json": "./package.json"
+	},
+	"sideEffects": false,
+	"keywords": [
+		"pdf",
+		"react-pdf",
+		"print",
+		"pdf-viewer",
+		"formatting",
+		"vite-plugin",
+		"framework-agnostic",
+		"typescript"
+	],
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/softistx/nxgt-material.git",
+		"directory": "packages/core"
+	},
+	"publishConfig": {
+		"registry": "https://registry.npmjs.org",
+		"access": "public"
+	},
+	"scripts": {
+		"build": "bun run ../../build.ts",
+		"postbuild": "bun run verify:ssr && bun run verify:dts",
+		"prepack": "bun run verify:dts",
+		"test": "vitest run",
+		"test:scripts": "bun test ./scripts/",
+		"typecheck": "tsc --noEmit",
+		"verify:ssr": "bun scripts/verify-ssr-safe.ts",
+		"verify:dts": "bun scripts/verify-dts.ts"
+	},
+	"nxgt": {
+		"entrypoints": [
+			"src/index.ts",
+			"src/pdf/index.ts",
+			"src/pdf/model/index.ts",
+			"src/pdf/render/index.ts",
+			"src/pdf/http.ts",
+			"src/pdf/file-loader.ts",
+			"src/lib/print-format.utils.ts",
+			"src/lib/print-fraction-digits.ts",
+			"src/lib/print-value.utils.ts",
+			"src/lib/print-table.utils.ts",
+			"src/lib/pdf-source.ts",
+			"src/lib/pdf-file-name.ts",
+			"src/lib/pdf-download.ts",
+			"src/lib/currency-digits.ts",
+			"src/lib/field-blur-layers.ts",
+			"src/pdf-viewer/index.ts",
+			"src/vite/index.ts"
+		]
+	},
+	"dependencies": {
+		"intl-messageformat": "^11.2.14"
+	},
+	"devDependencies": {
+		"@nxgt/material-testing": "0.0.0",
+		"@react-pdf/renderer": "^4.9.0",
+		"@types/bun": "^1.4.2",
+		"@types/react": "^19.2.17",
+		"react": "^19.2.8",
+		"typescript": "~6.0.3",
+		"vite": "8.1.5",
+		"vitest": "^4.1.10"
+	},
+	"peerDependencies": {
+		"@react-pdf/renderer": "^4.9.0",
+		"react": "^18.2.0 || ^19.0.0",
+		"vite": "^6.0.0 || ^7.0.0 || ^8.0.0"
+	},
+	"peerDependenciesMeta": {
+		"@react-pdf/renderer": {
+			"optional": true
+		},
+		"react": {
+			"optional": true
+		},
+		"vite": {
+			"optional": true
+		}
+	}
+}