mail-editor-pancake 0.2.1 → 0.2.2

package/README.md

@@ -76,7 +76,7 @@ simple-mail/
 - **MJML 管线**：内部 `EmailDoc` JSON → MJML → 邮件客户端可用 HTML
 - 双模式：设计态 + 源码态（文档级只读 MJML/HTML；组件级可锁定 `lockedMjml`）
 - 内置块：文本、HTML(raw)、图片、按钮、分隔线、间距、Hero、社交组，以及 1/2/3 列布局；示例自定义：Logo、单链社交、页脚
-- **图片字段**：手输 URL；可选上传（`uploadImage`）、内置图库（`imageGallery`）、自管图床（`pickImageFromGallery`）
+- **图片字段**：手输 URL；可选上传（`uploadImage`）、内置图库（`imageGallery`）、自管图库（`pickImageFromGallery`）
 - 撤销/重做、键盘删除、复制 Section/Block；**复制/导入设计稿**（JSON 信封）
 - **界面主题**：浅色 / 深色 / 跟随系统；画布仍为白纸贴近成品
 - **品牌色**：`accentColor` / `setAccentColor`；可选顶栏拾色器
@@ -594,7 +594,7 @@ import {
 |------|------|
 | `uploadImage?(file, ctx)` | 右栏「上传」→ HTTPS URL |
 | `imageGallery?` | 内置图库弹层（`showGallery: true`） |
-| `pickImageFromGallery?(ctx)` | 自管图床；与 `imageGallery` 并存时**优先内置图库** |
+| `pickImageFromGallery?(ctx)` | 自管图库；与 `imageGallery` 并存时**优先内置图库** |
 | `showUpload?` | 默认 `true`（有 `uploadImage` 时） |
 | `showGallery?` | 默认 `false` |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mail-editor-pancake",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "private": false,
   "description": "面向运营的轻量邮件可视化编辑器",
   "devDependencies": {

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

@@ -9,6 +9,14 @@ export declare function annotateDynamicVariantHtmlAttributes(html: string, doc:
  */
 export declare function appendInlineToRichHtml(html: string, insert: string): string;
 
+/**
+ * 资源动作权限的语义标识。宿主在 `ImageAssetPermissions.check` 中据此返回是否有权限：
+ * - `'upload'`：右栏「上传」按钮、图库弹层「上传」按钮（对应创建/上传权限）
+ * - `'addUrl'`：图库弹层「添加链接」按钮（对应创建权限）
+ * - `'delete'`：图库弹层缩略图删除按钮（对应删除权限）
+ */
+export declare type AssetPermissionAction = 'upload' | 'addUrl' | 'delete';
+
 /**
  * Block 是注册表驱动的：所有内置/自定义组件都遵循同一个数据形状。
  * 渲染、属性面板、代码模式三方都从注册表读取该 type 的定义。
@@ -224,7 +232,7 @@ declare interface EditorOptions {
      */
     theme?: EditorTheme;
     /**
-     * 可选。为 `type: 'image'` 提供上传 / 图床；`showUpload` 默认 true（有 uploadImage 时），`showGallery` 默认 false。
+     * 可选。为 `type: 'image'` 提供上传 / 图库；`showUpload` 默认 true（有 uploadImage 时），`showGallery` 默认 false。
      */
     imageAssets?: ImageAssetsHandlers;
     /** 右栏控件形态等可选 UI 偏好。 */
@@ -408,13 +416,34 @@ export declare interface GlobalStyles {
 /** HTML 块内容是否误含 MJML 标签（应只写 HTML，MJML 标签在 mj-raw 内不会被编译）。 */
 export declare function htmlContainsMjmlTags(html: string): boolean;
 
+/**
+ * 图片资源动作的权限管控配置。未配置 `check` 时视为全部有权限（不做管控）。
+ */
+export declare interface ImageAssetPermissions {
+    /**
+     * 权限校验：返回 `false` 表示该动作无权限。
+     * 未配置时视为全部有权限。
+     */
+    check?: (action: AssetPermissionAction) => boolean;
+    /**
+     * 无权限时的表现：
+     * - `'disable'`（默认）：按钮置灰禁用，hover 提示无权限。
+     * - `'hide'`：直接隐藏对应按钮。
+     */
+    noPermissionMode?: 'disable' | 'hide';
+    /**
+     * 无权限禁用时 hover 提示文案；未配置或为空时使用编辑器默认文案（`common.noPermission`）。
+     */
+    noPermissionTip?: string;
+}
+
 export declare interface ImageAssetsHandlers {
     /**
      * 用户点击右侧「上传」并选择本地文件。宿主完成上传后返回 **绝对 HTTPS URL**。
      */
     uploadImage?: (file: File, ctx: ImageFieldContext) => Promise<string>;
     /**
-     * 完全自管图床：与内置 `imageGallery` 可并存；
+     * 完全自管图库：与内置 `imageGallery` 可并存；
      * **同时配置时优先使用内置 `imageGallery` 弹层**。
      */
     pickImageFromGallery?: (ctx: ImageFieldContext) => Promise<string | null>;
@@ -429,14 +458,19 @@ export declare interface ImageAssetsHandlers {
      */
     showUpload?: boolean;
     /**
-     * 是否显示「图床」按钮。在配置了 `pickImageFromGallery` 或 `imageGallery` 时有效。
+     * 是否显示「图库」按钮。在配置了 `pickImageFromGallery` 或 `imageGallery` 时有效。
      * 默认 `false`；需显式设为 `true` 才展示入口。
      */
     showGallery?: boolean;
+    /**
+     * 资源动作权限管控。配置后，「上传 / 添加链接 / 删除」按钮将按 `check` 结果禁用或隐藏。
+     * 默认无权限时禁用并 hover 提示。右栏「上传」与图库弹层内按钮共用同一份配置。
+     */
+    permissions?: ImageAssetPermissions;
 }
 
 /**
- * 右侧「图片地址」类字段：宿主可选手输 URL、本地上传、内置图库弹层或完全自管图床回调。
+ * 右侧「图片地址」类字段：宿主可选手输 URL、本地上传、内置图库弹层或完全自管图库回调。
  * 编辑器最终只把 URL 写入 props。
  */
 export declare interface ImageFieldContext {
@@ -713,6 +747,11 @@ export declare interface OpenImageGalleryModalOptions {
     /** 挂载父节点，默认 `document.body` */
     parent?: HTMLElement;
     onClose?: () => void;
+    /**
+     * 资源动作权限管控。未配置或未提供 `check` 时弹层内按钮不做管控；
+     * 配置后「添加 / 上传 / 删除」按 `check` 结果禁用（默认）或隐藏，禁用时 hover 提示无权限。
+     */
+    permissions?: ImageAssetPermissions;
 }
 
 /** 左栏组合拖入：可附带新建 Section 的 attrs（如 meta 扩展袋） */
@@ -799,6 +838,22 @@ export declare function renderSectionBodyHtml(doc: EmailDoc, sectionId: string,
  */
 export declare function replaceVariables(text: string, vars: Variable[]): string;
 
+/**
+ * 解析某个动作的权限状态。未配置 `permissions` 或 `check` 时视为有权限。
+ * @param defaultNoPermissionTip 编辑器默认的无权限提示文案（由调用方从 i18n 传入）
+ */
+export declare function resolveAssetPermission(permissions: ImageAssetPermissions | undefined, action: AssetPermissionAction, defaultNoPermissionTip: string): ResolvedAssetPermission;
+
+/** `resolveAssetPermission` 的结果。 */
+export declare interface ResolvedAssetPermission {
+    /** `true` 表示有权限 */
+    allowed: boolean;
+    /** 无权限时的表现（仅在 `allowed === false` 时有意义） */
+    mode: 'disable' | 'hide';
+    /** 无权限禁用时的 hover 提示文案（仅在 `allowed === false` 且 `mode === 'disable'` 时有意义） */
+    tip: string;
+}
+
 /** 锁定块在画布上的渲染结果：preview 为 WYSIWYG HTML，source 为无法解析时的源码回退。 */
 export declare function resolveLockedMjmlCanvasContent(lockedMjml: string, padding: BlockPaddingBox): {
     mode: 'preview';