monto-email-builder 1.3.1 → 1.4.0

package/dist/HtmlEditor/index.d.ts

@@ -1,7 +1,19 @@
+import React from 'react';
 import { SxProps, Theme } from '@mui/material';
 import { Language } from '../i18n';
+import { type HtmlEditorVariableInput, type HtmlEditorVariableItem, type HtmlEditorVariableValidationResult } from './variables';
 export type HtmlEditorMode = 'split' | 'code' | 'preview';
 export type HtmlEditorDevice = 'desktop' | 'mobile';
+export type HtmlEditorRightTab = 'preview' | 'variables';
+export type { HtmlEditorVariableInput, HtmlEditorVariableItem, HtmlEditorVariableValidationResult, };
+export interface HtmlEditorRef {
+    getValue: () => string;
+    getPreviewHtml: () => string;
+    scanVariables: () => HtmlEditorVariableItem[];
+    getVariables: (callback?: (items: HtmlEditorVariableItem[]) => void) => HtmlEditorVariableItem[];
+    validateVariables: () => HtmlEditorVariableValidationResult;
+    showVariables: () => void;
+}
 export interface HtmlEditorProps {
     /**
      * HTML 代码内容
@@ -50,6 +62,25 @@ export interface HtmlEditorProps {
      * 若本地已有 localStorage 则优先用 localStorage；未传时默认 'dracula'
      */
     initialTheme?: string;
+    /**
+     * 初始右侧面板 tab
+     * @default 'preview'
+     */
+    initialRightTab?: HtmlEditorRightTab;
+    /**
+     * 已有模板变量默认值。保存时可通过 ref.validateVariables() 扫描当前 HTML 并合并这些默认值。
+     */
+    variables?: HtmlEditorVariableInput[];
+    /**
+     * 变量变更回调
+     */
+    onVariablesChange?: (variables: HtmlEditorVariableItem[]) => void;
+    /**
+     * 保存校验时是否要求用户变量填写默认值
+     * @default true
+     */
+    requireVariableDefaults?: boolean;
 }
-export default function HtmlEditor({ value, onChange, language, initialMode, initialDevice, codeEditorHeight, previewHeight, sx, showToolbar, initialTheme, }: HtmlEditorProps): import("react/jsx-runtime").JSX.Element;
+declare const ForwardedHtmlEditor: React.ForwardRefExoticComponent<HtmlEditorProps & React.RefAttributes<HtmlEditorRef>>;
+export default ForwardedHtmlEditor;
 //# sourceMappingURL=index.d.ts.map

package/dist/HtmlEditor/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/HtmlEditor/index.tsx"],"names":[],"mappings":"AAmBA,OAAO,EAA2D,OAAO,EAAE,KAAK,EAA2B,MAAM,eAAe,CAAC;AAOjI,OAAO,EAAE,QAAQ,EAAK,MAAM,SAAS,CAAC;AAUtC,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAC1D,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,QAAQ,CAAC;AA8DpD,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;OAGG;IACH,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B;;;OAGG;IACH,aAAa,CAAC,EAAE,gBAAgB,CAAC;IACjC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,EACjC,KAAK,EACL,QAAQ,EACR,QAAe,EACf,WAAqB,EACrB,aAAyB,EACzB,gBAAyB,EACzB,aAAsB,EACtB,EAAE,EACF,WAAkB,EAClB,YAAY,GACb,EAAE,eAAe,2CAiYjB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/HtmlEditor/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA6F,MAAM,OAAO,CAAC;AAmBlH,OAAO,EAYL,OAAO,EAIP,KAAK,EAIN,MAAM,eAAe,CAAC;AAWvB,OAAO,EAAE,QAAQ,EAAK,MAAM,SAAS,CAAC;AAItC,OAAO,EASL,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,kCAAkC,EACxC,MAAM,aAAa,CAAC;AAYrB,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAC1D,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,QAAQ,CAAC;AACpD,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,WAAW,CAAC;AACzD,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,kCAAkC,GACnC,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,sBAAsB,EAAE,CAAC;IAC9C,YAAY,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,sBAAsB,EAAE,KAAK,IAAI,KAAK,sBAAsB,EAAE,CAAC;IACjG,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;IAC5D,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B;AA8DD,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;OAGG;IACH,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B;;;OAGG;IACH,aAAa,CAAC,EAAE,gBAAgB,CAAC;IACjC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,eAAe,CAAC,EAAE,kBAAkB,CAAC;IACrC;;OAEG;IACH,SAAS,CAAC,EAAE,uBAAuB,EAAE,CAAC;IACtC;;OAEG;IACH,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,sBAAsB,EAAE,KAAK,IAAI,CAAC;IAClE;;;OAGG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAi1BD,QAAA,MAAM,mBAAmB,uFAAyD,CAAC;AAGnF,eAAe,mBAAmB,CAAC"}

