@useinsider/guido 2.0.0 → 2.1.0-beta.e6bf76b

package/dist/src/extensions/Blocks/Items/store/items-block.d.ts

@@ -10,6 +10,7 @@ interface ItemsBlockState {
     currencySymbol: string;
     currencyLocation: string;
     formattedPrice: boolean;
+    singlePrice: boolean;
     priceOrientation: 'vertical' | 'horizontal';
     templateData: {
         imageSrc: string;
@@ -31,6 +32,7 @@ export declare const useItemsBlockStore: import("pinia").StoreDefinition<"guidoI
     setCurrencySymbol(currencySymbol: string): void;
     setCurrencyLocation(currencyLocation: string): void;
     setFormattedPrice(formattedPrice: boolean): void;
+    setSinglePrice(singlePrice: boolean): void;
     setPriceOrientation(priceOrientation: "vertical" | "horizontal"): void;
     setTemplateData(templateData: ItemsBlockState["templateData"]): void;
     updateFromAttributes(attributes: {

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,25 @@ type TemplateParameters = {
     currencySymbol?: string;
     currencyLocation?: string;
     formattedPrice?: boolean;
+    /** Whether to show single product price (price divided by quantity) */
+    singlePrice?: boolean;
+    migrate?: boolean;
+    /** Legacy config format (data-* attributes for migration) */
+    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 +41,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,76 @@
+import { OrientationType, ProductType } from '@@/Types/extensions/items';
+import { ImmutableHtmlNode, ImmutableHtmlElementNode, ControlApi, BlockApi } from '@stripoinc/ui-editor-extensions';
+/**
+ * Typed configuration object for Items Block.
+ * 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;
+    priceHideDiscount: boolean;
+    priceFormatted: boolean;
+    priceSinglePrice: boolean;
+    priceCurrencySymbol: string;
+    priceCurrencyLocation: string;
+    priceOrientation: 'vertical' | 'horizontal';
+    quantityControlEnabled: boolean;
+    buttonLink: string;
+    imageLink: string;
+    buttonLabel: string;
+    /** Whether button should be full width (true = es-fw class) or inline (false = es-il class) */
+    buttonFullWidth: boolean;
+    imageVisible: boolean;
+    nameVisible: boolean;
+    quantityVisible: boolean;
+    priceVisible: boolean;
+    originalPriceVisible: boolean;
+    buttonVisible: boolean;
+}
+/**
+ * Generates a unique block instance ID.
+ */
+export declare function generateBlockInstanceId(): string;
+/**
+ * Escapes $ characters in a string for safe use in String.replace/replaceAll.
+ * Prevents currency symbols like "$", "R$", "HK$" from being interpreted as special replacement patterns.
+ */
+export declare const escapeReplacement: (str: string) => 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 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,26 +56,25 @@ export declare abstract class CommonControl extends Control {
     onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
     onDestroy(): void;
     /**
-     * Gets the config block element from the current node.
-     * @returns The config block element or null if not found
+     * Gets the Items block container element from the current node.
+     * @returns The container element or null if not found
      */
-    protected getConfigBlock(): ImmutableHtmlElementNode | null;
+    protected getItemsBlockContainer(): 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).
      * @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;
-    _GuLabel({ text, name, position }: LabelProps): string;
+    protected handleBlockInstanceChange(syncFunction: (node: ImmutableHtmlNode) => void, updateUI: () => void): boolean;
+    _GuLabel({ text, name }: LabelProps): string;
     _GuToggle(name: string): string;
     _GuSelectItem({ text, value }: {
         text: string;

package/dist/src/extensions/Blocks/controlFactories.d.ts

@@ -12,8 +12,9 @@
 import { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
 /**
  * Factory function to create text align controls for different block elements
+ * When targetBlockId and containerSelector are not provided, applies directly to root
  */
-export declare function createTextAlignControl(controlId: string, targetBlockId: string, containerSelector: string): {
+export declare function createTextAlignControl(controlId: string, targetBlockId?: string, containerSelector?: string): {
     new (): {
         getId(): string;
         getTargetNodes(root: ImmutableHtmlNode): ImmutableHtmlNode[];
@@ -27,8 +28,9 @@ export declare function createTextAlignControl(controlId: string, targetBlockId:
 };
 /**
  * Factory function to create text color controls for different block elements
+ * When targetBlockId and containerSelector are not provided, applies directly to root
  */
-export declare function createTextColorControl(controlId: string, targetBlockId: string, containerSelector?: string): {
+export declare function createTextColorControl(controlId: string, targetBlockId?: string, containerSelector?: string): {
     new (): {
         getId(): string;
         getTargetNodes(root: ImmutableHtmlNode): ImmutableHtmlNode[];
@@ -42,8 +44,9 @@ export declare function createTextColorControl(controlId: string, targetBlockId:
 };
 /**
  * Factory function to create text size controls for different block elements
+ * When targetBlockId and containerSelector are not provided, applies directly to root
  */
-export declare function createTextSizeControl(controlId: string, targetBlockId: string, containerSelector?: string): {
+export declare function createTextSizeControl(controlId: string, targetBlockId?: string, containerSelector?: string): {
     new (): {
         getId(): string;
         getTargetNodes(root: ImmutableHtmlNode): ImmutableHtmlNode[];
@@ -57,8 +60,9 @@ export declare function createTextSizeControl(controlId: string, targetBlockId:
 };
 /**
  * Factory function to create text style controls for different block elements
+ * When targetBlockId and containerSelector are not provided, applies directly to root
  */
-export declare function createTextStyleControl(controlId: string, targetBlockId: string, containerSelector?: string): {
+export declare function createTextStyleControl(controlId: string, targetBlockId?: string, containerSelector?: string): {
     new (): {
         getId(): string;
         getTargetNodes(root: ImmutableHtmlNode): ImmutableHtmlNode[];
@@ -72,8 +76,9 @@ export declare function createTextStyleControl(controlId: string, targetBlockId:
 };
 /**
  * Factory function to create text font family controls for different block elements
+ * When targetBlockId and containerSelector are not provided, applies directly to root
  */
-export declare function createTextFontFamilyControl(controlId: string, targetBlockId: string, containerSelector?: string): {
+export declare function createTextFontFamilyControl(controlId: string, targetBlockId?: string, containerSelector?: string): {
     new (): {
         getId(): string;
         getTargetNodes(root: ImmutableHtmlNode): ImmutableHtmlNode[];
@@ -87,8 +92,9 @@ export declare function createTextFontFamilyControl(controlId: string, targetBlo
 };
 /**
  * Factory function to create text background color controls for different block elements
+ * When targetBlockId and containerSelector are not provided, applies directly to root
  */
-export declare function createTextBackgroundColorControl(controlId: string, targetBlockId: string, containerSelector?: string): {
+export declare function createTextBackgroundColorControl(controlId: string, targetBlockId?: string, containerSelector?: string): {
     new (): {
         getId(): string;
         getTargetNodes(root: ImmutableHtmlNode): ImmutableHtmlNode[];
@@ -102,8 +108,25 @@ export declare function createTextBackgroundColorControl(controlId: string, targ
 };
 /**
  * Factory function to create paddings controls for different block elements
+ * When targetBlockId and containerSelector are not provided, applies directly to root
  */
-export declare function createPaddingsControl(controlId: string, targetBlockId: string, containerSelector?: string): {
+export declare function createPaddingsControl(controlId: string, targetBlockId?: string, containerSelector?: string): {
+    new (): {
+        getId(): string;
+        getTargetNodes(root: ImmutableHtmlNode): ImmutableHtmlNode[];
+        getParentControlId(): string;
+        api: import("@stripoinc/ui-editor-extensions").ControlApi;
+        getLabels(): import("@stripoinc/ui-editor-extensions").ControlLabels | undefined;
+        getModificationDescription(): import("@stripoinc/ui-editor-extensions").ModificationDescription | undefined;
+        getAdditionalModifications(_root: ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").TemplateModifier<import("@stripoinc/ui-editor-extensions").HtmlNodeModifier, import("@stripoinc/ui-editor-extensions").CssNodeModifier> | undefined;
+        isVisible(_node: ImmutableHtmlNode): boolean;
+    };
+};
+/**
+ * Factory function to create text line spacing controls for different block elements
+ * When targetBlockId and containerSelector are not provided, applies directly to root
+ */
+export declare function createTextLineSpacingControl(controlId: string, targetBlockId?: string, containerSelector?: string): {
     new (): {
         getId(): string;
         getTargetNodes(root: ImmutableHtmlNode): ImmutableHtmlNode[];