@useinsider/guido 3.18.2 → 3.19.0-beta.5355c3f

package/dist/guido.css

@@ -1 +1 @@
-@charset "UTF-8";.gap-16[data-v-5553d071],.gap-16[data-v-0e1b0c54]{gap:16px}[data-v-73199fa4] .in-button-v2__wrapper{line-height:0}[data-v-22226124] .in-segments-wrapper__button_selected,[data-v-22226124] .in-segments-wrapper__button_selected:hover{background-color:#dae1fb;color:#0010ac;border-color:#0010ac}[data-v-2cb418af] .in-progress-wrapper__progress p span:last-child{display:none!important}[data-v-2cb418af] .in-progress-description-status{display:none!important}.view-options-wrapper[data-v-87033101]{position:relative;display:inline-block}.new-tag[data-v-87033101]{position:absolute;top:-8px;right:-16px;z-index:10}[data-v-87033101] .guido__view-option-selection-desktop svg,[data-v-87033101] .guido__view-option-selection-mobile svg{margin:0 0 0 2px}[data-v-87033101] .in-segments-wrapper__button_selected,[data-v-87033101] .in-segments-wrapper__button_selected:hover{background-color:#dae1fb}[data-v-87033101] .in-tooltip-wrapper-v2__icon{cursor:pointer}.editor-toolbar[data-v-173c3a40]{gap:4px}.version-history-item[data-v-ee4b9c3f]{flex-basis:200px}.version-history[data-v-fad98586]{gap:8px}.version-history__toolbar[data-v-fad98586]{gap:4px}.view-options-wrapper[data-v-6ebabfe4]{position:relative;display:inline-block}.new-tag[data-v-6ebabfe4]{position:absolute;top:-8px;right:-16px;z-index:10}[data-v-6ebabfe4] .guido__verion-history-view-option-selection-desktop svg,[data-v-6ebabfe4] .guido__verion-history-view-option-selection-mobile svg{margin:0 0 0 2px}[data-v-6ebabfe4] .in-segments-wrapper__button_selected,[data-v-6ebabfe4] .in-segments-wrapper__button_selected:hover{background-color:#dae1fb}[data-v-6ebabfe4] .in-tooltip-wrapper-v2__icon{cursor:pointer}.auto-save-toggle[data-v-2c964af4]{position:relative}.auto-save-toggle__info-box[data-v-2c964af4]{position:absolute;top:100%;left:0;z-index:10;width:280px}.editor-actions[data-v-1ca6baf0]{gap:4px}.header-wrapper[data-v-d11dd577]{min-width:1000px}.guido-loading__wrapper[data-v-07c4b2d8]{height:100%;top:75px!important;bottom:0!important}.guido-editor__wrapper[data-v-050dfa52]{--ribbon-offset: 0px;position:relative;width:100%;height:calc(100vh - 128px - var(--ribbon-offset))}.guido-editor__container[data-v-050dfa52]{width:100%;height:calc(100vh - 128px - var(--ribbon-offset))}.guido-editor__no-header[data-v-050dfa52]{height:calc(100vh - 75px - var(--ribbon-offset))}[data-v-293f1c47] .in-breadcrumb-wrapper__links{cursor:pointer}.templates-wrapper[data-v-91a26acd]{gap:16px;grid-template-columns:repeat(3,1fr)}.templates-wrapper .template-wrapper[data-v-91a26acd]{cursor:pointer}.templates-wrapper .template-wrapper .template-container[data-v-91a26acd]{height:274px;padding:2px;transition:none}.templates-wrapper .template-wrapper .template-container.selected[data-v-91a26acd]{padding:1px}.templates-wrapper .template-wrapper .template-container .thumbnail[data-v-91a26acd]{object-fit:cover;transform:scale(1)}[data-v-b9a93c6e] .guido__verion-history-view-option-selection-desktop svg,[data-v-b9a93c6e] .guido__verion-history-view-option-selection-mobile svg{margin:0 0 0 2px}[data-v-b9a93c6e] .in-segments-wrapper__button_selected,[data-v-b9a93c6e] .in-segments-wrapper__button_selected:hover{background-color:#dae1fb}.error-list[data-v-c3fd5d4b]{gap:16px}.desktop-browser-header[data-v-d86c5af5]{height:79px;min-height:79px}.desktop-browser-header__left[data-v-d86c5af5]{-webkit-user-drag:none;height:79px;width:378px}.desktop-browser-header__center[data-v-d86c5af5]{height:79px;background-repeat:repeat-x;background-size:auto 100%;background-position:left top}.desktop-browser-header__right[data-v-d86c5af5]{-webkit-user-drag:none;height:79px;width:112px}.desktop-preview[data-v-cf946232]{min-width:602px;height:70vh;min-height:583px;border-radius:10px}.desktop-preview iframe[data-v-cf946232]{min-height:504px}.iframe-wrapper[data-v-f255b2bb]{width:258px}.iframe-scaled[data-v-f255b2bb]{width:320px;height:124.0310077519%;transform:scale(.80625);transform-origin:top left}.cropped-text[data-v-eb3d05d7]{width:220px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.mobile-preview-wrapper__phone[data-v-3f472f96]{width:282px}.mobile-preview-wrapper__phone img[data-v-3f472f96]{object-fit:cover;border-radius:44px}.mobile-preview-wrapper__content[data-v-3f472f96]{width:258px;height:450px;left:12px}[data-v-6bcaca8a] .vueperslides__parallax-wrapper{padding-bottom:110px!important}[data-v-f16f20f8] .vueperslides__bullets{pointer-events:none!important}[data-v-f16f20f8] .vueperslides__parallax-wrapper{padding-bottom:110px!important}[data-v-bb3cca55] .vueperslides__bullets{pointer-events:none!important}[data-v-bb3cca55] .vueperslides__parallax-wrapper{height:110px!important;padding-bottom:110px!important}[data-v-b09e80c4] .vueperslides__bullets{pointer-events:none!important}[data-v-b09e80c4] .vueperslides__parallax-wrapper{height:110px!important;padding-bottom:110px!important}[data-v-9bdef600] .vueperslides__parallax-wrapper{padding-bottom:110px!important}.assign-strategy-drawer-content .assign-strategy-select[data-v-2580a7d9]{width:100%;max-width:none}.assign-strategy-drawer-content .assign-strategy-select[data-v-2580a7d9] .in-dropdown-box__container{width:413px}.assign-strategy-drawer .spaced-dot-sep{background-image:linear-gradient(90deg,#91949f 20%,#fff0 0);background-position:center bottom;background-repeat:repeat-x;background-size:5px 1px}.assign-strategy-drawer .spaced-dot-sep--top{background-position:center top}.assign-strategy-drawer .spaced-dot-sep--fc-n:first-child{background:none}
+@charset "UTF-8";.gap-16[data-v-5553d071],.gap-16[data-v-0e1b0c54]{gap:16px}[data-v-73199fa4] .in-button-v2__wrapper{line-height:0}[data-v-22226124] .in-segments-wrapper__button_selected,[data-v-22226124] .in-segments-wrapper__button_selected:hover{background-color:#dae1fb;color:#0010ac;border-color:#0010ac}[data-v-2cb418af] .in-progress-wrapper__progress p span:last-child{display:none!important}[data-v-2cb418af] .in-progress-description-status{display:none!important}.view-options-wrapper[data-v-87033101]{position:relative;display:inline-block}.new-tag[data-v-87033101]{position:absolute;top:-8px;right:-16px;z-index:10}[data-v-87033101] .guido__view-option-selection-desktop svg,[data-v-87033101] .guido__view-option-selection-mobile svg{margin:0 0 0 2px}[data-v-87033101] .in-segments-wrapper__button_selected,[data-v-87033101] .in-segments-wrapper__button_selected:hover{background-color:#dae1fb}[data-v-87033101] .in-tooltip-wrapper-v2__icon{cursor:pointer}.editor-toolbar[data-v-173c3a40]{gap:4px}.version-history-item[data-v-ee4b9c3f]{flex-basis:200px}.version-history[data-v-fad98586]{gap:8px}.version-history__toolbar[data-v-fad98586]{gap:4px}.view-options-wrapper[data-v-6ebabfe4]{position:relative;display:inline-block}.new-tag[data-v-6ebabfe4]{position:absolute;top:-8px;right:-16px;z-index:10}[data-v-6ebabfe4] .guido__verion-history-view-option-selection-desktop svg,[data-v-6ebabfe4] .guido__verion-history-view-option-selection-mobile svg{margin:0 0 0 2px}[data-v-6ebabfe4] .in-segments-wrapper__button_selected,[data-v-6ebabfe4] .in-segments-wrapper__button_selected:hover{background-color:#dae1fb}[data-v-6ebabfe4] .in-tooltip-wrapper-v2__icon{cursor:pointer}.auto-save-toggle[data-v-2c964af4]{position:relative}.auto-save-toggle__info-box[data-v-2c964af4]{position:absolute;top:100%;left:0;z-index:10;width:280px}.editor-actions[data-v-1ca6baf0]{gap:4px}.header-wrapper[data-v-d11dd577]{min-width:1000px}.guido-loading__wrapper[data-v-07c4b2d8]{height:100%;top:75px!important;bottom:0!important}.guido-editor__wrapper[data-v-7674b645]{--ribbon-offset: 0px;position:relative;width:100%;height:calc(100vh - 128px - var(--ribbon-offset))}.guido-editor__container[data-v-7674b645]{width:100%;height:calc(100vh - 128px - var(--ribbon-offset))}.guido-editor__no-header[data-v-7674b645]{height:calc(100vh - 75px - var(--ribbon-offset))}[data-v-293f1c47] .in-breadcrumb-wrapper__links{cursor:pointer}.templates-wrapper[data-v-91a26acd]{gap:16px;grid-template-columns:repeat(3,1fr)}.templates-wrapper .template-wrapper[data-v-91a26acd]{cursor:pointer}.templates-wrapper .template-wrapper .template-container[data-v-91a26acd]{height:274px;padding:2px;transition:none}.templates-wrapper .template-wrapper .template-container.selected[data-v-91a26acd]{padding:1px}.templates-wrapper .template-wrapper .template-container .thumbnail[data-v-91a26acd]{object-fit:cover;transform:scale(1)}[data-v-b9a93c6e] .guido__verion-history-view-option-selection-desktop svg,[data-v-b9a93c6e] .guido__verion-history-view-option-selection-mobile svg{margin:0 0 0 2px}[data-v-b9a93c6e] .in-segments-wrapper__button_selected,[data-v-b9a93c6e] .in-segments-wrapper__button_selected:hover{background-color:#dae1fb}.error-list[data-v-c3fd5d4b]{gap:16px}.desktop-browser-header[data-v-d86c5af5]{height:79px;min-height:79px}.desktop-browser-header__left[data-v-d86c5af5]{-webkit-user-drag:none;height:79px;width:378px}.desktop-browser-header__center[data-v-d86c5af5]{height:79px;background-repeat:repeat-x;background-size:auto 100%;background-position:left top}.desktop-browser-header__right[data-v-d86c5af5]{-webkit-user-drag:none;height:79px;width:112px}.desktop-preview[data-v-cf946232]{min-width:602px;height:70vh;min-height:583px;border-radius:10px}.desktop-preview iframe[data-v-cf946232]{min-height:504px}.iframe-wrapper[data-v-f255b2bb]{width:258px}.iframe-scaled[data-v-f255b2bb]{width:320px;height:124.0310077519%;transform:scale(.80625);transform-origin:top left}.cropped-text[data-v-eb3d05d7]{width:220px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.mobile-preview-wrapper__phone[data-v-3f472f96]{width:282px}.mobile-preview-wrapper__phone img[data-v-3f472f96]{object-fit:cover;border-radius:44px}.mobile-preview-wrapper__content[data-v-3f472f96]{width:258px;height:450px;left:12px}[data-v-6bcaca8a] .vueperslides__parallax-wrapper{padding-bottom:110px!important}[data-v-f16f20f8] .vueperslides__bullets{pointer-events:none!important}[data-v-f16f20f8] .vueperslides__parallax-wrapper{padding-bottom:110px!important}[data-v-bb3cca55] .vueperslides__bullets{pointer-events:none!important}[data-v-bb3cca55] .vueperslides__parallax-wrapper{height:110px!important;padding-bottom:110px!important}[data-v-b09e80c4] .vueperslides__bullets{pointer-events:none!important}[data-v-b09e80c4] .vueperslides__parallax-wrapper{height:110px!important;padding-bottom:110px!important}[data-v-9bdef600] .vueperslides__parallax-wrapper{padding-bottom:110px!important}.assign-strategy-drawer-content .assign-strategy-select[data-v-2580a7d9]{width:100%;max-width:none}.assign-strategy-drawer-content .assign-strategy-select[data-v-2580a7d9] .in-dropdown-box__container{width:413px}.assign-strategy-drawer .spaced-dot-sep{background-image:linear-gradient(90deg,#91949f 20%,#fff0 0);background-position:center bottom;background-repeat:repeat-x;background-size:5px 1px}.assign-strategy-drawer .spaced-dot-sep--top{background-position:center top}.assign-strategy-drawer .spaced-dot-sep--fc-n:first-child{background:none}

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/useCortexBlueprintBridge.d.ts

@@ -17,12 +17,13 @@
  *   - `error` segments (and message-level `isError` / `isCancelled`) trigger
  *     a localized toaster.
  *
+ * Every apply settles into a terminal `applyAcks` entry on the public store, so
+ * cortex can move its Apply button on the truth of the editor write rather than
+ * on the click.
+ *
  * In dev (`import.meta.env.DEV`) every observed segment + message-level flag
  * change is also `console.debug`-logged with the prefix `[guido:cortex]` so a
  * developer can watch the agent stream in real time. In production this is
  * gated behind `localStorage.guido:debug:ai === '1'`.
- *
- * If cortex-fe isn't loaded the chat store is undefined and the bridge is a
- * no-op (intentional — Guido must still work standalone).
  */
 export declare const useCortexBlueprintBridge: () => void;

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

@@ -1,4 +1,20 @@
 type ApplyStatus = 'pending' | 'applying' | 'applied' | 'failed';
+/**
+ * Terminal outcome of an apply. Every promise this composable hands out settles
+ * with exactly one of these — callers (the cortex bridge) ack on it, so a
+ * never-settling promise would strand cortex's Apply button forever.
+ *
+ * `superseded` means a newer payload for the same blueprint replaced this one:
+ * not a success, not a failure, and deliberately never acked.
+ */
+export type ApplyOutcome = {
+    status: 'applied';
+} | {
+    status: 'failed';
+    error: unknown;
+} | {
+    status: 'superseded';
+};
 /**
  * Applies email_template blueprints from the chat agent to the Stripo editor.
  *
@@ -9,6 +25,10 @@ type ApplyStatus = 'pending' | 'applying' | 'applied' | 'failed';
  * - manual Apply click (first apply): immediate.
  * - blueprint_update after the user has applied once: debounced 250 ms trailing
  *   so rapid mid-stream updates don't thrash updateHtmlAndCss.
+ *
+ * A click that lands before Stripo finished initializing is queued rather than
+ * dropped, and flushed when `isStripoInitialized` flips — the user does not
+ * have to click again.
  */
 export declare const useEmailTemplateApplier: () => {
     applyStatus: import("vue").Ref<Record<string, ApplyStatus>>;
@@ -16,11 +36,11 @@ export declare const useEmailTemplateApplier: () => {
     applyTemplate: (blueprintId: string, data: {
         html?: string;
         css?: string;
-    }) => void;
+    }) => Promise<ApplyOutcome>;
     applyTemplateDebounced: (blueprintId: string, data: {
         html?: string;
         css?: string;
-    }) => void;
+    }) => Promise<ApplyOutcome>;
 };
 export declare const resetEmailTemplateApplier: () => void;
 export {};

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';

