docs(gui): regenerate graphs and sync the note's English pair

Generated docs follow the ui-models rename and the removed
ui-settings-general package; the English note side picks up the
feature-owner self-registration doctrine.

packages/client/locale/tests/language-row.spec.tsx

@@ -0,0 +1,82 @@
+// @vitest-environment jsdom
+/** LanguageRow behavior: selector pill shows the active locale, the menu
+ * opens/closes, and selection drives setLocale. */
+import { afterEach, describe, expect, it, vi } from 'vitest'
+import { act, cleanup, fireEvent, render, screen } from '@testing-library/react'
+import { createSnapshotStore, type SessionListState, type WorkspaceListState } from '@deepseek-ai/dsh-client-runtime/client'
+import { bindSnapshotSelector } from '@deepseek-ai/dsh-client-web-react'
+import { LanguageRow } from '../src/client/LanguageRow.tsx'
+import type { LanguageRowComponentProps } from '../src/client/LanguageRow.tsx'
+import { createLanguageRowStore } from '../src/client/settings-store.ts'
+
+afterEach(cleanup)
+
+const OPTIONS = [{ id: 'zh', label: '中文' }, { id: 'en', label: 'English' }]
+
+/** Empty global standard-kit hooks (the row reads neither). */
+function emptySessions() {
+  const store = createSnapshotStore<SessionListState>(
+    { ids: [], byId: {}, current: undefined, intent: undefined, phase: 'ready' })
+  return bindSnapshotSelector(store)
+}
+function emptyWorkspaces() {
+  const store = createSnapshotStore<WorkspaceListState>({
+    items: [], intent: undefined, state: 'idle', phase: 'ready', error: null,
+    baselinesReady: true, recentWorkspaceId: undefined,
+  })
+  return bindSnapshotSelector(store)
+}
+
+function mount(active = 'en') {
+  // Real store instance — the sanctioned zero-machinery path for tests.
+  const store = createLanguageRowStore().create()
+  store.actions.sync(active, OPTIONS, 0)
+  const setLocale = vi.fn()
+  const props: LanguageRowComponentProps = {
+    useSessions: emptySessions(),
+    useWorkspaces: emptyWorkspaces(),
+    useStore: bindSnapshotSelector(store),
+    actions: store.actions,
+    t: (key: string) => key === 'language.title' ? 'Language' : key,
+    setLocale,
+  }
+  render(<LanguageRow {...props} />)
+  return { store, setLocale }
+}
+
+describe('LanguageRow', () => {
+  it('shows the title and the active locale label on the selector pill', () => {
+    mount('en')
+    expect(screen.getByText('Language')).toBeDefined()
+    const trigger = screen.getByRole('button', { name: /English/ })
+    expect(trigger.getAttribute('aria-expanded')).toBe('false')
+  })
+
+  it('opens the menu, selects a locale, and closes', () => {
+    const b = mount('en')
+    const trigger = screen.getByRole('button', { name: /English/ })
+    fireEvent.click(trigger)
+    expect(trigger.getAttribute('aria-expanded')).toBe('true')
+    fireEvent.click(screen.getByRole('menuitem', { name: '中文' }))
+    expect(b.setLocale).toHaveBeenCalledWith('zh')
+    expect(trigger.getAttribute('aria-expanded')).toBe('false')
+    expect(screen.queryByRole('menuitem', { name: '中文' })).toBeNull()
+  })
+
+  it('closes on outside pointerdown without selecting', () => {
+    const b = mount('en')
+    fireEvent.click(screen.getByRole('button', { name: /English/ }))
+    expect(screen.getByRole('menuitem', { name: '中文' })).toBeDefined()
+    fireEvent.pointerDown(document.body)
+    expect(screen.queryByRole('menuitem', { name: '中文' })).toBeNull()
+    expect(b.setLocale).not.toHaveBeenCalled()
+  })
+
+  it('follows store changes; an unknown active id falls back to the id itself', () => {
+    const b = mount('en')
+    act(() => { b.store.actions.sync('zh', OPTIONS, 1) })
+    expect(screen.getByRole('button', { name: /中文/ })).toBeDefined()
+    act(() => { b.store.actions.sync('fr', OPTIONS, 2) })
+    expect(screen.getByRole('button', { name: /fr/ })).toBeDefined()
+  })
+})

