@useinsider/guido 3.18.2-beta.8ef3138 → 3.18.2-beta.eedafd2

package/dist/src/@types/config/schemas.d.ts

@@ -395,6 +395,8 @@ export declare const FeaturesSchema: v.ObjectSchema<{
     readonly allowlistEnabled: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
     /** Enable persistent link tracking-id assignment for the click heatmap (opt-in) */
     readonly linkTrackingIds: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
+    /** Allow persisting a template that still has validation errors (drawer "Save and Continue" soft-save). Host sets false for transactional + unsubscribe. */
+    readonly allowSaveWithErrors: v.OptionalSchema<v.BooleanSchema<undefined>, true>;
     readonly reusableRecommendationStrategy: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
 }, undefined>;
 /**
@@ -795,6 +797,8 @@ export declare const GuidoConfigSchema: v.ObjectSchema<{
         readonly allowlistEnabled: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
         /** Enable persistent link tracking-id assignment for the click heatmap (opt-in) */
         readonly linkTrackingIds: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
+        /** Allow persisting a template that still has validation errors (drawer "Save and Continue" soft-save). Host sets false for transactional + unsubscribe. */
+        readonly allowSaveWithErrors: v.OptionalSchema<v.BooleanSchema<undefined>, true>;
         readonly reusableRecommendationStrategy: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
     }, undefined>, {}>;
     /** Block configuration */

package/dist/src/@types/save-validation.d.ts

@@ -0,0 +1,19 @@
+import type { SaveValidationRule } from '@@/Enums/save-validation';
+import type { ToasterTypeOptions } from '@@/Enums/toaster';
+/** Which action triggered the validation run. Drives telemetry only in v1. */
+export type SaveValidationIntent = 'save' | 'back' | 'test';
+/**
+ * A single validation failure instance, one per drawer row. Names avoid the
+ * public `ValidationError` (config validation) collision — NOT exported from
+ * library.ts.
+ */
+export interface SaveValidationError {
+    /** Stable discriminator for tests and de-duplication. */
+    rule: SaveValidationRule;
+    /** Final translated string — trans() is applied at collect time. */
+    message: string;
+    /** Raw user content (field name / tag / src) — not i18n. */
+    detail?: string;
+    /** Mirrors the legacy toaster severity. Kept for the discriminator/tests; the drawer renders a uniform icon and never reads it. */
+    type: ToasterTypeOptions;
+}

package/dist/src/components/Guido.vue.d.ts

@@ -15,7 +15,23 @@ declare const _default: import("vue").DefineComponent<__VLS_WithDefaults<__VLS_T
         close: () => void;
     };
     hasChanges: import("vue").ComputedRef<boolean>;
