@useinsider/guido 3.12.0-beta.d2745e7 → 3.12.0-beta.d77b0d2

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;
@@ -107,8 +109,12 @@ export declare class RecommendationBlockControl extends CommonControl {
      */
     private _listenStateUpdates;
     /**
-     * Persists the current filter state from Pinia store to the Stripo node config.
-     * This ensures filters survive template save/reload cycles.
+     * Persists the Pinia-owned parts of the block config to the Stripo node config,
+     * so they survive template save/reload cycles.
+     *
+     * Filters are edited in a drawer and the strategy in an overlaid picker — neither
+     * is a Stripo form element, so neither can write to the node itself. Both ride
+     * this one update to keep the undo history to a single entry per change.
      */
-    private _persistFiltersToNodeConfig;
+    private _persistStoreConfigToNode;
 }

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

@@ -0,0 +1,118 @@
+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;
+    /**
+     * InOne's dictionary, not Stripo's. Every dotted key here
+     * (`discovery-strategy.*`, `gpt-app-builder.*`) lives in the host panel's
+     * translations, which `this.api.translate` does not read — that one is only
+     * for the plain-English control labels the rest of this panel uses.
+     */
+    private trans;
+    private events;
+    private unsubscribeStore;
+    private cardHideTimer;
+    /**
+     * Resolved once per render.
+     *
+     * The card stays INSIDE the control's markup. Parking it at the top of the
+     * shadow root positions it identically but places it outside the settings
+     * panel, and Stripo reads a press there as a press on the canvas: the block
+     * is deselected, the panel closes, and View More never gets its click.
+     */
+    private card;
+    getId(): string;
+    getTemplate(): string;
+    onRender(): void;
+    onDestroy(): void;
+    private _root;
+    private _setupEventListeners;
+    /**
+     * The card follows Stripo's own option rows.
+     *
+     * Stripo does not render the dropdown inside `ue-select`: it hands the list to
+     * `UE-FLOATING-COMPONENTS-CONTAINER`, a sibling of the whole settings panel.
+     * The shadow root is the only node that is an ancestor of both, so that is
+     * where the listener goes.
+     *
+     * `capture: true` is load-bearing, not caution. Stripo binds its own
+     * `mouseover` on the option row to drive `ue-select`'s `hoverItem` output and
+     * stops propagation there — measured: a bubble-phase listener on the shadow
+     * root sees nothing, the event dies one level above the row. Capture runs
+     * root-to-target, before that handler ever gets to speak.
+     *
+     * `mouseover`/`mouseout` rather than `mouseenter`/`mouseleave` because the
+     * latter do not participate in delegation at all, and the row is resolved
+     * through `composedPath()` rather than `event.target`.
+     *
+     * A row is matched to a strategy by its label, which doubles as the scope
+     * check — hovering the Locale or Currency dropdown finds no match and is
+     * ignored. Two strategies sharing a name would show the first one's card;
+     * Smart Recommender does not enforce unique names, and that is the cost.
+     */
+    private _setupCardListeners;
+    /**
+     * Guarded the same way `AlgorithmControl` guards its own select: writing the
+     * value back in `_render()` re-fires `onValueChanged`, and without this the
+     * control would re-select on every store change.
+     */
+    private _onStrategyChange;
+    /**
+     * Keeps the select's items, its value and the gear's enabled state in step
+     * with the store.
+     *
+     * All three depend on data that arrives after the first render: the strategy
+     * listing is fetched asynchronously, and `strategyId` changes when the user
+     * picks, duplicates, or switches blocks.
+     */
+    private _subscribeToStoreChanges;
+    /**
+     * Fingerprint of everything the rendered control depends on.
+     *
+     * Ids rather than a count: a refetch that renames a strategy or swaps one for
+     * another of the same length would otherwise leave the select showing stale
+     * copy until some unrelated store change happened to repaint.
+     */
+    private _stateKey;
+    private _render;
+    /**
+     * A strategy id the listing no longer knows was deleted in Smart Recommender.
+     * The id is deliberately kept (the save gate needs to see it) but the select
+     * falls back to its placeholder, so without this a broken block would look
+     * like one that was simply never configured.
+     */
+    private _renderMissingMessage;
+    /**
+     * The hover card is `position: fixed`, so it can sit beside the narrow panel
+     * instead of being clipped by it. Placed once per hover — the list cannot
+     * scroll under the pointer without the pointer leaving, so there is nothing
+     * to keep in sync.
+     */
+    private _showCard;
+    /**
+     * Resolves one of Stripo's option rows back to the strategy it was built from.
+     *
+     * Matched against the *rendered option labels*, not raw strategy names. Stripo's
+     * row carries no value of its own — its bindings are disabled/selected/tabindex —
+     * so the text is all there is, and `getStrategyOptions` disambiguates duplicate
+     * names by appending the id. Comparing to `strategy.name` would miss exactly those
+     * rows; going through the option list keeps the label the user sees and the label
+     * we match on in lockstep.
+     */
+    private _strategyForItem;
+    /** Grace period for the pointer to cross the gap between the row and the card. */
+    private _scheduleHideCard;
+    private _cancelHideCard;
+    private _hideCard;
+    /**
+     * Mirrors the design system's `InInfoBox`: coloured top rule, heading +
+     * "last updated" details, content, then a divided footer holding the View
+     * More text button. The component itself cannot render here, so the markup
+     * and the CSS reproduce its structure and tokens rather than approximating
+     * them — the values in `recommendation.css` are read from its stylesheet.
+     */
+    private _buildCardHtml;
+}