@golba98/codexa 1.0.1 → 1.0.3

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 (234) hide show
  1. package/README.md +391 -94
  2. package/package.json +14 -8
  3. package/src/app.tsx +196 -63
  4. package/src/commands/handler.ts +9 -4
  5. package/src/config/buildInfo.ts +3 -0
  6. package/src/config/launchArgs.ts +10 -0
  7. package/src/config/layeredConfig.ts +0 -0
  8. package/src/config/persistence.ts +51 -0
  9. package/src/config/runtimeConfig.ts +4 -0
  10. package/src/config/settings.ts +6 -13
  11. package/src/config/toml-serialize.ts +0 -0
  12. package/src/config/trustStore.ts +0 -0
  13. package/src/config/updateCheckCache.ts +63 -0
  14. package/src/core/attachments.ts +0 -0
  15. package/src/core/auth/codexAuth.ts +0 -0
  16. package/src/core/channel.ts +23 -0
  17. package/src/core/cleanupFastFail.ts +0 -0
  18. package/src/core/clipboard.ts +0 -0
  19. package/src/core/codex.ts +0 -0
  20. package/src/core/codexExecArgs.ts +0 -0
  21. package/src/core/codexLaunch.ts +0 -0
  22. package/src/core/codexPrompt.ts +0 -0
  23. package/src/core/executables/claudeExecutable.ts +0 -0
  24. package/src/core/executables/codexExecutable.ts +1 -0
  25. package/src/core/executables/executableResolver.ts +61 -43
  26. package/src/core/executables/geminiExecutable.ts +0 -0
  27. package/src/core/githubDiagnostics.ts +0 -0
  28. package/src/core/hollowResponseFormat.ts +0 -0
  29. package/src/core/inputDebug.ts +0 -0
  30. package/src/core/launchContext.ts +33 -33
  31. package/src/core/models/codexCapabilities.ts +0 -0
  32. package/src/core/models/codexModelCapabilities.ts +0 -0
  33. package/src/core/models/modelSpecs.ts +0 -0
  34. package/src/core/perf/profiler.ts +0 -0
  35. package/src/core/perf/renderDebug.ts +0 -0
  36. package/src/core/planStorage.ts +0 -0
  37. package/src/core/process/CommandRunner.ts +0 -0
  38. package/src/core/process/processValidation.ts +9 -5
  39. package/src/core/projectInstructions.ts +0 -0
  40. package/src/core/providerLauncher/launcher.ts +59 -42
  41. package/src/core/providerLauncher/registry.ts +0 -0
  42. package/src/core/providerLauncher/types.ts +0 -0
  43. package/src/core/providerLauncher/workspaceConfig.ts +0 -0
  44. package/src/core/providerRuntime/anthropic.ts +0 -0
  45. package/src/core/providerRuntime/capabilityProfile.ts +0 -0
  46. package/src/core/providerRuntime/claudeCodeDiscovery.ts +0 -0
  47. package/src/core/providerRuntime/contextMetadata.ts +0 -0
  48. package/src/core/providerRuntime/gemini.ts +0 -0
  49. package/src/core/providerRuntime/lmstudio.ts +0 -0
  50. package/src/core/providerRuntime/local.ts +0 -0
  51. package/src/core/providerRuntime/models.ts +0 -0
  52. package/src/core/providerRuntime/reasoning.ts +0 -0
  53. package/src/core/providerRuntime/registry.ts +0 -0
  54. package/src/core/providerRuntime/types.ts +0 -0
  55. package/src/core/providers/codexJsonStream.ts +0 -0
  56. package/src/core/providers/codexSubprocess.ts +0 -0
  57. package/src/core/providers/codexTranscript.ts +0 -0
  58. package/src/core/providers/openaiNative.ts +0 -0
  59. package/src/core/providers/registry.ts +0 -0
  60. package/src/core/providers/types.ts +0 -0
  61. package/src/core/terminal/startupClear.ts +20 -0
  62. package/src/core/terminal/terminalCapabilities.ts +0 -0
  63. package/src/core/terminal/terminalControl.ts +0 -0
  64. package/src/core/terminal/terminalSanitize.ts +0 -0
  65. package/src/core/terminal/terminalSelection.ts +0 -0
  66. package/src/core/terminal/terminalTitle.ts +0 -0
  67. package/src/core/updateCheck.ts +188 -0
  68. package/src/core/workspaceActivity.ts +0 -0
  69. package/src/core/workspaceGuard.ts +0 -0
  70. package/src/core/workspaceRoot.ts +0 -0
  71. package/src/exec.ts +0 -0
  72. package/src/headless/execArgs.ts +1 -0
  73. package/src/headless/execRunner.ts +0 -0
  74. package/src/index.tsx +13 -9
  75. package/src/session/appSession.ts +0 -0
  76. package/src/session/chatLifecycle.ts +0 -0
  77. package/src/session/liveRenderScheduler.ts +0 -0
  78. package/src/session/planFlow.ts +0 -0
  79. package/src/session/planTranscript.ts +0 -0
  80. package/src/session/promptRunSchedule.ts +0 -0
  81. package/src/session/types.ts +2 -1
  82. package/src/test/runtimeTestUtils.ts +0 -0
  83. package/src/types/react-dom.d.ts +0 -0
  84. package/src/ui/ActionRequiredBlock.tsx +5 -5
  85. package/src/ui/ActivityBars.tsx +3 -3
  86. package/src/ui/ActivityIndicator.tsx +6 -6
  87. package/src/ui/AgentBlock.tsx +6 -6
  88. package/src/ui/AnimatedStatusText.tsx +1 -1
  89. package/src/ui/AppShell.tsx +13 -5
  90. package/src/ui/AttachmentImportPanel.tsx +8 -8
  91. package/src/ui/AuthPanel.tsx +20 -20
  92. package/src/ui/BackendPicker.tsx +0 -0
  93. package/src/ui/BottomComposer.tsx +117 -78
  94. package/src/ui/DashCard.tsx +3 -3
  95. package/src/ui/Markdown.tsx +17 -17
  96. package/src/ui/ModePicker.tsx +0 -0
  97. package/src/ui/ModelPicker.tsx +0 -0
  98. package/src/ui/ModelPickerScreen.tsx +10 -10
  99. package/src/ui/ModelReasoningPicker.tsx +14 -14
  100. package/src/ui/Panel.tsx +3 -3
  101. package/src/ui/PermissionsPanel.tsx +0 -0
  102. package/src/ui/PlanActionPicker.tsx +6 -6
  103. package/src/ui/PlanReviewPanel.tsx +8 -8
  104. package/src/ui/ProviderPicker.tsx +18 -18
  105. package/src/ui/ReasoningPicker.tsx +0 -0
  106. package/src/ui/RunFooter.tsx +3 -3
  107. package/src/ui/SelectionPanel.tsx +4 -4
  108. package/src/ui/SettingsPanel.tsx +8 -8
  109. package/src/ui/Spinner.tsx +1 -1
  110. package/src/ui/StaticIntroItem.tsx +0 -0
  111. package/src/ui/StaticTranscriptItem.tsx +0 -0
  112. package/src/ui/TextEntryPanel.tsx +10 -10
  113. package/src/ui/ThemePicker.tsx +0 -0
  114. package/src/ui/ThinkingBlock.tsx +8 -8
  115. package/src/ui/Timeline.tsx +21 -17
  116. package/src/ui/TopHeader.tsx +421 -257
  117. package/src/ui/TurnGroup.tsx +31 -31
  118. package/src/ui/UpdateAvailableCard.tsx +41 -0
  119. package/src/ui/UpdatePromptPanel.tsx +203 -0
  120. package/src/ui/busyStatusAnimation.ts +0 -0
  121. package/src/ui/commandNormalize.ts +0 -0
  122. package/src/ui/diffRenderer.ts +0 -0
  123. package/src/ui/focus.ts +3 -0
  124. package/src/ui/inputBuffer.ts +0 -0
  125. package/src/ui/layout.ts +1 -1
  126. package/src/ui/logoVariants.ts +107 -0
  127. package/src/ui/modeDisplay.ts +12 -12
  128. package/src/ui/outputPipeline.ts +0 -0
  129. package/src/ui/progressEntries.ts +0 -0
  130. package/src/ui/runActivityView.ts +0 -0
  131. package/src/ui/runtimeDisplay.ts +100 -0
  132. package/src/ui/slashCommands.ts +0 -0
  133. package/src/ui/terminalAnswerFormat.ts +0 -0
  134. package/src/ui/textLayout.ts +0 -0
  135. package/src/ui/theme.tsx +274 -395
  136. package/src/ui/themeFlow.ts +0 -0
  137. package/src/ui/timelineMeasure.ts +29 -19
  138. package/src/ui/useThrottledValue.ts +0 -0
  139. package/scripts/audit-codexa-capabilities.mjs +0 -466
  140. package/scripts/smoke-terminal-bench.mjs +0 -35
  141. package/src/appRenderStability.test.ts +0 -131
  142. package/src/commands/handler.test.ts +0 -643
  143. package/src/config/launchArgs.test.ts +0 -158
  144. package/src/config/layeredConfig.test.ts +0 -143
  145. package/src/config/persistence.test.ts +0 -110
  146. package/src/config/runtimeConfig.test.ts +0 -218
  147. package/src/config/settings.test.ts +0 -155
  148. package/src/config/trustStore.test.ts +0 -29
  149. package/src/core/attachments.test.ts +0 -155
  150. package/src/core/auth/codexAuth.test.ts +0 -68
  151. package/src/core/cleanupFastFail.test.ts +0 -76
  152. package/src/core/codexExecArgs.test.ts +0 -195
  153. package/src/core/codexLaunch.test.ts +0 -205
  154. package/src/core/codexPrompt.test.ts +0 -252
  155. package/src/core/executables/codexExecutable.test.ts +0 -212
  156. package/src/core/executables/executableResolver.test.ts +0 -129
  157. package/src/core/executables/geminiExecutable.test.ts +0 -116
  158. package/src/core/executables/pathSanityScan.test.ts +0 -47
  159. package/src/core/githubDiagnostics.test.ts +0 -92
  160. package/src/core/hollowResponseFormat.test.ts +0 -58
  161. package/src/core/launchContext.test.ts +0 -157
  162. package/src/core/models/codexCapabilities.test.ts +0 -45
  163. package/src/core/models/codexModelCapabilities.test.ts +0 -246
  164. package/src/core/models/modelSpecs.test.ts +0 -283
  165. package/src/core/perf/renderDebug.test.ts +0 -230
  166. package/src/core/planStorage.test.ts +0 -143
  167. package/src/core/process/CommandRunner.test.ts +0 -105
  168. package/src/core/projectInstructions.test.ts +0 -50
  169. package/src/core/providerLauncher/launcher.test.ts +0 -238
  170. package/src/core/providerLauncher/registry.test.ts +0 -324
  171. package/src/core/providerLauncher/workspaceConfig.test.ts +0 -638
  172. package/src/core/providerRuntime/anthropic.test.ts +0 -1120
  173. package/src/core/providerRuntime/capabilityProfile.test.ts +0 -311
  174. package/src/core/providerRuntime/contextMetadata.test.ts +0 -468
  175. package/src/core/providerRuntime/gemini.test.ts +0 -437
  176. package/src/core/providerRuntime/lmstudio.test.ts +0 -168
  177. package/src/core/providerRuntime/local.test.ts +0 -787
  178. package/src/core/providerRuntime/registry.test.ts +0 -233
  179. package/src/core/providers/codexJsonStream.test.ts +0 -148
  180. package/src/core/providers/codexSubprocess.test.ts +0 -68
  181. package/src/core/providers/codexTranscript.test.ts +0 -284
  182. package/src/core/terminal/terminalCapabilities.test.ts +0 -93
  183. package/src/core/terminal/terminalControl.test.ts +0 -75
  184. package/src/core/terminal/terminalSanitize.test.ts +0 -22
  185. package/src/core/terminal/terminalSelection.test.ts +0 -42
  186. package/src/core/terminal/terminalTitle.test.ts +0 -328
  187. package/src/core/workspaceActivity.test.ts +0 -163
  188. package/src/core/workspaceGuard.test.ts +0 -151
  189. package/src/core/workspaceRoot.test.ts +0 -23
  190. package/src/exec.test.ts +0 -13
  191. package/src/headless/execArgs.test.ts +0 -147
  192. package/src/headless/execRunner.test.ts +0 -434
  193. package/src/index.test.tsx +0 -618
  194. package/src/session/appSession.test.ts +0 -897
  195. package/src/session/chatLifecycle.test.ts +0 -64
  196. package/src/session/liveRenderScheduler.test.ts +0 -201
  197. package/src/session/planFlow.test.ts +0 -103
  198. package/src/session/planTranscript.test.ts +0 -65
  199. package/src/session/promptRunSchedule.test.ts +0 -36
  200. package/src/ui/ActivityIndicator.test.tsx +0 -58
  201. package/src/ui/AgentBlock.test.ts +0 -6
  202. package/src/ui/AnimatedStatusText.test.ts +0 -16
  203. package/src/ui/AppShell.test.tsx +0 -1739
  204. package/src/ui/AttachmentImportPanel.test.tsx +0 -204
  205. package/src/ui/BottomComposer.test.ts +0 -674
  206. package/src/ui/CodexLogo.tsx +0 -55
  207. package/src/ui/Markdown.test.ts +0 -157
  208. package/src/ui/ModelPickerProviderScope.test.tsx +0 -411
  209. package/src/ui/ModelPickerScreen.test.tsx +0 -99
  210. package/src/ui/ModelPickerState.test.tsx +0 -151
  211. package/src/ui/ModelReasoningPicker.test.tsx +0 -447
  212. package/src/ui/PlanReviewPanel.test.tsx +0 -267
  213. package/src/ui/PromptCardBorder.test.tsx +0 -161
  214. package/src/ui/ProviderPicker.test.tsx +0 -289
  215. package/src/ui/ProviderShortcut.test.tsx +0 -143
  216. package/src/ui/SettingsPanel.test.tsx +0 -233
  217. package/src/ui/Timeline.test.ts +0 -2067
  218. package/src/ui/TimelineNavigation.test.tsx +0 -201
  219. package/src/ui/TopHeader.test.tsx +0 -239
  220. package/src/ui/TurnGroup.test.tsx +0 -365
  221. package/src/ui/busyStatusAnimation.test.ts +0 -30
  222. package/src/ui/commandNormalize.test.ts +0 -142
  223. package/src/ui/diffRenderer.test.ts +0 -102
  224. package/src/ui/focusFlow.test.tsx +0 -1098
  225. package/src/ui/inputBuffer.test.ts +0 -151
  226. package/src/ui/layout.test.ts +0 -145
  227. package/src/ui/modeDisplay.test.ts +0 -42
  228. package/src/ui/runActivityView.test.ts +0 -89
  229. package/src/ui/runLifecycleView.test.tsx +0 -237
  230. package/src/ui/statusRenderIsolation.test.tsx +0 -654
  231. package/src/ui/terminalAnswerFormat.test.ts +0 -19
  232. package/src/ui/textLayout.test.ts +0 -18
  233. package/src/ui/themeFlow.test.ts +0 -53
  234. package/src/ui/timelineMeasureCache.test.ts +0 -986
