@aibrains/pdf-renderer 0.3.0 → 0.5.0

package/dist/core/i18n.d.ts

@@ -14,14 +14,19 @@
  * Interpolation: simple `{var}` placeholders. Non-string values are coerced
  * via String(value); undefined/null become empty string.
  *
- * V1 supports two languages (`'en'`, `'ne'`) and one namespace (`'common'`).
- * Doc-type namespaces (`'invoice'`, `'receipt'`, etc.) ship with their
- * documents in Sprint C.1+.
+ * V1 languages: `'en'` + `'ne'`. Namespaces are added per-doc-type as their
+ * descriptors land:
+ *   - `'common'` (Sprint C.0.2)
+ *   - `'invoice'` (Sprint C.1.1)
+ *   - future: `'receipt'` (C.1.2), `'report-card'` (C.3.1), `'admit-card'` (C.5.1)
  */
 /** Supported document languages in V1. */
 export type Lang = 'en' | 'ne';
-/** Supported translation namespaces in V1. New doc types append here. */
-export type Namespace = 'common';
+/**
+ * Supported translation namespaces in V1. New doc types append here AND
+ * add a bundle entry to BUNDLES below; the loader is otherwise additive.
+ */
+export type Namespace = 'common' | 'invoice';
 /**
  * Translate a key.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/core/i18n.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,0CAA0C;AAC1C,MAAM,MAAM,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE/B,yEAAyE;AACzE,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC;AAajC;;;;;;;GAOG;AACH,wBAAgB,CAAC,CACf,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,IAAI,EACV,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,GACxD,MAAM,CAYR;AAED;;;;;;GAMG;AACH,wBAAgB,KAAK,CACnB,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,EACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,GACxD;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAKxC"}
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/core/i18n.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAOH,0CAA0C;AAC1C,MAAM,MAAM,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE/B;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAa7C;;;;;;;GAOG;AACH,wBAAgB,CAAC,CACf,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,IAAI,EACV,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,GACxD,MAAM,CAYR;AAED;;;;;;GAMG;AACH,wBAAgB,KAAK,CACnB,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,EACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,GACxD;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAKxC"}

package/dist/core/i18n.js

@@ -15,9 +15,11 @@
  * Interpolation: simple `{var}` placeholders. Non-string values are coerced
  * via String(value); undefined/null become empty string.
  *
- * V1 supports two languages (`'en'`, `'ne'`) and one namespace (`'common'`).
- * Doc-type namespaces (`'invoice'`, `'receipt'`, etc.) ship with their
- * documents in Sprint C.1+.
+ * V1 languages: `'en'` + `'ne'`. Namespaces are added per-doc-type as their
+ * descriptors land:
+ *   - `'common'` (Sprint C.0.2)
+ *   - `'invoice'` (Sprint C.1.1)
+ *   - future: `'receipt'` (C.1.2), `'report-card'` (C.3.1), `'admit-card'` (C.5.1)
  */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
@@ -27,9 +29,11 @@ exports.t = t;
 exports.tDual = tDual;
 const common_json_1 = __importDefault(require("../i18n/en/common.json"));
 const common_json_2 = __importDefault(require("../i18n/ne/common.json"));
+const invoice_json_1 = __importDefault(require("../i18n/en/invoice.json"));
+const invoice_json_2 = __importDefault(require("../i18n/ne/invoice.json"));
 const BUNDLES = {
-    en: { common: common_json_1.default },
-    ne: { common: common_json_2.default },
+    en: { common: common_json_1.default, invoice: invoice_json_1.default },
+    ne: { common: common_json_2.default, invoice: invoice_json_2.default },
 };
 /** Default fallback language when target language is missing a key. */
 const FALLBACK_LANG = 'en';

package/dist/core/i18n.js.map

