@useinsider/guido 3.12.0-beta.975e966 → 3.12.0-beta.aa6f9ba

package/dist/src/enums/extensions/filteringV2.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Filtering enums for Reusable Recommendation Strategies (RRS).
+ *
+ * Ported verbatim from discovery-strategies-fe `src/enums/FilteringEnumsV2.js`
+ * (branch `develop`). Only the subset the strategy info-box / humanizer needs is
+ * carried over: `Operators`, `OperatorAbbreviations`, `DataTypes`,
+ * `MultiSelectDataTypes`, `OperatorNames`, `TimeAbbreviations`.
+ *
+ * Guido has no equivalent — `utils/filterUtil.ts` and `validation/filterSchema.ts`
+ * serve the recommendation block's filters, which are a different shape from a
+ * strategy's filters. Do not merge the two.
+ *
+ * The `text` values are translation keys, not literals; resolve them through
+ * `useTranslations().trans()`.
+ *
+ * ponytail: kept as a literal copy rather than a re-derivation so it stays easy
+ * to diff against the source when Smart Recommender adds an operator.
+ */
+/** A single operator option, keyed under its attribute data type. */
+export interface OperatorDefinition {
+    value: string;
+    text: string;
+    operator: string;
+    /** Alternative label used when the strategy targets the cart page. */
+    cartPageText?: string;
+    /** Absent on the `Object` data type in the source. */
+    filterType?: string;
+}
+export declare const Operators: Record<string, OperatorDefinition[]>;
+export declare const TimeAbbreviations: {
+    readonly WEEK: "w";
+    readonly DAY: "d";
+    readonly HOUR: "h";
+};
+export declare const OperatorAbbreviations: {
+    readonly OPERATOR: {
+        readonly IN_LAST: "in-last";
+        readonly IS_EMPTY: "is-empty";
+        readonly IS_NOT_EMPTY: "is-not-empty";
+        readonly IN_BETWEEN: "is-between";
+        readonly IS_TRUE: "true";
+        readonly IS_FALSE: "false";
+    };
+    readonly OPERATOR_EXPRESSION: {
+        readonly IS_EMPTY: "?";
+        readonly IS_NOT_EMPTY: "!?";
+    };
+    readonly DATE_PICKER_OPERATORS: readonly ["after", "before", "is", "is-not"];
+    readonly NON_INPUT_OPERATORS: readonly ["in", "not-in", "after", "before", "is", "is-not", "is-empty", "is-not-empty"];
+    readonly CHIPS_WIDGET_OPERATORS: readonly ["in", "not-in"];
+};
+export declare const DataTypes: {
+    readonly STRING: "String";
+    readonly BOOLEAN: "Boolean";
+    readonly DATE: "Date";
+    readonly NUMBER: "Number";
+    readonly TEXT: "Text";
+    readonly URL: "Image";
+    readonly NUMBERS: "Numbers";
+    readonly DATES: "Dates";
+    readonly BOOLEANS: "Booleans";
+    readonly STRINGS: "Strings";
+};
+export declare const MultiSelectDataTypes: readonly ["Strings", "String", "Array"];
+export declare const OperatorNames: {
+    readonly IS_EXACTLY: "is-exactly";
+    readonly IS_NOT_EXACTLY: "is-not-exactly";
+    readonly CONTAINS: "contains";
+    readonly NOT_CONTAINS: "does-not-contain";
+    readonly IN: "in";
+    readonly NOT_IN: "not-in";
+};

package/dist/src/enums/extensions/recommendationBlock.d.ts

@@ -3,10 +3,20 @@ import type { RecommendationFeedItem } from '@@/Types/recommendation';
 export declare const URLS: {
     RECOMMENDATION_API_URL: string;
     PRODUCT_ATTRIBUTES_PATH: string;
+    RECOMMENDATION_STRATEGIES_PATH: string;
+    STRATEGY_RECOMMENDATION_URL_PATH: string;
 };
 export declare const QUERY_PARAMS: {
     CLIENT_ID: string;
+    STRATEGY_ID: string;
+    FILTERS: string;
 };
