dsh-plugin-term-dictionary 1.1.0 → 1.1.1

package/CHANGELOG.md

@@ -2,7 +2,40 @@
 
 本文件记录**发布出去**的版本。每一项都是可验证的行为，不写计划。
 
-## 1.1.0 — 未发布
+## 1.1.1 — 2026-10-11
+
+### 组可以改名、移动、删除
+
+- **重命名与移动是同一件事**，因为组就是一条路径：`backend → 服务端` 是改名，把 `net` 从 `backend` 挪到
+  `infra` 是移动。组行第二行有 `[✎]`（改名/移动）与 `[🗑]`（删除）。
+- 每个词条都走**单条移动那条带时间戳的决定**（`groupAt`）——批量移动不是"决定"这条规则的例外，所以它
+  同样经得起与宿主的合并。
+- **站在被改名的组里会跟着它走**（留在同一层、路径变了），而不是被扔回顶层。
+- 改到已存在的组名 = **合并两个组**。三种情况明确拒绝：空名、名字没变、把组移到自己里面。
+- **删除是软删除**：组里的词条进「已删除」并留下墓碑（可逐条撤回，也挡住路过的包把它们又放回来）。
+  确认框里**带条数**——"删除这个分组？"与"删除 12 条词条？"是两个不同的提议。
+- 改名表单是**内联**的，不是 `prompt()`：Electron 不实现 `prompt`。
+
+### 组卡片有一行正文
+
+- 组行现在是 `[📁] 名字  N 条 ›` 加一行**里面最新的几个词条名**（超过三条接「等 N 条」）。空盒子变成了
+  可读的预览，等高也就有了内容可撑。
+
+### 悬停/点击：段落左侧空白不再误触发
+
+- 报告：术语在**行首**时，鼠标在它**正左侧**任意位置（直到聊天区边缘）都会弹出悬浮窗、点击也会进词条。
+- 原因：`caretRangeFromPoint` **横向夹取**——左空白里的点被解析成该行起点（offset 0），而当术语正好在
+  行首时，offset 0 就是它。
+- 修法：量**光标自己**的位置（折叠 Range 的 `getBoundingClientRect`），只有光标真的在该点时才接受
+  （容差 8px ≈ 词前空格宽度）。量不到光标时选择信任，而不是拒掉所有悬浮。
+
+### 打包闸门不再崩在退出上（开发侧）
+
+- `pnpm publish` 曾报 `ERR_PNPM_EXECUTOR_LIFECYCLE_SCRIPT_FAILED` / `0xc0000409`：闸门**通过了**，却在
+  `process.exit()` 时撞上 libuv 的 `UV_HANDLE_CLOSING` 断言（fetch 的 keep-alive socket）。现在先关
+  dispatcher、再用 `process.exitCode` 让事件循环自然排空；绿路径退 0、红路径退 1，两条都验过。
+
+## 1.1.0 — 2026-10-10
 
 ### 词条组（目录）
 

package/lib/client.js