@@ -1 +1 @@
-{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../../src/core/i18n.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;;;AA8BH,cAiBC;AASD,sBAUC;AAhED,yEAA8C;AAC9C,yEAA8C;AAW9C,MAAM,OAAO,GAA8B;IACzC,EAAE,EAAE,EAAE,MAAM,EAAE,qBAAQ,EAAE;IACxB,EAAE,EAAE,EAAE,MAAM,EAAE,qBAAQ,EAAE;CACzB,CAAC;AAEF,uEAAuE;AACvE,MAAM,aAAa,GAAS,IAAI,CAAC;AAEjC;;;;;;;GAOG;AACH,SAAgB,CAAC,CACf,SAAoB,EACpB,GAAW,EACX,IAAU,EACV,IAAyD;;IAEzD,MAAM,GAAG,GACP,MAAA,MAAA,MAAA,MAAA,OAAO,CAAC,IAAI,CAAC,0CAAG,SAAS,CAAC,0CAAG,GAAG,CAAC,mCACjC,MAAA,MAAA,OAAO,CAAC,aAAa,CAAC,0CAAG,SAAS,CAAC,0CAAG,GAAG,CAAC,mCAC1C,GAAG,CAAC;IAEN,IAAI,CAAC,IAAI;QAAE,OAAO,GAAG,CAAC;IAEtB,OAAO,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,OAAe,EAAE,EAAE;QAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5B,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,KAAK,CACnB,SAAoB,EACpB,GAAW,EACX,KAAmB,EACnB,IAAyD;IAEzD,OAAO;QACL,OAAO,EAAE,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;QAC1C,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;KAC7C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../../src/core/i18n.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;;;AAmCH,cAiBC;AASD,sBAUC;AArED,yEAA8C;AAC9C,yEAA8C;AAC9C,2EAAgD;AAChD,2EAAgD;AAchD,MAAM,OAAO,GAA8B;IACzC,EAAE,EAAE,EAAE,MAAM,EAAE,qBAAQ,EAAE,OAAO,EAAE,sBAAS,EAAE;IAC5C,EAAE,EAAE,EAAE,MAAM,EAAE,qBAAQ,EAAE,OAAO,EAAE,sBAAS,EAAE;CAC7C,CAAC;AAEF,uEAAuE;AACvE,MAAM,aAAa,GAAS,IAAI,CAAC;AAEjC;;;;;;;GAOG;AACH,SAAgB,CAAC,CACf,SAAoB,EACpB,GAAW,EACX,IAAU,EACV,IAAyD;;IAEzD,MAAM,GAAG,GACP,MAAA,MAAA,MAAA,MAAA,OAAO,CAAC,IAAI,CAAC,0CAAG,SAAS,CAAC,0CAAG,GAAG,CAAC,mCACjC,MAAA,MAAA,OAAO,CAAC,aAAa,CAAC,0CAAG,SAAS,CAAC,0CAAG,GAAG,CAAC,mCAC1C,GAAG,CAAC;IAEN,IAAI,CAAC,IAAI;QAAE,OAAO,GAAG,CAAC;IAEtB,OAAO,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,OAAe,EAAE,EAAE;QAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5B,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,KAAK,CACnB,SAAoB,EACpB,GAAW,EACX,KAAmB,EACnB,IAAyD;IAEzD,OAAO;QACL,OAAO,EAAE,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;QAC1C,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;KAC7C,CAAC;AACJ,CAAC"}

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/invoice.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Invoice descriptor — Sprint C.1.1.
+ *
+ * The first concrete `TemplateDescriptor` registered with the library.
+ * Registers itself at module load via the top-level `registerDescriptor(...)`
+ * call below — importing this file is sufficient to make
+ * `getDescriptor('INVOICE')` work.
+ *
+ * Defaults are split between PABSON and GENERIC archetypes per the design
+ * doc §1: PABSON ⇒ BS+AD dual dates + EN+NE labels + south-asian numbers +
+ * NPR symbol; GENERIC ⇒ gregorian + EN-only + western + ISO-code currency.
+ *
+ * `configurableFields[]` is the operator-facing customization surface that
+ * the C.2.4 generic editor renders form sections from. 13 fields for V1.
+ */
+import { type InvoiceTemplateConfig, type InvoiceDocumentData } from '../documents/InvoicePdf';
+import type { TemplateDescriptor } from './types';
+export declare const invoiceDescriptor: TemplateDescriptor<InvoiceDocumentData, InvoiceTemplateConfig>;
+//# sourceMappingURL=invoice.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"invoice.d.ts","sourceRoot":"","sources":["../../src/descriptors/invoice.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAc,KAAK,qBAAqB,EAAE,KAAK,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE3G,OAAO,KAAK,EAGV,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAoIjB,eAAO,MAAM,iBAAiB,EAAE,kBAAkB,CAAC,mBAAmB,EAAE,qBAAqB,CAO5F,CAAC"}

package/dist/descriptors/invoice.js

@@ -0,0 +1,160 @@
+"use strict";
+/**
+ * Invoice descriptor — Sprint C.1.1.
+ *
+ * The first concrete `TemplateDescriptor` registered with the library.
+ * Registers itself at module load via the top-level `registerDescriptor(...)`
+ * call below — importing this file is sufficient to make
+ * `getDescriptor('INVOICE')` work.
+ *
+ * Defaults are split between PABSON and GENERIC archetypes per the design
+ * doc §1: PABSON ⇒ BS+AD dual dates + EN+NE labels + south-asian numbers +
+ * NPR symbol; GENERIC ⇒ gregorian + EN-only + western + ISO-code currency.
+ *
+ * `configurableFields[]` is the operator-facing customization surface that
+ * the C.2.4 generic editor renders form sections from. 13 fields for V1.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.invoiceDescriptor = void 0;
+const InvoicePdf_1 = require("../documents/InvoicePdf");
+const registry_1 = require("./registry");
+/**
+ * The default `InvoiceTemplateConfig` for a freshly-seeded template.
+ * Returns PABSON-flavor when the tenant archetype is `'PABSON'`, GENERIC
+ * for everything else. Reserved archetypes (`CBSE_IN`, `NAIS_US`,
+ * `GEMS_UAE`) fall through to GENERIC per the design doc § 1.
+ */
+function invoiceDefaults(archetype, _locale) {
+    const isPabson = archetype === 'PABSON';
+    return {
+        pageSize: 'A4',
+        orientation: 'portrait',
+        margins: { top: 15, right: 15, bottom: 15, left: 15 },
+        header: {
+            showLogo: true,
+            showSchoolName: true,
+            showSchoolAddress: true,
+            showContact: true,
+            tagline: isPabson ? 'Education for All' : undefined,
+        },
+        footer: {
+            text: undefined,
+            showPageNumbers: true,
+            showSignatureLine: true,
+        },
+        dateFormat: isPabson ? 'dual' : 'gregorian',
+        numberFormat: isPabson ? 'south-asian' : 'western',
+        currencyDisplay: 'iso-code',
+        labelLanguages: isPabson ? ['en', 'ne'] : ['en'],
+        lineItemColumns: {
+            description: true,
+            quantity: true,
+            amount: true,
+            discount: true,
+            taxRate: true,
+            taxAmount: true,
+            total: true,
+        },
+        totalsSection: {
+            showSubtotal: true,
+            showTaxTotal: true,
+            showDiscountTotal: true,
+            showAmountPaid: true,
+            showAmountDue: true,
+        },
+    };
+}
+/**
+ * Sample data for the C.2.4 editor's "default mock" preview path. The shape
+ * mirrors a realistic Saraswati Q1 invoice — one tuition fee + one library fee,
+ * with a discount + VAT row to exercise every line-item column.
+ */
+function invoiceSampleData(archetype, _locale) {
+    const isPabson = archetype === 'PABSON';
+    return {
+        invoiceNumber: 'INV-2026-001234',
+        issuedDate: '2026-03-15',
+        dueDate: '2026-04-28',
+        academicYear: '2025-2026',
+        billingPeriod: isPabson ? 'चैत 2082' : 'Q1 2026',
+        studentName: isPabson ? 'सरस्वती शर्मा' : 'Saraswati Sharma',
+        studentId: 'STU-2025-0042',
+        gradeLevel: '8',
+        lineItems: [
+            {
+                description: isPabson ? 'ट्यूशन शुल्क — कक्षा ८' : 'Tuition Fee — Grade 8',
+                quantity: 1,
+                amount: 10000,
+                discount: 500,
+                taxRate: 13,
+                taxAmount: 1235,
+                total: 10735,
+            },
+            {
+                description: isPabson ? 'पुस्तकालय शुल्क' : 'Library Fee',
+                quantity: 1,
+                amount: 500,
+                discount: 0,
+                taxRate: 0,
+                taxAmount: 0,
+                total: 500,
+            },
+        ],
+        subtotal: 10500,
+        taxTotal: 1235,
+        discountTotal: 500,
+        grandTotal: 11235,
+        amountPaid: 0,
+        amountDue: 11235,
+        currency: isPabson ? 'NPR' : 'USD',
+        status: 'issued',
+        notes: isPabson
+            ? 'कृपया भुक्तानी मिति भित्र भुक्तानी गर्नुहोला।'
+            : 'Please pay by the due date to avoid late fees.',
+    };
+}
+/**
+ * 13 configurable fields surfaced in the C.2.4 editor. Adding a field here =
+ * one more form section appears in the editor, no editor code change required.
+ *
+ * Field IDs are dot-paths into `InvoiceTemplateConfig`. Editor RHF Controllers
+ * register at exactly these paths so the form state shape matches the config
+ * shape — `Object.assign(template, formState)` is a one-line apply on save.
+ */
+const invoiceConfigurableFields = [
+    // Header (5 fields)
+    { path: 'header.showLogo', type: 'toggle', labelKey: 'field.header.showLogo' },
+    { path: 'header.showSchoolName', type: 'toggle', labelKey: 'field.header.showSchoolName' },
+    { path: 'header.showSchoolAddress', type: 'toggle', labelKey: 'field.header.showSchoolAddress' },
+    { path: 'header.showContact', type: 'toggle', labelKey: 'field.header.showContact' },
+    { path: 'header.tagline', type: 'text', labelKey: 'field.header.tagline' },
+    // Line item columns (3 toggleable; description/amount/total always-on)
+    { path: 'lineItemColumns.quantity', type: 'toggle', labelKey: 'field.lineItems.quantity' },
+    { path: 'lineItemColumns.discount', type: 'toggle', labelKey: 'field.lineItems.discount' },
+    { path: 'lineItemColumns.taxRate', type: 'toggle', labelKey: 'field.lineItems.taxRate' },
+    { path: 'lineItemColumns.taxAmount', type: 'toggle', labelKey: 'field.lineItems.taxAmount' },
+    // Totals (3 toggleable)
+    { path: 'totalsSection.showSubtotal', type: 'toggle', labelKey: 'field.totals.showSubtotal' },
+    { path: 'totalsSection.showTaxTotal', type: 'toggle', labelKey: 'field.totals.showTaxTotal' },
+    { path: 'totalsSection.showDiscountTotal', type: 'toggle', labelKey: 'field.totals.showDiscountTotal' },
+    // Localization (2)
+    {
+        path: 'dateFormat',
+        type: 'select',
+        labelKey: 'field.dateFormat',
+        options: ['gregorian', 'bikram_sambat', 'dual'],
+    },
+];
+exports.invoiceDescriptor = {
+    docType: 'INVOICE',
+    i18nNamespace: 'invoice',
+    Component: InvoicePdf_1.InvoicePdf,
+    defaults: invoiceDefaults,
+    sampleData: invoiceSampleData,
+    configurableFields: invoiceConfigurableFields,
+};
+// Self-register at module load. Consumers only need
+// `import '@aibrains/pdf-renderer/descriptors/invoice'` (or transitive via
+// the package index) for `getDescriptor('INVOICE')` to resolve.
+(0, registry_1.registerDescriptor)(exports.invoiceDescriptor);
+//# sourceMappingURL=invoice.js.map

package/dist/descriptors/invoice.js.map

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

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":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AACpC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC;;;GAGG;AACH,MAAM,MAAM,OAAO,GACf,SAAS,GACT,SAAS,GACT,aAAa,GACb,YAAY,GACZ,YAAY,GACZ,iBAAiB,GACjB,sBAAsB,GACtB,sBAAsB,GACtB,aAAa,GACb,eAAe,GACf,kBAAkB,GAClB,WAAW,CAAC;AAEhB;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAOlF;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uBAAuB,CAAC,EAAE,WAAW,CAAC;IACtC,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qBAAqB,CAAC,EAAE,WAAW,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,uCAAuC;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,WAAW,GAAG,eAAe,CAAC;IACrD,4BAA4B;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAEhC,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,QAAQ,CAAC;IACjC,WAAW,EAAE,UAAU,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAGtE,MAAM,EAAE;QACN,QAAQ,EAAE,OAAO,CAAC;QAClB,cAAc,EAAE,OAAO,CAAC;QACxB,iBAAiB,EAAE,OAAO,CAAC;QAC3B,WAAW,EAAE,OAAO,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,MAAM,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,eAAe,EAAE,OAAO,CAAC;KAC1B,CAAC;IAGF,UAAU,EAAE,WAAW,GAAG,eAAe,GAAG,MAAM,CAAC;IACnD,YAAY,EAAE,aAAa,GAAG,SAAS,GAAG,qBAAqB,CAAC;IAChE,eAAe,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;IAChD;;;;;;;;OAQG;IACH,cAAc,EAAE,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IAE3C,sFAAsF;IACtF,iBAAiB,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CAC1C;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,kFAAkF;IAClF,IAAI,EACA,MAAM,GACN,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,aAAa,GACb,OAAO,GACP,MAAM,GACN,QAAQ,CAAC;IACb,wEAAwE;IACxE,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;CAC/C;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB,CAAC,KAAK,EAAE,OAAO,SAAS,iBAAiB;IAC9E,IAAI,EAAE,KAAK,CAAC;IACZ,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,WAAW,CAAC;IACtB,QAAQ,EAAE,iBAAiB,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,kBAAkB,CAAC,KAAK,EAAE,OAAO,SAAS,iBAAiB;IAC1E,0EAA0E;IAC1E,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,sBAAsB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IACvE;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IACxD;;;OAGG;IACH,UAAU,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IACxD,8EAA8E;IAC9E,kBAAkB,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAClD"}

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/documents/InvoicePdf.d.ts

