@pixldocs/canvas-renderer 0.5.81 → 0.5.82

package/dist/index.d.ts

@@ -276,6 +276,14 @@ export declare interface PdfAssemblyOptions {
     fontBaseUrl?: string;
     /** Convert SVG text to paths before svg2pdf. Default: false — keep live Fabric SVG text for preview/PDF metric parity. */
     outlineText?: boolean;
+    /**
+     * Per-template text rendering mode.
+     * - 'auto'          : outline only complex scripts (Indic/Arabic/CJK/emoji); Latin stays selectable.
+     * - 'selectable'    : never outline; all text remains real selectable text in the PDF.
+     * - 'pixel-perfect' : outline every <text> for 100% font parity.
+     * When omitted, falls back to `outlineText` (legacy boolean) for backwards compatibility.
+     */
+    textMode?: 'auto' | 'selectable' | 'pixel-perfect';
 }
 
 /** Options for PDF rendering */
@@ -294,6 +302,8 @@ export declare interface PdfFromFormOptions {
     title?: string;
     /** Base URL for TTF font files for PDF font embedding */
     fontBaseUrl?: string;
+    /** PDF text rendering mode. Default: selectable real text. */
+    textMode?: 'auto' | 'selectable' | 'pixel-perfect';
 }
 
 export declare interface PdfRenderResult {
@@ -403,6 +413,7 @@ export declare class PixldocsRenderer {
     renderPdf(templateConfig: TemplateConfig, options?: {
         title?: string;
         fontBaseUrl?: string;
+        textMode?: 'auto' | 'selectable' | 'pixel-perfect';
     }): Promise<PdfRenderResult>;
     /**
      * Resolve from V2 sectionState and render a vector PDF.
@@ -669,6 +680,8 @@ export declare interface TemplateConfig {
     dynamicFields?: DynamicField[];
     fieldGroups?: any[];
     themeConfig?: ThemeConfig;
+    /** PDF text rendering mode. Default: selectable real text. */
+    pdfTextMode?: 'auto' | 'selectable' | 'pixel-perfect';
     formBindingMode?: string;
     boundFormDefId?: string;
     boundFormDefName?: string;

package/dist/index.js

@@ -12865,7 +12865,7 @@ class PixldocsRenderer {
   async renderPdf(templateConfig, options) {
     const svgs = await this.renderAllPageSvgs(templateConfig);
     const { assemblePdfFromSvgs: assemblePdfFromSvgs2 } = await Promise.resolve().then(() => pdfExport);
-    return assemblePdfFromSvgs2(svgs, { title: options == null ? void 0 : options.title, fontBaseUrl: options == null ? void 0 : options.fontBaseUrl });
+    return assemblePdfFromSvgs2(svgs, { title: options == null ? void 0 : options.title, fontBaseUrl: options == null ? void 0 : options.fontBaseUrl, textMode: (options == null ? void 0 : options.textMode) ?? templateConfig.pdfTextMode ?? "selectable" });
   }
   /**
    * Resolve from V2 sectionState and render a vector PDF.
@@ -12890,7 +12890,7 @@ class PixldocsRenderer {
     }
     const svgs = await this.renderAllPageSvgs(configToRender);
     const { assemblePdfFromSvgs: assemblePdfFromSvgs2 } = await Promise.resolve().then(() => pdfExport);
-    return assemblePdfFromSvgs2(svgs, { title: title ?? resolved.config.name, fontBaseUrl });
+    return assemblePdfFromSvgs2(svgs, { title: title ?? resolved.config.name, fontBaseUrl, textMode: options.textMode ?? configToRender.pdfTextMode ?? "selectable" });
   }
   async renderById(templateId, formData, options) {
     const resolved = await resolveTemplateData({
@@ -14140,10 +14140,22 @@ async function embedFont(pdf, fontName, weight, fontBaseUrl, isItalic = false) {
 async function embedFontsForConfig(pdf, config, fontBaseUrl) {
   const fontKeys = /* @__PURE__ */ new Set();
   const SEP = "";
+  const normalizeWeight = (raw) => {
+    if (raw == null) return 400;
+    if (typeof raw === "number" && Number.isFinite(raw)) return resolveFontWeight(raw);
+    const str = String(raw).trim().toLowerCase();
+    const parsed = Number.parseInt(str, 10);
+    if (Number.isFinite(parsed)) return resolveFontWeight(parsed);
+    if (str === "bold" || str === "bolder") return 700;
+    if (str === "semibold" || str === "demibold") return 600;
+    if (str === "medium") return 500;
+    if (str === "light" || str === "lighter" || str === "thin") return 300;
+    return 400;
+  };
   const walkElements = (elements) => {
     for (const el of elements) {
       if (el.fontFamily) {
-        const w = resolveFontWeight(el.fontWeight ?? 400);
+        const w = normalizeWeight(el.fontWeight);
         fontKeys.add(`${el.fontFamily}${SEP}${w}`);
       }
       if (el.styles && typeof el.styles === "object") {
@@ -14153,7 +14165,7 @@ async function embedFontsForConfig(pdf, config, fontBaseUrl) {
             for (const charKey of Object.keys(lineStyles)) {
               const s = lineStyles[charKey];
               if (s == null ? void 0 : s.fontFamily) {
-                const w = resolveFontWeight(s.fontWeight ?? 400);
+                const w = normalizeWeight(s.fontWeight);
                 fontKeys.add(`${s.fontFamily}${SEP}${w}`);
               }
             }
@@ -15788,7 +15800,9 @@ async function assemblePdfFromSvgs(svgResults, options = {}) {
     const hasGradient = !!((_b = (_a = page.backgroundGradient) == null ? void 0 : _a.stops) == null ? void 0 : _b.length);
     drawPageBackground(pdf, i, page.width, page.height, page.backgroundColor, page.backgroundGradient);
     const shouldStripBg = stripPageBackground ?? hasGradient;
-    const shouldOutlineText = options.outlineText !== false;
+    const textMode = options.textMode ?? (options.outlineText ? "pixel-perfect" : "selectable");
+    const shouldOutlineText = textMode === "pixel-perfect" || textMode === "auto";
+    const outlineSubMode = textMode === "auto" ? "complex-only" : "all";
     let pageSvg = page.svg;
     try {
       pageSvg = await convertSvgTextDecorationsToLinesString(pageSvg);
@@ -15800,8 +15814,8 @@ async function assemblePdfFromSvgs(svgResults, options = {}) {
     }
     if (shouldOutlineText) {
       try {
-        const { convertAllTextToPath } = await import("./svgTextToPath-BP0Kppla.js");
-        pageSvg = await convertAllTextToPath(pageSvg, fontBaseUrl);
+        const { convertAllTextToPath } = await import("./svgTextToPath-B5sT7sre.js");
+        pageSvg = await convertAllTextToPath(pageSvg, fontBaseUrl, { mode: outlineSubMode });
         try {
           dumpSvgTextDiagnostics(pageSvg, i, PARITY_TAG, "STAGE-1b-after-text-to-path-raw");
         } catch {