@aibrains/pdf-renderer 0.2.0 → 0.4.0

package/dist/core/fonts.js

@@ -0,0 +1,159 @@
+"use strict";
+/**
+ * Font registration for @aibrains/pdf-renderer.
+ *
+ * Two font families ship with the package:
+ *   - `Noto Sans` — Latin script (Regular + Bold)
+ *   - `Noto Sans Devanagari` — Devanagari script for Nepali (Regular + Bold)
+ *
+ * Both are sourced from @fontsource/* at build time and copied to ./fonts/ at the
+ * package root (see scripts/copy-fonts.js). At runtime, paths resolve identically
+ * from `src/core/fonts.ts` and `dist/core/fonts.js` because both live two
+ * directories below the package root (../../fonts/).
+ *
+ * Devanagari rendering uses Yoga + Fontkit + Harfbuzz inside @react-pdf/renderer v4
+ * to handle complex script shaping (conjuncts, vowel marks). This is the canary for
+ * Risk R45 (Devanagari shaping defects in production); snapshot tests in the
+ * primitives + components directories exercise the pipeline.
+ *
+ * Call `registerFonts()` exactly once per process before the first render. The
+ * `Document` primitive (in `primitives/Document.tsx`) does this automatically.
+ *
+ * For browser consumers (Shell live-preview via `<PDFViewer>`), the same fonts
+ * are bundled in the published tarball; consumers' bundlers (Rsbuild, Webpack)
+ * pick them up via the relative path. URL-based registration for CDN deployments
+ * is a Sprint C.2 concern.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FONT_FAMILY_DEVANAGARI = exports.FONT_FAMILY_LATIN = void 0;
+exports.pickFontFamily = pickFontFamily;
+exports.registerFonts = registerFonts;
+exports._resetFontsForTest = _resetFontsForTest;
+const path = __importStar(require("node:path"));
+const renderer_1 = require("@react-pdf/renderer");
+const PACKAGE_ROOT = path.resolve(__dirname, '..', '..');
+const FONT_DIR = path.join(PACKAGE_ROOT, 'fonts');
+/** Latin font family registered by `registerFonts()`. */
+exports.FONT_FAMILY_LATIN = 'Noto Sans';
+/** Devanagari (Nepali) font family registered by `registerFonts()`. */
+exports.FONT_FAMILY_DEVANAGARI = 'Noto Sans Devanagari';
+// Unicode range U+0900..U+097F covers the full Devanagari block. Any codepoint
+// in that range means the run contains Devanagari script and needs the
+// Devanagari font. Latin (Basic Latin + Latin-1 Supplement) lives outside
+// this range — we route it to the default Latin family. Mixed runs are split
+// into multiple <Text> elements by the component layer.
+const DEVANAGARI_RANGE = /[ऀ-ॿ]/;
+/**
+ * Pick the correct font family for a text run.
+ *
+ * `@react-pdf/renderer` does NOT support CSS-style font-fallback chains —
+ * each text run uses exactly one font family. For mixed-script content
+ * (e.g., dual-language labels "Invoice / बिल"), components must split into
+ * separate `<Text>` elements and call this helper per segment.
+ *
+ * Detection rule: **any-Devanagari-wins**. The implementation tests
+ * `DEVANAGARI_RANGE.test(str)`, which returns true if ANY codepoint in the
+ * string falls in the Devanagari block — regardless of position. So
+ * `pickFontFamily('Invoice / बिल')` returns `FONT_FAMILY_DEVANAGARI` even
+ * though Latin appears first. This is intentional for V1: when a Devanagari
+ * character is present, we always need its font to render correctly; the
+ * Latin characters in `Noto Sans Devanagari` render acceptably (the font
+ * includes Basic Latin glyphs). If first-script-wins semantics are ever
+ * needed, change `DEVANAGARI_RANGE.test(str)` to scan only the first script
+ * cluster.
+ *
+ * @example
+ *   pickFontFamily('Subtotal')        // 'Noto Sans'
+ *   pickFontFamily('उप-योग')          // 'Noto Sans Devanagari'
+ *   pickFontFamily('Invoice / बिल')   // 'Noto Sans Devanagari' (any-Devanagari-wins)
+ *   pickFontFamily('बिल / Invoice')   // 'Noto Sans Devanagari'
+ *   pickFontFamily('')                // 'Noto Sans' (default for empty / null / undefined)
+ */
+function pickFontFamily(text) {
+    if (text === null || text === undefined || text === '')
+        return exports.FONT_FAMILY_LATIN;
+    const str = String(text);
+    return DEVANAGARI_RANGE.test(str) ? exports.FONT_FAMILY_DEVANAGARI : exports.FONT_FAMILY_LATIN;
+}
+let registered = false;
+/**
+ * Register the bundled fonts with `@react-pdf/renderer`. Idempotent — safe to
+ * call multiple times; subsequent calls short-circuit.
+ *
+ * Throws if the font files are not on disk (which means `npm run build` was
+ * never run after installation). Surfaces a clear error rather than silently
+ * rendering with the default font.
+ */
+function registerFonts() {
+    if (registered)
+        return;
+    // @react-pdf/renderer uses NUMERIC fontWeight internally (400 for normal,
+    // 700 for bold). Passing the string 'normal'/'bold' to Font.register stores
+    // them as strings but the resolver looks up numerics, so the registration
+    // doesn't match at render time. Use numeric weights at registration to match.
+    renderer_1.Font.register({
+        family: exports.FONT_FAMILY_LATIN,
+        fonts: [
+            {
+                src: path.join(FONT_DIR, 'NotoSans-Regular.woff'),
+                fontWeight: 400,
+            },
+            {
+                src: path.join(FONT_DIR, 'NotoSans-Bold.woff'),
+                fontWeight: 700,
+            },
+        ],
+    });
+    renderer_1.Font.register({
+        family: exports.FONT_FAMILY_DEVANAGARI,
+        fonts: [
+            {
+                src: path.join(FONT_DIR, 'NotoSansDevanagari-Regular.woff'),
+                fontWeight: 400,
+            },
+            {
+                src: path.join(FONT_DIR, 'NotoSansDevanagari-Bold.woff'),
+                fontWeight: 700,
+            },
+        ],
+    });
+    registered = true;
+}
+/** Test-only escape hatch — resets the registration guard so a test can re-register. */
+function _resetFontsForTest() {
+    registered = false;
+}
+//# sourceMappingURL=fonts.js.map