@@ -0,0 +1,74 @@
+/**
+ * `<InvoicePdf>` — Sprint C.1.1 first document component for the renderer.
+ *
+ * Composes the C.0 primitives (Document + Page + BrandedHeader + BrandedFooter
+ * + Watermark) with the C.0 components (KeyValueTable + LineItemTable +
+ * TotalsBlock + SignatureLine). Zero new primitives — this whole document is
+ * a composition exercise.
+ *
+ * Dual-language label rendering: when `template.labelLanguages.length === 2`,
+ * each label renders STACKED VERTICALLY (primary in regular size, secondary
+ * at 80% size below). PABSON V1 default is `['en', 'ne']`. For single-language
+ * templates the secondary line is omitted entirely.
+ *
+ * Devanagari font selection is automatic via `pickFontFamily(text)` inside the
+ * primitive components — no work required by this document.
+ */
+import * as React from 'react';
+import { type LineItem } from '../components/LineItemTable';
+import type { DocumentComponentProps, PdfTemplateConfig } from '../descriptors/types';
+/**
+ * Per-doc-type config for invoices. Extends the shared `PdfTemplateConfig`
+ * with line-item column visibility + totals-block visibility — both editor-
+ * configurable via `invoiceDescriptor.configurableFields`.
+ */
+export interface InvoiceTemplateConfig extends PdfTemplateConfig {
+    lineItemColumns: {
+        description: boolean;
+        quantity: boolean;
+        amount: boolean;
+        discount: boolean;
+        taxRate: boolean;
+        taxAmount: boolean;
+        total: boolean;
+    };
+    totalsSection: {
+        showSubtotal: boolean;
+        showTaxTotal: boolean;
+        showDiscountTotal: boolean;
+        showAmountPaid: boolean;
+        showAmountDue: boolean;
+    };
+    footer: PdfTemplateConfig['footer'] & {
+        showSignatureLine: boolean;
+    };
+}
+/**
+ * Invoice data shape the document component renders. This is the minimum
+ * surface the renderer needs — the actual @aibrains/shared-types Invoice
+ * has more fields (taxSummary, statusHistory, etc.) that the renderer
+ * ignores. Endpoint callers can pass the full Invoice; structural typing
+ * lets the extra fields through harmlessly.
+ */
+export interface InvoiceDocumentData {
+    invoiceNumber: string;
+    issuedDate: string;
+    dueDate: string;
+    academicYear?: string;
+    billingPeriod?: string;
+    studentName: string;
+    studentId?: string;
+    gradeLevel?: string;
+    lineItems: LineItem[];
+    subtotal: number;
+    taxTotal: number;
+    discountTotal: number;
+    grandTotal: number;
+    amountPaid: number;
+    amountDue: number;
+    currency: string;
+    status: 'draft' | 'issued' | 'partially_paid' | 'paid' | 'overdue' | 'cancelled' | 'written_off';
+    notes?: string;
+}
+export declare const InvoicePdf: React.FC<DocumentComponentProps<InvoiceDocumentData, InvoiceTemplateConfig>>;
+//# sourceMappingURL=InvoicePdf.d.ts.map

