refactor(client): name the compile face in every client test filename

A test file under packages/client now says which face it covers: `*.client.spec.{ts,tsx}` and its `*.client.{ts,tsx}` helpers belong to the Client aggregate, `*.host.spec.ts` to the host aggregate. The carrier's four node-half specs take the Host suffix. The two suffixes are mutually exclusive, so each aggregate excludes the other's and both keep one broad test glob: `exclude` wins over `include`, and `packages/client/**` no longer has to be excluded wholesale from the host program with per-file `files` entries carved back out of it. A Host-face spec that reaches only Host source therefore needs no cross-face project reference, which the split-project rule rejects. vitest still discovers every file through `**/*.spec.{ts,tsx}`.
2026-08-12 01:40:03 +08:00
parent 7c3bd75bcc
commit 7ad54e7791
246 changed files with 47 additions and 35 deletions
@@ -0,0 +1,112 @@
+// @vitest-environment jsdom
+/**
+ * PlanChip over the `plan` projection: nothing renders while the capability
+ * is absent or the effective target is the default mode; while plan mode is
+ * the target, the chip executes /plan off and remains visible through failures
+ * until the projection confirms the exit.
+ */
+import { afterEach, describe, expect, it, vi } from 'vitest'
+import { cleanup, fireEvent, render, screen, waitFor } from '@testing-library/react'
+import { createSnapshotStore } from '@deepseek-ai/dsh-client-runtime/client'
+import { bindSnapshotSelector } from '@deepseek-ai/dsh-client-web-react'
+import type { PlanProjection } from '@deepseek-ai/dsh-plan-mode/client'
+import { PlanChip, type PlanChipProps } from '../src/client/PlanModeControl.tsx'
+import { makeTranslate } from '@deepseek-ai/dsh-client-test-runtime'
+import { zh as commonZh } from '@deepseek-ai/dsh-client-locale/src/locales/zh.ts'
+import { zh } from '../src/client/locales.ts'
+
+afterEach(cleanup)
+
+// The framework-injected t seat, stubbed over the zh dictionaries (the default locale).
+const t: PlanChipProps['t'] = makeTranslate(zh, commonZh)
+
+function setup(
+  plan: PlanProjection | undefined,
+  exitPlanMode = vi.fn(() => Promise.resolve<string | null>(null)),
+  locked = false,
+) {
+  const store = createSnapshotStore<{ value: PlanProjection | undefined }>({ value: plan })
+  const useProjection = (_key: string, selector?: (v: unknown) => unknown) =>
+    bindSnapshotSelector(store)(s => (selector ?? (v => v))(s.value))
+  const props = { useProjection, locked, exitPlanMode, t } as unknown as PlanChipProps
+  const view = render(<PlanChip {...props} />)
+  return { store, exitPlanMode, view }
+}
+
+const chip = () => screen.getByRole('button', { name: 'plan mode 已开启，按下关闭' })
+
+describe('PlanChip', () => {
+  it('renders nothing for an absent capability or a default-mode target', () => {
+    const absent = setup(undefined)
+    expect(absent.view.container.innerHTML).toBe('')
+    cleanup()
+    const inactive = setup({ active: false, pending: false })
+    expect(inactive.view.container.innerHTML).toBe('')
+    cleanup()
+    const leaving = setup({ active: true, pending: true })
+    expect(leaving.view.container.innerHTML).toBe('')
+  })
+
+  it('renders the Plan status for active and pending-entry targets', () => {
+    setup({ active: true, pending: false })
+    expect(chip().textContent).toBe('Plan')
+    cleanup()
+    setup({ active: false, pending: true })
+    expect(chip().textContent).toBe('Plan')
+  })
+
+  it('executes /plan off once and follows the projection down', async () => {
+    let resolve!: (value: string | null) => void
+    const exitPlanMode = vi.fn(() => new Promise<string | null>((done) => { resolve = done }))
+    const { store } = setup({ active: true, pending: false }, exitPlanMode)
+    fireEvent.click(chip())
+    expect(exitPlanMode).toHaveBeenCalledTimes(1)
+    fireEvent.click(chip())
+    expect(exitPlanMode).toHaveBeenCalledTimes(1)
+    resolve(null)
+    store.set({ value: { active: true, pending: true } })
+    await waitFor(() => {
+      expect(screen.queryByRole('button', { name: 'plan mode 已开启，按下关闭' })).toBeNull()
+    })
+  })
+
+  it('disables under the locked owner prop', () => {
+    setup({ active: true, pending: false }, vi.fn(), true)
+    expect((chip() as HTMLButtonElement).disabled).toBe(true)
+  })
+
+  it('surfaces admission and transport failures while staying visible', async () => {
+    const exitPlanMode = vi.fn()
+      .mockResolvedValueOnce('host said no')
+      .mockRejectedValueOnce(new Error('network down'))
+      .mockRejectedValueOnce('socket closed')
+    setup({ active: true, pending: false }, exitPlanMode)
+    fireEvent.click(chip())
+    expect((await screen.findByText('failed to exit plan mode')).getAttribute('title')).toBe('host said no')
+    expect(chip()).toBeTruthy()
+
+    fireEvent.click(chip())
+    expect(await screen.findByTitle('network down')).toBeTruthy()
+
+    fireEvent.click(chip())
+    expect(await screen.findByTitle('socket closed')).toBeTruthy()
+  })
+
+  it('ignores in-flight fulfillment and rejection after unmount', () => {
+    let resolve!: (value: string | null) => void
+    const successful = setup(
+      { active: true, pending: false },
+      vi.fn(() => new Promise<string | null>((done) => { resolve = done })),
+    )
+    fireEvent.click(chip())
+    successful.view.unmount()
+    expect(() => { resolve(null) }).not.toThrow()
+
+    let reject!: (reason: unknown) => void
+    const exitPlanMode = vi.fn(() => new Promise<string | null>((_done, fail) => { reject = fail }))
+    const { view } = setup({ active: true, pending: false }, exitPlanMode)
+    fireEvent.click(chip())
+    view.unmount()
+    expect(() => { reject(new Error('late')) }).not.toThrow()
+  })
+})