@@ -584,6 +584,19 @@ window.__ModuleLoader__.load({
 				groupGo: "回到「{name}」",
 				groupCount: "{count} 条",
 				groupEmpty: "这一层只有分组，还没有词条。",
+				groupSampleJoin: "、",
+				groupSampleMore: " 等 {count} 条",
+				groupRename: "重命名或移动",
+				groupRenameTo: "改到：",
+				groupRenameApply: "改名 / 移动",
+				groupDelete: "删除分组",
+				groupRenamed: "已移动 {count} 条词条。",
+				groupDeleted: "已删除 {count} 条词条，它们都在「已删除」里，可以撤回。",
+				groupDeleteConfirm: "删除分组「{name}」里的 {count} 条词条？它们会进入「已删除」，之后可以逐条撤回。",
+				"groupError_no-group": "那个分组不存在。",
+				"groupError_no-name": "分组名不能为空。",
+				"groupError_same": "新旧名字一样，没有需要动的地方。",
+				"groupError_into-itself": "不能把分组移动到它自己里面。",
 				groupPlaceholder: "留空 = 顶层；用 / 分层，例如 backend/net",
 				termPlaceholder: "例如 event sourcing",
 				glossPlaceholder: "用一两句话说明它的含义",
@@ -886,6 +899,19 @@ window.__ModuleLoader__.load({
 				groupGo: "Go back to {name}",
 				groupCount: "{count} entries",
 				groupEmpty: "This level holds only groups so far.",
+				groupSampleJoin: ", ",
+				groupSampleMore: " and {count} more",
+				groupRename: "Rename or move",
+				groupRenameTo: "Move to:",
+				groupRenameApply: "Rename / move",
+				groupDelete: "Delete group",
+				groupRenamed: "Moved {count} entries.",
+				groupDeleted: "Deleted {count} entries. They are on the deleted list and can be restored one by one.",
+				groupDeleteConfirm: "Delete the {count} entries in “{name}”? They go to the deleted list, where each can be restored.",
+				"groupError_no-group": "There is no such group.",
+				"groupError_no-name": "A group needs a name.",
+				"groupError_same": "The name is unchanged, so there is nothing to move.",
+				"groupError_into-itself": "A group cannot be moved inside itself.",
 				groupPlaceholder: "empty = top level; use / to nest, e.g. backend/net",
 				termPlaceholder: "e.g. event sourcing",
 				glossPlaceholder: "Say what it means in one or two sentences",
@@ -2388,6 +2414,73 @@ window.__ModuleLoader__.load({
 				return { total: live.length, explained, unexplained: live.length - explained, pinned };
 			}
 
+			/**
+			 * Move a group — and everything under it — to another path.
+			 *
+			 * Renaming and moving are the same act, because a group IS a path: renaming `backend` to `服务端` and moving
+			 * `net` out of `backend` into `infra` are both "these entries live somewhere else now". One primitive, two
+			 * names in the UI, so the two cannot drift apart.
+			 *
+			 * Each entry is moved through {@link editEntry}, so each carries the stamped decision (`groupAt`) a merge
+			 * weighs — a bulk move is not an exception to "a move is a decision".
+			 *
+			 * Refused: an empty target, a target inside the group being moved (which would put it inside itself), and a
+			 * target that leaves everything where it is. Renaming ONTO an existing group is allowed and merges the two,
+			 * which is what a reader asking for it means.
+			 *
+			 * @param state - the current document.
+			 * @param from - the path to move.
+			 * @param to - the path to move it to.
+			 * @param options - `now` overrides the timestamps.
+			 * @returns `{ state, moved, error }`.
+			 */
+			function renameGroup(state, from, to, options) {
+				const source = typeof from === "string" ? from.replace(/^\/+|\/+$/g, "") : "";
+				const target = typeof to === "string" ? to.replace(/^\/+|\/+$/g, "") : "";
+				if (source === "") return { state, moved: 0, error: "no-group" };
+				if (target === "") return { state, moved: 0, error: "no-name" };
+				if (target === source) return { state, moved: 0, error: "same" };
+				if (target.startsWith(`${source}/`)) return { state, moved: 0, error: "into-itself" };
+				const now = options?.now ?? Date.now();
+				let next = state;
+				let moved = 0;
+				let stamp = now;
+				for (const entry of state.entries.filter((each) => each.deletedAt === 0 && (each.group === source || each.group.startsWith(`${source}/`)))) {
+					stamp += 1;
+					const rest = entry.group === source ? "" : entry.group.slice(source.length + 1);
+					next = editEntry(next, entry.term, { group: rest === "" ? target : `${target}/${rest}` }, { now: stamp }).state;
+					moved += 1;
+				}
+				return { state: next, moved, error: null };
+			}
+
+			/**
+			 * Delete a group: every entry under it goes to the deleted list.
+			 *
+			 * Soft, like every other deletion here — the tombstones make it reversible from 「已删除」, and they are also
+			 * what stops a passing pack from putting the terms straight back. A group therefore disappears when the last
+			 * entry in it does, which is the same rule that made it appear.
+			 *
+			 * @param state - the current document.
+			 * @param from - the path to empty.
+			 * @param options - `now` overrides the timestamps.
+			 * @returns `{ state, removed, error }`.
+			 */
+			function deleteGroup(state, from, options) {
+				const source = typeof from === "string" ? from.replace(/^\/+|\/+$/g, "") : "";
+				if (source === "") return { state, removed: 0, error: "no-group" };
+				const now = options?.now ?? Date.now();
+				let next = state;
+				let removed = 0;
+				let stamp = now;
+				for (const entry of state.entries.filter((each) => each.deletedAt === 0 && (each.group === source || each.group.startsWith(`${source}/`)))) {
+					stamp += 1;
+					next = removeEntry(next, entry.id, { now: stamp }).state;
+					removed += 1;
+				}
+				return { state: next, removed, error: null };
+			}
+
 			/**
 			 * The groups immediately inside one path, with how many entries each holds.
 			 *
@@ -2395,14 +2488,32 @@ window.__ModuleLoader__.load({
 			 * that child, however deep. A group exists as long as something is in it — there is no separate list of
 			 * empty groups to keep in step with the entries, which is the trade this makes deliberately.
 			 *
+			 * Each group also carries a SAMPLE of the terms inside it. A folder row with only a name and a count is a
+			 * row of empty space next to entries full of text — and a preview answers the question the row raises
+			 * without making the reader open it to find out.
+			 *
 			 * @param entries - every live entry.
 			 * @param prefix - the path to look inside, `""` for the top level.
-			 * @returns `[{ group, name, count }]`, alphabetical.
+			 * @returns `[{ group, name, count, sample }]`, alphabetical.
 			 */
+			/**
+			 * How many terms a group's preview names before it stops.
+			 *
+			 * Three: enough to say what kind of thing is in there, few enough that the line stays one line in a
+			 * multi-column layout.
+			 */
+			const GROUP_SAMPLE = 3;
+
 			function groupsIn(entries, prefix) {
 				const base = prefix === undefined || prefix === null ? "" : String(prefix);
 				const counts = new Map();
-				for (const entry of Array.isArray(entries) ? entries : []) {
+				const samples = new Map();
+				// Newest first, the order the list itself uses, so the preview is the top of what you would see inside.
+				const ordered = (Array.isArray(entries) ? entries : [])
+					.filter((entry) => (entry?.deletedAt ?? 0) === 0 && typeof entry?.term === "string" && entry.term !== "")
+					.slice()
+					.sort((left, right) => (right.createdAt ?? 0) - (left.createdAt ?? 0) || left.term.localeCompare(right.term));
+				for (const entry of ordered) {
 					if ((entry?.deletedAt ?? 0) !== 0) continue;
 					const group = typeof entry?.group === "string" ? entry.group : "";
 					if (group === "" || group === base) continue;
@@ -2412,9 +2523,12 @@ window.__ModuleLoader__.load({
 					if (inside === null || inside === "") continue;
 					const name = inside.split("/")[0];
 					counts.set(name, (counts.get(name) ?? 0) + 1);
+					const sample = samples.get(name) ?? [];
+					if (sample.length < GROUP_SAMPLE) sample.push(entry.term);
+					samples.set(name, sample);
 				}
 				return [...counts.entries()]
-					.map(([name, count]) => ({ group: base === "" ? name : `${base}/${name}`, name, count }))
+					.map(([name, count]) => ({ group: base === "" ? name : `${base}/${name}`, name, count, sample: samples.get(name) ?? [] }))
 					.sort((left, right) => left.name.localeCompare(right.name));
 			}
 
@@ -2593,6 +2707,8 @@ window.__ModuleLoader__.load({
 				upsertEntry,
 				editEntry,
 				restoreEntry,
+				renameGroup,
+				deleteGroup,
 				recordSighting,
 				removeEntry,
 				reviveEntry,
@@ -4496,6 +4612,29 @@ window.__ModuleLoader__.load({
 						return result.entry;
 					},
 
+					/**
+					 * Move a group, and everything under it, to another path.
+					 * @param from - the path to move.
+					 * @param to - the path to move it to.
+					 * @returns a promise resolving to `{ moved, error }`.
+					 */
+					async renameGroup(from, to) {
+						const result = dictionary.renameGroup(state, from, to, { now: now() });
+						if (result.moved > 0) await commit(result.state);
+						return { moved: result.moved, error: result.error };
+					},
+
+					/**
+					 * Delete a group by deleting everything inside it, which is the only way a group can be deleted.
+					 * @param from - the path to empty.
+					 * @returns a promise resolving to `{ removed, error }`.
+					 */
+					async deleteGroup(from) {
+						const result = dictionary.deleteGroup(state, from, { now: now() });
+						if (result.removed > 0) await commit(result.state);
+						return { removed: result.removed, error: result.error };
+					},
+
 					/**
 					 * Bring a deleted term back, as an explicit act.
 					 *
@@ -8401,6 +8540,45 @@ window.__ModuleLoader__.load({
 					return null;
 				}
 
+				/**
+				 * How far left of the caret a pointer may still count as being on the text.
+				 *
+				 * The space before a word is enough: landing in it resolves the caret to the word's own start, and a
+				 * reader aiming at the first letter often lands there. A paragraph's left margin is tens of pixels, which
+				 * is what this has to reject.
+				 */
+				const LEFT_TOLERANCE_PX = 8;
+
+				/**
+				 * Whether the caret a point resolved to actually sits at that point.
+				 *
+				 * `caretRangeFromPoint` CLAMPS horizontally: a point in the left margin of a line resolves to the line's
+				 * start, offset 0. When a term begins that line, offset 0 IS that term — so every point from the panel's
+				 * left edge to the first character read as "on the term", and the card opened from anywhere in the margin,
+				 * with a click to match. That is how this was reported.
+				 *
+				 * The caret's own rectangle is the live proof of where the text is: it is measured from the document at
+				 * this instant, so unlike a block snapshot it cannot go stale. One measurement per event, and only once a
+				 * caret has been found at all.
+				 *
+				 * @param x - viewport x of the pointer.
+				 * @param caret - the Range the point resolved to.
+				 * @returns true when the caret is at the pointer rather than clamped to the start of a line.
+				 */
+				function caretIsAt(x, caret) {
+					let rect = null;
+					try {
+						rect = typeof caret?.getBoundingClientRect === "function" ? caret.getBoundingClientRect() : null;
+					} catch (error) {
+						rect = null;
+					}
+					// A browser (or a fixture) that cannot answer is trusted: refusing every hover because one optional
+					// measurement is missing would be a worse failure than the one being fixed. An all-zero rectangle says
+					// the same thing in another shape — a detached or not-yet-laid-out range.
+					if (rect === null || (rect.left === 0 && rect.top === 0 && rect.width === 0 && rect.height === 0)) return true;
+					return rect.left <= x + LEFT_TOLERANCE_PX;
+				}
+
 				/**
 				 * The marked occurrence under a point.
 				 *
@@ -8415,6 +8593,7 @@ window.__ModuleLoader__.load({
 				function matchAt(x, y) {
 					const caret = caretAt(x, y);
 					if (caret === null) return null;
+					if (!caretIsAt(x, caret)) return null;
 					const at = resolveCaret(caret, doc);
 					if (at === null) return null;
 					let best = null;
@@ -9175,6 +9354,8 @@ window.__ModuleLoader__.load({
 				/** The group row's own bits: the mark that says "not an entry", and the chevron that says "opens". */
 				groupIcon: { display: "inline-flex", alignItems: "center", color: "var(--dsw-alias-label-secondary)" },
 				groupEnter: { color: "var(--dsw-alias-label-tertiary)", fontSize: "14px", lineHeight: 1 },
+				/** One line saying what is inside a group, so the card is not a name over a blank space. */
+				groupPreview: { margin: 0, fontSize: "12px", lineHeight: 1.5, color: "var(--dsw-alias-label-tertiary)", overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" },
 				/**
 				 * The row's action toolbar: the second line, always.
 				 *
@@ -11243,6 +11424,13 @@ window.__ModuleLoader__.load({
 				 * because you looked at it — so it is panel state, next to the search box and the tab.
 				 */
 				const [group, setGroup] = React.useState("");
+				/**
+				 * The group being renamed or moved, as `{ group, value }`, or null.
+				 *
+				 * An inline form rather than `prompt()`: Electron does not implement `prompt`, so a rename dialog
+				 * built on it would do nothing at all in the app this plugin runs in.
+				 */
+				const [renaming, setRenaming] = React.useState(null);
 				const visible = React.useMemo(() => store.list(query, filter, group), [view, query, filter, group]);
 				/**
 				 * The groups directly inside the current one, each with how many entries it holds.
@@ -11285,6 +11473,43 @@ window.__ModuleLoader__.load({
 					return moved;
 				};
 
+				/**
+				 * Rename or move a group, and follow it if the panel was standing inside it.
+				 *
+				 * Following is the point: a reader who renames the folder they are in must still be looking at it
+				 * afterwards, not dropped back at the top wondering where it went.
+				 */
+				const commitRename = async () => {
+					if (renaming === null) return;
+					const result = await store.renameGroup(renaming.group, renaming.value);
+					if (result.error !== null) {
+						props.setToast?.(t(`groupError_${result.error}`));
+						return;
+					}
+					const target = renaming.value.replace(/^\/+|\/+$/g, "");
+					if (group === renaming.group || group.startsWith(`${renaming.group}/`)) {
+						setGroup(group === renaming.group ? target : `${target}${group.slice(renaming.group.length)}`);
+					}
+					setRenaming(null);
+					props.setToast?.(t("groupRenamed", { count: String(result.moved) }));
+				};
+
+				/**
+				 * Delete a group by deleting what is in it, after saying how much that is.
+				 *
+				 * The entries go to 「已删除」 rather than away, so this is reversible — and the count is in the
+				 * question, because "delete this group?" and "delete 12 entries?" are different offers.
+				 */
+				const removeGroup = async (sub) => {
+					if (globalThis.confirm?.(t("groupDeleteConfirm", { name: sub.name, count: String(sub.count) })) !== true) return;
+					const result = await store.deleteGroup(sub.group);
+					if (result.error !== null) {
+						props.setToast?.(t(`groupError_${result.error}`));
+						return;
+					}
+					props.setToast?.(t("groupDeleted", { count: String(result.removed) }));
+				};
+
 				/** Open the editor for a blank entry, prefilled from an optional term. */
 				const startCreate = (term = "", context = "") => {
 					setEditing({
@@ -11818,6 +12043,24 @@ window.__ModuleLoader__.load({
 						// row. A breadcrumb says where you are and is the way back up, because a directory you can only
 						// enter is a trap.
 						[
+							renaming === null ? null : h(
+								"div",
+								{ style: { ...applyStyles.transferRow, gridColumn: "1 / -1" }, "data-term-group-form": renaming.group },
+								h("span", { style: applyStyles.fieldLabel }, t("groupRenameTo")),
+								h("input", {
+									type: "text",
+									value: renaming.value,
+									"aria-label": t("groupRename"),
+									onChange: (event) => setRenaming({ ...renaming, value: event.target.value }),
+									onKeyDown: (event) => {
+										if (event.key === "Enter") void commitRename();
+										if (event.key === "Escape") setRenaming(null);
+									},
+									style: { ...applyStyles.input, maxWidth: "18em" }
+								}),
+								h(Button, { label: t("groupRenameApply"), onClick: () => void commitRename() }, t("groupRenameApply")),
+								h(Button, { label: t("cancel"), onClick: () => setRenaming(null) }, t("cancel"))
+							),
 							group === "" ? null : h(
 								"div",
 								{ style: { ...applyStyles.breadcrumb, gridColumn: "1 / -1" }, "data-term-breadcrumb": group },
@@ -11847,16 +12090,19 @@ window.__ModuleLoader__.load({
 									"article",
 									{
 									key: `group:${sub.group}`,
-									// Its own height, not the track's: a group has no body text, so stretching it to match a
-									// three-line entry would leave an empty box the size of the entry — which is what it looked
-									// like. Equal KIND of row is the point; equal height only reads as equal among rows with text.
-									style: { ...applyStyles.row, alignSelf: "start" },
+									// It fills its row again, now that the height carries something: with the preview below, the
+									// space that used to be emptiness is the first thing you would see on opening it.
+									style: applyStyles.row,
 									"data-term-group": sub.group,
 									// The WHOLE row opens the group, exactly as the whole row of an entry opens the entry.
 									// Only the label being live is what "the group cannot be clicked into" meant: a reader
 									// clicks the row, the same gesture that works one line below, and nothing happened.
 									// The label stays a button so it is reachable by keyboard and named for a screen reader.
-									onClick: () => setGroup(sub.group)
+									onClick: (event) => {
+										// The buttons inside keep their own meaning, exactly as they do on an entry row.
+										if (typeof event?.target?.closest === "function" && event.target.closest("button") !== null) return;
+										setGroup(sub.group);
+									}
 								},
 									h("div", { style: applyStyles.rowHead },
 										h("div", { style: applyStyles.groupIcon, "aria-hidden": "true" }, Icons.folder(14)),
@@ -11869,6 +12115,24 @@ window.__ModuleLoader__.load({
 										h("span", { style: applyStyles.badge }, t("groupCount", { count: String(sub.count) })),
 										h("span", { style: applyStyles.spacer }),
 										h("span", { style: applyStyles.groupEnter, "aria-hidden": "true" }, "›")
+									),
+									// The same shape an entry row has: a title line, a line of actions, then the body.
+									h(
+										"div",
+										{ style: applyStyles.rowActions, "data-term-group-actions": sub.group },
+										h(IconButton, { title: t("groupRename"), onClick: () => setRenaming({ group: sub.group, value: sub.group }) }, Icons.edit(13)),
+										h(IconButton, { title: t("groupDelete"), onClick: () => void removeGroup(sub) }, Icons.trash(13))
+									),
+									// What is inside, in one line: the row stops being a name over a blank card.
+									h(
+										"p",
+										{ style: applyStyles.groupPreview, "data-term-group-sample": sub.group },
+										[
+											sub.sample.join(t("groupSampleJoin")),
+											sub.count > sub.sample.length ? t("groupSampleMore", { count: String(sub.count - sub.sample.length) }) : ""
+										]
+											.filter((part) => part !== "")
+											.join("")
 									)
 								)
 							),

package/lib/core/copy.js

@@ -238,6 +238,19 @@ const zh = {
 	groupGo: "回到「{name}」",
 	groupCount: "{count} 条",
 	groupEmpty: "这一层只有分组，还没有词条。",
+	groupSampleJoin: "、",
+	groupSampleMore: " 等 {count} 条",
+	groupRename: "重命名或移动",
+	groupRenameTo: "改到：",
+	groupRenameApply: "改名 / 移动",
+	groupDelete: "删除分组",
+	groupRenamed: "已移动 {count} 条词条。",
+	groupDeleted: "已删除 {count} 条词条，它们都在「已删除」里，可以撤回。",
+	groupDeleteConfirm: "删除分组「{name}」里的 {count} 条词条？它们会进入「已删除」，之后可以逐条撤回。",
+	"groupError_no-group": "那个分组不存在。",
+	"groupError_no-name": "分组名不能为空。",
+	"groupError_same": "新旧名字一样，没有需要动的地方。",
+	"groupError_into-itself": "不能把分组移动到它自己里面。",
 	groupPlaceholder: "留空 = 顶层；用 / 分层，例如 backend/net",
 	termPlaceholder: "例如 event sourcing",
 	glossPlaceholder: "用一两句话说明它的含义",
@@ -540,6 +553,19 @@ const en = {
 	groupGo: "Go back to {name}",
 	groupCount: "{count} entries",
 	groupEmpty: "This level holds only groups so far.",
+	groupSampleJoin: ", ",
+	groupSampleMore: " and {count} more",
+	groupRename: "Rename or move",
+	groupRenameTo: "Move to:",
+	groupRenameApply: "Rename / move",
+	groupDelete: "Delete group",
+	groupRenamed: "Moved {count} entries.",
+	groupDeleted: "Deleted {count} entries. They are on the deleted list and can be restored one by one.",
+	groupDeleteConfirm: "Delete the {count} entries in “{name}”? They go to the deleted list, where each can be restored.",
+	"groupError_no-group": "There is no such group.",
+	"groupError_no-name": "A group needs a name.",
+	"groupError_same": "The name is unchanged, so there is nothing to move.",
+	"groupError_into-itself": "A group cannot be moved inside itself.",
 	groupPlaceholder: "empty = top level; use / to nest, e.g. backend/net",
 	termPlaceholder: "e.g. event sourcing",
 	glossPlaceholder: "Say what it means in one or two sentences",

package/lib/core/dictionary.js

@@ -966,6 +966,73 @@ function summarize(state) {
 	return { total: live.length, explained, unexplained: live.length - explained, pinned };
 }
 
+/**
+ * Move a group — and everything under it — to another path.
+ *
+ * Renaming and moving are the same act, because a group IS a path: renaming `backend` to `服务端` and moving
+ * `net` out of `backend` into `infra` are both "these entries live somewhere else now". One primitive, two
+ * names in the UI, so the two cannot drift apart.
+ *
+ * Each entry is moved through {@link editEntry}, so each carries the stamped decision (`groupAt`) a merge
+ * weighs — a bulk move is not an exception to "a move is a decision".
+ *
+ * Refused: an empty target, a target inside the group being moved (which would put it inside itself), and a
+ * target that leaves everything where it is. Renaming ONTO an existing group is allowed and merges the two,
+ * which is what a reader asking for it means.
+ *
+ * @param state - the current document.
+ * @param from - the path to move.
+ * @param to - the path to move it to.
+ * @param options - `now` overrides the timestamps.
+ * @returns `{ state, moved, error }`.
+ */
+function renameGroup(state, from, to, options) {
+	const source = typeof from === "string" ? from.replace(/^\/+|\/+$/g, "") : "";
+	const target = typeof to === "string" ? to.replace(/^\/+|\/+$/g, "") : "";
+	if (source === "") return { state, moved: 0, error: "no-group" };
+	if (target === "") return { state, moved: 0, error: "no-name" };
+	if (target === source) return { state, moved: 0, error: "same" };
+	if (target.startsWith(`${source}/`)) return { state, moved: 0, error: "into-itself" };
+	const now = options?.now ?? Date.now();
+	let next = state;
+	let moved = 0;
+	let stamp = now;
+	for (const entry of state.entries.filter((each) => each.deletedAt === 0 && (each.group === source || each.group.startsWith(`${source}/`)))) {
+		stamp += 1;
+		const rest = entry.group === source ? "" : entry.group.slice(source.length + 1);
+		next = editEntry(next, entry.term, { group: rest === "" ? target : `${target}/${rest}` }, { now: stamp }).state;
+		moved += 1;
+	}
+	return { state: next, moved, error: null };
+}
+
+/**
+ * Delete a group: every entry under it goes to the deleted list.
+ *
+ * Soft, like every other deletion here — the tombstones make it reversible from 「已删除」, and they are also
+ * what stops a passing pack from putting the terms straight back. A group therefore disappears when the last
+ * entry in it does, which is the same rule that made it appear.
+ *
+ * @param state - the current document.
+ * @param from - the path to empty.
+ * @param options - `now` overrides the timestamps.
+ * @returns `{ state, removed, error }`.
+ */
+function deleteGroup(state, from, options) {
+	const source = typeof from === "string" ? from.replace(/^\/+|\/+$/g, "") : "";
+	if (source === "") return { state, removed: 0, error: "no-group" };
+	const now = options?.now ?? Date.now();
+	let next = state;
+	let removed = 0;
+	let stamp = now;
+	for (const entry of state.entries.filter((each) => each.deletedAt === 0 && (each.group === source || each.group.startsWith(`${source}/`)))) {
+		stamp += 1;
+		next = removeEntry(next, entry.id, { now: stamp }).state;
+		removed += 1;
+	}
+	return { state: next, removed, error: null };
+}
+
 /**
  * The groups immediately inside one path, with how many entries each holds.
  *
@@ -973,14 +1040,32 @@ function summarize(state) {
  * that child, however deep. A group exists as long as something is in it — there is no separate list of
  * empty groups to keep in step with the entries, which is the trade this makes deliberately.
  *
+ * Each group also carries a SAMPLE of the terms inside it. A folder row with only a name and a count is a
+ * row of empty space next to entries full of text — and a preview answers the question the row raises
+ * without making the reader open it to find out.
+ *
  * @param entries - every live entry.
  * @param prefix - the path to look inside, `""` for the top level.
- * @returns `[{ group, name, count }]`, alphabetical.
+ * @returns `[{ group, name, count, sample }]`, alphabetical.
+ */
+/**
+ * How many terms a group's preview names before it stops.
+ *
+ * Three: enough to say what kind of thing is in there, few enough that the line stays one line in a
+ * multi-column layout.
  */
+const GROUP_SAMPLE = 3;
+
 function groupsIn(entries, prefix) {
 	const base = prefix === undefined || prefix === null ? "" : String(prefix);
 	const counts = new Map();
-	for (const entry of Array.isArray(entries) ? entries : []) {
+	const samples = new Map();
+	// Newest first, the order the list itself uses, so the preview is the top of what you would see inside.
+	const ordered = (Array.isArray(entries) ? entries : [])
+		.filter((entry) => (entry?.deletedAt ?? 0) === 0 && typeof entry?.term === "string" && entry.term !== "")
+		.slice()
+		.sort((left, right) => (right.createdAt ?? 0) - (left.createdAt ?? 0) || left.term.localeCompare(right.term));
+	for (const entry of ordered) {
 		if ((entry?.deletedAt ?? 0) !== 0) continue;
 		const group = typeof entry?.group === "string" ? entry.group : "";
 		if (group === "" || group === base) continue;
@@ -990,9 +1075,12 @@ function groupsIn(entries, prefix) {
 		if (inside === null || inside === "") continue;
 		const name = inside.split("/")[0];
 		counts.set(name, (counts.get(name) ?? 0) + 1);
+		const sample = samples.get(name) ?? [];
+		if (sample.length < GROUP_SAMPLE) sample.push(entry.term);
+		samples.set(name, sample);
 	}
 	return [...counts.entries()]
-		.map(([name, count]) => ({ group: base === "" ? name : `${base}/${name}`, name, count }))
+		.map(([name, count]) => ({ group: base === "" ? name : `${base}/${name}`, name, count, sample: samples.get(name) ?? [] }))
 		.sort((left, right) => left.name.localeCompare(right.name));
 }
 
@@ -1171,6 +1259,8 @@ module.exports = {
 	upsertEntry,
 	editEntry,
 	restoreEntry,
+	renameGroup,
+	deleteGroup,
 	recordSighting,
 	removeEntry,
 	reviveEntry,

package/lib/core/hover.js

@@ -199,6 +199,45 @@ function createHoverLayer(options) {
 		return null;
 	}
 
+	/**
+	 * How far left of the caret a pointer may still count as being on the text.
+	 *
+	 * The space before a word is enough: landing in it resolves the caret to the word's own start, and a
+	 * reader aiming at the first letter often lands there. A paragraph's left margin is tens of pixels, which
+	 * is what this has to reject.
+	 */
+	const LEFT_TOLERANCE_PX = 8;
+
+	/**
+	 * Whether the caret a point resolved to actually sits at that point.
+	 *
+	 * `caretRangeFromPoint` CLAMPS horizontally: a point in the left margin of a line resolves to the line's
+	 * start, offset 0. When a term begins that line, offset 0 IS that term — so every point from the panel's
+	 * left edge to the first character read as "on the term", and the card opened from anywhere in the margin,
+	 * with a click to match. That is how this was reported.
+	 *
+	 * The caret's own rectangle is the live proof of where the text is: it is measured from the document at
+	 * this instant, so unlike a block snapshot it cannot go stale. One measurement per event, and only once a
+	 * caret has been found at all.
+	 *
+	 * @param x - viewport x of the pointer.
+	 * @param caret - the Range the point resolved to.
+	 * @returns true when the caret is at the pointer rather than clamped to the start of a line.
+	 */
+	function caretIsAt(x, caret) {
+		let rect = null;
+		try {
+			rect = typeof caret?.getBoundingClientRect === "function" ? caret.getBoundingClientRect() : null;
+		} catch (error) {
+			rect = null;
+		}
+		// A browser (or a fixture) that cannot answer is trusted: refusing every hover because one optional
+		// measurement is missing would be a worse failure than the one being fixed. An all-zero rectangle says
+		// the same thing in another shape — a detached or not-yet-laid-out range.
+		if (rect === null || (rect.left === 0 && rect.top === 0 && rect.width === 0 && rect.height === 0)) return true;
+		return rect.left <= x + LEFT_TOLERANCE_PX;
+	}
+
 	/**
 	 * The marked occurrence under a point.
 	 *
@@ -213,6 +252,7 @@ function createHoverLayer(options) {
 	function matchAt(x, y) {
 		const caret = caretAt(x, y);
 		if (caret === null) return null;
+		if (!caretIsAt(x, caret)) return null;
 		const at = resolveCaret(caret, doc);
 		if (at === null) return null;
 		let best = null;

package/lib/core/store.js

@@ -201,6 +201,29 @@ function createDictionaryStore(options) {
 			return result.entry;
 		},
 
+		/**
+		 * Move a group, and everything under it, to another path.
+		 * @param from - the path to move.
+		 * @param to - the path to move it to.
+		 * @returns a promise resolving to `{ moved, error }`.
+		 */
+		async renameGroup(from, to) {
+			const result = dictionary.renameGroup(state, from, to, { now: now() });
+			if (result.moved > 0) await commit(result.state);
+			return { moved: result.moved, error: result.error };
+		},
+
+		/**
+		 * Delete a group by deleting everything inside it, which is the only way a group can be deleted.
+		 * @param from - the path to empty.
+		 * @returns a promise resolving to `{ removed, error }`.
+		 */
+		async deleteGroup(from) {
+			const result = dictionary.deleteGroup(state, from, { now: now() });
+			if (result.removed > 0) await commit(result.state);
+			return { removed: result.removed, error: result.error };
+		},
+
 		/**
 		 * Bring a deleted term back, as an explicit act.
 		 *

package/lib/core/styles.js

@@ -133,6 +133,8 @@ const applyStyles = {
 	/** The group row's own bits: the mark that says "not an entry", and the chevron that says "opens". */
 	groupIcon: { display: "inline-flex", alignItems: "center", color: "var(--dsw-alias-label-secondary)" },
 	groupEnter: { color: "var(--dsw-alias-label-tertiary)", fontSize: "14px", lineHeight: 1 },
+	/** One line saying what is inside a group, so the card is not a name over a blank space. */
+	groupPreview: { margin: 0, fontSize: "12px", lineHeight: 1.5, color: "var(--dsw-alias-label-tertiary)", overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" },
 	/**
 	 * The row's action toolbar: the second line, always.
 	 *

package/lib/core/views.js

@@ -1623,6 +1623,13 @@ function DictionaryPanel(props) {
 	 * because you looked at it — so it is panel state, next to the search box and the tab.
 	 */
 	const [group, setGroup] = React.useState("");
+	/**
+	 * The group being renamed or moved, as `{ group, value }`, or null.
+	 *
+	 * An inline form rather than `prompt()`: Electron does not implement `prompt`, so a rename dialog
+	 * built on it would do nothing at all in the app this plugin runs in.
+	 */
+	const [renaming, setRenaming] = React.useState(null);
 	const visible = React.useMemo(() => store.list(query, filter, group), [view, query, filter, group]);
 	/**
 	 * The groups directly inside the current one, each with how many entries it holds.
@@ -1665,6 +1672,43 @@ function DictionaryPanel(props) {
 		return moved;
 	};
 
+	/**
+	 * Rename or move a group, and follow it if the panel was standing inside it.
+	 *
+	 * Following is the point: a reader who renames the folder they are in must still be looking at it
+	 * afterwards, not dropped back at the top wondering where it went.
+	 */
+	const commitRename = async () => {
+		if (renaming === null) return;
+		const result = await store.renameGroup(renaming.group, renaming.value);
+		if (result.error !== null) {
+			props.setToast?.(t(`groupError_${result.error}`));
+			return;
+		}
+		const target = renaming.value.replace(/^\/+|\/+$/g, "");
+		if (group === renaming.group || group.startsWith(`${renaming.group}/`)) {
+			setGroup(group === renaming.group ? target : `${target}${group.slice(renaming.group.length)}`);
+		}
+		setRenaming(null);
+		props.setToast?.(t("groupRenamed", { count: String(result.moved) }));
+	};
+
+	/**
+	 * Delete a group by deleting what is in it, after saying how much that is.
+	 *
+	 * The entries go to 「已删除」 rather than away, so this is reversible — and the count is in the
+	 * question, because "delete this group?" and "delete 12 entries?" are different offers.
+	 */
+	const removeGroup = async (sub) => {
+		if (globalThis.confirm?.(t("groupDeleteConfirm", { name: sub.name, count: String(sub.count) })) !== true) return;
+		const result = await store.deleteGroup(sub.group);
+		if (result.error !== null) {
+			props.setToast?.(t(`groupError_${result.error}`));
+			return;
+		}
+		props.setToast?.(t("groupDeleted", { count: String(result.removed) }));
+	};
+
 	/** Open the editor for a blank entry, prefilled from an optional term. */
 	const startCreate = (term = "", context = "") => {
 		setEditing({
@@ -2198,6 +2242,24 @@ function DictionaryPanel(props) {
 			// row. A breadcrumb says where you are and is the way back up, because a directory you can only
 			// enter is a trap.
 			[
+				renaming === null ? null : h(
+					"div",
+					{ style: { ...applyStyles.transferRow, gridColumn: "1 / -1" }, "data-term-group-form": renaming.group },
+					h("span", { style: applyStyles.fieldLabel }, t("groupRenameTo")),
+					h("input", {
+						type: "text",
+						value: renaming.value,
+						"aria-label": t("groupRename"),
+						onChange: (event) => setRenaming({ ...renaming, value: event.target.value }),
+						onKeyDown: (event) => {
+							if (event.key === "Enter") void commitRename();
+							if (event.key === "Escape") setRenaming(null);
+						},
+						style: { ...applyStyles.input, maxWidth: "18em" }
+					}),
+					h(Button, { label: t("groupRenameApply"), onClick: () => void commitRename() }, t("groupRenameApply")),
+					h(Button, { label: t("cancel"), onClick: () => setRenaming(null) }, t("cancel"))
+				),
 				group === "" ? null : h(
 					"div",
 					{ style: { ...applyStyles.breadcrumb, gridColumn: "1 / -1" }, "data-term-breadcrumb": group },
@@ -2227,16 +2289,19 @@ function DictionaryPanel(props) {
 						"article",
 						{
 						key: `group:${sub.group}`,
-						// Its own height, not the track's: a group has no body text, so stretching it to match a
-						// three-line entry would leave an empty box the size of the entry — which is what it looked
-						// like. Equal KIND of row is the point; equal height only reads as equal among rows with text.
-						style: { ...applyStyles.row, alignSelf: "start" },
+						// It fills its row again, now that the height carries something: with the preview below, the
+						// space that used to be emptiness is the first thing you would see on opening it.
+						style: applyStyles.row,
 						"data-term-group": sub.group,
 						// The WHOLE row opens the group, exactly as the whole row of an entry opens the entry.
 						// Only the label being live is what "the group cannot be clicked into" meant: a reader
 						// clicks the row, the same gesture that works one line below, and nothing happened.
 						// The label stays a button so it is reachable by keyboard and named for a screen reader.
-						onClick: () => setGroup(sub.group)
+						onClick: (event) => {
+							// The buttons inside keep their own meaning, exactly as they do on an entry row.
+							if (typeof event?.target?.closest === "function" && event.target.closest("button") !== null) return;
+							setGroup(sub.group);
+						}
 					},
 						h("div", { style: applyStyles.rowHead },
 							h("div", { style: applyStyles.groupIcon, "aria-hidden": "true" }, Icons.folder(14)),
@@ -2249,6 +2314,24 @@ function DictionaryPanel(props) {
 							h("span", { style: applyStyles.badge }, t("groupCount", { count: String(sub.count) })),
 							h("span", { style: applyStyles.spacer }),
 							h("span", { style: applyStyles.groupEnter, "aria-hidden": "true" }, "›")
+						),
+						// The same shape an entry row has: a title line, a line of actions, then the body.
+						h(
+							"div",
+							{ style: applyStyles.rowActions, "data-term-group-actions": sub.group },
+							h(IconButton, { title: t("groupRename"), onClick: () => setRenaming({ group: sub.group, value: sub.group }) }, Icons.edit(13)),
+							h(IconButton, { title: t("groupDelete"), onClick: () => void removeGroup(sub) }, Icons.trash(13))
+						),
+						// What is inside, in one line: the row stops being a name over a blank card.
+						h(
+							"p",
+							{ style: applyStyles.groupPreview, "data-term-group-sample": sub.group },
+							[
+								sub.sample.join(t("groupSampleJoin")),
+								sub.count > sub.sample.length ? t("groupSampleMore", { count: String(sub.count - sub.sample.length) }) : ""
+							]
+								.filter((part) => part !== "")
+								.join("")
 						)
 					)
 				),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-term-dictionary",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "术语词典：自动识别对话中的生僻术语并建立词条，左侧插件区提供词典面板。已收录的词在回复中被划出，鼠标靠近显示简短解释，点击进入词典对应词条；选中词句可一键添加词条。",
   "icon": "./icon.svg",
   "keywords": [