@aibrains/pdf-renderer 0.2.0

package/README.md

@@ -0,0 +1,41 @@
+# @aibrains/pdf-renderer
+
+EdForge PDF rendering library. JSX-based document templates built on
+[`@react-pdf/renderer`](https://react-pdf.org/), with Devanagari (Nepali) font support,
+Bikram Sambat date support, and a `TemplateDescriptor` registry for cross-domain
+document types.
+
+## Status
+
+**Sprint C.0.1 — skeleton + first publish.** No documents or primitives shipped yet.
+See [`docs/pilot-greenlight/c-epic-pdf-generation-design.md`](../../docs/pilot-greenlight/c-epic-pdf-generation-design.md)
+for the architecture and the C.0.* sprint plan.
+
+## Roadmap (C.0.* tickets)
+
+| Ticket | Content |
+| --- | --- |
+| **C.0.1** (this) | Package skeleton, build infrastructure, first publish to npm at 0.1.0 |
+| C.0.2 | Fonts (Latin + Devanagari), theme tokens, i18n helpers (EN/NE bundles), format helpers (Gregorian/BS/dual date, currency, number) |
+| C.0.3 | Layout primitives (`Document`, `Page`, `BrandedHeader`, `BrandedFooter`, `Watermark`) + reusable components (`KeyValueTable`, `LineItemTable`, `TotalsBlock`, `SignatureLine`) |
+| C.0.4 | `TemplateDescriptor<T>` type + per-`DocType` registry (`getDescriptor`, `registerDescriptor`) |
+| C.0.5 | `SchoolBranding` schema + entity extension (lands on `@aibrains/shared-types` + identity service — not this package) |
+| C.0.6 | Tenant PDF S3 buckets via CDK (not this package) |
+| C.0.7 | Branding presigned-upload + GET endpoints (identity service — not this package) |
+| C.1.* | First document components: `<InvoicePdf>`, `<ReceiptPdf>` |
+| C.3.1 | `<GradeTable>` component + `<ReportCardPdf>` |
+| C.5.1 | `<AdmitCardPdf>` data-shape |
+
+## Build
+
+```bash
+# From repo root
+npm install
+cd packages/pdf-renderer
+npm run build      # produces dist/index.js + dist/index.d.ts
+npm run typecheck  # tsc --noEmit
+```
+
+## License
+
+MIT — see [LICENSE](../../LICENSE) at the repo root.

package/dist/core/format.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Date / currency / number formatting helpers for PDF documents.
+ *
+ * Wraps utilities from `@aibrains/shared-types`:
+ *   - `gregorianToBs` for Bikram Sambat conversion (BS 2000-2090)
+ *   - `formatCurrency` for archetype-aware currency rendering
+ *
+ * Three date modes per the design (§5.1):
+ *   - `gregorian`: AD only, ISO-style "YYYY-MM-DD"
+ *   - `bikram_sambat`: BS only, "B.S. YYYY-MM-DD"
+ *   - `dual`: BS first, AD in parens — "B.S. YYYY-MM-DD (YYYY-MM-DD)"
+ *
+ * Locale parameter is accepted for future expansion (e.g., long-form month
+ * names per locale), but V1 outputs are locale-independent format strings.
+ */
+export type DateFormat = 'gregorian' | 'bikram_sambat' | 'dual';
+/**
+ * Format an ISO-8601 date string for display in a PDF.
+ *
+ * @example
+ *   formatDate('2026-04-28T00:00:00Z', 'gregorian', 'en-US')  // '2026-04-28'
+ *   formatDate('2026-04-28T00:00:00Z', 'bikram_sambat', 'ne-NP')  // 'B.S. 2083-01-15'
+ *   formatDate('2026-04-28T00:00:00Z', 'dual', 'ne-NP')  // 'B.S. 2083-01-15 (2026-04-28)'
+ */
+export declare function formatDate(isoDate: string, format: DateFormat, _locale?: string): string;
+/**
+ * Format a number with locale-aware grouping. V1 supports south-asian
+ * (lakh / crore grouping) and western (thousands grouping) styles.
+ *
+ * Currency formatting that respects the archetype workspace setting lives
+ * in `@aibrains/shared-types/utils/currency::formatCurrency`. Re-exported
+ * from this module for convenience so document components have one import.
+ *
+ * @example
+ *   formatNumber(1234567, 'south-asian')  // '12,34,567'
+ *   formatNumber(1234567, 'western')      // '1,234,567'
+ */
+export type NumberGrouping = 'south-asian' | 'western';
+export declare function formatNumber(value: number, grouping: NumberGrouping): string;
+export { formatCurrency } from '@aibrains/shared-types';
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/core/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,eAAe,GAAG,MAAM,CAAC;AAEhE;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,UAAU,EAElB,OAAO,GAAE,MAAgB,GACxB,MAAM,CAgBR;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,SAAS,CAAC;AAEvD,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,cAAc,GACvB,MAAM,CAOR;AAID,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/core/format.js

@@ -0,0 +1,98 @@
+"use strict";
+/**
+ * Date / currency / number formatting helpers for PDF documents.
+ *
+ * Wraps utilities from `@aibrains/shared-types`:
+ *   - `gregorianToBs` for Bikram Sambat conversion (BS 2000-2090)
+ *   - `formatCurrency` for archetype-aware currency rendering
+ *
+ * Three date modes per the design (§5.1):
+ *   - `gregorian`: AD only, ISO-style "YYYY-MM-DD"
+ *   - `bikram_sambat`: BS only, "B.S. YYYY-MM-DD"
+ *   - `dual`: BS first, AD in parens — "B.S. YYYY-MM-DD (YYYY-MM-DD)"
+ *
+ * Locale parameter is accepted for future expansion (e.g., long-form month
+ * names per locale), but V1 outputs are locale-independent format strings.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatCurrency = void 0;
+exports.formatDate = formatDate;
+exports.formatNumber = formatNumber;
+const shared_types_1 = require("@aibrains/shared-types");
+/**
+ * Format an ISO-8601 date string for display in a PDF.
+ *
+ * @example
+ *   formatDate('2026-04-28T00:00:00Z', 'gregorian', 'en-US')  // '2026-04-28'
+ *   formatDate('2026-04-28T00:00:00Z', 'bikram_sambat', 'ne-NP')  // 'B.S. 2083-01-15'
+ *   formatDate('2026-04-28T00:00:00Z', 'dual', 'ne-NP')  // 'B.S. 2083-01-15 (2026-04-28)'
+ */
+function formatDate(isoDate, format, 
+// locale reserved for V1.5 long-form months; suppress unused warning explicitly
+_locale = 'en-US') {
+    // Normalize any ISO form (date-only or datetime, with or without TZ) to
+    // YYYY-MM-DD before BS conversion. Document dates (dueDate, issuedDate,
+    // etc.) are calendrical, not precise instants — and the shared-types BS
+    // converter has different behavior for date-only vs `T00:00:00Z` strings
+    // (date-only anchors to noon-local; datetime hits UTC interpretation and
+    // can be off-by-one in non-UTC timezones). Slicing first removes ambiguity.
+    const dateOnly = normalizeToDateOnly(isoDate);
+    if (format === 'gregorian')
+        return dateOnly;
+    const bs = (0, shared_types_1.gregorianToBs)(dateOnly);
+    const bsStr = `B.S. ${bs.year}-${pad2(bs.month)}-${pad2(bs.day)}`;
+    if (format === 'bikram_sambat')
+        return bsStr;
+    // dual: BS first, AD in parens
+    return `${bsStr} (${dateOnly})`;
+}
+function formatNumber(value, grouping) {
+    if (!Number.isFinite(value))
+        return '0';
+    if (grouping === 'western') {
+        return Math.trunc(value).toLocaleString('en-US');
+    }
+    // South-asian: last 3 digits, then groups of 2 (Indian-style lakh/crore)
+    return formatSouthAsian(value);
+}
+// Re-export the canonical currency formatter so consumers have one import path
+// for all formatting helpers.
+var shared_types_2 = require("@aibrains/shared-types");
+Object.defineProperty(exports, "formatCurrency", { enumerable: true, get: function () { return shared_types_2.formatCurrency; } });
+// --- internals ---
+const YMD_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+/**
+ * Extract YYYY-MM-DD from any ISO-8601 input. Works for both date-only
+ * (`'2026-04-28'`) and full datetime (`'2026-04-28T17:30:00Z'`) — slices the
+ * first 10 chars when the prefix is well-formed, falls back to UTC-component
+ * parsing otherwise. Returns the raw input verbatim if both paths fail
+ * (PDF rendering must never crash on a malformed date — surface it instead).
+ */
+function normalizeToDateOnly(iso) {
+    const slice = iso.slice(0, 10);
+    if (YMD_PATTERN.test(slice))
+        return slice;
+    const d = new Date(iso);
+    if (Number.isNaN(d.getTime()))
+        return iso;
+    const yyyy = d.getUTCFullYear();
+    const mm = pad2(d.getUTCMonth() + 1);
+    const dd = pad2(d.getUTCDate());
+    return `${yyyy}-${mm}-${dd}`;
+}
+function pad2(n) {
+    return n.toString().padStart(2, '0');
+}
+function formatSouthAsian(value) {
+    const isNegative = value < 0;
+    const abs = Math.trunc(Math.abs(value)).toString();
+    if (abs.length <= 3)
+        return isNegative ? `-${abs}` : abs;
+    const lastThree = abs.slice(-3);
+    const rest = abs.slice(0, -3);
+    // Group rest into pairs from the right.
+    const grouped = rest.replace(/\B(?=(\d{2})+(?!\d))/g, ',');
+    const formatted = `${grouped},${lastThree}`;
+    return isNegative ? `-${formatted}` : formatted;
+}
+//# sourceMappingURL=format.js.map

package/dist/core/format.js.map

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

package/dist/core/i18n.d.ts

@@ -0,0 +1,45 @@
+/**
+ * i18n helper for document labels.
+ *
+ * Translations live in JSON bundles under `src/i18n/{lang}/{namespace}.json`,
+ * loaded statically at module init via `resolveJsonModule`. The bundle ships
+ * with the package; consumers never load external translation files.
+ *
+ * Fallback rules:
+ *   - Missing key in target language → fall back to English.
+ *   - Missing key in English → return the key itself (visible breadcrumb in
+ *     the rendered PDF, surfacing the gap to whoever's reviewing).
+ *   - Missing namespace → behaves as missing key.
+ *
+ * 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+.
+ */
+/** Supported document languages in V1. */
+export type Lang = 'en' | 'ne';
+/** Supported translation namespaces in V1. New doc types append here. */
+export type Namespace = 'common';
+/**
+ * Translate a key.
+ *
+ * @example
+ *   t('common', 'subtotal', 'ne')                  // → 'उप-योग'
+ *   t('common', 'pageOf', 'en', {page: 1, total: 3}) // → 'Page 1 of 3'
+ *   t('common', 'nonexistentKey', 'ne')             // → 'nonexistentKey' (and absent from EN too)
+ */
+export declare function t(namespace: Namespace, key: string, lang: Lang, vars?: Record<string, string | number | undefined | null>): string;
+/**
+ * Render the same key in two languages side-by-side. Used when a template
+ * has `labelLanguages: ['en', 'ne']` (dual-language mode).
+ *
+ * @example
+ *   tDual('common', 'subtotal', ['en', 'ne'])  // → { primary: 'Subtotal', secondary: 'उप-योग' }
+ */
+export declare function tDual(namespace: Namespace, key: string, langs: [Lang, Lang], vars?: Record<string, string | number | undefined | null>): {
+    primary: string;
+    secondary: string;
+};
+//# sourceMappingURL=i18n.d.ts.map

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

@@ -0,0 +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"}

package/dist/core/i18n.js

@@ -0,0 +1,67 @@
+"use strict";
+/**
+ * i18n helper for document labels.
+ *
+ * Translations live in JSON bundles under `src/i18n/{lang}/{namespace}.json`,
+ * loaded statically at module init via `resolveJsonModule`. The bundle ships
+ * with the package; consumers never load external translation files.
+ *
+ * Fallback rules:
+ *   - Missing key in target language → fall back to English.
+ *   - Missing key in English → return the key itself (visible breadcrumb in
+ *     the rendered PDF, surfacing the gap to whoever's reviewing).
+ *   - Missing namespace → behaves as missing key.
+ *
+ * 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+.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+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 BUNDLES = {
+    en: { common: common_json_1.default },
+    ne: { common: common_json_2.default },
+};
+/** Default fallback language when target language is missing a key. */
+const FALLBACK_LANG = 'en';
+/**
+ * Translate a key.
+ *
+ * @example
+ *   t('common', 'subtotal', 'ne')                  // → 'उप-योग'
+ *   t('common', 'pageOf', 'en', {page: 1, total: 3}) // → 'Page 1 of 3'
+ *   t('common', 'nonexistentKey', 'ne')             // → 'nonexistentKey' (and absent from EN too)
+ */
+function t(namespace, key, lang, vars) {
+    var _a, _b, _c, _d, _e, _f;
+    const raw = (_f = (_c = (_b = (_a = BUNDLES[lang]) === null || _a === void 0 ? void 0 : _a[namespace]) === null || _b === void 0 ? void 0 : _b[key]) !== null && _c !== void 0 ? _c : (_e = (_d = BUNDLES[FALLBACK_LANG]) === null || _d === void 0 ? void 0 : _d[namespace]) === null || _e === void 0 ? void 0 : _e[key]) !== null && _f !== void 0 ? _f : key;
+    if (!vars)
+        return raw;
+    return raw.replace(/\{(\w+)\}/g, (match, varName) => {
+        const value = vars[varName];
+        return value === undefined || value === null ? '' : String(value);
+    });
+}
+/**
+ * Render the same key in two languages side-by-side. Used when a template
+ * has `labelLanguages: ['en', 'ne']` (dual-language mode).
+ *
+ * @example
+ *   tDual('common', 'subtotal', ['en', 'ne'])  // → { primary: 'Subtotal', secondary: 'उप-योग' }
+ */
+function tDual(namespace, key, langs, vars) {
+    return {
+        primary: t(namespace, key, langs[0], vars),
+        secondary: t(namespace, key, langs[1], vars),
+    };
+}
+//# sourceMappingURL=i18n.js.map

package/dist/core/i18n.js.map

@@ -0,0 +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"}

package/dist/core/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Core utilities for @aibrains/pdf-renderer documents.
+ *
+ * Sprint C.0.2 — exports theme tokens, i18n helper, and format helpers.
+ * Subsequent sprints (C.0.3+) add fonts registration, layout primitives,
+ * and reusable components on top of these.
+ */
+export { DEFAULT_COLORS, DEFAULT_SPACING, DEFAULT_FONT_SIZE, DEFAULT_MARGINS_MM, } from './theme';
+export type { Colors, Spacing, FontSize, Margins } from './theme';
+export { t, tDual } from './i18n';
+export type { Lang, Namespace } from './i18n';
+export { formatDate, formatNumber, formatCurrency } from './format';
+export type { DateFormat, NumberGrouping } from './format';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/core/index.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Core utilities for @aibrains/pdf-renderer documents.
+ *
+ * Sprint C.0.2 — exports theme tokens, i18n helper, and format helpers.
+ * Subsequent sprints (C.0.3+) add fonts registration, layout primitives,
+ * 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;
+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; } });
+Object.defineProperty(exports, "DEFAULT_FONT_SIZE", { enumerable: true, get: function () { return theme_1.DEFAULT_FONT_SIZE; } });
+Object.defineProperty(exports, "DEFAULT_MARGINS_MM", { enumerable: true, get: function () { return theme_1.DEFAULT_MARGINS_MM; } });
+var i18n_1 = require("./i18n");
+Object.defineProperty(exports, "t", { enumerable: true, get: function () { return i18n_1.t; } });
+Object.defineProperty(exports, "tDual", { enumerable: true, get: function () { return i18n_1.tDual; } });
+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; } });
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +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"}

