@aibrains/pdf-renderer 0.2.0 → 0.4.0

package/dist/index.js

@@ -31,7 +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.2.0';
-// Re-export the C.0.2 core API surface.
+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,wCAAwC;AACxC,yCAAuB"}
+{"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/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"}

package/dist/primitives/index.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Watermark = exports.BrandedFooter = exports.BrandedHeader = exports.Page = exports.Document = void 0;
+var Document_1 = require("./Document");
+Object.defineProperty(exports, "Document", { enumerable: true, get: function () { return Document_1.Document; } });
+var Page_1 = require("./Page");
+Object.defineProperty(exports, "Page", { enumerable: true, get: function () { return Page_1.Page; } });
+var BrandedHeader_1 = require("./BrandedHeader");
+Object.defineProperty(exports, "BrandedHeader", { enumerable: true, get: function () { return BrandedHeader_1.BrandedHeader; } });
+var BrandedFooter_1 = require("./BrandedFooter");
+Object.defineProperty(exports, "BrandedFooter", { enumerable: true, get: function () { return BrandedFooter_1.BrandedFooter; } });
+var Watermark_1 = require("./Watermark");
+Object.defineProperty(exports, "Watermark", { enumerable: true, get: function () { return Watermark_1.Watermark; } });
+//# sourceMappingURL=index.js.map

package/dist/primitives/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/primitives/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AAGjB,+BAA8B;AAArB,4FAAA,IAAI,OAAA;AAGb,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AAOtB,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AAGtB,yCAAwC;AAA/B,sGAAA,SAAS,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aibrains/pdf-renderer",
-  "version": "0.2.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",
@@ -14,28 +14,54 @@
       "types": "./dist/core/index.d.ts",
       "require": "./dist/core/index.js",
       "default": "./dist/core/index.js"
+    },
+    "./primitives": {
+      "types": "./dist/primitives/index.d.ts",
+      "require": "./dist/primitives/index.js",
+      "default": "./dist/primitives/index.js"
+    },
+    "./components": {
+      "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": [
     "dist",
+    "fonts",
     "README.md"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && node scripts/copy-fonts.js",
     "watch": "tsc --watch",
-    "clean": "rimraf dist",
+    "clean": "rimraf dist fonts",
     "typecheck": "tsc --noEmit",
     "test": "jest --config jest.config.cjs",
-    "prepare": "tsc",
+    "prepare": "tsc && node scripts/copy-fonts.js",
     "prepublishOnly": "npm run clean && npm run build"
   },
   "dependencies": {
-    "@aibrains/shared-types": "^0.60.0"
+    "@aibrains/shared-types": "^0.60.0",
+    "@react-pdf/renderer": "^3.4.5"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0 <20.0.0"
   },
   "devDependencies": {
+    "@fontsource/noto-sans": "^5.2.10",
+    "@fontsource/noto-sans-devanagari": "^5.2.8",
     "@types/jest": "^29.5.0",
     "@types/node": "^20.0.0",
+    "@types/react": "^18.3.29",
+    "@types/react-test-renderer": "^18.3.1",
     "jest": "^29.7.0",
+    "react": "^18.3.1",
+    "react-test-renderer": "^18.3.1",
     "rimraf": "^5.0.5",
     "ts-jest": "^29.1.0",
     "typescript": "^5.0.0"