package/dist/src/stores/editor.d.ts

@@ -6,6 +6,7 @@ export declare const useEditorStore: import("pinia").StoreDefinition<"guidoEdito
     isPreviewModeOpen: boolean;
     editorVisualMode: string;
     hasChanges: boolean;
+    changeSeq: number;
     isStripoInitialized: boolean;
     templateId: string;
     syncModulesEnabled: boolean;
@@ -19,6 +20,7 @@ export declare const useEditorStore: import("pinia").StoreDefinition<"guidoEdito
         isPreviewModeOpen: boolean;
         editorVisualMode: string;
         hasChanges: boolean;
+        changeSeq: number;
         isStripoInitialized: boolean;
         templateId: string;
         syncModulesEnabled: boolean;
@@ -31,6 +33,7 @@ export declare const useEditorStore: import("pinia").StoreDefinition<"guidoEdito
         isPreviewModeOpen: boolean;
         editorVisualMode: string;
         hasChanges: boolean;
+        changeSeq: number;
         isStripoInitialized: boolean;
         templateId: string;
         syncModulesEnabled: boolean;
@@ -44,6 +47,7 @@ export declare const useEditorStore: import("pinia").StoreDefinition<"guidoEdito
         isPreviewModeOpen: boolean;
         editorVisualMode: string;
         hasChanges: boolean;
