@tmagic/editor 1.8.0-beta.1 → 1.8.0-beta.2

package/dist/es/layouts/history-list/HistoryListPanel.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,270 @@
+import { useServices } from "../../hooks/use-services.js";
+import Icon_default from "../../components/Icon.js";
+import { useHistoryList } from "./composables.js";
+import CodeBlockTab_default from "./CodeBlockTab.js";
+import DataSourceTab_default from "./DataSourceTab.js";
+import HistoryDiffDialog_default from "./HistoryDiffDialog.js";
+import PageTab_default from "./PageTab.js";
+import { TMagicButton, TMagicPopover, TMagicTabs, TMagicTooltip, getDesignConfig } from "@tmagic/design";
+import { Fragment, createBlock, createElementBlock, createElementVNode, createVNode, defineComponent, guardReactiveProps, inject, markRaw, normalizeProps, openBlock, ref, resolveDynamicComponent, unref, useTemplateRef, withCtx } from "vue";
+import { Clock, Close } from "@element-plus/icons-vue";
+//#region packages/editor/src/layouts/history-list/HistoryListPanel.vue?vue&type=script&setup=true&lang.ts
+var _hoisted_1 = { class: "m-editor-history-list" };
+var HistoryListPanel_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineComponent({
+	name: "MEditorHistoryListPanel",
+	__name: "HistoryListPanel",
+	setup(__props) {
+		/**
+		* 历史记录面板：在顶部 NavMenu 上点击图标打开 popover，分三个 tab：
+		* - 页面：当前活动页面的历史栈，连续修改同一节点的多步会被合并成一组
+		* - 数据源：以 dataSource.id 分组，每组内部相邻的连续 update 自动合并
+		* - 代码块：同上，按 codeBlock.id 分组并合并相邻 update
+		*
+		* 数据通过 historyService 暴露的聚合 API 读取，UI 仅用于只读展示，
+		* 同时支持点击任意一条记录跳转至该状态：
+		* - 页面 tab：调用 editorService.gotoPageStep(targetCursor)
+		* - 数据源 tab：调用 dataSourceService.goto(id, targetCursor)
+		* - 代码块 tab：调用 codeBlockService.goto(id, targetCursor)
+		*
+		* 这里的 targetCursor = 用户点击的 step.index + 1，即"应用至此步完成的状态"。
+		*
+		* 此外每条 step 上提供"查看差异"入口（仅在前后值都存在的 update 步骤显示），
+		* 点击后弹出 HistoryDiffDialog，使用 CompareForm 组件以表单形式展示新旧值差异。
+		*
+		* 各 tab 的内容拆分为独立的 SFC（PageTab / DataSourceTab / CodeBlockTab），
+		* 共享的描述生成与折叠状态在 composables.ts 中维护。
+		*/
+		const ClockIcon = markRaw(Clock);
+		const CloseIcon = markRaw(Close);
+		const activeTab = ref("page");
+		/** 面板显隐受控：reference 图标点击切换，右上角关闭按钮置为 false。 */
+		const visible = ref(false);
+		const tabPaneComponent = getDesignConfig("components")?.tabPane;
+		const { editorService, dataSourceService, codeBlockService, historyService } = useServices();
+		/**
+		* 通过 inject 拿到 Editor 顶层注入的 `extendFormState`，转交给 HistoryDiffDialog
+		* 内部的 CompareForm，使差异对比表单的 filterFunction 能拿到完整的业务上下文。
+		* 未提供时为 undefined，CompareForm/MForm 会跳过 extendState 处理。
+		*/
+		const extendFormState = inject("extendFormState", void 0);
+		const { expanded, toggleGroup, pageGroups, dataSourceGroups, codeBlockGroups, pageGroupsDisplay, dataSourceGroupsByTarget, codeBlockGroupsByTarget } = useHistoryList();
+		/** 把"目标 step 索引"翻译成"目标 cursor"（已应用步骤数量）。 */
+		const indexToCursor = (index) => index + 1;
+		const onPageGoto = (index) => {
+			editorService.gotoPageStep(indexToCursor(index));
+		};
+		const onDataSourceGoto = (id, index) => {
+			dataSourceService.goto(id, indexToCursor(index));
+		};
+		const onCodeBlockGoto = (id, index) => {
+			codeBlockService.goto(id, indexToCursor(index));
+		};
+		/**
+		* "回到初始状态" = 把对应栈 cursor 移到 0（全部已撤销）。
+		* 复用 service.goto*(0) 即可，所有真实 step 的反向应用由 service 层的 undo 链路完成。
+		*/
+		const onPageGotoInitial = () => {
+			editorService.gotoPageStep(0);
+		};
+		const onDataSourceGotoInitial = (id) => {
+			dataSourceService.goto(id, 0);
+		};
+		const onCodeBlockGotoInitial = (id) => {
+			codeBlockService.goto(id, 0);
+		};
+		/**
+		* 「回滚」入口：把目标历史步骤的修改作为一次新操作反向应用（类 git revert），
+		* 不破坏原有栈结构。各 service 内部完成反向 + 入栈，并自带描述用于面板展示。
+		*/
+		const onPageRevert = (index) => {
+			editorService.revertPageStep(index);
+		};
+		const onDataSourceRevert = (id, index) => {
+			dataSourceService.revert(id, index);
+		};
+		const onCodeBlockRevert = (id, index) => {
+			codeBlockService.revert(id, index);
+		};
+		const diffDialogRef = useTemplateRef("diffDialog");
+		/**
+		* 页面 step 差异：仅 update 单节点修改可对比，传入旧/新节点。
+		* 节点类型 `type` 优先取 newNode.type，再回退 oldNode.type。
+		* `currentValue` 取自 editorService 中该节点当前实际值，用于支持「与当前对比」。
+		*/
+		const onPageDiff = (index) => {
+			const groups = historyService.getPageHistoryGroups();
+			for (const group of groups) {
+				const entry = group.steps.find((s) => s.index === index);
+				if (!entry) continue;
+				const item = entry.step.updatedItems?.[0];
+				if (!item?.oldNode || !item?.newNode) return;
+				const type = item.newNode.type || item.oldNode.type || "";
+				const nodeId = item.newNode.id ?? item.oldNode.id;
+				const currentNode = nodeId !== void 0 ? editorService.getNodeById(nodeId) : null;
+				diffDialogRef.value?.open({
+					category: "node",
+					type,
+					lastValue: item.oldNode,
+					value: item.newNode,
+					currentValue: currentNode || null,
+					targetLabel: item.newNode.name || item.oldNode.name || type,
+					id: nodeId
+				});
+				return;
+			}
+		};
+		const onDataSourceDiff = (id, index) => {
+			const groups = historyService.getDataSourceHistoryGroups();
+			for (const group of groups) {
+				if (group.id !== id) continue;
+				const entry = group.steps.find((s) => s.index === index);
+				if (!entry) continue;
+				const { oldSchema, newSchema } = entry.step;
+				if (!oldSchema || !newSchema) return;
+				const currentSchema = dataSourceService.getDataSourceById(`${id}`);
+				diffDialogRef.value?.open({
+					category: "data-source",
+					type: newSchema.type || oldSchema.type || "base",
+					lastValue: oldSchema,
+					value: newSchema,
+					currentValue: currentSchema || null,
+					targetLabel: newSchema.title || oldSchema.title || `${id}`,
+					id
+				});
+				return;
+			}
+		};
+		const onCodeBlockDiff = (id, index) => {
+			const groups = historyService.getCodeBlockHistoryGroups();
+			for (const group of groups) {
+				if (group.id !== id) continue;
+				const entry = group.steps.find((s) => s.index === index);
+				if (!entry) continue;
+				const { oldContent, newContent } = entry.step;
+				if (!oldContent || !newContent) return;
+				const currentContent = codeBlockService.getCodeContentById(id);
+				diffDialogRef.value?.open({
+					category: "code-block",
+					lastValue: oldContent,
+					value: newContent,
+					currentValue: currentContent || null,
+					targetLabel: newContent.name || oldContent.name || `${id}`,
+					id
+				});
+				return;
+			}
+		};
+		return (_ctx, _cache) => {
+			return openBlock(), createElementBlock(Fragment, null, [createVNode(unref(TMagicPopover), {
+				"popper-class": "m-editor-history-list-popover",
+				placement: "bottom",
+				trigger: "click",
+				visible: visible.value,
+				width: 660
+			}, {
+				reference: withCtx(() => [createVNode(unref(TMagicTooltip), {
+					effect: "dark",
+					placement: "bottom",
+					content: "历史记录"
+				}, {
+					default: withCtx(() => [createVNode(unref(TMagicButton), {
+						size: "small",
+						link: "",
+						onClick: _cache[2] || (_cache[2] = ($event) => visible.value = !visible.value)
+					}, {
+						icon: withCtx(() => [createVNode(Icon_default, { icon: unref(ClockIcon) }, null, 8, ["icon"])]),
+						_: 1
+					})]),
+					_: 1
+				})]),
+				default: withCtx(() => [createElementVNode("div", _hoisted_1, [createVNode(unref(TMagicTooltip), {
+					effect: "dark",
+					placement: "top",
+					content: "关闭"
+				}, {
+					default: withCtx(() => [createVNode(unref(TMagicButton), {
+						class: "m-editor-history-list-close",
+						size: "small",
+						link: "",
+						onClick: _cache[0] || (_cache[0] = ($event) => visible.value = false)
+					}, {
+						icon: withCtx(() => [createVNode(Icon_default, { icon: unref(CloseIcon) }, null, 8, ["icon"])]),
+						_: 1
+					})]),
+					_: 1
+				}), createVNode(unref(TMagicTabs), {
+					modelValue: activeTab.value,
+					"onUpdate:modelValue": _cache[1] || (_cache[1] = ($event) => activeTab.value = $event),
+					class: "m-editor-history-list-tabs"
+				}, {
+					default: withCtx(() => [
+						(openBlock(), createBlock(resolveDynamicComponent(unref(tabPaneComponent)?.component || "el-tab-pane"), normalizeProps(guardReactiveProps(unref(tabPaneComponent)?.props({
+							name: "page",
+							label: `页面 (${unref(pageGroups).length})`
+						}) || {})), {
+							default: withCtx(() => [createVNode(PageTab_default, {
+								list: unref(pageGroupsDisplay),
+								expanded: unref(expanded),
+								onToggle: unref(toggleGroup),
+								onGoto: onPageGoto,
+								onGotoInitial: onPageGotoInitial,
+								onDiffStep: onPageDiff,
+								onRevertStep: onPageRevert
+							}, null, 8, [
+								"list",
+								"expanded",
+								"onToggle"
+							])]),
+							_: 1
+						}, 16)),
+						(openBlock(), createBlock(resolveDynamicComponent(unref(tabPaneComponent)?.component || "el-tab-pane"), normalizeProps(guardReactiveProps(unref(tabPaneComponent)?.props({
+							name: "data-source",
+							label: `数据源 (${unref(dataSourceGroups).length})`
+						}) || {})), {
+							default: withCtx(() => [createVNode(DataSourceTab_default, {
+								buckets: unref(dataSourceGroupsByTarget),
+								expanded: unref(expanded),
+								onToggle: unref(toggleGroup),
+								onGoto: onDataSourceGoto,
+								onGotoInitial: onDataSourceGotoInitial,
+								onDiffStep: onDataSourceDiff,
+								onRevertStep: onDataSourceRevert
+							}, null, 8, [
+								"buckets",
+								"expanded",
+								"onToggle"
+							])]),
+							_: 1
+						}, 16)),
+						(openBlock(), createBlock(resolveDynamicComponent(unref(tabPaneComponent)?.component || "el-tab-pane"), normalizeProps(guardReactiveProps(unref(tabPaneComponent)?.props({
+							name: "code-block",
+							label: `代码块 (${unref(codeBlockGroups).length})`
+						}) || {})), {
+							default: withCtx(() => [createVNode(CodeBlockTab_default, {
+								buckets: unref(codeBlockGroupsByTarget),
+								expanded: unref(expanded),
+								onToggle: unref(toggleGroup),
+								onGoto: onCodeBlockGoto,
+								onGotoInitial: onCodeBlockGotoInitial,
+								onDiffStep: onCodeBlockDiff,
+								onRevertStep: onCodeBlockRevert
+							}, null, 8, [
+								"buckets",
+								"expanded",
+								"onToggle"
+							])]),
+							_: 1
+						}, 16))
+					]),
+					_: 1
+				}, 8, ["modelValue"])])]),
+				_: 1
+			}, 8, ["visible"]), createVNode(HistoryDiffDialog_default, {
+				ref: "diffDialog",
+				"extend-state": unref(extendFormState)
+			}, null, 8, ["extend-state"])], 64);
+		};
+	}
+});
+//#endregion
+export { HistoryListPanel_vue_vue_type_script_setup_true_lang_default as default };

