@myissue/vue-website-page-builder 3.5.48 → 3.5.51

package/dist/index.d.ts

@@ -102,6 +102,8 @@ declare interface BuildProductSectionStyleOptions {
     cardStyle?: ProductCardStyle;
     roundedImages?: boolean;
     openInNewTab?: boolean;
+    buttonStyle?: ProductButtonStyle;
+    roundedButtons?: boolean;
     hidePrice?: boolean;
     hideImage?: boolean;
     hideButton?: boolean;
@@ -153,6 +155,10 @@ export declare interface InsertProductsOptions {
     roundedImages?: boolean;
     /** Adds target="_blank" rel="noopener noreferrer" to product links */
     openInNewTab?: boolean;
+    /** Product CTA appearance: plain text link or button style */
+    buttonStyle?: ProductButtonStyle;
+    /** Applies rounded/full corners when CTA button style is enabled */
+    roundedButtons?: boolean;
     /** Hides price and compare-at price when product data includes them */
     hidePrice?: boolean;
     /** Hides product photos when product data includes images */
@@ -307,11 +313,17 @@ export declare class PageBuilderService {
     private _pendingPageSettings;
     private _lastKnownPageSettings;
     private isPageBuilderMissingOnStart;
+    private hasCompletedBuilderMount;
+    private builderWasMountedBeforeClose;
+    private builderMountPromise;
+    private activeBuilderSessionToken;
     private canvasClickCaptureListener;
     private canvasDblClickCaptureListener;
     private elementsWithListeners;
     private translate;
     constructor(pageBuilderStateStore: ReturnType<typeof usePageBuilderStateStore>);
+    private isDebugEnabled;
+    private debugLog;
     /**
      * Returns an array of available languages.
      * @returns {AvailableLanguage[]} An array of available language codes.
@@ -364,12 +376,30 @@ export declare class PageBuilderService {
      * @returns {Promise<StartBuilderResult>} A result object indicating success or failure.
      */
     startBuilder(config: PageBuilderConfig, passedComponentsArray?: BuilderResourceData): Promise<StartBuilderResult>;
+    /**
+     * Whether PageBuilder.vue should run deferred mount on mount (DOM was missing at startBuilder).
+     *
+     * @param ownCanvas - The component's own #pagebuilder element (passed from PageBuilder.vue ref).
+     *   Using this instead of document.querySelector ensures the correct canvas is checked when
+     *   multiple PageBuilder instances exist on the same page (e.g. one always-visible + one in a
+     *   modal).  When the modal's canvas is empty while another instance already has content, the
+     *   document.querySelector approach would miss the empty canvas entirely.
+     */
+    shouldCompleteBuilderMountOnMount(ownCanvas?: HTMLElement): boolean;
+    /**
+     * Marks the builder canvas lifecycle as "missing on start" for the next mount.
+     * Used by PageBuilder.vue on unmount (v-if modal close) so reopen performs
+     * a full draft-aware initialization instead of reusing potentially stale store DOM.
+     */
+    markCanvasUnmountedForNextMount(): void;
     /**
      * Completes the builder initialization process once the DOM is ready.
      * @param {BuilderResourceData} [passedComponentsArray] - Optional array of components to load.
      * @returns {Promise<void>}
      */
     completeBuilderInitialization(passedComponentsArray?: BuilderResourceData): Promise<void>;
+    private completeBuilderInitializationWithSession;
+    private runCompleteBuilderInitialization;
     /**
      * Converts an array of ComponentObject into a single HTML string.
      *
@@ -523,6 +553,16 @@ export declare class PageBuilderService {
     private handleCanvasDoubleClickCapture;
     openInlineTipTapFromEvent(e: Event): Promise<void>;
     private hasInlineTipTapElement;
+    /**
+     * Writes any active inline TipTap editor back to the live DOM synchronously.
+     * Used before localStorage persistence and before the builder unmounts.
+     */
+    private commitActiveInlineTipTapEditorSync;
+    /**
+     * Commits open inline editors and persists the current canvas to localStorage.
+     * Call before destroying the PageBuilder component (e.g. modal v-if close).
+     */
+    flushPendingEditsToLocalStorage(): void;
     finishActiveInlineTipTapEditorFromDom(nextElement?: HTMLElement | null): Promise<void>;
     /**
      * Handles the click event for editable elements, setting the element as selected.
@@ -907,6 +947,12 @@ export declare class PageBuilderService {
      * Call this after programmatically inserting elements into the builder canvas.
      */
     refreshListeners(): Promise<void>;
+    /**
+     * Applies config-provided pageSettings.style to #pagebuilder when the element
+     * has no inline style attribute.  Safe to call on every canvas refresh because
+     * the guard `!domStyle` means user-edited styles are never overwritten.
+     */
+    private reapplyConfigPageSettingsIfMissing;
     /**
      * Resumes editing from a draft saved in local storage.
      * @returns {Promise<void>}
@@ -997,6 +1043,7 @@ export declare class PageBuilderService {
      * @private
      */
     private convertStyleObjectToString;
+    private hasMeaningfulPageSettings;
     /**
      * Parses a string of HTML and extracts builder components and global page settings.
      * - This method expects an **HTML string** containing one or more `<section>...</section>` elements (such as the output from `getSavedPageHtml()` or a previously saved builder HTML string).
@@ -1155,6 +1202,8 @@ export declare interface PageSettings {
     [key: string]: unknown;
 }
 
+declare type ProductButtonStyle = 'text' | 'button' | (string & {});
+
 export declare type ProductCardStyle = 'minimal' | 'bordered' | 'shadow' | 'elevated' | (string & {});
 
 export declare type ProductGridLayout = 'grid-1' | 'grid-2' | 'grid-3' | 'grid-4' | 'grid-6' | (string & {});
@@ -1167,6 +1216,10 @@ export declare interface ProductSectionOptions {
     cardStyle?: ProductCardStyle;
     roundedImages?: boolean;
     openInNewTab?: boolean;
+    /** Product CTA appearance: plain text link or button style */
+    buttonStyle?: ProductButtonStyle;
+    /** Applies rounded/full corners when CTA button style is enabled */
+    roundedButtons?: boolean;
     /** Hides price and compare-at price when product data includes them */
     hidePrice?: boolean;
     /** Hides product photos when product data includes images */