+        changeSeq: number;
         isStripoInitialized: boolean;
         templateId: string;
         syncModulesEnabled: boolean;
@@ -56,6 +60,7 @@ export declare const useEditorStore: import("pinia").StoreDefinition<"guidoEdito
         isPreviewModeOpen: boolean;
         editorVisualMode: string;
         hasChanges: boolean;
+        changeSeq: number;
         isStripoInitialized: boolean;
         templateId: string;
         syncModulesEnabled: boolean;
@@ -69,6 +74,7 @@ export declare const useEditorStore: import("pinia").StoreDefinition<"guidoEdito
         isPreviewModeOpen: boolean;
         editorVisualMode: string;
         hasChanges: boolean;
+        changeSeq: number;
         isStripoInitialized: boolean;
         templateId: string;
         syncModulesEnabled: boolean;
@@ -81,6 +87,7 @@ export declare const useEditorStore: import("pinia").StoreDefinition<"guidoEdito
         isPreviewModeOpen: boolean;
         editorVisualMode: string;
         hasChanges: boolean;
+        changeSeq: number;
         isStripoInitialized: boolean;
         templateId: string;
         syncModulesEnabled: boolean;
@@ -94,6 +101,7 @@ export declare const useEditorStore: import("pinia").StoreDefinition<"guidoEdito
         isPreviewModeOpen: boolean;
         editorVisualMode: string;
         hasChanges: boolean;
