文件页(FileTree/TreePanel)
- Ctrl/Cmd 多选 + Shift 按可见行序连选(Esc/点空白/右键收敛),批量条支持复制路径、批量删除(共享 ConfirmDialog + 顺序 fsRemove)
- Git 变更着色:行名按状态上色 + M/A/D/U 徽标,目录按 dirHasChanges 着色,非仓库静默降级(数据来自共享 git 状态存储)
- 新建文件夹:fs.mkdir 路由 + mkdirWorkspaceEntry + 内联输入行(Enter/Esc/blur/IME 守卫)
- 性能:FileRow/DirRow memo(含反向验证)、搜索 hidden 停车不再卸载树、level 拉取世代守卫 + AbortController、fs.tree truncated 提示、use-dir-watch 入参 memo
- 拖拽上传视觉 token 化(硬编码色清零);可见性下传后隐藏页签停止轮询
- 右键「打开方式」改为复用 DSH 自带 open-in-app(宿主探测的关联应用 + 文件管理器显示)
文件变动页(changes/diff)
- 36px 头(宿主 SegmentedControl)+ 单一 ChangeRow + SectionHeader 分组 + 吸底提交条单状态行 + 历史独立空态
- 修掉:双份空态、暂存失败 unhandled rejection、手动刷新被丢、仓库切换刷新两次、worktree 清单缺 repoRoot、工作树被自动切走、预览持旧快照、恢复高度未 clamp、session ops 无谓轮询
- DiffPane/DiffTab 共用 use-git-diff;修掉 DiffPane 的 untracked 预览从不渲染
全局组件与宿主接入
- 新增 src/client/ui(IconButton/Chip/SectionHeader/Notice/ConfirmDialog/StatusBadge + 共享 git 状态存储)
- 新增 src/client/open-in-app.ts(宿主 open-in-app 客户端适配),删除自研 open-with 全链路与 open.external 路由
- 客户端 inject 补 remote / remote.session:缺声明时 ctx.get('remote').session 会抛出并把整个面板打成错误条(真实挂载 lane 抓到)
- 词典:+25 键 / -20 openWith* / -noChanges,20 份同步
验证:typecheck / lint / test(126 文件 1322 通过)/ build 全绿;
DSH_CMD='npx -y --package @deepseek-ai/dsh@0.1.7-rc.1 dsh' pnpm test:mount 7/7 通过(含 tab sweep 与 perf lane)
292 lines
12 KiB
TypeScript
292 lines
12 KiB
TypeScript
/**
|
|
* FileTree "open in app" menu (the host's own capability, replacing the
|
|
* plugin's removed open-with chain): a file row lists the host's registered
|
|
* applications — the default-application row first, then one row per app —
|
|
* followed by reveal-in-file-manager; a directory row lists the host's
|
|
* application catalogue plus reveal. Clicking a row hands the absolute path
|
|
* (plus the application id when one was chosen) to the injected handle, a
|
|
* listing that yields nothing degrades to one DISABLED row, a host that
|
|
* cannot open desktop paths hides the whole section, and a failure lands in
|
|
* the tree's error strip.
|
|
*/
|
|
// @vitest-environment jsdom
|
|
import { beforeAll, afterEach, describe, expect, it, vi } from 'vitest'
|
|
import { createElement } from 'react'
|
|
import { createRoot, type Root } from 'react-dom/client'
|
|
import { act } from 'react-dom/test-utils'
|
|
import { FileTree } from '../src/client/FileTree.tsx'
|
|
import { createOpenInApp, type OpenInApp, type OpenInAppEntry } from '../src/client/open-in-app.ts'
|
|
import { createSidebarStore } from '../src/client/state.ts'
|
|
|
|
import { setupReactAct } from './test-utils.ts'
|
|
setupReactAct()
|
|
|
|
// vitest 4.1.11+ follows the OS locale; pin en-US so menu copy is English.
|
|
beforeAll(() => {
|
|
Object.defineProperty(window.navigator, 'language', { value: 'en-US', configurable: true })
|
|
})
|
|
|
|
vi.mock('../src/client/api.ts', () => ({
|
|
api: {
|
|
fsTree: async () => ({
|
|
path: '/tmp',
|
|
entries: [
|
|
{ name: 'sub', path: '/tmp/sub', isDir: true },
|
|
{ name: 'a.ts', path: '/tmp/a.ts', isDir: false },
|
|
],
|
|
truncated: false,
|
|
}),
|
|
// The tree reads the shared git-status store; a non-repo answer keeps
|
|
// every row plain (this spec is about the open-in-app section).
|
|
gitStatus: async () => ({ isRepo: false, entries: [] }),
|
|
},
|
|
downloadUrl: () => '/sidebar/file',
|
|
isOutsideWorkspaceMessage: () => false,
|
|
}))
|
|
|
|
/** What the host reports for a file (the default entry first). */
|
|
const FILE_APPS: readonly OpenInAppEntry[] = [
|
|
{ id: 'textedit', name: 'TextEdit', icon: null, isDefault: true },
|
|
{ id: 'vscode', name: 'VS Code', icon: 'data:image/svg+xml,%3Csvg/%3E', isDefault: false },
|
|
]
|
|
|
|
/** What the host reports for a directory (no default concept). */
|
|
const DIRECTORY_APPS: readonly OpenInAppEntry[] = [
|
|
{ id: 'vscode', name: 'VS Code', icon: null, isDefault: false },
|
|
{ id: 'finder', name: 'Finder', icon: null, isDefault: false },
|
|
]
|
|
|
|
interface Handle {
|
|
openInApp: OpenInApp
|
|
open: ReturnType<typeof vi.fn>
|
|
reveal: ReturnType<typeof vi.fn>
|
|
fileApps: ReturnType<typeof vi.fn>
|
|
directoryApps: ReturnType<typeof vi.fn>
|
|
}
|
|
|
|
function makeHandle(overrides: Partial<OpenInApp> = {}): Handle {
|
|
const open = vi.fn(async () => true)
|
|
const reveal = vi.fn(async () => true)
|
|
const fileApps = vi.fn(async () => FILE_APPS)
|
|
const directoryApps = vi.fn(async () => DIRECTORY_APPS)
|
|
const openInApp: OpenInApp = {
|
|
available: () => true,
|
|
probe: async () => true,
|
|
directoryApps,
|
|
fileApps,
|
|
open,
|
|
reveal,
|
|
...overrides,
|
|
}
|
|
return { openInApp, open, reveal, fileApps, directoryApps }
|
|
}
|
|
|
|
interface Harness {
|
|
container: HTMLDivElement
|
|
unmount: () => void
|
|
}
|
|
|
|
async function mountTree(handle?: Handle): Promise<Harness> {
|
|
const container = document.createElement('div')
|
|
document.body.append(container)
|
|
const root: Root = createRoot(container)
|
|
await act(async () => {
|
|
root.render(createElement(FileTree, {
|
|
sessionId: 's1',
|
|
cwd: '/tmp',
|
|
store: createSidebarStore(),
|
|
expanded: [],
|
|
revealed: [],
|
|
onToggle: () => {},
|
|
onOpenFile: () => {},
|
|
onOpenFileNewTab: () => {},
|
|
onOpenFileSide: () => {},
|
|
...(handle !== undefined ? { openInApp: handle.openInApp } : {}),
|
|
onReferenceFile: () => {},
|
|
refreshTick: 0,
|
|
onUploadRequest: () => {},
|
|
busy: false,
|
|
}))
|
|
// Settle the async app listing the row menu triggers.
|
|
await Promise.resolve()
|
|
await Promise.resolve()
|
|
})
|
|
return {
|
|
container,
|
|
unmount: () => { act(() => { root.unmount() }); container.remove() },
|
|
}
|
|
}
|
|
|
|
/** The row whose label text matches (rows are role="button" divs). */
|
|
function rowByName(container: HTMLElement, name: string): HTMLElement {
|
|
const row = [...container.querySelectorAll<HTMLElement>('[role="button"]')]
|
|
.find(el => el.querySelector('[class*="explorerName"]')?.textContent === name)
|
|
if (row === undefined) throw new Error(`row not found: ${name}`)
|
|
return row
|
|
}
|
|
|
|
/** Open one row's context menu and settle the async app listing. */
|
|
async function openMenu(container: HTMLElement, name: string): Promise<void> {
|
|
await act(async () => {
|
|
rowByName(container, name).dispatchEvent(
|
|
new MouseEvent('contextmenu', { bubbles: true, cancelable: true, clientX: 20, clientY: 30 }),
|
|
)
|
|
await Promise.resolve()
|
|
await Promise.resolve()
|
|
})
|
|
}
|
|
|
|
function menuItems(): HTMLElement[] {
|
|
return [...document.querySelectorAll<HTMLElement>('[role="menuitem"]')]
|
|
}
|
|
|
|
function menuLabels(): string[] {
|
|
return menuItems().map(item => item.textContent ?? '')
|
|
}
|
|
|
|
function clickMenuitem(label: string): void {
|
|
const item = menuItems().find(el => el.textContent === label)
|
|
if (item === undefined) throw new Error(`menuitem not found: ${label}`)
|
|
act(() => { item.click() })
|
|
}
|
|
|
|
let harness: Harness
|
|
afterEach(() => {
|
|
harness.unmount()
|
|
document.body.innerHTML = ''
|
|
})
|
|
|
|
describe('FileTree open-in-app menu', () => {
|
|
it('lists the default application, the registered apps and reveal for a file row', async () => {
|
|
const handle = makeHandle()
|
|
harness = await mountTree(handle)
|
|
await openMenu(harness.container, 'a.ts')
|
|
expect(handle.fileApps).toHaveBeenCalledWith('/tmp/a.ts')
|
|
// The section heading is a non-interactive label row.
|
|
expect(document.body.textContent).toContain('Open with')
|
|
expect(menuLabels()).toContain('Open with default app')
|
|
expect(menuLabels()).toContain('VS Code')
|
|
expect(menuLabels()).toContain('Reveal in File Manager')
|
|
// The default row's glyph is the default app's own icon slot.
|
|
expect(menuItems().some(item => item.querySelector('img[class*="explorerAppIcon"]') !== null)).toBe(true)
|
|
})
|
|
|
|
it('hands the path (and the chosen application id) to the open handle', async () => {
|
|
const handle = makeHandle()
|
|
harness = await mountTree(handle)
|
|
await openMenu(harness.container, 'a.ts')
|
|
clickMenuitem('Open with default app')
|
|
expect(handle.open).toHaveBeenCalledWith('/tmp/a.ts')
|
|
// Selecting closes the menu entirely.
|
|
expect(menuItems()).toHaveLength(0)
|
|
await openMenu(harness.container, 'a.ts')
|
|
clickMenuitem('VS Code')
|
|
expect(handle.open).toHaveBeenCalledWith('/tmp/a.ts', 'vscode')
|
|
await openMenu(harness.container, 'a.ts')
|
|
clickMenuitem('Reveal in File Manager')
|
|
expect(handle.reveal).toHaveBeenCalledWith('/tmp/a.ts')
|
|
})
|
|
|
|
it('lists the host catalogue for a directory row, with no default row', async () => {
|
|
const handle = makeHandle()
|
|
harness = await mountTree(handle)
|
|
await openMenu(harness.container, 'sub')
|
|
expect(handle.directoryApps).toHaveBeenCalled()
|
|
expect(handle.fileApps).not.toHaveBeenCalled()
|
|
expect(menuLabels()).not.toContain('Open with default app')
|
|
expect(menuLabels()).toEqual(expect.arrayContaining(['VS Code', 'Finder', 'Reveal in File Manager']))
|
|
clickMenuitem('Finder')
|
|
expect(handle.open).toHaveBeenCalledWith('/tmp/sub', 'finder')
|
|
})
|
|
|
|
it('degrades to one DISABLED row when the host knows no application', async () => {
|
|
const handle = makeHandle({ fileApps: async () => [] })
|
|
harness = await mountTree(handle)
|
|
await openMenu(harness.container, 'a.ts')
|
|
const empty = menuItems().find(item => item.textContent === 'No application can open it')
|
|
expect(empty).toBeDefined()
|
|
expect((empty as HTMLButtonElement).disabled).toBe(true)
|
|
})
|
|
|
|
it('reports a failed hand-off in the error strip', async () => {
|
|
const handle = makeHandle({ fileApps: async () => null })
|
|
harness = await mountTree(handle)
|
|
await openMenu(harness.container, 'a.ts')
|
|
expect(harness.container.querySelector('[role="alert"]')?.textContent).toContain('Could not open: /tmp/a.ts')
|
|
})
|
|
|
|
it('reports a hand-off the host refused (open resolving false)', async () => {
|
|
const handle = makeHandle()
|
|
handle.open.mockResolvedValue(false)
|
|
harness = await mountTree(handle)
|
|
await openMenu(harness.container, 'a.ts')
|
|
await act(async () => { clickMenuitem('VS Code'); await Promise.resolve(); await Promise.resolve() })
|
|
expect(harness.container.querySelector('[role="alert"]')?.textContent).toContain('Could not open: /tmp/a.ts')
|
|
})
|
|
|
|
it('hides the whole section when the host cannot open desktop paths', async () => {
|
|
const handle = makeHandle({ available: () => false })
|
|
harness = await mountTree(handle)
|
|
await openMenu(harness.container, 'a.ts')
|
|
expect(handle.fileApps).not.toHaveBeenCalled()
|
|
expect(menuLabels()).not.toContain('Reveal in File Manager')
|
|
expect(document.body.textContent).not.toContain('Open with')
|
|
})
|
|
|
|
it('hides the section when no handle was injected at all', async () => {
|
|
harness = await mountTree()
|
|
await openMenu(harness.container, 'a.ts')
|
|
expect(menuLabels()).not.toContain('Reveal in File Manager')
|
|
expect(document.body.textContent).not.toContain('Open with')
|
|
})
|
|
|
|
it('probes the tri-state handle before deciding the section is unavailable', async () => {
|
|
// The REAL adapter starts with `available() === null` and only publishes
|
|
// an answer when `probe()` runs: a tree that reads the getter without
|
|
// probing would hide the section forever. This case pins that lifecycle
|
|
// with a handle that mimics it exactly.
|
|
let probed = false
|
|
let probes = 0
|
|
const handle = makeHandle({
|
|
available: () => (probed ? true : null),
|
|
probe: async () => { probed = true; probes += 1; return true },
|
|
})
|
|
harness = await mountTree(handle)
|
|
expect(handle.fileApps).not.toHaveBeenCalled()
|
|
await openMenu(harness.container, 'a.ts')
|
|
expect(handle.fileApps).toHaveBeenCalledWith('/tmp/a.ts')
|
|
expect(menuLabels()).toContain('Open with default app')
|
|
expect(menuLabels()).toContain('VS Code')
|
|
expect(probes).toBe(1)
|
|
})
|
|
|
|
it('drives the real host adapter end to end: probe, list, open, reveal', async () => {
|
|
// No hand-written handle here — the production adapter over a fake Host
|
|
// Remote, so the wiring (probe → fileApps → open/reveal) cannot drift.
|
|
const calls = { canOpen: 0, applications: [] as string[], open: [] as { path: string; application?: string }[] }
|
|
const openInApp = createOpenInApp({
|
|
get: (name) => name !== 'remote' ? undefined : {
|
|
session: {
|
|
canOpenWorkspacePath: async () => { calls.canOpen += 1; return { ok: true, value: true } },
|
|
workspacePathApplications: async (request: { path: string }) => {
|
|
calls.applications.push(request.path)
|
|
return { ok: true, value: [{ id: 'textedit', name: 'TextEdit', default: true, icon: null }] }
|
|
},
|
|
openWorkspacePath: async (request: { path: string; application?: string }) => {
|
|
calls.open.push({ path: request.path, ...(request.application !== undefined ? { application: request.application } : {}) })
|
|
return { ok: true }
|
|
},
|
|
},
|
|
},
|
|
})
|
|
expect(openInApp.available()).toBeNull()
|
|
harness = await mountTree({ openInApp } as Handle)
|
|
await openMenu(harness.container, 'a.ts')
|
|
expect(calls.canOpen).toBe(1)
|
|
expect(calls.applications).toEqual(['/tmp/a.ts'])
|
|
expect(menuLabels()).toContain('Open with default app')
|
|
await act(async () => { clickMenuitem('Open with default app'); await Promise.resolve() })
|
|
expect(calls.open).toEqual([{ path: '/tmp/a.ts' }])
|
|
})
|
|
})
|