package/dist/core/theme.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Default theme tokens for @aibrains/pdf-renderer documents.
+ *
+ * These are the defaults applied when a template's `brandingOverrides` does not
+ * specify the value. Document components import from here; per-template overrides
+ * are layered on top at render time via `template.brandingOverrides`.
+ *
+ * V1 keeps tokens minimal (8 colors, 5 spacings, 5 font sizes). Future sprints
+ * may extend without breaking consumers.
+ */
+export declare const DEFAULT_COLORS: {
+    /** Default primary accent (EdForge teal). Overridden per template. */
+    readonly primary: "#0D9488";
+    /** Default accent (used for secondary headings, hover-like states). */
+    readonly accent: "#0F766E";
+    /** Body text. */
+    readonly text: "#1F2937";
+    /** Muted text (metadata, captions). */
+    readonly textMuted: "#6B7280";
+    /** Light border (table dividers). */
+    readonly border: "#E5E7EB";
+    /** Page background. */
+    readonly background: "#FFFFFF";
+    /** Failure / NG / overdue highlight. */
+    readonly danger: "#DC2626";
+    /** Success / paid stamp. */
+    readonly success: "#16A34A";
+};
+export declare const DEFAULT_SPACING: {
+    readonly xs: 4;
+    readonly sm: 8;
+    readonly md: 12;
+    readonly lg: 16;
+    readonly xl: 24;
+};
+export declare const DEFAULT_FONT_SIZE: {
+    /** Caption / metadata (8pt). */
+    readonly xs: 8;
+    /** Body text (10pt). */
+    readonly sm: 10;
+    /** Default (11pt). */
+    readonly md: 11;
+    /** Section heading (14pt). */
+    readonly lg: 14;
+    /** Document title (18pt). */
+    readonly xl: 18;
+};
+/** Default page margins in millimetres (A4 conventional). */
+export declare const DEFAULT_MARGINS_MM: {
+    readonly top: 15;
+    readonly right: 15;
+    readonly bottom: 15;
+    readonly left: 15;
+};
+export type Colors = typeof DEFAULT_COLORS;
+export type Spacing = typeof DEFAULT_SPACING;
+export type FontSize = typeof DEFAULT_FONT_SIZE;
+export type Margins = typeof DEFAULT_MARGINS_MM;
+//# sourceMappingURL=theme.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/core/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,eAAO,MAAM,cAAc;IACzB,sEAAsE;;IAEtE,uEAAuE;;IAEvE,iBAAiB;;IAEjB,uCAAuC;;IAEvC,qCAAqC;;IAErC,uBAAuB;;IAEvB,wCAAwC;;IAExC,4BAA4B;;CAEpB,CAAC;AAEX,eAAO,MAAM,eAAe;;;;;;CAMlB,CAAC;AAEX,eAAO,MAAM,iBAAiB;IAC5B,gCAAgC;;IAEhC,wBAAwB;;IAExB,sBAAsB;;IAEtB,8BAA8B;;IAE9B,6BAA6B;;CAErB,CAAC;AAEX,6DAA6D;AAC7D,eAAO,MAAM,kBAAkB;;;;;CAKrB,CAAC;AAEX,MAAM,MAAM,MAAM,GAAG,OAAO,cAAc,CAAC;AAC3C,MAAM,MAAM,OAAO,GAAG,OAAO,eAAe,CAAC;AAC7C,MAAM,MAAM,QAAQ,GAAG,OAAO,iBAAiB,CAAC;AAChD,MAAM,MAAM,OAAO,GAAG,OAAO,kBAAkB,CAAC"}