+        changeSeq: number;
         isStripoInitialized: boolean;
         templateId: string;
         syncModulesEnabled: boolean;
@@ -106,6 +114,7 @@ export declare const useEditorStore: import("pinia").StoreDefinition<"guidoEdito
         isPreviewModeOpen: boolean;
         editorVisualMode: string;
         hasChanges: boolean;
+        changeSeq: number;
         isStripoInitialized: boolean;
         templateId: string;
         syncModulesEnabled: boolean;
@@ -119,6 +128,7 @@ export declare const useEditorStore: import("pinia").StoreDefinition<"guidoEdito
         isPreviewModeOpen: boolean;
         editorVisualMode: string;
         hasChanges: boolean;
+        changeSeq: number;
         isStripoInitialized: boolean;
         templateId: string;
         syncModulesEnabled: boolean;
@@ -131,6 +141,7 @@ export declare const useEditorStore: import("pinia").StoreDefinition<"guidoEdito
         isPreviewModeOpen: boolean;
         editorVisualMode: string;
         hasChanges: boolean;
+        changeSeq: number;
         isStripoInitialized: boolean;
         templateId: string;
         syncModulesEnabled: boolean;
@@ -144,6 +155,7 @@ export declare const useEditorStore: import("pinia").StoreDefinition<"guidoEdito
         isPreviewModeOpen: boolean;
         editorVisualMode: string;
         hasChanges: boolean;
