minicode-ai 0.9.29 → 0.11.0

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 (141) hide show
  1. package/AGENTS.md +45 -0
  2. package/CHANGELOG.md +79 -1
  3. package/PLAN.md +491 -0
  4. package/README.md +2 -2
  5. package/cli/args.ts +1 -0
  6. package/cli/commands/acp.ts +485 -0
  7. package/cli/commands/auth.ts +7 -4
  8. package/cli/commands/config.ts +41 -27
  9. package/cli/commands/exec.ts +33 -12
  10. package/cli/commands/mcp.ts +3 -2
  11. package/cli/commands/memory.ts +1 -1
  12. package/cli/commands/pricing.ts +6 -4
  13. package/cli/commands/providers.ts +18 -8
  14. package/cli/commands/sessions.ts +11 -4
  15. package/cli/commands/skills.ts +3 -3
  16. package/cli/commands/stats.ts +3 -1
  17. package/cli/commands.ts +225 -103
  18. package/cli/index.ts +89 -62
  19. package/cli/model-manager.ts +8 -8
  20. package/cli/provider-manager.ts +13 -13
  21. package/cli/router.ts +7 -0
  22. package/cli/setup.ts +349 -4
  23. package/cli/tui.ts +542 -0
  24. package/cli/wizard.ts +2 -1
  25. package/docs/ARCHITECTURE.html +62 -36
  26. package/docs/CONTROL-PLANE-MAP.md +139 -0
  27. package/docs/HARNESS.md +150 -0
  28. package/docs/PLAN_UIUX_V6.md +209 -0
  29. package/docs/README.md +1 -1
  30. package/docs/SUMMARY.md +52 -0
  31. package/docs/TERMINAL_CONTRACT.md +367 -0
  32. package/docs/UI_RENDER_PIPELINE.md +165 -0
  33. package/docs/USAGE.md +11 -0
  34. package/docs/agents.md +31 -0
  35. package/docs/architecture.md +3 -3
  36. package/docs/choosing-mode.md +34 -0
  37. package/docs/cli.md +130 -0
  38. package/docs/concepts.md +53 -0
  39. package/docs/config-providers.md +87 -0
  40. package/docs/config.md +63 -0
  41. package/docs/contributing.md +79 -0
  42. package/docs/environment.md +95 -0
  43. package/docs/exec.md +73 -0
  44. package/docs/getting-started.md +102 -0
  45. package/docs/glossary.md +37 -0
  46. package/docs/mcp-lsp.md +54 -0
  47. package/docs/memory-sessions.md +63 -0
  48. package/docs/policy-sandbox.md +72 -0
  49. package/docs/pricing-budget.md +49 -0
  50. package/docs/quickstart.md +60 -0
  51. package/docs/repl.md +67 -0
  52. package/docs/security-model.md +95 -0
  53. package/docs/security.md +91 -0
  54. package/docs/skills.md +48 -0
  55. package/docs/terminal.md +79 -0
  56. package/docs/tools.md +123 -0
  57. package/docs/troubleshooting.md +40 -0
  58. package/docs/verify-benchmark.md +58 -0
  59. package/package.json +8 -5
  60. package/src/app/provider-layer.ts +12 -4
  61. package/src/app/rag-layer.ts +7 -2
  62. package/src/app/session.ts +6 -0
  63. package/src/app/tool-layer.ts +2 -1
  64. package/src/config.ts +30 -1
  65. package/src/constants.ts +35 -0
  66. package/src/lib/net.ts +6 -1
  67. package/src/lsp/client.ts +41 -8
  68. package/src/mcp/http-transport.ts +52 -15
  69. package/src/mcp/transport.ts +32 -1
  70. package/src/memory/files.ts +6 -5
  71. package/src/policy/allowlist.ts +1 -1
  72. package/src/policy/bash-guard.ts +213 -17
  73. package/src/policy/compaction.ts +57 -3
  74. package/src/policy/context.ts +4 -0
  75. package/src/policy/jail.ts +49 -4
  76. package/src/policy/permission.ts +152 -12
  77. package/src/policy/pricing.ts +12 -9
  78. package/src/policy/update-check.ts +4 -1
  79. package/src/presentation/adapter.ts +721 -0
  80. package/src/presentation/events.ts +324 -0
  81. package/src/presentation/label.ts +140 -0
  82. package/src/presentation/model.ts +172 -0
  83. package/src/presentation/reducer.ts +486 -0
  84. package/src/presentation/store.ts +256 -0
  85. package/src/providers/anthropic.ts +22 -4
  86. package/src/providers/detect.ts +2 -1
  87. package/src/providers/router.ts +13 -0
  88. package/src/repo/repomap.ts +2 -29
  89. package/src/session/checkpoint.ts +27 -9
  90. package/src/session/journal.ts +27 -5
  91. package/src/skills/loader.ts +88 -5
  92. package/src/telemetry/trace.ts +36 -15
  93. package/src/tools/ask_user.ts +73 -4
  94. package/src/tools/bash.ts +23 -17
  95. package/src/tools/glob.ts +10 -11
  96. package/src/tools/lsp.ts +3 -56
  97. package/src/tools/memory.ts +13 -12
  98. package/src/tools/task.ts +7 -1
  99. package/src/tools/web_fetch.ts +11 -2
  100. package/src/tools/web_search.ts +4 -1
  101. package/src/ui/approval/prompt.ts +96 -22
  102. package/src/ui/assistant/simple.ts +188 -44
  103. package/src/ui/assistant/turn-status.ts +32 -10
  104. package/src/ui/contract.ts +119 -0
  105. package/src/ui/footer.ts +35 -14
  106. package/src/ui/i18n/en.ts +253 -0
  107. package/src/ui/i18n/id.ts +255 -0
  108. package/src/ui/i18n/locale.ts +68 -0
  109. package/src/ui/input/input.ts +189 -81
  110. package/src/ui/input/prompt-engine.ts +139 -4
  111. package/src/ui/render/collapse.ts +20 -13
  112. package/src/ui/render/diff.ts +7 -2
  113. package/src/ui/render/errors.ts +75 -50
  114. package/src/ui/render/format.ts +26 -8
  115. package/src/ui/render/highlight.ts +12 -5
  116. package/src/ui/render/markdown.ts +5 -1
  117. package/src/ui/render/sanitize.ts +29 -2
  118. package/src/ui/render/table.ts +12 -6
  119. package/src/ui/render/theme.ts +23 -4
  120. package/src/ui/render/width.ts +104 -17
  121. package/src/ui/runtime/motion.ts +16 -0
  122. package/src/ui/runtime/screen.ts +242 -0
  123. package/src/ui/runtime/spinner.ts +50 -4
  124. package/src/ui/runtime/statusline.ts +50 -1
  125. package/src/ui/screens/dialog.ts +174 -0
  126. package/src/ui/screens/form.ts +486 -0
  127. package/src/ui/screens/model-manager.ts +289 -134
  128. package/src/ui/screens/picker.ts +264 -109
  129. package/src/ui/screens/provider-manager.ts +385 -172
  130. package/src/ui/screens/wizard.ts +165 -102
  131. package/src/ui/tui/app.ts +951 -0
  132. package/src/ui/tui/transcript.ts +475 -0
  133. package/vendor/minicore/LICENSE +21 -0
  134. package/vendor/minicore/VENDOR.md +6 -3
  135. package/vendor/minicore/package.json +6 -3
  136. package/vendor/minicore/src/core/loop.ts +12 -2
  137. package/vendor/minicore/src/core/snapshot.ts +4 -0
  138. package/vendor/minicore/src/providers/openai-compat.ts +76 -25
  139. package/cli/repl.ts +0 -740
  140. package/src/ui/runtime/chrome.ts +0 -369
  141. package/src/ui/screens/overlay.ts +0 -61
