@aexol/spectral 0.7.1 → 0.7.5

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 (219) hide show
  1. package/CHANGELOG.md +5 -0
  2. package/dist/agent/agents.js +1 -1
  3. package/dist/agent/index.js +199 -184
  4. package/dist/commands/serve.js +0 -3
  5. package/dist/designer/data/systems/renault/DESIGN.md +1 -1
  6. package/dist/designer/philosophies.js +668 -0
  7. package/dist/mcp/sampling-handler.js +1 -1
  8. package/dist/memory/commands/status.js +1 -1
  9. package/dist/memory/compaction.js +2 -2
  10. package/dist/memory/config.js +1 -1
  11. package/dist/memory/debug-log.js +1 -1
  12. package/dist/memory/hooks/compaction-hook.js +29 -0
  13. package/dist/memory/index.js +2 -0
  14. package/dist/memory/observer.js +2 -2
  15. package/dist/memory/project-observations-store.js +14 -0
  16. package/dist/memory/tokens.js +1 -1
  17. package/dist/memory/tools/read-project-observations.js +82 -0
  18. package/dist/memory/tools/recall-observation.js +2 -2
  19. package/dist/pi/agent-core/agent-loop.js +501 -0
  20. package/dist/pi/agent-core/agent.js +401 -0
  21. package/dist/pi/agent-core/harness/agent-harness.js +899 -0
  22. package/dist/pi/agent-core/harness/compaction/branch-summarization.js +173 -0
  23. package/dist/pi/agent-core/harness/compaction/compaction.js +532 -0
  24. package/dist/pi/agent-core/harness/compaction/utils.js +130 -0
  25. package/dist/pi/agent-core/harness/env/nodejs.js +485 -0
  26. package/dist/pi/agent-core/harness/messages.js +101 -0
  27. package/dist/pi/agent-core/harness/prompt-templates.js +229 -0
  28. package/dist/pi/agent-core/harness/session/jsonl-repo.js +100 -0
  29. package/dist/pi/agent-core/harness/session/jsonl-storage.js +230 -0
  30. package/dist/pi/agent-core/harness/session/memory-repo.js +41 -0
  31. package/dist/pi/agent-core/harness/session/memory-storage.js +113 -0
  32. package/dist/pi/agent-core/harness/session/repo-utils.js +38 -0
  33. package/dist/pi/agent-core/harness/session/session.js +196 -0
  34. package/dist/pi/agent-core/harness/session/uuid.js +49 -0
  35. package/dist/pi/agent-core/harness/skills.js +310 -0
  36. package/dist/pi/agent-core/harness/system-prompt.js +29 -0
  37. package/dist/pi/agent-core/harness/types.js +93 -0
  38. package/dist/pi/agent-core/harness/utils/shell-output.js +125 -0
  39. package/dist/pi/agent-core/harness/utils/truncate.js +289 -0
  40. package/dist/pi/agent-core/index.js +24 -0
  41. package/dist/pi/agent-core/node.js +2 -0
  42. package/dist/pi/agent-core/proxy.js +277 -0
  43. package/dist/pi/agent-core/types.js +1 -0
  44. package/dist/pi/ai/api-registry.js +43 -0
  45. package/dist/pi/ai/cli.js +120 -0
  46. package/dist/pi/ai/env-api-keys.js +169 -0
  47. package/dist/pi/ai/image-models.generated.js +441 -0
  48. package/dist/pi/ai/image-models.js +22 -0
  49. package/dist/pi/ai/images-api-registry.js +21 -0
  50. package/dist/pi/ai/images.js +13 -0
  51. package/dist/pi/ai/index.js +18 -0
  52. package/dist/pi/ai/models.generated.js +16220 -0
  53. package/dist/pi/ai/models.js +70 -0
  54. package/dist/pi/ai/oauth.js +1 -0
  55. package/dist/pi/ai/providers/anthropic.js +945 -0
  56. package/dist/pi/ai/providers/faux.js +367 -0
  57. package/dist/pi/ai/providers/github-copilot-headers.js +28 -0
  58. package/dist/pi/ai/providers/openai-completions.js +945 -0
  59. package/dist/pi/ai/providers/openai-prompt-cache.js +9 -0
  60. package/dist/pi/ai/providers/register-builtins.js +97 -0
  61. package/dist/pi/ai/providers/simple-options.js +40 -0
  62. package/dist/pi/ai/providers/transform-messages.js +183 -0
  63. package/dist/pi/ai/session-resources.js +21 -0
  64. package/dist/pi/ai/stream.js +26 -0
  65. package/dist/pi/ai/types.js +1 -0
  66. package/dist/pi/ai/utils/diagnostics.js +24 -0
  67. package/dist/pi/ai/utils/event-stream.js +80 -0
  68. package/dist/pi/ai/utils/hash.js +13 -0
  69. package/dist/pi/ai/utils/headers.js +7 -0
  70. package/dist/pi/ai/utils/json-parse.js +112 -0
  71. package/dist/pi/ai/utils/node-http-proxy.js +96 -0
  72. package/dist/pi/ai/utils/oauth/anthropic.js +334 -0
  73. package/dist/pi/ai/utils/oauth/device-code.js +54 -0
  74. package/dist/pi/ai/utils/oauth/github-copilot.js +270 -0
  75. package/dist/pi/ai/utils/oauth/index.js +121 -0
  76. package/dist/pi/ai/utils/oauth/oauth-page.js +104 -0
  77. package/dist/pi/ai/utils/oauth/openai-codex.js +384 -0
  78. package/dist/pi/ai/utils/oauth/pkce.js +30 -0
  79. package/dist/pi/ai/utils/oauth/types.js +1 -0
  80. package/dist/pi/ai/utils/overflow.js +150 -0
  81. package/dist/pi/ai/utils/sanitize-unicode.js +25 -0
  82. package/dist/pi/ai/utils/typebox-helpers.js +20 -0
  83. package/dist/pi/ai/utils/validation.js +280 -0
  84. package/dist/pi/coding-agent/bun/cli.js +7 -0
  85. package/dist/pi/coding-agent/bun/restore-sandbox-env.js +31 -0
  86. package/dist/pi/coding-agent/cli/args.js +340 -0
  87. package/dist/pi/coding-agent/cli/file-processor.js +82 -0
  88. package/dist/pi/coding-agent/cli/initial-message.js +21 -0
  89. package/dist/pi/coding-agent/cli.js +17 -0
  90. package/dist/pi/coding-agent/config.js +414 -0
  91. package/dist/pi/coding-agent/core/agent-session-runtime.js +299 -0
  92. package/dist/pi/coding-agent/core/agent-session-services.js +117 -0
  93. package/dist/pi/coding-agent/core/agent-session.js +2498 -0
  94. package/dist/pi/coding-agent/core/auth-guidance.js +20 -0
  95. package/dist/pi/coding-agent/core/auth-storage.js +441 -0
  96. package/dist/pi/coding-agent/core/bash-executor.js +110 -0
  97. package/dist/pi/coding-agent/core/compaction/branch-summarization.js +242 -0
  98. package/dist/pi/coding-agent/core/compaction/compaction.js +624 -0
  99. package/dist/pi/coding-agent/core/compaction/index.js +6 -0
  100. package/dist/pi/coding-agent/core/compaction/utils.js +152 -0
  101. package/dist/pi/coding-agent/core/defaults.js +1 -0
  102. package/dist/pi/coding-agent/core/diagnostics.js +1 -0
  103. package/dist/pi/coding-agent/core/event-bus.js +24 -0
  104. package/dist/pi/coding-agent/core/exec.js +74 -0
  105. package/dist/pi/coding-agent/core/export-html/ansi-to-html.js +248 -0
  106. package/dist/pi/coding-agent/core/export-html/index.js +225 -0
  107. package/dist/pi/coding-agent/core/export-html/tool-renderer.js +107 -0
  108. package/dist/pi/coding-agent/core/extensions/index.js +8 -0
  109. package/dist/pi/coding-agent/core/extensions/loader.js +485 -0
  110. package/dist/pi/coding-agent/core/extensions/runner.js +824 -0
  111. package/dist/pi/coding-agent/core/extensions/types.js +44 -0
  112. package/dist/pi/coding-agent/core/extensions/wrapper.js +21 -0
  113. package/dist/pi/coding-agent/core/footer-data-provider.js +309 -0
  114. package/dist/pi/coding-agent/core/http-dispatcher.js +47 -0
  115. package/dist/pi/coding-agent/core/index.js +11 -0
  116. package/dist/pi/coding-agent/core/keybindings.js +294 -0
  117. package/dist/pi/coding-agent/core/messages.js +122 -0
  118. package/dist/pi/coding-agent/core/model-registry.js +728 -0
  119. package/dist/pi/coding-agent/core/model-resolver.js +494 -0
  120. package/dist/pi/coding-agent/core/output-guard.js +58 -0
  121. package/dist/pi/coding-agent/core/package-manager.js +2020 -0
  122. package/dist/pi/coding-agent/core/prompt-templates.js +237 -0
  123. package/dist/pi/coding-agent/core/provider-display-names.js +32 -0
  124. package/dist/pi/coding-agent/core/resolve-config-value.js +125 -0
  125. package/dist/pi/coding-agent/core/resource-loader.js +733 -0
  126. package/dist/pi/coding-agent/core/sdk.js +282 -0
  127. package/dist/pi/coding-agent/core/session-cwd.js +37 -0
  128. package/dist/pi/coding-agent/core/session-manager.js +1146 -0
  129. package/dist/pi/coding-agent/core/settings-manager.js +794 -0
  130. package/dist/pi/coding-agent/core/skills.js +386 -0
  131. package/dist/pi/coding-agent/core/slash-commands.js +24 -0
  132. package/dist/pi/coding-agent/core/source-info.js +18 -0
  133. package/dist/pi/coding-agent/core/system-prompt.js +122 -0
  134. package/dist/pi/coding-agent/core/telemetry.js +8 -0
  135. package/dist/pi/coding-agent/core/timings.js +30 -0
  136. package/dist/pi/coding-agent/core/tools/bash.js +341 -0
  137. package/dist/pi/coding-agent/core/tools/edit-diff.js +344 -0
  138. package/dist/pi/coding-agent/core/tools/edit.js +324 -0
  139. package/dist/pi/coding-agent/core/tools/file-mutation-queue.js +36 -0
  140. package/dist/pi/coding-agent/core/tools/find.js +297 -0
  141. package/dist/pi/coding-agent/core/tools/grep.js +303 -0
  142. package/dist/pi/coding-agent/core/tools/index.js +111 -0
  143. package/dist/pi/coding-agent/core/tools/ls.js +168 -0
  144. package/dist/pi/coding-agent/core/tools/output-accumulator.js +183 -0
  145. package/dist/pi/coding-agent/core/tools/path-utils.js +61 -0
  146. package/dist/pi/coding-agent/core/tools/read.js +288 -0
  147. package/dist/pi/coding-agent/core/tools/render-utils.js +48 -0
  148. package/dist/pi/coding-agent/core/tools/tool-definition-wrapper.js +33 -0
  149. package/dist/pi/coding-agent/core/tools/truncate.js +214 -0
  150. package/dist/pi/coding-agent/core/tools/write.js +212 -0
  151. package/dist/pi/coding-agent/index.js +41 -0
  152. package/dist/pi/coding-agent/main.js +5 -0
  153. package/dist/pi/coding-agent/migrations.js +280 -0
  154. package/dist/pi/coding-agent/modes/index.js +7 -0
  155. package/dist/pi/coding-agent/modes/interactive/components/diff.js +132 -0
  156. package/dist/pi/coding-agent/modes/interactive/components/keybinding-hints.js +35 -0
  157. package/dist/pi/coding-agent/modes/interactive/components/visual-truncate.js +32 -0
  158. package/dist/pi/coding-agent/modes/interactive/interactive-mode.js +3 -0
  159. package/dist/pi/coding-agent/modes/interactive/theme/theme.js +1023 -0
  160. package/dist/pi/coding-agent/modes/print-mode.js +130 -0
  161. package/dist/pi/coding-agent/modes/rpc/jsonl.js +48 -0
  162. package/dist/pi/coding-agent/modes/rpc/rpc-client.js +409 -0
  163. package/dist/pi/coding-agent/modes/rpc/rpc-mode.js +600 -0
  164. package/dist/pi/coding-agent/modes/rpc/rpc-types.js +7 -0
  165. package/dist/pi/coding-agent/utils/ansi.js +51 -0
  166. package/dist/pi/coding-agent/utils/changelog.js +86 -0
  167. package/dist/pi/coding-agent/utils/child-process.js +87 -0
  168. package/dist/pi/coding-agent/utils/clipboard-image.js +244 -0
  169. package/dist/pi/coding-agent/utils/clipboard-native.js +13 -0
  170. package/dist/pi/coding-agent/utils/clipboard.js +116 -0
  171. package/dist/pi/coding-agent/utils/exif-orientation.js +157 -0
  172. package/dist/pi/coding-agent/utils/frontmatter.js +25 -0
  173. package/dist/pi/coding-agent/utils/fs-watch.js +24 -0
  174. package/dist/pi/coding-agent/utils/git.js +162 -0
  175. package/dist/pi/coding-agent/utils/html.js +39 -0
  176. package/dist/pi/coding-agent/utils/image-convert.js +38 -0
  177. package/dist/pi/coding-agent/utils/image-resize.js +136 -0
  178. package/dist/pi/coding-agent/utils/mime.js +68 -0
  179. package/dist/pi/coding-agent/utils/paths.js +91 -0
  180. package/dist/pi/coding-agent/utils/photon.js +120 -0
  181. package/dist/pi/coding-agent/utils/pi-user-agent.js +4 -0
  182. package/dist/pi/coding-agent/utils/shell.js +194 -0
  183. package/dist/pi/coding-agent/utils/sleep.js +16 -0
  184. package/dist/pi/coding-agent/utils/syntax-highlight.js +117 -0
  185. package/dist/pi/coding-agent/utils/tools-manager.js +327 -0
  186. package/dist/pi/coding-agent/utils/version-check.js +81 -0
  187. package/dist/pi/coding-agent/utils/windows-self-update.js +76 -0
  188. package/dist/pi/tui/autocomplete.js +631 -0
  189. package/dist/pi/tui/components/box.js +103 -0
  190. package/dist/pi/tui/components/cancellable-loader.js +34 -0
  191. package/dist/pi/tui/components/editor.js +1915 -0
  192. package/dist/pi/tui/components/image.js +88 -0
  193. package/dist/pi/tui/components/input.js +425 -0
  194. package/dist/pi/tui/components/loader.js +68 -0
  195. package/dist/pi/tui/components/markdown.js +633 -0
  196. package/dist/pi/tui/components/select-list.js +158 -0
  197. package/dist/pi/tui/components/settings-list.js +184 -0
  198. package/dist/pi/tui/components/spacer.js +22 -0
  199. package/dist/pi/tui/components/text.js +88 -0
  200. package/dist/pi/tui/components/truncated-text.js +50 -0
  201. package/dist/pi/tui/editor-component.js +1 -0
  202. package/dist/pi/tui/fuzzy.js +109 -0
  203. package/dist/pi/tui/index.js +31 -0
  204. package/dist/pi/tui/keybindings.js +173 -0
  205. package/dist/pi/tui/keys.js +1172 -0
  206. package/dist/pi/tui/kill-ring.js +43 -0
  207. package/dist/pi/tui/stdin-buffer.js +360 -0
  208. package/dist/pi/tui/terminal-image.js +335 -0
  209. package/dist/pi/tui/terminal.js +324 -0
  210. package/dist/pi/tui/tui.js +1076 -0
  211. package/dist/pi/tui/undo-stack.js +24 -0
  212. package/dist/pi/tui/utils.js +1016 -0
  213. package/dist/relay/dispatcher.js +30 -0
  214. package/dist/server/handlers/queue.js +52 -0
  215. package/dist/server/pi-bridge.js +9 -1
  216. package/dist/server/session-stream.js +76 -111
  217. package/dist/server/storage.js +154 -2
  218. package/dist/server/title-generator.js +14 -153
  219. package/package.json +24 -6
