dsh-vscode-mode 0.3.1 → 0.3.2

package/src/client/tabActions.ts

@@ -0,0 +1,326 @@
+/**
+ * dsh-vscode-mode client — 文件页签操作纯函数（关闭族 / 固定 / 路径推导）。
+ * 页签状态是 EditorView 的 `{ path, pinned }[]`；本模块不触 React/DOM，可 node 单测，
+ * 菜单动作（tabMenu）与编辑器（EditorView）共用同一份语义，避免规则散落两处。
+ *
+ * 核心约定 —— **固定 = 保护**：
+ * 「关闭其他 / 关闭右侧 / 关闭已保存 / 全部关闭」一律不关固定页签；
+ * 只有单项「关闭」可以显式关掉一个固定页签（用户明确点了它）。
+ *
+ * 关闭后的活动页签：原活动页签未被关 → 不变；被关 → 右侧优先、否则左侧末位（VS Code 行为）。
+ * 作者 ddj 2026年09月11号
+ */
+
+/** 页签的最小形状（EditorView 持有超集）。 */
+export interface TabLike {
+  path: string
+  pinned?: boolean
+}
+
+/** 关闭操作结果（tabs 未变化时返回原引用，React 可跳过重渲染）。 */
+export interface CloseResult {
+  tabs: TabLike[]
+  active: string | null
+}
+
+// --region 关闭族
+
+/**
+ * 关闭指定集合：活动页签被关时按「右侧优先、否则左侧末位」补位。
+ * @author ddj 2026年09月11号
+ * @param tabs 当前页签
+ * @param closing 待关闭路径集合
+ * @param active 当前活动页签路径
+ * @returns 剩余页签与新的活动页签
+ */
+export function applyClose(tabs: TabLike[], closing: Set<string>, active: string | null): CloseResult {
+  const remaining = tabs.filter((tab) => !closing.has(tab.path))
+  if (remaining.length === tabs.length) return { tabs, active }
+  if (active && !closing.has(active)) return { tabs: remaining, active }
+  return { tabs: remaining, active: pickNeighbor(tabs, remaining, active) }
+}
+
+/**
+ * 关闭其他：保留目标页签与全部固定页签。
+ * @author ddj 2026年09月11号
+ * @param tabs 当前页签
+ * @param target 保留的目标页签路径
+ * @param active 当前活动页签路径
+ * @returns 关闭结果
+ */
+export function closeOthers(tabs: TabLike[], target: string, active: string | null): CloseResult {
+  return applyClose(tabs, closingExcept(tabs, (tab) => tab.path === target || tab.pinned === true), active)
+}
+
+/**
+ * 关闭右侧：关闭目标之后、未被固定的页签。
+ * @author ddj 2026年09月11号
+ * @param tabs 当前页签
+ * @param target 基准页签路径（其右侧才关）
+ * @param active 当前活动页签路径
+ * @returns 关闭结果
+ */
+export function closeRight(tabs: TabLike[], target: string, active: string | null): CloseResult {
+  const at = tabs.findIndex((tab) => tab.path === target)
+  const closing = new Set<string>()
+  for (let i = at + 1; i > 0 && i < tabs.length; i += 1) {
+    if (tabs[i].pinned !== true) closing.add(tabs[i].path)
+  }
+  return applyClose(tabs, closing, active)
+}
+
+/**
+ * 关闭已保存：关闭未固定且无未保存修改的页签。
+ * @author ddj 2026年09月11号
+ * @param tabs 当前页签
+ * @param dirty 路径 → 是否有未保存修改
+ * @param active 当前活动页签路径
+ * @returns 关闭结果
+ */
+export function closeSaved(tabs: TabLike[], dirty: Record<string, boolean>, active: string | null): CloseResult {
+  return applyClose(tabs, closingExcept(tabs, (tab) => tab.pinned === true || dirty[tab.path] === true), active)
+}
+
+/**
+ * 全部关闭：仅关未固定页签（全部固定时无操作）。
+ * @author ddj 2026年09月11号
+ * @param tabs 当前页签
+ * @param active 当前活动页签路径
+ * @returns 关闭结果
+ */
+export function closeAll(tabs: TabLike[], active: string | null): CloseResult {
+  return applyClose(tabs, closingExcept(tabs, (tab) => tab.pinned === true), active)
+}
+
+/**
+ * 反选可关闭集合（保留 keep 命中的页签，其余进关闭集）。
+ * @author ddj 2026年09月11号
+ * @param tabs 当前页签
+ * @param keep 保留判定
+ * @returns 待关闭路径集合
+ */
+function closingExcept(tabs: TabLike[], keep: (tab: TabLike) => boolean): Set<string> {
+  const closing = new Set<string>()
+  for (const tab of tabs) if (!keep(tab)) closing.add(tab.path)
+  return closing
+}
+
+/**
+ * 选补位页签：先向右找最近的存活页签，再向左找，都没有则取剩余首个。
+ * @author ddj 2026年09月11号
+ * @param tabs 关闭前的页签（用于取原索引）
+ * @param remaining 关闭后剩余的页签
+ * @param active 被关掉的活动页签路径
+ * @returns 补位页签路径；无剩余返回 null
+ */
+function pickNeighbor(tabs: TabLike[], remaining: TabLike[], active: string | null): string | null {
+  const first = remaining[0]
+  if (!first) return null
+  const at = tabs.findIndex((tab) => tab.path === active)
+  if (at < 0) return first.path
+  const alive = new Set(remaining.map((tab) => tab.path))
+  for (let i = at + 1; i < tabs.length; i += 1) if (alive.has(tabs[i].path)) return tabs[i].path
+  for (let i = at - 1; i >= 0; i -= 1) if (alive.has(tabs[i].path)) return tabs[i].path
+  return first.path
+}
+// --endregion
+
+// --region 固定与插入
+
+/**
+ * 切换页签固定态：固定页签整体前移（两侧各自保持相对顺序）。
+ * @author ddj 2026年09月11号
+ * @param tabs 当前页签
+ * @param target 目标页签路径
+ * @returns 重排后的页签（目标不存在时原样返回）
+ */
+export function togglePin(tabs: TabLike[], target: string): TabLike[] {
+  if (!tabs.some((tab) => tab.path === target)) return tabs
+  const next = tabs.map((tab) => (
+    tab.path === target ? { path: tab.path, pinned: tab.pinned !== true } : tab
+  ))
+  return pinnedFirst(next)
+}
+
+/**
+ * 新增页签：已存在则原样返回；否则插到最后一个固定页签之后。
+ * @author ddj 2026年09月11号
+ * @param tabs 当前页签
+ * @param path 新页签路径
+ * @returns 新页签数组
+ */
+export function insertTab(tabs: TabLike[], path: string): TabLike[] {
+  if (tabs.some((tab) => tab.path === path)) return tabs
+  // 缺省追加到末尾；存在固定页签时插到最后一个固定页签之后
+  let at = tabs.length
+  for (let i = tabs.length - 1; i >= 0; i -= 1) {
+    if (tabs[i].pinned !== true) continue
+    at = i + 1
+    break
+  }
+  return tabs.slice(0, at).concat([{ path }], tabs.slice(at))
+}
+
+/**
+ * 固定分区：固定页签在前，两侧各自保持原相对顺序。
+ * @author ddj 2026年09月11号
+ * @param tabs 页签
+ * @returns 重排后的页签
+ */
+function pinnedFirst(tabs: TabLike[]): TabLike[] {
+  return tabs.filter(isPinned).concat(tabs.filter((tab) => !isPinned(tab)))
+}
+
+/**
+ * 是否固定页签。
+ * @author ddj 2026年09月11号
+ * @param tab 页签
+ * @returns 是否固定
+ */
+function isPinned(tab: TabLike): boolean {
+  return tab.pinned === true
+}
+
+/**
+ * 归一化持久化的页签数据：兼容旧版 `string[]`、去重、固定分区。
+ * 损坏项（非字符串/非对象/无 path）直接丢弃。
+ * @author ddj 2026年09月11号
+ * @param raw localStorage 解析结果（任意形状）
+ * @returns 归一化后的页签数组
+ */
+export function normalizeTabs(raw: unknown): TabLike[] {
+  if (!Array.isArray(raw)) return []
+  const seen = new Set<string>()
+  const out: TabLike[] = []
+  for (const item of raw) {
+    const tab = tabOf(item)
+    if (!tab || seen.has(tab.path)) continue
+    seen.add(tab.path)
+    out.push(tab)
+  }
+  return pinnedFirst(out)
+}
+
+/**
+ * 解释单条持久化页签：字符串 = 路径（旧版），对象取 path/pinned。
+ * @author ddj 2026年09月11号
+ * @param item 原始条目
+ * @returns 页签或 null（无法解释）
+ */
+function tabOf(item: unknown): TabLike | null {
+  if (typeof item === 'string') return item ? { path: item } : null
+  if (!item || typeof item !== 'object') return null
+  const raw = item as { path?: unknown; pinned?: unknown }
+  if (typeof raw.path !== 'string' || !raw.path) return null
+  return raw.pinned === true ? { path: raw.path, pinned: true } : { path: raw.path }
+}
+
+/**
+ * 选活动页签：恢复值仍存在则用它，否则取首个（无页签返回 null）。
+ * @author ddj 2026年09月11号
+ * @param tabs 页签
+ * @param wanted 持久化的活动路径
+ * @returns 活动页签路径
+ */
+export function pickActive(tabs: TabLike[], wanted: unknown): string | null {
+  const first = tabs[0]
+  if (!first) return null
+  if (typeof wanted === 'string' && tabs.some((tab) => tab.path === wanted)) return wanted
+  return first.path
+}
+// --endregion
+
+// --region 路径推导
+
+/** Windows 盘符 / UNC / POSIX 根：视为工作区外的绝对路径。 */
+const ABSOLUTE_RE = /^(?:[a-z]:[\\/]|\\\\|\/)/i
+
+/**
+ * 是否绝对路径（工作区外）。
+ * @author ddj 2026年09月11号
+ * @param path 路径
+ * @returns 是否绝对路径
+ */
+export function isAbsolutePath(path: string): boolean {
+  return ABSOLUTE_RE.test(String(path ?? ''))
+}
+
+/**
+ * 是否可在资源管理器视图中定位（工作区相对且不含 `..` 上跳段）。
+ * @author ddj 2026年09月11号
+ * @param path 路径
+ * @returns 是否可定位
+ */
+export function isTreeRevealable(path: string): boolean {
+  const text = String(path ?? '').trim()
+  if (!text || isAbsolutePath(text)) return false
+  return !text.replace(/\\/g, '/').split('/').includes('..')
+}
+
+/**
+ * 相对路径：cwd 内路径去掉工作区前缀；工作区外/无 cwd 回退规范化原路径。
+ * @author ddj 2026年09月11号
+ * @param path 路径
+ * @param cwd 会话工作区目录（可空）
+ * @returns 展示/复制用的相对路径
+ */
+export function relativeOf(path: string, cwd?: string | null): string {
+  const target = normalizeSlashes(path)
+  const base = normalizeSlashes(cwd).replace(/\/+$/, '')
+  if (base && target.toLowerCase().startsWith((base + '/').toLowerCase())) return target.slice(base.length + 1)
+  return target
+}
+
+/**
+ * 绝对路径：相对路径按 cwd 拼接；已是绝对路径或没有 cwd 时回退规范化原路径。
+ * @author ddj 2026年09月11号
+ * @param path 路径
+ * @param cwd 会话工作区目录（可空）
+ * @returns 展示/复制用的绝对路径
+ */
+export function absoluteOf(path: string, cwd?: string | null): string {
+  const target = normalizeSlashes(path)
+  if (isAbsolutePath(target)) return target
+  const base = normalizeSlashes(cwd).replace(/\/+$/, '')
+  return base ? base + '/' + target : target
+}
+
+/**
+ * 反斜杠归一为斜杠（页签/引用/剪贴板统一用正斜杠，与既有 mentionOf 口径一致）。
+ * @author ddj 2026年09月11号
+ * @param path 路径
+ * @returns 正斜杠路径
+ */
+function normalizeSlashes(path: string | null | undefined): string {
+  return String(path ?? '').replace(/\\/g, '/')
+}
+
+/**
+ * 文件路径的祖先目录（由浅到深）：`a/b/c.ts` → `['a', 'a/b']`。
+ * 根级文件、绝对路径与含 `..` 的路径返回空数组。
+ * @author ddj 2026年09月11号
+ * @param path 工作区相对路径
+ * @returns 祖先目录相对路径数组
+ */
+export function ancestorDirsOf(path: string): string[] {
+  if (!isTreeRevealable(path)) return []
+  const segs = normalizeSlashes(path).split('/').filter(Boolean)
+  const out: string[] = []
+  for (let i = 1; i < segs.length; i += 1) {
+    const prev = segs[i - 1]
+    out.push(out.length ? out[out.length - 1] + '/' + prev : prev)
+  }
+  return out
+}
+
+/**
+ * 文件名（页签/状态栏展示与 tooltip 用）。
+ * @author ddj 2026年09月11号
+ * @param path 路径
+ * @returns 末段文件名；空路径返回空串
+ */
+export function baseNameOf(path: string): string {
+  const text = normalizeSlashes(path)
+  return text.split('/').filter(Boolean).pop() ?? ''
+}
+// --endregion

