@chengchenccc/tui 0.1.1-rc.1

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 (226) hide show
  1. package/dist/autocomplete.d.ts +56 -0
  2. package/dist/autocomplete.d.ts.map +1 -0
  3. package/dist/autocomplete.js +647 -0
  4. package/dist/components/box.d.ts +22 -0
  5. package/dist/components/box.d.ts.map +1 -0
  6. package/dist/components/box.js +103 -0
  7. package/dist/components/card.d.ts +33 -0
  8. package/dist/components/card.d.ts.map +1 -0
  9. package/dist/components/card.js +49 -0
  10. package/dist/components/editor.d.ts +257 -0
  11. package/dist/components/editor.d.ts.map +1 -0
  12. package/dist/components/editor.js +1980 -0
  13. package/dist/components/input.d.ts +37 -0
  14. package/dist/components/input.d.ts.map +1 -0
  15. package/dist/components/input.js +389 -0
  16. package/dist/components/loader.d.ts +33 -0
  17. package/dist/components/loader.d.ts.map +1 -0
  18. package/dist/components/loader.js +100 -0
  19. package/dist/components/markdown.d.ts +108 -0
  20. package/dist/components/markdown.d.ts.map +1 -0
  21. package/dist/components/markdown.js +847 -0
  22. package/dist/components/markdown.test.d.ts +2 -0
  23. package/dist/components/markdown.test.d.ts.map +1 -0
  24. package/dist/components/markdown.test.js +81 -0
  25. package/dist/components/output-block.d.ts +44 -0
  26. package/dist/components/output-block.d.ts.map +1 -0
  27. package/dist/components/output-block.js +131 -0
  28. package/dist/components/select-list.d.ts +50 -0
  29. package/dist/components/select-list.d.ts.map +1 -0
  30. package/dist/components/select-list.js +166 -0
  31. package/dist/components/spacer.d.ts +12 -0
  32. package/dist/components/spacer.d.ts.map +1 -0
  33. package/dist/components/spacer.js +22 -0
  34. package/dist/components/statusline.d.ts +30 -0
  35. package/dist/components/statusline.d.ts.map +1 -0
  36. package/dist/components/statusline.js +46 -0
  37. package/dist/components/text.d.ts +19 -0
  38. package/dist/components/text.d.ts.map +1 -0
  39. package/dist/components/text.js +90 -0
  40. package/dist/components/truncated-text.d.ts +13 -0
  41. package/dist/components/truncated-text.d.ts.map +1 -0
  42. package/dist/components/truncated-text.js +50 -0
  43. package/dist/editor-component.d.ts +39 -0
  44. package/dist/editor-component.d.ts.map +1 -0
  45. package/dist/editor-component.js +1 -0
  46. package/dist/fuzzy.d.ts +16 -0
  47. package/dist/fuzzy.d.ts.map +1 -0
  48. package/dist/fuzzy.js +109 -0
  49. package/dist/index.d.ts +25 -0
  50. package/dist/index.d.ts.map +1 -0
  51. package/dist/index.js +36 -0
  52. package/dist/keybindings.d.ts +193 -0
  53. package/dist/keybindings.d.ts.map +1 -0
  54. package/dist/keybindings.js +191 -0
  55. package/dist/keys.d.ts +184 -0
  56. package/dist/keys.d.ts.map +1 -0
  57. package/dist/keys.js +1191 -0
  58. package/dist/kill-ring.d.ts +28 -0
  59. package/dist/kill-ring.d.ts.map +1 -0
  60. package/dist/kill-ring.js +43 -0
  61. package/dist/mermaid.d.ts +23 -0
  62. package/dist/mermaid.d.ts.map +1 -0
  63. package/dist/mermaid.js +77 -0
  64. package/dist/mouse.d.ts +40 -0
  65. package/dist/mouse.d.ts.map +1 -0
  66. package/dist/mouse.js +39 -0
  67. package/dist/mouse.test.d.ts +2 -0
  68. package/dist/mouse.test.d.ts.map +1 -0
  69. package/dist/mouse.test.js +36 -0
  70. package/dist/native-modifiers.d.ts +3 -0
  71. package/dist/native-modifiers.d.ts.map +1 -0
  72. package/dist/native-modifiers.js +52 -0
  73. package/dist/stdin-buffer.d.ts +50 -0
  74. package/dist/stdin-buffer.d.ts.map +1 -0
  75. package/dist/stdin-buffer.js +360 -0
  76. package/dist/terminal-colors.d.ts +10 -0
  77. package/dist/terminal-colors.d.ts.map +1 -0
  78. package/dist/terminal-colors.js +58 -0
  79. package/dist/terminal-image.d.ts +90 -0
  80. package/dist/terminal-image.d.ts.map +1 -0
  81. package/dist/terminal-image.js +375 -0
  82. package/dist/terminal.d.ts +110 -0
  83. package/dist/terminal.d.ts.map +1 -0
  84. package/dist/terminal.js +432 -0
  85. package/dist/tui-scrollback.test.d.ts +2 -0
  86. package/dist/tui-scrollback.test.d.ts.map +1 -0
  87. package/dist/tui-scrollback.test.js +51 -0
  88. package/dist/tui.d.ts +330 -0
  89. package/dist/tui.d.ts.map +1 -0
  90. package/dist/tui.js +1568 -0
  91. package/dist/undo-stack.d.ts +17 -0
  92. package/dist/undo-stack.d.ts.map +1 -0
  93. package/dist/undo-stack.js +24 -0
  94. package/dist/utils.d.ts +85 -0
  95. package/dist/utils.d.ts.map +1 -0
  96. package/dist/utils.js +1066 -0
  97. package/dist/vendor/mermaid-ascii/ascii/ansi.d.ts +42 -0
  98. package/dist/vendor/mermaid-ascii/ascii/ansi.d.ts.map +1 -0
  99. package/dist/vendor/mermaid-ascii/ascii/ansi.js +361 -0
  100. package/dist/vendor/mermaid-ascii/ascii/canvas.d.ts +90 -0
  101. package/dist/vendor/mermaid-ascii/ascii/canvas.d.ts.map +1 -0
  102. package/dist/vendor/mermaid-ascii/ascii/canvas.js +414 -0
  103. package/dist/vendor/mermaid-ascii/ascii/class-diagram.d.ts +8 -0
  104. package/dist/vendor/mermaid-ascii/ascii/class-diagram.d.ts.map +1 -0
  105. package/dist/vendor/mermaid-ascii/ascii/class-diagram.js +623 -0
  106. package/dist/vendor/mermaid-ascii/ascii/converter.d.ts +13 -0
  107. package/dist/vendor/mermaid-ascii/ascii/converter.d.ts.map +1 -0
  108. package/dist/vendor/mermaid-ascii/ascii/converter.js +233 -0
  109. package/dist/vendor/mermaid-ascii/ascii/draw.d.ts +67 -0
  110. package/dist/vendor/mermaid-ascii/ascii/draw.d.ts.map +1 -0
  111. package/dist/vendor/mermaid-ascii/ascii/draw.js +1313 -0
  112. package/dist/vendor/mermaid-ascii/ascii/edge-bundling.d.ts +49 -0
  113. package/dist/vendor/mermaid-ascii/ascii/edge-bundling.d.ts.map +1 -0
  114. package/dist/vendor/mermaid-ascii/ascii/edge-bundling.js +289 -0
  115. package/dist/vendor/mermaid-ascii/ascii/edge-routing.d.ts +44 -0
  116. package/dist/vendor/mermaid-ascii/ascii/edge-routing.d.ts.map +1 -0
  117. package/dist/vendor/mermaid-ascii/ascii/edge-routing.js +302 -0
  118. package/dist/vendor/mermaid-ascii/ascii/er-diagram.d.ts +8 -0
  119. package/dist/vendor/mermaid-ascii/ascii/er-diagram.d.ts.map +1 -0
  120. package/dist/vendor/mermaid-ascii/ascii/er-diagram.js +380 -0
  121. package/dist/vendor/mermaid-ascii/ascii/grid.d.ts +57 -0
  122. package/dist/vendor/mermaid-ascii/ascii/grid.d.ts.map +1 -0
  123. package/dist/vendor/mermaid-ascii/ascii/grid.js +516 -0
  124. package/dist/vendor/mermaid-ascii/ascii/index.d.ts +66 -0
  125. package/dist/vendor/mermaid-ascii/ascii/index.d.ts.map +1 -0
  126. package/dist/vendor/mermaid-ascii/ascii/index.js +133 -0
  127. package/dist/vendor/mermaid-ascii/ascii/multiline-utils.d.ts +28 -0
  128. package/dist/vendor/mermaid-ascii/ascii/multiline-utils.d.ts.map +1 -0
  129. package/dist/vendor/mermaid-ascii/ascii/multiline-utils.js +60 -0
  130. package/dist/vendor/mermaid-ascii/ascii/pathfinder.d.ts +18 -0
  131. package/dist/vendor/mermaid-ascii/ascii/pathfinder.d.ts.map +1 -0
  132. package/dist/vendor/mermaid-ascii/ascii/pathfinder.js +224 -0
  133. package/dist/vendor/mermaid-ascii/ascii/sequence.d.ts +8 -0
  134. package/dist/vendor/mermaid-ascii/ascii/sequence.d.ts.map +1 -0
  135. package/dist/vendor/mermaid-ascii/ascii/sequence.js +416 -0
  136. package/dist/vendor/mermaid-ascii/ascii/shapes/circle.d.ts +12 -0
  137. package/dist/vendor/mermaid-ascii/ascii/shapes/circle.d.ts.map +1 -0
  138. package/dist/vendor/mermaid-ascii/ascii/shapes/circle.js +22 -0
  139. package/dist/vendor/mermaid-ascii/ascii/shapes/corners.d.ts +35 -0
  140. package/dist/vendor/mermaid-ascii/ascii/shapes/corners.d.ts.map +1 -0
  141. package/dist/vendor/mermaid-ascii/ascii/shapes/corners.js +91 -0
  142. package/dist/vendor/mermaid-ascii/ascii/shapes/diamond.d.ts +12 -0
  143. package/dist/vendor/mermaid-ascii/ascii/shapes/diamond.d.ts.map +1 -0
  144. package/dist/vendor/mermaid-ascii/ascii/shapes/diamond.js +22 -0
  145. package/dist/vendor/mermaid-ascii/ascii/shapes/hexagon.d.ts +12 -0
  146. package/dist/vendor/mermaid-ascii/ascii/shapes/hexagon.d.ts.map +1 -0
  147. package/dist/vendor/mermaid-ascii/ascii/shapes/hexagon.js +22 -0
  148. package/dist/vendor/mermaid-ascii/ascii/shapes/index.d.ts +27 -0
  149. package/dist/vendor/mermaid-ascii/ascii/shapes/index.d.ts.map +1 -0
  150. package/dist/vendor/mermaid-ascii/ascii/shapes/index.js +66 -0
  151. package/dist/vendor/mermaid-ascii/ascii/shapes/rectangle.d.ts +32 -0
  152. package/dist/vendor/mermaid-ascii/ascii/shapes/rectangle.d.ts.map +1 -0
  153. package/dist/vendor/mermaid-ascii/ascii/shapes/rectangle.js +149 -0
  154. package/dist/vendor/mermaid-ascii/ascii/shapes/rounded.d.ts +12 -0
  155. package/dist/vendor/mermaid-ascii/ascii/shapes/rounded.d.ts.map +1 -0
  156. package/dist/vendor/mermaid-ascii/ascii/shapes/rounded.js +22 -0
  157. package/dist/vendor/mermaid-ascii/ascii/shapes/special.d.ts +60 -0
  158. package/dist/vendor/mermaid-ascii/ascii/shapes/special.d.ts.map +1 -0
  159. package/dist/vendor/mermaid-ascii/ascii/shapes/special.js +253 -0
  160. package/dist/vendor/mermaid-ascii/ascii/shapes/stadium.d.ts +18 -0
  161. package/dist/vendor/mermaid-ascii/ascii/shapes/stadium.d.ts.map +1 -0
  162. package/dist/vendor/mermaid-ascii/ascii/shapes/stadium.js +103 -0
  163. package/dist/vendor/mermaid-ascii/ascii/shapes/state.d.ts +31 -0
  164. package/dist/vendor/mermaid-ascii/ascii/shapes/state.d.ts.map +1 -0
  165. package/dist/vendor/mermaid-ascii/ascii/shapes/state.js +167 -0
  166. package/dist/vendor/mermaid-ascii/ascii/shapes/types.d.ts +56 -0
  167. package/dist/vendor/mermaid-ascii/ascii/shapes/types.d.ts.map +1 -0
  168. package/dist/vendor/mermaid-ascii/ascii/shapes/types.js +4 -0
  169. package/dist/vendor/mermaid-ascii/ascii/types.d.ts +207 -0
  170. package/dist/vendor/mermaid-ascii/ascii/types.d.ts.map +1 -0
  171. package/dist/vendor/mermaid-ascii/ascii/types.js +39 -0
  172. package/dist/vendor/mermaid-ascii/ascii/validate.d.ts +52 -0
  173. package/dist/vendor/mermaid-ascii/ascii/validate.d.ts.map +1 -0
  174. package/dist/vendor/mermaid-ascii/ascii/validate.js +97 -0
  175. package/dist/vendor/mermaid-ascii/ascii/xychart.d.ts +3 -0
  176. package/dist/vendor/mermaid-ascii/ascii/xychart.d.ts.map +1 -0
  177. package/dist/vendor/mermaid-ascii/ascii/xychart.js +719 -0
  178. package/dist/vendor/mermaid-ascii/class/parser.d.ts +7 -0
  179. package/dist/vendor/mermaid-ascii/class/parser.d.ts.map +1 -0
  180. package/dist/vendor/mermaid-ascii/class/parser.js +265 -0
  181. package/dist/vendor/mermaid-ascii/class/types.d.ts +103 -0
  182. package/dist/vendor/mermaid-ascii/class/types.d.ts.map +1 -0
  183. package/dist/vendor/mermaid-ascii/class/types.js +7 -0
  184. package/dist/vendor/mermaid-ascii/er/parser.d.ts +7 -0
  185. package/dist/vendor/mermaid-ascii/er/parser.d.ts.map +1 -0
  186. package/dist/vendor/mermaid-ascii/er/parser.js +162 -0
  187. package/dist/vendor/mermaid-ascii/er/types.d.ts +77 -0
  188. package/dist/vendor/mermaid-ascii/er/types.d.ts.map +1 -0
  189. package/dist/vendor/mermaid-ascii/er/types.js +7 -0
  190. package/dist/vendor/mermaid-ascii/index.d.ts +2 -0
  191. package/dist/vendor/mermaid-ascii/index.d.ts.map +1 -0
  192. package/dist/vendor/mermaid-ascii/index.js +13 -0
  193. package/dist/vendor/mermaid-ascii/multiline-utils.d.ts +10 -0
  194. package/dist/vendor/mermaid-ascii/multiline-utils.d.ts.map +1 -0
  195. package/dist/vendor/mermaid-ascii/multiline-utils.js +29 -0
  196. package/dist/vendor/mermaid-ascii/parser.d.ts +8 -0
  197. package/dist/vendor/mermaid-ascii/parser.d.ts.map +1 -0
  198. package/dist/vendor/mermaid-ascii/parser.js +558 -0
  199. package/dist/vendor/mermaid-ascii/sequence/parser.d.ts +7 -0
  200. package/dist/vendor/mermaid-ascii/sequence/parser.d.ts.map +1 -0
  201. package/dist/vendor/mermaid-ascii/sequence/parser.js +182 -0
  202. package/dist/vendor/mermaid-ascii/sequence/types.d.ts +131 -0
  203. package/dist/vendor/mermaid-ascii/sequence/types.d.ts.map +1 -0
  204. package/dist/vendor/mermaid-ascii/sequence/types.js +7 -0
  205. package/dist/vendor/mermaid-ascii/text-metrics.d.ts +24 -0
  206. package/dist/vendor/mermaid-ascii/text-metrics.d.ts.map +1 -0
  207. package/dist/vendor/mermaid-ascii/text-metrics.js +69 -0
  208. package/dist/vendor/mermaid-ascii/types.d.ts +115 -0
  209. package/dist/vendor/mermaid-ascii/types.d.ts.map +1 -0
  210. package/dist/vendor/mermaid-ascii/types.js +4 -0
  211. package/dist/vendor/mermaid-ascii/xychart/colors.d.ts +26 -0
  212. package/dist/vendor/mermaid-ascii/xychart/colors.d.ts.map +1 -0
  213. package/dist/vendor/mermaid-ascii/xychart/colors.js +145 -0
  214. package/dist/vendor/mermaid-ascii/xychart/parser.d.ts +7 -0
  215. package/dist/vendor/mermaid-ascii/xychart/parser.d.ts.map +1 -0
  216. package/dist/vendor/mermaid-ascii/xychart/parser.js +105 -0
  217. package/dist/vendor/mermaid-ascii/xychart/types.d.ts +146 -0
  218. package/dist/vendor/mermaid-ascii/xychart/types.d.ts.map +1 -0
  219. package/dist/vendor/mermaid-ascii/xychart/types.js +8 -0
  220. package/dist/virtual-terminal.d.ts +80 -0
  221. package/dist/virtual-terminal.d.ts.map +1 -0
  222. package/dist/virtual-terminal.js +284 -0
  223. package/dist/word-navigation.d.ts +25 -0
  224. package/dist/word-navigation.d.ts.map +1 -0
  225. package/dist/word-navigation.js +97 -0
  226. package/package.json +38 -0
