@pixldocs/canvas-renderer 0.5.186 → 0.5.187

package/README.md

@@ -482,3 +482,77 @@ const blurFieldIds = ['text-reference-name', 'text-phone', 'text-address'];
   **downloads** (PNG/PDF) you still want to run `injectPreviewBlur(...)` on
   the resolved config before handing it to the imperative renderer, so the
   blur is baked into the exported pixels.
+
+### Biodata teaser previews — blur by flat form key (v0.5.187+)
+
+Form-driven apps (BioMaker, the pixldocs.com Use page, etc.) already
+speak the **flat form-key** language produced by `applyFormDataToConfig`
+— e.g.
+
+```
+field_<treeNodeId>_<entryIdx1>_<fieldKey>
+field_<parentTree>_<pi>_field_<childTree>_<ci>_<fieldKey>     // nested
+```
+
+Instead of reverse-engineering `config.__cloneIdMap` keys or the
+`__cN` / `_eN` clone suffixes on canvas element ids, you can pass those
+flat keys straight to `<PixldocsPreview>` and the package resolves them:
+
+```tsx
+import { PixldocsPreview } from '@pixldocs/canvas-renderer';
+
+// e.g. for a biodata teaser: blur every detail-row VALUE after row 3.
+const blurFlatFormKeys = buildTeaserBlurFlatKeys(sectionState, schema, {
+  afterRow: 3,
+  bindings: 'value',
+});
+
+<PixldocsPreview
+  config={displayConfig}
+  frostedBlur
+  blurFlatFormKeys={blurFlatFormKeys}
+  // Optional — defaults to { bindings: 'value' } so only `*_value` keys
+  // are honoured. Pass 'all' to blur labels / titles too.
+  blurFlatFormKeyOptions={{ bindings: 'value' }}
+/>
+```
+
+Notes:
+
+- Matching is done on `config.__cloneIdMap` and handles all alias
+  variants (`grp-…_4_value`, `…_4_field_detail_section_N_field_N_value`,
+  with or without the wrapper `field_` prefix). Unknown keys are
+  silently ignored — the package never blurs an element it can't
+  positively identify, so a stale key won't accidentally blur the full
+  name, photo, or section titles.
+- Defaults to `bindings: 'value'`, i.e. only flat keys whose last
+  segment is `value` resolve. This is exactly the biodata teaser
+  pattern: blur row values, leave labels / section titles / full-name /
+  photo sharp. Switch to `'all'` if you want labels blurred too.
+- This only drives the live preview overlay. For the watermarked
+  PNG/PDF download path, resolve the same keys to exact ids and bake
+  them in (see below).
+
+#### Watermarked downloads — same resolver + `injectPreviewBlur`
+
+```ts
+import {
+  injectPreviewBlur,
+  resolveBlurElementExactIdsFromFlatFormKeys,
+} from '@pixldocs/canvas-renderer';
+
+const exactIds = resolveBlurElementExactIdsFromFlatFormKeys(
+  resolvedConfig,
+  blurFlatFormKeys,
+  // { bindings: 'value' } by default
+);
+
+const exportConfig = injectPreviewBlur(resolvedConfig, {
+  extraElementExactIds: new Set(exactIds),
+});
+
+// Hand `exportConfig` to renderer.renderAllPages / renderPdf / …
+```
+
+Same resolution path as the live preview — so the on-screen overlay and
+the downloaded PNG/PDF blur exactly the same elements.

package/dist/{index-Xg0sHfrw.js → index-C9H38u7P.js}

@@ -16115,6 +16115,44 @@ async function getTemplateForm(options) {
     initialSectionState
   };
 }
