docrev 0.9.11 → 0.9.14

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 (138) hide show
  1. package/.claude/settings.local.json +9 -9
  2. package/.gitattributes +1 -1
  3. package/CHANGELOG.md +149 -149
  4. package/PLAN-tables-and-postprocess.md +850 -850
  5. package/README.md +391 -391
  6. package/bin/rev.js +11 -11
  7. package/bin/rev.ts +145 -145
  8. package/completions/rev.bash +127 -127
  9. package/completions/rev.ps1 +210 -210
  10. package/completions/rev.zsh +207 -207
  11. package/dev_notes/stress2/build_adversarial.ts +186 -186
  12. package/dev_notes/stress2/drift_matcher.ts +62 -62
  13. package/dev_notes/stress2/probe_anchors.ts +35 -35
  14. package/dev_notes/stress2/project/discussion.before.md +3 -3
  15. package/dev_notes/stress2/project/discussion.md +3 -3
  16. package/dev_notes/stress2/project/methods.before.md +20 -20
  17. package/dev_notes/stress2/project/methods.md +20 -20
  18. package/dev_notes/stress2/project/rev.yaml +5 -5
  19. package/dev_notes/stress2/project/sections.yaml +4 -4
  20. package/dev_notes/stress2/sections.yaml +5 -5
  21. package/dev_notes/stress2/trace_placement.ts +50 -50
  22. package/dev_notes/stresstest_boundaries.ts +27 -27
  23. package/dev_notes/stresstest_drift_apply.ts +43 -43
  24. package/dev_notes/stresstest_drift_compare.ts +43 -43
  25. package/dev_notes/stresstest_drift_v2.ts +54 -54
  26. package/dev_notes/stresstest_inspect.ts +54 -54
  27. package/dev_notes/stresstest_pstyle.ts +55 -55
  28. package/dev_notes/stresstest_section_debug.ts +23 -23
  29. package/dev_notes/stresstest_split.ts +70 -70
  30. package/dev_notes/stresstest_trace.ts +19 -19
  31. package/dev_notes/stresstest_verify_no_overwrite.ts +40 -40
  32. package/dist/lib/build.d.ts +50 -1
  33. package/dist/lib/build.d.ts.map +1 -1
  34. package/dist/lib/build.js +80 -30
  35. package/dist/lib/build.js.map +1 -1
  36. package/dist/lib/commands/build.d.ts.map +1 -1
  37. package/dist/lib/commands/build.js +38 -5
  38. package/dist/lib/commands/build.js.map +1 -1
  39. package/dist/lib/commands/utilities.js +164 -164
  40. package/dist/lib/commands/word-tools.js +8 -8
  41. package/dist/lib/grammar.js +3 -3
  42. package/dist/lib/import.d.ts.map +1 -1
  43. package/dist/lib/import.js +146 -24
  44. package/dist/lib/import.js.map +1 -1
  45. package/dist/lib/pdf-comments.js +44 -44
  46. package/dist/lib/plugins.js +57 -57
  47. package/dist/lib/pptx-themes.js +115 -115
  48. package/dist/lib/spelling.js +2 -2
  49. package/dist/lib/templates.js +387 -387
  50. package/dist/lib/themes.js +51 -51
  51. package/dist/lib/types.d.ts +20 -0
  52. package/dist/lib/types.d.ts.map +1 -1
  53. package/dist/lib/word-extraction.d.ts +6 -0
  54. package/dist/lib/word-extraction.d.ts.map +1 -1
  55. package/dist/lib/word-extraction.js +46 -3
  56. package/dist/lib/word-extraction.js.map +1 -1
  57. package/dist/lib/wordcomments.d.ts.map +1 -1
  58. package/dist/lib/wordcomments.js +23 -5
  59. package/dist/lib/wordcomments.js.map +1 -1
  60. package/eslint.config.js +27 -27
  61. package/lib/anchor-match.ts +276 -276
  62. package/lib/annotations.ts +644 -644
  63. package/lib/build.ts +1300 -1227
  64. package/lib/citations.ts +160 -160
  65. package/lib/commands/build.ts +833 -801
  66. package/lib/commands/citations.ts +515 -515
  67. package/lib/commands/comments.ts +1050 -1050
  68. package/lib/commands/context.ts +174 -174
  69. package/lib/commands/core.ts +309 -309
  70. package/lib/commands/doi.ts +435 -435
  71. package/lib/commands/file-ops.ts +372 -372
  72. package/lib/commands/history.ts +320 -320
  73. package/lib/commands/index.ts +87 -87
  74. package/lib/commands/init.ts +259 -259
  75. package/lib/commands/merge-resolve.ts +378 -378
  76. package/lib/commands/preview.ts +178 -178
  77. package/lib/commands/project-info.ts +244 -244
  78. package/lib/commands/quality.ts +517 -517
  79. package/lib/commands/response.ts +454 -454
  80. package/lib/commands/section-boundaries.ts +82 -82
  81. package/lib/commands/sections.ts +451 -451
  82. package/lib/commands/sync.ts +706 -706
  83. package/lib/commands/text-ops.ts +449 -449
  84. package/lib/commands/utilities.ts +448 -448
  85. package/lib/commands/verify-anchors.ts +272 -272
  86. package/lib/commands/word-tools.ts +340 -340
  87. package/lib/comment-realign.ts +517 -517
  88. package/lib/config.ts +84 -84
  89. package/lib/crossref.ts +781 -781
  90. package/lib/csl.ts +191 -191
  91. package/lib/dependencies.ts +98 -98
  92. package/lib/diff-engine.ts +465 -465
  93. package/lib/doi-cache.ts +115 -115
  94. package/lib/doi.ts +897 -897
  95. package/lib/equations.ts +506 -506
  96. package/lib/errors.ts +346 -346
  97. package/lib/format.ts +541 -541
  98. package/lib/git.ts +326 -326
  99. package/lib/grammar.ts +303 -303
  100. package/lib/image-registry.ts +180 -180
  101. package/lib/import.ts +911 -792
  102. package/lib/journals.ts +543 -543
  103. package/lib/merge.ts +633 -633
  104. package/lib/orcid.ts +144 -144
  105. package/lib/pdf-comments.ts +263 -263
  106. package/lib/pdf-import.ts +524 -524
  107. package/lib/plugins.ts +362 -362
  108. package/lib/postprocess.ts +188 -188
  109. package/lib/pptx-color-filter.lua +37 -37
  110. package/lib/pptx-template.ts +469 -469
  111. package/lib/pptx-themes.ts +483 -483
  112. package/lib/protect-restore.ts +520 -520
  113. package/lib/rate-limiter.ts +94 -94
  114. package/lib/response.ts +197 -197
  115. package/lib/restore-references.ts +240 -240
  116. package/lib/review.ts +327 -327
  117. package/lib/schema.ts +417 -417
  118. package/lib/scientific-words.ts +73 -73
  119. package/lib/sections.ts +335 -335
  120. package/lib/slides.ts +756 -756
  121. package/lib/spelling.ts +334 -334
  122. package/lib/templates.ts +526 -526
  123. package/lib/themes.ts +742 -742
  124. package/lib/trackchanges.ts +247 -247
  125. package/lib/tui.ts +450 -450
  126. package/lib/types.ts +550 -530
  127. package/lib/undo.ts +250 -250
  128. package/lib/utils.ts +69 -69
  129. package/lib/variables.ts +179 -179
  130. package/lib/word-extraction.ts +806 -759
  131. package/lib/word.ts +643 -643
  132. package/lib/wordcomments.ts +817 -798
  133. package/package.json +137 -137
  134. package/scripts/postbuild.js +28 -28
  135. package/skill/REFERENCE.md +431 -431
  136. package/skill/SKILL.md +258 -258
  137. package/tsconfig.json +26 -26
  138. package/types/index.d.ts +525 -525
