@useinsider/guido 1.4.4 → 2.0.0-beta.087a24f

package/dist/src/@types/config/validator.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Guido Configuration Validator
+ *
+ * Utilities for validating and parsing Guido configuration.
+ * Provides both throwing and non-throwing validation methods.
+ * @module @types/config/validator
+ */
+import type { GuidoConfig, GuidoConfigInput } from './types';
+/**
+ * Result of config validation
+ */
+export interface ValidationResult {
+    /** Whether validation was successful */
+    success: boolean;
+    /** Validated and transformed config (only if success) */
+    data?: GuidoConfig;
+    /** Validation error messages (only if failed) */
+    errors?: string[];
+}
+/**
+ * Formatted validation error with path and message
+ */
+export interface ValidationError {
+    /** Dot-notation path to the invalid field */
+    path: string;
+    /** Error message */
+    message: string;
+}
+/**
+ * Validates configuration input and returns a result object.
+ *
+ * Use this for non-throwing validation where you want to handle errors yourself.
+ * @example
+ * ```typescript
+ * const result = validateConfig({
+ *   identity: { templateId: 'tpl-1', userId: 'usr-1' },
+ *   partner: { name: 'acme-corp' },
+ * });
+ *
+ * if (result.success) {
+ *   console.log(result.data); // Full GuidoConfig with defaults
+ * } else {
+ *   console.error(result.errors); // ['[identity.templateId] templateId is required']
+ * }
+ * ```
+ * @param input - Raw configuration input
+ * @returns Validation result with success status and data or errors
+ */
+export declare function validateConfig(input: GuidoConfigInput): ValidationResult;
+/**
+ * Validates configuration and throws on error.
+ *
+ * Use this during component initialization where invalid config should halt execution.
+ * @example
+ * ```typescript
+ * try {
+ *   const config = parseConfig({
+ *     identity: { templateId: 'tpl-1', userId: 'usr-1' },
+ *     partner: { name: 'acme-corp' },
+ *   });
+ *   // config is fully typed GuidoConfig
+ * } catch (error) {
+ *   console.error('Invalid configuration:', error.message);
+ * }
+ * ```
+ * @param input - Raw configuration input
+ * @returns Validated GuidoConfig with all defaults applied
+ */
+export declare function parseConfig(input: GuidoConfigInput): GuidoConfig;
+/**
+ * Validates configuration with console warnings (non-throwing).
+ *
+ * Use this when you want to attempt recovery from invalid config.
+ * Returns null on failure instead of throwing.
+ * @example
+ * ```typescript
+ * const config = parseConfigSafe(userInput);
+ * if (!config) {
+ *   // Use fallback configuration
+ *   return defaultConfig;
+ * }
+ * ```
+ * @param input - Raw configuration input
+ * @returns Validated GuidoConfig or null if validation fails
+ */
+export declare function parseConfigSafe(input: GuidoConfigInput): GuidoConfig | null;
+/**
+ * Get structured validation errors for detailed error handling.
+ * @example
+ * ```typescript
+ * const errors = getValidationErrors(input);
+ * errors.forEach(({ path, message }) => {
+ *   formErrors[path] = message;
+ * });
+ * ```
+ * @param input - Raw configuration input
+ * @returns Array of validation errors with paths, or empty array if valid
+ */
+export declare function getValidationErrors(input: GuidoConfigInput): ValidationError[];
+/**
+ * Check if a configuration input is valid without parsing.
+ * @example
+ * ```typescript
+ * if (isValidConfig(userInput)) {
+ *   saveConfig(userInput);
+ * }
+ * ```
+ * @param input - Raw configuration input
+ * @returns True if valid, false otherwise
+ */
+export declare function isValidConfig(input: unknown): input is GuidoConfigInput;
+/**
+ * Validate just the identity section
+ */
+export declare function validateIdentity(input: unknown): ValidationResult;
+/**
+ * Validate just the partner section
+ */
+export declare function validatePartner(input: unknown): ValidationResult;

package/dist/src/@types/generic.d.ts

