mail-editor-pancake 0.2.7 → 0.3.0

package/packages/blocks/src/index.ts

@@ -1,21 +1,21 @@
 import {
-  createI18nContext,
   type BlockDefinition,
   type SimpleMailI18nOptions,
   type SimpleMailT,
+  createI18nContext,
 } from '@simple-mail/core';
 import { buttonBlock } from './button';
 import { dividerBlock } from './divider';
 import { footerBlock } from './footer';
 import { heroBlock } from './hero';
 import { htmlBlock } from './html';
+import { localizeBlockDefinitions } from './i18n';
 import { imageBlock } from './image';
 import { logoBlock } from './logo';
 import { socialBlock } from './social';
 import { socialGroupBlock } from './socialGroup';
 import { spacerBlock } from './spacer';
 import { textBlock } from './text';
-import { localizeBlockDefinitions } from './i18n';
 
 export {
   buttonBlock,
@@ -79,7 +79,9 @@ export function createBuiltinBlocks(options: CreateBlocksOptions = {}): BlockDef
 }
 
 /** 业务示例的“自定义”组件。可作为参考或直接使用；正式业务块应由宿主应用注册。 */
-export function createExampleCustomBlocks(options: CreateBlocksOptions = {}): BlockDefinition<any>[] {
+export function createExampleCustomBlocks(
+  options: CreateBlocksOptions = {},
+): BlockDefinition<any>[] {
   return localizeBlockDefinitions(baseExampleCustomBlocks, resolveBlocksT(options));
 }
 

package/packages/blocks/src/social.ts

@@ -1,15 +1,15 @@
-import { defineBlock, FONT_WEIGHT_STEP_OPTIONS, normalizeFontWeightStep } from '@simple-mail/core';
+import { FONT_WEIGHT_STEP_OPTIONS, defineBlock, normalizeFontWeightStep } from '@simple-mail/core';
 import { icons } from './icons';
 import {
   BIZ_SOCIAL_NETWORK_OPTIONS,
+  type SocialLinkItem,
   escAttr,
   flexJustifyFromAlign,
   mjSocialElementsLines,
   paddingQuad,
-  socialIconBorderRadiusMjml,
   renderSocialIconPreviewHtml,
+  socialIconBorderRadiusMjml,
   socialIconSpacingPx,
-  type SocialLinkItem,
 } from './socialShared';
 
 /** 与社交组一致，仅平台选项收窄为业务五件套 */

package/packages/blocks/src/socialGroup.ts

@@ -1,15 +1,15 @@
-import { defineBlock, FONT_WEIGHT_STEP_OPTIONS, normalizeFontWeightStep } from '@simple-mail/core';
+import { FONT_WEIGHT_STEP_OPTIONS, defineBlock, normalizeFontWeightStep } from '@simple-mail/core';
 import { icons } from './icons';
 import {
+  SOCIAL_NETWORK_OPTIONS,
+  type SocialLinkItem,
   escAttr,
   flexJustifyFromAlign,
   mjSocialElementsLines,
   paddingQuad,
-  socialIconBorderRadiusMjml,
   renderSocialIconPreviewHtml,
+  socialIconBorderRadiusMjml,
   socialIconSpacingPx,
-  SOCIAL_NETWORK_OPTIONS,
-  type SocialLinkItem,
 } from './socialShared';
 
 interface SocialGroupProps {

package/packages/blocks/src/socialShared.ts

@@ -8,6 +8,27 @@ export function mjSocialElementName(network: string): string {
   return n;
 }
 
+/** MJML 内置带 share-url 模板的网络：href 会被包装成「分享」链接而非直接跳转 */
+const MJML_SHARE_URL_NETWORKS = new Set([
+  'facebook',
+  'twitter',
+  'x',
+  'google',
+  'pinterest',
+  'linkedin',
+]);
+
+/**
+ * 生成 mj-social-element 的 name（编译安全版）。
+ * facebook/twitter/x 等内置网络带 share-url 模板（如 facebook sharer.php?u=[[URL]]），
+ * href 会被当作「被分享的 URL」包装。MJML 为每个内置网络预生成 `<name>-noshare`
+ * 变体（share-url 为 [[URL]] 原样）：保留内置图标与背景色，href 直达。
+ */
+export function mjSocialElementShareSafeName(network: string): string {
+  const n = mjSocialElementName(network);
+  return MJML_SHARE_URL_NETWORKS.has(n) ? `${n}-noshare` : n;
+}
+
 /** 业务示例：固定海外/垂类五平台（与 custom:social 块配套）。 */
 export const BIZ_SOCIAL_NETWORK_OPTIONS: { label: string; value: string }[] = [
   { label: 'X', value: 'x' },
@@ -78,8 +99,7 @@ export function socialMeta(network: string): { color: string; preview: string }
 }
 
 /** MJML 内置社交图标 CDN（与 mjml-browser 4.x 一致） */
-export const MJML_SOCIAL_ICON_BASE =
-  'https://www.mailjet.com/images/theme/v1/icons/ico-social/';
+export const MJML_SOCIAL_ICON_BASE = 'https://www.mailjet.com/images/theme/v1/icons/ico-social/';
 
 /** MJML `mj-social-element` name → 图标文件名 */
 const MJML_SOCIAL_ICON_FILES: Record<string, string> = {
@@ -185,7 +205,7 @@ export function mjSocialElementsLines(
       const meta = socialMeta(l.network);
       const bgColor = l.backgroundColor?.trim() || meta.color;
       const attrs = [
-        `name="${escAttr(mjSocialElementName(l.network))}"`,
+        `name="${escAttr(mjSocialElementShareSafeName(l.network))}"`,
         `href="${escAttr(l.href)}"`,
         `background-color="${escAttr(bgColor)}"`,
         `color="${escAttr(textColor)}"`,

package/packages/blocks/src/text.ts

@@ -1,4 +1,9 @@
-import { defineBlock, FONT_WEIGHT_STEP_OPTIONS, isRichHtmlEffectivelyEmpty, normalizeFontWeightStep } from '@simple-mail/core';
+import {
+  FONT_WEIGHT_STEP_OPTIONS,
+  defineBlock,
+  isRichHtmlEffectivelyEmpty,
+  normalizeFontWeightStep,
+} from '@simple-mail/core';
 import { icons } from './icons';
 
 interface TextProps {
@@ -27,8 +32,7 @@ export const textBlock = defineBlock<TextProps>({
   category: 'content',
   icon: icons.text,
   defaultProps: {
-    content:
-      '<p style="margin:0;">在此处输入文本。<strong>双击</strong>进入编辑模式，<em>选中文字</em>会出现工具条；支持变量 {{user.name}}</p>',
+    content: '<p>双击进入编辑...</p>',
     align: 'left',
     color: '',
     fontSize: '',
@@ -116,7 +120,7 @@ export const textBlock = defineBlock<TextProps>({
     const fwRaw = String(p.fontWeight ?? '').trim();
     const fwCss = fwRaw ? `font-weight:${normalizeFontWeightStep(fwRaw)};` : '';
     const lhRaw = String(p.lineHeight ?? '').trim();
-    const lh = lhRaw ? `line-height:${lhRaw};` : 'line-height:normal;';
+    const lh = lhRaw ? `line-height:${lhRaw};` : '';
     const colorRaw = String(p.color ?? '').trim();
     const colorCss = colorRaw ? `color:${colorRaw};` : '';
     const fsRaw = String(p.fontSize ?? '').trim();

package/packages/blocks/vite.config.ts

@@ -1,5 +1,5 @@
-import { defineConfig } from 'vite';
 import { resolve } from 'node:path';
+import { defineConfig } from 'vite';
 import dts from 'vite-plugin-dts';
 
 export default defineConfig({

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

@@ -140,6 +140,9 @@ export declare function buildBodyVariableKeyInsert(v: Variable): BodyVariableIns
 
 export declare function buildLinkVariableHtml(token: string, linkColor: string): string;
 
+/** 扫描局部设计稿内容中引用的 `{{key}}` 变量名集合（粘贴时用于变量并集）。 */
+export declare function collectSelectionVariableKeys(envelope: SelectionClipboardEnvelope): Set<string>;
+
 export declare interface Column {
     id: string;
     attrs: ColumnAttrs;
@@ -300,6 +303,8 @@ export declare interface EditorUiOptions {
     hideTopbarDocClipboard?: boolean;
     /** 为 true 时隐藏顶栏「插入变量」按钮（由宿主在编辑器外提供时可用）。 */
     hideTopbarInsertVariable?: boolean;
+    /** 为 true 时隐藏顶栏「选择节」入口（Section 批量复制 / 导出 / 删除的选择模式）。 */
+    hideTopbarSectionSelect?: boolean;
     /**
      * 为 true 时顶栏默认可切换为仅图标（文案收入 `title` / `aria-label`），适合窄屏或嵌入宿主。
      * 默认 false；嵌入场景可在宿主侧设为 true。
@@ -510,7 +515,7 @@ export declare interface ImageGalleryAdapter {
         page: number;
     }) => Promise<ImageGalleryListResult>;
     /** 在弹层内「上传到图库」：成功后编辑器会重新拉取第 0 页 */
-    uploadFile?: (file: File) => Promise<void | string>;
+    uploadFile?: (file: File) => Promise<unknown>;
     /** 在弹层内「通过链接添加」：校验/落库后编辑器会重新拉取第 0 页 */
     addByUrl?: (url: string) => Promise<void>;
     /** 从图库删除一条；提供后每张缩略图右上角显示删除按钮 */
@@ -673,6 +678,51 @@ export declare class MailEditor {
      * 将当前画布设计稿（EmailDoc JSON 信封）写入剪贴板，供另一实例「导入设计稿」使用。
      */
     copyDocDesign(): Promise<boolean>;
+    /**
+     * 复制局部设计稿：选中 Section / Block 的 JSON 写入剪贴板，可在其他画布「追加」粘贴。
+     * @param target 显式指定目标（工具条调用时传入）；缺省用当前选中项
+     */
+    copySelectionDesign(target?: {
+        sectionId: string;
+    } | {
+        blockId: string;
+    }): Promise<boolean>;
+    /**
+     * 批量复制混合勾选（整节 + 散块）的局部设计稿到剪贴板。
+     * 统一走 sections 通道：散块按母节骨架重建（保 attrs / 列结构，各列仅保留选中块），粘贴后所见即所得。
+     * @returns 是否成功写入剪贴板
+     */
+    copySectionsDesign(sectionIds: string[], blockIds?: string[]): Promise<boolean>;
+    /**
+     * 批量导出混合勾选（整节 + 散块）的局部设计稿为 JSON 文件（与剪贴板内容同构，可手动粘贴追加）。
+     * @returns 是否成功触发下载
+     */
+    exportSectionsDesign(sectionIds: string[], blockIds?: string[]): boolean;
+    /**
+     * 批量删除 Section（单条撤销记录，Ctrl/Cmd+Z 可整体恢复）。
+     * @returns 实际删除的节数量
+     */
+    removeSections(sectionIds: string[]): number;
+    /**
+     * 批量删除选择模式下的混合勾选（单条撤销记录）。
+     * 只删显式命中的内容：整选节整节删除；散选块仅从列中移除，节壳保留（可再圈选清理）。
+     * @returns 实际删除的节 + 块总数
+     */
+    removeCheckedSelection(sectionIds: string[], blockIds: string[]): number;
+    /**
+     * 按混合勾选构建局部设计稿节列表（统一走 sections 通道）：
+     * - 整选节：原样携带（id 由粘贴端重生成）
+     * - 含散选块的节：按母节骨架重建——保留 attrs / layout / 列结构，各列仅保留选中块
+     */
+    private _buildSectionsFromChecked;
+    /** 序列化局部设计稿写入剪贴板并 toast 反馈 */
+    private _writeSelectionClipboard;
+    /**
+     * 程序化粘贴局部设计稿：把 `simple-mail/selection` 信封内容**追加**到当前画布（不覆盖）。
+     * 未注册的 block type 会被跳过；内容引用到的变量会按 key 并入当前文档变量列表。
+     * @returns 是否成功解析并追加
+     */
+    importSelectionDesignFromJson(raw: string): boolean;
     /** 打开导入设计稿对话框（从剪贴板或手动粘贴 JSON，覆盖当前画布）。 */
     openImportDocDesign(): void;
     /**
@@ -719,6 +769,11 @@ export declare class MailEditor {
     private _insertAtFocus;
     private _ensureImportDocModal;
     private _applyImportedDoc;
+    /**
+     * 追加局部设计稿：过滤未注册类型 → 变量并集 → 按当前选中定位落点 → id 重生成后写入。
+     * 全程走 store.update（可撤销），不覆盖任何现有内容。
+     */
+    private _applyImportedSelection;
     private _showExport;
     private _showPreview;
     private _topbarLayoutContext;
@@ -729,6 +784,9 @@ export declare class MailEditor {
     private _unbindFullscreen;
     private _toggleFullscreen;
     private _toggleLayoutBorders;
+    /** 顶栏「选择节」入口：进入 / 退出 Section 批量选择模式（批量复制 / 导出 / 删除） */
+    private _toggleSectionSelectMode;
+    private _exitSectionSelectMode;
 }
 
 export declare function metaWidthInputString(raw: unknown): string;
@@ -835,6 +893,12 @@ export declare function parseMetaWidthFromUserInput(input: string): number | str
 /** Section 右栏输入；空字符串表示清除宽度 */
 export declare function parseSectionWidthFromUserInput(input: string): string | number | undefined;
 
+/**
+ * 解析局部设计稿信封（`simple-mail/selection`）。
+ * 仅做形状校验，不做未注册类型过滤（由编辑器粘贴时按 registry 处理）。
+ */
+export declare function parseSelectionClipboard(raw: string): SelectionClipboardEnvelope | null;
+
 /** @deprecated 请改用 {@link pruneSectionIfEmpty}，避免误删多个空 Section */
 export declare function pruneEmptySections(draft: EmailDoc): void;
 
@@ -846,6 +910,9 @@ export declare function pruneEmptySections(draft: EmailDoc): void;
  */
 export declare function pruneSectionIfEmpty(draft: EmailDoc, sectionId: string): void;
 
+/** 重生成单个 Block 的 id，用于局部粘贴。 */
+export declare function regenerateBlockId(block: Block): Block;
+
 /** 导入前重生成 section / column / block id，避免与当前文档冲突。 */
 export declare function regenerateDocIds(doc: EmailDoc): EmailDoc;
 
@@ -865,6 +932,9 @@ export declare class Registry {
     createBlock(type: string): Block;
 }
 
+/** 重生成单个 Section（含列与块）的全部 id，用于局部粘贴。 */
+export declare function remapSectionIds(sec: Section): Section;
+
 export declare interface RenderContext {
     doc: EmailDoc;
     /** 当前激活的渲染引擎，便于自定义组件做差异化输出 */
@@ -996,10 +1066,35 @@ declare type Selection_2 = {
 };
 export { Selection_2 as Selection }
 
+export declare const SELECTION_CLIPBOARD_FORMAT_VERSION: 1;
+
+/** 局部设计稿（Section / Block 子集）剪贴板信封标识 */
+export declare const SELECTION_CLIPBOARD_KIND: "simple-mail/selection";
+
+/**
+ * 局部设计稿信封：携带若干 Section 与若干独立 Block。
+ * 粘贴时按「追加」语义落到目标画布，不覆盖现有内容。
+ */
+export declare interface SelectionClipboardEnvelope {
+    kind: typeof SELECTION_CLIPBOARD_KIND;
+    formatVersion: typeof SELECTION_CLIPBOARD_FORMAT_VERSION;
+    /** 源文档变量列表；粘贴时仅合并被内容引用到的 key */
+    variables: Variable[];
+    sections: Section[];
+    blocks: Block[];
+}
+
 declare type SelectionListener = () => void;
 
 export declare function serializeDocClipboard(doc: EmailDoc): string;
 
+/** 序列化局部设计稿（选中的 Section / Block）为剪贴板 JSON。 */
+export declare function serializeSelectionClipboard(input: {
+    sections?: Section[];
+    blocks?: Block[];
+    variables?: Variable[];
+}): string;
+
 /** 更新 layout；列数变化时增删列，被删列内块并入最后一列 */
 export declare function setSectionLayout(section: Section, layout: SectionLayout): void;