@useinsider/guido 2.1.0-beta.425dfd0 → 2.1.0-beta.42f5dfa

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (166) hide show
  1. package/dist/components/organisms/extensions/recommendation/FilterSelectionDrawer.vue2.js +15 -14
  2. package/dist/composables/useActionsApi.js +15 -13
  3. package/dist/composables/useHtmlValidator.js +106 -84
  4. package/dist/composables/useRecommendation.js +54 -21
  5. package/dist/config/compiler/recommendationCompilerRules.js +45 -39
  6. package/dist/config/compiler/utils/recommendationCompilerUtils.js +116 -0
  7. package/dist/config/migrator/itemsBlockMigrator.js +140 -123
  8. package/dist/config/migrator/recommendationMigrator.js +2 -2
  9. package/dist/enums/extensions/recommendationBlock.js +1 -1
  10. package/dist/enums/recommendation.js +16 -15
  11. package/dist/extensions/Blocks/Items/block.js +19 -28
  12. package/dist/extensions/Blocks/Items/controls/button/link.js +19 -31
  13. package/dist/extensions/Blocks/Items/controls/cardComposition.js +124 -85
  14. package/dist/extensions/Blocks/Items/controls/image/link.js +19 -31
  15. package/dist/extensions/Blocks/Items/controls/name/trimming.js +28 -40
  16. package/dist/extensions/Blocks/Items/controls/price/currencyLocation.js +35 -47
  17. package/dist/extensions/Blocks/Items/controls/price/currencySymbol.js +49 -54
  18. package/dist/extensions/Blocks/Items/controls/price/formattedPrice.js +42 -51
  19. package/dist/extensions/Blocks/Items/controls/price/hideDiscount.js +23 -36
  20. package/dist/extensions/Blocks/Items/controls/price/priceOrientation.js +45 -57
  21. package/dist/extensions/Blocks/Items/controls/price/singlePrice.js +42 -60
  22. package/dist/extensions/Blocks/Items/controls/settingsControl.js +189 -196
  23. package/dist/extensions/Blocks/Items/enums/settingsEnums.js +0 -2
  24. package/dist/extensions/Blocks/Items/extension.js +8 -9
  25. package/dist/extensions/Blocks/Items/settingsPanel.js +10 -15
  26. package/dist/extensions/Blocks/Items/template.js +181 -175
  27. package/dist/extensions/Blocks/Items/utils/nodeConfigUtils.js +65 -65
  28. package/dist/extensions/Blocks/Recommendation/block.js +130 -9
  29. package/dist/extensions/Blocks/Recommendation/constants/blockIds.js +4 -0
  30. package/dist/extensions/Blocks/Recommendation/constants/controlIds.js +4 -0
  31. package/dist/extensions/Blocks/Recommendation/constants/defaultConfig.js +65 -0
  32. package/dist/extensions/Blocks/Recommendation/constants/layout.js +20 -0
  33. package/dist/extensions/Blocks/Recommendation/constants/selectors.js +19 -0
  34. package/dist/extensions/Blocks/Recommendation/controls/button/index.js +64 -0
  35. package/dist/extensions/Blocks/Recommendation/controls/cardBackground/index.js +80 -0
  36. package/dist/extensions/Blocks/Recommendation/controls/cardComposition/index.js +232 -0
  37. package/dist/extensions/Blocks/Recommendation/controls/image/index.js +19 -0
  38. package/dist/extensions/Blocks/Recommendation/controls/layout/index.js +92 -0
  39. package/dist/extensions/Blocks/Recommendation/controls/main/algorithm.js +102 -0
  40. package/dist/extensions/Blocks/Recommendation/controls/main/currency.js +209 -0
  41. package/dist/extensions/Blocks/Recommendation/controls/main/filters.js +52 -0
  42. package/dist/extensions/Blocks/Recommendation/controls/main/index.js +217 -0
  43. package/dist/extensions/Blocks/Recommendation/controls/main/locale.js +70 -0
  44. package/dist/extensions/Blocks/Recommendation/controls/main/productLayout.js +110 -0
  45. package/dist/extensions/Blocks/Recommendation/controls/main/shuffle.js +67 -0
  46. package/dist/extensions/Blocks/Recommendation/controls/main/utils.js +286 -0
  47. package/dist/extensions/Blocks/Recommendation/controls/name/index.js +46 -0
  48. package/dist/extensions/Blocks/Recommendation/controls/name/textTrim.js +108 -0
  49. package/dist/extensions/Blocks/Recommendation/controls/oldPrice/index.js +44 -0
  50. package/dist/extensions/Blocks/Recommendation/controls/omnibusDiscount/index.js +48 -0
  51. package/dist/extensions/Blocks/Recommendation/controls/{omnibusDiscountTextAfterControl.js → omnibusDiscount/textAfter.js} +16 -14
  52. package/dist/extensions/Blocks/Recommendation/controls/{omnibusDiscountTextBeforeControl.js → omnibusDiscount/textBefore.js} +16 -14
  53. package/dist/extensions/Blocks/Recommendation/controls/omnibusPrice/index.js +48 -0
  54. package/dist/extensions/Blocks/Recommendation/controls/{omnibusPriceTextAfterControl.js → omnibusPrice/textAfter.js} +16 -14
  55. package/dist/extensions/Blocks/Recommendation/controls/{omnibusPriceTextBeforeControl.js → omnibusPrice/textBefore.js} +14 -12
  56. package/dist/extensions/Blocks/Recommendation/controls/price/index.js +44 -0
  57. package/dist/extensions/Blocks/Recommendation/controls/spacing/index.js +222 -0
  58. package/dist/extensions/Blocks/Recommendation/extension.js +40 -17
  59. package/dist/extensions/Blocks/Recommendation/iconsRegistry.js +19 -3
  60. package/dist/extensions/Blocks/Recommendation/recommendation.css.js +13 -4
  61. package/dist/extensions/Blocks/Recommendation/services/configService.js +240 -0
  62. package/dist/extensions/Blocks/Recommendation/settingsPanel.js +21 -10
  63. package/dist/extensions/Blocks/Recommendation/store/recommendation.js +230 -193
  64. package/dist/extensions/Blocks/Recommendation/templates/grid/elementRenderer.js +233 -0
  65. package/dist/extensions/Blocks/Recommendation/templates/grid/migration.js +251 -0
  66. package/dist/extensions/Blocks/Recommendation/templates/grid/template.js +69 -0
  67. package/dist/extensions/Blocks/Recommendation/templates/index.js +12 -0
  68. package/dist/extensions/Blocks/Recommendation/templates/list/elementRenderer.js +174 -0
  69. package/dist/extensions/Blocks/Recommendation/templates/list/template.js +73 -0
  70. package/dist/extensions/Blocks/Recommendation/templates/utils.js +122 -0
  71. package/dist/extensions/Blocks/Recommendation/types/nodeConfig.js +6 -0
  72. package/dist/extensions/Blocks/Recommendation/utils/filterUtil.js +9 -9
  73. package/dist/extensions/Blocks/Recommendation/utils/preserveTextStyles.js +26 -15
  74. package/dist/extensions/Blocks/Recommendation/utils/priceFormatter.js +29 -0
  75. package/dist/extensions/Blocks/Recommendation/utils/tagName.js +46 -0
  76. package/dist/extensions/Blocks/common-control.js +91 -92
  77. package/dist/extensions/Blocks/controlFactories.js +125 -93
  78. package/dist/node_modules/@stripoinc/ui-editor-extensions/dist/esm/index.js +223 -169
  79. package/dist/services/recommendationApi.js +10 -9
  80. package/dist/services/templateLibraryApi.js +16 -13
  81. package/dist/src/components/wrappers/WpDrawer.vue.d.ts +1 -1
  82. package/dist/src/composables/useRecommendation.d.ts +1 -0
  83. package/dist/src/config/compiler/utils/recommendationCompilerUtils.d.ts +17 -0
  84. package/dist/src/extensions/Blocks/Items/block.d.ts +0 -1
  85. package/dist/src/extensions/Blocks/Items/controls/button/link.d.ts +0 -1
  86. package/dist/src/extensions/Blocks/Items/controls/cardComposition.d.ts +5 -5
  87. package/dist/src/extensions/Blocks/Items/controls/image/link.d.ts +0 -1
  88. package/dist/src/extensions/Blocks/Items/controls/name/trimming.d.ts +0 -1
  89. package/dist/src/extensions/Blocks/Items/controls/price/currencyLocation.d.ts +0 -1
  90. package/dist/src/extensions/Blocks/Items/controls/price/currencySymbol.d.ts +0 -1
  91. package/dist/src/extensions/Blocks/Items/controls/price/formattedPrice.d.ts +0 -1
  92. package/dist/src/extensions/Blocks/Items/controls/price/hideDiscount.d.ts +0 -1
  93. package/dist/src/extensions/Blocks/Items/controls/price/priceOrientation.d.ts +0 -1
  94. package/dist/src/extensions/Blocks/Items/controls/price/singlePrice.d.ts +0 -5
  95. package/dist/src/extensions/Blocks/Items/controls/settingsControl.d.ts +10 -12
  96. package/dist/src/extensions/Blocks/Items/utils/nodeConfigUtils.d.ts +2 -1
  97. package/dist/src/extensions/Blocks/Recommendation/block.d.ts +67 -0
  98. package/dist/src/extensions/Blocks/Recommendation/constants/blockIds.d.ts +13 -0
  99. package/dist/src/extensions/Blocks/Recommendation/{constants.d.ts → constants/controlIds.d.ts} +0 -24
  100. package/dist/src/extensions/Blocks/Recommendation/constants/defaultConfig.d.ts +49 -0
  101. package/dist/src/extensions/Blocks/Recommendation/constants/index.d.ts +13 -0
  102. package/dist/src/extensions/Blocks/Recommendation/constants/layout.d.ts +35 -0
  103. package/dist/src/extensions/Blocks/Recommendation/constants/selectors.d.ts +31 -0
  104. package/dist/src/extensions/Blocks/Recommendation/controls/button/index.d.ts +143 -0
  105. package/dist/src/extensions/Blocks/Recommendation/controls/cardBackground/index.d.ts +31 -0
  106. package/dist/src/extensions/Blocks/Recommendation/{cardCompositionControl.d.ts → controls/cardComposition/index.d.ts} +23 -3
  107. package/dist/src/extensions/Blocks/Recommendation/controls/image/index.d.ts +35 -0
  108. package/dist/src/extensions/Blocks/Recommendation/controls/index.d.ts +21 -589
  109. package/dist/src/extensions/Blocks/Recommendation/controls/layout/index.d.ts +37 -0
  110. package/dist/src/extensions/Blocks/Recommendation/controls/main/algorithm.d.ts +29 -0
  111. package/dist/src/extensions/Blocks/Recommendation/controls/main/currency.d.ts +52 -0
  112. package/dist/src/extensions/Blocks/Recommendation/controls/main/filters.d.ts +22 -0
  113. package/dist/src/extensions/Blocks/Recommendation/controls/main/index.d.ts +68 -0
  114. package/dist/src/extensions/Blocks/Recommendation/controls/main/locale.d.ts +24 -0
  115. package/dist/src/extensions/Blocks/Recommendation/controls/main/productLayout.d.ts +42 -0
  116. package/dist/src/extensions/Blocks/Recommendation/controls/main/shuffle.d.ts +23 -0
  117. package/dist/src/extensions/Blocks/Recommendation/controls/main/utils.d.ts +214 -0
  118. package/dist/src/extensions/Blocks/Recommendation/controls/name/index.d.ts +97 -0
  119. package/dist/src/extensions/Blocks/Recommendation/controls/name/textTrim.d.ts +34 -0
  120. package/dist/src/extensions/Blocks/Recommendation/controls/oldPrice/index.d.ts +95 -0
  121. package/dist/src/extensions/Blocks/Recommendation/controls/omnibusDiscount/index.d.ts +100 -0
  122. package/dist/src/extensions/Blocks/Recommendation/controls/omnibusDiscount/textAfter.d.ts +15 -0
  123. package/dist/src/extensions/Blocks/Recommendation/controls/omnibusDiscount/textBefore.d.ts +15 -0
  124. package/dist/src/extensions/Blocks/Recommendation/controls/omnibusPrice/index.d.ts +100 -0
  125. package/dist/src/extensions/Blocks/Recommendation/controls/omnibusPrice/textAfter.d.ts +15 -0
  126. package/dist/src/extensions/Blocks/Recommendation/controls/omnibusPrice/textBefore.d.ts +15 -0
  127. package/dist/src/extensions/Blocks/Recommendation/controls/price/index.d.ts +95 -0
  128. package/dist/src/extensions/Blocks/Recommendation/controls/spacing/index.d.ts +83 -0
  129. package/dist/src/extensions/Blocks/Recommendation/extension.d.ts +9 -0
  130. package/dist/src/extensions/Blocks/Recommendation/services/configService.d.ts +151 -0
  131. package/dist/src/extensions/Blocks/Recommendation/services/index.d.ts +6 -0
  132. package/dist/src/extensions/Blocks/Recommendation/store/recommendation.d.ts +131 -468
  133. package/dist/src/extensions/Blocks/Recommendation/templates/grid/elementRenderer.d.ts +20 -0
  134. package/dist/src/extensions/Blocks/Recommendation/templates/{migrationTemplate.d.ts → grid/migration.d.ts} +11 -4
  135. package/dist/src/extensions/Blocks/Recommendation/templates/grid/template.d.ts +33 -0
  136. package/dist/src/extensions/Blocks/Recommendation/templates/index.d.ts +39 -0
  137. package/dist/src/extensions/Blocks/Recommendation/templates/list/elementRenderer.d.ts +8 -0
  138. package/dist/src/extensions/Blocks/Recommendation/templates/list/migration.d.ts +25 -0
  139. package/dist/src/extensions/Blocks/Recommendation/templates/list/template.d.ts +18 -0
  140. package/dist/src/extensions/Blocks/Recommendation/templates/utils.d.ts +57 -0
  141. package/dist/src/extensions/Blocks/Recommendation/types/index.d.ts +7 -0
  142. package/dist/src/extensions/Blocks/Recommendation/types/nodeConfig.d.ts +160 -0
  143. package/dist/src/extensions/Blocks/Recommendation/utils/priceFormatter.d.ts +33 -0
  144. package/dist/src/extensions/Blocks/Recommendation/utils/stylePreserver.d.ts +113 -0
  145. package/dist/src/extensions/Blocks/Recommendation/utils/tagName.d.ts +77 -0
  146. package/dist/src/extensions/Blocks/common-control.d.ts +4 -5
  147. package/dist/static/styles/customEditorStyle.css.js +25 -2
  148. package/dist/utils/pairProductVariables.js +57 -56
  149. package/dist/utils/templatePreparation.js +15 -14
  150. package/package.json +1 -1
  151. package/dist/extensions/Blocks/Items/store/items-block.js +0 -79
  152. package/dist/extensions/Blocks/Recommendation/cardCompositionControl.js +0 -187
  153. package/dist/extensions/Blocks/Recommendation/constants.js +0 -13
  154. package/dist/extensions/Blocks/Recommendation/control.js +0 -336
  155. package/dist/extensions/Blocks/Recommendation/controls/cardBackgroundColorControl.js +0 -68
  156. package/dist/extensions/Blocks/Recommendation/controls/index.js +0 -245
  157. package/dist/extensions/Blocks/Recommendation/controls/nameTextTrimControl.js +0 -74
  158. package/dist/extensions/Blocks/Recommendation/controls/spacingControl.js +0 -188
  159. package/dist/extensions/Blocks/Recommendation/templates/blockTemplate.js +0 -181
  160. package/dist/extensions/Blocks/Recommendation/templates/migrationTemplate.js +0 -189
  161. package/dist/extensions/Blocks/Recommendation/templates/templateUtils.js +0 -209
  162. package/dist/src/extensions/Blocks/Items/store/items-block.d.ts +0 -45
  163. package/dist/src/extensions/Blocks/Recommendation/control.d.ts +0 -38
  164. package/dist/src/extensions/Blocks/Recommendation/controls/nameTextTrimControl.d.ts +0 -16
  165. package/dist/src/extensions/Blocks/Recommendation/templates/blockTemplate.d.ts +0 -16
  166. package/dist/src/extensions/Blocks/Recommendation/templates/templateUtils.d.ts +0 -52
