@useinsider/guido 3.15.0 → 3.15.1-beta.6da4177

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/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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@useinsider/guido",
-  "version": "3.15.0",
+  "version": "3.15.1-beta.6da4177",
   "description": "Guido is a Vue + TypeScript wrapper for Email Plugin. Easily embed the email editor in your Vue applications.",
   "main": "./dist/guido.umd.cjs",
   "module": "./dist/library.js",