package/dist/core/theme.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * Default theme tokens for @aibrains/pdf-renderer documents.
+ *
+ * These are the defaults applied when a template's `brandingOverrides` does not
+ * specify the value. Document components import from here; per-template overrides
+ * are layered on top at render time via `template.brandingOverrides`.
+ *
+ * V1 keeps tokens minimal (8 colors, 5 spacings, 5 font sizes). Future sprints
+ * may extend without breaking consumers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_MARGINS_MM = exports.DEFAULT_FONT_SIZE = exports.DEFAULT_SPACING = exports.DEFAULT_COLORS = void 0;
+exports.DEFAULT_COLORS = {
+    /** Default primary accent (EdForge teal). Overridden per template. */
+    primary: '#0D9488',
+    /** Default accent (used for secondary headings, hover-like states). */
+    accent: '#0F766E',
+    /** Body text. */
+    text: '#1F2937',
+    /** Muted text (metadata, captions). */
+    textMuted: '#6B7280',
+    /** Light border (table dividers). */
+    border: '#E5E7EB',
+    /** Page background. */
+    background: '#FFFFFF',
+    /** Failure / NG / overdue highlight. */
+    danger: '#DC2626',
+    /** Success / paid stamp. */
+    success: '#16A34A',
+};
+exports.DEFAULT_SPACING = {
+    xs: 4,
+    sm: 8,
+    md: 12,
+    lg: 16,
+    xl: 24,
+};
+exports.DEFAULT_FONT_SIZE = {
+    /** Caption / metadata (8pt). */
+    xs: 8,
+    /** Body text (10pt). */
+    sm: 10,
+    /** Default (11pt). */
+    md: 11,
+    /** Section heading (14pt). */
+    lg: 14,
+    /** Document title (18pt). */
+    xl: 18,
+};
+/** Default page margins in millimetres (A4 conventional). */
+exports.DEFAULT_MARGINS_MM = {
+    top: 15,
+    right: 15,
+    bottom: 15,
+    left: 15,
+};
+//# sourceMappingURL=theme.js.map