@@ -1,7 +1,7 @@
1
- import { useHttp as c } from "../composables/useHttp.js";
2
- import { URLS as a } from "../enums/extensions/recommendationBlock.js";
3
- const R = () => {
4
- const { get: o } = c();
1
+ import { useHttp as a } from "../composables/useHttp.js";
2
+ import { URLS as s } from "../enums/extensions/recommendationBlock.js";
3
+ const u = () => {
4
+ const { get: o } = a();
5
5
  return {
6
6
  fetchRecommendationCreateData: async () => {
7
7
  try {
@@ -18,14 +18,15 @@ const R = () => {
18
18
  throw console.error("fetchRecommendationFilters error:", e), e;
19
19
  }
20
20
  },
21
- fetchRecommendationProducts: async (e, n) => {
21
+ fetchRecommendationProducts: async (e, c) => {
22
+ var n;
22
23
  try {
23
- const t = decodeURIComponent(new URLSearchParams(Object.entries(n)).toString());
24
+ const t = decodeURIComponent(new URLSearchParams(Object.entries(c)).toString());
24
25
  console.debug("🏁 Recommendation API Query:", t);
25
26
  const r = await o(
26
- `${a.RECOMMENDATION_API_URL}/v2/${e}?${t}`
27
+ `${s.RECOMMENDATION_API_URL}/v2/${e}?${t}`
27
28
  );
28
- return (r == null ? void 0 : r.data) ?? [];
29
+ return ((n = r == null ? void 0 : r.data) == null ? void 0 : n.data) ?? [];
29
30
  } catch (t) {
30
31
  throw console.error("fetchRecommendationProducts error:", t), t;
31
32
  }
@@ -33,5 +34,5 @@ const R = () => {
33
34
  };
34
35
  };
35
36
  export {
36
- R as useRecommendationApi
37
+ u as useRecommendationApi
37
38
  };
@@ -3,29 +3,30 @@ import { useHttp as f } from "../composables/useHttp.js";
3
3
  import { useToaster as w } from "../composables/useToaster.js";
4
4
  import { useTranslations as b } from "../composables/useTranslations.js";
5
5
  import { EditorType as h } from "../enums/defaults.js";
6
- import { useSaveAsTemplateStore as C } from "../stores/save-as-template.js";
6
+ import { useRecommendationExtensionStore as C } from "../extensions/Blocks/Recommendation/store/recommendation.js";
7
+ import { useSaveAsTemplateStore as v } from "../stores/save-as-template.js";
7
8
  import { base64EncodeWithSpecialChars as a } from "../utils/base64.js";
8
- import { useTemplatePreparation as v } from "../utils/templatePreparation.js";
9
- const L = () => {
10
- const { get: m, post: n } = f(), { handleError: o, showToaster: i } = w(), { config: l } = T(), p = b();
9
+ import { useTemplatePreparation as S } from "../utils/templatePreparation.js";
10
+ const R = () => {
11
+ const { get: n, post: c } = f(), { handleError: o, showToaster: i } = w(), { config: l } = T(), p = b();
11
12
  return {
12
13
  getCategories: async () => {
13
14
  try {
14
- const { data: e = [] } = await m("/newsletter/template-library/get-template-categories");
15
+ const { data: e = [] } = await n("/newsletter/template-library/get-template-categories");
15
16
  return e;
16
17
  } catch (e) {
17
18
  return o(e, "Failed to fetch template categories"), [];
18
19
  }
19
20
  },
20
21
  checkTemplateNameAvailability: async (e) => {
21
- const { data: { status: t = !1 } } = await m(
22
+ const { data: { status: t = !1 } } = await n(
22
23
  `/newsletter/template-library/template-name-exists?name=${e}`
23
24
  );
24
25
  return !t;
25
26
  },
26
27
  createCategory: async (e) => {
27
28
  try {
28
- const { data: { id: t } } = await n(
29
+ const { data: { id: t } } = await c(
29
30
  "/newsletter/template-library/create-category",
30
31
  { name: e }
31
32
  );
@@ -37,7 +38,7 @@ const L = () => {
37
38
  createTemplate: async () => {
38
39
  var e, t, g, y;
39
40
  try {
40
- const { prepareTemplateDetails: c } = v(), r = C(), s = await c(), u = {
41
+ const { prepareTemplateDetails: m } = S(), r = v(), s = await m(), u = {
41
42
  name: r.getTemplateName,
42
43
  categories: r.getSelectedCategoryIds,
43
44
  productId: ((t = (e = l.value) == null ? void 0 : e.partner) == null ? void 0 : t.productType) || 0,
@@ -47,7 +48,9 @@ const L = () => {
47
48
  css: a(s.css),
48
49
  unsubscriptionPreferencePageStatus: !1,
49
50
  unsubscriptionPreferencePages: [],
50
- recommendationCampaignUrls: a({}),
51
+ recommendationCampaignUrls: a(
52
+ C().recommendationCampaignUrls
53
+ ),
51
54
  recommendationConfigs: a({}),
52
55
  isGuido: !0,
53
56
  stripoConfig: a({
@@ -55,7 +58,7 @@ const L = () => {
55
58
  html: s.rawHtml,
56
59
  css: s.css
57
60
  })
58
- }, { data: { type: d } } = await n(
61
+ }, { data: { type: d } } = await c(
59
62
  "/newsletter/template-library/create-template",
60
63
  u
61
64
  );
@@ -76,12 +79,12 @@ const L = () => {
76
79
  ),
77
80
  type: "success"
78
81
  });
79
- } catch (c) {
80
- o(c, "Failed to create template");
82
+ } catch (m) {
83
+ o(m, "Failed to create template");
81
84
  }
82
85
  }
83
86
  };
84
87
  };
85
88
  export {
86
- L as useTemplateLibraryApi
89
+ R as useTemplateLibraryApi
87
90
  };
@@ -33,8 +33,8 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_WithDefaults<
33
33
  descriptionStatus: boolean;
34
34
  descriptionText: string;
35
35
  }>>>, {
36
- className: string;
37
36
  size: "small" | "medium" | "large";
37
+ className: string;
38
38
  closeOnOutsideClick: boolean;
39
39
  descriptionStatus: boolean;
40
40
  descriptionText: string;
@@ -15,5 +15,6 @@ interface CampaignData extends CardWidthParams {
15
15
  export declare const useRecommendation: () => {
16
16
  calculateCardWidth: ({ mobileLeftPadding, mobileRightPadding, cardsInRow, unresponsive, }: CardWidthParams) => number;
17
17
  getRecommendationCampaignData: (id: string) => CampaignData;
18
+ buildCampaignUrl: (campaignId: string) => string;
18
19
  };
19
20
  export {};
@@ -0,0 +1,17 @@
1
+ /**
2
+ * Formats a price template variable with the correct currency alignment.
3
+ * @param campaignId - The recommendation block campaign ID
4
+ * @param productIndex - Zero-based product index
5
+ * @param attribute - Price attribute name (e.g., 'price', 'original_price')
6
+ * @param alignment - Currency alignment from block config: 'before' or 'after'
7
+ * @returns Formatted price string with currency variable in correct position
8
+ */
9
+ export declare function formatPriceVariable(campaignId: string, productIndex: number, attribute: string, alignment: string): string;
10
+ /**
11
+ * Transforms recommendation block HTML by replacing product data with
12
+ * template variables.
13
+ * Preserves the full document structure (DOCTYPE, html, head, body).
14
+ * @param html - The raw template HTML
15
+ * @returns HTML with template variables replacing product data
16
+ */
17
+ export declare function prepareRecommendationBlocks(html: string): string;
@@ -23,5 +23,4 @@ export declare class ItemsBlock extends Block {
23
23
  getTemplate(): string;
24
24
  allowInnerBlocksDND(): boolean;
25
25
  onCreated(node: ImmutableHtmlNode): void;
26
- onSelect(node: ImmutableHtmlNode): void;
27
26
  }
@@ -3,7 +3,6 @@ import { CommonControl } from '../../../common-control';
3
3
  import { ItemsBlockControlId } from '../../enums/controlEnums';
4
4
  export declare const CONTROL_BLOCK_ID = ItemsBlockControlId.BUTTON_LINK;
5
5
  export declare class ButtonLinkControl extends CommonControl {
6
- private store;
7
6
  getId(): string;
8
7
  getTemplate(): string;
9
8
  onRender(): void;
@@ -2,7 +2,6 @@ import { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
2
2
  import { CommonControl } from '../../common-control';
3
3
  export declare const COMPOSITION_CONTROL_BLOCK_ID = "ui-elements-items-card-composition-block";
4
4
  export declare class ItemsBlockCardCompositionControl extends CommonControl {
5
- private store;
6
5
  private visibilityState;
7
6
  getId(): string;
8
7
  getTemplate(): string;
@@ -19,10 +18,11 @@ export declare class ItemsBlockCardCompositionControl extends CommonControl {
19
18
  * If itemsType is not BROWSED_ITEMS, show quantity
20
19
  * If itemsType is BROWSED_ITEMS, hide quantity
21
20
  * and mark it as '0'
21
+ * @param syncOnly - If true, only sync local state and UI without modifying the document
22
22
  */
23
- _handleBrowsedItemsQuantity(): void;
24
- _applyVisibilityStyles(): void;
25
- _updateVisibilityAttribute(elementName: string, isVisible: boolean): void;
23
+ _handleBrowsedItemsQuantity(syncOnly?: boolean): void;
24
+ _applyVisibilityStyles(modifier?: ReturnType<typeof this.api.getDocumentModifier>): void;
25
+ _updateVisibilityAttribute(elementName: string, isVisible: boolean, modifier?: ReturnType<typeof this.api.getDocumentModifier>): void;
26
26
  _listenToFormUpdates(): void;
27
27
  _onProductImageChange(value: boolean): void;
28
28
  _onProductNameChange(value: boolean): void;
@@ -37,6 +37,6 @@ export declare class ItemsBlockCardCompositionControl extends CommonControl {
37
37
  * - When price is hidden, original price cell expands to 100%
38
38
  * - When both are visible, they share 50% each
39
39
  */
40
- _updatePriceCellWidthsForVerticalLayout(): void;
40
+ _updatePriceCellWidthsForVerticalLayout(modifier?: ReturnType<typeof this.api.getDocumentModifier>): void;
41
41
  _onProductButtonChange(value: boolean): void;
42
42
  }
@@ -3,7 +3,6 @@ import { CommonControl } from '../../../common-control';
3
3
  import { ItemsBlockControlId } from '../../enums/controlEnums';
4
4
  export declare const CONTROL_BLOCK_ID = ItemsBlockControlId.IMAGE_LINK;
5
5
  export declare class ImageLinkControl extends CommonControl {
6
- private store;
7
6
  getId(): string;
8
7
  getTemplate(): string;
9
8
  onRender(): void;
@@ -3,7 +3,6 @@ import { CommonControl } from '../../../common-control';
3
3
  import { ItemsBlockControlId } from '../../enums/controlEnums';
4
4
  export declare const CONTROL_BLOCK_ID = ItemsBlockControlId.NAME_TRIMMING;
5
5
  export declare class NameTrimmingControl extends CommonControl {
6
- private store;
7
6
  getId(): string;
8
7
  getTemplate(): string;
9
8
  onRender(): void;
@@ -3,7 +3,6 @@ import { CommonControl } from '../../../common-control';
3
3
  import { ItemsBlockControlId } from '../../enums/controlEnums';
4
4
  export declare const CONTROL_BLOCK_ID = ItemsBlockControlId.PRICE_CURRENCY_LOCATION;
5
5
  export declare class PriceCurrencyLocationControl extends CommonControl {
6
- private store;
7
6
  getId(): string;
8
7
  getTemplate(): string;
9
8
  onRender(): void;
@@ -3,7 +3,6 @@ import { CommonControl } from '../../../common-control';
3
3
  import { ItemsBlockControlId } from '../../enums/controlEnums';
4
4
  export declare const CONTROL_BLOCK_ID = ItemsBlockControlId.PRICE_CURRENCY_SYMBOL;
5
5
  export declare class PriceCurrencySymbolControl extends CommonControl {
6
- private store;
7
6
  private originalPriceContents;
8
7
  getId(): string;
9
8
  getTemplate(): string;
@@ -3,7 +3,6 @@ import { CommonControl } from '../../../common-control';
3
3
  import { ItemsBlockControlId } from '../../enums/controlEnums';
4
4
  export declare const CONTROL_BLOCK_ID = ItemsBlockControlId.PRICE_FORMATTED_PRICE;
5
5
  export declare class PriceFormattedPriceControl extends CommonControl {
6
- private store;
7
6
  getId(): string;
8
7
  getTemplate(): string;
9
8
  onRender(): void;
@@ -3,7 +3,6 @@ import { CommonControl } from '../../../common-control';
3
3
  import { ItemsBlockControlId } from '../../enums/controlEnums';
4
4
  export declare const CONTROL_BLOCK_ID = ItemsBlockControlId.PRICE_HIDE_DISCOUNT;
5
5
  export declare class PriceHideDiscountControl extends CommonControl {
6
- private store;
7
6
  getId(): string;
8
7
  getTemplate(): string;
9
8
  onRender(): void;
@@ -3,7 +3,6 @@ import { CommonControl } from '../../../common-control';
3
3
  import { ItemsBlockControlId } from '../../enums/controlEnums';
4
4
  export declare const CONTROL_BLOCK_ID = ItemsBlockControlId.PRICE_ORIENTATION;
5
5
  export declare class PriceOrientationControl extends CommonControl {
6
- private store;
7
6
  getId(): string;
8
7
  getTemplate(): string;
9
8
  onRender(): void;
@@ -3,15 +3,10 @@ import { CommonControl } from '../../../common-control';
3
3
  import { ItemsBlockControlId } from '../../enums/controlEnums';
4
4
  export declare const CONTROL_BLOCK_ID = ItemsBlockControlId.PRICE_SINGLE_PRICE;
5
5
  export declare class PriceSinglePriceControl extends CommonControl {
6
- private store;
7
6
  getId(): string;
8
7
  getTemplate(): string;
9
8
  onRender(): void;
10
9
  onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
11
- /**
12
- * Syncs single price state from nodeConfig.
13
- */
14
- private _syncSinglePriceFromNodeConfig;
15
10
  _onSinglePriceChange(value: boolean): void;
16
11
  private _updatePriceBlock;
17
12
  _getSinglePrice(): string;
@@ -3,12 +3,10 @@ import { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
3
3
  import { CommonControl } from '../../common-control';
4
4
  export declare const CONTROL_BLOCK_ID = "ui-elements-items-block";
5
5
  export declare class ItemsBlockControl extends CommonControl {
6
- private store;
7
6
  getId(): string;
8
7
  getTemplate(): string;
9
8
  onRender(): void;
10
9
  onTemplateNodeUpdated(node: ImmutableHtmlNode): void;
11
- onDestroy(): void;
12
10
  _getItemsType(): string;
13
11
  _getOrientation(): string;
14
12
  _getItemInCart(): string;
@@ -18,7 +16,7 @@ export declare class ItemsBlockControl extends CommonControl {
18
16
  _initializeSelectItems(): void;
19
17
  _listenToFormUpdates(): void;
20
18
  _renderTemplate(): void;
21
- _getTemplateData(): {
19
+ _getTemplateData(itemsTypeOverride?: ProductType, itemIdOverride?: string): {
22
20
  imageSrc: string;
23
21
  name: string;
24
22
  price: string;
@@ -26,15 +24,15 @@ export declare class ItemsBlockControl extends CommonControl {
26
24
  quantity: string;
27
25
  button: string;
28
26
  };
29
- _updateImageSrc(imageSrc: string): void;
30
- _updateName(name: string): void;
31
- _updatePrice(price: string): void;
32
- _updateOriginalPrice(originalPrice: string): void;
33
- _updateQuantity(quantity: string): void;
34
- _reOrderTemplate(): void;
35
- _updateDataTypeAttributes(itemsType: ProductType): void;
36
- _updateDataNumberAttributes(itemId: string): void;
37
- _reFillTemplate(): void;
27
+ _updateImageSrc(imageSrc: string, modifier: ReturnType<typeof this.api.getDocumentModifier>): void;
28
+ _updateName(name: string, modifier: ReturnType<typeof this.api.getDocumentModifier>): void;
29
+ _updatePrice(price: string, modifier: ReturnType<typeof this.api.getDocumentModifier>): void;
30
+ _updateOriginalPrice(originalPrice: string, modifier: ReturnType<typeof this.api.getDocumentModifier>): void;
31
+ _updateQuantity(quantity: string, itemsTypeOverride: ProductType | undefined, modifier: ReturnType<typeof this.api.getDocumentModifier>): void;
32
+ _reOrderTemplate(modifier?: ReturnType<typeof this.api.getDocumentModifier>): void;
33
+ _updateDataTypeAttributes(itemsType: ProductType, modifier: ReturnType<typeof this.api.getDocumentModifier>): void;
34
+ _updateDataNumberAttributes(itemId: string, modifier: ReturnType<typeof this.api.getDocumentModifier>): void;
35
+ _reFillTemplate(itemsType?: ProductType): void;
38
36
  _recalculateTrimming(): void;
39
37
  private _getParagraphFromBlock;
40
38
  private _escapeRegex;
@@ -66,8 +66,9 @@ export declare function getItemsBlockConfig(currentNode: ImmutableHtmlNode | und
66
66
  * @param currentNode - The current node from the control
67
67
  * @param api - The API object (ControlApi or BlockApi)
68
68
  * @param config - The configuration to set (partial update supported)
69
+ * @param modifier - Optional document modifier for batching updates
69
70
  */
70
- export declare function setItemsBlockConfig(currentNode: ImmutableHtmlNode | undefined, api: ControlApi | BlockApi, config: Partial<ItemsBlockConfig>): void;
71
+ export declare function setItemsBlockConfig(currentNode: ImmutableHtmlNode | undefined, api: ControlApi | BlockApi, config: Partial<ItemsBlockConfig>, modifier?: ReturnType<typeof api.getDocumentModifier>): void;
71
72
  /**
72
73
  * Gets the block instance ID from the node config.
73
74
  * @param currentNode - The current node from the control
@@ -1,11 +1,78 @@
1
+ /**
2
+ * Recommendation Block
3
+ *
4
+ * Main block class for the Recommendation extension.
5
+ * Handles block lifecycle including configuration initialization and migration.
6
+ * Supports multiple block instances with unique recommendation-id attributes.
7
+ */
8
+ import type { ImmutableHtmlNode } from '@stripoinc/ui-editor-extensions';
1
9
  import { Block, BlockCompositionType } from '@stripoinc/ui-editor-extensions';
2
10
  export declare const BLOCK_ID = "recommendation-block";
3
11
  export declare class RecommendationBlock extends Block {
12
+ /**
13
+ * Stores the ID generated in getTemplate() so onCreated() can reuse it.
14
+ * This avoids generating a new (different) ID in onCreated().
15
+ */
16
+ private _pendingBlockId;
4
17
  constructor();
5
18
  getId(): string;
6
19
  getIcon(): string;
7
20
  getBlockCompositionType(): BlockCompositionType;
8
21
  getName(): string;
9
22
  getDescription(): string;
23
+ /**
24
+ * Returns the template HTML for a new recommendation block.
25
+ * Generates a unique recommendation ID and embeds the instance class
26
+ * (ins-recommendation-v3-block-{id}) directly in the template HTML.
27
+ * This is necessary because Stripo's Angular rendering manages the class
28
+ * attribute and overwrites dynamically added classes via setAttribute.
29
+ */
10
30
  getTemplate(): string;
31
+ /**
32
+ * Called when a new block is dropped into the template
33
+ *
34
+ * Uses the ID from getTemplate() (which already embedded the instance class)
35
+ * and assigns the recommendation-id attribute + initializes configuration.
36
+ * @param node - The newly created block node
37
+ */
38
+ onCreated(node: ImmutableHtmlNode): void;
39
+ /**
40
+ * Called when the document changes or template is loaded
41
+ *
42
+ * Handles migration from legacy templates that don't have node config
43
+ * and assigns recommendation-id to legacy blocks that lack one.
44
+ * @param node - The block node that may need migration
45
+ */
46
+ onDocumentChanged(node: ImmutableHtmlNode): void;
47
+ /**
48
+ * Called when a block is deleted from the template
49
+ *
50
+ * Cleans up the per-block state from the Pinia store.
51
+ * @param node - The block node being deleted
52
+ */
53
+ onDelete(node: ImmutableHtmlNode): void;
54
+ /**
55
+ * Generates the next unique recommendation ID by scanning all existing blocks
56
+ * in the document and finding the maximum existing ID + 1.
57
+ */
58
+ private _generateNextId;
59
+ /**
60
+ * Assigns a recommendation-id attribute to the block element.
61
+ * The instance class (ins-recommendation-v3-block-{id}) is embedded in the template
62
+ * HTML by getTemplate(), since Stripo's Angular rendering overwrites dynamically
63
+ * added classes via setAttribute.
64
+ */
65
+ private _assignRecommendationId;
66
+ /**
67
+ * Gets the recommendation-id from a block node
68
+ */
69
+ private _getRecommendationId;
70
+ /**
71
+ * Gets the block element (the element with BLOCK_CLASS)
72
+ */
73
+ private _getBlockElement;
74
+ /**
75
+ * Migrate configuration from legacy format
76
+ */
77
+ private _migrateFromLegacy;
11
78
  }
@@ -0,0 +1,13 @@
1
+ /**
2
+ * Block IDs used in the Recommendation Extension
3
+ * These IDs are used in the esd-extension-block-id attribute to identify specific blocks
4
+ */
5
+ export declare enum RecommendationBlockId {
6
+ BUTTON = "recommendation-block-button",
7
+ NAME = "recommendation-block-name",
8
+ PRICE = "recommendation-block-price",
9
+ OLD_PRICE = "recommendation-block-old-price",
10
+ OMNIBUS_PRICE = "recommendation-block-omnibus-price",
11
+ OMNIBUS_DISCOUNT = "recommendation-block-omnibus-discount",
12
+ IMAGE = "recommendation-block-image"
13
+ }
@@ -1,27 +1,3 @@
1
- /**
2
- * Attribute type constants used in templates
3
- * These are used as keys in ElementRenderer and composition arrays
4
- */
5
- export declare const ATTR_PRODUCT_IMAGE = "productImage";
6
- export declare const ATTR_PRODUCT_NAME = "productName";
7
- export declare const ATTR_PRODUCT_PRICE = "productPrice";
8
- export declare const ATTR_PRODUCT_OLD_PRICE = "productOldPrice";
9
- export declare const ATTR_PRODUCT_OMNIBUS_PRICE = "productOmnibusPrice";
10
- export declare const ATTR_PRODUCT_OMNIBUS_DISCOUNT = "productOmnibusDiscount";
11
- export declare const ATTR_PRODUCT_BUTTON = "productButton";
12
- /**
13
- * Block IDs used in the Recommendation Extension
14
- * These IDs are used in the esd-extension-block-id attribute to identify specific blocks
15
- */
16
- export declare enum RecommendationBlockId {
17
- BUTTON = "recommendation-block-button",
18
- NAME = "recommendation-block-name",
19
- PRICE = "recommendation-block-price",
20
- OLD_PRICE = "recommendation-block-old-price",
21
- OMNIBUS_PRICE = "recommendation-block-omnibus-price",
22
- OMNIBUS_DISCOUNT = "recommendation-block-omnibus-discount",
23
- IMAGE = "recommendation-block-image"
24
- }
25
1
  /**
26
2
  * Control IDs used in the Recommendation Extension
27
3
  * These IDs are returned by the getId() method of each control
@@ -0,0 +1,49 @@
1
+ /**
2
+ * Default Configuration for Recommendation Block
3
+ *
4
+ * This module provides the default values for RecommendationNodeConfig.
5
+ * These values are used when:
6
+ * - A new block is dropped into the template
7
+ * - Migrating legacy templates without stored config
8
+ * - Merging partial updates with existing config
9
+ */
10
+ import type { RecommendationNodeConfig, CurrencyConfig, OmnibusTextConfig } from '../types/nodeConfig';
11
+ /**
12
+ * Default currency configuration
13
+ * Uses USD as the base currency with standard formatting
14
+ * Note: symbol stores the currency code (e.g., 'USD'), not the symbol character ('$')
15
+ * This matches the Currency Symbol dropdown which shows currency codes
16
+ */
17
+ export declare const DEFAULT_CURRENCY: CurrencyConfig;
18
+ /**
19
+ * Default omnibus price text configuration
20
+ * Pre-filled with common EU Omnibus Directive text
21
+ */
22
+ export declare const DEFAULT_OMNIBUS_PRICE: OmnibusTextConfig;
23
+ /**
24
+ * Default omnibus discount text configuration
25
+ */
26
+ export declare const DEFAULT_OMNIBUS_DISCOUNT: OmnibusTextConfig;
27
+ /**
28
+ * Default card composition order
29
+ * Defines the visual order of elements in product cards
30
+ */
31
+ export declare const DEFAULT_COMPOSITION: string[];
32
+ /**
33
+ * Default visibility settings for card elements
34
+ * Omnibus elements are hidden by default (not all regions require them)
35
+ */
36
+ export declare const DEFAULT_VISIBILITY: Record<string, boolean>;
37
+ /**
38
+ * Complete default configuration for Recommendation Block
39
+ *
40
+ * This is the single source of truth for default values.
41
+ * All other code should import and use this constant.
42
+ */
43
+ export declare const DEFAULT_NODE_CONFIG: RecommendationNodeConfig;
44
+ /**
45
+ * Current configuration version
46
+ * Increment this when making breaking changes to the schema
47
+ * Used for migration detection
48
+ */
49
+ export declare const CURRENT_CONFIG_VERSION = 1;
@@ -0,0 +1,13 @@
1
+ /**
2
+ * Recommendation Extension Constants
3
+ *
4
+ * This module re-exports all constants for the Recommendation extension.
5
+ * Import from this file for cleaner imports.
6
+ * @example
7
+ * import { RecommendationBlockId, CONTAINER_SELECTOR } from './constants';
8
+ */
9
+ export { RecommendationBlockId } from './blockIds';
10
+ export { RecommendationControlId } from './controlIds';
11
+ export { CONTAINER_SELECTOR, 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, } from './selectors';
12
+ export { LAYOUT_VALUES, LAYOUT_OPTIONS, DEFAULT_PRODUCTS_PER_ROW, DEFAULT_CARDS_IN_ROW, MAX_PRODUCT_COUNT, MIN_PRODUCT_COUNT, MAX_PRODUCTS_PER_ROW, MIN_PRODUCTS_PER_ROW, DEFAULT_COLUMN_SPACING, DEFAULT_ROW_SPACING, MIN_SPACING, MAX_SPACING, SPACING_STEP, } from './layout';
13
+ export { DEFAULT_NODE_CONFIG, DEFAULT_CURRENCY, DEFAULT_COMPOSITION, DEFAULT_VISIBILITY, CURRENT_CONFIG_VERSION, } from './defaultConfig';
@@ -0,0 +1,35 @@
1
+ /** Type-safe layout orientation values */
2
+ export declare const LAYOUT_VALUES: {
3
+ GRID: "grid";
4
+ LIST: "list";
5
+ };
6
+ /** Layout options for radio button UI control */
7
+ export declare const LAYOUT_OPTIONS: ({
8
+ icon: string;
9
+ value: "grid";
10
+ } | {
11
+ icon: string;
12
+ value: "list";
13
+ })[];
14
+ /** Default number of products displayed per row in grid layout */
15
+ export declare const DEFAULT_PRODUCTS_PER_ROW = 3;
16
+ /** Default number of cards in a row (used in store initialization) */
17
+ export declare const DEFAULT_CARDS_IN_ROW = 3;
18
+ /** Maximum number of products that can be displayed */
19
+ export declare const MAX_PRODUCT_COUNT = 9;
20
+ /** Minimum number of products that can be displayed */
21
+ export declare const MIN_PRODUCT_COUNT = 1;
22
+ /** Maximum number of products per row in grid layout */
23
+ export declare const MAX_PRODUCTS_PER_ROW = 4;
24
+ /** Minimum number of products per row in grid layout */
25
+ export declare const MIN_PRODUCTS_PER_ROW = 1;
26
+ /** Default column spacing between product cards (5px on each side = 10px total) */
27
+ export declare const DEFAULT_COLUMN_SPACING = 10;
28
+ /** Default row spacing between product rows */
29
+ export declare const DEFAULT_ROW_SPACING = 20;
30
+ /** Minimum spacing value */
31
+ export declare const MIN_SPACING = 0;
32
+ /** Maximum spacing value */
33
+ export declare const MAX_SPACING = 50;
34
+ /** Spacing adjustment step */
35
+ export declare const SPACING_STEP = 5;
@@ -0,0 +1,31 @@
1
+ /**
2
+ * CSS selectors and data attributes used across the Recommendation extension
3
+ */
4
+ /**
5
+ * Container selector for the product container element
6
+ * Used across controls to target elements within the recommendation block
7
+ */
8
+ export declare const CONTAINER_SELECTOR = ".ins-recommendation-product-container";
9
+ /**
10
+ * Currency HTML attributes set on the block element
11
+ * These are read by the HTML compiler at runtime to format prices
12
+ */
13
+ export declare const CURRENCY_ATTR: {
14
+ readonly CURRENCY: "currency";
15
+ readonly SYMBOL: "currency-symbol";
16
+ readonly ALIGNMENT: "currency-alignment";
17
+ readonly THOUSAND_SEPARATOR: "currency-thousand-separator";
18
+ readonly DECIMAL_SEPARATOR: "currency-decimal-separator";
19
+ readonly DECIMAL_COUNT: "currency-decimal-count";
20
+ };
21
+ /**
22
+ * Attribute type constants used in templates
23
+ * These are used as keys in ElementRenderer and composition arrays
24
+ */
25
+ export declare const ATTR_PRODUCT_IMAGE = "productImage";
26
+ export declare const ATTR_PRODUCT_NAME = "productName";
27
+ export declare const ATTR_PRODUCT_PRICE = "productPrice";
28
+ export declare const ATTR_PRODUCT_OLD_PRICE = "productOldPrice";
29
+ export declare const ATTR_PRODUCT_OMNIBUS_PRICE = "productOmnibusPrice";
30
+ export declare const ATTR_PRODUCT_OMNIBUS_DISCOUNT = "productOmnibusDiscount";
31
+ export declare const ATTR_PRODUCT_BUTTON = "productButton";