@copilotkit/react-core 1.54.1-next.6 → 1.55.0-next.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (183) hide show
  1. package/CHANGELOG.md +121 -106
  2. package/dist/copilotkit-B3Mb1yVE.cjs +7975 -0
  3. package/dist/copilotkit-B3Mb1yVE.cjs.map +1 -0
  4. package/dist/copilotkit-DBzgOMby.d.cts +2182 -0
  5. package/dist/copilotkit-DBzgOMby.d.cts.map +1 -0
  6. package/dist/copilotkit-DNYSFuz5.mjs +7562 -0
  7. package/dist/copilotkit-DNYSFuz5.mjs.map +1 -0
  8. package/dist/copilotkit-Dy5w3qEV.d.mts +2182 -0
  9. package/dist/copilotkit-Dy5w3qEV.d.mts.map +1 -0
  10. package/dist/index.cjs +27 -28
  11. package/dist/index.cjs.map +1 -1
  12. package/dist/index.d.cts +3 -3
  13. package/dist/index.d.cts.map +1 -1
  14. package/dist/index.d.mts +3 -3
  15. package/dist/index.d.mts.map +1 -1
  16. package/dist/index.mjs +4 -5
  17. package/dist/index.mjs.map +1 -1
  18. package/dist/index.umd.js +1941 -35
  19. package/dist/index.umd.js.map +1 -1
  20. package/dist/v2/index.cjs +77 -7
  21. package/dist/v2/index.css +1 -2
  22. package/dist/v2/index.d.cts +6 -4
  23. package/dist/v2/index.d.mts +6 -4
  24. package/dist/v2/index.mjs +7 -4
  25. package/dist/v2/index.umd.js +5725 -24
  26. package/dist/v2/index.umd.js.map +1 -1
  27. package/package.json +35 -7
  28. package/scripts/scope-preflight.mjs +101 -0
  29. package/src/components/CopilotListeners.tsx +2 -6
  30. package/src/components/copilot-provider/copilot-messages.tsx +1 -1
  31. package/src/components/copilot-provider/copilotkit-props.tsx +1 -1
  32. package/src/components/copilot-provider/copilotkit.tsx +4 -4
  33. package/src/context/copilot-messages-context.tsx +1 -1
  34. package/src/hooks/__tests__/use-coagent-config.test.ts +2 -2
  35. package/src/hooks/__tests__/use-coagent-state-render.e2e.test.tsx +2 -2
  36. package/src/hooks/__tests__/use-copilot-chat-internal-connect.test.tsx +3 -7
  37. package/src/hooks/__tests__/use-frontend-tool-available.test.tsx +1 -1
  38. package/src/hooks/__tests__/use-frontend-tool-remount.e2e.test.tsx +4 -4
  39. package/src/hooks/use-agent-nodename.ts +1 -1
  40. package/src/hooks/use-coagent-state-render-bridge.tsx +1 -4
  41. package/src/hooks/use-coagent.ts +1 -1
  42. package/src/hooks/use-configure-chat-suggestions.tsx +2 -2
  43. package/src/hooks/use-copilot-chat-suggestions.tsx +2 -2
  44. package/src/hooks/use-copilot-chat_internal.ts +2 -2
  45. package/src/hooks/use-copilot-readable.ts +1 -1
  46. package/src/hooks/use-frontend-tool.ts +2 -2
  47. package/src/hooks/use-human-in-the-loop.ts +2 -2
  48. package/src/hooks/use-langgraph-interrupt.ts +2 -5
  49. package/src/hooks/use-lazy-tool-renderer.tsx +1 -1
  50. package/src/hooks/use-render-tool-call.ts +1 -1
  51. package/src/lib/copilot-task.ts +1 -1
  52. package/src/setupTests.ts +18 -14
  53. package/src/v2/__tests__/A2UIMessageRenderer.test.tsx +176 -0
  54. package/src/v2/__tests__/globalSetup.ts +14 -0
  55. package/src/v2/__tests__/setup.ts +93 -0
  56. package/src/v2/__tests__/utils/test-helpers.tsx +470 -0
  57. package/src/v2/a2ui/A2UIMessageRenderer.tsx +206 -0
  58. package/src/v2/components/CopilotKitInspector.tsx +50 -0
  59. package/src/v2/components/MCPAppsActivityRenderer.tsx +785 -0
  60. package/src/v2/components/WildcardToolCallRender.tsx +86 -0
  61. package/src/v2/components/__tests__/license-warning-banner.test.tsx +46 -0
  62. package/src/v2/components/chat/CopilotChat.tsx +431 -0
  63. package/src/v2/components/chat/CopilotChatAssistantMessage.tsx +375 -0
  64. package/src/v2/components/chat/CopilotChatAudioRecorder.tsx +350 -0
  65. package/src/v2/components/chat/CopilotChatInput.tsx +1302 -0
  66. package/src/v2/components/chat/CopilotChatMessageView.tsx +556 -0
  67. package/src/v2/components/chat/CopilotChatReasoningMessage.tsx +252 -0
  68. package/src/v2/components/chat/CopilotChatSuggestionPill.tsx +59 -0
  69. package/src/v2/components/chat/CopilotChatSuggestionView.tsx +133 -0
  70. package/src/v2/components/chat/CopilotChatToggleButton.tsx +171 -0
  71. package/src/v2/components/chat/CopilotChatToolCallsView.tsx +40 -0
  72. package/src/v2/components/chat/CopilotChatUserMessage.tsx +388 -0
  73. package/src/v2/components/chat/CopilotChatView.tsx +598 -0
  74. package/src/v2/components/chat/CopilotModalHeader.tsx +129 -0
  75. package/src/v2/components/chat/CopilotPopup.tsx +81 -0
  76. package/src/v2/components/chat/CopilotPopupView.tsx +317 -0
  77. package/src/v2/components/chat/CopilotSidebar.tsx +76 -0
  78. package/src/v2/components/chat/CopilotSidebarView.tsx +255 -0
  79. package/src/v2/components/chat/__tests__/CopilotChat.e2e.test.tsx +1113 -0
  80. package/src/v2/components/chat/__tests__/CopilotChat.onError.test.tsx +73 -0
  81. package/src/v2/components/chat/__tests__/CopilotChat.slots.e2e.test.tsx +432 -0
  82. package/src/v2/components/chat/__tests__/CopilotChatActivityRendering.e2e.test.tsx +150 -0
  83. package/src/v2/components/chat/__tests__/CopilotChatAssistantMessage.slots.e2e.test.tsx +624 -0
  84. package/src/v2/components/chat/__tests__/CopilotChatAssistantMessage.test.tsx +702 -0
  85. package/src/v2/components/chat/__tests__/CopilotChatCssClasses.test.tsx +107 -0
  86. package/src/v2/components/chat/__tests__/CopilotChatInput.slots.e2e.test.tsx +929 -0
  87. package/src/v2/components/chat/__tests__/CopilotChatInput.test.tsx +986 -0
  88. package/src/v2/components/chat/__tests__/CopilotChatMessageView.slots.e2e.test.tsx +1004 -0
  89. package/src/v2/components/chat/__tests__/CopilotChatMessageView.test.tsx +169 -0
  90. package/src/v2/components/chat/__tests__/CopilotChatSuggestionView.slots.e2e.test.tsx +530 -0
  91. package/src/v2/components/chat/__tests__/CopilotChatToolRendering.e2e.test.tsx +782 -0
  92. package/src/v2/components/chat/__tests__/CopilotChatToolRerenders.e2e.test.tsx +2413 -0
  93. package/src/v2/components/chat/__tests__/CopilotChatUserMessage.slots.e2e.test.tsx +621 -0
  94. package/src/v2/components/chat/__tests__/CopilotChatView.onClick.e2e.test.tsx +853 -0
  95. package/src/v2/components/chat/__tests__/CopilotChatView.slots.e2e.test.tsx +1050 -0
  96. package/src/v2/components/chat/__tests__/CopilotModalHeader.slots.e2e.test.tsx +484 -0
  97. package/src/v2/components/chat/__tests__/CopilotPopupView.slots.e2e.test.tsx +612 -0
  98. package/src/v2/components/chat/__tests__/CopilotSidebarView.slots.e2e.test.tsx +502 -0
  99. package/src/v2/components/chat/__tests__/MCPAppsActivityRenderer.e2e.test.tsx +1011 -0
  100. package/src/v2/components/chat/__tests__/setup.ts +1 -0
  101. package/src/v2/components/chat/index.ts +79 -0
  102. package/src/v2/components/index.ts +7 -0
  103. package/src/v2/components/license-warning-banner.tsx +198 -0
  104. package/src/v2/components/ui/button.tsx +123 -0
  105. package/src/v2/components/ui/dropdown-menu.tsx +258 -0
  106. package/src/v2/components/ui/tooltip.tsx +60 -0
  107. package/src/v2/hooks/__tests__/standard-schema-types.test.tsx +152 -0
  108. package/src/v2/hooks/__tests__/standard-schema.test.tsx +282 -0
  109. package/src/v2/hooks/__tests__/use-agent-context-timing.e2e.test.tsx +132 -0
  110. package/src/v2/hooks/__tests__/use-agent-context.test.tsx +401 -0
  111. package/src/v2/hooks/__tests__/use-agent-error-state.test.tsx +44 -0
  112. package/src/v2/hooks/__tests__/use-agent-stability.test.tsx +205 -0
  113. package/src/v2/hooks/__tests__/use-agent.e2e.test.tsx +148 -0
  114. package/src/v2/hooks/__tests__/use-component.test.tsx +123 -0
  115. package/src/v2/hooks/__tests__/use-configure-suggestions.e2e.test.tsx +696 -0
  116. package/src/v2/hooks/__tests__/use-default-render-tool.test.tsx +153 -0
  117. package/src/v2/hooks/__tests__/use-frontend-tool-available.test.tsx +167 -0
  118. package/src/v2/hooks/__tests__/use-frontend-tool.e2e.test.tsx +2129 -0
  119. package/src/v2/hooks/__tests__/use-human-in-the-loop.e2e.test.tsx +1261 -0
  120. package/src/v2/hooks/__tests__/use-interrupt.test.tsx +397 -0
  121. package/src/v2/hooks/__tests__/use-katex-styles.test.tsx +56 -0
  122. package/src/v2/hooks/__tests__/use-keyboard-height.test.tsx +192 -0
  123. package/src/v2/hooks/__tests__/use-render-tool.test.tsx +259 -0
  124. package/src/v2/hooks/__tests__/use-suggestions.e2e.test.tsx +524 -0
  125. package/src/v2/hooks/__tests__/use-threads.test.tsx +433 -0
  126. package/src/v2/hooks/__tests__/zod-regression.test.tsx +311 -0
  127. package/src/v2/hooks/index.ts +18 -0
  128. package/src/v2/hooks/use-agent-context.tsx +45 -0
  129. package/src/v2/hooks/use-agent.tsx +155 -0
  130. package/src/v2/hooks/use-component.tsx +89 -0
  131. package/src/v2/hooks/use-configure-suggestions.tsx +187 -0
  132. package/src/v2/hooks/use-default-render-tool.tsx +254 -0
  133. package/src/v2/hooks/use-frontend-tool.tsx +43 -0
  134. package/src/v2/hooks/use-human-in-the-loop.tsx +81 -0
  135. package/src/v2/hooks/use-interrupt.tsx +305 -0
  136. package/src/v2/hooks/use-keyboard-height.tsx +67 -0
  137. package/src/v2/hooks/use-render-activity-message.tsx +73 -0
  138. package/src/v2/hooks/use-render-custom-messages.tsx +93 -0
  139. package/src/v2/hooks/use-render-tool-call.tsx +175 -0
  140. package/src/v2/hooks/use-render-tool.tsx +181 -0
  141. package/src/v2/hooks/use-suggestions.tsx +91 -0
  142. package/src/v2/hooks/use-threads.tsx +256 -0
  143. package/src/v2/hooks/useKatexStyles.ts +27 -0
  144. package/src/v2/index.css +1 -1
  145. package/src/v2/index.ts +18 -2
  146. package/src/v2/lib/__tests__/completePartialMarkdown.test.ts +495 -0
  147. package/src/v2/lib/__tests__/renderSlot.test.tsx +588 -0
  148. package/src/v2/lib/react-core.ts +156 -0
  149. package/src/v2/lib/slots.tsx +143 -0
  150. package/src/v2/lib/transcription-client.ts +184 -0
  151. package/src/v2/lib/utils.ts +8 -0
  152. package/src/v2/providers/CopilotChatConfigurationProvider.tsx +162 -0
  153. package/src/v2/providers/CopilotKitProvider.tsx +600 -0
  154. package/src/v2/providers/__tests__/CopilotChatConfigurationProvider.test.tsx +546 -0
  155. package/src/v2/providers/__tests__/CopilotKitProvider.license.test.tsx +101 -0
  156. package/src/v2/providers/__tests__/CopilotKitProvider.onError.test.tsx +69 -0
  157. package/src/v2/providers/__tests__/CopilotKitProvider.renderCustomMessages.e2e.test.tsx +881 -0
  158. package/src/v2/providers/__tests__/CopilotKitProvider.stability.test.tsx +740 -0
  159. package/src/v2/providers/__tests__/CopilotKitProvider.test.tsx +642 -0
  160. package/src/v2/providers/__tests__/CopilotKitProvider.wildcard.test.tsx +294 -0
  161. package/src/v2/providers/index.ts +14 -0
  162. package/src/v2/styles/globals.css +230 -0
  163. package/src/v2/types/__tests__/defineToolCallRenderer.test.tsx +525 -0
  164. package/src/v2/types/defineToolCallRenderer.ts +65 -0
  165. package/src/v2/types/frontend-tool.ts +8 -0
  166. package/src/v2/types/human-in-the-loop.ts +33 -0
  167. package/src/v2/types/index.ts +7 -0
  168. package/src/v2/types/interrupt.ts +15 -0
  169. package/src/v2/types/react-activity-message-renderer.ts +27 -0
  170. package/src/v2/types/react-custom-message-renderer.ts +17 -0
  171. package/src/v2/types/react-tool-call-renderer.ts +32 -0
  172. package/tsdown.config.ts +34 -10
  173. package/vitest.config.mjs +4 -3
  174. package/LICENSE +0 -21
  175. package/dist/copilotkit-BRPQ2sqS.d.cts +0 -670
  176. package/dist/copilotkit-BRPQ2sqS.d.cts.map +0 -1
  177. package/dist/copilotkit-C94ayZbs.cjs +0 -2161
  178. package/dist/copilotkit-C94ayZbs.cjs.map +0 -1
  179. package/dist/copilotkit-CwZMFmSK.d.mts +0 -670
  180. package/dist/copilotkit-CwZMFmSK.d.mts.map +0 -1
  181. package/dist/copilotkit-Yh_Ld_FX.mjs +0 -2031
  182. package/dist/copilotkit-Yh_Ld_FX.mjs.map +0 -1
  183. package/dist/v2/index.css.map +0 -1
