dsh-vscode-mode 0.5.3 → 0.6.0

package/src/client/dap/variableTree.ts

@@ -0,0 +1,62 @@
+/**
+ * dsh-vscode-mode client — DAP 变量树纯函数。
+ * 把 DAP variablesReference 缓存展平成可渲染 sibling rows，避免把子行嵌套进父级
+ * 横向 flex 行导致变量重叠；同时限制递归深度与总行数，保护侧栏性能。
+ * 作者 ddj 2026年09月29号
+ */
+
+/** DAP 变量最小视图。 */
+export interface VariableLike {
+  name: string
+  value: string
+  type?: string
+  ref: number
+}
+
+/** 展平后的变量行。 */
+export interface VariableRow {
+  key: string
+  variable: VariableLike
+  depth: number
+}
+
+/** 展平选项。 */
+export interface VariableTreeOptions {
+  maxRows?: number
+  maxDepth?: number
+}
+
+/**
+ * 将变量树展平为 sibling rows；循环 ref 只展开一次，避免异常适配器数据造成递归。
+ * @author ddj 2026年09月29号
+ * @param roots 根变量
+ * @param expanded 已展开的 variablesReference
+ * @param cache ref → 子变量缓存
+ * @param options 行数/深度上限
+ */
+export function flattenVariableRows(
+  roots: readonly VariableLike[],
+  expanded: ReadonlySet<number>,
+  cache: ReadonlyMap<number, readonly VariableLike[]>,
+  options: VariableTreeOptions = {},
+): VariableRow[] {
+  const rows: VariableRow[] = []
+  const maxRows = options.maxRows ?? 1000
+  const maxDepth = options.maxDepth ?? 32
+  const walk = (items: readonly VariableLike[], depth: number, ancestry: ReadonlySet<number>, prefix: string): void => {
+    if (depth > maxDepth || rows.length >= maxRows) return
+    for (let index = 0; index < items.length && rows.length < maxRows; index += 1) {
+      const variable = items[index]
+      const key = prefix + '/' + index + ':' + variable.name
+      rows.push({ key, variable, depth })
+      if (variable.ref <= 0 || !expanded.has(variable.ref) || ancestry.has(variable.ref)) continue
+      const children = cache.get(variable.ref)
+      if (!children?.length) continue
+      const nextAncestry = new Set(ancestry)
+      nextAncestry.add(variable.ref)
+      walk(children, depth + 1, nextAncestry, key)
+    }
+  }
+  walk(roots, 0, new Set(), 'root')
+  return rows
+}

package/src/client/index.ts

@@ -41,6 +41,7 @@ import { createFilePanel } from './sidebar/panels/index.js'
 import { createSearchPanel } from './sidebar/panels/index.js'
 import { createRulesPanel } from './sidebar/panels/index.js'
 import { createSvnPanel } from './sidebar/panels/index.js'
+import { createDebugPanel } from './sidebar/panels/index.js'
 import { createTreeMenuRegistry } from './sidebar/contextMenu.js'
 import { createDefaultFileMenuItems } from './sidebar/menuItems.js'
 import { createOutlinePanel } from './outline/index.js'
@@ -54,8 +55,10 @@ import { editorLimitApply } from './editorLimit.js'
 import { log } from './log.js'
 import { setupLsp, setSession, disposeLsp } from './monaco/lsp/index.js'
 import { disposeSnippets } from './snippets/provider.js'
+import { disposeLaunchJson } from './dap/launchSnippetProvider.js'
 import { disposeAiInline } from './ai/inlineProvider.js'
 import { readSessionScope, subscribeScope } from './sessionScope.js'
+import { dapStore } from './dap/store.js'
 import type { CompatAdapter } from '../shared/compat.js'
 
 // ⚠️ inject 只列必需服务：webUiSettings 是 @linxin666/dsh-client-ui-web-ui-settings 提供的