package/dist/es/layouts/history-list/InitialRow.js

@@ -0,0 +1,5 @@
+import InitialRow_vue_vue_type_script_setup_true_lang_default from "./InitialRow.vue_vue_type_script_setup_true_lang.js";
+//#region packages/editor/src/layouts/history-list/InitialRow.vue
+var InitialRow_default = InitialRow_vue_vue_type_script_setup_true_lang_default;
+//#endregion
+export { InitialRow_default as default };

package/dist/es/layouts/history-list/InitialRow.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,48 @@
+import { createCommentVNode, createElementBlock, createElementVNode, defineComponent, normalizeClass, openBlock } from "vue";
+//#region packages/editor/src/layouts/history-list/InitialRow.vue?vue&type=script&setup=true&lang.ts
+var _hoisted_1 = ["title"];
+var _hoisted_2 = {
+	key: 0,
+	class: "m-editor-history-list-item-current"
+};
+var InitialRow_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineComponent({
+	name: "MEditorHistoryListInitialRow",
+	__name: "InitialRow",
+	props: { isCurrent: { type: Boolean } },
+	emits: ["goto-initial"],
+	setup(__props, { emit: __emit }) {
+		/**
+		* 「初始状态」记录行：渲染于历史列表底部，作为整个栈的"零点"。
+		* - 点击该行会把对应栈撤销到 cursor === 0（即没有任何已应用步骤），等同于回到所有修改之前。
+		* - 当对应栈本身已处于 cursor === 0 时（isCurrent=true），用户已在初始状态，点击不再触发动作。
+		*
+		* 该行不是真实 step，仅作为 UI 入口；上层负责把"点击"翻译为 `service.goto*(0)`。
+		*/
+		const props = __props;
+		const emit = __emit;
+		const onClick = () => {
+			if (props.isCurrent) return;
+			emit("goto-initial");
+		};
+		return (_ctx, _cache) => {
+			return openBlock(), createElementBlock("li", {
+				class: normalizeClass(["m-editor-history-list-item m-editor-history-list-initial", {
+					"is-current": __props.isCurrent,
+					"is-clickable": !__props.isCurrent
+				}]),
+				title: __props.isCurrent ? "当前已回到未修改的初始状态" : "点击回到未修改的初始状态",
+				onClick
+			}, [
+				_cache[0] || (_cache[0] = createElementVNode("span", {
+					class: "m-editor-history-list-item-index",
+					title: "历史步骤编号 #0（未修改的初始状态）"
+				}, "#0", -1)),
+				_cache[1] || (_cache[1] = createElementVNode("span", { class: "m-editor-history-list-item-op op-initial" }, "初始", -1)),
+				_cache[2] || (_cache[2] = createElementVNode("span", { class: "m-editor-history-list-item-desc" }, "未修改的初始状态", -1)),
+				__props.isCurrent ? (openBlock(), createElementBlock("span", _hoisted_2, "当前")) : createCommentVNode("v-if", true)
+			], 10, _hoisted_1);
+		};
+	}
+});
+//#endregion
+export { InitialRow_vue_vue_type_script_setup_true_lang_default as default };

