@useinsider/guido 3.15.0 → 3.16.0-beta.0faee0c

package/dist/public/trackingIds.js

@@ -0,0 +1,8 @@
+import { TRACK_ID_ATTRIBUTE as a, TRACK_SEQ_ATTRIBUTE as e, assignTrackingIds as o, readTrackFloor as A, readTrackSeq as I } from "../utils/linkTrackingIds.js";
+export {
+  a as TRACK_ID_ATTRIBUTE,
+  e as TRACK_SEQ_ATTRIBUTE,
+  o as assignTrackingIds,
+  A as readTrackFloor,
+  I as readTrackSeq
+};

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

@@ -262,6 +262,14 @@ export declare const TemplateSchema: v.ObjectSchema<{
     readonly selectedUnsubscribePages: v.OptionalSchema<v.ArraySchema<v.NumberSchema<undefined>, undefined>, readonly []>;
     /** Force recreate template in Stripo storage (use true when updating externally modified templates) */
     readonly forceRecreate: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
+    /**
+     * Consumer-persisted tracking-id high-water mark (SD-141414). Used as the id floor
+     * during migration so a rolled-back document never re-mints retired tracking ids.
+     * Out-of-range numbers are coerced rather than rejected — this value arrives from
+     * stored partner data, and rejecting it would fail parseConfig and block the editor
+     * mount. Non-numbers still fail, like every other field in this schema.
+     */
+    readonly trackIdCounter: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.TransformAction<number, number>]>, 0>;
     /** Migration-only inputs (legacy block configs) */
     readonly migration: v.OptionalSchema<v.ObjectSchema<{
         /**
@@ -385,6 +393,8 @@ export declare const FeaturesSchema: v.ObjectSchema<{
     readonly autosave: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
     /** Enable pre-save domain-allowlist validation (opt-in; Guido self-serves the block toaster) */
     readonly allowlistEnabled: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
+    /** Enable persistent link tracking-id assignment for the click heatmap (opt-in) */
+    readonly linkTrackingIds: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
 }, undefined>;
 /**
  * Default block types available in Stripo
@@ -666,6 +676,14 @@ export declare const GuidoConfigSchema: v.ObjectSchema<{
         readonly selectedUnsubscribePages: v.OptionalSchema<v.ArraySchema<v.NumberSchema<undefined>, undefined>, readonly []>;
         /** Force recreate template in Stripo storage (use true when updating externally modified templates) */
         readonly forceRecreate: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