packages/client/locale/tests/settings-store.spec.ts

@@ -0,0 +1,30 @@
+/** Language row store: snapshot-mirror action and the revision guard. */
+import { describe, expect, it } from 'vitest'
+import { createLanguageRowStore } from '../src/client/settings-store.ts'
+
+const OPTIONS = [{ id: 'zh', label: '中文' }, { id: 'en', label: 'English' }]
+
+describe('createLanguageRowStore', () => {
+  it('init shape: empty mirror with revision at -1', () => {
+    const store = createLanguageRowStore().create()
+    expect(store.getSnapshot()).toEqual({ active: '', options: [], revision: -1 })
+  })
+
+  it('sync mirrors the snapshot and advances the revision', () => {
+    const store = createLanguageRowStore().create()
+    store.actions.sync('zh', OPTIONS, 0)
+    expect(store.getSnapshot()).toEqual({ active: 'zh', options: OPTIONS, revision: 0 })
+    store.actions.sync('en', OPTIONS, 1)
+    expect(store.getSnapshot().active).toBe('en')
+    expect(store.getSnapshot().revision).toBe(1)
+  })
+
+  it('revision guard drops stale and duplicate writes', () => {
+    const store = createLanguageRowStore().create()
+    store.actions.sync('en', OPTIONS, 5)
+    store.actions.sync('zh', OPTIONS, 4)
+    store.actions.sync('zh', OPTIONS, 5)
+    expect(store.getSnapshot().active).toBe('en')
+    expect(store.getSnapshot().revision).toBe(5)
+  })
+})

packages/client/ui-settings/tests/apply.spec.ts