package/dist/documents/InvoicePdf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvoicePdf.d.ts","sourceRoot":"","sources":["../../src/documents/InvoicePdf.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAQ/B,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAO3E,OAAO,KAAK,EACV,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,sBAAsB,CAAC;AAE9B;;;;GAIG;AACH,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC9D,eAAe,EAAE;QACf,WAAW,EAAE,OAAO,CAAC;QACrB,QAAQ,EAAE,OAAO,CAAC;QAClB,MAAM,EAAE,OAAO,CAAC;QAChB,QAAQ,EAAE,OAAO,CAAC;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,EAAE,OAAO,CAAC;QACnB,KAAK,EAAE,OAAO,CAAC;KAChB,CAAC;IACF,aAAa,EAAE;QACb,YAAY,EAAE,OAAO,CAAC;QACtB,YAAY,EAAE,OAAO,CAAC;QACtB,iBAAiB,EAAE,OAAO,CAAC;QAC3B,cAAc,EAAE,OAAO,CAAC;QACxB,aAAa,EAAE,OAAO,CAAC;KACxB,CAAC;IACF,MAAM,EAAE,iBAAiB,CAAC,QAAQ,CAAC,GAAG;QACpC,iBAAiB,EAAE,OAAO,CAAC;KAC5B,CAAC;CACH;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,aAAa,CAAC;IACjG,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAkFD,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAAC,mBAAmB,EAAE,qBAAqB,CAAC,CAsKnG,CAAC"}