package/src/client/tabMenu.ts

@@ -0,0 +1,107 @@
+/**
+ * dsh-vscode-mode client — 文件页签右键菜单模型（纯函数，可单测）。
+ * 菜单是「数据」而非 JSX：条目顺序、分组分隔线、禁用规则与键位提示全部在此收敛，
+ * EditorView 只把结果映射成 ContextMenu 的 entries 并派发动作。
+ *
+ * 与参考图（VS Code / CodeBuddy 页签右键菜单）的对齐口径：
+ * 保留其分组顺序（对话 / 关闭族 / 路径 / 定位 / 固定），**省略**本架构无法实现的
+ * 「向右拆分 / Split & Move / 移动到新窗口 / 复制到新窗口」（浏览器内单编辑器实例）。
+ * 只显示**真实已绑定**的键位；参考图里的两步弦（Ctrl+K W 等）引擎不支持，故不伪造。
+ *
+ * 「固定 = 保护」：关闭其他 / 关闭右侧 / 关闭已保存 / 全部关闭 一律不关固定页签，
+ * 故这些条目在「固定页签是唯一可关对象」时判定为禁用（与 tabActions 语义同源）。
+ * 作者 ddj 2026年09月11号
+ */
+import { closeAll, closeOthers, closeRight, closeSaved, isTreeRevealable, type TabLike } from './tabActions.js'
+
+/** 菜单构建输入（EditorView 每次打开菜单时按最新状态快照传入）。 */
+export interface TabMenuState {
+  /** 右键目标页签路径。 */
+  path: string
+  /** 当前全部页签。 */
+  tabs: TabLike[]
+  /** 当前活动页签路径。 */
+  active: string | null
+  /** 路径 → 是否有未保存修改。 */
+  dirty: Record<string, boolean>
+  /** 会话工作区目录（相对路径复制与「资源管理器视图中显示」用）。 */
+  cwd?: string | null
+  /** 是否有活动会话（复制/定位类动作依赖）。 */
+  hasSession: boolean
+  /** 「添加到对话」动作集是否可用。 */
+  canAddToConversation: boolean
+  /** 「关闭」项的键位提示（缺省无提示；由调用方读 chordOf 注入）。 */
+  closeChord?: string | null
+}
+
+/** 一条页签菜单项（ContextMenu 的展示形状 + 动作 id）。 */
+export interface TabMenuEntry {
+  id: string
+  label: string
+  /** 右侧键位提示（仅在真实绑定键位时出现）。 */
+  hint?: string
+  disabled?: boolean
+  danger?: boolean
+  /** 前置分隔线（分组的首条）。 */
+  separator?: boolean
+}
+
+/** 关闭族 id（EditorView 的动作表按 id 分派；导出便于测试与静态校验）。 */
+export const CLOSE_MENU_IDS = ['close', 'close-others', 'close-right', 'close-saved', 'close-all'] as const
+
+/** 本架构不支持的条目 id（参考图有、浏览器单编辑器实例无法实现）——显式登记以防误加。 */
+export const UNSUPPORTED_MENU_IDS = ['split-right', 'split-move', 'move-new-window', 'copy-new-window'] as const
+
+/**
+ * 构建页签右键菜单条目。
+ * @author ddj 2026年09月11号
+ * @param state 菜单状态快照
+ * @returns 菜单条目（已按参考图分组排序）
+ */
+export function buildTabMenu(state: TabMenuState): TabMenuEntry[] {
+  const { path, tabs, active, dirty, cwd, hasSession, canAddToConversation, closeChord } = state
+  const current = tabs.find((tab) => tab.path === path)
+  const pinned = current?.pinned === true
+  return [
+    {
+      id: 'add-to-conversation',
+      label: '添加到对话',
+      disabled: !(hasSession && canAddToConversation),
+    },
+    { id: 'close', label: '关闭', separator: true, ...(closeChord ? { hint: closeChord } : {}) },
+    { id: 'close-others', label: '关闭其他', disabled: nothingToClose(closeOthers(tabs, path, active), tabs) },
+    { id: 'close-right', label: '关闭右侧标签页', disabled: nothingToClose(closeRight(tabs, path, active), tabs) },
+    { id: 'close-saved', label: '关闭已保存', disabled: nothingToClose(closeSaved(tabs, dirty, active), tabs) },
+    { id: 'close-all', label: '全部关闭', disabled: nothingToClose(closeAll(tabs, active), tabs) },
+    { id: 'copy-path', label: '复制路径', separator: true },
+    { id: 'copy-relative-path', label: '复制相对路径', disabled: !hasCwd(cwd) },
+    { id: 'reveal-in-os', label: '在文件资源管理器中显示', separator: true, disabled: !hasSession },
+    { id: 'reveal-in-view', label: '在资源管理器视图中显示', disabled: !isTreeRevealable(path) },
+    {
+      id: 'toggle-pinned',
+      label: pinned ? '取消固定' : '固定',
+      separator: true,
+    },
+  ]
+}
+
+/**
+ * 关闭族是否无可关对象（结果页签数与关闭前一致 = 一个也没关掉）。
+ * @author ddj 2026年09月11号
+ * @param result 关闭结果
+ * @param tabs 关闭前的页签
+ * @returns 是否无可关对象
+ */
+function nothingToClose(result: { tabs: TabLike[] }, tabs: TabLike[]): boolean {
+  return result.tabs.length >= tabs.length
+}
+
+/**
+ * 是否有可用工作区目录（复制相对路径需要）。
+ * @author ddj 2026年09月11号
+ * @param cwd 会话工作区目录
+ * @returns 是否可用
+ */
+function hasCwd(cwd: string | null | undefined): boolean {
+  return typeof cwd === 'string' && cwd.trim() !== ''
+}