@@ -0,0 +1,158 @@
1
+ import { getKeybindings } from "../keybindings.js";
2
+ import { truncateToWidth, visibleWidth } from "../utils.js";
3
+ const DEFAULT_PRIMARY_COLUMN_WIDTH = 32;
4
+ const PRIMARY_COLUMN_GAP = 2;
5
+ const MIN_DESCRIPTION_WIDTH = 10;
6
+ const normalizeToSingleLine = (text) => text.replace(/[\r\n]+/g, " ").trim();
7
+ const clamp = (value, min, max) => Math.max(min, Math.min(value, max));
8
+ export class SelectList {
9
+ items = [];
10
+ filteredItems = [];
11
+ selectedIndex = 0;
12
+ maxVisible = 5;
13
+ theme;
14
+ layout;
15
+ onSelect;
16
+ onCancel;
17
+ onSelectionChange;
18
+ constructor(items, maxVisible, theme, layout = {}) {
19
+ this.items = items;
20
+ this.filteredItems = items;
21
+ this.maxVisible = maxVisible;
22
+ this.theme = theme;
23
+ this.layout = layout;
24
+ }
25
+ setFilter(filter) {
26
+ this.filteredItems = this.items.filter((item) => item.value.toLowerCase().startsWith(filter.toLowerCase()));
27
+ // Reset selection when filter changes
28
+ this.selectedIndex = 0;
29
+ }
30
+ setSelectedIndex(index) {
31
+ this.selectedIndex = Math.max(0, Math.min(index, this.filteredItems.length - 1));
32
+ }
33
+ invalidate() {
34
+ // No cached state to invalidate currently
35
+ }
36
+ render(width) {
37
+ const lines = [];
38
+ // If no items match filter, show message
39
+ if (this.filteredItems.length === 0) {
40
+ lines.push(this.theme.noMatch(" No matching commands"));
41
+ return lines;
42
+ }
43
+ const primaryColumnWidth = this.getPrimaryColumnWidth();
44
+ // Calculate visible range with scrolling
45
+ const startIndex = Math.max(0, Math.min(this.selectedIndex - Math.floor(this.maxVisible / 2), this.filteredItems.length - this.maxVisible));
46
+ const endIndex = Math.min(startIndex + this.maxVisible, this.filteredItems.length);
47
+ // Render visible items
48
+ for (let i = startIndex; i < endIndex; i++) {
49
+ const item = this.filteredItems[i];
50
+ if (!item)
51
+ continue;
52
+ const isSelected = i === this.selectedIndex;
53
+ const descriptionSingleLine = item.description ? normalizeToSingleLine(item.description) : undefined;
54
+ lines.push(this.renderItem(item, isSelected, width, descriptionSingleLine, primaryColumnWidth));
55
+ }
56
+ // Add scroll indicators if needed
57
+ if (startIndex > 0 || endIndex < this.filteredItems.length) {
58
+ const scrollText = ` (${this.selectedIndex + 1}/${this.filteredItems.length})`;
59
+ // Truncate if too long for terminal
60
+ lines.push(this.theme.scrollInfo(truncateToWidth(scrollText, width - 2, "")));
61
+ }
62
+ return lines;
63
+ }
64
+ handleInput(keyData) {
65
+ const kb = getKeybindings();
66
+ // Up arrow - wrap to bottom when at top
67
+ if (kb.matches(keyData, "tui.select.up")) {
68
+ this.selectedIndex = this.selectedIndex === 0 ? this.filteredItems.length - 1 : this.selectedIndex - 1;
69
+ this.notifySelectionChange();
70
+ }
71
+ // Down arrow - wrap to top when at bottom
72
+ else if (kb.matches(keyData, "tui.select.down")) {
73
+ this.selectedIndex = this.selectedIndex === this.filteredItems.length - 1 ? 0 : this.selectedIndex + 1;
74
+ this.notifySelectionChange();
75
+ }
76
+ // Enter
77
+ else if (kb.matches(keyData, "tui.select.confirm")) {
78
+ const selectedItem = this.filteredItems[this.selectedIndex];
79
+ if (selectedItem && this.onSelect) {
80
+ this.onSelect(selectedItem);
81
+ }
82
+ }
83
+ // Escape or Ctrl+C
84
+ else if (kb.matches(keyData, "tui.select.cancel")) {
85
+ if (this.onCancel) {
86
+ this.onCancel();
87
+ }
88
+ }
89
+ }
90
+ renderItem(item, isSelected, width, descriptionSingleLine, primaryColumnWidth) {
91
+ const prefix = isSelected ? "→ " : " ";
92
+ const prefixWidth = visibleWidth(prefix);
93
+ if (descriptionSingleLine && width > 40) {
94
+ const effectivePrimaryColumnWidth = Math.max(1, Math.min(primaryColumnWidth, width - prefixWidth - 4));
95
+ const maxPrimaryWidth = Math.max(1, effectivePrimaryColumnWidth - PRIMARY_COLUMN_GAP);
96
+ const truncatedValue = this.truncatePrimary(item, isSelected, maxPrimaryWidth, effectivePrimaryColumnWidth);
97
+ const truncatedValueWidth = visibleWidth(truncatedValue);
98
+ const spacing = " ".repeat(Math.max(1, effectivePrimaryColumnWidth - truncatedValueWidth));
99
+ const descriptionStart = prefixWidth + truncatedValueWidth + spacing.length;
100
+ const remainingWidth = width - descriptionStart - 2; // -2 for safety
101
+ if (remainingWidth > MIN_DESCRIPTION_WIDTH) {
102
+ const truncatedDesc = truncateToWidth(descriptionSingleLine, remainingWidth, "");
103
+ if (isSelected) {
104
+ return this.theme.selectedText(`${prefix}${truncatedValue}${spacing}${truncatedDesc}`);
105
+ }
106
+ const descText = this.theme.description(spacing + truncatedDesc);
107
+ return prefix + truncatedValue + descText;
108
+ }
109
+ }
110
+ const maxWidth = width - prefixWidth - 2;
111
+ const truncatedValue = this.truncatePrimary(item, isSelected, maxWidth, maxWidth);
112
+ if (isSelected) {
113
+ return this.theme.selectedText(`${prefix}${truncatedValue}`);
114
+ }
115
+ return prefix + truncatedValue;
116
+ }
117
+ getPrimaryColumnWidth() {
118
+ const { min, max } = this.getPrimaryColumnBounds();
119
+ const widestPrimary = this.filteredItems.reduce((widest, item) => {
120
+ return Math.max(widest, visibleWidth(this.getDisplayValue(item)) + PRIMARY_COLUMN_GAP);
121
+ }, 0);
122
+ return clamp(widestPrimary, min, max);
123
+ }
124
+ getPrimaryColumnBounds() {
125
+ const rawMin = this.layout.minPrimaryColumnWidth ?? this.layout.maxPrimaryColumnWidth ?? DEFAULT_PRIMARY_COLUMN_WIDTH;
126
+ const rawMax = this.layout.maxPrimaryColumnWidth ?? this.layout.minPrimaryColumnWidth ?? DEFAULT_PRIMARY_COLUMN_WIDTH;
127
+ return {
128
+ min: Math.max(1, Math.min(rawMin, rawMax)),
129
+ max: Math.max(1, Math.max(rawMin, rawMax)),
130
+ };
131
+ }
132
+ truncatePrimary(item, isSelected, maxWidth, columnWidth) {
133
+ const displayValue = this.getDisplayValue(item);
134
+ const truncatedValue = this.layout.truncatePrimary
135
+ ? this.layout.truncatePrimary({
136
+ text: displayValue,
137
+ maxWidth,
138
+ columnWidth,
139
+ item,
140
+ isSelected,
141
+ })
142
+ : truncateToWidth(displayValue, maxWidth, "");
143
+ return truncateToWidth(truncatedValue, maxWidth, "");
144
+ }
145
+ getDisplayValue(item) {
146
+ return item.label || item.value;
147
+ }
148
+ notifySelectionChange() {
149
+ const selectedItem = this.filteredItems[this.selectedIndex];
150
+ if (selectedItem && this.onSelectionChange) {
151
+ this.onSelectionChange(selectedItem);
152
+ }
153
+ }
154
+ getSelectedItem() {
155
+ const item = this.filteredItems[this.selectedIndex];
156
+ return item || null;
157
+ }
158
+ }
@@ -0,0 +1,184 @@
1
+ import { fuzzyFilter } from "../fuzzy.js";
2
+ import { getKeybindings } from "../keybindings.js";
3
+ import { truncateToWidth, visibleWidth, wrapTextWithAnsi } from "../utils.js";
4
+ import { Input } from "./input.js";
5
+ export class SettingsList {
6
+ items;
7
+ filteredItems;
8
+ theme;
9
+ selectedIndex = 0;
10
+ maxVisible;
11
+ onChange;
12
+ onCancel;
13
+ searchInput;
14
+ searchEnabled;
15
+ // Submenu state
16
+ submenuComponent = null;
17
+ submenuItemIndex = null;
18
+ constructor(items, maxVisible, theme, onChange, onCancel, options = {}) {
19
+ this.items = items;
20
+ this.filteredItems = items;
21
+ this.maxVisible = maxVisible;
22
+ this.theme = theme;
23
+ this.onChange = onChange;
24
+ this.onCancel = onCancel;
25
+ this.searchEnabled = options.enableSearch ?? false;
26
+ if (this.searchEnabled) {
27
+ this.searchInput = new Input();
28
+ }
29
+ }
30
+ /** Update an item's currentValue */
31
+ updateValue(id, newValue) {
32
+ const item = this.items.find((i) => i.id === id);
33
+ if (item) {
34
+ item.currentValue = newValue;
35
+ }
36
+ }
37
+ invalidate() {
38
+ this.submenuComponent?.invalidate?.();
39
+ }
40
+ render(width) {
41
+ // If submenu is active, render it instead
42
+ if (this.submenuComponent) {
43
+ return this.submenuComponent.render(width);
44
+ }
45
+ return this.renderMainList(width);
46
+ }
47
+ renderMainList(width) {
48
+ const lines = [];
49
+ if (this.searchEnabled && this.searchInput) {
50
+ lines.push(...this.searchInput.render(width));
51
+ lines.push("");
52
+ }
53
+ if (this.items.length === 0) {
54
+ lines.push(this.theme.hint(" No settings available"));
55
+ if (this.searchEnabled) {
56
+ this.addHintLine(lines, width);
57
+ }
58
+ return lines;
59
+ }
60
+ const displayItems = this.searchEnabled ? this.filteredItems : this.items;
61
+ if (displayItems.length === 0) {
62
+ lines.push(truncateToWidth(this.theme.hint(" No matching settings"), width));
63
+ this.addHintLine(lines, width);
64
+ return lines;
65
+ }
66
+ // Calculate visible range with scrolling
67
+ const startIndex = Math.max(0, Math.min(this.selectedIndex - Math.floor(this.maxVisible / 2), displayItems.length - this.maxVisible));
68
+ const endIndex = Math.min(startIndex + this.maxVisible, displayItems.length);
69
+ // Calculate max label width for alignment
70
+ const maxLabelWidth = Math.min(30, Math.max(...this.items.map((item) => visibleWidth(item.label))));
71
+ // Render visible items
72
+ for (let i = startIndex; i < endIndex; i++) {
73
+ const item = displayItems[i];
74
+ if (!item)
75
+ continue;
76
+ const isSelected = i === this.selectedIndex;
77
+ const prefix = isSelected ? this.theme.cursor : " ";
78
+ const prefixWidth = visibleWidth(prefix);
79
+ // Pad label to align values
80
+ const labelPadded = item.label + " ".repeat(Math.max(0, maxLabelWidth - visibleWidth(item.label)));
81
+ const labelText = this.theme.label(labelPadded, isSelected);
82
+ // Calculate space for value
83
+ const separator = " ";
84
+ const usedWidth = prefixWidth + maxLabelWidth + visibleWidth(separator);
85
+ const valueMaxWidth = width - usedWidth - 2;
86
+ const valueText = this.theme.value(truncateToWidth(item.currentValue, valueMaxWidth, ""), isSelected);
87
+ lines.push(truncateToWidth(prefix + labelText + separator + valueText, width));
88
+ }
89
+ // Add scroll indicator if needed
90
+ if (startIndex > 0 || endIndex < displayItems.length) {
91
+ const scrollText = ` (${this.selectedIndex + 1}/${displayItems.length})`;
92
+ lines.push(this.theme.hint(truncateToWidth(scrollText, width - 2, "")));
93
+ }
94
+ // Add description for selected item
95
+ const selectedItem = displayItems[this.selectedIndex];
96
+ if (selectedItem?.description) {
97
+ lines.push("");
98
+ const wrappedDesc = wrapTextWithAnsi(selectedItem.description, width - 4);
99
+ for (const line of wrappedDesc) {
100
+ lines.push(this.theme.description(` ${line}`));
101
+ }
102
+ }
103
+ // Add hint
104
+ this.addHintLine(lines, width);
105
+ return lines;
106
+ }
107
+ handleInput(data) {
108
+ // If submenu is active, delegate all input to it
109
+ // The submenu's onCancel (triggered by escape) will call done() which closes it
110
+ if (this.submenuComponent) {
111
+ this.submenuComponent.handleInput?.(data);
112
+ return;
113
+ }
114
+ // Main list input handling
115
+ const kb = getKeybindings();
116
+ const displayItems = this.searchEnabled ? this.filteredItems : this.items;
117
+ if (kb.matches(data, "tui.select.up")) {
118
+ if (displayItems.length === 0)
119
+ return;
120
+ this.selectedIndex = this.selectedIndex === 0 ? displayItems.length - 1 : this.selectedIndex - 1;
121
+ }
122
+ else if (kb.matches(data, "tui.select.down")) {
123
+ if (displayItems.length === 0)
124
+ return;
125
+ this.selectedIndex = this.selectedIndex === displayItems.length - 1 ? 0 : this.selectedIndex + 1;
126
+ }
127
+ else if (kb.matches(data, "tui.select.confirm") || data === " ") {
128
+ this.activateItem();
129
+ }
130
+ else if (kb.matches(data, "tui.select.cancel")) {
131
+ this.onCancel();
132
+ }
133
+ else if (this.searchEnabled && this.searchInput) {
134
+ const sanitized = data.replace(/ /g, "");
135
+ if (!sanitized) {
136
+ return;
137
+ }
138
+ this.searchInput.handleInput(sanitized);
139
+ this.applyFilter(this.searchInput.getValue());
140
+ }
141
+ }
142
+ activateItem() {
143
+ const item = this.searchEnabled ? this.filteredItems[this.selectedIndex] : this.items[this.selectedIndex];
144
+ if (!item)
145
+ return;
146
+ if (item.submenu) {
147
+ // Open submenu, passing current value so it can pre-select correctly
148
+ this.submenuItemIndex = this.selectedIndex;
149
+ this.submenuComponent = item.submenu(item.currentValue, (selectedValue) => {
150
+ if (selectedValue !== undefined) {
151
+ item.currentValue = selectedValue;
152
+ this.onChange(item.id, selectedValue);
153
+ }
154
+ this.closeSubmenu();
155
+ });
156
+ }
157
+ else if (item.values && item.values.length > 0) {
158
+ // Cycle through values
159
+ const currentIndex = item.values.indexOf(item.currentValue);
160
+ const nextIndex = (currentIndex + 1) % item.values.length;
161
+ const newValue = item.values[nextIndex];
162
+ item.currentValue = newValue;
163
+ this.onChange(item.id, newValue);
164
+ }
165
+ }
166
+ closeSubmenu() {
167
+ this.submenuComponent = null;
168
+ // Restore selection to the item that opened the submenu
169
+ if (this.submenuItemIndex !== null) {
170
+ this.selectedIndex = this.submenuItemIndex;
171
+ this.submenuItemIndex = null;
172
+ }
173
+ }
174
+ applyFilter(query) {
175
+ this.filteredItems = fuzzyFilter(this.items, query, (item) => item.label);
176
+ this.selectedIndex = 0;
177
+ }
178
+ addHintLine(lines, width) {
179
+ lines.push("");
180
+ lines.push(truncateToWidth(this.theme.hint(this.searchEnabled
181
+ ? " Type to search · Enter/Space to change · Esc to cancel"
182
+ : " Enter/Space to change · Esc to cancel"), width));
183
+ }
184
+ }
@@ -0,0 +1,22 @@
1
+ /**
2
+ * Spacer component that renders empty lines
3
+ */
4
+ export class Spacer {
5
+ lines;
6
+ constructor(lines = 1) {
7
+ this.lines = lines;
8
+ }
9
+ setLines(lines) {
10
+ this.lines = lines;
11
+ }
12
+ invalidate() {
13
+ // No cached state to invalidate currently
14
+ }
15
+ render(_width) {
16
+ const result = [];
17
+ for (let i = 0; i < this.lines; i++) {
18
+ result.push("");
19
+ }
20
+ return result;
21
+ }
22
+ }
@@ -0,0 +1,88 @@
1
+ import { applyBackgroundToLine, visibleWidth, wrapTextWithAnsi } from "../utils.js";
2
+ /**
3
+ * Text component - displays multi-line text with word wrapping
4
+ */
5
+ export class Text {
6
+ text;
7
+ paddingX; // Left/right padding
8
+ paddingY; // Top/bottom padding
9
+ customBgFn;
10
+ // Cache for rendered output
11
+ cachedText;
12
+ cachedWidth;
13
+ cachedLines;
14
+ constructor(text = "", paddingX = 1, paddingY = 1, customBgFn) {
15
+ this.text = text;
16
+ this.paddingX = paddingX;
17
+ this.paddingY = paddingY;
18
+ this.customBgFn = customBgFn;
19
+ }
20
+ setText(text) {
21
+ this.text = text;
22
+ this.cachedText = undefined;
23
+ this.cachedWidth = undefined;
24
+ this.cachedLines = undefined;
25
+ }
26
+ setCustomBgFn(customBgFn) {
27
+ this.customBgFn = customBgFn;
28
+ this.cachedText = undefined;
29
+ this.cachedWidth = undefined;
30
+ this.cachedLines = undefined;
31
+ }
32
+ invalidate() {
33
+ this.cachedText = undefined;
34
+ this.cachedWidth = undefined;
35
+ this.cachedLines = undefined;
36
+ }
37
+ render(width) {
38
+ // Check cache
39
+ if (this.cachedLines && this.cachedText === this.text && this.cachedWidth === width) {
40
+ return this.cachedLines;
41
+ }
42
+ // Don't render anything if there's no actual text
43
+ if (!this.text || this.text.trim() === "") {
44
+ const result = [];
45
+ this.cachedText = this.text;
46
+ this.cachedWidth = width;
47
+ this.cachedLines = result;
48
+ return result;
49
+ }
50
+ // Replace tabs with 3 spaces
51
+ const normalizedText = this.text.replace(/\t/g, " ");
52
+ // Calculate content width (subtract left/right margins)
53
+ const contentWidth = Math.max(1, width - this.paddingX * 2);
54
+ // Wrap text (this preserves ANSI codes but does NOT pad)
55
+ const wrappedLines = wrapTextWithAnsi(normalizedText, contentWidth);
56
+ // Add margins and background to each line
57
+ const leftMargin = " ".repeat(this.paddingX);
58
+ const rightMargin = " ".repeat(this.paddingX);
59
+ const contentLines = [];
60
+ for (const line of wrappedLines) {
61
+ // Add margins
62
+ const lineWithMargins = leftMargin + line + rightMargin;
63
+ // Apply background if specified (this also pads to full width)
64
+ if (this.customBgFn) {
65
+ contentLines.push(applyBackgroundToLine(lineWithMargins, width, this.customBgFn));
66
+ }
67
+ else {
68
+ // No background - just pad to width with spaces
69
+ const visibleLen = visibleWidth(lineWithMargins);
70
+ const paddingNeeded = Math.max(0, width - visibleLen);
71
+ contentLines.push(lineWithMargins + " ".repeat(paddingNeeded));
72
+ }
73
+ }
74
+ // Add top/bottom padding (empty lines)
75
+ const emptyLine = " ".repeat(width);
76
+ const emptyLines = [];
77
+ for (let i = 0; i < this.paddingY; i++) {
78
+ const line = this.customBgFn ? applyBackgroundToLine(emptyLine, width, this.customBgFn) : emptyLine;
79
+ emptyLines.push(line);
80
+ }
81
+ const result = [...emptyLines, ...contentLines, ...emptyLines];
82
+ // Update cache
83
+ this.cachedText = this.text;
84
+ this.cachedWidth = width;
85
+ this.cachedLines = result;
86
+ return result.length > 0 ? result : [""];
87
+ }
88
+ }
@@ -0,0 +1,50 @@
1
+ import { truncateToWidth, visibleWidth } from "../utils.js";
2
+ /**
3
+ * Text component that truncates to fit viewport width
4
+ */
5
+ export class TruncatedText {
6
+ text;
7
+ paddingX;
8
+ paddingY;
9
+ constructor(text, paddingX = 0, paddingY = 0) {
10
+ this.text = text;
11
+ this.paddingX = paddingX;
12
+ this.paddingY = paddingY;
13
+ }
14
+ invalidate() {
15
+ // No cached state to invalidate currently
16
+ }
17
+ render(width) {
18
+ const result = [];
19
+ // Empty line padded to width
20
+ const emptyLine = " ".repeat(width);
21
+ // Add vertical padding above
22
+ for (let i = 0; i < this.paddingY; i++) {
23
+ result.push(emptyLine);
24
+ }
25
+ // Calculate available width after horizontal padding
26
+ const availableWidth = Math.max(1, width - this.paddingX * 2);
27
+ // Take only the first line (stop at newline)
28
+ let singleLineText = this.text;
29
+ const newlineIndex = this.text.indexOf("\n");
30
+ if (newlineIndex !== -1) {
31
+ singleLineText = this.text.substring(0, newlineIndex);
32
+ }
33
+ // Truncate text if needed (accounting for ANSI codes)
34
+ const displayText = truncateToWidth(singleLineText, availableWidth);
35
+ // Add horizontal padding
36
+ const leftPadding = " ".repeat(this.paddingX);
37
+ const rightPadding = " ".repeat(this.paddingX);
38
+ const lineWithPadding = leftPadding + displayText + rightPadding;
39
+ // Pad line to exactly width characters
40
+ const lineVisibleWidth = visibleWidth(lineWithPadding);
41
+ const paddingNeeded = Math.max(0, width - lineVisibleWidth);
42
+ const finalLine = lineWithPadding + " ".repeat(paddingNeeded);
43
+ result.push(finalLine);
44
+ // Add vertical padding below
45
+ for (let i = 0; i < this.paddingY; i++) {
46
+ result.push(emptyLine);
47
+ }
48
+ return result;
49
+ }
50
+ }
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,109 @@
1
+ /**
2
+ * Fuzzy matching utilities.
3
+ * Matches if all query characters appear in order (not necessarily consecutive).
4
+ * Lower score = better match.
5
+ */
6
+ export function fuzzyMatch(query, text) {
7
+ const queryLower = query.toLowerCase();
8
+ const textLower = text.toLowerCase();
9
+ const matchQuery = (normalizedQuery) => {
10
+ if (normalizedQuery.length === 0) {
11
+ return { matches: true, score: 0 };
12
+ }
13
+ if (normalizedQuery.length > textLower.length) {
14
+ return { matches: false, score: 0 };
15
+ }
16
+ let queryIndex = 0;
17
+ let score = 0;
18
+ let lastMatchIndex = -1;
19
+ let consecutiveMatches = 0;
20
+ for (let i = 0; i < textLower.length && queryIndex < normalizedQuery.length; i++) {
21
+ if (textLower[i] === normalizedQuery[queryIndex]) {
22
+ const isWordBoundary = i === 0 || /[\s\-_./:]/.test(textLower[i - 1]);
23
+ // Reward consecutive matches
24
+ if (lastMatchIndex === i - 1) {
25
+ consecutiveMatches++;
26
+ score -= consecutiveMatches * 5;
27
+ }
28
+ else {
29
+ consecutiveMatches = 0;
30
+ // Penalize gaps
31
+ if (lastMatchIndex >= 0) {
32
+ score += (i - lastMatchIndex - 1) * 2;
33
+ }
34
+ }
35
+ // Reward word boundary matches
36
+ if (isWordBoundary) {
37
+ score -= 10;
38
+ }
39
+ // Slight penalty for later matches
40
+ score += i * 0.1;
41
+ lastMatchIndex = i;
42
+ queryIndex++;
43
+ }
44
+ }
45
+ if (queryIndex < normalizedQuery.length) {
46
+ return { matches: false, score: 0 };
47
+ }
48
+ if (normalizedQuery === textLower) {
49
+ score -= 100;
50
+ }
51
+ return { matches: true, score };
52
+ };
53
+ const primaryMatch = matchQuery(queryLower);
54
+ if (primaryMatch.matches) {
55
+ return primaryMatch;
56
+ }
57
+ const alphaNumericMatch = queryLower.match(/^(?<letters>[a-z]+)(?<digits>[0-9]+)$/);
58
+ const numericAlphaMatch = queryLower.match(/^(?<digits>[0-9]+)(?<letters>[a-z]+)$/);
59
+ const swappedQuery = alphaNumericMatch
60
+ ? `${alphaNumericMatch.groups?.digits ?? ""}${alphaNumericMatch.groups?.letters ?? ""}`
61
+ : numericAlphaMatch
62
+ ? `${numericAlphaMatch.groups?.letters ?? ""}${numericAlphaMatch.groups?.digits ?? ""}`
63
+ : "";
64
+ if (!swappedQuery) {
65
+ return primaryMatch;
66
+ }
67
+ const swappedMatch = matchQuery(swappedQuery);
68
+ if (!swappedMatch.matches) {
69
+ return primaryMatch;
70
+ }
71
+ return { matches: true, score: swappedMatch.score + 5 };
72
+ }
73
+ /**
74
+ * Filter and sort items by fuzzy match quality (best matches first).
75
+ * Supports space-separated tokens: all tokens must match.
76
+ */
77
+ export function fuzzyFilter(items, query, getText) {
78
+ if (!query.trim()) {
79
+ return items;
80
+ }
81
+ const tokens = query
82
+ .trim()
83
+ .split(/\s+/)
84
+ .filter((t) => t.length > 0);
85
+ if (tokens.length === 0) {
86
+ return items;
87
+ }
88
+ const results = [];
89
+ for (const item of items) {
90
+ const text = getText(item);
91
+ let totalScore = 0;
92
+ let allMatch = true;
93
+ for (const token of tokens) {
94
+ const match = fuzzyMatch(token, text);
95
+ if (match.matches) {
96
+ totalScore += match.score;
97
+ }
98
+ else {
99
+ allMatch = false;
100
+ break;
101
+ }
102
+ }
103
+ if (allMatch) {
104
+ results.push({ item, totalScore });
105
+ }
106
+ }
107
+ results.sort((a, b) => a.totalScore - b.totalScore);
108
+ return results.map((r) => r.item);
109
+ }
@@ -0,0 +1,31 @@
1
+ // Core TUI interfaces and classes
2
+ // Autocomplete support
3
+ export { CombinedAutocompleteProvider, } from "./autocomplete.js";
4
+ // Components
5
+ export { Box } from "./components/box.js";
6
+ export { CancellableLoader } from "./components/cancellable-loader.js";
7
+ export { Editor } from "./components/editor.js";
8
+ export { Image } from "./components/image.js";
9
+ export { Input } from "./components/input.js";
10
+ export { Loader } from "./components/loader.js";
11
+ export { Markdown } from "./components/markdown.js";
12
+ export { SelectList, } from "./components/select-list.js";
13
+ export { SettingsList } from "./components/settings-list.js";
14
+ export { Spacer } from "./components/spacer.js";
15
+ export { Text } from "./components/text.js";
16
+ export { TruncatedText } from "./components/truncated-text.js";
17
+ // Fuzzy matching
18
+ export { fuzzyFilter, fuzzyMatch } from "./fuzzy.js";
19
+ // Keybindings
20
+ export { getKeybindings, KeybindingsManager, setKeybindings, TUI_KEYBINDINGS, } from "./keybindings.js";
21
+ // Keyboard input handling
22
+ export { decodeKittyPrintable, isKeyRelease, isKeyRepeat, isKittyProtocolActive, Key, matchesKey, parseKey, setKittyProtocolActive, } from "./keys.js";
23
+ // Input buffering for batch splitting
24
+ export { StdinBuffer } from "./stdin-buffer.js";
25
+ // Terminal interface and implementations
26
+ export { ProcessTerminal } from "./terminal.js";
27
+ // Terminal image support
28
+ export { allocateImageId, calculateImageRows, deleteAllKittyImages, deleteKittyImage, detectCapabilities, encodeITerm2, encodeKitty, getCapabilities, getCellDimensions, getGifDimensions, getImageDimensions, getJpegDimensions, getPngDimensions, getWebpDimensions, hyperlink, imageFallback, renderImage, resetCapabilitiesCache, setCapabilities, setCellDimensions, } from "./terminal-image.js";
29
+ export { Container, CURSOR_MARKER, isFocusable, TUI, } from "./tui.js";
30
+ // Utilities
31
+ export { truncateToWidth, visibleWidth, wrapTextWithAnsi } from "./utils.js";