211 lines
9.0 KiB
TypeScript
211 lines
9.0 KiB
TypeScript
/** Ownerless-copy registrations: the four seats, the dictionaries, thunked labels, and HMR recovery. */
|
|
import { Context } from 'cordis'
|
|
import { afterEach, describe, expect, it, vi } from 'vitest'
|
|
import { resolveSlotLabel } from '@deepseek-ai/dsh-client-ui-slots'
|
|
import { SlotsService } 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 { apply, inject } from '@deepseek-ai/dsh-client-ui-settings-general/client'
|
|
import { CloseLabel, HeaderContent, TriggerContent } from '../src/client/chrome.tsx'
|
|
import { GeneralSection } from '../src/client/GeneralSection.tsx'
|
|
import { WelcomeNotice } from '../src/client/WelcomeNotice.tsx'
|
|
import type { WelcomeNoticeInjected } from '../src/client/WelcomeNotice.tsx'
|
|
import { WELCOME_NOTICE_SETTINGS_NAMESPACE } from '../src/onboarding-copy.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(() => { vi.unstubAllGlobals() })
|
|
|
|
/** The five seats this plugin fills (slot name → expected component). */
|
|
const SEATS = [
|
|
['settings.trigger', TriggerContent],
|
|
['settings.header', HeaderContent],
|
|
['settings.close', CloseLabel],
|
|
['settings.section', GeneralSection],
|
|
['settings.onboarding', WelcomeNotice],
|
|
] as const
|
|
|
|
async function bench() {
|
|
const ctx = new Context()
|
|
await ctx.plugin(SlotsService).await()
|
|
const locale = new LocaleService(ctx)
|
|
ctx.provide('locale', locale)
|
|
const settingsDescribe = vi.fn(() => Promise.resolve({
|
|
rpcId: 'settings-general' as never,
|
|
result: {
|
|
ok: true as const,
|
|
value: {
|
|
writable: true,
|
|
namespaces: [{
|
|
ns: WELCOME_NOTICE_SETTINGS_NAMESPACE,
|
|
schema: {},
|
|
value: {},
|
|
applies: 'live' as const,
|
|
secrets: [],
|
|
revision: 0,
|
|
}],
|
|
},
|
|
},
|
|
}))
|
|
ctx.provide('connection', { api: { settings: { describe: settingsDescribe } } } as never)
|
|
return { ctx, slots: ctx.get('slots') as SlotsService, locale, settingsDescribe }
|
|
}
|
|
|
|
/** Declare the shell's four child slots the way ui-settings' entry does. */
|
|
function declare(slots: SlotsService): () => void {
|
|
return slots.register(
|
|
{
|
|
name: 'root',
|
|
children: {
|
|
'settings.trigger': { kind: 'single', scope: 'root' },
|
|
'settings.header': { kind: 'single', scope: 'root' },
|
|
'settings.close': { kind: 'single', scope: 'root' },
|
|
'settings.section': { kind: 'list', scope: 'root' },
|
|
'settings.onboarding': { kind: 'list', scope: 'root' },
|
|
},
|
|
} as never,
|
|
() => null,
|
|
)
|
|
}
|
|
|
|
function generalEntry(slots: SlotsService) {
|
|
return slots.entries('settings.section').find(e => e.component === GeneralSection)
|
|
}
|
|
|
|
describe('ui-settings-general apply', () => {
|
|
it('declares the services it uses', () => {
|
|
expect(inject).toEqual(['slots', 'locale', 'connection'])
|
|
})
|
|
|
|
it('fills all five seats for declarations before or after apply', async () => {
|
|
const before = await bench()
|
|
declare(before.slots)
|
|
await before.ctx.plugin({ inject: [...inject], apply }).await()
|
|
for (const [name, component] of SEATS) {
|
|
expect(before.slots.entries(name)[0]!.component).toBe(component)
|
|
}
|
|
const entry = generalEntry(before.slots)!
|
|
expect(entry.options).toMatchObject({ id: 'general', order: 0 })
|
|
// The nav label is a locale-following thunk; owners resolve at read time.
|
|
expect(resolveSlotLabel(entry.options.label)).toBe('通用设置')
|
|
expect(before.slots.spec('settings.general.item')).toEqual({ kind: 'list', scope: 'root' })
|
|
expect(before.slots.entries('settings.general.item')).toEqual([])
|
|
const welcome = before.slots.entries('settings.onboarding')[0]!
|
|
expect(welcome.options).toMatchObject({ id: 'welcome-notice', order: -100 })
|
|
// Copy rides the standard locale seat: every seat declares the namespace.
|
|
for (const [name] of SEATS) {
|
|
expect(before.slots.entries(name)[0]!.locale).toBe('settings')
|
|
}
|
|
const after = await bench()
|
|
await after.ctx.plugin({ inject: [...inject], apply }).await()
|
|
for (const [name] of SEATS) expect(after.slots.entries(name)).toHaveLength(0)
|
|
declare(after.slots)
|
|
await Promise.resolve()
|
|
for (const [name, component] of SEATS) {
|
|
expect(after.slots.entries(name)[0]!.component).toBe(component)
|
|
// The self-inflicted ledger notifications hit the duplicate guard.
|
|
expect(after.slots.entries(name)).toHaveLength(1)
|
|
}
|
|
await vi.waitFor(() => {
|
|
expect(after.slots.spec('settings.general.item')).toEqual({ kind: 'list', scope: 'root' })
|
|
})
|
|
})
|
|
|
|
it('registers the zh/en settings dictionaries and frees the seats on teardown', async () => {
|
|
const b = await bench()
|
|
declare(b.slots)
|
|
const fiber = b.ctx.plugin({ inject: [...inject], apply })
|
|
await fiber.await()
|
|
expect(b.locale.bind('settings')('title')).toBe('设置')
|
|
b.locale.setLocale('en')
|
|
expect(b.locale.bind('settings')('close')).toBe('Close')
|
|
b.locale.setLocale('zh')
|
|
await fiber.dispose()
|
|
// The (ns, locale) seats are free again — the dictionary disposer ran.
|
|
expect(() => b.locale.register('settings', 'zh', {})).not.toThrow()
|
|
expect(() => b.locale.register('settings', 'en', {})).not.toThrow()
|
|
})
|
|
|
|
it('the nav label thunk follows the active locale without re-registration', async () => {
|
|
const b = await bench()
|
|
declare(b.slots)
|
|
await b.ctx.plugin({ inject: [...inject], apply }).await()
|
|
const zhVersions = SEATS.map(([name]) => b.slots.getVersion(name))
|
|
b.locale.setLocale('en')
|
|
// No ledger churn: freshness rides the thunk (and the renderer's locale
|
|
// subscription), not re-registration.
|
|
SEATS.forEach(([name], i) => {
|
|
expect(b.slots.getVersion(name)).toBe(zhVersions[i]!)
|
|
expect(b.slots.entries(name)).toHaveLength(1)
|
|
})
|
|
expect(resolveSlotLabel(generalEntry(b.slots)!.options.label)).toBe('General')
|
|
b.locale.setLocale('zh')
|
|
expect(resolveSlotLabel(generalEntry(b.slots)!.options.label)).toBe('通用设置')
|
|
})
|
|
|
|
it('refreshes loaded welcome state only for its settings namespace or a reconnect', async () => {
|
|
const b = await bench()
|
|
declare(b.slots)
|
|
await b.ctx.plugin({ inject: [...inject], apply }).await()
|
|
const entry = b.slots.entries('settings.onboarding')[0]!
|
|
const { controller } = (entry.inject as unknown as () => WelcomeNoticeInjected)()
|
|
await controller.load()
|
|
expect(b.settingsDescribe).toHaveBeenCalledOnce()
|
|
b.ctx.emit('settings/changed', 'unrelated')
|
|
expect(b.settingsDescribe).toHaveBeenCalledOnce()
|
|
b.ctx.emit('settings/changed', WELCOME_NOTICE_SETTINGS_NAMESPACE)
|
|
await vi.waitFor(() => { expect(b.settingsDescribe).toHaveBeenCalledTimes(2) })
|
|
b.ctx.emit('connection/reset')
|
|
await vi.waitFor(() => { expect(b.settingsDescribe).toHaveBeenCalledTimes(3) })
|
|
})
|
|
|
|
it('keeps remote welcome acknowledgement process-local', async () => {
|
|
vi.stubGlobal('location', { hostname: '192.0.2.20' })
|
|
const b = await bench()
|
|
declare(b.slots)
|
|
await b.ctx.plugin({ inject: [...inject], apply }).await()
|
|
const entry = b.slots.entries('settings.onboarding')[0]!
|
|
const { controller } = (entry.inject as unknown as () => WelcomeNoticeInjected)()
|
|
|
|
await controller.load()
|
|
await expect(controller.acknowledge()).resolves.toBe(true)
|
|
expect(controller.store.getSnapshot()).toMatchObject({ status: 'ready', acknowledged: true })
|
|
expect(b.settingsDescribe).not.toHaveBeenCalled()
|
|
})
|
|
|
|
it('re-registers after an HMR collapse of the declaring chain (stale disposers must not block)', async () => {
|
|
const b = await bench()
|
|
const redeclare = declare(b.slots)
|
|
await b.ctx.plugin({ inject: [...inject], apply }).await()
|
|
// Declarer unload: the cascade removes every seat entry and the item
|
|
// declaration while our local disposers go stale.
|
|
redeclare()
|
|
for (const [name] of SEATS) expect(b.slots.entries(name)).toHaveLength(0)
|
|
expect(b.slots.spec('settings.general.item')).toBeUndefined()
|
|
declare(b.slots)
|
|
await Promise.resolve()
|
|
for (const [name, component] of SEATS) {
|
|
expect(b.slots.entries(name)[0]!.component).toBe(component)
|
|
}
|
|
expect(b.slots.entries('settings.general.item')).toEqual([])
|
|
expect(b.slots.spec('settings.general.item')).toEqual({ kind: 'list', scope: 'root' })
|
|
// The recovered registrations still ride the locale path.
|
|
b.locale.setLocale('en')
|
|
expect(resolveSlotLabel(generalEntry(b.slots)!.options.label)).toBe('General')
|
|
b.locale.setLocale('zh')
|
|
})
|
|
|
|
it('removes every seat and the item declaration on teardown', async () => {
|
|
const b = await bench()
|
|
declare(b.slots)
|
|
const fiber = b.ctx.plugin({ inject: [...inject], apply })
|
|
await fiber.await()
|
|
expect(b.slots.spec('settings.general.item')).toBeDefined()
|
|
await fiber.dispose()
|
|
for (const [name] of SEATS) expect(b.slots.entries(name)).toHaveLength(0)
|
|
expect(b.slots.spec('settings.general.item')).toBeUndefined()
|
|
})
|
|
})
|