@@ -1,15 +1,19 @@
1
1
  // Modal picker - searchable, VS Code palette
2
2
 
3
+ import { t } from "../i18n/locale.ts"
3
4
  import {
4
5
  createDecoderState,
6
+ createKeyStreamPump,
7
+ type DecodedKey,
5
8
  type DecoderState,
6
- decodeKeysStream,
7
9
  toGraphemes,
8
10
  } from "../input/prompt-engine.ts"
9
11
  import { sanitizeAnsiLine } from "../render/sanitize.ts"
10
- import { c } from "../render/theme.ts"
11
- import { truncateToWidth } from "../render/width.ts"
12
- import { clearTransientOverlay, renderTransientOverlay } from "./overlay.ts"
12
+ import { c, stripAnsi } from "../render/theme.ts"
13
+ import { displayWidth, truncateToWidth } from "../render/width.ts"
14
+ import { type AltScreen, openAltScreen } from "../runtime/screen.ts"
15
+ import { beginInteractiveScreen } from "../runtime/statusline.ts"
16
+ import { boxLeftPad, dialogBox } from "./dialog.ts"
13
17
 
14
18
  export interface PickerItem {
15
19
  name: string
@@ -26,11 +30,12 @@ export interface PickerOptions {
26
30
  filterable?: boolean
27
31
  }
28
32
 
29
- const DIM = "\x1b[2m",
30
- RESTORE = "\x1b[22m",
31
- ACC = (s: string) => c.accent(c.bold(s)),
33
+ const dim = (s: string): string => c.dim(s),
32
34
  ACC_DIM = (s: string) => c.accent(s)
33
35
 
36
+ /** Lebar kotak popup picker TETAP (keputusan rasa: geometri stabil). */
37
+ const PICKER_BOX_W = 64
38
+
34
39
  // Tandai substring query di label agar user tahu KENAPA item cocok.
35
40
  // Operasi pada teks plain (sebelum truncate) — SGR bold nol kolom.
36
41
  function highlightMatch(label: string, query: string): string {
@@ -46,8 +51,11 @@ function highlightMatch(label: string, query: string): string {
46
51
 
47
52
  export async function runPicker(opts: PickerOptions): Promise<void> {
48
53
  if (!process.stdin.isTTY) {
54
+ // Pipe/redirect: item dari config (tak-terpercaya) disanitasi agar ANSI
55
+ // mentah tak mencemari output program (kontrak stdout non-TTY).
49
56
  console.log(`\n${opts.title}`)
50
- for (const [i, it] of opts.items.entries()) console.log(` [${i}] ${it.provider}::${it.name}`)
57
+ for (const [i, it] of opts.items.entries())
58
+ console.log(` [${i}] ${sanitizeAnsiLine(it.provider)}::${sanitizeAnsiLine(it.name)}`)
51
59
  console.log("")
52
60
  // Fail-closed: pemanggil nested (mis. pickEffort di /model) menunggu
53
61
  // onPick/onCancel — tanpa ini await-nya gantung selamanya (busy=true)
@@ -62,7 +70,6 @@ export async function runPicker(opts: PickerOptions): Promise<void> {
62
70
  let sel = 0
63
71
  let scroll = 0
64
72
  let filter = ""
65
- let prevRows = 0
66
73
  const isFilterable = opts.filterable ?? false
67
74
 
68
75
  const filteredItems = (): PickerItem[] => {
@@ -83,11 +90,19 @@ export async function runPicker(opts: PickerOptions): Promise<void> {
83
90
  const rows = process.stdout.rows || 24
84
91
  // Sisakan ruang untuk judul, baris filter, baris footer, dan baris sisa.
85
92
  const chrome = isFilterable ? 4 : 3
93
+ // Modal: dialog menambah border/judul/footer di luar jatah view + sisakan
94
+ // 1 baris untuk baris counter ("… N more") agar End selalu sampai dasar.
95
+ if (useModal) return Math.max(1, Math.min(rows - 5, 12))
86
96
  return Math.max(1, Math.min(rows - chrome, 12))
87
97
  }
88
- const width = () => Math.max(8, (process.stdout.columns || 80) - 2)
98
+ // Lebar konten = lebar kotak TETAP (min=max, keputusan rasa: geometri
99
+ // stabil, tak bernapas saat filter) dikurangi chrome dialog
100
+ // (border+padding = 4 kolom) agar dialogBox tak memotong ulang label.
101
+ const width = () =>
102
+ Math.max(8, Math.min((process.stdout.columns || 80) - 2 - 4, PICKER_BOX_W - 4))
89
103
 
90
- const buildLines = (): string[] => {
104
+ // Isi untuk dialog popup (tanpa judul/hint — dialog yang membingkai).
105
+ const bodyLines = (): string[] => {
91
106
  const items = filteredItems()
92
107
  const v = visibleRows()
93
108
  if (sel >= items.length) sel = Math.max(0, items.length - 1)
@@ -99,18 +114,15 @@ export async function runPicker(opts: PickerOptions): Promise<void> {
99
114
  const w = width()
100
115
  const cut = (s: string) => truncateToWidth(s, w)
101
116
  const lines: string[] = []
102
- lines.push(cut(`${DIM}─ ${ACC(opts.title)} ${DIM}─${RESTORE}`))
103
117
  if (isFilterable) {
104
- const placeholderText = opts.placeholder ?? "type to filter"
118
+ const placeholderText = opts.placeholder ?? t("pick.placeholder")
105
119
  // Filter = input user tak terpercaya — sanitasi sebelum tampil.
106
- const display = filter
107
- ? c.brightCyan(sanitizeAnsiLine(filter))
108
- : DIM + placeholderText + RESTORE
109
- const label = filter ? ACC_DIM("Filter:") : `${DIM}Filter:${RESTORE}`
120
+ const display = filter ? c.brightCyan(sanitizeAnsiLine(filter)) : dim(placeholderText)
121
+ const label = filter ? ACC_DIM(t("pick.filter")) : dim(t("pick.filter"))
110
122
  lines.push(cut(`${label} ${display}`))
111
123
  }
112
124
  if (items.length === 0) {
113
- lines.push(cut(`${DIM} No matches for "${sanitizeAnsiLine(filter)}"${RESTORE}`))
125
+ lines.push(cut(dim(` ${t("pick.noMatch", { q: sanitizeAnsiLine(filter) })}`)))
114
126
  return lines
115
127
  }
116
128
  for (let i = 0; i < rows.length; i++) {
@@ -118,34 +130,63 @@ export async function runPicker(opts: PickerOptions): Promise<void> {
118
130
  const picked = i === sel - scroll
119
131
  // Potong label ke KOLOM (CJK 2 kolom), sisakan ruang untuk penanda "› ".
120
132
  // Highlight query DITERAPKAN sebelum truncate agar posisi kolom tepat.
121
- const rawLabel = `${it.provider ? `${it.provider} › ` : ""}${it.name}`
133
+ // Nama di DEPAN (truncasi memakan ekor — id/nama adalah info
134
+ // terpenting dan harus selamat); provider/tanggal sebagai konteks
135
+ // ekor yang boleh terpotong. Sanitasi DULU karena truncateToWidth
136
+ // menyalin semua escape (juga 2J).
137
+ const rawLabel = `${sanitizeAnsiLine(it.name)}${it.provider ? ` — ${sanitizeAnsiLine(it.provider)}` : ""}`
122
138
  const label = highlightMatch(truncateToWidth(rawLabel, w - 4), filter)
123
- if (picked) lines.push(` ${c.accent("›")} ${c.accent(c.bold(label))}${RESTORE}`)
124
- else lines.push(` ${DIM}${label}${RESTORE}`)
139
+ if (picked) lines.push(` ${c.accent("›")} ${c.accent(c.bold(label))}`)
140
+ else lines.push(` ${dim(label)}`)
125
141
  }
126
142
  if (items.length > scroll + v) {
127
- lines.push(cut(`${DIM}… ${c.accent(String(items.length - scroll - v))} more${RESTORE}`))
143
+ lines.push(cut(dim(t("dlg.more", { n: items.length - scroll - v }))))
128
144
  } else if (isFilterable && filter) {
129
145
  lines.push(
130
- cut(`${DIM} ${c.accent(String(items.length))}/${opts.items.length} matches${RESTORE}`),
131
- )
132
- }
133
- // Footer hint — tanpa ini picker (mis. Thinking effort) tak memberi tahu
134
- // tombol apa yang berlaku. DILEWATKAN di terminal pendek (<6 baris):
135
- // di sana footer malah mendorong overlay melebihi layar (diuji ≤ rows).
136
- if ((process.stdout.rows || 24) >= 6) {
137
- lines.push("")
138
- lines.push(
139
- cut(
140
- `${DIM}${isFilterable ? "type to filter · " : ""}↑↓ select · Enter confirm · Esc back${RESTORE}`,
141
- ),
146
+ cut(dim(` ${t("pick.matches", { n: items.length, total: opts.items.length })}`)),
142
147
  )
143
148
  }
144
149
  return lines
145
150
  }
146
151
 
152
+ const hintText = (): string => t("pick.hint")
153
+
147
154
  const render = () => {
148
- prevRows = renderTransientOverlay(buildLines(), prevRows)
155
+ // Popup komposit: HANYA region kotak yang dilukis (tanpa clear) di atas
156
+ // konten pemilik layar (transkrip App / alt-buffer wizard). Pemilik
157
+ // me-repaint penuh saat popup tutup. Lebar TETAP 64 (min=max).
158
+ const box = dialogBox(
159
+ {
160
+ title: opts.title,
161
+ body: bodyLines(),
162
+ footer: hintText(),
163
+ minWidth: PICKER_BOX_W,
164
+ maxWidth: PICKER_BOX_W,
165
+ },
166
+ screen.cols,
167
+ screen.rows,
168
+ )
169
+ screen.paintRegion(box.lines, box.topRow)
170
+ // Parkir kursor: saat filter terisi, user sedang mengetik → kursor di
171
+ // ujung teks filter (dulu selalu di baris item = ketik buta). Saat
172
+ // filter kosong, parkir di baris item aktif (navigasi ↑↓).
173
+ // Kolom = padding kiri + border + spasi + lebar label+filter + 1.
174
+ try {
175
+ if (isFilterable && filter !== "") {
176
+ const li = Math.min(box.lines.length - 1, box.bodyTop)
177
+ const row = box.topRow + li
178
+ const leftPad = boxLeftPad(stripAnsi(box.lines[li] ?? ""))
179
+ const col = leftPad + 2 + displayWidth(stripAnsi(`${t("pick.filter")} ${filter}`)) + 1
180
+ process.stdout.write(`\x1b[${row};${Math.max(1, col)}H\x1b[?25h`)
181
+ } else {
182
+ const itemRow = Math.min(Math.max(0, sel - scroll), Math.max(0, visibleRows() - 1))
183
+ const bodyOffset = isFilterable ? 1 : 0
184
+ const li = Math.min(box.lines.length - 1, box.bodyTop + bodyOffset + itemRow)
185
+ const row = box.topRow + li
186
+ const leftPad = boxLeftPad(stripAnsi(box.lines[li] ?? ""))
187
+ process.stdout.write(`\x1b[${row};${Math.max(1, leftPad + 1)}H\x1b[?25h`)
188
+ }
189
+ } catch {}
149
190
  }
150
191
 
151
192
  let done = false
@@ -174,18 +215,64 @@ export async function runPicker(opts: PickerOptions): Promise<void> {
174
215
  }
175
216
  }
176
217
  const decoder: DecoderState = createDecoderState()
218
+ // Seperti manager: simpan batas listener warisan (guard: stdin stub test
219
+ // tak punya getMaxListeners), kembalikan di cleanup agar warning Node
220
+ // tetap berguna setelah sesi ini.
221
+ const prevMaxListeners =
222
+ typeof process.stdin.getMaxListeners === "function" ? process.stdin.getMaxListeners() : 10
223
+ // Popup komposit: layar HARUS mampu (alt-screen + cukup tinggi). Tanpa
224
+ // itu tak ada permukaan popup — tolak BERSUARA + batal (fail-closed).
225
+ // Jalur overlay inline dihapus: satu-satunya tampilan interaktif adalah
226
+ // TUI fullscreen (atau alt-buffer wizard first-run).
227
+ const screen: AltScreen = openAltScreen()
228
+ const useModal = screen.ok && (process.stdout.rows || 24) >= 10
229
+ if (!useModal) {
230
+ try {
231
+ console.log(`⚠ ${t("gate.tuiPicker", { title: opts.title })}`)
232
+ } catch {}
233
+ try {
234
+ opts.onCancel()
235
+ } catch {}
236
+ // Tutup layar sebelum batal: openAltScreen sudah menulis ENTER fisik
237
+ // (?1049h) — bail tanpa close membocorkan alt-screen (terminal tertinggal
238
+ // di buffer alternatif) dan hold painter-nya (I27) tidak pernah lepas.
239
+ try {
240
+ screen.close()
241
+ } catch {}
242
+ resolve()
243
+ return
244
+ }
245
+ // Raw mode (sama seperti askLine/askSecret): picker juga menghalangi
246
+ // painter transient stderr melukis di baris yang sama. Jalur ini aktif
247
+ // bahkan saat runPicker dipanggil langsung (bukan lewat wizard), misalnya
248
+ // di bawah alt-screen App yang painter-nya sudah ditahan — hold nested dan
249
+ // release-nya idempoten.
250
+ const endScreen = beginInteractiveScreen()
177
251
  const cleanup = () => {
178
252
  if (done) return
179
253
  done = true
254
+ try {
255
+ pickerPump.dispose()
256
+ } catch {}
257
+ try {
258
+ process.stdin.setMaxListeners(prevMaxListeners)
259
+ } catch {}
180
260
  if (idleTimer) clearTimeout(idleTimer)
181
- prevRows = clearTransientOverlay(prevRows)
261
+ // Lepas kepemilikan layar: painter boleh melukis lagi setelah ini
262
+ // (kursor sudah kembali ke anchor, overlay sudah dibersihkan).
263
+ endScreen()
264
+ // Hapus region popup sendiri; pemilik layar (App.resume) repaint penuh,
265
+ // standalone (wizard) membuang alt-buffer utuh via close.
266
+ try {
267
+ screen.clearRegion()
268
+ } catch {}
269
+ try {
270
+ screen.close()
271
+ } catch {}
182
272
  process.stdout.write("\x1b[0m\x1b[?25h")
183
- // TIDAK menulis \r\n di sini: clearTransientOverlay sudah menaruh kursor
184
- // kembali ke anchor. \r\n membuat baris kosong permanen di scrollback
185
- // (append-only) tiap picker dipakai — terlihat sebagai gap saat picker
186
- // nested di dalam manager (mis. Enter → Thinking effort di /model).
187
- // Pemanggil lanjutan (askLine/manager resume) menulis dari anchor; baris
188
- // anchor selalu baris kosong segar (pemanggil memulai dari akhir output).
273
+ // TIDAK menulis \r\n di sini: \r\n membuat baris kosong permanen tiap
274
+ // picker dipakai — terlihat sebagai gap saat picker nested di dalam
275
+ // manager (mis. Enter → Thinking effort di /model).
189
276
  try {
190
277
  process.stdin.setRawMode(false)
191
278
  } catch {}
@@ -194,86 +281,150 @@ export async function runPicker(opts: PickerOptions): Promise<void> {
194
281
  if (onResize) process.stdout.removeListener("resize", onResize)
195
282
  }
196
283
 
197
- onData = (chunk: Buffer) => {
198
- resetIdle()
199
- try {
200
- for (const d of decodeKeysStream(chunk, decoder)) {
201
- const items = filteredItems()
202
- switch (d.key.type) {
203
- case "up":
204
- sel = Math.max(0, sel - 1)
284
+ // Jalur tunggal key (sinkron + flush lone-ESC 50ms via pump): panah split
285
+ // tak lagi jadi esc (filter terhapus + picker tertutup). True = selesai.
286
+ const handlePickerKeys = (keys: DecodedKey[]): boolean => {
287
+ for (const d of keys) {
288
+ const items = filteredItems()
289
+ switch (d.key.type) {
290
+ case "up":
291
+ sel = Math.max(0, sel - 1)
292
+ render()
293
+ break
294
+ case "down":
295
+ // Daftar kosong: jangan biarkan sel=-1 (Enter setelah Down lalu
296
+ // filter menghadirkan 1 item akan menunjuk items[-1]=undefined →
297
+ // onCancel padahal ada hasil ter-highlight).
298
+ sel = items.length ? Math.min(items.length - 1, sel + 1) : 0
299
+ render()
300
+ break
301
+ case "char": {
302
+ if (isFilterable) {
303
+ filter += d.key.ch
304
+ sel = 0
305
+ scroll = 0
205
306
  render()
206
- break
207
- case "down":
208
- // Daftar kosong: jangan biarkan sel=-1 (Enter setelah Down lalu
209
- // filter menghadirkan 1 item akan menunjuk items[-1]=undefined →
210
- // onCancel padahal ada hasil ter-highlight).
211
- sel = items.length ? Math.min(items.length - 1, sel + 1) : 0
307
+ }
308
+ break
309
+ }
310
+ case "backspace": {
311
+ if (isFilterable && filter.length > 0) {
312
+ // Hapus satu grapheme (filter bisa berisi emoji/flag).
313
+ const graphemes = toGraphemes(filter)
314
+ graphemes.pop()
315
+ filter = graphemes.join("")
316
+ sel = 0
317
+ scroll = 0
212
318
  render()
213
- break
214
- case "char": {
215
- if (isFilterable) {
216
- filter += d.key.ch
217
- sel = 0
218
- scroll = 0
219
- render()
220
- }
221
- break
222
319
  }
223
- case "backspace": {
224
- if (isFilterable && filter.length > 0) {
225
- // Hapus satu grapheme (filter bisa berisi emoji/flag).
226
- const graphemes = toGraphemes(filter)
227
- graphemes.pop()
228
- filter = graphemes.join("")
229
- sel = 0
230
- scroll = 0
231
- render()
232
- }
233
- break
320
+ break
321
+ }
322
+ case "delete": {
323
+ // Del = edit-teks di semua permukaan (paritas Backspace).
324
+ if (isFilterable && filter.length > 0) {
325
+ const graphemes = toGraphemes(filter)
326
+ graphemes.pop()
327
+ filter = graphemes.join("")
328
+ sel = 0
329
+ scroll = 0
330
+ render()
234
331
  }
235
- case "enter": {
236
- const item = items[sel]
237
- // Perilaku dipertahankan: tanpa hasil, Enter = batal (dikunci
238
- // test). Bug yang diperbaiki adalah sel=-1 setelah Down di
239
- // daftar kosong — item "phantom" yang batal padahal ada hasil.
240
- cleanup()
241
- if (item) opts.onPick(item.value)
242
- else opts.onCancel()
243
- resolve()
244
- return
332
+ break
333
+ }
334
+ case "ctrl-u": {
335
+ // Ctrl+U = clear filter (paritas editor).
336
+ if (isFilterable && filter.length > 0) {
337
+ filter = ""
338
+ sel = 0
339
+ scroll = 0
340
+ render()
245
341
  }
246
- case "esc": {
247
- // Esc pertama membersihkan filter; Esc kedua (filter kosong) keluar.
248
- if (isFilterable && filter.length > 0) {
249
- filter = ""
250
- sel = 0
251
- scroll = 0
252
- render()
253
- break
254
- }
255
- cleanup()
256
- opts.onCancel()
257
- resolve()
258
- return
342
+ break
343
+ }
344
+ case "home": {
345
+ // Home/End = lompat atas/bawah daftar (paritas daftar App).
346
+ sel = 0
347
+ scroll = 0
348
+ render()
349
+ break
350
+ }
351
+ case "end": {
352
+ sel = items.length ? Math.max(0, items.length - 1) : 0
353
+ render()
354
+ break
355
+ }
356
+ case "pageup":
357
+ case "pagedown": {
358
+ // Scroll daftar panjang (… N more) per halaman — paritas App.
359
+ const vis = Math.max(1, Math.min((process.stdout.rows || 24) - 5, 12))
360
+ if (items.length > vis) {
361
+ const page = Math.max(1, vis - 1)
362
+ const maxScroll = Math.max(0, items.length - vis)
363
+ scroll = Math.max(
364
+ 0,
365
+ Math.min(maxScroll, scroll + (d.key.type === "pageup" ? -page : page)),
366
+ )
367
+ sel = Math.max(0, Math.min(items.length - 1, sel))
368
+ if (sel < scroll) sel = scroll
369
+ if (sel >= scroll + vis) sel = scroll + vis - 1
370
+ render()
259
371
  }
260
- case "ctrl-c":
261
- case "ctrl-d":
262
- cleanup()
263
- opts.onCancel()
264
- resolve()
265
- return
266
- default:
372
+ break
373
+ }
374
+ case "enter": {
375
+ const item = items[sel]
376
+ // Perilaku dipertahankan: tanpa hasil, Enter = batal (dikunci
377
+ // test). Bug yang diperbaiki adalah sel=-1 setelah Down di
378
+ // daftar kosong — item "phantom" yang batal padahal ada hasil.
379
+ cleanup()
380
+ if (item) opts.onPick(item.value)
381
+ else opts.onCancel()
382
+ resolve()
383
+ return true
384
+ }
385
+ case "esc": {
386
+ // Esc pertama membersihkan filter; Esc kedua (filter kosong) keluar.
387
+ if (isFilterable && filter.length > 0) {
388
+ filter = ""
389
+ sel = 0
390
+ scroll = 0
391
+ render()
267
392
  break
393
+ }
394
+ cleanup()
395
+ opts.onCancel()
396
+ resolve()
397
+ return true
268
398
  }
399
+ case "ctrl-c":
400
+ case "ctrl-d":
401
+ cleanup()
402
+ opts.onCancel()
403
+ resolve()
404
+ return true
405
+ default:
406
+ break
269
407
  }
270
- } catch {
408
+ }
409
+ return false
410
+ }
411
+ const pickerPump = createKeyStreamPump({ state: decoder, onKeys: handlePickerKeys })
412
+
413
+ onData = (chunk: Buffer) => {
414
+ resetIdle()
415
+ try {
416
+ pickerPump.push(chunk)
417
+ } catch (e) {
271
418
  // Tanpa onCancel+resolve, await runPicker gantung selamanya dan
272
419
  // busy=true bocor di pemanggil nested (= manager terkunci, terlihat
273
420
  // hang). Batal adalah satu-satunya jawaban jujur saat render rusak.
421
+ // Kegagalan ikut BERSUARA (prinsip Fase D: tak ada jendela bisu).
274
422
  try {
275
423
  cleanup()
276
424
  } catch {}
425
+ try {
426
+ console.log(`⚠ ${t("pick.fail", { msg: String((e as Error)?.message ?? e) })}`)
427
+ } catch {}
277
428
  try {
278
429
  opts.onCancel()
279
430
  } catch {}
@@ -292,12 +443,16 @@ export async function runPicker(opts: PickerOptions): Promise<void> {
292
443
  process.stdout.on("resize", onResize)
293
444
  resetIdle()
294
445
  render()
295
- } catch {
446
+ } catch (e) {
296
447
  // Sama seperti di atas: setup gagal (raw-mode ConPTY rusak) harus
297
- // settle, bukan gantung.
448
+ // settle, bukan gantung. Kegagalan BERSUARA (satu baris scrollback),
449
+ // bukan bisu — kelas bug "jendela kosong" hanya bisa diburu bila terlihat.
298
450
  try {
299
451
  cleanup()
300
452
  } catch {}
453
+ try {
454
+ console.log(`⚠ ${t("pick.failOpen", { msg: String((e as Error)?.message ?? e) })}`)
455
+ } catch {}
301
456
  try {
302
457
  opts.onCancel()
303
458
  } catch {}