+function stripFieldPrefix(s) {
+  return s.startsWith("field_") ? s.slice("field_".length) : s;
+}
+function addAll(val, out) {
+  if (!val) return false;
+  if (Array.isArray(val)) {
+    for (const v of val) out.add(v);
+    return val.length > 0;
+  }
+  out.add(val);
+  return true;
+}
+function resolveBlurElementExactIdsFromFlatFormKeys(config, flatFormKeys, options) {
+  const cloneIdMap = (config == null ? void 0 : config.__cloneIdMap) || {};
+  if (!cloneIdMap || typeof cloneIdMap !== "object") return [];
+  const bindings = (options == null ? void 0 : options.bindings) ?? "value";
+  const out = /* @__PURE__ */ new Set();
+  for (const rawId of flatFormKeys) {
+    if (typeof rawId !== "string" || !rawId) continue;
+    if (bindings === "value" && !rawId.endsWith("_value")) continue;
+    const candidates = [rawId];
+    if (rawId.startsWith("field_")) {
+      const topStripped = stripFieldPrefix(rawId);
+      candidates.push(topStripped);
+      const nestedIdx = topStripped.indexOf("_field_");
+      if (nestedIdx >= 0) {
+        const nestedStripped = topStripped.slice(0, nestedIdx + 1) + topStripped.slice(nestedIdx + 1 + "field_".length);
+        candidates.push(nestedStripped);
+      }
+    }
+    for (const k of candidates) {
+      if (k in cloneIdMap) {
+        if (addAll(cloneIdMap[k], out)) break;
+      }
+    }
+  }
+  return Array.from(out);
+}
 const PREVIEW_DEBUG_PREFIX = "[canvas-renderer][preview-debug]";
 function computeFontSignature(config) {
   var _a;
@@ -16208,7 +16246,9 @@ function PixldocsPreview(props) {
     frostedBlur = true,
     frostedBlurOptions,
     blurFieldIds,
-    blurElementExactIds
+    blurElementExactIds,
+    blurFlatFormKeys,
+    blurFlatFormKeyOptions
   } = props;
   useEffect(() => {
     setPackageApiUrl(imageProxyUrl);
@@ -16329,8 +16369,26 @@ function PixldocsPreview(props) {
     [blurFieldIds ? blurFieldIds.join("|") : ""]
   );
   const blurExactSet = useMemo(
-    () => blurElementExactIds && blurElementExactIds.length ? new Set(blurElementExactIds) : void 0,
-    [blurElementExactIds ? blurElementExactIds.join("|") : ""]
+    () => {
+      const merged = /* @__PURE__ */ new Set();
+      if (blurElementExactIds) for (const id of blurElementExactIds) merged.add(id);
+      if (config && blurFlatFormKeys && blurFlatFormKeys.length) {
+        for (const id of resolveBlurElementExactIdsFromFlatFormKeys(
+          config,
+          blurFlatFormKeys,
+          blurFlatFormKeyOptions
+        )) {
+          merged.add(id);
+        }
+      }
+      return merged.size > 0 ? merged : void 0;
+    },
+    [
+      blurElementExactIds ? blurElementExactIds.join("|") : "",
+      blurFlatFormKeys ? blurFlatFormKeys.join("|") : "",
+      blurFlatFormKeyOptions == null ? void 0 : blurFlatFormKeyOptions.bindings,
+      config
+    ]
   );
   const frostedBounds = useMemo(
     () => frostedBlur ? computeFrostedBoundsForPage(config, pageIndex, blurBaseSet, blurExactSet) : [],
@@ -16575,9 +16633,9 @@ function captureFabricCanvasSvgForPdf(fabricInstance, canvasWidth, canvasHeight)
   }
   return svgString;
 }
-const resolvedPackageVersion = "0.5.186";
+const resolvedPackageVersion = "0.5.187";
 const PACKAGE_VERSION = resolvedPackageVersion;
-const DEPLOYMENT_VERSION_MARKER = "__PIXLDOCS_CANVAS_RENDERER_VERSION__:0.5.186";
+const DEPLOYMENT_VERSION_MARKER = "__PIXLDOCS_CANVAS_RENDERER_VERSION__:0.5.187";
 const roundParityValue = (value) => {
   if (typeof value !== "number") return value;
   return Number.isFinite(value) ? Number(value.toFixed(3)) : value;
@@ -16876,8 +16934,8 @@ class PixldocsRenderer {
     if (shouldWatermark) {
       const { injectWatermark } = await import("./canvasWatermark-pkhacGge.js");
       configToRender = injectWatermark(configToRender, watermarkOptions);
-      const { injectPreviewBlur } = await import("./previewBlur-CDBjIIjX.js");
-      configToRender = injectPreviewBlur(configToRender);
+      const { injectPreviewBlur: injectPreviewBlur2 } = await Promise.resolve().then(() => previewBlur);
+      configToRender = injectPreviewBlur2(configToRender);
     }
     return this.renderAllPages(configToRender, renderOpts);
   }
@@ -16935,8 +16993,8 @@ class PixldocsRenderer {
     if (shouldWatermark) {
       const { injectWatermark } = await import("./canvasWatermark-pkhacGge.js");
       configToRender = injectWatermark(configToRender, watermarkOptions);
-      const { injectPreviewBlur } = await import("./previewBlur-CDBjIIjX.js");
-      configToRender = injectPreviewBlur(configToRender);
+      const { injectPreviewBlur: injectPreviewBlur2 } = await Promise.resolve().then(() => previewBlur);
+      configToRender = injectPreviewBlur2(configToRender);
     }
     return this.renderAllPageSvgs(configToRender);
   }
@@ -16979,8 +17037,8 @@ class PixldocsRenderer {
     if (shouldWatermark) {
       const { injectWatermark } = await import("./canvasWatermark-pkhacGge.js");
       configToRender = injectWatermark(configToRender, watermarkOptions);
-      const { injectPreviewBlur } = await import("./previewBlur-CDBjIIjX.js");
-      configToRender = injectPreviewBlur(configToRender);
+      const { injectPreviewBlur: injectPreviewBlur2 } = await Promise.resolve().then(() => previewBlur);
+      configToRender = injectPreviewBlur2(configToRender);
     }
     return this.renderPdfViaClientExport(configToRender, {
       title: title ?? resolved.config.name,
@@ -17085,7 +17143,7 @@ class PixldocsRenderer {
         await this.waitForCanvasScene(container, cloned, i);
       }
       console.log(`[canvas-renderer][pdf-unified] mounted ${cloned.pages.length} page(s), handing off to client exportMultiPagePdf`);
-      const { exportMultiPagePdf, preparePagesForExport } = await import("./vectorPdfExport-v3mr9nks.js");
+      const { exportMultiPagePdf, preparePagesForExport } = await import("./vectorPdfExport-BkERGCkM.js");
       const prepared = preparePagesForExport(
         cloned.pages,
         canvasWidth,
@@ -17927,7 +17985,7 @@ function collectFontSpecsFromMarkup(markup) {
   }
   return Array.from(specs);
 }
-function parseColor(color) {
+function parseColor$1(color) {
   if (!color) return null;
   const raw = color.trim().toLowerCase();
   if (!raw || raw === "transparent" || raw === "none") return null;
@@ -18480,7 +18538,7 @@ function stripSuspiciousFullPageOverlayNodes(svg) {
   if (!(pageWidth > 0 && pageHeight > 0)) return;
   const isNear = (a, b, tolerance = 0.75) => Math.abs(a - b) <= tolerance;
   const isDarkPaint = (value) => {
-    const rgb = value ? parseColor(value) : null;
+    const rgb = value ? parseColor$1(value) : null;
     return rgb ? rgb.r <= 32 && rgb.g <= 32 && rgb.b <= 32 : false;
   };
   const removeIfSuspicious = (el) => {
@@ -18593,13 +18651,13 @@ function inlineComputedStyles(svg) {
         const fill = cs.fill;
         const stroke = cs.stroke;
         if (fill && fill !== "none" && fill !== "rgba(0, 0, 0, 0)") {
-          const parsed = parseColor(fill);
+          const parsed = parseColor$1(fill);
           if (parsed) el.setAttribute("fill", rgbToHex(parsed.r, parsed.g, parsed.b));
         } else if (fill === "rgba(0, 0, 0, 0)" || fill === "transparent") {
           el.setAttribute("fill", "none");
         }
         if (stroke && stroke !== "none" && stroke !== "rgba(0, 0, 0, 0)") {
-          const parsed = parseColor(stroke);
+          const parsed = parseColor$1(stroke);
           if (parsed) el.setAttribute("stroke", rgbToHex(parsed.r, parsed.g, parsed.b));
         }
       }
@@ -18747,7 +18805,7 @@ function setPdfColorFromSvg(pdf, svg, _elementId) {
   const { fill, stroke } = getFirstExplicitColorFromSvg(svg);
   const setColor = (hex, setter) => {
     if (!hex) return;
-    const c = parseColor(hex);
+    const c = parseColor$1(hex);
     if (c) pdf[setter](c.r, c.g, c.b);
   };
   setColor(fill, "setFillColor");
@@ -19230,7 +19288,7 @@ async function prepareLiveCanvasSvgForPdf(rawSvg, pageWidth, pageHeight, pageKey
     if (options == null ? void 0 : options.stripPageBackground) stripRootPageBackgroundFromSvg(svgToDraw);
     sanitizeSvgTreeForPdf(svgToDraw);
     try {
-      const { bakeTextAnchorPositionsFromLiveSvg, logTextMeasurementDiagnostic } = await import("./vectorPdfExport-v3mr9nks.js");
+      const { bakeTextAnchorPositionsFromLiveSvg, logTextMeasurementDiagnostic } = await import("./vectorPdfExport-BkERGCkM.js");
       try {
         await logTextMeasurementDiagnostic(svgToDraw);
       } catch {
@@ -19250,7 +19308,7 @@ function drawPageBackground(pdf, pageIndex, pageWidth, pageHeight, backgroundCol
   if (backgroundGradient && ((_a = backgroundGradient.stops) == null ? void 0 : _a.length) >= 2) {
     const grad = backgroundGradient;
     const colorStops = grad.stops.map((s) => {
-      const c = parseColor(s.color);
+      const c = parseColor$1(s.color);
       return {
         offset: Math.max(0, Math.min(1, Number(s.offset))),
         color: c ? [c.r, c.g, c.b] : [0, 0, 0]
@@ -19306,7 +19364,7 @@ function drawPageBackground(pdf, pageIndex, pageWidth, pageHeight, backgroundCol
       pdf.rect(0, 0, pageWidth, pageHeight, "F");
     }
   } else {
-    const bgColor = parseColor(backgroundColor && backgroundColor !== "transparent" ? backgroundColor : "#ffffff");
+    const bgColor = parseColor$1(backgroundColor && backgroundColor !== "transparent" ? backgroundColor : "#ffffff");
     if (bgColor) {
       pdf.setFillColor(bgColor.r, bgColor.g, bgColor.b);
       pdf.rect(0, 0, pageWidth, pageHeight, "F");
@@ -19429,6 +19487,123 @@ async function assemblePdfFromSvgs(svgResults, options = {}) {
     pages: svgResults.map((p) => ({ width: p.width, height: p.height }))
   };
 }
+const OVERLAY_ID_PREFIX = "__pb_";
+function getNumber(v, fallback = 0) {
+  return typeof v === "number" && Number.isFinite(v) ? v : fallback;
+}
+function resolveSize(node, key) {
+  const v = node == null ? void 0 : node[key];
+  if (typeof v === "number" && Number.isFinite(v)) return v;
+  return 0;
+}
+function collectOverlays(node, parentLeft, parentTop, inheritedBlur, extraBaseIds, extraExactIds, out) {
+  if (!node || typeof node !== "object") return;
+  const matchesBase = !!(extraBaseIds && typeof node.id === "string" && extraBaseIds.has(baseId(node.id)));
+  const matchesExact = !!(extraExactIds && typeof node.id === "string" && extraExactIds.has(node.id));
+  const isBlurred = inheritedBlur || node.previewBlur === true || matchesBase || matchesExact;
+  const absLeft = parentLeft + getNumber(node.left, 0);
+  const absTop = parentTop + getNumber(node.top, 0);
+  if (node.type === "group") {
+    const children = node.children || node.elements;
+    if (Array.isArray(children)) {
+      for (const child of children) {
+        collectOverlays(child, absLeft, absTop, isBlurred, extraBaseIds, extraExactIds, out);
+      }
+    }
+    return;
+  }
+  if (!isBlurred) return;
+  const scaleX = getNumber(node.scaleX, 1) || 1;
+  const scaleY = getNumber(node.scaleY, 1) || 1;
+  const w = Math.max(4, resolveSize(node, "width") * scaleX);
+  const h = Math.max(4, resolveSize(node, "height") * scaleY);
+  out.push({
+    left: absLeft,
+    top: absTop,
+    width: w,
+    height: h,
+    hintFill: typeof node.fill === "string" ? node.fill : void 0
+  });
+}
+function parseColor(c) {
+  if (!c) return null;
+  const s = c.trim();
+  const hex = s.match(/^#([0-9a-f]{3}|[0-9a-f]{6})$/i);
+  if (hex) {
+    let h = hex[1];
+    if (h.length === 3) h = h.split("").map((x) => x + x).join("");
+    return {
+      r: parseInt(h.slice(0, 2), 16),
+      g: parseInt(h.slice(2, 4), 16),
+      b: parseInt(h.slice(4, 6), 16)
+    };
+  }
+  const rgb = s.match(/^rgba?\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)/i);
+  if (rgb) return { r: +rgb[1], g: +rgb[2], b: +rgb[3] };
+  return null;
+}
+function buildOverlay(b, idx) {
+  const c = parseColor(b.hintFill);
+  const lum = c ? (0.299 * c.r + 0.587 * c.g + 0.114 * c.b) / 255 : 0.2;
+  const isLightGlass = lum < 0.5;
+  const baseFill = isLightGlass ? "rgba(245,245,245,0.68)" : "rgba(30,30,30,0.62)";
+  return {
+    id: `${OVERLAY_ID_PREFIX}${idx}`,
+    type: "shape",
+    shapeType: "rounded-rect",
+    left: b.left,
+    top: b.top,
+    width: b.width,
+    height: b.height,
+    cornerRadius: 0,
+    fill: baseFill,
+    stroke: "transparent",
+    strokeWidth: 0,
+    opacity: 1,
+    selectable: false,
+    locked: true,
+    visible: true,
+    scaleX: 1,
+    scaleY: 1
+  };
+}
+function injectPreviewBlur(config, options) {
+  const cloned = typeof structuredClone === "function" ? structuredClone(config) : JSON.parse(JSON.stringify(config));
+  const extraBase = (options == null ? void 0 : options.extraElementBaseIds) && options.extraElementBaseIds.size > 0 ? options.extraElementBaseIds : void 0;
+  const extraExact = (options == null ? void 0 : options.extraElementExactIds) && options.extraElementExactIds.size > 0 ? options.extraElementExactIds : void 0;
+  let idx = 0;
+  for (const page of cloned.pages || []) {
+    const children = page.children || page.elements;
+    if (!Array.isArray(children)) continue;
+    const overlays = [];
+    for (const child of children) {
+      collectOverlays(child, 0, 0, false, extraBase, extraExact, overlays);
+    }
+    if (overlays.length === 0) continue;
+    for (const b of overlays) {
+      children.push(buildOverlay(b, idx++));
+    }
+  }
+  return cloned;
+}
+function hasAnyPreviewBlur(config) {
+  function walk(node) {
+    if (!node || typeof node !== "object") return false;
+    if (node.previewBlur === true) return true;
+    const children = node.children || node.elements;
+    if (Array.isArray(children)) {
+      for (const c of children) if (walk(c)) return true;
+    }
+    return false;
+  }
+  for (const page of config.pages || []) if (walk(page)) return true;
+  return false;
+}
+const previewBlur = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  hasAnyPreviewBlur,
+  injectPreviewBlur
+}, Symbol.toStringTag, { value: "Module" }));
 const SELECT_COLUMNS = "id,name,description,category,thumbnail_url,preview_images,price,download_count,workspace_id,sort_order,created_at,updated_at";
 async function listPublishedTemplates(options) {
   const { workspaceId, supabaseUrl, supabaseAnonKey, category, limit = 200, offset = 0 } = options;
@@ -19568,63 +19743,65 @@ function setAutoShrinkDebug(enabled) {
   }
 }
 export {
-  setAutoShrinkDebug as $,
+  resolveTemplateData as $,
   API_URL as A,
-  collectFontsFromConfig as B,
-  collectImageUrls as C,
+  collectImageUrls as B,
+  configHasAutoShrinkText$1 as C,
   DEPLOYMENT_VERSION_MARKER as D,
-  configHasAutoShrinkText$1 as E,
+  dumpSvgTextDiagnostics as E,
   FONT_FALLBACK_DEVANAGARI as F,
-  dumpSvgTextDiagnostics as G,
-  embedFont as H,
-  embedFontsForConfig as I,
-  embedFontsInPdf as J,
-  ensureFontsForResolvedConfig as K,
-  extractFontFamiliesFromSvgs as L,
-  getEmbeddedJsPDFFontName as M,
-  getPublishedTemplate as N,
-  getTemplateForm as O,
+  embedFont as G,
+  embedFontsForConfig as H,
+  embedFontsInPdf as I,
+  ensureFontsForResolvedConfig as J,
+  extractFontFamiliesFromSvgs as K,
+  getEmbeddedJsPDFFontName as L,
+  getPublishedTemplate as M,
+  getTemplateForm as N,
+  hasAnyPreviewBlur as O,
   PACKAGE_VERSION as P,
-  isBundledAssetUrl as Q,
-  isFontAvailable as R,
-  isPrivateUrl as S,
+  injectPreviewBlur as Q,
+  isBundledAssetUrl as R,
+  isFontAvailable as S,
   TRIANGLE_STROKE_MITER_LIMIT as T,
-  listPublishedTemplates as U,
-  loadGoogleFontCSS as V,
-  normalizeFontFamily as W,
-  resolveFontWeight as X,
-  resolveFromForm as Y,
-  resolveTemplateData as Z,
-  rewriteSvgFontsForJsPDF as _,
+  isPrivateUrl as U,
+  listPublishedTemplates as V,
+  loadGoogleFontCSS as W,
+  normalizeFontFamily as X,
+  resolveBlurElementExactIdsFromFlatFormKeys as Y,
+  resolveFontWeight as Z,
+  resolveFromForm as _,
   getAbsoluteBounds as a,
-  setBundledAssetPrefixes as a0,
-  warmResolvedTemplateForPreview as a1,
-  warmTemplateFromForm as a2,
-  canvasImageLoader as a3,
-  baseId as b,
+  rewriteSvgFontsForJsPDF as a0,
+  setAutoShrinkDebug as a1,
+  setBundledAssetPrefixes as a2,
+  warmResolvedTemplateForPreview as a3,
+  warmTemplateFromForm as a4,
+  canvasImageLoader as a5,
+  getProxiedImageUrl as b,
   captureFabricCanvasSvgForPdf as c,
-  getProxiedImageUrl as d,
-  bakeEdgeFade as e,
+  bakeEdgeFade as d,
+  isGroup as e,
   findNodeById as f,
   getCanvasForPage as g,
   hasEdgeFade as h,
   isElement as i,
-  isGroup as j,
-  buildRoundedTrianglePath as k,
-  getImageProxyFetchOptions as l,
-  getRoundedRectRadii as m,
+  buildRoundedTrianglePath as j,
+  getImageProxyFetchOptions as k,
+  getRoundedRectRadii as l,
+  getTrianglePoints as m,
   normalizeShapeType as n,
-  getTrianglePoints as o,
+  FONT_FALLBACK_MATH as o,
   parseTextMarkdown as p,
-  FONT_FALLBACK_MATH as q,
+  FONT_FALLBACK_SYMBOLS as q,
   renderSmartElementToSvg as r,
-  FONT_FALLBACK_SYMBOLS as s,
-  FONT_FILES as t,
-  PixldocsPreview as u,
-  PixldocsRenderer as v,
-  applyThemeToConfig as w,
-  assemblePdfFromSvgs as x,
-  awaitFontsForConfig as y,
-  collectFontDescriptorsFromConfig as z
+  FONT_FILES as s,
+  PixldocsPreview as t,
+  PixldocsRenderer as u,
+  applyThemeToConfig as v,
+  assemblePdfFromSvgs as w,
+  awaitFontsForConfig as x,
+  collectFontDescriptorsFromConfig as y,
+  collectFontsFromConfig as z
 };
-//# sourceMappingURL=index-Xg0sHfrw.js.map
+//# sourceMappingURL=index-C9H38u7P.js.map