@golba98/codexa 1.0.2 → 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 (150) hide show
  1. package/README.md +391 -94
  2. package/package.json +12 -7
  3. package/src/app.tsx +149 -117
  4. package/src/commands/handler.ts +4 -4
  5. package/src/config/buildInfo.ts +2 -2
  6. package/src/config/persistence.ts +10 -0
  7. package/src/config/settings.ts +7 -15
  8. package/src/config/updateCheckCache.ts +19 -1
  9. package/src/core/channel.ts +23 -0
  10. package/src/core/executables/codexExecutable.ts +1 -0
  11. package/src/core/executables/executableResolver.ts +61 -43
  12. package/src/core/launchContext.ts +33 -33
  13. package/src/core/process/processValidation.ts +9 -5
  14. package/src/core/providerLauncher/launcher.ts +59 -42
  15. package/src/core/updateCheck.ts +111 -95
  16. package/src/session/types.ts +2 -1
  17. package/src/ui/ActionRequiredBlock.tsx +5 -5
  18. package/src/ui/ActivityBars.tsx +3 -3
  19. package/src/ui/ActivityIndicator.tsx +6 -6
  20. package/src/ui/AgentBlock.tsx +6 -6
  21. package/src/ui/AnimatedStatusText.tsx +1 -1
  22. package/src/ui/AppShell.tsx +9 -24
  23. package/src/ui/AttachmentImportPanel.tsx +8 -8
  24. package/src/ui/AuthPanel.tsx +20 -20
  25. package/src/ui/BottomComposer.tsx +117 -78
  26. package/src/ui/DashCard.tsx +3 -3
  27. package/src/ui/Markdown.tsx +17 -17
  28. package/src/ui/ModelPickerScreen.tsx +10 -10
  29. package/src/ui/ModelReasoningPicker.tsx +14 -14
  30. package/src/ui/Panel.tsx +3 -3
  31. package/src/ui/PlanActionPicker.tsx +6 -6
  32. package/src/ui/PlanReviewPanel.tsx +8 -8
  33. package/src/ui/ProviderPicker.tsx +18 -18
  34. package/src/ui/RunFooter.tsx +3 -3
  35. package/src/ui/SelectionPanel.tsx +4 -4
  36. package/src/ui/SettingsPanel.tsx +8 -8
  37. package/src/ui/Spinner.tsx +1 -1
  38. package/src/ui/TextEntryPanel.tsx +10 -10
  39. package/src/ui/ThinkingBlock.tsx +8 -8
  40. package/src/ui/Timeline.tsx +21 -17
  41. package/src/ui/TopHeader.tsx +421 -293
  42. package/src/ui/TurnGroup.tsx +31 -31
  43. package/src/ui/UpdateAvailableCard.tsx +41 -0
  44. package/src/ui/UpdatePromptPanel.tsx +203 -0
  45. package/src/ui/focus.ts +3 -0
  46. package/src/ui/layout.ts +1 -1
  47. package/src/ui/logoVariants.ts +107 -0
  48. package/src/ui/modeDisplay.ts +12 -12
  49. package/src/ui/runtimeDisplay.ts +100 -0
  50. package/src/ui/theme.tsx +274 -395
  51. package/src/ui/timelineMeasure.ts +29 -19
  52. package/scripts/audit-codexa-capabilities.mjs +0 -466
  53. package/scripts/gen-build-info.mjs +0 -33
  54. package/scripts/smoke-terminal-bench.mjs +0 -35
  55. package/src/appRenderStability.test.ts +0 -131
  56. package/src/commands/handler.test.ts +0 -655
  57. package/src/config/launchArgs.test.ts +0 -189
  58. package/src/config/layeredConfig.test.ts +0 -143
  59. package/src/config/persistence.test.ts +0 -114
  60. package/src/config/runtimeConfig.test.ts +0 -218
  61. package/src/config/settings.test.ts +0 -155
  62. package/src/config/trustStore.test.ts +0 -29
  63. package/src/core/attachments.test.ts +0 -155
  64. package/src/core/auth/codexAuth.test.ts +0 -68
  65. package/src/core/cleanupFastFail.test.ts +0 -76
  66. package/src/core/codexExecArgs.test.ts +0 -195
  67. package/src/core/codexLaunch.test.ts +0 -205
  68. package/src/core/codexPrompt.test.ts +0 -252
  69. package/src/core/executables/codexExecutable.test.ts +0 -212
  70. package/src/core/executables/executableResolver.test.ts +0 -129
  71. package/src/core/executables/geminiExecutable.test.ts +0 -116
  72. package/src/core/executables/pathSanityScan.test.ts +0 -47
  73. package/src/core/githubDiagnostics.test.ts +0 -92
  74. package/src/core/hollowResponseFormat.test.ts +0 -58
  75. package/src/core/launchContext.test.ts +0 -157
  76. package/src/core/models/codexCapabilities.test.ts +0 -45
  77. package/src/core/models/codexModelCapabilities.test.ts +0 -246
  78. package/src/core/models/modelSpecs.test.ts +0 -283
  79. package/src/core/perf/renderDebug.test.ts +0 -230
  80. package/src/core/planStorage.test.ts +0 -143
  81. package/src/core/process/CommandRunner.test.ts +0 -105
  82. package/src/core/projectInstructions.test.ts +0 -50
  83. package/src/core/providerLauncher/launcher.test.ts +0 -238
  84. package/src/core/providerLauncher/registry.test.ts +0 -324
  85. package/src/core/providerLauncher/workspaceConfig.test.ts +0 -638
  86. package/src/core/providerRuntime/anthropic.test.ts +0 -1120
  87. package/src/core/providerRuntime/capabilityProfile.test.ts +0 -311
  88. package/src/core/providerRuntime/contextMetadata.test.ts +0 -468
  89. package/src/core/providerRuntime/gemini.test.ts +0 -437
  90. package/src/core/providerRuntime/lmstudio.test.ts +0 -168
  91. package/src/core/providerRuntime/local.test.ts +0 -787
  92. package/src/core/providerRuntime/registry.test.ts +0 -233
  93. package/src/core/providers/codexJsonStream.test.ts +0 -148
  94. package/src/core/providers/codexSubprocess.test.ts +0 -68
  95. package/src/core/providers/codexTranscript.test.ts +0 -284
  96. package/src/core/terminal/startupClear.test.ts +0 -55
  97. package/src/core/terminal/terminalCapabilities.test.ts +0 -93
  98. package/src/core/terminal/terminalControl.test.ts +0 -75
  99. package/src/core/terminal/terminalSanitize.test.ts +0 -22
  100. package/src/core/terminal/terminalSelection.test.ts +0 -42
  101. package/src/core/terminal/terminalTitle.test.ts +0 -328
  102. package/src/core/updateCheck.test.ts +0 -194
  103. package/src/core/workspaceActivity.test.ts +0 -163
  104. package/src/core/workspaceGuard.test.ts +0 -151
  105. package/src/core/workspaceRoot.test.ts +0 -23
  106. package/src/exec.test.ts +0 -13
  107. package/src/headless/execArgs.test.ts +0 -147
  108. package/src/headless/execRunner.test.ts +0 -436
  109. package/src/index.test.tsx +0 -620
  110. package/src/session/appSession.test.ts +0 -897
  111. package/src/session/chatLifecycle.test.ts +0 -64
  112. package/src/session/liveRenderScheduler.test.ts +0 -201
  113. package/src/session/planFlow.test.ts +0 -103
  114. package/src/session/planTranscript.test.ts +0 -65
  115. package/src/session/promptRunSchedule.test.ts +0 -36
  116. package/src/ui/ActivityIndicator.test.tsx +0 -58
  117. package/src/ui/AgentBlock.test.ts +0 -6
  118. package/src/ui/AnimatedStatusText.test.ts +0 -16
  119. package/src/ui/AppShell.test.tsx +0 -1776
  120. package/src/ui/AttachmentImportPanel.test.tsx +0 -204
  121. package/src/ui/BottomComposer.test.ts +0 -674
  122. package/src/ui/CodexLogo.tsx +0 -55
  123. package/src/ui/Markdown.test.ts +0 -157
  124. package/src/ui/ModelPickerProviderScope.test.tsx +0 -411
  125. package/src/ui/ModelPickerScreen.test.tsx +0 -99
  126. package/src/ui/ModelPickerState.test.tsx +0 -151
  127. package/src/ui/ModelReasoningPicker.test.tsx +0 -447
  128. package/src/ui/PlanReviewPanel.test.tsx +0 -267
  129. package/src/ui/PromptCardBorder.test.tsx +0 -161
  130. package/src/ui/ProviderPicker.test.tsx +0 -289
  131. package/src/ui/ProviderShortcut.test.tsx +0 -143
  132. package/src/ui/SettingsPanel.test.tsx +0 -233
  133. package/src/ui/Timeline.test.ts +0 -2067
  134. package/src/ui/TimelineNavigation.test.tsx +0 -201
  135. package/src/ui/TopHeader.test.tsx +0 -254
  136. package/src/ui/TurnGroup.test.tsx +0 -365
  137. package/src/ui/busyStatusAnimation.test.ts +0 -30
  138. package/src/ui/commandNormalize.test.ts +0 -142
  139. package/src/ui/diffRenderer.test.ts +0 -102
  140. package/src/ui/focusFlow.test.tsx +0 -1098
  141. package/src/ui/inputBuffer.test.ts +0 -151
  142. package/src/ui/layout.test.ts +0 -146
  143. package/src/ui/modeDisplay.test.ts +0 -42
  144. package/src/ui/runActivityView.test.ts +0 -89
  145. package/src/ui/runLifecycleView.test.tsx +0 -237
  146. package/src/ui/statusRenderIsolation.test.tsx +0 -654
  147. package/src/ui/terminalAnswerFormat.test.ts +0 -19
  148. package/src/ui/textLayout.test.ts +0 -18
  149. package/src/ui/themeFlow.test.ts +0 -53
  150. package/src/ui/timelineMeasureCache.test.ts +0 -986