package/dist/documents/InvoicePdf.js

@@ -0,0 +1,172 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvoicePdf = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const renderer_1 = require("@react-pdf/renderer");
+const Document_1 = require("../primitives/Document");
+const Page_1 = require("../primitives/Page");
+const BrandedHeader_1 = require("../primitives/BrandedHeader");
+const BrandedFooter_1 = require("../primitives/BrandedFooter");
+const Watermark_1 = require("../primitives/Watermark");
+const KeyValueTable_1 = require("../components/KeyValueTable");
+const LineItemTable_1 = require("../components/LineItemTable");
+const TotalsBlock_1 = require("../components/TotalsBlock");
+const SignatureLine_1 = require("../components/SignatureLine");
+const i18n_1 = require("../core/i18n");
+const format_1 = require("../core/format");
+const fonts_1 = require("../core/fonts");
+const theme_1 = require("../core/theme");
+const styles = renderer_1.StyleSheet.create({
+    metaBlock: {
+        marginTop: theme_1.DEFAULT_SPACING.md,
+        marginBottom: theme_1.DEFAULT_SPACING.md,
+    },
+    sectionTitle: {
+        fontSize: theme_1.DEFAULT_FONT_SIZE.md,
+        fontWeight: 700,
+        color: theme_1.DEFAULT_COLORS.text,
+        marginBottom: theme_1.DEFAULT_SPACING.xs,
+    },
+    sectionTitleSecondary: {
+        fontSize: theme_1.DEFAULT_FONT_SIZE.sm,
+        color: theme_1.DEFAULT_COLORS.textMuted,
+        marginBottom: theme_1.DEFAULT_SPACING.sm,
+    },
+    notesBlock: {
+        marginTop: theme_1.DEFAULT_SPACING.md,
+        padding: theme_1.DEFAULT_SPACING.sm,
+        backgroundColor: '#F8F9FA',
+        borderLeftWidth: 3,
+        borderLeftColor: theme_1.DEFAULT_COLORS.border,
+    },
+    notesLabel: {
+        fontSize: theme_1.DEFAULT_FONT_SIZE.sm,
+        fontWeight: 700,
+        color: theme_1.DEFAULT_COLORS.text,
+        marginBottom: theme_1.DEFAULT_SPACING.xs,
+    },
+    notesText: {
+        fontSize: theme_1.DEFAULT_FONT_SIZE.sm,
+        color: theme_1.DEFAULT_COLORS.text,
+    },
+});
+/**
+ * Build a one-line label per the template's labelLanguages. Returns the
+ * primary translation; the caller renders the secondary (if present)
+ * separately via `buildSecondary`.
+ */
+function buildPrimary(key, langs) {
+    return (0, i18n_1.t)('invoice', key, langs[0]);
+}
+/**
+ * Returns the secondary-language label when the template is dual-language,
+ * else undefined. The caller renders it stacked below the primary at 80%
+ * size with the same family.
+ */
+function buildSecondary(key, langs) {
+    return langs.length >= 2 ? (0, i18n_1.t)('invoice', key, langs[1]) : undefined;
+}
+/**
+ * Dual-language label for free-form labels (not for the table headers which
+ * use a single string and are themselves bilingual via Devanagari font run).
+ */
+const dualLabelStyles = renderer_1.StyleSheet.create({
+    primary: {
+        fontSize: theme_1.DEFAULT_FONT_SIZE.sm,
+        color: theme_1.DEFAULT_COLORS.text,
+    },
+    secondary: {
+        fontSize: theme_1.DEFAULT_FONT_SIZE.sm * 0.8,
+        color: theme_1.DEFAULT_COLORS.textMuted,
+    },
+});
+/** Stacked dual-language label primitive (small enough to inline here). */
+const DualLabel = ({ primary, secondary }) => ((0, jsx_runtime_1.jsxs)(renderer_1.View, { children: [(0, jsx_runtime_1.jsx)(renderer_1.Text, { style: [dualLabelStyles.primary, { fontFamily: (0, fonts_1.pickFontFamily)(primary) }], children: primary }), secondary && ((0, jsx_runtime_1.jsx)(renderer_1.Text, { style: [dualLabelStyles.secondary, { fontFamily: (0, fonts_1.pickFontFamily)(secondary) }], children: secondary }))] }));
+const InvoicePdf = ({ data, template, branding, settings, }) => {
+    var _a, _b, _c, _d, _e, _f, _g, _h;
+    const langs = template.labelLanguages;
+    const isDualLang = langs.length >= 2;
+    // Number + currency formatters bound once per render
+    const numberGrouping = template.numberFormat === 'auto-from-workspace'
+        ? 'western'
+        : template.numberFormat;
+    const renderNumber = (v) => (0, format_1.formatNumber)(v !== null && v !== void 0 ? v : 0, numberGrouping);
+    // Currency display: shared-types `formatCurrency` exposes `showSymbol` only;
+    // map V1 `'symbol'` → showSymbol:true and `'iso-code'`/`'name'` → false (the
+    // ISO code prefix is added by the shared-types implementation as the
+    // fallback shape). When showSymbol is true the symbol/native symbol is used.
+    const renderCurrency = (v) => (0, format_1.formatCurrency)(v, data.currency, {
+        locale: settings.defaultLocale,
+        showSymbol: template.currencyDisplay === 'symbol',
+    });
+    // Header label resolution — uses BrandedHeader's own config shape
+    const headerConfig = {
+        showLogo: template.header.showLogo,
+        showSchoolName: template.header.showSchoolName,
+        showSchoolAddress: template.header.showSchoolAddress,
+        showContact: template.header.showContact,
+        tagline: template.header.tagline,
+        primaryColor: (_a = template.brandingOverrides) === null || _a === void 0 ? void 0 : _a.primaryColor,
+    };
+    const headerBranding = {
+        logoSrc: (_c = (_b = template.brandingOverrides) === null || _b === void 0 ? void 0 : _b.logoSrc) !== null && _c !== void 0 ? _c : branding.logoSrc,
+        schoolName: branding.schoolName,
+        addressLines: (_e = (_d = template.brandingOverrides) === null || _d === void 0 ? void 0 : _d.addressLines) !== null && _e !== void 0 ? _e : branding.addressLines,
+        phone: branding.phone,
+        email: branding.email,
+    };
+    // Watermark on draft / cancelled invoices
+    const watermarkLabel = data.status === 'draft'
+        ? (0, i18n_1.t)('invoice', 'watermarkDraft', langs[0])
+        : data.status === 'cancelled'
+            ? (0, i18n_1.t)('invoice', 'watermarkCancelled', langs[0])
+            : undefined;
+    // KeyValueTable expects pre-formatted strings; build them with dual-lang
+    // labels rendered ABOVE each value would require a custom row primitive,
+    // so V1 uses primary-language labels in the metadata table and emits
+    // a small bilingual title above it. Acceptable trade-off; the table
+    // itself stays in C.0's existing API.
+    const metadataEntries = [
+        { label: buildPrimary('invoiceNumber', langs), value: data.invoiceNumber },
+        { label: buildPrimary('issuedDate', langs), value: (0, format_1.formatDate)(data.issuedDate, template.dateFormat) },
+        { label: buildPrimary('dueDate', langs), value: (0, format_1.formatDate)(data.dueDate, template.dateFormat) },
+        { label: buildPrimary('studentName', langs), value: data.studentName },
+        { label: buildPrimary('gradeLevel', langs), value: data.gradeLevel },
+        { label: buildPrimary('academicYear', langs), value: data.academicYear },
+        { label: buildPrimary('billingPeriod', langs), value: data.billingPeriod },
+    ];
+    return ((0, jsx_runtime_1.jsx)(Document_1.Document, { title: `Invoice ${data.invoiceNumber}`, subject: "Invoice", children: (0, jsx_runtime_1.jsxs)(Page_1.Page, { size: template.pageSize, orientation: template.orientation, margins: template.margins, children: [watermarkLabel && (0, jsx_runtime_1.jsx)(Watermark_1.Watermark, { text: watermarkLabel }), (0, jsx_runtime_1.jsx)(BrandedHeader_1.BrandedHeader, { branding: headerBranding, config: headerConfig }), (0, jsx_runtime_1.jsxs)(renderer_1.View, { style: styles.metaBlock, children: [(0, jsx_runtime_1.jsx)(renderer_1.Text, { style: [styles.sectionTitle, { fontFamily: (0, fonts_1.pickFontFamily)(buildPrimary('title', langs)) }], children: buildPrimary('title', langs) }), isDualLang && ((0, jsx_runtime_1.jsx)(renderer_1.Text, { style: [
+                                styles.sectionTitleSecondary,
+                                { fontFamily: (0, fonts_1.pickFontFamily)((_f = buildSecondary('title', langs)) !== null && _f !== void 0 ? _f : '') },
+                            ], children: buildSecondary('title', langs) })), (0, jsx_runtime_1.jsx)(KeyValueTable_1.KeyValueTable, { entries: metadataEntries })] }), (0, jsx_runtime_1.jsx)(LineItemTable_1.LineItemTable, { items: data.lineItems, columns: template.lineItemColumns, headers: {
+                        description: buildPrimary('description', langs),
+                        quantity: buildPrimary('quantity', langs),
+                        amount: buildPrimary('amount', langs),
+                        discount: buildPrimary('discount', langs),
+                        taxRate: buildPrimary('taxRate', langs),
+                        taxAmount: buildPrimary('taxAmount', langs),
+                        total: buildPrimary('total', langs),
+                    }, renderNumber: renderNumber }), (0, jsx_runtime_1.jsx)(TotalsBlock_1.TotalsBlock, { entries: {
+                        subtotal: data.subtotal,
+                        taxTotal: data.taxTotal,
+                        discountTotal: data.discountTotal,
+                        grandTotal: data.grandTotal,
+                        amountPaid: data.amountPaid,
+                        amountDue: data.amountDue,
+                    }, visibility: {
+                        showSubtotal: template.totalsSection.showSubtotal,
+                        showTaxTotal: template.totalsSection.showTaxTotal,
+                        showDiscountTotal: template.totalsSection.showDiscountTotal,
+                        showAmountPaid: template.totalsSection.showAmountPaid,
+                        showAmountDue: template.totalsSection.showAmountDue,
+                    }, labels: {
+                        subtotal: buildPrimary('subtotal', langs),
+                        taxTotal: buildPrimary('totalTax', langs),
+                        discountTotal: buildPrimary('totalDiscount', langs),
+                        grandTotal: buildPrimary('grandTotal', langs),
+                        amountPaid: buildPrimary('amountPaid', langs),
+                        amountDue: buildPrimary('amountDue', langs),
+                    }, renderCurrency: renderCurrency }), data.notes && ((0, jsx_runtime_1.jsxs)(renderer_1.View, { style: styles.notesBlock, children: [(0, jsx_runtime_1.jsx)(DualLabel, { primary: buildPrimary('notes', langs), secondary: buildSecondary('notes', langs) }), (0, jsx_runtime_1.jsx)(renderer_1.Text, { style: [styles.notesText, { fontFamily: (0, fonts_1.pickFontFamily)(data.notes) }], children: data.notes.length > 500 ? `${data.notes.slice(0, 500)}…` : data.notes })] })), template.footer.showSignatureLine && ((0, jsx_runtime_1.jsx)(SignatureLine_1.SignatureLine, { caption: (_h = (_g = branding.formalName) !== null && _g !== void 0 ? _g : branding.schoolName) !== null && _h !== void 0 ? _h : '', signatureSrc: branding.principalSignatureSrc, align: "right" })), (0, jsx_runtime_1.jsx)(BrandedFooter_1.BrandedFooter, { text: template.footer.text, showPageNumbers: template.footer.showPageNumbers, lang: langs[0] })] }) }));
+};
+exports.InvoicePdf = InvoicePdf;
+//# sourceMappingURL=InvoicePdf.js.map