package/dist/HtmlEditor/variables.d.ts

@@ -0,0 +1,36 @@
+import { type VariableGroup, type VariableKind } from '../documents/blocks/Text/variableCatalog';
+export type HtmlEditorVariableType = 'user' | 'system';
+export type HtmlEditorVariableItem = {
+    id: number;
+    variable: string;
+    type: HtmlEditorVariableType;
+    attribute: string;
+    default: string;
+};
+export type HtmlEditorVariableInput = Partial<HtmlEditorVariableItem> & {
+    Variable?: string;
+    Type?: HtmlEditorVariableType;
+    Attribute?: string;
+    Default?: string;
+    key?: string;
+    value?: string;
+};
+export type HtmlEditorVariableValidationResult = {
+    valid: boolean;
+    variables: HtmlEditorVariableItem[];
+    missing: HtmlEditorVariableItem[];
+};
+export declare const HTML_EDITOR_VARIABLE_GROUPS: VariableGroup[];
+export declare const HTML_EDITOR_UNSUBSCRIBE_LINK_VARIABLE = "unsubscribe_link";
+export declare function parseHtmlEditorVariableToken(token: string | null | undefined): {
+    attribute: string;
+    type: HtmlEditorVariableType;
+} | null;
+export declare function normalizeHtmlEditorVariables(variables: ReadonlyArray<HtmlEditorVariableInput> | null | undefined): HtmlEditorVariableItem[];
+export declare function scanHtmlEditorVariables(source: string): HtmlEditorVariableItem[];
+export declare function mergeScannedHtmlEditorVariables(scanned: ReadonlyArray<HtmlEditorVariableItem>, current: ReadonlyArray<HtmlEditorVariableItem>): HtmlEditorVariableItem[];
+export declare function applyHtmlEditorVariableDefaults(source: string, variables: ReadonlyArray<HtmlEditorVariableItem>): string;
+export declare function createHtmlEditorVariable(name: string, kind: VariableKind, defaultValue?: string): HtmlEditorVariableItem | null;
+export declare function isHtmlEditorBuiltinVariableName(name: string): boolean;
+export declare function getHtmlEditorVariableInsertText(name: string, kind: VariableKind): string;
+//# sourceMappingURL=variables.d.ts.map

