@pixldocs/canvas-renderer 0.3.28 → 0.4.0

package/dist/index.d.ts

@@ -13,6 +13,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;
@@ -113,6 +119,41 @@ 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;
+}
+
+/** 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;
+}
+
+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 +239,17 @@ 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;
+    }): 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.