pmx-canvas 0.1.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 (226) hide show
  1. package/CHANGELOG.md +38 -0
  2. package/LICENSE +21 -0
  3. package/Readme.md +865 -0
  4. package/dist/canvas/global.css +3173 -0
  5. package/dist/canvas/index.js +183 -0
  6. package/dist/json-render/index.css +2 -0
  7. package/dist/json-render/index.js +389 -0
  8. package/dist/types/cli/agent.d.ts +13 -0
  9. package/dist/types/cli/index.d.ts +2 -0
  10. package/dist/types/cli/watch.d.ts +5 -0
  11. package/dist/types/client/App.d.ts +1 -0
  12. package/dist/types/client/canvas/AttentionHistory.d.ts +1 -0
  13. package/dist/types/client/canvas/AttentionToast.d.ts +1 -0
  14. package/dist/types/client/canvas/CanvasNode.d.ts +8 -0
  15. package/dist/types/client/canvas/CanvasViewport.d.ts +8 -0
  16. package/dist/types/client/canvas/CommandPalette.d.ts +4 -0
  17. package/dist/types/client/canvas/ContextMenu.d.ts +24 -0
  18. package/dist/types/client/canvas/ContextPinBar.d.ts +1 -0
  19. package/dist/types/client/canvas/ContextPinHud.d.ts +1 -0
  20. package/dist/types/client/canvas/DockedNode.d.ts +4 -0
  21. package/dist/types/client/canvas/EdgeLayer.d.ts +8 -0
  22. package/dist/types/client/canvas/ExpandedNodeOverlay.d.ts +1 -0
  23. package/dist/types/client/canvas/FocusFieldLayer.d.ts +1 -0
  24. package/dist/types/client/canvas/Minimap.d.ts +23 -0
  25. package/dist/types/client/canvas/SelectionBar.d.ts +1 -0
  26. package/dist/types/client/canvas/ShortcutOverlay.d.ts +3 -0
  27. package/dist/types/client/canvas/SnapshotPanel.d.ts +7 -0
  28. package/dist/types/client/canvas/snap-guides.d.ts +23 -0
  29. package/dist/types/client/canvas/use-node-drag.d.ts +15 -0
  30. package/dist/types/client/canvas/use-node-resize.d.ts +15 -0
  31. package/dist/types/client/canvas/use-pan-zoom.d.ts +16 -0
  32. package/dist/types/client/ext-app/bridge.d.ts +161 -0
  33. package/dist/types/client/icons.d.ts +70 -0
  34. package/dist/types/client/index.d.ts +1 -0
  35. package/dist/types/client/nodes/ContextNode.d.ts +34 -0
  36. package/dist/types/client/nodes/ExtAppFrame.d.ts +18 -0
  37. package/dist/types/client/nodes/FileNode.d.ts +5 -0
  38. package/dist/types/client/nodes/GroupNode.d.ts +6 -0
  39. package/dist/types/client/nodes/ImageNode.d.ts +10 -0
  40. package/dist/types/client/nodes/InlineFormatBar.d.ts +7 -0
  41. package/dist/types/client/nodes/InlineMarkdownEditor.d.ts +14 -0
  42. package/dist/types/client/nodes/LedgerNode.d.ts +4 -0
  43. package/dist/types/client/nodes/MarkdownNode.d.ts +6 -0
  44. package/dist/types/client/nodes/McpAppNode.d.ts +4 -0
  45. package/dist/types/client/nodes/MdFormatBar.d.ts +8 -0
  46. package/dist/types/client/nodes/PromptNode.d.ts +5 -0
  47. package/dist/types/client/nodes/ResponseNode.d.ts +5 -0
  48. package/dist/types/client/nodes/StatusNode.d.ts +4 -0
  49. package/dist/types/client/nodes/StatusSummary.d.ts +4 -0
  50. package/dist/types/client/nodes/TraceNode.d.ts +4 -0
  51. package/dist/types/client/nodes/WebpageNode.d.ts +5 -0
  52. package/dist/types/client/nodes/image-warnings.d.ts +6 -0
  53. package/dist/types/client/nodes/inline-editor-commands.d.ts +11 -0
  54. package/dist/types/client/nodes/md-format.d.ts +25 -0
  55. package/dist/types/client/state/attention-bridge.d.ts +3 -0
  56. package/dist/types/client/state/attention-store.d.ts +25 -0
  57. package/dist/types/client/state/canvas-store.d.ts +74 -0
  58. package/dist/types/client/state/intent-bridge.d.ts +158 -0
  59. package/dist/types/client/state/sse-bridge.d.ts +5 -0
  60. package/dist/types/client/theme/tokens.d.ts +27 -0
  61. package/dist/types/client/types.d.ts +40 -0
  62. package/dist/types/client/utils/ext-app-tool-result.d.ts +1 -0
  63. package/dist/types/client/utils/placement.d.ts +1 -0
  64. package/dist/types/client/utils/platform.d.ts +2 -0
  65. package/dist/types/json-render/catalog.d.ts +815 -0
  66. package/dist/types/json-render/charts/components.d.ts +54 -0
  67. package/dist/types/json-render/charts/definitions.d.ts +103 -0
  68. package/dist/types/json-render/charts/extra-components.d.ts +58 -0
  69. package/dist/types/json-render/charts/extra-definitions.d.ts +181 -0
  70. package/dist/types/json-render/renderer/index.d.ts +16 -0
  71. package/dist/types/json-render/schema.d.ts +46 -0
  72. package/dist/types/json-render/server.d.ts +55 -0
  73. package/dist/types/mcp/server.d.ts +22 -0
  74. package/dist/types/server/agent-context.d.ts +21 -0
  75. package/dist/types/server/artifact-paths.d.ts +3 -0
  76. package/dist/types/server/canvas-operations.d.ts +154 -0
  77. package/dist/types/server/canvas-provenance.d.ts +13 -0
  78. package/dist/types/server/canvas-schema.d.ts +49 -0
  79. package/dist/types/server/canvas-serialization.d.ts +25 -0
  80. package/dist/types/server/canvas-state.d.ts +174 -0
  81. package/dist/types/server/canvas-validation.d.ts +33 -0
  82. package/dist/types/server/chart-template.d.ts +29 -0
  83. package/dist/types/server/code-graph.d.ts +67 -0
  84. package/dist/types/server/context-cards.d.ts +24 -0
  85. package/dist/types/server/diagram-presets.d.ts +28 -0
  86. package/dist/types/server/ext-app-call-registry.d.ts +16 -0
  87. package/dist/types/server/ext-app-tool-result.d.ts +1 -0
  88. package/dist/types/server/file-watcher.d.ts +16 -0
  89. package/dist/types/server/index.d.ts +243 -0
  90. package/dist/types/server/mcp-app-candidate.d.ts +25 -0
  91. package/dist/types/server/mcp-app-host.d.ts +65 -0
  92. package/dist/types/server/mcp-app-runtime.d.ts +47 -0
  93. package/dist/types/server/mutation-history.d.ts +105 -0
  94. package/dist/types/server/placement.d.ts +37 -0
  95. package/dist/types/server/server.d.ts +103 -0
  96. package/dist/types/server/spatial-analysis.d.ts +87 -0
  97. package/dist/types/server/trace-manager.d.ts +48 -0
  98. package/dist/types/server/web-artifacts.d.ts +50 -0
  99. package/dist/types/server/webpage-node.d.ts +25 -0
  100. package/dist/types/shared/auto-arrange.d.ts +29 -0
  101. package/dist/types/shared/ext-app-tool-result.d.ts +9 -0
  102. package/dist/types/shared/placement.d.ts +26 -0
  103. package/dist/types/shared/semantic-attention.d.ts +97 -0
  104. package/package.json +109 -0
  105. package/skills/data-analysis/SKILL.md +324 -0
  106. package/skills/doc-coauthoring/SKILL.md +375 -0
  107. package/skills/frontend-design/SKILL.md +45 -0
  108. package/skills/json-render-codegen/SKILL.md +112 -0
  109. package/skills/json-render-core/SKILL.md +265 -0
  110. package/skills/json-render-ink/SKILL.md +273 -0
  111. package/skills/json-render-mcp/SKILL.md +132 -0
  112. package/skills/json-render-react/SKILL.md +264 -0
  113. package/skills/json-render-shadcn/SKILL.md +159 -0
  114. package/skills/playwright-cli/SKILL.md +67 -0
  115. package/skills/pmx-canvas/SKILL.md +668 -0
  116. package/skills/pmx-canvas/evals/evals.json +186 -0
  117. package/skills/pmx-canvas-testing/SKILL.md +78 -0
  118. package/skills/published-consumer-e2e/SKILL.md +43 -0
  119. package/skills/published-consumer-e2e/scripts/run-published-consumer-e2e.sh +241 -0
  120. package/skills/web-artifacts-builder/SKILL.md +80 -0
  121. package/skills/web-artifacts-builder/scripts/bundle-artifact.sh +167 -0
  122. package/skills/web-artifacts-builder/scripts/init-artifact.sh +425 -0
  123. package/skills/web-artifacts-builder/scripts/shadcn-components.tar.gz +0 -0
  124. package/skills/web-design-guidelines/SKILL.md +39 -0
  125. package/src/cli/agent.ts +2144 -0
  126. package/src/cli/index.ts +622 -0
  127. package/src/cli/watch.ts +88 -0
  128. package/src/client/App.tsx +507 -0
  129. package/src/client/canvas/AttentionHistory.tsx +81 -0
  130. package/src/client/canvas/AttentionToast.tsx +19 -0
  131. package/src/client/canvas/CanvasNode.tsx +363 -0
  132. package/src/client/canvas/CanvasViewport.tsx +590 -0
  133. package/src/client/canvas/CommandPalette.tsx +302 -0
  134. package/src/client/canvas/ContextMenu.tsx +601 -0
  135. package/src/client/canvas/ContextPinBar.tsx +25 -0
  136. package/src/client/canvas/ContextPinHud.tsx +22 -0
  137. package/src/client/canvas/DockedNode.tsx +66 -0
  138. package/src/client/canvas/EdgeLayer.tsx +280 -0
  139. package/src/client/canvas/ExpandedNodeOverlay.tsx +260 -0
  140. package/src/client/canvas/FocusFieldLayer.tsx +107 -0
  141. package/src/client/canvas/Minimap.tsx +301 -0
  142. package/src/client/canvas/SelectionBar.tsx +69 -0
  143. package/src/client/canvas/ShortcutOverlay.tsx +69 -0
  144. package/src/client/canvas/SnapshotPanel.tsx +236 -0
  145. package/src/client/canvas/snap-guides.ts +170 -0
  146. package/src/client/canvas/use-node-drag.ts +51 -0
  147. package/src/client/canvas/use-node-resize.ts +59 -0
  148. package/src/client/canvas/use-pan-zoom.ts +191 -0
  149. package/src/client/ext-app/bridge.ts +542 -0
  150. package/src/client/icons.tsx +424 -0
  151. package/src/client/index.tsx +7 -0
  152. package/src/client/nodes/ContextNode.tsx +412 -0
  153. package/src/client/nodes/ExtAppFrame.tsx +509 -0
  154. package/src/client/nodes/FileNode.tsx +256 -0
  155. package/src/client/nodes/GroupNode.tsx +39 -0
  156. package/src/client/nodes/ImageNode.tsx +160 -0
  157. package/src/client/nodes/InlineFormatBar.tsx +169 -0
  158. package/src/client/nodes/InlineMarkdownEditor.tsx +123 -0
  159. package/src/client/nodes/LedgerNode.tsx +37 -0
  160. package/src/client/nodes/MarkdownNode.tsx +359 -0
  161. package/src/client/nodes/McpAppNode.tsx +85 -0
  162. package/src/client/nodes/MdFormatBar.tsx +109 -0
  163. package/src/client/nodes/PromptNode.tsx +597 -0
  164. package/src/client/nodes/ResponseNode.tsx +153 -0
  165. package/src/client/nodes/StatusNode.tsx +84 -0
  166. package/src/client/nodes/StatusSummary.tsx +38 -0
  167. package/src/client/nodes/TraceNode.tsx +120 -0
  168. package/src/client/nodes/WebpageNode.tsx +288 -0
  169. package/src/client/nodes/image-warnings.ts +95 -0
  170. package/src/client/nodes/inline-editor-commands.ts +37 -0
  171. package/src/client/nodes/md-format.ts +206 -0
  172. package/src/client/state/attention-bridge.ts +328 -0
  173. package/src/client/state/attention-store.ts +73 -0
  174. package/src/client/state/canvas-store.ts +631 -0
  175. package/src/client/state/intent-bridge.ts +315 -0
  176. package/src/client/state/sse-bridge.ts +965 -0
  177. package/src/client/theme/global.css +3173 -0
  178. package/src/client/theme/tokens.ts +72 -0
  179. package/src/client/types-shims.d.ts +5 -0
  180. package/src/client/types.ts +81 -0
  181. package/src/client/utils/ext-app-tool-result.ts +4 -0
  182. package/src/client/utils/placement.ts +4 -0
  183. package/src/client/utils/platform.ts +2 -0
  184. package/src/json-render/catalog.ts +256 -0
  185. package/src/json-render/charts/components.tsx +198 -0
  186. package/src/json-render/charts/definitions.ts +81 -0
  187. package/src/json-render/charts/extra-components.tsx +267 -0
  188. package/src/json-render/charts/extra-definitions.ts +145 -0
  189. package/src/json-render/renderer/index.css +174 -0
  190. package/src/json-render/renderer/index.tsx +86 -0
  191. package/src/json-render/schema.ts +62 -0
  192. package/src/json-render/server.ts +597 -0
  193. package/src/mcp/server.ts +1377 -0
  194. package/src/server/agent-context.ts +242 -0
  195. package/src/server/artifact-paths.ts +17 -0
  196. package/src/server/canvas-operations.ts +1279 -0
  197. package/src/server/canvas-provenance.ts +243 -0
  198. package/src/server/canvas-schema.ts +432 -0
  199. package/src/server/canvas-serialization.ts +95 -0
  200. package/src/server/canvas-state.ts +1134 -0
  201. package/src/server/canvas-validation.ts +114 -0
  202. package/src/server/chart-template.ts +449 -0
  203. package/src/server/code-graph.ts +370 -0
  204. package/src/server/context-cards.ts +31 -0
  205. package/src/server/diagram-presets.ts +71 -0
  206. package/src/server/ext-app-call-registry.ts +77 -0
  207. package/src/server/ext-app-tool-result.ts +4 -0
  208. package/src/server/file-watcher.ts +121 -0
  209. package/src/server/index.ts +647 -0
  210. package/src/server/mcp-app-candidate.ts +174 -0
  211. package/src/server/mcp-app-host.ts +814 -0
  212. package/src/server/mcp-app-runtime.ts +459 -0
  213. package/src/server/mutation-history.ts +350 -0
  214. package/src/server/placement.ts +125 -0
  215. package/src/server/server.ts +3846 -0
  216. package/src/server/spatial-analysis.ts +356 -0
  217. package/src/server/trace-manager.ts +333 -0
  218. package/src/server/web-artifacts/scripts/bundle-artifact.sh +167 -0
  219. package/src/server/web-artifacts/scripts/init-artifact.sh +426 -0
  220. package/src/server/web-artifacts/scripts/shadcn-components.tar.gz +0 -0
  221. package/src/server/web-artifacts.ts +442 -0
  222. package/src/server/webpage-node.ts +328 -0
  223. package/src/shared/auto-arrange.ts +439 -0
  224. package/src/shared/ext-app-tool-result.ts +76 -0
  225. package/src/shared/placement.ts +81 -0
  226. package/src/shared/semantic-attention.ts +598 -0
