@aibrains/pdf-renderer 0.2.0 → 0.3.0

package/dist/core/fonts.js

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

package/dist/core/fonts.js.map

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

package/dist/core/index.d.ts

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

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

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

package/dist/core/index.js

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

package/dist/core/index.js.map

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

package/dist/index.d.ts

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

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -31,7 +31,9 @@ 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.2.0';
-// Re-export the C.0.2 core API surface.
+exports.PDF_RENDERER_PACKAGE_VERSION = '0.3.0';
+// Re-export the C.0.2 core API surface + C.0.3 primitives + components.
 __exportStar(require("./core"), exports);
+__exportStar(require("./primitives"), exports);
+__exportStar(require("./components"), 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,wCAAwC;AACxC,yCAAuB"}
+{"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"}

package/dist/primitives/BrandedFooter.d.ts

@@ -0,0 +1,18 @@
+/**
+ * BrandedFooter — fixed-bottom page footer with optional text + page number.
+ *
+ * Sits on every page via `fixed` (a @react-pdf/renderer flag that pins the
+ * element across pagination). Pages without the footer can simply omit it.
+ */
+import * as React from 'react';
+import { type Lang } from '../core/i18n';
+export interface BrandedFooterConfig {
+    /** Custom footer text (e.g., school slogan, terms reference, etc.) */
+    text?: string;
+    /** Show "Page X of Y" — defaults to true. */
+    showPageNumbers?: boolean;
+    /** Language for the page-number label (defaults to 'en'). */
+    lang?: Lang;
+}
+export declare const BrandedFooter: React.FC<BrandedFooterConfig>;
+//# sourceMappingURL=BrandedFooter.d.ts.map

package/dist/primitives/BrandedFooter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrandedFooter.d.ts","sourceRoot":"","sources":["../../src/primitives/BrandedFooter.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAAK,KAAK,IAAI,EAAE,MAAM,cAAc,CAAC;AAG5C,MAAM,WAAW,mBAAmB;IAClC,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,6DAA6D;IAC7D,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AAsBD,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAqBvD,CAAC"}

package/dist/primitives/BrandedFooter.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrandedFooter = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const renderer_1 = require("@react-pdf/renderer");
+const theme_1 = require("../core/theme");
+const i18n_1 = require("../core/i18n");
+const fonts_1 = require("../core/fonts");
+const styles = renderer_1.StyleSheet.create({
+    container: {
+        position: 'absolute',
+        bottom: 8,
+        left: 0,
+        right: 0,
+        flexDirection: 'row',
+        justifyContent: 'space-between',
+        alignItems: 'center',
+        paddingTop: theme_1.DEFAULT_SPACING.xs,
+        borderTopWidth: 1,
+        borderTopColor: theme_1.DEFAULT_COLORS.border,
+        paddingHorizontal: 24,
+    },
+    text: {
+        fontSize: theme_1.DEFAULT_FONT_SIZE.xs,
+        color: theme_1.DEFAULT_COLORS.textMuted,
+    },
+});
+const BrandedFooter = ({ text, showPageNumbers = true, lang = 'en', }) => {
+    // Page-number label uses the localized "Page X of Y" — pick the matching font
+    // based on the language (ne → Devanagari, else → Latin).
+    const pageNumberFontFamily = lang === 'ne' ? fonts_1.FONT_FAMILY_DEVANAGARI : fonts_1.FONT_FAMILY_LATIN;
+    return ((0, jsx_runtime_1.jsxs)(renderer_1.View, { style: styles.container, fixed: true, children: [(0, jsx_runtime_1.jsx)(renderer_1.Text, { style: [styles.text, { fontFamily: (0, fonts_1.pickFontFamily)(text) }], children: text !== null && text !== void 0 ? text : '' }), showPageNumbers && ((0, jsx_runtime_1.jsx)(renderer_1.Text, { style: [styles.text, { fontFamily: pageNumberFontFamily }], render: ({ pageNumber, totalPages }) => (0, i18n_1.t)('common', 'pageOf', lang, { page: pageNumber, total: totalPages }) }))] }));
+};
+exports.BrandedFooter = BrandedFooter;
+//# sourceMappingURL=BrandedFooter.js.map

package/dist/primitives/BrandedFooter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrandedFooter.js","sourceRoot":"","sources":["../../src/primitives/BrandedFooter.tsx"],"names":[],"mappings":";;;;AAQA,kDAA6D;AAC7D,yCAAmF;AACnF,uCAA4C;AAC5C,yCAA0F;AAW1F,MAAM,MAAM,GAAG,qBAAU,CAAC,MAAM,CAAC;IAC/B,SAAS,EAAE;QACT,QAAQ,EAAE,UAAU;QACpB,MAAM,EAAE,CAAC;QACT,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,CAAC;QACR,aAAa,EAAE,KAAK;QACpB,cAAc,EAAE,eAAe;QAC/B,UAAU,EAAE,QAAQ;QACpB,UAAU,EAAE,uBAAe,CAAC,EAAE;QAC9B,cAAc,EAAE,CAAC;QACjB,cAAc,EAAE,sBAAc,CAAC,MAAM;QACrC,iBAAiB,EAAE,EAAE;KACtB;IACD,IAAI,EAAE;QACJ,QAAQ,EAAE,yBAAiB,CAAC,EAAE;QAC9B,KAAK,EAAE,sBAAc,CAAC,SAAS;KAChC;CACF,CAAC,CAAC;AAEI,MAAM,aAAa,GAAkC,CAAC,EAC3D,IAAI,EACJ,eAAe,GAAG,IAAI,EACtB,IAAI,GAAG,IAAI,GACZ,EAAE,EAAE;IACH,8EAA8E;IAC9E,yDAAyD;IACzD,MAAM,oBAAoB,GAAG,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,8BAAsB,CAAC,CAAC,CAAC,yBAAiB,CAAC;IACxF,OAAO,CACL,wBAAC,eAAI,IAAC,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,KAAK,mBAClC,uBAAC,eAAI,IAAC,KAAK,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,IAAA,sBAAc,EAAC,IAAI,CAAC,EAAE,CAAC,YAAG,IAAI,aAAJ,IAAI,cAAJ,IAAI,GAAI,EAAE,GAAQ,EACpF,eAAe,IAAI,CAClB,uBAAC,eAAI,IACH,KAAK,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,oBAAoB,EAAE,CAAC,EAC1D,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE,CACrC,IAAA,QAAC,EAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,GAEtE,CACH,IACI,CACR,CAAC;AACJ,CAAC,CAAC;AArBW,QAAA,aAAa,iBAqBxB"}

package/dist/primitives/BrandedHeader.d.ts

@@ -0,0 +1,41 @@
+/**
+ * BrandedHeader — page header with logo, school name, and address.
+ *
+ * Used by Invoice, Receipt, Report Card, Admit Card. Per template config:
+ *   - `header.showLogo` — toggle the logo (if branding.logoS3Key present)
+ *   - `header.showSchoolName` — toggle the school name
+ *   - `header.showSchoolAddress` — toggle the address lines
+ *   - `header.tagline` — optional tagline below the school name
+ *
+ * Logo source: callers must pre-resolve the S3 key to a URL or Buffer and
+ * pass it as the `logoSrc` prop. The header doesn't fetch anything.
+ */
+import * as React from 'react';
+import { type ImageSource } from '../core/fonts';
+export interface BrandedHeaderBranding {
+    /**
+     * Pre-resolved logo source. Accepts URL string, Buffer, or react-pdf
+     * SourceObject literal — see `ImageSource` in `core/fonts.ts`. Pass
+     * `undefined` to skip.
+     */
+    logoSrc?: ImageSource;
+    schoolName?: string;
+    addressLines?: string[];
+    phone?: string;
+    email?: string;
+}
+export interface BrandedHeaderConfig {
+    showLogo?: boolean;
+    showSchoolName?: boolean;
+    showSchoolAddress?: boolean;
+    showContact?: boolean;
+    tagline?: string;
+    /** Primary brand color — applied to the school name. Defaults to theme primary. */
+    primaryColor?: string;
+}
+export interface BrandedHeaderProps {
+    branding: BrandedHeaderBranding;
+    config?: BrandedHeaderConfig;
+}
+export declare const BrandedHeader: React.FC<BrandedHeaderProps>;
+//# sourceMappingURL=BrandedHeader.d.ts.map

package/dist/primitives/BrandedHeader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrandedHeader.d.ts","sourceRoot":"","sources":["../../src/primitives/BrandedHeader.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjE,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,qBAAqB,CAAC;IAChC,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAwCD,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CA2CtD,CAAC"}

package/dist/primitives/BrandedHeader.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrandedHeader = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const renderer_1 = require("@react-pdf/renderer");
+const theme_1 = require("../core/theme");
+const fonts_1 = require("../core/fonts");
+const styles = renderer_1.StyleSheet.create({
+    container: {
+        flexDirection: 'row',
+        justifyContent: 'space-between',
+        alignItems: 'flex-start',
+        paddingBottom: theme_1.DEFAULT_SPACING.md,
+        borderBottomWidth: 1,
+        borderBottomColor: theme_1.DEFAULT_COLORS.border,
+        marginBottom: theme_1.DEFAULT_SPACING.lg,
+    },
+    logo: {
+        width: 64,
+        height: 64,
+        objectFit: 'contain',
+    },
+    textBlock: {
+        flexDirection: 'column',
+        alignItems: 'flex-end',
+        flex: 1,
+    },
+    schoolName: {
+        fontSize: theme_1.DEFAULT_FONT_SIZE.lg,
+        fontWeight: 'bold',
+        marginBottom: 2,
+    },
+    tagline: {
+        // No italic variant registered in V1 — keep style upright.
+        fontSize: theme_1.DEFAULT_FONT_SIZE.xs,
+        color: theme_1.DEFAULT_COLORS.textMuted,
+        marginBottom: 4,
+    },
+    address: {
+        fontSize: theme_1.DEFAULT_FONT_SIZE.xs,
+        color: theme_1.DEFAULT_COLORS.textMuted,
+        lineHeight: 1.3,
+    },
+});
+const BrandedHeader = ({ branding, config = {}, }) => {
+    const { showLogo = true, showSchoolName = true, showSchoolAddress = true, showContact = true, tagline, primaryColor, } = config;
+    const hasLogo = showLogo && branding.logoSrc;
+    const schoolColor = primaryColor !== null && primaryColor !== void 0 ? primaryColor : theme_1.DEFAULT_COLORS.primary;
+    return ((0, jsx_runtime_1.jsxs)(renderer_1.View, { style: styles.container, children: [hasLogo && (0, jsx_runtime_1.jsx)(renderer_1.Image, { style: styles.logo, src: branding.logoSrc }), (0, jsx_runtime_1.jsxs)(renderer_1.View, { style: styles.textBlock, children: [showSchoolName && branding.schoolName && ((0, jsx_runtime_1.jsx)(renderer_1.Text, { style: [styles.schoolName, { color: schoolColor, fontFamily: (0, fonts_1.pickFontFamily)(branding.schoolName) }], children: branding.schoolName })), tagline && ((0, jsx_runtime_1.jsx)(renderer_1.Text, { style: [styles.tagline, { fontFamily: (0, fonts_1.pickFontFamily)(tagline) }], children: tagline })), showSchoolAddress && branding.addressLines && branding.addressLines.length > 0 && ((0, jsx_runtime_1.jsx)(renderer_1.View, { children: branding.addressLines.map((line, idx) => ((0, jsx_runtime_1.jsx)(renderer_1.Text, { style: [styles.address, { fontFamily: (0, fonts_1.pickFontFamily)(line) }], children: line }, idx))) })), showContact && (branding.phone || branding.email) && ((0, jsx_runtime_1.jsx)(renderer_1.Text, { style: styles.address, children: [branding.phone, branding.email].filter(Boolean).join(' · ') }))] })] }));
+};
+exports.BrandedHeader = BrandedHeader;
+//# sourceMappingURL=BrandedHeader.js.map

package/dist/primitives/BrandedHeader.js.map

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

package/dist/primitives/Document.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Document — wraps `@react-pdf/renderer`'s Document and ensures the bundled
+ * fonts are registered before the first render.
+ *
+ * Every consumer document (InvoicePdf, ReceiptPdf, ReportCardPdf, ...) should
+ * wrap its `<Page>` children in this Document rather than the raw RPDF one.
+ * That makes font registration a render-side invariant rather than a per-caller
+ * concern, eliminating an easy gap.
+ */
+import * as React from 'react';
+export interface DocumentProps {
+    /** Document title surfaced in PDF metadata. */
+    title?: string;
+    /** Document author surfaced in PDF metadata. */
+    author?: string;
+    /** Document subject surfaced in PDF metadata. */
+    subject?: string;
+    children: React.ReactNode;
+}
+export declare const Document: React.FC<DocumentProps>;
+//# sourceMappingURL=Document.d.ts.map

package/dist/primitives/Document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Document.d.ts","sourceRoot":"","sources":["../../src/primitives/Document.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAUD,eAAO,MAAM,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CAY5C,CAAC"}

package/dist/primitives/Document.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Document = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const renderer_1 = require("@react-pdf/renderer");
+const fonts_1 = require("../core/fonts");
+/**
+ * Register fonts on module load (idempotent). Each consumer document still
+ * wraps children in `<Document>`, so the registration is also guaranteed by
+ * the render path — but pre-registering here means snapshot tests that
+ * accidentally render outside `<Document>` still get correct shaping.
+ */
+(0, fonts_1.registerFonts)();
+const Document = ({ title, author, subject, children, }) => {
+    // RPDF's Document props don't include children in its TS type — pass via prop.
+    return ((0, jsx_runtime_1.jsx)(renderer_1.Document, { title: title, author: author, subject: subject, children: children }));
+};
+exports.Document = Document;
+//# sourceMappingURL=Document.js.map

package/dist/primitives/Document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Document.js","sourceRoot":"","sources":["../../src/primitives/Document.tsx"],"names":[],"mappings":";;;;AAWA,kDAA+D;AAC/D,yCAA8C;AAY9C;;;;;GAKG;AACH,IAAA,qBAAa,GAAE,CAAC;AAET,MAAM,QAAQ,GAA4B,CAAC,EAChD,KAAK,EACL,MAAM,EACN,OAAO,EACP,QAAQ,GACT,EAAE,EAAE;IACH,+EAA+E;IAC/E,OAAO,CACL,uBAAC,mBAAY,IAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,YACzD,QAA8B,GAClB,CAChB,CAAC;AACJ,CAAC,CAAC;AAZW,QAAA,QAAQ,YAYnB"}

package/dist/primitives/Page.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Page — wraps `@react-pdf/renderer`'s Page with EdForge defaults.
+ *
+ * Margins come from template config (`PdfTemplateConfig.margins`); pageSize
+ * from `template.pageSize`. The default values mirror the design doc § 4.2
+ * (A4 portrait, 15mm margins on all sides) which suit a printable invoice in
+ * Nepal pilot defaults.
+ */
+import * as React from 'react';
+export type PageSize = 'A4' | 'A5' | 'LETTER';
+export type Orientation = 'portrait' | 'landscape';
+export interface PageProps {
+    /** Defaults to A4. */
+    size?: PageSize;
+    /** Defaults to portrait. */
+    orientation?: Orientation;
+    /** Margins in millimetres; defaults to 15mm on all sides. */
+    margins?: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    children: React.ReactNode;
+}
+export declare const Page: React.FC<PageProps>;
+//# sourceMappingURL=Page.d.ts.map

package/dist/primitives/Page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Page.d.ts","sourceRoot":"","sources":["../../src/primitives/Page.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,QAAQ,CAAC;AAC9C,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,WAAW,CAAC;AAEnD,MAAM,WAAW,SAAS;IACxB,sBAAsB;IACtB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,4BAA4B;IAC5B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,6DAA6D;IAC7D,OAAO,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAgBD,eAAO,MAAM,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,SAAS,CAuBpC,CAAC"}

package/dist/primitives/Page.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Page = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const renderer_1 = require("@react-pdf/renderer");
+const theme_1 = require("../core/theme");
+const fonts_1 = require("../core/fonts");
+const mm = (value) => `${value}mm`;
+// react-pdf does NOT support CSS-style font-fallback chains. The page default
+// is Latin; Devanagari text runs MUST explicitly set fontFamily to
+// 'Noto Sans Devanagari' (use `pickFontFamily(text)` helper from core/fonts).
+const baseStyles = renderer_1.StyleSheet.create({
+    page: {
+        fontFamily: fonts_1.FONT_FAMILY_LATIN,
+        fontSize: theme_1.DEFAULT_FONT_SIZE.md,
+        color: theme_1.DEFAULT_COLORS.text,
+        backgroundColor: theme_1.DEFAULT_COLORS.background,
+    },
+});
+const Page = ({ size = 'A4', orientation = 'portrait', margins = theme_1.DEFAULT_MARGINS_MM, children, }) => {
+    return ((0, jsx_runtime_1.jsx)(renderer_1.Page, { size: size, orientation: orientation, style: [
+            baseStyles.page,
+            {
+                paddingTop: mm(margins.top),
+                paddingRight: mm(margins.right),
+                paddingBottom: mm(margins.bottom),
+                paddingLeft: mm(margins.left),
+            },
+        ], children: children }));
+};
+exports.Page = Page;
+//# sourceMappingURL=Page.js.map

package/dist/primitives/Page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Page.js","sourceRoot":"","sources":["../../src/primitives/Page.tsx"],"names":[],"mappings":";;;;AAUA,kDAAmE;AACnE,yCAAsF;AACtF,yCAAkD;AAelD,MAAM,EAAE,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,GAAG,KAAK,IAAI,CAAC;AAE3C,8EAA8E;AAC9E,mEAAmE;AACnE,8EAA8E;AAC9E,MAAM,UAAU,GAAG,qBAAU,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE;QACJ,UAAU,EAAE,yBAAiB;QAC7B,QAAQ,EAAE,yBAAiB,CAAC,EAAE;QAC9B,KAAK,EAAE,sBAAc,CAAC,IAAI;QAC1B,eAAe,EAAE,sBAAc,CAAC,UAAU;KAC3C;CACF,CAAC,CAAC;AAEI,MAAM,IAAI,GAAwB,CAAC,EACxC,IAAI,GAAG,IAAI,EACX,WAAW,GAAG,UAAU,EACxB,OAAO,GAAG,0BAAkB,EAC5B,QAAQ,GACT,EAAE,EAAE;IACH,OAAO,CACL,uBAAC,eAAQ,IACP,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE;YACL,UAAU,CAAC,IAAI;YACf;gBACE,UAAU,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;gBAC3B,YAAY,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;gBAC/B,aAAa,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;gBACjC,WAAW,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;aAC9B;SACF,YAEA,QAA8B,GACtB,CACZ,CAAC;AACJ,CAAC,CAAC;AAvBW,QAAA,IAAI,QAuBf"}

package/dist/primitives/Watermark.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Watermark — diagonal translucent text overlay.
+ *
+ * Common cases:
+ *   - "DRAFT" on a not-yet-issued invoice preview
+ *   - "PAID" on a settled invoice
+ *   - "CANCELLED" on a voided invoice or refunded receipt
+ *
+ * Positioned absolutely, rotated 45deg. Use sparingly — it bleeds through to
+ * the body content visually.
+ */
+import * as React from 'react';
+export interface WatermarkProps {
+    text: string;
+    /** 0.0–1.0. Defaults to 0.10 (faint). */
+    opacity?: number;
+    /** Rotation in degrees. Defaults to -45 (bottom-left to top-right). */
+    rotation?: number;
+    /** Hex color. Defaults to theme danger. */
+    color?: string;
+    /** Font size in pt. Defaults to 96. */
+    fontSize?: number;
+}
+export declare const Watermark: React.FC<WatermarkProps>;
+//# sourceMappingURL=Watermark.d.ts.map

package/dist/primitives/Watermark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Watermark.d.ts","sourceRoot":"","sources":["../../src/primitives/Watermark.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAiBD,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,cAAc,CAyB9C,CAAC"}

package/dist/primitives/Watermark.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Watermark = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const renderer_1 = require("@react-pdf/renderer");
+const theme_1 = require("../core/theme");
+const fonts_1 = require("../core/fonts");
+const styles = renderer_1.StyleSheet.create({
+    container: {
+        position: 'absolute',
+        top: '40%',
+        left: 0,
+        right: 0,
+        alignItems: 'center',
+        justifyContent: 'center',
+    },
+    text: {
+        fontWeight: 'bold',
+        letterSpacing: 8,
+    },
+});
+const Watermark = ({ text, opacity = 0.1, rotation = -45, color = theme_1.DEFAULT_COLORS.danger, fontSize = 96, }) => {
+    return ((0, jsx_runtime_1.jsx)(renderer_1.View, { style: styles.container, fixed: true, children: (0, jsx_runtime_1.jsx)(renderer_1.Text, { style: [
+                styles.text,
+                {
+                    color,
+                    opacity,
+                    fontSize,
+                    fontFamily: (0, fonts_1.pickFontFamily)(text),
+                    transform: `rotate(${rotation}deg)`,
+                },
+            ], children: text }) }));
+};
+exports.Watermark = Watermark;
+//# sourceMappingURL=Watermark.js.map

package/dist/primitives/Watermark.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Watermark.js","sourceRoot":"","sources":["../../src/primitives/Watermark.tsx"],"names":[],"mappings":";;;;AAaA,kDAA6D;AAC7D,yCAA+C;AAC/C,yCAA+C;AAc/C,MAAM,MAAM,GAAG,qBAAU,CAAC,MAAM,CAAC;IAC/B,SAAS,EAAE;QACT,QAAQ,EAAE,UAAU;QACpB,GAAG,EAAE,KAAK;QACV,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,CAAC;QACR,UAAU,EAAE,QAAQ;QACpB,cAAc,EAAE,QAAQ;KACzB;IACD,IAAI,EAAE;QACJ,UAAU,EAAE,MAAM;QAClB,aAAa,EAAE,CAAC;KACjB;CACF,CAAC,CAAC;AAEI,MAAM,SAAS,GAA6B,CAAC,EAClD,IAAI,EACJ,OAAO,GAAG,GAAG,EACb,QAAQ,GAAG,CAAC,EAAE,EACd,KAAK,GAAG,sBAAc,CAAC,MAAM,EAC7B,QAAQ,GAAG,EAAE,GACd,EAAE,EAAE;IACH,OAAO,CACL,uBAAC,eAAI,IAAC,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,KAAK,kBAClC,uBAAC,eAAI,IACH,KAAK,EAAE;gBACL,MAAM,CAAC,IAAI;gBACX;oBACE,KAAK;oBACL,OAAO;oBACP,QAAQ;oBACR,UAAU,EAAE,IAAA,sBAAc,EAAC,IAAI,CAAC;oBAChC,SAAS,EAAE,UAAU,QAAQ,MAAM;iBACpC;aACF,YAEA,IAAI,GACA,GACF,CACR,CAAC;AACJ,CAAC,CAAC;AAzBW,QAAA,SAAS,aAyBpB"}

package/dist/primitives/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Layout primitives — building blocks that compose into document components.
+ *
+ * Sprint C.0.3:
+ *   - Document — wraps RPDF Document, auto-registers fonts
+ *   - Page — wraps RPDF Page with template margins + default font + theme
+ *   - BrandedHeader — logo + school name + address (driven by branding)
+ *   - BrandedFooter — footer text + page numbers
+ *   - Watermark — DRAFT/PAID/CANCELLED diagonal overlay
+ */
+export { Document } from './Document';
+export type { DocumentProps } from './Document';
+export { Page } from './Page';
+export type { PageProps, PageSize, Orientation } from './Page';
+export { BrandedHeader } from './BrandedHeader';
+export type { BrandedHeaderProps, BrandedHeaderBranding, BrandedHeaderConfig, } from './BrandedHeader';
+export { BrandedFooter } from './BrandedFooter';
+export type { BrandedFooterConfig } from './BrandedFooter';
+export { Watermark } from './Watermark';
+export type { WatermarkProps } from './Watermark';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/primitives/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}