@@ -0,0 +1,360 @@
1
+ /**
2
+ * StdinBuffer buffers input and emits complete sequences.
3
+ *
4
+ * This is necessary because stdin data events can arrive in partial chunks,
5
+ * especially for escape sequences like mouse events. Without buffering,
6
+ * partial sequences can be misinterpreted as regular keypresses.
7
+ *
8
+ * For example, the mouse SGR sequence `\x1b[<35;20;5m` might arrive as:
9
+ * - Event 1: `\x1b`
10
+ * - Event 2: `[<35`
11
+ * - Event 3: `;20;5m`
12
+ *
13
+ * The buffer accumulates these until a complete sequence is detected.
14
+ * Call the `process()` method to feed input data.
15
+ *
16
+ * Based on code from OpenTUI (https://github.com/anomalyco/opentui)
17
+ * MIT License - Copyright (c) 2025 opentui
18
+ */
19
+ import { EventEmitter } from "events";
20
+ const ESC = "\x1b";
21
+ const BRACKETED_PASTE_START = "\x1b[200~";
22
+ const BRACKETED_PASTE_END = "\x1b[201~";
23
+ /**
24
+ * Check if a string is a complete escape sequence or needs more data
25
+ */
26
+ function isCompleteSequence(data) {
27
+ if (!data.startsWith(ESC)) {
28
+ return "not-escape";
29
+ }
30
+ if (data.length === 1) {
31
+ return "incomplete";
32
+ }
33
+ const afterEsc = data.slice(1);
34
+ // CSI sequences: ESC [
35
+ if (afterEsc.startsWith("[")) {
36
+ // Check for old-style mouse sequence: ESC[M + 3 bytes
37
+ if (afterEsc.startsWith("[M")) {
38
+ // Old-style mouse needs ESC[M + 3 bytes = 6 total
39
+ return data.length >= 6 ? "complete" : "incomplete";
40
+ }
41
+ return isCompleteCsiSequence(data);
42
+ }
43
+ // OSC sequences: ESC ]
44
+ if (afterEsc.startsWith("]")) {
45
+ return isCompleteOscSequence(data);
46
+ }
47
+ // DCS sequences: ESC P ... ESC \ (includes XTVersion responses)
48
+ if (afterEsc.startsWith("P")) {
49
+ return isCompleteDcsSequence(data);
50
+ }
51
+ // APC sequences: ESC _ ... ESC \ (includes Kitty graphics responses)
52
+ if (afterEsc.startsWith("_")) {
53
+ return isCompleteApcSequence(data);
54
+ }
55
+ // SS3 sequences: ESC O
56
+ if (afterEsc.startsWith("O")) {
57
+ // ESC O followed by a single character
58
+ return afterEsc.length >= 2 ? "complete" : "incomplete";
59
+ }
60
+ // Meta key sequences: ESC followed by a single character
61
+ if (afterEsc.length === 1) {
62
+ return "complete";
63
+ }
64
+ // Unknown escape sequence - treat as complete
65
+ return "complete";
66
+ }
67
+ /**
68
+ * Check if CSI sequence is complete
69
+ * CSI sequences: ESC [ ... followed by a final byte (0x40-0x7E)
70
+ */
71
+ function isCompleteCsiSequence(data) {
72
+ if (!data.startsWith(`${ESC}[`)) {
73
+ return "complete";
74
+ }
75
+ // Need at least ESC [ and one more character
76
+ if (data.length < 3) {
77
+ return "incomplete";
78
+ }
79
+ const payload = data.slice(2);
80
+ // CSI sequences end with a byte in the range 0x40-0x7E (@-~)
81
+ // This includes all letters and several special characters
82
+ const lastChar = payload[payload.length - 1];
83
+ const lastCharCode = lastChar.charCodeAt(0);
84
+ if (lastCharCode >= 0x40 && lastCharCode <= 0x7e) {
85
+ // Special handling for SGR mouse sequences
86
+ // Format: ESC[<B;X;Ym or ESC[<B;X;YM
87
+ if (payload.startsWith("<")) {
88
+ // Must have format: <digits;digits;digits[Mm]
89
+ const mouseMatch = /^<\d+;\d+;\d+[Mm]$/.test(payload);
90
+ if (mouseMatch) {
91
+ return "complete";
92
+ }
93
+ // If it ends with M or m but doesn't match the pattern, still incomplete
94
+ if (lastChar === "M" || lastChar === "m") {
95
+ // Check if we have the right structure
96
+ const parts = payload.slice(1, -1).split(";");
97
+ if (parts.length === 3 && parts.every((p) => /^\d+$/.test(p))) {
98
+ return "complete";
99
+ }
100
+ }
101
+ return "incomplete";
102
+ }
103
+ return "complete";
104
+ }
105
+ return "incomplete";
106
+ }
107
+ /**
108
+ * Check if OSC sequence is complete
109
+ * OSC sequences: ESC ] ... ST (where ST is ESC \ or BEL)
110
+ */
111
+ function isCompleteOscSequence(data) {
112
+ if (!data.startsWith(`${ESC}]`)) {
113
+ return "complete";
114
+ }
115
+ // OSC sequences end with ST (ESC \) or BEL (\x07)
116
+ if (data.endsWith(`${ESC}\\`) || data.endsWith("\x07")) {
117
+ return "complete";
118
+ }
119
+ return "incomplete";
120
+ }
121
+ /**
122
+ * Check if DCS (Device Control String) sequence is complete
123
+ * DCS sequences: ESC P ... ST (where ST is ESC \)
124
+ * Used for XTVersion responses like ESC P >| ... ESC \
125
+ */
126
+ function isCompleteDcsSequence(data) {
127
+ if (!data.startsWith(`${ESC}P`)) {
128
+ return "complete";
129
+ }
130
+ // DCS sequences end with ST (ESC \)
131
+ if (data.endsWith(`${ESC}\\`)) {
132
+ return "complete";
133
+ }
134
+ return "incomplete";
135
+ }
136
+ /**
137
+ * Check if APC (Application Program Command) sequence is complete
138
+ * APC sequences: ESC _ ... ST (where ST is ESC \)
139
+ * Used for Kitty graphics responses like ESC _ G ... ESC \
140
+ */
141
+ function isCompleteApcSequence(data) {
142
+ if (!data.startsWith(`${ESC}_`)) {
143
+ return "complete";
144
+ }
145
+ // APC sequences end with ST (ESC \)
146
+ if (data.endsWith(`${ESC}\\`)) {
147
+ return "complete";
148
+ }
149
+ return "incomplete";
150
+ }
151
+ /**
152
+ * Split accumulated buffer into complete sequences
153
+ */
154
+ function parseUnmodifiedKittyPrintableCodepoint(sequence) {
155
+ const match = sequence.match(/^\x1b\[(\d+)(?::\d*)?(?::\d+)?u$/);
156
+ if (!match)
157
+ return undefined;
158
+ const codepoint = parseInt(match[1], 10);
159
+ return codepoint >= 32 ? codepoint : undefined;
160
+ }
161
+ function extractCompleteSequences(buffer) {
162
+ const sequences = [];
163
+ let pos = 0;
164
+ while (pos < buffer.length) {
165
+ const remaining = buffer.slice(pos);
166
+ // Try to extract a sequence starting at this position
167
+ if (remaining.startsWith(ESC)) {
168
+ // Find the end of this escape sequence
169
+ let seqEnd = 1;
170
+ while (seqEnd <= remaining.length) {
171
+ const candidate = remaining.slice(0, seqEnd);
172
+ const status = isCompleteSequence(candidate);
173
+ if (status === "complete") {
174
+ // WezTerm with enable_kitty_keyboard sends the Escape key press as a
175
+ // raw '\x1b' byte (simple text path in encode_kitty, ignoring
176
+ // DISAMBIGUATE_ESCAPE_CODES) and the release as a full Kitty CSI-u
177
+ // sequence. These arrive concatenated as '\x1b\x1b[27;...u'.
178
+ // The buffer would normally treat '\x1b\x1b' as a complete meta-key
179
+ // sequence (ESC + single char), leaving '[27;...u' to be typed as
180
+ // plain text. If the character immediately following '\x1b\x1b'
181
+ // would begin a new escape sequence, emit only the first ESC and
182
+ // restart from the second.
183
+ if (candidate === "\x1b\x1b") {
184
+ const nextChar = remaining[seqEnd];
185
+ if (nextChar === "[" || // CSI
186
+ nextChar === "]" || // OSC
187
+ nextChar === "O" || // SS3
188
+ nextChar === "P" || // DCS
189
+ nextChar === "_" // APC
190
+ ) {
191
+ sequences.push(ESC);
192
+ pos += 1;
193
+ break;
194
+ }
195
+ }
196
+ sequences.push(candidate);
197
+ pos += seqEnd;
198
+ break;
199
+ }
200
+ else if (status === "incomplete") {
201
+ seqEnd++;
202
+ }
203
+ else {
204
+ // Should not happen when starting with ESC
205
+ sequences.push(candidate);
206
+ pos += seqEnd;
207
+ break;
208
+ }
209
+ }
210
+ if (seqEnd > remaining.length) {
211
+ return { sequences, remainder: remaining };
212
+ }
213
+ }
214
+ else {
215
+ // Not an escape sequence - take a single character
216
+ sequences.push(remaining[0]);
217
+ pos++;
218
+ }
219
+ }
220
+ return { sequences, remainder: "" };
221
+ }
222
+ /**
223
+ * Buffers stdin input and emits complete sequences via the 'data' event.
224
+ * Handles partial escape sequences that arrive across multiple chunks.
225
+ */
226
+ export class StdinBuffer extends EventEmitter {
227
+ buffer = "";
228
+ timeout = null;
229
+ timeoutMs;
230
+ pasteMode = false;
231
+ pasteBuffer = "";
232
+ pendingKittyPrintableCodepoint;
233
+ constructor(options = {}) {
234
+ super();
235
+ this.timeoutMs = options.timeout ?? 10;
236
+ }
237
+ process(data) {
238
+ // Clear any pending timeout
239
+ if (this.timeout) {
240
+ clearTimeout(this.timeout);
241
+ this.timeout = null;
242
+ }
243
+ // Handle high-byte conversion (for compatibility with parseKeypress)
244
+ // If buffer has single byte > 127, convert to ESC + (byte - 128)
245
+ let str;
246
+ if (Buffer.isBuffer(data)) {
247
+ if (data.length === 1 && data[0] > 127) {
248
+ const byte = data[0] - 128;
249
+ str = `\x1b${String.fromCharCode(byte)}`;
250
+ }
251
+ else {
252
+ str = data.toString();
253
+ }
254
+ }
255
+ else {
256
+ str = data;
257
+ }
258
+ if (str.length === 0 && this.buffer.length === 0) {
259
+ this.emitDataSequence("");
260
+ return;
261
+ }
262
+ this.buffer += str;
263
+ if (this.pasteMode) {
264
+ this.pasteBuffer += this.buffer;
265
+ this.buffer = "";
266
+ const endIndex = this.pasteBuffer.indexOf(BRACKETED_PASTE_END);
267
+ if (endIndex !== -1) {
268
+ const pastedContent = this.pasteBuffer.slice(0, endIndex);
269
+ const remaining = this.pasteBuffer.slice(endIndex + BRACKETED_PASTE_END.length);
270
+ this.pasteMode = false;
271
+ this.pasteBuffer = "";
272
+ this.pendingKittyPrintableCodepoint = undefined;
273
+ this.emit("paste", pastedContent);
274
+ if (remaining.length > 0) {
275
+ this.process(remaining);
276
+ }
277
+ }
278
+ return;
279
+ }
280
+ const startIndex = this.buffer.indexOf(BRACKETED_PASTE_START);
281
+ if (startIndex !== -1) {
282
+ if (startIndex > 0) {
283
+ const beforePaste = this.buffer.slice(0, startIndex);
284
+ const result = extractCompleteSequences(beforePaste);
285
+ for (const sequence of result.sequences) {
286
+ this.emitDataSequence(sequence);
287
+ }
288
+ }
289
+ this.pendingKittyPrintableCodepoint = undefined;
290
+ this.buffer = this.buffer.slice(startIndex + BRACKETED_PASTE_START.length);
291
+ this.pasteMode = true;
292
+ this.pasteBuffer = this.buffer;
293
+ this.buffer = "";
294
+ const endIndex = this.pasteBuffer.indexOf(BRACKETED_PASTE_END);
295
+ if (endIndex !== -1) {
296
+ const pastedContent = this.pasteBuffer.slice(0, endIndex);
297
+ const remaining = this.pasteBuffer.slice(endIndex + BRACKETED_PASTE_END.length);
298
+ this.pasteMode = false;
299
+ this.pasteBuffer = "";
300
+ this.pendingKittyPrintableCodepoint = undefined;
301
+ this.emit("paste", pastedContent);
302
+ if (remaining.length > 0) {
303
+ this.process(remaining);
304
+ }
305
+ }
306
+ return;
307
+ }
308
+ const result = extractCompleteSequences(this.buffer);
309
+ this.buffer = result.remainder;
310
+ for (const sequence of result.sequences) {
311
+ this.emitDataSequence(sequence);
312
+ }
313
+ if (this.buffer.length > 0) {
314
+ this.timeout = setTimeout(() => {
315
+ const flushed = this.flush();
316
+ for (const sequence of flushed) {
317
+ this.emitDataSequence(sequence);
318
+ }
319
+ }, this.timeoutMs);
320
+ }
321
+ }
322
+ emitDataSequence(sequence) {
323
+ const rawCodepoint = sequence.length === 1 ? sequence.codePointAt(0) : undefined;
324
+ if (rawCodepoint !== undefined && rawCodepoint === this.pendingKittyPrintableCodepoint) {
325
+ this.pendingKittyPrintableCodepoint = undefined;
326
+ return;
327
+ }
328
+ this.pendingKittyPrintableCodepoint = parseUnmodifiedKittyPrintableCodepoint(sequence);
329
+ this.emit("data", sequence);
330
+ }
331
+ flush() {
332
+ if (this.timeout) {
333
+ clearTimeout(this.timeout);
334
+ this.timeout = null;
335
+ }
336
+ if (this.buffer.length === 0) {
337
+ return [];
338
+ }
339
+ const sequences = [this.buffer];
340
+ this.buffer = "";
341
+ this.pendingKittyPrintableCodepoint = undefined;
342
+ return sequences;
343
+ }
344
+ clear() {
345
+ if (this.timeout) {
346
+ clearTimeout(this.timeout);
347
+ this.timeout = null;
348
+ }
349
+ this.buffer = "";
350
+ this.pasteMode = false;
351
+ this.pasteBuffer = "";
352
+ this.pendingKittyPrintableCodepoint = undefined;
353
+ }
354
+ getBuffer() {
355
+ return this.buffer;
356
+ }
357
+ destroy() {
358
+ this.clear();
359
+ }
360
+ }
@@ -0,0 +1,10 @@
1
+ export interface RgbColor {
2
+ r: number;
3
+ g: number;
4
+ b: number;
5
+ }
6
+ export type TerminalColorScheme = "dark" | "light";
7
+ export declare function isOsc11BackgroundColorResponse(data: string): boolean;
8
+ export declare function parseOsc11BackgroundColor(data: string): RgbColor | undefined;
9
+ export declare function parseTerminalColorSchemeReport(data: string): TerminalColorScheme | undefined;
10
+ //# sourceMappingURL=terminal-colors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"terminal-colors.d.ts","sourceRoot":"","sources":["../src/terminal-colors.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,OAAO,CAAC;AAwBnD,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpE;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CA8B5E;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAM5F"}
@@ -0,0 +1,58 @@
1
+ function hexToRgb(hex) {
2
+ const normalized = hex.startsWith("#") ? hex.slice(1) : hex;
3
+ const r = parseInt(normalized.slice(0, 2), 16);
4
+ const g = parseInt(normalized.slice(2, 4), 16);
5
+ const b = parseInt(normalized.slice(4, 6), 16);
6
+ return { r, g, b };
7
+ }
8
+ function parseOscHexChannel(channel) {
9
+ if (!/^[0-9a-f]+$/i.test(channel)) {
10
+ return undefined;
11
+ }
12
+ const max = 16 ** channel.length - 1;
13
+ if (max <= 0) {
14
+ return undefined;
15
+ }
16
+ return Math.round((parseInt(channel, 16) / max) * 255);
17
+ }
18
+ const OSC11_BACKGROUND_COLOR_RESPONSE_PATTERN = /^\x1b\]11;([^\x07\x1b]*)(?:\x07|\x1b\\)$/i;
19
+ const COLOR_SCHEME_REPORT_PATTERN = /^\x1b\[\?997;(1|2)n$/;
20
+ export function isOsc11BackgroundColorResponse(data) {
21
+ return OSC11_BACKGROUND_COLOR_RESPONSE_PATTERN.test(data);
22
+ }
23
+ export function parseOsc11BackgroundColor(data) {
24
+ const match = data.match(OSC11_BACKGROUND_COLOR_RESPONSE_PATTERN);
25
+ if (!match) {
26
+ return undefined;
27
+ }
28
+ const value = match[1].trim();
29
+ if (value.startsWith("#")) {
30
+ const hex = value.slice(1);
31
+ if (/^[0-9a-f]{6}$/i.test(hex)) {
32
+ return hexToRgb(value);
33
+ }
34
+ if (/^[0-9a-f]{12}$/i.test(hex)) {
35
+ const r = parseOscHexChannel(hex.slice(0, 4));
36
+ const g = parseOscHexChannel(hex.slice(4, 8));
37
+ const b = parseOscHexChannel(hex.slice(8, 12));
38
+ return r !== undefined && g !== undefined && b !== undefined ? { r, g, b } : undefined;
39
+ }
40
+ return undefined;
41
+ }
42
+ const rgbValue = value.replace(/^rgba?:/i, "");
43
+ const [red, green, blue] = rgbValue.split("/");
44
+ if (red === undefined || green === undefined || blue === undefined) {
45
+ return undefined;
46
+ }
47
+ const r = parseOscHexChannel(red);
48
+ const g = parseOscHexChannel(green);
49
+ const b = parseOscHexChannel(blue);
50
+ return r !== undefined && g !== undefined && b !== undefined ? { r, g, b } : undefined;
51
+ }
52
+ export function parseTerminalColorSchemeReport(data) {
53
+ const match = data.match(COLOR_SCHEME_REPORT_PATTERN);
54
+ if (!match) {
55
+ return undefined;
56
+ }
57
+ return match[1] === "2" ? "light" : "dark";
58
+ }
@@ -0,0 +1,90 @@
1
+ export type ImageProtocol = "kitty" | "iterm2" | null;
2
+ export interface TerminalCapabilities {
3
+ images: ImageProtocol;
4
+ trueColor: boolean;
5
+ hyperlinks: boolean;
6
+ }
7
+ export interface CellDimensions {
8
+ widthPx: number;
9
+ heightPx: number;
10
+ }
11
+ export interface ImageDimensions {
12
+ widthPx: number;
13
+ heightPx: number;
14
+ }
15
+ export interface ImageRenderOptions {
16
+ maxWidthCells?: number;
17
+ maxHeightCells?: number;
18
+ preserveAspectRatio?: boolean;
19
+ /** Kitty image ID. If provided, reuses/replaces existing image with this ID. */
20
+ imageId?: number;
21
+ /** Whether Kitty should apply its default cursor movement after placement. */
22
+ moveCursor?: boolean;
23
+ }
24
+ export declare function getCellDimensions(): CellDimensions;
25
+ export declare function setCellDimensions(dims: CellDimensions): void;
26
+ export declare function detectCapabilities(tmuxForwardsHyperlink?: () => boolean): TerminalCapabilities;
27
+ export declare function getCapabilities(): TerminalCapabilities;
28
+ export declare function resetCapabilitiesCache(): void;
29
+ /** Override the cached capabilities. Useful in tests to exercise both code paths. */
30
+ export declare function setCapabilities(caps: TerminalCapabilities): void;
31
+ export declare function isImageLine(line: string): boolean;
32
+ /**
33
+ * Generate a random image ID for Kitty graphics protocol.
34
+ * Uses random IDs to avoid collisions between different module instances
35
+ * (e.g., main app vs extensions).
36
+ */
37
+ export declare function allocateImageId(): number;
38
+ export declare function encodeKitty(base64Data: string, options?: {
39
+ columns?: number;
40
+ rows?: number;
41
+ imageId?: number;
42
+ /** Whether Kitty should apply its default cursor movement after placement. Default: true. */
43
+ moveCursor?: boolean;
44
+ }): string;
45
+ /**
46
+ * Delete a Kitty graphics image by ID.
47
+ * Uses uppercase 'I' to also free the image data.
48
+ */
49
+ export declare function deleteKittyImage(imageId: number): string;
50
+ /**
51
+ * Delete all visible Kitty graphics images.
52
+ * Uses uppercase 'A' to also free the image data.
53
+ */
54
+ export declare function deleteAllKittyImages(): string;
55
+ export declare function encodeITerm2(base64Data: string, options?: {
56
+ width?: number | string;
57
+ height?: number | string;
58
+ name?: string;
59
+ preserveAspectRatio?: boolean;
60
+ inline?: boolean;
61
+ }): string;
62
+ export interface ImageCellSize {
63
+ columns: number;
64
+ rows: number;
65
+ }
66
+ export declare function calculateImageCellSize(imageDimensions: ImageDimensions, maxWidthCells: number, maxHeightCells?: number, cellDimensions?: CellDimensions): ImageCellSize;
67
+ export declare function calculateImageRows(imageDimensions: ImageDimensions, targetWidthCells: number, cellDimensions?: CellDimensions): number;
68
+ export declare function getPngDimensions(base64Data: string): ImageDimensions | null;
69
+ export declare function getJpegDimensions(base64Data: string): ImageDimensions | null;
70
+ export declare function getGifDimensions(base64Data: string): ImageDimensions | null;
71
+ export declare function getWebpDimensions(base64Data: string): ImageDimensions | null;
72
+ export declare function getImageDimensions(base64Data: string, mimeType: string): ImageDimensions | null;
73
+ export declare function renderImage(base64Data: string, imageDimensions: ImageDimensions, options?: ImageRenderOptions): {
74
+ sequence: string;
75
+ rows: number;
76
+ imageId?: number;
77
+ } | null;
78
+ /**
79
+ * Wrap text in an OSC 8 hyperlink sequence.
80
+ * The text is rendered as a clickable hyperlink in terminals that support OSC 8
81
+ * (Ghostty, Kitty, WezTerm, iTerm2, VSCode, and others).
82
+ * In terminals that do not support OSC 8, the escape sequences are ignored
83
+ * and only the plain text is displayed.
84
+ *
85
+ * @param text - The visible text to display
86
+ * @param url - The URL to link to
87
+ */
88
+ export declare function hyperlink(text: string, url: string): string;
89
+ export declare function imageFallback(mimeType: string, dimensions?: ImageDimensions, filename?: string): string;
90
+ //# sourceMappingURL=terminal-image.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"terminal-image.d.ts","sourceRoot":"","sources":["../src/terminal-image.ts"],"names":[],"mappings":"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"}