// @vitest-environment jsdom import { Context } from 'cordis' import { afterEach, describe, expect, it, vi } from 'vitest' import { cleanup, fireEvent, render, screen, waitFor } from '@testing-library/react' import { SlotsService } from '@deepseek-ai/dsh-client-runtime/client' import type { DirectoryListing } from '@deepseek-ai/dsh-client-runtime/client' import { LocaleService } from '@deepseek-ai/dsh-client-locale/client' import { usePinnedBrowserLanguages } from '@deepseek-ai/dsh-client-test-runtime' import type { DirectoryFlowOwnerProps } from '@deepseek-ai/dsh-client-ui-workspace/client' import { apply, inject } from '../src/client/index.ts' import { BrowseDirectoryFlow } from '../src/client/flow.ts' // The service reads its initial locale from the browser; these specs assert // the shipped Chinese copy, so they state the browser they assume. usePinnedBrowserLanguages('zh-CN') afterEach(cleanup) const HOLES = ['conversation.hero.workspace.directoryFlow', 'sidebar.workspaces.directoryFlow'] as const const HOME = '/home/u' const homeListing: DirectoryListing = { path: HOME, home: HOME, crumbs: [{ name: '/', path: '/', hidden: false }, { name: 'u', path: HOME, hidden: false }], entries: [{ name: 'Documents', path: `${HOME}/Documents`, hidden: false }], truncated: false, } async function bench() { const ctx = new Context() await ctx.plugin(SlotsService).await() ctx.provide('locale', new LocaleService(ctx)) const listDirectory = vi.fn(async (): Promise => homeListing) const createDirectory = vi.fn(async (path: string, name: string) => `${path}/${name}`) ctx.provide('workspaces', { listDirectory, createDirectory } as never) const slots = ctx.get('slots') as SlotsService const declare = () => slots.register({ name: 'root', children: Object.fromEntries(HOLES.map(name => [name, { kind: 'single', scope: 'root' }])), } as never, () => null) return { ctx, slots, listDirectory, createDirectory, declare } } function owner(overrides: Partial = {}): DirectoryFlowOwnerProps { return { open: true, busy: false, onPicked: vi.fn(), onCancel: vi.fn(), onError: vi.fn(), ...overrides, } } describe('directory-picker-browse client half', () => { it('declares the services it drives', () => { expect(inject).toEqual(['slots', 'workspaces', 'locale']) }) it('fills both directory-flow holes for declarations before or after apply, and leaves with its fiber', async () => { const before = await bench() before.declare() const fiber = before.ctx.plugin({ inject: [...inject], apply }) await fiber.await() for (const hole of HOLES) expect(before.slots.entries(hole)).toHaveLength(1) // Registry-contribution disposal proof: the fiber going down empties the holes. await fiber.dispose() for (const hole of HOLES) expect(before.slots.entries(hole)).toHaveLength(0) const after = await bench() await after.ctx.plugin({ inject: [...inject], apply }).await() for (const hole of HOLES) expect(after.slots.entries(hole)).toHaveLength(0) after.declare() await Promise.resolve() for (const hole of HOLES) expect(after.slots.entries(hole)).toHaveLength(1) }) it('rolls back the outer injection when the second hole is already occupied', async () => { const b = await bench() b.declare() // Foreign occupant in the SECOND registered hole: the pair construction // throws after the outer injection installed its subscription. b.slots.register({ name: HOLES[1] } as never, () => null) const rejections: unknown[] = [] const onUnhandled = (reason: unknown): void => { rejections.push(reason) } process.on('unhandledRejection', onUnhandled) try { const fiber = b.ctx.plugin({ inject: [...inject], apply }) await expect(fiber.await()).rejects.toThrow(/already has a registration/) // A leaked first deferral would now race this probe registration and // throw from its orphaned subscription against the HERO hole; the // rollback leaves only the activation failure itself (cordis re-raises // the apply throw as a late rejection — installFailLoud's contract). const disposeProbe = b.slots.register({ name: HOLES[0] } as never, () => null) await new Promise(resolve => setTimeout(resolve, 20)) expect(rejections.map(String).filter(text => text.includes(HOLES[0]))).toEqual([]) disposeProbe() } finally { process.off('unhandledRejection', onUnhandled) } }) it('rolls back wholesale and reports loudly when a rival injection wins declaration activation', async () => { const b = await bench() const rejections: unknown[] = [] const onUnhandled = (reason: unknown): void => { rejections.push(reason) } process.on('unhandledRejection', onUnhandled) process.on('uncaughtException', onUnhandled) try { // The rival subscribes first, so synchronous declaration notifications // let it occupy the pair before this provider's waiting injection runs. b.slots.inject(HOLES[0], () => b.slots.inject(HOLES[1], function* () { yield b.slots.register({ name: HOLES[0] } as never, () => null) yield b.slots.register({ name: HOLES[1] } as never, () => null) })) await b.ctx.plugin({ inject: [...inject], apply }).await() b.declare() await new Promise(resolve => setTimeout(resolve, 20)) // The rival keeps both holes; this provider rolled back wholesale and // surfaced the conflict on the fail-loud channel — no partial mix. for (const hole of HOLES) expect(b.slots.entries(hole)).toHaveLength(1) expect(rejections.map(String).join('\n')).toContain('already has a registration') // Non-Error conflicts wrap before the loud rethrow (same channel). const c = await bench() await c.ctx.plugin({ inject: [...inject], apply }).await() const original = c.slots.register.bind(c.slots) const slotsAny = c.slots as { register: typeof original } slotsAny.register = ((options: never, component: never) => { if ((options as { name?: string }).name === HOLES[0]) throw 'string conflict' return original(options, component) }) as typeof original c.declare() await new Promise(resolve => setTimeout(resolve, 20)) expect(rejections.map(String).join('\n')).toContain('string conflict') } finally { process.off('unhandledRejection', onUnhandled) process.off('uncaughtException', onUnhandled) } }) it('rolls back the zh dictionary when a rival already owns the namespace en slot', async () => { const b = await bench() b.declare() const locale = b.ctx.get('locale') as LocaleService const disposeRival = locale.register('directory-browser', 'en', { 'browser.title': 'rival' }) const rejections: unknown[] = [] const onUnhandled = (reason: unknown): void => { rejections.push(reason) } // cordis re-raises the apply throw as a late rejection (installFailLoud's contract). process.on('unhandledRejection', onUnhandled) try { const fiber = b.ctx.plugin({ inject: [...inject], apply }) await expect(fiber.await()).rejects.toThrow(/already has locale/) // The zh registration rolled back with the failure: once the rival // leaves, a fresh registrant owns the whole namespace again. disposeRival() const disposeZh = locale.register('directory-browser', 'zh', { 'browser.title': '空闲' }) disposeZh() } finally { await new Promise(resolve => setTimeout(resolve, 0)) process.off('unhandledRejection', onUnhandled) } }) it('registers the dialog dictionaries and binds this package namespace', async () => { const b = await bench() b.declare() await b.ctx.plugin({ inject: [...inject], apply }).await() const entry = b.slots.entries(HOLES[0])[0]! const injected = (entry.inject as () => { t: (key: string) => string })() // zh is the shipped default locale. expect(injected.t('browser.title')).toBe('选择工作区目录') expect(injected.t('browser.newFolder')).toBe('新建文件夹') expect(injected.t('browser.showHidden')).toBe('显示隐藏文件') }) it('drives the injected browse calls through the hole entry', async () => { const b = await bench() b.declare() await b.ctx.plugin({ inject: [...inject], apply }).await() const entry = b.slots.entries(HOLES[1])[0]! const injected = (entry.inject as () => { listDirectory: (path?: string) => Promise createDirectory: (path: string, name: string) => Promise })() await expect(injected.listDirectory()).resolves.toBe(homeListing) await expect(injected.createDirectory(HOME, 'fresh')).resolves.toBe(`${HOME}/fresh`) expect(b.listDirectory).toHaveBeenCalledOnce() expect(b.createDirectory).toHaveBeenCalledWith(HOME, 'fresh') }) it('adapts the owner conversation onto the dialog: confirm picks, dismissal cancels', async () => { const props = owner() const listDirectory = vi.fn(async (): Promise => homeListing) const t = (key: string): string => key render( '')} t={t} />, ) // The dialog opened at home; its confirm (browser.open) adopts the listed level. const openButton = screen.getByRole('button', { name: 'browser.open' }) await waitFor(() => { expect(openButton.disabled).toBe(false) }) fireEvent.click(openButton) expect(props.onPicked).toHaveBeenCalledWith(HOME) fireEvent.click(screen.getByRole('button', { name: 'browser.cancel' })) expect(props.onCancel).toHaveBeenCalled() expect(props.onError).not.toHaveBeenCalled() }) it('renders nothing while the flow is closed', () => { const view = render( homeListing)} createDirectory={vi.fn(async () => '')} t={key => key} />, ) expect(view.container.innerHTML).toBe('') }) })