@@ -0,0 +1,929 @@
1
+ import React from "react";
2
+ import { render, screen, fireEvent } from "@testing-library/react";
3
+ import { describe, it, expect, vi } from "vitest";
4
+ import { CopilotChatInput } from "../CopilotChatInput";
5
+ import { CopilotKitProvider } from "../../../providers/CopilotKitProvider";
6
+ import { CopilotChatConfigurationProvider } from "../../../providers/CopilotChatConfigurationProvider";
7
+
8
+ // Wrapper to provide required context
9
+ const TestWrapper: React.FC<{ children: React.ReactNode }> = ({ children }) => (
10
+ <CopilotKitProvider>
11
+ <CopilotChatConfigurationProvider threadId="test-thread">
12
+ <div style={{ height: 200 }}>{children}</div>
13
+ </CopilotChatConfigurationProvider>
14
+ </CopilotKitProvider>
15
+ );
16
+
17
+ describe("CopilotChatInput Slot System E2E Tests", () => {
18
+ // ============================================================================
19
+ // 1. TAILWIND CLASS TESTS
20
+ // ============================================================================
21
+ describe("1. Tailwind Class Slot Override", () => {
22
+ describe("textArea slot", () => {
23
+ it("should apply tailwind class string to textArea", () => {
24
+ const { container } = render(
25
+ <TestWrapper>
26
+ <CopilotChatInput textArea="border-2 border-blue-500 rounded-lg p-4" />
27
+ </TestWrapper>,
28
+ );
29
+
30
+ const textAreaEl = container.querySelector(".border-blue-500");
31
+ expect(textAreaEl).toBeDefined();
32
+ });
33
+
34
+ it("should override default textArea className", () => {
35
+ const { container } = render(
36
+ <TestWrapper>
37
+ <CopilotChatInput textArea="custom-textarea-class" />
38
+ </TestWrapper>,
39
+ );
40
+
41
+ expect(container.querySelector(".custom-textarea-class")).toBeDefined();
42
+ });
43
+ });
44
+
45
+ describe("sendButton slot", () => {
46
+ it("should apply tailwind class string to sendButton", () => {
47
+ const { container } = render(
48
+ <TestWrapper>
49
+ <CopilotChatInput sendButton="bg-green-500 hover:bg-green-600 rounded-full" />
50
+ </TestWrapper>,
51
+ );
52
+
53
+ const sendBtn = container.querySelector(".bg-green-500");
54
+ expect(sendBtn).toBeDefined();
55
+ });
56
+ });
57
+
58
+ describe("startTranscribeButton slot", () => {
59
+ it("should apply tailwind class string to startTranscribeButton", () => {
60
+ const { container } = render(
61
+ <TestWrapper>
62
+ <CopilotChatInput
63
+ onStartTranscribe={() => {}}
64
+ startTranscribeButton="bg-red-500 rounded"
65
+ />
66
+ </TestWrapper>,
67
+ );
68
+
69
+ const transcribeBtn = container.querySelector(".bg-red-500");
70
+ // Button may only appear when transcription is enabled
71
+ });
72
+ });
73
+
74
+ describe("cancelTranscribeButton slot", () => {
75
+ it("should apply tailwind class string to cancelTranscribeButton", () => {
76
+ const { container } = render(
77
+ <TestWrapper>
78
+ <CopilotChatInput
79
+ mode="transcribe"
80
+ onCancelTranscribe={() => {}}
81
+ cancelTranscribeButton="bg-gray-500"
82
+ />
83
+ </TestWrapper>,
84
+ );
85
+
86
+ const cancelBtn = container.querySelector(".bg-gray-500");
87
+ // Button appears in transcribe mode
88
+ });
89
+ });
90
+
91
+ describe("finishTranscribeButton slot", () => {
92
+ it("should apply tailwind class string to finishTranscribeButton", () => {
93
+ const { container } = render(
94
+ <TestWrapper>
95
+ <CopilotChatInput
96
+ mode="transcribe"
97
+ onFinishTranscribe={() => {}}
98
+ finishTranscribeButton="bg-purple-500"
99
+ />
100
+ </TestWrapper>,
101
+ );
102
+
103
+ const finishBtn = container.querySelector(".bg-purple-500");
104
+ // Button appears in transcribe mode
105
+ });
106
+ });
107
+
108
+ describe("addMenuButton slot", () => {
109
+ it("should apply tailwind class string to addMenuButton", () => {
110
+ const { container } = render(
111
+ <TestWrapper>
112
+ <CopilotChatInput
113
+ toolsMenu={[{ label: "Test", action: () => {} }]}
114
+ addMenuButton="bg-yellow-500"
115
+ />
116
+ </TestWrapper>,
117
+ );
118
+
119
+ const addBtn = container.querySelector(".bg-yellow-500");
120
+ // Button appears when toolsMenu is provided
121
+ });
122
+ });
123
+
124
+ describe("audioRecorder slot", () => {
125
+ it("should apply tailwind class string to audioRecorder", () => {
126
+ const { container } = render(
127
+ <TestWrapper>
128
+ <CopilotChatInput
129
+ mode="transcribe"
130
+ audioRecorder="border-dashed border-2"
131
+ />
132
+ </TestWrapper>,
133
+ );
134
+
135
+ const recorder = container.querySelector(".border-dashed");
136
+ // Recorder appears in transcribe mode
137
+ });
138
+ });
139
+ });
140
+
141
+ // ============================================================================
142
+ // 2. PROPERTIES (onClick, etc.) TESTS
143
+ // ============================================================================
144
+ describe("2. Properties Slot Override", () => {
145
+ describe("textArea props", () => {
146
+ it("should pass placeholder prop to textArea", async () => {
147
+ render(
148
+ <TestWrapper>
149
+ <CopilotChatInput
150
+ textArea={{ placeholder: "Custom placeholder..." }}
151
+ />
152
+ </TestWrapper>,
153
+ );
154
+
155
+ const textarea = await screen.findByPlaceholderText(
156
+ "Custom placeholder...",
157
+ );
158
+ expect(textarea).toBeDefined();
159
+ });
160
+
161
+ it("should pass disabled prop to textArea", () => {
162
+ render(
163
+ <TestWrapper>
164
+ <CopilotChatInput
165
+ textArea={
166
+ { disabled: true, "data-testid": "disabled-textarea" } as any
167
+ }
168
+ />
169
+ </TestWrapper>,
170
+ );
171
+
172
+ const textarea = screen.queryByTestId("disabled-textarea");
173
+ if (textarea) {
174
+ expect(textarea.hasAttribute("disabled")).toBe(true);
175
+ }
176
+ });
177
+
178
+ it("should pass onKeyDown prop to textArea", async () => {
179
+ const handleKeyDown = vi.fn();
180
+
181
+ render(
182
+ <TestWrapper>
183
+ <CopilotChatInput textArea={{ onKeyDown: handleKeyDown }} />
184
+ </TestWrapper>,
185
+ );
186
+
187
+ const textarea = await screen.findByRole("textbox");
188
+ fireEvent.keyDown(textarea, { key: "a" });
189
+ // Handler should be called
190
+ });
191
+
192
+ it("should pass autoFocus prop to textArea", () => {
193
+ render(
194
+ <TestWrapper>
195
+ <CopilotChatInput textArea={{ autoFocus: true }} />
196
+ </TestWrapper>,
197
+ );
198
+
199
+ const textarea = document.querySelector("textarea");
200
+ // autoFocus behavior may vary
201
+ });
202
+ });
203
+
204
+ describe("sendButton props", () => {
205
+ it("should pass onClick handler to sendButton", () => {
206
+ const handleClick = vi.fn();
207
+
208
+ render(
209
+ <TestWrapper>
210
+ <CopilotChatInput
211
+ // Need to provide onSubmitMessage and value to enable the button, or override disabled
212
+ sendButton={
213
+ {
214
+ onClick: handleClick,
215
+ disabled: false,
216
+ "data-testid": "send-btn",
217
+ } as any
218
+ }
219
+ />
220
+ </TestWrapper>,
221
+ );
222
+
223
+ const sendBtn = screen.queryByTestId("send-btn");
224
+ if (sendBtn) {
225
+ fireEvent.click(sendBtn);
226
+ expect(handleClick).toHaveBeenCalled();
227
+ }
228
+ });
229
+
230
+ it("should pass disabled prop to sendButton", () => {
231
+ render(
232
+ <TestWrapper>
233
+ <CopilotChatInput
234
+ sendButton={
235
+ { disabled: true, "data-testid": "disabled-send" } as any
236
+ }
237
+ />
238
+ </TestWrapper>,
239
+ );
240
+
241
+ const sendBtn = screen.queryByTestId("disabled-send");
242
+ if (sendBtn) {
243
+ expect(sendBtn.hasAttribute("disabled")).toBe(true);
244
+ }
245
+ });
246
+
247
+ it("should pass aria-label prop to sendButton", () => {
248
+ render(
249
+ <TestWrapper>
250
+ <CopilotChatInput sendButton={{ "aria-label": "Submit message" }} />
251
+ </TestWrapper>,
252
+ );
253
+
254
+ const sendBtn = document.querySelector("[aria-label='Submit message']");
255
+ expect(sendBtn).toBeDefined();
256
+ });
257
+ });
258
+
259
+ describe("addMenuButton props", () => {
260
+ it("should pass onClick handler to addMenuButton", () => {
261
+ const handleClick = vi.fn();
262
+
263
+ render(
264
+ <TestWrapper>
265
+ <CopilotChatInput
266
+ toolsMenu={[{ label: "Item", action: () => {} }]}
267
+ addMenuButton={
268
+ { onClick: handleClick, "data-testid": "add-menu" } as any
269
+ }
270
+ />
271
+ </TestWrapper>,
272
+ );
273
+
274
+ const addBtn = screen.queryByTestId("add-menu");
275
+ if (addBtn) {
276
+ fireEvent.click(addBtn);
277
+ }
278
+ });
279
+ });
280
+
281
+ describe("user props override pre-set props", () => {
282
+ it("user disabled should override default disabled state", () => {
283
+ render(
284
+ <TestWrapper>
285
+ <CopilotChatInput
286
+ sendButton={
287
+ { disabled: false, "data-testid": "override-send" } as any
288
+ }
289
+ />
290
+ </TestWrapper>,
291
+ );
292
+
293
+ const sendBtn = screen.queryByTestId("override-send");
294
+ // User's disabled=false should take effect
295
+ });
296
+ });
297
+ });
298
+
299
+ // ============================================================================
300
+ // 3. CUSTOM COMPONENT TESTS
301
+ // ============================================================================
302
+ describe("3. Custom Component Slot Override", () => {
303
+ describe("textArea custom component", () => {
304
+ it("should render custom textArea component", () => {
305
+ const CustomTextArea = React.forwardRef<HTMLTextAreaElement, any>(
306
+ ({ value, onChange, ...props }, ref) => (
307
+ <textarea
308
+ ref={ref}
309
+ data-testid="custom-textarea"
310
+ value={value}
311
+ onChange={(e) => onChange?.(e.target.value)}
312
+ className="custom-input"
313
+ {...props}
314
+ />
315
+ ),
316
+ );
317
+
318
+ render(
319
+ <TestWrapper>
320
+ <CopilotChatInput textArea={CustomTextArea} />
321
+ </TestWrapper>,
322
+ );
323
+
324
+ expect(screen.getByTestId("custom-textarea")).toBeDefined();
325
+ });
326
+
327
+ it("custom textArea should receive value and onChange props", () => {
328
+ let receivedValue: string | undefined;
329
+ let receivedOnChange: any;
330
+
331
+ const CustomTextArea = React.forwardRef<HTMLTextAreaElement, any>(
332
+ ({ value, onChange, ...props }, ref) => {
333
+ receivedValue = value;
334
+ receivedOnChange = onChange;
335
+ return (
336
+ <textarea
337
+ ref={ref}
338
+ data-testid="value-check-textarea"
339
+ value={value || ""}
340
+ onChange={(e) => onChange?.(e.target.value)}
341
+ {...props}
342
+ />
343
+ );
344
+ },
345
+ );
346
+
347
+ render(
348
+ <TestWrapper>
349
+ <CopilotChatInput
350
+ textArea={CustomTextArea}
351
+ value="test value"
352
+ onChange={() => {}}
353
+ />
354
+ </TestWrapper>,
355
+ );
356
+
357
+ expect(receivedValue).toBe("test value");
358
+ expect(receivedOnChange).toBeDefined();
359
+ });
360
+ });
361
+
362
+ describe("sendButton custom component", () => {
363
+ it("should render custom sendButton component", () => {
364
+ const CustomSendButton: React.FC<any> = ({ onClick, disabled }) => (
365
+ <button
366
+ data-testid="custom-send"
367
+ onClick={onClick}
368
+ disabled={disabled}
369
+ >
370
+ 🚀 Send Message
371
+ </button>
372
+ );
373
+
374
+ render(
375
+ <TestWrapper>
376
+ <CopilotChatInput sendButton={CustomSendButton} />
377
+ </TestWrapper>,
378
+ );
379
+
380
+ expect(screen.getByTestId("custom-send")).toBeDefined();
381
+ expect(screen.getByText("🚀 Send Message")).toBeDefined();
382
+ });
383
+
384
+ it("custom sendButton should receive onClick callback", () => {
385
+ const submitHandler = vi.fn();
386
+
387
+ const CustomSendButton: React.FC<any> = ({ onClick }) => (
388
+ <button data-testid="onclick-send" onClick={onClick}>
389
+ Send
390
+ </button>
391
+ );
392
+
393
+ render(
394
+ <TestWrapper>
395
+ <CopilotChatInput
396
+ sendButton={CustomSendButton}
397
+ onSubmitMessage={submitHandler}
398
+ />
399
+ </TestWrapper>,
400
+ );
401
+
402
+ fireEvent.click(screen.getByTestId("onclick-send"));
403
+ // onClick should trigger submission flow
404
+ });
405
+ });
406
+
407
+ describe("startTranscribeButton custom component", () => {
408
+ it("should render custom startTranscribeButton component", () => {
409
+ const CustomStart: React.FC<any> = ({ onClick }) => (
410
+ <button data-testid="custom-start-transcribe" onClick={onClick}>
411
+ 🎤 Start Recording
412
+ </button>
413
+ );
414
+
415
+ render(
416
+ <TestWrapper>
417
+ <CopilotChatInput
418
+ onStartTranscribe={() => {}}
419
+ startTranscribeButton={CustomStart}
420
+ />
421
+ </TestWrapper>,
422
+ );
423
+
424
+ const btn = screen.queryByTestId("custom-start-transcribe");
425
+ if (btn) {
426
+ expect(btn.textContent).toContain("Start Recording");
427
+ }
428
+ });
429
+ });
430
+
431
+ describe("cancelTranscribeButton custom component", () => {
432
+ it("should render custom cancelTranscribeButton component", () => {
433
+ const CustomCancel: React.FC<any> = ({ onClick }) => (
434
+ <button data-testid="custom-cancel-transcribe" onClick={onClick}>
435
+ ❌ Cancel
436
+ </button>
437
+ );
438
+
439
+ render(
440
+ <TestWrapper>
441
+ <CopilotChatInput
442
+ mode="transcribe"
443
+ onCancelTranscribe={() => {}}
444
+ cancelTranscribeButton={CustomCancel}
445
+ />
446
+ </TestWrapper>,
447
+ );
448
+
449
+ const btn = screen.queryByTestId("custom-cancel-transcribe");
450
+ if (btn) {
451
+ expect(btn.textContent).toContain("Cancel");
452
+ }
453
+ });
454
+ });
455
+
456
+ describe("finishTranscribeButton custom component", () => {
457
+ it("should render custom finishTranscribeButton component", () => {
458
+ const CustomFinish: React.FC<any> = ({ onClick }) => (
459
+ <button data-testid="custom-finish-transcribe" onClick={onClick}>
460
+ ✓ Done
461
+ </button>
462
+ );
463
+
464
+ render(
465
+ <TestWrapper>
466
+ <CopilotChatInput
467
+ mode="transcribe"
468
+ onFinishTranscribe={() => {}}
469
+ finishTranscribeButton={CustomFinish}
470
+ />
471
+ </TestWrapper>,
472
+ );
473
+
474
+ const btn = screen.queryByTestId("custom-finish-transcribe");
475
+ if (btn) {
476
+ expect(btn.textContent).toContain("Done");
477
+ }
478
+ });
479
+ });
480
+
481
+ describe("addMenuButton custom component", () => {
482
+ it("should render custom addMenuButton component", () => {
483
+ const CustomAddMenu: React.FC<any> = ({ onClick }) => (
484
+ <button data-testid="custom-add-menu" onClick={onClick}>
485
+ ➕ Add
486
+ </button>
487
+ );
488
+
489
+ render(
490
+ <TestWrapper>
491
+ <CopilotChatInput
492
+ toolsMenu={[{ label: "Tool", action: () => {} }]}
493
+ addMenuButton={CustomAddMenu}
494
+ />
495
+ </TestWrapper>,
496
+ );
497
+
498
+ const btn = screen.queryByTestId("custom-add-menu");
499
+ if (btn) {
500
+ expect(btn.textContent).toContain("Add");
501
+ }
502
+ });
503
+ });
504
+
505
+ describe("audioRecorder custom component", () => {
506
+ it("should render custom audioRecorder component", () => {
507
+ const CustomRecorder: React.FC<any> = ({ onAudioReady }) => (
508
+ <div data-testid="custom-recorder">
509
+ <button onClick={() => onAudioReady?.(new Blob())}>
510
+ Custom Recorder
511
+ </button>
512
+ </div>
513
+ );
514
+
515
+ render(
516
+ <TestWrapper>
517
+ <CopilotChatInput
518
+ mode="transcribe"
519
+ onFinishTranscribeWithAudio={async () => {}}
520
+ audioRecorder={CustomRecorder}
521
+ />
522
+ </TestWrapper>,
523
+ );
524
+
525
+ const recorder = screen.queryByTestId("custom-recorder");
526
+ if (recorder) {
527
+ expect(recorder.textContent).toContain("Custom Recorder");
528
+ }
529
+ });
530
+ });
531
+
532
+ describe("multiple custom components", () => {
533
+ it("should render multiple custom components together", () => {
534
+ const CustomTextArea = React.forwardRef<HTMLTextAreaElement, any>(
535
+ (props, ref) => (
536
+ <textarea ref={ref} data-testid="multi-textarea" {...props} />
537
+ ),
538
+ );
539
+
540
+ const CustomSendButton: React.FC<any> = (props) => (
541
+ <button data-testid="multi-send" {...props}>
542
+ Send
543
+ </button>
544
+ );
545
+
546
+ render(
547
+ <TestWrapper>
548
+ <CopilotChatInput
549
+ textArea={CustomTextArea}
550
+ sendButton={CustomSendButton}
551
+ />
552
+ </TestWrapper>,
553
+ );
554
+
555
+ expect(screen.getByTestId("multi-textarea")).toBeDefined();
556
+ expect(screen.getByTestId("multi-send")).toBeDefined();
557
+ });
558
+ });
559
+ });
560
+
561
+ // ============================================================================
562
+ // 4. RECURSIVE DRILL-DOWN TESTS (Input has no sub-slots, but test nested props)
563
+ // ============================================================================
564
+ describe("4. Nested Props and Complex Configurations", () => {
565
+ describe("complex textArea configuration", () => {
566
+ it("should support complex props configuration", () => {
567
+ render(
568
+ <TestWrapper>
569
+ <CopilotChatInput
570
+ textArea={
571
+ {
572
+ className: "complex-textarea",
573
+ placeholder: "Complex placeholder",
574
+ "data-testid": "complex-ta",
575
+ rows: 4,
576
+ } as any
577
+ }
578
+ />
579
+ </TestWrapper>,
580
+ );
581
+
582
+ const textarea = screen.queryByTestId("complex-ta");
583
+ if (textarea) {
584
+ expect(textarea.getAttribute("placeholder")).toBe(
585
+ "Complex placeholder",
586
+ );
587
+ }
588
+ });
589
+ });
590
+
591
+ describe("complex sendButton configuration", () => {
592
+ it("should support complex props on sendButton", () => {
593
+ render(
594
+ <TestWrapper>
595
+ <CopilotChatInput
596
+ sendButton={
597
+ {
598
+ className: "complex-send",
599
+ "data-testid": "complex-send-btn",
600
+ "aria-label": "Send your message",
601
+ title: "Click to send",
602
+ } as any
603
+ }
604
+ />
605
+ </TestWrapper>,
606
+ );
607
+
608
+ const btn = screen.queryByTestId("complex-send-btn");
609
+ if (btn) {
610
+ expect(btn.getAttribute("aria-label")).toBe("Send your message");
611
+ expect(btn.getAttribute("title")).toBe("Click to send");
612
+ }
613
+ });
614
+ });
615
+ });
616
+
617
+ // ============================================================================
618
+ // 5. CLASSNAME OVERRIDE TESTS
619
+ // ============================================================================
620
+ describe("5. className Override with Tailwind", () => {
621
+ describe("className prop in object slots", () => {
622
+ it("should allow className prop in textArea object slot", () => {
623
+ const { container } = render(
624
+ <TestWrapper>
625
+ <CopilotChatInput
626
+ textArea={{ className: "textarea-class-override" }}
627
+ />
628
+ </TestWrapper>,
629
+ );
630
+
631
+ expect(
632
+ container.querySelector(".textarea-class-override"),
633
+ ).toBeDefined();
634
+ });
635
+
636
+ it("should allow className prop in sendButton object slot", () => {
637
+ const { container } = render(
638
+ <TestWrapper>
639
+ <CopilotChatInput
640
+ sendButton={{ className: "send-class-override" }}
641
+ />
642
+ </TestWrapper>,
643
+ );
644
+
645
+ expect(container.querySelector(".send-class-override")).toBeDefined();
646
+ });
647
+ });
648
+
649
+ describe("string slot vs className prop equivalence", () => {
650
+ it("string slot should set className on textArea", () => {
651
+ const { container } = render(
652
+ <TestWrapper>
653
+ <CopilotChatInput textArea="string-class-textarea" />
654
+ </TestWrapper>,
655
+ );
656
+
657
+ expect(container.querySelector(".string-class-textarea")).toBeDefined();
658
+ });
659
+
660
+ it("string slot should set className on sendButton", () => {
661
+ const { container } = render(
662
+ <TestWrapper>
663
+ <CopilotChatInput sendButton="string-class-send" />
664
+ </TestWrapper>,
665
+ );
666
+
667
+ expect(container.querySelector(".string-class-send")).toBeDefined();
668
+ });
669
+ });
670
+
671
+ describe("tailwind utility classes", () => {
672
+ it("should apply tailwind focus utilities to textArea", () => {
673
+ const { container } = render(
674
+ <TestWrapper>
675
+ <CopilotChatInput textArea="focus:ring-2 focus:ring-blue-500 focus:outline-none" />
676
+ </TestWrapper>,
677
+ );
678
+
679
+ const el = container.querySelector(".focus\\:ring-2");
680
+ expect(el).toBeDefined();
681
+ });
682
+
683
+ it("should apply tailwind hover utilities to sendButton", () => {
684
+ const { container } = render(
685
+ <TestWrapper>
686
+ <CopilotChatInput sendButton="hover:bg-blue-600 active:bg-blue-700" />
687
+ </TestWrapper>,
688
+ );
689
+
690
+ const el = container.querySelector(".hover\\:bg-blue-600");
691
+ expect(el).toBeDefined();
692
+ });
693
+ });
694
+ });
695
+
696
+ // ============================================================================
697
+ // 6. CHILDREN RENDER FUNCTION TESTS
698
+ // ============================================================================
699
+ describe("6. Children Render Function", () => {
700
+ it("should support children render function for custom layout", () => {
701
+ render(
702
+ <TestWrapper>
703
+ <CopilotChatInput>
704
+ {({ textArea, sendButton }) => (
705
+ <div data-testid="custom-input-layout">
706
+ <div className="input-row">
707
+ {textArea}
708
+ {sendButton}
709
+ </div>
710
+ </div>
711
+ )}
712
+ </CopilotChatInput>
713
+ </TestWrapper>,
714
+ );
715
+
716
+ expect(screen.getByTestId("custom-input-layout")).toBeDefined();
717
+ });
718
+
719
+ it("children render function should receive all slot elements", () => {
720
+ const receivedKeys: string[] = [];
721
+
722
+ render(
723
+ <TestWrapper>
724
+ <CopilotChatInput>
725
+ {(slots) => {
726
+ receivedKeys.push(...Object.keys(slots));
727
+ return <div data-testid="slots-check">Rendered</div>;
728
+ }}
729
+ </CopilotChatInput>
730
+ </TestWrapper>,
731
+ );
732
+
733
+ expect(screen.getByTestId("slots-check")).toBeDefined();
734
+ // Should receive textArea, sendButton, etc.
735
+ });
736
+
737
+ it("children render function allows complete layout control", () => {
738
+ render(
739
+ <TestWrapper>
740
+ <CopilotChatInput toolsMenu={[{ label: "Tool", action: () => {} }]}>
741
+ {({ textArea, sendButton, addMenuButton }) => (
742
+ <div data-testid="full-control-layout">
743
+ <div className="toolbar">{addMenuButton}</div>
744
+ <div className="main">{textArea}</div>
745
+ <div className="actions">{sendButton}</div>
746
+ </div>
747
+ )}
748
+ </CopilotChatInput>
749
+ </TestWrapper>,
750
+ );
751
+
752
+ expect(screen.getByTestId("full-control-layout")).toBeDefined();
753
+ expect(document.querySelector(".toolbar")).toBeDefined();
754
+ expect(document.querySelector(".main")).toBeDefined();
755
+ expect(document.querySelector(".actions")).toBeDefined();
756
+ });
757
+ });
758
+
759
+ // ============================================================================
760
+ // 7. POSITIONING PROP TESTS
761
+ // ============================================================================
762
+ describe("7. Positioning Prop", () => {
763
+ it("should render static positioning by default", () => {
764
+ const { container } = render(
765
+ <TestWrapper>
766
+ <CopilotChatInput data-testid="input-container" />
767
+ </TestWrapper>,
768
+ );
769
+
770
+ // By default (static), should NOT have absolute positioning classes
771
+ const inputContainer = container.querySelector(
772
+ '[data-testid="input-container"]',
773
+ ) as HTMLElement;
774
+ expect(inputContainer).not.toBeNull();
775
+ expect(inputContainer.classList.contains("cpk:absolute")).toBe(false);
776
+ });
777
+
778
+ it("should render absolute positioning when positioning='absolute'", () => {
779
+ const { container } = render(
780
+ <TestWrapper>
781
+ <CopilotChatInput
782
+ positioning="absolute"
783
+ data-testid="absolute-input"
784
+ />
785
+ </TestWrapper>,
786
+ );
787
+
788
+ const inputContainer = container.querySelector(
789
+ '[data-testid="absolute-input"]',
790
+ ) as HTMLElement;
791
+ expect(inputContainer).not.toBeNull();
792
+ expect(inputContainer.classList.contains("cpk:absolute")).toBe(true);
793
+ expect(inputContainer.classList.contains("cpk:bottom-0")).toBe(true);
794
+ });
795
+
796
+ it("should apply keyboard height transform", () => {
797
+ const { container } = render(
798
+ <TestWrapper>
799
+ <CopilotChatInput
800
+ positioning="absolute"
801
+ keyboardHeight={300}
802
+ data-testid="keyboard-input"
803
+ />
804
+ </TestWrapper>,
805
+ );
806
+
807
+ const inputContainer = container.querySelector(
808
+ '[data-testid="keyboard-input"]',
809
+ ) as HTMLElement;
810
+ expect(inputContainer).not.toBeNull();
811
+ expect(inputContainer.style.transform).toBe("translateY(-300px)");
812
+ });
813
+
814
+ it("should forward containerRef", () => {
815
+ let containerRef: HTMLDivElement | null = null;
816
+ const RefCapture = () => {
817
+ const ref = React.useRef<HTMLDivElement>(null);
818
+ React.useEffect(() => {
819
+ containerRef = ref.current;
820
+ }, []);
821
+ return (
822
+ <TestWrapper>
823
+ <CopilotChatInput containerRef={ref} />
824
+ </TestWrapper>
825
+ );
826
+ };
827
+
828
+ render(<RefCapture />);
829
+ expect(containerRef).not.toBeNull();
830
+ });
831
+ });
832
+
833
+ // ============================================================================
834
+ // 8. DISCLAIMER SLOT TESTS
835
+ // ============================================================================
836
+ describe("8. Disclaimer Slot", () => {
837
+ it("should render disclaimer when showDisclaimer=true", () => {
838
+ render(
839
+ <TestWrapper>
840
+ <CopilotChatInput showDisclaimer={true} />
841
+ </TestWrapper>,
842
+ );
843
+
844
+ // Look for disclaimer text (from labels)
845
+ expect(
846
+ screen.queryByText(/AI-generated responses/i) ||
847
+ document.querySelector('[class*="text-muted-foreground"]'),
848
+ ).toBeDefined();
849
+ });
850
+
851
+ it("should hide disclaimer when showDisclaimer=false", () => {
852
+ const { container } = render(
853
+ <TestWrapper>
854
+ <CopilotChatInput showDisclaimer={false} />
855
+ </TestWrapper>,
856
+ );
857
+
858
+ // Disclaimer should not be rendered
859
+ const disclaimer = container.querySelector(
860
+ '[class*="text-center"][class*="text-xs"]',
861
+ );
862
+ expect(disclaimer).toBeNull();
863
+ });
864
+
865
+ it("should show disclaimer by default with absolute positioning", () => {
866
+ const { container } = render(
867
+ <TestWrapper>
868
+ <CopilotChatInput positioning="absolute" />
869
+ </TestWrapper>,
870
+ );
871
+
872
+ // Disclaimer should be present with absolute positioning (default showDisclaimer=true)
873
+ const disclaimer = container.querySelector(
874
+ '[class*="text-center"][class*="text-xs"]',
875
+ );
876
+ expect(disclaimer).not.toBeNull();
877
+ });
878
+
879
+ it("should hide disclaimer by default with static positioning", () => {
880
+ const { container } = render(
881
+ <TestWrapper>
882
+ <CopilotChatInput positioning="static" />
883
+ </TestWrapper>,
884
+ );
885
+
886
+ // Disclaimer should NOT be present with static positioning (default showDisclaimer=false)
887
+ const disclaimer = container.querySelector(
888
+ '[class*="text-center"][class*="text-xs"]',
889
+ );
890
+ expect(disclaimer).toBeNull();
891
+ });
892
+
893
+ it("should apply tailwind class to disclaimer", () => {
894
+ const { container } = render(
895
+ <TestWrapper>
896
+ <CopilotChatInput
897
+ showDisclaimer={true}
898
+ disclaimer="text-red-500 italic"
899
+ />
900
+ </TestWrapper>,
901
+ );
902
+
903
+ const disclaimer = container.querySelector(".text-red-500");
904
+ if (disclaimer) {
905
+ expect(disclaimer.classList.contains("italic")).toBe(true);
906
+ }
907
+ });
908
+
909
+ it("should render custom disclaimer component", () => {
910
+ const CustomDisclaimer: React.FC<any> = () => (
911
+ <div data-testid="custom-disclaimer">Custom Disclaimer Content</div>
912
+ );
913
+
914
+ render(
915
+ <TestWrapper>
916
+ <CopilotChatInput
917
+ showDisclaimer={true}
918
+ disclaimer={CustomDisclaimer}
919
+ />
920
+ </TestWrapper>,
921
+ );
922
+
923
+ const disclaimer = screen.queryByTestId("custom-disclaimer");
924
+ if (disclaimer) {
925
+ expect(disclaimer.textContent).toContain("Custom Disclaimer");
926
+ }
927
+ });
928
+ });
929
+ });