package/dist/documents/InvoicePdf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvoicePdf.js","sourceRoot":"","sources":["../../src/documents/InvoicePdf.tsx"],"names":[],"mappings":"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"}

package/dist/i18n/en/invoice.json

@@ -0,0 +1,31 @@
+{
+    "title": "Invoice",
+    "invoiceNumber": "Invoice No.",
+    "issuedDate": "Issued",
+    "dueDate": "Due",
+    "academicYear": "Academic Year",
+    "billingPeriod": "Billing Period",
+    "billedTo": "Billed to",
+    "studentName": "Student",
+    "studentId": "Student ID",
+    "gradeLevel": "Grade",
+    "lineItems": "Line items",
+    "description": "Description",
+    "quantity": "Qty",
+    "amount": "Amount",
+    "discount": "Discount",
+    "taxRate": "Tax %",
+    "taxAmount": "Tax",
+    "total": "Total",
+    "subtotal": "Subtotal",
+    "totalTax": "Total tax",
+    "totalDiscount": "Total discount",
+    "grandTotal": "Grand total",
+    "amountPaid": "Paid",
+    "amountDue": "Due",
+    "status": "Status",
+    "notes": "Notes",
+    "footerThankYou": "Thank you for your payment.",
+    "watermarkDraft": "DRAFT",
+    "watermarkCancelled": "CANCELLED"
+}