@@ -1,43 +1,7 @@
-import type { CompilerRule } from './html-compiler';
-type Extensions = {
-    unsubscribe?: boolean;
-};
-type Features = {
-    dynamicContent?: boolean;
-    saveAsTemplate?: boolean;
-    versionHistory?: boolean;
-    testMessage?: boolean;
-    displayConditions?: boolean;
-};
-type Partner = {
-    partnerName: string;
-    productType: number;
-    messageType: number;
-};
-export type GuidoBlockType = 'amp-accordion' | 'amp-carousel' | 'amp-form-controls' | 'banner-block' | 'button-block' | 'html-block' | 'image-block' | 'menu-block' | 'social-block' | 'spacer-block' | 'text-block' | 'timer-block' | 'video-block';
-export type GuidoCustomBlockType = 'dynamic-content' | 'checkbox-block' | 'radio-button-block' | 'recommendation-block' | 'unsubscribe-block' | 'coupon-block' | 'items-block';
-type BlocksConfig = {
-    excludeDefaults?: GuidoBlockType[];
-    includeCustoms?: GuidoCustomBlockType[];
-};
-export type GuidoConfig = {
-    translationsPath: string;
-    htmlCompilerRules?: CompilerRule[];
-    ignoreDefaultHtmlCompilerRules?: boolean;
-    useHeader?: boolean;
-    emailHeader: EmailHeader;
-    migrationDate: number;
-    partner?: Partner;
-    extensions?: Extensions;
-    features?: Features;
-    blocks?: BlocksConfig;
-    backButtonLabel?: string;
-};
-export type TemplateConfig = {
-    preselectedDynamicContentList?: DynamicContent[];
-    selectedUnsubscribePages?: number[];
-    variationId?: string;
-};
+/**
+ * Generic types used throughout the application.
+ * Note: Configuration types are now in @types/config/
+ */
 export type BaseDynamicContent = {
     value: string;
     fallback?: string;
@@ -71,10 +35,6 @@ export type MergeTagClickEvent = {
     tagValue: string | null;
     tagLabel: string | null;
 };
-export interface EmailHeader {
-    senderName: string;
-    subject: string;
-}
 export interface TooltipOptions {
     id: string;
     dynamicPosition: boolean;
@@ -95,4 +55,3 @@ export interface L10n {
     timezone?: string;
     time?: number;
 }
-export {};

package/dist/src/components/Guido.vue.d.ts

@@ -1,16 +1,9 @@
-import type { DynamicContent, GuidoConfig, PositionData, TemplateConfig } from '@@/Types/generic';
+import type { DynamicContent, GuidoConfigInput } from '@@/Types/config';
+import type { PositionData } from '@@/Types/generic';
 import type { SavedTemplateDetails } from '@@/Types/stripo';
 type __VLS_Props = {
-    templateId: string;
-    userId: string;
-    messageType?: number;
-    partnerName?: string;
-    productType?: number;
-    username?: string;
-    html?: string;
-    css?: string;
-    guidoConfig: GuidoConfig;
-    templateConfig?: TemplateConfig;
+    /** Guido configuration object */
+    config: GuidoConfigInput;
 };
 declare const _default: import("vue").DefineComponent<__VLS_TypePropsToOption<__VLS_Props>, {
     dynamicContent: {
@@ -20,7 +13,15 @@ declare const _default: import("vue").DefineComponent<__VLS_TypePropsToOption<__
     hasChanges: import("vue").ComputedRef<boolean>;
     saveSilent: () => Promise<SavedTemplateDetails | undefined> | undefined;
 }, {}, {}, {}, import("vue/types/v3-component-options.js").ComponentOptionsMixin, import("vue/types/v3-component-options.js").ComponentOptionsMixin, {
-    "dynamic-content:open": (detail: DynamicContent | null, position?: PositionData | undefined) => void;
+    "dynamic-content:open": (detail: {
+        text: string;
+        value: string;
+        fallback?: string | undefined;
+        format?: {
+            key: string;
+            value: string;
+        } | undefined;
+    } | null, position?: PositionData | undefined) => void;
     back: () => void;
     "save:start": () => void;
     "save:complete": (data: Omit<SavedTemplateDetails, "forceRecreate">) => void;

package/dist/src/components/wrappers/WpModal.vue.d.ts

@@ -32,8 +32,8 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_WithDefaults<
     closeOnOutsideClick: boolean;
     footerStatus: boolean;
 }>>>, {
-    size: "small" | "medium" | "large";
     description: string;
+    size: "small" | "medium" | "large";
     closeOnOutsideClick: boolean;
     footerButtonOptions: FooterButtonGroup;
     closeButtonStatus: boolean;

package/dist/src/composables/useActionsApi.d.ts

@@ -5,4 +5,6 @@ export declare const useActionsApi: () => {
     getTemplateData: () => Promise<TemplateData>;
     activateCustomViewStyles: (isActive?: boolean) => void;
     getPreviewData: (options?: CompileEmailOptions) => Promise<CompiledEmailResult>;
+    updateTimerInClonedTemplate: () => Promise<string | null>;
+    updateHtmlAndCss: (html: string, css: string) => void;
 };

package/dist/src/composables/useConfig.d.ts

@@ -1,4 +1,188 @@
-import type { GuidoConfig } from '@@/Types/generic';
+import type { GuidoConfig, FeaturesConfig } from '@@/Types/config';
+/**
+ * Composable for accessing Guido configuration
+ *
+ * Provides access to the validated configuration from the config store.
+ * All values are reactive and will update when the config changes.
+ */
 export declare const useConfig: () => {
-    config: GuidoConfig;
+    config: import("vue").Ref<{
+        identity: {
+            templateId: string;
+            userId: string;
+            variationId?: string | undefined;
+        };
+        partner: {
+            name: string;
+            productType: 60 | 49 | 97;
+            messageType: 1 | 2;
+            username: string;
+        };
+        template: {
+            html: string;
+            css: string;
+            preselectedDynamicContent: {
+                text: string;
+                value: string;
+                fallback?: string | undefined;
+                format?: {
+                    key: string;
+                    value: string;
+                } | undefined;
+            }[];
+            selectedUnsubscribePages: number[];
+        };
+        editor: {
+            locale: string;
+            translationsPath: string;
+            migrationDate: number;
+            emailHeader: {
+                senderName: string;
+                subject: string;
+            };
+        };
+        ui: {
+            showHeader: boolean;
+            backButtonLabel?: string | undefined;
+        };
+        features: {
+            dynamicContent: boolean;
+            saveAsTemplate: boolean;
+            versionHistory: boolean;
+            testMessage: boolean;
+            displayConditions: boolean;
+            unsubscribe: boolean;
+            modulesDisabled: boolean;
+        };
+        blocks: {
+            excludeDefaults: ("amp-accordion" | "amp-carousel" | "amp-form-controls" | "banner-block" | "button-block" | "html-block" | "image-block" | "menu-block" | "social-block" | "spacer-block" | "text-block" | "timer-block" | "video-block")[];
+            includeCustoms: ("dynamic-content" | "checkbox-block" | "radio-button-block" | "recommendation-block" | "unsubscribe-block" | "coupon-block" | "items-block")[];
+        };
+        compiler: {
+            customRules: ({
+                type: "replace";
+                search: string;
+                replacement: string;
+                replaceAll?: boolean | undefined;
+                id: string;
+                description?: string | undefined;
+                priority: number;
+            } | {
+                type: "regex";
+                pattern: string;
+                replacement: string;
+                flags?: string | undefined;
+                id: string;
+                description?: string | undefined;
+                priority: number;
+            } | {
+                type: "remove";
+                targets: string[];
+                id: string;
+                description?: string | undefined;
+                priority: number;
+            } | {
+                type: "custom";
+                processor: (html: string) => string;
+                id: string;
+                description?: string | undefined;
+                priority: number;
+            })[];
+            ignoreDefaultRules: boolean;
+        };
+    } | null>;
+    initialized: import("vue").Ref<boolean>;
+    identity: import("vue").ComputedRef<{
+        templateId: string;
+        userId: string;
+        variationId?: string | undefined;
+    } | null>;
+    partner: import("vue").ComputedRef<{
+        name: string;
+        productType: 60 | 49 | 97;
+        messageType: 1 | 2;
+        username: string;
+    } | null>;
+    template: import("vue").ComputedRef<{
+        html: string;
+        css: string;
+        preselectedDynamicContent: {
+            text: string;
+            value: string;
+            fallback?: string | undefined;
+            format?: {
+                key: string;
+                value: string;
+            } | undefined;
+        }[];
+        selectedUnsubscribePages: number[];
+    } | null>;
+    editor: import("vue").ComputedRef<{
+        locale: string;
+        translationsPath: string;
+        migrationDate: number;
+        emailHeader: {
+            senderName: string;
+            subject: string;
+        };
+    } | null>;
+    ui: import("vue").ComputedRef<{
+        showHeader: boolean;
+        backButtonLabel?: string | undefined;
+    } | null>;
+    features: import("vue").ComputedRef<{
+        dynamicContent: boolean;
+        saveAsTemplate: boolean;
+        versionHistory: boolean;
+        testMessage: boolean;
+        displayConditions: boolean;
+        unsubscribe: boolean;
+        modulesDisabled: boolean;
+    } | null>;
+    blocks: import("vue").ComputedRef<{
+        excludeDefaults: ("amp-accordion" | "amp-carousel" | "amp-form-controls" | "banner-block" | "button-block" | "html-block" | "image-block" | "menu-block" | "social-block" | "spacer-block" | "text-block" | "timer-block" | "video-block")[];
+        includeCustoms: ("dynamic-content" | "checkbox-block" | "radio-button-block" | "recommendation-block" | "unsubscribe-block" | "coupon-block" | "items-block")[];
+    } | null>;
+    compiler: import("vue").ComputedRef<{
+        customRules: ({
+            type: "replace";
+            search: string;
+            replacement: string;
+            replaceAll?: boolean | undefined;
+            id: string;
+            description?: string | undefined;
+            priority: number;
+        } | {
+            type: "regex";
+            pattern: string;
+            replacement: string;
+            flags?: string | undefined;
+            id: string;
+            description?: string | undefined;
+            priority: number;
+        } | {
+            type: "remove";
+            targets: string[];
+            id: string;
+            description?: string | undefined;
+            priority: number;
+        } | {
+            type: "custom";
+            processor: (html: string) => string;
+            id: string;
+            description?: string | undefined;
+            priority: number;
+        })[];
+        ignoreDefaultRules: boolean;
+    } | null>;
+    templateId: import("vue").ComputedRef<string>;
+    userId: import("vue").ComputedRef<string>;
+    variationId: import("vue").ComputedRef<string>;
+    partnerName: import("vue").ComputedRef<string>;
+    productType: import("vue").ComputedRef<number>;
+    messageType: import("vue").ComputedRef<number>;
+    username: import("vue").ComputedRef<string>;
+    showHeader: import("vue").ComputedRef<boolean>;
+    getConfig: () => GuidoConfig | null;
+    isFeatureEnabled: (feature: keyof FeaturesConfig) => boolean;
 };

package/dist/src/composables/usePartner.d.ts

@@ -1,5 +1,13 @@
+/**
+ * Composable for accessing partner information
+ *
+ * Provides access to partner data from the config store,
+ * with fallbacks to URL-based detection for backward compatibility.
+ */
 export declare const usePartner: () => {
     getPartnerName: () => string;
     getProductType: () => number;
+    getMessageType: () => number;
+    getUsername: () => string;
     isTestPartner: () => boolean;
 };

package/dist/src/composables/useTimerClone.d.ts

@@ -0,0 +1,6 @@
+export declare const useTimerClone: () => {
+    hasTimerBlocks: (html: string) => boolean;
+    cloneTimersInHtml: (html: string, authToken: string) => Promise<string | null>;
+    cloneTimersOnSave: (html: string) => Promise<string>;
+    updateTimersOnLoad: (getTokenFn: () => Promise<string>) => Promise<void>;
+};

package/dist/src/config/migrator/itemsBlockMigrator.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Migrates legacy ItemsBlock templates to v2 format
+ * @param html - HTML string containing legacy items blocks
+ * @returns Migrated HTML with replaced variables and cleaned conditionals
+ */
+export declare function migrateItemsBlock(html: string): string;

package/dist/src/enums/defaults.d.ts

@@ -1,12 +1,11 @@
-import type { GuidoConfig } from '@@/Types/generic';
-export declare const DefaultGuidoConfig: GuidoConfig;
+/**
+ * Default values and constants.
+ * Note: Configuration defaults are now in @types/config/defaults.ts
+ */
 export declare const TemplateTypes: {
     promotional: number;
     transactional: number;
 };
-export declare const DefaultProductType = "email";
-export declare const DefaultUsername = "Guido User";
-export declare const DefaultMessageType: number;
 export declare const EditorType: number;
+export declare const MAX_DEFAULT_TEMPLATE_ID = 13;
 export declare const ProductIds: Record<string, number>;
-export declare const TEST_PARTNER_LIST: string[];

package/dist/src/enums/unsubscribe.d.ts

@@ -29,7 +29,11 @@ export declare const PAGE_TYPES: {
 export declare const TYPE_COLLECTIONS: {
     [x: number]: number[];
 };
-export declare const TYPE_TRANSLATIONS: {
+/**
+ * Get type translations lazily to avoid Pinia initialization issues.
+ * Must be called within a Vue component context or after Pinia is initialized.
+ */
+export declare const getTypeTranslations: () => {
     [x: number]: string;
 };
 export declare const MERGE_TAGS: {

package/dist/src/extensions/Blocks/Items/controls/price/priceOrientation.d.ts

@@ -9,7 +9,7 @@ export declare class PriceOrientationControl extends CommonControl {
     onRender(): void;
     onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
     _onPriceOrientationChange(value: string): void;
-    private _updateHorizontalLayout;
     private _updateVerticalLayout;
+    private _updateHorizontalLayout;
     _getPriceOrientation(): string;
 }

package/dist/src/extensions/Blocks/Items/controls/settingsControl.d.ts

@@ -31,10 +31,6 @@ export declare class ItemsBlockControl extends CommonControl {
     _updatePrice(price: string): void;
     _updateOriginalPrice(originalPrice: string): void;
     _updateQuantity(quantity: string): void;
-    /**
-     * @todo Optimize template reordering for performance.
-     * @description Reorders the template structure based on current orientation and visibility settings.
-     */
     _reOrderTemplate(): void;
     _updateDataTypeAttributes(itemsType: ProductType): void;
     _updateDataNumberAttributes(itemId: string): void;

package/dist/src/extensions/Blocks/Items/template.d.ts

@@ -1,6 +1,8 @@
+import type { ItemsBlockConfig } from './utils/nodeConfigUtils';
 declare const migrationTemplate = "ADD YOUR MIGRATION HERE";
 type ProductType = 'CART_ITEMS' | 'BROWSED_ITEMS' | 'PURCHASED_ITEMS';
 type OrientationType = 'vertical' | 'horizontal';
+type PriceOrientationType = 'vertical' | 'horizontal';
 type TemplateParameters = {
     orientation: OrientationType;
     itemsType: ProductType;
@@ -8,6 +10,23 @@ type TemplateParameters = {
     currencySymbol?: string;
     currencyLocation?: string;
     formattedPrice?: boolean;
+    migrate?: boolean;
+    /** Legacy config format (data-* attributes from esd-config-block) */
+    configBlockAttributes?: Record<string, string>;
+    /** New config format (Stripo V2 nodeConfig from esd-ext-config) */
+    nodeConfig?: Partial<ItemsBlockConfig>;
+    /** Extracted styles from a[product-attr="name"] for migration */
+    nameStyles?: string;
+    /** Extracted styles from a.es-button for migration */
+    buttonStyles?: string;
+    /** Extracted styles from p[product-attr="price"] for migration */
+    priceStyles?: string;
+    /** Extracted styles from p[product-attr="originalPrice"] for migration */
+    originalPriceStyles?: string;
+    /** Extracted styles from p[product-attr="quantity"] for migration */
+    quantityStyles?: string;
+    /** Price orientation within the card ('vertical' = stacked, 'horizontal' = side-by-side) */
+    priceOrientation?: PriceOrientationType;
 };
 /**
  * Generates the default template for the Items Block.
@@ -20,5 +39,5 @@ type TemplateParameters = {
  * @param params.formattedPrice - Whether to use formatted price display
  * @returns HTML template string for the Items Block
  */
-export declare function getDefaultTemplate({ orientation, itemsType, itemId, currencySymbol, currencyLocation, formattedPrice, }: TemplateParameters): string;
+export declare function getDefaultTemplate({ orientation, itemsType, itemId, currencySymbol, currencyLocation, migrate, formattedPrice, configBlockAttributes, nodeConfig, nameStyles, buttonStyles, priceStyles, originalPriceStyles, quantityStyles, priceOrientation, }: TemplateParameters): string;
 export default migrationTemplate;

package/dist/src/extensions/Blocks/Items/utils/nodeConfigUtils.d.ts

@@ -0,0 +1,71 @@
+import { OrientationType, ProductType } from '@@/Types/extensions/items';
+import { ImmutableHtmlNode, ImmutableHtmlElementNode, ControlApi, BlockApi } from '@stripoinc/ui-editor-extensions';
+/**
+ * Typed configuration object for Items Block.
+ * Replaces the deprecated esd-config-block data-* attributes approach.
+ * Configuration is stored directly on the block node using Stripo V2's getNodeConfig/setNodeConfig API.
+ */
+export interface ItemsBlockConfig {
+    initialized: boolean;
+    blockInstanceId: string;
+    source: ProductType;
+    type: ProductType;
+    itemsSelectValue: string;
+    orientation: OrientationType;
+    nameTrimming: boolean;
+    nameControlEnabled: boolean;
+    priceHideDiscount: boolean;
+    priceFormatted: boolean;
+    priceCurrencySymbol: string;
+    priceCurrencyLocation: string;
+    priceControlOpened: boolean;
+    priceOrientation: 'vertical' | 'horizontal';
+    quantityControlEnabled: boolean;
+    buttonLink: string;
+    imageLink: string;
+    buttonLabel: string;
+    imageVisible: boolean;
+    nameVisible: boolean;
+    quantityVisible: boolean;
+    priceVisible: boolean;
+    originalPriceVisible: boolean;
+    buttonVisible: boolean;
+}
+/**
+ * Generates a unique block instance ID.
+ */
+export declare function generateBlockInstanceId(): string;
+/**
+ * Returns default ItemsBlockConfig values.
+ * These are used when initializing a new block or when migrating from legacy format.
+ */
+export declare function getDefaultItemsBlockConfig(): ItemsBlockConfig;
+/**
+ * Gets the Items block container element from the current node.
+ * The container is identified by the `.items-block-v2` class (new) or `.esd-cart-items-block` (legacy).
+ * @param currentNode - The current node from the control (usually this.currentNode)
+ * @returns The container element or null if not found
+ */
+export declare function getItemsBlockContainer(currentNode: ImmutableHtmlNode | undefined): ImmutableHtmlElementNode | null;
+/**
+ * Gets the node configuration from the Items block.
+ * Uses Stripo V2's getNodeConfig() API.
+ * Falls back to migrating from legacy esd-config-block if nodeConfig is empty.
+ * @param currentNode - The current node from the control
+ * @returns The ItemsBlockConfig object or null if not found
+ */
+export declare function getItemsBlockConfig(currentNode: ImmutableHtmlNode | undefined): ItemsBlockConfig | null;
+/**
+ * Sets the node configuration on the Items block.
+ * Uses Stripo V2's setNodeConfig() API.
+ * @param currentNode - The current node from the control
+ * @param api - The API object (ControlApi or BlockApi)
+ * @param config - The configuration to set (partial update supported)
+ */
+export declare function setItemsBlockConfig(currentNode: ImmutableHtmlNode | undefined, api: ControlApi | BlockApi, config: Partial<ItemsBlockConfig>): void;
+/**
+ * Gets the block instance ID from the node config.
+ * @param currentNode - The current node from the control
+ * @returns The block instance ID or null if not found
+ */
+export declare function getBlockInstanceIdFromConfig(currentNode: ImmutableHtmlNode | undefined): string | null;

package/dist/src/extensions/Blocks/common-control.d.ts

@@ -56,25 +56,30 @@ export declare abstract class CommonControl extends Control {
     onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
     onDestroy(): void;
     /**
-     * Gets the config block element from the current node.
+     * Gets the Items block container element from the current node.
+     * @returns The container element or null if not found
+     */
+    protected getItemsBlockContainer(): ImmutableHtmlElementNode | null;
+    /**
+     * Gets the config block element from the current node (legacy support).
+     * @deprecated Use getNodeConfig() from nodeConfigUtils instead for Stripo V2
      * @returns The config block element or null if not found
      */
     protected getConfigBlock(): ImmutableHtmlElementNode | null;
     /**
-     * Gets the current block instance ID from the config block.
-     * @param blockInstanceIdAttribute - The attribute name for block instance ID (default: 'data-block-instance-id')
+     * Gets the current block instance ID from the node config (Stripo V2) or legacy config block.
      * @returns The block instance ID or null if not found
      */
-    protected getBlockInstanceId(blockInstanceIdAttribute?: string): string | null;
+    protected getBlockInstanceId(): string | null;
     /**
      * Handles block instance change detection and syncing.
-     * This is a helper method for controls that need to sync attributes when switching between block instances.
-     * @param syncFunction - Function to call when block instance changes (to sync from attributes)
+     * This is a helper method for controls that need to sync config when switching between block instances.
+     * Uses Stripo V2 nodeConfig API for block instance tracking.
+     * @param syncFunction - Function to call when block instance changes (to sync from node config)
      * @param updateUI - Function to call to update the UI (called both on change and when same block)
-     * @param blockInstanceIdAttribute - The attribute name for block instance ID (default: 'data-block-instance-id')
      * @returns true if block instance changed, false otherwise
      */
-    protected handleBlockInstanceChange(syncFunction: (node: ImmutableHtmlNode) => void, updateUI: () => void, blockInstanceIdAttribute?: string): boolean;
+    protected handleBlockInstanceChange(syncFunction: (node: ImmutableHtmlNode) => void, updateUI: () => void): boolean;
     _GuLabel({ text, name, position }: LabelProps): string;
     _GuToggle(name: string): string;
     _GuSelectItem({ text, value }: {