@useinsider/guido 3.2.0-beta.f15b321 → 3.2.0-beta.f5e9ee4

package/README.md

@@ -496,18 +496,6 @@ npm install ../guido/useinsider-guido-1.0.0.tgz
 
 ---
 
-## Documentation
-
-Internal documentation for contributors and the release process lives in [`wiki/`](./wiki/):
-
-| Document | Purpose |
-|---|---|
-| [`wiki/RELEASING.md`](./wiki/RELEASING.md) | Release policy — Thursday train cadence, hotfix lane, cross-repo coupled changes, bootstrap checklist |
-| [`wiki/SEMANTIC_VERSIONING.md`](./wiki/SEMANTIC_VERSIONING.md) | How version numbers are assigned (conventional commits + release-please) |
-| [`wiki/release-policy-playground.html`](./wiki/release-policy-playground.html) | 🎮 Interactive playground — pick a release scenario, see workflows + branches + step-by-step actions. Recommended for first-time onboarding. Open the file directly in a browser. |
-
----
-
 ## License
 
 ISC License

package/dist/extensions/Blocks/Recommendation/block.js

@@ -8,8 +8,8 @@ import { regenerateMobileProductRows as C } from "./controls/main/utils.js";
 import { ensureMobileCssRulesExist as g, setMobileLayoutOptOut as d, hasMobileLayoutOptOut as A } from "./controls/mobileLayout/cssRules.js";
 import { RecommendationConfigService as c } from "./services/configService.js";
 import { useRecommendationExtensionStore as p } from "./store/recommendation.js";