package/dist/i18n/ne/invoice.json

@@ -0,0 +1,31 @@
+{
+    "title": "बिल",
+    "invoiceNumber": "बिल नं.",
+    "issuedDate": "जारी मिति",
+    "dueDate": "भुक्तानी मिति",
+    "academicYear": "शैक्षिक वर्ष",
+    "billingPeriod": "बिलिंग अवधि",
+    "billedTo": "बिल प्राप्तकर्ता",
+    "studentName": "विद्यार्थीको नाम",
+    "studentId": "विद्यार्थी आईडी",
+    "gradeLevel": "कक्षा",
+    "lineItems": "विवरण",
+    "description": "विवरण",
+    "quantity": "संख्या",
+    "amount": "रकम",
+    "discount": "छुट",
+    "taxRate": "कर %",
+    "taxAmount": "कर",
+    "total": "जम्मा",
+    "subtotal": "उप-योग",
+    "totalTax": "जम्मा कर",
+    "totalDiscount": "जम्मा छुट",
+    "grandTotal": "जम्मा रकम",
+    "amountPaid": "भुक्तानी",
+    "amountDue": "बाँकी",
+    "status": "स्थिति",
+    "notes": "टिप्पणी",
+    "footerThankYou": "तपाईंको भुक्तानीको लागि धन्यवाद।",
+    "watermarkDraft": "मस्यौदा",
+    "watermarkCancelled": "रद्द"
+}

package/dist/index.d.ts

@@ -4,18 +4,23 @@
  * Sprint C.0.2 ships core utilities (theme tokens, i18n helper, date/currency
  * /number format helpers). Bikram Sambat support comes via `@aibrains/shared-types`.
  *
- * Subsequent C.0.* tickets add:
- *   - C.0.3: fonts registration (Noto Sans + Noto Sans Devanagari) + layout
- *            primitives (Document, Page, BrandedHeader, BrandedFooter, Watermark)
- *            + reusable components (KeyValueTable, LineItemTable, TotalsBlock,
- *            SignatureLine) + Devanagari snapshot tests
+ * Shipped:
+ *   - C.0.2: core utilities (fonts + theme + i18n + format)
+ *   - C.0.3: layout primitives + reusable components + Devanagari R45 canary
  *   - C.0.4: TemplateDescriptor<T> generic + per-docType registry
