@linxiraos/pi-tui 1.4.6 → 1.4.7

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 (278) hide show
  1. package/CHANGELOG.md +194 -195
  2. package/README.md +34 -34
  3. package/dist/types/app-keybindings.d.ts +15 -0
  4. package/dist/types/apps/session-picker.d.ts +5 -0
  5. package/dist/types/charts/chart-plan.d.ts +9 -7
  6. package/dist/types/chat/assistant-message.d.ts +15 -3
  7. package/dist/types/chat/bash-execution.d.ts +2 -0
  8. package/dist/types/chat/display-preferences.d.ts +2 -0
  9. package/dist/types/chat/extension-types.d.ts +31 -0
  10. package/dist/types/chat/reply-write.d.ts +48 -0
  11. package/dist/types/chat/table-chart.d.ts +4 -3
  12. package/dist/types/chat/tool-execution.d.ts +1 -2
  13. package/dist/types/chat/transcript-outline.d.ts +7 -0
  14. package/dist/types/chat/transcript-render-helpers.d.ts +2 -0
  15. package/dist/types/chrome/index.d.ts +1 -0
  16. package/dist/types/chrome/transcript-notice.d.ts +35 -0
  17. package/dist/types/chrome/transcript-status.d.ts +20 -8
  18. package/dist/types/components/editor.d.ts +8 -0
  19. package/dist/types/components/markdown.d.ts +7 -0
  20. package/dist/types/native/blobs.d.ts +2 -1
  21. package/dist/types/native/picker.d.ts +4 -4
  22. package/dist/types/overlays/annotation-overlay.d.ts +7 -1
  23. package/dist/types/overlays/annotation-types.d.ts +28 -0
  24. package/dist/types/overlays/login-dialog.d.ts +5 -1
  25. package/dist/types/overlays/model-browser.d.ts +10 -1
  26. package/dist/types/overlays/oauth-selector.d.ts +23 -0
  27. package/dist/types/overlays/plan-review-overlay.d.ts +2 -0
  28. package/dist/types/overlays/rewind-selector.d.ts +1 -1
  29. package/dist/types/overlays/session-selector.d.ts +22 -2
  30. package/dist/types/prompt/composer.d.ts +43 -0
  31. package/dist/types/prompt/interactive-context-helpers.d.ts +10 -3
  32. package/dist/types/render/extension-links.d.ts +65 -0
  33. package/dist/types/render/hyperlink.d.ts +25 -7
  34. package/dist/types/render/index.d.ts +1 -0
  35. package/dist/types/setup/scenes/glyph.d.ts +1 -1
  36. package/dist/types/setup/scenes/model.d.ts +1 -1
  37. package/dist/types/setup/scenes/outro.d.ts +5 -4
  38. package/dist/types/setup/scenes/sign-in.d.ts +13 -8
  39. package/dist/types/setup/scenes/types.d.ts +16 -1
  40. package/dist/types/setup/startup-splash.d.ts +1 -1
  41. package/dist/types/setup/wizard-overlay.d.ts +11 -7
  42. package/dist/types/setup/wizard.d.ts +5 -1
  43. package/dist/types/status-line/component.d.ts +1 -1
  44. package/dist/types/status-line/context-usage.d.ts +28 -6
  45. package/dist/types/status-line/host.d.ts +6 -2
  46. package/dist/types/theme/theme.d.ts +0 -23
  47. package/dist/types/tools/bash-interactive.d.ts +6 -0
  48. package/dist/types/tools/bash.d.ts +2 -0
  49. package/dist/types/tools/default-renderer.d.ts +6 -4
  50. package/dist/types/tools/irc.d.ts +6 -0
  51. package/dist/types/tools/json-tree.d.ts +23 -4
  52. package/dist/types/tools/lsp.d.ts +2 -0
  53. package/dist/types/tools/mcp.d.ts +6 -5
  54. package/dist/types/tools/native-view.d.ts +1 -1
  55. package/dist/types/tools/renderer.d.ts +2 -0
  56. package/dist/types/tools/streaming-output.d.ts +11 -0
  57. package/dist/types/tools/task.d.ts +9 -1
  58. package/dist/types/tools/url-scheme-host.d.ts +17 -0
  59. package/dist/types/tools/yield.d.ts +1 -1
  60. package/dist/types/tui.d.ts +7 -2
  61. package/package.json +10 -14
  62. package/src/app-keybindings.d.ts +15 -0
  63. package/src/app-keybindings.ts +15 -0
  64. package/src/apps/session-picker.ts +7 -0
  65. package/src/charts/chart-plan.d.ts +9 -7
  66. package/src/charts/chart-plan.ts +20 -50
  67. package/src/chat/advisor-message.ts +2 -0
  68. package/src/chat/assistant-message.d.ts +15 -3
  69. package/src/chat/assistant-message.ts +137 -19
  70. package/src/chat/background-tan-message.ts +4 -0
  71. package/src/chat/bash-execution.d.ts +2 -0
  72. package/src/chat/bash-execution.ts +6 -0
  73. package/src/chat/chat-transcript-builder.ts +58 -28
  74. package/src/chat/compaction-summary-message.ts +2 -1
  75. package/src/chat/display-preferences.d.ts +2 -0
  76. package/src/chat/display-preferences.ts +3 -0
  77. package/src/chat/extension-types.d.ts +31 -0
  78. package/src/chat/extension-types.ts +34 -0
  79. package/src/chat/reply-write.d.ts +48 -0
  80. package/src/chat/reply-write.ts +127 -0
  81. package/src/chat/table-chart.d.ts +4 -3
  82. package/src/chat/table-chart.ts +10 -4
  83. package/src/chat/tool-execution.d.ts +1 -2
  84. package/src/chat/tool-execution.ts +20 -13
  85. package/src/chat/transcript-outline.d.ts +7 -0
  86. package/src/chat/transcript-outline.ts +27 -0
  87. package/src/chat/transcript-render-helpers.d.ts +2 -0
  88. package/src/chat/transcript-render-helpers.ts +66 -24
  89. package/src/chrome/index.ts +1 -0
  90. package/src/chrome/transcript-notice.d.ts +35 -0
  91. package/src/chrome/transcript-notice.ts +83 -0
  92. package/src/chrome/transcript-status.d.ts +20 -8
  93. package/src/chrome/transcript-status.ts +29 -29
  94. package/src/components/editor.d.ts +8 -0
  95. package/src/components/editor.ts +10 -1
  96. package/src/components/markdown.d.ts +7 -0
  97. package/src/components/markdown.ts +116 -6
  98. package/src/hotkeys-markdown.ts +1 -0
  99. package/src/native/backend.ts +5 -66
  100. package/src/native/blobs.d.ts +2 -1
  101. package/src/native/blobs.ts +3 -2
  102. package/src/native/picker.d.ts +4 -4
  103. package/src/native/picker.ts +4 -4
  104. package/src/overlays/advisor-config.ts +1 -10
  105. package/src/overlays/annotation-overlay.ts +125 -37
  106. package/src/overlays/annotation-types.ts +24 -0
  107. package/src/overlays/hook-selector.ts +2 -2
  108. package/src/overlays/login-dialog.ts +31 -5
  109. package/src/overlays/mcp-add-wizard.ts +1 -1
  110. package/src/overlays/model-browser.ts +37 -0
  111. package/src/overlays/model-hub.ts +1 -7
  112. package/src/overlays/model-picker.ts +1 -10
  113. package/src/overlays/oauth-selector.ts +44 -6
  114. package/src/overlays/plan-review-overlay.ts +13 -2
  115. package/src/overlays/rewind-selector.ts +29 -12
  116. package/src/overlays/session-selector.ts +313 -42
  117. package/src/overlays/usage-dashboard.ts +5 -12
  118. package/src/prompt/composer.ts +216 -1
  119. package/src/prompt/custom-editor.ts +6 -1
  120. package/src/prompt/emoji-autocomplete.ts +0 -2
  121. package/src/prompt/interactive-context-helpers.ts +29 -4
  122. package/src/render/extension-links.d.ts +65 -0
  123. package/src/render/extension-links.ts +214 -0
  124. package/src/render/hyperlink.d.ts +25 -7
  125. package/src/render/hyperlink.ts +65 -9
  126. package/src/render/index.d.ts +1 -0
  127. package/src/render/index.ts +1 -0
  128. package/src/setup/scenes/composer.ts +2 -0
  129. package/src/setup/scenes/glyph.ts +3 -1
  130. package/src/setup/scenes/model.ts +192 -29
  131. package/src/setup/scenes/outro.ts +33 -15
  132. package/src/setup/scenes/sign-in.ts +196 -400
  133. package/src/setup/scenes/theme.ts +2 -0
  134. package/src/setup/scenes/types.ts +18 -1
  135. package/src/setup/startup-splash.ts +8 -7
  136. package/src/setup/wizard-overlay.ts +164 -35
  137. package/src/setup/wizard.ts +11 -2
  138. package/src/status-line/component.ts +4 -10
  139. package/src/status-line/context-usage.ts +72 -21
  140. package/src/status-line/host.ts +6 -2
  141. package/src/terminal.ts +24 -2
  142. package/src/theme/defaults.json +1 -0
  143. package/src/theme/loader.ts +1 -1
  144. package/src/theme/theme.d.ts +0 -23
  145. package/src/theme/theme.ts +2 -75
  146. package/src/tools/bash-interactive.d.ts +49 -0
  147. package/src/tools/bash-interactive.ts +6 -1
  148. package/src/tools/bash.d.ts +2 -0
  149. package/src/tools/bash.ts +2 -0
  150. package/src/tools/default-renderer.d.ts +6 -4
  151. package/src/tools/default-renderer.ts +9 -6
  152. package/src/tools/eval.ts +14 -4
  153. package/src/tools/irc.d.ts +6 -0
  154. package/src/tools/irc.ts +6 -0
  155. package/src/tools/job-widget.ts +13 -1
  156. package/src/tools/json-tree.d.ts +23 -4
  157. package/src/tools/json-tree.ts +132 -42
  158. package/src/tools/lsp.d.ts +2 -0
  159. package/src/tools/lsp.ts +36 -15
  160. package/src/tools/mcp.d.ts +6 -5
  161. package/src/tools/mcp.ts +20 -12
  162. package/src/tools/native-view.d.ts +1 -1
  163. package/src/tools/native-view.ts +1 -1
  164. package/src/tools/renderer.d.ts +2 -0
  165. package/src/tools/renderer.ts +2 -0
  166. package/src/tools/streaming-output.d.ts +11 -0
  167. package/src/tools/streaming-output.ts +41 -0
  168. package/src/tools/task.d.ts +9 -1
  169. package/src/tools/task.ts +59 -16
  170. package/src/tools/url-scheme-host.d.ts +17 -0
  171. package/src/tools/url-scheme-host.ts +21 -0
  172. package/src/tools/yield.d.ts +1 -1
  173. package/src/tools/yield.ts +18 -9
  174. package/src/tui.d.ts +7 -2
  175. package/src/tui.ts +43 -15
  176. package/dist/types/theme/defaults/index.d.ts +0 -10289
  177. package/src/theme/defaults/alabaster.json +0 -103
  178. package/src/theme/defaults/amethyst.json +0 -106
  179. package/src/theme/defaults/anthracite.json +0 -103
  180. package/src/theme/defaults/basalt.json +0 -101
  181. package/src/theme/defaults/birch.json +0 -105
  182. package/src/theme/defaults/dark-abyss.json +0 -101
  183. package/src/theme/defaults/dark-arctic.json +0 -114
  184. package/src/theme/defaults/dark-aurora.json +0 -105
  185. package/src/theme/defaults/dark-catppuccin.json +0 -117
  186. package/src/theme/defaults/dark-cavern.json +0 -101
  187. package/src/theme/defaults/dark-celestial.json +0 -116
  188. package/src/theme/defaults/dark-copper.json +0 -105
  189. package/src/theme/defaults/dark-cosmos.json +0 -100
  190. package/src/theme/defaults/dark-cyberpunk.json +0 -112
  191. package/src/theme/defaults/dark-dracula.json +0 -108
  192. package/src/theme/defaults/dark-eclipse.json +0 -101
  193. package/src/theme/defaults/dark-ember.json +0 -105
  194. package/src/theme/defaults/dark-equinox.json +0 -100
  195. package/src/theme/defaults/dark-forest.json +0 -106
  196. package/src/theme/defaults/dark-github.json +0 -115
  197. package/src/theme/defaults/dark-gruvbox.json +0 -122
  198. package/src/theme/defaults/dark-lavender.json +0 -105
  199. package/src/theme/defaults/dark-lunar.json +0 -99
  200. package/src/theme/defaults/dark-midnight.json +0 -105
  201. package/src/theme/defaults/dark-monochrome.json +0 -104
  202. package/src/theme/defaults/dark-monokai.json +0 -108
  203. package/src/theme/defaults/dark-nebula.json +0 -100
  204. package/src/theme/defaults/dark-neon-noir.json +0 -110
  205. package/src/theme/defaults/dark-nord.json +0 -108
  206. package/src/theme/defaults/dark-ocean.json +0 -111
  207. package/src/theme/defaults/dark-one.json +0 -110
  208. package/src/theme/defaults/dark-poimandres.json +0 -125
  209. package/src/theme/defaults/dark-rainforest.json +0 -101
  210. package/src/theme/defaults/dark-reef.json +0 -101
  211. package/src/theme/defaults/dark-retro.json +0 -102
  212. package/src/theme/defaults/dark-rose-pine.json +0 -106
  213. package/src/theme/defaults/dark-sakura.json +0 -105
  214. package/src/theme/defaults/dark-slate.json +0 -105
  215. package/src/theme/defaults/dark-solarized.json +0 -107
  216. package/src/theme/defaults/dark-solstice.json +0 -100
  217. package/src/theme/defaults/dark-starfall.json +0 -101
  218. package/src/theme/defaults/dark-sunset.json +0 -109
  219. package/src/theme/defaults/dark-swamp.json +0 -100
  220. package/src/theme/defaults/dark-synthwave.json +0 -113
  221. package/src/theme/defaults/dark-taiga.json +0 -101
  222. package/src/theme/defaults/dark-terminal.json +0 -105
  223. package/src/theme/defaults/dark-tokyo-night.json +0 -111
  224. package/src/theme/defaults/dark-tundra.json +0 -101
  225. package/src/theme/defaults/dark-twilight.json +0 -101
  226. package/src/theme/defaults/dark-volcanic.json +0 -101
  227. package/src/theme/defaults/graphite.json +0 -102
  228. package/src/theme/defaults/index.d.ts +0 -10289
  229. package/src/theme/defaults/index.ts +0 -203
  230. package/src/theme/defaults/light-arctic.json +0 -117
  231. package/src/theme/defaults/light-aurora-day.json +0 -101
  232. package/src/theme/defaults/light-canyon.json +0 -101
  233. package/src/theme/defaults/light-catppuccin.json +0 -116
  234. package/src/theme/defaults/light-cirrus.json +0 -100
  235. package/src/theme/defaults/light-coral.json +0 -105
  236. package/src/theme/defaults/light-cyberpunk.json +0 -106
  237. package/src/theme/defaults/light-dawn.json +0 -100
  238. package/src/theme/defaults/light-dunes.json +0 -101
  239. package/src/theme/defaults/light-eucalyptus.json +0 -105
  240. package/src/theme/defaults/light-forest.json +0 -110
  241. package/src/theme/defaults/light-frost.json +0 -105
  242. package/src/theme/defaults/light-github.json +0 -125
  243. package/src/theme/defaults/light-glacier.json +0 -101
  244. package/src/theme/defaults/light-gruvbox.json +0 -118
  245. package/src/theme/defaults/light-haze.json +0 -100
  246. package/src/theme/defaults/light-honeycomb.json +0 -105
  247. package/src/theme/defaults/light-lagoon.json +0 -101
  248. package/src/theme/defaults/light-lavender.json +0 -105
  249. package/src/theme/defaults/light-meadow.json +0 -101
  250. package/src/theme/defaults/light-mint.json +0 -105
  251. package/src/theme/defaults/light-monochrome.json +0 -111
  252. package/src/theme/defaults/light-ocean.json +0 -109
  253. package/src/theme/defaults/light-one.json +0 -109
  254. package/src/theme/defaults/light-opal.json +0 -101
  255. package/src/theme/defaults/light-orchard.json +0 -101
  256. package/src/theme/defaults/light-paper.json +0 -105
  257. package/src/theme/defaults/light-poimandres.json +0 -125
  258. package/src/theme/defaults/light-prism.json +0 -100
  259. package/src/theme/defaults/light-retro.json +0 -108
  260. package/src/theme/defaults/light-sand.json +0 -105
  261. package/src/theme/defaults/light-savanna.json +0 -101
  262. package/src/theme/defaults/light-solarized.json +0 -112
  263. package/src/theme/defaults/light-soleil.json +0 -100
  264. package/src/theme/defaults/light-sunset.json +0 -109
  265. package/src/theme/defaults/light-synthwave.json +0 -108
  266. package/src/theme/defaults/light-tokyo-night.json +0 -121
  267. package/src/theme/defaults/light-wetland.json +0 -101
  268. package/src/theme/defaults/light-zenith.json +0 -99
  269. package/src/theme/defaults/limestone.json +0 -104
  270. package/src/theme/defaults/mahogany.json +0 -107
  271. package/src/theme/defaults/marble.json +0 -103
  272. package/src/theme/defaults/obsidian.json +0 -101
  273. package/src/theme/defaults/onyx.json +0 -101
  274. package/src/theme/defaults/pearl.json +0 -103
  275. package/src/theme/defaults/porcelain.json +0 -101
  276. package/src/theme/defaults/quartz.json +0 -106
  277. package/src/theme/defaults/sandstone.json +0 -105
  278. package/src/theme/defaults/titanium.json +0 -100
