@pixldocs/canvas-renderer 0.3.28 → 0.4.1

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';
@@ -13,6 +14,12 @@ import { SmartElementType } from '../../../shared/smart-elements/types';
  */
 export declare function applyThemeToConfig(config: TemplateConfig, themeOverrides: ThemeVariables): TemplateConfig;
 
+/**
+ * Assemble a vector PDF from SVG render results.
+ * This is the core function that converts canvas SVGs into a multi-page PDF document.
+ */
+export declare function assemblePdfFromSvgs(svgResults: SvgRenderResult[], options?: PdfAssemblyOptions): Promise<PdfRenderResult>;
+
 export declare interface CanvasNode {
     id: string;
     name?: string;
@@ -63,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.
@@ -81,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
@@ -92,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.
@@ -113,6 +178,45 @@ export declare interface PageSettings {
     contentBottom?: number;
 }
 
+export declare interface PdfAssemblyOptions {
+    /** PDF document title */
+    title?: string;
+    /** Output filename hint */
+    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 */
+export declare interface PdfFromFormOptions {
+    templateId: string;
+    formSchemaId: string;
+    sectionState: SectionFormState;
+    themeId?: string;
+    /** Whether to inject watermark. Default: auto (true for paid templates, false for free). */
+    watermark?: boolean;
+    /** PDF document title */
+    title?: string;
+    /** Base URL for TTF font files for PDF font embedding */
+    fontBaseUrl?: string;
+}
+
+export declare interface PdfRenderResult {
+    /** PDF as a Blob */
+    blob: Blob;
+    /** PDF as ArrayBuffer */
+    arrayBuffer: ArrayBuffer;
+    /** Total number of pages */
+    totalPages: number;
+    /** Page dimensions (CSS pixels) */
+    pages: Array<{
+        width: number;
+        height: number;
+    }>;
+}
+
 export declare function PixldocsPreview(props: PixldocsPreviewProps): JSX_2.Element;
 
 declare interface PixldocsPreviewBaseProps {
@@ -198,8 +302,18 @@ export declare class PixldocsRenderer {
      */
     renderSvgsFromForm(options: Omit<RenderFromFormOptions, 'format' | 'quality' | 'scale' | 'pixelRatio'>): Promise<SvgRenderResult[]>;
     /**
-     * Convenience: fetch by ID with simple flat data and render.
+     * Render a pre-resolved template config to a vector PDF.
+     * Returns a Blob and ArrayBuffer.
+     */
+    renderPdf(templateConfig: TemplateConfig, options?: {
+        title?: string;
+        fontBaseUrl?: string;
+    }): Promise<PdfRenderResult>;
+    /**
+     * Resolve from V2 sectionState and render a vector PDF.
+     * This is the primary PDF export API — mirrors renderFromForm() but returns a PDF.
      */
+    renderPdfFromForm(options: PdfFromFormOptions): Promise<PdfRenderResult>;
     renderById(templateId: string, formData?: Record<string, any>, options?: RenderOptions): Promise<RenderResult>;
     /**
      * Convenience: fetch by ID with flat data and render ALL pages.
@@ -281,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.
@@ -316,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 }