package/dist/core/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/core/theme.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEU,QAAA,cAAc,GAAG;IAC5B,sEAAsE;IACtE,OAAO,EAAE,SAAS;IAClB,uEAAuE;IACvE,MAAM,EAAE,SAAS;IACjB,iBAAiB;IACjB,IAAI,EAAE,SAAS;IACf,uCAAuC;IACvC,SAAS,EAAE,SAAS;IACpB,qCAAqC;IACrC,MAAM,EAAE,SAAS;IACjB,uBAAuB;IACvB,UAAU,EAAE,SAAS;IACrB,wCAAwC;IACxC,MAAM,EAAE,SAAS;IACjB,4BAA4B;IAC5B,OAAO,EAAE,SAAS;CACV,CAAC;AAEE,QAAA,eAAe,GAAG;IAC7B,EAAE,EAAE,CAAC;IACL,EAAE,EAAE,CAAC;IACL,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;CACE,CAAC;AAEE,QAAA,iBAAiB,GAAG;IAC/B,gCAAgC;IAChC,EAAE,EAAE,CAAC;IACL,wBAAwB;IACxB,EAAE,EAAE,EAAE;IACN,sBAAsB;IACtB,EAAE,EAAE,EAAE;IACN,8BAA8B;IAC9B,EAAE,EAAE,EAAE;IACN,6BAA6B;IAC7B,EAAE,EAAE,EAAE;CACE,CAAC;AAEX,6DAA6D;AAChD,QAAA,kBAAkB,GAAG;IAChC,GAAG,EAAE,EAAE;IACP,KAAK,EAAE,EAAE;IACT,MAAM,EAAE,EAAE;IACV,IAAI,EAAE,EAAE;CACA,CAAC"}