@@ -82,10 +82,12 @@ describe('ui-settings apply', () => {
     // empty once apply settles.
     expect(injected.sections()).toEqual([{ id: 'general', order: 0, label: '通用设置' }])
     b.slots.register({ name: 'settings.section', id: 'z', order: 20, label: 'Z' } as never, () => null)
-    b.slots.register({ name: 'settings.section', id: 'a', order: 5 } as never, () => null)
+    // No order and no label: both projection defaults apply (order 0 ties
+    // keep registration sequence, so 'a' lands after the General entry).
+    b.slots.register({ name: 'settings.section', id: 'a' } as never, () => null)
     expect(injected.sections()).toEqual([
       { id: 'general', order: 0, label: '通用设置' },
-      { id: 'a', order: 5, label: '' },
+      { id: 'a', order: 0, label: '' },
       { id: 'z', order: 20, label: 'Z' },
     ])
     expect(injected.sectionsVersion()).toBe(b.slots.getVersion('settings.section'))

packages/client/ui-settings/tests/general-section.spec.tsx

@@ -11,7 +11,11 @@ function mount() {
   const renderSlot = vi.fn(
     ((key: string) => <div data-testid={`slot-${key}`} />) as GeneralSectionComponentProps['renderSlot'],
   )
+  // Global standard kit stubs: the section consumes neither hook.
+  const unusedHook = (() => { throw new Error('unused by GeneralSection') }) as never
   const props: GeneralSectionComponentProps = {
+    useSessions: unusedHook,
+    useWorkspaces: unusedHook,
     t: (key) => en[key] ?? key,
     renderSlot,
   }

packages/client/ui-theme/tests/appearance-row.spec.tsx

@@ -0,0 +1,75 @@
+// @vitest-environment jsdom
+/** AppearanceRow behavior: three cubes, selection follows the persisted
+ * preference, clicks drive setTheme. */
+import { afterEach, describe, expect, it, vi } from 'vitest'
+import { act, cleanup, fireEvent, render, screen } from '@testing-library/react'
+import { createSnapshotStore, type SessionListState, type WorkspaceListState } from '@deepseek-ai/dsh-client-runtime/client'
+import { bindSnapshotSelector } from '@deepseek-ai/dsh-client-web-react'
+import { AppearanceRow } from '../src/client/AppearanceRow.tsx'
+import type { AppearanceRowComponentProps } from '../src/client/AppearanceRow.tsx'
+import { createAppearanceRowStore } from '../src/client/settings-store.ts'
+import type { ThemePreference } from '../src/client/index.ts'
+
+afterEach(cleanup)
+
+const COPY: Record<string, string> = {
+  'appearance.title': 'Appearance',
+  'appearance.light': 'Light',
+  'appearance.dark': 'Dark',
+  'appearance.system': 'System',
+}
+
+/** Empty global standard-kit hooks (the row reads neither). */
+function emptySessions() {
+  const store = createSnapshotStore<SessionListState>(
+    { ids: [], byId: {}, current: undefined, intent: undefined, phase: 'ready' })
+  return bindSnapshotSelector(store)
+}
+function emptyWorkspaces() {
+  const store = createSnapshotStore<WorkspaceListState>({
+    items: [], intent: undefined, state: 'idle', phase: 'ready', error: null,
+    baselinesReady: true, recentWorkspaceId: undefined,
+  })
+  return bindSnapshotSelector(store)
+}
+
+function mount(preference: ThemePreference = 'system') {
+  // Real store instance — the sanctioned zero-machinery path for tests.
+  const store = createAppearanceRowStore().create()
+  store.actions.sync(preference, 0)
+  const setTheme = vi.fn()
+  const props: AppearanceRowComponentProps = {
+    useSessions: emptySessions(),
+    useWorkspaces: emptyWorkspaces(),
+    useStore: bindSnapshotSelector(store),
+    actions: store.actions,
+    t: (key: string) => COPY[key] ?? key,
+    setTheme,
+  }
+  render(<AppearanceRow {...props} />)
+  return { store, setTheme }
+}
+
+const pressed = (name: RegExp): string | null =>
+  screen.getByRole('button', { name }).getAttribute('aria-pressed')
+
+describe('AppearanceRow', () => {
+  it('renders the title and three cubes with the preference cube selected', () => {
+    mount('dark')
+    expect(screen.getByText('Appearance')).toBeDefined()
+    expect(pressed(/Dark/)).toBe('true')
+    expect(pressed(/Light/)).toBe('false')
+    expect(pressed(/System/)).toBe('false')
+  })
+
+  it('click drives setTheme; selection follows the store mirror, not the click echo', () => {
+    const b = mount('dark')
+    fireEvent.click(screen.getByRole('button', { name: /Light/ }))
+    expect(b.setTheme).toHaveBeenCalledWith('light')
+    // No store write yet: selection is unchanged.
+    expect(pressed(/Dark/)).toBe('true')
+    act(() => { b.store.actions.sync('light', 1) })
+    expect(pressed(/Light/)).toBe('true')
+    expect(pressed(/Dark/)).toBe('false')
+  })
+})

packages/client/ui-theme/tests/settings-store.spec.ts

@@ -0,0 +1,28 @@
+/** Appearance row store: snapshot-mirror action and the revision guard. */
+import { describe, expect, it } from 'vitest'
+import { createAppearanceRowStore } from '../src/client/settings-store.ts'
+
+describe('createAppearanceRowStore', () => {
+  it('init shape: system preference with revision at -1', () => {
+    const store = createAppearanceRowStore().create()
+    expect(store.getSnapshot()).toEqual({ preference: 'system', revision: -1 })
+  })
+
+  it('sync mirrors the preference and advances the revision', () => {
+    const store = createAppearanceRowStore().create()
+    store.actions.sync('dark', 0)
+    expect(store.getSnapshot()).toEqual({ preference: 'dark', revision: 0 })
+    store.actions.sync('light', 2)
+    expect(store.getSnapshot().preference).toBe('light')
+    expect(store.getSnapshot().revision).toBe(2)
+  })
+
+  it('revision guard drops stale and duplicate writes', () => {
+    const store = createAppearanceRowStore().create()
+    store.actions.sync('dark', 3)
+    store.actions.sync('system', 2)
+    store.actions.sync('system', 3)
+    expect(store.getSnapshot().preference).toBe('dark')
+    expect(store.getSnapshot().revision).toBe(3)
+  })
+})