@useinsider/guido 3.6.0 → 3.7.0-beta.509616e

package/dist/src/extensions/Blocks/Recommendation/templates/grid/elementRenderer.d.ts

@@ -17,4 +17,11 @@ export declare const DEFAULT_CELL_PADDING = "0 5px";
  * Used by controls to reliably select direct children for spacing adjustments
  */
 export declare const ATTRIBUTE_CELL_CLASS = "attribute-cell";
+/**
+ * Builds an empty filler cell used to pad incomplete rows (productsPerRow >
+ * number of products). Without fillers, table-layout:fixed redistributes the
+ * width among fewer cells and stretches them. Shared by the template and the
+ * card-composition control so both render identical filler markup.
+ */
+export declare function buildFillerCell(columnWidth: string, padding?: string): string;
 export declare const gridElementRenderer: ElementRenderer;

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

@@ -6,7 +6,7 @@
  */
 import type { RecommendationProduct } from '@@/Types/recommendation';
 import { type Orientation, type PrepareProductRowsOptions } from './utils';
-export { DEFAULTS, DEFAULT_CARD_COMPOSITION, DEFAULT_CARD_VISIBILITY, getDefaultProducts, spacer, sanitizeImageUrl, createBlockTemplate, type Orientation, type PrepareProductRowsOptions, type ElementRenderer, type ProductCardGetter, } from './utils';
+export { DEFAULTS, DEFAULT_CARD_COMPOSITION, DEFAULT_CARD_VISIBILITY, getDefaultProducts, spacer, sanitizeImageUrl, createBlockTemplate, toDisplayableAttributeValue, type Orientation, type PrepareProductRowsOptions, type ElementRenderer, type ProductCardGetter, } from './utils';
 /**
  * Unified function to prepare product rows for any layout.
  * Delegates to the appropriate layout-specific implementation.

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

@@ -5,6 +5,14 @@ import { ATTR_PRODUCT_IMAGE, ATTR_PRODUCT_NAME, ATTR_PRODUCT_PRICE, ATTR_PRODUCT
  * e.g., "rating_star" → "Rating Star"
  */
 export declare function toDisplayName(attrName: string): string;