package/dist/HtmlEditor/variables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variables.d.ts","sourceRoot":"","sources":["../../src/HtmlEditor/variables.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,0CAA0C,CAAC;AAElD,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEvD,MAAM,MAAM,sBAAsB,GAAG;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,sBAAsB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC,GAAG;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,sBAAsB,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG;IAC/C,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,sBAAsB,EAAE,CAAC;IACpC,OAAO,EAAE,sBAAsB,EAAE,CAAC;CACnC,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,aAAa,EAAyB,CAAC;AACjF,eAAO,MAAM,qCAAqC,qBAAqB,CAAC;AAaxE,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG;IAC9E,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,sBAAsB,CAAC;CAC9B,GAAG,IAAI,CAWP;AAqBD,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,aAAa,CAAC,uBAAuB,CAAC,GAAG,IAAI,GAAG,SAAS,GACnE,sBAAsB,EAAE,CAc1B;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,sBAAsB,EAAE,CAyChF;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,aAAa,CAAC,sBAAsB,CAAC,EAC9C,OAAO,EAAE,aAAa,CAAC,sBAAsB,CAAC,GAC7C,sBAAsB,EAAE,CAW1B;AAWD,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,aAAa,CAAC,sBAAsB,CAAC,GAC/C,MAAM,CAiBR;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,SAAK,GAAG,sBAAsB,GAAG,IAAI,CAW3H;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKrE;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAOxF"}

package/dist/chunks/{chunk-kYwVqyDL.js → chunk-CF4KXMbF.js}