package/CHANGELOG.md CHANGED
@@ -1,182 +1,8 @@
1
1
  ## [Unreleased]
2
2
 
3
- ## [1.4.6] - 2026-10-28
4
-
5
- ### Added
6
-
7
- - Tools settings now show a SiYuan group for the API switch, URL, and token.
8
-
9
- ## [9.5.0] - 2026-02-01
10
-
11
- ### Changed
12
-
13
- - Improved fuzzy file search performance by using native implementation instead of spawning external process
14
-
15
- ## [9.4.0] - 2026-01-31
16
-
17
- ### Added
18
-
19
- - Exported `padding` utility function for creating space-padded strings efficiently
20
-
21
- ### Changed
22
-
23
- - Optimized padding operations across all components to use pre-allocated space buffer for better performance
24
-
25
- ## [8.4.1] - 2026-01-25
26
-
27
- ### Added
28
-
29
- - Added fuzzy match function for autocomplete suggestions
30
-
31
- ## [8.4.0] - 2026-01-25
32
-
33
- ### Fixed
34
-
35
- - Terminal gracefully handles write failures by marking dead instead of exiting the process
36
-
37
- ## [8.2.0] - 2026-01-24
38
-
39
- ### Added
40
-
41
- - Added mermaid diagram rendering engine (renderMermaidToPng) with mmdc CLI integration
42
- - Added terminal graphics encoding (iTerm2/Kitty) for mermaid diagrams with automatic width scaling
43
-
44
- ### Fixed
45
-
46
- - Fixed crash when terminal becomes unavailable (EIO errors) by exiting gracefully instead of throwing
47
-
48
- ## [6.8.3] - 2026-01-21
49
-
50
- ### Added
51
-
52
- - Added undo support in the editor via `Ctrl+-`
53
-
54
- ### Changed
55
-
56
- - Improved fuzzy matching to handle alphanumeric swaps
57
-
58
- ## [5.6.7] - 2026-01-18
59
-
60
- ### Added
61
-
62
- - Added configurable editor padding via `editorPaddingX` theme option
63
- - Added `setMaxHeight()` method to limit editor height with scrolling
64
- - Added Emacs-style kill ring for text deletion operations
65
-
66
- ### Changed
67
-
68
- - Updated tab bar rendering to wrap text across multiple lines when content exceeds available width
69
-
70
- ### Fixed
71
-
72
- - Fixed key detection for shifted symbol characters
73
-
74
- ## [5.3.1] - 2026-01-15
75
-
76
- ### Fixed
77
-
78
- - Fixed rendering issues on Windows by preventing re-entrant renders
79
-
80
- ## [5.1.0] - 2026-01-14
81
-
82
- ### Changed
83
-
84
- - Changed `OverlayOptions` to use `SizeValue` type for `width`, `maxHeight`, `row`, and `col` properties
85
-
86
- ### Fixed
87
-
88
- - Fixed numbered list items showing "1." for all items when code blocks break list continuity
89
-
90
- ## [4.6.0] - 2026-01-12
91
-
92
- ### Added
93
-
94
- - Add fuzzy matching module (`fuzzyMatch`, `fuzzyFilter`) for command autocomplete
95
-
96
- ### Fixed
97
-
98
- - Remove Kitty protocol query timeout that caused shift+enter delays
99
- - Add bracketed paste check to prevent false key release/repeat detection
100
-
101
- ## [4.2.1] - 2026-01-11
102
-
103
- ### Fixed
104
-
105
- - Fixed editor redraw glitch when canceling autocomplete suggestions
106
-
107
- ## [4.1.0] - 2026-01-10
108
-
109
- ### Added
110
-
111
- - Added persistent prompt history storage support via `setHistoryStorage()` method, allowing history to be saved and restored across sessions
112
-
113
- ## [4.0.0] - 2026-01-10
114
-
115
- ### Added
116
-
117
- - `EditorComponent` interface for custom editor implementations
118
-
119
- ## [3.32.0] - 2026-01-08
120
-
121
- ### Fixed
122
-
123
- - Fixed text wrapping allowing long whitespace tokens to exceed line width
124
-
125
- ## [3.20.0] - 2026-01-06
126
-
127
- ### Added
128
-
129
- - Added `isCapsLock` helper function for detecting Caps Lock key press via Kitty protocol
130
-
131
- ### Changed
132
-
133
- - Settings list descriptions now wrap to the available width instead of truncating
134
-
135
- ### Fixed
136
-
137
- - Fixed Shift+Enter detection in legacy terminals that send ESC+CR sequence
138
-
139
- ## [3.15.0] - 2026-01-05
140
-
141
- ### Added
142
-
143
- - Added `inputCursor` symbol for customizing the text input cursor character
144
-
145
- ## [3.9.1337] - 2026-01-04
146
-
147
- ### Changed
148
-
149
- - Changed Editor component to use proper box borders with vertical side borders instead of horizontal-only borders
150
-
151
- ## [1.500.0] - 2026-01-03
152
-
153
- ### Added
154
-
155
- - Added `getText()` method to Text component for retrieving current text content
156
-
157
- ## [1.337.1] - 2026-01-02
158
-
159
- ### Added
160
-
161
- - TabBar component for horizontal tab navigation
162
-
163
- ### Changed
164
-
165
- - Forked to @oh-my-pi scope with unified versioning across all packages
3
+ ## [1.4.7] - 2026-10-30
166
4
 