package/dist/core/fonts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fonts.js","sourceRoot":"","sources":["../../src/core/fonts.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8CH,wCAMC;AAgCD,sCAoCC;AAGD,gDAEC;AA3HD,gDAAkC;AAClC,kDAA2C;AAE3C,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;AAElD,yDAAyD;AAC5C,QAAA,iBAAiB,GAAG,WAAoB,CAAC;AACtD,uEAAuE;AAC1D,QAAA,sBAAsB,GAAG,sBAA+B,CAAC;AAEtE,+EAA+E;AAC/E,uEAAuE;AACvE,0EAA0E;AAC1E,6EAA6E;AAC7E,wDAAwD;AACxD,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,SAAgB,cAAc,CAC5B,IAAwC;IAExC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,yBAAiB,CAAC;IACjF,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IACzB,OAAO,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,8BAAsB,CAAC,CAAC,CAAC,yBAAiB,CAAC;AACjF,CAAC;AAsBD,IAAI,UAAU,GAAG,KAAK,CAAC;AAEvB;;;;;;;GAOG;AACH,SAAgB,aAAa;IAC3B,IAAI,UAAU;QAAE,OAAO;IAEvB,0EAA0E;IAC1E,4EAA4E;IAC5E,0EAA0E;IAC1E,8EAA8E;IAC9E,eAAI,CAAC,QAAQ,CAAC;QACZ,MAAM,EAAE,yBAAiB;QACzB,KAAK,EAAE;YACL;gBACE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,uBAAuB,CAAC;gBACjD,UAAU,EAAE,GAAG;aAChB;YACD;gBACE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,oBAAoB,CAAC;gBAC9C,UAAU,EAAE,GAAG;aAChB;SACF;KACF,CAAC,CAAC;IAEH,eAAI,CAAC,QAAQ,CAAC;QACZ,MAAM,EAAE,8BAAsB;QAC9B,KAAK,EAAE;YACL;gBACE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,iCAAiC,CAAC;gBAC3D,UAAU,EAAE,GAAG;aAChB;YACD;gBACE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,8BAA8B,CAAC;gBACxD,UAAU,EAAE,GAAG;aAChB;SACF;KACF,CAAC,CAAC;IAEH,UAAU,GAAG,IAAI,CAAC;AACpB,CAAC;AAED,wFAAwF;AACxF,SAAgB,kBAAkB;IAChC,UAAU,GAAG,KAAK,CAAC;AACrB,CAAC"}

