@pixldocs/canvas-renderer 0.5.80 → 0.5.82

package/dist/index.d.ts

@@ -256,7 +256,7 @@ export declare function normalizeFontFamily(fontStack: string): string;
  * Package version banner. Bump alongside package.json so we can confirm
  * (via browser:log) that the deployed bundle matches the expected build.
  */
-export declare const PACKAGE_VERSION = "0.5.80";
+export declare const PACKAGE_VERSION = "0.5.81";
 
 export declare interface PageSettings {
     backgroundColor?: string;
@@ -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

@@ -12590,7 +12590,7 @@ function PixldocsPreview(props) {
     !canvasSettled && /* @__PURE__ */ jsx("div", { style: { position: "absolute", inset: 0, display: "flex", alignItems: "center", justifyContent: "center", minHeight: 200 }, children: /* @__PURE__ */ jsx("div", { style: { color: "#888", fontSize: 14 }, children: "Loading preview..." }) })
   ] });
 }
-const PACKAGE_VERSION = "0.5.80";
+const PACKAGE_VERSION = "0.5.81";
 const roundParityValue = (value) => {
   if (typeof value !== "number") return value;
   return Number.isFinite(value) ? Number(value.toFixed(3)) : value;
@@ -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}`);
               }
             }
@@ -15435,7 +15447,9 @@ async function convertTextDecorationsToLines(svg) {
       const fontFamily = tspan.getAttribute("data-source-font-family") || textEl.getAttribute("data-source-font-family") || resolveInheritedSvgValue(tspan, "font-family") || "sans-serif";
       const fontWeight = tspan.getAttribute("data-source-font-weight") || textEl.getAttribute("data-source-font-weight") || resolveInheritedSvgValue(tspan, "font-weight") || "normal";
       const fontStyle = tspan.getAttribute("data-source-font-style") || textEl.getAttribute("data-source-font-style") || resolveInheritedSvgValue(tspan, "font-style") || "normal";
-      const fill = tspan.getAttribute("fill") || textEl.getAttribute("fill") || "#000000";
+      const resolvedFill = tspan.getAttribute("fill") || getInlineStyleValue(tspan, "fill") || resolveInheritedSvgValue(tspan, "fill") || textEl.getAttribute("fill") || getInlineStyleValue(textEl, "fill") || "#000000";
+      const fill = resolvedFill;
+      const fillOpacity = tspan.getAttribute("fill-opacity") || getInlineStyleValue(tspan, "fill-opacity") || resolveInheritedSvgValue(tspan, "fill-opacity") || textEl.getAttribute("fill-opacity") || getInlineStyleValue(textEl, "fill-opacity") || null;
       let textWidth = content.length * fontSize * 0.6;
       if (ctx) {
         ctx.font = `${fontStyle} ${fontWeight} ${fontSize}px ${fontFamily.replace(/'/g, "")}`;
@@ -15486,6 +15500,7 @@ async function convertTextDecorationsToLines(svg) {
       line.setAttribute("stroke-width", String(thickness));
       line.setAttribute("stroke-linecap", "butt");
       line.setAttribute("fill", "none");
+      if (fillOpacity) line.setAttribute("stroke-opacity", fillOpacity);
       if (textEl.parentElement) {
         textEl.parentElement.insertBefore(line, textEl.nextSibling);
       }
@@ -15785,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);
@@ -15797,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 {