package/lib/tui.ts CHANGED
@@ -1,450 +1,450 @@
1
- /**
2
- * TUI (Text User Interface) components for enhanced visual display
3
- * Uses box-drawing characters and colors for a richer terminal experience
4
- */
5
-
6
- import chalk from 'chalk';
7
- import * as readline from 'readline';
8
- import type { Annotation } from './types.js';
9
- import type { DocumentSession } from './undo.js';
10
-
11
- // =============================================================================
12
- // Interfaces
13
- // =============================================================================
14
-
15
- interface BoxOptions {
16
- title?: string;
17
- content?: string[];
18
- width?: number;
19
- borderColor?: string;
20
- }
21
-
22
- interface TuiReviewOptions {
23
- author?: string;
24
- addReply?: (text: string, comment: Annotation, author: string, reply: string) => string;
25
- setStatus?: (text: string, comment: Annotation, resolved: boolean) => string;
26
- }
27
-
28
- interface TuiReviewResult {
29
- text: string;
30
- resolved: number;
31
- replied: number;
32
- skipped: number;
33
- }
34
-
35
- // =============================================================================
36
- // Utility Functions
37
- // =============================================================================
38
-
39
- /**
40
- * Strip ANSI codes for length calculation
41
- */
42
- export function stripAnsi(str: string): string {
43
- return str.replace(/\x1b\[[0-9;]*m/g, '');
44
- }
45
-
46
- /**
47
- * Word wrap text to fit within width
48
- */
49
- function wordWrap(text: string, width: number): string[] {
50
- const words = text.split(/\s+/);
51
- const lines: string[] = [];
52
- let currentLine = '';
53
-
54
- for (const word of words) {
55
- if (currentLine.length + word.length + 1 <= width) {
56
- currentLine += (currentLine ? ' ' : '') + word;
57
- } else {
58
- if (currentLine) lines.push(currentLine);
59
- currentLine = word;
60
- }
61
- }
62
-
63
- if (currentLine) lines.push(currentLine);
64
- return lines;
65
- }
66
-
67
- // =============================================================================
68
- // Screen Functions
69
- // =============================================================================
70
-
71
- /**
72
- * Clear the terminal screen
73
- */
74
- export function clearScreen(): void {
75
- process.stdout.write('\x1B[2J\x1B[H');
76
- }
77
-
78
- /**
79
- * Move cursor to position
80
- */
81
- export function moveCursor(row: number, col: number): void {
82
- process.stdout.write(`\x1B[${row};${col}H`);
83
- }
84
-
85
- /**
86
- * Get terminal dimensions
87
- */
88
- export function getTerminalSize(): { rows: number; cols: number } {
89
- return {
90
- rows: process.stdout.rows || 24,
91
- cols: process.stdout.columns || 80,
92
- };
93
- }
94
-
95
- // =============================================================================
96
- // Drawing Functions
97
- // =============================================================================
98
-
99
- /**
100
- * Draw a box with content
101
- */
102
- export function drawBox({ title = '', content = [], width = 60, borderColor = 'dim' }: BoxOptions = {}): string[] {
103
- const border = {
104
- tl: '\u256D', tr: '\u256E', bl: '\u2570', br: '\u256F',
105
- h: '\u2500', v: '\u2502',
106
- };
107
-
108
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
109
- const colorFn = ((chalk as any)[borderColor] as ((str: string) => string)) || chalk.dim;
110
- const lines: string[] = [];
111
-
112
- // Top border with title
113
- if (title) {
114
- const titleDisplay = ` ${title} `;
115
- const remaining = width - titleDisplay.length - 2;
116
- lines.push(
117
- colorFn(border.tl + border.h) +
118
- chalk.bold(titleDisplay) +
119
- colorFn(border.h.repeat(Math.max(0, remaining)) + border.tr)
120
- );
121
- } else {
122
- lines.push(colorFn(border.tl + border.h.repeat(width - 2) + border.tr));
123
- }
124
-
125
- // Content lines
126
- for (const line of content) {
127
- const plainLen = stripAnsi(line).length;
128
- const padding = Math.max(0, width - 4 - plainLen);
129
- lines.push(
130
- colorFn(border.v) + ' ' + line + ' '.repeat(padding) + ' ' + colorFn(border.v)
131
- );
132
- }
133
-
134
- // Bottom border
135
- lines.push(colorFn(border.bl + border.h.repeat(width - 2) + border.br));
136
-
137
- return lines;
138
- }
139
-
140
- /**
141
- * Draw a status bar at the bottom of the screen
142
- */
143
- export function statusBar(left: string, right: string = ''): string {
144
- const { cols } = getTerminalSize();
145
- const leftLen = stripAnsi(left).length;
146
- const rightLen = stripAnsi(right).length;
147
- const padding = Math.max(0, cols - leftLen - rightLen);
148
-
149
- return chalk.inverse(left + ' '.repeat(padding) + right);
150
- }
151
-
152
- /**
153
- * Draw a progress indicator
154
- */
155
- export function progressIndicator(current: number, total: number, width: number = 20): string {
156
- const ratio = current / total;
157
- const filled = Math.round(ratio * width);
158
- const empty = width - filled;
159
-
160
- const bar = chalk.cyan('\u2588'.repeat(filled)) + chalk.dim('\u2591'.repeat(empty));
161
- return `${bar} ${current}/${total}`;
162
- }
163
-
164
- /**
165
- * Format a comment for TUI display
166
- */
167
- export function formatCommentCard(comment: Annotation, index: number, total: number, width: number = 70): string[] {
168
- const statusIcon = comment.resolved ? chalk.green('\u2713') : chalk.yellow('\u25CB');
169
- const author = comment.author || 'Anonymous';
170
-
171
- const content: string[] = [];
172
-
173
- // Author and status line
174
- content.push(chalk.blue(author) + ' ' + statusIcon);
175
- content.push('');
176
-
177
- // Comment text (word-wrap)
178
- const wrappedText = wordWrap(comment.content, width - 6);
179
- for (const line of wrappedText) {
180
- content.push(line);
181
- }
182
-
183
- // Context
184
- if (comment.before) {
185
- content.push('');
186
- const context = comment.before.trim().slice(-50);
187
- content.push(chalk.dim(`Context: "...${context}"`));
188
- }
189
-
190
- // Line number
191
- content.push('');
192
- content.push(chalk.dim(`Line ${comment.line}`));
193
-
194
- return drawBox({
195
- title: `Comment ${index + 1}/${total}`,
196
- content,
197
- width,
198
- borderColor: comment.resolved ? 'green' : 'cyan',
199
- });
200
- }
201
-
202
- /**
203
- * Draw the action menu
204
- */
205
- export function actionMenu(options: [string, string][]): string {
206
- return options
207
- .map(([key, desc]) => chalk.bold(`[${key}]`) + chalk.dim(desc))
208
- .join(' ');
209
- }
210
-
211
- // =============================================================================
212
- // Interactive TUI Review
213
- // =============================================================================
214
-
215
- /**
216
- * Prompt for a single keypress
217
- */
218
- function promptKey(validKeys: string[]): Promise<string> {
219
- return new Promise((resolve) => {
220
- const rl = readline.createInterface({
221
- input: process.stdin,
222
- output: process.stdout,
223
- });
224
-
225
- if (process.stdin.isTTY) {
226
- process.stdin.setRawMode(true);
227
- }
228
- process.stdin.resume();
229
-
230
- process.stdin.once('data', (key: Buffer) => {
231
- const char = key.toString();
232
-
233
- if (process.stdin.isTTY) {
234
- process.stdin.setRawMode(false);
235
- }
236
- rl.close();
237
-
238
- if (char === '\u0003') {
239
- // Ctrl+C
240
- clearScreen();
241
- process.exit(0);
242
- }
243
-
244
- if (validKeys.includes(char.toLowerCase()) || validKeys.includes(char)) {
245
- resolve(char);
246
- } else {
247
- resolve(promptKey(validKeys));
248
- }
249
- });
250
- });
251
- }
252
-
253
- /**
254
- * Prompt for text input
255
- */
256
- function promptText(prompt: string): Promise<string> {
257
- return new Promise((resolve) => {
258
- const rl = readline.createInterface({
259
- input: process.stdin,
260
- output: process.stdout,
261
- });
262
- rl.question(prompt, (answer: string) => {
263
- rl.close();
264
- resolve(answer);
265
- });
266
- });
267
- }
268
-
269
- /**
270
- * Run TUI comment review session
271
- */
272
- export async function tuiCommentReview(text: string, options: TuiReviewOptions = {}): Promise<TuiReviewResult> {
273
- const { getComments } = await import('./annotations.js');
274
- const { createDocumentSession } = await import('./undo.js');
275
- const { author = 'Author', addReply, setStatus } = options;
276
-
277
- const comments = getComments(text, { pendingOnly: true });
278
-
279
- if (comments.length === 0) {
280
- console.log(chalk.green('No pending comments found.'));
281
- return { text, resolved: 0, replied: 0, skipped: 0 };
282
- }
283
-
284
- // Create session with undo support
285
- const session: DocumentSession = createDocumentSession(text);
286
-
287
- let currentIndex = 0;
288
- let resolved = 0;
289
- let replied = 0;
290
- let skipped = 0;
291
- let message = '';
292
-
293
- const render = (): void => {
294
- clearScreen();
295
-
296
- const { cols } = getTerminalSize();
297
- const cardWidth = Math.min(cols - 4, 80);
298
-
299
- // Header
300
- console.log(chalk.cyan.bold(` Reviewing ${comments.length} comment(s) as ${author}`));
301
- const undoInfo = session.info();
302
- const undoStatus = session.canUndo()
303
- ? chalk.dim(` | ${undoInfo.undoSteps} undo`)
304
- : '';
305
- console.log(chalk.dim(` ${progressIndicator(currentIndex + 1, comments.length)}${undoStatus}`));
306
- console.log();
307
-
308
- // Current comment card
309
- const comment = comments[currentIndex];
310
- const card = formatCommentCard(comment, currentIndex, comments.length, cardWidth);
311
- for (const line of card) {
312
- console.log(' ' + line);
313
- }
314
-
315
- console.log();
316
-
317
- // Status message
318
- if (message) {
319
- console.log(' ' + message);
320
- console.log();
321
- message = '';
322
- }
323
-
324
- // Action menu with undo
325
- const menuItems: [string, string][] = [
326
- ['r', 'eply'],
327
- ['m', 'ark resolved'],
328
- ['s', 'kip'],
329
- ['n', 'ext'],
330
- ['p', 'rev'],
331
- ];
332
-
333
- if (session.canUndo()) {
334
- menuItems.push(['u', 'ndo']);
335
- }
336
-
337
- menuItems.push(['A', 'll resolve'], ['q', 'uit']);
338
-
339
- console.log(' ' + actionMenu(menuItems));
340
- console.log();
341
- };
342
-
343
- // Main loop
344
- while (currentIndex < comments.length) {
345
- render();
346
-
347
- const validKeys = session.canUndo()
348
- ? ['r', 'm', 's', 'n', 'p', 'u', 'A', 'q']
349
- : ['r', 'm', 's', 'n', 'p', 'A', 'q'];
350
-
351
- const choice = await promptKey(validKeys);
352
- const comment = comments[currentIndex];
353
-
354
- switch (choice) {
355
- case 'q':
356
- clearScreen();
357
- console.log(chalk.yellow('Aborted.'));
358
- return { text: session.getText(), resolved, replied, skipped: comments.length - currentIndex };
359
-
360
- case 'u':
361
- if (session.canUndo()) {
362
- const undone = session.undo();
363
- if (undone) {
364
- message = chalk.yellow(`Undone: ${undone.description}`);
365
- if (undone.description.includes('Resolved')) resolved = Math.max(0, resolved - 1);
366
- if (undone.description.includes('Reply')) replied = Math.max(0, replied - 1);
367
- if (currentIndex > 0) currentIndex--;
368
- }
369
- }
370
- break;
371
-
372
- case 'A': {
373
- let newText = session.getText();
374
- for (let j = currentIndex; j < comments.length; j++) {
375
- if (setStatus) {
376
- newText = setStatus(newText, comments[j], true);
377
- }
378
- }
379
- session.applyChange(newText, `Resolved ${comments.length - currentIndex} comments`);
380
- resolved += comments.length - currentIndex;
381
- currentIndex = comments.length;
382
- break;
383
- }
384
-
385
- case 'm':
386
- if (setStatus) {
387
- const newText = setStatus(session.getText(), comment, true);
388
- session.applyChange(newText, `Resolved comment #${currentIndex + 1}`);
389
- }
390
- resolved++;
391
- currentIndex++;
392
- break;
393
-
394
- case 'r': {
395
- console.log();
396
- const replyText = await promptText(chalk.cyan(' Reply: '));
397
- if (replyText.trim() && addReply) {
398
- const newText = addReply(session.getText(), comment, author, replyText.trim());
399
- session.applyChange(newText, `Reply to comment #${currentIndex + 1}`);
400
- replied++;
401
- }
402
- currentIndex++;
403
- break;
404
- }
405
-
406
- case 's':
407
- skipped++;
408
- currentIndex++;
409
- break;
410
-
411
- case 'n':
412
- if (currentIndex < comments.length - 1) {
413
- currentIndex++;
414
- }
415
- break;
416
-
417
- case 'p':
418
- if (currentIndex > 0) {
419
- currentIndex--;
420
- }
421
- break;
422
- }
423
- }
424
-
425
- // Summary
426
- clearScreen();
427
- console.log(chalk.cyan.bold(' Review Complete'));
428
- console.log();
429
-
430
- const undoInfo = session.info();
431
- const summaryBox = drawBox({
432
- title: 'Summary',
433
- content: [
434
- chalk.green(`Resolved: ${resolved}`),
435
- chalk.blue(`Replied: ${replied}`),
436
- chalk.yellow(`Skipped: ${skipped}`),
437
- undoInfo.undoSteps > 1 ? chalk.dim(`Changes: ${undoInfo.undoSteps}`) : '',
438
- ].filter(Boolean),
439
- width: 30,
440
- borderColor: 'cyan',
441
- });
442
-
443
- for (const line of summaryBox) {
444
- console.log(' ' + line);
445
- }
446
-
447
- console.log();
448
-
449
- return { text: session.getText(), resolved, replied, skipped };
450
- }
1
+ /**
2
+ * TUI (Text User Interface) components for enhanced visual display
3
+ * Uses box-drawing characters and colors for a richer terminal experience
4
+ */
5
+
6
+ import chalk from 'chalk';
7
+ import * as readline from 'readline';
8
+ import type { Annotation } from './types.js';
9
+ import type { DocumentSession } from './undo.js';
10
+
11
+ // =============================================================================
12
+ // Interfaces
13
+ // =============================================================================
14
+
15
+ interface BoxOptions {
16
+ title?: string;
17
+ content?: string[];
18
+ width?: number;
19
+ borderColor?: string;
20
+ }
21
+
22
+ interface TuiReviewOptions {
23
+ author?: string;
24
+ addReply?: (text: string, comment: Annotation, author: string, reply: string) => string;
25
+ setStatus?: (text: string, comment: Annotation, resolved: boolean) => string;
26
+ }
27
+
28
+ interface TuiReviewResult {
29
+ text: string;
30
+ resolved: number;
31
+ replied: number;
32
+ skipped: number;
33
+ }
34
+
35
+ // =============================================================================
36
+ // Utility Functions
37
+ // =============================================================================
38
+
39
+ /**
40
+ * Strip ANSI codes for length calculation
41
+ */
42
+ export function stripAnsi(str: string): string {
43
+ return str.replace(/\x1b\[[0-9;]*m/g, '');
44
+ }
45
+
46
+ /**
47
+ * Word wrap text to fit within width
48
+ */
49
+ function wordWrap(text: string, width: number): string[] {
50
+ const words = text.split(/\s+/);
51
+ const lines: string[] = [];
52
+ let currentLine = '';
53
+
54
+ for (const word of words) {
55
+ if (currentLine.length + word.length + 1 <= width) {
56
+ currentLine += (currentLine ? ' ' : '') + word;
57
+ } else {
58
+ if (currentLine) lines.push(currentLine);
59
+ currentLine = word;
60
+ }
61
+ }
62
+
63
+ if (currentLine) lines.push(currentLine);
64
+ return lines;
65
+ }
66
+
67
+ // =============================================================================
68
+ // Screen Functions
69
+ // =============================================================================
70
+
71
+ /**
72
+ * Clear the terminal screen
73
+ */
74
+ export function clearScreen(): void {
75
+ process.stdout.write('\x1B[2J\x1B[H');
76
+ }
77
+
78
+ /**
79
+ * Move cursor to position
80
+ */
81
+ export function moveCursor(row: number, col: number): void {
82
+ process.stdout.write(`\x1B[${row};${col}H`);
83
+ }
84
+
85
+ /**
86
+ * Get terminal dimensions
87
+ */
88
+ export function getTerminalSize(): { rows: number; cols: number } {
89
+ return {
90
+ rows: process.stdout.rows || 24,
91
+ cols: process.stdout.columns || 80,
92
+ };
93
+ }
94
+
95
+ // =============================================================================
96
+ // Drawing Functions
97
+ // =============================================================================
98
+
99
+ /**
100
+ * Draw a box with content
101
+ */
102
+ export function drawBox({ title = '', content = [], width = 60, borderColor = 'dim' }: BoxOptions = {}): string[] {
103
+ const border = {
104
+ tl: '\u256D', tr: '\u256E', bl: '\u2570', br: '\u256F',
105
+ h: '\u2500', v: '\u2502',
106
+ };
107
+
108
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
109
+ const colorFn = ((chalk as any)[borderColor] as ((str: string) => string)) || chalk.dim;
110
+ const lines: string[] = [];
111
+
112
+ // Top border with title
113
+ if (title) {
114
+ const titleDisplay = ` ${title} `;
115
+ const remaining = width - titleDisplay.length - 2;
116
+ lines.push(
117
+ colorFn(border.tl + border.h) +
118
+ chalk.bold(titleDisplay) +
119
+ colorFn(border.h.repeat(Math.max(0, remaining)) + border.tr)
120
+ );
121
+ } else {
122
+ lines.push(colorFn(border.tl + border.h.repeat(width - 2) + border.tr));
123
+ }
124
+
125
+ // Content lines
126
+ for (const line of content) {
127
+ const plainLen = stripAnsi(line).length;
128
+ const padding = Math.max(0, width - 4 - plainLen);
129
+ lines.push(
130
+ colorFn(border.v) + ' ' + line + ' '.repeat(padding) + ' ' + colorFn(border.v)
131
+ );
132
+ }
133
+
134
+ // Bottom border
135
+ lines.push(colorFn(border.bl + border.h.repeat(width - 2) + border.br));
136
+
137
+ return lines;
138
+ }
139
+
140
+ /**
141
+ * Draw a status bar at the bottom of the screen
142
+ */
143
+ export function statusBar(left: string, right: string = ''): string {
144
+ const { cols } = getTerminalSize();
145
+ const leftLen = stripAnsi(left).length;
146
+ const rightLen = stripAnsi(right).length;
147
+ const padding = Math.max(0, cols - leftLen - rightLen);
148
+
149
+ return chalk.inverse(left + ' '.repeat(padding) + right);
150
+ }
151
+
152
+ /**
153
+ * Draw a progress indicator
154
+ */
155
+ export function progressIndicator(current: number, total: number, width: number = 20): string {
156
+ const ratio = current / total;
157
+ const filled = Math.round(ratio * width);
158
+ const empty = width - filled;
159
+
160
+ const bar = chalk.cyan('\u2588'.repeat(filled)) + chalk.dim('\u2591'.repeat(empty));
161
+ return `${bar} ${current}/${total}`;
162
+ }
163
+
164
+ /**
165
+ * Format a comment for TUI display
166
+ */
167
+ export function formatCommentCard(comment: Annotation, index: number, total: number, width: number = 70): string[] {
168
+ const statusIcon = comment.resolved ? chalk.green('\u2713') : chalk.yellow('\u25CB');
169
+ const author = comment.author || 'Anonymous';
170
+
171
+ const content: string[] = [];
172
+
173
+ // Author and status line
174
+ content.push(chalk.blue(author) + ' ' + statusIcon);
175
+ content.push('');
176
+
177
+ // Comment text (word-wrap)
178
+ const wrappedText = wordWrap(comment.content, width - 6);
179
+ for (const line of wrappedText) {
180
+ content.push(line);
181
+ }
182
+
183
+ // Context
184
+ if (comment.before) {
185
+ content.push('');
186
+ const context = comment.before.trim().slice(-50);
187
+ content.push(chalk.dim(`Context: "...${context}"`));
188
+ }
189
+
190
+ // Line number
191
+ content.push('');
192
+ content.push(chalk.dim(`Line ${comment.line}`));
193
+
194
+ return drawBox({
195
+ title: `Comment ${index + 1}/${total}`,
196
+ content,
197
+ width,
198
+ borderColor: comment.resolved ? 'green' : 'cyan',
199
+ });
200
+ }
201
+
202
+ /**
203
+ * Draw the action menu
204
+ */
205
+ export function actionMenu(options: [string, string][]): string {
206
+ return options
207
+ .map(([key, desc]) => chalk.bold(`[${key}]`) + chalk.dim(desc))
208
+ .join(' ');
209
+ }
210
+
211
+ // =============================================================================
212
+ // Interactive TUI Review
213
+ // =============================================================================
214
+
215
+ /**
216
+ * Prompt for a single keypress
217
+ */
218
+ function promptKey(validKeys: string[]): Promise<string> {
219
+ return new Promise((resolve) => {
220
+ const rl = readline.createInterface({
221
+ input: process.stdin,
222
+ output: process.stdout,
223
+ });
224
+
225
+ if (process.stdin.isTTY) {
226
+ process.stdin.setRawMode(true);
227
+ }
228
+ process.stdin.resume();
229
+
230
+ process.stdin.once('data', (key: Buffer) => {
231
+ const char = key.toString();
232
+
233
+ if (process.stdin.isTTY) {
234
+ process.stdin.setRawMode(false);
235
+ }
236
+ rl.close();
237
+
238
+ if (char === '\u0003') {
239
+ // Ctrl+C
240
+ clearScreen();
241
+ process.exit(0);
242
+ }
243
+
244
+ if (validKeys.includes(char.toLowerCase()) || validKeys.includes(char)) {
245
+ resolve(char);
246
+ } else {
247
+ resolve(promptKey(validKeys));
248
+ }
249
+ });
250
+ });
251
+ }
252
+
253
+ /**
254
+ * Prompt for text input
255
+ */
256
+ function promptText(prompt: string): Promise<string> {
257
+ return new Promise((resolve) => {
258
+ const rl = readline.createInterface({
259
+ input: process.stdin,
260
+ output: process.stdout,
261
+ });
262
+ rl.question(prompt, (answer: string) => {
263
+ rl.close();
264
+ resolve(answer);
265
+ });
266
+ });
267
+ }
268
+
269
+ /**
270
+ * Run TUI comment review session
271
+ */
272
+ export async function tuiCommentReview(text: string, options: TuiReviewOptions = {}): Promise<TuiReviewResult> {
273
+ const { getComments } = await import('./annotations.js');
274
+ const { createDocumentSession } = await import('./undo.js');
275
+ const { author = 'Author', addReply, setStatus } = options;
276
+
277
+ const comments = getComments(text, { pendingOnly: true });
278
+
279
+ if (comments.length === 0) {
280
+ console.log(chalk.green('No pending comments found.'));
281
+ return { text, resolved: 0, replied: 0, skipped: 0 };
282
+ }
283
+
284
+ // Create session with undo support
285
+ const session: DocumentSession = createDocumentSession(text);
286
+
287
+ let currentIndex = 0;
288
+ let resolved = 0;
289
+ let replied = 0;
290
+ let skipped = 0;
291
+ let message = '';
292
+
293
+ const render = (): void => {
294
+ clearScreen();
295
+
296
+ const { cols } = getTerminalSize();
297
+ const cardWidth = Math.min(cols - 4, 80);
298
+
299
+ // Header
300
+ console.log(chalk.cyan.bold(` Reviewing ${comments.length} comment(s) as ${author}`));
301
+ const undoInfo = session.info();
302
+ const undoStatus = session.canUndo()
303
+ ? chalk.dim(` | ${undoInfo.undoSteps} undo`)
304
+ : '';
305
+ console.log(chalk.dim(` ${progressIndicator(currentIndex + 1, comments.length)}${undoStatus}`));
306
+ console.log();
307
+
308
+ // Current comment card
309
+ const comment = comments[currentIndex];
310
+ const card = formatCommentCard(comment, currentIndex, comments.length, cardWidth);
311
+ for (const line of card) {
312
+ console.log(' ' + line);
313
+ }
314
+
315
+ console.log();
316
+
317
+ // Status message
318
+ if (message) {
319
+ console.log(' ' + message);
320
+ console.log();
321
+ message = '';
322
+ }
323
+
324
+ // Action menu with undo
325
+ const menuItems: [string, string][] = [
326
+ ['r', 'eply'],
327
+ ['m', 'ark resolved'],
328
+ ['s', 'kip'],
329
+ ['n', 'ext'],
330
+ ['p', 'rev'],
331
+ ];
332
+
333
+ if (session.canUndo()) {
334
+ menuItems.push(['u', 'ndo']);
335
+ }
336
+
337
+ menuItems.push(['A', 'll resolve'], ['q', 'uit']);
338
+
339
+ console.log(' ' + actionMenu(menuItems));
340
+ console.log();
341
+ };
342
+
343
+ // Main loop
344
+ while (currentIndex < comments.length) {
345
+ render();
346
+
347
+ const validKeys = session.canUndo()
348
+ ? ['r', 'm', 's', 'n', 'p', 'u', 'A', 'q']
349
+ : ['r', 'm', 's', 'n', 'p', 'A', 'q'];
350
+
351
+ const choice = await promptKey(validKeys);
352
+ const comment = comments[currentIndex];
353
+
354
+ switch (choice) {
355
+ case 'q':
356
+ clearScreen();
357
+ console.log(chalk.yellow('Aborted.'));
358
+ return { text: session.getText(), resolved, replied, skipped: comments.length - currentIndex };
359
+
360
+ case 'u':
361
+ if (session.canUndo()) {
362
+ const undone = session.undo();
363
+ if (undone) {
364
+ message = chalk.yellow(`Undone: ${undone.description}`);
365
+ if (undone.description.includes('Resolved')) resolved = Math.max(0, resolved - 1);
366
+ if (undone.description.includes('Reply')) replied = Math.max(0, replied - 1);
367
+ if (currentIndex > 0) currentIndex--;
368
+ }
369
+ }
370
+ break;
371
+
372
+ case 'A': {
373
+ let newText = session.getText();
374
+ for (let j = currentIndex; j < comments.length; j++) {
375
+ if (setStatus) {
376
+ newText = setStatus(newText, comments[j], true);
377
+ }
378
+ }
379
+ session.applyChange(newText, `Resolved ${comments.length - currentIndex} comments`);
380
+ resolved += comments.length - currentIndex;
381
+ currentIndex = comments.length;
382
+ break;
383
+ }
384
+
385
+ case 'm':
386
+ if (setStatus) {
387
+ const newText = setStatus(session.getText(), comment, true);
388
+ session.applyChange(newText, `Resolved comment #${currentIndex + 1}`);
389
+ }
390
+ resolved++;
391
+ currentIndex++;
392
+ break;
393
+
394
+ case 'r': {
395
+ console.log();
396
+ const replyText = await promptText(chalk.cyan(' Reply: '));
397
+ if (replyText.trim() && addReply) {
398
+ const newText = addReply(session.getText(), comment, author, replyText.trim());
399
+ session.applyChange(newText, `Reply to comment #${currentIndex + 1}`);
400
+ replied++;
401
+ }
402
+ currentIndex++;
403
+ break;
404
+ }
405
+
406
+ case 's':
407
+ skipped++;
408
+ currentIndex++;
409
+ break;
410
+
411
+ case 'n':
412
+ if (currentIndex < comments.length - 1) {
413
+ currentIndex++;
414
+ }
415
+ break;
416
+
417
+ case 'p':
418
+ if (currentIndex > 0) {
419
+ currentIndex--;
420
+ }
421
+ break;
422
+ }
423
+ }
424
+
425
+ // Summary
426
+ clearScreen();
427
+ console.log(chalk.cyan.bold(' Review Complete'));
428
+ console.log();
429
+
430
+ const undoInfo = session.info();
431
+ const summaryBox = drawBox({
432
+ title: 'Summary',
433
+ content: [
434
+ chalk.green(`Resolved: ${resolved}`),
435
+ chalk.blue(`Replied: ${replied}`),
436
+ chalk.yellow(`Skipped: ${skipped}`),
437
+ undoInfo.undoSteps > 1 ? chalk.dim(`Changes: ${undoInfo.undoSteps}`) : '',
438
+ ].filter(Boolean),
439
+ width: 30,
440
+ borderColor: 'cyan',
441
+ });
442
+
443
+ for (const line of summaryBox) {
444
+ console.log(' ' + line);
445
+ }
446
+
447
+ console.log();
448
+
449
+ return { text: session.getText(), resolved, replied, skipped };
450
+ }