@aibrains/pdf-renderer 0.3.0 → 0.4.0

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":"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/index.d.ts

@@ -14,8 +14,9 @@
  *
  * 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.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;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;AAIpD,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -31,9 +31,11 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 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.PDF_RENDERER_PACKAGE_VERSION = '0.4.0';
+// Re-export the C.0.2 core API surface + C.0.3 primitives + components
+// + C.0.4 descriptor registry.
 __exportStar(require("./core"), exports);
 __exportStar(require("./primitives"), exports);
 __exportStar(require("./components"), exports);
+__exportStar(require("./descriptors"), exports);
 //# 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,uEAAuE;AACvE,+BAA+B;AAC/B,yCAAuB;AACvB,+CAA6B;AAC7B,+CAA6B;AAC7B,gDAA8B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aibrains/pdf-renderer",
-  "version": "0.3.0",
+  "version": "0.4.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": [