+        changeSeq: number;
         isStripoInitialized: boolean;
         templateId: string;
         syncModulesEnabled: boolean;
@@ -156,6 +168,7 @@ export declare const useEditorStore: import("pinia").StoreDefinition<"guidoEdito
         isPreviewModeOpen: boolean;
         editorVisualMode: string;
         hasChanges: boolean;
+        changeSeq: number;
         isStripoInitialized: boolean;
         templateId: string;
         syncModulesEnabled: boolean;
@@ -169,6 +182,7 @@ export declare const useEditorStore: import("pinia").StoreDefinition<"guidoEdito
         isPreviewModeOpen: boolean;
         editorVisualMode: string;
         hasChanges: boolean;
+        changeSeq: number;
         isStripoInitialized: boolean;
         templateId: string;
         syncModulesEnabled: boolean;
@@ -181,6 +195,7 @@ export declare const useEditorStore: import("pinia").StoreDefinition<"guidoEdito
         isPreviewModeOpen: boolean;
         editorVisualMode: string;
         hasChanges: boolean;
+        changeSeq: number;
         isStripoInitialized: boolean;
         templateId: string;
         syncModulesEnabled: boolean;
@@ -194,6 +209,7 @@ export declare const useEditorStore: import("pinia").StoreDefinition<"guidoEdito
         isPreviewModeOpen: boolean;
         editorVisualMode: string;
         hasChanges: boolean;
