The open-source agent harness - the runtime layer that turns an LLM into a working agent.
feat: added conclusive test suite (#93)
vinit-truefoundry6da501da0312
diff --git a/packages/trueforge-ui-sdk/eslint.config.js b/packages/trueforge-ui-sdk/eslint.config.jsindex 218825190..e52bd005c 100644--- a/packages/trueforge-ui-sdk/eslint.config.js+++ b/packages/trueforge-ui-sdk/eslint.config.js@@ -10,7 +10,7 @@ export default tseslint.config(eslint.configs.recommended,...tseslint.configs.recommended,{- files: ['src/**/*.{ts,tsx}'],+ files: ['src/**/*.{ts,tsx}', 'test/**/*.{ts,tsx}'],languageOptions: {ecmaVersion: 2022,globals: {diff --git a/packages/trueforge-ui-sdk/package.json b/packages/trueforge-ui-sdk/package.jsonindex 00ba06fec..6ca3adb87 100644--- a/packages/trueforge-ui-sdk/package.json+++ b/packages/trueforge-ui-sdk/package.json@@ -52,11 +52,12 @@"build": "tsup && tailwindcss --input src/build-styles.css --output dist/styles.css --minify","dev:watch": "tsup --watch","pack:tgz": "pnpm build && pnpm pack",- "test": "vitest run",+ "test": "vitest run && pnpm test:package",+ "test:package": "pnpm build && node test/packageExports.smoke.mjs","test:coverage": "vitest run --coverage",- "typecheck": "tsc --noEmit",- "lint": "eslint src --ext .ts,.tsx",- "format": "prettier --write \"src/**/*.{ts,tsx,css,md}\" \"*.md\" \"docs/**/*.md\""+ "typecheck": "tsc --noEmit && tsc --noEmit -p test/tsconfig.json",+ "lint": "eslint src test --ext .ts,.tsx",+ "format": "prettier --write \"src/**/*.{ts,tsx,css,md}\" \"test/**/*.{ts,tsx}\" \"*.md\" \"docs/**/*.md\" --config ../../.prettierrc"},"peerDependencies": {"@assistant-ui/core": "^0.2.22",diff --git a/packages/trueforge-ui-sdk/src/atoms/AttachmentCard.tsx b/packages/trueforge-ui-sdk/src/atoms/AttachmentCard.tsxindex e518cebbd..6aa9ccc3a 100644--- a/packages/trueforge-ui-sdk/src/atoms/AttachmentCard.tsx+++ b/packages/trueforge-ui-sdk/src/atoms/AttachmentCard.tsx@@ -76,7 +76,11 @@ export function AttachmentCard({type="button"aria-label="Remove file"title="Remove file"- className={auiButtonClass({ variant: 'ghost', size: 'icon', className: 'size-6 shrink-0 rounded-full' })}+ className={auiButtonClass({+ variant: 'ghost',+ size: 'icon',+ className: 'size-6 shrink-0 rounded-full',+ })}onClick={onRemove}><Icon name="xmark" />diff --git a/packages/trueforge-ui-sdk/src/atoms/primitives/BottomSheet.test.tsx b/packages/trueforge-ui-sdk/src/atoms/primitives/BottomSheet.test.tsxdeleted file mode 100644index 0b5616c9b..000000000--- a/packages/trueforge-ui-sdk/src/atoms/primitives/BottomSheet.test.tsx+++ /dev/null@@ -1,29 +0,0 @@-// @vitest-environment jsdom-import { fireEvent, render, screen } from '@testing-library/react';-import { describe, expect, it, vi } from 'vitest';--import { BottomSheet } from './BottomSheet.js';--HTMLDialogElement.prototype.showModal = function showModal() {- this.setAttribute('open', '');-};--describe('BottomSheet', () => {- it('handles Escape without closing a parent dialog', () => {- const onOpenChange = vi.fn();- const onParentCancel = vi.fn();-- render(- <dialog open onCancel={onParentCancel}>- <BottomSheet open onOpenChange={onOpenChange} aria-label="Picker">- Content- </BottomSheet>- </dialog>,- );-- fireEvent(screen.getByRole('dialog', { name: 'Picker' }), new Event('cancel', { bubbles: true }));-- expect(onOpenChange).toHaveBeenCalledWith(false);- expect(onParentCancel).not.toHaveBeenCalled();- });-});diff --git a/packages/trueforge-ui-sdk/src/containers/ComposerContainer.tsx b/packages/trueforge-ui-sdk/src/containers/ComposerContainer.tsxindex 9cc223a37..335622044 100644--- a/packages/trueforge-ui-sdk/src/containers/ComposerContainer.tsx+++ b/packages/trueforge-ui-sdk/src/containers/ComposerContainer.tsx@@ -8,8 +8,7 @@ import { DraftCatalogProvider } from '../atoms/draft/DraftCatalogProvider.js';import { useComposerBusyState } from '../hooks/useComposerBusyState.js';import { useComposerPauseView } from '../hooks/useComposerPauseView.js';import { useOptionalShellMode } from '../server/ShellModeContext.js';-import { defaultSlots } from '../theme/defaultSlots.js';-import { SlotsProvider, useSlot } from '../theme/SlotsProvider.js';+import { SlotsProvider, useSlot, useSlotIsDefault } from '../theme/SlotsProvider.js';import { AskUserContainer } from './AskUserContainer.js';import { ComposerAttachmentsContainer } from './AttachmentsContainer.js';import { McpAuthContainer } from './McpAuthContainer.js';@@ -18,14 +17,6 @@ export type ComposerContainerProps = {placeholder?: string;};-/**- * Use draft UI only when the host did not override the slot.- * Example: host overrides LeftSection → keep host; else → DraftComposerLeftSection.- */-function preferHostSlotOverride<T>(parentSlot: T, stockDefault: T, draftDefault: T): T {- return parentSlot === stockDefault ? draftDefault : parentSlot;-}-function ComposerBody({ placeholder }: { placeholder: string }) {const ComposerShell = useSlot('ComposerShell');const aui = useAui();@@ -101,6 +92,8 @@ export function ComposerContainer({const shell = useOptionalShellMode();const parentLeftSection = useSlot('ComposerLeftSection');const parentRightSection = useSlot('ComposerRightSection');+ const usesDefaultLeftSection = useSlotIsDefault('ComposerLeftSection');+ const usesDefaultRightSection = useSlotIsDefault('ComposerRightSection');const DraftComposerLeftSection = useSlot('DraftComposerLeftSection');const DraftComposerRightSection = useSlot('DraftComposerRightSection');const canMutateSpec = shell?.mode.status === 'active' && shell.mode.isMutable;@@ -117,16 +110,8 @@ export function ComposerContainer({<DraftCatalogProvider><SlotsProvideroverrides={{- ComposerLeftSection: preferHostSlotOverride(- parentLeftSection,- defaultSlots.ComposerLeftSection,- DraftComposerLeftSection,- ),- ComposerRightSection: preferHostSlotOverride(- parentRightSection,- defaultSlots.ComposerRightSection,- DraftComposerRightSection,- ),+ ComposerLeftSection: usesDefaultLeftSection ? DraftComposerLeftSection : parentLeftSection,+ ComposerRightSection: usesDefaultRightSection ? DraftComposerRightSection : parentRightSection,}}><ComposerBody placeholder={placeholder} />diff --git a/packages/trueforge-ui-sdk/src/containers/ErrorToasterContainer.test.tsx b/packages/trueforge-ui-sdk/src/containers/ErrorToasterContainer.test.tsxdeleted file mode 100644index d7d25eabd..000000000--- a/packages/trueforge-ui-sdk/src/containers/ErrorToasterContainer.test.tsx+++ /dev/null@@ -1,83 +0,0 @@-import { act, fireEvent, render, screen, waitFor } from '@testing-library/react';-import { beforeEach, describe, expect, it, vi } from 'vitest';--import { Toast } from '../atoms/Toast.js';-import { SlotsProvider } from '../theme/SlotsProvider.js';-import { ErrorToasterProvider, useErrorToaster } from './ErrorToasterContainer.js';--function Trigger({ errors }: { errors: unknown[] }) {- const { showError } = useErrorToaster();- return (- <button- type="button"- onClick={() => {- for (const error of errors) showError(error);- }}- >- boom- </button>- );-}--describe('ErrorToasterProvider', () => {- beforeEach(() => {- vi.spyOn(console, 'error').mockImplementation(() => {});- });-- it('stacks multiple error toasts', async () => {- render(- <SlotsProvider>- <ErrorToasterProvider>- <Trigger errors={[new Error('first'), new Error('second')]} />- </ErrorToasterProvider>- </SlotsProvider>,- );-- fireEvent.click(screen.getByRole('button', { name: 'boom' }));-- expect(await screen.findByText('first')).toBeTruthy();- expect(screen.getByText('second')).toBeTruthy();- expect(screen.getAllByRole('alert')).toHaveLength(2);- });-- it('dismisses one toast without removing the other', async () => {- render(- <SlotsProvider>- <ErrorToasterProvider>- <Trigger errors={[new Error('keep-me'), new Error('drop-me')]} />- </ErrorToasterProvider>- </SlotsProvider>,- );-- fireEvent.click(screen.getByRole('button', { name: 'boom' }));- expect(await screen.findByText('drop-me')).toBeTruthy();-- const dropToast = screen.getByText('drop-me').closest("[role='alert']");- expect(dropToast).toBeTruthy();- fireEvent.click(dropToast!.querySelector('[aria-label="Close"]')!);-- await waitFor(() => {- expect(screen.queryByText('drop-me')).toBeNull();- });- expect(screen.getByText('keep-me')).toBeTruthy();- });-});--describe('Toast copy', () => {- it('copies title and description', async () => {- const writeText = vi.fn().mockResolvedValue(undefined);- Object.assign(navigator, { clipboard: { writeText } });-- render(- <SlotsProvider>- <Toast title="Request failed" description="body detail" open onOpenChange={() => {}} />- </SlotsProvider>,- );-- await act(async () => {- fireEvent.click(screen.getByRole('button', { name: 'Copy' }));- });-- expect(writeText).toHaveBeenCalledWith('Request failed\nbody detail');- });-});diff --git a/packages/trueforge-ui-sdk/src/containers/ThreadContainer.tsx b/packages/trueforge-ui-sdk/src/containers/ThreadContainer.tsxindex c10796060..f10e8c946 100644--- a/packages/trueforge-ui-sdk/src/containers/ThreadContainer.tsx+++ b/packages/trueforge-ui-sdk/src/containers/ThreadContainer.tsx@@ -17,7 +17,13 @@ import { UserMessageContainer } from './UserMessageContainer.js';// `remoteId == null` keeps welcome off during first-turn edit/retry: the// runtime briefly rewinds to an empty snapshot before applying pendingUser,// and messages.length===0 alone would flash the welcome screen.-export const isNewChatView = (s: AssistantState) =>+type NewChatViewState = {+ thread: Pick<AssistantState['thread'], 'messages' | 'isLoading'>;+ threads: Pick<AssistantState['threads'], 'isLoading'>;+ threadListItem: Pick<AssistantState['threadListItem'], 'remoteId'>;+};++export const isNewChatView = (s: NewChatViewState) =>s.thread.messages.length === 0 && (!s.thread.isLoading || s.threads.isLoading) && s.threadListItem.remoteId == null;/** Mount-only lift. Keyed by message.id via ThreadPrimitive.Messages — not content (streaming). */diff --git a/packages/trueforge-ui-sdk/src/containers/TrueFoundryChatProvider.test.tsx b/packages/trueforge-ui-sdk/src/containers/TrueFoundryChatProvider.test.tsxdeleted file mode 100644index 9ebe89fb3..000000000--- a/packages/trueforge-ui-sdk/src/containers/TrueFoundryChatProvider.test.tsx+++ /dev/null@@ -1,50 +0,0 @@-// @vitest-environment jsdom-import { useExternalStoreRuntime, type ThreadMessageLike } from '@assistant-ui/react';-import { render, screen } from '@testing-library/react';-import { describe, expect, it, vi } from 'vitest';-import type { AgentUIServer } from '../server/types.js';--vi.mock('@truefoundry/assistant-ui-runtime', () => ({- trueFoundryAttachmentAdapter: {},- useTrueFoundryAgentRuntime: () =>- // Called from ChatRuntimeScope (a React component), so hooks are valid here.- useExternalStoreRuntime<ThreadMessageLike>({- messages: [],- isRunning: false,- convertMessage: (message: ThreadMessageLike) => message,- onNew: async () => {},- }),-}));--import { TrueFoundryChatProvider } from './TrueFoundryChatProvider.js';--function mockServer(): AgentUIServer {- return {- createSession: vi.fn(),- listSessions: vi.fn(),- getSession: vi.fn(),- updateSession: vi.fn(),- createTurn: vi.fn(),- cancelSession: vi.fn(),- listTurns: vi.fn(),- getTurn: vi.fn(),- listEvents: vi.fn(),- getModels: vi.fn(async () => []),- getSkills: vi.fn(async () => []),- getMcp: vi.fn(async () => []),- searchAgents: vi.fn(async () => []),- saveAgent: vi.fn(async () => ({})),- } as unknown as AgentUIServer;-}--describe('TrueFoundryChatProvider', () => {- it('mounts children under the chat provider with a mock server', () => {- render(- <TrueFoundryChatProvider server={mockServer()} agentName="my-agent">- <div>chat-child</div>- </TrueFoundryChatProvider>,- );-- expect(screen.getByText('chat-child')).toBeInTheDocument();- });-});diff --git a/packages/trueforge-ui-sdk/src/icons/Icon.tsx b/packages/trueforge-ui-sdk/src/icons/Icon.tsxindex e177eb7d1..5ce00bda5 100644--- a/packages/trueforge-ui-sdk/src/icons/Icon.tsx+++ b/packages/trueforge-ui-sdk/src/icons/Icon.tsx@@ -1,16 +1,9 @@-import {- createElement,- isValidElement,- useContext,- type ComponentType,- type CSSProperties,- type ReactNode,-} from 'react';+import { createElement, isValidElement, useContext, type CSSProperties, type ReactNode } from 'react';import { cn } from '../atoms/lib/cn.js';import { ThemeContext } from '../theme/ThemeProvider.js';-import type { IconProps as ThemeIconProps } from '../theme/types.js';-import { lookupIcon, resolveIconName, type IconEntry } from './IconRegistry.js';+import type { IconComponent, IconEntry, IconProps as ThemeIconProps } from '../theme/types.js';+import { lookupIcon, resolveIconName } from './IconRegistry.js';export type IconProps = ThemeIconProps & {name: string | readonly string[];@@ -23,9 +16,9 @@ type IconRenderProps = {width?: string | number;height?: string | number;role?: string;-} & Pick<IconProps, 'aria-hidden' | 'aria-label'>;+} & Pick<IconProps, 'aria-hidden' | 'aria-label' | 'data-testid'>;-function isComponent(entry: IconEntry): boolean {+function isComponent(entry: IconEntry): entry is IconComponent {if (typeof entry === 'function') return true;// Lucide (and other) icons are forwardRef objects, not functionsreturn (@@ -40,7 +33,7 @@ function isComponent(entry: IconEntry): boolean {function renderEntry(entry: IconEntry, props: IconRenderProps): ReactNode {if (isComponent(entry)) {const { size, className, style, ...aria } = props;- return createElement(entry as ComponentType<IconRenderProps>, {+ return createElement(entry, {className: cn('inline-block shrink-0', className),style,size,@@ -48,10 +41,11 @@ function renderEntry(entry: IconEntry, props: IconRenderProps): ReactNode {height: size,'aria-hidden': aria['aria-label'] ? undefined : (aria['aria-hidden'] ?? true),'aria-label': aria['aria-label'],+ ...(aria['data-testid'] === undefined ? {} : { 'data-testid': aria['data-testid'] }),role: aria['aria-label'] ? 'img' : undefined,});}- return entry as ReactNode;+ return entry;}export function Icon({ name, className, style, size = '1em', ...aria }: IconProps) {diff --git a/packages/trueforge-ui-sdk/src/icons/IconRegistry.tsx b/packages/trueforge-ui-sdk/src/icons/IconRegistry.tsxindex ff5ceacdd..71f1d762a 100644--- a/packages/trueforge-ui-sdk/src/icons/IconRegistry.tsx+++ b/packages/trueforge-ui-sdk/src/icons/IconRegistry.tsx@@ -50,11 +50,8 @@ import {Wrench,X,} from 'lucide-react';-import type { FC, ReactNode, SVGProps } from 'react';-import type { IconMap, IconProps } from '../theme/types.js';--export type IconEntry = LucideIcon | ReactNode | ((props: IconProps) => ReactNode) | FC<SVGProps<SVGSVGElement>>;+import type { IconEntry, IconMap } from '../theme/types.js';const registry = new Map<string, IconEntry>();@@ -62,7 +59,7 @@ export function registerIcon(name: string, icon: IconEntry): void {registry.set(name, icon);}-export function registerIcons(icons: Record<string, IconEntry>): void {+export function registerIcons(icons: IconMap): void {for (const [name, icon] of Object.entries(icons)) {registry.set(name, icon);}@@ -142,7 +139,7 @@ for (const [name, icon] of Object.entries(defaults)) {/** Merge host `theme.icons` over the registry for a single lookup (does not mutate). */export function lookupIcon(name: string, themeIcons?: IconMap): IconEntry | undefined {if (themeIcons && name in themeIcons) {- return themeIcons[name] as IconEntry;+ return themeIcons[name];}return registry.get(name);}diff --git a/packages/trueforge-ui-sdk/src/index.ts b/packages/trueforge-ui-sdk/src/index.tsindex c25a60a7a..8d7ddb79b 100644--- a/packages/trueforge-ui-sdk/src/index.ts+++ b/packages/trueforge-ui-sdk/src/index.ts@@ -323,7 +323,7 @@ export type {// Utilsexport { computeAgentStepsSplit } from './utils/computeAgentStepsSplit.js';-export type { AgentStepsSplitResult } from './utils/computeAgentStepsSplit.js';+export type { AgentStepPart, AgentStepsSplitResult } from './utils/computeAgentStepsSplit.js';export { AgentsLibrary } from './atoms/AgentsLibrary.js';export type { AgentsLibraryProps } from './atoms/AgentsLibrary.js';diff --git a/packages/trueforge-ui-sdk/src/theme/SlotsProvider.tsx b/packages/trueforge-ui-sdk/src/theme/SlotsProvider.tsxindex ff754ebac..09b3c4c72 100644--- a/packages/trueforge-ui-sdk/src/theme/SlotsProvider.tsx+++ b/packages/trueforge-ui-sdk/src/theme/SlotsProvider.tsx@@ -77,6 +77,12 @@ export function useSlot<K extends keyof PublicAtomSlots>(name: K): PublicAtomSloreturn slots[name];}+/** Whether the currently resolved slot is the SDK's stock implementation. */+export function useSlotIsDefault<K extends keyof PublicAtomSlots>(name: K): boolean {+ const slots = useContext(SlotsContext);+ return slots[name] === defaultSlots[name];+}+/** Resolves the light or dark theme mode supplied by the SDK consumer. */export function useThemeMode(): 'light' | 'dark' {return useContext(ThemeModeContext) ?? 'light';diff --git a/packages/trueforge-ui-sdk/src/theme/types.ts b/packages/trueforge-ui-sdk/src/theme/types.tsindex 53cc2c7c7..e64f6a723 100644--- a/packages/trueforge-ui-sdk/src/theme/types.ts+++ b/packages/trueforge-ui-sdk/src/theme/types.ts@@ -46,12 +46,14 @@ export type IconProps = {size?: string | number;'aria-hidden'?: boolean | 'true' | 'false';'aria-label'?: string;+ 'data-testid'?: string;};-export type IconMap = Record<- string,- LucideIcon | ReactNode | ((props: IconProps) => ReactNode) | FC<SVGProps<SVGSVGElement>>->;+export type IconComponent = LucideIcon | ((props: IconProps) => ReactNode) | FC<SVGProps<SVGSVGElement>>;++export type IconEntry = IconComponent | ReactNode;++export type IconMap = Record<string, IconEntry>;export type BrandImage = { src: string; alt?: string } | ReactNode | ((props: { className?: string }) => ReactNode);diff --git a/packages/trueforge-ui-sdk/src/utils/computeAgentStepsSplit.ts b/packages/trueforge-ui-sdk/src/utils/computeAgentStepsSplit.tsindex b5e82ea02..61802d1c3 100644--- a/packages/trueforge-ui-sdk/src/utils/computeAgentStepsSplit.ts+++ b/packages/trueforge-ui-sdk/src/utils/computeAgentStepsSplit.ts@@ -1,5 +1,10 @@import type { PartState } from '@assistant-ui/core/react';+export type AgentStepPart = {+ type: PartState['type'];+ text?: string;+};+export interface AgentStepsSplitResult {cutIndex: number;hasFinal: boolean;@@ -7,7 +12,7 @@ export interface AgentStepsSplitResult {thinkingCount: number;}-export function computeAgentStepsSplit(parts: readonly PartState[], isRunning: boolean): AgentStepsSplitResult {+export function computeAgentStepsSplit(parts: readonly AgentStepPart[], isRunning: boolean): AgentStepsSplitResult {const finalTexts: Array<{ index: number; content: string }> = [];let cutIdx = parts.length;@@ -16,7 +21,7 @@ export function computeAgentStepsSplit(parts: readonly PartState[], isRunning: bif (!part) continue;if (part.type === 'text') {- const text = (part as { text?: string }).text ?? '';+ const text = part.text ?? '';const trimmed = text.trim();if (trimmed) {diff --git a/packages/trueforge-ui-sdk/src/atoms/AgentHistoryFilterButton.test.tsx b/packages/trueforge-ui-sdk/test/atoms/AgentHistoryFilterButton.test.tsxsimilarity index 61%rename from packages/trueforge-ui-sdk/src/atoms/AgentHistoryFilterButton.test.tsxrename to packages/trueforge-ui-sdk/test/atoms/AgentHistoryFilterButton.test.tsxindex 62860cd33..ba9b43b63 100644--- a/packages/trueforge-ui-sdk/src/atoms/AgentHistoryFilterButton.test.tsx+++ b/packages/trueforge-ui-sdk/test/atoms/AgentHistoryFilterButton.test.tsx@@ -1,27 +1,39 @@// @vitest-environment jsdomimport { act, fireEvent, render, screen, waitFor } from '@testing-library/react';import type { ReactNode } from 'react';-import { describe, expect, it, vi } from 'vitest';--import { ServerProvider } from '../server/ServerContext.js';-import { ShellModeProvider, useShellMode } from '../server/ShellModeContext.js';-import type { AgentUIServer } from '../server/types.js';-import { SlotsProvider } from '../theme/SlotsProvider.js';-import { AgentHistoryFilterButton } from './AgentHistoryFilterButton.js';--HTMLDialogElement.prototype.showModal = function showModal() {- this.setAttribute('open', '');-};-HTMLDialogElement.prototype.close = function close() {- this.removeAttribute('open');- this.dispatchEvent(new Event('close'));-};+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';++import { AgentHistoryFilterButton } from '@/atoms/AgentHistoryFilterButton.js';+import { ServerProvider } from '@/server/ServerContext.js';+import { ShellModeProvider, useShellMode } from '@/server/ShellModeContext.js';+import type { AgentUIServer } from '@/server/types.js';+import { SlotsProvider } from '@/theme/SlotsProvider.js';+import { createMockAgentUIServer } from '../server/mockServer.js';++const originalShowModal = Object.getOwnPropertyDescriptor(HTMLDialogElement.prototype, 'showModal');+const originalClose = Object.getOwnPropertyDescriptor(HTMLDialogElement.prototype, 'close');++beforeEach(() => {+ Object.defineProperty(HTMLDialogElement.prototype, 'showModal', {+ configurable: true,+ value(this: HTMLDialogElement) {+ this.open = true;+ },+ });+ Object.defineProperty(HTMLDialogElement.prototype, 'close', {+ configurable: true,+ value(this: HTMLDialogElement) {+ this.open = false;+ this.dispatchEvent(new Event('close'));+ },+ });+});function mockServer(partial: Partial<AgentUIServer> = {}): AgentUIServer {- return {- searchAgents: vi.fn().mockResolvedValue([{ name: 'from-sdk' }, { name: 'other' }]),+ return createMockAgentUIServer({+ searchAgents: async () => [{ name: 'from-sdk' }, { name: 'other' }],...partial,- } as AgentUIServer;+ });}function FilterProbe() {@@ -50,6 +62,20 @@ function wrap({};}+afterEach(() => {+ vi.unstubAllGlobals();+ if (originalShowModal === undefined) {+ Reflect.deleteProperty(HTMLDialogElement.prototype, 'showModal');+ } else {+ Object.defineProperty(HTMLDialogElement.prototype, 'showModal', originalShowModal);+ }+ if (originalClose === undefined) {+ Reflect.deleteProperty(HTMLDialogElement.prototype, 'close');+ } else {+ Object.defineProperty(HTMLDialogElement.prototype, 'close', originalClose);+ }+});+describe('AgentHistoryFilterButton', () => {it('renders nothing when library is disabled', () => {render(<AgentHistoryFilterButton />, {@@ -59,7 +85,8 @@ describe('AgentHistoryFilterButton', () => {});it('opens popover and sets history filter on agent click', async () => {- const server = mockServer();+ const searchAgents = vi.fn(async () => [{ name: 'from-sdk' }, { name: 'other' }]);+ const server = mockServer({ searchAgents });render(<AgentHistoryFilterButton />, {wrapper: wrap({ agentConfig: { mode: 'AgentLibraryWithComposer' }, server }),});@@ -74,7 +101,7 @@ describe('AgentHistoryFilterButton', () => {});expect(screen.getByTestId('filter-value')).toHaveTextContent('from-sdk');- expect(server.searchAgents).toHaveBeenCalled();+ expect(searchAgents).toHaveBeenCalled();});it('opens a bottom sheet on mobile', async () => {@@ -100,7 +127,5 @@ describe('AgentHistoryFilterButton', () => {expect(screen.getByRole('dialog', { name: /Filter agents/i })).toBeInTheDocument();});await waitFor(() => expect(screen.getByRole('menuitem', { name: /from-sdk/i })).toBeInTheDocument());-- vi.unstubAllGlobals();});});diff --git a/packages/trueforge-ui-sdk/src/atoms/AgentsLibrary.test.tsx b/packages/trueforge-ui-sdk/test/atoms/AgentsLibrary.test.tsxsimilarity index 91%rename from packages/trueforge-ui-sdk/src/atoms/AgentsLibrary.test.tsxrename to packages/trueforge-ui-sdk/test/atoms/AgentsLibrary.test.tsxindex 830898d9f..68949c338 100644--- a/packages/trueforge-ui-sdk/src/atoms/AgentsLibrary.test.tsx+++ b/packages/trueforge-ui-sdk/test/atoms/AgentsLibrary.test.tsx@@ -2,13 +2,14 @@import { fireEvent, render, screen, waitFor } from '@testing-library/react';import { beforeAll, describe, expect, it, vi } from 'vitest';-import { ServerProvider } from '../server/ServerContext.js';-import { ShellModeProvider, useShellMode } from '../server/ShellModeContext.js';-import type { AgentUIServer } from '../server/types.js';-import { SlotsProvider } from '../theme/SlotsProvider.js';-import { AgentsLibrary } from './AgentsLibrary.js';-import { AgentsLibraryButton } from './AgentsLibraryButton.js';-import { CenteredModal } from './primitives/CenteredModal.js';+import { AgentsLibrary } from '@/atoms/AgentsLibrary.js';+import { AgentsLibraryButton } from '@/atoms/AgentsLibraryButton.js';+import { CenteredModal } from '@/atoms/primitives/CenteredModal.js';+import { ServerProvider } from '@/server/ServerContext.js';+import { ShellModeProvider, useShellMode } from '@/server/ShellModeContext.js';+import type { AgentUIServer } from '@/server/types.js';+import { SlotsProvider } from '@/theme/SlotsProvider.js';+import { createMockAgentUIServer } from '../server/mockServer.js';beforeAll(() => {// jsdom does not implement HTMLDialogElement showModal/close.@@ -28,9 +29,9 @@ function mockServer(agentSpec?: { model: { name: string }; skills?: Array<{ id: string; name: string }> };}> = [{ name: 'alpha-agent' }],): AgentUIServer {- return {+ return createMockAgentUIServer({searchAgents: vi.fn(async () => agents),- } as unknown as AgentUIServer;+ });}describe('CenteredModal', () => {diff --git a/packages/trueforge-ui-sdk/test/atoms/AssistantMessageBubble.test.tsx b/packages/trueforge-ui-sdk/test/atoms/AssistantMessageBubble.test.tsxnew file mode 100644index 000000000..b72bce163--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/AssistantMessageBubble.test.tsx@@ -0,0 +1,32 @@+import { render, screen } from '@testing-library/react';+import { describe, expect, it } from 'vitest';++import { AssistantMessageBubble } from '@/atoms/AssistantMessageBubble.js';++describe('AssistantMessageBubble', () => {+ it('renders message, error, and action content in their regions', () => {+ const { container } = render(+ <AssistantMessageBubble+ error={<span>Generation failed</span>}+ actionBar={<button type="button">Copy response</button>}+ className="host-bubble"+ >+ <p>Assistant response</p>+ </AssistantMessageBubble>,+ );++ const root = container.querySelector('[data-slot="aui_assistant-message-root"]');+ expect(root).toHaveClass('host-bubble');+ expect(root).toContainElement(screen.getByText('Assistant response'));+ expect(screen.getByText('Generation failed').parentElement).toHaveClass('text-destructive');+ expect(screen.getByRole('button', { name: 'Copy response' }).parentElement).toHaveClass('mt-1');+ });++ it('omits optional regions when their values are absent', () => {+ const { container } = render(<AssistantMessageBubble>Only the message</AssistantMessageBubble>);++ expect(screen.getByText('Only the message')).toBeInTheDocument();+ expect(container.querySelector('.text-destructive')).not.toBeInTheDocument();+ expect(container.querySelector('.mt-1')).not.toBeInTheDocument();+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/AttachmentCard.test.tsx b/packages/trueforge-ui-sdk/test/atoms/AttachmentCard.test.tsxnew file mode 100644index 000000000..d4fd542af--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/AttachmentCard.test.tsx@@ -0,0 +1,56 @@+import { fireEvent, render, screen } from '@testing-library/react';+import { describe, expect, it, vi } from 'vitest';++import { AttachmentCard } from '@/atoms/AttachmentCard.js';++describe('AttachmentCard', () => {+ it('renders an image preview with accessible text and a configured size', () => {+ const { container } = render(+ <AttachmentCard+ name="diagram.png"+ previewSrc="/diagram.png"+ isImage+ size="preview"+ previewRem={12}+ className="consumer-class"+ />,+ );++ const preview = container.querySelector('[data-slot="aui_attachment-preview"]');+ expect(preview).toHaveClass('consumer-class');+ expect(preview).toHaveStyle({ width: '12rem', height: '12rem' });+ expect(screen.getByRole('img', { name: 'diagram.png' })).toHaveAttribute('src', '/diagram.png');+ });++ it('renders a removable image chip and invokes its removal callback', () => {+ const onRemove = vi.fn();+ const { container } = render(+ <AttachmentCard+ name="long-image-name.png"+ previewSrc="/thumbnail.png"+ isImage+ previewRem={8}+ onRemove={onRemove}+ />,+ );++ const chip = container.querySelector('[data-slot="aui_attachment-chip"]');+ expect(chip).toHaveStyle({ maxWidth: '8rem' });+ expect(screen.getByRole('img', { name: 'long-image-name.png' })).toHaveAttribute('src', '/thumbnail.png');++ const removeButton = screen.getByRole('button', { name: 'Remove file' });+ expect(removeButton).toHaveAttribute('type', 'button');+ expect(removeButton).toHaveAttribute('title', 'Remove file');+ fireEvent.click(removeButton);+ expect(onRemove).toHaveBeenCalledOnce();+ });++ it('falls back to a file chip when image preview data is unavailable', () => {+ const { container } = render(<AttachmentCard name="report.pdf" contentType="application/pdf" isImage />);++ expect(container.querySelector('[data-slot="aui_attachment-chip"]')).toBeInTheDocument();+ expect(screen.getByText('report.pdf')).toBeInTheDocument();+ expect(screen.queryByRole('img')).not.toBeInTheDocument();+ expect(screen.queryByRole('button', { name: 'Remove file' })).not.toBeInTheDocument();+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/AttachmentPickerButton.test.tsx b/packages/trueforge-ui-sdk/test/atoms/AttachmentPickerButton.test.tsxnew file mode 100644index 000000000..806ce95ad--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/AttachmentPickerButton.test.tsx@@ -0,0 +1,30 @@+import { fireEvent, render, screen } from '@testing-library/react';+import { describe, expect, it, vi } from 'vitest';++import { AttachmentPickerButton } from '@/atoms/AttachmentPickerButton.js';++describe('AttachmentPickerButton', () => {+ it('provides an accessible button and forwards interaction props', () => {+ const onClick = vi.fn();+ render(<AttachmentPickerButton onClick={onClick} className="consumer-class" data-testid="picker" />);++ const button = screen.getByRole('button', { name: 'Add Attachment' });+ expect(button).toHaveAttribute('type', 'button');+ expect(button).toHaveAttribute('title', 'Add Attachment');+ expect(button).toHaveAttribute('data-testid', 'picker');+ expect(button).toHaveClass('consumer-class');++ fireEvent.click(button);+ expect(onClick).toHaveBeenCalledOnce();+ });++ it('honors the native disabled state', () => {+ const onClick = vi.fn();+ render(<AttachmentPickerButton disabled onClick={onClick} />);++ const button = screen.getByRole('button', { name: 'Add Attachment' });+ expect(button).toBeDisabled();+ fireEvent.click(button);+ expect(onClick).not.toHaveBeenCalled();+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/AttachmentPreviewDialog.test.tsx b/packages/trueforge-ui-sdk/test/atoms/AttachmentPreviewDialog.test.tsxnew file mode 100644index 000000000..4f041155c--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/AttachmentPreviewDialog.test.tsx@@ -0,0 +1,47 @@+import { fireEvent, render, screen } from '@testing-library/react';+import { beforeAll, describe, expect, it } from 'vitest';++import { AttachmentPreviewDialog } from '@/atoms/AttachmentPreviewDialog.js';++beforeAll(() => {+ HTMLDialogElement.prototype.showModal = function showModal() {+ this.setAttribute('open', '');+ };+ HTMLDialogElement.prototype.close = function close() {+ this.removeAttribute('open');+ this.dispatchEvent(new Event('close'));+ };+});++describe('AttachmentPreviewDialog', () => {+ it('renders children directly when no preview source is available', () => {+ render(+ <AttachmentPreviewDialog>+ <span>plain attachment</span>+ </AttachmentPreviewDialog>,+ );++ expect(screen.getByText('plain attachment')).toBeInTheDocument();+ expect(screen.queryByRole('button', { name: 'Open attachment preview' })).not.toBeInTheDocument();+ expect(screen.queryByRole('dialog')).not.toBeInTheDocument();+ });++ it('opens an accessible image dialog and closes it with its close control', () => {+ render(+ <AttachmentPreviewDialog previewSrc="/full-size.png">+ <img src="/thumbnail.png" alt="diagram thumbnail" />+ </AttachmentPreviewDialog>,+ );++ const trigger = screen.getByRole('button', { name: 'Open attachment preview' });+ expect(trigger).toHaveAttribute('type', 'button');+ fireEvent.click(trigger);++ const dialog = screen.getByRole('dialog', { name: 'Attachment preview' });+ expect(dialog).toHaveAttribute('open');+ expect(screen.getByRole('img', { name: 'Attachment preview' })).toHaveAttribute('src', '/full-size.png');++ fireEvent.click(screen.getByRole('button', { name: 'Close' }));+ expect(dialog).not.toHaveAttribute('open');+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/ChatFileDownload.test.tsx b/packages/trueforge-ui-sdk/test/atoms/ChatFileDownload.test.tsxnew file mode 100644index 000000000..e0aa91908--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/ChatFileDownload.test.tsx@@ -0,0 +1,95 @@+import { act, fireEvent, render, screen } from '@testing-library/react';+import { describe, expect, it, vi } from 'vitest';++import { ChatFileDownload } from '@/atoms/ChatFileDownload.js';++describe('ChatFileDownload', () => {+ it('renders direct download links with singular and plural summaries', () => {+ const { rerender } = render(+ <ChatFileDownload+ files={[{ name: 'report.pdf', path: '/report.pdf' }]}+ fileDownloadBaseUrl="https://files.example.com"+ />,+ );++ expect(screen.getByText('1 file generated')).toBeInTheDocument();+ const reportLink = screen.getByRole('link', { name: 'Download report.pdf' });+ expect(reportLink).toHaveAttribute('href', 'https://files.example.com/report.pdf');+ expect(reportLink).toHaveAttribute('download', 'report.pdf');++ rerender(+ <ChatFileDownload+ files={[+ { name: 'report.pdf', path: '/report.pdf' },+ { name: 'data.csv', path: '/data.csv' },+ ]}+ fileDownloadBaseUrl="/downloads"+ />,+ );+ expect(screen.getByText('2 files generated')).toBeInTheDocument();+ expect(screen.getByRole('link', { name: 'Download data.csv' })).toHaveAttribute('href', '/downloads/data.csv');+ });++ it('shows per-file progress and suppresses duplicate artifact downloads', async () => {+ let resolveDownload: (() => void) | undefined;+ const downloadPromise = new Promise<void>(resolve => {+ resolveDownload = resolve;+ });+ const onDownloadArtifact = vi.fn(() => downloadPromise);+ render(+ <ChatFileDownload+ files={[{ name: 'bundle.zip', path: '/bundle.zip' }]}+ onDownloadArtifact={onDownloadArtifact}+ />,+ );++ fireEvent.click(screen.getByRole('link', { name: 'Download bundle.zip' }));+ expect(onDownloadArtifact).toHaveBeenCalledWith('/bundle.zip', 'bundle.zip');++ const downloadingLink = screen.getByRole('link', { name: 'Downloading bundle.zip' });+ expect(downloadingLink).toHaveAttribute('aria-busy', 'true');+ expect(screen.getByRole('status', { name: 'Loading' })).toBeInTheDocument();+ fireEvent.click(downloadingLink);+ expect(onDownloadArtifact).toHaveBeenCalledOnce();++ if (resolveDownload === undefined) {+ throw new Error('Expected the download resolver to be assigned');+ }+ const completeDownload = resolveDownload;+ await act(async () => {+ completeDownload();+ await downloadPromise;+ });++ expect(screen.getByRole('link', { name: 'Download bundle.zip' })).not.toHaveAttribute('aria-busy');+ expect(screen.queryByRole('status', { name: 'Loading' })).not.toBeInTheDocument();+ });++ it('renders read-only filenames without interactive download controls', () => {+ render(+ <ChatFileDownload+ readOnly+ files={[+ { name: 'one.txt', path: '/one.txt' },+ { name: 'two.txt', path: '/two.txt' },+ ]}+ fileDownloadBaseUrl="/downloads"+ onDownloadArtifact={vi.fn(async () => {})}+ />,+ );++ expect(screen.getByText('one.txt')).toBeInTheDocument();+ expect(screen.getByText('two.txt')).toBeInTheDocument();+ expect(screen.queryAllByRole('link')).toHaveLength(0);+ expect(screen.queryByLabelText(/Download /)).not.toBeInTheDocument();+ });++ it('marks files as unavailable when no download mechanism is configured', () => {+ render(<ChatFileDownload files={[{ name: 'offline.txt', path: '/offline.txt' }]} />);++ const unavailable = screen.getByLabelText('Download offline.txt');+ expect(unavailable).not.toHaveAttribute('href');+ expect(unavailable).toHaveClass('pointer-events-none', 'opacity-60');+ expect(screen.queryByRole('link', { name: 'Download offline.txt' })).not.toBeInTheDocument();+ });+});diff --git a/packages/trueforge-ui-sdk/src/atoms/ClearChatButton.test.tsx b/packages/trueforge-ui-sdk/test/atoms/ClearChatButton.test.tsxsimilarity index 80%rename from packages/trueforge-ui-sdk/src/atoms/ClearChatButton.test.tsxrename to packages/trueforge-ui-sdk/test/atoms/ClearChatButton.test.tsxindex 65191526d..3d08a4a48 100644--- a/packages/trueforge-ui-sdk/src/atoms/ClearChatButton.test.tsx+++ b/packages/trueforge-ui-sdk/test/atoms/ClearChatButton.test.tsx@@ -2,17 +2,17 @@import { fireEvent, render, screen } from '@testing-library/react';import { describe, expect, it, vi } from 'vitest';-import { ServerProvider } from '../server/ServerContext.js';-import { ShellModeProvider } from '../server/ShellModeContext.js';-import type { AgentUIServer } from '../server/types.js';-import { SlotsProvider } from '../theme/SlotsProvider.js';-import { ClearChatButton } from './ClearChatButton.js';-import { SelectAgentEmptyState } from './SelectAgentEmptyState.js';+import { ClearChatButton } from '@/atoms/ClearChatButton.js';+import { SelectAgentEmptyState } from '@/atoms/SelectAgentEmptyState.js';+import { ServerProvider } from '@/server/ServerContext.js';+import { ShellModeProvider } from '@/server/ShellModeContext.js';+import { SlotsProvider } from '@/theme/SlotsProvider.js';+import { createMockAgentUIServer } from '../server/mockServer.js';-function mockServer(): AgentUIServer {- return {+function mockServer() {+ return createMockAgentUIServer({searchAgents: vi.fn(async () => [{ name: 'alpha' }]),- } as unknown as AgentUIServer;+ });}describe('ClearChatButton', () => {diff --git a/packages/trueforge-ui-sdk/test/atoms/CodeEditor.test.tsx b/packages/trueforge-ui-sdk/test/atoms/CodeEditor.test.tsxnew file mode 100644index 000000000..e9b8b4509--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/CodeEditor.test.tsx@@ -0,0 +1,174 @@+// @vitest-environment jsdom+import { act, fireEvent, render, screen } from '@testing-library/react';+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';++import { CodeEditor } from '@/atoms/CodeEditor.js';++vi.mock('@/atoms/MonacoEditorCore.js', () => ({+ MonacoEditorCore: ({+ value,+ height,+ options,+ onChange,+ onMount,+ beforeMount,+ }: {+ value: string;+ height?: string | number;+ options?: Record<string, unknown>;+ onChange?: (value: string) => void;+ onMount?: (editor: unknown, monaco: unknown) => void;+ beforeMount?: (monaco: unknown) => void;+ }) => (+ <div+ data-testid="monaco-editor"+ data-value={value}+ data-height={String(height)}+ data-line-numbers={String(options?.lineNumbers)}+ >+ <button type="button" onClick={() => onChange?.('edited')}>+ Edit+ </button>+ <button type="button" onClick={() => beforeMount?.('monaco-api')}>+ Before mount+ </button>+ <button type="button" onClick={() => onMount?.('editor-api', 'monaco-api')}>+ Mount+ </button>+ </div>+ ),+}));++const clipboardDescriptor = Object.getOwnPropertyDescriptor(navigator, 'clipboard');+const createObjectURLDescriptor = Object.getOwnPropertyDescriptor(URL, 'createObjectURL');+const revokeObjectURLDescriptor = Object.getOwnPropertyDescriptor(URL, 'revokeObjectURL');++describe('CodeEditor', () => {+ const writeText = vi.fn(() => Promise.resolve());+ const createObjectURL = vi.fn(() => 'blob:test-download');+ const revokeObjectURL = vi.fn();++ beforeEach(() => {+ vi.clearAllMocks();+ Object.defineProperty(navigator, 'clipboard', {+ configurable: true,+ value: { writeText },+ });+ Object.defineProperty(URL, 'createObjectURL', {+ configurable: true,+ value: createObjectURL,+ });+ Object.defineProperty(URL, 'revokeObjectURL', {+ configurable: true,+ value: revokeObjectURL,+ });+ });++ afterEach(() => {+ vi.useRealTimers();+ if (clipboardDescriptor === undefined) {+ Reflect.deleteProperty(navigator, 'clipboard');+ } else {+ Object.defineProperty(navigator, 'clipboard', clipboardDescriptor);+ }+ if (createObjectURLDescriptor === undefined) {+ Reflect.deleteProperty(URL, 'createObjectURL');+ } else {+ Object.defineProperty(URL, 'createObjectURL', createObjectURLDescriptor);+ }+ if (revokeObjectURLDescriptor === undefined) {+ Reflect.deleteProperty(URL, 'revokeObjectURL');+ } else {+ Object.defineProperty(URL, 'revokeObjectURL', revokeObjectURLDescriptor);+ }+ vi.restoreAllMocks();+ });++ it('renders the toolbar, toggles line numbers, and forwards editor changes', () => {+ const onChange = vi.fn();+ const beforeMount = vi.fn();+ const onMount = vi.fn();+ render(+ <CodeEditor+ value="const answer = 42;"+ filename="answer.ts"+ language="typescript"+ onChange={onChange}+ beforeMount={beforeMount}+ onMount={onMount}+ />,+ );++ expect(screen.getByText('answer.ts')).toBeInTheDocument();+ expect(screen.getByTestId('monaco-editor')).toHaveAttribute('data-line-numbers', 'off');++ fireEvent.click(screen.getByRole('button', { name: 'Show line numbers' }));+ expect(screen.getByRole('button', { name: 'Hide line numbers' })).toBeInTheDocument();+ expect(screen.getByTestId('monaco-editor')).toHaveAttribute('data-line-numbers', 'on');++ fireEvent.click(screen.getByRole('button', { name: 'Edit' }));+ expect(onChange).toHaveBeenCalledWith('edited');+ fireEvent.click(screen.getByRole('button', { name: 'Before mount' }));+ expect(beforeMount).toHaveBeenCalledWith('monaco-api');+ fireEvent.click(screen.getByRole('button', { name: 'Mount' }));+ expect(onMount).toHaveBeenCalledWith('editor-api', 'monaco-api');+ });++ it('copies the current value and reports the copied state', async () => {+ vi.useFakeTimers();+ render(<CodeEditor value="copy me" />);++ await act(async () => {+ fireEvent.click(screen.getByRole('button', { name: 'Copy' }));+ await Promise.resolve();+ });++ expect(writeText).toHaveBeenCalledWith('copy me');+ expect(screen.getByRole('button', { name: 'Copied!' })).toBeInTheDocument();++ act(() => {+ vi.advanceTimersByTime(2000);+ });+ expect(screen.getByRole('button', { name: 'Copy' })).toBeInTheDocument();+ });++ it('expands and collapses the editor while keeping Monaco fill-height', () => {+ const { container } = render(<CodeEditor value="code" height={240} />);+ const root = container.querySelector('.aui-code-editor');++ expect(root).not.toHaveClass('fixed');+ expect(screen.getByTestId('monaco-editor')).toHaveAttribute('data-height', '100%');++ fireEvent.click(screen.getByRole('button', { name: 'Expand' }));+ expect(root).toHaveClass('fixed');+ expect(screen.getByRole('button', { name: 'Collapse' })).toBeInTheDocument();++ fireEvent.click(screen.getByRole('button', { name: 'Collapse' }));+ expect(root).not.toHaveClass('fixed');+ });++ it('downloads the current value using the filename', () => {+ let clickedDownload: string | undefined;+ let clickedHref: string | undefined;+ vi.spyOn(HTMLAnchorElement.prototype, 'click').mockImplementation(function click(this: HTMLAnchorElement) {+ clickedDownload = this.download;+ clickedHref = this.href;+ });+ render(<CodeEditor value="download me" filename="result.ts" language="typescript" />);++ fireEvent.click(screen.getByRole('button', { name: 'Download' }));++ expect(createObjectURL).toHaveBeenCalledWith(expect.any(Blob));+ expect(clickedDownload).toBe('result.ts');+ expect(clickedHref).toBe('blob:test-download');+ expect(revokeObjectURL).toHaveBeenCalledWith('blob:test-download');+ });++ it('hides all toolbar actions when requested', () => {+ render(<CodeEditor value="code" filename="hidden.ts" showToolbar={false} />);++ expect(screen.queryByText('hidden.ts')).not.toBeInTheDocument();+ expect(screen.queryByRole('button', { name: 'Copy' })).not.toBeInTheDocument();+ expect(screen.getByTestId('monaco-editor')).toBeInTheDocument();+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/ComposerSections.test.tsx b/packages/trueforge-ui-sdk/test/atoms/ComposerSections.test.tsxnew file mode 100644index 000000000..275582750--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/ComposerSections.test.tsx@@ -0,0 +1,72 @@+import { fireEvent, render, screen } from '@testing-library/react';+import { describe, expect, it, vi } from 'vitest';++import { ComposerLeftSection, ComposerRightSection, ComposerSendButton } from '@/atoms/ComposerSections.js';++describe('ComposerLeftSection', () => {+ it('renders an accessible attachment action when a handler is provided', () => {+ const onAttach = vi.fn();+ render(<ComposerLeftSection disabled={false} isRunning={false} onAttach={onAttach} />);++ const button = screen.getByRole('button', { name: 'Attach' });+ expect(button).toHaveAttribute('type', 'button');+ expect(button).toHaveAttribute('title', 'Attach');+ fireEvent.click(button);+ expect(onAttach).toHaveBeenCalledOnce();+ });++ it('renders nothing when attachment handling is unavailable', () => {+ const { container } = render(<ComposerLeftSection disabled isRunning />);+ expect(container).toBeEmptyDOMElement();+ });+});++describe('ComposerRightSection', () => {+ it('reserves no default UI in either idle or running state', () => {+ const { container, rerender } = render(<ComposerRightSection disabled={false} isRunning={false} />);+ expect(container).toBeEmptyDOMElement();++ rerender(<ComposerRightSection disabled isRunning />);+ expect(container).toBeEmptyDOMElement();+ });+});++describe('ComposerSendButton', () => {+ it('disables submission until the composer can submit', () => {+ const onSubmit = vi.fn();+ const { rerender } = render(+ <ComposerSendButton disabled={false} canSubmit={false} isRunning={false} onSubmit={onSubmit} />,+ );++ const unavailableButton = screen.getByRole('button', { name: 'Send message' });+ expect(unavailableButton).toBeDisabled();+ fireEvent.click(unavailableButton);+ expect(onSubmit).not.toHaveBeenCalled();++ rerender(<ComposerSendButton disabled={false} canSubmit isRunning={false} onSubmit={onSubmit} />);+ const availableButton = screen.getByRole('button', { name: 'Send message' });+ expect(availableButton).toBeEnabled();+ expect(availableButton).toHaveAttribute('title', 'Send message');+ fireEvent.click(availableButton);+ expect(onSubmit).toHaveBeenCalledOnce();+ });++ it('switches to a cancel action while running', () => {+ const onSubmit = vi.fn();+ const onCancel = vi.fn();+ render(<ComposerSendButton disabled={false} canSubmit isRunning onSubmit={onSubmit} onCancel={onCancel} />);++ const cancelButton = screen.getByRole('button', { name: 'Cancel' });+ expect(cancelButton).toHaveTextContent('Cancel');+ expect(screen.queryByRole('button', { name: 'Send message' })).not.toBeInTheDocument();+ fireEvent.click(cancelButton);+ expect(onCancel).toHaveBeenCalledOnce();+ expect(onSubmit).not.toHaveBeenCalled();+ });++ it('disables cancellation when no cancel handler is supplied', () => {+ render(<ComposerSendButton disabled={false} canSubmit isRunning onSubmit={() => {}} />);++ expect(screen.getByRole('button', { name: 'Cancel' })).toBeDisabled();+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/ComposerShell.test.tsx b/packages/trueforge-ui-sdk/test/atoms/ComposerShell.test.tsxnew file mode 100644index 000000000..25ba7ca9a--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/ComposerShell.test.tsx@@ -0,0 +1,70 @@+import { fireEvent, render, screen } from '@testing-library/react';+import { describe, expect, it, vi } from 'vitest';++import { ComposerShell } from '@/atoms/ComposerShell.js';++describe('ComposerShell', () => {+ it('composes input, attachments, metadata, and idle actions', () => {+ const onAttach = vi.fn();+ const onSubmit = vi.fn();+ const { container } = render(+ <ComposerShell+ input={<textarea aria-label="Message" defaultValue="Hello" />}+ attachments={<div>design.png</div>}+ disabled={false}+ canSubmit+ modelLabel="GPT 5"+ modelIcon={<span aria-label="Model icon">M</span>}+ connectorStatusLabel="Connected"+ onAttach={onAttach}+ onSubmit={onSubmit}+ className="consumer-class"+ />,+ );++ const shell = container.querySelector('[data-slot="aui_composer-shell"]');+ expect(shell).toHaveClass('consumer-class');+ expect(screen.getByRole('textbox', { name: 'Message' })).toHaveValue('Hello');+ expect(screen.getByText('design.png')).toBeInTheDocument();+ expect(screen.getByText('Connected')).toBeInTheDocument();+ expect(screen.getByText('GPT 5')).toBeInTheDocument();+ expect(screen.getByLabelText('Model icon')).toBeInTheDocument();++ fireEvent.click(screen.getByRole('button', { name: 'Attach' }));+ fireEvent.click(screen.getByRole('button', { name: 'Send message' }));+ expect(onAttach).toHaveBeenCalledOnce();+ expect(onSubmit).toHaveBeenCalledOnce();+ });++ it('shows the running cancel action and delegates cancellation', () => {+ const onSubmit = vi.fn();+ const onCancel = vi.fn();+ render(+ <ComposerShell+ input={<textarea aria-label="Message" />}+ disabled+ canSubmit={false}+ isRunning+ onSubmit={onSubmit}+ onCancel={onCancel}+ />,+ );++ expect(screen.queryByRole('button', { name: 'Send message' })).not.toBeInTheDocument();+ const cancelButton = screen.getByRole('button', { name: 'Cancel' });+ expect(cancelButton).toBeEnabled();+ fireEvent.click(cancelButton);+ expect(onCancel).toHaveBeenCalledOnce();+ expect(onSubmit).not.toHaveBeenCalled();+ });++ it('omits optional composer chrome when labels and attachment handling are absent', () => {+ render(+ <ComposerShell input={<input aria-label="Message" />} disabled={false} canSubmit={false} onSubmit={() => {}} />,+ );++ expect(screen.queryByRole('button', { name: 'Attach' })).not.toBeInTheDocument();+ expect(screen.queryByText('Connected')).not.toBeInTheDocument();+ expect(screen.getByRole('button', { name: 'Send message' })).toBeDisabled();+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/HistoryLoader.test.tsx b/packages/trueforge-ui-sdk/test/atoms/HistoryLoader.test.tsxnew file mode 100644index 000000000..6876ed102--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/HistoryLoader.test.tsx@@ -0,0 +1,26 @@+import { render, screen } from '@testing-library/react';+import { createRef } from 'react';+import { describe, expect, it } from 'vitest';++import { HistoryLoader } from '@/atoms/HistoryLoader.js';++describe('HistoryLoader', () => {+ it('describes the idle sentinel without showing a spinner', () => {+ const ref = createRef<HTMLDivElement>();+ render(<HistoryLoader ref={ref} className="host-loader" data-testid="history-loader" />);++ const loader = screen.getByRole('status', { name: 'Scroll up to load older messages' });+ expect(loader).toBe(ref.current);+ expect(loader).toHaveAttribute('aria-live', 'polite');+ expect(loader).toHaveAttribute('data-slot', 'aui_history-loader');+ expect(loader).toHaveClass('host-loader');+ expect(screen.queryByRole('status', { name: 'Loading' })).not.toBeInTheDocument();+ });++ it('announces loading and displays a spinner', () => {+ render(<HistoryLoader isLoading />);++ expect(screen.getByRole('status', { name: 'Loading older messages' })).toBeInTheDocument();+ expect(screen.getByRole('status', { name: 'Loading' })).toHaveAttribute('width', '14');+ });+});diff --git a/packages/trueforge-ui-sdk/src/atoms/Markdown.test.tsx b/packages/trueforge-ui-sdk/test/atoms/Markdown.test.tsxsimilarity index 96%rename from packages/trueforge-ui-sdk/src/atoms/Markdown.test.tsxrename to packages/trueforge-ui-sdk/test/atoms/Markdown.test.tsxindex 9dc2e2b1d..da7540c73 100644--- a/packages/trueforge-ui-sdk/src/atoms/Markdown.test.tsx+++ b/packages/trueforge-ui-sdk/test/atoms/Markdown.test.tsx@@ -2,7 +2,7 @@import { render, screen, waitFor } from '@testing-library/react';import { describe, expect, it } from 'vitest';-import { Markdown } from './Markdown.js';+import { Markdown } from '@/atoms/Markdown.js';// @openuidev mocks are in testSetup.ts; they make OpenUiFenceBlock render// a simple div with data-testid="aui-openui-renderer" synchronously.diff --git a/packages/trueforge-ui-sdk/test/atoms/MessageActionBar.test.tsx b/packages/trueforge-ui-sdk/test/atoms/MessageActionBar.test.tsxnew file mode 100644index 000000000..100163270--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/MessageActionBar.test.tsx@@ -0,0 +1,24 @@+import { fireEvent, render, screen } from '@testing-library/react';+import { describe, expect, it, vi } from 'vitest';++import { MessageActionBar } from '@/atoms/MessageActionBar.js';++describe('MessageActionBar', () => {+ it('invokes copy and switches from copy to confirmation state', () => {+ const onCopy = vi.fn();+ const { rerender } = render(+ <MessageActionBar isCopied={false} onCopy={onCopy} createdAt="2026-04-05T14:03:02.000Z" className="host-bar" />,+ );++ const copyButton = screen.getByRole('button', { name: 'Copy' });+ expect(copyButton).toHaveAttribute('title', 'Copy');+ expect(copyButton.querySelector('svg')).toHaveClass('lucide-copy');+ expect(copyButton.parentElement).toHaveClass('aui-assistant-action-bar-root', 'host-bar');++ fireEvent.click(copyButton);+ expect(onCopy).toHaveBeenCalledOnce();++ rerender(<MessageActionBar isCopied onCopy={onCopy} />);+ expect(screen.getByRole('button', { name: 'Copy' }).querySelector('svg')).toHaveClass('lucide-check');+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/MessageErrorBanner.test.tsx b/packages/trueforge-ui-sdk/test/atoms/MessageErrorBanner.test.tsxnew file mode 100644index 000000000..03fad057f--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/MessageErrorBanner.test.tsx@@ -0,0 +1,15 @@+import { render, screen } from '@testing-library/react';+import { describe, expect, it } from 'vitest';++import { MessageErrorBanner } from '@/atoms/MessageErrorBanner.js';++describe('MessageErrorBanner', () => {+ it('announces the supplied error and preserves host styling', () => {+ render(<MessageErrorBanner message="The response could not be generated" className="host-error" />);++ const alert = screen.getByRole('alert');+ expect(alert).toHaveTextContent('The response could not be generated');+ expect(alert).toHaveClass('aui-message-error-root', 'host-error');+ expect(alert.firstElementChild).toHaveClass('aui-message-error-message', 'line-clamp-2');+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/MessageIndicator.test.tsx b/packages/trueforge-ui-sdk/test/atoms/MessageIndicator.test.tsxnew file mode 100644index 000000000..2ae551cfd--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/MessageIndicator.test.tsx@@ -0,0 +1,15 @@+import { render, screen } from '@testing-library/react';+import { describe, expect, it } from 'vitest';++import { MessageIndicator } from '@/atoms/MessageIndicator.js';++describe('MessageIndicator', () => {+ it('provides an accessible working state and preserves host styling', () => {+ render(<MessageIndicator className="host-indicator" />);++ const indicator = screen.getByLabelText('Assistant is working');+ expect(indicator).toHaveTextContent('●');+ expect(indicator).toHaveAttribute('data-slot', 'aui_assistant-message-indicator');+ expect(indicator).toHaveClass('animate-pulse', 'host-indicator');+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/MessageTimestamp.test.tsx b/packages/trueforge-ui-sdk/test/atoms/MessageTimestamp.test.tsxnew file mode 100644index 000000000..e54d5af12--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/MessageTimestamp.test.tsx@@ -0,0 +1,56 @@+import { fireEvent, render, screen } from '@testing-library/react';+import { describe, expect, it } from 'vitest';++import { MessageTimestamp } from '@/atoms/MessageTimestamp.js';++const createdAt = new Date('2026-04-05T14:03:02.000Z');++function expectedTime(date: Date): string {+ return new Intl.DateTimeFormat(undefined, {+ hour: '2-digit',+ minute: '2-digit',+ second: '2-digit',+ hour12: true,+ }).format(date);+}++function expectedFullDate(date: Date): string {+ return new Intl.DateTimeFormat(undefined, {+ month: 'short',+ day: 'numeric',+ year: 'numeric',+ hour: 'numeric',+ minute: '2-digit',+ hour12: true,+ }).format(date);+}++describe('MessageTimestamp', () => {+ it('renders Date and ISO string values using the local time format', () => {+ const { rerender } = render(<MessageTimestamp createdAt={createdAt} className="host-timestamp" />);++ expect(screen.getByText(expectedTime(createdAt))).toHaveClass('host-timestamp');++ rerender(<MessageTimestamp createdAt={createdAt.toISOString()} />);+ expect(screen.getByText(expectedTime(createdAt))).toBeInTheDocument();+ });++ it('shows the full date in a tooltip on focus', () => {+ render(<MessageTimestamp createdAt={createdAt} />);+ const timestamp = screen.getByText(expectedTime(createdAt));++ fireEvent.focus(timestamp);++ expect(screen.getByRole('tooltip')).toHaveTextContent(expectedFullDate(createdAt));+ fireEvent.blur(timestamp);+ expect(screen.queryByRole('tooltip')).not.toBeInTheDocument();+ });++ it('renders nothing for missing or invalid dates', () => {+ const { container, rerender } = render(<MessageTimestamp />);+ expect(container).toBeEmptyDOMElement();++ rerender(<MessageTimestamp createdAt="not-a-date" />);+ expect(container).toBeEmptyDOMElement();+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/MonacoEditorCore.test.tsx b/packages/trueforge-ui-sdk/test/atoms/MonacoEditorCore.test.tsxnew file mode 100644index 000000000..5bb9a4bc3--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/MonacoEditorCore.test.tsx@@ -0,0 +1,130 @@+// @vitest-environment jsdom+import { act, render, waitFor } from '@testing-library/react';+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';++import { MonacoEditorCore } from '@/atoms/MonacoEditorCore.js';++const monacoMocks = vi.hoisted(() => {+ let changeListener: (() => void) | undefined;+ let sizeListener: (() => void) | undefined;++ const changeDisposable = { dispose: vi.fn() };+ const sizeDisposable = { dispose: vi.fn() };+ const editor = {+ getValue: vi.fn(() => 'initial value'),+ setValue: vi.fn(),+ getContentHeight: vi.fn(() => 72),+ onDidChangeModelContent: vi.fn((listener: () => void) => {+ changeListener = listener;+ return changeDisposable;+ }),+ onDidContentSizeChange: vi.fn((listener: () => void) => {+ sizeListener = listener;+ return sizeDisposable;+ }),+ updateOptions: vi.fn(),+ dispose: vi.fn(),+ layout: vi.fn(),+ };+ const editorApi = {+ create: vi.fn(() => editor),+ defineTheme: vi.fn(),+ setTheme: vi.fn(),+ };++ return {+ module: { editor: editorApi },+ editor,+ editorApi,+ changeDisposable,+ sizeDisposable,+ invokeChange: () => changeListener?.(),+ invokeSizeChange: () => sizeListener?.(),+ };+});++vi.mock('monaco-editor', () => monacoMocks.module);++describe('MonacoEditorCore', () => {+ beforeEach(() => {+ vi.clearAllMocks();+ monacoMocks.editor.getValue.mockReturnValue('initial value');+ monacoMocks.editor.getContentHeight.mockReturnValue(72);+ vi.stubGlobal('requestAnimationFrame', (callback: FrameRequestCallback) => {+ callback(0);+ return 1;+ });+ });++ afterEach(() => vi.unstubAllGlobals());++ it('creates Monaco with consumer options and forwards lifecycle and change callbacks', async () => {+ const beforeMount = vi.fn();+ const onMount = vi.fn();+ const onChange = vi.fn();+ const { unmount } = render(+ <MonacoEditorCore+ value="initial value"+ language="typescript"+ theme="custom-theme"+ options={{ readOnly: true, lineNumbers: 'off' }}+ beforeMount={beforeMount}+ onMount={onMount}+ onChange={onChange}+ />,+ );++ await waitFor(() => expect(monacoMocks.editorApi.create).toHaveBeenCalledOnce());+ expect(monacoMocks.editorApi.defineTheme).toHaveBeenCalledTimes(2);+ expect(beforeMount).toHaveBeenCalledWith(monacoMocks.module);+ expect(monacoMocks.editorApi.create).toHaveBeenCalledWith(+ expect.any(HTMLElement),+ expect.objectContaining({+ value: 'initial value',+ language: 'typescript',+ theme: 'custom-theme',+ readOnly: true,+ lineNumbers: 'off',+ }),+ );+ expect(onMount).toHaveBeenCalledWith(monacoMocks.editor, monacoMocks.module);++ monacoMocks.editor.getValue.mockReturnValue('edited value');+ act(() => monacoMocks.invokeChange());+ expect(onChange).toHaveBeenCalledWith('edited value');++ unmount();+ expect(monacoMocks.changeDisposable.dispose).toHaveBeenCalledOnce();+ expect(monacoMocks.editor.dispose).toHaveBeenCalledOnce();+ });++ it('syncs external values without recreating the editor', async () => {+ const { rerender } = render(<MonacoEditorCore value="first" />);+ await waitFor(() => expect(monacoMocks.editorApi.create).toHaveBeenCalledOnce());++ monacoMocks.editor.getValue.mockReturnValue('first');+ rerender(<MonacoEditorCore value="second" />);++ await waitFor(() => expect(monacoMocks.editor.setValue).toHaveBeenCalledWith('second'));+ expect(monacoMocks.editorApi.create).toHaveBeenCalledOnce();+ });++ it('clamps auto-height and responds to Monaco content-size changes', async () => {+ monacoMocks.editor.getContentHeight.mockReturnValue(500);+ const { container, unmount } = render(+ <MonacoEditorCore value={'one\ntwo'} autoHeight minHeight={30} maxHeight={100} />,+ );++ await waitFor(() => expect(monacoMocks.editorApi.create).toHaveBeenCalledOnce());+ const editorContainer = container.querySelector('.aui-monaco');+ expect(editorContainer).toHaveStyle({ height: '100px' });+ expect(monacoMocks.editor.layout).toHaveBeenCalled();++ monacoMocks.editor.getContentHeight.mockReturnValue(10);+ act(() => monacoMocks.invokeSizeChange());+ expect(editorContainer).toHaveStyle({ height: '30px' });++ unmount();+ expect(monacoMocks.sizeDisposable.dispose).toHaveBeenCalledOnce();+ });+});diff --git a/packages/trueforge-ui-sdk/src/atoms/NamedAgentHeaderLabel.test.tsx b/packages/trueforge-ui-sdk/test/atoms/NamedAgentHeaderLabel.test.tsxsimilarity index 90%rename from packages/trueforge-ui-sdk/src/atoms/NamedAgentHeaderLabel.test.tsxrename to packages/trueforge-ui-sdk/test/atoms/NamedAgentHeaderLabel.test.tsxindex fc313cc7a..5f0bbbadb 100644--- a/packages/trueforge-ui-sdk/src/atoms/NamedAgentHeaderLabel.test.tsx+++ b/packages/trueforge-ui-sdk/test/atoms/NamedAgentHeaderLabel.test.tsx@@ -2,8 +2,8 @@import { act, render, screen } from '@testing-library/react';import { describe, expect, it } from 'vitest';-import { ShellModeProvider, useShellMode } from '../server/ShellModeContext.js';-import { NamedAgentHeaderLabel } from './NamedAgentHeaderLabel.js';+import { NamedAgentHeaderLabel } from '@/atoms/NamedAgentHeaderLabel.js';+import { ShellModeProvider, useShellMode } from '@/server/ShellModeContext.js';function SelectNamed() {const shell = useShellMode();diff --git a/packages/trueforge-ui-sdk/test/atoms/OpenUiFenceBlock.test.tsx b/packages/trueforge-ui-sdk/test/atoms/OpenUiFenceBlock.test.tsxnew file mode 100644index 000000000..fd6589ab1--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/OpenUiFenceBlock.test.tsx@@ -0,0 +1,53 @@+// @vitest-environment jsdom+import { render, screen } from '@testing-library/react';+import type { ReactNode } from 'react';+import { describe, expect, it, vi } from 'vitest';++import { OpenUiFenceBlock } from '@/atoms/OpenUiFenceBlock.js';++const openUiMocks = vi.hoisted(() => ({+ library: { name: 'test-openui-library' },+ renderer: vi.fn(),+}));++vi.mock('@openuidev/react-lang', () => ({+ Renderer: ({ response, library, isStreaming }: { response: string; library: unknown; isStreaming?: boolean }) => {+ openUiMocks.renderer({ response, library, isStreaming });+ return (+ <div data-testid="openui-renderer" data-streaming={String(Boolean(isStreaming))}>+ {response}+ </div>+ );+ },+}));++vi.mock('@openuidev/react-ui', () => ({+ ThemeProvider: ({ mode, children }: { mode: string; children: ReactNode }) => (+ <div data-testid="openui-theme" data-mode={mode}>+ {children}+ </div>+ ),+ openuiLibrary: openUiMocks.library,+}));++describe('OpenUiFenceBlock', () => {+ it('passes content, streaming state, and the OpenUI library to the renderer', () => {+ render(<OpenUiFenceBlock content='{"type":"Text","text":"Working"}' isStreaming />);++ expect(screen.getByTestId('openui-renderer')).toHaveTextContent('{"type":"Text","text":"Working"}');+ expect(screen.getByTestId('openui-renderer')).toHaveAttribute('data-streaming', 'true');+ expect(openUiMocks.renderer).toHaveBeenCalledWith({+ response: '{"type":"Text","text":"Working"}',+ library: openUiMocks.library,+ isStreaming: true,+ });+ });++ it('selects light and dark OpenUI themes from the public prop', () => {+ const { rerender } = render(<OpenUiFenceBlock content="content" />);+ expect(screen.getByTestId('openui-theme')).toHaveAttribute('data-mode', 'light');++ rerender(<OpenUiFenceBlock content="content" darkTheme />);+ expect(screen.getByTestId('openui-theme')).toHaveAttribute('data-mode', 'dark');+ });+});diff --git a/packages/trueforge-ui-sdk/src/atoms/SandboxArtifactDownload.test.tsx b/packages/trueforge-ui-sdk/test/atoms/SandboxArtifactDownload.test.tsxsimilarity index 93%rename from packages/trueforge-ui-sdk/src/atoms/SandboxArtifactDownload.test.tsxrename to packages/trueforge-ui-sdk/test/atoms/SandboxArtifactDownload.test.tsxindex 48a20e49f..fe7fa8b78 100644--- a/packages/trueforge-ui-sdk/src/atoms/SandboxArtifactDownload.test.tsx+++ b/packages/trueforge-ui-sdk/test/atoms/SandboxArtifactDownload.test.tsx@@ -2,10 +2,10 @@import { act, render, screen } from '@testing-library/react';import { describe, expect, it, vi } from 'vitest';-import { SlotsProvider } from '../theme/SlotsProvider.js';-import { ThemeProvider } from '../theme/ThemeProvider.js';-import { Markdown } from './Markdown.js';-import { parseSandboxArtifacts, SandboxArtifactDownload } from './SandboxArtifactDownload.js';+import { Markdown } from '@/atoms/Markdown.js';+import { parseSandboxArtifacts, SandboxArtifactDownload } from '@/atoms/SandboxArtifactDownload.js';+import { SlotsProvider } from '@/theme/SlotsProvider.js';+import { ThemeProvider } from '@/theme/ThemeProvider.js';describe('parseSandboxArtifacts', () => {it('parses tfy markdown-link pairs', () => {diff --git a/packages/trueforge-ui-sdk/test/atoms/SandboxToolCallCard.test.tsx b/packages/trueforge-ui-sdk/test/atoms/SandboxToolCallCard.test.tsxnew file mode 100644index 000000000..19ad90c27--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/SandboxToolCallCard.test.tsx@@ -0,0 +1,110 @@+// @vitest-environment jsdom+import { fireEvent, render, screen } from '@testing-library/react';+import { describe, expect, it, vi } from 'vitest';++import { SandboxToolCallCard } from '@/atoms/SandboxToolCallCard.js';++vi.mock('@/atoms/MonacoEditorCore.js', () => ({+ MonacoEditorCore: ({ value, options }: { value: string; options?: Record<string, unknown> }) => (+ <div data-testid="sandbox-json" data-read-only={String(options?.readOnly)}>+ {value}+ </div>+ ),+}));++describe('SandboxToolCallCard', () => {+ it('uses intent as the title, reports running duration, and toggles expansion', () => {+ const onToggle = vi.fn();+ render(+ <SandboxToolCallCard+ name="run_command"+ intent="Install dependencies"+ status="running"+ expanded={false}+ onToggle={onToggle}+ durationText="3s"+ hasContent+ command="pnpm install"+ />,+ );++ expect(screen.getByText('Install dependencies')).toBeInTheDocument();+ expect(screen.getByText('3s')).toBeInTheDocument();+ expect(screen.queryByText('pnpm install')).not.toBeInTheDocument();++ fireEvent.click(screen.getByRole('button', { name: 'Expand step' }));+ expect(onToggle).toHaveBeenCalledOnce();+ });++ it('renders terminal output, exit status, and controlled view-mode callbacks', () => {+ const onViewModeChange = vi.fn();+ render(+ <SandboxToolCallCard+ name="run_command"+ status="success"+ expanded+ onToggle={() => {}}+ command="echo hello"+ resultText="hello"+ exitCode={0}+ hasContent+ viewMode="terminal"+ onViewModeChange={onViewModeChange}+ dataTestPrefix="sandbox"+ />,+ );++ expect(screen.getByText('echo hello')).toBeInTheDocument();+ expect(screen.getByText('hello')).toBeInTheDocument();+ expect(screen.getByTestId('sandbox-exit-code')).toHaveTextContent('exit: 0');+ expect(screen.getByRole('button', { name: 'Terminal View' })).toHaveAttribute('aria-pressed', 'true');++ fireEvent.click(screen.getByRole('button', { name: 'Code View' }));+ expect(onViewModeChange).toHaveBeenCalledWith('code');+ });++ it('renders read-only argument and result JSON in code view', () => {+ const { container } = render(+ <SandboxToolCallCard+ name="run_command"+ status="error"+ expanded+ onToggle={() => {}}+ argsJson='{"command":"false"}'+ resultJson='{"error":"failed"}'+ exitCode={1}+ hasContent+ viewMode="code"+ dataTestPrefix="sandbox"+ />,+ );++ expect(screen.getByText('Arguments')).toBeInTheDocument();+ expect(screen.getByText('Result')).toBeInTheDocument();+ expect(screen.getAllByTestId('sandbox-json')).toHaveLength(2);+ for (const editor of screen.getAllByTestId('sandbox-json')) {+ expect(editor).toHaveAttribute('data-read-only', 'true');+ }+ expect(container.querySelector('svg.text-destructive')).toBeInTheDocument();+ expect(screen.getByTestId('sandbox-exit-code')).toHaveTextContent('exit: 1');+ });++ it('keeps the sandbox body empty when hasContent is false', () => {+ render(+ <SandboxToolCallCard+ name="run_command"+ status="success"+ expanded+ onToggle={() => {}}+ command="hidden command"+ resultText="hidden result"+ hasContent={false}+ dataTestPrefix="sandbox"+ />,+ );++ expect(screen.getByTestId('sandbox-sandbox')).toBeInTheDocument();+ expect(screen.queryByText('hidden command')).not.toBeInTheDocument();+ expect(screen.queryByText('hidden result')).not.toBeInTheDocument();+ });+});diff --git a/packages/trueforge-ui-sdk/src/atoms/SaveAgentButton.test.tsx b/packages/trueforge-ui-sdk/test/atoms/SaveAgentButton.test.tsxsimilarity index 90%rename from packages/trueforge-ui-sdk/src/atoms/SaveAgentButton.test.tsxrename to packages/trueforge-ui-sdk/test/atoms/SaveAgentButton.test.tsxindex 626cea202..79a6d14e0 100644--- a/packages/trueforge-ui-sdk/src/atoms/SaveAgentButton.test.tsx+++ b/packages/trueforge-ui-sdk/test/atoms/SaveAgentButton.test.tsx@@ -3,11 +3,11 @@ import { fireEvent, render, screen, waitFor } from '@testing-library/react';import { useEffect, useRef } from 'react';import { beforeAll, describe, expect, it, vi } from 'vitest';-import { ServerProvider } from '../server/ServerContext.js';-import { ShellModeProvider, useShellMode } from '../server/ShellModeContext.js';-import type { AgentUIServer } from '../server/types.js';-import { SlotsProvider } from '../theme/SlotsProvider.js';-import { SaveAgentButton } from './SaveAgentButton.js';+import { SaveAgentButton } from '@/atoms/SaveAgentButton.js';+import { ServerProvider } from '@/server/ServerContext.js';+import { ShellModeProvider, useShellMode } from '@/server/ShellModeContext.js';+import { SlotsProvider } from '@/theme/SlotsProvider.js';+import { createMockAgentUIServer } from '../server/mockServer.js';vi.mock('@truefoundry/assistant-ui-runtime', () => ({useTrueFoundryAgentSpec: () => ({@@ -28,8 +28,16 @@ beforeAll(() => {};});-function mockServer(saveAgent = vi.fn(async () => ({ ok: true }))): AgentUIServer {- return { saveAgent } as unknown as AgentUIServer;+function mockServer(saveAgent = vi.fn(async () => ({ ok: true }))) {+ return createMockAgentUIServer({ saveAgent });+}++function getSubmitButton(dialog: HTMLElement): HTMLButtonElement {+ const button = dialog.querySelector<HTMLButtonElement>('button[type="submit"]');+ if (button === null) {+ throw new Error('Expected submit button');+ }+ return button;}describe('SaveAgentButton', () => {@@ -73,7 +81,7 @@ describe('SaveAgentButton', () => {fireEvent.change(screen.getByLabelText('System instructions'), {target: { value: ' You write release notes. ' },});- fireEvent.click(dialog.querySelector('button[type="submit"]')!);+ fireEvent.click(getSubmitButton(dialog));await waitFor(() => {expect(saveAgent).toHaveBeenCalledWith({@@ -164,7 +172,7 @@ describe('SaveAgentButton', () => {fireEvent.click(screen.getByRole('button', { name: 'Save as agent' }));const dialog = screen.getByRole('dialog', { name: 'Save as agent' });fireEvent.change(screen.getByLabelText('Name'), { target: { value: 'dup' } });- fireEvent.click(dialog.querySelector('button[type="submit"]')!);+ fireEvent.click(getSubmitButton(dialog));await waitFor(() => {expect(screen.getByText('Name taken')).toBeInTheDocument();diff --git a/packages/trueforge-ui-sdk/test/atoms/ScrollToBottomButton.test.tsx b/packages/trueforge-ui-sdk/test/atoms/ScrollToBottomButton.test.tsxnew file mode 100644index 000000000..5907f50f2--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/ScrollToBottomButton.test.tsx@@ -0,0 +1,33 @@+import { fireEvent, render, screen } from '@testing-library/react';+import { createRef } from 'react';+import { describe, expect, it, vi } from 'vitest';++import { ScrollToBottomButton } from '@/atoms/ScrollToBottomButton.js';++describe('ScrollToBottomButton', () => {+ it('forwards button props, invokes clicks, and exposes its positioning wrapper ref', () => {+ const onClick = vi.fn();+ const ref = createRef<HTMLSpanElement>();+ render(<ScrollToBottomButton ref={ref} onClick={onClick} className="host-scroll-button" data-track="scroll" />);++ const button = screen.getByRole('button', { name: 'Scroll to bottom' });+ expect(button).toHaveAttribute('type', 'button');+ expect(button).toHaveAttribute('title', 'Scroll to bottom');+ expect(button).toHaveAttribute('data-track', 'scroll');+ expect(button).toHaveClass('aui-thread-scroll-to-bottom', 'host-scroll-button');+ expect(button.querySelector('svg')).toHaveClass('lucide-arrow-down');+ expect(ref.current).toBe(button.parentElement);++ fireEvent.click(button);+ expect(onClick).toHaveBeenCalledOnce();+ });++ it('does not render while disabled', () => {+ const onClick = vi.fn();+ const { container } = render(<ScrollToBottomButton disabled onClick={onClick} />);++ expect(container).toBeEmptyDOMElement();+ expect(screen.queryByRole('button', { name: 'Scroll to bottom' })).not.toBeInTheDocument();+ expect(onClick).not.toHaveBeenCalled();+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/Skeletons.test.tsx b/packages/trueforge-ui-sdk/test/atoms/Skeletons.test.tsxnew file mode 100644index 000000000..5a6ea7751--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/Skeletons.test.tsx@@ -0,0 +1,17 @@+import { render, screen } from '@testing-library/react';+import { describe, expect, it } from 'vitest';++import { MessageListSkeleton } from '@/atoms/Skeletons.js';++describe('MessageListSkeleton', () => {+ it('announces conversation loading and renders message-shaped placeholders', () => {+ const { container } = render(<MessageListSkeleton className="host-skeleton" />);++ const status = screen.getByRole('status', { name: 'Loading conversation' });+ expect(status).toHaveAttribute('data-slot', 'aui_thread-history-skeleton');+ expect(status).toHaveClass('host-skeleton');+ expect(container.querySelectorAll('.animate-pulse')).toHaveLength(4);+ expect(container.querySelector('.justify-end .h-10')).toBeInTheDocument();+ expect(container.querySelectorAll('.px-2 .h-4')).toHaveLength(3);+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/SubAgentCard.test.tsx b/packages/trueforge-ui-sdk/test/atoms/SubAgentCard.test.tsxnew file mode 100644index 000000000..2788d79b1--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/SubAgentCard.test.tsx@@ -0,0 +1,96 @@+// @vitest-environment jsdom+import { fireEvent, render, screen } from '@testing-library/react';+import type { ComponentProps } from 'react';+import { describe, expect, it, vi } from 'vitest';++import { Markdown } from '@/atoms/Markdown.js';+import { SubAgentCard } from '@/atoms/SubAgentCard.js';+import { SlotsProvider } from '@/theme/SlotsProvider.js';++function MarkdownStub({ content }: ComponentProps<typeof Markdown>) {+ return <div data-testid="instruction-markdown">{content}</div>;+}++function renderCard(props: ComponentProps<typeof SubAgentCard>) {+ return render(+ <SlotsProvider overrides={{ Markdown: MarkdownStub }}>+ <SubAgentCard {...props} />+ </SlotsProvider>,+ );+}++describe('SubAgentCard', () => {+ it('hides collapsed details and invokes the expansion callback', () => {+ const onToggle = vi.fn();+ renderCard({+ agentName: 'Researcher',+ instruction: 'Find primary sources',+ stepCount: 2,+ status: 'running',+ expanded: false,+ onToggle,+ durationText: '12s',+ children: <div>nested steps</div>,+ dataTestPrefix: 'sub',+ });++ expect(screen.getByText('Sub-agent: Researcher')).toBeInTheDocument();+ expect(screen.getByText('12s')).toBeInTheDocument();+ expect(screen.queryByText('Find primary sources')).not.toBeInTheDocument();+ expect(screen.queryByText('nested steps')).not.toBeInTheDocument();++ fireEvent.click(screen.getByRole('button', { name: 'Expand step' }));+ expect(onToggle).toHaveBeenCalledOnce();+ });++ it('renders instructions and nested content when expanded', () => {+ renderCard({+ agentName: 'Coder',+ instruction: 'Implement the fix',+ stepCount: 3,+ status: 'success',+ expanded: true,+ onToggle: () => {},+ children: <div>child tool call</div>,+ dataTestPrefix: 'sub',+ });++ expect(screen.getByTestId('instruction-markdown')).toHaveTextContent('Implement the fix');+ expect(screen.getByTestId('sub-instructions')).toBeInTheDocument();+ expect(screen.getByTestId('sub-nested-content')).toHaveTextContent('child tool call');+ expect(screen.getByTestId('sub-success-icon')).toBeInTheDocument();+ });++ it('uses a custom instruction renderer and maps error status', () => {+ const renderInstruction = vi.fn((instruction: string) => <strong>Custom: {instruction}</strong>);+ const { container } = renderCard({+ agentName: 'Reviewer',+ instruction: 'Review changes',+ stepCount: 1,+ status: 'error',+ expanded: true,+ onToggle: () => {},+ renderInstruction,+ dataTestPrefix: 'sub',+ });++ expect(renderInstruction).toHaveBeenCalledWith('Review changes');+ expect(screen.getByText('Custom: Review changes')).toBeInTheDocument();+ expect(container.querySelector('svg.text-destructive')).toBeInTheDocument();+ });++ it('omits the instruction section for whitespace-only instructions', () => {+ renderCard({+ agentName: 'Idle',+ instruction: ' ',+ stepCount: 0,+ status: 'success',+ expanded: true,+ onToggle: () => {},+ dataTestPrefix: 'sub',+ });++ expect(screen.queryByText('Instructions')).not.toBeInTheDocument();+ expect(screen.queryByTestId('sub-instructions')).not.toBeInTheDocument();+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/SyntaxHighlighter.test.tsx b/packages/trueforge-ui-sdk/test/atoms/SyntaxHighlighter.test.tsxnew file mode 100644index 000000000..2a9801917--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/SyntaxHighlighter.test.tsx@@ -0,0 +1,73 @@+// @vitest-environment jsdom+import { render, screen } from '@testing-library/react';+import type { ComponentType, ReactNode } from 'react';+import { describe, expect, it, vi } from 'vitest';++import { SyntaxHighlighter } from '@/atoms/SyntaxHighlighter.js';++const syntaxMocks = vi.hoisted(() => ({+ dark: { name: 'dark' },+ light: { name: 'light' },+}));++vi.mock('react-syntax-highlighter/dist/esm/styles/prism', () => ({+ oneDark: syntaxMocks.dark,+ oneLight: syntaxMocks.light,+}));++vi.mock('react-syntax-highlighter', () => ({+ Prism: ({+ children,+ language,+ style,+ showLineNumbers,+ PreTag,+ CodeTag,+ }: {+ children?: ReactNode;+ language?: string;+ style?: unknown;+ showLineNumbers?: boolean;+ PreTag?: ComponentType<{ children?: ReactNode; className?: string }>;+ CodeTag?: ComponentType<{ children?: ReactNode; className?: string }>;+ }) => (+ <div+ data-testid="syntax-engine"+ data-language={language}+ data-theme={style === syntaxMocks.dark ? 'dark' : 'light'}+ data-line-numbers={String(Boolean(showLineNumbers))}+ >+ {PreTag ? (+ <PreTag className="engine-pre">+ {CodeTag ? <CodeTag className="engine-code">{children}</CodeTag> : children}+ </PreTag>+ ) : (+ children+ )}+ </div>+ ),+}));++describe('SyntaxHighlighter', () => {+ it('passes code, language, and line-number behavior to the highlighting engine', () => {+ render(<SyntaxHighlighter code={'const x = 1;\nconsole.log(x);'} language="typescript" showLineNumbers />);++ const highlighter = screen.getByTestId('syntax-engine');+ expect(highlighter).toHaveAttribute('data-language', 'typescript');+ expect(highlighter).toHaveAttribute('data-line-numbers', 'true');+ expect(highlighter).toHaveTextContent('const x = 1;');+ expect(highlighter).toHaveTextContent('console.log(x);');+ expect(highlighter.querySelector('pre')).toHaveClass('engine-pre', 'max-w-full', 'overflow-x-auto');+ expect(highlighter.querySelector('code')).toHaveClass('engine-code');+ });++ it('switches the highlighting theme and preserves consumer classes', () => {+ const { container, rerender } = render(<SyntaxHighlighter code="value" className="consumer-class" />);++ expect(screen.getByTestId('syntax-engine')).toHaveAttribute('data-theme', 'light');+ expect(container.querySelector('.aui-syntax-highlighter')).toHaveClass('consumer-class');++ rerender(<SyntaxHighlighter code="value" darkTheme className="consumer-class" />);+ expect(screen.getByTestId('syntax-engine')).toHaveAttribute('data-theme', 'dark');+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/ThreadListMisc.test.tsx b/packages/trueforge-ui-sdk/test/atoms/ThreadListMisc.test.tsxnew file mode 100644index 000000000..955a864e1--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/ThreadListMisc.test.tsx@@ -0,0 +1,86 @@+import { fireEvent, render, screen } from '@testing-library/react';+import { describe, expect, it, vi } from 'vitest';++import {+ ThreadListEmptyState,+ ThreadListNewButton,+ ThreadListRowSkeleton,+ ThreadListShell,+} from '@/atoms/ThreadListMisc.js';++describe('ThreadListNewButton', () => {+ it('renders the default accessible action and forwards button behavior', () => {+ const onClick = vi.fn();+ render(<ThreadListNewButton onClick={onClick} className="consumer-class" />);++ const button = screen.getByRole('button', { name: 'Start new chat' });+ expect(button).toHaveAttribute('type', 'button');+ expect(button).toHaveTextContent('New Chat');+ expect(button).toHaveClass('consumer-class');+ expect(button).toHaveStyle({ borderRadius: 'var(--thread-list-item-radius, 0.5rem)' });+ fireEvent.click(button);+ expect(onClick).toHaveBeenCalledOnce();+ });++ it('accepts custom content and native disabled state while preserving consumer styles', () => {+ const onClick = vi.fn();+ render(+ <ThreadListNewButton disabled onClick={onClick} style={{ borderRadius: '2rem', color: 'red' }}>+ Start over+ </ThreadListNewButton>,+ );++ const button = screen.getByRole('button', { name: 'Start new chat' });+ expect(button).toHaveTextContent('Start over');+ expect(button).toHaveStyle({ borderRadius: '2rem', color: 'rgb(255, 0, 0)' });+ expect(button).toBeDisabled();+ fireEvent.click(button);+ expect(onClick).not.toHaveBeenCalled();+ });+});++describe('ThreadListRowSkeleton', () => {+ it('announces loading and renders the requested number of skeleton rows', () => {+ const { rerender } = render(<ThreadListRowSkeleton count={3} className="consumer-class" />);++ const status = screen.getByRole('status', { name: 'Loading threads' });+ expect(status).toHaveClass('consumer-class');+ expect(status.querySelectorAll('.animate-pulse')).toHaveLength(3);++ rerender(<ThreadListRowSkeleton count={1} />);+ expect(screen.getByRole('status', { name: 'Loading threads' }).querySelectorAll('.animate-pulse')).toHaveLength(1);+ });++ it('uses five rows by default', () => {+ render(<ThreadListRowSkeleton />);+ expect(screen.getByRole('status', { name: 'Loading threads' }).querySelectorAll('.animate-pulse')).toHaveLength(5);+ });+});++describe('ThreadListEmptyState', () => {+ it('renders the default and custom empty messages', () => {+ const { rerender } = render(<ThreadListEmptyState className="consumer-class" />);+ expect(screen.getByText('No threads yet')).toHaveClass('consumer-class');++ rerender(<ThreadListEmptyState message="No matching conversations" />);+ expect(screen.getByText('No matching conversations')).toBeInTheDocument();+ expect(screen.queryByText('No threads yet')).not.toBeInTheDocument();+ });+});++describe('ThreadListShell', () => {+ it('keeps header and history-owned overflow in separate regions', () => {+ const { container } = render(+ <ThreadListShell header={<button type="button">Create thread</button>} className="consumer-class">+ <a href="/threads/one">Thread one</a>+ </ThreadListShell>,+ );++ const root = container.firstElementChild;+ expect(root).toHaveClass('consumer-class');+ expect(root?.children).toHaveLength(2);+ expect(root?.children[0]).toContainElement(screen.getByRole('button', { name: 'Create thread' }));+ expect(root?.children[1]).toContainElement(screen.getByRole('link', { name: 'Thread one' }));+ expect(root?.children[1]).toHaveClass('overflow-hidden');+ });+});diff --git a/packages/trueforge-ui-sdk/src/atoms/ThreadListRow.test.tsx b/packages/trueforge-ui-sdk/test/atoms/ThreadListRow.test.tsxsimilarity index 95%rename from packages/trueforge-ui-sdk/src/atoms/ThreadListRow.test.tsxrename to packages/trueforge-ui-sdk/test/atoms/ThreadListRow.test.tsxindex 3b3f8cf9d..e490e5ae1 100644--- a/packages/trueforge-ui-sdk/src/atoms/ThreadListRow.test.tsx+++ b/packages/trueforge-ui-sdk/test/atoms/ThreadListRow.test.tsx@@ -2,9 +2,9 @@import { fireEvent, render, screen } from '@testing-library/react';import { describe, expect, it, vi } from 'vitest';-import { SlotsProvider } from '../theme/SlotsProvider.js';-import { ThreadListRow } from './ThreadListRow.js';-import { DropdownMenuItem } from './primitives/DropdownMenu.js';+import { ThreadListRow } from '@/atoms/ThreadListRow.js';+import { DropdownMenuItem } from '@/atoms/primitives/DropdownMenu.js';+import { SlotsProvider } from '@/theme/SlotsProvider.js';describe('ThreadListRow', () => {it('hides actions when omitted', () => {diff --git a/packages/trueforge-ui-sdk/test/atoms/ThreadShell.test.tsx b/packages/trueforge-ui-sdk/test/atoms/ThreadShell.test.tsxnew file mode 100644index 000000000..d5543ff2d--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/ThreadShell.test.tsx@@ -0,0 +1,83 @@+import { render, screen } from '@testing-library/react';+import { createRef } from 'react';+import { describe, expect, it } from 'vitest';++import { MessageGroup, ThreadComposerAreaShell, ThreadRootShell, ThreadViewportShell } from '@/atoms/ThreadShell.js';++describe('ThreadRootShell', () => {+ it('merges host styles over defaults and forwards its ref and attributes', () => {+ const ref = createRef<HTMLDivElement>();+ const hostStyle = Object.assign({ color: 'red' }, { '--thread-max-width': '60rem' });+ render(<ThreadRootShell ref={ref} data-testid="thread-root" className="host-thread" style={hostStyle} />);++ const root = screen.getByTestId('thread-root');+ expect(root).toBe(ref.current);+ expect(root).toHaveClass('aui-thread-root', 'host-thread');+ expect(root.style.getPropertyValue('--thread-max-width')).toBe('60rem');+ expect(root.style.getPropertyValue('--composer-bg')).toBe('var(--card)');+ expect(root.style.color).toBe('red');+ });+});++describe('ThreadViewportShell', () => {+ it('centers empty content and restores message-list spacing when populated', () => {+ const { rerender } = render(+ <ThreadViewportShell isEmpty data-testid="viewport">+ <p>Welcome</p>+ </ThreadViewportShell>,+ );++ const viewport = screen.getByTestId('viewport');+ expect(viewport).toHaveAttribute('data-slot', 'aui_thread-viewport');+ expect(viewport.firstElementChild).toHaveClass('min-h-full', 'justify-center', 'pb-4');+ expect(viewport).toHaveTextContent('Welcome');++ rerender(+ <ThreadViewportShell isEmpty={false} data-testid="viewport">+ <p>Messages</p>+ </ThreadViewportShell>,+ );+ expect(viewport.firstElementChild).toHaveClass('pb-32');+ expect(viewport.firstElementChild).not.toHaveClass('justify-center');+ });+});++describe('ThreadComposerAreaShell', () => {+ it('applies populated-state rounding while forwarding content and attributes', () => {+ const { rerender } = render(+ <ThreadComposerAreaShell isEmpty data-testid="composer" className="host-composer">+ Empty composer+ </ThreadComposerAreaShell>,+ );++ const composer = screen.getByTestId('composer');+ expect(composer).toHaveAttribute('data-slot', 'aui_thread-composer');+ expect(composer).toHaveClass('host-composer');+ expect(composer).not.toHaveClass('rounded-t-(--composer-radius)');++ rerender(+ <ThreadComposerAreaShell isEmpty={false} data-testid="composer">+ Populated composer+ </ThreadComposerAreaShell>,+ );+ expect(composer).toHaveClass('rounded-t-(--composer-radius)');+ expect(composer).toHaveTextContent('Populated composer');+ });+});++describe('MessageGroup', () => {+ it('forwards its ref, children, and host attributes', () => {+ const ref = createRef<HTMLDivElement>();+ render(+ <MessageGroup ref={ref} data-testid="message-group" className="host-group">+ <article>Message one</article>+ </MessageGroup>,+ );++ const group = screen.getByTestId('message-group');+ expect(group).toBe(ref.current);+ expect(group).toHaveAttribute('data-slot', 'aui_message-group');+ expect(group).toHaveClass('empty:hidden', 'host-group');+ expect(group).toContainElement(screen.getByText('Message one'));+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/Toast.test.tsx b/packages/trueforge-ui-sdk/test/atoms/Toast.test.tsxnew file mode 100644index 000000000..79edcb42d--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/Toast.test.tsx@@ -0,0 +1,91 @@+import { act, fireEvent, render, screen } from '@testing-library/react';+import { afterEach, describe, expect, it, vi } from 'vitest';++import { Toast, ToastStack } from '@/atoms/Toast.js';++vi.mock('@/icons/Icon.js', () => ({+ Icon: ({ name }: { name: string }) => <span data-testid={`icon-${name}`} />,+}));++const clipboardDescriptor = Object.getOwnPropertyDescriptor(navigator, 'clipboard');++describe('Toast', () => {+ afterEach(() => {+ vi.useRealTimers();+ if (clipboardDescriptor === undefined) {+ Reflect.deleteProperty(navigator, 'clipboard');+ } else {+ Object.defineProperty(navigator, 'clipboard', clipboardDescriptor);+ }+ });++ it('renders alert content while open and delegates dismissal', () => {+ const onOpenChange = vi.fn();+ render(+ <Toast+ title="Request failed"+ description={'First detail\nSecond detail'}+ open+ onOpenChange={onOpenChange}+ className="consumer-class"+ />,+ );++ const alert = screen.getByRole('alert');+ expect(alert).toHaveClass('consumer-class');+ expect(alert).toHaveTextContent('Request failed');+ expect(alert).toHaveTextContent('First detail Second detail');++ const closeButton = screen.getByRole('button', { name: 'Close' });+ expect(closeButton).toHaveAttribute('title', 'Close');+ fireEvent.click(closeButton);+ expect(onOpenChange).toHaveBeenCalledWith(false);+ });++ it('renders nothing when closed', () => {+ render(<Toast title="Hidden" description="Not visible" open={false} onOpenChange={() => {}} />);+ expect(screen.queryByRole('alert')).not.toBeInTheDocument();+ expect(screen.queryByText('Hidden')).not.toBeInTheDocument();+ });++ it('copies the full error and temporarily exposes copied state', async () => {+ vi.useFakeTimers();+ const writeText = vi.fn(async () => {});+ Object.defineProperty(navigator, 'clipboard', {+ configurable: true,+ value: { writeText },+ });+ render(<Toast title="Copy title" description="Copy body" open onOpenChange={() => {}} />);++ expect(screen.getByTestId('icon-clone')).toBeInTheDocument();+ await act(async () => {+ fireEvent.click(screen.getByRole('button', { name: 'Copy' }));+ await Promise.resolve();+ });++ expect(writeText).toHaveBeenCalledWith('Copy title\nCopy body');+ expect(screen.getByTestId('icon-check')).toBeInTheDocument();++ act(() => {+ vi.advanceTimersByTime(1500);+ });+ expect(screen.getByTestId('icon-clone')).toBeInTheDocument();+ });+});++describe('ToastStack', () => {+ it('renders all children in the fixed non-interactive stack', () => {+ const { container } = render(+ <ToastStack>+ <div>Older toast</div>+ <div>Newer toast</div>+ </ToastStack>,+ );++ const stack = container.firstElementChild;+ expect(stack).toHaveClass('pointer-events-none', 'fixed', 'flex-col-reverse');+ expect(stack?.children).toHaveLength(2);+ expect(stack?.children[0]).toHaveTextContent('Older toast');+ expect(stack?.children[1]).toHaveTextContent('Newer toast');+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/ToolApprovalBar.test.tsx b/packages/trueforge-ui-sdk/test/atoms/ToolApprovalBar.test.tsxnew file mode 100644index 000000000..1884c5c38--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/ToolApprovalBar.test.tsx@@ -0,0 +1,113 @@+// @vitest-environment jsdom+import { fireEvent, render, screen } from '@testing-library/react';+import { describe, expect, it, vi } from 'vitest';++import { ToolApprovalBar, type ApprovalOption } from '@/atoms/ToolApprovalBar.js';++const reasonOption: ApprovalOption = {+ id: 'deny-with-reason',+ label: 'Deny',+ requiresReason: true,+ grants: ['filesystem:read'],+ confirm: {+ title: 'Explain the denial',+ description: 'The agent will receive this reason.',+ },+};++describe('ToolApprovalBar', () => {+ it('submits immediate approve and deny options', () => {+ const onSelect = vi.fn();+ render(+ <ToolApprovalBar+ toolName="shell"+ approveOptions={[{ id: 'allow-once', label: 'Allow once', variant: 'primary' }]}+ denyOptions={[{ id: 'reject', label: 'Reject', variant: 'destructive' }]}+ onSelect={onSelect}+ />,+ );++ fireEvent.click(screen.getByRole('button', { name: 'Allow once' }));+ fireEvent.click(screen.getByRole('button', { name: 'Reject' }));+ expect(onSelect).toHaveBeenNthCalledWith(1, 'allow-once');+ expect(onSelect).toHaveBeenNthCalledWith(2, 'reject');+ });++ it('drives the controlled denial-reason workflow and error state', () => {+ const onDenyOptionChange = vi.fn();+ const onDenialReasonChange = vi.fn();+ const onReasonSubmit = vi.fn();+ const { rerender } = render(+ <ToolApprovalBar+ toolName="filesystem"+ denyOptions={[reasonOption]}+ onSelect={() => {}}+ onDenyOptionChange={onDenyOptionChange}+ />,+ );++ fireEvent.click(screen.getByRole('button', { name: 'Deny' }));+ expect(onDenyOptionChange).toHaveBeenCalledWith('deny-with-reason');++ rerender(+ <ToolApprovalBar+ toolName="filesystem"+ denyOptions={[reasonOption]}+ selectedDenyOption={reasonOption}+ denialReason="unsafe"+ showReasonError+ onSelect={() => {}}+ onDenyOptionChange={onDenyOptionChange}+ onDenialReasonChange={onDenialReasonChange}+ onReasonSubmit={onReasonSubmit}+ />,+ );++ expect(screen.getByText('Explain the denial')).toBeInTheDocument();+ expect(screen.getByText('filesystem:read')).toBeInTheDocument();+ expect(screen.getByRole('alert')).toHaveTextContent('Reason is required');+ const reasonInput = screen.getByRole('textbox', { name: 'Reason for denial' });+ expect(reasonInput).toHaveAttribute('aria-invalid', 'true');++ fireEvent.change(reasonInput, { target: { value: 'new reason' } });+ expect(onDenialReasonChange).toHaveBeenCalledWith('new reason');+ fireEvent.click(screen.getByRole('button', { name: 'Submit' }));+ expect(onReasonSubmit).toHaveBeenCalledOnce();+ fireEvent.click(screen.getByRole('button', { name: 'Back' }));+ expect(onDenyOptionChange).toHaveBeenLastCalledWith(null);+ });++ it('locks disabled interactions and hides controls in read-only mode', () => {+ const onSelect = vi.fn();+ const { rerender } = render(<ToolApprovalBar toolName="shell" onSelect={onSelect} disabled />);++ expect(screen.getByRole('button', { name: 'Approve' })).toBeDisabled();+ expect(screen.getByRole('button', { name: 'Deny' })).toBeDisabled();+ fireEvent.click(screen.getByRole('button', { name: 'Approve' }));+ expect(onSelect).not.toHaveBeenCalled();++ rerender(<ToolApprovalBar toolName="shell" onSelect={onSelect} readOnly />);+ expect(screen.queryByRole('button', { name: 'Approve' })).not.toBeInTheDocument();+ expect(screen.queryByRole('button', { name: 'Deny' })).not.toBeInTheDocument();+ expect(screen.getByText('Tool Approval Required for')).toBeInTheDocument();+ });++ it('renders approved and denied decisions with an optional reason', () => {+ const { rerender } = render(+ <ToolApprovalBar toolName="shell" onSelect={() => {}} status={{ type: 'approved' }} dataTestPrefix="tool" />,+ );+ expect(screen.getByText('Tool Approved')).toBeInTheDocument();+ expect(screen.queryByRole('button', { name: 'Approve' })).not.toBeInTheDocument();++ rerender(+ <ToolApprovalBar+ toolName="shell"+ onSelect={() => {}}+ status={{ type: 'denied', reason: 'Policy blocked it' }}+ dataTestPrefix="tool"+ />,+ );+ expect(screen.getByText('Tool Approval Denied')).toBeInTheDocument();+ expect(screen.getByText('Reason: Policy blocked it')).toBeInTheDocument();+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/ToolCallCard.test.tsx b/packages/trueforge-ui-sdk/test/atoms/ToolCallCard.test.tsxnew file mode 100644index 000000000..b2d671d59--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/ToolCallCard.test.tsx@@ -0,0 +1,78 @@+// @vitest-environment jsdom+import { fireEvent, render, screen } from '@testing-library/react';+import { describe, expect, it, vi } from 'vitest';++import { ToolCallCard } from '@/atoms/ToolCallCard.js';++describe('ToolCallCard', () => {+ it('toggles expandable request content and only shows response content when expanded', () => {+ const onToggle = vi.fn();+ const { rerender } = render(+ <ToolCallCard+ toolName="Search docs"+ expanded={false}+ onToggle={onToggle}+ requestSlot={<div>request body</div>}+ responseSlot={<div>response body</div>}+ showResponseLine+ dataTestPrefix="search"+ />,+ );++ expect(screen.queryByText('request body')).not.toBeInTheDocument();+ expect(screen.queryByText('response body')).not.toBeInTheDocument();+ fireEvent.click(screen.getByRole('button', { name: 'Expand step' }));+ expect(onToggle).toHaveBeenCalledOnce();++ rerender(+ <ToolCallCard+ toolName="Search docs"+ expanded+ onToggle={onToggle}+ requestSlot={<div>request body</div>}+ responseSlot={<div>response body</div>}+ showResponseLine+ dataTestPrefix="search"+ />,+ );+ expect(screen.getByText('request body')).toBeInTheDocument();+ expect(screen.getByText('response body')).toBeInTheDocument();+ expect(screen.getByRole('button', { name: 'Collapse step' })).toHaveAttribute('aria-expanded', 'true');+ });++ it('derives running, success, and error presentation from awaiting and exit code', () => {+ const { container, rerender } = render(+ <ToolCallCard toolName="Run" awaiting awaitingText="Executing…" dataTestPrefix="run" />,+ );+ expect(screen.getByText('Executing…')).toBeInTheDocument();+ expect(screen.queryByTestId('run-header-success-icon')).not.toBeInTheDocument();++ rerender(<ToolCallCard toolName="Run" exitCode={0} dataTestPrefix="run" />);+ expect(screen.getByTestId('run-header-success-icon')).toBeInTheDocument();++ rerender(<ToolCallCard toolName="Run" exitCode={2} dataTestPrefix="run" />);+ expect(container.querySelector('svg.text-destructive')).toBeInTheDocument();+ });++ it('honors explicit status and suppresses expansion when no expandable content exists', () => {+ const { container } = render(+ <ToolCallCard toolName="Failed tool" status="error" onToggle={vi.fn()} dataTestPrefix="failed" />,+ );++ expect(container.querySelector('svg.text-destructive')).toBeInTheDocument();+ expect(screen.queryByRole('button', { name: 'Expand step' })).not.toBeInTheDocument();+ });++ it('keeps approval content visible while request content is collapsed', () => {+ render(+ <ToolCallCard+ toolName="Protected tool"+ approvalSlot={<div>approval controls</div>}+ requestSlot={<div>private request</div>}+ />,+ );++ expect(screen.getByText('approval controls')).toBeInTheDocument();+ expect(screen.queryByText('private request')).not.toBeInTheDocument();+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/ToolCallContentBlock.test.tsx b/packages/trueforge-ui-sdk/test/atoms/ToolCallContentBlock.test.tsxnew file mode 100644index 000000000..7e8c7972a--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/ToolCallContentBlock.test.tsx@@ -0,0 +1,157 @@+// @vitest-environment jsdom+import { act, fireEvent, render, screen } from '@testing-library/react';+import type { ComponentProps } from 'react';+import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from 'vitest';++import { Markdown } from '@/atoms/Markdown.js';+import { ToolCallContentBlock } from '@/atoms/ToolCallContentBlock.js';+import { SlotsProvider } from '@/theme/SlotsProvider.js';++vi.mock('@/atoms/MonacoEditorCore.js', () => ({+ MonacoEditorCore: ({+ value,+ language,+ height,+ autoHeight,+ options,+ }: {+ value: string;+ language?: string;+ height?: string | number;+ autoHeight?: boolean;+ options?: Record<string, unknown>;+ }) => (+ <div+ data-testid="json-editor"+ data-language={language}+ data-height={String(height)}+ data-auto-height={String(Boolean(autoHeight))}+ data-read-only={String(options?.readOnly)}+ >+ {value}+ </div>+ ),+}));++const clipboardDescriptor = Object.getOwnPropertyDescriptor(navigator, 'clipboard');++function MarkdownStub({ content }: ComponentProps<typeof Markdown>) {+ return <div data-testid="markdown-content">{content}</div>;+}++function renderBlock(props: ComponentProps<typeof ToolCallContentBlock>) {+ return render(+ <SlotsProvider overrides={{ Markdown: MarkdownStub }}>+ <ToolCallContentBlock {...props} />+ </SlotsProvider>,+ );+}++describe('ToolCallContentBlock', () => {+ const writeText = vi.fn(() => Promise.resolve());++ beforeAll(() => {+ Object.defineProperty(HTMLDialogElement.prototype, 'showModal', {+ configurable: true,+ value: function showModal(this: HTMLDialogElement) {+ this.open = true;+ },+ });+ Object.defineProperty(HTMLDialogElement.prototype, 'close', {+ configurable: true,+ value: function close(this: HTMLDialogElement) {+ this.open = false;+ },+ });+ });++ beforeEach(() => {+ vi.clearAllMocks();+ Object.defineProperty(navigator, 'clipboard', {+ configurable: true,+ value: { writeText },+ });+ });++ afterEach(() => {+ vi.useRealTimers();+ if (clipboardDescriptor === undefined) {+ Reflect.deleteProperty(navigator, 'clipboard');+ } else {+ Object.defineProperty(navigator, 'clipboard', clipboardDescriptor);+ }+ });++ it('renders JSON read-only and copies the configured copy value', async () => {+ vi.useFakeTimers();+ renderBlock({+ title: 'Arguments',+ content: '{"token":"redacted"}',+ copyValue: '{"token":"actual"}',+ dataTestPrefix: 'args',+ });++ expect(screen.getByTestId('json-editor')).toHaveAttribute('data-language', 'json');+ expect(screen.getByTestId('json-editor')).toHaveAttribute('data-read-only', 'true');+ expect(screen.getByTestId('json-editor')).toHaveAttribute('data-auto-height', 'true');++ await act(async () => {+ fireEvent.click(screen.getByTestId('args-copy'));+ await Promise.resolve();+ });+ expect(writeText).toHaveBeenCalledWith('{"token":"actual"}');+ expect(writeText).toHaveBeenCalledOnce();++ act(() => {+ vi.advanceTimersByTime(1500);+ });+ });++ it('renders markdown, clamps resizable height, and provides the content node', () => {+ const contentRef = vi.fn();+ renderBlock({+ title: 'Response',+ content: '**done**',+ isJson: false,+ resizable: true,+ contentHeightRem: 25,+ contentRef,+ });++ expect(screen.getByTestId('markdown-content')).toHaveTextContent('**done**');+ expect(screen.queryByTestId('json-editor')).not.toBeInTheDocument();+ const body = screen.getByTestId('markdown-content').parentElement?.parentElement;+ expect(body).toHaveStyle({ height: '10rem', resize: 'vertical' });+ expect(contentRef).toHaveBeenCalledWith(body);+ });++ it('requests fullscreen and closes the controlled fullscreen dialog', () => {+ const onFullscreenChange = vi.fn();+ const { rerender } = renderBlock({+ title: 'Tool output',+ content: '{"ok":true}',+ onFullscreenChange,+ });++ fireEvent.click(screen.getByRole('button', { name: 'Expand' }));+ expect(onFullscreenChange).toHaveBeenCalledWith(true);++ rerender(+ <SlotsProvider overrides={{ Markdown: MarkdownStub }}>+ <ToolCallContentBlock+ title="Tool output"+ content='{"ok":true}'+ fullscreen+ onFullscreenChange={onFullscreenChange}+ />+ </SlotsProvider>,+ );++ expect(screen.getByRole('dialog')).toBeInTheDocument();+ expect(screen.getAllByTestId('json-editor')).toHaveLength(2);+ expect(screen.getAllByTestId('json-editor')[1]).toHaveAttribute('data-height', '100%');++ fireEvent.click(screen.getByRole('button', { name: 'Minimize' }));+ expect(onFullscreenChange).toHaveBeenLastCalledWith(false);+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/ToolGroupCard.test.tsx b/packages/trueforge-ui-sdk/test/atoms/ToolGroupCard.test.tsxnew file mode 100644index 000000000..f1a98706b--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/ToolGroupCard.test.tsx@@ -0,0 +1,48 @@+// @vitest-environment jsdom+import { fireEvent, render, screen } from '@testing-library/react';+import { describe, expect, it, vi } from 'vitest';++import { ToolGroupCard } from '@/atoms/ToolGroupCard.js';++describe('ToolGroupCard', () => {+ it('renders singular and plural tool-call labels', () => {+ const { rerender } = render(+ <ToolGroupCard toolCallCount={1} expanded={false} onToggle={() => {}}>+ content+ </ToolGroupCard>,+ );+ expect(screen.getByText('1 tool call')).toBeInTheDocument();++ rerender(+ <ToolGroupCard toolCallCount={3} expanded={false} onToggle={() => {}}>+ content+ </ToolGroupCard>,+ );+ expect(screen.getByText('3 tool calls')).toBeInTheDocument();+ });++ it('hides collapsed children and invokes the controlled toggle callback', () => {+ const onToggle = vi.fn();+ render(+ <ToolGroupCard toolCallCount={2} expanded={false} onToggle={onToggle}>+ <div>group content</div>+ </ToolGroupCard>,+ );++ expect(screen.queryByText('group content')).not.toBeInTheDocument();+ fireEvent.click(screen.getByRole('button', { name: /2 tool calls/i }));+ expect(onToggle).toHaveBeenCalledOnce();+ });++ it('shows children and active progress when expanded', () => {+ render(+ <ToolGroupCard toolCallCount={2} expanded active onToggle={() => {}}>+ <div>group content</div>+ </ToolGroupCard>,+ );++ expect(screen.getByText('group content')).toBeInTheDocument();+ expect(screen.getByRole('button', { name: /2 tool calls/i })).toHaveAttribute('aria-expanded', 'true');+ expect(document.querySelector('.animate-spin')).toBeInTheDocument();+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/UserMessageActionBar.test.tsx b/packages/trueforge-ui-sdk/test/atoms/UserMessageActionBar.test.tsxnew file mode 100644index 000000000..b99f24dbb--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/UserMessageActionBar.test.tsx@@ -0,0 +1,43 @@+import { fireEvent, render, screen } from '@testing-library/react';+import { describe, expect, it, vi } from 'vitest';++import { UserMessageActionBar } from '@/atoms/UserMessageActionBar.js';++describe('UserMessageActionBar', () => {+ it('exposes and invokes retry, edit, and copy actions', () => {+ const onRetry = vi.fn();+ const onEdit = vi.fn();+ const onCopy = vi.fn();+ render(+ <UserMessageActionBar isCopied={false} onRetry={onRetry} onEdit={onEdit} onCopy={onCopy} className="host-bar" />,+ );++ const retryButton = screen.getByRole('button', { name: 'Try again' });+ const editButton = screen.getByRole('button', { name: 'Edit' });+ const copyButton = screen.getByRole('button', { name: 'Copy' });++ expect(retryButton).toHaveAttribute('title', 'Try again');+ expect(editButton).toHaveAttribute('title', 'Edit');+ expect(copyButton).toHaveAttribute('title', 'Copy');+ expect(retryButton.parentElement).toHaveClass('aui-user-action-bar-root', 'host-bar');++ fireEvent.click(retryButton);+ fireEvent.click(editButton);+ fireEvent.click(copyButton);++ expect(onRetry).toHaveBeenCalledOnce();+ expect(onEdit).toHaveBeenCalledOnce();+ expect(onCopy).toHaveBeenCalledOnce();+ });++ it('disables editing and shows the copied confirmation icon', () => {+ const onEdit = vi.fn();+ render(<UserMessageActionBar isCopied editDisabled onRetry={vi.fn()} onEdit={onEdit} onCopy={vi.fn()} />);++ const editButton = screen.getByRole('button', { name: 'Edit' });+ expect(editButton).toBeDisabled();+ fireEvent.click(editButton);+ expect(onEdit).not.toHaveBeenCalled();+ expect(screen.getByRole('button', { name: 'Copy' }).querySelector('svg')).toHaveClass('lucide-check');+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/UserMessageBubble.test.tsx b/packages/trueforge-ui-sdk/test/atoms/UserMessageBubble.test.tsxnew file mode 100644index 000000000..23a97322c--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/UserMessageBubble.test.tsx@@ -0,0 +1,34 @@+import { render, screen } from '@testing-library/react';+import { describe, expect, it } from 'vitest';++import { UserMessageBubble } from '@/atoms/UserMessageBubble.js';++describe('UserMessageBubble', () => {+ it('renders message content, attachments, and an edit action in their semantic slots', () => {+ const { container } = render(+ <UserMessageBubble+ text={'First line\nSecond line'}+ attachments={<a href="/brief.pdf">brief.pdf</a>}+ editAction={<button type="button">Edit message</button>}+ className="consumer-class"+ />,+ );++ const root = container.querySelector('[data-slot="aui_user-message-root"]');+ const content = container.querySelector('[data-slot="aui_user-message-content"]');++ expect(root).toHaveClass('consumer-class');+ expect(content).toHaveTextContent('First line Second line');+ expect(content).toHaveStyle({ borderRadius: 'var(--composer-radius, 1.5rem)' });+ expect(screen.getByRole('link', { name: 'brief.pdf' })).toHaveAttribute('href', '/brief.pdf');+ expect(screen.getByRole('button', { name: 'Edit message' })).toBeInTheDocument();+ });++ it('omits optional attachment and edit-action content', () => {+ render(<UserMessageBubble text="Just text" />);++ expect(screen.getByText('Just text')).toBeInTheDocument();+ expect(screen.queryByRole('button')).not.toBeInTheDocument();+ expect(screen.queryByRole('link')).not.toBeInTheDocument();+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/UserMessageEdit.test.tsx b/packages/trueforge-ui-sdk/test/atoms/UserMessageEdit.test.tsxnew file mode 100644index 000000000..0013acd53--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/UserMessageEdit.test.tsx@@ -0,0 +1,43 @@+import { render, screen } from '@testing-library/react';+import { describe, expect, it } from 'vitest';++import { UserMessageEdit } from '@/atoms/UserMessageEdit.js';++describe('UserMessageEdit', () => {+ it('renders edit context and forwards root HTML attributes', () => {+ render(+ <UserMessageEdit+ timestamp={<time dateTime="2026-08-06">Today</time>}+ attachments={<span>notes.txt</span>}+ input={<textarea aria-label="Edit message" defaultValue="Draft text" />}+ footer={<button type="button">Save edit</button>}+ className="consumer-class"+ data-testid="edit-root"+ aria-label="Message editor"+ />,+ );++ const root = screen.getByTestId('edit-root');+ expect(root).toHaveAttribute('data-slot', 'aui_user-message-edit');+ expect(root).toHaveAttribute('aria-label', 'Message editor');+ expect(root).toHaveClass('consumer-class');+ expect(screen.getByText('User')).toBeInTheDocument();+ expect(screen.getByText('Today')).toHaveAttribute('datetime', '2026-08-06');+ expect(screen.getByText('notes.txt')).toBeInTheDocument();+ expect(screen.getByRole('textbox', { name: 'Edit message' })).toHaveValue('Draft text');+ expect(screen.getByRole('button', { name: 'Save edit' })).toBeInTheDocument();+ });++ it('does not add a user metadata row when timestamp and attachments are absent', () => {+ render(+ <UserMessageEdit+ input={<input aria-label="Edit message" />}+ footer={<button type="button">Cancel edit</button>}+ />,+ );++ expect(screen.queryByText('User')).not.toBeInTheDocument();+ expect(screen.getByRole('textbox', { name: 'Edit message' })).toBeInTheDocument();+ expect(screen.getByRole('button', { name: 'Cancel edit' })).toBeInTheDocument();+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/WelcomeScreen.test.tsx b/packages/trueforge-ui-sdk/test/atoms/WelcomeScreen.test.tsxnew file mode 100644index 000000000..3ec62e767--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/WelcomeScreen.test.tsx@@ -0,0 +1,57 @@+import { render, screen } from '@testing-library/react';+import { describe, expect, it } from 'vitest';++import { WelcomeScreen } from '@/atoms/WelcomeScreen.js';+import { ThemeProvider } from '@/theme/ThemeProvider.js';++describe('WelcomeScreen', () => {+ it('renders the default heading and brand icon outside a provider', () => {+ const { container } = render(<WelcomeScreen className="host-welcome" />);++ const heading = screen.getByRole('heading', { level: 1, name: 'How can I help you today?' });+ const root = container.querySelector('[data-preset="truefoundry"]');+ expect(root).toHaveClass('aui-thread-welcome-root', 'host-welcome');+ expect(root?.querySelector('svg[aria-hidden="true"]')).toBeInTheDocument();+ expect(heading).toHaveClass('font-semibold', 'delay-75');+ });++ it('renders a custom heading and icon', () => {+ render(<WelcomeScreen heading="Start a task" icon={<span aria-label="Custom welcome icon">★</span>} />);++ expect(screen.getByRole('heading', { name: 'Start a task' })).toBeInTheDocument();+ expect(screen.getByLabelText('Custom welcome icon')).toHaveTextContent('★');+ });++ it('allows callers to explicitly suppress the icon', () => {+ const { container } = render(<WelcomeScreen icon={null} />);++ const heading = screen.getByRole('heading');+ expect(container.querySelector('svg')).not.toBeInTheDocument();+ expect(heading).not.toHaveClass('delay-75');+ });++ it('uses preset-specific icon behavior', () => {+ const { container, rerender } = render(+ <ThemeProvider theme={{ preset: 'chatgpt', mode: 'light' }}>+ <WelcomeScreen />+ </ThemeProvider>,+ );+ expect(container.querySelector('.aui-thread-welcome-root svg')).not.toBeInTheDocument();+ expect(screen.getByRole('heading')).toHaveClass('font-normal');++ rerender(+ <ThemeProvider theme={{ preset: 'claude', mode: 'light' }}>+ <WelcomeScreen />+ </ThemeProvider>,+ );+ expect(container.querySelector('.aui-thread-welcome-root svg')).toHaveClass('fill-current');++ rerender(+ <ThemeProvider theme={{ preset: 'gemini', mode: 'light' }}>+ <WelcomeScreen />+ </ThemeProvider>,+ );+ expect(container.querySelector('.aui-thread-welcome-root')).toHaveClass('py-8');+ expect(container.querySelector('[aria-hidden].motion-safe\\:animate-pulse')).toBeInTheDocument();+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/adapters/AgentStepsCardAdapter.test.tsx b/packages/trueforge-ui-sdk/test/atoms/adapters/AgentStepsCardAdapter.test.tsxnew file mode 100644index 000000000..dfd429e40--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/adapters/AgentStepsCardAdapter.test.tsx@@ -0,0 +1,50 @@+// @vitest-environment jsdom+import { fireEvent, render, screen } from '@testing-library/react';+import { describe, expect, it, vi } from 'vitest';++import { AgentStepsCard } from '@/atoms/adapters/AgentStepsCardAdapter.js';++describe('AgentStepsCard', () => {+ it('formats tool and thought counts and invokes the controlled toggle', () => {+ const onToggle = vi.fn();+ render(+ <AgentStepsCard toolCount={1} thinkingCount={2} expanded={false} onToggle={onToggle} dataTestPrefix="agent">+ <div>step details</div>+ </AgentStepsCard>,+ );++ expect(screen.getByText(/1 tool call/)).toBeInTheDocument();+ expect(screen.getByText(/2 thoughts/)).toBeInTheDocument();+ expect(screen.queryByText('step details')).not.toBeInTheDocument();++ fireEvent.click(screen.getByRole('button', { name: /Agent steps/i }));+ expect(onToggle).toHaveBeenCalledOnce();+ });++ it('shows expanded content, singular thought text, and active progress', () => {+ render(+ <AgentStepsCard+ toolCount={3}+ thinkingCount={1}+ expanded+ active+ onToggle={() => {}}+ background="rgb(1, 2, 3)"+ borderColor="rgb(4, 5, 6)"+ dataTestPrefix="agent"+ >+ <div>step details</div>+ </AgentStepsCard>,+ );++ expect(screen.getByText(/3 tool calls/)).toBeInTheDocument();+ expect(screen.getByText(/1 thought/)).toBeInTheDocument();+ expect(screen.getByTestId('agent-content')).toHaveTextContent('step details');+ expect(screen.getByRole('status', { name: 'Loading' })).toBeInTheDocument();+ expect(screen.getByTestId('agent-agent-steps-card')).toHaveAttribute('data-expanded', 'true');+ expect(screen.getByTestId('agent-agent-steps-card')).toHaveStyle({+ background: 'rgb(1, 2, 3)',+ borderColor: 'rgb(4, 5, 6)',+ });+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/adapters/AskUserPromptAdapter.test.tsx b/packages/trueforge-ui-sdk/test/atoms/adapters/AskUserPromptAdapter.test.tsxnew file mode 100644index 000000000..04c18cd9c--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/adapters/AskUserPromptAdapter.test.tsx@@ -0,0 +1,139 @@+// @vitest-environment jsdom+import { fireEvent, render, screen } from '@testing-library/react';+import { describe, expect, it, vi } from 'vitest';++import { ASK_USER_CUSTOM_OPTION, AskUserPrompt, type Question } from '@/atoms/adapters/AskUserPromptAdapter.js';++const firstQuestion: Question = {+ id: 'deployment',+ question: 'How should this deploy?',+ options: ['Immediately', 'Schedule it'],+};++const secondQuestion: Question = {+ id: 'region',+ question: 'Which region?',+ options: ['US', 'EU'],+};++describe('AskUserPrompt', () => {+ it('renders nothing without questions or answers, then summarizes answered questions', () => {+ const onSubmit = vi.fn();+ const { container, rerender } = render(<AskUserPrompt questions={[]} onSubmit={onSubmit} />);++ expect(container).toBeEmptyDOMElement();++ rerender(+ <AskUserPrompt+ questions={[]}+ answeredQuestions={[+ { ...firstQuestion, answer: 'Immediately', isCustom: false },+ { ...secondQuestion, answer: 'Near the users', isCustom: true },+ ]}+ onSubmit={onSubmit}+ dataTestPrefix="ask"+ />,+ );++ expect(screen.getByTestId('ask-answered-deployment')).toHaveTextContent('Immediately');+ expect(screen.getByTestId('ask-answered-region')).toHaveTextContent('Other: Near the users');+ expect(screen.getAllByText('Answered')).toHaveLength(2);+ });++ it('reports option and custom-answer edits and submits an enabled single question', () => {+ const onCurrentAnswerChange = vi.fn();+ const onSubmit = vi.fn();+ render(+ <AskUserPrompt+ questions={[firstQuestion]}+ currentQuestion={firstQuestion}+ currentAnswer={{ radioValue: '', custom: '' }}+ isSubmitAllDisabled={false}+ onCurrentAnswerChange={onCurrentAnswerChange}+ onSubmit={onSubmit}+ />,+ );++ fireEvent.click(screen.getByRole('radio', { name: 'Immediately' }));+ expect(onCurrentAnswerChange).toHaveBeenCalledWith('deployment', { radioValue: 'Immediately' });++ const customAnswer = screen.getByRole('textbox', { name: 'Other (custom answer)' });+ fireEvent.focus(customAnswer);+ expect(onCurrentAnswerChange).toHaveBeenCalledWith('deployment', {+ radioValue: ASK_USER_CUSTOM_OPTION,+ });++ fireEvent.change(customAnswer, { target: { value: 'After approval' } });+ expect(onCurrentAnswerChange).toHaveBeenLastCalledWith('deployment', {+ custom: 'After approval',+ radioValue: ASK_USER_CUSTOM_OPTION,+ });++ fireEvent.click(screen.getByRole('button', { name: 'Submit' }));+ expect(onSubmit).toHaveBeenCalledOnce();+ });++ it('derives multi-question navigation and prevents premature submission', () => {+ const onCurrentQuestionIndexChange = vi.fn();+ const { rerender } = render(+ <AskUserPrompt+ questions={[firstQuestion, secondQuestion]}+ currentQuestion={secondQuestion}+ currentQuestionIndex={1}+ currentAnswer={{ radioValue: '', custom: '' }}+ onCurrentQuestionIndexChange={onCurrentQuestionIndexChange}+ onSubmit={() => {}}+ />,+ );++ expect(screen.getByText('Questions')).toBeInTheDocument();+ expect(screen.getByText('Which region?')).toBeInTheDocument();+ expect(screen.getByText('Answer all questions to submit')).toBeInTheDocument();+ expect(screen.getByRole('button', { name: 'Next question' })).toBeDisabled();+ expect(screen.getByRole('button', { name: 'Submit' })).toBeDisabled();++ fireEvent.click(screen.getByRole('button', { name: 'Previous question' }));+ expect(onCurrentQuestionIndexChange).toHaveBeenCalledWith(0);++ rerender(+ <AskUserPrompt+ questions={[firstQuestion, secondQuestion]}+ currentQuestion={firstQuestion}+ currentQuestionIndex={0}+ currentAnswer={{ radioValue: 'Immediately', custom: '' }}+ isSubmitDisabled={false}+ onCurrentQuestionIndexChange={onCurrentQuestionIndexChange}+ onSubmit={() => {}}+ />,+ );++ fireEvent.click(screen.getByRole('button', { name: 'Next' }));+ expect(onCurrentQuestionIndexChange).toHaveBeenLastCalledWith(1);+ });++ it('makes an unanswered read-only question non-interactive', () => {+ const onCurrentAnswerChange = vi.fn();+ const onSubmit = vi.fn();+ render(+ <AskUserPrompt+ questions={[firstQuestion]}+ currentQuestion={firstQuestion}+ currentAnswer={{ radioValue: '', custom: '' }}+ readOnly+ onCurrentAnswerChange={onCurrentAnswerChange}+ onSubmit={onSubmit}+ />,+ );++ expect(screen.getByText('Unanswered')).toBeInTheDocument();+ for (const radio of screen.getAllByRole('radio')) {+ expect(radio).toBeDisabled();+ }+ expect(screen.getByRole('textbox', { name: 'Other (custom answer)' })).toBeDisabled();+ expect(screen.queryByRole('button', { name: 'Submit' })).not.toBeInTheDocument();++ fireEvent.click(screen.getByRole('radio', { name: 'Immediately' }));+ expect(onCurrentAnswerChange).not.toHaveBeenCalled();+ expect(onSubmit).not.toHaveBeenCalled();+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/adapters/ReasoningCardAdapter.test.tsx b/packages/trueforge-ui-sdk/test/atoms/adapters/ReasoningCardAdapter.test.tsxnew file mode 100644index 000000000..4b26c11cc--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/adapters/ReasoningCardAdapter.test.tsx@@ -0,0 +1,87 @@+// @vitest-environment jsdom+import { fireEvent, render, screen } from '@testing-library/react';+import type { ComponentProps } from 'react';+import { describe, expect, it, vi } from 'vitest';++import { Markdown } from '@/atoms/Markdown.js';+import { ReasoningCard } from '@/atoms/adapters/ReasoningCardAdapter.js';+import { SlotsProvider } from '@/theme/SlotsProvider.js';++function MarkdownProbe({ content }: ComponentProps<typeof Markdown>) {+ return <div data-testid="markdown-probe">{content}</div>;+}++function renderSubject(props: ComponentProps<typeof ReasoningCard>) {+ return render(+ <SlotsProvider overrides={{ Markdown: MarkdownProbe }}>+ <ReasoningCard {...props} />+ </SlotsProvider>,+ );+}++describe('ReasoningCard', () => {+ it('summarizes completed one-line reasoning and exposes its controlled toggle', () => {+ const onToggle = vi.fn();+ renderSubject({+ content: 'Checked the deployment state.',+ reasoningTimeText: 'Reasoned for 2s',+ onToggle,+ dataTestPrefix: 'reason',+ });++ expect(screen.getByTestId('reason-reasoning-inline')).toBeInTheDocument();+ expect(screen.getByTestId('reason-title')).toHaveTextContent('Reasoned for 2s');+ expect(screen.queryByTestId('reason-content')).not.toBeInTheDocument();++ fireEvent.click(screen.getByRole('button', { name: 'Expand step' }));+ expect(onToggle).toHaveBeenCalledOnce();+ });++ it('renders expanded multiline content through the Markdown slot and provides its content node', () => {+ const contentRef = vi.fn();+ renderSubject({+ content: 'First line\nSecond line',+ expanded: true,+ isMultiLine: true,+ contentRef,+ onToggle: () => {},+ dataTestPrefix: 'reason',+ });++ const content = screen.getByTestId('reason-content');+ expect(screen.getByTestId('reason-reasoning-accordion')).toBeInTheDocument();+ expect(screen.getByTestId('markdown-probe')).toHaveTextContent(/First line\s+Second line/);+ expect(contentRef).toHaveBeenCalledWith(content);+ expect(screen.getByRole('button', { name: 'Collapse step' })).toHaveAttribute('aria-expanded', 'true');+ });++ it('keeps empty completed reasoning idle and non-expandable', () => {+ const onToggle = vi.fn();+ renderSubject({+ content: '',+ onToggle,+ dataTestPrefix: 'reason',+ });++ expect(screen.getByTestId('reason-title')).toHaveTextContent('Reasoning');+ expect(screen.queryByRole('button', { name: /step/i })).not.toBeInTheDocument();+ expect(screen.queryByTestId('markdown-probe')).not.toBeInTheDocument();+ });++ it('uses the streaming heading and remains expandable before content arrives', () => {+ const onToggle = vi.fn();+ renderSubject({+ content: '',+ isStreaming: true,+ headingText: 'Thinking through changes',+ onToggle,+ dataTestPrefix: 'reason',+ });++ expect(screen.getByTestId('reason-title')).toHaveTextContent('Thinking through changes');+ expect(screen.getByRole('button', { name: 'Expand step' })).toBeInTheDocument();++ fireEvent.click(screen.getByRole('button', { name: 'Expand step' }));+ expect(onToggle).toHaveBeenCalledOnce();+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/agent-chat/AgentStepRow.test.tsx b/packages/trueforge-ui-sdk/test/atoms/agent-chat/AgentStepRow.test.tsxnew file mode 100644index 000000000..fbe0c7218--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/agent-chat/AgentStepRow.test.tsx@@ -0,0 +1,126 @@+import { fireEvent, render, screen } from '@testing-library/react';+import type { SVGProps } from 'react';+import { describe, expect, it, vi } from 'vitest';++import { AgentStepRow, type AgentStepRowProps } from '@/atoms/agent-chat/AgentStepRow.js';+import { ThemeProvider } from '@/theme/ThemeProvider.js';+import type { ThemeConfig } from '@/theme/types.js';++function StepIconProbe(props: SVGProps<SVGSVGElement>) {+ return <svg {...props} data-testid="configured-step-icon" />;+}++const testTheme: ThemeConfig = {+ mode: 'light',+ icons: {+ 'test-step': StepIconProbe,+ },+};++function TestSubject(props: Omit<AgentStepRowProps, 'icon'>) {+ return (+ <ThemeProvider theme={testTheme}>+ <AgentStepRow icon="test-step" {...props} />+ </ThemeProvider>+ );+}++describe('AgentStepRow', () => {+ it('exposes its controlled expansion and propagates only intended row clicks', () => {+ const onToggle = vi.fn();+ const { rerender } = render(+ <TestSubject+ title="Fetch deployment"+ body={<button type="button">Inspect response</button>}+ expandable+ expanded={false}+ onToggle={onToggle}+ dataTestPrefix="fetch"+ />,+ );++ expect(screen.getByTestId('configured-step-icon')).toHaveAttribute('aria-hidden', 'true');++ const expandButton = screen.getByRole('button', { name: 'Expand step' });+ expect(expandButton).toHaveAttribute('aria-expanded', 'false');++ fireEvent.click(expandButton);+ fireEvent.click(screen.getByTestId('fetch-title'));+ fireEvent.click(screen.getByRole('button', { name: 'Inspect response' }));+ expect(onToggle).toHaveBeenCalledTimes(3);++ rerender(+ <TestSubject+ title="Fetch deployment"+ body={<button type="button">Inspect response</button>}+ expandable+ expanded+ onToggle={onToggle}+ dataTestPrefix="fetch"+ />,+ );++ const collapseButton = screen.getByRole('button', { name: 'Collapse step' });+ expect(collapseButton).toHaveAttribute('aria-expanded', 'true');++ fireEvent.click(screen.getByRole('button', { name: 'Inspect response' }));+ expect(onToggle).toHaveBeenCalledTimes(3);++ fireEvent.click(collapseButton);+ expect(onToggle).toHaveBeenCalledTimes(4);+ });++ it('hides collapsible children while keeping persistent children mounted', () => {+ const { rerender } = render(+ <TestSubject+ title="Process files"+ expanded={false}+ dataTestPrefix="process"+ persistentChildren={<div>Always-visible progress</div>}+ >+ <div>Expanded details</div>+ </TestSubject>,+ );++ expect(screen.queryByTestId('process-expanded-content')).not.toBeInTheDocument();+ expect(screen.queryByText('Expanded details')).not.toBeInTheDocument();+ expect(screen.getByTestId('process-persistent-content')).toHaveTextContent('Always-visible progress');++ rerender(+ <TestSubject+ title="Process files"+ expanded+ dataTestPrefix="process"+ persistentChildren={<div>Always-visible progress</div>}+ >+ <div>Expanded details</div>+ </TestSubject>,+ );++ expect(screen.getByTestId('process-expanded-content')).toHaveTextContent('Expanded details');+ expect(screen.getByTestId('process-persistent-content')).toHaveTextContent('Always-visible progress');+ });++ it('presents running, success, and error statuses with their intended indicators', () => {+ const { rerender } = render(+ <TestSubject title="Run command" status="running" statusText="Running" dataTestPrefix="command" />,+ );++ const runningText = screen.getByText('Running');+ expect(runningText.previousElementSibling).toHaveAttribute('aria-hidden', 'true');+ expect(screen.queryByRole('status', { name: 'Loading' })).not.toBeInTheDocument();++ rerender(<TestSubject title="Run command" status="running" showSpinner dataTestPrefix="command" />);+ expect(screen.getByRole('status', { name: 'Loading' })).toBeInTheDocument();+ expect(screen.queryByText('Running')).not.toBeInTheDocument();++ rerender(<TestSubject title="Run command" status="success" dataTestPrefix="command" />);+ expect(screen.getByTestId('command-success-icon')).toHaveAttribute('aria-hidden', 'true');+ expect(screen.queryByRole('status', { name: 'Loading' })).not.toBeInTheDocument();+ expect(screen.queryByTestId('command-error-icon')).not.toBeInTheDocument();++ rerender(<TestSubject title="Run command" status="error" dataTestPrefix="command" />);+ expect(screen.getByTestId('command-error-icon')).toHaveAttribute('aria-hidden', 'true');+ expect(screen.queryByTestId('command-success-icon')).not.toBeInTheDocument();+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/draft/DraftCatalogProvider.test.tsx b/packages/trueforge-ui-sdk/test/atoms/draft/DraftCatalogProvider.test.tsxnew file mode 100644index 000000000..a1da58001--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/draft/DraftCatalogProvider.test.tsx@@ -0,0 +1,115 @@+// @vitest-environment jsdom+import { act, render, screen, waitFor } from '@testing-library/react';+import { describe, expect, it, vi } from 'vitest';++import { DraftCatalogProvider, useDraftCatalog } from '@/atoms/draft/DraftCatalogProvider.js';+import { ServerProvider } from '@/server/ServerContext.js';+import type { AgentSkill, ConnectorState, ModelSelection } from '@/server/types.js';+import { createMockAgentUIServer } from '../../server/mockServer.js';++function CatalogProbe() {+ const catalog = useDraftCatalog();++ return (+ <div>+ <output data-testid="models">{catalog.models.map(model => model.name).join(',')}</output>+ <output data-testid="skills">{catalog.skills.map(skill => skill.name).join(',')}</output>+ <output data-testid="connectors">{catalog.connectors.map(connector => connector.name).join(',')}</output>+ <output data-testid="loading">{String(catalog.loading)}</output>+ <output data-testid="error">{catalog.error ?? ''}</output>+ </div>+ );+}++function deferred<T>() {+ let resolvePromise: ((value: T) => void) | undefined;+ let rejectPromise: ((reason?: unknown) => void) | undefined;+ const promise = new Promise<T>((resolve, reject) => {+ resolvePromise = resolve;+ rejectPromise = reject;+ });++ return {+ promise,+ resolve(value: T) {+ if (resolvePromise === undefined) {+ throw new Error('Deferred promise was not initialized');+ }+ resolvePromise(value);+ },+ reject(reason: unknown) {+ if (rejectPromise === undefined) {+ throw new Error('Deferred promise was not initialized');+ }+ rejectPromise(reason);+ },+ };+}++describe('DraftCatalogProvider', () => {+ it('exposes an empty, idle catalog when used without a provider', () => {+ render(<CatalogProbe />);++ expect(screen.getByTestId('models')).toBeEmptyDOMElement();+ expect(screen.getByTestId('skills')).toBeEmptyDOMElement();+ expect(screen.getByTestId('connectors')).toBeEmptyDOMElement();+ expect(screen.getByTestId('loading')).toHaveTextContent('false');+ expect(screen.getByTestId('error')).toBeEmptyDOMElement();+ });++ it('loads all catalog collections and publishes them together', async () => {+ const models = deferred<ModelSelection[]>();+ const skills = deferred<AgentSkill[]>();+ const connectors = deferred<ConnectorState[]>();+ const getModels = vi.fn(() => models.promise);+ const getSkills = vi.fn(() => skills.promise);+ const getMcp = vi.fn(() => connectors.promise);+ const server = createMockAgentUIServer({ getModels, getSkills, getMcp });++ render(+ <ServerProvider server={server}>+ <DraftCatalogProvider>+ <CatalogProbe />+ </DraftCatalogProvider>+ </ServerProvider>,+ );++ expect(screen.getByTestId('loading')).toHaveTextContent('true');+ expect(getModels).toHaveBeenCalledTimes(1);+ expect(getSkills).toHaveBeenCalledTimes(1);+ expect(getMcp).toHaveBeenCalledTimes(1);++ await act(async () => {+ models.resolve([{ name: 'openai/gpt-4.1', provider: 'OpenAI' }]);+ skills.resolve([{ id: 'skill-1', name: 'Release notes' }]);+ connectors.resolve([{ id: 'mcp-1', name: 'GitHub' }]);+ await Promise.all([models.promise, skills.promise, connectors.promise]);+ });++ await waitFor(() => expect(screen.getByTestId('loading')).toHaveTextContent('false'));+ expect(screen.getByTestId('models')).toHaveTextContent('openai/gpt-4.1');+ expect(screen.getByTestId('skills')).toHaveTextContent('Release notes');+ expect(screen.getByTestId('connectors')).toHaveTextContent('GitHub');+ expect(screen.getByTestId('error')).toBeEmptyDOMElement();+ });++ it('surfaces catalog failures and leaves loading state', async () => {+ const server = createMockAgentUIServer({+ getModels: async () => {+ throw new Error('Catalog unavailable');+ },+ });++ render(+ <ServerProvider server={server}>+ <DraftCatalogProvider>+ <CatalogProbe />+ </DraftCatalogProvider>+ </ServerProvider>,+ );++ await waitFor(() => expect(screen.getByTestId('error')).toHaveTextContent('Catalog unavailable'));+ expect(screen.getByTestId('loading')).toHaveTextContent('false');+ expect(screen.getByTestId('models')).toBeEmptyDOMElement();+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/draft/DraftComposerSections.test.tsx b/packages/trueforge-ui-sdk/test/atoms/draft/DraftComposerSections.test.tsxnew file mode 100644index 000000000..df59af2a4--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/draft/DraftComposerSections.test.tsx@@ -0,0 +1,94 @@+// @vitest-environment jsdom+import { fireEvent, render, screen } from '@testing-library/react';+import { beforeEach, describe, expect, it, vi } from 'vitest';++import { DraftCatalogProvider } from '@/atoms/draft/DraftCatalogProvider.js';+import { DraftComposerLeftSection, DraftComposerRightSection } from '@/atoms/draft/DraftComposerSections.js';+import { ServerProvider } from '@/server/ServerContext.js';+import type { AgentSpec } from '@/server/types.js';+import { createMockAgentUIServer } from '../../server/mockServer.js';++let agentSpec: AgentSpec;+const updateAgentSpec = vi.fn();++vi.mock('@truefoundry/assistant-ui-runtime', () => ({+ useTrueFoundryAgentSpec: () => ({ agentSpec }),+ useTrueFoundryUpdateAgentSpec: () => updateAgentSpec,+}));++function DraftSections({+ onAttach,+ disabled = false,+ isRunning = false,+}: {+ onAttach?: () => void;+ disabled?: boolean;+ isRunning?: boolean;+}) {+ const server = createMockAgentUIServer({+ getModels: async () => [+ {+ name: 'openai/gpt-4.1',+ provider: 'OpenAI',+ reasoningEfforts: ['low', 'high'],+ },+ ],+ });++ return (+ <ServerProvider server={server}>+ <DraftCatalogProvider>+ <DraftComposerLeftSection disabled={disabled} isRunning={isRunning} onAttach={onAttach} />+ <DraftComposerRightSection disabled={disabled} isRunning={isRunning} />+ </DraftCatalogProvider>+ </ServerProvider>+ );+}++describe('draft composer sections', () => {+ beforeEach(() => {+ agentSpec = {+ model: { name: 'openai/gpt-4.1', params: { reasoningEffort: 'high' } },+ mcpServers: [{ id: 'github', name: 'GitHub' }],+ skills: [+ { id: 'research', name: 'Research' },+ { id: 'writer', name: 'Writer' },+ ],+ };+ updateAgentSpec.mockReset();+ });++ it('composes selection chips and forwards attachment behavior from the left section', () => {+ const onAttach = vi.fn();+ render(<DraftSections onAttach={onAttach} />);++ expect(screen.getByText('1 Connector')).toBeInTheDocument();+ expect(screen.getByText('2 Skills')).toBeInTheDocument();++ fireEvent.click(screen.getByRole('button', { name: 'Add connectors, skills, or attachments' }));+ fireEvent.click(screen.getByRole('button', { name: 'Attachment' }));+ fireEvent.click(screen.getByRole('button', { name: /Add files or photos/ }));++ expect(onAttach).toHaveBeenCalledTimes(1);+ });++ it('composes model and reasoning selectors in the right section', async () => {+ render(<DraftSections />);++ expect(await screen.findByTitle('Select model')).toHaveTextContent('gpt-4.1');+ expect(await screen.findByTitle('Select reasoning effort')).toHaveTextContent('high');+ });++ it('propagates disabled and running state to composed controls', async () => {+ const { rerender } = render(<DraftSections disabled />);++ expect(screen.getByRole('button', { name: 'Add connectors, skills, or attachments' })).toBeDisabled();+ expect(await screen.findByTitle('Select model')).toBeDisabled();+ expect(await screen.findByTitle('Select reasoning effort')).toBeDisabled();++ rerender(<DraftSections isRunning />);+ expect(screen.getByRole('button', { name: 'Add connectors, skills, or attachments' })).toBeDisabled();+ expect(await screen.findByTitle('Select model')).toBeDisabled();+ expect(await screen.findByTitle('Select reasoning effort')).toBeDisabled();+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/draft/DraftCompositeSelector.test.tsx b/packages/trueforge-ui-sdk/test/atoms/draft/DraftCompositeSelector.test.tsxnew file mode 100644index 000000000..5be288084--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/draft/DraftCompositeSelector.test.tsx@@ -0,0 +1,110 @@+// @vitest-environment jsdom+import { fireEvent, render, screen, within } from '@testing-library/react';+import { beforeEach, describe, expect, it, vi } from 'vitest';++import { DraftCatalogProvider } from '@/atoms/draft/DraftCatalogProvider.js';+import { DraftCompositeSelector, type DraftCompositeSelectorProps } from '@/atoms/draft/DraftCompositeSelector.js';+import { ServerProvider } from '@/server/ServerContext.js';+import type { AgentSpec } from '@/server/types.js';+import { createMockAgentUIServer } from '../../server/mockServer.js';++let agentSpec: AgentSpec;+const updateAgentSpec = vi.fn();++vi.mock('@truefoundry/assistant-ui-runtime', () => ({+ useTrueFoundryAgentSpec: () => ({ agentSpec }),+ useTrueFoundryUpdateAgentSpec: () => updateAgentSpec,+}));++function renderSelector(props: DraftCompositeSelectorProps = {}) {+ const server = createMockAgentUIServer({+ getSkills: async () => [+ { id: 'research', name: 'Research', description: 'Find relevant sources' },+ { id: 'writer', name: 'Writer', description: 'Draft polished copy' },+ ],+ getMcp: async () => [+ { id: 'github', name: 'GitHub', description: 'Code hosting' },+ { id: 'slack', name: 'Slack', description: 'Team messages' },+ ],+ });++ return render(+ <ServerProvider server={server}>+ <DraftCatalogProvider>+ <DraftCompositeSelector {...props} />+ </DraftCatalogProvider>+ </ServerProvider>,+ );+}++describe('DraftCompositeSelector', () => {+ beforeEach(() => {+ agentSpec = {+ model: { name: 'openai/gpt-4.1' },+ mcpServers: [{ id: 'slack', name: 'Slack' }],+ skills: [{ id: 'research', name: 'Research' }],+ };+ updateAgentSpec.mockReset();+ });++ it('adds an available connector to the draft spec', async () => {+ renderSelector();+ fireEvent.click(screen.getByRole('button', { name: 'Add connectors, skills, or attachments' }));++ const github = await screen.findByRole('menuitemcheckbox', { name: /GitHub/ });+ expect(github).toHaveAttribute('aria-checked', 'false');+ fireEvent.click(github);++ expect(updateAgentSpec).toHaveBeenCalledWith({+ mcpServers: [+ { id: 'slack', name: 'Slack' },+ { id: 'github', name: 'GitHub' },+ ],+ });+ });++ it('switches tabs, resets search, and removes a selected skill', async () => {+ renderSelector();+ fireEvent.click(screen.getByRole('button', { name: 'Add connectors, skills, or attachments' }));+ await screen.findByRole('menuitemcheckbox', { name: /GitHub/ });++ fireEvent.change(screen.getByRole('searchbox'), { target: { value: 'github' } });+ expect(screen.queryByRole('menuitemcheckbox', { name: /Slack/ })).not.toBeInTheDocument();++ fireEvent.click(screen.getByRole('button', { name: /Skills/ }));+ const skillSearch = screen.getByRole('searchbox');+ expect(skillSearch).toHaveValue('');+ expect(skillSearch).toHaveAttribute('placeholder', 'Search skills...');++ const dialog = screen.getByRole('dialog', { name: 'Add to composer' });+ const research = within(dialog).getByRole('menuitemcheckbox', { name: /Research/ });+ expect(research).toHaveAttribute('aria-checked', 'true');+ expect(within(dialog).getByRole('menuitemcheckbox', { name: /Writer/ })).toBeInTheDocument();+ fireEvent.click(research);++ expect(updateAgentSpec).toHaveBeenCalledWith({ skills: [] });+ });++ it('forwards attachment requests and closes the picker', async () => {+ const onAttach = vi.fn();+ renderSelector({ onAttach });+ const trigger = screen.getByRole('button', { name: 'Add connectors, skills, or attachments' });+ fireEvent.click(trigger);+ await screen.findByRole('menuitemcheckbox', { name: /GitHub/ });+ fireEvent.click(screen.getByRole('button', { name: 'Attachment' }));+ fireEvent.click(screen.getByRole('button', { name: /Add files or photos/ }));++ expect(onAttach).toHaveBeenCalledTimes(1);+ expect(screen.queryByRole('dialog', { name: 'Add to composer' })).not.toBeInTheDocument();+ expect(trigger).toHaveAttribute('aria-expanded', 'false');+ });++ it('cannot open while disabled or running', () => {+ const { rerender } = render(<DraftCompositeSelector disabled />);++ expect(screen.getByRole('button', { name: 'Add connectors, skills, or attachments' })).toBeDisabled();++ rerender(<DraftCompositeSelector isRunning />);+ expect(screen.getByRole('button', { name: 'Add connectors, skills, or attachments' })).toBeDisabled();+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/draft/DraftModelSelector.test.tsx b/packages/trueforge-ui-sdk/test/atoms/draft/DraftModelSelector.test.tsxnew file mode 100644index 000000000..b94664935--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/draft/DraftModelSelector.test.tsx@@ -0,0 +1,92 @@+// @vitest-environment jsdom+import { fireEvent, render, screen, waitFor, within } from '@testing-library/react';+import { beforeEach, describe, expect, it, vi } from 'vitest';++import { DraftCatalogProvider } from '@/atoms/draft/DraftCatalogProvider.js';+import { DraftModelSelector, type DraftModelSelectorProps } from '@/atoms/draft/DraftModelSelector.js';+import { ServerProvider } from '@/server/ServerContext.js';+import type { AgentSpec, ModelSelection } from '@/server/types.js';+import { createMockAgentUIServer } from '../../server/mockServer.js';++let agentSpec: AgentSpec | undefined;+const updateAgentSpec = vi.fn();++vi.mock('@truefoundry/assistant-ui-runtime', () => ({+ useTrueFoundryAgentSpec: () => ({ agentSpec }),+ useTrueFoundryUpdateAgentSpec: () => updateAgentSpec,+}));++const models: ModelSelection[] = [+ { name: 'openai/gpt-4.1', provider: 'OpenAI' },+ {+ name: 'anthropic/claude-3.7-sonnet',+ provider: 'Anthropic',+ reasoningEfforts: ['low', 'high'],+ },+];++function renderSelector(props: DraftModelSelectorProps = {}) {+ const server = createMockAgentUIServer({ getModels: async () => models });++ return render(+ <ServerProvider server={server}>+ <DraftCatalogProvider>+ <DraftModelSelector {...props} />+ </DraftCatalogProvider>+ </ServerProvider>,+ );+}++describe('DraftModelSelector', () => {+ beforeEach(() => {+ agentSpec = {+ model: {+ name: 'openai/gpt-4.1',+ params: { maxTokens: 512, reasoningEffort: 'medium' },+ },+ };+ updateAgentSpec.mockReset();+ });++ it('filters models and updates the agent spec when a model is selected', async () => {+ renderSelector();++ const trigger = await screen.findByTitle('Select model');+ await waitFor(() => expect(trigger).toHaveTextContent('gpt-4.1'));+ fireEvent.click(trigger);++ const listbox = screen.getByRole('listbox', { name: 'Select model' });+ expect(within(listbox).getAllByRole('option')).toHaveLength(2);++ fireEvent.change(screen.getByRole('searchbox'), { target: { value: 'anthropic' } });+ expect(within(listbox).getAllByRole('option')).toHaveLength(1);+ expect(within(listbox).getByRole('option')).toHaveTextContent('claude-3.7-sonnet');++ fireEvent.click(within(listbox).getByRole('option'));++ expect(updateAgentSpec).toHaveBeenCalledWith({+ model: {+ name: 'anthropic/claude-3.7-sonnet',+ params: { maxTokens: 512, reasoningEffort: 'low' },+ },+ });+ expect(screen.queryByRole('listbox', { name: 'Select model' })).not.toBeInTheDocument();+ expect(trigger).toHaveAttribute('aria-expanded', 'false');+ });++ it('uses the first catalog model when the runtime has no draft spec', async () => {+ agentSpec = undefined;+ renderSelector();++ await waitFor(() => expect(screen.getByTitle('Select model')).toHaveTextContent('gpt-4.1'));+ });++ it('disables selection while disabled or running', () => {+ const { rerender } = render(<DraftModelSelector disabled />);++ expect(screen.getByTitle('Select model')).toBeDisabled();++ rerender(<DraftModelSelector isRunning />);+ expect(screen.getByTitle('Select model')).toBeDisabled();+ });+});diff --git a/packages/trueforge-ui-sdk/src/atoms/draft/reasoningEffort.test.ts b/packages/trueforge-ui-sdk/test/atoms/draft/reasoningEffort.test.tssimilarity index 92%rename from packages/trueforge-ui-sdk/src/atoms/draft/reasoningEffort.test.tsrename to packages/trueforge-ui-sdk/test/atoms/draft/reasoningEffort.test.tsindex 092e00522..bdbbcc739 100644--- a/packages/trueforge-ui-sdk/src/atoms/draft/reasoningEffort.test.ts+++ b/packages/trueforge-ui-sdk/test/atoms/draft/reasoningEffort.test.ts@@ -1,6 +1,10 @@import { describe, expect, it } from 'vitest';-import { hasReasoningEfforts, modelPatchWithReasoningEffort, resolveReasoningEffort } from './reasoningEffort.js';+import {+ hasReasoningEfforts,+ modelPatchWithReasoningEffort,+ resolveReasoningEffort,+} from '@/atoms/draft/reasoningEffort.js';describe('hasReasoningEfforts', () => {it('is false for nullish or empty', () => {diff --git a/packages/trueforge-ui-sdk/test/atoms/primitives/Accordion.test.tsx b/packages/trueforge-ui-sdk/test/atoms/primitives/Accordion.test.tsxnew file mode 100644index 000000000..a86b00e6f--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/primitives/Accordion.test.tsx@@ -0,0 +1,108 @@+import { fireEvent, render, screen } from '@testing-library/react';+import { describe, expect, it, vi } from 'vitest';++import {+ Accordion,+ AccordionContent,+ AccordionDetails,+ AccordionItem,+ AccordionRoot,+ AccordionSummary,+ AccordionTrigger,+} from '@/atoms/primitives/Accordion.js';++describe('Accordion', () => {+ it('reports controlled changes and keeps summary and details accessibility in sync', () => {+ const onChange = vi.fn();+ const { rerender } = render(+ <Accordion expanded={false} onChange={onChange} className="host-accordion" data-testid="accordion">+ <AccordionSummary>Account settings</AccordionSummary>+ <AccordionDetails>Profile details</AccordionDetails>+ </Accordion>,+ );++ const accordion = screen.getByTestId('accordion');+ const summary = screen.getByRole('button', { name: 'Account settings' });+ expect(accordion).toHaveClass('w-full', 'host-accordion');+ expect(accordion).not.toHaveAttribute('data-expanded');+ expect(summary).toHaveAttribute('aria-expanded', 'false');+ expect(summary).toHaveAttribute('aria-controls');+ expect(screen.queryByRole('region')).not.toBeInTheDocument();++ fireEvent.click(summary);+ expect(onChange).toHaveBeenCalledWith(expect.any(Object), true);++ rerender(+ <Accordion expanded onChange={onChange} className="host-accordion" data-testid="accordion">+ <AccordionSummary>Account settings</AccordionSummary>+ <AccordionDetails>Profile details</AccordionDetails>+ </Accordion>,+ );++ const region = screen.getByRole('region');+ expect(accordion).toHaveAttribute('data-expanded', 'true');+ expect(summary).toHaveAttribute('aria-expanded', 'true');+ expect(region).toHaveTextContent('Profile details');+ expect(region).toHaveAttribute('id', summary.getAttribute('aria-controls'));++ fireEvent.click(summary);+ expect(onChange).toHaveBeenLastCalledWith(expect.any(Object), false);+ });+});++describe('AccordionRoot', () => {+ it('opens, switches, and closes items in single mode', () => {+ render(+ <AccordionRoot defaultValue="profile" className="host-root">+ <AccordionItem value="profile">+ <AccordionTrigger data-track="profile">Profile</AccordionTrigger>+ <AccordionContent>Profile panel</AccordionContent>+ </AccordionItem>+ <AccordionItem value="security">+ <AccordionTrigger>Security</AccordionTrigger>+ <AccordionContent>Security panel</AccordionContent>+ </AccordionItem>+ </AccordionRoot>,+ );++ const profile = screen.getByRole('button', { name: 'Profile' });+ const security = screen.getByRole('button', { name: 'Security' });+ expect(profile).toHaveAttribute('data-track', 'profile');+ expect(profile).toHaveAttribute('aria-expanded', 'true');+ expect(screen.getByRole('region')).toHaveTextContent('Profile panel');++ fireEvent.click(security);+ expect(profile).toHaveAttribute('aria-expanded', 'false');+ expect(security).toHaveAttribute('aria-expanded', 'true');+ expect(screen.queryByText('Profile panel')).not.toBeInTheDocument();+ expect(screen.getByRole('region')).toHaveTextContent('Security panel');+ expect(screen.getByRole('region')).toHaveAttribute('id', security.getAttribute('aria-controls'));++ fireEvent.click(security);+ expect(security).toHaveAttribute('aria-expanded', 'false');+ expect(screen.queryByRole('region')).not.toBeInTheDocument();+ });++ it('keeps independently toggled items open in multiple mode', () => {+ render(+ <AccordionRoot type="multiple">+ <AccordionItem value="first">+ <AccordionTrigger>First</AccordionTrigger>+ <AccordionContent>First panel</AccordionContent>+ </AccordionItem>+ <AccordionItem value="second">+ <AccordionTrigger>Second</AccordionTrigger>+ <AccordionContent>Second panel</AccordionContent>+ </AccordionItem>+ </AccordionRoot>,+ );++ fireEvent.click(screen.getByRole('button', { name: 'First' }));+ fireEvent.click(screen.getByRole('button', { name: 'Second' }));+ expect(screen.getAllByRole('region')).toHaveLength(2);++ fireEvent.click(screen.getByRole('button', { name: 'First' }));+ expect(screen.queryByText('First panel')).not.toBeInTheDocument();+ expect(screen.getByText('Second panel')).toBeInTheDocument();+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/primitives/Avatar.test.tsx b/packages/trueforge-ui-sdk/test/atoms/primitives/Avatar.test.tsxnew file mode 100644index 000000000..ef367f1d0--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/primitives/Avatar.test.tsx@@ -0,0 +1,57 @@+import { fireEvent, render, screen } from '@testing-library/react';+import { describe, expect, it, vi } from 'vitest';++import { Avatar, AvatarFallback, AvatarImage } from '@/atoms/primitives/Avatar.js';++describe('Avatar', () => {+ it('applies the selected size and forwards host attributes', () => {+ render(<Avatar size="lg" className="host-avatar" aria-label="Ada Lovelace" />);++ const avatar = screen.getByLabelText('Ada Lovelace');+ expect(avatar).toHaveAttribute('data-slot', 'avatar');+ expect(avatar).toHaveAttribute('data-size', 'lg');+ expect(avatar).toHaveClass('h-10', 'w-10', 'host-avatar');+ });+});++describe('AvatarImage', () => {+ it('renders its source and accessible alternative text', () => {+ render(<AvatarImage src="/ada.png" alt="Ada Lovelace" className="host-image" />);++ const image = screen.getByRole('img', { name: 'Ada Lovelace' });+ expect(image).toHaveAttribute('src', '/ada.png');+ expect(image).toHaveAttribute('data-slot', 'avatar-image');+ expect(image).toHaveClass('object-cover', 'host-image');+ });++ it('calls the host error handler and removes a failed image', () => {+ const onError = vi.fn();+ render(<AvatarImage src="/missing.png" alt="Missing avatar" onError={onError} />);++ fireEvent.error(screen.getByRole('img', { name: 'Missing avatar' }));++ expect(onError).toHaveBeenCalledOnce();+ expect(screen.queryByRole('img', { name: 'Missing avatar' })).not.toBeInTheDocument();+ });++ it('does not render an image without a source', () => {+ const { container } = render(<AvatarImage alt="No source" />);++ expect(container).toBeEmptyDOMElement();+ });+});++describe('AvatarFallback', () => {+ it('renders fallback content and forwards host attributes', () => {+ render(+ <AvatarFallback className="host-fallback" aria-label="Ada initials">+ AL+ </AvatarFallback>,+ );++ const fallback = screen.getByLabelText('Ada initials');+ expect(fallback).toHaveTextContent('AL');+ expect(fallback).toHaveAttribute('data-slot', 'avatar-fallback');+ expect(fallback).toHaveClass('host-fallback');+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/primitives/BottomSheet.test.tsx b/packages/trueforge-ui-sdk/test/atoms/primitives/BottomSheet.test.tsxnew file mode 100644index 000000000..0d5563c1c--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/primitives/BottomSheet.test.tsx@@ -0,0 +1,149 @@+// @vitest-environment jsdom+import { fireEvent, render, screen } from '@testing-library/react';+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';++import { BottomSheet } from '@/atoms/primitives/BottomSheet.js';++const originalShowModal = Object.getOwnPropertyDescriptor(HTMLDialogElement.prototype, 'showModal');+const originalClose = Object.getOwnPropertyDescriptor(HTMLDialogElement.prototype, 'close');+const showModal = vi.fn(function showModal(this: HTMLDialogElement) {+ this.open = true;+});+const close = vi.fn(function close(this: HTMLDialogElement) {+ this.open = false;+ this.dispatchEvent(new Event('close'));+});++beforeEach(() => {+ showModal.mockClear();+ close.mockClear();+ Object.defineProperty(HTMLDialogElement.prototype, 'showModal', {+ configurable: true,+ value: showModal,+ });+ Object.defineProperty(HTMLDialogElement.prototype, 'close', {+ configurable: true,+ value: close,+ });+});++afterEach(() => {+ if (originalShowModal === undefined) {+ Reflect.deleteProperty(HTMLDialogElement.prototype, 'showModal');+ } else {+ Object.defineProperty(HTMLDialogElement.prototype, 'showModal', originalShowModal);+ }+ if (originalClose === undefined) {+ Reflect.deleteProperty(HTMLDialogElement.prototype, 'close');+ } else {+ Object.defineProperty(HTMLDialogElement.prototype, 'close', originalClose);+ }+});++function getNativeDialog(container: HTMLElement) {+ const dialog = container.querySelector('dialog');+ if (dialog === null) {+ throw new Error('Expected a native dialog');+ }+ return dialog;+}++describe('BottomSheet', () => {+ it('synchronizes the controlled open state with the native dialog', () => {+ const onOpenChange = vi.fn();+ const view = render(+ <BottomSheet open={false} onOpenChange={onOpenChange} aria-label="Picker">+ Content+ </BottomSheet>,+ );+ const dialog = getNativeDialog(view.container);++ expect(dialog).not.toHaveAttribute('open');+ expect(showModal).not.toHaveBeenCalled();++ view.rerender(+ <BottomSheet open onOpenChange={onOpenChange} aria-label="Picker">+ Content+ </BottomSheet>,+ );+ expect(dialog).toHaveAttribute('open');+ expect(showModal).toHaveBeenCalledOnce();++ view.rerender(+ <BottomSheet open onOpenChange={onOpenChange} aria-label="Picker">+ Content+ </BottomSheet>,+ );+ expect(showModal).toHaveBeenCalledOnce();++ view.rerender(+ <BottomSheet open={false} onOpenChange={onOpenChange} aria-label="Picker">+ Content+ </BottomSheet>,+ );+ expect(dialog).not.toHaveAttribute('open');+ expect(close).toHaveBeenCalledOnce();+ expect(onOpenChange).toHaveBeenCalledWith(false);+ });++ it('reports native close and backdrop requests but ignores child clicks', () => {+ const onOpenChange = vi.fn();+ const { container } = render(+ <BottomSheet open onOpenChange={onOpenChange} aria-label="Picker">+ <button type="button">Inside action</button>+ </BottomSheet>,+ );+ const dialog = getNativeDialog(container);++ fireEvent.click(screen.getByRole('button', { name: 'Inside action' }));+ expect(onOpenChange).not.toHaveBeenCalled();++ fireEvent.click(dialog);+ expect(onOpenChange).toHaveBeenCalledOnce();+ expect(onOpenChange).toHaveBeenCalledWith(false);++ onOpenChange.mockClear();+ fireEvent(dialog, new Event('close'));+ expect(onOpenChange).toHaveBeenCalledWith(false);+ });++ it('handles Escape without closing a parent dialog', () => {+ const onOpenChange = vi.fn();+ const onParentCancel = vi.fn();++ render(+ <dialog open onCancel={onParentCancel}>+ <BottomSheet open onOpenChange={onOpenChange} aria-label="Picker">+ Content+ </BottomSheet>+ </dialog>,+ );++ const cancelEvent = new Event('cancel', { bubbles: true, cancelable: true });+ fireEvent(screen.getByRole('dialog', { name: 'Picker' }), cancelEvent);++ expect(cancelEvent.defaultPrevented).toBe(true);+ expect(onOpenChange).toHaveBeenCalledWith(false);+ expect(onParentCancel).not.toHaveBeenCalled();+ });++ it('forwards its id, accessible label, custom class, and children', () => {+ render(+ <BottomSheet+ open+ onOpenChange={() => undefined}+ id="attachment-picker"+ aria-label="Choose an attachment"+ className="custom-sheet"+ >+ <section>Sheet content</section>+ </BottomSheet>,+ );++ const dialog = screen.getByRole('dialog', { name: 'Choose an attachment' });+ expect(dialog).toHaveAttribute('id', 'attachment-picker');+ expect(dialog).toHaveClass('custom-sheet');+ expect(dialog).toHaveStyle({ height: 'min(70dvh, 30rem)', maxHeight: '85dvh' });+ expect(screen.getByText('Sheet content')).toBeInTheDocument();+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/primitives/Button.test.tsx b/packages/trueforge-ui-sdk/test/atoms/primitives/Button.test.tsxnew file mode 100644index 000000000..3cd5d83d6--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/primitives/Button.test.tsx@@ -0,0 +1,49 @@+import { fireEvent, render, screen } from '@testing-library/react';+import { createRef } from 'react';+import { describe, expect, it, vi } from 'vitest';++import { Button } from '@/atoms/primitives/Button.js';++describe('Button', () => {+ it('forwards its ref and host props while applying the requested presentation', () => {+ const ref = createRef<HTMLButtonElement>();+ const onClick = vi.fn();+ render(+ <Button+ ref={ref}+ type="button"+ variant="outline"+ size="lg"+ className="host-button"+ data-track="save"+ onClick={onClick}+ >+ Save changes+ </Button>,+ );++ const button = screen.getByRole('button', { name: 'Save changes' });+ expect(button).toBe(ref.current);+ expect(button).toHaveAttribute('type', 'button');+ expect(button).toHaveAttribute('data-track', 'save');+ expect(button).toHaveClass('border', 'h-10', 'host-button');++ fireEvent.click(button);+ expect(onClick).toHaveBeenCalledOnce();+ });++ it('preserves native disabled behavior', () => {+ const onClick = vi.fn();+ render(+ <Button disabled onClick={onClick}>+ Delete+ </Button>,+ );++ const button = screen.getByRole('button', { name: 'Delete' });+ expect(button).toBeDisabled();++ fireEvent.click(button);+ expect(onClick).not.toHaveBeenCalled();+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/primitives/CenteredModal.test.tsx b/packages/trueforge-ui-sdk/test/atoms/primitives/CenteredModal.test.tsxnew file mode 100644index 000000000..07c1cabb7--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/primitives/CenteredModal.test.tsx@@ -0,0 +1,162 @@+// @vitest-environment jsdom+import { fireEvent, render, screen } from '@testing-library/react';+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';++import { CenteredModal } from '@/atoms/primitives/CenteredModal.js';++const originalShowModal = Object.getOwnPropertyDescriptor(HTMLDialogElement.prototype, 'showModal');+const originalClose = Object.getOwnPropertyDescriptor(HTMLDialogElement.prototype, 'close');+const showModal = vi.fn(function showModal(this: HTMLDialogElement) {+ this.open = true;+});+const close = vi.fn(function close(this: HTMLDialogElement) {+ this.open = false;+ this.dispatchEvent(new Event('close'));+});++beforeEach(() => {+ showModal.mockClear();+ close.mockClear();+ Object.defineProperty(HTMLDialogElement.prototype, 'showModal', {+ configurable: true,+ value: showModal,+ });+ Object.defineProperty(HTMLDialogElement.prototype, 'close', {+ configurable: true,+ value: close,+ });+});++afterEach(() => {+ if (originalShowModal === undefined) {+ Reflect.deleteProperty(HTMLDialogElement.prototype, 'showModal');+ } else {+ Object.defineProperty(HTMLDialogElement.prototype, 'showModal', originalShowModal);+ }+ if (originalClose === undefined) {+ Reflect.deleteProperty(HTMLDialogElement.prototype, 'close');+ } else {+ Object.defineProperty(HTMLDialogElement.prototype, 'close', originalClose);+ }+});++function getNativeDialog(container: HTMLElement) {+ const dialog = container.querySelector('dialog');+ if (dialog === null) {+ throw new Error('Expected a native dialog');+ }+ return dialog;+}++describe('CenteredModal', () => {+ it('synchronizes the controlled open state with the native dialog', () => {+ const onOpenChange = vi.fn();+ const view = render(+ <CenteredModal open={false} onOpenChange={onOpenChange} title="Account">+ Account body+ </CenteredModal>,+ );+ const dialog = getNativeDialog(view.container);++ expect(dialog).not.toHaveAttribute('open');+ expect(showModal).not.toHaveBeenCalled();++ view.rerender(+ <CenteredModal open onOpenChange={onOpenChange} title="Account">+ Account body+ </CenteredModal>,+ );+ expect(dialog).toHaveAttribute('open');+ expect(showModal).toHaveBeenCalledOnce();++ view.rerender(+ <CenteredModal open onOpenChange={onOpenChange} title="Account">+ Account body+ </CenteredModal>,+ );+ expect(showModal).toHaveBeenCalledOnce();++ view.rerender(+ <CenteredModal open={false} onOpenChange={onOpenChange} title="Account">+ Account body+ </CenteredModal>,+ );+ expect(dialog).not.toHaveAttribute('open');+ expect(close).toHaveBeenCalledOnce();+ expect(onOpenChange).toHaveBeenCalledWith(false);+ });++ it('reports native close, close-button, backdrop, and cancel requests', () => {+ const onOpenChange = vi.fn();+ const onParentCancel = vi.fn();+ render(+ <dialog open onCancel={onParentCancel}>+ <CenteredModal open onOpenChange={onOpenChange} title="Account">+ <button type="button">Inside action</button>+ </CenteredModal>+ </dialog>,+ );+ const dialog = screen.getByRole('dialog', { name: 'Account' });++ fireEvent.click(screen.getByRole('button', { name: 'Inside action' }));+ expect(onOpenChange).not.toHaveBeenCalled();++ fireEvent.click(dialog);+ expect(onOpenChange).toHaveBeenLastCalledWith(false);++ onOpenChange.mockClear();+ fireEvent.click(screen.getByRole('button', { name: 'Close' }));+ expect(onOpenChange).toHaveBeenCalledWith(false);++ onOpenChange.mockClear();+ const cancelEvent = new Event('cancel', { bubbles: true, cancelable: true });+ fireEvent(dialog, cancelEvent);+ expect(cancelEvent.defaultPrevented).toBe(true);+ expect(onOpenChange).toHaveBeenCalledWith(false);+ expect(onParentCancel).not.toHaveBeenCalled();++ onOpenChange.mockClear();+ fireEvent(dialog, new Event('close'));+ expect(onOpenChange).toHaveBeenCalledWith(false);+ });++ it('wires its title, optional description, icon, children, and accessible name', () => {+ const { container } = render(+ <CenteredModal+ open+ onOpenChange={() => undefined}+ title="Account settings"+ description="Manage your profile"+ headerIcon={<span data-testid="header-icon">icon</span>}+ aria-label="Account dialog"+ contentSized+ className="custom-modal"+ >+ <section>Modal content</section>+ </CenteredModal>,+ );+ const dialog = getNativeDialog(container);+ const title = screen.getByRole('heading', { name: 'Account settings' });+ const description = screen.getByText('Manage your profile');++ expect(dialog).toHaveAttribute('aria-label', 'Account dialog');+ expect(dialog).toHaveAttribute('aria-labelledby', title.id);+ expect(dialog).toHaveAttribute('aria-describedby', description.id);+ expect(dialog).toHaveClass('custom-modal');+ expect(dialog).toHaveStyle({ height: 'fit-content', maxHeight: '85dvh' });+ expect(screen.getByTestId('header-icon')).toBeInTheDocument();+ expect(screen.getByText('Modal content')).toBeInTheDocument();+ });++ it('uses the title as the label and omits description wiring when absent', () => {+ render(+ <CenteredModal open onOpenChange={() => undefined} title="Untitled description">+ Body+ </CenteredModal>,+ );++ const dialog = screen.getByRole('dialog', { name: 'Untitled description' });+ expect(dialog).toHaveAttribute('aria-label', 'Untitled description');+ expect(dialog).not.toHaveAttribute('aria-describedby');+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/primitives/Dialog.test.tsx b/packages/trueforge-ui-sdk/test/atoms/primitives/Dialog.test.tsxnew file mode 100644index 000000000..cd6ac5c61--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/primitives/Dialog.test.tsx@@ -0,0 +1,245 @@+// @vitest-environment jsdom+import { fireEvent, render, screen } from '@testing-library/react';+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';++import { Dialog, DialogContent, DialogFooter, DialogHeader, DialogTitle, Modal } from '@/atoms/primitives/Dialog.js';++const originalShowModal = Object.getOwnPropertyDescriptor(HTMLDialogElement.prototype, 'showModal');+const originalClose = Object.getOwnPropertyDescriptor(HTMLDialogElement.prototype, 'close');+const showModal = vi.fn(function showModal(this: HTMLDialogElement) {+ this.open = true;+});+const close = vi.fn(function close(this: HTMLDialogElement) {+ this.open = false;+ this.dispatchEvent(new Event('close'));+});++beforeEach(() => {+ showModal.mockClear();+ close.mockClear();+ Object.defineProperty(HTMLDialogElement.prototype, 'showModal', {+ configurable: true,+ value: showModal,+ });+ Object.defineProperty(HTMLDialogElement.prototype, 'close', {+ configurable: true,+ value: close,+ });+});++afterEach(() => {+ if (originalShowModal === undefined) {+ Reflect.deleteProperty(HTMLDialogElement.prototype, 'showModal');+ } else {+ Object.defineProperty(HTMLDialogElement.prototype, 'showModal', originalShowModal);+ }+ if (originalClose === undefined) {+ Reflect.deleteProperty(HTMLDialogElement.prototype, 'close');+ } else {+ Object.defineProperty(HTMLDialogElement.prototype, 'close', originalClose);+ }+});++function getNativeDialog(container: HTMLElement) {+ const dialog = container.querySelector('dialog');+ if (dialog === null) {+ throw new Error('Expected a native dialog');+ }+ return dialog;+}++describe('Dialog', () => {+ it('synchronizes the controlled open state and reports native close events', () => {+ const onOpenChange = vi.fn();+ const view = render(+ <Dialog open={false} onOpenChange={onOpenChange} aria-label="Settings">+ Dialog body+ </Dialog>,+ );+ const dialog = getNativeDialog(view.container);++ expect(dialog).not.toHaveAttribute('open');+ expect(showModal).not.toHaveBeenCalled();++ view.rerender(+ <Dialog open onOpenChange={onOpenChange} aria-label="Settings">+ Dialog body+ </Dialog>,+ );+ expect(dialog).toHaveAttribute('open');+ expect(showModal).toHaveBeenCalledOnce();++ view.rerender(+ <Dialog open onOpenChange={onOpenChange} aria-label="Settings">+ Dialog body+ </Dialog>,+ );+ expect(showModal).toHaveBeenCalledOnce();++ view.rerender(+ <Dialog open={false} onOpenChange={onOpenChange} aria-label="Settings">+ Dialog body+ </Dialog>,+ );+ expect(dialog).not.toHaveAttribute('open');+ expect(close).toHaveBeenCalledOnce();+ expect(onOpenChange).toHaveBeenCalledWith(false);++ onOpenChange.mockClear();+ fireEvent(dialog, new Event('close'));+ expect(onOpenChange).toHaveBeenCalledWith(false);+ });++ it('requests closure only when the dialog backdrop itself is clicked', () => {+ const onOpenChange = vi.fn();+ const { container } = render(+ <Dialog open onOpenChange={onOpenChange} aria-label="Settings">+ <button type="button">Keep editing</button>+ </Dialog>,+ );+ const dialog = getNativeDialog(container);++ fireEvent.click(screen.getByRole('button', { name: 'Keep editing' }));+ expect(onOpenChange).not.toHaveBeenCalled();++ fireEvent.click(dialog);+ expect(onOpenChange).toHaveBeenCalledOnce();+ expect(onOpenChange).toHaveBeenCalledWith(false);+ });++ it('forwards accessibility attributes, custom classes, and children', () => {+ render(+ <>+ <h1 id="settings-title">Workspace settings</h1>+ <Dialog+ open+ onOpenChange={() => undefined}+ aria-label="Settings fallback"+ aria-labelledby="settings-title"+ className="custom-dialog"+ >+ <span>Dialog child</span>+ </Dialog>+ </>,+ );++ const dialog = screen.getByRole('dialog', { name: 'Workspace settings' });+ expect(dialog).toHaveAttribute('aria-label', 'Settings fallback');+ expect(dialog).toHaveAttribute('aria-labelledby', 'settings-title');+ expect(dialog).toHaveClass('custom-dialog');+ expect(screen.getByText('Dialog child')).toBeInTheDocument();+ });+});++describe('Dialog subcomponents', () => {+ it('renders semantic children and forwards HTML attributes', () => {+ render(+ <DialogContent className="content-class" data-testid="content">+ <DialogHeader className="header-class" data-testid="header">+ <DialogTitle className="title-class" id="subcomponent-title" data-state="ready">+ Confirm action+ </DialogTitle>+ </DialogHeader>+ <DialogFooter className="footer-class" data-testid="footer">+ <button type="button">Confirm</button>+ </DialogFooter>+ </DialogContent>,+ );++ expect(screen.getByTestId('content')).toHaveClass('content-class');+ expect(screen.getByTestId('header')).toHaveClass('header-class');+ expect(screen.getByRole('heading', { name: 'Confirm action', level: 2 })).toHaveClass('title-class');+ expect(screen.getByRole('heading', { name: 'Confirm action' })).toHaveAttribute('data-state', 'ready');+ expect(screen.getByTestId('footer')).toHaveClass('footer-class');+ expect(screen.getByRole('button', { name: 'Confirm' })).toBeInTheDocument();+ });+});++describe('Modal', () => {+ it('renders accessible content and closes only from backdrop or Escape', () => {+ const onClose = vi.fn();+ const escapeEvent = new KeyboardEvent('keydown', {+ key: 'Escape',+ bubbles: true,+ cancelable: true,+ });+ const { container } = render(+ <Modal open onClose={onClose} aria-label="Legacy settings">+ <button type="button">Inside legacy modal</button>+ </Modal>,+ );+ const dialog = screen.getByRole('dialog', { name: 'Legacy settings' });+ const backdrop = container.querySelector('[role="presentation"]');+ if (backdrop === null) {+ throw new Error('Expected the modal backdrop');+ }++ expect(dialog).toHaveAttribute('aria-modal', 'true');+ fireEvent.click(dialog);+ expect(onClose).not.toHaveBeenCalled();++ fireEvent.click(backdrop);+ expect(onClose).toHaveBeenCalledOnce();++ onClose.mockClear();+ fireEvent(document, escapeEvent);+ expect(escapeEvent.defaultPrevented).toBe(true);+ expect(onClose).toHaveBeenCalledOnce();+ });++ it('focuses the first control, traps Tab, and restores prior focus on close', () => {+ const onClose = vi.fn();+ const view = render(+ <>+ <button type="button">Open legacy modal</button>+ <Modal open={false} onClose={onClose} aria-label="Legacy settings">+ <button type="button">First control</button>+ <button type="button" disabled>+ Disabled control+ </button>+ <a href="#last">Last control</a>+ </Modal>+ </>,+ );+ const trigger = screen.getByRole('button', { name: 'Open legacy modal' });+ trigger.focus();++ view.rerender(+ <>+ <button type="button">Open legacy modal</button>+ <Modal open onClose={onClose} aria-label="Legacy settings">+ <button type="button">First control</button>+ <button type="button" disabled>+ Disabled control+ </button>+ <a href="#last">Last control</a>+ </Modal>+ </>,+ );+ const first = screen.getByRole('button', { name: 'First control' });+ const last = screen.getByRole('link', { name: 'Last control' });+ expect(first).toHaveFocus();++ last.focus();+ fireEvent.keyDown(document, { key: 'Tab' });+ expect(first).toHaveFocus();++ first.focus();+ fireEvent.keyDown(document, { key: 'Tab', shiftKey: true });+ expect(last).toHaveFocus();++ view.rerender(+ <>+ <button type="button">Open legacy modal</button>+ <Modal open={false} onClose={onClose} aria-label="Legacy settings">+ <button type="button">First control</button>+ <button type="button" disabled>+ Disabled control+ </button>+ <a href="#last">Last control</a>+ </Modal>+ </>,+ );+ expect(trigger).toHaveFocus();+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/primitives/DropdownMenu.test.tsx b/packages/trueforge-ui-sdk/test/atoms/primitives/DropdownMenu.test.tsxnew file mode 100644index 000000000..99e580eb1--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/primitives/DropdownMenu.test.tsx@@ -0,0 +1,118 @@+import { fireEvent, render, screen } from '@testing-library/react';+import { describe, expect, it, vi } from 'vitest';++import { DropdownMenu, DropdownMenuItem, DropdownMenuSeparator } from '@/atoms/primitives/DropdownMenu.js';++describe('DropdownMenu', () => {+ it('opens and closes from clicks, menu selection, and outside interaction', () => {+ const onTriggerClick = vi.fn();+ const onSelect = vi.fn();++ render(+ <div>+ <DropdownMenu trigger={<button onClick={onTriggerClick}>Actions</button>} className="host-menu">+ <DropdownMenuItem onClick={onSelect}>Rename</DropdownMenuItem>+ </DropdownMenu>+ <button>Outside</button>+ </div>,+ );++ const trigger = screen.getByRole('button', { name: 'Actions' });+ expect(trigger).toHaveAttribute('aria-haspopup', 'menu');+ expect(trigger).toHaveAttribute('aria-expanded', 'false');+ expect(trigger).not.toHaveAttribute('aria-controls');++ fireEvent.click(trigger);++ const menu = screen.getByRole('menu');+ expect(onTriggerClick).toHaveBeenCalledOnce();+ expect(trigger).toHaveAttribute('aria-expanded', 'true');+ expect(trigger).toHaveAttribute('aria-controls', menu.id);+ expect(menu).toHaveClass('host-menu');++ fireEvent.click(screen.getByRole('menuitem', { name: 'Rename' }));++ expect(onSelect).toHaveBeenCalledOnce();+ expect(screen.queryByRole('menu')).not.toBeInTheDocument();+ expect(trigger).toHaveAttribute('aria-expanded', 'false');++ fireEvent.click(trigger);+ expect(screen.getByRole('menu')).toBeInTheDocument();++ fireEvent.mouseDown(screen.getByRole('button', { name: 'Outside' }));++ expect(screen.queryByRole('menu')).not.toBeInTheDocument();+ });++ it('merges trigger keyboard handling and manages focus across enabled items', () => {+ const onTriggerKeyDown = vi.fn();+ const onDisabledClick = vi.fn();++ render(+ <DropdownMenu+ trigger={+ <button data-host-trigger="true" onKeyDown={onTriggerKeyDown}>+ Actions+ </button>+ }+ >+ <DropdownMenuItem data-item-id="first">First</DropdownMenuItem>+ <DropdownMenuItem disabled onClick={onDisabledClick}>+ Disabled+ </DropdownMenuItem>+ <DropdownMenuItem data-item-id="last">Last</DropdownMenuItem>+ </DropdownMenu>,+ );++ const trigger = screen.getByRole('button', { name: 'Actions' });+ expect(trigger).toHaveAttribute('data-host-trigger', 'true');++ trigger.focus();+ fireEvent.keyDown(trigger, { key: 'Enter' });++ expect(onTriggerKeyDown).toHaveBeenCalledOnce();+ expect(screen.getByRole('menuitem', { name: 'First' })).toHaveFocus();++ const disabled = screen.getByRole('menuitem', { name: 'Disabled' });+ expect(disabled).toBeDisabled();++ fireEvent.keyDown(document, { key: 'ArrowDown' });+ expect(screen.getByRole('menuitem', { name: 'Last' })).toHaveFocus();++ fireEvent.keyDown(document, { key: 'ArrowDown' });+ expect(screen.getByRole('menuitem', { name: 'First' })).toHaveFocus();++ fireEvent.keyDown(document, { key: 'End' });+ expect(screen.getByRole('menuitem', { name: 'Last' })).toHaveFocus();++ fireEvent.keyDown(document, { key: 'Home' });+ expect(screen.getByRole('menuitem', { name: 'First' })).toHaveFocus();++ fireEvent.keyDown(document, { key: 'ArrowUp' });+ expect(screen.getByRole('menuitem', { name: 'Last' })).toHaveFocus();++ fireEvent.keyDown(document, { key: 'Escape' });+ expect(screen.queryByRole('menu')).not.toBeInTheDocument();+ expect(trigger).toHaveFocus();++ fireEvent.click(trigger);+ fireEvent.click(screen.getByRole('menuitem', { name: 'Disabled' }));+ expect(onDisabledClick).not.toHaveBeenCalled();+ });++ it('forwards item and separator host attributes', () => {+ render(+ <DropdownMenu trigger={<button>Actions</button>}>+ <DropdownMenuItem name="rename" aria-label="Rename item">+ Rename+ </DropdownMenuItem>+ <DropdownMenuSeparator data-divider="actions" aria-label="More actions" />+ </DropdownMenu>,+ );++ fireEvent.click(screen.getByRole('button', { name: 'Actions' }));++ expect(screen.getByRole('menuitem', { name: 'Rename item' })).toHaveAttribute('name', 'rename');+ expect(screen.getByRole('separator', { name: 'More actions' })).toHaveAttribute('data-divider', 'actions');+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/primitives/IconButton.test.tsx b/packages/trueforge-ui-sdk/test/atoms/primitives/IconButton.test.tsxnew file mode 100644index 000000000..34fa6466a--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/primitives/IconButton.test.tsx@@ -0,0 +1,46 @@+import { fireEvent, render, screen } from '@testing-library/react';+import { createRef } from 'react';+import { describe, expect, it, vi } from 'vitest';++import { IconButton } from '@/atoms/primitives/IconButton.js';++describe('IconButton', () => {+ it('uses its label and tooltip accessibly while forwarding button behavior and its ref', () => {+ const ref = createRef<HTMLButtonElement>();+ const onClick = vi.fn();+ render(+ <IconButton+ ref={ref}+ type="button"+ aria-label="Open settings"+ tooltip="Settings"+ variant="ghost"+ className="host-icon-button"+ data-track="settings"+ onClick={onClick}+ >+ <span aria-hidden="true">⚙</span>+ </IconButton>,+ );++ const button = screen.getByRole('button', { name: 'Open settings' });+ expect(button).toBe(ref.current);+ expect(button).toHaveAttribute('title', 'Settings');+ expect(button).toHaveAttribute('type', 'button');+ expect(button).toHaveAttribute('data-track', 'settings');+ expect(button).toHaveClass('h-8', 'w-8', 'host-icon-button');++ fireEvent.click(button);+ expect(onClick).toHaveBeenCalledOnce();+ });++ it('does not add an empty title when no tooltip is provided', () => {+ render(+ <IconButton aria-label="Close">+ <span aria-hidden="true">×</span>+ </IconButton>,+ );++ expect(screen.getByRole('button', { name: 'Close' })).not.toHaveAttribute('title');+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/primitives/SearchInput.test.tsx b/packages/trueforge-ui-sdk/test/atoms/primitives/SearchInput.test.tsxnew file mode 100644index 000000000..6d82cd3bf--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/primitives/SearchInput.test.tsx@@ -0,0 +1,33 @@+import { fireEvent, render, screen } from '@testing-library/react';+import { describe, expect, it, vi } from 'vitest';++import SearchInput from '@/atoms/primitives/SearchInput.js';++describe('SearchInput', () => {+ it('renders an accessible focused search control with its default placeholder', () => {+ render(<SearchInput query="" setQuery={vi.fn()} />);++ const input = screen.getByRole('searchbox');+ expect(input).toHaveAttribute('type', 'search');+ expect(input).toHaveAttribute('placeholder', 'Search');+ expect(input).toHaveFocus();+ });++ it('reports user changes and reflects controlled query updates', () => {+ const setQuery = vi.fn();+ const { rerender } = render(<SearchInput query="initial" setQuery={setQuery} placeholder="Find agents" />);++ const input = screen.getByRole('searchbox');+ expect(input).toHaveValue('initial');+ expect(input).toHaveAttribute('placeholder', 'Find agents');++ fireEvent.change(input, { target: { value: 'updated' } });++ expect(setQuery).toHaveBeenCalledOnce();+ expect(setQuery).toHaveBeenCalledWith('updated');++ rerender(<SearchInput query="updated" setQuery={setQuery} placeholder="Find agents" />);++ expect(screen.getByRole('searchbox')).toHaveValue('updated');+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/primitives/Skeleton.test.tsx b/packages/trueforge-ui-sdk/test/atoms/primitives/Skeleton.test.tsxnew file mode 100644index 000000000..1219be303--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/primitives/Skeleton.test.tsx@@ -0,0 +1,30 @@+import { fireEvent, render, screen } from '@testing-library/react';+import { describe, expect, it, vi } from 'vitest';++import { Skeleton } from '@/atoms/primitives/Skeleton.js';++describe('Skeleton', () => {+ it('renders host content and forwards attributes, styles, classes, and callbacks', () => {+ const onAnimationEnd = vi.fn();+ render(+ <Skeleton+ aria-label="Loading profile"+ className="host-skeleton"+ data-track="profile"+ style={{ width: 120 }}+ onAnimationEnd={onAnimationEnd}+ >+ <span>Placeholder</span>+ </Skeleton>,+ );++ const skeleton = screen.getByLabelText('Loading profile');+ expect(skeleton).toHaveTextContent('Placeholder');+ expect(skeleton).toHaveAttribute('data-track', 'profile');+ expect(skeleton).toHaveStyle({ width: '120px' });+ expect(skeleton).toHaveClass('animate-pulse', 'rounded-md', 'bg-muted', 'host-skeleton');++ fireEvent.animationEnd(skeleton);+ expect(onAnimationEnd).toHaveBeenCalledOnce();+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/primitives/Spinner.test.tsx b/packages/trueforge-ui-sdk/test/atoms/primitives/Spinner.test.tsxnew file mode 100644index 000000000..304bb3e25--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/primitives/Spinner.test.tsx@@ -0,0 +1,37 @@+import { render, screen } from '@testing-library/react';+import { createRef } from 'react';+import { describe, expect, it } from 'vitest';++import { Spinner } from '@/atoms/primitives/Spinner.js';++describe('Spinner', () => {+ it('provides an accessible default loading indicator', () => {+ render(<Spinner />);++ const spinner = screen.getByRole('status', { name: 'Loading' });+ expect(spinner).toHaveAttribute('width', '16');+ expect(spinner).toHaveAttribute('height', '16');+ expect(spinner).toHaveAttribute('viewBox', '0 0 16 16');+ expect(spinner).toHaveClass('animate-spin');+ });++ it('derives its geometry from size and forwards SVG props and its ref', () => {+ const ref = createRef<SVGSVGElement>();+ render(+ <Spinner ref={ref} size={24} aria-label="Saving" className="host-spinner" data-track="save" strokeWidth={4} />,+ );++ const spinner = screen.getByRole('status', { name: 'Saving' });+ const circle = spinner.querySelector('circle');+ expect(spinner).toBe(ref.current);+ expect(spinner).toHaveAttribute('width', '24');+ expect(spinner).toHaveAttribute('height', '24');+ expect(spinner).toHaveAttribute('viewBox', '0 0 24 24');+ expect(spinner).toHaveAttribute('data-track', 'save');+ expect(spinner).toHaveAttribute('stroke-width', '4');+ expect(spinner).toHaveClass('animate-spin', 'host-spinner');+ expect(circle).toHaveAttribute('cx', '12');+ expect(circle).toHaveAttribute('cy', '12');+ expect(circle).toHaveAttribute('r', '9');+ });+});diff --git a/packages/trueforge-ui-sdk/test/atoms/primitives/Tooltip.test.tsx b/packages/trueforge-ui-sdk/test/atoms/primitives/Tooltip.test.tsxnew file mode 100644index 000000000..1114c0a6b--- /dev/null+++ b/packages/trueforge-ui-sdk/test/atoms/primitives/Tooltip.test.tsx@@ -0,0 +1,94 @@+import { act, fireEvent, render, screen } from '@testing-library/react';+import { describe, expect, it, vi } from 'vitest';++import { LightTooltip, Tooltip } from '@/atoms/primitives/Tooltip.js';++describe('Tooltip', () => {+ it('shows and hides on hover while merging the child callbacks', () => {+ const onMouseEnter = vi.fn();+ const onMouseLeave = vi.fn();++ render(+ <Tooltip content="Copy message" className="host-tooltip">+ <button onMouseEnter={onMouseEnter} onMouseLeave={onMouseLeave}>+ Copy+ </button>+ </Tooltip>,+ );++ const trigger = screen.getByRole('button', { name: 'Copy' });+ expect(screen.queryByRole('tooltip')).not.toBeInTheDocument();++ fireEvent.mouseEnter(trigger);++ expect(onMouseEnter).toHaveBeenCalledOnce();+ expect(screen.getByRole('tooltip')).toHaveTextContent('Copy message');+ expect(screen.getByRole('tooltip')).toHaveClass('host-tooltip');++ fireEvent.mouseLeave(trigger);++ expect(onMouseLeave).toHaveBeenCalledOnce();+ expect(screen.queryByRole('tooltip')).not.toBeInTheDocument();+ });++ it('shows and hides on keyboard focus while merging the child callbacks', () => {+ const onFocus = vi.fn();+ const onBlur = vi.fn();++ render(+ <Tooltip content="Open settings">+ <button onFocus={onFocus} onBlur={onBlur}>+ Settings+ </button>+ </Tooltip>,+ );++ const trigger = screen.getByRole('button', { name: 'Settings' });+ act(() => trigger.focus());++ expect(onFocus).toHaveBeenCalledOnce();+ expect(trigger).toHaveFocus();+ expect(screen.getByRole('tooltip')).toHaveAccessibleName('Open settings');++ act(() => trigger.blur());++ expect(onBlur).toHaveBeenCalledOnce();+ expect(screen.queryByRole('tooltip')).not.toBeInTheDocument();+ });++ it('preserves child attributes and disabled behavior', () => {+ const onClick = vi.fn();++ render(+ <Tooltip content="Unavailable">+ <button disabled data-action="archive" onClick={onClick}>+ Archive+ </button>+ </Tooltip>,+ );++ const trigger = screen.getByRole('button', { name: 'Archive' });+ expect(trigger).toBeDisabled();+ expect(trigger).toHaveAttribute('data-action', 'archive');++ fireEvent.click(trigger);++ expect(onClick).not.toHaveBeenCalled();+ });+});++describe('LightTooltip', () => {+ it('forwards its title and tooltip attributes', () => {+ render(+ <LightTooltip title="Light help" className="host-light-tooltip" size="small">+ <button>Help</button>+ </LightTooltip>,+ );++ fireEvent.focus(screen.getByRole('button', { name: 'Help' }));++ const tooltip = screen.getByRole('tooltip');+ expect(tooltip).toHaveTextContent('Light help');+ expect(tooltip).toHaveClass('host-light-tooltip');+ });+});diff --git a/packages/trueforge-ui-sdk/test/containers/AgentStepsContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/AgentStepsContainer.test.tsxnew file mode 100644index 000000000..b5e02cdff--- /dev/null+++ b/packages/trueforge-ui-sdk/test/containers/AgentStepsContainer.test.tsx@@ -0,0 +1,66 @@+// @vitest-environment jsdom+import { fireEvent, render, screen, waitFor } from '@testing-library/react';+import { describe, expect, it } from 'vitest';++import type { AgentStepsCardProps } from '@/atoms/adapters/AgentStepsCardAdapter.js';+import { AgentStepsContainer } from '@/containers/AgentStepsContainer.js';+import { SlotsProvider } from '@/theme/SlotsProvider.js';++function AgentStepsCardProbe({ toolCount, thinkingCount, expanded, onToggle, children }: AgentStepsCardProps) {+ return (+ <section+ data-testid="agent-steps-probe"+ data-tool-count={toolCount}+ data-thinking-count={thinkingCount}+ data-expanded={String(expanded)}+ >+ <button type="button" onClick={onToggle}>+ Toggle steps+ </button>+ {expanded ? children : null}+ </section>+ );+}++function TestSubject({ hasFinal }: { hasFinal: boolean }) {+ return (+ <SlotsProvider overrides={{ AgentStepsCard: AgentStepsCardProbe }}>+ <AgentStepsContainer toolCount={2} thinkingCount={3} hasFinal={hasFinal}>+ <div>step details</div>+ </AgentStepsContainer>+ </SlotsProvider>+ );+}++describe('AgentStepsContainer', () => {+ it('maps counts and toggles its initially expanded children', () => {+ render(<TestSubject hasFinal={false} />);++ const probe = screen.getByTestId('agent-steps-probe');+ expect(probe).toHaveAttribute('data-tool-count', '2');+ expect(probe).toHaveAttribute('data-thinking-count', '3');+ expect(probe).toHaveAttribute('data-expanded', 'true');+ expect(screen.getByText('step details')).toBeInTheDocument();++ fireEvent.click(screen.getByRole('button', { name: 'Toggle steps' }));++ expect(probe).toHaveAttribute('data-expanded', 'false');+ expect(screen.queryByText('step details')).not.toBeInTheDocument();+ });++ it('auto-collapses once when a final answer appears and still allows manual expansion', async () => {+ const { rerender } = render(<TestSubject hasFinal={false} />);++ rerender(<TestSubject hasFinal />);++ await waitFor(() => {+ expect(screen.getByTestId('agent-steps-probe')).toHaveAttribute('data-expanded', 'false');+ });++ fireEvent.click(screen.getByRole('button', { name: 'Toggle steps' }));+ expect(screen.getByTestId('agent-steps-probe')).toHaveAttribute('data-expanded', 'true');++ rerender(<TestSubject hasFinal />);+ expect(screen.getByTestId('agent-steps-probe')).toHaveAttribute('data-expanded', 'true');+ });+});diff --git a/packages/trueforge-ui-sdk/test/containers/AskUserContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/AskUserContainer.test.tsxnew file mode 100644index 000000000..a7b84364c--- /dev/null+++ b/packages/trueforge-ui-sdk/test/containers/AskUserContainer.test.tsx@@ -0,0 +1,159 @@+// @vitest-environment jsdom+import { fireEvent, render, screen } from '@testing-library/react';+import { beforeEach, describe, expect, it, vi } from 'vitest';++import { ASK_USER_CUSTOM_OPTION, type AskUserPromptProps } from '@/atoms/adapters/AskUserPromptAdapter.js';+import { AskUserContainer } from '@/containers/AskUserContainer.js';+import { SlotsProvider } from '@/theme/SlotsProvider.js';++const useToolResponses = vi.hoisted(() => vi.fn());+const useThreadRunning = vi.hoisted(() => vi.fn());++vi.mock('@truefoundry/assistant-ui-runtime', () => ({+ useTrueFoundryToolResponses: () => useToolResponses(),+}));++vi.mock('@assistant-ui/core/react', () => ({+ useThreadIsRunning: () => useThreadRunning(),+}));++function AskUserPromptProbe({+ currentQuestion,+ currentAnswer,+ readOnly,+ isSubmitDisabled,+ isSubmitAllDisabled,+ allQuestionsAnswered,+ onCurrentAnswerChange,+ onSubmit,+}: AskUserPromptProps) {+ return (+ <section+ data-testid="ask-user-probe"+ data-question={currentQuestion?.question}+ data-options={currentQuestion?.options.join('|')}+ data-read-only={String(readOnly)}+ data-answer={currentAnswer?.radioValue}+ data-custom={currentAnswer?.custom}+ data-all-answered={String(allQuestionsAnswered)}+ >+ <button+ type="button"+ disabled={readOnly}+ onClick={() => {+ if (currentQuestion !== undefined) {+ onCurrentAnswerChange?.(currentQuestion.id, { radioValue: 'Proceed' });+ }+ }}+ >+ Choose Proceed+ </button>+ <input+ aria-label="Custom response"+ disabled={readOnly}+ value={currentAnswer?.custom ?? ''}+ onChange={event => {+ if (currentQuestion !== undefined) {+ onCurrentAnswerChange?.(currentQuestion.id, {+ radioValue: ASK_USER_CUSTOM_OPTION,+ custom: event.target.value,+ });+ }+ }}+ />+ <button type="button" disabled={isSubmitDisabled || isSubmitAllDisabled} onClick={onSubmit}>+ Submit response+ </button>+ </section>+ );+}++function renderSubject() {+ return render(+ <SlotsProvider overrides={{ AskUserPrompt: AskUserPromptProbe }}>+ <AskUserContainer />+ </SlotsProvider>,+ );+}++describe('AskUserContainer', () => {+ const respond = vi.fn();++ beforeEach(() => {+ vi.clearAllMocks();+ useThreadRunning.mockReturnValue(false);+ useToolResponses.mockReturnValue({ pending: [], respond });+ });++ it('renders nothing while there is no pending question', () => {+ renderSubject();++ expect(screen.queryByTestId('ask-user-probe')).not.toBeInTheDocument();+ });++ it('maps the first pending question and submits the selected option', () => {+ useToolResponses.mockReturnValue({+ pending: [{ toolCallId: 'question-1', question: 'Continue?', options: ['Proceed', 'Stop'] }],+ respond,+ });+ renderSubject();++ const probe = screen.getByTestId('ask-user-probe');+ expect(probe).toHaveAttribute('data-question', 'Continue?');+ expect(probe).toHaveAttribute('data-options', 'Proceed|Stop');+ expect(probe).toHaveAttribute('data-all-answered', 'false');+ expect(screen.getByRole('button', { name: 'Submit response' })).toBeDisabled();++ fireEvent.click(screen.getByRole('button', { name: 'Choose Proceed' }));++ expect(probe).toHaveAttribute('data-answer', 'Proceed');+ expect(probe).toHaveAttribute('data-all-answered', 'true');+ fireEvent.click(screen.getByRole('button', { name: 'Submit response' }));+ expect(respond).toHaveBeenCalledWith({ toolCallId: 'question-1', content: 'Proceed' });+ });++ it('trims a custom response and resets draft state for the next pending tool call', () => {+ useToolResponses.mockReturnValue({+ pending: [{ toolCallId: 'question-1', question: 'Why?', options: [] }],+ respond,+ });+ const { rerender } = renderSubject();++ fireEvent.change(screen.getByRole('textbox', { name: 'Custom response' }), {+ target: { value: ' because it is safer ' },+ });+ fireEvent.click(screen.getByRole('button', { name: 'Submit response' }));+ expect(respond).toHaveBeenCalledWith({+ toolCallId: 'question-1',+ content: 'because it is safer',+ });++ useToolResponses.mockReturnValue({+ pending: [{ toolCallId: 'question-2', question: undefined, options: undefined }],+ respond,+ });+ rerender(+ <SlotsProvider overrides={{ AskUserPrompt: AskUserPromptProbe }}>+ <AskUserContainer />+ </SlotsProvider>,+ );++ expect(screen.getByTestId('ask-user-probe')).toHaveAttribute('data-question', 'Answer required');+ expect(screen.getByTestId('ask-user-probe')).toHaveAttribute('data-answer', '');+ expect(screen.getByRole('button', { name: 'Submit response' })).toBeDisabled();+ });++ it('maps a running thread to read-only pending state', () => {+ useThreadRunning.mockReturnValue(true);+ useToolResponses.mockReturnValue({+ pending: [{ toolCallId: 'question-1', question: 'Continue?', options: ['Proceed'] }],+ respond,+ });+ renderSubject();++ expect(screen.getByTestId('ask-user-probe')).toHaveAttribute('data-read-only', 'true');+ expect(screen.getByRole('button', { name: 'Choose Proceed' })).toBeDisabled();+ expect(screen.getByRole('textbox', { name: 'Custom response' })).toBeDisabled();+ expect(screen.getByRole('button', { name: 'Submit response' })).toBeDisabled();+ });+});diff --git a/packages/trueforge-ui-sdk/src/containers/AssistantMessageContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/AssistantMessageContainer.test.tsxsimilarity index 96%rename from packages/trueforge-ui-sdk/src/containers/AssistantMessageContainer.test.tsxrename to packages/trueforge-ui-sdk/test/containers/AssistantMessageContainer.test.tsxindex ae2a66049..fa2744388 100644--- a/packages/trueforge-ui-sdk/src/containers/AssistantMessageContainer.test.tsx+++ b/packages/trueforge-ui-sdk/test/containers/AssistantMessageContainer.test.tsx@@ -3,7 +3,7 @@ import { ThreadPrimitive, type ThreadMessageLike } from '@assistant-ui/react';import { render, screen } from '@testing-library/react';import { describe, expect, it } from 'vitest';-import { AssistantMessageContainer } from './AssistantMessageContainer.js';+import { AssistantMessageContainer } from '@/containers/AssistantMessageContainer.js';import { RuntimeHarness } from './RuntimeHarness.js';function renderAssistantMessage(messages: ThreadMessageLike[], options?: { isRunning?: boolean }) {diff --git a/packages/trueforge-ui-sdk/src/containers/AssistantTextContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/AssistantTextContainer.test.tsxsimilarity index 86%rename from packages/trueforge-ui-sdk/src/containers/AssistantTextContainer.test.tsxrename to packages/trueforge-ui-sdk/test/containers/AssistantTextContainer.test.tsxindex 04cb45d48..7f725e69a 100644--- a/packages/trueforge-ui-sdk/src/containers/AssistantTextContainer.test.tsx+++ b/packages/trueforge-ui-sdk/test/containers/AssistantTextContainer.test.tsx@@ -9,9 +9,9 @@ import { fireEvent, render, screen, waitFor } from '@testing-library/react';import { trueFoundryExtras } from '@truefoundry/assistant-ui-runtime';import { describe, expect, it, vi } from 'vitest';-import type { MarkdownProps } from '../atoms/Markdown.js';-import { SlotsProvider } from '../theme/SlotsProvider.js';-import { AssistantMessageContainer } from './AssistantMessageContainer.js';+import type { MarkdownProps } from '@/atoms/Markdown.js';+import { AssistantMessageContainer } from '@/containers/AssistantMessageContainer.js';+import { SlotsProvider } from '@/theme/SlotsProvider.js';import { RuntimeHarness } from './RuntimeHarness.js';function renderAssistantMessage(messages: ThreadMessageLike[]) {@@ -67,6 +67,7 @@ describe('AssistantTextContainer', () => {it('downloads an artifact through the turn that produced the message', async () => {const downloadSandboxFile = vi.fn(async () => new Blob(['hello harness']));+ const anchorClick = vi.spyOn(HTMLAnchorElement.prototype, 'click').mockImplementation(() => {});function ExtrasHarness() {const runtime = useExternalStoreRuntime({@@ -106,12 +107,16 @@ describe('AssistantTextContainer', () => {);}- render(<ExtrasHarness />);+ try {+ render(<ExtrasHarness />);- fireEvent.click(await screen.findByText('report.txt'));+ fireEvent.click(await screen.findByText('report.txt'));- await waitFor(() => {- expect(downloadSandboxFile).toHaveBeenCalledWith({ turnId: 'turn-42', path: '/tmp/report.txt' });- });+ await waitFor(() => {+ expect(downloadSandboxFile).toHaveBeenCalledWith({ turnId: 'turn-42', path: '/tmp/report.txt' });+ });+ } finally {+ anchorClick.mockRestore();+ }});});diff --git a/packages/trueforge-ui-sdk/test/containers/AttachmentsContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/AttachmentsContainer.test.tsxnew file mode 100644index 000000000..d58a46e6f--- /dev/null+++ b/packages/trueforge-ui-sdk/test/containers/AttachmentsContainer.test.tsx@@ -0,0 +1,187 @@+// @vitest-environment jsdom+import {+ AssistantRuntimeProvider,+ ThreadPrimitive,+ useExternalStoreRuntime,+ type AttachmentAdapter,+ type PendingAttachment,+ type ThreadMessageLike,+} from '@assistant-ui/react';+import { fireEvent, render, screen, waitFor } from '@testing-library/react';+import type { ReactNode } from 'react';+import { beforeAll, describe, expect, it, vi } from 'vitest';++import type { AttachmentPickerButtonProps } from '@/atoms/AttachmentPickerButton.js';+import type { AttachmentPreviewDialogProps } from '@/atoms/AttachmentPreviewDialog.js';+import {+ ComposerAttachmentPickerContainer,+ ComposerAttachmentsContainer,+ MessageAttachmentsContainer,+} from '@/containers/AttachmentsContainer.js';+import { SlotsProvider } from '@/theme/SlotsProvider.js';+import { RuntimeHarness } from './RuntimeHarness.js';++beforeAll(() => {+ Object.defineProperty(URL, 'createObjectURL', {+ configurable: true,+ value: vi.fn(() => 'blob:composer-preview'),+ });+ Object.defineProperty(URL, 'revokeObjectURL', {+ configurable: true,+ value: vi.fn(),+ });+ HTMLDialogElement.prototype.showModal = function showModal() {+ this.setAttribute('open', '');+ };+ HTMLDialogElement.prototype.close = function close() {+ this.removeAttribute('open');+ this.dispatchEvent(new Event('close'));+ };+});++function createAttachmentAdapter(remove: AttachmentAdapter['remove']): AttachmentAdapter {+ return {+ accept: 'image/*,.pdf',+ add: async ({ file }) => ({+ id: `pending-${file.name}`,+ type: file.type.startsWith('image/') ? 'image' : 'file',+ name: file.name,+ contentType: file.type,+ file,+ status: { type: 'requires-action', reason: 'composer-send' },+ }),+ remove,+ send: async (attachment: PendingAttachment) => ({+ ...attachment,+ status: { type: 'complete' },+ content: [+ {+ type: 'file',+ data: 'data:application/octet-stream;base64,AA==',+ mimeType: attachment.contentType ?? 'application/octet-stream',+ filename: attachment.name,+ },+ ],+ }),+ };+}++function AttachmentRuntimeHarness({ adapter, children }: { adapter: AttachmentAdapter; children: ReactNode }) {+ const runtime = useExternalStoreRuntime<ThreadMessageLike>({+ messages: [],+ convertMessage: message => message,+ onNew: async () => {},+ adapters: { attachments: adapter },+ });++ return <AssistantRuntimeProvider runtime={runtime}>{children}</AssistantRuntimeProvider>;+}++function PickerOverride(props: AttachmentPickerButtonProps) {+ return (+ <button type="button" {...props}>+ Choose attachment+ </button>+ );+}++function PreviewOverride({ previewSrc, children }: AttachmentPreviewDialogProps) {+ return (+ <div data-testid="attachment-preview-slot" data-preview-src={previewSrc}>+ {children}+ </div>+ );+}++describe('attachment containers', () => {+ it('uses the picker slot, stages a selected file, supplies its preview, and removes it', async () => {+ const remove = vi.fn<AttachmentAdapter['remove']>(async () => {});+ const adapter = createAttachmentAdapter(remove);++ render(+ <SlotsProvider+ overrides={{+ AttachmentPickerButton: PickerOverride,+ AttachmentPreviewDialog: PreviewOverride,+ }}+ >+ <AttachmentRuntimeHarness adapter={adapter}>+ <ComposerAttachmentPickerContainer />+ <ComposerAttachmentsContainer />+ </AttachmentRuntimeHarness>+ </SlotsProvider>,+ );++ fireEvent.click(screen.getByRole('button', { name: 'Choose attachment' }));+ const input = document.querySelector<HTMLInputElement>('input[type="file"]');+ expect(input).not.toBeNull();+ if (input === null) {+ throw new Error('Expected attachment file input');+ }+ expect(input).toHaveAttribute('accept', 'image/*,.pdf');++ const file = new File(['image'], 'diagram.png', { type: 'image/png' });+ fireEvent.change(input, { target: { files: [file] } });++ expect(await screen.findByText('diagram.png')).toBeInTheDocument();+ await waitFor(() => {+ expect(screen.getByTestId('attachment-preview-slot')).toHaveAttribute(+ 'data-preview-src',+ 'blob:composer-preview',+ );+ });++ fireEvent.click(screen.getByRole('button', { name: 'Remove file' }));++ await waitFor(() => {+ expect(screen.queryByText('diagram.png')).not.toBeInTheDocument();+ });+ expect(remove).toHaveBeenCalledTimes(1);+ expect(remove.mock.calls[0]?.[0]).toMatchObject({+ id: 'pending-diagram.png',+ name: 'diagram.png',+ contentType: 'image/png',+ });+ });++ it('opens a full-size preview for a sent image attachment', () => {+ render(+ <RuntimeHarness+ messages={[+ {+ role: 'user',+ content: 'Please inspect this',+ attachments: [+ {+ id: 'image-1',+ type: 'image',+ name: 'result.png',+ contentType: 'image/png',+ status: { type: 'complete' },+ content: [+ {+ type: 'image',+ image: 'data:image/png;base64,iVBORw0KGgo=',+ filename: 'result.png',+ },+ ],+ },+ ],+ },+ ]}+ >+ <ThreadPrimitive.Messages>{() => <MessageAttachmentsContainer />}</ThreadPrimitive.Messages>+ </RuntimeHarness>,+ );++ expect(screen.queryByRole('button', { name: 'Remove file' })).not.toBeInTheDocument();+ fireEvent.click(screen.getByRole('button', { name: 'Open attachment preview' }));++ const dialog = screen.getByRole('dialog', { name: 'Attachment preview' });+ expect(dialog).toHaveAttribute('open');+ expect(screen.getByRole('img', { name: 'Attachment preview' })).toHaveAttribute(+ 'src',+ 'data:image/png;base64,iVBORw0KGgo=',+ );+ });+});diff --git a/packages/trueforge-ui-sdk/src/containers/ComposerContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/ComposerContainer.test.tsxsimilarity index 83%rename from packages/trueforge-ui-sdk/src/containers/ComposerContainer.test.tsxrename to packages/trueforge-ui-sdk/test/containers/ComposerContainer.test.tsxindex f5a569778..c54ba4c00 100644--- a/packages/trueforge-ui-sdk/src/containers/ComposerContainer.test.tsx+++ b/packages/trueforge-ui-sdk/test/containers/ComposerContainer.test.tsx@@ -3,10 +3,10 @@ import type { AppendMessage } from '@assistant-ui/react';import { fireEvent, render, screen, waitFor } from '@testing-library/react';import { describe, expect, it, vi } from 'vitest';-import { ComposerBusyProvider } from '../hooks/useComposerBusyState.js';-import { ShellModeProvider } from '../server/ShellModeContext.js';-import { SlotsProvider } from '../theme/SlotsProvider.js';-import { ComposerContainer } from './ComposerContainer.js';+import { ComposerContainer } from '@/containers/ComposerContainer.js';+import { ComposerBusyProvider } from '@/hooks/useComposerBusyState.js';+import { ShellModeProvider } from '@/server/ShellModeContext.js';+import { SlotsProvider } from '@/theme/SlotsProvider.js';import { RuntimeHarness } from './RuntimeHarness.js';vi.mock('@truefoundry/assistant-ui-runtime', () => ({@@ -36,13 +36,16 @@ describe('ComposerContainer', () => {renderComposer();const dropzone = document.querySelector('[data-slot="aui_composer-attachment-dropzone"]');expect(dropzone).not.toBeNull();- fireEvent.dragEnter(dropzone!);+ if (dropzone === null) {+ throw new Error('Expected attachment dropzone');+ }+ fireEvent.dragEnter(dropzone);expect(dropzone).toHaveAttribute('data-dragging', 'true');});it('keeps the caret in place when text is inserted mid-string', () => {renderComposer();- const input = screen.getByRole('textbox', { name: 'Message input' }) as HTMLTextAreaElement;+ const input = screen.getByRole<HTMLTextAreaElement>('textbox', { name: 'Message input' });fireEvent.change(input, { target: { value: 'hello world' } });fireEvent.change(input, {@@ -56,7 +59,7 @@ describe('ComposerContainer', () => {it('submits once on Enter and inserts a newline on Shift+Enter', async () => {const onNew = vi.fn(async () => {});renderComposer(onNew);- const input = screen.getByRole('textbox', { name: 'Message input' }) as HTMLTextAreaElement;+ const input = screen.getByRole<HTMLTextAreaElement>('textbox', { name: 'Message input' });fireEvent.change(input, { target: { value: 'hi' } });fireEvent.keyDown(input, { key: 'Enter', shiftKey: true });diff --git a/packages/trueforge-ui-sdk/test/containers/ErrorToasterContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/ErrorToasterContainer.test.tsxnew file mode 100644index 000000000..ae23e897e--- /dev/null+++ b/packages/trueforge-ui-sdk/test/containers/ErrorToasterContainer.test.tsx@@ -0,0 +1,138 @@+import { act, fireEvent, render, renderHook, screen, waitFor } from '@testing-library/react';+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';++import { Toast } from '@/atoms/Toast.js';+import { ErrorToasterProvider, useErrorToaster, useErrorToasterOptional } from '@/containers/ErrorToasterContainer.js';+import { SlotsProvider } from '@/theme/SlotsProvider.js';++function Trigger({ errors }: { errors: unknown[] }) {+ const { showError } = useErrorToaster();+ return (+ <button+ type="button"+ onClick={() => {+ for (const error of errors) showError(error);+ }}+ >+ boom+ </button>+ );+}++describe('ErrorToasterProvider', () => {+ beforeEach(() => {+ vi.spyOn(console, 'error').mockImplementation(() => {});+ });++ afterEach(() => {+ vi.restoreAllMocks();+ });++ it('requires a provider for useErrorToaster while the optional hook returns null', () => {+ expect(() => renderHook(() => useErrorToaster())).toThrow(+ 'useErrorToaster must be used within ErrorToasterProvider',+ );++ const { result } = renderHook(() => useErrorToasterOptional());+ expect(result.current).toBeNull();+ });++ it('stacks multiple error toasts', async () => {+ render(+ <SlotsProvider>+ <ErrorToasterProvider>+ <Trigger errors={[new Error('first'), new Error('second')]} />+ </ErrorToasterProvider>+ </SlotsProvider>,+ );++ fireEvent.click(screen.getByRole('button', { name: 'boom' }));++ expect(await screen.findByText('first')).toBeTruthy();+ expect(screen.getByText('second')).toBeTruthy();+ expect(screen.getAllByRole('alert')).toHaveLength(2);+ });++ it('dismisses one toast without removing the other', async () => {+ render(+ <SlotsProvider>+ <ErrorToasterProvider>+ <Trigger errors={[new Error('keep-me'), new Error('drop-me')]} />+ </ErrorToasterProvider>+ </SlotsProvider>,+ );++ fireEvent.click(screen.getByRole('button', { name: 'boom' }));+ expect(await screen.findByText('drop-me')).toBeTruthy();++ const dropToast = screen.getByText('drop-me').closest("[role='alert']");+ expect(dropToast).toBeTruthy();+ const closeButton = dropToast?.querySelector('[aria-label="Close"]');+ if (closeButton === null || closeButton === undefined) {+ throw new Error('Expected close button');+ }+ fireEvent.click(closeButton);++ await waitFor(() => {+ expect(screen.queryByText('drop-me')).toBeNull();+ });+ expect(screen.getByText('keep-me')).toBeTruthy();+ });++ it('formats HTTP-like status and response body details', async () => {+ const httpError = Object.assign(new Error('request failed'), {+ statusCode: 422,+ body: { detail: 'invalid agent' },+ });++ render(+ <SlotsProvider>+ <ErrorToasterProvider>+ <Trigger errors={[httpError]} />+ </ErrorToasterProvider>+ </SlotsProvider>,+ );++ fireEvent.click(screen.getByRole('button', { name: 'boom' }));++ expect(await screen.findByText('Request failed (422)')).toBeInTheDocument();+ expect(screen.getByText(/"detail": "invalid agent"/)).toBeInTheDocument();+ });++ it('keeps only the five most recent errors visible', async () => {+ const errors = Array.from({ length: 6 }, (_, index) => new Error(`error-${index + 1}`));++ render(+ <SlotsProvider>+ <ErrorToasterProvider>+ <Trigger errors={errors} />+ </ErrorToasterProvider>+ </SlotsProvider>,+ );++ fireEvent.click(screen.getByRole('button', { name: 'boom' }));++ expect(await screen.findAllByRole('alert')).toHaveLength(5);+ expect(screen.queryByText('error-1')).not.toBeInTheDocument();+ expect(screen.getByText('error-6')).toBeInTheDocument();+ });+});++describe('Toast copy', () => {+ it('copies title and description', async () => {+ const writeText = vi.fn().mockResolvedValue(undefined);+ Object.assign(navigator, { clipboard: { writeText } });++ render(+ <SlotsProvider>+ <Toast title="Request failed" description="body detail" open onOpenChange={() => {}} />+ </SlotsProvider>,+ );++ await act(async () => {+ fireEvent.click(screen.getByRole('button', { name: 'Copy' }));+ });++ expect(writeText).toHaveBeenCalledWith('Request failed\nbody detail');+ });+});diff --git a/packages/trueforge-ui-sdk/src/containers/HistoryLoaderContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/HistoryLoaderContainer.test.tsxsimilarity index 92%rename from packages/trueforge-ui-sdk/src/containers/HistoryLoaderContainer.test.tsxrename to packages/trueforge-ui-sdk/test/containers/HistoryLoaderContainer.test.tsxindex 308dd1c0c..18e6bb94d 100644--- a/packages/trueforge-ui-sdk/src/containers/HistoryLoaderContainer.test.tsx+++ b/packages/trueforge-ui-sdk/test/containers/HistoryLoaderContainer.test.tsx@@ -4,7 +4,7 @@ import { render, screen, waitFor } from '@testing-library/react';import { trueFoundryExtras } from '@truefoundry/assistant-ui-runtime';import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';-import { HistoryLoaderContainer } from './HistoryLoaderContainer.js';+import { HistoryLoaderContainer } from '@/containers/HistoryLoaderContainer.js';type ObserverCallback = (entries: Array<{ isIntersecting: boolean }>) => void;@@ -21,12 +21,11 @@ class IntersectionObserverStub {beforeEach(() => {observerCallbacks = [];- globalThis.IntersectionObserver = IntersectionObserverStub as unknown as typeof IntersectionObserver;+ vi.stubGlobal('IntersectionObserver', IntersectionObserverStub);});afterEach(() => {- // @ts-expect-error jsdom has no IntersectionObserver; remove the stub.- delete globalThis.IntersectionObserver;+ vi.unstubAllGlobals();});function Harness({diff --git a/packages/trueforge-ui-sdk/src/containers/McpAuthContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/McpAuthContainer.test.tsxsimilarity index 91%rename from packages/trueforge-ui-sdk/src/containers/McpAuthContainer.test.tsxrename to packages/trueforge-ui-sdk/test/containers/McpAuthContainer.test.tsxindex 217cdadfd..007f18a20 100644--- a/packages/trueforge-ui-sdk/src/containers/McpAuthContainer.test.tsx+++ b/packages/trueforge-ui-sdk/test/containers/McpAuthContainer.test.tsx@@ -4,7 +4,7 @@ import { fireEvent, render, screen } from '@testing-library/react';import { trueFoundryExtras, type TrueFoundryRuntimeExtras } from '@truefoundry/assistant-ui-runtime';import { describe, expect, it, vi } from 'vitest';-import { McpAuthContainer } from './McpAuthContainer.js';+import { McpAuthContainer } from '@/containers/McpAuthContainer.js';const SERVERS = [{ id: 'srv-1', name: 'github', authUrl: 'https://example.com/auth/github' },@@ -68,8 +68,12 @@ describe('McpAuthContainer', () => {const connectButtons = screen.getAllByRole('button', { name: /connect/i });expect(connectButtons).toHaveLength(2);- fireEvent.click(connectButtons[0]!);- fireEvent.click(connectButtons[1]!);+ const [githubButton, slackButton] = connectButtons;+ if (githubButton === undefined || slackButton === undefined) {+ throw new Error('Expected connector buttons');+ }+ fireEvent.click(githubButton);+ fireEvent.click(slackButton);expect(openSpy).toHaveBeenCalledWith('https://example.com/auth/github', '_blank', 'noopener,noreferrer');expect(openSpy).toHaveBeenCalledWith('https://example.com/auth/slack', '_blank', 'noopener,noreferrer');diff --git a/packages/trueforge-ui-sdk/test/containers/McpOauthContainer/PostMcpOauthScreen.test.tsx b/packages/trueforge-ui-sdk/test/containers/McpOauthContainer/PostMcpOauthScreen.test.tsxnew file mode 100644index 000000000..8dcd5ae0d--- /dev/null+++ b/packages/trueforge-ui-sdk/test/containers/McpOauthContainer/PostMcpOauthScreen.test.tsx@@ -0,0 +1,110 @@+// @vitest-environment jsdom+import { act, cleanup, render, screen } from '@testing-library/react';+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';++import PostMcpOauthScreen from '@/containers/McpOauthContainer/PostMcpOauthScreen.js';+import { MCP_AUTH_POPUP_CHANNEL } from '@/hooks/useMcpAuth.js';++const channels: BroadcastChannelStub[] = [];++class BroadcastChannelStub {+ readonly name: string;+ readonly postMessage = vi.fn();+ readonly close = vi.fn();++ constructor(name: string) {+ this.name = name;+ channels.push(this);+ }+}++describe('PostMcpOauthScreen', () => {+ beforeEach(() => {+ vi.useFakeTimers();+ channels.length = 0;+ vi.stubGlobal('BroadcastChannel', BroadcastChannelStub);+ vi.spyOn(window, 'close').mockImplementation(() => {});+ window.history.replaceState({}, '', '/oauth/callback');+ });++ afterEach(() => {+ cleanup();+ vi.clearAllTimers();+ vi.useRealTimers();+ vi.restoreAllMocks();+ vi.unstubAllGlobals();+ });++ it('reads a successful result from the URL and broadcasts it immediately and once more', () => {+ window.history.replaceState({}, '', '/oauth/callback?pUid=popup-123&isSuccess=TrUe');++ render(<PostMcpOauthScreen />);++ expect(screen.getByRole('heading', { name: 'Authorization successful' })).toBeInTheDocument();+ expect(channels).toHaveLength(1);+ expect(channels[0]?.name).toBe(MCP_AUTH_POPUP_CHANNEL);+ expect(channels[0]?.postMessage).toHaveBeenCalledWith({+ popupUid: 'popup-123',+ isSuccess: true,+ });+ expect(channels[0]?.close).toHaveBeenCalledOnce();++ act(() => {+ vi.advanceTimersByTime(1000);+ });++ expect(channels).toHaveLength(2);+ expect(channels[1]?.postMessage).toHaveBeenCalledWith({+ popupUid: 'popup-123',+ isSuccess: true,+ });+ expect(channels[1]?.close).toHaveBeenCalledOnce();+ });++ it('renders and broadcasts a failed authorization result', () => {+ window.history.replaceState({}, '', '/oauth/callback?pUid=popup-456&isSuccess=false');++ render(<PostMcpOauthScreen />);++ expect(screen.getByRole('heading', { name: 'Authorization failed' })).toBeInTheDocument();+ expect(channels[0]?.postMessage).toHaveBeenCalledWith({+ popupUid: 'popup-456',+ isSuccess: false,+ });+ });++ it('does not broadcast an invalid result but still closes the popup after two seconds', () => {+ window.history.replaceState({}, '', '/oauth/callback?isSuccess=true');++ render(<PostMcpOauthScreen />);++ expect(screen.getByRole('heading', { name: 'Authorization failed' })).toBeInTheDocument();+ expect(screen.getByText(/authorization result is invalid/i)).toBeInTheDocument();+ expect(channels).toHaveLength(0);++ act(() => {+ vi.advanceTimersByTime(1999);+ });+ expect(window.close).not.toHaveBeenCalled();++ act(() => {+ vi.advanceTimersByTime(1);+ });+ expect(window.close).toHaveBeenCalledOnce();+ });++ it('clears the retry and close timers when unmounted', () => {+ window.history.replaceState({}, '', '/oauth/callback?pUid=popup-cleanup&isSuccess=true');+ const { unmount } = render(<PostMcpOauthScreen />);++ expect(channels).toHaveLength(1);+ unmount();++ act(() => {+ vi.advanceTimersByTime(3000);+ });++ expect(channels).toHaveLength(1);+ expect(window.close).not.toHaveBeenCalled();+ });+});diff --git a/packages/trueforge-ui-sdk/test/containers/ReasoningContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/ReasoningContainer.test.tsxnew file mode 100644index 000000000..466768c6b--- /dev/null+++ b/packages/trueforge-ui-sdk/test/containers/ReasoningContainer.test.tsx@@ -0,0 +1,132 @@+// @vitest-environment jsdom+import { ThreadPrimitive, type ThreadMessageLike } from '@assistant-ui/react';+import { fireEvent, render, screen, waitFor } from '@testing-library/react';+import { useCallback } from 'react';+import { describe, expect, it } from 'vitest';++import type { AgentStepsCardProps } from '@/atoms/adapters/AgentStepsCardAdapter.js';+import type { ReasoningCardProps } from '@/atoms/adapters/ReasoningCardAdapter.js';+import { AssistantMessageContainer } from '@/containers/AssistantMessageContainer.js';+import { SlotsProvider } from '@/theme/SlotsProvider.js';+import { RuntimeHarness } from './RuntimeHarness.js';++function AgentStepsCardProbe({ children }: AgentStepsCardProps) {+ return <div>{children}</div>;+}++function ReasoningCardProbe({+ content,+ isStreaming,+ expanded,+ isMultiLine,+ reasoningTimeText,+ previewText,+ headingText,+ contentRef,+ onToggle,+}: ReasoningCardProps) {+ const measuredContentRef = useCallback(+ (node: HTMLDivElement | null) => {+ if (node !== null) {+ Object.defineProperty(node, 'scrollHeight', { configurable: true, value: 80 });+ }+ contentRef?.(node);+ },+ [contentRef],+ );++ return (+ <section+ data-testid="reasoning-probe"+ data-content={content}+ data-streaming={String(isStreaming)}+ data-expanded={String(expanded)}+ data-multiline={String(isMultiLine)}+ data-reasoning-time={String(reasoningTimeText)}+ data-preview={previewText}+ data-heading={headingText}+ >+ <button type="button" onClick={onToggle}>+ Toggle reasoning+ </button>+ <div ref={measuredContentRef}>measured reasoning</div>+ </section>+ );+}++function TestSubject({ message, isRunning = false }: { message: ThreadMessageLike; isRunning?: boolean }) {+ return (+ <RuntimeHarness messages={[message]} isRunning={isRunning}>+ <SlotsProvider+ overrides={{+ AgentStepsCard: AgentStepsCardProbe,+ ReasoningCard: ReasoningCardProbe,+ }}+ >+ <ThreadPrimitive.Messages>{() => <AssistantMessageContainer />}</ThreadPrimitive.Messages>+ </SlotsProvider>+ </RuntimeHarness>+ );+}++describe('ReasoningContainer', () => {+ it('joins grouped reasoning, normalizes its preview, and measures multiline content', async () => {+ render(+ <TestSubject+ message={{+ role: 'assistant',+ content: [+ { type: 'reasoning', text: 'First line\n' },+ { type: 'reasoning', text: ' second line' },+ ],+ }}+ />,+ );++ const probe = screen.getByTestId('reasoning-probe');+ expect(probe).toHaveAttribute('data-content', 'First line\n second line');+ expect(probe).toHaveAttribute('data-preview', 'First line second line');+ expect(probe).toHaveAttribute('data-streaming', 'false');+ expect(probe).toHaveAttribute('data-expanded', 'false');+ expect(probe).toHaveAttribute('data-heading', 'Reasoning');+ expect(probe).toHaveAttribute('data-reasoning-time', 'null');+ await waitFor(() => {+ expect(probe).toHaveAttribute('data-multiline', 'true');+ });++ fireEvent.click(screen.getByRole('button', { name: 'Toggle reasoning' }));+ expect(probe).toHaveAttribute('data-expanded', 'true');+ });++ it('starts expanded while streaming and re-expands when streaming resumes', async () => {+ const completedMessage: ThreadMessageLike = {+ role: 'assistant',+ content: [{ type: 'reasoning', text: 'Thinking' }],+ };+ const runningMessage: ThreadMessageLike = {+ role: 'assistant',+ content: [{ type: 'reasoning', text: 'Thinking further' }],+ status: { type: 'running' },+ };+ const { rerender } = render(<TestSubject message={runningMessage} isRunning />);++ const probe = screen.getByTestId('reasoning-probe');+ expect(probe).toHaveAttribute('data-streaming', 'true');+ expect(probe).toHaveAttribute('data-expanded', 'true');++ fireEvent.click(screen.getByRole('button', { name: 'Toggle reasoning' }));+ expect(probe).toHaveAttribute('data-expanded', 'false');++ rerender(<TestSubject message={completedMessage} />);+ await waitFor(() => {+ expect(screen.getByTestId('reasoning-probe')).toHaveAttribute('data-streaming', 'false');+ });+ expect(screen.getByTestId('reasoning-probe')).toHaveAttribute('data-expanded', 'false');++ rerender(<TestSubject message={runningMessage} isRunning />);+ await waitFor(() => {+ expect(screen.getByTestId('reasoning-probe')).toHaveAttribute('data-streaming', 'true');+ expect(screen.getByTestId('reasoning-probe')).toHaveAttribute('data-expanded', 'true');+ });+ });+});diff --git a/packages/trueforge-ui-sdk/src/containers/RuntimeHarness.tsx b/packages/trueforge-ui-sdk/test/containers/RuntimeHarness.tsxsimilarity index 100%rename from packages/trueforge-ui-sdk/src/containers/RuntimeHarness.tsxrename to packages/trueforge-ui-sdk/test/containers/RuntimeHarness.tsxdiff --git a/packages/trueforge-ui-sdk/test/containers/SandboxToolCallContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/SandboxToolCallContainer.test.tsxnew file mode 100644index 000000000..1aecb9aec--- /dev/null+++ b/packages/trueforge-ui-sdk/test/containers/SandboxToolCallContainer.test.tsx@@ -0,0 +1,114 @@+// @vitest-environment jsdom+import { fireEvent, render, screen } from '@testing-library/react';+import { describe, expect, it } from 'vitest';++import type { SandboxToolCallCardProps } from '@/atoms/SandboxToolCallCard.js';+import { SandboxToolCallContainer } from '@/containers/SandboxToolCallContainer.js';+import { SlotsProvider } from '@/theme/SlotsProvider.js';++function SandboxToolCallCardProbe({+ name,+ status,+ expanded,+ command,+ argsJson,+ resultText,+ resultJson,+ viewMode,+ hasContent,+ onViewModeChange,+}: SandboxToolCallCardProps) {+ return (+ <section+ data-testid="sandbox-probe"+ data-name={name}+ data-status={status}+ data-expanded={String(expanded)}+ data-command={command}+ data-args={argsJson}+ data-result-text={resultText}+ data-result-json={resultJson}+ data-view-mode={viewMode}+ data-has-content={String(hasContent)}+ >+ <button type="button" onClick={() => onViewModeChange?.('terminal')}>+ Show terminal+ </button>+ <button type="button" onClick={() => onViewModeChange?.('code')}>+ Show code+ </button>+ </section>+ );+}++function renderSubject(props: Omit<SandboxToolCallCardProps, 'viewMode' | 'hasContent' | 'onViewModeChange'>) {+ return render(+ <SlotsProvider overrides={{ SandboxToolCallCard: SandboxToolCallCardProbe }}>+ <SandboxToolCallContainer {...props} />+ </SlotsProvider>,+ );+}++describe('SandboxToolCallContainer', () => {+ it('starts in terminal mode, forwards card props, and reveals argument JSON in code mode', () => {+ renderSubject({+ name: 'run_command',+ status: 'success',+ expanded: true,+ onToggle: () => {},+ argsJson: '{"command":"pwd"}',+ });++ const probe = screen.getByTestId('sandbox-probe');+ expect(probe).toHaveAttribute('data-name', 'run_command');+ expect(probe).toHaveAttribute('data-status', 'success');+ expect(probe).toHaveAttribute('data-expanded', 'true');+ expect(probe).toHaveAttribute('data-args', '{"command":"pwd"}');+ expect(probe).toHaveAttribute('data-view-mode', 'terminal');+ expect(probe).toHaveAttribute('data-has-content', 'false');++ fireEvent.click(screen.getByRole('button', { name: 'Show code' }));+ expect(probe).toHaveAttribute('data-view-mode', 'code');+ expect(probe).toHaveAttribute('data-has-content', 'true');++ fireEvent.click(screen.getByRole('button', { name: 'Show terminal' }));+ expect(probe).toHaveAttribute('data-view-mode', 'terminal');+ expect(probe).toHaveAttribute('data-has-content', 'false');+ });++ it('treats command and text output as terminal-only content', () => {+ renderSubject({+ name: 'run_command',+ status: 'running',+ expanded: false,+ onToggle: () => {},+ command: 'pnpm test',+ resultText: 'passed',+ });++ const probe = screen.getByTestId('sandbox-probe');+ expect(probe).toHaveAttribute('data-command', 'pnpm test');+ expect(probe).toHaveAttribute('data-result-text', 'passed');+ expect(probe).toHaveAttribute('data-has-content', 'true');++ fireEvent.click(screen.getByRole('button', { name: 'Show code' }));+ expect(probe).toHaveAttribute('data-has-content', 'false');+ });++ it('keeps structured result JSON available in both views', () => {+ renderSubject({+ name: 'run_command',+ status: 'error',+ expanded: true,+ onToggle: () => {},+ resultJson: '{"exit_code":1}',+ });++ const probe = screen.getByTestId('sandbox-probe');+ expect(probe).toHaveAttribute('data-result-json', '{"exit_code":1}');+ expect(probe).toHaveAttribute('data-has-content', 'true');++ fireEvent.click(screen.getByRole('button', { name: 'Show code' }));+ expect(probe).toHaveAttribute('data-has-content', 'true');+ });+});diff --git a/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/ImportGithubSkillForm.test.tsx b/packages/trueforge-ui-sdk/test/containers/SettingsBuilder/ImportGithubSkillForm.test.tsxsimilarity index 94%rename from packages/trueforge-ui-sdk/src/containers/SettingsBuilder/ImportGithubSkillForm.test.tsxrename to packages/trueforge-ui-sdk/test/containers/SettingsBuilder/ImportGithubSkillForm.test.tsxindex d4b819f39..49abc1633 100644--- a/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/ImportGithubSkillForm.test.tsx+++ b/packages/trueforge-ui-sdk/test/containers/SettingsBuilder/ImportGithubSkillForm.test.tsx@@ -2,7 +2,7 @@import { fireEvent, render, screen, waitFor } from '@testing-library/react';import { beforeAll, describe, expect, it, vi } from 'vitest';-import ImportGithubSkillForm from './ImportGithubSkillForm.js';+import ImportGithubSkillForm from '@/containers/SettingsBuilder/ImportGithubSkillForm.js';beforeAll(() => {HTMLDialogElement.prototype.showModal = function showModal() {diff --git a/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/SandboxSettings.test.tsx b/packages/trueforge-ui-sdk/test/containers/SettingsBuilder/SandboxSettings.test.tsxsimilarity index 95%rename from packages/trueforge-ui-sdk/src/containers/SettingsBuilder/SandboxSettings.test.tsxrename to packages/trueforge-ui-sdk/test/containers/SettingsBuilder/SandboxSettings.test.tsxindex 38e50a4c7..62b946cbe 100644--- a/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/SandboxSettings.test.tsx+++ b/packages/trueforge-ui-sdk/test/containers/SettingsBuilder/SandboxSettings.test.tsx@@ -3,15 +3,15 @@ import { fireEvent, render, screen, waitFor } from '@testing-library/react';import type { ReactNode } from 'react';import { beforeAll, describe, expect, it } from 'vitest';-import { ServerProvider } from '../../server/ServerContext.js';+import SandboxSettings from '@/containers/SettingsBuilder/SandboxSettings.js';+import { ServerProvider } from '@/server/ServerContext.js';import type {- AgentUIServer,CreateSandboxProviderRequest,SandboxProviderBase,SandboxProviderCatalogEntry,UpdateSandboxProviderRequest,-} from '../../server/types.js';-import SandboxSettings from './SandboxSettings.js';+} from '@/server/types.js';+import { createMockAgentUIServer, createMockCatalog } from '../../server/mockServer.js';beforeAll(() => {HTMLDialogElement.prototype.showModal = function showModal() {@@ -79,7 +79,9 @@ function createFakeHost(initial: SandboxProviderBase[] = []) {},};- const server = { catalog: { sandboxCatalog } } as unknown as AgentUIServer;+ const server = createMockAgentUIServer({+ catalog: createMockCatalog({ sandboxCatalog }),+ });return {created,diff --git a/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/SkillSettings.test.tsx b/packages/trueforge-ui-sdk/test/containers/SettingsBuilder/SkillSettings.test.tsxsimilarity index 92%rename from packages/trueforge-ui-sdk/src/containers/SettingsBuilder/SkillSettings.test.tsxrename to packages/trueforge-ui-sdk/test/containers/SettingsBuilder/SkillSettings.test.tsxindex d77e14aec..fa0d2fb0a 100644--- a/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/SkillSettings.test.tsx+++ b/packages/trueforge-ui-sdk/test/containers/SettingsBuilder/SkillSettings.test.tsx@@ -3,9 +3,10 @@ import { fireEvent, render, screen, waitFor } from '@testing-library/react';import type { ReactNode } from 'react';import { beforeAll, describe, expect, it } from 'vitest';-import { ServerProvider } from '../../server/ServerContext.js';-import type { AgentUIServer, CreateSkillRequest, DefinedSkill, SkillCatalogEntry } from '../../server/types.js';-import SkillSettings from './SkillSettings.js';+import SkillSettings from '@/containers/SettingsBuilder/SkillSettings.js';+import { ServerProvider } from '@/server/ServerContext.js';+import type { CreateSkillRequest, DefinedSkill, SkillCatalogEntry } from '@/server/types.js';+import { createMockAgentUIServer, createMockCatalog } from '../../server/mockServer.js';beforeAll(() => {HTMLDialogElement.prototype.showModal = function showModal() {@@ -56,7 +57,9 @@ function createFakeHost(initial: DefinedSkill[] = []) {},};- const server = { catalog: { skillCatalog } } as unknown as AgentUIServer;+ const server = createMockAgentUIServer({+ catalog: createMockCatalog({ skillCatalog }),+ });return {created,diff --git a/packages/trueforge-ui-sdk/test/containers/SettingsBuilder/index.test.tsx b/packages/trueforge-ui-sdk/test/containers/SettingsBuilder/index.test.tsxnew file mode 100644index 000000000..0825e7767--- /dev/null+++ b/packages/trueforge-ui-sdk/test/containers/SettingsBuilder/index.test.tsx@@ -0,0 +1,145 @@+// @vitest-environment jsdom+import { fireEvent, render, screen, waitFor } from '@testing-library/react';+import type { ReactNode } from 'react';+import { describe, expect, it, vi } from 'vitest';++import TruefoundrySettingsBuilder from '@/containers/SettingsBuilder/index.js';+import { ServerProvider } from '@/server/ServerContext.js';+import { ShellModeProvider, useShellMode } from '@/server/ShellModeContext.js';+import type { AgentUIServer, SandboxCatalogServer, SkillCatalogServer } from '@/server/types.js';+import { createMockAgentUIServer, createMockCatalog } from '../../server/mockServer.js';++vi.mock('@/containers/SettingsBuilder/ModelSettings.js', () => ({+ default: () => <div>Model settings content</div>,+}));++vi.mock('@/containers/SettingsBuilder/ConnectorSettings.js', () => ({+ default: () => <div>Connector settings content</div>,+}));++vi.mock('@/containers/SettingsBuilder/SkillSettings.js', () => ({+ default: () => <div>Skill settings content</div>,+}));++vi.mock('@/containers/SettingsBuilder/SandboxSettings.js', () => ({+ default: () => <div>Sandbox settings content</div>,+}));++async function unavailable(): Promise<never> {+ throw new Error('Unexpected settings section call');+}++const skillCatalog: SkillCatalogServer = {+ getSkillCatalog: async () => [],+ listSkills: async () => [],+ createSkill: unavailable,+};++const sandboxCatalog: SandboxCatalogServer = {+ getSandboxProviderCatalog: async () => [],+ listSandboxProviders: async () => [],+ createSandboxProvider: unavailable,+ updateSandboxProvider: unavailable,+};++function createServer(options: { catalog?: boolean; skills?: boolean; sandbox?: boolean } = {}): AgentUIServer {+ if (options.catalog === false) {+ return createMockAgentUIServer();+ }+ return createMockAgentUIServer({+ catalog: createMockCatalog({+ ...(options.skills ? { skillCatalog } : {}),+ ...(options.sandbox ? { sandboxCatalog } : {}),+ }),+ });+}++function SettingsControls() {+ const { setSettingsOpen } = useShellMode();+ return (+ <button type="button" onClick={() => setSettingsOpen(true)}>+ Open settings+ </button>+ );+}++function TestShell({ server, children }: { server?: AgentUIServer; children?: ReactNode }) {+ const content = (+ <ShellModeProvider>+ <SettingsControls />+ <TruefoundrySettingsBuilder />+ {children}+ </ShellModeProvider>+ );+ return server === undefined ? content : <ServerProvider server={server}>{content}</ServerProvider>;+}++describe('TruefoundrySettingsBuilder', () => {+ it('stays hidden while closed and when no settings catalog is available', () => {+ const { rerender } = render(<TestShell server={createServer()} />);++ expect(screen.queryByRole('heading', { name: 'Settings' })).not.toBeInTheDocument();++ fireEvent.click(screen.getByRole('button', { name: 'Open settings' }));+ expect(screen.getByRole('heading', { name: 'Settings' })).toBeInTheDocument();++ rerender(<TestShell server={createServer({ catalog: false })} />);+ expect(screen.queryByRole('heading', { name: 'Settings' })).not.toBeInTheDocument();++ rerender(<TestShell />);+ expect(screen.queryByRole('heading', { name: 'Settings' })).not.toBeInTheDocument();+ });++ it('only exposes optional sections backed by catalogs', () => {+ const { rerender } = render(<TestShell server={createServer()} />);+ fireEvent.click(screen.getByRole('button', { name: 'Open settings' }));++ expect(screen.getByRole('button', { name: 'Models' })).toHaveAttribute('aria-current', 'page');+ expect(screen.getByRole('button', { name: 'Connectors' })).toBeInTheDocument();+ expect(screen.queryByRole('button', { name: 'Skills' })).not.toBeInTheDocument();+ expect(screen.queryByRole('button', { name: 'Sandbox' })).not.toBeInTheDocument();+ expect(screen.getByText('Model settings content')).toBeInTheDocument();++ rerender(<TestShell server={createServer({ skills: true, sandbox: true })} />);++ fireEvent.click(screen.getByRole('button', { name: 'Skills' }));+ expect(screen.getByText('Skill settings content')).toBeInTheDocument();++ fireEvent.click(screen.getByRole('button', { name: 'Sandbox providers' }));+ expect(screen.getByText('Sandbox settings content')).toBeInTheDocument();++ fireEvent.click(screen.getByRole('button', { name: 'Connectors' }));+ expect(screen.getByText('Connector settings content')).toBeInTheDocument();+ });++ it('resets a stale optional section when its catalog disappears', async () => {+ const { rerender } = render(<TestShell server={createServer({ skills: true })} />);+ fireEvent.click(screen.getByRole('button', { name: 'Open settings' }));+ fireEvent.click(screen.getByRole('button', { name: 'Skills' }));++ expect(screen.getByText('Skill settings content')).toBeInTheDocument();++ rerender(<TestShell server={createServer()} />);++ await waitFor(() => {+ expect(screen.getByRole('button', { name: 'Models' })).toHaveAttribute('aria-current', 'page');+ });+ expect(screen.getByText('Model settings content')).toBeInTheDocument();+ expect(screen.queryByRole('button', { name: 'Skills' })).not.toBeInTheDocument();+ });++ it('closes on Escape without leaking the event to a parent handler', () => {+ const parentKeyDown = vi.fn();+ render(+ <div onKeyDown={parentKeyDown}>+ <TestShell server={createServer()} />+ </div>,+ );+ fireEvent.click(screen.getByRole('button', { name: 'Open settings' }));++ fireEvent.keyDown(screen.getByRole('heading', { name: 'Settings' }), { key: 'Escape' });++ expect(screen.queryByRole('heading', { name: 'Settings' })).not.toBeInTheDocument();+ expect(parentKeyDown).not.toHaveBeenCalled();+ });+});diff --git a/packages/trueforge-ui-sdk/test/containers/Thread.test.tsx b/packages/trueforge-ui-sdk/test/containers/Thread.test.tsxnew file mode 100644index 000000000..2731028af--- /dev/null+++ b/packages/trueforge-ui-sdk/test/containers/Thread.test.tsx@@ -0,0 +1,34 @@+// @vitest-environment jsdom+import { render, screen } from '@testing-library/react';+import { describe, expect, it, vi } from 'vitest';++import type { WelcomeScreenProps } from '@/atoms/WelcomeScreen.js';+import { Thread } from '@/containers/Thread.js';+import { SlotsProvider } from '@/theme/SlotsProvider.js';+import { RuntimeHarness } from './RuntimeHarness.js';++vi.mock('@truefoundry/assistant-ui-runtime', () => ({+ useTrueFoundryCancel: () => vi.fn(),+ useTrueFoundryToolResponses: () => ({ pending: [] }),+}));++function WelcomeOverride({ heading }: WelcomeScreenProps) {+ return <div data-testid="welcome-slot">{heading ?? 'Custom welcome'}</div>;+}++describe('Thread', () => {+ it('assembles the thread view and composer while honoring thread slots', () => {+ render(+ <SlotsProvider overrides={{ WelcomeScreen: WelcomeOverride }}>+ <RuntimeHarness messages={[]}>+ <Thread />+ </RuntimeHarness>+ </SlotsProvider>,+ );++ expect(screen.getByTestId('welcome-slot')).toHaveTextContent('Custom welcome');+ expect(screen.getByRole('textbox', { name: 'Message input' })).toBeInTheDocument();+ expect(document.querySelector('[data-slot="aui_thread-viewport"]')).toBeInTheDocument();+ expect(document.querySelector('[data-slot="aui_composer-shell"]')).toBeInTheDocument();+ });+});diff --git a/packages/trueforge-ui-sdk/src/containers/ThreadContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/ThreadContainer.test.tsxsimilarity index 94%rename from packages/trueforge-ui-sdk/src/containers/ThreadContainer.test.tsxrename to packages/trueforge-ui-sdk/test/containers/ThreadContainer.test.tsxindex 7dbcd1682..07e00e2b0 100644--- a/packages/trueforge-ui-sdk/src/containers/ThreadContainer.test.tsx+++ b/packages/trueforge-ui-sdk/test/containers/ThreadContainer.test.tsx@@ -1,12 +1,12 @@// @vitest-environment jsdom-import type { AssistantState, ThreadMessageLike } from '@assistant-ui/react';+import type { ThreadMessageLike } from '@assistant-ui/react';import { render, screen, waitFor } from '@testing-library/react';import { useEffect, useRef, type ReactNode } from 'react';import { describe, expect, it } from 'vitest';-import { ShellModeProvider, useShellMode } from '../server/ShellModeContext.js';+import { isNewChatView, ThreadContainer } from '@/containers/ThreadContainer.js';+import { ShellModeProvider, useShellMode } from '@/server/ShellModeContext.js';import { RuntimeHarness } from './RuntimeHarness.js';-import { isNewChatView, ThreadContainer } from './ThreadContainer.js';function EditAgentBootstrap({ children }: { children: ReactNode }) {const shell = useShellMode();@@ -55,7 +55,7 @@ function emptyThreadState(threadsIsLoading?: boolean;remoteId?: string | undefined;} = {},-): AssistantState {+) {return {thread: {messages: [],@@ -67,7 +67,7 @@ function emptyThreadState(threadListItem: {remoteId: overrides.remoteId,},- } as unknown as AssistantState;+ };}describe('isNewChatView', () => {diff --git a/packages/trueforge-ui-sdk/test/containers/ThreadListContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/ThreadListContainer.test.tsxnew file mode 100644index 000000000..f38c6d4df--- /dev/null+++ b/packages/trueforge-ui-sdk/test/containers/ThreadListContainer.test.tsx@@ -0,0 +1,186 @@+// @vitest-environment jsdom+import {+ AssistantRuntimeProvider,+ useExternalStoreRuntime,+ type ExternalStoreThreadListAdapter,+ type ThreadMessageLike,+} from '@assistant-ui/react';+import { fireEvent, render, screen, waitFor } from '@testing-library/react';+import type { ReactNode } from 'react';+import { beforeAll, describe, expect, it, vi } from 'vitest';++import type { ThreadListRowProps } from '@/atoms/ThreadListRow.js';+import { CompactLayoutProvider } from '@/atoms/lib/CompactLayoutContext.js';+import { ThreadListContainer } from '@/containers/ThreadListContainer.js';+import { ServerProvider } from '@/server/ServerContext.js';+import { SlotsProvider } from '@/theme/SlotsProvider.js';+import { createMockAgentUIServer } from '../server/mockServer.js';++beforeAll(() => {+ HTMLDialogElement.prototype.showModal = function showModal() {+ this.setAttribute('open', '');+ };+ HTMLDialogElement.prototype.close = function close() {+ this.removeAttribute('open');+ this.dispatchEvent(new Event('close'));+ };+});++function ThreadListRuntimeHarness({+ threadList,+ children,+}: {+ threadList: ExternalStoreThreadListAdapter;+ children: ReactNode;+}) {+ const runtime = useExternalStoreRuntime<ThreadMessageLike>({+ messages: [],+ convertMessage: message => message,+ onNew: async () => {},+ adapters: { threadList },+ });++ return <AssistantRuntimeProvider runtime={runtime}>{children}</AssistantRuntimeProvider>;+}++function ThreadListRowOverride({ title, active, onSelect, actions }: ThreadListRowProps) {+ return (+ <div data-testid={`thread-row-${title}`} data-active={active ? 'true' : 'false'}>+ <button type="button" onClick={onSelect}>+ {title}+ </button>+ {actions}+ </div>+ );+}++function renderThreadList({+ adapter,+ onThreadOpen,+ canDelete = false,+}: {+ adapter: ExternalStoreThreadListAdapter;+ onThreadOpen?: () => void;+ canDelete?: boolean;+}) {+ const list = (+ <SlotsProvider overrides={{ ThreadListRow: ThreadListRowOverride }}>+ <ThreadListRuntimeHarness threadList={adapter}>+ <CompactLayoutProvider>+ <ThreadListContainer onThreadOpen={onThreadOpen} />+ </CompactLayoutProvider>+ </ThreadListRuntimeHarness>+ </SlotsProvider>+ );++ if (!canDelete) {+ return render(list);+ }++ return render(+ <ServerProvider server={createMockAgentUIServer({ deleteSession: async () => {} })}>{list}</ServerProvider>,+ );+}++describe('ThreadListContainer', () => {+ it('renders loading and empty list states from the runtime', () => {+ const { unmount } = renderThreadList({+ adapter: {+ isLoading: true,+ threads: [],+ },+ });++ expect(screen.getByRole('status', { name: 'Loading threads' })).toBeInTheDocument();+ unmount();++ renderThreadList({+ adapter: {+ isLoading: false,+ threads: [],+ },+ });++ expect(screen.getByText('No threads yet')).toBeInTheDocument();+ expect(screen.queryByRole('status', { name: 'Loading threads' })).not.toBeInTheDocument();+ });++ it('starts a new chat and selects a row through the thread-list API', async () => {+ const onSwitchToNewThread = vi.fn(async () => {});+ const onSwitchToThread = vi.fn(async () => {});+ const onThreadOpen = vi.fn();++ renderThreadList({+ adapter: {+ threadId: 'thread-1',+ threads: [+ {+ status: 'regular',+ id: 'thread-1',+ title: 'Current session',+ },+ {+ status: 'regular',+ id: 'thread-2',+ title: 'Previous session',+ },+ ],+ onSwitchToNewThread,+ onSwitchToThread,+ },+ onThreadOpen,+ });++ expect(screen.getByTestId('thread-row-Current session')).toHaveAttribute('data-active', 'true');+ expect(screen.getByTestId('thread-row-Previous session')).toHaveAttribute('data-active', 'false');++ fireEvent.click(screen.getByRole('button', { name: 'Previous session' }));+ await waitFor(() => {+ expect(onSwitchToThread).toHaveBeenCalledWith('thread-2');+ });++ fireEvent.click(screen.getByRole('button', { name: 'Start new chat' }));+ await waitFor(() => {+ expect(onSwitchToNewThread).toHaveBeenCalledTimes(1);+ });+ expect(onThreadOpen).toHaveBeenCalledTimes(2);+ });++ it('exposes delete only for remote sessions and delegates deletion to the runtime', async () => {+ const onDelete = vi.fn(async () => {});++ renderThreadList({+ adapter: {+ threadId: 'thread-1',+ threads: [+ {+ status: 'regular',+ id: 'thread-1',+ remoteId: 'session-1',+ title: 'Remote session',+ },+ {+ status: 'regular',+ id: 'thread-local',+ title: 'Local draft',+ },+ ],+ onDelete,+ },+ canDelete: true,+ });++ const actionButtons = screen.getAllByRole('button', { name: 'Session actions' });+ expect(actionButtons).toHaveLength(1);+ const actionButton = actionButtons[0];+ if (actionButton === undefined) {+ throw new Error('Expected session actions button');+ }+ fireEvent.click(actionButton);+ fireEvent.click(screen.getByRole('button', { name: 'Delete' }));++ await waitFor(() => {+ expect(onDelete).toHaveBeenCalledWith('thread-1');+ });+ });+});diff --git a/packages/trueforge-ui-sdk/test/containers/ToolApprovalContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/ToolApprovalContainer.test.tsxnew file mode 100644index 000000000..b058221e8--- /dev/null+++ b/packages/trueforge-ui-sdk/test/containers/ToolApprovalContainer.test.tsx@@ -0,0 +1,134 @@+// @vitest-environment jsdom+import { fireEvent, render, screen } from '@testing-library/react';+import { describe, expect, it, vi } from 'vitest';++import type { ToolApprovalBarProps } from '@/atoms/ToolApprovalBar.js';+import { ToolApprovalContainer, type ToolApprovalOption } from '@/containers/ToolApprovalContainer.js';+import { SlotsProvider } from '@/theme/SlotsProvider.js';++function ToolApprovalBarProbe({+ toolName,+ approveOptions,+ denyOptions,+ selectedDenyOption,+ denialReason,+ showReasonError,+ onSelect,+ onDenyOptionChange,+ onDenialReasonChange,+ onReasonSubmit,+}: ToolApprovalBarProps) {+ return (+ <section+ data-testid="approval-probe"+ data-tool-name={toolName}+ data-approve-variants={approveOptions?.map(option => option.variant).join('|')}+ data-deny-requires-reason={denyOptions?.map(option => String(option.requiresReason)).join('|')}+ data-selected-deny={selectedDenyOption?.id ?? ''}+ data-show-reason-error={String(showReasonError)}+ >+ {approveOptions?.map(option => (+ <button key={option.id} type="button" onClick={() => onSelect(option.id)}>+ {option.label}+ </button>+ ))}+ {denyOptions?.map(option => (+ <button+ key={option.id}+ type="button"+ onClick={() => {+ if (option.requiresReason) {+ onDenyOptionChange?.(option.id);+ } else {+ onSelect(option.id);+ }+ }}+ >+ {option.label}+ </button>+ ))}+ {selectedDenyOption !== undefined ? (+ <>+ <div>{selectedDenyOption.confirm?.title}</div>+ <div>{selectedDenyOption.confirm?.description}</div>+ <div>{selectedDenyOption.grants?.join(',')}</div>+ <input+ aria-label="Denial reason"+ value={denialReason}+ onChange={event => onDenialReasonChange?.(event.target.value)}+ />+ <button type="button" onClick={onReasonSubmit}>+ Submit denial+ </button>+ </>+ ) : null}+ </section>+ );+}++const options: ToolApprovalOption[] = [+ { id: 'allow-once', label: 'Allow once', isAllow: true },+ { id: 'allow-session', label: 'Allow session', isAllow: true },+ { id: 'reject-now', label: 'Reject now', isAllow: false },+ {+ id: 'reject-with-reason',+ label: 'Reject with reason',+ isAllow: false,+ grants: ['filesystem:write'],+ confirm: {+ title: 'Explain rejection',+ description: 'The agent will receive this reason.',+ },+ },+];++function renderSubject(onSelectOption: (optionId: string, reason?: string) => void) {+ return render(+ <SlotsProvider overrides={{ ToolApprovalBar: ToolApprovalBarProbe }}>+ <ToolApprovalContainer toolName="shell" options={options} onSelectOption={onSelectOption} />+ </SlotsProvider>,+ );+}++describe('ToolApprovalContainer', () => {+ it('maps allow and deny options and forwards immediate selections', () => {+ const onSelectOption = vi.fn();+ renderSubject(onSelectOption);++ const probe = screen.getByTestId('approval-probe');+ expect(probe).toHaveAttribute('data-tool-name', 'shell');+ expect(probe).toHaveAttribute('data-approve-variants', 'primary|secondary');+ expect(probe).toHaveAttribute('data-deny-requires-reason', 'false|true');++ fireEvent.click(screen.getByRole('button', { name: 'Allow once' }));+ fireEvent.click(screen.getByRole('button', { name: 'Reject now' }));+ expect(onSelectOption).toHaveBeenNthCalledWith(1, 'allow-once');+ expect(onSelectOption).toHaveBeenNthCalledWith(2, 'reject-now');+ });++ it('requires, trims, and submits a denial reason with confirmation metadata', () => {+ const onSelectOption = vi.fn();+ renderSubject(onSelectOption);++ fireEvent.click(screen.getByRole('button', { name: 'Reject with reason' }));++ const probe = screen.getByTestId('approval-probe');+ expect(probe).toHaveAttribute('data-selected-deny', 'reject-with-reason');+ expect(screen.getByText('Explain rejection')).toBeInTheDocument();+ expect(screen.getByText('The agent will receive this reason.')).toBeInTheDocument();+ expect(screen.getByText('filesystem:write')).toBeInTheDocument();++ fireEvent.click(screen.getByRole('button', { name: 'Submit denial' }));+ expect(onSelectOption).not.toHaveBeenCalled();+ expect(probe).toHaveAttribute('data-show-reason-error', 'true');++ fireEvent.change(screen.getByRole('textbox', { name: 'Denial reason' }), {+ target: { value: ' policy blocked ' },+ });+ expect(probe).toHaveAttribute('data-show-reason-error', 'false');++ fireEvent.click(screen.getByRole('button', { name: 'Submit denial' }));+ expect(onSelectOption).toHaveBeenCalledWith('reject-with-reason', 'policy blocked');+ expect(probe).toHaveAttribute('data-selected-deny', '');+ });+});diff --git a/packages/trueforge-ui-sdk/src/containers/ToolCallContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/ToolCallContainer.test.tsxsimilarity index 51%rename from packages/trueforge-ui-sdk/src/containers/ToolCallContainer.test.tsxrename to packages/trueforge-ui-sdk/test/containers/ToolCallContainer.test.tsxindex f35a13fe0..d592813b0 100644--- a/packages/trueforge-ui-sdk/src/containers/ToolCallContainer.test.tsx+++ b/packages/trueforge-ui-sdk/test/containers/ToolCallContainer.test.tsx@@ -1,20 +1,50 @@// @vitest-environment jsdom-import { ThreadPrimitive, type ThreadMessageLike } from '@assistant-ui/react';+import { ThreadPrimitive, type ThreadMessage, type ThreadMessageLike } from '@assistant-ui/react';import { fireEvent, render, screen } from '@testing-library/react';import { describe, expect, it, vi } from 'vitest';-import { AssistantMessageContainer } from './AssistantMessageContainer.js';+import type { AskUserPromptProps } from '@/atoms/adapters/AskUserPromptAdapter.js';+import type { SandboxToolCallCardProps } from '@/atoms/SandboxToolCallCard.js';+import type { SubAgentCardProps } from '@/atoms/SubAgentCard.js';+import type { ToolCallCardProps } from '@/atoms/ToolCallCard.js';+import { AssistantMessageContainer } from '@/containers/AssistantMessageContainer.js';+import { SlotsProvider, type SlotOverrides } from '@/theme/SlotsProvider.js';import { RuntimeHarness } from './RuntimeHarness.js';-function renderToolCallMessage(content: ThreadMessageLike['content']) {+function renderToolCallMessage(content: ThreadMessageLike['content'], overrides?: SlotOverrides) {const message: ThreadMessageLike = { role: 'assistant', content };return render(- <RuntimeHarness messages={[message]}>- <ThreadPrimitive.Messages>{() => <AssistantMessageContainer />}</ThreadPrimitive.Messages>- </RuntimeHarness>,+ <SlotsProvider overrides={overrides}>+ <RuntimeHarness messages={[message]}>+ <ThreadPrimitive.Messages>{() => <AssistantMessageContainer />}</ThreadPrimitive.Messages>+ </RuntimeHarness>+ </SlotsProvider>,);}+function createToolCallCardProbe() {+ return vi.fn(({ toolName }: ToolCallCardProps) => <div>{toolName}</div>);+}++function createSandboxToolCallCardProbe() {+ return vi.fn(({ name }: SandboxToolCallCardProps) => <div>{name}</div>);+}++function createAskUserPromptProbe() {+ return vi.fn(({ answeredQuestions }: AskUserPromptProps) => (+ <div>{answeredQuestions?.map(question => question.answer).join('|')}</div>+ ));+}++function createSubAgentCardProbe() {+ return vi.fn(({ agentName, children }: SubAgentCardProps) => (+ <section>+ <div>{agentName}</div>+ {children}+ </section>+ ));+}+/** Pending approvals only surface part-level "requires-action" when the whole message is flagged too. */function renderPendingApprovalMessage(content: ThreadMessageLike['content'],@@ -72,6 +102,130 @@ describe('ToolCallContainer', () => {expect(blocks[1]).toHaveTextContent('boom');});+ it('routes sandbox calls with parsed command and result details', () => {+ const SandboxToolCallCard = createSandboxToolCallCardProbe();+ const args = {+ command: 'pnpm test',+ intent: 'Run focused tests',+ };+ const result = {+ response: {+ exitCode: 0,+ result: 'Tests passed',+ },+ };++ renderToolCallMessage(+ [+ {+ type: 'tool-call',+ toolCallId: 'sandbox-1',+ toolName: 'sandbox_exec',+ args: {},+ argsText: JSON.stringify(args),+ result,+ },+ ],+ { SandboxToolCallCard },+ );++ expect(SandboxToolCallCard.mock.calls[0]?.[0]).toEqual(+ expect.objectContaining({+ name: 'sandbox_exec',+ intent: 'Run focused tests',+ status: 'success',+ command: 'pnpm test',+ exitCode: 0,+ argsJson: JSON.stringify(args, null, 2),+ resultText: 'Tests passed',+ resultJson: JSON.stringify(result, null, 2),+ }),+ );+ });++ it('replays a completed ask-user call with a custom answer', () => {+ const AskUserPrompt = createAskUserPromptProbe();++ renderToolCallMessage(+ [+ {+ type: 'tool-call',+ toolCallId: 'question-1',+ toolName: 'ask_user_question',+ args: {},+ argsText: JSON.stringify({+ question: 'Choose a report format',+ options: ['Summary', 'Full report'],+ }),+ result: { content: 'Annotated report' },+ },+ ],+ { AskUserPrompt },+ );++ expect(AskUserPrompt.mock.calls[0]?.[0]).toEqual(+ expect.objectContaining({+ questions: [],+ answeredQuestions: [+ {+ id: 'question-1',+ question: 'Choose a report format',+ options: ['Summary', 'Full report'],+ answer: 'Annotated report',+ isCustom: true,+ },+ ],+ readOnly: true,+ }),+ );+ });++ it('routes sub-agent metadata and renders its nested assistant content', () => {+ const SubAgentCard = createSubAgentCardProbe();+ const nestedMessage: ThreadMessage = {+ id: 'nested-message-1',+ role: 'assistant',+ createdAt: new Date('2026-07-01T00:00:00Z'),+ content: [{ type: 'text', text: 'Nested agent response' }],+ status: { type: 'complete', reason: 'stop' },+ metadata: {+ unstable_state: null,+ unstable_annotations: [],+ unstable_data: [],+ steps: [],+ custom: {+ subAgent: {+ title: 'Research specialist',+ input: 'Find primary sources',+ },+ },+ },+ };++ renderToolCallMessage(+ [+ {+ type: 'tool-call',+ toolCallId: 'sub-agent-1',+ toolName: 'create_sub_agent',+ args: {},+ messages: [nestedMessage],+ },+ ],+ { SubAgentCard },+ );++ expect(SubAgentCard.mock.calls[0]?.[0]).toEqual(+ expect.objectContaining({+ agentName: 'Research specialist',+ instruction: 'Find primary sources',+ stepCount: 1,+ status: 'success',+ }),+ );+ expect(screen.getByText('Nested agent response')).toBeInTheDocument();+ });+it('auto-expands and shows the approval bar while an approval is pending', () => {renderPendingApprovalMessage([{@@ -191,56 +345,46 @@ describe('ToolCallContainer', () => {expect(screen.getByText('database:write')).toBeInTheDocument();});- it('passes mcpServerName for list_tools', () => {- renderToolCallMessage([- {- type: 'tool-call',- toolCallId: '1',- toolName: 'list_tools',- args: {},- argsText: '{"mcp_server":"github-team"}',- },- ]);- // Verify the card is rendered (actual prop checking would require slot mocking)- expect(screen.getByText(/Listing tools/)).toBeInTheDocument();- });-- it('passes mcpServerName for call_tool', () => {- renderToolCallMessage([- {- type: 'tool-call',- toolCallId: '1',- toolName: 'call_tool',- args: {},- argsText: '{"mcp_server":"slack-workspace","tool_name":"send_message","input":{}}',- },- ]);- expect(screen.getByText(/call_tool: send_message/)).toBeInTheDocument();- });+ it.each([+ ['list_tools', '{"mcp_server":"github-team"}', 'github-team'],+ ['call_tool', '{"mcp_server":"slack-workspace","tool_name":"send_message","input":{}}', 'slack-workspace'],+ ['get_tool_info', '{"mcp_server":"linear-integration","tool_name":"create_issue"}', 'linear-integration'],+ ])('passes mcpServerName for %s', (toolName, argsText, mcpServerName) => {+ const ToolCallCard = createToolCallCardProbe();+ renderToolCallMessage(+ [+ {+ type: 'tool-call',+ toolCallId: '1',+ toolName,+ args: {},+ argsText,+ },+ ],+ { ToolCallCard },+ );- it('passes mcpServerName for get_tool_info', () => {- renderToolCallMessage([- {- type: 'tool-call',- toolCallId: '1',- toolName: 'get_tool_info',- args: {},- argsText: '{"mcp_server":"linear-integration","tool_name":"create_issue"}',- },- ]);- expect(screen.getByText(/get_tool_info: create_issue/)).toBeInTheDocument();+ expect(ToolCallCard.mock.calls[0]?.[0]).toEqual(expect.objectContaining({ mcpServerName }));});it('does not pass mcpServerName for non-MCP tools', () => {- renderToolCallMessage([- {- type: 'tool-call',- toolCallId: '1',- toolName: 'search_docs',- args: {},- argsText: '{"query":"example"}',- },- ]);- expect(screen.getByText('search_docs')).toBeInTheDocument();+ const ToolCallCard = createToolCallCardProbe();+ renderToolCallMessage(+ [+ {+ type: 'tool-call',+ toolCallId: '1',+ toolName: 'search_docs',+ args: {},+ argsText: '{"query":"example"}',+ },+ ],+ { ToolCallCard },+ );++ expect(ToolCallCard).toHaveBeenCalledOnce();+ const [call] = ToolCallCard.mock.calls;+ if (!call) throw new Error('Expected ToolCallCard to render');+ expect(call[0].mcpServerName).toBeUndefined();});});diff --git a/packages/trueforge-ui-sdk/test/containers/ToolCallContentBlockContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/ToolCallContentBlockContainer.test.tsxnew file mode 100644index 000000000..6dd1a712f--- /dev/null+++ b/packages/trueforge-ui-sdk/test/containers/ToolCallContentBlockContainer.test.tsx@@ -0,0 +1,133 @@+// @vitest-environment jsdom+import { fireEvent, render, screen, waitFor } from '@testing-library/react';+import { useCallback } from 'react';+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';++import type { ToolCallContentBlockProps } from '@/atoms/ToolCallContentBlock.js';+import { ToolCallContentBlockContainer } from '@/containers/ToolCallContentBlockContainer.js';+import { SlotsProvider } from '@/theme/SlotsProvider.js';++let observedNodes: Element[] = [];+let disconnectCount = 0;++class ResizeObserverProbe implements ResizeObserver {+ readonly callback: ResizeObserverCallback;++ constructor(callback: ResizeObserverCallback) {+ this.callback = callback;+ }++ observe(target: Element) {+ observedNodes.push(target);+ this.callback([], this);+ }++ unobserve() {}++ disconnect() {+ disconnectCount += 1;+ }+}++function ToolCallContentBlockProbe({+ title,+ content,+ isJson,+ copyValue,+ maxHeight,+ resizable,+ fullscreen,+ onFullscreenChange,+ contentHeightRem,+ contentRef,+}: ToolCallContentBlockProps) {+ const measuredContentRef = useCallback(+ (node: HTMLDivElement | null) => {+ if (node !== null) {+ Object.defineProperty(node, 'scrollHeight', { configurable: true, value: 64 });+ }+ if (resizable) contentRef?.(node);+ },+ [contentRef, resizable],+ );++ return (+ <section+ data-testid="content-block-probe"+ data-title={title}+ data-content={content}+ data-json={String(isJson)}+ data-copy-value={copyValue}+ data-max-height={maxHeight}+ data-resizable={String(resizable)}+ data-fullscreen={String(fullscreen)}+ data-content-height={String(contentHeightRem)}+ >+ <div ref={measuredContentRef}>content node</div>+ <button type="button" onClick={() => onFullscreenChange?.(true)}>+ Enter fullscreen+ </button>+ <button type="button" onClick={() => onFullscreenChange?.(false)}>+ Exit fullscreen+ </button>+ </section>+ );+}++function TestSubject({ resizable = false }: { resizable?: boolean }) {+ return (+ <SlotsProvider overrides={{ ToolCallContentBlock: ToolCallContentBlockProbe }}>+ <ToolCallContentBlockContainer+ title="Tool result"+ content='{"ok":true}'+ isJson+ copyValue="raw result"+ maxHeight="20rem"+ resizable={resizable}+ />+ </SlotsProvider>+ );+}++describe('ToolCallContentBlockContainer', () => {+ beforeEach(() => {+ observedNodes = [];+ disconnectCount = 0;+ vi.stubGlobal('ResizeObserver', ResizeObserverProbe);+ });++ afterEach(() => {+ vi.unstubAllGlobals();+ });++ it('forwards content configuration and owns fullscreen state', () => {+ render(<TestSubject />);++ const probe = screen.getByTestId('content-block-probe');+ expect(probe).toHaveAttribute('data-title', 'Tool result');+ expect(probe).toHaveAttribute('data-content', '{"ok":true}');+ expect(probe).toHaveAttribute('data-json', 'true');+ expect(probe).toHaveAttribute('data-copy-value', 'raw result');+ expect(probe).toHaveAttribute('data-max-height', '20rem');+ expect(probe).toHaveAttribute('data-fullscreen', 'false');++ fireEvent.click(screen.getByRole('button', { name: 'Enter fullscreen' }));+ expect(probe).toHaveAttribute('data-fullscreen', 'true');++ fireEvent.click(screen.getByRole('button', { name: 'Exit fullscreen' }));+ expect(probe).toHaveAttribute('data-fullscreen', 'false');+ });++ it('measures resizable content and disconnects its observer on unmount', async () => {+ const { unmount } = render(<TestSubject resizable />);++ await waitFor(() => {+ expect(screen.getByTestId('content-block-probe')).toHaveAttribute('data-content-height', '4');+ });+ expect(observedNodes).toHaveLength(1);++ const disconnectsBeforeUnmount = disconnectCount;+ unmount();+ expect(disconnectCount).toBeGreaterThan(disconnectsBeforeUnmount);+ });+});diff --git a/packages/trueforge-ui-sdk/src/containers/ToolGroupContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/ToolGroupContainer.test.tsxsimilarity index 97%rename from packages/trueforge-ui-sdk/src/containers/ToolGroupContainer.test.tsxrename to packages/trueforge-ui-sdk/test/containers/ToolGroupContainer.test.tsxindex e2441c4a3..cc7e25571 100644--- a/packages/trueforge-ui-sdk/src/containers/ToolGroupContainer.test.tsx+++ b/packages/trueforge-ui-sdk/test/containers/ToolGroupContainer.test.tsx@@ -3,7 +3,7 @@ import { ThreadPrimitive, type ThreadMessageLike } from '@assistant-ui/react';import { fireEvent, render, screen } from '@testing-library/react';import { describe, expect, it } from 'vitest';-import { AssistantMessageContainer } from './AssistantMessageContainer.js';+import { AssistantMessageContainer } from '@/containers/AssistantMessageContainer.js';import { RuntimeHarness } from './RuntimeHarness.js';function renderMultiToolMessage(content: ThreadMessageLike['content'], isRunning = false) {diff --git a/packages/trueforge-ui-sdk/test/containers/TrueFoundryChatProvider.test.tsx b/packages/trueforge-ui-sdk/test/containers/TrueFoundryChatProvider.test.tsxnew file mode 100644index 000000000..6b719cfe4--- /dev/null+++ b/packages/trueforge-ui-sdk/test/containers/TrueFoundryChatProvider.test.tsx@@ -0,0 +1,110 @@+// @vitest-environment jsdom+import { useExternalStoreRuntime, type ThreadMessageLike } from '@assistant-ui/react';+import { act, render, screen } from '@testing-library/react';+import {+ trueFoundryAttachmentAdapter,+ type TrueFoundryAgentConfig,+ type UseTrueFoundryAgentRuntimeOptions,+} from '@truefoundry/assistant-ui-runtime';+import { beforeEach, describe, expect, it, vi } from 'vitest';+import { createMockAgentUIServer } from '../server/mockServer.js';++const runtimeSpy = vi.hoisted(() => vi.fn<(options: UseTrueFoundryAgentRuntimeOptions) => void>());+const defaultAttachmentAdapter = vi.hoisted(() => ({}));++vi.mock('@truefoundry/assistant-ui-runtime', () => ({+ trueFoundryAttachmentAdapter: defaultAttachmentAdapter,+ useTrueFoundryAgentRuntime: (options: UseTrueFoundryAgentRuntimeOptions) => {+ runtimeSpy(options);+ // Called from ChatRuntimeScope (a React component), so hooks are valid here.+ return useExternalStoreRuntime<ThreadMessageLike>({+ messages: [],+ isRunning: false,+ convertMessage: (message: ThreadMessageLike) => message,+ onNew: async () => {},+ });+ },+}));++import { TrueFoundryChatProvider } from '@/containers/TrueFoundryChatProvider.js';++describe('TrueFoundryChatProvider', () => {+ beforeEach(() => {+ runtimeSpy.mockClear();+ });++ it('forwards legacy runtime options and supplies the default attachment adapter', () => {+ const server = createMockAgentUIServer();+ const onError = vi.fn();++ render(+ <TrueFoundryChatProvider server={server} agentName="my-agent" initialSessionId="session-123" onError={onError}>+ <div>chat-child</div>+ </TrueFoundryChatProvider>,+ );++ expect(screen.getByText('chat-child')).toBeInTheDocument();+ expect(runtimeSpy).toHaveBeenCalledWith(+ expect.objectContaining({+ server,+ agentName: 'my-agent',+ initialSessionId: 'session-123',+ onError,+ adapters: { attachments: defaultAttachmentAdapter },+ }),+ );+ });++ it('forwards a discriminated agent configuration', () => {+ const agent: TrueFoundryAgentConfig = {+ mode: 'named',+ agentName: 'configured-agent',+ };++ render(+ <TrueFoundryChatProvider server={createMockAgentUIServer()} agent={agent}>+ <div>chat-child</div>+ </TrueFoundryChatProvider>,+ );++ expect(runtimeSpy).toHaveBeenCalledWith(expect.objectContaining({ agent }));+ });++ it('preserves a consumer-provided attachment adapter', () => {+ const attachmentAdapter = { ...trueFoundryAttachmentAdapter };++ render(+ <TrueFoundryChatProvider+ server={createMockAgentUIServer()}+ agentName="my-agent"+ adapters={{ attachments: attachmentAdapter }}+ >+ <div>chat-child</div>+ </TrueFoundryChatProvider>,+ );++ expect(runtimeSpy).toHaveBeenCalledWith(+ expect.objectContaining({+ adapters: { attachments: attachmentAdapter },+ }),+ );+ });++ it('uses the toaster as the default runtime error handler', async () => {+ render(+ <TrueFoundryChatProvider server={createMockAgentUIServer()} agentName="my-agent">+ <div>chat-child</div>+ </TrueFoundryChatProvider>,+ );+ const options = runtimeSpy.mock.calls[0]?.[0];+ if (options?.onError === undefined) {+ throw new Error('Expected runtime onError handler');+ }++ act(() => {+ options.onError?.(new Error('runtime failed'));+ });++ expect(await screen.findByText('runtime failed')).toBeInTheDocument();+ });+});diff --git a/packages/trueforge-ui-sdk/src/containers/TrueforgeUI.test.tsx b/packages/trueforge-ui-sdk/test/containers/TrueforgeUI.test.tsxsimilarity index 81%rename from packages/trueforge-ui-sdk/src/containers/TrueforgeUI.test.tsxrename to packages/trueforge-ui-sdk/test/containers/TrueforgeUI.test.tsxindex e53b29e66..783e7fe83 100644--- a/packages/trueforge-ui-sdk/src/containers/TrueforgeUI.test.tsx+++ b/packages/trueforge-ui-sdk/test/containers/TrueforgeUI.test.tsx@@ -1,8 +1,9 @@// @vitest-environment jsdom+import type { CatalogServer } from '@/server/types.js';import { useExternalStoreRuntime, type ThreadMessageLike } from '@assistant-ui/react';-import { fireEvent, render, screen, waitFor, within } from '@testing-library/react';+import { act, fireEvent, render, screen, waitFor, within } from '@testing-library/react';import { describe, expect, it, vi } from 'vitest';-import type { AgentUIServer, CatalogServer } from '../server/types.js';+import { createMockAgentUIServer, createMockCatalog } from '../server/mockServer.js';vi.mock('@truefoundry/assistant-ui-runtime', () => ({trueFoundryAttachmentAdapter: {},@@ -37,38 +38,22 @@ vi.mock('@truefoundry/assistant-ui-runtime/plugins/truefoundry-agent-server-adap),}));-import { DrawerLayout } from '../layouts/DrawerLayout.js';-import { SidebarLayout } from '../layouts/SidebarLayout.js';-import { StackChatPanel } from '../layouts/StackChatPanel.js';-import { WidgetLayout } from '../layouts/WidgetLayout.js';-import { ServerProvider } from '../server/ServerContext.js';-import { ShellModeProvider } from '../server/ShellModeContext.js';-import { SlotsProvider } from '../theme/SlotsProvider.js';+import { TrueforgeUI, type ChatLayout } from '@/containers/TrueforgeUI.js';+import { DrawerLayout } from '@/layouts/DrawerLayout.js';+import { SidebarLayout } from '@/layouts/SidebarLayout.js';+import { StackChatPanel } from '@/layouts/StackChatPanel.js';+import { WidgetLayout } from '@/layouts/WidgetLayout.js';+import { ServerProvider } from '@/server/ServerContext.js';+import { ShellModeProvider } from '@/server/ShellModeContext.js';+import { SlotsProvider } from '@/theme/SlotsProvider.js';import { RuntimeHarness } from './RuntimeHarness.js';-import { TrueforgeUI, type ChatLayout } from './TrueforgeUI.js';--function mockServer(catalog?: CatalogServer): AgentUIServer {- return {- createSession: vi.fn(),- listSessions: vi.fn(),- getSession: vi.fn(),- updateSession: vi.fn(),- createTurn: vi.fn(),- cancelSession: vi.fn(),- listTurns: vi.fn(),- getTurn: vi.fn(),- listEvents: vi.fn(),- getModels: vi.fn(async () => []),- getSkills: vi.fn(async () => []),- getMcp: vi.fn(async () => []),- searchAgents: vi.fn(async () => []),- saveAgent: vi.fn(async () => ({})),- ...(catalog != null ? { catalog } : {}),- } as unknown as AgentUIServer;++function mockServer(catalog?: CatalogServer) {+ return createMockAgentUIServer(catalog === undefined ? {} : { catalog });}/** Minimal catalog stub — ShellActions only checks presence. */-const stubCatalog = {} as CatalogServer;+const stubCatalog = createMockCatalog();describe('TrueforgeUI', () => {const server = mockServer();@@ -83,9 +68,26 @@ describe('TrueforgeUI', () => {className="h-96"/>,);+ await act(async () => {+ await vi.dynamicImportSettled();+ });await waitFor(() => {- expect(container.querySelector('.h-96')).toBeTruthy();+ switch (layout) {+ case 'sidebar':+ expect(screen.getByRole('button', { name: /^(Collapse|Expand) sidebar$/ })).toBeInTheDocument();+ break;+ case 'drawer':+ expect(screen.getByRole('button', { name: 'New chat' })).toBeInTheDocument();+ break;+ case 'dock':+ expect(container.querySelector('[data-aui-compact-layout]')).toBeInTheDocument();+ break;+ case 'widget':+ expect(screen.getByRole('button', { name: 'Open chat' })).toBeInTheDocument();+ break;+ }});+ expect(container.querySelector('.h-96')).toBeInTheDocument();});it('mounts a custom layout component inside providers', async () => {@@ -124,20 +126,24 @@ describe('TrueforgeUI', () => {);window.history.replaceState(null, '', '/?screenType=mcp-auth&pUid=popup-1&isSuccess=true');- const { unmount } = render(- <TrueforgeUI- server={server}- agentConfig={{ mode: 'SingleAgent', name: 'my-agent' }}- layout={() => <div data-testid="regular-layout">regular chrome</div>}- />,- );-- expect(await screen.findByText('Authorization successful')).toBeInTheDocument();- expect(screen.queryByTestId('regular-layout')).not.toBeInTheDocument();-- unmount();- window.history.replaceState(null, '', originalUrl);- vi.unstubAllGlobals();+ let unmount: (() => void) | undefined;+ try {+ const view = render(+ <TrueforgeUI+ server={server}+ agentConfig={{ mode: 'SingleAgent', name: 'my-agent' }}+ layout={() => <div data-testid="regular-layout">regular chrome</div>}+ />,+ );+ unmount = view.unmount;++ expect(await screen.findByText('Authorization successful')).toBeInTheDocument();+ expect(screen.queryByTestId('regular-layout')).not.toBeInTheDocument();+ } finally {+ unmount?.();+ window.history.replaceState(null, '', originalUrl);+ vi.unstubAllGlobals();+ }});it('surfaces trueforge-not-implemented as an alert', async () => {@@ -242,7 +248,7 @@ describe('SidebarLayout', () => {expect(screen.getByRole('button', { name: 'Expand sidebar' })).toBeInTheDocument();});- it('toggles theme from the footer and shows settings only when catalog is provided', () => {+ it('toggles theme from the footer and shows settings only when catalog is provided', async () => {const { rerender } = render(<SlotsProvider theme={{ brand: { name: 'Acme' } }}><ServerProvider server={mockServer(stubCatalog)}>@@ -258,8 +264,16 @@ describe('SidebarLayout', () => {);expect(screen.getAllByRole('button', { name: 'Settings' })).toHaveLength(2);- const themeBtn = screen.getAllByRole('button', { name: /Switch to (light|dark) theme/ })[0]!;- fireEvent.click(themeBtn);+ const expandButton = screen.queryByRole('button', { name: 'Expand sidebar' });+ if (expandButton != null) {+ fireEvent.click(expandButton);+ }+ expect(await screen.findAllByRole('button', { name: 'Agents Library (0)' })).not.toHaveLength(0);+ const [themeButton] = screen.getAllByRole('button', { name: /Switch to (light|dark) theme/ });+ if (themeButton === undefined) {+ throw new Error('Expected theme toggle');+ }+ fireEvent.click(themeButton);expect(screen.getAllByRole('button', { name: /Switch to (light|dark) theme/ })).toHaveLength(2);// Settings stays available with a locked agentName when catalog is present.diff --git a/packages/trueforge-ui-sdk/src/containers/UserEditComposerContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/UserEditComposerContainer.test.tsxsimilarity index 84%rename from packages/trueforge-ui-sdk/src/containers/UserEditComposerContainer.test.tsxrename to packages/trueforge-ui-sdk/test/containers/UserEditComposerContainer.test.tsxindex ce2bf07cb..c918b4148 100644--- a/packages/trueforge-ui-sdk/src/containers/UserEditComposerContainer.test.tsx+++ b/packages/trueforge-ui-sdk/test/containers/UserEditComposerContainer.test.tsx@@ -3,8 +3,8 @@ import { ThreadPrimitive, type ThreadMessageLike } from '@assistant-ui/react';import { fireEvent, render, screen } from '@testing-library/react';import { describe, expect, it, vi } from 'vitest';+import { UserEditComposerContainer } from '@/containers/UserEditComposerContainer.js';import { RuntimeHarness } from './RuntimeHarness.js';-import { UserEditComposerContainer } from './UserEditComposerContainer.js';function renderEditComposer(messages: ThreadMessageLike[]) {return render(@@ -28,12 +28,15 @@ describe('UserEditComposerContainer', () => {const input = screen.getByRole('textbox');const form = input.closest('form');- expect(form).toBeTruthy();- const requestSubmit = vi.spyOn(form!, 'requestSubmit');+ if (!(form instanceof HTMLFormElement)) {+ throw new Error('Expected edit input to be rendered inside a form');+ }+ const onSubmit = vi.fn((event: Event) => event.preventDefault());+ form.addEventListener('submit', onSubmit);fireEvent.keyDown(input, { key: 'Enter' });- expect(requestSubmit).toHaveBeenCalled();+ expect(onSubmit).toHaveBeenCalledOnce();});it('shows read-only attachments without remove controls', () => {diff --git a/packages/trueforge-ui-sdk/src/containers/UserMessageContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/UserMessageContainer.test.tsxsimilarity index 97%rename from packages/trueforge-ui-sdk/src/containers/UserMessageContainer.test.tsxrename to packages/trueforge-ui-sdk/test/containers/UserMessageContainer.test.tsxindex 758cdc77e..e61641669 100644--- a/packages/trueforge-ui-sdk/src/containers/UserMessageContainer.test.tsx+++ b/packages/trueforge-ui-sdk/test/containers/UserMessageContainer.test.tsx@@ -3,8 +3,8 @@ import { ThreadPrimitive, type ThreadMessageLike } from '@assistant-ui/react';import { render, screen } from '@testing-library/react';import { describe, expect, it } from 'vitest';+import { UserMessageContainer } from '@/containers/UserMessageContainer.js';import { RuntimeHarness } from './RuntimeHarness.js';-import { UserMessageContainer } from './UserMessageContainer.js';function renderUserMessage(messages: ThreadMessageLike[], options?: { isRunning?: boolean }) {return render(diff --git a/packages/trueforge-ui-sdk/src/containers/useResolvedServer.test.tsx b/packages/trueforge-ui-sdk/test/containers/useResolvedServer.test.tsxsimilarity index 87%rename from packages/trueforge-ui-sdk/src/containers/useResolvedServer.test.tsxrename to packages/trueforge-ui-sdk/test/containers/useResolvedServer.test.tsxindex e97938c66..f02ab694c 100644--- a/packages/trueforge-ui-sdk/src/containers/useResolvedServer.test.tsx+++ b/packages/trueforge-ui-sdk/test/containers/useResolvedServer.test.tsx@@ -2,8 +2,8 @@import { renderHook, waitFor } from '@testing-library/react';import { describe, expect, it, vi } from 'vitest';-import type { AgentUIServer } from '../server/types.js';-import { useResolvedServer } from './useResolvedServer.js';+import { useResolvedServer } from '@/containers/useResolvedServer.js';+import { createMockAgentUIServer, createMockCatalog } from '../server/mockServer.js';vi.mock('@truefoundry/assistant-ui-runtime/plugins/truefoundry-agent-server-adapter', () => ({createTrueFoundryAgentUIServer: vi.fn(async () => ({@@ -12,13 +12,9 @@ vi.mock('@truefoundry/assistant-ui-runtime/plugins/truefoundry-agent-server-adap})),}));-function mockServer(): AgentUIServer {- return { saveAgent: vi.fn() } as unknown as AgentUIServer;-}-describe('useResolvedServer', () => {it('passes through AgentUIServer synchronously', () => {- const server = mockServer();+ const server = createMockAgentUIServer({ saveAgent: vi.fn() });const { result } = renderHook(() => useResolvedServer(server));expect(result.current).toEqual({status: 'ready',@@ -61,7 +57,7 @@ describe('useResolvedServer', () => {});it('attaches an optional catalog onto the truefoundry server', async () => {- const catalog = { skillCatalog: {} } as never;+ const catalog = createMockCatalog();const { result } = renderHook(() =>useResolvedServer({type: 'truefoundry',diff --git a/packages/trueforge-ui-sdk/src/hooks/useComposerBusyState.test.ts b/packages/trueforge-ui-sdk/test/hooks/useComposerBusyState.test.tssimilarity index 68%rename from packages/trueforge-ui-sdk/src/hooks/useComposerBusyState.test.tsrename to packages/trueforge-ui-sdk/test/hooks/useComposerBusyState.test.tsindex 46f8b1fea..b7b3140aa 100644--- a/packages/trueforge-ui-sdk/src/hooks/useComposerBusyState.test.ts+++ b/packages/trueforge-ui-sdk/test/hooks/useComposerBusyState.test.ts@@ -9,7 +9,7 @@ vi.mock('@assistant-ui/core/react', () => ({useThreadIsRunning: () => useThreadIsRunning(),}));-import { ComposerBusyProvider, useComposerBusyState } from './useComposerBusyState.js';+import { ComposerBusyProvider, useComposerBusyState } from '@/hooks/useComposerBusyState.js';function wrapper({ children }: { children: ReactNode }) {return createElement(ComposerBusyProvider, null, children);@@ -20,6 +20,15 @@ describe('useComposerBusyState', () => {useThreadIsRunning.mockReturnValue(false);});+ it('reflects a running thread without marking it as submitting', () => {+ useThreadIsRunning.mockReturnValue(true);+ const { result } = renderHook(() => useComposerBusyState(), { wrapper });++ expect(result.current.isBusy).toBe(true);+ expect(result.current.isRunning).toBe(true);+ expect(result.current.isSubmitting).toBe(false);+ });+it('starts busy immediately on send before the thread is running', () => {const { result } = renderHook(() => useComposerBusyState(), { wrapper });@@ -62,6 +71,19 @@ describe('useComposerBusyState', () => {});});+ it('clears submitting when send throws synchronously', () => {+ const { result } = renderHook(() => useComposerBusyState(), { wrapper });++ act(() => {+ result.current.send(() => {+ throw new Error('send failed');+ });+ });++ expect(result.current.isBusy).toBe(false);+ expect(result.current.isSubmitting).toBe(false);+ });+it('resetBusy clears optimistic submitting state', () => {const { result } = renderHook(() => useComposerBusyState(), { wrapper });@@ -75,4 +97,10 @@ describe('useComposerBusyState', () => {});expect(result.current.isBusy).toBe(false);});++ it('requires ComposerBusyProvider', () => {+ expect(() => renderHook(() => useComposerBusyState())).toThrow(+ 'useComposerBusyState must be used within ComposerBusyProvider',+ );+ });});diff --git a/packages/trueforge-ui-sdk/test/hooks/useComposerPauseView.test.ts b/packages/trueforge-ui-sdk/test/hooks/useComposerPauseView.test.tsnew file mode 100644index 000000000..917080501--- /dev/null+++ b/packages/trueforge-ui-sdk/test/hooks/useComposerPauseView.test.ts@@ -0,0 +1,104 @@+// @vitest-environment jsdom+import { renderHook } from '@testing-library/react';+import { beforeEach, describe, expect, it, vi } from 'vitest';++const useAuiState = vi.hoisted(() => vi.fn());+const useToolResponses = vi.hoisted(() => vi.fn());++vi.mock('@assistant-ui/react', () => ({+ useAuiState,+}));++vi.mock('@truefoundry/assistant-ui-runtime', () => ({+ useTrueFoundryToolResponses: useToolResponses,+}));++import { threadHasPendingMcpAuth, type ThreadPauseState, useComposerPauseView } from '@/hooks/useComposerPauseView.js';++describe('threadHasPendingMcpAuth', () => {+ it('recognizes MCP authorization only on the latest requiring-action assistant message', () => {+ const pendingState = {+ thread: {+ messages: [+ { role: 'user' },+ {+ role: 'assistant',+ status: { type: 'requires-action' },+ metadata: { custom: { pendingMcpAuth: true } },+ },+ ],+ },+ } satisfies ThreadPauseState;++ expect(threadHasPendingMcpAuth(pendingState)).toBe(true);+ expect(+ threadHasPendingMcpAuth({+ thread: {+ messages: [...pendingState.thread.messages, { role: 'user' }],+ },+ }),+ ).toBe(false);+ });++ it('rejects assistant messages without both the required status and metadata flag', () => {+ expect(+ threadHasPendingMcpAuth({+ thread: {+ messages: [+ {+ role: 'assistant',+ status: { type: 'running' },+ metadata: { custom: { pendingMcpAuth: true } },+ },+ ],+ },+ }),+ ).toBe(false);+ expect(+ threadHasPendingMcpAuth({+ thread: {+ messages: [+ {+ role: 'assistant',+ status: { type: 'requires-action' },+ metadata: { custom: { pendingMcpAuth: false } },+ },+ ],+ },+ }),+ ).toBe(false);+ expect(threadHasPendingMcpAuth({ thread: { messages: [] } })).toBe(false);+ });+});++describe('useComposerPauseView', () => {+ beforeEach(() => {+ vi.clearAllMocks();+ useAuiState.mockReturnValue(false);+ useToolResponses.mockReturnValue({ pending: [] });+ });++ it('returns the normal composer when no pause source is pending', () => {+ const { result } = renderHook(() => useComposerPauseView());++ expect(result.current).toEqual({ kind: 'compose' });+ expect(useAuiState).toHaveBeenCalledWith(threadHasPendingMcpAuth);+ });++ it('shows the ask-user view while tool responses are pending', () => {+ useToolResponses.mockReturnValue({ pending: [{ toolCallId: 'question-1' }] });++ const { result } = renderHook(() => useComposerPauseView());++ expect(result.current).toEqual({ kind: 'ask-user' });+ });++ it('gives MCP authorization precedence over pending tool responses', () => {+ useAuiState.mockReturnValue(true);+ useToolResponses.mockReturnValue({ pending: [{ toolCallId: 'question-1' }] });++ const { result } = renderHook(() => useComposerPauseView());++ expect(result.current).toEqual({ kind: 'mcp' });+ });+});diff --git a/packages/trueforge-ui-sdk/test/hooks/useMcpAuth.test.ts b/packages/trueforge-ui-sdk/test/hooks/useMcpAuth.test.tsnew file mode 100644index 000000000..1e5b79afc--- /dev/null+++ b/packages/trueforge-ui-sdk/test/hooks/useMcpAuth.test.ts@@ -0,0 +1,194 @@+// @vitest-environment jsdom+import { act, cleanup, renderHook } from '@testing-library/react';+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';++import type { ConnectorCatalogServer } from '@/server/types.js';++type CatalogHookValue = {+ connectorCatalog: Pick<ConnectorCatalogServer, 'authenticateConnector'>;+};++type ErrorToasterValue = {+ showError: (error: unknown) => void;+};++const useCatalogServer = vi.hoisted(() => vi.fn<() => CatalogHookValue>());+const useErrorToasterOptional = vi.hoisted(() => vi.fn<() => ErrorToasterValue | null>());++vi.mock('@/server/ServerContext.js', () => ({+ useCatalogServer,+}));++vi.mock('@/containers/ErrorToasterContainer.js', () => ({+ useErrorToasterOptional,+}));++import { MCP_AUTH_POPUP_CHANNEL, useMCPAuth } from '@/hooks/useMcpAuth.js';++const channels: BroadcastChannelStub[] = [];++class BroadcastChannelStub {+ readonly name: string;+ readonly close = vi.fn();+ onmessage: ((event: MessageEvent<unknown>) => void) | null = null;++ constructor(name: string) {+ this.name = name;+ channels.push(this);+ }++ emit(data: unknown) {+ this.onmessage?.(new MessageEvent('message', { data }));+ }+}++const authenticateConnector = vi.fn<ConnectorCatalogServer['authenticateConnector']>();+const showError = vi.fn<(error: unknown) => void>();++function getPopupUid(): string {+ const call = authenticateConnector.mock.calls.at(-1);+ if (!call) throw new Error('Expected authenticateConnector to be called');++ const redirectURL = call[0].redirectURL;+ if (!redirectURL) throw new Error('Expected authenticateConnector to receive a redirect URL');++ const popupUid = new URL(redirectURL).searchParams.get('pUid');+ if (!popupUid) throw new Error('Expected the redirect URL to contain a popup UID');+ return popupUid;+}++describe('useMCPAuth', () => {+ beforeEach(() => {+ channels.length = 0;+ authenticateConnector.mockReset();+ showError.mockReset();+ useCatalogServer.mockReset();+ useErrorToasterOptional.mockReset();+ useCatalogServer.mockReturnValue({+ connectorCatalog: { authenticateConnector },+ });+ useErrorToasterOptional.mockReturnValue({ showError });+ vi.stubGlobal('BroadcastChannel', BroadcastChannelStub);+ window.history.replaceState({}, '', '/chat');+ });++ afterEach(() => {+ cleanup();+ vi.restoreAllMocks();+ vi.unstubAllGlobals();+ });++ it('completes immediately when the connector is already authenticated', async () => {+ authenticateConnector.mockResolvedValue({ status: 'AUTHENTICATED' });+ const open = vi.spyOn(window, 'open');+ const callback = vi.fn();+ const { result } = renderHook(() => useMCPAuth());++ await act(async () => {+ await result.current.handleAuthorize('connector-1', callback);+ });++ expect(authenticateConnector).toHaveBeenCalledWith({+ id: 'connector-1',+ redirectURL: expect.any(String),+ });+ expect(callback).toHaveBeenCalledOnce();+ expect(callback).toHaveBeenCalledWith(true);+ expect(open).not.toHaveBeenCalled();+ expect(channels).toHaveLength(0);+ expect(showError).not.toHaveBeenCalled();+ expect(result.current.isOAuthLoading).toBe(false);+ });++ it('opens the authorization endpoint and accepts only its matching channel result', async () => {+ authenticateConnector.mockResolvedValue({+ authorization_endpoint: 'https://auth.example.test/authorize',+ });+ const open = vi.spyOn(window, 'open').mockReturnValue(window);+ const focus = vi.spyOn(window, 'focus').mockImplementation(() => {});+ const close = vi.spyOn(window, 'close').mockImplementation(() => {});+ const callback = vi.fn();+ const { result } = renderHook(() => useMCPAuth({ callbackPath: '/oauth/callback' }));++ await act(async () => {+ await result.current.handleAuthorize('connector-2', callback);+ });++ expect(open).toHaveBeenCalledWith('https://auth.example.test/authorize', '_blank', 'popup=true');+ expect(focus).toHaveBeenCalledOnce();+ expect(channels).toHaveLength(1);+ expect(channels[0]?.name).toBe(MCP_AUTH_POPUP_CHANNEL);++ const redirectCall = authenticateConnector.mock.calls[0];+ if (!redirectCall?.[0].redirectURL) throw new Error('Expected a redirect URL');+ const redirectURL = new URL(redirectCall[0].redirectURL);+ expect(redirectURL.pathname).toBe('/oauth/callback');+ expect(redirectURL.searchParams.get('screenType')).toBe('mcp-auth');+ expect(redirectURL.searchParams.get('integrationId')).toBe('connector-2');++ const channel = channels[0];+ if (!channel) throw new Error('Expected an authorization channel');+ channel.emit(null);+ channel.emit({ popupUid: getPopupUid() });+ channel.emit({ popupUid: 'another-popup', isSuccess: true });++ expect(callback).not.toHaveBeenCalled();+ expect(channel.close).not.toHaveBeenCalled();+ expect(close).not.toHaveBeenCalled();++ channel.emit({ popupUid: getPopupUid(), isSuccess: true });++ expect(callback).toHaveBeenCalledOnce();+ expect(callback).toHaveBeenCalledWith(true);+ expect(channel.close).toHaveBeenCalledOnce();+ expect(close).toHaveBeenCalledOnce();+ expect(showError).not.toHaveBeenCalled();+ });++ it('reports a blocked popup and completes authorization as failed', async () => {+ authenticateConnector.mockResolvedValue({+ authorization_endpoint: 'https://auth.example.test/authorize',+ });+ vi.spyOn(window, 'open').mockReturnValue(null);+ const callback = vi.fn();+ const { result } = renderHook(() => useMCPAuth());++ await act(async () => {+ await result.current.handleAuthorize('connector-3', callback);+ });++ expect(callback).toHaveBeenCalledOnce();+ expect(callback).toHaveBeenCalledWith(false);+ expect(showError).toHaveBeenCalledOnce();+ expect(showError).toHaveBeenCalledWith(+ new Error('Popup blocked. Please allow pop-ups to authorize the MCP server.'),+ );+ expect(channels[0]?.close).toHaveBeenCalledOnce();+ expect(result.current.isOAuthLoading).toBe(false);+ });++ it('closes the channel and popup when the hook unmounts', async () => {+ authenticateConnector.mockResolvedValue({+ authorization_endpoint: 'https://auth.example.test/authorize',+ });+ vi.spyOn(window, 'open').mockReturnValue(window);+ vi.spyOn(window, 'focus').mockImplementation(() => {});+ const close = vi.spyOn(window, 'close').mockImplementation(() => {});+ const callback = vi.fn();+ const { result, unmount } = renderHook(() => useMCPAuth());++ await act(async () => {+ await result.current.handleAuthorize('connector-4', callback);+ });++ const channel = channels[0];+ if (!channel) throw new Error('Expected an authorization channel');+ expect(channel.close).not.toHaveBeenCalled();++ unmount();++ expect(channel.close).toHaveBeenCalledOnce();+ expect(close).toHaveBeenCalledOnce();+ expect(callback).not.toHaveBeenCalled();+ });+});diff --git a/packages/trueforge-ui-sdk/test/icons/Icon.test.tsx b/packages/trueforge-ui-sdk/test/icons/Icon.test.tsxnew file mode 100644index 000000000..a2a550494--- /dev/null+++ b/packages/trueforge-ui-sdk/test/icons/Icon.test.tsx@@ -0,0 +1,52 @@+import { render, screen } from '@testing-library/react';+import type { SVGProps } from 'react';+import { describe, expect, it } from 'vitest';++import { Icon } from '@/icons/Icon.js';+import { ThemeProvider } from '@/theme/ThemeProvider.js';++function CustomIcon(props: SVGProps<SVGSVGElement>) {+ return <svg data-testid="custom-icon" {...props} />;+}++describe('Icon', () => {+ it('renders a named icon as decorative by default', () => {+ const { container } = render(<Icon name="check" className="host-icon" size={20} style={{ color: 'red' }} />);+ const icon = container.querySelector('svg');++ expect(icon).toHaveAttribute('aria-hidden', 'true');+ expect(icon).toHaveAttribute('width', '20');+ expect(icon).toHaveAttribute('height', '20');+ expect(icon).toHaveClass('inline-block', 'shrink-0', 'host-icon');+ expect(icon?.style.color).toBe('red');+ });++ it('uses the last array entry and exposes labelled icons as images', () => {+ render(<Icon name={['far', 'clone']} aria-label="Copy message" />);++ const icon = screen.getByRole('img', { name: 'Copy message' });+ expect(icon).toHaveClass('lucide-copy');+ expect(icon).not.toHaveAttribute('aria-hidden');+ });++ it('prefers a theme icon override while preserving icon props', () => {+ render(+ <ThemeProvider theme={{ icons: { check: CustomIcon } }}>+ <Icon name="check" aria-label="Custom check" className="override-class" size="2rem" />+ </ThemeProvider>,+ );++ const icon = screen.getByRole('img', { name: 'Custom check' });+ expect(icon).toBe(screen.getByTestId('custom-icon'));+ expect(icon).toHaveClass('inline-block', 'override-class');+ expect(icon).toHaveAttribute('width', '2rem');+ expect(icon).toHaveAttribute('height', '2rem');+ });++ it('renders nothing for an unknown icon name', () => {+ const { container } = render(<Icon name="not-registered" aria-label="Unknown" />);++ expect(container).toBeEmptyDOMElement();+ expect(screen.queryByRole('img', { name: 'Unknown' })).not.toBeInTheDocument();+ });+});diff --git a/packages/trueforge-ui-sdk/test/packageExports.smoke.mjs b/packages/trueforge-ui-sdk/test/packageExports.smoke.mjsnew file mode 100644index 000000000..1e0b03506--- /dev/null+++ b/packages/trueforge-ui-sdk/test/packageExports.smoke.mjs@@ -0,0 +1,65 @@+import assert from 'node:assert/strict';+import { execFileSync } from 'node:child_process';+import { mkdir, mkdtemp, readdir, rm, writeFile } from 'node:fs/promises';+import path from 'node:path';+import { execPath } from 'node:process';+import { fileURLToPath, URL } from 'node:url';++// Create a temporary directory to test the package exports+const packageRoot = fileURLToPath(new URL('..', import.meta.url));+const tempDir = await mkdtemp(path.join(packageRoot, 'test', '.package-smoke-'));++try {+ // create a tarball of the package+ execFileSync('pnpm', ['pack', '--pack-destination', tempDir], {+ cwd: packageRoot,+ stdio: 'inherit',+ });++ // confirm that the tarball was created+ const tarballs = (await readdir(tempDir)).filter(file => file.endsWith('.tgz'));+ assert.equal(tarballs.length, 1, 'Expected pnpm pack to create one tarball');+ const [tarballName] = tarballs;+ assert.ok(tarballName);++ // extract the tarball into a temporary directory+ const packageDir = path.join(tempDir, 'node_modules', '@truefoundry', 'trueforge-ui');+ await mkdir(packageDir, { recursive: true });+ execFileSync('tar', ['-xzf', path.join(tempDir, tarballName), '--strip-components=1', '-C', packageDir]);++ // create a package.json for the consumer+ await writeFile(+ path.join(tempDir, 'package.json'),+ `${JSON.stringify({ name: 'trueforge-ui-package-smoke', private: true, type: 'module' }, null, 2)}\n`,+ );++ // create a consumer.mjs file that imports the package and verifies that the package exports are valid+ await writeFile(+ path.join(tempDir, 'consumer.mjs'),+ `import assert from 'node:assert/strict';+import { access } from 'node:fs/promises';+import { fileURLToPath } from 'node:url';++const sdk = await import('@truefoundry/trueforge-ui');+const assistantUi = await import('@truefoundry/trueforge-ui/assistant-ui');++assert.equal(typeof sdk.TrueforgeUI, 'function');+assert.equal(typeof sdk.createTrueFoundryServer, 'function');+assert.equal(typeof sdk.useMCPAuth, 'function');+assert.equal(typeof assistantUi.useAui, 'function');+assert.equal(typeof assistantUi.useAuiState, 'function');++const stylesPath = fileURLToPath(import.meta.resolve('@truefoundry/trueforge-ui/styles.css'));+await access(stylesPath);+`,+ );++ // execute the consumer.mjs file in the temporary directory+ execFileSync(execPath, ['consumer.mjs'], {+ cwd: tempDir,+ stdio: 'inherit',+ });+} finally {+ // clean up the temporary directory+ await rm(tempDir, { recursive: true, force: true });+}diff --git a/packages/trueforge-ui-sdk/test/publicUiExports.test.ts b/packages/trueforge-ui-sdk/test/publicUiExports.test.tsnew file mode 100644index 000000000..fe49ff683--- /dev/null+++ b/packages/trueforge-ui-sdk/test/publicUiExports.test.ts@@ -0,0 +1,152 @@+import { describe, expect, it } from 'vitest';++import * as sdk from '@/index.js';++const expectedRuntimeExports: Array<keyof typeof sdk> = [+ 'AgentStepsCard',+ 'AgentStepsContainer',+ 'AgentsLibrary',+ 'AgentsLibraryButton',+ 'AskUserContainer',+ 'AssistantMessageBubble',+ 'AssistantMessageContainer',+ 'AssistantTextContainer',+ 'AttachmentCard',+ 'AttachmentPickerButton',+ 'AttachmentPreviewDialog',+ 'Avatar',+ 'AvatarFallback',+ 'AvatarImage',+ 'BottomSheet',+ 'BrandIcon',+ 'BrandLogo',+ 'CenteredModal',+ 'ChatFileDownload',+ 'ClearChatButton',+ 'CodeEditor',+ 'ComposerAttachmentPickerContainer',+ 'ComposerAttachmentsContainer',+ 'ComposerBusyProvider',+ 'ComposerContainer',+ 'ComposerLeftSection',+ 'ComposerRightSection',+ 'ComposerSendButton',+ 'ComposerShell',+ 'DEFAULT_AGENT_CONFIG',+ 'DraftCatalogProvider',+ 'DraftComposerLeftSection',+ 'DraftComposerRightSection',+ 'DraftCompositeSelector',+ 'DraftModelSelector',+ 'ErrorToasterProvider',+ 'HistoryLoader',+ 'HistoryLoaderContainer',+ 'Icon',+ 'MCP_AUTH_POPUP_CHANNEL',+ 'Markdown',+ 'McpAuthContainer',+ 'MessageActionBar',+ 'MessageAttachmentsContainer',+ 'MessageErrorBanner',+ 'MessageGroup',+ 'MessageIndicator',+ 'MessageListSkeleton',+ 'MessageTimestamp',+ 'MonacoEditorCore',+ 'OpenUiFenceBlock',+ 'PRESETS',+ 'PostMcpOauthScreen',+ 'ReasoningContainer',+ 'SandboxArtifactDownload',+ 'SandboxToolCallCard',+ 'SaveAgentButton',+ 'ScrollToBottomButton',+ 'SelectAgentEmptyState',+ 'ServerProvider',+ 'ShellModeProvider',+ 'SlotsProvider',+ 'SubAgentCard',+ 'SyntaxHighlighter',+ 'ThemeProvider',+ 'Thread',+ 'ThreadComposerAreaShell',+ 'ThreadContainer',+ 'ThreadListContainer',+ 'ThreadListEmptyState',+ 'ThreadListNewButton',+ 'ThreadListRow',+ 'ThreadListRowSkeleton',+ 'ThreadListShell',+ 'ThreadRootShell',+ 'ThreadViewportShell',+ 'Toast',+ 'ToastStack',+ 'ToolApprovalBar',+ 'ToolApprovalContainer',+ 'ToolCallCard',+ 'ToolCallContainer',+ 'ToolCallContentBlock',+ 'ToolCallContentBlockContainer',+ 'ToolGroupCard',+ 'ToolGroupContainer',+ 'TrueFoundryChatProvider',+ 'TrueforgeUI',+ 'USER_MESSAGE_ATTACHMENT_PREVIEW_REM',+ 'UserEditComposerContainer',+ 'UserMessageActionBar',+ 'UserMessageBubble',+ 'UserMessageContainer',+ 'UserMessageEdit',+ 'WelcomeScreen',+ 'computeAgentStepsSplit',+ 'createTrueFoundryServer',+ 'defaultSlots',+ 'libraryAgentId',+ 'mergeAgentSpec',+ 'preloadMarkdownOpenUI',+ 'resolvePresetTokens',+ 'shellIsMutable',+ 'threadHasPendingMcpAuth',+ 'trueFoundryAttachmentAdapter',+ 'useAui',+ 'useAuiState',+ 'useBrand',+ 'useCatalogServer',+ 'useComposerBusyState',+ 'useComposerPauseView',+ 'useContentClassNames',+ 'useDraftCatalog',+ 'useErrorToaster',+ 'useErrorToasterOptional',+ 'useMCPAuth',+ 'useOptionalCatalogServer',+ 'useOptionalContentClassNames',+ 'useOptionalServer',+ 'useOptionalShellMode',+ 'useServer',+ 'useShellMode',+ 'useSlot',+ 'useTheme',+ 'useThemeIcons',+ 'useThemeMode',+ 'useTrueFoundryAgentRuntime',+ 'useTrueFoundryAgentSpec',+ 'useTrueFoundryCancel',+ 'useTrueFoundryDownloadSandboxFile',+ 'useTrueFoundryHistoryPagination',+ 'useTrueFoundryMcpAuth',+ 'useTrueFoundryRespondToToolApproval',+ 'useTrueFoundryToolResponses',+ 'useTrueFoundryTurnId',+ 'useTrueFoundryUpdateAgentSpec',+];++describe('public runtime exports', () => {+ it('matches the complete package entrypoint contract', () => {+ expect(Object.keys(sdk).sort()).toEqual([...expectedRuntimeExports].sort());+ });++ it.each(expectedRuntimeExports)('keeps %s defined', exportName => {+ expect(sdk[exportName]).toBeDefined();+ });+});diff --git a/packages/trueforge-ui-sdk/src/server/ServerContext.test.tsx b/packages/trueforge-ui-sdk/test/server/ServerContext.test.tsxsimilarity index 75%rename from packages/trueforge-ui-sdk/src/server/ServerContext.test.tsxrename to packages/trueforge-ui-sdk/test/server/ServerContext.test.tsxindex f04293f33..8ada6ffc5 100644--- a/packages/trueforge-ui-sdk/src/server/ServerContext.test.tsx+++ b/packages/trueforge-ui-sdk/test/server/ServerContext.test.tsx@@ -3,8 +3,15 @@ import { renderHook } from '@testing-library/react';import type { ReactNode } from 'react';import { describe, expect, it, vi } from 'vitest';-import { ServerProvider, useCatalogServer, useOptionalCatalogServer } from './ServerContext.js';-import type { AgentUIServer, CatalogServer } from './types.js';+import {+ ServerProvider,+ useCatalogServer,+ useOptionalCatalogServer,+ useOptionalServer,+ useServer,+} from '@/server/ServerContext.js';+import type { AgentUIServer, CatalogServer } from '@/server/types.js';+import { createMockAgentUIServer } from './mockServer.js';const catalog: CatalogServer = {modelCatalog: {@@ -91,9 +98,28 @@ function wrap(server: AgentUIServer) {};}+describe('ServerProvider', () => {+ it('provides the configured server', () => {+ const server = createMockAgentUIServer();+ const { result } = renderHook(() => useServer(), { wrapper: wrap(server) });++ expect(result.current).toBe(server);+ });++ it('requires a provider for useServer', () => {+ expect(() => renderHook(() => useServer())).toThrow('useServer must be used within a ServerProvider.');+ });++ it('returns null from useOptionalServer outside a provider', () => {+ const { result } = renderHook(() => useOptionalServer());++ expect(result.current).toBeNull();+ });+});+describe('useCatalogServer', () => {it('returns server.catalog when present', () => {- const server = { catalog } as unknown as AgentUIServer;+ const server = createMockAgentUIServer({ catalog });const { result } = renderHook(() => useCatalogServer(), {wrapper: wrap(server),});@@ -101,14 +127,14 @@ describe('useCatalogServer', () => {});it('throws when catalog is omitted', () => {- const server = {} as unknown as AgentUIServer;+ const server = createMockAgentUIServer();expect(() => renderHook(() => useCatalogServer(), { wrapper: wrap(server) })).toThrow(/requires AgentUIServer\.catalog/,);});it('useOptionalCatalogServer returns null when omitted', () => {- const server = {} as unknown as AgentUIServer;+ const server = createMockAgentUIServer();const { result } = renderHook(() => useOptionalCatalogServer(), {wrapper: wrap(server),});diff --git a/packages/trueforge-ui-sdk/src/server/ShellModeContext.test.tsx b/packages/trueforge-ui-sdk/test/server/ShellModeContext.test.tsxsimilarity index 96%rename from packages/trueforge-ui-sdk/src/server/ShellModeContext.test.tsxrename to packages/trueforge-ui-sdk/test/server/ShellModeContext.test.tsxindex 250c83568..279f3353b 100644--- a/packages/trueforge-ui-sdk/src/server/ShellModeContext.test.tsx+++ b/packages/trueforge-ui-sdk/test/server/ShellModeContext.test.tsx@@ -3,7 +3,7 @@ import { act, renderHook } from '@testing-library/react';import type { ReactNode } from 'react';import { describe, expect, it } from 'vitest';-import { ShellModeProvider, useShellMode, type AgentConfig } from './ShellModeContext.js';+import { ShellModeProvider, useOptionalShellMode, useShellMode, type AgentConfig } from '@/server/ShellModeContext.js';function wrap(agentConfig?: AgentConfig) {return function Wrapper({ children }: { children: ReactNode }) {@@ -12,6 +12,16 @@ function wrap(agentConfig?: AgentConfig) {}describe('ShellModeProvider', () => {+ it('requires a provider for useShellMode', () => {+ expect(() => renderHook(() => useShellMode())).toThrow('useShellMode must be used within a ShellModeProvider.');+ });++ it('returns null from useOptionalShellMode outside a provider', () => {+ const { result } = renderHook(() => useOptionalShellMode());++ expect(result.current).toBeNull();+ });+it('defaults to AgentLibraryWithComposer (mutable + library)', () => {const { result } = renderHook(() => useShellMode(), { wrapper: wrap() });expect(result.current.mode).toMatchObject({ status: 'active', isMutable: true, locked: false });diff --git a/packages/trueforge-ui-sdk/src/server/createTrueFoundryServer.test.ts b/packages/trueforge-ui-sdk/test/server/createTrueFoundryServer.test.tssimilarity index 90%rename from packages/trueforge-ui-sdk/src/server/createTrueFoundryServer.test.tsrename to packages/trueforge-ui-sdk/test/server/createTrueFoundryServer.test.tsindex ea54acf45..b51deb678 100644--- a/packages/trueforge-ui-sdk/src/server/createTrueFoundryServer.test.ts+++ b/packages/trueforge-ui-sdk/test/server/createTrueFoundryServer.test.ts@@ -1,11 +1,12 @@+import type { CatalogServer } from '@/server/types.js';import { describe, expect, it, vi } from 'vitest';-import type { AgentChatServer, CatalogServer } from './types.js';-import { createTrueFoundryServer } from './createTrueFoundryServer.js';+import { createTrueFoundryServer } from '@/server/createTrueFoundryServer.js';+import { createMockAgentUIServer } from './mockServer.js';describe('createTrueFoundryServer', () => {it('composes chat server with builder callbacks', async () => {- const chatServer = {+ const chatServer = createMockAgentUIServer({createSession: vi.fn(),listSessions: vi.fn(),getSession: vi.fn(),@@ -15,7 +16,7 @@ describe('createTrueFoundryServer', () => {listTurns: vi.fn(),getTurn: vi.fn(),listEvents: vi.fn(),- } as unknown as AgentChatServer;+ });const getModels = vi.fn(async () => [{ name: 'm', provider: 'p', apiModel: 'p/m', modelId: 'm' }]);const getSkills = vi.fn(async () => []);@@ -48,7 +49,7 @@ describe('createTrueFoundryServer', () => {});it('attaches optional catalog when provided', async () => {- const chatServer = {+ const chatServer = createMockAgentUIServer({createSession: vi.fn(),listSessions: vi.fn(),getSession: vi.fn(),@@ -58,7 +59,7 @@ describe('createTrueFoundryServer', () => {listTurns: vi.fn(),getTurn: vi.fn(),listEvents: vi.fn(),- } as unknown as AgentChatServer;+ });const catalog: CatalogServer = {modelCatalog: {@@ -150,7 +151,10 @@ describe('createTrueFoundryServer', () => {});expect(server.catalog).toBe(catalog);- await expect(server.catalog!.modelCatalog.listModelProviders()).resolves.toEqual([+ if (server.catalog === undefined) {+ throw new Error('Expected catalog');+ }+ await expect(server.catalog.modelCatalog.listModelProviders()).resolves.toEqual([{ id: 'openai', type: 'openai', name: 'OpenAI', models: [] },]);});diff --git a/packages/trueforge-ui-sdk/test/server/mockServer.ts b/packages/trueforge-ui-sdk/test/server/mockServer.tsnew file mode 100644index 000000000..ddc29933a--- /dev/null+++ b/packages/trueforge-ui-sdk/test/server/mockServer.ts@@ -0,0 +1,49 @@+import type { AgentUIServer, CatalogServer } from '@/server/types.js';++async function unavailable(): Promise<never> {+ throw new Error('Unexpected mock server call');+}++async function* emptyTurnStream() {}++export function createMockCatalog(overrides: Partial<CatalogServer> = {}): CatalogServer {+ return {+ modelCatalog: {+ getModelProviderCatalog: async () => [],+ listModelProviders: async () => [],+ createModelProvider: unavailable,+ updateModelProvider: unavailable,+ },+ connectorCatalog: {+ getConnectorCatalog: async () => [],+ listConnectors: async () => [],+ getConnector: unavailable,+ getToolsByConnectorId: async () => [],+ createConnector: unavailable,+ updateConnector: unavailable,+ authenticateConnector: unavailable,+ disconnectConnector: unavailable,+ },+ ...overrides,+ };+}++export function createMockAgentUIServer(overrides: Partial<AgentUIServer> = {}): AgentUIServer {+ return {+ createSession: unavailable,+ listSessions: unavailable,+ getSession: unavailable,+ updateSession: unavailable,+ createTurn: emptyTurnStream,+ cancelSession: unavailable,+ listTurns: unavailable,+ getTurn: unavailable,+ listEvents: unavailable,+ getModels: async () => [],+ getSkills: async () => [],+ getMcp: async () => [],+ searchAgents: async () => [],+ saveAgent: unavailable,+ ...overrides,+ };+}diff --git a/packages/trueforge-ui-sdk/src/testSetup.ts b/packages/trueforge-ui-sdk/test/testSetup.tssimilarity index 91%rename from packages/trueforge-ui-sdk/src/testSetup.tsrename to packages/trueforge-ui-sdk/test/testSetup.tsindex 215b60636..40a9c21c0 100644--- a/packages/trueforge-ui-sdk/src/testSetup.ts+++ b/packages/trueforge-ui-sdk/test/testSetup.ts@@ -48,5 +48,9 @@ class ResizeObserverStub {}if (typeof globalThis.ResizeObserver === 'undefined') {- globalThis.ResizeObserver = ResizeObserverStub as unknown as typeof ResizeObserver;+ Object.defineProperty(globalThis, 'ResizeObserver', {+ configurable: true,+ writable: true,+ value: ResizeObserverStub,+ });}diff --git a/packages/trueforge-ui-sdk/src/theme/SlotsProvider.test.tsx b/packages/trueforge-ui-sdk/test/theme/SlotsProvider.test.tsxsimilarity index 73%rename from packages/trueforge-ui-sdk/src/theme/SlotsProvider.test.tsxrename to packages/trueforge-ui-sdk/test/theme/SlotsProvider.test.tsxindex c7e22958e..ae14de9c9 100644--- a/packages/trueforge-ui-sdk/src/theme/SlotsProvider.test.tsx+++ b/packages/trueforge-ui-sdk/test/theme/SlotsProvider.test.tsx@@ -1,10 +1,10 @@// @vitest-environment jsdomimport { render, screen } from '@testing-library/react';-import type { ComponentProps } from 'react';+import type { ComponentProps, ReactNode } from 'react';import { describe, expect, it } from 'vitest';-import { WelcomeScreen } from '../atoms/WelcomeScreen.js';-import { SlotsProvider, useSlot, useThemeMode } from './SlotsProvider.js';+import { WelcomeScreen } from '@/atoms/WelcomeScreen.js';+import { SlotsProvider, useSlot, useThemeMode } from '@/theme/SlotsProvider.js';function WelcomeConsumer() {const SlotWelcome = useSlot('WelcomeScreen');@@ -19,6 +19,10 @@ function CustomWelcome(_props: ComponentProps<typeof WelcomeScreen>) {return <p data-testid="custom-welcome">custom</p>;}+function CustomAccordion({ children }: { children?: ReactNode }) {+ return <section data-testid="custom-accordion">{children}</section>;+}+describe('SlotsProvider', () => {it('resolves the default WelcomeScreen when no override is provided', () => {render(<WelcomeConsumer />);@@ -66,10 +70,18 @@ describe('SlotsProvider', () => {}render(- <SlotsProvider overrides={{ WelcomeScreen: CustomWelcome }}>- <AccordionConsumer />+ <SlotsProvider overrides={{ WelcomeScreen: CustomWelcome }} theme={{ mode: 'dark' }}>+ <SlotsProvider overrides={{ Accordion: CustomAccordion }}>+ <WelcomeConsumer />+ <AccordionConsumer />+ <ThemeModeConsumer />+ </SlotsProvider></SlotsProvider>,);++ expect(screen.getByTestId('custom-welcome')).toBeInTheDocument();+ expect(screen.getByTestId('custom-accordion')).toHaveTextContent('nested-ok');expect(screen.getByText('nested-ok')).toBeInTheDocument();+ expect(screen.getByText('dark')).toBeInTheDocument();});});diff --git a/packages/trueforge-ui-sdk/src/theme/ThemeProvider.test.tsx b/packages/trueforge-ui-sdk/test/theme/ThemeProvider.test.tsxsimilarity index 76%rename from packages/trueforge-ui-sdk/src/theme/ThemeProvider.test.tsxrename to packages/trueforge-ui-sdk/test/theme/ThemeProvider.test.tsxindex e13ba67bb..107d5e14f 100644--- a/packages/trueforge-ui-sdk/src/theme/ThemeProvider.test.tsx+++ b/packages/trueforge-ui-sdk/test/theme/ThemeProvider.test.tsx@@ -1,10 +1,10 @@// @vitest-environment jsdom-import { act, render, screen } from '@testing-library/react';-import { describe, expect, it } from 'vitest';+import { act, render, renderHook, screen } from '@testing-library/react';+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';-import { WelcomeScreen } from '../atoms/WelcomeScreen.js';-import { BrandIcon, BrandLogo } from './brand.js';-import { ThemeProvider, useBrand, useTheme } from './ThemeProvider.js';+import { WelcomeScreen } from '@/atoms/WelcomeScreen.js';+import { BrandIcon, BrandLogo } from '@/theme/brand.js';+import { ThemeProvider, useBrand, useTheme } from '@/theme/ThemeProvider.js';function ModeProbe() {const { mode, preference, setTheme } = useTheme();@@ -27,7 +27,29 @@ function BrandProbe() {return <output data-testid="brand-name">{brand.name ?? 'none'}</output>;}+function getThemeRoot(container: HTMLElement): HTMLElement {+ const root = container.querySelector<HTMLElement>('.aui-theme-root');+ if (root === null) {+ throw new Error('Expected theme root');+ }+ return root;+}+describe('ThemeProvider', () => {+ beforeEach(() => {+ localStorage.clear();+ document.documentElement.classList.remove('dark');+ });++ afterEach(() => {+ vi.unstubAllGlobals();+ document.documentElement.classList.remove('dark');+ });++ it('requires a provider for useTheme', () => {+ expect(() => renderHook(() => useTheme())).toThrow('useTheme must be used within a ThemeProvider');+ });+it('applies controlled mode and ignores setTheme', () => {render(<ThemeProvider theme={{ mode: 'dark' }}>@@ -52,6 +74,49 @@ describe('ThemeProvider', () => {});expect(screen.getByTestId('mode')).toHaveTextContent('dark');expect(document.documentElement.classList.contains('dark')).toBe(true);+ expect(localStorage.getItem('aui-theme-preference')).toBe('dark');+ });++ it('follows system preference changes and removes the listener on unmount', () => {+ let systemDark = false;+ const listeners = new Set<() => void>();+ const addEventListener = vi.fn((_type: string, listener: () => void) => {+ listeners.add(listener);+ });+ const removeEventListener = vi.fn((_type: string, listener: () => void) => {+ listeners.delete(listener);+ });+ vi.stubGlobal(+ 'matchMedia',+ vi.fn(() => ({+ get matches() {+ return systemDark;+ },+ addEventListener,+ removeEventListener,+ })),+ );+ localStorage.setItem('aui-theme-preference', 'system');++ const { unmount } = render(+ <ThemeProvider>+ <ModeProbe />+ </ThemeProvider>,+ );++ expect(screen.getByTestId('preference')).toHaveTextContent('system');+ expect(screen.getByTestId('mode')).toHaveTextContent('light');++ systemDark = true;+ act(() => {+ for (const listener of listeners) listener();+ });++ expect(screen.getByTestId('mode')).toHaveTextContent('dark');+ expect(document.documentElement).toHaveClass('dark');++ unmount();+ expect(removeEventListener).toHaveBeenCalledWith('change', expect.any(Function));});it('exposes brand config and BrandLogo / BrandIcon', () => {@@ -72,7 +137,7 @@ describe('ThemeProvider', () => {<span>child</span></ThemeProvider>,);- const root = container.querySelector('.aui-theme-root') as HTMLElement;+ const root = getThemeRoot(container);expect(root.classList.contains('host-chat')).toBe(true);expect(root.style.getPropertyValue('--primary')).toBe('#e11d48');});@@ -83,7 +148,7 @@ describe('ThemeProvider', () => {<span>child</span></ThemeProvider>,);- const root = container.querySelector('.aui-theme-root') as HTMLElement;+ const root = getThemeRoot(container);expect(root.getAttribute('data-preset')).toBe('chatgpt');expect(root.style.getPropertyValue('--primary')).toBe('#0d0d0d');expect(root.style.getPropertyValue('--background')).toBe('#ffffff');@@ -103,7 +168,7 @@ describe('ThemeProvider', () => {<span>child</span></ThemeProvider>,);- const root = container.querySelector('.aui-theme-root') as HTMLElement;+ const root = getThemeRoot(container);expect(root.style.getPropertyValue('--background')).toBe('#000000');expect(root.style.getPropertyValue('--card')).toBe('#212121');expect(root.style.getPropertyValue('--primary')).toBe('#ffffff');@@ -118,7 +183,7 @@ describe('ThemeProvider', () => {<span>child</span></ThemeProvider>,);- const root = container.querySelector('.aui-theme-root') as HTMLElement;+ const root = getThemeRoot(container);expect(root.getAttribute('data-preset')).toBe('claude');expect(root.style.getPropertyValue('--background')).toBe('#f0ece0');expect(root.style.getPropertyValue('--foreground')).toBe('#1a1a18');@@ -139,7 +204,7 @@ describe('ThemeProvider', () => {<span>child</span></ThemeProvider>,);- const root = container.querySelector('.aui-theme-root') as HTMLElement;+ const root = getThemeRoot(container);expect(root.style.getPropertyValue('--background')).toBe('#2b2a27');expect(root.style.getPropertyValue('--foreground')).toBe('#eeeeee');expect(root.style.getPropertyValue('--card')).toBe('#1f1e1b');@@ -154,7 +219,7 @@ describe('ThemeProvider', () => {<span>child</span></ThemeProvider>,);- const root = container.querySelector('.aui-theme-root') as HTMLElement;+ const root = getThemeRoot(container);expect(root.style.getPropertyValue('--background')).toBe('#fdfcfc');expect(root.style.getPropertyValue('--foreground')).toBe('#1f1f1f');expect(root.style.getPropertyValue('--primary')).toBe('#1f3b9b');@@ -172,7 +237,7 @@ describe('ThemeProvider', () => {<span>child</span></ThemeProvider>,);- const root = container.querySelector('.aui-theme-root') as HTMLElement;+ const root = getThemeRoot(container);expect(root.style.getPropertyValue('--background')).toBe('#0c0c0c');expect(root.style.getPropertyValue('--card')).toBe('#1e1f20');expect(root.style.getPropertyValue('--primary')).toBe('#a8c7fa');diff --git a/packages/trueforge-ui-sdk/test/theme/brand.test.tsx b/packages/trueforge-ui-sdk/test/theme/brand.test.tsxnew file mode 100644index 000000000..48f7c795c--- /dev/null+++ b/packages/trueforge-ui-sdk/test/theme/brand.test.tsx@@ -0,0 +1,61 @@+import { render, screen } from '@testing-library/react';+import { describe, expect, it } from 'vitest';++import { BrandIcon, BrandLogo } from '@/theme/brand.js';+import { ThemeProvider } from '@/theme/ThemeProvider.js';++describe('BrandIcon and BrandLogo', () => {+ it('renders accessible default branding without a provider', () => {+ const { container } = render(+ <>+ <BrandLogo className="host-logo" />+ <BrandIcon className="host-icon" />+ </>,+ );++ expect(screen.getByText('TrueFoundry').parentElement).toHaveClass('host-logo');+ const icons = container.querySelectorAll('svg[aria-hidden="true"]');+ expect(icons).toHaveLength(2);+ expect(icons[1]).toHaveClass('host-icon');+ });++ it('renders configured image descriptors with alt text and classes', () => {+ render(+ <ThemeProvider+ theme={{+ brand: {+ logo: { src: '/acme-logo.svg', alt: 'Acme logo' },+ icon: { src: '/acme-icon.svg', alt: 'Acme icon' },+ },+ }}+ >+ <BrandLogo className="logo-image" />+ <BrandIcon className="icon-image" />+ </ThemeProvider>,+ );++ expect(screen.getByRole('img', { name: 'Acme logo' })).toHaveAttribute('src', '/acme-logo.svg');+ expect(screen.getByRole('img', { name: 'Acme logo' })).toHaveClass('logo-image');+ expect(screen.getByRole('img', { name: 'Acme icon' })).toHaveAttribute('src', '/acme-icon.svg');+ expect(screen.getByRole('img', { name: 'Acme icon' })).toHaveClass('icon-image');+ });++ it('supports render callbacks and passes through the requested class', () => {+ render(+ <ThemeProvider+ theme={{+ brand: {+ logo: ({ className }) => <span className={className}>Callback logo</span>,+ icon: ({ className }) => <span className={className}>Callback icon</span>,+ },+ }}+ >+ <BrandLogo className="custom-logo" />+ <BrandIcon className="custom-icon" />+ </ThemeProvider>,+ );++ expect(screen.getByText('Callback logo')).toHaveClass('custom-logo');+ expect(screen.getByText('Callback icon')).toHaveClass('custom-icon');+ });+});diff --git a/packages/trueforge-ui-sdk/test/tsconfig.json b/packages/trueforge-ui-sdk/test/tsconfig.jsonnew file mode 100644index 000000000..ec978a7ae--- /dev/null+++ b/packages/trueforge-ui-sdk/test/tsconfig.json@@ -0,0 +1,12 @@+{+ "extends": "../tsconfig.json",+ "compilerOptions": {+ "declaration": false,+ "declarationMap": false,+ "module": "ESNext",+ "moduleResolution": "Bundler",+ "rootDir": "..",+ "types": ["node", "vitest/globals"]+ },+ "include": ["../src", ".", "../vitest.config.ts"]+}diff --git a/packages/trueforge-ui-sdk/src/utils/computeAgentStepsSplit.test.ts b/packages/trueforge-ui-sdk/test/utils/computeAgentStepsSplit.test.tssimilarity index 74%rename from packages/trueforge-ui-sdk/src/utils/computeAgentStepsSplit.test.tsrename to packages/trueforge-ui-sdk/test/utils/computeAgentStepsSplit.test.tsindex c30bff1b3..c7b353726 100644--- a/packages/trueforge-ui-sdk/src/utils/computeAgentStepsSplit.test.ts+++ b/packages/trueforge-ui-sdk/test/utils/computeAgentStepsSplit.test.ts@@ -1,18 +1,17 @@import { describe, expect, it } from 'vitest';-import type { PartState } from '@assistant-ui/core/react';-import { computeAgentStepsSplit } from './computeAgentStepsSplit.js';+import { computeAgentStepsSplit, type AgentStepPart } from '@/index.js';-function text(content: string): PartState {- return { type: 'text', text: content } as PartState;+function text(content: string): AgentStepPart {+ return { type: 'text', text: content };}-function tool(): PartState {- return { type: 'tool-call', toolCallId: '1', toolName: 't' } as PartState;+function tool(): AgentStepPart {+ return { type: 'tool-call' };}-function reasoning(): PartState {- return { type: 'reasoning', text: 'thinking' } as PartState;+function reasoning(): AgentStepPart {+ return { type: 'reasoning', text: 'thinking' };}describe('computeAgentStepsSplit', () => {diff --git a/packages/trueforge-ui-sdk/src/utils/toolCallParsing.test.ts b/packages/trueforge-ui-sdk/test/utils/toolCallParsing.test.tssimilarity index 98%rename from packages/trueforge-ui-sdk/src/utils/toolCallParsing.test.tsrename to packages/trueforge-ui-sdk/test/utils/toolCallParsing.test.tsindex 0e86636fd..539ed5e7d 100644--- a/packages/trueforge-ui-sdk/src/utils/toolCallParsing.test.ts+++ b/packages/trueforge-ui-sdk/test/utils/toolCallParsing.test.ts@@ -12,7 +12,7 @@ import {parseSandboxArgs,parseSandboxResult,toStatus,-} from './toolCallParsing.js';+} from '@/utils/toolCallParsing.js';describe('toolCallParsing', () => {it('parses ask-user args', () => {diff --git a/packages/trueforge-ui-sdk/tsconfig.json b/packages/trueforge-ui-sdk/tsconfig.jsonindex 6ee628623..fdeae1883 100644--- a/packages/trueforge-ui-sdk/tsconfig.json+++ b/packages/trueforge-ui-sdk/tsconfig.json@@ -12,9 +12,8 @@"sourceMap": true,"rootDir": "src","outDir": "dist",- "baseUrl": ".","paths": {- "@/*": ["src/*"]+ "@/*": ["./src/*"]},"noEmit": true,"isolatedModules": true,diff --git a/packages/trueforge-ui-sdk/tsup.config.ts b/packages/trueforge-ui-sdk/tsup.config.tsindex 9a67fad28..0b7e9f528 100644--- a/packages/trueforge-ui-sdk/tsup.config.ts+++ b/packages/trueforge-ui-sdk/tsup.config.ts@@ -22,6 +22,7 @@ export default defineConfig({},}),],+ noExternal: ['react-syntax-highlighter/dist/esm/styles/prism'],external: ['react','react-dom',@@ -36,7 +37,6 @@ export default defineConfig({'react-markdown','remark-gfm','react-syntax-highlighter',- 'react-syntax-highlighter/dist/esm/styles/prism','monaco-editor',],});diff --git a/packages/trueforge-ui-sdk/vitest.config.ts b/packages/trueforge-ui-sdk/vitest.config.tsindex e2b66ef79..b5b33e62f 100644--- a/packages/trueforge-ui-sdk/vitest.config.ts+++ b/packages/trueforge-ui-sdk/vitest.config.ts@@ -12,18 +12,18 @@ export default defineConfig({},test: {environment: 'jsdom',- include: ['src/**/*.test.{ts,tsx}'],+ include: ['test/**/*.test.{ts,tsx}'],globals: true,- setupFiles: ['./src/testSetup.ts'],+ setupFiles: ['./test/testSetup.ts'],coverage: {provider: 'v8',include: ['src/**/*.{ts,tsx}'],- exclude: ['src/**/*.test.{ts,tsx}', 'src/testSetup.ts', 'src/svg.d.ts'],+ exclude: ['test/**', 'src/svg.d.ts'],thresholds: {- // Floor just under measured baseline (~70/67/56) so CI stays green.- lines: 65,- functions: 60,- branches: 50,+ // Floors stay below the measured baseline (~82/76/75) while preventing large regressions.+ lines: 78,+ functions: 73,+ branches: 72,},},},