+/**
+ * Reduces a raw product-attribute value to a displayable scalar string.
+ * Array-type attributes (filter types `Strings`/`Numbers`) are substituted with
+ * their last item by the email renderer at send time, so we mirror that here to
+ * keep the editor preview consistent with what is actually sent.
+ * Returns undefined when there is no displayable string/number.
+ */
+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`).

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

@@ -0,0 +1 @@
+export {};

package/dist/src/extensions/Blocks/Recommendation/useRecommendationBlockWarning.d.ts

@@ -0,0 +1,12 @@
+import type { QueryableRoot } from './utils/recommendationBlockCount';
+/**
+ * Advisory shown when a design ends up with more than one recommendation block,
+ * since multiple blocks can slow campaign delivery. Driven from the block
+ * lifecycle (`onCreated` for direct drop / duplicate, counting the editor's
+ * document root). `onCreated` also fires for a reco block that arrives inside a
+ * saved structure (SD-143028), so that case is covered without a separate
+ * `module_dropped` re-check.
+ */
+export declare const useRecommendationBlockWarning: () => {
+    warnIfMultipleBlocks: (root: QueryableRoot) => void;
+};

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

@@ -0,0 +1,7 @@
+/**
+ * Returns the extra recommendation feed query params for an account, if any.
+ * Accounts without customizations get an empty object.
+ * @param partnerName Account subdomain (`config.partner.name`)
+ * @param strategy    Recommendation strategy key of the block
+ */
+export declare function getPartnerRecommendationParams(partnerName: string, strategy: string): Record<string, string>;

package/dist/src/extensions/Blocks/Recommendation/utils/priceFormatter.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,28 @@
+/**
+ * Counts *live* recommendation blocks in a document.
+ *
+ * Deleting a recommendation block strips its inner content but leaves an empty
+ * `.recommendation-block-v2` container shell behind — present in every document
+ * representation the editor exposes (`getDocumentRoot`, `getDocumentRootHtmlNode`
+ * and even `getTemplateData`). A raw class count therefore over-reports after a
+ * delete→add cycle (SD-143028). The product row (`.recommendation-product-row`)
+ * is present on every live block from drop time (the default template ships
+ * product rows, both grid and list layouts) and is removed from a deleted
+ * block's leftover shell, so filtering by it cleanly separates live blocks from
+ * ghosts without reading any store.
+ */
+export declare const RECOMMENDATION_BLOCK_SELECTOR = ".recommendation-block-v2";
+export declare const RECOMMENDATION_PRODUCT_ROW_SELECTOR = ".recommendation-product-row";
+interface QueryableNode {
+    querySelector(selector: string): unknown;
+}
+export interface QueryableRoot {
+    querySelectorAll(selector: string): Iterable<QueryableNode>;
+}
+/**
+ * Counts the live recommendation blocks reachable from `root`. Works on the
+ * editor's `ImmutableHtmlNode` document root (the `onCreated` drop / duplicate
+ * paths) and on any DOM-like root exposing `querySelectorAll`.
+ */
+export declare function countLiveRecommendationBlocks(root: QueryableRoot): number;
+export {};

package/dist/src/extensions/Blocks/Recommendation/utils/recommendationBlockCount.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/utils/ampErrorFilter.d.ts

@@ -0,0 +1,2 @@
+export declare const AMP_ERROR_WHITELISTED_TOKENS: string[];
+export declare const filterAmpErrors: (ampErrors: string[]) => string[];

package/dist/src/utils/ampErrorFilter.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/utils/templatePreparation.d.ts

@@ -1,4 +1,20 @@
 import type { SavedTemplateDetails } from '@@/Types/stripo';
+/**
+ * Collects every unsubscribe page id referenced by the unsubscribe blocks
+ * present in the email HTML, deduped.
+ *
+ * The email's unsubscribe link is variation-scoped on the backend, which
+ * resolves the page to render from the page ids the FE persists for that
+ * variation. Those ids must reflect the blocks actually in the email — not a
+ * UI-only selection store — otherwise a block that entered the editor by any
+ * path other than the page-selection UI (e.g. a dropped saved module) sends an
+ * empty association and the backend falls back to the default page.
+ *
+ * Read from raw editor HTML: the `data-unsubscribe-page-list` attribute lives
+ * on the block node there (the save-time sync-module extractor relies on the
+ * same source), so it is reliably present regardless of how the block was added.
+ */
+export declare function getHtmlReferencedUnsubscribePages(html: string): number[];
 export declare const useTemplatePreparation: () => {
     prepareTemplateDetails: () => Promise<Omit<SavedTemplateDetails, "metadata">>;
 };

package/dist/src/utils/templatePreparation.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/utils/ampErrorFilter.js

@@ -0,0 +1,8 @@
+import { MERGE_TAGS as t } from "../enums/unsubscribe.js";
+const E = Object.values(t), c = (r) => r.filter(
+  (e) => !E.some((o) => e.includes(o))
+);
+export {
+  E as AMP_ERROR_WHITELISTED_TOKENS,
+  c as filterAmpErrors
+};

package/dist/utils/templatePreparation.js

@@ -1,58 +1,58 @@
-import { useActionsApi as C } from "../composables/useActionsApi.js";
-import { useHtmlCompiler as T } from "../composables/useHtmlCompiler.js";
-import { DEFAULT_CURRENCY as d, DEFAULT_NODE_CONFIG as s } from "../extensions/Blocks/Recommendation/constants/defaultConfig.js";
+import { useActionsApi as P } from "../composables/useActionsApi.js";
+import { useHtmlCompiler as w } from "../composables/useHtmlCompiler.js";
+import { DEFAULT_CURRENCY as l, DEFAULT_NODE_CONFIG as i } from "../extensions/Blocks/Recommendation/constants/defaultConfig.js";
 import { useRecommendationExtensionStore as b } from "../extensions/Blocks/Recommendation/store/recommendation.js";
-import { DATA_ATTRIBUTES as S } from "../extensions/Blocks/Unsubscribe/utils/constants.js";
-import { parsePageList as D } from "../extensions/Blocks/Unsubscribe/utils/utils.js";
-import { useDynamicContentStore as P } from "../stores/dynamic-content.js";
-import { useUnsubscribeStore as w } from "../stores/unsubscribe.js";
-function E(i, o) {
-  const t = new DOMParser().parseFromString(i, "text/html").querySelectorAll(`[${S.PAGE_LIST}]`), c = [];
-  return t.forEach((r) => {
-    const a = r.getAttribute(S.PAGE_LIST);
-    a && c.push(...D(a));
-  }), o.filter((r) => c.includes(r));
+import { DATA_ATTRIBUTES as h } from "../extensions/Blocks/Unsubscribe/utils/constants.js";
+import { parsePageList as E } from "../extensions/Blocks/Unsubscribe/utils/utils.js";
+import { useDynamicContentStore as H } from "../stores/dynamic-content.js";
+import { useUnsubscribeStore as U } from "../stores/unsubscribe.js";
+function F(s) {
+  const o = new DOMParser().parseFromString(s, "text/html").querySelectorAll(`[${h.PAGE_LIST}]`), t = [];
+  return o.forEach((n) => {
+    const a = n.getAttribute(h.PAGE_LIST);
+    a && t.push(...E(a));
+  }), [...new Set(t)];
 }
-async function U(i) {
-  const m = new DOMParser().parseFromString(i, "text/html").querySelectorAll(".recommendation-block-v2");
+async function R(s) {
+  const m = new DOMParser().parseFromString(s, "text/html").querySelectorAll(".recommendation-block-v2");
   if (m.length === 0)
     return;
-  const l = b();
+  const o = b();
   m.forEach((t) => {
-    var g, f, u, n, y;
-    const c = t.getAttribute("recommendation-id"), r = c ? Number(c) : NaN;
-    if (!Number.isFinite(r))
+    var c, p, g, f, r;
+    const n = t.getAttribute("recommendation-id"), a = n ? Number(n) : NaN;
+    if (!Number.isFinite(a))
       return;
-    const a = t.getAttribute("esd-ext-config");
-    if (!a)
+    const d = t.getAttribute("esd-ext-config");
+    if (!d)
       return;
     let e;
     try {
-      e = JSON.parse(a);
+      e = JSON.parse(d);
     } catch {
       return;
     }
     if (!e || typeof e != "object" || Array.isArray(e))
       return;
-    const p = {
-      strategy: e.strategy ?? s.strategy,
-      language: e.language ?? s.language,
-      size: e.size ?? s.size,
+    const y = {
+      strategy: e.strategy ?? i.strategy,
+      language: e.language ?? i.language,
+      size: e.size ?? i.size,
       // Spread the default arrays so each block gets a fresh reference
       // instead of sharing the singleton in DEFAULT_NODE_CONFIG.
-      productIds: e.productIds ?? [...s.productIds],
-      filters: e.filters ?? [...s.filters],
-      shuffleProducts: e.shuffleProducts ?? s.shuffleProducts,
-      currencyCode: ((g = e.currency) == null ? void 0 : g.code) ?? d.code,
-      currencyAlignment: ((f = e.currency) == null ? void 0 : f.alignment) ?? d.alignment,
-      currencyDecimalCount: ((u = e.currency) == null ? void 0 : u.decimalCount) ?? d.decimalCount,
-      currencyDecimalSeparator: ((n = e.currency) == null ? void 0 : n.decimalSeparator) ?? d.decimalSeparator,
-      currencyThousandSeparator: ((y = e.currency) == null ? void 0 : y.thousandSeparator) ?? d.thousandSeparator
+      productIds: e.productIds ?? [...i.productIds],
+      filters: e.filters ?? [...i.filters],
+      shuffleProducts: e.shuffleProducts ?? i.shuffleProducts,
+      currencyCode: ((c = e.currency) == null ? void 0 : c.code) ?? l.code,
+      currencyAlignment: ((p = e.currency) == null ? void 0 : p.alignment) ?? l.alignment,
+      currencyDecimalCount: ((g = e.currency) == null ? void 0 : g.decimalCount) ?? l.decimalCount,
+      currencyDecimalSeparator: ((f = e.currency) == null ? void 0 : f.decimalSeparator) ?? l.decimalSeparator,
+      currencyThousandSeparator: ((r = e.currency) == null ? void 0 : r.thousandSeparator) ?? l.thousandSeparator
     };
-    l.seedBlockUrlConfig(r, p);
+    o.seedBlockUrlConfig(a, y);
   });
   try {
-    await l.fetchRecommendationCreateData();
+    await o.fetchRecommendationCreateData();
   } catch (t) {
     console.warn(
       "Recommendation reference data pre-load failed; validator will skip the availability check.",
@@ -60,42 +60,43 @@ async function U(i) {
     );
   }
 }
-const _ = () => {
-  const i = P(), o = w(), { getCompiledEmail: m, getTemplateData: l } = C(), { compileHtml: t } = T();
+const v = () => {
+  const s = H(), u = U(), { getCompiledEmail: m, getTemplateData: o } = P(), { compileHtml: t, compileAmpHtml: n } = w();
   return {
     prepareTemplateDetails: async () => {
-      const { html: r, ampHtml: a = "", ampErrors: e = [] } = await m({
+      const { html: d, ampHtml: e = "", ampErrors: y = [] } = await m({
         minimize: !0,
         resetDataSavedFlag: !1
-      }), { html: p, css: g, syncModulesIds: f = [] } = await l();
-      o.selectedUnsubscribePages.length && await o.fetchTemplates(), await U(p);
-      const { compiledHtml: u, stats: n, appliedRules: y } = t(r), h = i.getSelectedDynamicContentList, A = b();
+      }), { html: c, css: p, syncModulesIds: g = [] } = await o();
+      u.selectedUnsubscribePages.length && await u.fetchTemplates(), await R(c);
+      const { compiledHtml: f, stats: r, appliedRules: A } = t(d), C = e && n(e).compiledHtml, T = s.getSelectedDynamicContentList, D = b(), S = F(c);
       return console.debug("HTML Compilation Stats:", {
-        originalSize: n.originalSize,
-        compiledSize: n.compiledSize,
-        reduction: `${n.reductionPercentage.toFixed(2)}%`,
-        appliedRules: y,
-        executionTime: `${n.executionTime.toFixed(2)}ms`
+        originalSize: r.originalSize,
+        compiledSize: r.compiledSize,
+        reduction: `${r.reductionPercentage.toFixed(2)}%`,
+        appliedRules: A,
+        executionTime: `${r.executionTime.toFixed(2)}ms`
       }), {
-        dynamicContentList: h,
-        compiledHtml: u,
-        rawHtml: p,
-        css: g,
-        ampHtml: a,
-        ampErrors: e,
-        modules: f.map(Number),
+        dynamicContentList: T,
+        compiledHtml: f,
+        rawHtml: c,
+        css: p,
+        ampHtml: C,
+        ampErrors: y,
+        modules: g.map(Number),
         recommendation: {
-          campaignUrls: A.recommendationCampaignUrls,
+          campaignUrls: D.recommendationCampaignUrls,
           configs: {}
         },
         unsubscribe: {
-          status: o.unsubscribePagesStatus,
-          config: E(u, o.selectedUnsubscribePages)
+          status: S.length > 0,
+          config: S
         }
       };
     }
   };
 };
 export {
-  _ as useTemplatePreparation
+  F as getHtmlReferencedUnsubscribePages,
+  v as useTemplatePreparation
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@useinsider/guido",
-  "version": "3.6.0",
+  "version": "3.7.0-beta.509616e",
   "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",