package/src/client/ui/ContextMenu.ts

@@ -9,7 +9,7 @@ import React from 'react'
 import { createPortal } from 'react-dom'
 import { clampMenuPosition } from './menuPosition.js'
 
-/** 单条菜单项（展示层形状；业务侧由 buildTreeMenu 映射而来）。 */
+/** 单条菜单项（展示层形状；业务侧由 buildTreeMenu / buildTabMenu 映射而来）。 */
 export interface ContextMenuEntry {
   id: string
   label: string
@@ -17,6 +17,8 @@ export interface ContextMenuEntry {
   disabled?: boolean
   /** 前置分隔线。 */
   separator?: boolean
+  /** 右侧提示文案（键位弦等；仅在真实绑定时传入，缺省不渲染）。 */
+  hint?: string
   onClick?: () => void
 }
 
@@ -27,10 +29,36 @@ export interface ContextMenuProps {
   onClose: () => void
 }
 
-/** 菜单估算宽高（clamp 防越出视口，与 EditorView menuPos 常量对齐）。 */
+/** 估算宽高（实测前的回退值；条目数变化大时以实测为准，见 useLayoutEffect）。 */
 const MENU_W = 224
 const MENU_H = 176
 
+/** 渲染行：分隔线或菜单项。 */
+export interface MenuRow {
+  kind: 'sep' | 'item'
+  entry: ContextMenuEntry
+}
+
+/**
+ * 把条目表展开为渲染行：`separator` 是**前置分隔线**，条目本身仍然渲染。
+ *
+ * ⚠️ 旧实现把 `separator` 当成「本条是分隔线」而 `continue` 跳过条目本身 ——
+ * 因历史调用方都没用过该字段，缺陷一直潜伏；页签菜单首次使用后表现为
+ * 「关闭 / 复制路径 / 在文件资源管理器中显示 / 固定」四条主条目整条消失。
+ * 首条带 separator 时不渲染分隔线（菜单顶部不应有横线，与参考图一致）。
+ * @author ddj 2026年09月11号
+ * @param entries 菜单项列表
+ * @returns 渲染行列表
+ */
+export function menuRows(entries: readonly ContextMenuEntry[]): MenuRow[] {
+  const rows: MenuRow[] = []
+  for (const entry of entries) {
+    if (entry.separator && rows.length) rows.push({ kind: 'sep', entry })
+    rows.push({ kind: 'item', entry })
+  }
+  return rows
+}
+
 /**
  * 浮动右键菜单。
  * @param props.x 视口 x 坐标
@@ -41,6 +69,8 @@ const MENU_H = 176
 export function ContextMenu(props: ContextMenuProps): React.ReactElement {
   const { x, y, entries, onClose } = props
   const menuRef = React.useRef<HTMLDivElement | null>(null)
+  // 实测菜单尺寸：页签菜单有 11 条 + 键位提示，估算常量会偏低导致底部条目越界不可达
+  const [size, setSize] = React.useState<{ w: number; h: number } | null>(null)
 
   React.useEffect(() => {
     const onKey = (e: KeyboardEvent): void => {
@@ -67,6 +97,16 @@ export function ContextMenu(props: ContextMenuProps): React.ReactElement {
     }
   }, [onClose])
 
+  // 首帧后量一次真实尺寸并据此定位：条目数/文案长度变化都不会越出视口下边界
+  React.useLayoutEffect(() => {
+    const el = menuRef.current
+    if (!el) return
+    const w = el.offsetWidth
+    const h = el.offsetHeight
+    if (!w || !h) return
+    setSize((prev) => (prev && prev.w === w && prev.h === h ? prev : { w, h }))
+  }, [entries])
+
   const safeX = Number.isFinite(x) ? x : 4
   const safeY = Number.isFinite(y) ? y : 4
   const position = clampMenuPosition(
@@ -74,16 +114,17 @@ export function ContextMenu(props: ContextMenuProps): React.ReactElement {
     safeY,
     window.innerWidth || 800,
     window.innerHeight || 600,
-    MENU_W,
-    MENU_H,
+    size?.w ?? MENU_W,
+    size?.h ?? MENU_H,
   )
 
   const children: React.ReactNode[] = []
-  for (const entry of entries) {
-    if (entry.separator) {
-      children.push(React.createElement('div', { key: 'sep-' + entry.id, className: 'edrv-ctxmenu-sep' }))
+  for (const row of menuRows(entries)) {
+    if (row.kind === 'sep') {
+      children.push(React.createElement('div', { key: 'sep-' + row.entry.id, className: 'edrv-ctxmenu-sep' }))
       continue
     }
+    const entry = row.entry
     const cls = 'edrv-ctxmenu-item'
       + (entry.danger ? ' edrv-ctxmenu-danger' : '')
       + (entry.disabled ? ' edrv-ctxmenu-disabled' : '')
@@ -91,13 +132,16 @@ export function ContextMenu(props: ContextMenuProps): React.ReactElement {
       key: entry.id,
       className: cls,
       disabled: entry.disabled,
+      title: entry.hint ? entry.label + ' (' + entry.hint + ')' : entry.label,
       onClick: () => {
         if (!entry.disabled) {
           entry.onClick?.()
           onClose()
         }
       },
-    }, entry.label))
+    },
+      React.createElement('span', { className: 'edrv-ctxmenu-label' }, entry.label),
+      entry.hint ? React.createElement('span', { className: 'edrv-ctxmenu-hint' }, entry.hint) : null))
   }
 
   const overlay = React.createElement('div', { 'data-edrv-view': '1' },