@pixldocs/canvas-renderer 0.5.54 → 0.5.56

package/dist/index.d.ts

@@ -482,16 +482,29 @@ export declare function resolveFromForm(options: ResolveFromFormOptions): Promis
 export declare interface ResolveFromFormOptions {
     /** Template UUID */
     templateId: string;
-    /** Form schema UUID */
-    formSchemaId: string;
-    /** V2 section state (same shape sent to /render-from-form) */
-    sectionState: SectionFormState;
+    /**
+     * Form schema UUID. Optional — omit for templates with manual `dynamicFields`
+     * that are not bound to a saved form schema.
+     */
+    formSchemaId?: string;
+    /**
+     * V2 section state (same shape sent to /render-from-form). Optional when
+     * `flatFormData` is provided (manual-fields path).
+     */
+    sectionState?: SectionFormState;
+    /**
+     * Flat key/value map of dynamic-field values, keyed by `dynamicField.id`.
+     * Use this for manual-fields templates with no `formSchemaId` — values
+     * are applied directly through `applyFormDataToConfig` without going
+     * through the section-state flatten step.
+     */
+    flatFormData?: Record<string, unknown>;
     /** Optional theme variant ID (default: 'default') */
     themeId?: string;
     /** Supabase project URL */
-    supabaseUrl: string;
+    supabaseUrl?: string;
     /** Supabase anon key */
-    supabaseAnonKey: string;
+    supabaseAnonKey?: string;
     /** Optional prefetched rows from a trusted server so browser-side package resolution can skip REST fetches entirely. */
     prefetched?: {
         templateRow?: {
@@ -530,9 +543,24 @@ export declare interface ResolveOptions {
     /** Optional flat formData (legacy, simple fields only) */
     formData?: Record<string, any>;
     /** Supabase project URL */
-    supabaseUrl: string;
+    supabaseUrl?: string;
     /** Supabase anon key */
-    supabaseAnonKey: string;
+    supabaseAnonKey?: string;
+    /**
+     * Optional prefetched template row from a trusted server. When provided
+     * the resolver skips the REST fetch — useful for the EC2 v2 pipeline where
+     * the server already has the row in memory.
+     */
+    prefetched?: {
+        templateRow?: {
+            id?: string;
+            name?: string;
+            price?: number;
+            config: TemplateConfig;
+            form_schema?: unknown;
+            default_data?: unknown;
+        };
+    };
 }
 
 export declare function resolveTemplateData(options: ResolveOptions): Promise<ResolvedTemplate>;
@@ -550,6 +578,14 @@ export declare function rewriteSvgFontsForJsPDF(svgStr: string): string;
 
 export { SectionFormState }
 
+/**
+ * Enable verbose console logs for the auto-shrink loop in the live preview.
+ * Logs target width, measured line widths, font availability, and the chosen
+ * fontSize for each text element with `overflowPolicy: 'auto-shrink'`.
+ * Disabled by default — call once from the host app when debugging.
+ */
+export declare function setAutoShrinkDebug(enabled: boolean): void;
+
 export { setBundledAssetPrefixes }
 
 export { SmartElementProps }

package/dist/index.js

@@ -5270,6 +5270,10 @@ function createText(element) {
   const splitByGrapheme = overflowPolicy === "auto-shrink" ? false : element.splitByGrapheme ?? element.wordWrap === "break-word";
   if (overflowPolicy === "auto-shrink") {
     const explicitLineCount = Math.max(1, text.split("\n").length);
+    const debugAutoShrink = typeof window !== "undefined" && window.__pixldocsDebugAutoShrink === true;
+    const startFontSize = fontSize;
+    let breakReason = "min-font-size-reached";
+    let lastIter = null;
     while (fontSize > 1) {
       const testTextbox = new fabric.Textbox(text, {
         width: fixedWidth,
@@ -5291,11 +5295,47 @@ function createText(element) {
       const lineWidths = testTextbox.__lineWidths;
       const maxLineWidth = lineWidths && lineWidths.length > 0 ? Math.max(...lineWidths) : 0;
       const fitsWidth = !widthDidGrow && maxLineWidth <= fixedWidth + 1;
+      if (debugAutoShrink) {
+        lastIter = {
+          fontSize,
+          renderedLineCount,
+          explicitLineCount,
+          textHeight,
+          maxLineWidth,
+          fixedWidth,
+          widthDidGrow,
+          hasNoImplicitWrap,
+          fitsHeight,
+          fitsWidth
+        };
+      }
       if (hasNoImplicitWrap && fitsHeight && fitsWidth) {
+        breakReason = "fits";
         break;
       }
       fontSize--;
     }
+    if (debugAutoShrink) {
+      console.log("[auto-shrink][diag]", {
+        id: element.id,
+        name: element.name,
+        text,
+        fontFamily: element.fontFamily,
+        fontWeight: element.fontWeight,
+        elementWidth: element.width,
+        elementHeight: element.height,
+        scaleX: element.scaleX ?? 1,
+        scaleY: element.scaleY ?? 1,
+        fixedWidth,
+        baseHeight,
+        startFontSize,
+        finalFontSize: fontSize,
+        breakReason,
+        lastIter,
+        fontCheckRegular: typeof document !== "undefined" && document.fonts ? document.fonts.check(`16px "${element.fontFamily || "Open Sans"}"`) : null,
+        fontCheckBold: typeof document !== "undefined" && document.fonts ? document.fonts.check(`bold 16px "${element.fontFamily || "Open Sans"}"`) : null
+      });
+    }
   }
   if (overflowPolicy === "max-lines-ellipsis") {
     const originalText = element.text || "Text";
@@ -11674,8 +11714,8 @@ function deriveRepeatablePagesFromTemplate(config, inlineFormSchema, formData) {
   return out;
 }
 async function resolveTemplateData(options) {
-  const { templateId, formData, supabaseUrl, supabaseAnonKey } = options;
-  const template = await fetchRow(supabaseUrl, supabaseAnonKey, "templates", templateId);
+  const { templateId, formData, supabaseUrl, supabaseAnonKey, prefetched } = options;
+  const template = (prefetched == null ? void 0 : prefetched.templateRow) ? prefetched.templateRow : await fetchRow(supabaseUrl, supabaseAnonKey, "templates", templateId);
   let config = template.config;
   const inlineFormSchema = template.form_schema;
   const defaultData = template.default_data;
@@ -11742,7 +11782,16 @@ async function resolveTemplateData(options) {
 }
 async function resolveFromForm(options) {
   var _a, _b, _c;
-  const { templateId, formSchemaId, sectionState, themeId, supabaseUrl, supabaseAnonKey, prefetched } = options;
+  const { templateId, formSchemaId, sectionState, flatFormData: directFlatFormData, themeId, supabaseUrl, supabaseAnonKey, prefetched } = options;
+  if (!formSchemaId) {
+    return resolveTemplateData({
+      templateId,
+      formData: directFlatFormData ?? sectionState ?? {},
+      supabaseUrl,
+      supabaseAnonKey,
+      prefetched: (prefetched == null ? void 0 : prefetched.templateRow) ? { templateRow: prefetched.templateRow } : void 0
+    });
+  }
   const [templateRow, formSchemaRow, defaultForm] = await Promise.all([
     (prefetched == null ? void 0 : prefetched.templateRow) ? Promise.resolve(prefetched.templateRow) : fetchRow(supabaseUrl, supabaseAnonKey, "templates", templateId),
     (prefetched == null ? void 0 : prefetched.formSchemaRow) !== void 0 ? Promise.resolve(prefetched.formSchemaRow) : fetchRow(supabaseUrl, supabaseAnonKey, "form_schemas", formSchemaId),
@@ -15452,6 +15501,11 @@ async function warmTemplateFromForm(options) {
   if (signal == null ? void 0 : signal.aborted) return;
   await warmResolvedTemplateForPreview(resolved.config, { signal, imageProxyUrl });
 }
+function setAutoShrinkDebug(enabled) {
+  if (typeof window !== "undefined") {
+    window.__pixldocsDebugAutoShrink = !!enabled;
+  }
+}
 export {
   FONT_FALLBACK_DEVANAGARI,
   FONT_FALLBACK_SYMBOLS,
@@ -15480,6 +15534,7 @@ export {
   resolveFromForm,
   resolveTemplateData,
   rewriteSvgFontsForJsPDF,
+  setAutoShrinkDebug,
   setBundledAssetPrefixes,
   warmResolvedTemplateForPreview,
   warmTemplateFromForm