@@ -1,620 +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 intentionally clears scrollback (\x1b[3J) so the app opens into a
369
- // clean screen. Verify it IS written exactly once during startup.
370
- assert.match(harness.stdout.writes, /\x1b\[3J/, "startup must erase scrollback for clean open");
371
-
372
- // Capture offset so we can inspect only post-startup writes.
373
- const startupEnd = harness.stdout.writes.length;
374
-
375
- harness.stdout.columns = 80;
376
- harness.stdout.emit("resize");
377
-
378
- await new Promise((resolve) => setTimeout(resolve, 200));
379
-
380
- // Normal valid resize is a soft repaint and must not call Ink.clear().
381
- assert.equal(harness.stdout.clearCalls, 0, "normal resize must not call clear()");
382
-
383
- // Post-resize writes must not contain full/viewport clear sequences.
384
- const resizeWrites = harness.stdout.writes.slice(startupEnd);
385
- assert.doesNotMatch(resizeWrites, /\x1b\[3J/, "scrollback must not be erased on resize");
386
- assert.doesNotMatch(resizeWrites, /\x1b\[2J/, "normal resize must not clear the viewport");
387
-
388
- harness.resolveExit();
389
- await flushMicrotasks();
390
- });
391
-
392
- test("normal app render writes do not clear the terminal after startup", async () => {
393
- const harness = createSupportedHarness();
394
- startApp(harness.deps);
395
-
396
- const writesAfterStartup = harness.stdout.writes.slice(
397
- harness.stdout.writes.indexOf("\x1b[?2004h") + "\x1b[?2004h".length,
398
- );
399
- assert.equal(harness.stdout.clearCalls, 0);
400
- assert.doesNotMatch(harness.stdout.writes, /\x1b\[\?1000h|\x1b\[\?1006h/);
401
- assert.doesNotMatch(writesAfterStartup, /\x1b\[2J|\x1b\[3J/);
402
-
403
- harness.resolveExit();
404
- await flushMicrotasks();
405
- });
406
-
407
- test("startup writes safe fallback title before repaint and workspace title before Ink render setup", async () => {
408
- const harness = createSupportedHarness();
409
- startApp(harness.deps);
410
-
411
- // Startup now writes a full transcript clear: viewport + scrollback + cursor home.
412
- const repaintIndex = harness.stdout.writes.indexOf("\x1b[2J\x1b[3J\x1b[H");
413
- const firstTitleIndex = harness.stdout.writes.indexOf("\x1b]0;");
414
- const postRepaintTitleIndex = harness.stdout.writes.indexOf("\x1b]0;", repaintIndex + 1);
415
- const bracketedPasteIndex = harness.stdout.writes.indexOf("\x1b[?2004h");
416
-
417
- assert.ok(repaintIndex >= 0, "startup repaint should be written");
418
- assert.ok(firstTitleIndex >= 0, "fallback title should be written");
419
- assert.ok(firstTitleIndex < repaintIndex, "safe fallback title should be written before startup repaint");
420
- assert.ok(postRepaintTitleIndex > repaintIndex, "workspace title should be written after startup repaint");
421
- assert.ok(bracketedPasteIndex > postRepaintTitleIndex, "workspace title should be written before bracketed paste/render setup");
422
- assert.match(harness.stdout.writes, /\x1b\]0;[^\x07]+\x07\x1b\]2;[^\x07]+\x07/);
423
- assert.doesNotMatch(harness.stdout.writes, /\x1b\](?:0|2);[a-zA-Z]:[\\/]/);
424
-
425
- harness.resolveExit();
426
- await flushMicrotasks();
427
- });
428
-
429
- test("soft-repaints when resize occurs without invalid dimensions", async () => {
430
- const harness = createSupportedHarness();
431
- startApp(harness.deps);
432
-
433
- const writesBefore = harness.stdout.writes;
434
-
435
- // Emit a resize at valid dimensions (no invalid transition)
436
- harness.stdout.columns = 80;
437
- harness.stdout.emit("resize");
438
-
439
- // No writes happen immediately.
440
- const immediateWrites = harness.stdout.writes.slice(writesBefore.length);
441
- assert.equal(immediateWrites, "");
442
-
443
- // After debounce fires, valid resize still avoids terminal clear writes.
444
- await new Promise((resolve) => setTimeout(resolve, 200));
445
- assert.equal(harness.stdout.clearCalls, 0);
446
- const delayedWrites = harness.stdout.writes.slice(writesBefore.length);
447
- assert.doesNotMatch(delayedWrites, /\x1b\[2J|\x1b\[3J/);
448
-
449
- harness.resolveExit();
450
- await flushMicrotasks();
451
- });
452
-
453
- test("post-startup resize does not force Ink internals or blank cached output", async () => {
454
- const inkInstance = createFakeInkInstance();
455
- const harness = createSupportedHarness({ inkInstance });
456
- startApp(harness.deps);
457
-
458
- assert.equal(inkInstance.unsubscribeResizeCalls, 1, "startup still disables Ink's competing resize listener");
459
-
460
- const initialLastOutput = inkInstance.lastOutput;
461
- const initialLastOutputToRender = inkInstance.lastOutputToRender;
462
- const initialLastOutputHeight = inkInstance.lastOutputHeight;
463
- const startupEnd = harness.stdout.writes.length;
464
-
465
- harness.stdout.columns = 15;
466
- harness.stdout.rows = 8;
467
- harness.stdout.emit("resize");
468
-
469
- harness.stdout.columns = 100;
470
- harness.stdout.rows = 32;
471
- harness.stdout.emit("resize");
472
-
473
- await new Promise((resolve) => setTimeout(resolve, 200));
474
-
475
- assert.equal(harness.stdout.clearCalls, 0);
476
- assert.doesNotMatch(harness.stdout.writes.slice(startupEnd), /\x1b\[2J|\x1b\[3J/);
477
- assert.equal(inkInstance.lastOutput, initialLastOutput);
478
- assert.equal(inkInstance.lastOutputToRender, initialLastOutputToRender);
479
- assert.equal(inkInstance.lastOutputHeight, initialLastOutputHeight);
480
- assert.equal(inkInstance.calculateLayoutCalls, 0);
481
- assert.equal(inkInstance.onRenderCalls, 0);
482
- assert.equal(inkInstance.throttledLogCancelCalls, 0);
483
- assert.equal(inkInstance.rootOnRenderCancelCalls, 0);
484
- assert.equal(inkInstance.onRenderCancelCalls, 0);
485
-
486
- harness.resolveExit();
487
- await flushMicrotasks();
488
- });
489
-
490
- test("removes resize listener and restores bracketed paste on cleanup", async () => {
491
- const harness = createSupportedHarness();
492
-
493
- startApp(harness.deps);
494
- assert.equal(harness.stdout.listenerCount("resize"), 1);
495
- assert.equal(harness.registeredHandlers.length, 1);
496
-
497
- // Cleanup is deferred via registerExitHandler (index 0)
498
- harness.registeredHandlers[0]!();
499
- assert.equal(harness.stdout.listenerCount("resize"), 0);
500
- assert.equal(harness.getCleanupCalls(), 1);
501
- // Verify mouse reporting is not enabled during default startup.
502
- assert.doesNotMatch(harness.stdout.writes, /\x1b\[\?1000h/);
503
- assert.doesNotMatch(harness.stdout.writes, /\x1b\[\?1002h/);
504
- assert.doesNotMatch(harness.stdout.writes, /\x1b\[\?1003h/);
505
- assert.doesNotMatch(harness.stdout.writes, /\x1b\[\?1006h/);
506
- assert.doesNotMatch(harness.stdout.writes, /\x1b\[\?1015h/);
507
- assert.match(harness.stdout.writes, /\x1b\[\?2004h/);
508
- // Verify defensive disable sequences were written during cleanup.
509
- assert.match(harness.stdout.writes, /\x1b\[\?1000l/);
510
- assert.match(harness.stdout.writes, /\x1b\[\?1002l/);
511
- assert.match(harness.stdout.writes, /\x1b\[\?1003l/);
512
- assert.match(harness.stdout.writes, /\x1b\[\?1006l/);
513
- assert.match(harness.stdout.writes, /\x1b\[\?1015l/);
514
- assert.match(harness.stdout.writes, /\x1b\[\?2004l/);
515
-
516
- // Resolving after explicit cleanup should be idempotent.
517
- harness.resolveExit();
518
- await flushMicrotasks();
519
- });
520
-
521
- test("treats sub-viewport dimensions as invalid and defers repaint", async () => {
522
- const harness = createSupportedHarness();
523
- startApp(harness.deps);
524
-
525
- // Reset counters after initial render
526
- harness.stdout.clearCalls = 0;
527
- harness.stdout.writes = "";
528
-
529
- // Emit resize with medium-invalid dims (pass old <=1 check but fail MIN_VIEWPORT threshold)
530
- harness.stdout.columns = 15;
531
- harness.stdout.rows = 8;
532
- harness.stdout.emit("resize");
533
-
534
- // Should NOT write scrollback clear — dims are invalid, content preserved
535
- assert.equal(harness.stdout.clearCalls, 0);
536
-
537
- // Debounce fires but dims are still invalid — repaint is skipped
538
- await new Promise((resolve) => setTimeout(resolve, 200));
539
- assert.equal(harness.stdout.clearCalls, 0);
540
-
541
- // Now recover to valid dims
542
- harness.stdout.columns = 120;
543
- harness.stdout.rows = 40;
544
- harness.stdout.emit("resize");
545
-
546
- // After debounce, recovery still preserves the old frame and avoids clear().
547
- await new Promise((resolve) => setTimeout(resolve, 200));
548
- assert.equal(harness.stdout.clearCalls, 0);
549
- assert.doesNotMatch(harness.stdout.writes, /\x1b\[2J|\x1b\[3J/);
550
-
551
- harness.resolveExit();
552
- await flushMicrotasks();
553
- });
554
-
555
- test("debounced repaint fires after rapid resizes to identical dimensions", async () => {
556
- const harness = createSupportedHarness();
557
- startApp(harness.deps);
558
-
559
- // Reset counters after initial render
560
- harness.stdout.clearCalls = 0;
561
- harness.stdout.writes = "";
562
-
563
- try {
564
- // Emit two resizes to identical valid dims in quick succession — simulates
565
- // max→standard where the final dims match what React already rendered.
566
- // The debounce should collapse both into a single repaint.
567
- harness.stdout.columns = 100;
568
- harness.stdout.rows = 35;
569
- harness.stdout.emit("resize");
570
- harness.stdout.emit("resize");
571
-
572
- // No writes happen immediately.
573
-
574
- assert.equal(harness.stdout.clearCalls, 0);
575
-
576
- // Wait for the 150ms debounce to fire
577
- await new Promise((resolve) => setTimeout(resolve, 200));
578
-
579
- // Valid resize remains a soft repaint, even when rapid events collapse.
580
- assert.equal(harness.stdout.clearCalls, 0);
581
- assert.equal(harness.stdout.writes.replace(TITLE_SEQUENCE_PATTERN, ""), "");
582
- } finally {
583
- harness.resolveExit();
584
- await flushMicrotasks();
585
- }
586
- });
587
-
588
- test("scheduled soft repaint does not call renderHandle.clear when inkInstance is null", async () => {
589
- const harness = createSupportedHarness();
590
- startApp(harness.deps);
591
-
592
- // Reset counters after initial render
593
- harness.stdout.clearCalls = 0;
594
- harness.stdout.writes = "";
595
-
596
- // Emit a normal resize — triggers scheduleRepaint (no immediate writes)
597
- harness.stdout.columns = 80;
598
- harness.stdout.emit("resize");
599
-
600
- // Immediately after resize: no writes and no renderHandle.clear() yet
601
- assert.equal(harness.stdout.clearCalls, 0);
602
- assert.equal(harness.stdout.writes, "");
603
-
604
- // Wait for the 150ms debounce to fire
605
- await new Promise((resolve) => setTimeout(resolve, 200));
606
-
607
- // In test mocks inkInstance is null; normal valid resize should still avoid
608
- // the fallback clear path.
609
- assert.equal(harness.stdout.clearCalls, 0);
610
- assert.equal(harness.stdout.writes.replace(TITLE_SEQUENCE_PATTERN, ""), "");
611
-
612
- harness.resolveExit();
613
- await flushMicrotasks();
614
- });
615
-
616
- test("render startup does not introduce alternate-screen mode", () => {
617
- const source = readFileSync(new URL("./index.tsx", import.meta.url), "utf8");
618
- assert.doesNotMatch(source, /write\([^)]*1049h/);
619
- assert.doesNotMatch(source, /const\s+\w+\s*=\s*["'`][^"'`]*1049h/);
620
- });