- * Sprint C.1+: <InvoicePdf>, <ReceiptPdf>, <ReportCardPdf>, ...
+ *   - C.1.1: <InvoicePdf> document + invoice descriptor + invoice i18n
+ *
+ * Sprint C.1.2+: <ReceiptPdf>, <ReportCardPdf>, …
  *
  * Design source of truth: docs/pilot-greenlight/c-epic-pdf-generation-design.md
  */
-export declare const PDF_RENDERER_PACKAGE_VERSION = "0.3.0";
+export declare const PDF_RENDERER_PACKAGE_VERSION = "0.5.0";
 export * from './core';
 export * from './primitives';
 export * from './components';
+export * from './descriptors';
+import './descriptors/invoice';
+export { InvoicePdf } from './documents/InvoicePdf';
+export type { InvoiceTemplateConfig, InvoiceDocumentData } from './documents/InvoicePdf';
+export { invoiceDescriptor } from './descriptors/invoice';
 //# 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;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}
+{"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;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAM9B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,YAAY,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -5,13 +5,13 @@
  * Sprint C.0.2 ships core utilities (theme tokens, i18n helper, date/currency
  * /number format helpers). Bikram Sambat support comes via `@aibrains/shared-types`.
  *
- * Subsequent C.0.* tickets add:
- *   - C.0.3: fonts registration (Noto Sans + Noto Sans Devanagari) + layout
- *            primitives (Document, Page, BrandedHeader, BrandedFooter, Watermark)
- *            + reusable components (KeyValueTable, LineItemTable, TotalsBlock,
- *            SignatureLine) + Devanagari snapshot tests
+ * Shipped:
+ *   - C.0.2: core utilities (fonts + theme + i18n + format)
+ *   - C.0.3: layout primitives + reusable components + Devanagari R45 canary
  *   - C.0.4: TemplateDescriptor<T> generic + per-docType registry
- * Sprint C.1+: <InvoicePdf>, <ReceiptPdf>, <ReportCardPdf>, ...
+ *   - C.1.1: <InvoicePdf> document + invoice descriptor + invoice i18n
+ *
+ * Sprint C.1.2+: <ReceiptPdf>, <ReportCardPdf>, …
  *
  * Design source of truth: docs/pilot-greenlight/c-epic-pdf-generation-design.md
  */
@@ -30,10 +30,20 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PDF_RENDERER_PACKAGE_VERSION = void 0;
-exports.PDF_RENDERER_PACKAGE_VERSION = '0.3.0';
-// Re-export the C.0.2 core API surface + C.0.3 primitives + components.
+exports.invoiceDescriptor = exports.InvoicePdf = exports.PDF_RENDERER_PACKAGE_VERSION = void 0;
+exports.PDF_RENDERER_PACKAGE_VERSION = '0.5.0';
+// Core + primitives + components + descriptor registry from Sprint C.0.
 __exportStar(require("./core"), exports);
 __exportStar(require("./primitives"), exports);
 __exportStar(require("./components"), exports);
+__exportStar(require("./descriptors"), exports);
+// C.1.1 — first concrete document. Importing this module's descriptor file
+// has the side-effect of self-registering it with the registry. Consumers
+// that only `import '@aibrains/pdf-renderer'` (the package root) get
+// `getDescriptor('INVOICE')` working transitively.
+require("./descriptors/invoice");
+var InvoicePdf_1 = require("./documents/InvoicePdf");
+Object.defineProperty(exports, "InvoicePdf", { enumerable: true, get: function () { return InvoicePdf_1.InvoicePdf; } });
+var invoice_1 = require("./descriptors/invoice");
+Object.defineProperty(exports, "invoiceDescriptor", { enumerable: true, get: function () { return invoice_1.invoiceDescriptor; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;;;;;;;;;;;;;;;AAEU,QAAA,4BAA4B,GAAG,OAAO,CAAC;AAEpD,wEAAwE;AACxE,yCAAuB;AACvB,+CAA6B;AAC7B,+CAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;;;;;;;;;;;;;;;AAEU,QAAA,4BAA4B,GAAG,OAAO,CAAC;AAEpD,wEAAwE;AACxE,yCAAuB;AACvB,+CAA6B;AAC7B,+CAA6B;AAC7B,gDAA8B;AAE9B,2EAA2E;AAC3E,0EAA0E;AAC1E,qEAAqE;AACrE,mDAAmD;AACnD,iCAA+B;AAC/B,qDAAoD;AAA3C,wGAAA,UAAU,OAAA;AAEnB,iDAA0D;AAAjD,4GAAA,iBAAiB,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aibrains/pdf-renderer",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "EdForge PDF rendering library. JSX-based document templates built on @react-pdf/renderer, with localization (EN + NE), Bikram Sambat date support, and a TemplateDescriptor registry for cross-domain doc types (invoice, receipt, report card, admit card, etc.).",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -24,6 +24,11 @@
       "types": "./dist/components/index.d.ts",
       "require": "./dist/components/index.js",
       "default": "./dist/components/index.js"
+    },
+    "./descriptors": {
+      "types": "./dist/descriptors/index.d.ts",
+      "require": "./dist/descriptors/index.js",
+      "default": "./dist/descriptors/index.js"
     }
   },
   "files": [