-import { getDefaultTemplate as E } from "./templates/grid/template.js";
-const f = B.Recommendation, a = "recommendation-block-v2", l = "recommendation-id";
+import { getDefaultTemplate as D } from "./templates/grid/template.js";
+const f = B.Recommendation, l = "recommendation-block-v2", m = "recommendation-id";
 let h = !1;
 class q extends b {
   constructor() {
@@ -56,7 +56,7 @@ class q extends b {
    */
   getTemplate() {
     const t = this._generateNextId();
-    return this._pendingBlockId = t, E(t);
+    return this._pendingBlockId = t, D(t);
   }
   /**
    * Called when a new block is dropped into the template
@@ -68,13 +68,20 @@ class q extends b {
   onCreated(t) {
     const e = this._pendingBlockId ?? this._generateNextId();
     this._pendingBlockId = null, this._assignRecommendationId(t, e);
-    const o = c.initializeConfig(this.api, t, { recommendationId: e }), i = p();
-    i.setCurrentBlock(e), g(this.api);
-    const s = this._getBlockElement(t);
-    s && (d(this.api, s, !0), C({
-      currentNode: t,
-      documentModifier: this.api.getDocumentModifier()
-    })), i.patchCurrentBlockConfig({ language: o.language }, { triggerRefetch: !1 });
+    const { config: i, wasFreshDrop: o } = c.initializeConfig(
+      this.api,
+      t,
+      { recommendationId: e }
+    ), s = p();
+    if (s.setCurrentBlock(e), o) {
+      g(this.api);
+      const a = this._getBlockElement(t);
+      a && (d(this.api, a, !0), C({
+        currentNode: t,
+        documentModifier: this.api.getDocumentModifier()
+      }));
+    }
+    s.patchCurrentBlockConfig({ language: i.language }, { triggerRefetch: !1 });
   }
   /**
    * Called when the document changes or template is loaded
@@ -97,10 +104,10 @@ class q extends b {
       c.needsMigration(t) && this._migrateFromLegacy(t);
       try {
         h || (g(this.api), h = !0);
-        const e = c.getConfig(t), o = this._getBlockElement(t);
-        if (o) {
-          const i = !e.mobileLayoutEnabled;
-          A(o) !== i && d(this.api, o, i);
+        const e = c.getConfig(t), i = this._getBlockElement(t);
+        if (i) {
+          const o = !e.mobileLayoutEnabled;
+          A(i) !== o && d(this.api, i, o);
         }
       } catch {
       }
@@ -124,10 +131,10 @@ class q extends b {
     let t = 0;
     try {
       const e = this.api.getDocumentRoot();
-      e && "querySelectorAll" in e && e.querySelectorAll(`.${a}`).forEach((i) => {
-        if ("getAttribute" in i) {
-          const s = i.getAttribute(l), m = s ? parseInt(s) : 0;
-          m > t && (t = m);
+      e && "querySelectorAll" in e && e.querySelectorAll(`.${l}`).forEach((o) => {
+        if ("getAttribute" in o) {
+          const s = o.getAttribute(m), a = s ? parseInt(s) : 0;
+          a > t && (t = a);
         }
       });
     } catch {
@@ -141,11 +148,11 @@ class q extends b {
    * added classes via setAttribute.
    */
   _assignRecommendationId(t, e) {
-    const o = this._getBlockElement(t);
-    if (!o)
+    const i = this._getBlockElement(t);
+    if (!i)
       return;
-    const i = this.api.getDocumentModifier();
-    i.modifyHtml(o).setAttribute(l, e.toString()), i.apply(new y(`Assign recommendation ID ${e}`));
+    const o = this.api.getDocumentModifier();
+    o.modifyHtml(i).setAttribute(m, e.toString()), o.apply(new y(`Assign recommendation ID ${e}`));
   }
   /**
    * Gets the recommendation-id from a block node
@@ -154,11 +161,11 @@ class q extends b {
     const e = this._getBlockElement(t);
     if (!e || !("getAttribute" in e))
       return null;
-    const o = e.getAttribute(l);
-    if (!o)
+    const i = e.getAttribute(m);
+    if (!i)
       return null;
-    const i = parseInt(o);
-    return Number.isNaN(i) ? null : i;
+    const o = parseInt(i);
+    return Number.isNaN(o) ? null : o;
   }
   /**
    * Gets the block element (the element with BLOCK_CLASS)
@@ -166,10 +173,10 @@ class q extends b {
   _getBlockElement(t) {
     if ("getAttribute" in t) {
       const e = t.getAttribute("class");
-      if (e && e.includes(a))
+      if (e && e.includes(l))
         return t;
     }
-    return "querySelector" in t ? t.querySelector(`.${a}`) ?? null : null;
+    return "querySelector" in t ? t.querySelector(`.${l}`) ?? null : null;
   }
   /**
    * Migrate configuration from legacy format

package/dist/extensions/Blocks/Recommendation/services/configService.js

@@ -85,21 +85,28 @@ class C {
    *
    * Called when a block is first created (dropped into template).
    * Can optionally merge in partial config from migration.
+   *
+   * The `wasFreshDrop` flag distinguishes a brand-new drop (no prior config)
+   * from a clone (Stripo replays the source's setNodeConfig payload before
+   * onCreated fires). Callers use this to skip side-effects already inherited
+   * from the source.
    * @example
    * // In Block.onCreated lifecycle
-   * RecommendationConfigService.initializeConfig(this.api, node);
+   * const { config, wasFreshDrop } = RecommendationConfigService.initializeConfig(this.api, node);
    * @param api - Stripo extension API with document modifier
    * @param node - The immutable HTML node to initialize
    * @param partialConfig - Optional partial config to merge with defaults
-   * @returns The initialized configuration
+   * @returns The initialized configuration and whether the node was a fresh drop
    */
   static initializeConfig(i, t, o) {
+    if (this.hasConfig(t))
+      return { config: o ? this.updateConfig(i, t, o, "Initialize recommendation block") : this.getConfig(t), wasFreshDrop: !1 };
     const n = o ? this.mergeWithDefaults(o) : this.cloneDefaults();
     return this.saveConfig(i, t, n, "Initialize recommendation block"), g({
       currentNode: t,
       documentModifier: i.getDocumentModifier(),
       currency: n.currency
-    }), n;
+    }), { config: n, wasFreshDrop: !0 };
   }
   /**
    * Save complete configuration to a node
@@ -143,7 +150,7 @@ class C {
       const c = t.getAttribute("data-row-spacing");
       c && (o.rowSpacing = parseInt(c) || e.rowSpacing);
     }
-    return this.initializeConfig(i, t, o);
+    return this.initializeConfig(i, t, o).config;
   }
   /**
    * Check if configuration needs migration

package/dist/src/extensions/Blocks/Recommendation/services/configService.d.ts

@@ -95,15 +95,23 @@ export declare class RecommendationConfigService {
      *
      * Called when a block is first created (dropped into template).
      * Can optionally merge in partial config from migration.
+     *
+     * The `wasFreshDrop` flag distinguishes a brand-new drop (no prior config)
+     * from a clone (Stripo replays the source's setNodeConfig payload before
+     * onCreated fires). Callers use this to skip side-effects already inherited
+     * from the source.
      * @example
      * // In Block.onCreated lifecycle
-     * RecommendationConfigService.initializeConfig(this.api, node);
+     * const { config, wasFreshDrop } = RecommendationConfigService.initializeConfig(this.api, node);
      * @param api - Stripo extension API with document modifier
      * @param node - The immutable HTML node to initialize
      * @param partialConfig - Optional partial config to merge with defaults
-     * @returns The initialized configuration
+     * @returns The initialized configuration and whether the node was a fresh drop
      */
-    static initializeConfig(api: DocumentModifierApi, node: ImmutableHtmlNode, partialConfig?: PartialNodeConfig): RecommendationNodeConfig;
+    static initializeConfig(api: DocumentModifierApi, node: ImmutableHtmlNode, partialConfig?: PartialNodeConfig): {
+        config: RecommendationNodeConfig;
+        wasFreshDrop: boolean;
+    };
     /**
      * Save complete configuration to a node
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@useinsider/guido",
-  "version": "3.2.0-beta.f15b321",
+  "version": "3.2.0-beta.f5e9ee4",
   "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",