+        /**
+         * Consumer-persisted tracking-id high-water mark (SD-141414). Used as the id floor
+         * during migration so a rolled-back document never re-mints retired tracking ids.
+         * Out-of-range numbers are coerced rather than rejected — this value arrives from
+         * stored partner data, and rejecting it would fail parseConfig and block the editor
+         * mount. Non-numbers still fail, like every other field in this schema.
+         */
+        readonly trackIdCounter: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.TransformAction<number, number>]>, 0>;
         /** Migration-only inputs (legacy block configs) */
         readonly migration: v.OptionalSchema<v.ObjectSchema<{
             /**
@@ -774,6 +792,8 @@ export declare const GuidoConfigSchema: v.ObjectSchema<{
         readonly autosave: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
         /** Enable pre-save domain-allowlist validation (opt-in; Guido self-serves the block toaster) */
         readonly allowlistEnabled: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
+        /** Enable persistent link tracking-id assignment for the click heatmap (opt-in) */
+        readonly linkTrackingIds: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
     }, undefined>, {}>;
     /** Block configuration */
     readonly blocks: v.OptionalSchema<v.ObjectSchema<{

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

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

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

@@ -40,6 +40,7 @@ export declare const useConfig: () => {
             customFieldAttributes: string[];
             selectedUnsubscribePages: number[];
             forceRecreate: boolean;
+            trackIdCounter: number;
             migration: {
                 recommendationConfigs: {
                     [x: string]: {
@@ -97,6 +98,7 @@ export declare const useConfig: () => {
             liquidSyntax: boolean;
             autosave: boolean;
             allowlistEnabled: boolean;
+            linkTrackingIds: 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")[];
@@ -172,6 +174,7 @@ export declare const useConfig: () => {
         customFieldAttributes: string[];
         selectedUnsubscribePages: number[];
         forceRecreate: boolean;
+        trackIdCounter: number;
         migration: {
             recommendationConfigs: {
                 [x: string]: {
@@ -229,6 +232,7 @@ export declare const useConfig: () => {
         liquidSyntax: boolean;
         autosave: boolean;
         allowlistEnabled: boolean;
+        linkTrackingIds: 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")[];

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

@@ -14,8 +14,9 @@ export declare function parseRecommendationVariable(field: string): {
  * `{{recoId_index_attribute}}` variables: the built-in compiler attributes plus
  * each account attribute in its canonical token form — bare for
  * `defaultAttribute`, `product_attribute.<name>` for `productAttribute`. Using
- * `resolveProductAttrValue` (the same producer the block builder uses) keeps the
- * validator's notion of "valid form" identical to what is actually emitted.
+ * `filterToProductAttrValue` (the same producer the block builder uses) keeps the
+ * validator's notion of "valid form" identical to what is actually emitted, and
+ * admits both forms when a default and a custom attribute share a name.
  */
 export declare function buildPartnerAttributeNameSet(filterList: FiltersResponse): Set<string>;
 /**

package/dist/src/config/migrator/recommendation/types.d.ts

@@ -193,6 +193,7 @@ export type PerElementStyles = Record<string, MappedTextStyle | MappedButtonStyl
 export interface MappedComposition {
     composition: string[];
     visibility: Record<string, boolean>;
+    /** Canonical `product-attr` values, mirrored into `data-custom-attributes`. */
     customAttributes: string[];
     /** Mapping of customAttr key → full `product-attr` value. */
     customAttrValues: Record<string, string>;

package/dist/src/extensions/Blocks/Checkbox/constants/controlIds.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Control IDs used in the Checkbox Extension
+ * These IDs are returned by the getId() method of each control
+ */
+export declare enum CheckboxControlId {
+    BLOCK_BACKGROUND = "checkbox-block-background-color-control"
+}

package/dist/src/extensions/Blocks/Checkbox/constants/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Checkbox Extension Constants
+ *
+ * This module re-exports all constants for the Checkbox extension.
+ * Import from this file for cleaner imports.
+ * @example
+ * import { CheckboxControlId, BLOCK_ROOT_SELECTOR } from './constants';
+ */
+export { CheckboxControlId } from './controlIds';
+export { BLOCK_ROOT_SELECTOR, CSS_CLASS_CHECKBOX_BLOCK, CSS_CLASS_CHECKBOX_BLOCK_V2, } from './selectors';

package/dist/src/extensions/Blocks/Checkbox/constants/selectors.d.ts

@@ -0,0 +1,16 @@
+/**
+ * CSS selectors and class names used across the Checkbox extension
+ */
+/**
+ * Stable contract class present on BOTH legacy and v2 markup — the backend submit
+ * script selects by it. Renaming it silently breaks form submission.
+ */
+export declare const CSS_CLASS_CHECKBOX_BLOCK = "checkbox-block";
+/** Current block class — what the template emits and the migrator upgrades legacy blocks to. */
+export declare const CSS_CLASS_CHECKBOX_BLOCK_V2 = "checkbox-block-v2";
+/**
+ * Block root selector — the block `<td>` itself.
+ * Used across block-level controls so edits apply to the whole block, not the title cell.
+ * Derived from the class so a rename cannot half-land.
+ */
+export declare const BLOCK_ROOT_SELECTOR = ".checkbox-block-v2";

package/dist/src/extensions/Blocks/Checkbox/controls/blockBackground/index.d.ts

@@ -0,0 +1,14 @@
+export declare const CheckboxBlockBackgroundControl: {
+    new (): {
+        getId(): string;
+        getLabels(): {
+            title: string;
+        };
+        getTargetNodes(root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode[];
+        getAdditionalModifications(root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").TemplateModifier<import("@stripoinc/ui-editor-extensions").HtmlNodeModifier, import("@stripoinc/ui-editor-extensions").CssNodeModifier> | undefined;
+        getParentControlId(): string;
+        api: import("@stripoinc/ui-editor-extensions").ControlApi;
+        getModificationDescription(): import("@stripoinc/ui-editor-extensions").ModificationDescription | undefined;
+        isVisible(_node: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): boolean;
+    };
+};

package/dist/src/extensions/Blocks/RadioButton/constants/controlIds.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Control IDs used in the RadioButton Extension
+ * These IDs are returned by the getId() method of each control
+ */
+export declare enum RadioButtonControlId {
+    BLOCK_BACKGROUND = "radio-button-block-background-color-control"
+}

package/dist/src/extensions/Blocks/RadioButton/constants/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * RadioButton Extension Constants
+ *
+ * This module re-exports all constants for the RadioButton extension.
+ * Import from this file for cleaner imports.
+ * @example
+ * import { RadioButtonControlId, BLOCK_ROOT_SELECTOR } from './constants';
+ */
+export { RadioButtonControlId } from './controlIds';
+export { BLOCK_ROOT_SELECTOR, CSS_CLASS_RADIO_BUTTON_BLOCK, CSS_CLASS_RADIO_BUTTON_BLOCK_V2, } from './selectors';

package/dist/src/extensions/Blocks/RadioButton/constants/selectors.d.ts

@@ -0,0 +1,16 @@
+/**
+ * CSS selectors and class names used across the RadioButton extension
+ */
+/**
+ * Stable contract class present on BOTH legacy and v2 markup — the backend submit
+ * script selects by it. Renaming it silently breaks form submission.
+ */
+export declare const CSS_CLASS_RADIO_BUTTON_BLOCK = "radio-button-block";
+/** Current block class — what the template emits and the migrator upgrades legacy blocks to. */
+export declare const CSS_CLASS_RADIO_BUTTON_BLOCK_V2 = "radio-button-v2";
+/**
+ * Block root selector — the block `<td>` itself.
+ * Used across block-level controls so edits apply to the whole block, not the title cell.
+ * Derived from the class so a rename cannot half-land.
+ */
+export declare const BLOCK_ROOT_SELECTOR = ".radio-button-v2";

package/dist/src/extensions/Blocks/RadioButton/controls/blockBackground/index.d.ts

@@ -0,0 +1,14 @@
+export declare const RadioButtonBlockBackgroundControl: {
+    new (): {
+        getId(): string;
+        getLabels(): {
+            title: string;
+        };
+        getTargetNodes(root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode[];
+        getAdditionalModifications(root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").TemplateModifier<import("@stripoinc/ui-editor-extensions").HtmlNodeModifier, import("@stripoinc/ui-editor-extensions").CssNodeModifier> | undefined;
+        getParentControlId(): string;
+        api: import("@stripoinc/ui-editor-extensions").ControlApi;
+        getModificationDescription(): import("@stripoinc/ui-editor-extensions").ModificationDescription | undefined;
+        isVisible(_node: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): boolean;
+    };
+};

package/dist/src/extensions/Blocks/Recommendation/constants/index.d.ts

@@ -8,6 +8,6 @@
  */
 export { RecommendationBlockId } from './blockIds';
 export { RecommendationControlId } from './controlIds';
-export { BLOCK_ROOT_SELECTOR, CONTAINER_SELECTOR, DESKTOP_CONTAINER_SELECTOR, MOBILE_CONTAINER_SELECTOR, MOBILE_ROW_SELECTOR, CSS_CLASS_RECO_BUTTON, CSS_CLASS_SKIP_COMPILE, RECOMMENDATION_VARIABLE_BUILTIN_ATTRIBUTES, CURRENCY_ATTR, ATTR_PRODUCT_IMAGE, ATTR_PRODUCT_NAME, ATTR_PRODUCT_PRICE, ATTR_PRODUCT_OLD_PRICE, ATTR_PRODUCT_OMNIBUS_PRICE, ATTR_PRODUCT_OMNIBUS_DISCOUNT, ATTR_PRODUCT_BUTTON, ATTR_CUSTOM_PREFIX, ATTR_DATA_CUSTOM_ATTRIBUTES, ATTR_PRODUCT_ATTR, PRODUCT_ATTRIBUTE_PREFIX, BUILT_IN_DEFAULT_ATTRIBUTES, } from './selectors';
+export { BLOCK_ROOT_SELECTOR, CONTAINER_SELECTOR, DESKTOP_CONTAINER_SELECTOR, MOBILE_CONTAINER_SELECTOR, MOBILE_ROW_SELECTOR, CSS_CLASS_RECO_BUTTON, CSS_CLASS_SKIP_COMPILE, RECOMMENDATION_VARIABLE_BUILTIN_ATTRIBUTES, CURRENCY_ATTR, ATTR_PRODUCT_IMAGE, ATTR_PRODUCT_NAME, ATTR_PRODUCT_PRICE, ATTR_PRODUCT_OLD_PRICE, ATTR_PRODUCT_OMNIBUS_PRICE, ATTR_PRODUCT_OMNIBUS_DISCOUNT, ATTR_PRODUCT_BUTTON, ATTR_CUSTOM_PREFIX, ATTR_DATA_CARD_COMPOSITION, ATTR_DATA_CUSTOM_ATTRIBUTES, ATTR_PRODUCT_ATTR, SELECTOR_ATTRIBUTE_ROW, ATTR_DATA_ATTRIBUTE_TYPE, PRODUCT_ATTRIBUTE_PREFIX, BUILT_IN_DEFAULT_ATTRIBUTES, } from './selectors';
 export { LAYOUT_VALUES, LAYOUT_OPTIONS, DEFAULT_PRODUCTS_PER_ROW, DEFAULT_CARDS_IN_ROW, DEFAULT_MOBILE_CARDS_IN_ROW, MAX_PRODUCT_COUNT, MIN_PRODUCT_COUNT, MAX_PRODUCTS_PER_ROW, MIN_PRODUCTS_PER_ROW, MAX_MOBILE_PRODUCTS_PER_ROW, MIN_MOBILE_PRODUCTS_PER_ROW, DEFAULT_COLUMN_SPACING, DEFAULT_ROW_SPACING, DEFAULT_MOBILE_COLUMN_SPACING, DEFAULT_MOBILE_ROW_SPACING, MIN_SPACING, MAX_SPACING, SPACING_STEP, } from './layout';
 export { DEFAULT_NODE_CONFIG, DEFAULT_CURRENCY, DEFAULT_COMPOSITION, DEFAULT_VISIBILITY, CURRENT_CONFIG_VERSION, EXCLUDED_ALGORITHM_IDS, } from './defaultConfig';

package/dist/src/extensions/Blocks/Recommendation/constants/selectors.d.ts

@@ -66,8 +66,14 @@ export declare const ATTR_PRODUCT_BUTTON = "productButton";
 export declare const ATTR_CUSTOM_PREFIX = "customAttr:";
 /** HTML data attribute storing JSON array of added custom attribute names */
 export declare const ATTR_DATA_CUSTOM_ATTRIBUTES = "data-custom-attributes";
+/** HTML data attribute on the block root holding the comma-joined composition order */
+export declare const ATTR_DATA_CARD_COMPOSITION = "data-card-composition";
 /** HTML attribute on <td> elements identifying the product attribute for compiler template variable generation */
 export declare const ATTR_PRODUCT_ATTR = "product-attr";
+/** Row wrapper of one composition entry inside a product card */
+export declare const SELECTOR_ATTRIBUTE_ROW = ".recommendation-attribute-row";
+/** HTML attribute on an attribute row holding its composition key */
+export declare const ATTR_DATA_ATTRIBUTE_TYPE = "data-attribute-type";
 /** Prefix `resolveProductAttrValue` puts on custom (non-default) product attributes in `product-attr` values */
 export declare const PRODUCT_ATTRIBUTE_PREFIX = "product_attribute.";
 /**

package/dist/src/extensions/Blocks/Recommendation/controls/cardComposition/index.d.ts

@@ -29,6 +29,8 @@ export declare class RecommendationCardCompositionControl extends CommonControl
     private _initializeComposition;
     private _registerValueChangeListeners;
     private _readCompositionFromNode;
+    /** Upgrades legacy bare-name custom keys to the canonical form. (SD-147101) */
+    private _normalizeComposition;
     private _readCustomAttributesFromNode;
     private _readVisibilityFromRows;
     private _getDefaultVisibilities;
@@ -61,7 +63,15 @@ export declare class RecommendationCardCompositionControl extends CommonControl
     private _createPriceGroupItemHtml;
     private _createCustomItemHtml;
     /**
-     * Builds select options from the store's filterList.
+     * Dropdown label of an attribute. A partner can own a default and a custom
+     * attribute under the same name; the type is spelled out only then, so partners
+     * without a collision keep clean labels. (SD-147101)
+     */
+    private _toOptionLabel;
+    /**
+     * Builds select options from the store's filterList. Option values are
+     * `product-attr` values, so a default attribute and a same-named custom one
+     * never collapse onto a single option. (SD-147101)
      * Falls back to a single option for the currently selected attribute.
      */
     private _getSelectOptions;
@@ -144,6 +154,12 @@ export declare class RecommendationCardCompositionControl extends CommonControl
      */
     private _onCustomAttributeChanged;
     private _onReorder;
+    /**
+     * Outer HTML of an existing attribute row, rewritten to the canonical key when
+     * the row still carries a legacy bare-name one. Copying rows this way lets the
+     * DOM converge on the next composition change without writing on open.
+     */
+    private _getExistingRowHtml;
     private _injectCustomAttributeHtml;
     private _injectGridAttributeRow;
     private _injectListAttributeRow;
@@ -204,13 +220,19 @@ export declare class RecommendationCardCompositionControl extends CommonControl
      */
     private _subscribeToStoreChanges;
     /**
-     * Returns filters eligible for the custom attribute dropdown,
-     * excluding default attributes already covered by built-in toggle items.
+     * Returns filters eligible for the custom attribute dropdown, excluding default
+     * attributes already covered by built-in toggle items.
+     *
+     * Deduped by canonical value: a partner can own two backend rows of the same type
+     * and name (e.g. two `defaultAttribute` "discount"), which are indistinguishable
+     * once reduced to a `product-attr`. Left in, they render as identical options and
+     * skew the collision count that decides the (Default)/(Custom) suffix. (SD-147101)
      */
     private _getAddableFilters;
     /**
-     * Looks up the display name for an attribute from the store's filterList.
-     * Falls back to Title Case conversion of the snake_case attribute name.
+     * Looks up the display name for a `product-attr` value from the store's filterList.
+     * Matches on the canonical value, so a default and a same-named custom attribute
+     * resolve to their own entry. Falls back to Title Case of the bare name.
      */
     private _getDisplayNameForAttribute;
     /**

package/dist/src/extensions/Blocks/Recommendation/controls/main/utils.d.ts

@@ -9,7 +9,7 @@
  * - In-place content updates (style-preserving)
  */
 import type { CurrencyConfig } from '../../types/nodeConfig';
-import type { RecommendationProduct } from '@@/Types/recommendation';
+import type { FiltersResponse, RecommendationProduct } from '@@/Types/recommendation';
 import type { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
 import { ModificationDescription } from '@stripoinc/ui-editor-extensions';
 import { type Orientation } from '../../templates';
@@ -54,9 +54,11 @@ export declare function getCurrentLayout(currentNode: ImmutableHtmlNode | null |
 /**
  * Gets the current card composition from block data attribute or use default
  * @param currentNode - The current template node
+ * @param filterList - Partner filters. Omitting it makes a row-less legacy key resolve
+ *   differently here than in `_readCompositionFromNode`. (SD-147101)
  * @returns Array of card element types in order
  */
-export declare function getCardComposition(currentNode: ImmutableHtmlNode | null | undefined): string[];
+export declare function getCardComposition(currentNode: ImmutableHtmlNode | null | undefined, filterList?: FiltersResponse): string[];
 export interface RegenerateProductRowsOptions {
     currentNode: ImmutableHtmlNode | null | undefined;
     documentModifier: DocumentModifier;

package/dist/src/extensions/Blocks/Recommendation/controls/spacing/index.d.ts

@@ -30,6 +30,11 @@ export declare class SpacingControl extends CommonControl {
     onRender(): void;
     onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
     onDestroy(): void;
+    /**
+     * One label + counter per two-column row, so every spacing field gets the same
+     * 16px-padded row the color controls already render instead of sharing one grid.
+     */
+    _spacingRow(label: string, labelName: string, counterName: string): string;
     /**
      * Updates spacing control visibility based on layout orientation and mobileLayoutEnabled.
      * - List layout: hide column spacing (products are full-width), hide ALL mobile

package/dist/src/extensions/Blocks/Recommendation/templates/utils.d.ts

@@ -43,22 +43,23 @@ export declare function resolveInlinePriceOrder(composition: string[]): {
  */
 export declare function toDisplayableAttributeValue(value: unknown): string | undefined;
 /**
- * Checks whether an attribute is a default (top-level) product attribute
- * vs a custom product attribute (nested under `product_attributes`).
- * Returns false when filterList is empty or the attribute is not found.
+ * Name-only type lookup — **legacy fallback only**; the canonical path uses
+ * `isDefaultProductAttr` on the `product-attr` value. A bare name is the canonical
+ * form of a default attribute, so a duplicated name resolves to the default rather
+ * than to whichever entry the filter list happens to enumerate first. (SD-147101)
  */
 export declare function isDefaultAttribute(attrName: string, filterList: FiltersResponse): boolean;
 /**
- * Resolves the `product-attr` HTML attribute value based on attribute type from the filter list.
- * - Default attributes → attribute name directly (e.g., "brand") → compiles to `{{1_0_brand}}`
- * - Product attributes → "product_attribute.<name>" (e.g., "product_attribute.rating_star")
+ * Name-only `product-attr` resolution — **legacy fallback only**, see
+ * `isDefaultAttribute`. Prefer `filterToProductAttrValue`, which reads the type off
+ * the filter entry itself.
  */
 export declare function resolveProductAttrValue(attrName: string, filterList: FiltersResponse): string;
 /**
- * Reverse of `resolveProductAttrValue`: maps a cell's `product-attr` value back to its
- * `customAttr:<name>` composition key. The resolver only ever emits `<name>` (default
- * attribute) or `product_attribute.<name>` (custom product attribute), so stripping the
- * prefix recovers the attribute name without needing the store's filter list.
+ * Maps a cell's `product-attr` value to its composition key. The value is the
+ * canonical identity, so it is carried into the key verbatim — stripping the
+ * `product_attribute.` prefix here would collapse a default and a same-named
+ * custom attribute onto one key.
  */
 export declare function toCustomCompositionKey(productAttrValue: string): string;
 /**
@@ -184,7 +185,7 @@ export interface RenderOptions {
  * `RenderOptions`. Single source for both the stacked per-cell options and the two inline
  * (price + old-price) option sets, so style capture → re-bake stays consistent across layouts.
  */
-export declare function buildCellOptions(attrType: string, renderOptions: RenderOptions): CellRenderOptions;
+export declare function buildCellOptions(attrType: string, renderOptions: RenderOptions, composition?: string[]): CellRenderOptions;
 /**
  * Options for prepareProductRows unified function
  */

package/dist/src/extensions/Blocks/Recommendation/utils/compositionKeys.d.ts

@@ -0,0 +1,47 @@
+import type { FiltersResponse } from '@@/Types/recommendation';
+import type { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
+/**
+ * Canonical identity of a card-composition custom attribute is its `product-attr`
+ * value — `brand` for a default attribute, `product_attribute.brand` for a custom
+ * one. A partner can own both under the same name, and only this form tells them
+ * apart. (SD-147101)
+ */
+type FilterEntry = FiltersResponse[string];
+export declare function isDefaultProductAttr(productAttrValue: string): boolean;
+export declare function bareAttributeName(productAttrValue: string): string;
+export declare function compositionKeyToProductAttr(compositionKey: string): string;
+export declare function productAttrToCompositionKey(productAttrValue: string): string;
+/**
+ * Canonical identity of a filter entry. Reads the type off the entry itself, so
+ * two same-named filters never collapse onto one value.
+ */
+export declare function filterToProductAttrValue(filter: FilterEntry): string;
+/**
+ * Filter entry behind a bare attribute name. A bare name is the canonical form of a
+ * DEFAULT attribute, so the default wins a name collision; the custom entry is only
+ * reached when it is the sole match (a genuinely legacy key). (SD-147101)
+ */
+export declare function findFilterByBareName(bareName: string, filterList: FiltersResponse): FilterEntry | undefined;
+export declare function normalizeCompositionKeys(composition: string[], blockNode?: ImmutableHtmlNode | null, filterList?: FiltersResponse): string[];
+/**
+ * `data-custom-attributes` upgraded to canonical values. Index-preserving: the
+ * Nth entry must keep mapping to the Nth `customAttr:*` composition key.
+ */
+export declare function normalizeCustomAttrValues(values: string[], blockNode?: ImmutableHtmlNode | null, filterList?: FiltersResponse): string[];
+/**
+ * Composition key of an attribute row. Custom rows are keyed by their `product-attr`
+ * value, which stays correct on rows still tagged with a legacy bare name.
+ */
+export declare function resolveRowCompositionKey(row: ImmutableHtmlNode): string | null;
+/**
+ * Finds an attribute row by composition key, tolerating rows still tagged with the
+ * legacy bare-name key. Custom candidates are validated against their `product-attr`,
+ * so a legacy custom `brand` row is never mistaken for the default `brand`.
+ */
+export declare function findAttributeRow(container: ImmutableHtmlNode, compositionKey: string): ImmutableHtmlNode | null;
+/**
+ * Rewrites a copied row's legacy `data-attribute-type` to the canonical key so the
+ * DOM converges on the user's next composition change (no write on mere open).
+ */
+export declare function rewriteLegacyRowKeyHtml(rowHtml: string, compositionKey: string): string;
+export {};

package/dist/src/extensions/Blocks/_Boilerplate/constants/controlIds.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Control IDs used in the Extension
+ * These IDs are returned by the getId() method of each control
+ */
+export declare enum BlockControlId {
+    BLOCK_BACKGROUND = "{{your-block}}-background-color-control"
+}

package/dist/src/extensions/Blocks/_Boilerplate/constants/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Extension Constants
+ *
+ * This module re-exports all constants for the extension.
+ * Import from this file for cleaner imports.
+ * @example
+ * import { BlockControlId, BLOCK_ROOT_SELECTOR } from './constants';
+ */
+export { BlockControlId } from './controlIds';
+export { BLOCK_ROOT_SELECTOR, CSS_CLASS_BLOCK, CSS_CLASS_BLOCK_V2, } from './selectors';

package/dist/src/extensions/Blocks/_Boilerplate/constants/selectors.d.ts

@@ -0,0 +1,16 @@
+/**
+ * CSS selectors and class names used across the extension
+ *
+ * Declare them ONCE here and import everywhere (template, migrator, save validator,
+ * controls). The same literal re-typed across those files is how a rename half-lands.
+ */
+/** Stable contract class, if the backend selects this block by name. Renaming breaks it. */
+export declare const CSS_CLASS_BLOCK = "{{your-block}}";
+/** Current block class — what the template emits and the migrator upgrades legacy blocks to. */
+export declare const CSS_CLASS_BLOCK_V2 = "{{your-block}}-v2";
+/**
+ * Block root selector — the block `<td>` itself.
+ * Used across block-level controls so edits apply to the whole block, not the title cell.
+ * Derived from the class so a rename cannot half-land.
+ */
+export declare const BLOCK_ROOT_SELECTOR = ".{{your-block}}-v2";

package/dist/src/extensions/Blocks/_Boilerplate/controls/blockBackground/index.d.ts

@@ -0,0 +1,14 @@
+export declare const BlockBackgroundControl: {
+    new (): {
+        getId(): string;
+        getLabels(): {
+            title: string;
+        };
+        getTargetNodes(root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode[];
+        getAdditionalModifications(root: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): import("@stripoinc/ui-editor-extensions").TemplateModifier<import("@stripoinc/ui-editor-extensions").HtmlNodeModifier, import("@stripoinc/ui-editor-extensions").CssNodeModifier> | undefined;
+        getParentControlId(): string;
+        api: import("@stripoinc/ui-editor-extensions").ControlApi;
+        getModificationDescription(): import("@stripoinc/ui-editor-extensions").ModificationDescription | undefined;
+        isVisible(_node: import("@stripoinc/ui-editor-extensions").ImmutableHtmlNode): boolean;
+    };
+};

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

@@ -34,6 +34,8 @@ interface SelectProps {
     placeholder: string;
     options: TextValueObject[];
     className?: string;
+    /** Adds the picker's built-in search box. Worth it once the list gets long. */
+    searchable?: boolean;
 }
 interface CounterProps {
     name: string;
@@ -105,7 +107,7 @@ export declare abstract class CommonControl extends Control {
         text: string;
         value: string;
     }): string;
-    _GuSelect({ name, placeholder, options, className }: SelectProps): string;
+    _GuSelect({ name, placeholder, options, className, searchable, }: SelectProps): string;
     _GuTextInput({ name, placeholder, className, disabled }: TextInputProps): string;
     _GuCounter({ name, maxValue, minValue, step }: CounterProps): string;
     _GuRadioButtonItem({ text, value, icon }: {

package/dist/src/library.d.ts

@@ -1,5 +1,6 @@
 export { default as Guido } from './components/Guido.vue';
 export type { GuidoConfig, GuidoConfigInput, IdentityConfig, PartnerConfig, TemplateConfig, TemplateMigrationConfig, LegacyRecommendationConfig, EditorConfig, UIConfig, FeaturesConfig, BlocksConfig, CompilerConfig, DynamicContent, EmailHeader, DefaultBlockType, CustomBlockType, ValidationResult, ValidationError, } from './@types/config';
 export { validateConfig, parseConfig, parseConfigSafe, isValidConfig, getValidationErrors, MessageType, ProductType, } from './@types/config';
+export { assignTrackingIds, readTrackFloor, readTrackSeq } from './public/trackingIds';
 export type { StripoEventType } from './@types/events';
 export type { PositionData, DynamicContentEvent, MergeTagClickEvent, MergeTag, BaseDynamicContent, DynamicContentNode, DynamicContentList, TooltipOptions, TextValueObject, L10n, } from './@types/generic';

package/dist/src/public/trackingIds.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Published as `@useinsider/guido/tracking-ids` — persistent link ids for the click heatmap.
+ *
+ * Importing from here pulls in nothing else, so the editor never enters a
+ * consumer's module graph. Re-export surface only: this is the contract,
+ * `utils/linkTrackingIds` is the implementation and stays free to move.
+ */
+export { assignTrackingIds, readTrackFloor, readTrackSeq, TRACK_ID_ATTRIBUTE, TRACK_SEQ_ATTRIBUTE, } from '@@/Utils/linkTrackingIds';
+export type { TrackingIdResult } from '@@/Utils/linkTrackingIds';