+        changeSeq: number;
         isStripoInitialized: boolean;
         templateId: string;
         syncModulesEnabled: boolean;
@@ -206,6 +222,7 @@ export declare const useEditorStore: import("pinia").StoreDefinition<"guidoEdito
         isPreviewModeOpen: boolean;
         editorVisualMode: string;
         hasChanges: boolean;
+        changeSeq: number;
         isStripoInitialized: boolean;
         templateId: string;
         syncModulesEnabled: boolean;
@@ -219,6 +236,7 @@ export declare const useEditorStore: import("pinia").StoreDefinition<"guidoEdito
         isPreviewModeOpen: boolean;
         editorVisualMode: string;
         hasChanges: boolean;
+        changeSeq: number;
         isStripoInitialized: boolean;
         templateId: string;
         syncModulesEnabled: boolean;
@@ -231,6 +249,7 @@ export declare const useEditorStore: import("pinia").StoreDefinition<"guidoEdito
         isPreviewModeOpen: boolean;
         editorVisualMode: string;
         hasChanges: boolean;
+        changeSeq: number;
         isStripoInitialized: boolean;
         templateId: string;
         syncModulesEnabled: boolean;
@@ -244,6 +263,7 @@ export declare const useEditorStore: import("pinia").StoreDefinition<"guidoEdito
         isPreviewModeOpen: boolean;
         editorVisualMode: string;
         hasChanges: boolean;
+        changeSeq: number;
         isStripoInitialized: boolean;
         templateId: string;
         syncModulesEnabled: boolean;
@@ -256,6 +276,7 @@ export declare const useEditorStore: import("pinia").StoreDefinition<"guidoEdito
         isPreviewModeOpen: boolean;
         editorVisualMode: string;
         hasChanges: boolean;
+        changeSeq: number;
         isStripoInitialized: boolean;
         templateId: string;
         syncModulesEnabled: boolean;
@@ -269,6 +290,7 @@ export declare const useEditorStore: import("pinia").StoreDefinition<"guidoEdito
         isPreviewModeOpen: boolean;
         editorVisualMode: string;
         hasChanges: boolean;
+        changeSeq: number;
         isStripoInitialized: boolean;
         templateId: string;
         syncModulesEnabled: boolean;
@@ -281,6 +303,7 @@ export declare const useEditorStore: import("pinia").StoreDefinition<"guidoEdito
         isPreviewModeOpen: boolean;
         editorVisualMode: string;
         hasChanges: boolean;
+        changeSeq: number;
         isStripoInitialized: boolean;
         templateId: string;
         syncModulesEnabled: boolean;
@@ -294,6 +317,7 @@ export declare const useEditorStore: import("pinia").StoreDefinition<"guidoEdito
         isPreviewModeOpen: boolean;
         editorVisualMode: string;
         hasChanges: boolean;
+        changeSeq: number;
         isStripoInitialized: boolean;
         templateId: string;
         syncModulesEnabled: boolean;
