@formepdf/react 0.2.0 → 0.3.0

package/dist/font.d.ts

@@ -0,0 +1,11 @@
+export interface FontRegistration {
+    family: string;
+    src: string | Uint8Array;
+    fontWeight?: number | 'normal' | 'bold';
+    fontStyle?: 'normal' | 'italic' | 'oblique';
+}
+export declare const Font: {
+    register(options: FontRegistration): void;
+    clear(): void;
+    getRegistered(): FontRegistration[];
+};

package/dist/font.js

@@ -0,0 +1,23 @@
+const globalFonts = [];
+function normalizeWeight(w) {
+    if (w === undefined || w === 'normal')
+        return 400;
+    if (w === 'bold')
+        return 700;
+    return typeof w === 'number' ? w : (parseInt(w, 10) || 400);
+}
+export const Font = {
+    register(options) {
+        globalFonts.push({
+            ...options,
+            fontWeight: normalizeWeight(options.fontWeight),
+            fontStyle: options.fontStyle || 'normal',
+        });
+    },
+    clear() {
+        globalFonts.length = 0;
+    },
+    getRegistered() {
+        return [...globalFonts];
+    },
+};

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 export { Document, Page, View, Text, Image, Table, Row, Cell, Fixed, Svg, PageBreak } from './components.js';
 export { serialize, mapStyle, mapDimension, parseColor, expandEdges, expandCorners } from './serialize.js';
 export { StyleSheet } from './stylesheet.js';
+export { Font } from './font.js';
+export type { FontRegistration } from './font.js';
 export { render, renderToObject } from './render.js';
-export type { Style, Edges, Corners, EdgeColors, DocumentProps, PageProps, ViewProps, TextProps, ImageProps, ColumnDef, TableProps, RowProps, CellProps, FixedProps, SvgProps, TextRun, FormeDocument, FormeNode, FormeNodeKind, FormeStyle, FormePageConfig, FormePageSize, FormeEdges, FormeMetadata, FormeColumnDef, FormeColumnWidth, FormeDimension, FormeColor, FormeEdgeValues, FormeCornerValues, } from './types.js';
+export type { Style, Edges, Corners, EdgeColors, DocumentProps, PageProps, ViewProps, TextProps, ImageProps, ColumnDef, TableProps, RowProps, CellProps, FixedProps, SvgProps, TextRun, FormeDocument, FormeFont, FormeNode, FormeNodeKind, FormeStyle, FormePageConfig, FormePageSize, FormeEdges, FormeMetadata, FormeColumnDef, FormeColumnWidth, FormeDimension, FormeColor, FormeEdgeValues, FormeCornerValues, } from './types.js';

package/dist/index.js

@@ -4,5 +4,7 @@ export { Document, Page, View, Text, Image, Table, Row, Cell, Fixed, Svg, PageBr
 export { serialize, mapStyle, mapDimension, parseColor, expandEdges, expandCorners } from './serialize.js';
 // StyleSheet
 export { StyleSheet } from './stylesheet.js';
+// Font registration
+export { Font } from './font.js';
 // Render functions
 export { render, renderToObject } from './render.js';

package/dist/serialize.js

@@ -1,5 +1,6 @@
 import { isValidElement, Children, Fragment } from 'react';
 import { Document, Page, View, Text, Image, Table, Row, Cell, Fixed, Svg, PageBreak } from './components.js';
+import { Font } from './font.js';
 const VALID_PARENTS = {
     Page: {
         allowed: ['Document'],
@@ -87,7 +88,9 @@ export function serialize(element) {
         metadata.subject = props.subject;
     if (props.creator !== undefined)
         metadata.creator = props.creator;
-    return {
+    // Merge global + document fonts (document fonts override on conflict)
+    const mergedFonts = mergeFonts(Font.getRegistered(), props.fonts);
+    const result = {
         children,
         metadata,
         defaultPage: {
@@ -96,6 +99,10 @@ export function serialize(element) {
             wrap: true,
         },
     };
+    if (mergedFonts.length > 0) {
+        result.fonts = mergedFonts;
+    }
+    return result;
 }
 // ─── Page serialization ──────────────────────────────────────────────
 function serializePage(element) {
@@ -723,3 +730,32 @@ function mapColumnWidth(w) {
         return { Fixed: w.fixed };
     return 'Auto';
 }
+// ─── Font merging ─────────────────────────────────────────────────
+function normalizeFontWeight(w) {
+    if (w === undefined || w === 'normal')
+        return 400;
+    if (w === 'bold')
+        return 700;
+    return typeof w === 'number' ? w : (parseInt(w, 10) || 400);
+}
+function fontKey(family, weight, italic) {
+    return `${family}:${weight}:${italic}`;
+}
+function mergeFonts(globalFonts, docFonts) {
+    const map = new Map();
+    for (const f of globalFonts) {
+        const weight = normalizeFontWeight(f.fontWeight);
+        const italic = f.fontStyle === 'italic' || f.fontStyle === 'oblique';
+        const key = fontKey(f.family, weight, italic);
+        map.set(key, { family: f.family, src: f.src, weight, italic });
+    }
+    if (docFonts) {
+        for (const f of docFonts) {
+            const weight = normalizeFontWeight(f.fontWeight);
+            const italic = f.fontStyle === 'italic' || f.fontStyle === 'oblique';
+            const key = fontKey(f.family, weight, italic);
+            map.set(key, { family: f.family, src: f.src, weight, italic });
+        }
+    }
+    return Array.from(map.values());
+}

package/dist/types.d.ts

@@ -1,4 +1,5 @@
 import type { ReactNode } from 'react';
+import type { FontRegistration } from './font.js';
 /** Edge values for padding, margin, borderWidth */
 export interface Edges {
     top: number;
@@ -97,6 +98,7 @@ export interface DocumentProps {
     author?: string;
     subject?: string;
     creator?: string;
+    fonts?: FontRegistration[];
     children?: ReactNode;
 }
 export interface PageProps {
@@ -168,10 +170,17 @@ export interface TextRun {
     style?: FormeStyle;
     href?: string;
 }
+export interface FormeFont {
+    family: string;
+    src: string | Uint8Array;
+    weight: number;
+    italic: boolean;
+}
 export interface FormeDocument {
     children: FormeNode[];
     metadata: FormeMetadata;
     defaultPage: FormePageConfig;
+    fonts?: FormeFont[];
 }
 export interface FormeMetadata {
     title?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@formepdf/react",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "JSX-to-JSON serializer for Forme PDF engine",
   "type": "module",
   "main": "./dist/index.js",