@pixldocs/canvas-renderer 0.5.188 → 0.5.190

package/README.md

@@ -483,7 +483,7 @@ const blurFieldIds = ['text-reference-name', 'text-phone', 'text-address'];
   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+)
+### Biodata teaser previews — blur by flat form key (v0.5.187+, hardened in v0.5.189, pagination-safe in v0.5.190)
 
 Form-driven apps (BioMaker, the pixldocs.com Use page, etc.) already
 speak the **flat form-key** language produced by `applyFormDataToConfig`
@@ -499,7 +499,10 @@ Instead of reverse-engineering `config.__cloneIdMap` keys or the
 flat keys straight to `<PixldocsPreview>` and the package resolves them:
 
 ```tsx
-import { PixldocsPreview } from '@pixldocs/canvas-renderer';
+import {
+  PixldocsPreview,
+  buildTeaserBlurFlatKeys,
+} from '@pixldocs/canvas-renderer';
 
 // e.g. for a biodata teaser: blur every detail-row VALUE after row 3.
 const blurFlatFormKeys = buildTeaserBlurFlatKeys(sectionState, schema, {
@@ -509,11 +512,14 @@ const blurFlatFormKeys = buildTeaserBlurFlatKeys(sectionState, schema, {
 
 <PixldocsPreview
   config={displayConfig}
+  pageIndex={pageIndex}
   frostedBlur
   blurFlatFormKeys={blurFlatFormKeys}
   // Optional — defaults to { bindings: 'value' } so only `*_value` keys
-  // are honoured. Pass 'all' to blur labels / titles too.
-  blurFlatFormKeyOptions={{ bindings: 'value' }}
+  // are honoured. Pass 'all' to blur labels / titles too. `pageIndex` is
+  // forwarded into the resolver so verification scopes to the page
+  // currently being rendered (recommended for stacked multi-page previews).
+  blurFlatFormKeyOptions={{ bindings: 'value', pageIndex }}
 />
 ```
 