package/dist/core/index.d.ts

@@ -11,4 +11,6 @@ export { t, tDual } from './i18n';
 export type { Lang, Namespace } from './i18n';
 export { formatDate, formatNumber, formatCurrency } from './format';
 export type { DateFormat, NumberGrouping } from './format';
+export { registerFonts, pickFontFamily, FONT_FAMILY_LATIN, FONT_FAMILY_DEVANAGARI, } from './fonts';
+export type { ImageSource } from './fonts';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAClC,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACpE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAClC,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACpE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE3D,OAAO,EACL,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/dist/core/index.js

@@ -7,7 +7,7 @@
  * and reusable components on top of these.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatCurrency = exports.formatNumber = exports.formatDate = exports.tDual = exports.t = exports.DEFAULT_MARGINS_MM = exports.DEFAULT_FONT_SIZE = exports.DEFAULT_SPACING = exports.DEFAULT_COLORS = void 0;
+exports.FONT_FAMILY_DEVANAGARI = exports.FONT_FAMILY_LATIN = exports.pickFontFamily = exports.registerFonts = exports.formatCurrency = exports.formatNumber = exports.formatDate = exports.tDual = exports.t = exports.DEFAULT_MARGINS_MM = exports.DEFAULT_FONT_SIZE = exports.DEFAULT_SPACING = exports.DEFAULT_COLORS = void 0;
 var theme_1 = require("./theme");
 Object.defineProperty(exports, "DEFAULT_COLORS", { enumerable: true, get: function () { return theme_1.DEFAULT_COLORS; } });
 Object.defineProperty(exports, "DEFAULT_SPACING", { enumerable: true, get: function () { return theme_1.DEFAULT_SPACING; } });
@@ -20,4 +20,9 @@ var format_1 = require("./format");
 Object.defineProperty(exports, "formatDate", { enumerable: true, get: function () { return format_1.formatDate; } });
 Object.defineProperty(exports, "formatNumber", { enumerable: true, get: function () { return format_1.formatNumber; } });
 Object.defineProperty(exports, "formatCurrency", { enumerable: true, get: function () { return format_1.formatCurrency; } });
+var fonts_1 = require("./fonts");
+Object.defineProperty(exports, "registerFonts", { enumerable: true, get: function () { return fonts_1.registerFonts; } });
+Object.defineProperty(exports, "pickFontFamily", { enumerable: true, get: function () { return fonts_1.pickFontFamily; } });
+Object.defineProperty(exports, "FONT_FAMILY_LATIN", { enumerable: true, get: function () { return fonts_1.FONT_FAMILY_LATIN; } });
+Object.defineProperty(exports, "FONT_FAMILY_DEVANAGARI", { enumerable: true, get: function () { return fonts_1.FONT_FAMILY_DEVANAGARI; } });
 //# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,iCAKiB;AAJf,uGAAA,cAAc,OAAA;AACd,wGAAA,eAAe,OAAA;AACf,0GAAA,iBAAiB,OAAA;AACjB,2GAAA,kBAAkB,OAAA;AAIpB,+BAAkC;AAAzB,yFAAA,CAAC,OAAA;AAAE,6FAAA,KAAK,OAAA;AAGjB,mCAAoE;AAA3D,oGAAA,UAAU,OAAA;AAAE,sGAAA,YAAY,OAAA;AAAE,wGAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,iCAKiB;AAJf,uGAAA,cAAc,OAAA;AACd,wGAAA,eAAe,OAAA;AACf,0GAAA,iBAAiB,OAAA;AACjB,2GAAA,kBAAkB,OAAA;AAIpB,+BAAkC;AAAzB,yFAAA,CAAC,OAAA;AAAE,6FAAA,KAAK,OAAA;AAGjB,mCAAoE;AAA3D,oGAAA,UAAU,OAAA;AAAE,sGAAA,YAAY,OAAA;AAAE,wGAAA,cAAc,OAAA;AAGjD,iCAKiB;AAJf,sGAAA,aAAa,OAAA;AACb,uGAAA,cAAc,OAAA;AACd,0GAAA,iBAAiB,OAAA;AACjB,+GAAA,sBAAsB,OAAA"}