@@ -306,6 +330,7 @@ export declare const useEditorStore: import("pinia").StoreDefinition<"guidoEdito
         isPreviewModeOpen: boolean;
         editorVisualMode: string;
         hasChanges: boolean;
+        changeSeq: number;
         isStripoInitialized: boolean;
         templateId: string;
         syncModulesEnabled: boolean;

package/dist/src/stores/guido-email-editor.d.ts

@@ -1,41 +1,63 @@
-/**
- * Outbound contract Guido publishes to the host's shared Pinia singleton so
- * cortex-fe can pick up the current editor state and forward it as
- * `clientState.editor` on the next chat-stream POST.
- *
- * State + getters only — `useGuidoStateBridge` writes via `$patch`, no actions
- * live here (architecture invariant).
- *
- * Store id `guidoEmailEditor` is cross-MFE: cortex-fe reads it via
- * `pinia._s.get('guidoEmailEditor')` at runtime. The internal Guido editor
- * store keeps id `guidoEditor` — these are intentionally separate. The
- * internal store carries UI state that cortex-fe should not see; this public
- * store carries the contract Guido is willing to share.
- */
-export declare const useGuidoEmailEditorStore: import("pinia").StoreDefinition<"guidoEmailEditor", {
+/** Terminal outcome of an editor write, keyed by `${blueprintId}:${version}`. */
+export interface ApplyAck {
+    status: 'applied' | 'failed';
+    /** The `applyRequestedAt` of the click this ack answers — lets cortex drop stale acks. */
+    requestedAt: number;
+    /** Strictly increasing per key, so two acks in the same millisecond still order. */
+    ackAt: number;
+    /** Stringified — cortex JSON-clones store-derived payloads, an Error would not survive. */
+    error?: string;
+}
+/** The published editor snapshot — the shape a consumer reads off the shared store. */
+export interface GuidoEmailEditorState {
     /** Current Stripo HTML — stripe tables only, no DOCTYPE/wrapper. */
     html: string;
     /** Current Stripo CSS — es-p* utility classes used by the html. */
     css: string;
     /** Wall-clock ms when html/css were last written by the bridge. */
     lastUpdatedAt: number;
-    /** Template id from the editor config, for cortex-fe to scope per-template. */
+    /** Template id from the editor config, so a consumer can scope per-template. */
     templateId: string;
-}, {
+    /** True while a mounted Guido bridge is consuming the chat store. Gates cortex's Apply button. */
+    bridgeActive: boolean;
+    /** `${blueprintId}:${version}` → terminal outcome of the editor write, written only after it settles. */
+    applyAcks: Record<string, ApplyAck>;
+}
+/**
+ * Outbound contract Guido publishes to the host's shared Pinia singleton so a
+ * consumer can read the current editor state: cortex-fe forwards it as
+ * `clientState.editor` on the next chat-stream POST, email-fe scans it for the
+ * Array of Objects lock.
+ *
+ * Published as `@useinsider/guido/editor-state` and from the root barrel, so a
+ * consumer imports this store instead of re-declaring one under the same id.
+ *
+ * This store is **state-only, by contract**. It declares no actions and no
+ * non-trivial getters, so `pinia.state.value['guidoEmailEditor']` is a complete
+ * view of it. cortex-fe reads it through that public path; adding an action or
+ * a getter that cortex needs would silently break that read. Keep it
+ * state-only. (`hasSnapshot` stays — cortex does not read it.)
+ *
+ * `useGuidoStateBridge` (the snapshot) and `useCortexBlueprintBridge` (the
+ * apply handshake) are the only intended writers, but that is Guido's own
+ * convention rather than something the store enforces: publishing the
+ * definition hands a consumer `$patch` as well, exactly as the runtime
+ * `pinia._s` probe always did.
+ *
+ * Store id `guidoEmailEditor` is cross-MFE: cortex-fe reads it at runtime rather
+ * than importing it, so the id stays part of the contract. The internal Guido
+ * editor store keeps id `guidoEditor` — these are intentionally separate. The
+ * internal store carries UI state a consumer should not see; this public store
+ * carries the contract Guido is willing to share.
+ */
+export declare const useGuidoEmailEditorStore: import("pinia").StoreDefinition<"guidoEmailEditor", GuidoEmailEditorState, {
     /** True once the bridge has published at least one snapshot. */
     hasSnapshot: (state: {
         html: string;
         css: string;
         lastUpdatedAt: number;
         templateId: string;
-    } & import("pinia").PiniaCustomStateProperties<{
-        /** Current Stripo HTML — stripe tables only, no DOCTYPE/wrapper. */
-        html: string;
-        /** Current Stripo CSS — es-p* utility classes used by the html. */
-        css: string;
-        /** Wall-clock ms when html/css were last written by the bridge. */
-        lastUpdatedAt: number;
-        /** Template id from the editor config, for cortex-fe to scope per-template. */
-        templateId: string;
-    }>) => boolean;
+        bridgeActive: boolean;
+        applyAcks: Record<string, ApplyAck>;
+    } & import("pinia").PiniaCustomStateProperties<GuidoEmailEditorState>) => boolean;
 }, {}>;

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