167
- ### Fixed
168
-
169
- - Strip OSC 8 hyperlink sequences in `visibleWidth()`
170
- - Crash on Unicode format characters in `visibleWidth()`
171
- - Markdown code block syntax highlighting
172
-
173
- ## [1.337.0] - 2026-01-02
174
-
175
- Initial release under @oh-my-pi scope. See previous releases at [badlogic/pi-mono](https://github.com/badlogic/pi-mono).
176
-
177
- ## [1.4.5] - 2026-10-28
178
-
179
- - Synced with upstream OMP v18.13.2: `/context` is now a context viewer (overview + detail); the legacy grid renderer is gone.
5
+ - Synced with upstream OMP v18.14.0; no package-specific user-visible changes.
180
6
 
181
7
  ### Breaking Changes
182
8
 
@@ -252,6 +78,7 @@ Initial release under @oh-my-pi scope. See previous releases at [badlogic/pi-mon
252
78
  - `Editor.insertTextAtCursor(text)` method for programmatic text insertion ([#419](https://github.com/badlogic/pi-mono/issues/419))
253
79
  - `EditorKeybindingsManager` for configurable editor keybindings. Components now use `matchesKey()` and keybindings manager instead of individual `isXxx()` functions. ([#405](https://github.com/badlogic/pi-mono/pull/405) by [@hjanuschka](https://github.com/hjanuschka))
254
80
  - Symbol key support in keybinding system: `SymbolKey` type with 32 symbol keys, `Key` constants (e.g., `Key.backtick`, `Key.comma`), updated `matchesKey()` and `parseKey()` to handle symbol input ([#450](https://github.com/badlogic/pi-mono/pull/450) by [@kaofelix](https://github.com/kaofelix))
81
+ - Editor now supports Page Up/Down keys (Fn+Up/Down on MacBook) for scrolling through large content ([#732](https://github.com/badlogic/pi-mono/issues/732))
255
82
 
256
83
  ### Changed
257
84
 
@@ -301,6 +128,8 @@ Initial release under @oh-my-pi scope. See previous releases at [badlogic/pi-mon
301
128
 
302
129
  ### Fixed
303
130
 
131
+ - Crash on Unicode format characters in `visibleWidth()`
132
+ - Markdown code block syntax highlighting
304
133
  - Fixed width overflow protection in overlay compositing to prevent TUI crashes
305
134
  - Key presses no longer dropped when batched with other events over SSH
306
135
  - Fixed `fd` tool detection to automatically find `fd` or `fdfind` in PATH when not explicitly configured
@@ -347,6 +176,9 @@ Older entries are archived in [packages/tui/CHANGELOG.md@58141d4e5fa8](https://g
347
176
  - Editor no longer corrupts terminal display when text exceeds screen height. Content now scrolls vertically with indicators showing lines above/below the viewport. Max height is 30% of terminal (minimum 5 lines). ([#732](https://github.com/badlogic/pi-mono/issues/732))
348
177
  - Cursor now moves to end of content on exit, preventing status line from being overwritten ([#629](https://github.com/badlogic/pi-mono/pull/629) by [@tallshort](https://github.com/tallshort))
349
178
  - Slash command autocomplete now triggers for commands starting with `.`, `-`, or `_` (e.g., `/.land`, `/-foo`) ([#422](https://github.com/badlogic/pi-mono/issues/422))
179
+ - Numbered list items showing "1." for all items when code blocks break list continuity ([#660](https://github.com/badlogic/pi-mono/pull/660) by [@ogulcancelik](https://github.com/ogulcancelik))
180
+ - Reduced flicker by only re-rendering changed lines ([#617](https://github.com/badlogic/pi-mono/pull/617) by [@ogulcancelik](https://github.com/ogulcancelik))
181
+ - Crash when pasting text with trailing whitespace exceeding terminal width through Markdown rendering ([#457](https://github.com/badlogic/pi-mono/pull/457) by [@robinwander](https://github.com/robinwander))
350
182
 
351
183
  ### Removed
352
184
 
@@ -357,6 +189,192 @@ Older entries are archived in [packages/tui/CHANGELOG.md@58141d4e5fa8](https://g
357
189
  - Removed `visibleWidth` benchmark file in favor of Kitty sequence benchmarking
358
190
  - Removed `truncateToWidth`, `sliceWithWidth`, and `extractSegments` functions from public API (now re-exported directly from @linxiraos/pi-natives)
359
191
 
192
+ ## [9.5.0] - 2026-02-01
193
+
194
+ ### Changed
195
+
196
+ - Improved fuzzy file search performance by using native implementation instead of spawning external process
197
+
198
+ ## [9.4.0] - 2026-01-31
199
+
200
+ ### Added
201
+
202
+ - Exported `padding` utility function for creating space-padded strings efficiently
203
+
204
+ ### Changed
205
+
206
+ - Optimized padding operations across all components to use pre-allocated space buffer for better performance
207
+
208
+ ## [8.4.1] - 2026-01-25
209
+
210
+ ### Added
211
+
212
+ - Added fuzzy match function for autocomplete suggestions
213
+
214
+ ## [8.4.0] - 2026-01-25
215
+
216
+ ### Fixed
217
+
218
+ - Terminal gracefully handles write failures by marking dead instead of exiting the process
219
+
220
+ ## [8.2.0] - 2026-01-24
221
+
222
+ ### Added
223
+
224
+ - Added mermaid diagram rendering engine (renderMermaidToPng) with mmdc CLI integration
225
+ - Added terminal graphics encoding (iTerm2/Kitty) for mermaid diagrams with automatic width scaling
226
+
227
+ ### Fixed
228
+
229
+ - Fixed crash when terminal becomes unavailable (EIO errors) by exiting gracefully instead of throwing
230
+
231
+ ## [6.8.3] - 2026-01-21
232
+
233
+ ### Added
234
+
235
+ - Added undo support in the editor via `Ctrl+-`
236
+
237
+ ### Changed
238
+
239
+ - Improved fuzzy matching to handle alphanumeric swaps
240
+
241
+ ## [5.6.7] - 2026-01-18
242
+
243
+ ### Added
244
+
245
+ - Added configurable editor padding via `editorPaddingX` theme option
246
+ - Added `setMaxHeight()` method to limit editor height with scrolling
247
+ - Added Emacs-style kill ring for text deletion operations
248
+
249
+ ### Changed
250
+
251
+ - Updated tab bar rendering to wrap text across multiple lines when content exceeds available width
252
+
253
+ ### Fixed
254
+
255
+ - Fixed key detection for shifted symbol characters
256
+
257
+ ## [5.3.1] - 2026-01-15
258
+
259
+ ### Fixed
260
+
261
+ - Fixed rendering issues on Windows by preventing re-entrant renders
262
+
263
+ ## [5.1.0] - 2026-01-14
264
+
265
+ ### Changed
266
+
267
+ - Changed `OverlayOptions` to use `SizeValue` type for `width`, `maxHeight`, `row`, and `col` properties
268
+
269
+ ### Fixed
270
+
271
+ - Fixed numbered list items showing "1." for all items when code blocks break list continuity
272
+
273
+ ## [4.6.0] - 2026-01-12
274
+
275
+ ### Added
276
+
277
+ - Add fuzzy matching module (`fuzzyMatch`, `fuzzyFilter`) for command autocomplete
278
+
279
+ ### Fixed
280
+
281
+ - Remove Kitty protocol query timeout that caused shift+enter delays
282
+ - Add bracketed paste check to prevent false key release/repeat detection
283
+
284
+ ## [4.2.1] - 2026-01-11
285
+
286
+ ### Fixed
287
+
288
+ - Fixed editor redraw glitch when canceling autocomplete suggestions
289
+
290
+ ## [4.1.0] - 2026-01-10
291
+
292
+ ### Added
293
+
294
+ - Added persistent prompt history storage support via `setHistoryStorage()` method, allowing history to be saved and restored across sessions
295
+
296
+ ## [4.0.0] - 2026-01-10
297
+
298
+ ### Added
299
+
300
+ - `EditorComponent` interface for custom editor implementations
301
+
302
+ ## [3.32.0] - 2026-01-08
303
+
304
+ ### Fixed
305
+
306
+ - Fixed text wrapping allowing long whitespace tokens to exceed line width
307
+
308
+ ## [3.20.0] - 2026-01-06
309
+
310
+ ### Added
311
+
312
+ - Added `isCapsLock` helper function for detecting Caps Lock key press via Kitty protocol
313
+
314
+ ### Changed
315
+
316
+ - Settings list descriptions now wrap to the available width instead of truncating
317
+
318
+ ### Fixed
319
+
320
+ - Fixed Shift+Enter detection in legacy terminals that send ESC+CR sequence
321
+
322
+ ## [3.15.0] - 2026-01-05
323
+
324
+ ### Added
325
+
326
+ - Added `inputCursor` symbol for customizing the text input cursor character
327
+
328
+ ## [3.9.1337] - 2026-01-04
329
+
330
+ ### Changed
331
+
332
+ - Changed Editor component to use proper box borders with vertical side borders instead of horizontal-only borders
333
+
334
+ ## [1.500.0] - 2026-01-03
335
+
336
+ ### Added
337
+
338
+ - Added `getText()` method to Text component for retrieving current text content
339
+
340
+ ## [1.337.1] - 2026-01-02
341
+
342
+ ### Added
343
+
344
+ - TabBar component for horizontal tab navigation
345
+
346
+ ### Changed
347
+
348
+ - Forked to @oh-my-pi scope with unified versioning across all packages
349
+
350
+ ### Fixed
351
+
352
+ - Strip OSC 8 hyperlink sequences in `visibleWidth()`
353
+
354
+ ## [1.337.0] - 2026-01-02
355
+
356
+ Initial release under @oh-my-pi scope. See previous releases at [badlogic/pi-mono](https://github.com/badlogic/pi-mono).
357
+
358
+ ## [1.4.6] - 2026-10-28
359
+
360
+ ### Breaking Changes
361
+
362
+ - Moved `PINNED_HUD_TOGGLE_ID` to the coding agent's task output manager so reserving subagent IDs no longer loads the interactive editor.
363
+ - Updated `StatusLineHost.resetExpiryNotice` to receive the session and manage warning deduplication; custom status-line components must use the new signature.
364
+ - Removed `ToolExecutionHandle.setToolActivityVisible`; tool-activity visibility is now controlled by transcript components, while reply blocks remain visible by default.
365
+ - Removed the `@oh-my-pi/pi-tui/theme/defaults` export. Bundled palettes are now available through `getBuiltinThemes()` from `theme/defaults.json`.
366
+
367
+ ### Fixed
368
+
369
+ - Fixed table-chart direction detection so measures are not incorrectly marked as better based on header words; single-measure tables are now sent for judging when local charting is appropriate.
370
+ - Fixed LSP diagnostics that incorrectly showed “No issues” before a language server had reported; such files are now shown as unverified. ([#17293](https://github.com/can1357/oh-my-pi/pull/17293) by [@JustasMasiulis](https://github.com/JustasMasiulis))
371
+ - Fixed Esc-Esc rewind in Tern selecting interrupted turns with no visible output instead of the last displayed turn.
372
+ - Fixed streamed code blocks losing lines that scrolled off screen before the closing fence arrived; completed lines now remain available in scrollback. ([#17333](https://github.com/can1357/oh-my-pi/pull/17333) by [@gzkGit777](https://github.com/gzkGit777))
373
+
374
+ ## [1.4.5] - 2026-10-28
375
+
376
+ - Synced with upstream OMP v18.13.2: `/context` is now a context viewer (overview + detail); the legacy grid renderer is gone.
377
+
360
378
  ## [1.4.4] - 2026-10-26
361
379
 
362
380
  - Released as part of Zeta 1.4.4; no package-specific user-visible changes.
@@ -593,7 +611,6 @@ Older entries are archived in [packages/tui/CHANGELOG.md@58141d4e5fa8](https://g
593
611
  - Hardware cursor positioning for IME support in `Editor` and `Input` components. The terminal cursor now follows the text cursor position, enabling proper IME candidate window placement for CJK input. ([#719](https://github.com/badlogic/pi-mono/pull/719))
594
612
  - `Focusable` interface for components that need hardware cursor positioning. Implement `focused: boolean` and emit `CURSOR_MARKER` in render output when focused.
595
613
  - `CURSOR_MARKER` constant and `isFocusable()` type guard exported from the package
596
- - Editor now supports Page Up/Down keys (Fn+Up/Down on MacBook) for scrolling through large content ([#732](https://github.com/badlogic/pi-mono/issues/732))
597
614
 
598
615
  ## [0.46.0] - 2026-01-15
599
616
 
@@ -611,18 +628,6 @@ Older entries are archived in [packages/tui/CHANGELOG.md@58141d4e5fa8](https://g
611
628
 
612
629
  - Overlay compositing crash when rendered lines exceed terminal width due to complex ANSI/OSC sequences (e.g., hyperlinks in subagent output) ([#667](https://github.com/badlogic/pi-mono/pull/667) by [@nicobailon](https://github.com/nicobailon))
613
630
 
614
- ## [0.44.0] - 2026-01-12
615
-
616
- ### Fixed
617
-
618
- - Numbered list items showing "1." for all items when code blocks break list continuity ([#660](https://github.com/badlogic/pi-mono/pull/660) by [@ogulcancelik](https://github.com/ogulcancelik))
619
-
620
- ## [0.42.5] - 2026-01-11
621
-
622
- ### Fixed
623
-
624
- - Reduced flicker by only re-rendering changed lines ([#617](https://github.com/badlogic/pi-mono/pull/617) by [@ogulcancelik](https://github.com/ogulcancelik))
625
-
626
631
  ## [0.38.0] - 2026-01-08
627
632
 
628
633
  ### Fixed
@@ -645,12 +650,6 @@ Older entries are archived in [packages/tui/CHANGELOG.md@58141d4e5fa8](https://g
645
650
 
646
651
  - `matchesKey()` now correctly matches Kitty protocol sequences for unmodified letter keys (needed for key release events)
647
652
 
648
- ## [0.37.0] - 2026-01-05
649
-
650
- ### Fixed
651
-
652
- - Crash when pasting text with trailing whitespace exceeding terminal width through Markdown rendering ([#457](https://github.com/badlogic/pi-mono/pull/457) by [@robinwander](https://github.com/robinwander))
653
-
654
653
  ## [0.31.1] - 2026-01-02
655
654
 
656
655
  Older entries are archived in [packages/tui/CHANGELOG.md@fa14205f838f](https://github.com/can1357/oh-my-pi/blob/fa14205f838f282fcea048c64fca74026789a492/packages/tui/CHANGELOG.md).
package/README.md CHANGED
@@ -28,7 +28,7 @@ const tui = new TUI(terminal);
28
28
  tui.addChild(new Text("Welcome to my app!"));
29
29
 
30
30
  const editor = new Editor(editorTheme);
31
- editor.onSubmit = (text) => {
31
+ editor.onSubmit = text => {
32
32
  console.log("Submitted:", text);
33
33
  tui.addChild(new Text(`You said: ${text}`));
34
34
  };
@@ -106,12 +106,12 @@ interface Component {
106
106
  }
107
107
  ```
108
108
 
109
- | Method | Description |
110
- | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
109
+ | Method | Description |
110
+ | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
111
111
  | `render(width)` | Returns an array of strings, one per line. Each line **must not exceed `width`** or the TUI will error. Use `truncateToWidth()` or manual wrapping to ensure this. The result is component-owned and immutable to callers; return the same array reference when unchanged (enables renderer memoization) and a new array when content changed. |
112
- | `handleInput?(data)` | Called when the component has focus and receives keyboard input. The `data` string contains raw terminal input (may include ANSI escape sequences). |
113
- | `invalidate?()` | Called to clear any cached render state. Components should re-render from scratch on the next `render()` call. |
114
- | `releaseRenderCaches?()` | Drops only derived render caches. The next `render()` must return the same rows without eager rebuilds, renderer callbacks, image conversions, or child replacement. |
112
+ | `handleInput?(data)` | Called when the component has focus and receives keyboard input. The `data` string contains raw terminal input (may include ANSI escape sequences). |
113
+ | `invalidate?()` | Called to clear any cached render state. Components should re-render from scratch on the next `render()` call. |
114
+ | `releaseRenderCaches?()` | Drops only derived render caches. The next `render()` must return the same rows without eager rebuilds, renderer callbacks, image conversions, or child replacement. |
115
115
 
116
116
  ## Built-in Components
117
117
 
@@ -119,20 +119,20 @@ interface Component {
119
119
 
120
120
  Build screens from persistent components and update their data, selection, expansion, or size through setters. Layouts own child bounds and mouse-coordinate translation; controllers retain domain workflows and asynchronous operations. Propagate `invalidate()` after theme changes and `dispose()` when removing an owned component tree.
121
121
 
122
- | Family | Components | Import |
123
- | --- | --- | --- |
124
- | Layout | `Stack`, `Row`, `SplitPane` | package root |
125
- | Panels | `OverlayPanel`, `PanelRows`, `PanelDivider` | `/chrome` |
126
- | Menus | `SelectList`, `MenuSelection` | package root |
127
- | Forms | `Form`, `FormField`, `TextFormField`, `SelectFormField`, `SettingsFormField` | package root |
128
- | Wizard steps | `WizardStep` | package root |
129
- | Viewports | `ScrollView`, including child rendering, follow-tail, and keyed range anchoring | package root |
130
- | Trees | `TreeView` | package root |
131
- | Disclosure | `Disclosure`, with lazy summary/detail children | package root |
132
- | Messages | `FramedMessageComponent`, `MessageNoticeComponent`, `MessageDividerComponent` | `/chrome` |
133
- | Tool output | `ToolCard`, `framedToolCard`, `plainToolCard`, `OutputPane` | `/render` |
134
- | Transcripts | `TranscriptBrowser` | package root |
135
- | Data | `MetricRow`, `ProgressBar`, `Table`, `KeyValueList`, `Section` | package root |
122
+ | Family | Components | Import |
123
+ | ------------ | ------------------------------------------------------------------------------- | ------------ |
124
+ | Layout | `Stack`, `Row`, `SplitPane` | package root |
125
+ | Panels | `OverlayPanel`, `PanelRows`, `PanelDivider` | `/chrome` |
126
+ | Menus | `SelectList`, `MenuSelection` | package root |
127
+ | Forms | `Form`, `FormField`, `TextFormField`, `SelectFormField`, `SettingsFormField` | package root |
128
+ | Wizard steps | `WizardStep` | package root |
129
+ | Viewports | `ScrollView`, including child rendering, follow-tail, and keyed range anchoring | package root |
130
+ | Trees | `TreeView` | package root |
131
+ | Disclosure | `Disclosure`, with lazy summary/detail children | package root |
132
+ | Messages | `FramedMessageComponent`, `MessageNoticeComponent`, `MessageDividerComponent` | `/chrome` |
133
+ | Tool output | `ToolCard`, `framedToolCard`, `plainToolCard`, `OutputPane` | `/render` |
134
+ | Transcripts | `TranscriptBrowser` | package root |
135
+ | Data | `MetricRow`, `ProgressBar`, `Table`, `KeyValueList`, `Section` | package root |
136
136
 
137
137
  ```typescript
138
138
  import { Disclosure, SplitPane, Text } from "@linxiraos/pi-tui";
@@ -176,10 +176,10 @@ Container that applies padding and background color to all children.
176
176
  const box = new Box(
177
177
  1, // paddingX (default: 1)
178
178
  1, // paddingY (default: 1)
179
- (text) => chalk.bgGray(text), // optional background function
179
+ text => chalk.bgGray(text), // optional background function
180
180
  );
181
181
  box.addChild(new Text("Content"));
182
- box.setBgFn((text) => chalk.bgBlue(text)); // Change background dynamically
182
+ box.setBgFn(text => chalk.bgBlue(text)); // Change background dynamically
183
183
  ```
184
184
 
185
185
  ### Text
@@ -191,10 +191,10 @@ const text = new Text(
191
191
  "Hello World", // text content
192
192
  1, // paddingX (default: 1)
193
193
  1, // paddingY (default: 1)
194
- (text) => chalk.bgGray(text), // optional background function
194
+ text => chalk.bgGray(text), // optional background function
195
195
  );
196
196
  text.setText("Updated text");
197
- text.setCustomBgFn((text) => chalk.bgBlue(text));
197
+ text.setCustomBgFn(text => chalk.bgBlue(text));
198
198
  ```
199
199
 
200
200
  ### TruncatedText
@@ -215,7 +215,7 @@ Single-line text input with horizontal scrolling.
215
215
 
216
216
  ```typescript
217
217
  const input = new Input();
218
- input.onSubmit = (value) => console.log(value);
218
+ input.onSubmit = value => console.log(value);
219
219
  input.setValue("initial");
220
220
  input.getValue();
221
221
  ```
@@ -285,11 +285,11 @@ interface EditorTheme {
285
285
  }
286
286
 
287
287
  const editor = new Editor(theme);
288
- editor.onSubmit = (text) => console.log(text);
289
- editor.onChange = (text) => console.log("Changed:", text);
288
+ editor.onSubmit = text => console.log(text);
289
+ editor.onChange = text => console.log("Changed:", text);
290
290
  editor.disableSubmit = true; // Disable submit temporarily
291
291
  editor.setAutocompleteProvider(provider);
292
- editor.borderColor = (s) => chalk.blue(s); // Change border dynamically
292
+ editor.borderColor = s => chalk.blue(s); // Change border dynamically
293
293
  ```
294
294
 
295
295
  **Features:**
@@ -371,8 +371,8 @@ Animated loading spinner.
371
371
  ```typescript
372
372
  const loader = new Loader(
373
373
  tui, // TUI instance for render updates
374
- (s) => chalk.cyan(s), // spinner color function
375
- (s) => chalk.gray(s), // message color function
374
+ s => chalk.cyan(s), // spinner color function
375
+ s => chalk.gray(s), // message color function
376
376
  "Loading...", // message (default: "Loading...")
377
377
  );
378
378
  loader.start();
@@ -387,8 +387,8 @@ Extends Loader with Escape key handling and an AbortSignal for cancelling async
387
387
  ```typescript
388
388
  const loader = new CancellableLoader(
389
389
  tui, // TUI instance for render updates
390
- (s) => chalk.cyan(s), // spinner color function
391
- (s) => chalk.gray(s), // message color function
390
+ s => chalk.cyan(s), // spinner color function
391
+ s => chalk.gray(s), // message color function
392
392
  "Working...", // message
393
393
  );
394
394
  loader.onAbort = () => done(null); // Called when user presses Escape
@@ -430,9 +430,9 @@ const list = new SelectList(
430
430
  theme, // SelectListTheme
431
431
  );
432
432
 
433
- list.onSelect = (item) => console.log("Selected:", item);
433
+ list.onSelect = item => console.log("Selected:", item);
434
434
  list.onCancel = () => console.log("Cancelled");
435
- list.onSelectionChange = (item) => console.log("Highlighted:", item);
435
+ list.onSelectionChange = item => console.log("Highlighted:", item);
436
436
  list.setFilter("opt"); // Filter items
437
437
  ```
438
438
 
@@ -39,10 +39,13 @@ interface AppKeybindings {
39
39
  "app.session.rename": true;
40
40
  "app.session.delete": true;
41
41
  "app.session.deleteNoninvasive": true;
42
+ "app.session.pin": true;
43
+ "app.session.unpin": true;
42
44
  "app.tree.previousBranch": true;
43
45
  "app.tree.nextBranch": true;
44
46
  "app.plan.toggle": true;
45
47
  "app.history.search": true;
48
+ "app.links.hint": true;
46
49
  "app.stt.pushToTalk": true;
47
50
  "app.stt.toggle": true;
48
51
  "app.live.toggle": true;
@@ -329,6 +332,14 @@ export declare const KEYBINDINGS: {
329
332
  readonly defaultKeys: "ctrl+backspace";
330
333
  readonly description: "Delete session (non-invasive)";
331
334
  };
335
+ readonly "app.session.pin": {
336
+ readonly defaultKeys: "alt+k";
337
+ readonly description: "Pin the selected session in the resume picker";
338
+ };
339
+ readonly "app.session.unpin": {
340
+ readonly defaultKeys: "alt+shift+k";
341
+ readonly description: "Unpin the selected session in the resume picker";
342
+ };
332
343
  readonly "app.tree.previousBranch": {
333
344
  readonly defaultKeys: [];
334
345
  readonly description: "Jump to the previous branch in /tree";
@@ -345,6 +356,10 @@ export declare const KEYBINDINGS: {
345
356
  readonly defaultKeys: "ctrl+r";
346
357
  readonly description: "Search history";
347
358
  };
359
+ readonly "app.links.hint": {
360
+ readonly defaultKeys: "alt+o";
361
+ readonly description: "Pick an extension link on screen by its hint tag";
362
+ };
348
363
  readonly "app.stt.pushToTalk": {
349
364
  readonly defaultKeys: "space";
350
365
  readonly description: "Hold to record speech-to-text";
@@ -5,6 +5,9 @@ export interface SessionPickerHost<T extends SessionSelectorEntry = SessionSelec
5
5
  loadPinnedIds?(): Promise<ReadonlySet<string>>;
6
6
  loadHistoryMatcher?(): SessionHistoryMatcher;
7
7
  deleteSession?(session: T): Promise<boolean>;
8
+ /** Rename the session and resolve with the title as stored, or null when it did not happen. */
9
+ renameSession?(session: T, title: string): Promise<string | null>;
10
+ setSessionPinned?(session: T, pinned: boolean): Promise<void>;
8
11
  loadAllSessions?(): Promise<T[]>;
9
12
  /** Builds the three-level resume source for the standalone `--resume` tree. */
10
13
  loadResumeSource?(deleteMode: "trash" | "permanent", workspacePath?: string): Promise<ResumeTreeSource | undefined>;
@@ -16,6 +19,8 @@ export interface SessionPickerOptions<T extends SessionSelectorEntry = SessionSe
16
19
  scopeLabel?: string | false;
17
20
  showCwd?: boolean;
18
21
  allowDelete?: boolean;
22
+ /** Rename the selected session; resolve with the title as stored, or null when it did not happen. */
23
+ onRename?: (session: T, title: string) => Promise<string | null>;
19
24
  allowGlobalScope?: boolean;
20
25
  historySearch?: boolean;
21
26
  pinnedIds?: ReadonlySet<string>;
@@ -419,9 +419,10 @@ export type ChartAnnotation = {
419
419
  export declare function planChart(table: TableAnalysis): ChartPlan | undefined;
420
420
  /**
421
421
  * Whether a model should pick `table`'s chart (`tui.autoGraph: smart`):
422
- * multi-series tables, and tables whose rows may be named by a number the
423
- * `guess` plots (`Thread | State`, `Finding | Current`), where only meaning
424
- * tells a name from a measure.
422
+ * multi-series tables, tables whose rows may be named by a number the
423
+ * `guess` plots (`Thread | State`, `Finding | Current`), and any other chart
424
+ * the guess would draw — only meaning tells a measure from page references,
425
+ * step numbers or figures quoted in prose, which the judge charts as none.
425
426
  */
426
427
  export declare function shouldJudge(table: TableAnalysis, guess: ChartPlan | undefined): boolean;
427
428
  /** Measure columns before `guess`'s text label column: numbers that may only name their rows. */
@@ -446,10 +447,11 @@ export declare function tableTakeaways(table: TableAnalysis, plan: ChartPlan, co
446
447
  */
447
448
  export declare function drawnNames(spec: ChartSpec): Set<string>;
448
449
  /**
449
- * The local guess at what `plan`'s rows and measures mean: header keywords
450
- * for each measure's {@link Polarity} (resources like tokens or memory only
451
- * beside a baseline), rivals from the label's header, focus from bolded or
452
- * `(current)` row names, and a status column whose cells vary.
450
+ * The local guess at what `plan`'s rows and measures mean: each measure's
451
+ * {@link Polarity} as far as its unit says ({@link dimPolarity}; what a name
452
+ * means — `Memory` as a capacity or a cost — is the judge's call), rivals from
453
+ * the label's header, focus from bolded or `(current)` row names, and a status
454
+ * column whose cells vary.
453
455
  */
454
456
  export declare function guessMeaning(table: TableAnalysis, plan: ChartPlan): Pick<ChartPlan, "polarity" | "rowPolarity" | "rivals" | "focus" | "status">;
455
457
  /** Whether `plan`'s rows may each be a metric of their own: a `change`, a transposed table, or mixed-unit columns. */