package/dist/descriptors/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Public surface of the descriptor system.
+ *
+ * Sprint C.0.4 ships the registry + the contract. Concrete descriptors land
+ * with their document components in subsequent sprints:
+ *   - C.1.1 — invoice descriptor
+ *   - C.1.2 — receipt descriptor
+ *   - C.3.1 — report-card descriptor
+ *   - C.5.1 — admit-card descriptor
+ *   - (and so on for the V1.5 doc types)
+ */
+export { registerDescriptor, getDescriptor, getRegisteredDocTypes, hasDescriptor, } from './registry';
+export type { DocType, Archetype, PdfBranding, PdfLocaleSettings, PdfTemplateConfig, ConfigurableField, DocumentComponentProps, TemplateDescriptor, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/descriptors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,qBAAqB,EACrB,aAAa,GACd,MAAM,YAAY,CAAC;AAKpB,YAAY,EACV,OAAO,EACP,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,SAAS,CAAC"}

package/dist/descriptors/index.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * Public surface of the descriptor system.
+ *
+ * Sprint C.0.4 ships the registry + the contract. Concrete descriptors land
+ * with their document components in subsequent sprints:
+ *   - C.1.1 — invoice descriptor
+ *   - C.1.2 — receipt descriptor
+ *   - C.3.1 — report-card descriptor
+ *   - C.5.1 — admit-card descriptor
+ *   - (and so on for the V1.5 doc types)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasDescriptor = exports.getRegisteredDocTypes = exports.getDescriptor = exports.registerDescriptor = void 0;
+var registry_1 = require("./registry");
+Object.defineProperty(exports, "registerDescriptor", { enumerable: true, get: function () { return registry_1.registerDescriptor; } });
+Object.defineProperty(exports, "getDescriptor", { enumerable: true, get: function () { return registry_1.getDescriptor; } });
+Object.defineProperty(exports, "getRegisteredDocTypes", { enumerable: true, get: function () { return registry_1.getRegisteredDocTypes; } });
+Object.defineProperty(exports, "hasDescriptor", { enumerable: true, get: function () { return registry_1.hasDescriptor; } });
+//# sourceMappingURL=index.js.map

package/dist/descriptors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/descriptors/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH,uCAKoB;AAJlB,8GAAA,kBAAkB,OAAA;AAClB,yGAAA,aAAa,OAAA;AACb,iHAAA,qBAAqB,OAAA;AACrB,yGAAA,aAAa,OAAA"}

package/dist/descriptors/registry.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Singleton registry of template descriptors, keyed by `DocType`.
+ *
+ * Each `descriptors/{doc-type}.ts` file performs a side-effect at module load:
+ *
+ *   import { registerDescriptor } from '../descriptors/registry';
+ *   registerDescriptor(myDescriptor);
+ *
+ * The editor UI and render endpoints look up descriptors by `getDescriptor`.
+ * Adding a new doc type = adding a new file that calls `registerDescriptor`;
+ * NO change to the editor, the registry, or any consumer is needed.
+ *
+ * The registry deliberately uses module-singleton state. Tests can reset it
+ * via `_clearRegistryForTest`.
+ */
+import type { DocType, PdfTemplateConfig, TemplateDescriptor } from './types';
+/**
+ * Register a descriptor. Throws on duplicate `docType` — each doc type
+ * registers exactly once. Catching the duplicate at registration time
+ * surfaces accidental double-imports (e.g., two paths both importing
+ * `descriptors/invoice.ts`) as a loud error rather than silent override.
+ */
+export declare function registerDescriptor<TData, TConfig extends PdfTemplateConfig>(descriptor: TemplateDescriptor<TData, TConfig>): void;
+/**
+ * Look up a descriptor by `docType`. Throws with a helpful message listing
+ * the known docTypes if the requested one isn't registered — guards against
+ * typos at endpoint wire-up time.
+ *
+ * Generics: callers that know the concrete `TData` + `TConfig` for the docType
+ * can supply them to get a typed descriptor back. Callers that don't (e.g.,
+ * the editor UI iterating over all doc types) get the default
+ * `unknown / PdfTemplateConfig` shape and access only the descriptor-level
+ * metadata (configurableFields, defaults, sampleData).
+ */
+export declare function getDescriptor<TData = unknown, TConfig extends PdfTemplateConfig = PdfTemplateConfig>(docType: DocType): TemplateDescriptor<TData, TConfig>;
+/**
+ * Return the list of currently-registered doc types. Used by the editor's
+ * settings page to enumerate template cards.
+ */
+export declare function getRegisteredDocTypes(): readonly DocType[];
+/**
+ * Check whether a descriptor is registered without throwing. Useful for the
+ * editor when it wants to render disabled cards for not-yet-shipped doc
+ * types.
+ */
+export declare function hasDescriptor(docType: DocType): boolean;
+/**
+ * Test-only escape hatch. Clears the registry so each spec file starts
+ * clean. Not exported from the public package surface.
+ */
+export declare function _clearRegistryForTest(): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/descriptors/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/descriptors/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,OAAO,EACP,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAUjB;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,SAAS,iBAAiB,EACzE,UAAU,EAAE,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,GAC7C,IAAI,CAaN;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,KAAK,GAAG,OAAO,EACf,OAAO,SAAS,iBAAiB,GAAG,iBAAiB,EACrD,OAAO,EAAE,OAAO,GAAG,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,CAWtD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,SAAS,OAAO,EAAE,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEvD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/descriptors/registry.js

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * Singleton registry of template descriptors, keyed by `DocType`.
+ *
+ * Each `descriptors/{doc-type}.ts` file performs a side-effect at module load:
+ *
+ *   import { registerDescriptor } from '../descriptors/registry';
+ *   registerDescriptor(myDescriptor);
+ *
+ * The editor UI and render endpoints look up descriptors by `getDescriptor`.
+ * Adding a new doc type = adding a new file that calls `registerDescriptor`;
+ * NO change to the editor, the registry, or any consumer is needed.
+ *
+ * The registry deliberately uses module-singleton state. Tests can reset it
+ * via `_clearRegistryForTest`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerDescriptor = registerDescriptor;
+exports.getDescriptor = getDescriptor;
+exports.getRegisteredDocTypes = getRegisteredDocTypes;
+exports.hasDescriptor = hasDescriptor;
+exports._clearRegistryForTest = _clearRegistryForTest;
+const REGISTRY = new Map();
+/**
+ * Register a descriptor. Throws on duplicate `docType` — each doc type
+ * registers exactly once. Catching the duplicate at registration time
+ * surfaces accidental double-imports (e.g., two paths both importing
+ * `descriptors/invoice.ts`) as a loud error rather than silent override.
+ */
+function registerDescriptor(descriptor) {
+    if (REGISTRY.has(descriptor.docType)) {
+        throw new Error(`[pdf-renderer] Duplicate descriptor registration for docType '${descriptor.docType}'. ` +
+            `Each docType must register exactly once. Check for duplicate imports of the same descriptor file.`);
+    }
+    // Double-cast through `unknown` is required because TS can't directly relate
+    // `TemplateDescriptor<TData, TConfig>` to `TemplateDescriptor<unknown, PdfTemplateConfig>`
+    // — the generic param positions are invariant. The store-as-unknown /
+    // cast-back-at-retrieval pattern is intentional; getDescriptor does the
+    // matching reverse cast.
+    REGISTRY.set(descriptor.docType, descriptor);
+}
+/**
+ * Look up a descriptor by `docType`. Throws with a helpful message listing
+ * the known docTypes if the requested one isn't registered — guards against
+ * typos at endpoint wire-up time.
+ *
+ * Generics: callers that know the concrete `TData` + `TConfig` for the docType
+ * can supply them to get a typed descriptor back. Callers that don't (e.g.,
+ * the editor UI iterating over all doc types) get the default
+ * `unknown / PdfTemplateConfig` shape and access only the descriptor-level
+ * metadata (configurableFields, defaults, sampleData).
+ */
+function getDescriptor(docType) {
+    const descriptor = REGISTRY.get(docType);
+    if (!descriptor) {
+        const known = [...REGISTRY.keys()];
+        throw new Error(`[pdf-renderer] No descriptor registered for docType '${docType}'. ` +
+            `Known: ${known.length > 0 ? known.join(', ') : '(none)'}.`);
+    }
+    // See registerDescriptor — this is the matching cast on the retrieval side.
+    return descriptor;
+}
+/**
+ * Return the list of currently-registered doc types. Used by the editor's
+ * settings page to enumerate template cards.
+ */
+function getRegisteredDocTypes() {
+    return [...REGISTRY.keys()];
+}
+/**
+ * Check whether a descriptor is registered without throwing. Useful for the
+ * editor when it wants to render disabled cards for not-yet-shipped doc
+ * types.
+ */
+function hasDescriptor(docType) {
+    return REGISTRY.has(docType);
+}
+/**
+ * Test-only escape hatch. Clears the registry so each spec file starts
+ * clean. Not exported from the public package surface.
+ */
+function _clearRegistryForTest() {
+    REGISTRY.clear();
+}
+//# sourceMappingURL=registry.js.map

package/dist/descriptors/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/descriptors/registry.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;AAsBH,gDAeC;AAaD,sCAcC;AAMD,sDAEC;AAOD,sCAEC;AAMD,sDAEC;AA3ED,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA8B,CAAC;AAEvD;;;;;GAKG;AACH,SAAgB,kBAAkB,CAChC,UAA8C;IAE9C,IAAI,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CACb,iEAAiE,UAAU,CAAC,OAAO,KAAK;YACtF,mGAAmG,CACtG,CAAC;IACJ,CAAC;IACD,6EAA6E;IAC7E,2FAA2F;IAC3F,sEAAsE;IACtE,wEAAwE;IACxE,yBAAyB;IACzB,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,UAA0C,CAAC,CAAC;AAC/E,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,aAAa,CAG3B,OAAgB;IAChB,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,KAAK,GAAG,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACnC,MAAM,IAAI,KAAK,CACb,wDAAwD,OAAO,KAAK;YAClE,UAAU,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,CAC9D,CAAC;IACJ,CAAC;IACD,4EAA4E;IAC5E,OAAO,UAA2D,CAAC;AACrE,CAAC;AAED;;;GAGG;AACH,SAAgB,qBAAqB;IACnC,OAAO,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED;;;;GAIG;AACH,SAAgB,aAAa,CAAC,OAAgB;IAC5C,OAAO,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,SAAgB,qBAAqB;IACnC,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC"}

package/dist/descriptors/types.d.ts

@@ -0,0 +1,207 @@
+/**
+ * Type contracts for the TemplateDescriptor registry.
+ *
+ * A `TemplateDescriptor<TData, TConfig>` is the unit of extensibility in this
+ * library. Each future doc type (invoice, receipt, report card, admit card,
+ * ID card, certificate, …) ships exactly one descriptor file that registers
+ * itself at module load. The editor UI and per-domain render endpoints both
+ * look up descriptors by `docType` — neither needs to import the document
+ * components directly.
+ *
+ * Design source of truth: docs/pilot-greenlight/c-epic-pdf-generation-design.md §5.2.
+ */
+import type * as React from 'react';
+import type { ImageSource } from '../core/fonts';
+import type { Lang } from '../core/i18n';
+/**
+ * Document types known to the renderer. Each value corresponds to exactly
+ * one descriptor registration. Extend this union when adding a new doc type.
+ */
+export type DocType = 'INVOICE' | 'RECEIPT' | 'REPORT_CARD' | 'ADMIT_CARD' | 'TRANSCRIPT' | 'STUDENT_ID_CARD' | 'BONAFIDE_CERTIFICATE' | 'TRANSFER_CERTIFICATE' | 'HALL_TICKET' | 'FEE_STATEMENT' | 'ATTENDANCE_SHEET' | 'MARK_LIST';
+/**
+ * Tenant archetype the renderer recognizes when computing defaults.
+ * Locked here to match `@aibrains/shared-types` Archetype enum. Reserved
+ * archetypes (`CBSE_IN`, `NAIS_US`, `GEMS_UAE`) are accepted in the type
+ * but a descriptor's `defaults(archetype, …)` SHOULD fall back to the
+ * GENERIC profile for any value it doesn't explicitly handle — V1 only
+ * exercises `'PABSON'` and `'GENERIC'`.
+ */
+export type Archetype = 'PABSON' | 'GENERIC' | 'CBSE_IN' | 'NAIS_US' | 'GEMS_UAE';
+/**
+ * Minimal branding shape consumed by document Components.
+ *
+ * Templates accept this as `branding` and forward selected fields to the
+ * `BrandedHeader` / `SignatureLine` / `Watermark` primitives. Local to the
+ * renderer; consumers map `@aibrains/shared-types`'s `SchoolBranding` to
+ * this shape at the endpoint boundary (Sprint C.0.5 + C.1).
+ *
+ * Property order is alphabetical to keep the type readable as it grows.
+ */
+export interface PdfBranding {
+    accentColor?: string;
+    addressLines?: string[];
+    email?: string;
+    formalName?: string;
+    letterheadBackgroundSrc?: ImageSource;
+    logoSrc?: ImageSource;
+    panNumber?: string;
+    phone?: string;
+    primaryColor?: string;
+    principalSignatureSrc?: ImageSource;
+    schoolName?: string;
+    tagline?: string;
+    vatNumber?: string;
+}
+/**
+ * Minimal locale + regional settings consumed by document Components.
+ * Sourced from `WorkspaceSettings` + `SchoolConfiguration` in production;
+ * the descriptor doesn't care which layer of the precedence chain produced
+ * each value.
+ */
+export interface PdfLocaleSettings {
+    /** BCP 47 — e.g., 'en-US', 'ne-NP'. */
+    defaultLocale: string;
+    /** ISO 4217 — e.g., 'NPR', 'USD', 'INR'. */
+    defaultCurrency: string;
+    defaultCalendarSystem: 'gregorian' | 'bikram_sambat';
+    /** IANA timezone string. */
+    defaultTimeZone?: string;
+}
+/**
+ * The shared base config every PDF template has. Per-doc-type config (the
+ * `TConfig` generic on `TemplateDescriptor`) extends this with
+ * domain-specific options — e.g., an `InvoiceTemplateConfig` adds
+ * `lineItemColumns` + `totalsSection`.
+ */
+export interface PdfTemplateConfig {
+    pageSize: 'A4' | 'A5' | 'LETTER';
+    orientation: 'portrait' | 'landscape';
+    margins: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    header: {
+        showLogo: boolean;
+        showSchoolName: boolean;
+        showSchoolAddress: boolean;
+        showContact: boolean;
+        tagline?: string;
+    };
+    footer: {
+        text?: string;
+        showPageNumbers: boolean;
+    };
+    dateFormat: 'gregorian' | 'bikram_sambat' | 'dual';
+    numberFormat: 'south-asian' | 'western' | 'auto-from-workspace';
+    currencyDisplay: 'symbol' | 'iso-code' | 'name';
+    /**
+     * At minimum one entry; two entries enables dual-language label rendering
+     * (e.g., `['en', 'ne']` → "Subtotal" + "उप-योग" stacked or inline).
+     *
+     * Encoded as a **non-empty tuple type** so the compiler rejects empty
+     * arrays at the call site — the runtime invariant "every template must
+     * have at least one label language" is enforced by the type itself, not
+     * by a runtime check buried in the renderer.
+     */
+    labelLanguages: readonly [Lang, ...Lang[]];
+    /** Per-template branding overrides — rare; most templates inherit school branding. */
+    brandingOverrides?: Partial<PdfBranding>;
+}
+/**
+ * A single configurable form field surfaced in the template editor UI.
+ *
+ * The editor reads each descriptor's `configurableFields[]` and generates
+ * form sections automatically. **Adding a new editable field = appending one
+ * entry here; the editor needs no code change.** This is the property that
+ * makes the editor work uniformly across all 12+ planned doc types.
+ */
+export interface ConfigurableField {
+    /**
+     * Dot path into `TConfig` for this field's value.
+     * Example: `'lineItemColumns.discount'`, `'header.tagline'`, `'pageSize'`.
+     */
+    path: string;
+    /** Form-input type. The editor maps each to a primitive from `@edforge/forms`. */
+    type: 'text' | 'textarea' | 'toggle' | 'select' | 'multiselect' | 'color' | 'file' | 'number';
+    /** i18n key for the field label. Resolved per current editor locale. */
+    labelKey: string;
+    /** i18n key for an optional help/description tooltip. */
+    descriptionKey?: string;
+    /** Choices for `select` / `multiselect`. */
+    options?: readonly string[];
+    /** File `accept` attribute for `file` type. Example: `'.png,.jpg,.svg'`. */
+    accept?: string;
+    /** Max file size in bytes for `file` type. */
+    maxSizeBytes?: number;
+    /** Minimum items for `multiselect`. */
+    minItems?: number;
+    /**
+     * Conditional display: only render this field when another field's value
+     * equals the given value. Useful for toggling sub-sections on/off.
+     */
+    visibleIf?: {
+        path: string;
+        equals: unknown;
+    };
+}
+/**
+ * Props every document Component accepts. Stable across all doc types so the
+ * editor and render endpoints don't need per-doc-type adapter code.
+ */
+export interface DocumentComponentProps<TData, TConfig extends PdfTemplateConfig> {
+    data: TData;
+    template: TConfig;
+    branding: PdfBranding;
+    settings: PdfLocaleSettings;
+}
+/**
+ * The contract every doc-type descriptor satisfies.
+ *
+ * @example
+ *   import { registerDescriptor, type TemplateDescriptor } from '@aibrains/pdf-renderer';
+ *
+ *   const invoiceDescriptor: TemplateDescriptor<Invoice, InvoiceTemplateConfig> = {
+ *     docType: 'INVOICE',
+ *     i18nNamespace: 'invoice',
+ *     Component: InvoicePdf,
+ *     defaults: (archetype, locale) => ({ ... }),
+ *     sampleData: (archetype, locale) => ({ ... }),
+ *     configurableFields: [ ... ],
+ *   };
+ *
+ *   registerDescriptor(invoiceDescriptor);
+ */
+export interface TemplateDescriptor<TData, TConfig extends PdfTemplateConfig> {
+    /** Globally unique discriminator (e.g., `'INVOICE'`, `'REPORT_CARD'`). */
+    docType: DocType;
+    /**
+     * i18n namespace this descriptor's labels live under. Translations are
+     * bundled in `src/i18n/{lang}/{namespace}.json` and loaded by the editor
+     * + the document component.
+     */
+    i18nNamespace: string;
+    /**
+     * The React component that renders the document. Both
+     * `renderToBuffer` (Node) and `<PDFViewer>` (browser) invoke this with
+     * the standard four props.
+     */
+    Component: React.ComponentType<DocumentComponentProps<TData, TConfig>>;
+    /**
+     * Returns the default config for a fresh template, parameterized by
+     * archetype + locale. For PABSON tenants this should produce
+     * BS+AD dual dates, EN+NE labels, ne-NP locale, NPR, south-asian numbers
+     * — sensible defaults so the lazy-seed path produces a usable PDF
+     * without any operator action.
+     */
+    defaults(archetype: Archetype, locale: string): TConfig;
+    /**
+     * Returns mock data for the editor's live preview when the operator
+     * hasn't yet selected a real document to preview against.
+     */
+    sampleData(archetype: Archetype, locale: string): TData;
+    /** Editor-form-rendering metadata. The order is the field order in the UI. */
+    configurableFields: readonly ConfigurableField[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/descriptors/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/descriptors/types.ts"],"names":[],"mappings":"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"}

package/dist/descriptors/types.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Type contracts for the TemplateDescriptor registry.
+ *
+ * A `TemplateDescriptor<TData, TConfig>` is the unit of extensibility in this
+ * library. Each future doc type (invoice, receipt, report card, admit card,
+ * ID card, certificate, …) ships exactly one descriptor file that registers
+ * itself at module load. The editor UI and per-domain render endpoints both
+ * look up descriptors by `docType` — neither needs to import the document
+ * components directly.
+ *
+ * Design source of truth: docs/pilot-greenlight/c-epic-pdf-generation-design.md §5.2.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/descriptors/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/descriptors/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG"}

package/dist/index.d.ts

@@ -14,6 +14,9 @@
  *
  * Design source of truth: docs/pilot-greenlight/c-epic-pdf-generation-design.md
  */
-export declare const PDF_RENDERER_PACKAGE_VERSION = "0.2.0";
+export declare const PDF_RENDERER_PACKAGE_VERSION = "0.4.0";
 export * from './core';
+export * from './primitives';
+export * from './components';
+export * from './descriptors';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,4BAA4B,UAAU,CAAC;AAGpD,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,4BAA4B,UAAU,CAAC;AAIpD,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}