+/**
+ * Smart Recommender's filter grammar: `[table.field][operator][value]`, ANDed with `*`.
+ * `~` means "contains" — required because `suitable_channels` is a comma-separated
+ * column, so `=` would only ever match single-channel strategies.
+ */
+export declare const RRS_EMAIL_ACTIVE_FILTER = "[sr_strategies.status][=][active]*[sr_strategies.suitable_channels][~][EMAIL]";
 /**
  * Get recommendation feed source maps lazily so translated names resolve at access time.
  * Must be called within a Vue component context or after Pinia is initialized.

package/dist/src/enums/extensions/strategyDetail.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Enums for the Reusable Recommendation Strategy (RRS) detail drawer.
+ *
+ * Ported from design-system-organisms
+ * `src/organisms/OrgStrategyDetailModal/enums/details-modal.enum.ts` (branch `develop`).
+ *
+ * IMPORTANT — this is NOT the same operator table as `@@/Enums/extensions/filteringV2`.
+ * The detail modal carries its own, deliberately: it uses different operator values
+ * (a `-page-context` suffix where FilteringEnumsV2 uses `_dynamic`) and a different
+ * label per operator. The two tables humanize the same JSON for different surfaces —
+ * filteringV2 backs the four-row panel summary, this one backs the drawer's filter
+ * humanizer. Do not merge them or the drawer starts rendering the wrong operator names.
+ *
+ * One deliberate deviation from the source: the source resolves `translations[...]` at
+ * module-evaluation time. Guido loads translations from editor config after module init,
+ * so every `text` here stays a translation KEY and is resolved at render through
+ * `useTranslations()`. Resolving eagerly would freeze every label to `undefined`.
+ */
+/** Discriminates a duration-based exclusion from a count-based one. */
+export declare const TIME = "TIME";
+export declare const COUNT = "COUNT";
+export declare const OperatorAbbreviations: {
+    readonly OPERATOR: {
+        readonly IN_LAST: "in-last";
+        readonly IS_EMPTY: "is-empty";
+        readonly IS_NOT_EMPTY: "is-not-empty";
+        readonly IN_BETWEEN: "is-between";
+        readonly IS_TRUE: "true";
+        readonly IS_FALSE: "false";
+        readonly IN: "in";
+        readonly NOT_IN: "not-in";
+    };
+    readonly OPERATOR_EXPRESSION: {
+        readonly IS_EMPTY: "?";
+        readonly IS_NOT_EMPTY: "!?";
+    };
+};
+/** One operator option; `text` is a translation key, not a label. */
+export interface DetailOperator {
+    value: string;
+    text: string;
+    operator: string;
+}
+export declare const Operators: Record<string, DetailOperator[]>;
+export declare const DataTypes: {
+    readonly STRING: "String";
+    readonly BOOLEAN: "Boolean";
+    readonly DATE: "Date";
+    readonly NUMBER: "Number";
+    readonly TEXT: "Text";
+    readonly URL: "Image";
+    readonly NUMBERS: "Numbers";
+    readonly DATES: "Dates";
+    readonly BOOLEANS: "Booleans";
+    readonly STRINGS: "Strings";
+};
+export declare const MultiSelectDataTypes: string[];
+export declare const OperatorNames: {
+    readonly IS_EXACTLY: "is-exactly";
+    readonly IS_NOT_EXACTLY: "is-not-exactly";
+    readonly CONTAINS: "contains";
+    readonly NOT_CONTAINS: "does-not-contain";
+    readonly IN: "in";
+    readonly NOT_IN: "not-in";
+};
+export declare const FilterTypeNames: {
+    readonly STANDARD_FILTER: "standardFilter";
+    readonly DYNAMIC_FILTER: "dynamicFilter";
+    readonly USER_CONTEXT_FILTER: "userContextFilter";
+    readonly USER_ATTRIBUTE_FILTER: "userAttributeFilter";
+    readonly USER_EVENT_FILTER: "userEventFilter";
+    readonly EVENT_BASED_FILTER: "eventBasedFilter";
+};
+export declare const UserEventKeys: {
+    readonly CURRENTLY_VIEWED_ITEM: "page";
+    readonly LEGACY_CURRENTLY_VIEWED_ITEM: "currentlyViewedItem";
+};
+/** `text` is a translation key, resolved at render. */
+export declare const UserEvents: {
+    value: string;
+    text: string;
+}[];
+/** Channel value that must render as the email product's own label. */
+export declare const EMAIL_CHANNEL = "email";
+export declare const PageTypeTranslationKeys: Record<string, string>;
+/** Drawer tab identifiers. */
+export declare const DetailTabs: {
+    readonly GENERAL: "general";
+    readonly OTHER: "other";
+};

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

@@ -9,8 +9,9 @@ import { PricePlacementControl, PRICE_PLACEMENT_CONTROL_ID } from './pricePlacem
 import { ProductCountControl, PRODUCT_COUNT_CONTROL_ID } from './productCount';
 import { ProductLayoutControl, PRODUCT_LAYOUT_CONTROL_ID } from './productLayout';
 import { ShuffleControl, SHUFFLE_CONTROL_ID } from './shuffle';