@@ -1,618 +0,0 @@
1
- import assert from "node:assert/strict";
2
- import test from "node:test";
3
- import React from "react";
4
- import { EventEmitter } from "node:events";
5
- import { readFileSync } from "node:fs";
6
- import type { RenderOptions } from "ink";
7
- import { startApp } from "./index.js";
8
-
9
- const TITLE_SEQUENCE_PATTERN = /\x1b\](?:0|2);[^\x07]*(?:\x07|\x1b\\)/g;
10
-
11
- class MockStdout extends EventEmitter {
12
- isTTY = true;
13
- columns = 120;
14
- rows = 40;
15
- writes = "";
16
- clearCalls = 0;
17
-
18
- write(chunk: string): boolean {
19
- this.writes += chunk;
20
- return true;
21
- }
22
- }
23
-
24
- class MockStderr {
25
- writes = "";
26
-
27
- write(chunk: string): boolean {
28
- this.writes += chunk;
29
- return true;
30
- }
31
- }
32
-
33
- function flushMicrotasks(): Promise<void> {
34
- return new Promise((resolve) => setImmediate(resolve));
35
- }
36
-
37
- function createSupportedHarness(options: {
38
- inkInstance?: {
39
- lastOutput: string;
40
- lastOutputToRender: string;
41
- lastOutputHeight: number;
42
- calculateLayoutCalls: number;
43
- onRenderCalls: number;
44
- unsubscribeResizeCalls: number;
45
- throttledLogCancelCalls: number;
46
- rootOnRenderCancelCalls: number;
47
- onRenderCancelCalls: number;
48
- calculateLayout: () => void;
49
- onRender: (() => void) & { cancel: () => void };
50
- unsubscribeResize: () => void;
51
- throttledLog: { cancel: () => void };
52
- rootNode: { onRender: { cancel: () => void } };
53
- } | null;
54
- } = {}) {
55
- const stdout = new MockStdout();
56
- const stderr = new MockStderr();
57
- const registeredHandlers: Array<() => void> = [];
58
- let renderCalls = 0;
59
- let cleanupCalls = 0;
60
- let renderOptions: RenderOptions | undefined;
61
- let resolveExitPromise = () => {};
62
- const waitUntilExitPromise = new Promise<void>((resolve) => {
63
- resolveExitPromise = resolve;
64
- });
65
-
66
- return {
67
- stdout,
68
- stderr,
69
- registeredHandlers,
70
- getCleanupCalls: () => cleanupCalls,
71
- getRenderCalls: () => renderCalls,
72
- getRenderOptions: () => renderOptions,
73
- resolveExit() {
74
- resolveExitPromise();
75
- registeredHandlers[0]?.();
76
- },
77
- deps: {
78
- stdin: { isTTY: true },
79
- stdout,
80
- stderr,
81
- env: {},
82
- platform: "linux" as const,
83
- renderApp(_node: React.ReactElement, options?: RenderOptions) {
84
- renderCalls += 1;
85
- renderOptions = options;
86
- return {
87
- clear() {
88
- stdout.clearCalls += 1;
89
- },
90
- cleanup() {
91
- cleanupCalls += 1;
92
- },
93
- waitUntilExit() {
94
- return waitUntilExitPromise;
95
- },
96
- };
97
- },
98
- registerExitHandler(handler: () => void) {
99
- registeredHandlers.push(handler);
100
- },
101
- resolveInkInstanceForStdout() {
102
- return options.inkInstance ?? null;
103
- },
104
- },
105
- };
106
- }
107
-
108
- function createFakeInkInstance() {
109
- const fake = {
110
- lastOutput: "previous-frame",
111
- lastOutputToRender: "previous-frame-to-render",
112
- lastOutputHeight: 12,
113
- calculateLayoutCalls: 0,
114
- onRenderCalls: 0,
115
- unsubscribeResizeCalls: 0,
116
- throttledLogCancelCalls: 0,
117
- rootOnRenderCancelCalls: 0,
118
- onRenderCancelCalls: 0,
119
- calculateLayout() {
120
- fake.calculateLayoutCalls += 1;
121
- },
122
- onRender: Object.assign(
123
- () => {
124
- fake.onRenderCalls += 1;
125
- },
126
- {
127
- cancel() {
128
- fake.onRenderCancelCalls += 1;
129
- },
130
- },
131
- ),
132
- unsubscribeResize() {
133
- fake.unsubscribeResizeCalls += 1;
134
- },
135
- throttledLog: {
136
- cancel() {
137
- fake.throttledLogCancelCalls += 1;
138
- },
139
- },
140
- rootNode: {
141
- onRender: {
142
- cancel() {
143
- fake.rootOnRenderCancelCalls += 1;
144
- },
145
- },
146
- },
147
- };
148
-
149
- return fake;
150
- }
151
-
152
- test("strict VT mode refuses unsupported terminals without writing bracketed paste sequences", () => {
153
- let stdoutWrites = "";
154
- let stderrWrites = "";
155
- let renderCalled = false;
156
- let exitHandlerRegistered = false;
157
-
158
- const result = startApp({
159
- stdin: { isTTY: true },
160
- stdout: {
161
- isTTY: true,
162
- columns: 120,
163
- rows: 40,
164
- on() {
165
- return this;
166
- },
167
- off() {
168
- return this;
169
- },
170
- write(chunk: string) {
171
- stdoutWrites += chunk;
172
- return true;
173
- },
174
- },
175
- stderr: {
176
- write(chunk: string) {
177
- stderrWrites += chunk;
178
- return true;
179
- },
180
- },
181
- env: { CODEXA_REQUIRE_VT: "1" },
182
- platform: "win32",
183
- renderApp(_node: React.ReactElement) {
184
- renderCalled = true;
185
- return {
186
- clear() {},
187
- cleanup() {},
188
- waitUntilExit() {
189
- return Promise.resolve();
190
- },
191
- };
192
- },
193
- registerExitHandler() {
194
- exitHandlerRegistered = true;
195
- },
196
- });
197
-
198
- assert.deepEqual(result, { started: false, exitCode: 1 });
199
- assert.equal(renderCalled, false);
200
- assert.equal(exitHandlerRegistered, false);
201
- assert.equal(stdoutWrites, "");
202
- assert.doesNotMatch(stderrWrites, /\?2004[hl]/);
203
- assert.match(stderrWrites, /VT control sequences/i);
204
- });
205
-
206
- test("uncertain Windows VT support warns but continues without stdout probing", () => {
207
- let stdoutWrites = "";
208
- let stderrWrites = "";
209
- let renderCalled = false;
210
- const registeredHandlers: Array<() => void> = [];
211
-
212
- const result = startApp({
213
- stdin: { isTTY: true },
214
- stdout: {
215
- isTTY: true,
216
- columns: 120,
217
- rows: 40,
218
- on() {
219
- return this;
220
- },
221
- off() {
222
- return this;
223
- },
224
- write(chunk: string) {
225
- stdoutWrites += chunk;
226
- return true;
227
- },
228
- },
229
- stderr: {
230
- write(chunk: string) {
231
- stderrWrites += chunk;
232
- return true;
233
- },
234
- },
235
- env: {},
236
- platform: "win32",
237
- renderApp(_node: React.ReactElement) {
238
- renderCalled = true;
239
- return {
240
- clear() {},
241
- cleanup() {},
242
- waitUntilExit() {
243
- return Promise.resolve();
244
- },
245
- };
246
- },
247
- registerExitHandler(handler) {
248
- registeredHandlers.push(handler);
249
- },
250
- });
251
-
252
- assert.deepEqual(result, { started: true, exitCode: 0 });
253
- assert.equal(renderCalled, true);
254
- assert.match(stderrWrites, /will continue/i);
255
- assert.doesNotMatch(stdoutWrites, /\x1b(?:\[6n|\[>c|\[c|c)/);
256
-
257
- registeredHandlers[0]?.();
258
- });
259
-
260
- test("launch diagnostics report TTY state only behind debug flag", () => {
261
- let stderrWrites = "";
262
- let renderCalled = false;
263
- const registeredHandlers: Array<() => void> = [];
264
-
265
- const result = startApp({
266
- stdin: { isTTY: true },
267
- stdout: {
268
- isTTY: true,
269
- columns: 120,
270
- rows: 40,
271
- on() {
272
- return this;
273
- },
274
- off() {
275
- return this;
276
- },
277
- write() {
278
- return true;
279
- },
280
- },
281
- stderr: {
282
- isTTY: true,
283
- write(chunk: string) {
284
- stderrWrites += chunk;
285
- return true;
286
- },
287
- },
288
- env: { CODEXA_DEBUG_LAUNCH: "1", WT_SESSION: "test-session" },
289
- platform: "win32",
290
- argv: ["--model", "gpt-test"],
291
- renderApp(_node: React.ReactElement) {
292
- renderCalled = true;
293
- return {
294
- clear() {},
295
- cleanup() {},
296
- waitUntilExit() {
297
- return Promise.resolve();
298
- },
299
- };
300
- },
301
- registerExitHandler(handler) {
302
- registeredHandlers.push(handler);
303
- },
304
- });
305
-
306
- assert.deepEqual(result, { started: true, exitCode: 0 });
307
- assert.equal(renderCalled, true);
308
- assert.match(stderrWrites, /\[codexa:launch\]/);
309
- assert.match(stderrWrites, /"stdinIsTTY":true/);
310
- assert.match(stderrWrites, /"stdoutIsTTY":true/);
311
- assert.match(stderrWrites, /"stderrIsTTY":true/);
312
- registeredHandlers[0]?.();
313
- });
314
-
315
- test("enforces a single render root while active", async () => {
316
- const harness = createSupportedHarness();
317
-
318
- const first = startApp(harness.deps);
319
- const second = startApp(harness.deps);
320
-
321
- assert.deepEqual(first, { started: true, exitCode: 0 });
322
- assert.deepEqual(second, { started: true, exitCode: 0 });
323
- assert.equal(harness.getRenderCalls(), 1);
324
- assert.deepEqual(harness.getRenderOptions()?.kittyKeyboard, {
325
- mode: "auto",
326
- flags: ["disambiguateEscapeCodes"],
327
- });
328
-
329
- harness.resolveExit();
330
- await flushMicrotasks();
331
- });
332
-
333
- test("resize recovery preserves the viewport after invalid dimensions", async () => {
334
- const harness = createSupportedHarness();
335
-
336
- startApp(harness.deps);
337
- assert.equal(harness.stdout.clearCalls, 0);
338
-
339
- harness.stdout.columns = 1;
340
- harness.stdout.rows = 1;
341
- harness.stdout.emit("resize");
342
-
343
- harness.stdout.columns = 120;
344
- harness.stdout.rows = 40;
345
- harness.stdout.emit("resize");
346
-
347
- // onResize does not erase the viewport or scrollback.
348
- assert.equal(harness.stdout.clearCalls, 0);
349
- assert.doesNotMatch(harness.stdout.writes, /\x1b\[\?1000h/);
350
- assert.doesNotMatch(harness.stdout.writes, /\x1b\[\?1006h/);
351
- assert.match(harness.stdout.writes, /\x1b\[\?2004h/);
352
- const writesAfterStart = harness.stdout.writes.indexOf("\x1b[?2004h") + "\x1b[?2004h".length;
353
- assert.doesNotMatch(harness.stdout.writes.slice(writesAfterStart), /\x1b\[2J|\x1b\[3J/);
354
-
355
- // After the debounce fires, recovery still avoids clear() and ANSI clears.
356
- await new Promise((resolve) => setTimeout(resolve, 200));
357
- assert.equal(harness.stdout.clearCalls, 0);
358
- assert.doesNotMatch(harness.stdout.writes.slice(writesAfterStart), /\x1b\[2J|\x1b\[3J/);
359
-
360
- harness.resolveExit();
361
- await flushMicrotasks();
362
- });
363
-
364
- test("resize repaint does not erase terminal scrollback buffer", async () => {
365
- const harness = createSupportedHarness();
366
- startApp(harness.deps);
367
-
368
- // Startup clears only the visible viewport; native terminal scrollback must survive.
369
- assert.doesNotMatch(harness.stdout.writes, /\x1b\[3J/, "startup must not erase scrollback");
370
-
371
- // Capture offset so we can inspect only post-startup writes.
372
- const startupEnd = harness.stdout.writes.length;
373
-
374
- harness.stdout.columns = 80;
375
- harness.stdout.emit("resize");
376
-
377
- await new Promise((resolve) => setTimeout(resolve, 200));
378
-
379
- // Normal valid resize is a soft repaint and must not call Ink.clear().
380
- assert.equal(harness.stdout.clearCalls, 0, "normal resize must not call clear()");
381
-
382
- // Post-resize writes must not contain full/viewport clear sequences.
383
- const resizeWrites = harness.stdout.writes.slice(startupEnd);
384
- assert.doesNotMatch(resizeWrites, /\x1b\[3J/, "scrollback must not be erased on resize");
385
- assert.doesNotMatch(resizeWrites, /\x1b\[2J/, "normal resize must not clear the viewport");
386
-
387
- harness.resolveExit();
388
- await flushMicrotasks();
389
- });
390
-
391
- test("normal app render writes do not clear the terminal after startup", async () => {
392
- const harness = createSupportedHarness();
393
- startApp(harness.deps);
394
-
395
- const writesAfterStartup = harness.stdout.writes.slice(
396
- harness.stdout.writes.indexOf("\x1b[?2004h") + "\x1b[?2004h".length,
397
- );
398
- assert.equal(harness.stdout.clearCalls, 0);
399
- assert.doesNotMatch(harness.stdout.writes, /\x1b\[\?1000h|\x1b\[\?1006h/);
400
- assert.doesNotMatch(writesAfterStartup, /\x1b\[2J|\x1b\[3J/);
401
-
402
- harness.resolveExit();
403
- await flushMicrotasks();
404
- });
405
-
406
- test("startup writes safe fallback title before repaint and workspace title before Ink render setup", async () => {
407
- const harness = createSupportedHarness();
408
- startApp(harness.deps);
409
-
410
- const repaintIndex = harness.stdout.writes.indexOf("\x1b[2J\x1b[H");
411
- const firstTitleIndex = harness.stdout.writes.indexOf("\x1b]0;");
412
- const postRepaintTitleIndex = harness.stdout.writes.indexOf("\x1b]0;", repaintIndex + 1);
413
- const bracketedPasteIndex = harness.stdout.writes.indexOf("\x1b[?2004h");
414
-
415
- assert.ok(repaintIndex >= 0, "startup repaint should be written");
416
- assert.ok(firstTitleIndex >= 0, "fallback title should be written");
417
- assert.ok(firstTitleIndex < repaintIndex, "safe fallback title should be written before startup repaint");
418
- assert.ok(postRepaintTitleIndex > repaintIndex, "workspace title should be written after startup repaint");
419
- assert.ok(bracketedPasteIndex > postRepaintTitleIndex, "workspace title should be written before bracketed paste/render setup");
420
- assert.match(harness.stdout.writes, /\x1b\]0;[^\x07]+\x07\x1b\]2;[^\x07]+\x07/);
421
- assert.doesNotMatch(harness.stdout.writes, /\x1b\](?:0|2);[a-zA-Z]:[\\/]/);
422
-
423
- harness.resolveExit();
424
- await flushMicrotasks();
425
- });
426
-
427
- test("soft-repaints when resize occurs without invalid dimensions", async () => {
428
- const harness = createSupportedHarness();
429
- startApp(harness.deps);
430
-
431
- const writesBefore = harness.stdout.writes;
432
-
433
- // Emit a resize at valid dimensions (no invalid transition)
434
- harness.stdout.columns = 80;
435
- harness.stdout.emit("resize");
436
-
437
- // No writes happen immediately.
438
- const immediateWrites = harness.stdout.writes.slice(writesBefore.length);
439
- assert.equal(immediateWrites, "");
440
-
441
- // After debounce fires, valid resize still avoids terminal clear writes.
442
- await new Promise((resolve) => setTimeout(resolve, 200));
443
- assert.equal(harness.stdout.clearCalls, 0);
444
- const delayedWrites = harness.stdout.writes.slice(writesBefore.length);
445
- assert.doesNotMatch(delayedWrites, /\x1b\[2J|\x1b\[3J/);
446
-
447
- harness.resolveExit();
448
- await flushMicrotasks();
449
- });
450
-
451
- test("post-startup resize does not force Ink internals or blank cached output", async () => {
452
- const inkInstance = createFakeInkInstance();
453
- const harness = createSupportedHarness({ inkInstance });
454
- startApp(harness.deps);
455
-
456
- assert.equal(inkInstance.unsubscribeResizeCalls, 1, "startup still disables Ink's competing resize listener");
457
-
458
- const initialLastOutput = inkInstance.lastOutput;
459
- const initialLastOutputToRender = inkInstance.lastOutputToRender;
460
- const initialLastOutputHeight = inkInstance.lastOutputHeight;
461
- const startupEnd = harness.stdout.writes.length;
462
-
463
- harness.stdout.columns = 15;
464
- harness.stdout.rows = 8;
465
- harness.stdout.emit("resize");
466
-
467
- harness.stdout.columns = 100;
468
- harness.stdout.rows = 32;
469
- harness.stdout.emit("resize");
470
-
471
- await new Promise((resolve) => setTimeout(resolve, 200));
472
-
473
- assert.equal(harness.stdout.clearCalls, 0);
474
- assert.doesNotMatch(harness.stdout.writes.slice(startupEnd), /\x1b\[2J|\x1b\[3J/);
475
- assert.equal(inkInstance.lastOutput, initialLastOutput);
476
- assert.equal(inkInstance.lastOutputToRender, initialLastOutputToRender);
477
- assert.equal(inkInstance.lastOutputHeight, initialLastOutputHeight);
478
- assert.equal(inkInstance.calculateLayoutCalls, 0);
479
- assert.equal(inkInstance.onRenderCalls, 0);
480
- assert.equal(inkInstance.throttledLogCancelCalls, 0);
481
- assert.equal(inkInstance.rootOnRenderCancelCalls, 0);
482
- assert.equal(inkInstance.onRenderCancelCalls, 0);
483
-
484
- harness.resolveExit();
485
- await flushMicrotasks();
486
- });
487
-
488
- test("removes resize listener and restores bracketed paste on cleanup", async () => {
489
- const harness = createSupportedHarness();
490
-
491
- startApp(harness.deps);
492
- assert.equal(harness.stdout.listenerCount("resize"), 1);
493
- assert.equal(harness.registeredHandlers.length, 1);
494
-
495
- // Cleanup is deferred via registerExitHandler (index 0)
496
- harness.registeredHandlers[0]!();
497
- assert.equal(harness.stdout.listenerCount("resize"), 0);
498
- assert.equal(harness.getCleanupCalls(), 1);
499
- // Verify mouse reporting is not enabled during default startup.
500
- assert.doesNotMatch(harness.stdout.writes, /\x1b\[\?1000h/);
501
- assert.doesNotMatch(harness.stdout.writes, /\x1b\[\?1002h/);
502
- assert.doesNotMatch(harness.stdout.writes, /\x1b\[\?1003h/);
503
- assert.doesNotMatch(harness.stdout.writes, /\x1b\[\?1006h/);
504
- assert.doesNotMatch(harness.stdout.writes, /\x1b\[\?1015h/);
505
- assert.match(harness.stdout.writes, /\x1b\[\?2004h/);
506
- // Verify defensive disable sequences were written during cleanup.
507
- assert.match(harness.stdout.writes, /\x1b\[\?1000l/);
508
- assert.match(harness.stdout.writes, /\x1b\[\?1002l/);
509
- assert.match(harness.stdout.writes, /\x1b\[\?1003l/);
510
- assert.match(harness.stdout.writes, /\x1b\[\?1006l/);
511
- assert.match(harness.stdout.writes, /\x1b\[\?1015l/);
512
- assert.match(harness.stdout.writes, /\x1b\[\?2004l/);
513
-
514
- // Resolving after explicit cleanup should be idempotent.
515
- harness.resolveExit();
516
- await flushMicrotasks();
517
- });
518
-
519
- test("treats sub-viewport dimensions as invalid and defers repaint", async () => {
520
- const harness = createSupportedHarness();
521
- startApp(harness.deps);
522
-
523
- // Reset counters after initial render
524
- harness.stdout.clearCalls = 0;
525
- harness.stdout.writes = "";
526
-
527
- // Emit resize with medium-invalid dims (pass old <=1 check but fail MIN_VIEWPORT threshold)
528
- harness.stdout.columns = 15;
529
- harness.stdout.rows = 8;
530
- harness.stdout.emit("resize");
531
-
532
- // Should NOT write scrollback clear — dims are invalid, content preserved
533
- assert.equal(harness.stdout.clearCalls, 0);
534
-
535
- // Debounce fires but dims are still invalid — repaint is skipped
536
- await new Promise((resolve) => setTimeout(resolve, 200));
537
- assert.equal(harness.stdout.clearCalls, 0);
538
-
539
- // Now recover to valid dims
540
- harness.stdout.columns = 120;
541
- harness.stdout.rows = 40;
542
- harness.stdout.emit("resize");
543
-
544
- // After debounce, recovery still preserves the old frame and avoids clear().
545
- await new Promise((resolve) => setTimeout(resolve, 200));
546
- assert.equal(harness.stdout.clearCalls, 0);
547
- assert.doesNotMatch(harness.stdout.writes, /\x1b\[2J|\x1b\[3J/);
548
-
549
- harness.resolveExit();
550
- await flushMicrotasks();
551
- });
552
-
553
- test("debounced repaint fires after rapid resizes to identical dimensions", async () => {
554
- const harness = createSupportedHarness();
555
- startApp(harness.deps);
556
-
557
- // Reset counters after initial render
558
- harness.stdout.clearCalls = 0;
559
- harness.stdout.writes = "";
560
-
561
- try {
562
- // Emit two resizes to identical valid dims in quick succession — simulates
563
- // max→standard where the final dims match what React already rendered.
564
- // The debounce should collapse both into a single repaint.
565
- harness.stdout.columns = 100;
566
- harness.stdout.rows = 35;
567
- harness.stdout.emit("resize");
568
- harness.stdout.emit("resize");
569
-
570
- // No writes happen immediately.
571
-
572
- assert.equal(harness.stdout.clearCalls, 0);
573
-
574
- // Wait for the 150ms debounce to fire
575
- await new Promise((resolve) => setTimeout(resolve, 200));
576
-
577
- // Valid resize remains a soft repaint, even when rapid events collapse.
578
- assert.equal(harness.stdout.clearCalls, 0);
579
- assert.equal(harness.stdout.writes.replace(TITLE_SEQUENCE_PATTERN, ""), "");
580
- } finally {
581
- harness.resolveExit();
582
- await flushMicrotasks();
583
- }
584
- });
585
-
586
- test("scheduled soft repaint does not call renderHandle.clear when inkInstance is null", async () => {
587
- const harness = createSupportedHarness();
588
- startApp(harness.deps);
589
-
590
- // Reset counters after initial render
591
- harness.stdout.clearCalls = 0;
592
- harness.stdout.writes = "";
593
-
594
- // Emit a normal resize — triggers scheduleRepaint (no immediate writes)
595
- harness.stdout.columns = 80;
596
- harness.stdout.emit("resize");
597
-
598
- // Immediately after resize: no writes and no renderHandle.clear() yet
599
- assert.equal(harness.stdout.clearCalls, 0);
600
- assert.equal(harness.stdout.writes, "");
601
-
602
- // Wait for the 150ms debounce to fire
603
- await new Promise((resolve) => setTimeout(resolve, 200));
604
-
605
- // In test mocks inkInstance is null; normal valid resize should still avoid
606
- // the fallback clear path.
607
- assert.equal(harness.stdout.clearCalls, 0);
608
- assert.equal(harness.stdout.writes.replace(TITLE_SEQUENCE_PATTERN, ""), "");
609
-
610
- harness.resolveExit();
611
- await flushMicrotasks();
612
- });
613
-
614
- test("render startup does not introduce alternate-screen mode", () => {
615
- const source = readFileSync(new URL("./index.tsx", import.meta.url), "utf8");
616
- assert.doesNotMatch(source, /write\([^)]*1049h/);
617
- assert.doesNotMatch(source, /const\s+\w+\s*=\s*["'`][^"'`]*1049h/);
618
- });