@@ -521,10 +527,28 @@ 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.
+  with or without the wrapper `field_` prefix). **As of v0.5.189**
+  every resolved id is then verified against the actual rendered page
+  tree (`config.pages[*]`) — stale or alias map entries that don't
+  match a real element are dropped silently.
+- **As of v0.5.190** `applyContentBoundsPagination` rewrites
+  `__cloneIdMap` after pagination so flat keys for overflow rows that
+  moved to continuation pages still resolve to ids that exist on the
+  tree (clones inherit `__sourceId` from the original element). If the
+  map is still stale for any reason, the resolver also falls back to
+  walking the page tree and matching `__sourceId` / `__baseNodeId`
+  against the raw resolved ids — the same strategy the theming pipeline
+  uses to track paginated clones. End result: frosted blur for row N
+  appears on whichever page row N actually renders on, even when
+  content-bounds pagination moved it.
+- Pass `pageIndex` in `blurFlatFormKeyOptions` to scope verification
+  to a single page — clones that landed on a different page will not
+  contribute overlays to this page. This is the recommended pattern
+  for stacked multi-page previews. Default is `'all'` (verify across
+  every page).
+- Use `skipTreeVerification: true` only if you fully trust your
+  `__cloneIdMap` (e.g. you just built the config in-process and
+  haven't mutated the tree since).
 - 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 /
@@ -533,6 +557,26 @@ Notes:
   PNG/PDF download path, resolve the same keys to exact ids and bake
   them in (see below).
 
+#### `buildTeaserBlurFlatKeys(sectionState, sections, options)`
+
+Emits the flat form-keys for every repeatable-section entry **after**
+`afterRow` (1-indexed). Walks nested repeatables recursively.
+
+- `sectionState` — the same `SectionFormState` you'd hand to
+  `resolveFromForm` / `<PixldocsPreview sectionState={…}>`.
+- `sections` — `InferredSection[]` for the active form schema (you
+  already have these from `inferFormSchemaFromTemplate` or from the
+  `form_schemas` row converted via `fromFormDefSections`).
+- `options.afterRow` — keep the first N entries sharp; blur entries
+  `N+1, N+2, …`.
+- `options.bindings` — `'value'` (default) emits only `_value` keys
+  (the canonical biodata teaser pattern); `'all'` emits every entry
+  field key.
+
+Returned keys can be fed straight into the `blurFlatFormKeys` prop
+above and into `resolveBlurElementExactIdsFromFlatFormKeys` for the
+watermarked download path below.
+
 #### Watermarked downloads — same resolver + `injectPreviewBlur`
 
 ```ts
@@ -544,7 +588,9 @@ import {
 const exactIds = resolveBlurElementExactIdsFromFlatFormKeys(
   resolvedConfig,
   blurFlatFormKeys,
-  // { bindings: 'value' } by default
+  // { bindings: 'value', pageIndex: 'all' } by default. For the
+  // download path you usually want 'all' since the export covers
+  // every page.
 );
 
 const exportConfig = injectPreviewBlur(resolvedConfig, {

package/dist/{index-0rk-MRGy.cjs → index-BUm3wqlB.cjs}

@@ -13327,6 +13327,7 @@ function isStaticOnNewPage(node) {
 function cloneNodeWithNewIds(node) {
   const base = node.__baseNodeId;
   const source = node.__sourceId;
+  const effectiveSource = source ?? node.id;
   if (isGroup(node)) {
     const g = node;
     const cloned2 = {
@@ -13335,14 +13336,14 @@ function cloneNodeWithNewIds(node) {
       children: (g.children ?? []).map(cloneNodeWithNewIds)
     };
     if (base != null) cloned2.__baseNodeId = base;
-    if (source != null) cloned2.__sourceId = source;
+    cloned2.__sourceId = effectiveSource;
     return cloned2;
   }
   const el = node;
   const prefix = el.type === "text" ? "text" : el.type === "image" ? "img" : el.type === "shape" ? "shape" : "line";
   const cloned = { ...el, id: generateId(prefix) };
   if (base != null) cloned.__baseNodeId = base;
-  if (source != null) cloned.__sourceId = source;
+  cloned.__sourceId = effectiveSource;
   return cloned;
 }
 function cloneNodeWithStableIds(node, baseId2, path) {
@@ -13648,7 +13649,51 @@ function applyContentBoundsPagination(config) {
     resultPages.push(...paginated);
   }
   if (!mutated) return config;
-  return { ...config, pages: resultPages };
+  const next = { ...config, pages: resultPages };
+  remapCloneIdMapAfterPagination(next);
+  return next;
+}
+function remapCloneIdMapAfterPagination(config) {
+  const cloneIdMap = config.__cloneIdMap;
+  if (!cloneIdMap || typeof cloneIdMap !== "object") return;
+  const allIds = /* @__PURE__ */ new Set();
+  const sourceToNew = /* @__PURE__ */ new Map();
+  const walk = (node) => {
+    if (!node || typeof node !== "object") return;
+    const n = node;
+    if (typeof n.id === "string") {
+      allIds.add(n.id);
+      const src = n.__sourceId;
+      if (typeof src === "string" && src !== n.id) {
+        const arr = sourceToNew.get(src);
+        if (arr) arr.push(n.id);
+        else sourceToNew.set(src, [n.id]);
+      }
+    }
+    const children = n.children;
+    if (Array.isArray(children)) for (const c of children) walk(c);
+  };
+  for (const page of config.pages ?? []) {
+    const ch = page.children;
+    if (Array.isArray(ch)) for (const c of ch) walk(c);
+  }
+  const updated = {};
+  for (const [key, val] of Object.entries(cloneIdMap)) {
+    const oldIds = Array.isArray(val) ? val : [val];
+    const newIds = [];
+    for (const oid of oldIds) {
+      if (typeof oid !== "string") continue;
+      if (allIds.has(oid)) newIds.push(oid);
+      const clones = sourceToNew.get(oid);
+      if (clones) {
+        for (const c of clones) if (allIds.has(c)) newIds.push(c);
+      }
+    }
+    if (newIds.length === 0) continue;
+    const uniq = Array.from(new Set(newIds));
+    updated[key] = uniq.length === 1 ? uniq[0] : uniq;
+  }
+  config.__cloneIdMap = updated;
 }
 const __vite_import_meta_env__ = {};
 const FONT_WEIGHT_LABELS = {
@@ -16257,6 +16302,49 @@ function addAllToSet(val, out) {
   out.add(val);
   return true;
 }
+function collectPageTreeElementIds(config, pageIndex = "all") {
+  const out = /* @__PURE__ */ new Set();
+  const pages = config == null ? void 0 : config.pages;
+  if (!Array.isArray(pages)) return out;
+  const targets = pageIndex === "all" ? pages : pages[pageIndex] != null ? [pages[pageIndex]] : [];
+  const walk = (node) => {
+    if (!node || typeof node !== "object") return;
+    if (typeof node.id === "string") out.add(node.id);
+    const children = node.children || node.elements;
+    if (Array.isArray(children)) for (const c of children) walk(c);
+  };
+  for (const page of targets) {
+    const children = (page == null ? void 0 : page.children) || (page == null ? void 0 : page.elements);
+    if (Array.isArray(children)) for (const c of children) walk(c);
+  }
+  return out;
+}
+function collectIdsBySourceMatch(config, targetIds, pageIndex = "all") {
+  const targets = /* @__PURE__ */ new Set();
+  for (const t of targetIds) if (typeof t === "string" && t) targets.add(t);
+  if (targets.size === 0) return [];
+  const pages = config == null ? void 0 : config.pages;
+  if (!Array.isArray(pages)) return [];
+  const visitPages = pageIndex === "all" ? pages : pages[pageIndex] != null ? [pages[pageIndex]] : [];
+  const out = /* @__PURE__ */ new Set();
+  const walk = (node) => {
+    if (!node || typeof node !== "object") return;
+    const src = typeof node.__sourceId === "string" ? node.__sourceId : void 0;
+    const base = typeof node.__baseNodeId === "string" ? node.__baseNodeId : void 0;
+    if (typeof node.id === "string") {
+      if (targets.has(node.id)) out.add(node.id);
+      else if (src && targets.has(src)) out.add(node.id);
+      else if (base && targets.has(base)) out.add(node.id);
+    }
+    const children = node.children || node.elements;
+    if (Array.isArray(children)) for (const c of children) walk(c);
+  };
+  for (const page of visitPages) {
+    const children = (page == null ? void 0 : page.children) || (page == null ? void 0 : page.elements);
+    if (Array.isArray(children)) for (const c of children) walk(c);
+  }
+  return Array.from(out);
+}
 function resolveBlurElementExactIdsFromFlatFormKeys(config, flatFormKeys, options) {
   const cloneIdMap = (config == null ? void 0 : config.__cloneIdMap) || {};
   if (!cloneIdMap || typeof cloneIdMap !== "object") return [];
@@ -16281,10 +16369,60 @@ function resolveBlurElementExactIdsFromFlatFormKeys(config, flatFormKeys, option
       }
     }
   }
-  return Array.from(out);
+  if (out.size === 0) return [];
+  if (options == null ? void 0 : options.skipTreeVerification) return Array.from(out);
+  const treeIds = collectPageTreeElementIds(
+    config,
+    (options == null ? void 0 : options.pageIndex) ?? "all"
+  );
+  if (treeIds.size === 0) return Array.from(out);
+  const verified = [];
+  for (const id of out) if (treeIds.has(id)) verified.push(id);
+  if (verified.length > 0) return verified;
+  return collectIdsBySourceMatch(config, out, (options == null ? void 0 : options.pageIndex) ?? "all");
+}
+function buildTeaserBlurFlatKeys(sectionState, sections, options) {
+  const afterRow = Math.max(0, options.afterRow | 0);
+  const bindings = options.bindings ?? "value";
+  const out = [];
+  if (!sectionState || !Array.isArray(sections)) return out;
+  const repeatables = sections.filter((s) => (s == null ? void 0 : s.type) === "repeatable");
+  const childrenByParent = /* @__PURE__ */ new Map();
+  for (const r of repeatables) {
+    if (!r.parentId) continue;
+    const arr = childrenByParent.get(r.parentId) || [];
+    arr.push(r);
+    childrenByParent.set(r.parentId, arr);
+  }
+  const emitForEntryFields = (section, keyPrefix, entryIdx1) => {
+    const fields = section.entryFields || [];
+    for (const f of fields) {
+      if (!(f == null ? void 0 : f.key)) continue;
+      if (bindings === "value" && f.key !== "value") continue;
+      out.push(`${keyPrefix}_${f.key}`);
+    }
+  };
+  const walkRepeatable = (section, parentKeyPrefix) => {
+    const entries = sectionState == null ? void 0 : sectionState[section.id];
+    if (!Array.isArray(entries)) return;
+    for (let i = 0; i < entries.length; i++) {
+      const entryIdx1 = i + 1;
+      const isBlurred = entryIdx1 > afterRow;
+      const keyPrefix = parentKeyPrefix ? `${parentKeyPrefix}_field_${section.id}_${entryIdx1}` : `field_${section.id}_${entryIdx1}`;
+      if (isBlurred) emitForEntryFields(section, keyPrefix);
+      const children = childrenByParent.get(section.id) || [];
+      for (const child of children) walkRepeatable(child, keyPrefix);
+    }
+  };
+  for (const r of repeatables) {
+    if (r.parentId) continue;
+    walkRepeatable(r, "");
+  }
+  return out;
 }
 const previewBlur = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
+  buildTeaserBlurFlatKeys,
   hasAnyPreviewBlur,
   injectPreviewBlur,
   resolveBlurElementExactIdsFromFlatFormKeys
@@ -16769,9 +16907,9 @@ function captureFabricCanvasSvgForPdf(fabricInstance, canvasWidth, canvasHeight)
   }
   return svgString;
 }
-const resolvedPackageVersion = "0.5.188";
+const resolvedPackageVersion = "0.5.190";
 const PACKAGE_VERSION = resolvedPackageVersion;
-const DEPLOYMENT_VERSION_MARKER = "__PIXLDOCS_CANVAS_RENDERER_VERSION__:0.5.188";
+const DEPLOYMENT_VERSION_MARKER = "__PIXLDOCS_CANVAS_RENDERER_VERSION__:0.5.190";
 const roundParityValue = (value) => {
   if (typeof value !== "number") return value;
   return Number.isFinite(value) ? Number(value.toFixed(3)) : value;
@@ -17279,7 +17417,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 Promise.resolve().then(() => require("./vectorPdfExport-B2Cf-9eT.cjs"));
+      const { exportMultiPagePdf, preparePagesForExport } = await Promise.resolve().then(() => require("./vectorPdfExport-Cgw8dB-L.cjs"));
       const prepared = preparePagesForExport(
         cloned.pages,
         canvasWidth,
@@ -19424,7 +19562,7 @@ async function prepareLiveCanvasSvgForPdf(rawSvg, pageWidth, pageHeight, pageKey
     if (options == null ? void 0 : options.stripPageBackground) stripRootPageBackgroundFromSvg(svgToDraw);
     sanitizeSvgTreeForPdf(svgToDraw);
     try {
-      const { bakeTextAnchorPositionsFromLiveSvg, logTextMeasurementDiagnostic } = await Promise.resolve().then(() => require("./vectorPdfExport-B2Cf-9eT.cjs"));
+      const { bakeTextAnchorPositionsFromLiveSvg, logTextMeasurementDiagnostic } = await Promise.resolve().then(() => require("./vectorPdfExport-Cgw8dB-L.cjs"));
       try {
         await logTextMeasurementDiagnostic(svgToDraw);
       } catch {
@@ -19775,6 +19913,7 @@ exports.assemblePdfFromSvgs = assemblePdfFromSvgs;
 exports.awaitFontsForConfig = awaitFontsForConfig;
 exports.bakeEdgeFade = bakeEdgeFade;
 exports.buildRoundedTrianglePath = buildRoundedTrianglePath;
+exports.buildTeaserBlurFlatKeys = buildTeaserBlurFlatKeys;
 exports.canvasImageLoader = canvasImageLoader;
 exports.captureFabricCanvasSvgForPdf = captureFabricCanvasSvgForPdf;
 exports.collectFontDescriptorsFromConfig = collectFontDescriptorsFromConfig;
@@ -19820,4 +19959,4 @@ exports.setAutoShrinkDebug = setAutoShrinkDebug;
 exports.setBundledAssetPrefixes = setBundledAssetPrefixes;
 exports.warmResolvedTemplateForPreview = warmResolvedTemplateForPreview;
 exports.warmTemplateFromForm = warmTemplateFromForm;
-//# sourceMappingURL=index-0rk-MRGy.cjs.map
+//# sourceMappingURL=index-BUm3wqlB.cjs.map