+import { StrategyControl, STRATEGY_CONTROL_ID } from './strategy';
 export declare const CONTROL_BLOCK_ID = "ui-elements-recommendation-block";
-export { AlgorithmControl, ALGORITHM_CONTROL_ID, LocaleControl, LOCALE_CONTROL_ID, CurrencyControl, CURRENCY_CONTROL_ID, ProductCountControl, PRODUCT_COUNT_CONTROL_ID, ProductLayoutControl, PRODUCT_LAYOUT_CONTROL_ID, FiltersControl, FILTERS_CONTROL_ID, ShuffleControl, SHUFFLE_CONTROL_ID, LayoutOrientationControl, LAYOUT_ORIENTATION_CONTROL_ID, PricePlacementControl, PRICE_PLACEMENT_CONTROL_ID, };
+export { AlgorithmControl, ALGORITHM_CONTROL_ID, LocaleControl, LOCALE_CONTROL_ID, CurrencyControl, CURRENCY_CONTROL_ID, ProductCountControl, PRODUCT_COUNT_CONTROL_ID, ProductLayoutControl, PRODUCT_LAYOUT_CONTROL_ID, FiltersControl, FILTERS_CONTROL_ID, ShuffleControl, SHUFFLE_CONTROL_ID, LayoutOrientationControl, LAYOUT_ORIENTATION_CONTROL_ID, PricePlacementControl, PRICE_PLACEMENT_CONTROL_ID, StrategyControl, STRATEGY_CONTROL_ID, };
 export * from './utils';
 /**
  * Main recommendation block control that composes all sub-controls
@@ -21,6 +22,7 @@ export declare class RecommendationBlockControl extends CommonControl {
     private storeUnsubscription;
     private syncedBlockIds;
     private algorithmControl;
+    private strategyControl;
     private localeControl;
     private currencyControl;
     private productCountControl;

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

@@ -0,0 +1,61 @@
+/**
+ * Reusable Recommendation Strategy (RRS) Selection Control
+ *
+ * Lets the marketer pick a named strategy defined in Smart Recommender instead
+ * of configuring an algorithm per block. The selected strategy id is stored in
+ * node config (persists with the template) and decides the block's
+ * recommendation URL at compile time.
+ *
+ * Rendered only when the `reusableRecommendationStrategy` feature is enabled;
+ * otherwise the block keeps using AlgorithmControl.
+ *
+ * Beside the dropdown sits an icon button that opens the strategy detail drawer.
+ * The RRS listing page shows these details in an `InSelect` hover card, which
+ * cannot be reproduced here — `_GuSelect` has no `infoBoxProps` equivalent — so
+ * the details move out of the 425px panel and over the editor instead.
+ *
+ * ponytail: selecting a strategy only drives the URL — Number of Products,
+ * Locale, Currency and Filters stay independently editable in the panel. The
+ * product decision on which of those become strategy-owned is still open
+ * (see the Figma "which settings stay in the editor" note), so nothing is
+ * locked or overwritten here. Add that only once the decision lands.
+ */
+import type { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
+import { CommonControl } from '../../../common-control';
+export declare const STRATEGY_CONTROL_ID = "recommendation-strategy-control";
+/**
+ * Control for selecting a Reusable Recommendation Strategy
+ */
+export declare class StrategyControl extends CommonControl {
+    private store;
+    private detailsListener;
+    private detailsButton;
+    getId(): string;
+    getTemplate(): string;
+    onRender(): void;
+    onDestroy(): void;
+    onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
+    _setFormValues(): void;
+    _initializeSelectItems(): void;
+    /**
+     * Reconciles the panel with the strategy listing: loading, empty, and
+     * deleted-strategy states.
+     *
+     * A strategy the partner deleted in Smart Recommender still lives in this
+     * block's saved config. The id is deliberately left in place and surfaced
+     * instead of being cleared — silently dropping it would make a template that
+     * compiles a broken feed URL look correctly configured.
+     *
+     * ponytail: one message element, three texts. Severity styling (warning vs
+     * info) is not drawn in Figma and pending design sign-off — see open question
+     * 4 in the handoff. Vary `type` once that lands.
+     */
+    _refreshSelectionState(): void;
+    _setDisabled(element: string, disabled: boolean): void;
+    _showMessage(text: string): void;
+    _hideMessage(): void;
+    _onDetailsClick(): void;
+    _setupDetailsButtonListener(): void;
+    _onStrategyChange(value: string): void;
+    _listenToFormUpdates(): void;
+}