@pixldocs/canvas-renderer 0.4.0 → 0.4.2

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { InferredSection } from '../../../src/lib/inferFormSchemaFromTemplate';
+import { jsPDF } from 'jspdf';
 import { JSX as JSX_2 } from 'react/jsx-runtime';
 import { SectionFormState } from '../../../src/lib/inferFormSchemaFromTemplate';
 import { SmartElementProps } from '../../../shared/smart-elements/types';
@@ -69,6 +70,25 @@ export declare interface DynamicField {
     [key: string]: any;
 }
 
+/**
+ * Load and embed a single font weight into jsPDF.
+ * Each weight is registered as a SEPARATE jsPDF font name like "JosefinSans-SemiBold"
+ * with style "normal". This is the key difference from the old approach.
+ */
+export declare function embedFont(pdf: jsPDF, fontName: string, weight: number, fontBaseUrl: string, isItalic?: boolean): Promise<boolean>;
+
+/**
+ * Walk a template config to discover all font families/weights,
+ * then embed each one into jsPDF. Also embeds symbol + devanagari fallbacks.
+ */
+export declare function embedFontsForConfig(pdf: jsPDF, config: any, fontBaseUrl: string): Promise<Set<string>>;
+
+/**
+ * @deprecated Use embedFontsForConfig + rewriteSvgFontsForJsPDF instead.
+ * Embed all required fonts into a jsPDF instance using the old approach.
+ */
+export declare function embedFontsInPdf(pdf: jsPDF, fontFamilies: Set<string>, fontBaseUrl: string): Promise<Set<string>>;
+
 /**
  * Ensure all fonts required by a fully-resolved TemplateConfig are loaded
  * and available to Fabric/Canvas before rendering.
@@ -87,6 +107,22 @@ export declare interface DynamicField {
  */
 export declare function ensureFontsForResolvedConfig(config: TemplateConfig): Promise<void>;
 
+/**
+ * Extract all unique font-family values from SVG strings.
+ */
+export declare function extractFontFamiliesFromSvgs(svgs: string[]): Set<string>;
+
+/** Font used for Devanagari / Hindi script */
+export declare const FONT_FALLBACK_DEVANAGARI = "Hind";
+
+/** Font used for symbols (● ◆ ★ etc.) */
+export declare const FONT_FALLBACK_SYMBOLS = "Noto Sans";
+
+/**
+ * Maps font family names to their TTF file names (relative to fontBaseUrl).
+ */
+export declare const FONT_FILES: Record<string, FontWeightFiles>;
+
 /**
  * Walk a fully-resolved TemplateConfig and collect every unique
  * { fontFamily, fontWeight, fontStyle } tuple from all text nodes
@@ -98,8 +134,31 @@ export declare interface FontDescriptor {
     style: string;
 }
 
+declare type FontWeightFiles = {
+    regular: string;
+    bold?: string;
+    light?: string;
+    medium?: string;
+    semibold?: string;
+    italic?: string;
+    boldItalic?: string;
+    lightItalic?: string;
+    mediumItalic?: string;
+    semiboldItalic?: string;
+};
+
+/**
+ * Get the embedded jsPDF font name for a given font family + weight + italic.
+ * This is the name used for pdf.setFont() and must match the font-family
+ * attribute rewritten in SVG text elements.
+ */
+export declare function getEmbeddedJsPDFFontName(fontName: string, weight: number, isItalic?: boolean): string;
+
 export { InferredSection }
 
+/** Check if a font is in our local mapping */
+export declare function isFontAvailable(fontName: string): boolean;
+
 /**
  * Load a Google Font by injecting a <link> stylesheet.
  * Resolves when the font is ready for use.
@@ -126,6 +185,8 @@ export declare interface PdfAssemblyOptions {
     filename?: string;
     /** Whether to strip page background from SVG (drawn separately for gradient support) */
     stripPageBackground?: boolean;
+    /** Base URL for TTF font files (e.g. 'https://pixldocs.com/fonts/' or '/fonts/'). Required for correct font rendering. */
+    fontBaseUrl?: string;
 }
 
 /** Options for PDF rendering */
@@ -138,6 +199,8 @@ export declare interface PdfFromFormOptions {
     watermark?: boolean;
     /** PDF document title */
     title?: string;
+    /** Base URL for TTF font files for PDF font embedding */
+    fontBaseUrl?: string;
 }
 
 export declare interface PdfRenderResult {
@@ -244,6 +307,7 @@ export declare class PixldocsRenderer {
      */
     renderPdf(templateConfig: TemplateConfig, options?: {
         title?: string;
+        fontBaseUrl?: string;
     }): Promise<PdfRenderResult>;
     /**
      * Resolve from V2 sectionState and render a vector PDF.
@@ -331,6 +395,8 @@ export declare interface ResolvedTemplate {
     price: number;
 }
 
+export declare function resolveFontWeight(weight: number): number;
+
 /**
  * Resolve a template using the V2 sectionState format.
  * This is the primary API for external consumers and matches the server's /render-from-form pipeline.
@@ -366,6 +432,14 @@ export declare interface ResolveOptions {
 
 export declare function resolveTemplateData(options: ResolveOptions): Promise<ResolvedTemplate>;
 
+/**
+ * Rewrite font-family attributes in SVG <text>/<tspan> to match jsPDF embedded font names.
+ * CRITICAL: Also sets font-weight to "normal" because the weight is already baked into
+ * the jsPDF font name (e.g. JosefinSans-SemiBold). Without this, svg2pdf combines
+ * font-weight + font-style into "600normal" which won't match fonts registered with style "normal".
+ */
+export declare function rewriteSvgFontsForJsPDF(svgStr: string): string;
+
 export { SectionFormState }
 
 export { SmartElementProps }