@tmagic/stage 1.7.13 → 1.7.14-beta.0

package/dist/es/ActionManager.js

@@ -40,8 +40,12 @@ var ActionManager = class extends EventEmitter$1 {
 	getElementsFromPoint;
 	canSelect;
 	isContainer;
+	/** 见 ActionManagerConfig.canDropIn */
+	canDropIn;
 	getRenderDocument;
 	disabledMultiSelect = false;
+	/** 始终启用多选模式（无需按住 Ctrl/Meta），优先级低于 disabledMultiSelect */
+	alwaysMultiSelect = false;
 	config;
 	mouseMoveHandler = throttle((event) => {
 		const handler = async () => {
@@ -65,13 +69,18 @@ var ActionManager = class extends EventEmitter$1 {
 		this.containerHighlightDuration = config.containerHighlightDuration || defaultContainerHighlightDuration;
 		this.containerHighlightType = config.containerHighlightType;
 		this.disabledMultiSelect = config.disabledMultiSelect ?? false;
+		this.alwaysMultiSelect = config.alwaysMultiSelect ?? false;
 		this.getTargetElement = config.getTargetElement;
 		this.getElementsFromPoint = config.getElementsFromPoint;
 		this.canSelect = config.canSelect || ((el) => Boolean(getIdFromEl()(el)));
 		this.getRenderDocument = config.getRenderDocument;
 		this.isContainer = config.isContainer;
+		this.canDropIn = config.canDropIn;
 		this.dr = this.createDr(config);
-		if (!this.disabledMultiSelect) this.multiDr = this.createMultiDr(config);
+		if (!this.disabledMultiSelect) {
+			this.multiDr = this.createMultiDr(config);
+			if (this.alwaysMultiSelect) this.isMultiSelectStatus = true;
+		}
 		this.highlightLayer = new StageHighlight({
 			container: config.container,
 			updateDragEl: config.updateDragEl,
@@ -82,6 +91,7 @@ var ActionManager = class extends EventEmitter$1 {
 	}
 	disableMultiSelect() {
 		this.disabledMultiSelect = true;
+		this.isMultiSelectStatus = false;
 		if (this.multiDr) {
 			this.multiDr.destroy();
 			this.multiDr = null;
@@ -90,6 +100,16 @@ var ActionManager = class extends EventEmitter$1 {
 	enableMultiSelect() {
 		this.disabledMultiSelect = false;
 		if (!this.multiDr) this.multiDr = this.createMultiDr(this.config);
+		if (this.alwaysMultiSelect) this.isMultiSelectStatus = true;
+	}
+	/**
+	* 设置是否始终启用多选模式（无需按住 Ctrl/Meta），
+	* 当 `disabledMultiSelect` 为 true 时本方法不会启用多选。
+	*/
+	setAlwaysMultiSelect(value) {
+		this.alwaysMultiSelect = value;
+		if (this.disabledMultiSelect) return;
+		this.isMultiSelectStatus = value;
 	}
 	/**
 	* 设置水平/垂直参考线
@@ -255,9 +275,23 @@ var ActionManager = class extends EventEmitter$1 {
 		const doc = this.getRenderDocument();
 		if (!doc) return;
 		const els = this.getElementsFromPoint(event);
-		for (const el of els) if (!getIdFromEl()(el)?.startsWith("ghost_el_") && await this.isContainer?.(el) && !excludeElList.includes(el)) {
-			addClassName(el, doc, this.containerHighlightClassName);
-			break;
+		const sourceIds = excludeElList.map((el) => el instanceof HTMLElement ? getIdFromEl()(el) : void 0).filter((id) => Boolean(id));
+		for (const el of els) {
+			const targetId = getIdFromEl()(el);
+			if (!targetId?.startsWith("ghost_el_") && await this.isContainer?.(el) && !excludeElList.includes(el)) {
+				let highlightEl = el;
+				if (targetId && this.canDropIn) {
+					const result = this.canDropIn(sourceIds, targetId);
+					if (result === false) continue;
+					if (typeof result === "string" || typeof result === "number") {
+						const redirectedEl = this.getTargetElement(result);
+						if (!redirectedEl) continue;
+						highlightEl = redirectedEl;
+					}
+				}
+				addClassName(highlightEl, doc, this.containerHighlightClassName);
+				break;
+			}
 		}
 	}
 	/**
@@ -419,12 +453,12 @@ var ActionManager = class extends EventEmitter$1 {
 			if (!this.disabledMultiSelect) this.isMultiSelectStatus = true;
 		});
 		KeyController.global.on("blur", () => {
-			if (!this.disabledMultiSelect) this.isMultiSelectStatus = false;
+			if (!this.disabledMultiSelect && !this.alwaysMultiSelect) this.isMultiSelectStatus = false;
 			this.isAltKeydown = false;
 		});
 		KeyController.global.keyup(ctrl, (e) => {
 			e.inputEvent.preventDefault();
-			if (!this.disabledMultiSelect) this.isMultiSelectStatus = false;
+			if (!this.disabledMultiSelect && !this.alwaysMultiSelect) this.isMultiSelectStatus = false;
 		});
 		KeyController.global.keydown("alt", (e) => {
 			e.inputEvent.preventDefault();

package/dist/es/StageCore.js

@@ -177,6 +177,13 @@ var StageCore = class extends EventEmitter {
 	enableMultiSelect() {
 		this.actionManager?.enableMultiSelect();
 	}
+	/**
+	* 设置是否始终启用多选模式（无需按住 Ctrl/Meta）。
+	* 当多选被 `disabledMultiSelect` 禁用时，本方法不会启用多选。
+	*/
+	setAlwaysMultiSelect(value) {
+		this.actionManager?.setAlwaysMultiSelect(value);
+	}
 	reloadIframe(url) {
 		this.renderer?.reloadIframe(url);
 	}
@@ -231,8 +238,10 @@ var StageCore = class extends EventEmitter {
 			container: this.mask.content,
 			disabledDragStart: config.disabledDragStart,
 			disabledMultiSelect: config.disabledMultiSelect,
+			alwaysMultiSelect: config.alwaysMultiSelect,
 			canSelect: config.canSelect,
 			isContainer: config.isContainer,
+			canDropIn: config.canDropIn,
 			updateDragEl: config.updateDragEl,
 			getRootContainer: () => this.container,
 			getRenderDocument: () => this.renderer.getDocument(),

package/dist/tmagic-stage.umd.cjs

@@ -3512,8 +3512,12 @@
 		getElementsFromPoint;
 		canSelect;
 		isContainer;
+		/** 见 ActionManagerConfig.canDropIn */
+		canDropIn;
 		getRenderDocument;
 		disabledMultiSelect = false;
+		/** 始终启用多选模式（无需按住 Ctrl/Meta），优先级低于 disabledMultiSelect */
+		alwaysMultiSelect = false;
 		config;
 		mouseMoveHandler = throttle((event) => {
 			const handler = async () => {
@@ -3537,13 +3541,18 @@
 			this.containerHighlightDuration = config.containerHighlightDuration || defaultContainerHighlightDuration;
 			this.containerHighlightType = config.containerHighlightType;
 			this.disabledMultiSelect = config.disabledMultiSelect ?? false;
+			this.alwaysMultiSelect = config.alwaysMultiSelect ?? false;
 			this.getTargetElement = config.getTargetElement;
 			this.getElementsFromPoint = config.getElementsFromPoint;
 			this.canSelect = config.canSelect || ((el) => Boolean((0, _tmagic_core.getIdFromEl)()(el)));
 			this.getRenderDocument = config.getRenderDocument;
 			this.isContainer = config.isContainer;
+			this.canDropIn = config.canDropIn;
 			this.dr = this.createDr(config);
-			if (!this.disabledMultiSelect) this.multiDr = this.createMultiDr(config);
+			if (!this.disabledMultiSelect) {
+				this.multiDr = this.createMultiDr(config);
+				if (this.alwaysMultiSelect) this.isMultiSelectStatus = true;
+			}
 			this.highlightLayer = new StageHighlight({
 				container: config.container,
 				updateDragEl: config.updateDragEl,
@@ -3554,6 +3563,7 @@
 		}
 		disableMultiSelect() {
 			this.disabledMultiSelect = true;
+			this.isMultiSelectStatus = false;
 			if (this.multiDr) {
 				this.multiDr.destroy();
 				this.multiDr = null;
@@ -3562,6 +3572,16 @@
 		enableMultiSelect() {
 			this.disabledMultiSelect = false;
 			if (!this.multiDr) this.multiDr = this.createMultiDr(this.config);
+			if (this.alwaysMultiSelect) this.isMultiSelectStatus = true;
+		}
+		/**
+		* 设置是否始终启用多选模式（无需按住 Ctrl/Meta），
+		* 当 `disabledMultiSelect` 为 true 时本方法不会启用多选。
+		*/
+		setAlwaysMultiSelect(value) {
+			this.alwaysMultiSelect = value;
+			if (this.disabledMultiSelect) return;
+			this.isMultiSelectStatus = value;
 		}
 		/**
 		* 设置水平/垂直参考线
@@ -3727,9 +3747,23 @@
 			const doc = this.getRenderDocument();
 			if (!doc) return;
 			const els = this.getElementsFromPoint(event);
-			for (const el of els) if (!(0, _tmagic_core.getIdFromEl)()(el)?.startsWith("ghost_el_") && await this.isContainer?.(el) && !excludeElList.includes(el)) {
-				(0, _tmagic_core.addClassName)(el, doc, this.containerHighlightClassName);
-				break;
+			const sourceIds = excludeElList.map((el) => el instanceof HTMLElement ? (0, _tmagic_core.getIdFromEl)()(el) : void 0).filter((id) => Boolean(id));
+			for (const el of els) {
+				const targetId = (0, _tmagic_core.getIdFromEl)()(el);
+				if (!targetId?.startsWith("ghost_el_") && await this.isContainer?.(el) && !excludeElList.includes(el)) {
+					let highlightEl = el;
+					if (targetId && this.canDropIn) {
+						const result = this.canDropIn(sourceIds, targetId);
+						if (result === false) continue;
+						if (typeof result === "string" || typeof result === "number") {
+							const redirectedEl = this.getTargetElement(result);
+							if (!redirectedEl) continue;
+							highlightEl = redirectedEl;
+						}
+					}
+					(0, _tmagic_core.addClassName)(highlightEl, doc, this.containerHighlightClassName);
+					break;
+				}
 			}
 		}
 		/**
@@ -3891,12 +3925,12 @@
 				if (!this.disabledMultiSelect) this.isMultiSelectStatus = true;
 			});
 			keycon.default.global.on("blur", () => {
-				if (!this.disabledMultiSelect) this.isMultiSelectStatus = false;
+				if (!this.disabledMultiSelect && !this.alwaysMultiSelect) this.isMultiSelectStatus = false;
 				this.isAltKeydown = false;
 			});
 			keycon.default.global.keyup(ctrl, (e) => {
 				e.inputEvent.preventDefault();
-				if (!this.disabledMultiSelect) this.isMultiSelectStatus = false;
+				if (!this.disabledMultiSelect && !this.alwaysMultiSelect) this.isMultiSelectStatus = false;
 			});
 			keycon.default.global.keydown("alt", (e) => {
 				e.inputEvent.preventDefault();
@@ -4716,6 +4750,13 @@
 		enableMultiSelect() {
 			this.actionManager?.enableMultiSelect();
 		}
+		/**
+		* 设置是否始终启用多选模式（无需按住 Ctrl/Meta）。
+		* 当多选被 `disabledMultiSelect` 禁用时，本方法不会启用多选。
+		*/
+		setAlwaysMultiSelect(value) {
+			this.actionManager?.setAlwaysMultiSelect(value);
+		}
 		reloadIframe(url) {
 			this.renderer?.reloadIframe(url);
 		}
@@ -4770,8 +4811,10 @@
 				container: this.mask.content,
 				disabledDragStart: config.disabledDragStart,
 				disabledMultiSelect: config.disabledMultiSelect,
+				alwaysMultiSelect: config.alwaysMultiSelect,
 				canSelect: config.canSelect,
 				isContainer: config.isContainer,
+				canDropIn: config.canDropIn,
 				updateDragEl: config.updateDragEl,
 				getRootContainer: () => this.container,
 				getRenderDocument: () => this.renderer.getDocument(),

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.7.13",
+  "version": "1.7.14-beta.0",
   "name": "@tmagic/stage",
   "type": "module",
   "sideEffects": false,
@@ -44,7 +44,7 @@
   },
   "peerDependencies": {
     "typescript": "^6.0.3",
-    "@tmagic/core": "1.7.13"
+    "@tmagic/core": "1.7.14-beta.0"
   },
   "peerDependenciesMeta": {
     "typescript": {

package/src/ActionManager.ts

@@ -42,6 +42,7 @@ import StageMultiDragResize from './StageMultiDragResize';
 import type {
   ActionManagerConfig,
   ActionManagerEvents,
+  CanDropIn,
   CanSelect,
   CustomizeMoveableOptions,
   CustomizeMoveableOptionsCallbackConfig,
@@ -88,8 +89,12 @@ export default class ActionManager extends EventEmitter {
   private getElementsFromPoint: GetElementsFromPoint;
   private canSelect: CanSelect;
   private isContainer?: IsContainer;
+  /** 见 ActionManagerConfig.canDropIn */
+  private canDropIn?: CanDropIn;
   private getRenderDocument: GetRenderDocument;
   private disabledMultiSelect = false;
+  /** 始终启用多选模式（无需按住 Ctrl/Meta），优先级低于 disabledMultiSelect */
+  private alwaysMultiSelect = false;
   private config: ActionManagerConfig;
 
   private mouseMoveHandler = throttle((event: MouseEvent): void => {
@@ -120,16 +125,21 @@ export default class ActionManager extends EventEmitter {
     this.containerHighlightDuration = config.containerHighlightDuration || defaultContainerHighlightDuration;
     this.containerHighlightType = config.containerHighlightType;
     this.disabledMultiSelect = config.disabledMultiSelect ?? false;
+    this.alwaysMultiSelect = config.alwaysMultiSelect ?? false;
     this.getTargetElement = config.getTargetElement;
     this.getElementsFromPoint = config.getElementsFromPoint;
     this.canSelect = config.canSelect || ((el: HTMLElement) => Boolean(getIdFromEl()(el)));
     this.getRenderDocument = config.getRenderDocument;
     this.isContainer = config.isContainer;
+    this.canDropIn = config.canDropIn;
 
     this.dr = this.createDr(config);
 
     if (!this.disabledMultiSelect) {
       this.multiDr = this.createMultiDr(config);
+      if (this.alwaysMultiSelect) {
+        this.isMultiSelectStatus = true;
+      }
     }
 
     this.highlightLayer = new StageHighlight({
@@ -144,6 +154,7 @@ export default class ActionManager extends EventEmitter {
 
   public disableMultiSelect() {
     this.disabledMultiSelect = true;
+    this.isMultiSelectStatus = false;
     if (this.multiDr) {
       this.multiDr.destroy();
       this.multiDr = null;
@@ -156,6 +167,20 @@ export default class ActionManager extends EventEmitter {
     if (!this.multiDr) {
       this.multiDr = this.createMultiDr(this.config);
     }
+
+    if (this.alwaysMultiSelect) {
+      this.isMultiSelectStatus = true;
+    }
+  }
+
+  /**
+   * 设置是否始终启用多选模式（无需按住 Ctrl/Meta），
+   * 当 `disabledMultiSelect` 为 true 时本方法不会启用多选。
+   */
+  public setAlwaysMultiSelect(value: boolean) {
+    this.alwaysMultiSelect = value;
+    if (this.disabledMultiSelect) return;
+    this.isMultiSelectStatus = value;
   }
 
   /**
@@ -371,14 +396,28 @@ export default class ActionManager extends EventEmitter {
     if (!doc) return;
 
     const els = this.getElementsFromPoint(event);
+    // 取出源元素的节点 id 列表（多选拖动时为多个；从组件列表拖入时为空数组）
+    const sourceIds: Id[] = excludeElList
+      .map((el) => (el instanceof HTMLElement ? getIdFromEl()(el) : undefined))
+      .filter((id): id is string => Boolean(id));
 
     for (const el of els) {
-      if (
-        !getIdFromEl()(el)?.startsWith(GHOST_EL_ID_PREFIX) &&
-        (await this.isContainer?.(el)) &&
-        !excludeElList.includes(el)
-      ) {
-        addClassName(el, doc, this.containerHighlightClassName);
+      const targetId = getIdFromEl()(el);
+      if (!targetId?.startsWith(GHOST_EL_ID_PREFIX) && (await this.isContainer?.(el)) && !excludeElList.includes(el)) {
+        // 用户配置的钩子可以：
+        //   - 返回 false 阻止某些源拖入命中的容器（例如禁止 button 拖入 list）
+        //   - 返回 Id 将拖入目标重定向到另一个容器（例如把命中的 list 重定向到其内层的 list-content）
+        let highlightEl: HTMLElement = el;
+        if (targetId && this.canDropIn) {
+          const result = this.canDropIn(sourceIds, targetId);
+          if (result === false) continue;
+          if (typeof result === 'string' || typeof result === 'number') {
+            const redirectedEl = this.getTargetElement(result);
+            if (!redirectedEl) continue;
+            highlightEl = redirectedEl;
+          }
+        }
+        addClassName(highlightEl, doc, this.containerHighlightClassName);
         break;
       }
     }
@@ -615,14 +654,14 @@ export default class ActionManager extends EventEmitter {
     });
     // ctrl+tab切到其他窗口，需要将多选状态置为false
     KeyController.global.on('blur', () => {
-      if (!this.disabledMultiSelect) {
+      if (!this.disabledMultiSelect && !this.alwaysMultiSelect) {
         this.isMultiSelectStatus = false;
       }
       this.isAltKeydown = false;
     });
     KeyController.global.keyup(ctrl, (e) => {
       e.inputEvent.preventDefault();
-      if (!this.disabledMultiSelect) {
+      if (!this.disabledMultiSelect && !this.alwaysMultiSelect) {
         this.isMultiSelectStatus = false;
       }
     });

package/src/StageCore.ts

@@ -269,6 +269,14 @@ export default class StageCore extends EventEmitter {
     this.actionManager?.enableMultiSelect();
   }
 
+  /**
+   * 设置是否始终启用多选模式（无需按住 Ctrl/Meta）。
+   * 当多选被 `disabledMultiSelect` 禁用时，本方法不会启用多选。
+   */
+  public setAlwaysMultiSelect(value: boolean) {
+    this.actionManager?.setAlwaysMultiSelect(value);
+  }
+
   public reloadIframe(url: string) {
     this.renderer?.reloadIframe(url);
   }
@@ -346,8 +354,10 @@ export default class StageCore extends EventEmitter {
       container: this.mask!.content,
       disabledDragStart: config.disabledDragStart,
       disabledMultiSelect: config.disabledMultiSelect,
+      alwaysMultiSelect: config.alwaysMultiSelect,
       canSelect: config.canSelect,
       isContainer: config.isContainer,
+      canDropIn: config.canDropIn,
       updateDragEl: config.updateDragEl,
       getRootContainer: () => this.container,
       getRenderDocument: () => this.renderer!.getDocument(),

package/src/types.ts

@@ -30,6 +30,18 @@ export type TargetElement = HTMLElement | SVGElement;
 
 export type CanSelect = (el: HTMLElement, event: MouseEvent, stop: () => boolean) => boolean | Promise<boolean>;
 export type IsContainer = (el: HTMLElement) => boolean | Promise<boolean>;
+/**
+ * 判断当前正在拖动的源是否可以拖入目标容器（用于画布上拖入组件时的容器高亮命中）
+ * @param sourceIds 当前正在拖动的源节点 id 列表
+ *   - 在画布上拖动已有组件时：为被拖动的组件 id（多选拖动时为多个）
+ *   - 从组件列表拖入新组件时：为空数组（此时尚无 id，可仅依据 targetId 判断）
+ * @param targetId 已通过 isContainer 命中的候选容器节点 id
+ * @returns
+ *   - `false`：阻止该容器被视为合法拖入目标（不会被高亮命中）
+ *   - `Id`（string | number）：将拖入目标重定向到该 id 对应的节点
+ *   - 其他（`true` / `void` / `undefined`）：按命中的 targetId 正常拖入
+ */
+export type CanDropIn = (sourceIds: Id[], targetId: Id) => Id | boolean | void;
 export type CustomizeRender = (renderer: StageCore) => Promise<HTMLElement | void> | HTMLElement | void;
 
 export type CustomizeMoveableOptionsFunction = (config: CustomizeMoveableOptionsCallbackConfig) => MoveableOptions;
@@ -54,6 +66,11 @@ export interface StageCoreConfig {
   zoom?: number;
   canSelect?: CanSelect;
   isContainer?: IsContainer;
+  /**
+   * 画布上拖动组件时，对已通过 isContainer 命中的候选容器进行二次过滤，
+   * 用于实现"某些源不允许拖入某些容器内部"的场景。返回 false 时阻止该容器被高亮命中
+   */
+  canDropIn?: CanDropIn;
   containerHighlightClassName?: string;
   containerHighlightDuration?: number;
   containerHighlightType?: ContainerHighlightType;
@@ -67,6 +84,11 @@ export interface StageCoreConfig {
   renderType?: RenderType;
   guidesOptions?: Partial<GuidesOptions>;
   disabledMultiSelect?: boolean;
+  /**
+   * 始终启用多选模式（无需按住 Ctrl/Meta），默认 false。
+   * 当 `disabledMultiSelect` 为 true 时，本配置失效。
+   */
+  alwaysMultiSelect?: boolean;
   disabledRule?: boolean;
 }
 
@@ -78,8 +100,15 @@ export interface ActionManagerConfig {
   moveableOptions?: CustomizeMoveableOptions;
   disabledDragStart?: boolean;
   disabledMultiSelect?: boolean;
+  /**
+   * 始终启用多选模式（无需按住 Ctrl/Meta），默认 false。
+   * 当 `disabledMultiSelect` 为 true 时，本配置失效。
+   */
+  alwaysMultiSelect?: boolean;
   canSelect?: CanSelect;
   isContainer?: IsContainer;
+  /** 见 StageCoreConfig.canDropIn */
+  canDropIn?: CanDropIn;
   getRootContainer: GetRootContainer;
   getRenderDocument: GetRenderDocument;
   updateDragEl?: UpdateDragEl;

package/types/index.d.ts

@@ -160,6 +160,18 @@ declare class DragResizeHelper {
 type TargetElement = HTMLElement | SVGElement;
 type CanSelect = (el: HTMLElement, event: MouseEvent, stop: () => boolean) => boolean | Promise<boolean>;
 type IsContainer = (el: HTMLElement) => boolean | Promise<boolean>;
+/**
+ * 判断当前正在拖动的源是否可以拖入目标容器（用于画布上拖入组件时的容器高亮命中）
+ * @param sourceIds 当前正在拖动的源节点 id 列表
+ *   - 在画布上拖动已有组件时：为被拖动的组件 id（多选拖动时为多个）
+ *   - 从组件列表拖入新组件时：为空数组（此时尚无 id，可仅依据 targetId 判断）
+ * @param targetId 已通过 isContainer 命中的候选容器节点 id
+ * @returns
+ *   - `false`：阻止该容器被视为合法拖入目标（不会被高亮命中）
+ *   - `Id`（string | number）：将拖入目标重定向到该 id 对应的节点
+ *   - 其他（`true` / `void` / `undefined`）：按命中的 targetId 正常拖入
+ */
+type CanDropIn = (sourceIds: Id[], targetId: Id) => Id | boolean | void;
 type CustomizeRender = (renderer: StageCore) => Promise<HTMLElement | void> | HTMLElement | void;
 type CustomizeMoveableOptionsFunction = (config: CustomizeMoveableOptionsCallbackConfig) => MoveableOptions;
 /** 业务方自定义的moveableOptions，可以是配置，也可以是回调函数 */
@@ -180,6 +192,11 @@ interface StageCoreConfig {
   zoom?: number;
   canSelect?: CanSelect;
   isContainer?: IsContainer;
+  /**
+   * 画布上拖动组件时，对已通过 isContainer 命中的候选容器进行二次过滤，
+   * 用于实现"某些源不允许拖入某些容器内部"的场景。返回 false 时阻止该容器被高亮命中
+   */
+  canDropIn?: CanDropIn;
   containerHighlightClassName?: string;
   containerHighlightDuration?: number;
   containerHighlightType?: ContainerHighlightType;
@@ -193,6 +210,11 @@ interface StageCoreConfig {
   renderType?: RenderType;
   guidesOptions?: Partial<GuidesOptions$1>;
   disabledMultiSelect?: boolean;
+  /**
+   * 始终启用多选模式（无需按住 Ctrl/Meta），默认 false。
+   * 当 `disabledMultiSelect` 为 true 时，本配置失效。
+   */
+  alwaysMultiSelect?: boolean;
   disabledRule?: boolean;
 }
 interface ActionManagerConfig {
@@ -203,8 +225,15 @@ interface ActionManagerConfig {
   moveableOptions?: CustomizeMoveableOptions;
   disabledDragStart?: boolean;
   disabledMultiSelect?: boolean;
+  /**
+   * 始终启用多选模式（无需按住 Ctrl/Meta），默认 false。
+   * 当 `disabledMultiSelect` 为 true 时，本配置失效。
+   */
+  alwaysMultiSelect?: boolean;
   canSelect?: CanSelect;
   isContainer?: IsContainer;
+  /** 见 StageCoreConfig.canDropIn */
+  canDropIn?: CanDropIn;
   getRootContainer: GetRootContainer;
   getRenderDocument: GetRenderDocument;
   updateDragEl?: UpdateDragEl;
@@ -433,13 +462,22 @@ declare class ActionManager extends EventEmitter$1 {
   private getElementsFromPoint;
   private canSelect;
   private isContainer?;
+  /** 见 ActionManagerConfig.canDropIn */
+  private canDropIn?;
   private getRenderDocument;
   private disabledMultiSelect;
+  /** 始终启用多选模式（无需按住 Ctrl/Meta），优先级低于 disabledMultiSelect */
+  private alwaysMultiSelect;
   private config;
   private mouseMoveHandler;
   constructor(config: ActionManagerConfig);
   disableMultiSelect(): void;
   enableMultiSelect(): void;
+  /**
+   * 设置是否始终启用多选模式（无需按住 Ctrl/Meta），
+   * 当 `disabledMultiSelect` 为 true 时本方法不会启用多选。
+   */
+  setAlwaysMultiSelect(value: boolean): void;
   /**
    * 设置水平/垂直参考线
    * @param type 参考线类型
@@ -814,6 +852,11 @@ declare class StageCore extends EventEmitter {
   getDragStatus(): _$_tmagic_editor0.StageDragStatus | undefined;
   disableMultiSelect(): void;
   enableMultiSelect(): void;
+  /**
+   * 设置是否始终启用多选模式（无需按住 Ctrl/Meta）。
+   * 当多选被 `disabledMultiSelect` 禁用时，本方法不会启用多选。
+   */
+  setAlwaysMultiSelect(value: boolean): void;
   reloadIframe(url: string): void;
   /**
    * 将指定id的dom元素生成为图片
@@ -1060,4 +1103,4 @@ declare const _default: (handler: (type: AbleActionEventType) => void, customize
   render(moveable: MoveableManagerInterface<any, any>, React: Renderer): any;
 };
 //#endregion
-export { AbleActionEventType, AbleCustomizedButton, ActionManagerConfig, ActionManagerEvents, CONTAINER_HIGHLIGHT_CLASS_NAME, CanSelect, ContainerHighlightType, CoreEvents, CustomizeMoveableOptions, CustomizeMoveableOptionsCallbackConfig, CustomizeMoveableOptionsFunction, CustomizeRender, DEFAULT_ZOOM, DRAG_EL_ID_PREFIX, DelayedMarkContainer, DrEvents, DragResizeHelperConfig, GHOST_EL_ID_PREFIX, GetElementsFromPoint, GetRenderDocument, GetRootContainer, GetTargetElement, GuidesEventData, type GuidesOptions, GuidesType, HIGHLIGHT_EL_ID_PREFIX, IsContainer, Magic, MarkContainerEnd, MaskEvents, Mode, MouseButton, _default as MoveableActionsAble, MoveableOptionsManagerConfig, MultiDrEvents, Offset, PAGE_CLASS, Point, Rect, RemoveData, RemoveEventData, RenderEvents, RenderType, RuleOptions, Runtime, RuntimeWindow, SELECTED_CLASS, SelectStatus, SortEventData, StageCoreConfig, StageDragResize, StageDragResizeConfig, StageDragStatus, StageHighlightConfig, StageMask, StageMaskConfig, StageMultiDragResizeConfig, StageRender, StageRenderConfig, TargetElement, TargetShadowConfig, UpdateData, UpdateDragEl, UpdateEventData, ZIndex, addSelectedClassName, StageCore as default, down, getAbsolutePosition, getBorderWidth, getMarginValue, getMode, getOffset, getScrollParent, getTargetElStyle, isAbsolute, isFixed, isFixedParent, isMoveableButton, isRelative, isStatic, removeSelectedClassName, up };
+export { AbleActionEventType, AbleCustomizedButton, ActionManagerConfig, ActionManagerEvents, CONTAINER_HIGHLIGHT_CLASS_NAME, CanDropIn, CanSelect, ContainerHighlightType, CoreEvents, CustomizeMoveableOptions, CustomizeMoveableOptionsCallbackConfig, CustomizeMoveableOptionsFunction, CustomizeRender, DEFAULT_ZOOM, DRAG_EL_ID_PREFIX, DelayedMarkContainer, DrEvents, DragResizeHelperConfig, GHOST_EL_ID_PREFIX, GetElementsFromPoint, GetRenderDocument, GetRootContainer, GetTargetElement, GuidesEventData, type GuidesOptions, GuidesType, HIGHLIGHT_EL_ID_PREFIX, IsContainer, Magic, MarkContainerEnd, MaskEvents, Mode, MouseButton, _default as MoveableActionsAble, MoveableOptionsManagerConfig, MultiDrEvents, Offset, PAGE_CLASS, Point, Rect, RemoveData, RemoveEventData, RenderEvents, RenderType, RuleOptions, Runtime, RuntimeWindow, SELECTED_CLASS, SelectStatus, SortEventData, StageCoreConfig, StageDragResize, StageDragResizeConfig, StageDragStatus, StageHighlightConfig, StageMask, StageMaskConfig, StageMultiDragResizeConfig, StageRender, StageRenderConfig, TargetElement, TargetShadowConfig, UpdateData, UpdateDragEl, UpdateEventData, ZIndex, addSelectedClassName, StageCore as default, down, getAbsolutePosition, getBorderWidth, getMarginValue, getMode, getOffset, getScrollParent, getTargetElStyle, isAbsolute, isFixed, isFixedParent, isMoveableButton, isRelative, isStatic, removeSelectedClassName, up };