@@ -30,3 +30,9 @@ export declare const replaceString: (string?: string, values?: Record<string, st
  * a string nor a number becomes ''.
  */
 export declare const asText: (value: unknown) => string;
+/**
+ * Narrows an unknown API value to a plain JSON object. Arrays and exotic
+ * objects (Blob, Date, FormData) are rejected, so a response body that useHttp
+ * parsed as text or blob can never be read as a JSON payload.
+ */
+export declare const isPlainObject: <T>(value: T) => value is T & Record<string, unknown>;

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

@@ -0,0 +1,20 @@
+import type { BaseDynamicContent } from '@@/Types/generic';
+export type DynamicContentFormat = NonNullable<BaseDynamicContent['format']>;
+/** Format key the dynamic-content picker sends for a custom date/time format. */
+export declare const TIME_FORMAT_KEY = "time-format";
+/** Wraps a Liquid filter argument in whichever quote style the value itself does not use. */
+export declare const quoteArgument: (value: string) => string | null;
+/**
+ * `{ key: 'time-format', value: '%Y-%m-%d' }` -> `date: "%Y-%m-%d"`.
+ *
+ * Only a custom date/time strftime pattern has a Liquid equivalent. Anything else returns null so
+ * the caller emits a plain tag rather than one that silently lost — or literally printed — its
+ * format.
+ * @example formatToLiquidFilter({ key: 'time-format', value: '%b %-d, %Y' }) -> date: "%b %-d, %Y"
+ */
+export declare const formatToLiquidFilter: (format: DynamicContentFormat) => string | null;
+/**
+ * Inverse of `formatToLiquidFilter` — reads the picker format back out of one filter segment, so a
+ * reopened tag restores its selection in the host's format dropdown.
+ */
+export declare const liquidFilterToFormat: (segment: string) => DynamicContentFormat | null;

package/dist/stores/editor.js

@@ -8,6 +8,10 @@ const o = e("guidoEditor", {
     isPreviewModeOpen: !1,
     editorVisualMode: "desktop",
     hasChanges: !1,
+    // Bumped on every Stripo document change. `hasChanges` is a latch that stays
+    // true until a save, so it cannot signal the second edit onwards; watchers
+    // that need every change (the outbound state bridge) watch this instead.
+    changeSeq: 0,
     isStripoInitialized: !1,
     templateId: "",
     syncModulesEnabled: !1,

package/dist/stores/guido-email-editor.js

@@ -1,14 +1,12 @@
 import { defineStore as e } from "pinia";
 const d = e("guidoEmailEditor", {
   state: () => ({
-    /** Current Stripo HTML — stripe tables only, no DOCTYPE/wrapper. */
     html: "",
-    /** Current Stripo CSS — es-p* utility classes used by the html. */
     css: "",
-    /** Wall-clock ms when html/css were last written by the bridge. */
     lastUpdatedAt: 0,
-    /** Template id from the editor config, for cortex-fe to scope per-template. */
-    templateId: ""
+    templateId: "",
+    bridgeActive: !1,
+    applyAcks: {}
   }),
   getters: {
     /** True once the bridge has published at least one snapshot. */