-    saveSilent: () => Promise<Omit<SavedTemplateDetails, "metadata" | "silent"> | undefined> | undefined;
+    saveSilent: () => Promise<{
+        dynamicContentList: import("@@/Types/generic").DynamicContent[];
+        compiledHtml: string;
+        rawHtml: string;
+        css: string;
+        ampHtml: string;
+        ampErrors: string[];
+        modules: number[];
+        recommendation: {
+            campaignUrls: Record<string, import("../@types/recommendation").RecommendationCampaignUrlValue>;
+            configs: Record<string, string>;
+        };
+        unsubscribe: {
+            status: boolean;
+            config: number[];
+        };
+    } | undefined> | undefined;
     setLoading: (value: boolean) => void;
 }, {}, {}, {}, import("vue/types/v3-component-options.js").ComponentOptionsMixin, import("vue/types/v3-component-options.js").ComponentOptionsMixin, {
     "dynamic-content:open": (detail: {

package/dist/src/components/organisms/header/EditorActions.vue.d.ts

@@ -1,4 +1,20 @@
 declare const _default: import("vue").DefineComponent<{}, {
-    handleSave: (isSilent: boolean) => Promise<Omit<import("../../../@types/stripo.js").SavedTemplateDetails, "metadata" | "silent"> | undefined> | undefined;
+    handleSave: (isSilent: boolean) => Promise<{
+        dynamicContentList: import("../../../@types/generic.js").DynamicContent[];
+        compiledHtml: string;
+        rawHtml: string;
+        css: string;
+        ampHtml: string;
+        ampErrors: string[];
+        modules: number[];
+        recommendation: {
+            campaignUrls: Record<string, import("../../../@types/recommendation.js").RecommendationCampaignUrlValue>;
+            configs: Record<string, string>;
+        };
+        unsubscribe: {
+            status: boolean;
+            config: number[];
+        };
+    } | undefined> | undefined;
 }, {}, {}, {}, import("vue/types/v3-component-options.js").ComponentOptionsMixin, import("vue/types/v3-component-options.js").ComponentOptionsMixin, {}, string, Readonly<import("vue").ExtractPropTypes<{}>>, {}>;
 export default _default;

package/dist/src/components/organisms/header/HeaderWrapper.vue.d.ts

@@ -1,4 +1,20 @@
 declare const _default: import("vue").DefineComponent<{}, {
-    handleSave: (isSilent: boolean) => Promise<Omit<import("../../../@types/stripo.js").SavedTemplateDetails, "metadata" | "silent"> | undefined> | undefined;
+    handleSave: (isSilent: boolean) => Promise<{
+        dynamicContentList: import("../../../@types/generic.js").DynamicContent[];
+        compiledHtml: string;
+        rawHtml: string;
+        css: string;
+        ampHtml: string;
+        ampErrors: string[];
+        modules: number[];
+        recommendation: {
+            campaignUrls: Record<string, import("../../../@types/recommendation.js").RecommendationCampaignUrlValue>;
+            configs: Record<string, string>;
+        };
+        unsubscribe: {
+            status: boolean;
+            config: number[];
+        };
+    } | undefined> | undefined;
 }, {}, {}, {}, import("vue/types/v3-component-options.js").ComponentOptionsMixin, import("vue/types/v3-component-options.js").ComponentOptionsMixin, {}, string, Readonly<import("vue").ExtractPropTypes<{}>>, {}>;
 export default _default;

package/dist/src/components/organisms/header/RightSlot.vue.d.ts

@@ -1,4 +1,20 @@
 declare const _default: import("vue").DefineComponent<{}, {
-    handleSave: (isSilent: boolean) => Promise<Omit<import("../../../@types/stripo.js").SavedTemplateDetails, "metadata" | "silent"> | undefined> | undefined;
+    handleSave: (isSilent: boolean) => Promise<{
+        dynamicContentList: import("../../../@types/generic.js").DynamicContent[];
+        compiledHtml: string;
+        rawHtml: string;
+        css: string;
+        ampHtml: string;
+        ampErrors: string[];
+        modules: number[];
+        recommendation: {
+            campaignUrls: Record<string, import("../../../@types/recommendation.js").RecommendationCampaignUrlValue>;
+            configs: Record<string, string>;
+        };
+        unsubscribe: {
+            status: boolean;
+            config: number[];
+        };
+    } | undefined> | undefined;
 }, {}, {}, {}, import("vue/types/v3-component-options.js").ComponentOptionsMixin, import("vue/types/v3-component-options.js").ComponentOptionsMixin, {}, string, Readonly<import("vue").ExtractPropTypes<{}>>, {}>;
 export default _default;

package/dist/src/components/organisms/validation/ValidationErrorDrawer.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue/types/v3-component-options.js").ComponentOptionsMixin, import("vue/types/v3-component-options.js").ComponentOptionsMixin, {}, string, Readonly<import("vue").ExtractPropTypes<{}>>, {}>;
+export default _default;

package/dist/src/components/wrappers/WpDrawer.vue.d.ts

@@ -10,11 +10,11 @@ interface Props {
     status: boolean;
     titleText: string;
 }
-declare var __VLS_12: {}, __VLS_14: {};
+declare var __VLS_13: {}, __VLS_15: {};
 type __VLS_Slots = {} & {
-    headerBottomSlot?: (props: typeof __VLS_12) => any;
+    headerBottomSlot?: (props: typeof __VLS_13) => any;
 } & {
-    default?: (props: typeof __VLS_14) => any;
+    default?: (props: typeof __VLS_15) => any;
 };
 declare const __VLS_component: import("vue").DefineComponent<__VLS_WithDefaults<__VLS_TypePropsToOption<Props>, {
     className: string;
@@ -26,6 +26,7 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_WithDefaults<
     cancelOrBackButtonEvent: () => void;
     onCloseEvent: () => void;
     primaryButtonEvent: () => void;
+    secondaryButtonEvent: () => void;
 }, string, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<Props>, {
     className: string;
     size: string;

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

@@ -99,6 +99,7 @@ export declare const useConfig: () => {
             autosave: boolean;
             allowlistEnabled: boolean;
             linkTrackingIds: boolean;
+            allowSaveWithErrors: boolean;
             reusableRecommendationStrategy: boolean;
         };
         blocks: {
@@ -234,6 +235,7 @@ export declare const useConfig: () => {
         autosave: boolean;
         allowlistEnabled: boolean;
         linkTrackingIds: boolean;
+        allowSaveWithErrors: boolean;
         reusableRecommendationStrategy: boolean;
     } | null>;
     blocks: import("vue").ComputedRef<{

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

@@ -1,5 +1,12 @@
 import type { DynamicContent } from '@@/Types/generic';
 import type { FiltersResponse } from '@@/Types/recommendation';
+/**
+ * Extracts recommendation block IDs directly from the HTML by parsing
+ * the recommendation-id attribute on block elements.
+ * This avoids depending on store state which may not be populated
+ * when the settings panel hasn't been opened yet (e.g., saved templates).
+ */
+export declare function getRecommendationBlockIds(html: string): string[];
 /**
  * Parses a `{{recoId_index_attributeName}}` variable (already stripped of the
  * braces/whitespace) into its recommendation id and attribute name. Returns
@@ -27,6 +34,20 @@ export declare function buildPartnerAttributeNameSet(filterList: FiltersResponse
  * before, so flagging it would false-positive on merge tags like `{{user.name}}`.
  */
 export declare function findInvalidCustomFields(html: string, validCustomFields: string[], recommendationBlockIds: string[], ignoredIds: Set<string>, ignoredAttributeNames: Set<string> | null): string[];
+/**
+ * Returns the invalid `{{ ... }}` dynamic-content tags found in the HTML.
+ *
+ * A tag's variable name is the part before the first `|` (everything after it is the fallback).
+ * Surrounding whitespace is always allowed (trimmed). A tag is valid only when the variable name
+ * is an allowed system token, or it is a clean identifier (`[A-Za-z0-9_.]`) and — when a `|` is
+ * present — the fallback after it is not empty. Otherwise the tag is invalid (e.g.
+ * `{{Api Response: OA1 Main Item Url}}` — spaces/`:` — or `{{bounce|}}` — empty fallback).
+ *
+ * `data-*` block-config attribute values are excluded from the scan: blocks such as Items/cart
+ * store product merge tags (`data-product_button_link="{{Abandoned Cart Item (1) Url}}"`) that the
+ * backend resolves through its own pipeline, so they must not be treated as user-authored tags.
+ */
+export declare function getInvalidDynamicContentTags(html: string): string[];
 export declare const useHtmlValidator: () => {
     validateHtml: (html: string, customFields: DynamicContent[], isOnSaveValidation?: boolean) => Promise<boolean>;
 };

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

@@ -1,4 +1,9 @@
 import type { SavedTemplateDetails } from '@@/Types/stripo';
+type SaveDetails = Omit<SavedTemplateDetails, 'metadata' | 'silent'>;
+type SaveResult = SaveDetails | undefined;
 export declare const useSave: () => {
-    save: (suppressEmit?: boolean, silent?: boolean) => Promise<Omit<SavedTemplateDetails, "metadata" | "silent"> | undefined>;
+    save: (suppressEmit?: boolean, silent?: boolean) => Promise<SaveResult>;
+    saveWithErrors: () => Promise<SaveResult>;
+    saveRawOnly: () => Promise<SaveResult>;
 };
+export {};

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

@@ -0,0 +1,6 @@
+import type { DynamicContent } from '@@/Types/generic';
+import type { SaveValidationError } from '@@/Types/save-validation';
+export declare const useSaveValidation: () => {
+    collectSaveValidationErrors: (compiledHtml: string, dynamicContentList: DynamicContent[]) => Promise<SaveValidationError[]>;
+    validateCurrentTemplate: () => Promise<SaveValidationError[]>;
+};

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

@@ -0,0 +1,3 @@
+export declare const useSaveValidationRollout: () => {
+    isEnabled: import("vue").ComputedRef<boolean>;
+};

package/dist/src/composables/validators/useCouponBlockValidator.d.ts

@@ -1,3 +1,6 @@
+export declare const COUPON_TAG_MODIFIED_KEY = "newsletter.coupon-tag-modified";
+/** Pure core: the tag text of every coupon block whose code was modified. */
+export declare function findInvalidCouponBlocks(html: string): string[];
 export declare const useCouponBlockValidator: () => {
     validateCouponBlockTags: (html: string) => boolean;
 };

package/dist/src/composables/validators/useUnsubscribeBlockValidator.d.ts

@@ -1,4 +1,14 @@
+declare const SINGLETON_BLOCK_RULES: {
+    pageType: number;
+    messageKey: string;
+}[];
+export declare const EMPTY_BLOCK_KEY = "unsubscription-preference.select-page-to-continue";
+/** Pure core: the singleton rules whose page type appears more than once. */
+export declare function findDuplicateUnsubPageTypes(html: string): typeof SINGLETON_BLOCK_RULES;
+/** Pure core: count of unsubscribe blocks with no page type or page list chosen. */
+export declare function countUnsubBlocksWithoutPage(html: string): number;
 export declare const useUnsubscribeBlockValidator: () => {
     validateUnsubscribeBlockUniqueness: (html: string) => boolean;
     validateUnsubscribeBlockHasTemplate: (html: string) => boolean;
 };
+export {};

package/dist/src/enums/save-validation.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Stable discriminators for each save-validation rule site — one per rule that
+ * can produce a drawer row, kept in sync with the collector + legacy validator chains.
+ */
+export declare enum SaveValidationRule {
+    CouponTagModified = "coupon-tag-modified",
+    DuplicateUnsubBlock = "duplicate-unsub-block",
+    UnsubBlockMissingTemplate = "unsub-block-missing-template",
+    LiquidSyntax = "liquid-syntax",
+    InvalidLinks = "invalid-links",
+    LinkCheckInProgress = "link-check-in-progress",
+    CustomFieldScript = "custom-field-script",
+    EmptyHtml = "empty-html",
+    MismatchedBraces = "mismatched-braces",
+    InvalidDynamicTag = "invalid-dynamic-tag",
+    InvalidCustomField = "invalid-custom-field",
+    ConditionsSyntax = "conditions-syntax",
+    WrongEqualityOperator = "wrong-equality-operator",
+    MissingIfEndif = "missing-if-endif",
+    ConditionTagSpacing = "condition-tag-spacing",
+    BracesInsideIfTag = "braces-inside-if-tag",
+    RecommendationRequiredFields = "recommendation-required-fields",
+    RecommendationFilters = "recommendation-filters",
+    InvalidImageType = "invalid-image-type",
+    CheckboxUnsubGroup = "checkbox-unsub-group",
+    RadioButtonUnsubGroup = "radio-button-unsub-group"
+}

package/dist/src/extensions/Blocks/Recommendation/store/recommendation.d.ts

@@ -462,6 +462,11 @@ export declare const useRecommendationExtensionStore: import("pinia").StoreDefin
      * every block's recommendationConfigs across user edits.
      */
     hasInvalidBlock(): boolean;
+    /**
+     * Per-instance counterpart to `hasInvalidBlock`: the ids of every block
+     * that fails required-field validation, one drawer row each (SD-147430).
+     */
+    invalidBlockIds(): string[];
     fetchRecommendationProducts(): Promise<void>;
     _doFetchProducts(): Promise<void>;
     _doFetchStrategyProducts(blockId: number): Promise<void>;

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

@@ -104,6 +104,7 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 autosave: boolean;
                 allowlistEnabled: boolean;
                 linkTrackingIds: boolean;
+                allowSaveWithErrors: boolean;
                 reusableRecommendationStrategy: boolean;
             };
             blocks: {
@@ -245,6 +246,7 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 autosave: boolean;
                 allowlistEnabled: boolean;
                 linkTrackingIds: boolean;
+                allowSaveWithErrors: boolean;
                 reusableRecommendationStrategy: boolean;
             };
             blocks: {
@@ -386,6 +388,7 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 autosave: boolean;
                 allowlistEnabled: boolean;
                 linkTrackingIds: boolean;
+                allowSaveWithErrors: boolean;
                 reusableRecommendationStrategy: boolean;
             };
             blocks: {
@@ -527,6 +530,7 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 autosave: boolean;
                 allowlistEnabled: boolean;
                 linkTrackingIds: boolean;
+                allowSaveWithErrors: boolean;
                 reusableRecommendationStrategy: boolean;
             };
             blocks: {
@@ -668,6 +672,7 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 autosave: boolean;
                 allowlistEnabled: boolean;
                 linkTrackingIds: boolean;
+                allowSaveWithErrors: boolean;
                 reusableRecommendationStrategy: boolean;
             };
             blocks: {
@@ -809,6 +814,7 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 autosave: boolean;
                 allowlistEnabled: boolean;
                 linkTrackingIds: boolean;
+                allowSaveWithErrors: boolean;
                 reusableRecommendationStrategy: boolean;
             };
             blocks: {
@@ -950,6 +956,7 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 autosave: boolean;
                 allowlistEnabled: boolean;
                 linkTrackingIds: boolean;
+                allowSaveWithErrors: boolean;
                 reusableRecommendationStrategy: boolean;
             };
             blocks: {
@@ -1091,6 +1098,7 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 autosave: boolean;
                 allowlistEnabled: boolean;
                 linkTrackingIds: boolean;
+                allowSaveWithErrors: boolean;
                 reusableRecommendationStrategy: boolean;
             };
             blocks: {
@@ -1232,6 +1240,7 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 autosave: boolean;
                 allowlistEnabled: boolean;
                 linkTrackingIds: boolean;
+                allowSaveWithErrors: boolean;
                 reusableRecommendationStrategy: boolean;
             };
             blocks: {
@@ -1373,6 +1382,7 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 autosave: boolean;
                 allowlistEnabled: boolean;
                 linkTrackingIds: boolean;
+                allowSaveWithErrors: boolean;
                 reusableRecommendationStrategy: boolean;
             };
             blocks: {
@@ -1514,6 +1524,7 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 autosave: boolean;
                 allowlistEnabled: boolean;
                 linkTrackingIds: boolean;
+                allowSaveWithErrors: boolean;
                 reusableRecommendationStrategy: boolean;
             };
             blocks: {
@@ -1655,6 +1666,7 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 autosave: boolean;
                 allowlistEnabled: boolean;
                 linkTrackingIds: boolean;
+                allowSaveWithErrors: boolean;
                 reusableRecommendationStrategy: boolean;
             };
             blocks: {
@@ -1796,6 +1808,7 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 autosave: boolean;
                 allowlistEnabled: boolean;
                 linkTrackingIds: boolean;
+                allowSaveWithErrors: boolean;
                 reusableRecommendationStrategy: boolean;
             };
             blocks: {
@@ -1937,6 +1950,7 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 autosave: boolean;
                 allowlistEnabled: boolean;
                 linkTrackingIds: boolean;
+                allowSaveWithErrors: boolean;
                 reusableRecommendationStrategy: boolean;
             };
             blocks: {
@@ -2078,6 +2092,7 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 autosave: boolean;
                 allowlistEnabled: boolean;
                 linkTrackingIds: boolean;
+                allowSaveWithErrors: boolean;
                 reusableRecommendationStrategy: boolean;
             };
             blocks: {
@@ -2121,6 +2136,18 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
             };
         } | null;
     } & import("pinia").PiniaCustomStateProperties<ConfigStoreState>) => number;
+    /**
+     * Transactional campaigns keep the hard save block. Reactive getter, so
+     * consumers stay safe in setup where a raw config read snapshots null (SD-147945).
+     */
+    isTransactional(): boolean;
+    /**
+     * Soft-save policy: may the editor persist a template with validation errors?
+     * Default true (host sets features.allowSaveWithErrors=false for transactional +
+     * unsub). Reactive getter defaulting true — reading via isFeatureEnabled would
+     * floor to false pre-init and momentarily hide the soft-save option (SD-147430).
+     */
+    allowSaveWithErrors(): boolean;
     /**
      * Get the username
      */
@@ -2219,6 +2246,7 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 autosave: boolean;
                 allowlistEnabled: boolean;
                 linkTrackingIds: boolean;
+                allowSaveWithErrors: boolean;
                 reusableRecommendationStrategy: boolean;
             };
             blocks: {
@@ -2360,6 +2388,7 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 autosave: boolean;
                 allowlistEnabled: boolean;
                 linkTrackingIds: boolean;
+                allowSaveWithErrors: boolean;
                 reusableRecommendationStrategy: boolean;
             };
             blocks: {
@@ -2503,6 +2532,7 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"guido-conf
                 autosave: boolean;
                 allowlistEnabled: boolean;
                 linkTrackingIds: boolean;
+                allowSaveWithErrors: boolean;
                 reusableRecommendationStrategy: boolean;
             };
             blocks: {

package/dist/src/stores/save-validation.d.ts

@@ -0,0 +1,22 @@
+import type { SaveValidationError, SaveValidationIntent } from '@@/Types/save-validation';
+interface SaveValidationState {
+    errors: SaveValidationError[];
+    isDrawerOpen: boolean;
+    intent: SaveValidationIntent | null;
+}
+export declare const useSaveValidationStore: import("pinia").StoreDefinition<"guidoSaveValidation", SaveValidationState, {
+    errorCount: (state: {
+        errors: {
+            rule: import("../enums/save-validation").SaveValidationRule;
+            message: string;
+            detail?: string | undefined;
+            type: import("../enums/toaster").ToasterTypeOptions;
+        }[];
+        isDrawerOpen: boolean;
+        intent: SaveValidationIntent | null;
+    } & import("pinia").PiniaCustomStateProperties<SaveValidationState>) => number;
+}, {
+    open(errors: SaveValidationError[], intent: SaveValidationIntent): void;
+    close(): void;
+}>;
+export {};

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/src/utils/templatePreparation.d.ts

@@ -15,6 +15,36 @@ import type { SavedTemplateDetails } from '@@/Types/stripo';
  * same source), so it is reliably present regardless of how the block was added.
  */
 export declare function getHtmlReferencedUnsubscribePages(html: string): number[];
+/**
+ * Hydrates the recommendation extension store from the persisted `esd-ext-config`
+ * JSON blob on each `.recommendation-block-v2` element in the raw editor HTML.
+ *
+ * Why this runs before `compileHtml`:
+ *   The HTML compiler's `prepareRecommendationBlocks` rule asks
+ *   `useRecommendation.buildCampaignUrl(id)` to assemble each block's API URL
+ *   from `blockStates[id].recommendationConfigs`. That Pinia entry is normally
+ *   populated by `RecommendationBlockControl._syncNodeConfigToStore`, which
+ *   only fires when the user *selects* the block. Saving without ever
+ *   selecting a migrated block would otherwise build the URL from empty/
+ *   default state and the campaign URL would not be saved.
+ *
+ * Why we read raw HTML, not compiled HTML:
+ *   Stripo's `compileEmail()` strips editor-only attributes (`esd-*`) from the
+ *   compiled output, so `esd-ext-config` is gone by the time the compiler
+ *   pipeline sees the HTML. The raw HTML from `getTemplateData()` preserves
+ *   the attribute as the migrator wrote it.
+ *
+ * Reference data pre-load:
+ *   When the template has recommendation blocks, this also pre-loads the
+ *   shared reference data (languages / currency list) so the save-time
+ *   required-fields validator can check each block's locale and currency
+ *   against the partner's real options. Best-effort — on a fetch failure the
+ *   validator degrades to its empty-list guard (`requiredFields.ts`) instead
+ *   of blocking the save or stranding the Save button.
+ */
+declare function hydrateRecommendationStoreFromRawHtml(rawHtml: string): Promise<void>;
 export declare const useTemplatePreparation: () => {
     prepareTemplateDetails: () => Promise<Omit<SavedTemplateDetails, "metadata">>;
+    hydrateRecommendationStore: typeof hydrateRecommendationStoreFromRawHtml;
 };
+export {};