package/dist/es/layouts/history-list/PageTab.js

@@ -0,0 +1,5 @@
+import PageTab_vue_vue_type_script_setup_true_lang_default from "./PageTab.vue_vue_type_script_setup_true_lang.js";
+//#region packages/editor/src/layouts/history-list/PageTab.vue
+var PageTab_default = PageTab_vue_vue_type_script_setup_true_lang_default;
+//#endregion
+export { PageTab_default as default };

package/dist/es/layouts/history-list/PageTab.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,99 @@
+import { describePageGroup, describePageStep } from "./composables.js";
+import GroupRow_default from "./GroupRow.js";
+import InitialRow_default from "./InitialRow.js";
+import { TMagicScrollbar } from "@tmagic/design";
+import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createVNode, defineComponent, openBlock, renderList, unref, withCtx } from "vue";
+//#region packages/editor/src/layouts/history-list/PageTab.vue?vue&type=script&setup=true&lang.ts
+var _hoisted_1 = {
+	key: 0,
+	class: "m-editor-history-list-empty"
+};
+var _hoisted_2 = { class: "m-editor-history-list-ul" };
+var PageTab_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineComponent({
+	name: "MEditorHistoryListPageTab",
+	__name: "PageTab",
+	props: {
+		list: {},
+		expanded: {}
+	},
+	emits: [
+		"toggle",
+		"goto",
+		"goto-initial",
+		"diff-step",
+		"revert-step"
+	],
+	setup(__props) {
+		const props = __props;
+		/**
+		* 当前 step 是否可查看差异：
+		* - 仅 update 操作；
+		* - 单节点更新（updatedItems.length === 1），且 oldNode / newNode 都存在。
+		* 多节点更新难以选定单一对比目标，统一不展示差异入口。
+		*/
+		const isPageStepDiffable = (step) => {
+			if (step.opType !== "update") return false;
+			const items = step.updatedItems ?? [];
+			if (items.length !== 1) return false;
+			return Boolean(items[0]?.oldNode && items[0]?.newNode);
+		};
+		/**
+		* 是否处于"初始状态"——即对应页面历史栈 cursor===0：
+		* 当 list 中所有 group 的 applied 都为 false 时即为该状态。
+		* 没有任何 group 的情况由外层"暂无操作记录"分支兜底，本计算可以不考虑。
+		*/
+		const isInitial = computed(() => props.list.length > 0 && props.list.every((g) => !g.applied));
+		return (_ctx, _cache) => {
+			return !__props.list.length ? (openBlock(), createElementBlock("div", _hoisted_1, "暂无操作记录")) : (openBlock(), createBlock(unref(TMagicScrollbar), {
+				key: 1,
+				"max-height": "360px"
+			}, {
+				default: withCtx(() => [createElementVNode("ul", _hoisted_2, [
+					(openBlock(true), createElementBlock(Fragment, null, renderList(__props.list, (group, gIdx) => {
+						return openBlock(), createBlock(GroupRow_default, {
+							key: `pg-${gIdx}`,
+							"group-key": `pg-${gIdx}`,
+							applied: group.applied,
+							merged: group.steps.length > 1,
+							"op-type": group.opType,
+							desc: unref(describePageGroup)(group),
+							"step-count": group.steps.length,
+							"sub-steps": group.steps.map((s) => ({
+								index: s.index,
+								applied: s.applied,
+								isCurrent: s.isCurrent,
+								desc: unref(describePageStep)(s.step),
+								diffable: isPageStepDiffable(s.step),
+								revertable: s.applied
+							})),
+							"is-current": group.isCurrent,
+							expanded: !!__props.expanded[`pg-${gIdx}`],
+							onToggle: _cache[0] || (_cache[0] = (key) => _ctx.$emit("toggle", key)),
+							onGoto: _cache[1] || (_cache[1] = (index) => _ctx.$emit("goto", index)),
+							onDiffStep: _cache[2] || (_cache[2] = (index) => _ctx.$emit("diff-step", index)),
+							onRevertStep: _cache[3] || (_cache[3] = (index) => _ctx.$emit("revert-step", index))
+						}, null, 8, [
+							"group-key",
+							"applied",
+							"merged",
+							"op-type",
+							"desc",
+							"step-count",
+							"sub-steps",
+							"is-current",
+							"expanded"
+						]);
+					}), 128)),
+					createCommentVNode("\n        初始状态项：永远位于列表底部（页面 tab 倒序展示，最底部=最早），\n        作为\"未修改\"零点。当所有 group 都未 applied 时它即为当前位置。\n      "),
+					createVNode(InitialRow_default, {
+						"is-current": isInitial.value,
+						onGotoInitial: _cache[4] || (_cache[4] = ($event) => _ctx.$emit("goto-initial"))
+					}, null, 8, ["is-current"])
+				])]),
+				_: 1
+			}));
+		};
+	}
+});
+//#endregion
+export { PageTab_vue_vue_type_script_setup_true_lang_default as default };

