@useinsider/guido 3.18.2 → 3.19.0

package/README.md

@@ -561,6 +561,26 @@ import {
 import '@useinsider/guido/style';
 ```
 
+### Subpath entries
+
+Two surfaces also ship as their own entry points. Importing one pulls in only its
+own dependencies, so a consumer that needs the store or the tracking-id helpers
+never loads the editor:
+
+```typescript
+// Live editor state, published by the editor into the host's shared Pinia instance.
+// Store id `guidoEmailEditor` is the cross-app contract — read it, do not redeclare it.
+import { useGuidoEmailEditorStore } from '@useinsider/guido/editor-state';
+import type { GuidoEmailEditorState } from '@useinsider/guido/editor-state';
+
+// Persistent link ids for the click heatmap.
+import { assignTrackingIds, TRACK_ID_ATTRIBUTE } from '@useinsider/guido/tracking-ids';
+import type { TrackingIdResult } from '@useinsider/guido/tracking-ids';
+```
+
+Both are re-exported from the root barrel as well; the subpath is what keeps the
+editor out of the consumer's module graph.
+
 ---
 
 ## Constants

package/dist/components/organisms/save-as-template/SaveAsTemplateDrawer.vue2.js

@@ -1,64 +1,64 @@
-import { defineComponent as A, ref as c, computed as b, toRef as h, nextTick as C } from "vue";
-import N from "../../wrappers/WpDrawer.vue.js";
-import { useTranslations as O } from "../../../composables/useTranslations.js";
+import { defineComponent as _, ref as c, computed as h, watch as C, toRef as N, nextTick as O } from "vue";
+import b from "../../wrappers/WpDrawer.vue.js";
+import { useTranslations as D } from "../../../composables/useTranslations.js";
 import { useTemplateNameValidator as x } from "../../../composables/validators/saveAsTemplate.js";
 import { useTemplateLibraryApi as B } from "../../../services/templateLibraryApi.js";
-import { useEditorStore as D } from "../../../stores/editor.js";
-import { useSaveAsTemplateStore as k } from "../../../stores/save-as-template.js";
-import { InMultiSelect as I, InBasicTextInput as M } from "@useinsider/design-system-vue";
-import { useDebounceFn as V } from "../../../node_modules/@vueuse/shared/index.js";
-const H = /* @__PURE__ */ A({
+import { useEditorStore as k } from "../../../stores/editor.js";
+import { useSaveAsTemplateStore as I } from "../../../stores/save-as-template.js";
+import { InMultiSelect as M, InBasicTextInput as V } from "@useinsider/design-system-vue";
+import { useDebounceFn as E } from "../../../node_modules/@vueuse/shared/index.js";
+const J = /* @__PURE__ */ _({
   __name: "SaveAsTemplateDrawer",
-  setup(E) {
-    const o = O(), n = D(), t = k(), { createTemplate: m } = B(), a = c(!1), r = c(!1), l = c(""), f = b(() => ({
+  setup(R) {
+    const s = D(), o = k(), t = I(), { createTemplate: m } = B(), a = c(!1), n = c(!1), r = c(""), f = h(() => ({
       primaryButton: {
         styling: "solid",
         type: "primary",
-        labelText: o(a.value ? "newsletter.saving" : "products.save"),
+        labelText: s(a.value ? "newsletter.saving" : "products.save"),
         loadingStatus: a.value,
         disabledStatus: t.skeletonStatus
       },
       cancelOrBackButton: {
         styling: "ghost",
         type: "secondary",
-        labelText: o("products.cancel"),
+        labelText: s("products.cancel"),
         disabledStatus: a.value
       }
-    })), u = () => {
-      l.value = "", n.isSaveAsTemplateDrawerOpen = !1;
-    }, i = async () => {
-      const e = h(t, "templateName"), { success: s, errorMessage: _ } = await x(e).validate();
-      return l.value = _, s;
-    }, v = V(async (e) => {
-      t.templateName = e, await i();
-    }, 500), g = async (e) => {
-      r.value = !0, await t.addCategory(e), r.value = !1;
-    }, y = (e) => {
+    })), p = () => {
+      r.value = "", o.isSaveAsTemplateDrawerOpen = !1;
+    }, l = async () => {
+      const e = N(t, "templateName"), { success: i, errorMessage: A } = await x(e).validate();
+      return r.value = A, i;
+    }, v = E(async (e) => {
+      t.templateName = e, await l();
+    }, 500), S = async (e) => {
+      n.value = !0, await t.addCategory(e), n.value = !1;
+    }, T = (e) => {
       t.selectedCategories = e;
-    }, S = (e) => {
+    }, g = (e) => {
       e && (t.selectedCategories = e);
-    }, T = () => {
+    }, y = () => {
       t.selectedCategories = [];
     }, w = async () => {
-      if (a.value = !0, !await i()) {
+      if (a.value = !0, !await l()) {
         a.value = !1;
         return;
       }
-      const s = await m();
-      a.value = !1, s && u();
-    }, p = () => {
-      C(() => {
+      const i = await m();
+      a.value = !1, i && p();
+    }, u = () => {
+      O(() => {
         const e = document.querySelector("input#guido__template-name-input");
         e == null || e.focus();
       });
     }, d = async () => {
-      t.$reset(), await t.fetchCategories(), t.skeletonStatus = !1, p();
+      t.$reset(), await t.fetchCategories(), t.skeletonStatus = !1, u();
     };
-    return n.$subscribe((e, { isSaveAsTemplateDrawerOpen: s }) => {
-      s && d();
-    }), { __sfc: !0, trans: o, editorStore: n, saveAsTemplateStore: t, createTemplate: m, isSaving: a, isAddingOption: r, templateNameError: l, footerButtonGroupOptions: f, closeModal: u, validateTemplateName: i, handleTemplateName: v, handleAddOption: g, handleCategoryChange: y, handleSelectAllOptions: S, handleResetAllOptions: T, saveTemplate: w, focusToInput: p, initializeDrawer: d, WpDrawer: N, InBasicTextInput: M, InMultiSelect: I };
+    return C(() => o.isSaveAsTemplateDrawerOpen, (e) => {
+      e && d();
+    }), { __sfc: !0, trans: s, editorStore: o, saveAsTemplateStore: t, createTemplate: m, isSaving: a, isAddingOption: n, templateNameError: r, footerButtonGroupOptions: f, closeModal: p, validateTemplateName: l, handleTemplateName: v, handleAddOption: S, handleCategoryChange: T, handleSelectAllOptions: g, handleResetAllOptions: y, saveTemplate: w, focusToInput: u, initializeDrawer: d, WpDrawer: b, InBasicTextInput: V, InMultiSelect: M };
   }
 });
 export {
-  H as default
+  J as default
 };

package/dist/composables/useGuidoStateBridge.js

@@ -1,54 +1,59 @@
-import { useActionsApi as b } from "./useActionsApi.js";
-import { useEditorLock as v } from "./useEditorLock.js";
+import { useActionsApi as v } from "./useActionsApi.js";
+import { useEditorLock as C } from "./useEditorLock.js";
 import { useConfigStore as T } from "../stores/config.js";
 import { useEditorStore as w } from "../stores/editor.js";
 import { useGuidoEmailEditorStore as y } from "../stores/guido-email-editor.js";
-import { watch as a, onUnmounted as B } from "vue";
-const C = 500, L = () => {
-  const i = w(), u = y(), l = T(), { getTemplateData: d } = b(), { runExclusive: m, isEditorBusy: p } = v();
-  let o = null, s = !1;
-  const n = () => {
+import { watch as c, onUnmounted as z } from "vue";
+const B = 500, G = () => {
+  const i = w(), u = y(), d = T(), { getTemplateData: l } = v(), { runExclusive: m, isEditorBusy: p } = C();
+  let o = null, n = !1;
+  const r = () => {
     o && (clearTimeout(o), o = null);
-  }, c = (t) => {
-    n(), o = setTimeout(() => {
+  }, a = (t) => {
+    r(), o = setTimeout(() => {
       o = null, t();
-    }, C);
+    }, B);
   }, e = async () => {
-    var t, r;
-    if (!(s || !i.isStripoInitialized)) {
+    var t, s;
+    if (!(n || !i.isStripoInitialized)) {
       if (p()) {
-        c(() => void e());
+        a(() => void e());
         return;
       }
       try {
-        const { html: E, css: g } = await m(d), I = ((r = (t = l.config) == null ? void 0 : t.identity) == null ? void 0 : r.templateId) ?? "";
-        if (s)
+        const { html: E, css: I } = await m(l), b = ((s = (t = d.config) == null ? void 0 : t.identity) == null ? void 0 : s.templateId) ?? "";
+        if (n)
           return;
         u.$patch({
           html: E ?? "",
-          css: g ?? "",
-          templateId: I,
+          css: I ?? "",
+          templateId: b,
           lastUpdatedAt: Date.now()
         });
       } catch {
       }
     }
-  }, f = () => c(() => void e()), h = a(
+  }, f = () => a(() => void e()), h = c(
     () => i.isStripoInitialized,
     (t) => {
       t && e();
     },
     { immediate: !0 }
-  ), S = a(
+  ), S = c(
+    () => i.changeSeq,
+    () => {
+      i.isStripoInitialized && f();
+    }
+  ), g = c(
     () => i.hasChanges,
-    (t, r) => {
-      i.isStripoInitialized && (t ? f() : r && (n(), e()));
+    (t, s) => {
+      !t && s && i.isStripoInitialized && (r(), e());
     }
   );
-  B(() => {
-    s = !0, n(), h(), S();
+  z(() => {
+    n = !0, r(), h(), S(), g();
   });
 };
 export {
-  L as useGuidoStateBridge
+  G as useGuidoStateBridge
 };

package/dist/composables/useHttp.js

@@ -1,14 +1,16 @@
-import { getCsrfToken as H } from "../utils/genericUtil.js";
-import { ref as p, computed as T } from "vue";
-const k = (b = {}) => {
-  const h = p(!1), a = p(null), u = p(null), g = T(() => h.value), y = T(() => a.value !== null), v = {
+import { getCsrfToken as O } from "../utils/genericUtil.js";
+import { ref as m, computed as T } from "vue";
+const X = (b = {}) => {
+  const p = m(!1), a = m(null), u = m(null), g = T(() => p.value), y = T(() => a.value !== null), v = {
     baseURL: "",
     timeout: 1e4,
     retry: 0,
     retryDelay: 1e3,
     headers: {
       "Content-Type": "application/json",
-      "X-CSRF-TOKEN": H()
+      "X-CSRF-TOKEN": O(),
+      Accept: "application/json",
+      "X-Requested-With": "XMLHttpRequest"
     },
     ...b
   }, w = (e, s) => {
@@ -22,22 +24,22 @@ const k = (b = {}) => {
     }, e);
   }), x = (e) => new Promise((s) => {
     setTimeout(s, e);
-  }), i = async (e, s, t, D = {}) => {
-    a.value = null, h.value = !0, u.value = new AbortController();
-    const n = { ...v, ...D }, L = w(s, n.baseURL), c = {
+  }), i = async (e, s, t, L = {}) => {
+    a.value = null, p.value = !0, u.value = new AbortController();
+    const n = { ...v, ...L }, D = w(s, n.baseURL), c = {
       method: e,
       headers: { ...n.headers },
       signal: u.value.signal,
       ...n
     };
     t && ["POST", "PUT", "PATCH"].includes(e) && (t instanceof FormData ? (delete c.headers["Content-Type"], c.body = t) : c.body = JSON.stringify(t));
-    const E = async (m = 0) => {
+    const E = async (h = 0) => {
       try {
-        const o = [fetch(L, c)];
+        const o = [fetch(D, c)];
         n.timeout && o.push(P(n.timeout));
         const r = await Promise.race(o);
         if (!r.ok) {
-          const O = `HTTP Error: ${r.status} ${r.statusText}`, d = new Error(O);
+          const H = `HTTP Error: ${r.status} ${r.statusText}`, d = new Error(H);
           throw d.status = r.status, d.statusText = r.statusText, d.response = r, d;
         }
         let f;
@@ -50,19 +52,19 @@ const k = (b = {}) => {
         };
       } catch (o) {
         const r = o instanceof Error && o.name === "AbortError";
-        if (m < (n.retry || 0) && !r)
-          return await x(n.retryDelay || 1e3), E(m + 1);
+        if (h < (n.retry || 0) && !r)
+          return await x(n.retryDelay || 1e3), E(h + 1);
         throw o instanceof Error ? o.name === "AbortError" ? a.value = { message: "Request was cancelled" } : a.value = { message: o.message } : a.value = o, o;
       }
     };
     try {
       return await E();
     } finally {
-      h.value = !1, u.value = null;
+      p.value = !1, u.value = null;
     }
-  }, C = (e, s) => i("GET", e, void 0, s), $ = (e, s, t) => i("POST", e, s, t), R = (e, s, t) => i("PUT", e, s, t), U = (e, s, t) => i("PATCH", e, s, t), A = (e, s) => i("DELETE", e, void 0, s), W = (e) => {
+  }, C = (e, s) => i("GET", e, void 0, s), R = (e, s, t) => i("POST", e, s, t), $ = (e, s, t) => i("PUT", e, s, t), q = (e, s, t) => i("PATCH", e, s, t), A = (e, s) => i("DELETE", e, void 0, s), U = (e) => {
     u.value && u.value.abort(e);
-  }, q = () => {
+  }, W = () => {
     a.value = null;
   };
   return {
@@ -73,14 +75,14 @@ const k = (b = {}) => {
     // Methods
     request: i,
     get: C,
-    post: $,
-    put: R,
-    patch: U,
+    post: R,
+    put: $,
+    patch: q,
     delete: A,
-    cancel: W,
-    clearError: q
+    cancel: U,
+    clearError: W
   };
 };
 export {
-  k as useHttp
+  X as useHttp
 };

package/dist/composables/useStripo.js

@@ -1,6 +1,6 @@
-import { useActionsApi as L } from "./useActionsApi.js";
-import { useBlocksConfig as O } from "./useBlocksConfig.js";
-import { useConfig as q } from "./useConfig.js";
+import { useActionsApi as x } from "./useActionsApi.js";
+import { useBlocksConfig as L } from "./useBlocksConfig.js";
+import { useConfig as O } from "./useConfig.js";
 import { useCustomInterfaceAppearance as H } from "./useCustomInterfaceAppearance.js";
 import { useFullStoryBridge as N } from "./useFullStoryBridge.js";
 import { useModuleRepair as j } from "./useModuleRepair.js";
@@ -17,7 +17,7 @@ import { buildMergeTagEntries as W, flattenDynamicContentList as Y } from "../ut
 import Z from "../package.json.js";
 let n = null;
 const Ce = () => {
-  const { features: c, template: u, isFeatureEnabled: m } = q(), { handleError: p, showToaster: k } = G(), { getToken: B, getCustomFonts: M, getSyncModulesStatus: T } = K(), { handleEvent: v } = z(), { handleModuleAdd: F } = j(), { getStripoBlocksConfig: A } = O(), { getStripoNotifications: V } = $(), f = () => n || (n = new Promise((i, s) => {
+  const { features: c, template: u, isFeatureEnabled: m } = O(), { handleError: p, showToaster: k } = G(), { getToken: B, getCustomFonts: M, getSyncModulesStatus: T } = K(), { handleEvent: v } = z(), { handleModuleAdd: F } = j(), { getStripoBlocksConfig: A } = L(), { getStripoNotifications: V } = $(), f = () => n || (n = new Promise((i, s) => {
     var d;
     if (document.getElementById("UiEditorScript")) {
       i();
@@ -88,8 +88,8 @@ const Ce = () => {
         },
         onTemplateLoaded() {
           try {
-            const { importCss: t } = H(), { activateCustomViewStyles: l, updateTimerInClonedTemplate: I } = L(), { injectFullStory: x } = N();
-            t(), l(), x(), I(), o.onReady(), e.isStripoInitialized = !0, e.loadingStatus = !1, setTimeout(() => {
+            const { importCss: t } = H(), { activateCustomViewStyles: l, updateTimerInClonedTemplate: I } = x(), { injectFullStory: q } = N();
+            t(), l(), q(), I(), o.onReady(), e.isStripoInitialized = !0, e.loadingStatus = !1, setTimeout(() => {
               e.hasChanges = !1;
             }, 1e3);
           } catch (t) {
@@ -106,7 +106,7 @@ const Ce = () => {
           e.isVersionHistoryOpen = t;
         },
         onDataChanged() {
-          e.hasChanges = !0;
+          e.hasChanges = !0, e.changeSeq += 1;
         },
         onEvent: v,
         onModuleAdd: F,

package/dist/extensions/Blocks/Recommendation/controls/cardComposition/index.js

@@ -67,7 +67,7 @@ class se extends ut {
       (d, c) => `
                 <div data-reorder-icon-key="${P}${c}" style="display: none;">
                     <${_.BUTTON}
-                        class="drag-handle-btn flat-inline flat-white"
+                        class="guido-drag-handle-btn flat-inline flat-white"
                         ${O.BUTTON.name}="${P}${c}"
                     >
                         <${_.ICON}
@@ -328,7 +328,7 @@ class se extends ut {
   _createBuiltInItemHtml(t, e) {
     return `
             <div class="orderable-item" draggable="true" data-key="${t.key}">
-                <span class="drag-handle" data-reorder-icon-slot="${e}"></span>
+                <span class="guido-drag-handle" data-reorder-icon-slot="${e}"></span>
                 <span class="item-label">${this.api.translate(t.label)}</span>
                 <div class="item-action" data-action-for="${t.key}"></div>
             </div>
@@ -353,7 +353,7 @@ class se extends ut {
             <div class="orderable-item price-group-item" draggable="true"
                 data-key="${C}" data-group="prices">
                 <div class="price-group-header">
-                    <span class="drag-handle" data-reorder-icon-slot="${t}"></span>
+                    <span class="guido-drag-handle" data-reorder-icon-slot="${t}"></span>
                     <span class="item-label">${this.api.translate("Product Prices")}</span>
                     <div class="item-action" data-action-for="${C}"></div>
                 </div>
@@ -365,7 +365,7 @@ class se extends ut {
     return `
             <div class="orderable-item" draggable="true"
                 data-key="${t}" data-custom-index="${e}">
-                <span class="drag-handle" data-reorder-icon-slot="${r}"></span>
+                <span class="guido-drag-handle" data-reorder-icon-slot="${r}"></span>
                 <div class="custom-attr-select-wrap"
                     data-custom-select-slot="${e}"></div>
                 <div class="item-action"

package/dist/extensions/Blocks/Recommendation/recommendation.css.js

@@ -134,7 +134,10 @@ ue-orderable.orderable-disabled .droppable-icon {
     border-top: 2px solid var(--guido-color-primary-500, #0A2ECC);
 }
 
-.drag-handle {
+/* Namespaced: Stripo ships a global \`.drag-handle { position: absolute }\` for its
+   floating popups, which knocked this handle out of flow (SD-151734). */
+.guido-drag-handle {
+    cursor: move;
     user-select: none;
     display: flex;
     align-items: center;
@@ -144,13 +147,13 @@ ue-orderable.orderable-disabled .droppable-icon {
     flex-shrink: 0;
 }
 
-.drag-handle .drag-handle-btn .button {
+.guido-drag-handle .guido-drag-handle-btn .button {
     padding: 0;
     min-width: auto;
     cursor: move;
 }
 
-.drag-handle .drag-handle-btn .button .icon-button {
+.guido-drag-handle .guido-drag-handle-btn .button .icon-button {
     color: var(--guido-color-gray-600);
 }
 

package/dist/library.js

@@ -1,18 +1,20 @@
-import { default as e } from "./components/Guido.vue.js";
-import { MessageType as f, ProductType as s } from "./@types/config/schemas.js";
+import { default as a } from "./components/Guido.vue.js";
+import { MessageType as t, ProductType as d } from "./@types/config/schemas.js";
 import "./@types/config/defaults.js";
-import { getValidationErrors as d, isValidConfig as p, parseConfig as g, parseConfigSafe as n, validateConfig as l } from "./@types/config/validator.js";
-import { assignTrackingIds as T, readTrackFloor as c, readTrackSeq as x } from "./utils/linkTrackingIds.js";
+import { getValidationErrors as s, isValidConfig as p, parseConfig as g, parseConfigSafe as m, validateConfig as n } from "./@types/config/validator.js";
+import { assignTrackingIds as u, readTrackFloor as x, readTrackSeq as T } from "./utils/linkTrackingIds.js";
+import { useGuidoEmailEditorStore as C } from "./stores/guido-email-editor.js";
 export {
-  e as Guido,
-  f as MessageType,
-  s as ProductType,
-  T as assignTrackingIds,
-  d as getValidationErrors,
+  a as Guido,
+  t as MessageType,
+  d as ProductType,
+  u as assignTrackingIds,
+  s as getValidationErrors,
   p as isValidConfig,
   g as parseConfig,
-  n as parseConfigSafe,
-  c as readTrackFloor,
-  x as readTrackSeq,
-  l as validateConfig
+  m as parseConfigSafe,
+  x as readTrackFloor,
+  T as readTrackSeq,
+  C as useGuidoEmailEditorStore,
+  n as validateConfig
 };

package/dist/package.json.js

@@ -1,4 +1,4 @@
-const o = { stripo: { version: "2.76.0" } }, s = {
+const o = { stripo: { version: "2.77.0" } }, s = {
   guido: o
 };
 export {

package/dist/public/editorState.js

@@ -0,0 +1,4 @@
+import { useGuidoEmailEditorStore as e } from "../stores/guido-email-editor.js";
+export {
+  e as useGuidoEmailEditorStore
+};

package/dist/services/templateLibraryApi.js

@@ -4,13 +4,14 @@ import { useToaster as C } from "../composables/useToaster.js";
 import { useTranslations as h } from "../composables/useTranslations.js";
 import { useLiquidValidator as S } from "../composables/validators/useLiquidValidator.js";
 import { EditorType as v } from "../enums/defaults.js";
-import { ToasterTypeOptions as N } from "../enums/toaster.js";
-import { useRecommendationExtensionStore as x } from "../extensions/Blocks/Recommendation/store/recommendation.js";
-import { useSaveAsTemplateStore as E } from "../stores/save-as-template.js";
+import { ToasterTypeOptions as x } from "../enums/toaster.js";
+import { useRecommendationExtensionStore as E } from "../extensions/Blocks/Recommendation/store/recommendation.js";
+import { useSaveAsTemplateStore as N } from "../stores/save-as-template.js";
 import { base64EncodeWithSpecialChars as r } from "../utils/base64.js";
+import { isPlainObject as P } from "../utils/genericUtil.js";
 import { useTemplatePreparation as A } from "../utils/templatePreparation.js";
-const j = () => {
-  const { get: n, post: m } = b(), { handleError: o, showToaster: l } = C(), { config: c, isFeatureEnabled: p } = w(), { validateLiquidSyntax: g } = S(), u = h();
+const B = () => {
+  const { get: n, post: m } = b(), { handleError: o, showToaster: l } = C(), { config: c, isFeatureEnabled: p } = w(), { validateLiquidSyntax: f } = S(), u = h();
   return {
     getCategories: async () => {
       try {
@@ -40,10 +41,10 @@ const j = () => {
     createTemplate: async () => {
       var e, t, d, y;
       try {
-        const { prepareTemplateDetails: i } = A(), s = E(), a = await i();
-        if (p("liquidSyntax") && !await g(a.compiledHtml))
+        const { prepareTemplateDetails: i } = A(), s = N(), a = await i();
+        if (p("liquidSyntax") && !await f(a.compiledHtml))
           return !1;
-        const f = {
+        const T = {
           name: s.getTemplateName,
           categories: s.getSelectedCategoryIds,
           productId: ((t = (e = c.value) == null ? void 0 : e.partner) == null ? void 0 : t.productType) || 0,
@@ -54,7 +55,7 @@ const j = () => {
           unsubscriptionPreferencePageStatus: !1,
           unsubscriptionPreferencePages: [],
           recommendationCampaignUrls: r(
-            x().recommendationCampaignUrls
+            E().recommendationCampaignUrls
           ),
           recommendationConfigs: r({}),
           isGuido: !0,
@@ -66,16 +67,18 @@ const j = () => {
             css: a.css,
             dynamicContentList: a.dynamicContentList
           })
-        }, { data: { type: T } } = await m(
+        }, { data: g } = await m(
           "/newsletter/template-library/create-template",
-          f
+          T
         );
-        return T === "alert" ? (l({
+        if (!P(g))
+          throw new Error("Unexpected create-template response");
+        return g.type === "alert" ? (l({
           message: u(
             "newsletter.template-library-save-alert",
             { templateName: s.getTemplateName }
           ),
-          type: N.Error
+          type: x.Error
         }), !1) : (l({
           message: u(
             "newsletter.template-library-save-success",
@@ -90,5 +93,5 @@ const j = () => {
   };
 };
 export {
-  j as useTemplateLibraryApi
+  B as useTemplateLibraryApi
 };

package/dist/src/composables/useGuidoStateBridge.d.ts

@@ -1,22 +1,26 @@
 /**
  * Outbound bridge — publishes the current editor's html/css to the shared
- * Pinia store `guidoEmailEditor` so cortex-fe can read it at chat-stream
- * submit time and forward it as `clientState.editor`. This is what enables
+ * Pinia store `guidoEmailEditor`. cortex-fe reads it at chat-stream submit
+ * time and forwards it as `clientState.editor`, which is what enables
  * sub-case 1.3 (refine an already-loaded template via the email-agent).
  *
  * The bridge writes on three triggers:
  *
  *   1. Stripo finishes initializing — first snapshot.
- *   2. Editor `hasChanges` flips to true — debounced 500 ms so a streaming
- *      Stripo edit doesn't thrash the store.
+ *   2. Every document change, via the `changeSeq` counter — debounced 500 ms
+ *      so a streaming Stripo edit doesn't thrash the store.
  *   3. Editor `hasChanges` flips back to false (post-save / autosave) —
  *      immediate, since this is the canonical "saved" snapshot.
  *
  * `getTemplateData()` is a Stripo iframe call; it must not run before
  * `isStripoInitialized` is true. The bridge guards against that.
  *
- * If cortex-fe isn't loaded the store still gets written — that's fine;
- * the store has zero overhead and any future reader will find consistent
- * state. The bridge is a one-way pipe with no consumer dependency.
+ * The store is written even with no reader attached — it has zero overhead,
+ * and a late reader still finds consistent state.
+ *
+ * Readers are not optional any more, so treat the publish timing as part of
+ * the contract: the store ships as `@useinsider/guido/editor-state`, and
+ * email-fe imports it to scan the live html for its Array of Objects lock.
+ * Weakening a trigger here silently breaks that lock in the consumer.
  */
 export declare const useGuidoStateBridge: () => void;

package/dist/src/library.d.ts

@@ -2,5 +2,7 @@ export { default as Guido } from './components/Guido.vue';
 export type { GuidoConfig, GuidoConfigInput, IdentityConfig, PartnerConfig, TemplateConfig, TemplateMigrationConfig, LegacyRecommendationConfig, EditorConfig, UIConfig, FeaturesConfig, BlocksConfig, CompilerConfig, DynamicContent, EmailHeader, DefaultBlockType, CustomBlockType, ValidationResult, ValidationError, } from './@types/config';
 export { validateConfig, parseConfig, parseConfigSafe, isValidConfig, getValidationErrors, MessageType, ProductType, } from './@types/config';
 export { assignTrackingIds, readTrackFloor, readTrackSeq } from './public/trackingIds';
+export { useGuidoEmailEditorStore } from './public/editorState';
+export type { GuidoEmailEditorState } from './public/editorState';
 export type { StripoEventType } from './@types/events';
 export type { PositionData, DynamicContentEvent, MergeTagClickEvent, MergeTag, BaseDynamicContent, DynamicContentNode, DynamicContentList, TooltipOptions, TextValueObject, L10n, } from './@types/generic';

package/dist/src/public/editorState.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Published as `@useinsider/guido/editor-state` — the live editor snapshot Guido
+ * writes into the host's shared Pinia singleton.
+ *
+ * Importing from here pulls in nothing but pinia, so the editor never enters a
+ * consumer's module graph. Re-export surface only: this is the contract,
+ * `stores/guido-email-editor` is the implementation and stays free to move.
+ *
+ * Consumers read the store by importing it; the id `guidoEmailEditor` remains
+ * part of the contract for cortex-fe, which probes `pinia._s` at runtime instead
+ * of taking a build-time dependency on this package.
+ */
+export { useGuidoEmailEditorStore } from '../stores/guido-email-editor';
+export type { GuidoEmailEditorState } from '../stores/guido-email-editor';

package/dist/src/public/trackingIds.d.ts

@@ -4,6 +4,10 @@
  * Importing from here pulls in nothing else, so the editor never enters a
  * consumer's module graph. Re-export surface only: this is the contract,
  * `utils/linkTrackingIds` is the implementation and stays free to move.
+ *
+ * Relative, not the `@@/Utils/` alias: vue-tsc copies the specifier into the emitted
+ * .d.ts verbatim, and a consumer's TypeScript cannot resolve our alias table. A relative
+ * path resolves against dist/src/, so the published types actually load.
  */
-export { assignTrackingIds, readTrackFloor, readTrackSeq, TRACK_ID_ATTRIBUTE, TRACK_SEQ_ATTRIBUTE, } from '@@/Utils/linkTrackingIds';
-export type { TrackingIdResult } from '@@/Utils/linkTrackingIds';
+export { assignTrackingIds, readTrackFloor, readTrackSeq, TRACK_ID_ATTRIBUTE, TRACK_SEQ_ATTRIBUTE, } from '../utils/linkTrackingIds';
+export type { TrackingIdResult } from '../utils/linkTrackingIds';