@useinsider/guido 3.22.0-beta.0951deb → 3.22.0-beta.0af1132

package/README.md

@@ -150,7 +150,6 @@ const config: GuidoConfigInput = {
   ui?: {
     showHeader?: boolean,         // Default: true
     backButtonLabel?: string,
-    externalDisplayConditions?: boolean, // Default: false - Replace Stripo's display-condition UI with a Conditions tab in the settings panel and create/select drawers for reusable Liquid/Pongo display conditions.
   },
 
   // Optional: Feature toggles (defaults apply once initialized — see `ready` prop below)
@@ -167,6 +166,7 @@ const config: GuidoConfigInput = {
     allowlistEnabled?: boolean,   // Default: false - Pre-save domain-allowlist check (opt-in). Guido self-serves the block toaster (role lookup, deep-link, copy from window.trans).
     allowSaveWithErrors?: boolean, // Default: true - Allow the validation drawer's "Save and Continue" soft-save. Set false to hard-block invalid saves (transactional + unsubscribe pages).
     reusableRecommendationStrategy?: boolean, // Default: false - Assign an RRS strategy to recommendation blocks instead of per-block algorithm/filters/shuffle/product-count settings.
+    accessibilityTesting?: boolean, // Default: false - Show the Accessibility Test entry in the header kebab menu (Stripo's checker: contrast, image alternatives, colour-vision simulation) and the tab-bar onboarding tour that points at it.
   },
 
   // Optional: Callbacks
@@ -583,9 +583,9 @@ 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:
+Three surfaces also ship as their own entry points. Importing one pulls in only its
+own dependencies, so a consumer that needs the store, the tracking-id helpers or the
+runtime prefetch never loads the editor:
 
 ```typescript
 // Live editor state, published by the editor into the host's shared Pinia instance.
@@ -596,11 +596,42 @@ 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';
+
+// Start downloading the Stripo editor runtime before the editor opens.
+import { prefetchGuidoRuntime } from '@useinsider/guido/prefetch';
 ```
 
-Both are re-exported from the root barrel as well; the subpath is what keeps the
+All three are re-exported from the root barrel as well; the subpath is what keeps the
 editor out of the consumer's module graph.
 
+### Runtime prefetch
+
+```typescript
+import { prefetchGuidoRuntime } from '@useinsider/guido/prefetch';
+
+prefetchGuidoRuntime(); // e.g. when the user lands on the page that opens the editor
+```
+
+Call it as early as the host knows an editor is likely to open. It appends one
+`<link rel="prefetch" data-guido-prefetch>` per file of the pinned Stripo runtime
+(`src/static/stripo-runtime-manifest.json`) from
+`https://email-static.useinsider.com/guido/<stripo version>/`, so the files are in the
+HTTP cache when `<Guido>` mounts. It only downloads: no Stripo code runs and the
+editor's startup order does not change.
+
+- Returns `void` and never throws.
+- Idempotent: later calls add nothing.
+- Adds nothing when the runtime is already loading or loaded (`#UiEditorScript` exists
+  or `window.UIEditor` is defined), when the browser does not support `rel="prefetch"`
+  (Safari by default), when `navigator.connection.saveData` is on, or when
+  `navigator.connection.effectiveType` is `slow-2g` or `2g`.
+- The `guido_editor_open` metric reports it as `runtime_prefetch`: `none` (not called
+  before Guido's setup), `pending` (some files still downloading) or `done`.
+
+After bumping `guido.stripo.version`, regenerate the file list with
+`npm run stripo:manifest`; a unit test fails while the manifest's version differs from
+the pinned one.
+
 ---
 
 ## Constants

package/dist/@types/config/schemas.js

@@ -1,5 +1,5 @@
 import { ModuleFolderDefaults as S } from "../../enums/defaults.js";
-import { object as a, number as s, optional as e, string as t, picklist as m, pipe as i, minLength as b, custom as k, boolean as o, array as n, transform as y, unknown as r, record as g, fallback as R, literal as u, looseObject as C, variant as I, union as h, lazy as T } from "../../node_modules/valibot/dist/index.js";
+import { object as a, number as s, optional as e, string as t, picklist as m, pipe as i, minLength as b, custom as k, boolean as o, array as c, transform as y, unknown as r, record as g, fallback as R, literal as u, looseObject as C, variant as T, union as h, lazy as I } from "../../node_modules/valibot/dist/index.js";
 const p = {
   /** Promotional/marketing emails */
   PROMOTIONAL: 1,
@@ -76,30 +76,30 @@ const p = {
       value: t()
     })
   )
-}), f = T(() => C({
+}), f = I(() => C({
   text: e(t()),
   // eslint-disable-next-line camelcase -- backend field name
   tag_text: e(t()),
   value: e(t()),
-  children: e(n(f)),
+  children: e(c(f)),
   // eslint-disable-next-line camelcase -- backend field name
-  select_items: e(n(f))
-})), x = g(
+  select_items: e(c(f))
+})), N = g(
   t(),
-  R(n(f), [])
-), D = C({
+  R(c(f), [])
+), P = C({
   /** Block ID (matches the dictionary key and the legacy HTML element id) */
   id: e(s()),
   /** Decimal places for price display (legacy data may use string or number) */
   decimalCount: e(h([t(), s()])),
   /** Pinned product IDs (empty array when filter-driven) */
-  productIds: e(n(r())),
+  productIds: e(c(r())),
   /** Whether the block requested live products at send time */
   sendProductRequestFlag: e(o()),
   /** Whether to randomize product order */
   shuffleProducts: e(o()),
   /** Filter rules driving product selection */
-  filters: e(n(r())),
+  filters: e(c(r())),
   /** Currency code (e.g. 'EUR') — sometimes absent in legacy data */
   currency: e(t()),
   /** Currency display settings (separators, alignment, decimals) */
@@ -109,7 +109,7 @@ const p = {
   /** Recommendation strategy key (e.g. 'newArrivals') */
   strategy: e(t()),
   /** Snapshot of products as rendered by the legacy block */
-  recommendedProducts: e(n(r())),
+  recommendedProducts: e(c(r())),
   /** Number of product cards per row */
   cardsInRow: e(s()),
   /** Mobile-only padding (right) */
@@ -132,7 +132,7 @@ const p = {
   isPriceMovedToNextLine: e(o()),
   /** Legacy "Hide if same as discounted" / delete-price-for-zero-sale toggle */
   isPriceDeletedForZeroSale: e(o())
-}), N = a({
+}), v = a({
   /**
    * Legacy recommendation block configs keyed by block ID.
    * Pass this when loading a template authored with the v1
@@ -140,17 +140,17 @@ const p = {
    * strategy, currency, locale, and layout data.
    */
   recommendationConfigs: e(
-    g(t(), D),
+    g(t(), P),
     {}
   )
-}), P = a({
+}), x = a({
   /** Initial HTML content */
   html: e(t(), ""),
   /** Initial CSS content */
   css: e(t(), ""),
   /** Preselected dynamic content items */
   preselectedDynamicContent: e(
-    n(M),
+    c(M),
     []
   ),
   /**
@@ -159,11 +159,11 @@ const p = {
    * (first) partner's leaf attributes into the label→token map that repairs
    * label-form placeholders (`{{ Phone Number }}`) in dropped saved modules.
    */
-  dynamicContentList: e(x, {}),
+  dynamicContentList: e(N, {}),
   /** Valid custom field attribute names from the partner's categorized fields */
-  customFieldAttributes: e(n(t()), []),
+  customFieldAttributes: e(c(t()), []),
   /** Selected unsubscribe page IDs */
-  selectedUnsubscribePages: e(n(s()), []),
+  selectedUnsubscribePages: e(c(s()), []),
   /** Force recreate template in Stripo storage (use true when updating externally modified templates) */
   forceRecreate: e(o(), !1),
   /**
@@ -176,7 +176,7 @@ const p = {
   trackIdCounter: e(
     i(
       s(),
-      y((c) => Number.isFinite(c) ? Math.max(0, Math.floor(c)) : 0)
+      y((n) => Number.isFinite(n) ? Math.max(0, Math.floor(n)) : 0)
     ),
     0
   ),
@@ -190,12 +190,12 @@ const p = {
   recommendationCampaignUrls: e(
     i(
       r(),
-      y((c) => c && typeof c == "object" ? { ...c } : void 0)
+      y((n) => n && typeof n == "object" ? { ...n } : void 0)
     )
   ),
   /** Migration-only inputs (legacy block configs) */
-  migration: e(N, {})
-}), v = a({
+  migration: e(v, {})
+}), D = a({
   /** Sender display name */
   senderName: e(t(), ""),
   /** Email subject line */
@@ -208,7 +208,7 @@ const p = {
   /** Migration date for template compatibility */
   migrationDate: e(s(), 1759696858),
   /** Email header settings */
-  emailHeader: e(v, { senderName: "", subject: "" }),
+  emailHeader: e(D, { senderName: "", subject: "" }),
   /** Folder name for user-saved modules (used by Stripo plugin panel for path construction) */
   savedModulesFolderName: e(t(), S.SAVED_MODULES),
   /** Folder name for default/prebuilt modules (used by Stripo plugin panel for path construction) */
@@ -217,9 +217,7 @@ const p = {
   /** Whether to show the header bar */
   showHeader: e(o(), !0),
   /** Custom label for back button (if shown) */
-  backButtonLabel: e(t()),
-  /** Replace Stripo's display-condition UI with the Conditions tab and create/select drawers */
-  externalDisplayConditions: e(o(), !1)
+  backButtonLabel: e(t())
 }), U = a({
   /** Enable dynamic content insertion */
   dynamicContent: e(o(), !0),
@@ -239,6 +237,7 @@ const p = {
   liquidSyntax: e(o(), !1),
   /** Enable autosave (3-min interval + tab-hide). User toggles on/off from the header. */
   autosave: e(o(), !1),
+  accessibilityTesting: e(o(), !1),
   /** Enable pre-save domain-allowlist validation (opt-in; Guido self-serves the block toaster) */
   allowlistEnabled: e(o(), !1),
   /** Enable persistent link tracking-id assignment for the click heatmap (opt-in) */
@@ -271,12 +270,12 @@ const p = {
 ]), j = a({
   /** Default blocks to exclude from the editor */
   excludeDefaults: e(
-    n(w),
+    c(w),
     []
   ),
   /** Custom blocks to include in the editor */
   includeCustoms: e(
-    n(B),
+    c(B),
     []
   )
 }), d = a({
@@ -308,23 +307,23 @@ const p = {
   ...d.entries,
   type: u("remove"),
   /** Strings or patterns to remove */
-  targets: n(t())
+  targets: c(t())
 }), G = a({
   ...d.entries,
   type: u("custom"),
   /** Custom processor function */
   processor: k(
-    (c) => typeof c == "function",
+    (n) => typeof n == "function",
     "processor must be a function"
   )
-}), V = I("type", [
+}), V = T("type", [
   H,
   _,
   q,
   G
 ]), z = a({
   /** Custom compiler rules to apply */
-  customRules: e(n(V), []),
+  customRules: e(c(V), []),
   /** Skip default compiler rules */
   ignoreDefaultRules: e(o(), !1)
 }), W = a({
@@ -334,7 +333,7 @@ const p = {
    */
   externalValidation: e(
     k(
-      (c) => typeof c == "function",
+      (n) => typeof n == "function",
       "externalValidation must be a function"
     )
   )
@@ -346,7 +345,7 @@ const p = {
   partner: E,
   // Optional sections (with defaults)
   /** Template content and presets */
-  template: e(P, {}),
+  template: e(x, {}),
   /** Editor settings */
   editor: e(O, {}),
   /** UI configuration */
@@ -368,23 +367,23 @@ export {
   B as CustomBlockTypeSchema,
   G as CustomRuleSchema,
   w as DefaultBlockTypeSchema,
-  x as DynamicContentListSchema,
+  N as DynamicContentListSchema,
   f as DynamicContentNodeSchema,
   M as DynamicContentSchema,
   O as EditorSchema,
-  v as EmailHeaderSchema,
+  D as EmailHeaderSchema,
   L as FallbackFontSchema,
   U as FeaturesSchema,
   K as GuidoConfigSchema,
   A as IdentitySchema,
-  D as LegacyRecommendationConfigSchema,
+  P as LegacyRecommendationConfigSchema,
   p as MessageType,
   E as PartnerSchema,
   l as ProductType,
   _ as RegexRuleSchema,
   q as RemoveRuleSchema,
   H as ReplaceRuleSchema,
-  N as TemplateMigrationSchema,
-  P as TemplateSchema,
+  v as TemplateMigrationSchema,
+  x as TemplateSchema,
   F as UISchema
 };

package/dist/components/Guido.vue.js

@@ -1,20 +1,20 @@
-import i from "./Guido.vue2.js";
+import o from "./Guido.vue2.js";
 /* empty css           */
-import o from "../_virtual/_plugin-vue2_normalizer.js";
+import i from "../_virtual/_plugin-vue2_normalizer.js";
 var t = function() {
   var a = this, r = a._self._c, e = a._self._setupProxy;
-  return r("div", { ref: "wrapperRef", staticClass: "guido-editor__wrapper", class: { "guido-editor__no-header": e.noHeader } }, [r(e.HeaderWrapper, { ref: "headerWrapperRef" }), r(e.AutoSaveController), e.editorStore.isPreviewModeOpen ? r(e.PreviewContainer) : a._e(), r("div", { directives: [{ name: "show", rawName: "v-show", value: !e.previewStore.isLoaded, expression: "!previewStore.isLoaded" }], staticClass: "guido-editor__container", class: { "guido-editor__no-header": e.noHeader }, attrs: { id: "guido-editor" } }), r(e.Toaster), r(e.AuthErrorModal), r(e.FilterSelectionDrawer), e.isRrsEnabled || e.hasAssignedStrategy ? r(e.AssignStrategyDrawer) : a._e(), e.isRrsEnabled || e.hasAssignedStrategy ? r(e.RemoveStrategyModal) : a._e(), e.isRrsEnabled ? r(e.LegacyStrategyUpdatedModal) : a._e(), r(e.SaveAsTemplateDrawer), e.isSaveValidationEnabled ? r(e.ValidationErrorDrawer) : a._e(), e.isExternalDisplayConditionsEnabled ? r(e.DisplayConditionsHost) : a._e(), e.isTestPartner() ? a._e() : r(e.OnboardingWrapper, { on: { "onboarding-finished": function(_) {
+  return r("div", { ref: "wrapperRef", staticClass: "guido-editor__wrapper", class: { "guido-editor__no-header": e.noHeader } }, [r(e.HeaderWrapper), r(e.AutoSaveController, { ref: "autoSaveControllerRef" }), e.editorStore.isPreviewModeOpen ? r(e.PreviewContainer) : a._e(), r("div", { directives: [{ name: "show", rawName: "v-show", value: !e.previewStore.isLoaded, expression: "!previewStore.isLoaded" }], staticClass: "guido-editor__container", class: { "guido-editor__no-header": e.noHeader }, attrs: { id: "guido-editor" } }), r(e.Toaster), r(e.AuthErrorModal), r(e.FilterSelectionDrawer), e.isRrsEnabled || e.hasAssignedStrategy ? r(e.AssignStrategyDrawer) : a._e(), e.isRrsEnabled || e.hasAssignedStrategy ? r(e.RemoveStrategyModal) : a._e(), e.isRrsEnabled ? r(e.LegacyStrategyUpdatedModal) : a._e(), r(e.SaveAsTemplateDrawer), e.isSaveValidationEnabled ? r(e.ValidationErrorDrawer) : a._e(), e.isTestPartner() ? a._e() : r(e.OnboardingWrapper, { on: { "onboarding-finished": function(_) {
     return e.emit("onboarding:finished");
   } } }), r(e.UnsubscribeWrapper), r(e.LoadingWrapper)], 1);
-}, s = [], n = /* @__PURE__ */ o(
-  i,
+}, s = [], n = /* @__PURE__ */ i(
+  o,
   t,
   s,
   !1,
   null,
-  "5d5e32de"
+  "8422eef8"
 );
-const v = n.exports;
+const c = n.exports;
 export {
-  v as default
+  c as default
 };