mail-editor-pancake 0.0.8 → 0.0.9

package/packages/core/dist/index.d.ts

@@ -76,6 +76,28 @@ export declare interface BlockSchemaField {
     inheritGlobal?: boolean;
 }
 
+export declare interface BodyVariableInsert {
+    content: string;
+    asHtml: boolean;
+}
+
+/** 插入链接 / 图片等元素片段 */
+export declare function buildBodyVariableElementInsert(v: Variable, options?: {
+    linkColor?: string;
+    token?: string;
+}): BodyVariableInsert;
+
+/** @deprecated 使用 buildBodyVariableKeyInsert / buildBodyVariableElementInsert */
+export declare function buildBodyVariableInsert(v: Variable, options?: {
+    linkColor?: string;
+    token?: string;
+}): BodyVariableInsert;
+
+/** 插入变量 key（`{{key}}`） */
+export declare function buildBodyVariableKeyInsert(v: Variable): BodyVariableInsert;
+
+export declare function buildLinkVariableHtml(token: string, linkColor: string): string;
+
 export declare interface Column {
     id: string;
     attrs: ColumnAttrs;
@@ -89,6 +111,9 @@ declare interface ColumnAttrs {
 
 export declare function createSection(layout: SectionLayout): Section;
 
+/** 无后端 sample 时按 kind / label 生成预览用示例值（仅预览弹窗等场景） */
+export declare function defaultVariableSample(v: Pick<Variable, 'key' | 'label' | 'kind' | 'sample'>): string;
+
 /** 工厂函数，便于外部以函数式风格定义组件。 */
 export declare function defineBlock<P extends object>(def: BlockDefinition<P>): BlockDefinition<P>;
 
@@ -383,6 +408,8 @@ export declare class MailEditor {
     private showLayoutBorders;
     /** 「重置内容」时恢复的文档快照（与当前画布内容无关） */
     private presetContentDoc;
+    /** 宿主通过 setVariables 注入的列表；setValue 恢复文档后仍会写回，避免被 doc JSON 里的空数组覆盖 */
+    private configuredVariables;
     private systemThemeMq;
     private readonly _onSystemThemeMqChange;
     private readonly _onFullscreenChange;
@@ -407,6 +434,19 @@ export declare class MailEditor {
     setPresetDoc(partial: Partial<EmailDoc>): void;
     setVariables(vars: Variable[]): void;
     getVariables(): Variable[];
+    private _applyConfiguredVariables;
+    /**
+     * 插入变量 key（`{{key}}`）。
+     * @returns 是否成功插入
+     */
+    insertVariableKey(v: Variable): boolean;
+    /**
+     * 插入链接 / 图片变量对应元素（`<a>` / image 块等）。
+     * 非 link/image 时退化为 insertVariableKey。
+     */
+    insertVariableElement(v: Variable): boolean;
+    /** 同 {@link insertVariableKey} */
+    insertVariable(v: Variable): boolean;
     /** 当前界面主题（`system` 不解析为 light/dark）。 */
     getTheme(): EditorTheme;
     /** 切换界面主题；写入 `data-sm-theme`，顶栏选择器同步。 */
@@ -436,13 +476,14 @@ export declare class MailEditor {
     private _blurRightPanelIfFocused;
     /** 提交内联编辑并清空选中，右栏回到文档级面板 */
     private _focusMailSettings;
-    private _confirmClearCanvas;
-    private _confirmResetContent;
     private _setMode;
     private _bindKeyboard;
     private _onChange;
     private _showVariablePopover;
-    private _insertVariable;
+    private _showToast;
+    private _insertImageVariable;
+    /** 在焦点处插入文本或 HTML；失败时返回 false */
+    private _insertAtFocus;
     private _showExport;
     private _showPreview;
     private _bindFullscreen;
@@ -478,6 +519,9 @@ export declare function mjRawEmailTableWrap(paddingCss: string, cellInnerHtml: s
 /** 将任意历史写法映射到最近一档（normal→400，bold→700 等） */
 export declare function normalizeFontWeightStep(raw: string | undefined | null): FontWeightStep;
 
+/** 规范化 Variable（补 kind、sample） */
+export declare function normalizeVariable(v: Variable): Variable;
+
 /**
  * 打开内置图库弹层：搜索、分页、选图插入；可选「链接添加」「上传到图库」「删除」由 adapter 决定。
  */
@@ -643,6 +687,9 @@ export declare class Store {
     private _notify;
 }
 
+/** 从 Mustache token 提取 key，如 `{{username}}` → `username` */
+export declare function tokenToVariableKey(token: string): string;
+
 /** 两列 Section 的列宽比例（左栏拖入默认 `1-1`，右栏可改为 `1-2` / `2-1`） */
 export declare const TWO_COLUMN_LAYOUTS: readonly ["1-1", "1-2", "2-1"];
 
@@ -654,6 +701,12 @@ export declare interface Variable {
     label: string;
     /** 预览数据，仅设计态预览使用 */
     sample?: string;
+    /** 插入语义：纯文本占位 / 链接片段 / 图片块 */
+    kind?: 'text' | 'link' | 'image';
 }
 
+export declare type VariableKind = 'text' | 'link' | 'image';
+
+export declare function variablePlaceholder(key: string): string;
+
 export { }