@useinsider/guido 1.0.0-beta.dad21f4 → 1.0.0-beta.dbd0bad

package/README.md

@@ -47,7 +47,9 @@ export default {
       emailId: 'abc123',
       userId: '12345',
       guidoConfig: {
-        translationsPath: 'window.trans.en'
+        translationsPath: 'window.trans.en',
+        htmlCompilerRules: [],
+        ignoreDefaultHtmlCompilerRules: false,
       }
       dynamicContentModalVisible: false
     };
@@ -58,15 +60,20 @@ export default {
       this.dynamicContentModalVisible = true;
     }
     // ⚠️ Your own Dynamic Content Modal should have this id: #guido-dynamic-content-modal
-    handleDynamicContentApply() {
-      this.$ref.guidoEditor.applyDynamicContent({
+    handleDynamicContentInsert() {
+      this.$ref.guidoEditor?.dynamicContent.insert({
         text: 'Text', 
         value: 'Value', 
         fallback: 'Fallback'
       });
 
       this.dynamicContentModalVisible = false;
+    },
+    // ⚠️ It's mandatory. There is no way to understand if user closes the modal without selection.
+    handleDynamicContentClose() {
+      this.$ref.guidoEditor?.dynamicContent.close();
     }
+
   }
 };
 </script>
@@ -87,7 +94,8 @@ export default {
 
 ### Guido Exposed Methods
 ```typescript
-applyDynamicContent(DynamicContent);
+dynamicContent.insert(DynamicContent);
+dynamicContent.close();
 ```
 
 ### Guido Interfaces
@@ -95,12 +103,16 @@ applyDynamicContent(DynamicContent);
 ```typescript
 interface GuidoConfig {
   translationsPath: string;
+  htmlCompilerRules: CompilerRule[];
+  ignoreDefaultHtmlCompilerRules: boolean;
 }
 ```
 
 | Property | Type | Default | Description |
 |----------|------|---------|-------------|
 | `translationsPath` | `string` | `'window.trans.en'` | JavaScript path to the translations object |
+| `htmlCompilerRules` | `CompilerRule[]` | `[]` | Additional compiler rules to apply to HTML content. See [HTML Compiler Rules](#-html-compiler-rules) section below |
+| `ignoreDefaultHtmlCompilerRules` | `boolean` | `false` | Skip default compiler rules and only use custom rules. Default rules: `src/config/compiler/htmlCompilerRules.ts` |
 
 ```typescript
 interface DynamicContent {
@@ -109,6 +121,7 @@ interface DynamicContent {
   fallback?: string;
 }
 ```
+---
 
 | Property | Type | Default | Description |
 |----------|------|---------|-------------|
@@ -129,6 +142,185 @@ import type { GuidoConfig } from '@useinsider/guido';
 import type { StripoEventType } from '@useinsider/guido';
 ```
 
+## 🔨 HTML Compiler Rules
+
+Guido includes a powerful HTML compiler system that allows you to transform HTML content with custom rules. You can define additional rules and optionally ignore the default rules.
+
+### Rule Types
+
+There are 4 types of compiler rules:
+
+#### 1. Replace Rule
+Replace specific strings in HTML content.
+
+```typescript
+{
+  id: 'fix-encoding',
+  description: 'Fix URL encoding issues',
+  type: 'replace',
+  search: '{%22',           // String to find
+  replacement: '%7B%22',    // String to replace with
+  replaceAll: true,         // Replace all occurrences (default: true)
+  priority: 10              // Execution priority (lower = earlier)
+}
+```
+
+#### 2. Regex Rule
+Use regular expressions for complex pattern matching and replacement.
+
+```typescript
+{
+  id: 'remove-comments',
+  description: 'Remove HTML comments',
+  type: 'regex',
+  pattern: '<!--.*?-->',    // Regex pattern
+  replacement: '',          // Replacement string
+  flags: 'g',              // Regex flags (default: 'g')
+  priority: 20
+}
+```
+
+#### 3. Remove Rule
+Remove specific strings or patterns from HTML content.
+
+```typescript
+{
+  id: 'cleanup-scripts',
+  description: 'Remove unwanted script tags',
+  type: 'remove',
+  targets: [                              // Array of strings or RegExp objects
+    '<script src="unwanted.js"></script>',
+    /onclick="[^"]*"/g
+  ],
+  priority: 30
+}
+```
+
+#### 4. Custom Rule
+Define complex transformation logic with a custom processor function.
+
+```typescript
+{
+  id: 'add-meta-tags',
+  description: 'Add custom meta tags to head',
+  type: 'custom',
+  processor: (html: string): string => {
+    // Custom transformation logic
+    const metaTags = '<meta name="custom" content="value">';
+    return html.replace('</head>', `${metaTags}</head>`);
+  },
+  priority: 40
+}
+```
+
+### Using HTML Compiler Rules
+
+#### Basic Usage with Custom Rules
+
+```typescript
+const guidoConfig = {
+  translationsPath: 'window.trans.en',
+  htmlCompilerRules: [
+    {
+      id: 'replace-domain',
+      description: 'Replace old domain with new one',
+      type: 'replace',
+      search: 'old-domain.com',
+      replacement: 'new-domain.com',
+      replaceAll: true,
+      priority: 10
+    },
+    {
+      id: 'remove-tracking',
+      description: 'Remove tracking pixels',
+      type: 'regex',
+      pattern: '<img[^>]*tracking[^>]*>',
+      replacement: '',
+      flags: 'gi',
+      priority: 20
+    }
+  ]
+};
+```
+
+#### Ignoring Default Rules
+
+```typescript
+const guidoConfig = {
+  translationsPath: 'window.trans.en',
+  ignoreDefaultHtmlCompilerRules: true, // Skip all default rules
+  htmlCompilerRules: [
+    // Only your custom rules will be applied
+    {
+      id: 'custom-transformation',
+      type: 'replace',
+      search: 'old-text',
+      replacement: 'new-text',
+      priority: 1
+    }
+  ]
+};
+```
+
+### Rule Execution Order
+
+Rules are executed in priority order (lower numbers first). Rules with the same priority are executed in array order.
+
+- **Priority 1-99**: Reserved for critical transformations
+- **Priority 100-999**: Standard transformations  
+- **Priority 1000+**: Additional custom rules (automatically assigned)
+
+### Default Rules
+
+Guido includes several default rules for common email HTML optimizations:
+
+- **URL encoding fixes**: Fixes malformed URL encoding in dynamic content
+- **Template tag restoration**: Restores `{{}}` template tags that got URL encoded
+- **HTML entity decoding**: Converts `&lt;` and `&gt;` back to `<` and `>`
+- **Cleanup rules**: Removes unwanted iframe and style elements
+- **MSO conditions**: Manages Outlook-specific conditional comments
+- **Domain replacement**: Updates old image domains to current ones
+
+You can view all default rules in: `src/config/compiler/htmlCompilerRules.ts`
+
+### CompilerRule Interface
+
+```typescript
+type CompilerRuleType = 'replace' | 'regex' | 'remove' | 'custom';
+
+interface BaseCompilerRule {
+  id: string;
+  description?: string;
+  priority: number;
+}
+
+interface ReplaceRule extends BaseCompilerRule {
+  type: 'replace';
+  search: string;
+  replacement: string;
+  replaceAll?: boolean; // Default: true
+}
+
+interface RegexRule extends BaseCompilerRule {
+  type: 'regex';
+  pattern: string;
+  replacement: string;
+  flags?: string; // Default: 'g'
+}
+
+interface RemoveRule extends BaseCompilerRule {
+  type: 'remove';
+  targets: (string | RegExp)[]; // Array of strings or RegExp objects
+}
+
+interface CustomRule extends BaseCompilerRule {
+  type: 'custom';
+  processor: (html: string) => string;
+}
+
+type CompilerRule = ReplaceRule | RegexRule | RemoveRule | CustomRule;
+```
+
 ---
 
 ## 🔧 Development
@@ -210,16 +402,16 @@ Since bun does not have packaging yet, use npm here: 🥲
 npm pack
 ```
 
-It'll crate like `useinsider-guido-1.0.0.gz` file.
+It'll crate like `useinsider-guido-1.0.0.tgz` file.
 
 Move this file to your project path like: `email-fe` via:
 ```sh
-cp useinsider-guido-1.0.0.gz ../email-fe
+cp useinsider-guido-1.0.0.tgz ../email-fe
 ```
 
 Install the file to your project: 
 ```sh
-npm i ./useinsider-guido-1.0.0.gz
+npm i ./useinsider-guido-1.0.0.tgz
 ```
 
 Then you just need to rebuild to your project or restart the Container. 🎉

package/dist/@types/generic.d.ts

@@ -1,8 +1,17 @@
+import type { CompilerRule } from './html-compiler';
 export type GuidoConfig = {
     translationsPath: string;
+    htmlCompilerRules?: CompilerRule[];
+    ignoreDefaultHtmlCompilerRules?: boolean;
 };
 export type DynamicContent = {
     value: string;
     text: string;
     fallback?: string;
 };
+export interface TooltipOptions {
+    id: string;
+    dynamicPosition: boolean;
+    staticPosition: string;
+    iconStatus: boolean;
+}

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

@@ -8,7 +8,10 @@ type __VLS_Props = {
     guidoConfig: GuidoConfig;
 };
 declare const _default: import("vue").DefineComponent<__VLS_TypePropsToOption<__VLS_Props>, {
-    applyDynamicContent: (data: DynamicContent) => void;
+    dynamicContent: {
+        insert: (data: DynamicContent) => void;
+        close: () => void;
+    };
 }, {}, {}, {}, import("vue/types/v3-component-options.js").ComponentOptionsMixin, import("vue/types/v3-component-options.js").ComponentOptionsMixin, {
     "dynamic-content:open": (detail: DynamicContent | null) => void;
 }, string, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToOption<__VLS_Props>>>, {}>;

package/dist/components/Guido.vue.js

@@ -10,7 +10,7 @@ var s = function() {
   _,
   !1,
   null,
-  "1d1d2b7c"
+  "89423288"
 );
 const f = a.exports;
 export {

package/dist/components/Guido.vue2.js

@@ -1,10 +1,10 @@
-import { defineComponent as C, onMounted as w } from "vue";
-import { usePartner as _ } from "../composables/usePartner.js";
-import { useStripo as T } from "../composables/useStripo.js";
-import { useTemplates as b } from "../composables/useTemplates.js";
-import { DefaultUsername as h, DefaultGuidoConfig as v } from "../enums/defaults.js";
-import D from "./organisms/header/HeaderWrapper.vue.js";
-const x = /* @__PURE__ */ C({
+import { defineComponent as v, onMounted as w } from "vue";
+import { usePartner as h } from "../composables/usePartner.js";
+import { useStripo as D } from "../composables/useStripo.js";
+import { useTemplates as E } from "../composables/useTemplates.js";
+import { DefaultUsername as _, DefaultGuidoConfig as b } from "../enums/defaults.js";
+import T from "./organisms/header/HeaderWrapper.vue.js";
+const W = /* @__PURE__ */ v({
   __name: "Guido",
   props: {
     emailId: null,
@@ -15,28 +15,28 @@ const x = /* @__PURE__ */ C({
     guidoConfig: null
   },
   emits: ["dynamic-content:open"],
-  setup(g, { expose: y, emit: n }) {
-    const o = g, { getPartnerName: t, getProductType: r } = _(), {
+  setup(g, { expose: C, emit: n }) {
+    const t = g, { getPartnerName: o, getProductType: c } = h(), {
       emailId: i,
       userId: a,
-      guidoConfig: c,
-      partnerName: s = t(),
-      productType: u = r(),
-      username: d = h
-    } = o;
+      guidoConfig: r,
+      partnerName: s = o(),
+      productType: d = c(),
+      username: u = _
+    } = t;
     window.GuidoConfig = {
-      ...v,
-      ...c
+      ...b,
+      ...r
     };
-    const { initPlugin: m } = T({ emailId: i, userId: a, username: d, partnerName: s, productType: u }), { getDefaultTemplate: p } = b(), l = (e) => {
-      console.debug("dynamic-content:close", e), document.dispatchEvent(new CustomEvent("dynamic-content:close", {
-        detail: e
-      }));
+    const { initPlugin: m } = D({ emailId: i, userId: a, username: u, partnerName: s, productType: d }), { getDefaultTemplate: l } = E(), p = (e) => {
+      console.debug("dynamic-content:close", e), document.dispatchEvent(new CustomEvent("dynamic-content:close", { detail: e }));
+    }, y = () => {
+      console.debug("dynamic-content:close", "Without Data"), document.dispatchEvent(new CustomEvent("dynamic-content:close", { detail: { text: "", value: "" } }));
     };
     return w(async () => {
       console.debug("Guido says happy coding 🎉"), console.debug("🚗 Ka-Chow");
       try {
-        const e = await p();
+        const e = await l();
         await m(e);
       } catch (e) {
         console.error("Failed to initialize Stripo editor:", e);
@@ -45,11 +45,14 @@ const x = /* @__PURE__ */ C({
         const f = e;
         console.debug("dynamic-content:open", f.detail), n("dynamic-content:open", f.detail);
       });
-    }), y({
-      applyDynamicContent: l
-    }), { __sfc: !0, props: o, getPartnerName: t, getProductType: r, emailId: i, userId: a, guidoConfig: c, partnerName: s, productType: u, username: d, emit: n, initPlugin: m, getDefaultTemplate: p, applyDynamicContent: l, HeaderWrapper: D };
+    }), C({
+      dynamicContent: {
+        insert: p,
+        close: y
+      }
+    }), { __sfc: !0, props: t, getPartnerName: o, getProductType: c, emailId: i, userId: a, guidoConfig: r, partnerName: s, productType: d, username: u, emit: n, initPlugin: m, getDefaultTemplate: l, insertDynamicContent: p, closeDynamicContent: y, HeaderWrapper: T };
   }
 });
 export {
-  x as default
+  W as default
 };

package/dist/components/organisms/header/MiddleSlot.vue.js

@@ -1,17 +1,17 @@
-import s from "./MiddleSlot.vue2.js";
-import i from "../../../_virtual/_plugin-vue2_normalizer.js";
+import i from "./MiddleSlot.vue2.js";
+import s from "../../../_virtual/_plugin-vue2_normalizer.js";
 var n = function() {
   var e = this, o = e._self._c, t = e._self._setupProxy;
-  return t.editorStore.isVersionHistoryOpen ? o("div", { staticClass: "d-f" }, [o(t.VersionHistory), o(t.VersionHistoryViewOptions)], 1) : o("div", { staticClass: "d-f" }, [o(t.InButtonV2, { attrs: { id: "guido__undo-button", "left-icon": "line-undo", styling: "ghost", type: "secondary", "label-text-status": !1 } }), o(t.InButtonV2, { attrs: { id: "guido__redo-button", "left-icon": "line-redo", styling: "ghost", type: "secondary", "label-text-status": !1 } }), o(t.InButtonV2, { attrs: { id: "guido__code-button", "left-icon": "line-code", styling: "ghost", "tooltip-text": "Code Editor", type: "secondary", "label-text-status": !1, "selected-status": t.editorStore.isCodeEditorOpen, "tooltip-options": t.getTooltipOptions("guido__code-button") } }), o(t.InButtonV2, { attrs: { id: "guido__preview-button", "left-icon": "line-show-on", styling: "ghost", type: "secondary", "label-text-status": !1, "tooltip-options": t.getTooltipOptions("guido__preview-button"), "tooltip-text": t.trans("newsletter.email-preview") } }), o(t.ViewOptions, { staticClass: "ml-3" })], 1);
-}, l = [], r = /* @__PURE__ */ i(
-  s,
+  return t.editorStore.isVersionHistoryOpen ? o("div", { staticClass: "d-f" }, [o(t.VersionHistory), o(t.VersionHistoryViewOptions)], 1) : o("div", { staticClass: "d-f" }, [o(t.InButtonV2, { attrs: { id: "guido__undo-button", "left-icon": "line-undo", styling: "ghost", type: "secondary", "label-text-status": !1, "tooltip-options": t.getTooltipOptions("guido__undo-button"), "tooltip-text": t.trans("action-builder.undo") } }), o(t.InButtonV2, { attrs: { id: "guido__redo-button", "left-icon": "line-redo", styling: "ghost", type: "secondary", "label-text-status": !1, "tooltip-options": t.getTooltipOptions("guido__redo-button"), "tooltip-text": t.trans("action-builder.redo") } }), o(t.InButtonV2, { attrs: { id: "guido__code-button", "data-testid": "Code Editor", "left-icon": "line-code", styling: "ghost", type: "secondary", "label-text-status": !1, "selected-status": t.editorStore.isCodeEditorOpen, "tooltip-options": t.getTooltipOptions("guido__code-button"), "tooltip-text": t.codeEditorTooltipText } }), o(t.InButtonV2, { attrs: { id: "guido__preview-button", "left-icon": "line-show-on", styling: "ghost", type: "secondary", "label-text-status": !1, "selected-status": t.editorStore.isPreviewModeOpen, "tooltip-options": t.getTooltipOptions("guido__preview-button"), "tooltip-text": t.previewTooltipText }, on: { click: t.handlePreview } }), o(t.ViewOptions, { staticClass: "ml-3" })], 1);
+}, l = [], r = /* @__PURE__ */ s(
+  i,
   n,
   l,
   !1,
   null,
   null
 );
-const p = r.exports;
+const u = r.exports;
 export {
-  p as default
+  u as default
 };

package/dist/components/organisms/header/MiddleSlot.vue2.js

@@ -1,22 +1,20 @@
-import { defineComponent as r } from "vue";
-import { useTranslations as s } from "../../../composables/useTranslations.js";
-import { useEditorStore as n } from "../../../stores/editor.js";
-import { InButtonV2 as e } from "@useinsider/design-system-vue";
-import m from "./version-history/VersionHistory.vue.js";
-import p from "./version-history/ViewOptions.vue.js";
-import f from "./ViewOptions.vue.js";
-const y = /* @__PURE__ */ r({
+import { defineComponent as s, computed as t } from "vue";
+import { useTranslations as n } from "../../../composables/useTranslations.js";
+import { useEditorStore as p } from "../../../stores/editor.js";
+import { getTooltipOptions as m } from "../../../utils/tooltipUtils.js";
+import { InButtonV2 as l } from "@useinsider/design-system-vue";
+import d from "./version-history/VersionHistory.vue.js";
+import w from "./version-history/ViewOptions.vue.js";
+import c from "./ViewOptions.vue.js";
+const M = /* @__PURE__ */ s({
   __name: "MiddleSlot",
-  setup(a) {
-    const o = n(), t = s();
-    return { __sfc: !0, editorStore: o, trans: t, getTooltipOptions: (i) => ({
-      id: `${i}-tooltip`,
-      dynamicPosition: !1,
-      staticPosition: "bottom center",
-      iconStatus: !1
-    }), InButtonV2: e, VersionHistory: m, VersionHistoryViewOptions: p, ViewOptions: f };
+  setup(f) {
+    const e = p(), o = n(), r = t(() => e.isCodeEditorOpen ? o("newsletter.close-html-editor") : o("newsletter.html-editor")), i = t(() => e.isPreviewModeOpen ? o("newsletter.close-email-preview") : o("newsletter.email-preview"));
+    return { __sfc: !0, editorStore: e, trans: o, codeEditorTooltipText: r, previewTooltipText: i, handlePreview: () => {
+      e.isPreviewModeOpen = !e.isPreviewModeOpen;
+    }, getTooltipOptions: m, InButtonV2: l, VersionHistory: d, VersionHistoryViewOptions: w, ViewOptions: c };
   }
 });
 export {
-  y as default
+  M as default
 };

package/dist/components/organisms/header/RightSlot.vue.js

@@ -1,17 +1,17 @@
-import o from "./RightSlot.vue2.js";
+import s from "./RightSlot.vue2.js";
 import i from "../../../_virtual/_plugin-vue2_normalizer.js";
 var n = function() {
-  var s = this, e = s._self._c, t = s._self._setupProxy;
-  return e("div", { staticClass: "d-f" }, [e(t.InButtonV2, { attrs: { id: "guido__history-button", "left-icon": "line-architect-version-history", styling: "ghost", type: "secondary", "label-text-status": !1, "selected-status": t.editorStore.isVersionHistoryOpen }, on: { click: t.handleVersionHistory } }), e(t.InButtonV2, { attrs: { id: "guido__export-button", "left-icon": "line-export", styling: "ghost", type: "secondary", "disabled-status": t.editorStore.isVersionHistoryOpen, "label-text-status": !1 }, on: { click: t.exportHtml } }), e(t.InButtonV2, { attrs: { id: "guido__save-as-button", "left-icon": "line-newsletter-save-as-template", styling: "ghost", type: "secondary", "disabled-status": t.editorStore.isVersionHistoryOpen, "label-text-status": !1 } }), e(t.InButtonV2, { attrs: { id: "guido__test-button", "left-icon": "line-architect-test-journey", styling: "ghost", type: "secondary", "disabled-status": t.editorStore.isVersionHistoryOpen, "label-text-status": !1 } }), e(t.InButtonV2, { staticClass: "ml-3", attrs: { id: "guido__save-button", "label-text": "Save", "disabled-status": t.editorStore.isVersionHistoryOpen } })], 1);
-}, r = [], a = /* @__PURE__ */ i(
-  o,
+  var e = this, o = e._self._c, t = e._self._setupProxy;
+  return o("div", { staticClass: "d-f" }, [o(t.InButtonV2, { attrs: { id: "guido__history-button", "left-icon": "line-architect-version-history", styling: "ghost", type: "secondary", "label-text-status": !1, "selected-status": t.editorStore.isVersionHistoryOpen, "tooltip-options": t.getTooltipOptions("guido__history-button"), "tooltip-text": t.versionHistoryTooltipText }, on: { click: t.handleVersionHistory } }), o(t.InButtonV2, { attrs: { id: "guido__export-button", "left-icon": "line-export", styling: "ghost", type: "secondary", "disabled-status": t.editorStore.isVersionHistoryOpen, "label-text-status": !1, "tooltip-options": t.getTooltipOptions("guido__export-button"), "tooltip-text": t.trans("newsletter.export") }, on: { click: t.exportHtml } }), o(t.InButtonV2, { attrs: { id: "guido__save-as-button", "left-icon": "line-newsletter-save-as-template", styling: "ghost", type: "secondary", "disabled-status": t.editorStore.isVersionHistoryOpen, "label-text-status": !1, "tooltip-options": t.getTooltipOptions("guido__save-as-button"), "tooltip-text": t.trans("newsletter.save-templates") } }), o(t.InButtonV2, { attrs: { id: "guido__test-button", "left-icon": "line-architect-test-journey", styling: "ghost", type: "secondary", "disabled-status": t.editorStore.isVersionHistoryOpen, "label-text-status": !1, "tooltip-options": t.getTooltipOptions("guido__test-button"), "tooltip-text": t.trans("newsletter.test-email") } }), o(t.InButtonV2, { staticClass: "ml-3", attrs: { id: "guido__save-button", "label-text": "Save", "disabled-status": t.editorStore.isVersionHistoryOpen } })], 1);
+}, r = [], l = /* @__PURE__ */ i(
+  s,
   n,
   r,
   !1,
   null,
   null
 );
-const c = a.exports;
+const d = l.exports;
 export {
-  c as default
+  d as default
 };

package/dist/components/organisms/header/RightSlot.vue2.js

@@ -1,21 +1,23 @@
-import { defineComponent as s } from "vue";
-import { useExport as i } from "../../../composables/useExport.js";
-import { useVersionHistoryApi as n } from "../../../composables/useVersionHistoryApi.js";
-import { useEditorStore as p } from "../../../stores/editor.js";
-import { InButtonV2 as m } from "@useinsider/design-system-vue";
-const d = /* @__PURE__ */ s({
+import { defineComponent as p, computed as m } from "vue";
+import { useExport as c } from "../../../composables/useExport.js";
+import { useTranslations as f } from "../../../composables/useTranslations.js";
+import { useVersionHistoryApi as l } from "../../../composables/useVersionHistoryApi.js";
+import { useEditorStore as u } from "../../../stores/editor.js";
+import { getTooltipOptions as y } from "../../../utils/tooltipUtils.js";
+import { InButtonV2 as a } from "@useinsider/design-system-vue";
+const O = /* @__PURE__ */ p({
   __name: "RightSlot",
-  setup(f) {
-    const { exportHtml: e } = i(), { openVersionHistory: o, closeVersionHistory: r } = n(), t = p();
-    return { __sfc: !0, exportHtml: e, openVersionHistory: o, closeVersionHistory: r, editorStore: t, handleVersionHistory: () => {
-      if (t.isVersionHistoryOpen) {
-        r();
+  setup(H) {
+    const { exportHtml: e } = c(), { openVersionHistory: r, closeVersionHistory: s } = l(), o = u(), t = f(), i = () => {
+      if (o.isVersionHistoryOpen) {
+        s();
         return;
       }
-      o();
-    }, InButtonV2: m };
+      r();
+    }, n = m(() => o.isVersionHistoryOpen ? t("newsletter.close-version-history") : t("newsletter.version-history"));
+    return { __sfc: !0, exportHtml: e, openVersionHistory: r, closeVersionHistory: s, editorStore: o, trans: t, handleVersionHistory: i, versionHistoryTooltipText: n, getTooltipOptions: y, InButtonV2: a };
   }
 });
 export {
-  d as default
+  O as default
 };

package/dist/composables/useExport.d.ts

@@ -1,3 +1,3 @@
 export declare const useExport: () => {
-    exportHtml: () => Promise<void>;
+    exportHtml: (compile?: boolean) => Promise<void>;
 };

package/dist/composables/useExport.js

@@ -1,30 +1,45 @@
 import { useActionsApi as l } from "./useActionsApi.js";
-import { useToaster as m } from "./useToaster.js";
-const u = () => {
-  const a = (r, t, e) => {
-    const n = new Blob([r], { type: e }), s = URL.createObjectURL(n), o = document.createElement("a");
-    o.href = s, o.download = t, document.body.appendChild(o), o.click(), document.body.removeChild(o), URL.revokeObjectURL(s);
-  }, c = (r) => {
-    const t = /* @__PURE__ */ new Date(), e = String(t.getDate()).padStart(2, "0"), n = String(t.getMonth() + 1).padStart(2, "0"), s = t.getFullYear(), o = String(t.getHours()).padStart(2, "0"), i = String(t.getMinutes()).padStart(2, "0");
-    return `${r}_${e}-${n}-${s}_${o}-${i}.html`;
+import { useHtmlCompiler as m } from "./useHtmlCompiler.js";
+import { useToaster as d } from "./useToaster.js";
+const h = () => {
+  const a = (s, o, r) => {
+    const i = new Blob([s], { type: r }), t = URL.createObjectURL(i), e = document.createElement("a");
+    e.href = t, e.download = o, document.body.appendChild(e), e.click(), document.body.removeChild(e), URL.revokeObjectURL(t);
+  }, c = (s) => {
+    const o = /* @__PURE__ */ new Date(), r = String(o.getDate()).padStart(2, "0"), i = String(o.getMonth() + 1).padStart(2, "0"), t = o.getFullYear(), e = String(o.getHours()).padStart(2, "0"), n = String(o.getMinutes()).padStart(2, "0");
+    return `${s}_${r}-${i}-${t}_${e}-${n}.html`;
   };
-  return { exportHtml: async () => {
-    const { getCompiledEmail: r } = l(), { showToaster: t } = m();
+  return { exportHtml: async (s = !0) => {
+    const { getCompiledEmail: o } = l(), { showToaster: r } = d(), { compileHtml: i } = m();
     try {
-      const { html: e } = await r();
-      e ? a(e, c("HTML"), "text/html") : t({
+      const { html: t } = await o();
+      if (t) {
+        let e = t;
+        if (s) {
+          const n = i(t);
+          e = n.compiledHtml, console.debug("HTML Compilation Stats:", {
+            originalSize: n.stats.originalSize,
+            compiledSize: n.stats.compiledSize,
+            reduction: `${n.stats.reductionPercentage.toFixed(2)}%`,
+            appliedRules: n.appliedRules,
+            executionTime: `${n.stats.executionTime.toFixed(2)}ms`
+          });
+        }
+        a(e, c("HTML"), "text/html");
+      } else
+        r({
+          type: "error",
+          message: "No HTML content to download"
+        });
+    } catch (t) {
+      const e = t instanceof Error ? t.message : String(t);
+      r({
         type: "error",
-        message: "No HTML content to download"
-      });
-    } catch (e) {
-      const n = e instanceof Error ? e.message : String(e);
-      t({
-        type: "error",
-        message: `Error compiling email: ${n}`
+        message: `Error compiling email: ${e}`
       });
     }
   } };
 };
 export {
-  u as useExport
+  h as useExport
 };

package/dist/composables/useHtmlCompiler.d.ts

@@ -0,0 +1,4 @@
+import type { CompilationResult } from '@@/Types/html-compiler';
+export declare const useHtmlCompiler: () => {
+    compileHtml: (html: string) => CompilationResult;
+};

package/dist/composables/useHtmlCompiler.js

@@ -0,0 +1,16 @@
+import { defaultHtmlCompilerRules as r } from "../config/compiler/htmlCompilerRules.js";
+import { createHtmlCompiler as p } from "../utils/htmlCompiler.js";
+const a = () => {
+  const e = typeof window < "u" ? window.GuidoConfig : void 0, l = (e == null ? void 0 : e.htmlCompilerRules) || [], t = [
+    ...!!(e != null && e.ignoreDefaultHtmlCompilerRules) ? [] : r,
+    ...l.map((o, m) => ({
+      ...o,
+      priority: o.priority + 1e3 + m
+      // Ensure additional rules run after default rules
+    }))
+  ], i = p(t);
+  return { compileHtml: (o) => i.compile(o) };
+};
+export {
+  a as useHtmlCompiler
+};

package/dist/config/compiler/htmlCompilerRules.d.ts

@@ -0,0 +1,2 @@
+import type { CompilerRule } from '@@/Types/html-compiler';
+export declare const defaultHtmlCompilerRules: CompilerRule[];

package/dist/config/compiler/htmlCompilerRules.js

@@ -0,0 +1,145 @@
+const a = [
+  {
+    id: "fix-url-encoding-start",
+    description: "Replace {%22 with %7B%22 to fix URL encoding",
+    type: "replace",
+    search: "{%22",
+    replacement: "%7B%22",
+    replaceAll: !0,
+    priority: 10
+  },
+  {
+    id: "fix-url-encoding-end",
+    description: "Replace %22} with %22%7D to fix URL encoding",
+    type: "replace",
+    search: "%22}",
+    replacement: "%22%7D",
+    replaceAll: !0,
+    priority: 10
+  },
+  {
+    id: "fix-tags-start",
+    description: "Replace %7B%7B with {{ to fix URL encoding",
+    type: "replace",
+    search: "%7B%7B",
+    replacement: "{{",
+    replaceAll: !0,
+    priority: 11
+  },
+  {
+    id: "fix-tags-end",
+    description: "Replace %7D%7D with }} to fix URL encoding",
+    type: "replace",
+    search: "%7D%7D",
+    replacement: "}}",
+    replaceAll: !0,
+    priority: 12
+  },
+  {
+    id: "unescape-inequality-operators-start",
+    description: "Replace &lt; with < to fix URL encoding",
+    type: "replace",
+    search: "&lt;",
+    replacement: "<",
+    replaceAll: !0,
+    priority: 13
+  },
+  {
+    id: "unescape-inequality-operators-end",
+    description: "Replace &gt; with > to fix URL encoding",
+    type: "replace",
+    search: "&gt;",
+    replacement: ">",
+    replaceAll: !0,
+    priority: 14
+  },
+  {
+    id: "remove-apty-iframe",
+    description: "Cleanup Apty Iframe Code",
+    type: "remove",
+    targets: [
+      '<iframe src="about:blank" id="letznav-iframe-script" allowtransparency="true" style="width:1px;height:1px"></iframe>',
+      'src="about:blank" id="letznav-iframe-script" allowtransparency="true" style="width:1px;height:1px"></iframe>'
+    ],
+    priority: 20
+  },
+  {
+    id: "remove-apty-styles",
+    description: "Removing Apty Styles",
+    type: "regex",
+    pattern: '<styles*data-styles="apty_styles"s* type="text/css"s*>((s|.)*?)</style>',
+    replacement: "",
+    flags: "g",
+    priority: 21
+  },
+  {
+    id: "remove-mso-conditions",
+    description: "Removing MSO Conditions",
+    type: "remove",
+    targets: [
+      /<!--\[if\s\(mso 16\)\]>\s*<style\s*\S*>\s*a\s*\{\s*text-decoration\s*:\s*none\s*;*\s*\}\s*<\/style>\s*<!\[endif\]-->/g,
+      /<!--\[if\sgte mso 9\]>\s*<style\s*\S*>\s*sup\s*\{\s*font-size\s*:\s*100%\s*!important\s*;*\s*\}\s*<\/style>\s*<!\[endif\]-->/g,
+      /<!--\[if\sgte mso 9\]>\s*<noscript>\s*<xml>\s*<o:OfficeDocumentSettings>\s*<o:AllowPNG>\s*<\/o:AllowPNG>\s*<o:PixelsPerInch>\d+<\/o:PixelsPerInch>\s*<\/o:OfficeDocumentSettings>\s*<\/xml>\s*<\/noscript>\s*<!\[endif\]-->/g,
+      /<!--\[if mso\]>\s*<xml>\s*<w:WordDocument\s+xmlns:w="urn:schemas-microsoft-com:office:word">\s*<w:DontUseAdvancedTypographyReadingMail><\/w:DontUseAdvancedTypographyReadingMail>\s*<\/w:WordDocument>\s*<\/xml>\s*<!\[endif\]-->/g,
+      /<\!--\[if \!mso\]><\!--\s*\d*\s*-->\s*<\!--\[if \!mso\]><\!--\s*\d*\s*-->\s*<\!--<!\[endif\]-->/g,
+      /<!--\[if\s\!mso\]>\s*<!-- \d -->/g
+    ],
+    priority: 22
+  },
+  {
+    id: "add-mso-conditions",
+    description: "Adding MSO Conditions",
+    type: "custom",
+    processor: (e) => {
+      const t = [
+        `<!--[if gte mso 9]>
+<style>sup {
+    font-size: 100% !important;
+}</style><![endif]-->`,
+        `<!--[if gte mso 9]>
+<noscript>
+    <xml>
+        <o:OfficeDocumentSettings>
+            <o:AllowPNG></o:AllowPNG>
+            <o:PixelsPerInch>96</o:PixelsPerInch>
+        </o:OfficeDocumentSettings>
+    </xml>
+</noscript><![endif]-->`,
+        `<!--[if mso]>
+<xml>
+    <w:WordDocument xmlns:w="urn:schemas-microsoft-com:office:word">
+        <w:DontUseAdvancedTypographyReadingMail></w:DontUseAdvancedTypographyReadingMail>
+    </w:WordDocument>
+</xml><![endif]-->`
+      ], s = /<head>([\S\s]*)<\/head>/, o = new RegExp(s);
+      if (!e.match(o))
+        return e;
+      let i = e;
+      return t.forEach((r) => {
+        i = i.replace("</head>", `${r}</head>`);
+      }), i;
+    },
+    priority: 30
+  },
+  {
+    id: "replace-old-image-domain",
+    description: "Replacing old image domains",
+    type: "replace",
+    search: "stripo-editor-image.s3-eu-west-1.amazonaws.com",
+    replacement: "email-static.useinsider.com",
+    replaceAll: !0,
+    priority: 40
+  },
+  {
+    id: "replace-old-v2-image-domain",
+    description: "Replacing old image domains",
+    type: "replace",
+    search: "email.static.useinsider.com",
+    replacement: "email-static.useinsider.com",
+    replaceAll: !0,
+    priority: 41
+  }
+];
+export {
+  a as defaultHtmlCompilerRules
+};

package/dist/guido.css

@@ -1 +1 @@
-.version-history-item[data-v-ee4b9c3f]{flex-basis:200px}.version-history-wrapper[data-v-52a77eec]{gap:8px}[data-v-6a2bde67] .guido__verion-history-view-option-selection-desktop svg,[data-v-6a2bde67] .guido__verion-history-view-option-selection-mobile svg{margin:0 0 0 2px}[data-v-6a2bde67] .in-segments-wrapper__button_selected,[data-v-6a2bde67] .in-segments-wrapper__button_selected:hover{background-color:#dae1fb}[data-v-0fff376c] .guido__view-option-selection-desktop svg,[data-v-0fff376c] .guido__view-option-selection-mobile svg{margin:0 0 0 2px}[data-v-0fff376c] .in-segments-wrapper__button_selected,[data-v-0fff376c] .in-segments-wrapper__button_selected:hover{background-color:#dae1fb}.guido-editor__wrapper[data-v-1d1d2b7c],.guido-editor__container[data-v-1d1d2b7c]{width:100%;height:calc(100vh - 75px)}
+.version-history-item[data-v-ee4b9c3f]{flex-basis:200px}.version-history-wrapper[data-v-52a77eec]{gap:8px}[data-v-6a2bde67] .guido__verion-history-view-option-selection-desktop svg,[data-v-6a2bde67] .guido__verion-history-view-option-selection-mobile svg{margin:0 0 0 2px}[data-v-6a2bde67] .in-segments-wrapper__button_selected,[data-v-6a2bde67] .in-segments-wrapper__button_selected:hover{background-color:#dae1fb}[data-v-0fff376c] .guido__view-option-selection-desktop svg,[data-v-0fff376c] .guido__view-option-selection-mobile svg{margin:0 0 0 2px}[data-v-0fff376c] .in-segments-wrapper__button_selected,[data-v-0fff376c] .in-segments-wrapper__button_selected:hover{background-color:#dae1fb}.guido-editor__wrapper[data-v-89423288],.guido-editor__container[data-v-89423288]{width:100%;height:calc(100vh - 75px)}

package/dist/stores/editor.d.ts

@@ -1,5 +1,6 @@
 export declare const useEditorStore: import("pinia").StoreDefinition<"editor", {
     isCodeEditorOpen: boolean;
     isVersionHistoryOpen: boolean;
+    isPreviewModeOpen: boolean;
     editorVisualMode: string;
 }, {}, {}>;

package/dist/stores/editor.js

@@ -1,11 +1,12 @@
 import { defineStore as e } from "pinia";
-const t = e("editor", {
+const i = e("editor", {
   state: () => ({
     isCodeEditorOpen: !1,
     isVersionHistoryOpen: !1,
+    isPreviewModeOpen: !1,
     editorVisualMode: "desktop"
   })
 });
 export {
-  t as useEditorStore
+  i as useEditorStore
 };

package/dist/utils/htmlCompiler.d.ts

@@ -0,0 +1,12 @@
+import type { CompilerRule, CompilationResult, HtmlCompiler } from '@@/Types/html-compiler';
+export declare class HtmlCompilerEngine implements HtmlCompiler {
+    private rules;
+    constructor(rules?: CompilerRule[]);
+    compile(html: string, rules?: CompilerRule[]): CompilationResult;
+    private applyRule;
+    private applyReplaceRule;
+    private applyRegexRule;
+    private applyRemoveRule;
+    private applyCustomRule;
+}
+export declare const createHtmlCompiler: (rules?: CompilerRule[]) => HtmlCompiler;

package/dist/utils/htmlCompiler.js

@@ -0,0 +1,70 @@
+var y = Object.defineProperty;
+var g = (p, e, r) => e in p ? y(p, e, { enumerable: !0, configurable: !0, writable: !0, value: r }) : p[e] = r;
+var u = (p, e, r) => g(p, typeof e != "symbol" ? e + "" : e, r);
+import { useToaster as m } from "../composables/useToaster.js";
+class d {
+  constructor(e = []) {
+    u(this, "rules");
+    this.rules = e;
+  }
+  compile(e, r) {
+    const l = performance.now(), t = e, o = e.length;
+    let s = e;
+    const a = [];
+    (r || this.rules).sort((n, c) => n.priority - c.priority).forEach((n) => {
+      const c = s.length;
+      s = this.applyRule(s, n), s.length !== c && a.push(n.id);
+    });
+    const i = s.length, R = o > 0 ? (o - i) / o * 100 : 0;
+    return {
+      originalHtml: t,
+      compiledHtml: s,
+      appliedRules: a,
+      // TODO: We can use stats for monitoring in the future
+      stats: {
+        originalSize: o,
+        compiledSize: i,
+        reductionPercentage: R,
+        executionTime: performance.now() - l
+      }
+    };
+  }
+  applyRule(e, r) {
+    try {
+      switch (r.type) {
+        case "replace":
+          return this.applyReplaceRule(e, r);
+        case "regex":
+          return this.applyRegexRule(e, r);
+        case "remove":
+          return this.applyRemoveRule(e, r);
+        case "custom":
+          return this.applyCustomRule(e, r);
+        default:
+          return e;
+      }
+    } catch (l) {
+      const { handleError: t } = m();
+      return t(l, `Failed to apply rule ${r.id}:`), e;
+    }
+  }
+  applyReplaceRule(e, r) {
+    const { search: l, replacement: t, replaceAll: o = !0 } = r;
+    return o ? e.replaceAll(l, t) : e.replace(l, t);
+  }
+  applyRegexRule(e, r) {
+    const { pattern: l, replacement: t, flags: o = "g" } = r, s = new RegExp(l, o);
+    return e.replace(s, t);
+  }
+  applyRemoveRule(e, r) {
+    return r.targets.reduce((l, t) => t instanceof RegExp ? l.replace(t, "") : l.replaceAll(t, ""), e);
+  }
+  applyCustomRule(e, r) {
+    return r.processor(e);
+  }
+}
+const A = (p = []) => new d(p);
+export {
+  d as HtmlCompilerEngine,
+  A as createHtmlCompiler
+};

package/dist/utils/tooltipUtils.d.ts

@@ -0,0 +1,2 @@
+import type { TooltipOptions } from '../@types/generic';
+export declare const getTooltipOptions: (id: string) => TooltipOptions;

package/dist/utils/tooltipUtils.js

@@ -0,0 +1,9 @@
+const o = (t) => ({
+  id: t,
+  dynamicPosition: !0,
+  staticPosition: "top",
+  iconStatus: !1
+});
+export {
+  o as getTooltipOptions
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@useinsider/guido",
-  "version": "1.0.0-beta.dad21f4",
+  "version": "1.0.0-beta.dbd0bad",
   "description": "Guido is a Vue + TypeScript wrapper for Email Plugin. Easily embed the email editor in your Vue applications.",
   "main": "./dist/guido.umd.cjs",
   "module": "./dist/library.js",
@@ -21,7 +21,6 @@
     "start": "vite",
     "build": "vite build && vue-tsc --declaration --emitDeclarationOnly --project tsconfig.app.json",
     "preview": "vite preview",
-    "test": "echo \"Error: no test specified\" && exit 1",
     "lint": "NODE_OPTIONS=--max-old-space-size=2048 eslint ./ && bun run type-check",
     "lint:fix": "NODE_OPTIONS=--max-old-space-size=2048 eslint --fix ./",
     "type-check": "vue-tsc --noEmit --project tsconfig.config.json && vue-tsc --noEmit --project tsconfig.app.json"
@@ -43,6 +42,7 @@
     "@cspell/eslint-plugin": "8.17.5",
     "@eslint/eslintrc": "3.3.0",
     "@eslint/js": "8.57.1",
+    "@playwright/test": "^1.54.2",
     "@stylistic/eslint-plugin": "3.1.0",
     "@stylistic/eslint-plugin-migrate": "3.1.0",
     "@types/eslint": "8.56.12",