Registrations declare a dictionary namespace (locale: NS) and the renderer
synthesizes a typed t prop for the entry's component from the installed
LocaleFace; the seat binding is re-derived per locale revision, so a language
switch hands out fresh t references and memoized consumers re-render through
ordinary shallow comparison. LocaleNamespaceMap is the declare-merge table
(namespace -> dictionary key union); TranslateNS<'ns'> is the
namespace-addressed translate type (namespace keys plus the shared common
vocabulary), carried by the t seat and by the locale service's typed bind.
LocaleService implements the face (lookup ns -> common -> zh -> key,
revision-carrying snapshots with subscriber isolation) and installs it
through the boot-once slots.installLocale seam, mirroring the renderer
install. The typed register(ns, {zh, en}) overload checks each dictionary
against the namespace's key union and requires every shipped locale, so a
missing or extra key and an unbalanced translation are compile errors.
Dictionary registration bumps the face revision without emitting
locale/change — the event now means exactly 'the active locale switched',
so registration-heavy boot cannot storm event listeners.
103 lines
4.1 KiB
TypeScript
103 lines
4.1 KiB
TypeScript
// @vitest-environment jsdom
|
|
import { afterEach, describe, expect, it, vi } from 'vitest'
|
|
import { cleanup, fireEvent, render, screen } from '@testing-library/react'
|
|
import type { SidebarRootComponentProps, SidebarSectionOwnerProps, SidebarSettingsOwnerProps } from '../src/client/contract/slots.ts'
|
|
import { SidebarRoot } from '../src/client/SidebarRoot.tsx'
|
|
import { en } from '../src/client/locales.ts'
|
|
|
|
// English-dictionary translate stub: the shell renders the same copy the
|
|
// assertions below query by accessible name.
|
|
const t: SidebarRootComponentProps['t'] = key => (en as Record<string, string>)[key] ?? key
|
|
|
|
afterEach(() => {
|
|
cleanup()
|
|
vi.useRealTimers()
|
|
})
|
|
|
|
// The shell never reads the global hooks itself, but they ride the standard
|
|
// props share; stub them as never-called functions.
|
|
const neverHook = (() => { throw new Error('shell must not read global hooks') }) as never
|
|
|
|
function mountShell({ collapsed = false, width = 300 }: { collapsed?: boolean; width?: number } = {}) {
|
|
const startSession = vi.fn()
|
|
const toggleSidebar = vi.fn()
|
|
let regionOwner: SidebarSectionOwnerProps | undefined
|
|
let settingsOwner: SidebarSettingsOwnerProps | undefined
|
|
let current = { collapsed, width }
|
|
const root = () => (
|
|
<SidebarRoot
|
|
collapsed={current.collapsed} width={current.width}
|
|
useSessions={neverHook} useWorkspaces={neverHook}
|
|
startSession={startSession} toggleSidebar={toggleSidebar} t={t}
|
|
renderSlot={((key: string, owner: SidebarSectionOwnerProps | SidebarSettingsOwnerProps) => {
|
|
if (key === 'sidebar.settings') {
|
|
settingsOwner = owner
|
|
return <div data-testid="settings-seat" data-wide={owner.wide} />
|
|
}
|
|
regionOwner = owner as SidebarSectionOwnerProps
|
|
return <div data-testid="region" data-wide={owner.wide} />
|
|
}) as SidebarRootComponentProps['renderSlot']}
|
|
/>
|
|
)
|
|
const view = render(root())
|
|
return {
|
|
startSession,
|
|
toggleSidebar,
|
|
regionOwner: () => {
|
|
if (regionOwner === undefined) throw new Error('region owner not rendered')
|
|
return regionOwner
|
|
},
|
|
settingsOwner: () => {
|
|
if (settingsOwner === undefined) throw new Error('settings owner not rendered')
|
|
return settingsOwner
|
|
},
|
|
rerender(next: Partial<typeof current>) {
|
|
current = { ...current, ...next }
|
|
view.rerender(root())
|
|
},
|
|
}
|
|
}
|
|
|
|
describe('SidebarRoot shell', () => {
|
|
it('routes New Session (capsule + wordmark) and the column toggle', () => {
|
|
const b = mountShell()
|
|
// Expanded, both the wordmark and the capsule start a session.
|
|
const starters = screen.getAllByRole('button', { name: 'New session' })
|
|
expect(starters).toHaveLength(2)
|
|
for (const button of starters) fireEvent.click(button)
|
|
expect(b.startSession).toHaveBeenCalledTimes(2)
|
|
fireEvent.click(screen.getByRole('button', { name: 'Collapse sidebar' }))
|
|
expect(b.toggleSidebar).toHaveBeenCalledOnce()
|
|
})
|
|
|
|
it('hands the region its wide flag and clamps expandSidebar to the collapsed state', () => {
|
|
const b = mountShell()
|
|
expect(b.regionOwner().wide).toBe(true)
|
|
// The settings seat rides the same wide flag (ui-settings renders the row).
|
|
expect(b.settingsOwner().wide).toBe(true)
|
|
// Expanded: the request is a no-op (no accidental collapse).
|
|
b.regionOwner().expandSidebar()
|
|
expect(b.toggleSidebar).not.toHaveBeenCalled()
|
|
})
|
|
|
|
it('keeps the region mounted through collapse and expands on its request', () => {
|
|
vi.useFakeTimers()
|
|
const b = mountShell()
|
|
b.rerender({ collapsed: true })
|
|
// Wide content survives the crossfade window, then settles into the rail.
|
|
expect(b.regionOwner().wide).toBe(true)
|
|
vi.advanceTimersByTime(200)
|
|
b.rerender({})
|
|
expect(b.regionOwner().wide).toBe(false)
|
|
expect(screen.getByTestId('region')).toBeTruthy()
|
|
b.regionOwner().expandSidebar()
|
|
expect(b.toggleSidebar).toHaveBeenCalledOnce()
|
|
})
|
|
|
|
it('renders statically collapsed on a cold start (no crossfade classes)', () => {
|
|
const b = mountShell({ collapsed: true })
|
|
expect(b.regionOwner().wide).toBe(false)
|
|
expect(screen.getByRole('button', { name: 'Open sidebar' })).toBeTruthy()
|
|
})
|
|
})
|