package/dist/es/layouts/history-list/composables.js

@@ -0,0 +1,154 @@
+import { useServices } from "../../hooks/use-services.js";
+import { computed, reactive } from "vue";
+//#region packages/editor/src/layouts/history-list/composables.ts
+/**
+* 历史记录面板共享逻辑：
+* - 暴露三类历史的聚合数据（页面 / 数据源 / 代码块）；
+* - 提供折叠状态管理；
+* - 提供操作描述文案生成器。
+*
+* 所有数据基于 historyService 的 reactive state 派生，自动跟随历史变化刷新。
+*/
+var useHistoryList = () => {
+	const { historyService } = useServices();
+	/** 折叠状态：key 形如 `pg-${groupIdx}` / `ds-${id}-${groupIdx}` / `cb-${id}-${groupIdx}`。 */
+	const expanded = reactive({});
+	const toggleGroup = (key) => {
+		expanded[key] = !expanded[key];
+	};
+	const pageGroups = computed(() => historyService.getPageHistoryGroups());
+	const dataSourceGroups = computed(() => historyService.getDataSourceHistoryGroups());
+	const codeBlockGroups = computed(() => historyService.getCodeBlockHistoryGroups());
+	/** 页面 tab 倒序展示（最新一组在最上面）。 */
+	const pageGroupsDisplay = computed(() => pageGroups.value.slice().reverse());
+	/**
+	* 把按时间正序的 group 列表，再按 id 聚拢成 bucket（同 id 的所有分组放一起）。
+	* 每个 bucket 内部仍然按时间倒序展示（最近的操作最先看到）。
+	*/
+	const groupByTarget = (groups) => {
+		const map = /* @__PURE__ */ new Map();
+		groups.forEach((g) => {
+			const list = map.get(g.id) ?? [];
+			list.push(g);
+			map.set(g.id, list);
+		});
+		return Array.from(map.entries()).map(([id, gs]) => ({
+			id,
+			groups: gs.slice().reverse()
+		}));
+	};
+	return {
+		expanded,
+		toggleGroup,
+		pageGroups,
+		dataSourceGroups,
+		codeBlockGroups,
+		pageGroupsDisplay,
+		dataSourceGroupsByTarget: computed(() => groupByTarget(dataSourceGroups.value)),
+		codeBlockGroupsByTarget: computed(() => groupByTarget(codeBlockGroups.value))
+	};
+};
+var opLabel = (op) => {
+	switch (op) {
+		case "add": return "新增";
+		case "remove": return "删除";
+		default: return "修改";
+	}
+};
+var nameOf = (node) => node?.name || node?.type || `${node?.id ?? ""}`;
+/**
+* 默认描述里展示「名称 (id: xxx)」，便于区分同名实体。
+* - 当未传入 id，或 label 本身就是 id 字符串（即没有 name/type/title 可用）时，仅展示 label，避免出现「123 (id: 123)」。
+*/
+var labelWithId = (label, id) => {
+	const labelStr = label === void 0 || label === null ? "" : `${label}`;
+	if (id === void 0 || id === null || id === "") return labelStr;
+	if (labelStr === "" || labelStr === `${id}`) return `${id}`;
+	return `${labelStr} (id: ${id})`;
+};
+/** 从一组可选 historyDescription 中取最后一条非空值；都为空时返回 undefined。 */
+var pickLastDescription = (descs) => {
+	for (let i = descs.length - 1; i >= 0; i--) if (descs[i]) return descs[i];
+};
+var describePageStep = (step) => {
+	if (step.historyDescription) return step.historyDescription;
+	const { opType } = step;
+	if (opType === "add") {
+		const count = step.nodes?.length ?? 0;
+		const node = step.nodes?.[0];
+		return `新增 ${count} 个节点${count === 1 && node ? `（${labelWithId(nameOf(node), node.id)}）` : ""}`;
+	}
+	if (opType === "remove") {
+		const count = step.removedItems?.length ?? 0;
+		const node = step.removedItems?.[0]?.node;
+		return `删除 ${count} 个节点${count === 1 && node ? `（${labelWithId(nameOf(node), node.id)}）` : ""}`;
+	}
+	const updated = step.updatedItems ?? [];
+	if (!updated.length) return "修改节点";
+	if (updated.length === 1) {
+		const { newNode, changeRecords } = updated[0];
+		const propPath = changeRecords?.[0]?.propPath;
+		return `修改 ${labelWithId(nameOf(newNode), newNode?.id)}${propPath ? ` · ${propPath}` : ""}`;
+	}
+	return `修改 ${updated.length} 个节点`;
+};
+/**
+* 合并组的展示文案：
+* - 若组内任一步显式提供了 historyDescription：取最后一条非空 historyDescription（最近一次的描述更准确）；
+* - 单步组：复用 describePageStep；
+* - 多步组（连续修改同一节点）：展示节点名 + 涉及的前几个 propPath。
+*/
+var describePageGroup = (group) => {
+	const lastDesc = pickLastDescription(group.steps.map((s) => s.step.historyDescription));
+	if (lastDesc) return lastDesc;
+	if (group.steps.length === 1) return describePageStep(group.steps[0].step);
+	const paths = /* @__PURE__ */ new Set();
+	group.steps.forEach((s) => {
+		s.step.updatedItems?.[0]?.changeRecords?.forEach((r) => r.propPath && paths.add(r.propPath));
+	});
+	const pathList = Array.from(paths).slice(0, 3).join(", ");
+	const target = labelWithId(group.targetName ?? (group.targetId !== void 0 ? `${group.targetId}` : "节点"), group.targetId);
+	return pathList ? `修改 ${target} · ${pathList}${paths.size > 3 ? "…" : ""}` : `修改 ${target}`;
+};
+var describeDataSourceStep = (step) => {
+	if (step.historyDescription) return step.historyDescription;
+	if (step.oldSchema === null && step.newSchema) return `创建 ${labelWithId(step.newSchema.title, step.newSchema.id ?? step.id)}`;
+	if (step.newSchema === null && step.oldSchema) return `删除 ${labelWithId(step.oldSchema.title, step.oldSchema.id ?? step.id)}`;
+	const propPath = step.changeRecords?.[0]?.propPath;
+	const title = labelWithId(step.newSchema?.title || step.oldSchema?.title, step.id);
+	return propPath ? `修改 ${title} · ${propPath}` : `修改 ${title}`;
+};
+var describeDataSourceGroup = (group) => {
+	const lastDesc = pickLastDescription(group.steps.map((s) => s.step.historyDescription));
+	if (lastDesc) return lastDesc;
+	if (group.steps.length === 1) return describeDataSourceStep(group.steps[0].step);
+	const paths = /* @__PURE__ */ new Set();
+	group.steps.forEach((s) => {
+		s.step.changeRecords?.forEach((r) => r.propPath && paths.add(r.propPath));
+	});
+	const pathList = Array.from(paths).slice(0, 3).join(", ");
+	const target = labelWithId(group.steps[group.steps.length - 1].step.newSchema?.title || group.steps[0].step.oldSchema?.title, group.id);
+	return pathList ? `修改 ${target} · ${pathList}${paths.size > 3 ? "…" : ""}` : `修改 ${target}`;
+};
+var describeCodeBlockStep = (step) => {
+	if (step.historyDescription) return step.historyDescription;
+	if (step.oldContent === null && step.newContent) return `创建 ${labelWithId(step.newContent.name, step.newContent.id ?? step.id)}`;
+	if (step.newContent === null && step.oldContent) return `删除 ${labelWithId(step.oldContent.name, step.oldContent.id ?? step.id)}`;
+	const propPath = step.changeRecords?.[0]?.propPath;
+	const title = labelWithId(step.newContent?.name || step.oldContent?.name, step.id);
+	return propPath ? `修改 ${title} · ${propPath}` : `修改 ${title}`;
+};
+var describeCodeBlockGroup = (group) => {
+	const lastDesc = pickLastDescription(group.steps.map((s) => s.step.historyDescription));
+	if (lastDesc) return lastDesc;
+	if (group.steps.length === 1) return describeCodeBlockStep(group.steps[0].step);
+	const paths = /* @__PURE__ */ new Set();
+	group.steps.forEach((s) => {
+		s.step.changeRecords?.forEach((r) => r.propPath && paths.add(r.propPath));
+	});
+	const pathList = Array.from(paths).slice(0, 3).join(", ");
+	const target = labelWithId(group.steps[group.steps.length - 1].step.newContent?.name || group.steps[0].step.oldContent?.name, group.id);
+	return pathList ? `修改 ${target} · ${pathList}${paths.size > 3 ? "…" : ""}` : `修改 ${target}`;
+};
+//#endregion
+export { describeCodeBlockGroup, describeCodeBlockStep, describeDataSourceGroup, describeDataSourceStep, describePageGroup, describePageStep, opLabel, useHistoryList };

package/dist/es/layouts/sidebar/layer/use-node-status.js

@@ -4,7 +4,7 @@ import { computed, onBeforeUnmount, ref, watch } from "vue";
 //#region packages/editor/src/layouts/sidebar/layer/use-node-status.ts
 var createPageNodeStatus = (page, initialLayerNodeStatus) => {
 	const map = /* @__PURE__ */ new Map();
-	map.set(page.id, {
+	map.set(page.id, initialLayerNodeStatus?.get(page.id) || {
 		visible: true,
 		expand: true,
 		selected: true,