@@ -0,0 +1,302 @@
1
+ import { useCallback, useEffect, useRef, useState } from 'preact/hooks';
2
+ import {
3
+ autoArrange,
4
+ canvasTheme,
5
+ fitAll,
6
+ focusNode,
7
+ forceDirectedArrange,
8
+ nodes,
9
+ searchHighlightIds,
10
+ } from '../state/canvas-store';
11
+ import { createNodeFromClient } from '../state/intent-bridge';
12
+ import { TYPE_LABELS, type CanvasNodeState } from '../types';
13
+ import { invalidateTokenCache } from '../theme/tokens';
14
+
15
+ import { MOD_KEY } from '../utils/platform';
16
+
17
+ // ── Types ───────────────────────────────────────────────────
18
+ interface PaletteItem {
19
+ id: string;
20
+ kind: 'node' | 'action';
21
+ label: string;
22
+ description?: string;
23
+ badge: string;
24
+ badgeClass?: string;
25
+ nodeType?: CanvasNodeState['type'];
26
+ action: () => void;
27
+ }
28
+
29
+ // ── Fuzzy match ─────────────────────────────────────────────
30
+ function fuzzyMatch(query: string, text: string): { match: boolean; score: number; indices: number[] } {
31
+ const q = query.toLowerCase();
32
+ const t = text.toLowerCase();
33
+ const indices: number[] = [];
34
+ let qi = 0;
35
+ let score = 0;
36
+ let lastIdx = -1;
37
+
38
+ for (let ti = 0; ti < t.length && qi < q.length; ti++) {
39
+ if (t[ti] === q[qi]) {
40
+ indices.push(ti);
41
+ // Consecutive chars bonus
42
+ score += (lastIdx === ti - 1) ? 10 : 1;
43
+ // Start-of-word bonus
44
+ if (ti === 0 || t[ti - 1] === ' ' || t[ti - 1] === '-' || t[ti - 1] === '_') score += 5;
45
+ lastIdx = ti;
46
+ qi++;
47
+ }
48
+ }
49
+
50
+ return { match: qi === q.length, score, indices };
51
+ }
52
+
53
+ function highlightMatch(text: string, indices: number[]) {
54
+ if (indices.length === 0) return text;
55
+ const result: (string | preact.JSX.Element)[] = [];
56
+ let last = 0;
57
+ for (const idx of indices) {
58
+ if (idx > last) result.push(text.slice(last, idx));
59
+ result.push(<mark key={idx}>{text[idx]}</mark>);
60
+ last = idx + 1;
61
+ }
62
+ if (last < text.length) result.push(text.slice(last));
63
+ return result;
64
+ }
65
+
66
+ // ── Type filter aliases ─────────────────────────────────────
67
+ const TYPE_ALIASES: Record<string, CanvasNodeState['type']> = {
68
+ md: 'markdown',
69
+ app: 'mcp-app',
70
+ web: 'webpage',
71
+ ui: 'json-render',
72
+ chart: 'graph',
73
+ ctx: 'context',
74
+ log: 'ledger',
75
+ };
76
+
77
+ function parseTypeFilter(query: string): { typeFilter: CanvasNodeState['type'] | null; remaining: string } {
78
+ const lower = query.toLowerCase().trim();
79
+
80
+ // type:xxx prefix
81
+ if (lower.startsWith('type:')) {
82
+ const typePart = lower.slice(5).trim();
83
+ const allTypes = Object.keys(TYPE_LABELS) as CanvasNodeState['type'][];
84
+ const matched = allTypes.find((t) => t.startsWith(typePart));
85
+ if (matched) return { typeFilter: matched, remaining: '' };
86
+ const aliased = TYPE_ALIASES[typePart];
87
+ if (aliased) return { typeFilter: aliased, remaining: '' };
88
+ }
89
+
90
+ // Exact alias match
91
+ if (TYPE_ALIASES[lower]) return { typeFilter: TYPE_ALIASES[lower], remaining: '' };
92
+
93
+ return { typeFilter: null, remaining: query };
94
+ }
95
+
96
+ // ── Component ───────────────────────────────────────────────
97
+ export function CommandPalette({
98
+ onClose,
99
+ onToggleMinimap,
100
+ }: {
101
+ onClose: () => void;
102
+ onToggleMinimap: () => void;
103
+ }) {
104
+ const [query, setQuery] = useState('');
105
+ const [selectedIndex, setSelectedIndex] = useState(0);
106
+ const inputRef = useRef<HTMLInputElement>(null);
107
+ const listRef = useRef<HTMLDivElement>(null);
108
+
109
+ // Autofocus
110
+ useEffect(() => {
111
+ setTimeout(() => inputRef.current?.focus(), 30);
112
+ }, []);
113
+
114
+ // ── Build items ─────────────────────────────────────────
115
+ const buildItems = useCallback((): PaletteItem[] => {
116
+ const items: PaletteItem[] = [];
117
+
118
+ // Node items
119
+ for (const node of nodes.value.values()) {
120
+ const title = (node.data.title as string) || TYPE_LABELS[node.type];
121
+ const content = (node.data.content as string) || (node.data.path as string) || '';
122
+ items.push({
123
+ id: `node:${node.id}`,
124
+ kind: 'node',
125
+ label: title,
126
+ description: content.length > 80 ? content.slice(0, 80) + '...' : content || undefined,
127
+ badge: TYPE_LABELS[node.type],
128
+ nodeType: node.type,
129
+ action: () => {
130
+ focusNode(node.id);
131
+ onClose();
132
+ },
133
+ });
134
+ }
135
+
136
+ // Action items
137
+ const actions: Array<{ label: string; badge: string; action: () => void }> = [
138
+ { label: 'New note (markdown node)', badge: 'CREATE', action: () => { createNodeFromClient({ type: 'markdown', title: 'New note' }); onClose(); } },
139
+ { label: 'Fit all nodes', badge: 'VIEW', action: () => { fitAll(window.innerWidth, window.innerHeight); onClose(); } },
140
+ { label: 'Auto-arrange (grid)', badge: 'LAYOUT', action: () => { autoArrange(); onClose(); } },
141
+ { label: 'Auto-arrange (graph-aware)', badge: 'LAYOUT', action: () => { forceDirectedArrange(); onClose(); } },
142
+ { label: 'Toggle minimap', badge: 'VIEW', action: () => { onToggleMinimap(); onClose(); } },
143
+ {
144
+ label: 'Toggle theme (dark/light)',
145
+ badge: 'THEME',
146
+ action: () => {
147
+ const next = canvasTheme.value === 'dark' ? 'light' : 'dark';
148
+ canvasTheme.value = next;
149
+ document.documentElement.setAttribute('data-theme', next);
150
+ invalidateTokenCache();
151
+ onClose();
152
+ },
153
+ },
154
+ ];
155
+
156
+ for (const a of actions) {
157
+ items.push({
158
+ id: `action:${a.label}`,
159
+ kind: 'action',
160
+ label: a.label,
161
+ badge: a.badge,
162
+ badgeClass: 'command-palette-badge--action',
163
+ action: a.action,
164
+ });
165
+ }
166
+
167
+ return items;
168
+ }, [onClose, onToggleMinimap]);
169
+
170
+ // ── Filter items ────────────────────────────────────────
171
+ const { typeFilter, remaining } = parseTypeFilter(query);
172
+ const allItems = buildItems();
173
+
174
+ let filtered: Array<PaletteItem & { score: number; indices: number[] }>;
175
+ if (!query.trim()) {
176
+ // No query: show all, nodes first
177
+ filtered = allItems.map((item) => ({ ...item, score: 0, indices: [] }));
178
+ } else {
179
+ filtered = [];
180
+ for (const item of allItems) {
181
+ // Type filter
182
+ if (typeFilter) {
183
+ if (item.kind !== 'node' || item.nodeType !== typeFilter) continue;
184
+ if (!remaining) {
185
+ filtered.push({ ...item, score: 0, indices: [] });
186
+ continue;
187
+ }
188
+ }
189
+
190
+ const result = fuzzyMatch(remaining || query, item.label);
191
+ if (result.match) {
192
+ filtered.push({ ...item, score: result.score, indices: result.indices });
193
+ }
194
+ }
195
+ // Sort by score descending
196
+ filtered.sort((a, b) => b.score - a.score);
197
+ }
198
+
199
+ // ── Sync spatial search highlights to canvas ──────────────
200
+ useEffect(() => {
201
+ if (!query.trim()) {
202
+ searchHighlightIds.value = null;
203
+ return;
204
+ }
205
+ const nodeIds = new Set<string>();
206
+ for (const item of filtered) {
207
+ if (item.kind === 'node') {
208
+ // Extract node ID from "node:xxx" format
209
+ nodeIds.add(item.id.slice(5));
210
+ }
211
+ }
212
+ searchHighlightIds.value = nodeIds.size > 0 ? nodeIds : null;
213
+ }, [query, filtered]);
214
+
215
+ // Clear highlights on unmount (palette close)
216
+ useEffect(() => {
217
+ return () => { searchHighlightIds.value = null; };
218
+ }, []);
219
+
220
+ // Clamp selected index
221
+ const clampedIndex = Math.min(selectedIndex, Math.max(0, filtered.length - 1));
222
+
223
+ // ── Keyboard nav ────────────────────────────────────────
224
+ const handleKeyDown = useCallback(
225
+ (e: KeyboardEvent) => {
226
+ if (e.key === 'ArrowDown') {
227
+ e.preventDefault();
228
+ setSelectedIndex((i) => Math.min(i + 1, filtered.length - 1));
229
+ } else if (e.key === 'ArrowUp') {
230
+ e.preventDefault();
231
+ setSelectedIndex((i) => Math.max(i - 1, 0));
232
+ } else if (e.key === 'Enter') {
233
+ e.preventDefault();
234
+ if (filtered[clampedIndex]) filtered[clampedIndex].action();
235
+ } else if (e.key === 'Escape') {
236
+ e.preventDefault();
237
+ e.stopPropagation();
238
+ onClose();
239
+ }
240
+ },
241
+ [filtered, clampedIndex, onClose],
242
+ );
243
+
244
+ // Scroll selected into view
245
+ useEffect(() => {
246
+ const list = listRef.current;
247
+ if (!list) return;
248
+ const el = list.children[clampedIndex] as HTMLElement | undefined;
249
+ el?.scrollIntoView({ block: 'nearest' });
250
+ }, [clampedIndex]);
251
+
252
+ // Reset selection on query change
253
+ useEffect(() => {
254
+ setSelectedIndex(0);
255
+ }, [query]);
256
+
257
+ return (
258
+ <div class="command-palette-backdrop" onMouseDown={onClose}>
259
+ <div class="command-palette" onMouseDown={(e) => e.stopPropagation()}>
260
+ <input
261
+ ref={inputRef}
262
+ type="text"
263
+ class="command-palette-input"
264
+ value={query}
265
+ onInput={(e) => setQuery((e.target as HTMLInputElement).value)}
266
+ onKeyDown={handleKeyDown}
267
+ placeholder={`Search nodes and actions... (${MOD_KEY}+K)`}
268
+ />
269
+ <div class="command-palette-hint">
270
+ <span><kbd>{'\u2191'}</kbd><kbd>{'\u2193'}</kbd> navigate</span>
271
+ <span><kbd>{'\u21B5'}</kbd> select</span>
272
+ <span><kbd>esc</kbd> close</span>
273
+ <span><kbd>type:</kbd> filter by type</span>
274
+ </div>
275
+ <div class="command-palette-results" ref={listRef}>
276
+ {filtered.length === 0 && (
277
+ <div class="command-palette-empty">No matching nodes or actions</div>
278
+ )}
279
+ {filtered.map((item, i) => (
280
+ <button
281
+ key={item.id}
282
+ type="button"
283
+ class={`command-palette-item${i === clampedIndex ? ' selected' : ''}`}
284
+ onMouseEnter={() => setSelectedIndex(i)}
285
+ onClick={() => item.action()}
286
+ >
287
+ <span class={`command-palette-badge${item.badgeClass ? ` ${item.badgeClass}` : ''}`}>
288
+ {item.badge}
289
+ </span>
290
+ <span class="command-palette-label">
291
+ {item.indices.length > 0 ? highlightMatch(item.label, item.indices) : item.label}
292
+ </span>
293
+ {item.description && (
294
+ <span class="command-palette-desc">{item.description}</span>
295
+ )}
296
+ </button>
297
+ ))}
298
+ </div>
299
+ </div>
300
+ </div>
301
+ );
302
+ }