package/dist/i18n/en/common.json

@@ -0,0 +1,32 @@
+{
+    "address": "Address",
+    "phone": "Phone",
+    "email": "Email",
+    "panNumber": "PAN",
+    "vatNumber": "VAT",
+    "studentName": "Student Name",
+    "studentId": "Student ID",
+    "schoolName": "School Name",
+    "principal": "Principal",
+    "classTeacher": "Class Teacher",
+    "signature": "Signature",
+    "date": "Date",
+    "time": "Time",
+    "page": "Page",
+    "pageOf": "Page {page} of {total}",
+    "of": "of",
+    "from": "From",
+    "to": "To",
+    "at": "at",
+    "amount": "Amount",
+    "quantity": "Qty",
+    "description": "Description",
+    "subtotal": "Subtotal",
+    "total": "Total",
+    "tax": "Tax",
+    "discount": "Discount",
+    "grandTotal": "Grand Total",
+    "amountPaid": "Amount Paid",
+    "amountDue": "Amount Due",
+    "notes": "Notes"
+}

package/dist/i18n/ne/common.json

@@ -0,0 +1,32 @@
+{
+    "address": "ठेगाना",
+    "phone": "फोन",
+    "email": "इमेल",
+    "panNumber": "स्थायी लेखा नम्बर",
+    "vatNumber": "मू.अ.कर नम्बर",
+    "studentName": "विद्यार्थीको नाम",
+    "studentId": "विद्यार्थी परिचय",
+    "schoolName": "विद्यालयको नाम",
+    "principal": "प्रधानाध्यापक",
+    "classTeacher": "कक्षाध्यापक",
+    "signature": "हस्ताक्षर",
+    "date": "मिति",
+    "time": "समय",
+    "page": "पृष्ठ",
+    "pageOf": "पृष्ठ {page} / {total}",
+    "of": "/",
+    "from": "देखि",
+    "to": "सम्म",
+    "at": "मा",
+    "amount": "रकम",
+    "quantity": "मात्रा",
+    "description": "विवरण",
+    "subtotal": "उप-योग",
+    "total": "जम्मा",
+    "tax": "कर",
+    "discount": "छुट",
+    "grandTotal": "कुल जम्मा",
+    "amountPaid": "भुक्तानी रकम",
+    "amountDue": "बाँकी रकम",
+    "notes": "कैफियत"
+}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @aibrains/pdf-renderer — EdForge PDF rendering library.
+ *
+ * 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
+ *   - C.0.4: TemplateDescriptor<T> generic + per-docType registry
+ * Sprint C.1+: <InvoicePdf>, <ReceiptPdf>, <ReportCardPdf>, ...
+ *
+ * Design source of truth: docs/pilot-greenlight/c-epic-pdf-generation-design.md
+ */
+export declare const PDF_RENDERER_PACKAGE_VERSION = "0.2.0";
+export * from './core';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * @aibrains/pdf-renderer — EdForge PDF rendering library.
+ *
+ * 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
+ *   - C.0.4: TemplateDescriptor<T> generic + per-docType registry
+ * Sprint C.1+: <InvoicePdf>, <ReceiptPdf>, <ReportCardPdf>, ...
+ *
+ * Design source of truth: docs/pilot-greenlight/c-epic-pdf-generation-design.md
+ */
+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 __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.2.0';
+// Re-export the C.0.2 core API surface.
+__exportStar(require("./core"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;;;;;;;;;;;;;;;AAEU,QAAA,4BAA4B,GAAG,OAAO,CAAC;AAEpD,wCAAwC;AACxC,yCAAuB"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@aibrains/pdf-renderer",
+  "version": "0.2.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",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "require": "./dist/core/index.js",
+      "default": "./dist/core/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "clean": "rimraf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "jest --config jest.config.cjs",
+    "prepare": "tsc",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "dependencies": {
+    "@aibrains/shared-types": "^0.60.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.0.0",
+    "jest": "^29.7.0",
+    "rimraf": "^5.0.5",
+    "ts-jest": "^29.1.0",
+    "typescript": "^5.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}