@@ -194,6 +197,11 @@ export function apply(ctx: any): void {
   ctx.effect(() => sidebarPanels.register(createRulesPanel()), 'vscode-mode: sidebar panel rules')
   // SVN 变更面板：活动栏「SVN 变更」页签（工作副本状态列表；visible 守卫使非 SVN 工作区不出现）
   ctx.effect(() => sidebarPanels.register(createSvnPanel()), 'vscode-mode: sidebar panel svn')
+  // 调试面板：活动栏「调试」页签（VS Code 调试视图四段布局 + REPL；DAP 桥接）
+  ctx.effect(() => sidebarPanels.register(createDebugPanel()), 'vscode-mode: sidebar panel debug')
+  // 客户端（重）装配对账：host 的 DapSession 常驻，而本模块状态随刷新/HMR 归零，
+  // 不对账则调试面板与暂停态 hover 静默失效（见 dapStore.resync）。
+  void dapStore.resync()
   // 文件右键菜单项注册表（对外 provide，供本插件/第三方注册；内置「在文件浏览器中打开」）
   const fileMenuItems = createTreeMenuRegistry()
   ctx.provide('edrvFileContextMenuItems', fileMenuItems)
@@ -448,6 +456,7 @@ export function apply(ctx: any): void {
   // 不做会导致重载后重复注册（补全/跳转/hover 各翻倍）与陈旧开关残留。
   ctx.effect(() => () => {
     try { disposeSnippets() } catch { /* 卸载异常不得阻断其余清理 */ }
+    try { disposeLaunchJson() } catch { /* 同上 */ }
     try { disposeAiInline() } catch { /* 同上 */ }
     try { disposeLsp() } catch { /* 同上 */ }
   }, 'vscode-mode: monaco providers teardown')

package/src/client/monaco/lsp/index.ts

@@ -6,6 +6,9 @@
  * 作者 ddj 2026-08-27
  */
 import { registerLspProviders, disposeLspProviders, hideReferencesOverlay } from './providers.js'
+import { registerDapHover, disposeDapHover } from '../../dap/hover.js'
+import { installHoverTree, disposeHoverTree } from '../../dap/hoverTree.js'
+import { installHoverMode, disposeHoverMode } from '../../dap/hoverMode.js'
 import { setLspSession, refreshStatus, lspStatusFor, onLspProgress, bindLspSession } from './lspClient.js'
 
 let monacoRef = null
@@ -19,7 +22,16 @@ const LSP_SESSION_GLOBAL = '__edrvLspSessionUnbind__'
 /** Monaco 加载后装配（幂等；重复调用仅刷新会话）。 */
 export function setupLsp(monaco) {
   monacoRef = monaco
+  // 注册顺序决定同分 provider 的 ordinal：LanguageFeatureRegistry._compareByScoreAndTime 对
+  // 同分选择器按 _time 倒序（后注册者排前），hover 部件再按 ordinal 升序渲染 —— 因此 DAP
+  // 必须**最后**注册，暂停态的调试值行才会稳定渲染在 LSP 文档行之前；反序会让调试值被
+  // LSP 长文档挤到浮窗下方（超出 maxHeight 需滚动，等同看不到）。
   registerLspProviders(monaco)
+  registerDapHover(monaco)
+  // hover 变量树的 DOM 绑定（观察 hover 面板插入/重渲染；幂等）
+  installHoverTree()
+  // Alt 跟踪：暂停态默认调试值浮窗、按住 Alt 切 LSP 信息（对齐 CodeBuddy）
+  installHoverMode()
   // 会话广播订阅只装一次：跨重载时上一代已订阅（取消函数落 window，模块级状态会复位），
   // 只判 sessionBound 会重复订阅 → 同一 LSP 会话事件被处理多次。
   const host = /* @__PURE__ */ (typeof window === 'undefined' ? undefined : window)
@@ -52,6 +64,9 @@ export function disposeLspOverlay() {
  */
 export function disposeLsp() {
   disposeLspProviders()
+  disposeDapHover()
+  disposeHoverTree()
+  disposeHoverMode()
   const unbind = sessionUnbind
   if (typeof unbind === 'function') {
     try { unbind() } catch { /* 已解绑 */ }

package/src/client/monaco/lsp/providers.ts

@@ -136,6 +136,8 @@ export function registerLspProviders(monaco) {
     }),
     monaco.languages.registerHoverProvider(LSP_LANGS, {
       provideHover: async (model, position, token) => {
+        // 暂停态的 LSP 行由调试 hover 层默认隐藏、按住 Alt 时显示（见 dap/hoverTree.ts），
+        // 因此这里照常返回内容，不再按位置让位。
         const path = pathOfModel(model)
         if (!path) return null
         const hover = await fetchHover(path, model.getValue(), position)

package/src/client/monaco/theme.ts

@@ -137,6 +137,14 @@ const DARK_COLORS = {
   'scrollbarSlider.background': '#79797966',
   'scrollbarSlider.hoverBackground': '#646464b3',
   'scrollbarSlider.activeBackground': '#bfbfbf66',
+  // 差异视图色块（本仓库 vendored Monaco 无 .line-insert 静态背景规则，靠主题键保证；
+  // 色相取自研差异 UI 同源：绿 #0f9d58 / 红 #d9534f，alpha 提到肉眼可辨）
+  'diffEditor.insertedLineBackground': '#0f9d5830',
+  'diffEditor.removedLineBackground': '#d9534f2e',
+  'diffEditor.insertedTextBackground': '#0f9d5833',
+  'diffEditor.removedTextBackground': '#d9534f40',
+  'diffEditorGutter.insertedLineBackground': '#0f9d5859',
+  'diffEditorGutter.removedLineBackground': '#d9534f59',
 }
 
 const LIGHT_COLORS = {
@@ -157,6 +165,13 @@ const LIGHT_COLORS = {
   'scrollbarSlider.background': '#64646466',
   'scrollbarSlider.hoverBackground': '#646464b3',
   'scrollbarSlider.activeBackground': '#00000099',
+  // 差异视图色块（同上：主题键保证整行背景可见；色相/透明度与暗色一致）
+  'diffEditor.insertedLineBackground': '#0f9d5830',
+  'diffEditor.removedLineBackground': '#d9534f2e',
+  'diffEditor.insertedTextBackground': '#0f9d5833',
+  'diffEditor.removedTextBackground': '#d9534f40',
+  'diffEditorGutter.insertedLineBackground': '#0f9d5859',
+  'diffEditorGutter.removedLineBackground': '#d9534f59',
 }
 
 /**