@@ -1,4 +1,4 @@
-const c = {
+const d = {
   newDocument: "New Blank Document",
   useBuiltInTemplates: "Use Built-in Templates",
   emailBuilder: "Monto Email Builder",
@@ -21,7 +21,7 @@ const c = {
   undoTooltip: "Undo (Ctrl/Cmd + Z)",
   redo: "Redo",
   redoTooltip: "Redo (Ctrl/Cmd + Shift + Z)"
-}, d = {
+}, c = {
   welcomeEmail: "Marketing Template",
   oneTimePasscode: "One-time passcode (OTP)",
   resetPassword: "Reset password",
@@ -57,7 +57,7 @@ const c = {
   uploading: "Uploading...",
   uploadHandlerNotConfigured: "Please configure imageUploadHandler to enable local upload",
   placeholder: "Add an image"
-}, g = {
+}, b = {
   title: "Video block",
   name: "Video",
   sourceUrl: "Video URL",
@@ -78,7 +78,7 @@ const c = {
   loop: "Loop",
   muted: "Muted",
   controls: "Show controls"
-}, h = {
+}, g = {
   title: "Columns block",
   name: "Columns",
   layout: "Layout",
@@ -96,7 +96,7 @@ const c = {
   confirmChangeMessage: "Changing the column layout will delete data in some columns. This action cannot be undone. Are you sure you want to continue?",
   cancel: "Cancel",
   confirm: "Confirm"
-}, b = {
+}, h = {
   global: "Global",
   backdropColor: "Backdrop color",
   canvasColor: "Canvas color",
@@ -105,7 +105,7 @@ const c = {
   pageWidth: "Page width",
   fontFamily: "Font family",
   textColor: "Text color"
-}, k = {
+}, y = {
   title: "Text block",
   name: "Text",
   content: "Content",
@@ -172,7 +172,7 @@ const c = {
     customVariableNameInvalid: "Only letters, numbers, and underscores allowed, starting with a letter or underscore",
     customVariableNameDuplicate: "Variable name already exists"
   }
-}, C = {
+}, k = {
   title: "Button block",
   name: "Button",
   text: "Text",
@@ -191,7 +191,7 @@ const c = {
   stylePill: "Pill",
   textColor: "Text color",
   buttonColor: "Button color"
-}, y = {
+}, v = {
   title: "Heading block",
   name: "Heading",
   content: "Content",
@@ -205,7 +205,7 @@ const c = {
   shapeRounded: "Rounded",
   imageUrl: "Image URL",
   altText: "Alt text"
-}, v = {
+}, C = {
   title: "Divider block",
   name: "Divider",
   color: "Color",
@@ -234,7 +234,7 @@ const c = {
   iconUrl: "Link URL",
   placeholder: "Click the right panel to add social media icons",
   addAnother: "Add another social link"
-}, R = {
+}, x = {
   backgroundColor: "Background color",
   borderColor: "Border color",
   borderRadius: "Border radius",
@@ -258,7 +258,7 @@ const c = {
   both: "Both",
   default: "Default",
   formatGroup: "Style"
-}, U = {
+}, R = {
   mode: {
     split: "Split view",
     code: "Code only",
@@ -277,28 +277,42 @@ const c = {
     previewOnly: "Preview only",
     desktopView: "Desktop view",
     mobileView: "Mobile view"
+  },
+  tabs: {
+    preview: "Preview",
+    variables: "Settings"
+  },
+  variables: {
+    title: "Variables",
+    scan: "Scan variables",
+    scanHint: "Insert variables here and set their default values.",
+    help: "You can type {{variable_name}} directly in the code, then click Save in the code panel to scan variables and set default values in one place. You can also insert variables from Settings and enter their defaults here.",
+    detected: "Detected variables",
+    defaultHelp: "Please enter a default value to ensure that the content displays correctly even if the variable is missing.",
+    empty: "No variables yet. Click Save in the code panel to scan, or insert one from the catalog above.",
+    systemDefault: "System variables do not need defaults"
   }
-}, V = {
-  common: c,
-  samples: d,
+}, A = {
+  common: d,
+  samples: c,
   inspector: u,
   tabs: m,
   image: p,
-  video: g,
-  columns: h,
-  emailLayout: b,
-  text: k,
-  button: C,
-  heading: y,
+  video: b,
+  columns: g,
+  emailLayout: h,
+  text: y,
+  button: k,
+  heading: v,
   avatar: f,
-  divider: v,
+  divider: C,
   container: S,
   spacer: w,
   html: T,
   socials: L,
-  style: R,
-  htmlEditor: U
-}, x = {
+  style: x,
+  htmlEditor: R
+}, V = {
   newDocument: "新建空白文档",
   useBuiltInTemplates: "使用内置模板",
   emailBuilder: "Monto 邮件编辑器",
@@ -321,7 +335,7 @@ const c = {
   undoTooltip: "撤销 (Ctrl/Cmd + Z)",
   redo: "重做",
   redoTooltip: "重做 (Ctrl/Cmd + Shift + Z)"
-}, B = {
+}, U = {
   welcomeEmail: "营销模板",
   oneTimePasscode: "一次性密码 (OTP)",
   resetPassword: "重置密码",
@@ -331,17 +345,17 @@ const c = {
   postMetrics: "指标报告",
   respondToMessage: "回复询问",
   quickStart: "快速开始"
-}, M = {
+}, B = {
   styles: "样式",
   inspect: "检查",
   clickBlockToInspect: "点击一个块进行检查。",
   blockNotFound: "未找到 id 为 {{id}} 的块。点击一个块以重置。"
-}, A = {
+}, N = {
   edit: "编辑",
   preview: "预览",
   htmlOutput: "HTML 输出",
   jsonOutput: "JSON 输出"
-}, I = {
+}, M = {
   title: "图片块",
   name: "图片",
   sourceUrl: "图片地址",
@@ -357,7 +371,7 @@ const c = {
   uploading: "上传中...",
   uploadHandlerNotConfigured: "请配置 imageUploadHandler 以启用本地上传功能",
   placeholder: "添加图片"
-}, N = {
+}, I = {
   title: "视频块",
   name: "视频",
   sourceUrl: "视频地址",
@@ -396,7 +410,7 @@ const c = {
   confirmChangeMessage: "切换分栏布局将删除部分列中的数据，此操作不可撤销。确定要继续吗？",
   cancel: "取消",
   confirm: "确定"
-}, z = {
+}, E = {
   global: "全局",
   backdropColor: "背景颜色",
   canvasColor: "画布颜色",
@@ -405,7 +419,7 @@ const c = {
   pageWidth: "页面宽度",
   fontFamily: "字体",
   textColor: "文字颜色"
-}, E = {
+}, _ = {
   title: "文本块",
   name: "文本",
   content: "内容",
@@ -491,12 +505,12 @@ const c = {
   stylePill: "胶囊",
   textColor: "文字颜色",
   buttonColor: "按钮颜色"
-}, D = {
+}, z = {
   title: "标题块",
   name: "标题",
   content: "内容",
   level: "级别"
-}, O = {
+}, D = {
   title: "头像块",
   size: "尺寸",
   shape: "形状",
@@ -505,23 +519,23 @@ const c = {
   shapeRounded: "圆角",
   imageUrl: "图片地址",
   altText: "替代文本"
-}, $ = {
+}, K = {
   title: "分割线块",
   name: "分割线",
   color: "颜色",
   height: "高度"
-}, W = {
+}, O = {
   title: "容器块",
   name: "容器"
-}, F = {
+}, $ = {
   title: "间距块",
   name: "间距",
   height: "高度"
-}, q = {
+}, W = {
   title: "HTML块",
   name: "HTML",
   content: "内容"
-}, J = {
+}, F = {
   title: "社媒块",
   name: "社媒",
   selectPlatforms: "社媒选择",
@@ -534,7 +548,7 @@ const c = {
   iconUrl: "跳转链接",
   placeholder: "点击右侧面板添加社媒图标",
   addAnother: "新增社媒"
-}, j = {
+}, q = {
   backgroundColor: "背景颜色",
   borderColor: "边框颜色",
   borderRadius: "圆角",
@@ -558,7 +572,7 @@ const c = {
   both: "两者",
   default: "默认",
   formatGroup: "样式"
-}, Z = {
+}, J = {
   mode: {
     split: "左右栏",
     code: "仅代码",
@@ -577,65 +591,151 @@ const c = {
     previewOnly: "仅预览",
     desktopView: "桌面视图",
     mobileView: "移动视图"
+  },
+  tabs: {
+    preview: "预览",
+    variables: "设置"
+  },
+  variables: {
+    title: "变量",
+    scan: "扫描变量",
+    scanHint: "可以从这里插入变量并设置默认值。",
+    help: "你可以在代码中直接输入 {{变量名}}，然后点击左侧代码区的保存按钮扫描变量并统一设置默认值；也可以在设置页直接插入变量，再填写默认值。",
+    detected: "已识别变量",
+    defaultHelp: "请为变量输入默认值，确保变量缺失时内容仍能正确显示。",
+    empty: "暂无变量。点击左侧代码区的保存按钮扫描，或从上方变量目录插入。",
+    systemDefault: "系统变量无需默认值"
   }
-}, G = {
-  common: x,
-  samples: B,
-  inspector: M,
-  tabs: A,
-  image: I,
-  video: N,
+}, Y = {
+  common: V,
+  samples: U,
+  inspector: B,
+  tabs: N,
+  image: M,
+  video: I,
   columns: P,
-  emailLayout: z,
-  text: E,
+  emailLayout: E,
+  text: _,
   button: H,
-  heading: D,
-  avatar: O,
-  divider: $,
-  container: W,
-  spacer: F,
-  html: q,
-  socials: J,
-  style: j,
-  htmlEditor: Z
-}, X = {
-  zh: G,
-  en: V
+  heading: z,
+  avatar: D,
+  divider: K,
+  container: O,
+  spacer: $,
+  html: W,
+  socials: F,
+  style: q,
+  htmlEditor: J
+}, Z = {
+  zh: Y,
+  en: A
 };
-function Q(t, e, n) {
-  const i = n ?? Y(), r = t.split(".");
-  let o = X[i];
-  for (const a of r)
-    if (o && typeof o == "object" && a in o)
-      o = o[a];
+function Q(a, e, o) {
+  const l = o ?? j(), s = a.split(".");
+  let n = Z[l];
+  for (const t of s)
+    if (n && typeof n == "object" && t in n)
+      n = n[t];
     else
-      return t;
-  return typeof o != "string" ? t : e ? o.replace(/\{\{(\w+)\}\}/g, (a, s) => {
-    var l;
-    return ((l = e[s]) == null ? void 0 : l.toString()) ?? a;
-  }) : o;
+      return a;
+  return typeof n != "string" ? a : e ? n.replace(/\{\{(\w+)\}\}/g, (t, i) => {
+    var r;
+    return ((r = e[i]) == null ? void 0 : r.toString()) ?? t;
+  }) : n;
 }
-function Y() {
+function j() {
   if (typeof window > "u")
     return "en";
-  const t = localStorage.getItem("app-language");
-  return t && (t === "zh" || t === "en") ? t : navigator.language.toLowerCase().startsWith("zh") ? "zh" : "en";
+  const a = localStorage.getItem("app-language");
+  return a && (a === "zh" || a === "en") ? a : navigator.language.toLowerCase().startsWith("zh") ? "zh" : "en";
 }
-function K(t) {
-  typeof window < "u" && localStorage.setItem("app-language", t);
+function ee(a) {
+  typeof window < "u" && localStorage.setItem("app-language", a);
 }
-function _(t) {
-  let e = t, n = 0;
-  for (; e && typeof e == "object" && "default" in e && n < 5; ) {
-    const i = e.default;
-    if (!i || i === e) break;
-    e = i, n += 1;
+function te(a) {
+  let e = a, o = 0;
+  for (; e && typeof e == "object" && "default" in e && o < 5; ) {
+    const l = e.default;
+    if (!l || l === e) break;
+    e = l, o += 1;
   }
   return typeof e == "function" || typeof e == "string" || e && typeof e == "object" && "$$typeof" in e ? e : "span";
 }
+const G = /^[A-Za-z_][A-Za-z0-9_]*$/, X = [
+  {
+    id: "contacts",
+    items: [
+      { name: "first_name", labelKey: "text.variables.firstName", kind: "user" },
+      { name: "last_name", labelKey: "text.variables.lastName", kind: "user" },
+      { name: "middle_name", labelKey: "text.variables.middleName", kind: "user" }
+    ]
+  },
+  {
+    id: "email",
+    items: [
+      { name: "email", labelKey: "text.variables.email", kind: "user" },
+      { name: "alternative_email", labelKey: "text.variables.alternativeEmail", kind: "user" }
+    ]
+  },
+  {
+    id: "organization",
+    items: [
+      { name: "company", labelKey: "text.variables.company", kind: "user" },
+      { name: "address_line_1", labelKey: "text.variables.addressLine1", kind: "user" },
+      { name: "address_line_2", labelKey: "text.variables.addressLine2", kind: "user" },
+      { name: "country", labelKey: "text.variables.country", kind: "user" },
+      { name: "city", labelKey: "text.variables.city", kind: "user" },
+      { name: "state", labelKey: "text.variables.state", kind: "user" },
+      { name: "postal_code", labelKey: "text.variables.postalCode", kind: "user" },
+      { name: "recipient_company", labelKey: "text.variables.recipientCompany", kind: "user" },
+      { name: "recipient_address_line_1", labelKey: "text.variables.recipientAddressLine1", kind: "user" },
+      { name: "recipient_address_line_2", labelKey: "text.variables.recipientAddressLine2", kind: "user" },
+      { name: "recipient_country", labelKey: "text.variables.recipientCountry", kind: "user" },
+      { name: "recipient_city", labelKey: "text.variables.recipientCity", kind: "user" },
+      { name: "recipient_state", labelKey: "text.variables.recipientState", kind: "user" },
+      { name: "recipient_postal_code", labelKey: "text.variables.recipientPostalCode", kind: "user" }
+    ]
+  },
+  {
+    id: "date",
+    items: [
+      { name: "birthday", labelKey: "text.variables.birthday", kind: "user" },
+      { name: "send_date", labelKey: "text.variables.currentDate", kind: "builtin" },
+      { name: "send_year", labelKey: "text.variables.currentYear", kind: "builtin" },
+      { name: "send_month", labelKey: "text.variables.currentMonthName", kind: "builtin" },
+      { name: "send_weekday", labelKey: "text.variables.currentWeekday", kind: "builtin" }
+    ]
+  },
+  {
+    id: "links",
+    items: [{ name: "unsubscribe_link", labelKey: "text.variables.unsubscribeLink", kind: "user" }]
+  }
+];
+function ae(a) {
+  const e = a.baseGroups ?? X, o = /* @__PURE__ */ new Set(), l = /* @__PURE__ */ new Set();
+  for (const t of e)
+    for (const i of t.items)
+      i.kind === "user" ? o.add(i.name) : l.add(i.name);
+  const s = Array.isArray(a.contactAttributes) ? a.contactAttributes : [];
+  for (const t of s) {
+    const i = t == null ? void 0 : t.Enable;
+    if (i === 0 || i === !1) continue;
+    const r = typeof (t == null ? void 0 : t.AttrField) == "string" ? t.AttrField.trim() : "";
+    r && o.add(r);
+  }
+  const n = Array.isArray(a.customVariables) ? a.customVariables : [];
+  for (const t of n) {
+    const i = typeof (t == null ? void 0 : t.name) == "string" ? t.name.trim() : "";
+    i && G.test(i) && o.add(i);
+  }
+  return { allowedUser: o, allowedBuiltin: l };
+}
 export {
-  Y as g,
-  _ as r,
-  K as s,
+  X as B,
+  G as V,
+  ae as b,
+  j as g,
+  te as r,
+  ee as s,
   Q as t
 };

package/dist/documents/blocks/EmailLayout/EmailLayoutPropsSchema.d.ts

@@ -13,19 +13,19 @@ declare const EmailLayoutPropsSchema: z.ZodObject<{
     width?: number | null | undefined;
     borderColor?: string | null | undefined;
     borderRadius?: number | null | undefined;
+    textColor?: string | null | undefined;
     childrenIds?: string[] | null | undefined;
     backdropColor?: string | null | undefined;
     canvasColor?: string | null | undefined;
-    textColor?: string | null | undefined;
 }, {
     fontFamily?: "MODERN_SANS" | "BOOK_SANS" | "ORGANIC_SANS" | "GEOMETRIC_SANS" | "HEAVY_SANS" | "ROUNDED_SANS" | "MODERN_SERIF" | "BOOK_SERIF" | "MONOSPACE" | null | undefined;
     width?: number | null | undefined;
     borderColor?: string | null | undefined;
     borderRadius?: number | null | undefined;
+    textColor?: string | null | undefined;
     childrenIds?: string[] | null | undefined;
     backdropColor?: string | null | undefined;
     canvasColor?: string | null | undefined;
-    textColor?: string | null | undefined;
 }>;
 export default EmailLayoutPropsSchema;
 export type EmailLayoutProps = z.infer<typeof EmailLayoutPropsSchema>;

package/dist/documents/editor/core.d.ts

@@ -1066,19 +1066,19 @@ export declare const EditorBlock: ({ type, data }: import("monto-email-document-
         width?: number | null | undefined;
         borderColor?: string | null | undefined;
         borderRadius?: number | null | undefined;
+        textColor?: string | null | undefined;
         childrenIds?: string[] | null | undefined;
         backdropColor?: string | null | undefined;
         canvasColor?: string | null | undefined;
-        textColor?: string | null | undefined;
     }, {
         fontFamily?: "MODERN_SANS" | "BOOK_SANS" | "ORGANIC_SANS" | "GEOMETRIC_SANS" | "HEAVY_SANS" | "ROUNDED_SANS" | "MODERN_SERIF" | "BOOK_SERIF" | "MONOSPACE" | null | undefined;
         width?: number | null | undefined;
         borderColor?: string | null | undefined;
         borderRadius?: number | null | undefined;
+        textColor?: string | null | undefined;
         childrenIds?: string[] | null | undefined;
         backdropColor?: string | null | undefined;
         canvasColor?: string | null | undefined;
-        textColor?: string | null | undefined;
     }>;
     Spacer: z.ZodObject<{
         props: z.ZodNullable<z.ZodOptional<z.ZodObject<{
@@ -2351,19 +2351,19 @@ export declare const EditorBlockSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"ty
         width?: number | null | undefined;
         borderColor?: string | null | undefined;
         borderRadius?: number | null | undefined;
+        textColor?: string | null | undefined;
         childrenIds?: string[] | null | undefined;
         backdropColor?: string | null | undefined;
         canvasColor?: string | null | undefined;
-        textColor?: string | null | undefined;
     }, {
         fontFamily?: "MODERN_SANS" | "BOOK_SANS" | "ORGANIC_SANS" | "GEOMETRIC_SANS" | "HEAVY_SANS" | "ROUNDED_SANS" | "MODERN_SERIF" | "BOOK_SERIF" | "MONOSPACE" | null | undefined;
         width?: number | null | undefined;
         borderColor?: string | null | undefined;
         borderRadius?: number | null | undefined;
+        textColor?: string | null | undefined;
         childrenIds?: string[] | null | undefined;
         backdropColor?: string | null | undefined;
         canvasColor?: string | null | undefined;
-        textColor?: string | null | undefined;
     }>;
     Spacer: z.ZodObject<{
         props: z.ZodNullable<z.ZodOptional<z.ZodObject<{
@@ -3636,19 +3636,19 @@ export declare const EditorConfigurationSchema: z.ZodRecord<z.ZodString, z.ZodEf
         width?: number | null | undefined;
         borderColor?: string | null | undefined;
         borderRadius?: number | null | undefined;
+        textColor?: string | null | undefined;
         childrenIds?: string[] | null | undefined;
         backdropColor?: string | null | undefined;
         canvasColor?: string | null | undefined;
-        textColor?: string | null | undefined;
     }, {
         fontFamily?: "MODERN_SANS" | "BOOK_SANS" | "ORGANIC_SANS" | "GEOMETRIC_SANS" | "HEAVY_SANS" | "ROUNDED_SANS" | "MODERN_SERIF" | "BOOK_SERIF" | "MONOSPACE" | null | undefined;
         width?: number | null | undefined;
         borderColor?: string | null | undefined;
         borderRadius?: number | null | undefined;
+        textColor?: string | null | undefined;
         childrenIds?: string[] | null | undefined;
         backdropColor?: string | null | undefined;
         canvasColor?: string | null | undefined;
-        textColor?: string | null | undefined;
     }>;
     Spacer: z.ZodObject<{
         props: z.ZodNullable<z.ZodOptional<z.ZodObject<{

package/dist/html-editor.d.ts

@@ -5,6 +5,6 @@
  * 使用方式：import { HtmlEditor } from 'monto-email-builder/html-editor'
  */
 export { default as HtmlEditor } from './HtmlEditor';
-export type { HtmlEditorProps, HtmlEditorMode, HtmlEditorDevice } from './HtmlEditor';
+export type { HtmlEditorDevice, HtmlEditorMode, HtmlEditorProps, HtmlEditorRef, HtmlEditorRightTab, HtmlEditorVariableInput, HtmlEditorVariableItem, HtmlEditorVariableValidationResult, } from './HtmlEditor';
 export { default } from './HtmlEditor';
 //# sourceMappingURL=html-editor.d.ts.map

package/dist/html-editor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"html-editor.d.ts","sourceRoot":"","sources":["../src/html-editor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACtF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"html-editor.d.ts","sourceRoot":"","sources":["../src/html-editor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AACrD,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,EACtB,kCAAkC,GACnC,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}