@kabmo-labs/kabmo 0.18.0 → 0.19.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 (191) hide show
  1. package/README.md +10 -7
  2. package/dist/client/index.html +1 -1
  3. package/dist/client/index.js +475 -474
  4. package/dist/client/static/js/{index-tc09dtca.js → index-fcee4c13.js} +766 -765
  5. package/dist/client/static/js/index-sxdw908m.css +1 -0
  6. package/marketplace/plugins/command-runner/package.json +3 -2
  7. package/marketplace/plugins/git-forge/package.json +3 -2
  8. package/marketplace/plugins/session-info/package.json +3 -2
  9. package/marketplace/plugins/stats/package.json +3 -2
  10. package/package.json +3 -1
  11. package/src/client/components/auth/login-screen/index.tsx +2 -1
  12. package/src/client/components/common/ComposerPicker.tsx +1 -1
  13. package/src/client/components/common/FolderPicker.tsx +2 -2
  14. package/src/client/components/common/Modal.tsx +2 -2
  15. package/src/client/components/common/PWAInstallButton.tsx +2 -2
  16. package/src/client/components/common/ViewportSelector.tsx +1 -1
  17. package/src/client/components/common/anchored-menu/index.tsx +5 -1
  18. package/src/client/components/common/batch-selection/SelectionCheckbox.tsx +2 -1
  19. package/src/client/components/common/brand-wordmark/index.test.tsx +13 -2
  20. package/src/client/components/common/brand-wordmark/index.tsx +13 -2
  21. package/src/client/components/common/checkbox/style.test.ts +139 -0
  22. package/src/client/components/common/checkbox/style.ts +51 -0
  23. package/src/client/components/common/context-usage-button/index.tsx +2 -2
  24. package/src/client/components/common/file-icon/index.tsx +23 -9
  25. package/src/client/components/common/header-controls/MoreMenu.tsx +1 -1
  26. package/src/client/components/common/markdown-review/ReviewPopover.tsx +1 -1
  27. package/src/client/components/common/panel-mark/index.tsx +97 -0
  28. package/src/client/components/common/provider-icon/glyphs.test.ts +1 -1
  29. package/src/client/components/common/provider-icon/index.test.ts +14 -0
  30. package/src/client/components/common/provider-icon/index.tsx +4 -0
  31. package/src/client/components/common/provider-icon/resolve.test.ts +8 -7
  32. package/src/client/components/common/provider-icon/resolve.ts +16 -3
  33. package/src/client/components/common/session-actions-menu/index.tsx +1 -1
  34. package/src/client/components/common/toolbar-row/index.tsx +1 -1
  35. package/src/client/components/layout/ActivityBar.tsx +22 -3
  36. package/src/client/components/layout/LeftDock.tsx +9 -2
  37. package/src/client/components/layout/PanelVisibilityMenu.tsx +1 -1
  38. package/src/client/components/layout/WindowAura.tsx +27 -0
  39. package/src/client/components/layout/desktop-layout/LeftColumn.tsx +1 -1
  40. package/src/client/components/layout/desktop-layout/TopNavbar.tsx +2 -2
  41. package/src/client/components/layout/desktop-layout/WorkspacePanels.tsx +11 -2
  42. package/src/client/components/layout/desktop-layout/index.tsx +3 -1
  43. package/src/client/components/layout/session-sidebar/CategoryHeader.tsx +3 -3
  44. package/src/client/components/layout/session-sidebar/Header.tsx +1 -1
  45. package/src/client/components/layout/session-sidebar/OverflowMenu.tsx +1 -1
  46. package/src/client/components/layout/session-sidebar/Toolbar.tsx +1 -1
  47. package/src/client/components/layout/session-sidebar/about-modal/index.tsx +2 -2
  48. package/src/client/components/layout/session-sidebar/modern/ActionRow.tsx +1 -1
  49. package/src/client/components/layout/session-sidebar/modern/WorkspaceHeader.tsx +13 -5
  50. package/src/client/components/layout/session-sidebar/new-workspace-modal/index.tsx +2 -2
  51. package/src/client/components/layout/session-sidebar/scheduler-modal/TaskForm.tsx +2 -1
  52. package/src/client/components/layout/session-sidebar/scheduler-modal/index.tsx +2 -2
  53. package/src/client/components/mobile/LayoutWrapper.tsx +3 -1
  54. package/src/client/components/mobile/mobile-main-view/Header.tsx +2 -2
  55. package/src/client/components/mobile/mobile-session-sidebar/Header.tsx +1 -1
  56. package/src/client/components/mobile/mobile-session-sidebar/Toolbar.tsx +1 -1
  57. package/src/client/components/mobile/panel-chips.tsx +10 -2
  58. package/src/client/components/settings/Modal.tsx +4 -4
  59. package/src/client/components/settings/ProjectSelectorDropdown.tsx +2 -2
  60. package/src/client/components/settings/apply-side-effects.test.ts +30 -0
  61. package/src/client/components/settings/apply-side-effects.ts +14 -0
  62. package/src/client/components/settings/categories/AppearanceSettings.tsx +6 -0
  63. package/src/client/components/settings/categories/appearance-settings/EditorBlameSection.tsx +2 -1
  64. package/src/client/components/settings/categories/appearance-settings/EditorTypingSection.tsx +2 -1
  65. package/src/client/components/settings/categories/appearance-settings/IconStyleSection.tsx +144 -0
  66. package/src/client/components/settings/categories/appearance-settings/SurfaceStyleSection.test.tsx +120 -0
  67. package/src/client/components/settings/categories/appearance-settings/SurfaceStyleSection.tsx +180 -0
  68. package/src/client/components/settings/categories/mcp-settings/DetailPane.tsx +2 -1
  69. package/src/client/components/settings/categories/mcp-settings/ImportModal.tsx +2 -2
  70. package/src/client/components/settings/categories/omp-settings/OrderedChips.tsx +1 -1
  71. package/src/client/components/settings/categories/panel-plugins/AvailableList.tsx +1 -1
  72. package/src/client/components/settings/categories/panel-plugins/BuiltinList.tsx +21 -3
  73. package/src/client/components/settings/categories/panel-plugins/PluginCard.tsx +1 -1
  74. package/src/client/components/settings/categories/panel-plugins/PluginMark.test.ts +51 -2
  75. package/src/client/components/settings/categories/panel-plugins/PluginMark.tsx +43 -10
  76. package/src/client/components/settings/categories/plugin-settings/DetailPane.tsx +2 -1
  77. package/src/client/components/settings/categories/plugin-settings/SettingsSection.tsx +2 -1
  78. package/src/client/components/settings/categories/project-settings/ModelDropdown.tsx +1 -1
  79. package/src/client/components/settings/categories/project-settings/WorktreeSettings.tsx +2 -1
  80. package/src/client/components/settings/categories/provider-settings/DeleteProviderModal.tsx +2 -2
  81. package/src/client/components/settings/categories/provider-settings/EntryAdvanced.tsx +3 -2
  82. package/src/client/components/settings/categories/provider-settings/LogoutProviderModal.tsx +2 -2
  83. package/src/client/components/settings/categories/skill-catalog/GitImportPanel.tsx +3 -2
  84. package/src/client/components/settings/categories/skill-settings/DetailHeader.tsx +2 -1
  85. package/src/client/components/settings/categories/token-usage-settings/Controls.tsx +1 -1
  86. package/src/client/components/workspace/btw-panel/TopicMenu.tsx +1 -1
  87. package/src/client/components/workspace/chat-timeline/AiMessageFooter.tsx +2 -2
  88. package/src/client/components/workspace/chat-timeline/NewChatModal.tsx +3 -3
  89. package/src/client/components/workspace/chat-timeline/UndoConfirmModal.tsx +2 -2
  90. package/src/client/components/workspace/chat-timeline/chat-input/AccessDropdown.tsx +1 -1
  91. package/src/client/components/workspace/chat-timeline/chat-input/GoalModal.tsx +4 -3
  92. package/src/client/components/workspace/chat-timeline/chat-input/ThinkingLevelDropdown.tsx +1 -1
  93. package/src/client/components/workspace/chat-timeline/chat-input/WaitingDependencyPicker.tsx +1 -1
  94. package/src/client/components/workspace/chat-timeline/plan-review/index.tsx +2 -2
  95. package/src/client/components/workspace/chat-timeline/target-picker/WorkspacePicker.tsx +1 -1
  96. package/src/client/components/workspace/chat-timeline/target-picker/WorktreePicker.tsx +1 -1
  97. package/src/client/components/workspace/chat-timeline/tool-renderers/extension-dialog/index.tsx +2 -6
  98. package/src/client/components/workspace/context-panel/CostBreakdownPopover.tsx +1 -1
  99. package/src/client/components/workspace/diff-panel/index.tsx +2 -2
  100. package/src/client/components/workspace/editor/PluginRail.tsx +1 -1
  101. package/src/client/components/workspace/editor/SaveDeletedFileModal.tsx +2 -2
  102. package/src/client/components/workspace/editor/TabContextMenu.tsx +1 -1
  103. package/src/client/components/workspace/editor/Tabs.tsx +1 -1
  104. package/src/client/components/workspace/file-explorer/ContextMenu.tsx +1 -1
  105. package/src/client/components/workspace/file-explorer/Modals.tsx +10 -10
  106. package/src/client/components/workspace/file-explorer/RootMenu.tsx +1 -1
  107. package/src/client/components/workspace/git-panel/BranchToolbar.test.tsx +130 -0
  108. package/src/client/components/workspace/git-panel/BranchToolbar.tsx +21 -11
  109. package/src/client/components/workspace/git-panel/CommitBox.tsx +2 -1
  110. package/src/client/components/workspace/git-panel/Modals.tsx +2 -2
  111. package/src/client/components/workspace/git-panel/StashSection.tsx +2 -1
  112. package/src/client/components/workspace/git-panel/branch-modal/DeleteDialog.tsx +2 -1
  113. package/src/client/components/workspace/git-panel/branch-modal/RenameDialog.tsx +2 -1
  114. package/src/client/components/workspace/git-panel/commit-modal/index.tsx +2 -2
  115. package/src/client/components/workspace/git-panel/index.tsx +7 -0
  116. package/src/client/components/workspace/model-dropdown/Panel.tsx +1 -1
  117. package/src/client/components/workspace/model-dropdown/SpecsTooltip.tsx +1 -1
  118. package/src/client/components/workspace/plugin-panel/catalog.tsx +7 -0
  119. package/src/client/components/workspace/plugin-panel/resolve.tsx +4 -0
  120. package/src/client/components/workspace/search-panel/Body.tsx +1 -1
  121. package/src/client/components/workspace/usage-panel/ProviderSelect.tsx +1 -1
  122. package/src/client/glass.css +785 -0
  123. package/src/client/glass.test.ts +346 -0
  124. package/src/client/hooks/ui/glass-support.ts +57 -0
  125. package/src/client/hooks/ui/icon-style.ts +59 -0
  126. package/src/client/hooks/ui/stuck-header.test.ts +188 -0
  127. package/src/client/hooks/ui/stuck-header.ts +91 -0
  128. package/src/client/hooks/ui/style-attributes.test.ts +120 -0
  129. package/src/client/hooks/ui/surface-style.ts +56 -0
  130. package/src/client/hooks/workspace/panel-hues.ts +23 -0
  131. package/src/client/main.tsx +10 -0
  132. package/src/client/tailwind.css +264 -11
  133. package/src/server/lib/assets/shell-attributes.server.ts +80 -0
  134. package/src/server/lib/assets/shell-attributes.test.ts +86 -0
  135. package/src/server/lib/omp/rpc/frame-fold-host.test-util.ts +1 -0
  136. package/src/server/lib/omp/rpc/frame-fold-signals.test.ts +2 -30
  137. package/src/server/lib/omp/rpc/frame-fold.test.ts +55 -0
  138. package/src/server/lib/omp/rpc/frame-fold.ts +4 -0
  139. package/src/server/lib/omp/rpc/manager.ts +2 -2
  140. package/src/server/lib/omp/rpc/process-helpers.ts +11 -0
  141. package/src/server/lib/omp/rpc/process.test.ts +106 -0
  142. package/src/server/lib/omp/rpc/process.ts +28 -4
  143. package/src/server/lib/omp/rpc/run-settle.server.ts +12 -0
  144. package/src/server/lib/omp/rpc/run-settle.test.ts +22 -0
  145. package/src/server/lib/omp/rpc/session-command-guards.ts +5 -0
  146. package/src/server/lib/omp/rpc/session-commands.test.ts +9 -1
  147. package/src/server/lib/omp/rpc/session-commands.ts +11 -0
  148. package/src/server/lib/omp/rpc/terminal-settle.ts +29 -7
  149. package/src/server/lib/panels/bundled-catalog.server.ts +1 -0
  150. package/src/server/lib/panels/manifest.test.ts +20 -0
  151. package/src/server/lib/panels/manifest.ts +12 -0
  152. package/src/server/lib/panels/scan.server.ts +4 -0
  153. package/src/server/lib/queue/delivery-dispatch.server.test.ts +48 -0
  154. package/src/server/lib/queue/delivery-harness.ts +8 -4
  155. package/src/server/lib/queue/delivery.server.test.ts +29 -0
  156. package/src/server/lib/queue/delivery.server.ts +39 -0
  157. package/src/server/lib/queue/store.server.test.ts +22 -2
  158. package/src/server/lib/queue/store.server.ts +33 -11
  159. package/src/server/plugins/ssr.ts +22 -5
  160. package/src/shared/lib/icons/file-brand-color.ts +38 -0
  161. package/src/shared/lib/icons/icon-paint-css.test.ts +234 -0
  162. package/src/shared/lib/icons/icon-paint-css.ts +284 -0
  163. package/src/shared/lib/icons/icon-paint-panel.ts +100 -0
  164. package/src/shared/lib/icons/tint-hues.generated.ts +230 -0
  165. package/src/shared/lib/icons/tint.test.ts +273 -0
  166. package/src/shared/lib/icons/tint.ts +219 -0
  167. package/src/shared/lib/models/provider/brand-color.test.ts +116 -0
  168. package/src/shared/lib/models/provider/brand-color.ts +103 -0
  169. package/src/shared/lib/omp/rpc/frame.test.ts +65 -0
  170. package/src/shared/lib/omp/rpc/frame.ts +58 -3
  171. package/src/shared/lib/settings/defaults.ts +4 -0
  172. package/src/shared/lib/theme/catalog.test.ts +5 -4
  173. package/src/shared/lib/theme/catalog.ts +18 -3
  174. package/src/shared/lib/theme/glass-support.test.ts +38 -0
  175. package/src/shared/lib/theme/glass-support.ts +73 -0
  176. package/src/shared/lib/theme/icon-style.test.ts +74 -0
  177. package/src/shared/lib/theme/icon-style.ts +90 -0
  178. package/src/shared/lib/theme/legibility.ts +91 -0
  179. package/src/shared/lib/theme/palettes/dark-extended.ts +152 -0
  180. package/src/shared/lib/theme/palettes/light-extended.ts +157 -0
  181. package/src/shared/lib/theme/surface-style.test.ts +68 -0
  182. package/src/shared/lib/theme/surface-style.ts +91 -0
  183. package/src/shared/lib/theme/theme.test.ts +11 -7
  184. package/src/shared/lib/workspace/panel-hues.test.ts +68 -0
  185. package/src/shared/lib/workspace/panel-hues.ts +57 -0
  186. package/src/shared/types/panels-registry.ts +6 -0
  187. package/src/shared/types/panels.ts +14 -0
  188. package/src/shared/types/settings/state.ts +26 -0
  189. package/src/test-support/fake-omp-frames.ts +163 -0
  190. package/dist/client/static/js/index-hp75vsv9.css +0 -1
  191. /package/src/{client/components/common/file-icon/brand-paths.ts → shared/lib/icons/file-brand-paths.ts} +0 -0
@@ -0,0 +1,230 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * GENERATED by `scripts/icon-tints.mjs` — do not hand-edit.
8
+ *
9
+ * One hue per functional glyph, 36 hues 10° apart, assigned by a stable hash of
10
+ * the icon name. The signal icons in `tint.ts` are deliberately absent: they
11
+ * paint a palette token, because a trash can has to be the theme's error colour
12
+ * and not whatever the hash said.
13
+ *
14
+ * Regenerate with `bun run icons:tints` after adding an icon. The suite fails
15
+ * when this table and the imports disagree (`icons:tints:check`), so a stale
16
+ * table cannot ship.
17
+ */
18
+
19
+ export const ICON_HUES: Readonly<Record<string, number>> = {
20
+ Activity: 240,
21
+ AlignJustify: 100,
22
+ AlignLeft: 150,
23
+ Archive: 50,
24
+ ArchiveRestore: 90,
25
+ ArrowDown: 100,
26
+ ArrowDownToLine: 330,
27
+ ArrowLeft: 350,
28
+ ArrowRight: 80,
29
+ ArrowUp: 150,
30
+ ArrowUpDown: 310,
31
+ BarChart3: 150,
32
+ Blocks: 110,
33
+ Bot: 220,
34
+ Box: 260,
35
+ Boxes: 220,
36
+ Brain: 350,
37
+ BrainCircuit: 300,
38
+ Briefcase: 310,
39
+ Camera: 60,
40
+ CaseSensitive: 110,
41
+ ChevronDown: 120,
42
+ ChevronLeft: 250,
43
+ ChevronRight: 300,
44
+ ChevronUp: 250,
45
+ ChevronsUpDown: 80,
46
+ Circle: 50,
47
+ CircleDot: 240,
48
+ ClipboardCopy: 280,
49
+ ClipboardList: 290,
50
+ ClipboardPaste: 200,
51
+ Cloud: 340,
52
+ CloudDownload: 300,
53
+ Code: 200,
54
+ Code2: 260,
55
+ Coins: 210,
56
+ Columns: 280,
57
+ Columns2: 20,
58
+ Command: 100,
59
+ Component: 200,
60
+ Copy: 320,
61
+ CopyPlus: 40,
62
+ CornerDownLeft: 10,
63
+ Cpu: 250,
64
+ Database: 280,
65
+ Dice5: 50,
66
+ Diff: 300,
67
+ DollarSign: 220,
68
+ Download: 210,
69
+ DownloadCloud: 180,
70
+ Edit2: 210,
71
+ Ellipsis: 100,
72
+ ExternalLink: 60,
73
+ Eye: 20,
74
+ EyeOff: 350,
75
+ File: 310,
76
+ FileCode: 260,
77
+ FileCog: 340,
78
+ FileEdit: 270,
79
+ FileImage: 40,
80
+ FilePlus: 350,
81
+ FilePlus2: 350,
82
+ FileSearch: 310,
83
+ FileText: 80,
84
+ Files: 320,
85
+ Flag: 350,
86
+ FlaskConical: 170,
87
+ Folder: 290,
88
+ FolderGit: 190,
89
+ FolderGit2: 190,
90
+ FolderInput: 310,
91
+ FolderOpen: 330,
92
+ FolderPlus: 250,
93
+ FolderSearch: 10,
94
+ FolderTree: 10,
95
+ Gamepad2: 300,
96
+ GitBranch: 30,
97
+ GitCommitVertical: 240,
98
+ GitCompare: 340,
99
+ GitFork: 30,
100
+ GitMerge: 90,
101
+ GitPullRequest: 10,
102
+ Globe: 340,
103
+ GraduationCap: 190,
104
+ GripVertical: 350,
105
+ Hammer: 310,
106
+ Hand: 200,
107
+ HardDrive: 0,
108
+ Hash: 330,
109
+ Heading: 250,
110
+ Heart: 270,
111
+ History: 110,
112
+ Home: 20,
113
+ Image: 140,
114
+ Key: 240,
115
+ KeyRound: 240,
116
+ Keyboard: 120,
117
+ Laptop: 170,
118
+ Layers: 30,
119
+ LayoutTemplate: 170,
120
+ Leaf: 50,
121
+ Library: 160,
122
+ Lightbulb: 0,
123
+ List: 170,
124
+ ListChecks: 320,
125
+ ListFilter: 230,
126
+ ListOrdered: 220,
127
+ ListTodo: 210,
128
+ ListTree: 330,
129
+ Loader2: 40,
130
+ Lock: 220,
131
+ LockKeyhole: 270,
132
+ LockOpen: 180,
133
+ LogIn: 140,
134
+ LogOut: 190,
135
+ Maximize: 310,
136
+ Maximize2: 270,
137
+ Menu: 100,
138
+ MessageSquare: 150,
139
+ MessageSquareOff: 40,
140
+ MessageSquarePlus: 350,
141
+ MessagesSquare: 220,
142
+ Mic: 160,
143
+ MicOff: 170,
144
+ Minimize: 290,
145
+ Minimize2: 130,
146
+ Minus: 110,
147
+ Monitor: 250,
148
+ Moon: 80,
149
+ MoreHorizontal: 160,
150
+ MousePointerClick: 70,
151
+ MoveVertical: 300,
152
+ Music: 280,
153
+ Package: 270,
154
+ Paintbrush: 250,
155
+ Palette: 320,
156
+ PanelLeft: 280,
157
+ PanelLeftClose: 160,
158
+ PanelRight: 330,
159
+ PanelRightClose: 350,
160
+ Paperclip: 310,
161
+ Pause: 10,
162
+ Pencil: 0,
163
+ PencilLine: 260,
164
+ Pin: 0,
165
+ PinOff: 50,
166
+ Pipette: 120,
167
+ Play: 310,
168
+ Plug: 50,
169
+ Plus: 210,
170
+ Power: 340,
171
+ Puzzle: 50,
172
+ Quote: 110,
173
+ Radio: 320,
174
+ Ratio: 160,
175
+ RefreshCw: 180,
176
+ Regex: 280,
177
+ Replace: 190,
178
+ ReplaceAll: 140,
179
+ Rocket: 210,
180
+ RotateCcw: 330,
181
+ RotateCw: 0,
182
+ Rows: 160,
183
+ Rows3: 250,
184
+ Save: 40,
185
+ SaveAll: 190,
186
+ Scissors: 260,
187
+ Search: 250,
188
+ Send: 110,
189
+ Server: 300,
190
+ ServerCog: 50,
191
+ Settings: 240,
192
+ Settings2: 20,
193
+ Shield: 160,
194
+ Shrink: 160,
195
+ Sliders: 290,
196
+ SlidersHorizontal: 50,
197
+ Smartphone: 20,
198
+ Space: 290,
199
+ Sparkles: 180,
200
+ Square: 60,
201
+ SquareFunction: 220,
202
+ SquarePen: 10,
203
+ Star: 170,
204
+ StickyNote: 100,
205
+ Store: 340,
206
+ Sun: 90,
207
+ Tablet: 290,
208
+ Tag: 310,
209
+ Target: 200,
210
+ Terminal: 210,
211
+ TextSelect: 220,
212
+ Ticket: 170,
213
+ Type: 170,
214
+ Undo2: 310,
215
+ Upload: 0,
216
+ UploadCloud: 50,
217
+ User: 140,
218
+ Variable: 330,
219
+ Volume2: 270,
220
+ VolumeX: 50,
221
+ Wand2: 270,
222
+ WandSparkles: 40,
223
+ WholeWord: 240,
224
+ WrapText: 340,
225
+ Wrench: 0,
226
+ X: 230,
227
+ Zap: 120,
228
+ ZoomIn: 250,
229
+ ZoomOut: 340,
230
+ };
@@ -0,0 +1,273 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The functional-glyph colour table.
8
+ *
9
+ * Four facts are worth pinning, and each is invisible until wrong:
10
+ *
11
+ * - **The class conversion matches what Lucide emits.** `Trash2` is an alias of
12
+ * `trash` (class `lucide-trash-2`), `AlertTriangle` of `triangle-alert`, so a
13
+ * table keyed on the IMPORT name is only useful if the kebab translation lands
14
+ * on a class the component really carries. Every row is RENDERED here rather
15
+ * than trusted.
16
+ * - **The hue table matches the imports.** It is generated from `src/`; a stale
17
+ * copy would leave a newly added icon on the default hue, which looks like the
18
+ * mode half-applied. `scripts/icon-tints.mjs --check` is the same comparison.
19
+ * - **Every generated hue clears the non-text contrast floor** on every palette
20
+ * of its variant, at the lightness `ICON_HUE_PAINT` states. That is the whole
21
+ * reason the lightness is 30% / 70% and not something prettier.
22
+ * - **A signal icon is never also a hue row**, so the signal colour cannot be
23
+ * shadowed by a `--icon-hue` on the same element.
24
+ */
25
+
26
+ import { afterAll, afterEach, beforeEach, describe, expect, test } from 'bun:test';
27
+ import { Window } from 'happy-dom';
28
+ import { h, render } from 'preact';
29
+ import * as lucide from 'lucide-preact';
30
+ import {
31
+ assignPanelHues,
32
+ DEFAULT_ICON_HUE,
33
+ ICON_HUE_PAINT,
34
+ ICON_HUE_ROWS,
35
+ ICON_TINTS,
36
+ ICON_TINT_ROWS,
37
+ ICON_TINT_TOKENS,
38
+ iconHue,
39
+ hashHue,
40
+ iconHueColor,
41
+ iconHuePaint,
42
+ iconTintRole,
43
+ kebabIconName,
44
+ lucideClassName,
45
+ } from '@/shared/lib/icons/tint';
46
+ import { ICON_HUES } from '@/shared/lib/icons/tint-hues.generated';
47
+ import { THEMES } from '@/shared/lib/theme/catalog';
48
+ import { BRAND_CONTRAST_FLOOR, contrastRatio } from '@/shared/lib/theme/legibility';
49
+
50
+ const DOM_GLOBALS = ['window', 'document', 'navigator', 'Node', 'Element', 'HTMLElement', 'Event'] as const;
51
+ const nativeGlobals: Partial<Record<(typeof DOM_GLOBALS)[number], unknown>> = {};
52
+ let container: HTMLElement;
53
+
54
+ beforeEach(() => {
55
+ const win = new Window({ url: 'http://localhost' });
56
+ const target = globalThis as unknown as Record<string, unknown>;
57
+ for (const key of DOM_GLOBALS) {
58
+ if (!(key in nativeGlobals)) nativeGlobals[key] = win[key as keyof Window];
59
+ target[key] = win[key as keyof Window];
60
+ }
61
+ container = document.createElement('div');
62
+ document.body.appendChild(container);
63
+ });
64
+
65
+ afterEach(() => {
66
+ render(null, container);
67
+ container.remove();
68
+ });
69
+
70
+ afterAll(() => {
71
+ const target = globalThis as unknown as Record<string, unknown>;
72
+ for (const key of DOM_GLOBALS) {
73
+ if (key in nativeGlobals) target[key] = nativeGlobals[key];
74
+ else delete target[key];
75
+ }
76
+ });
77
+
78
+ /** `hsl(<hue> <sat>% <light>%)` as a hex, so contrast can be measured. */
79
+ function hslHex(hue: number, saturation: number, lightness: number): string {
80
+ const s = saturation / 100;
81
+ const l = lightness / 100;
82
+ const k = (n: number) => (n + hue / 30) % 12;
83
+ const a = s * Math.min(l, 1 - l);
84
+ const channel = (n: number) => l - a * Math.max(-1, Math.min(k(n) - 3, Math.min(9 - k(n), 1)));
85
+ const toHex = (value: number) =>
86
+ Math.round(Math.min(1, Math.max(0, value)) * 255)
87
+ .toString(16)
88
+ .padStart(2, '0');
89
+ return `#${toHex(channel(0))}${toHex(channel(8))}${toHex(channel(4))}`;
90
+ }
91
+
92
+
93
+
94
+ describe('kebabIconName', () => {
95
+ test('lowercase, camel and digit boundaries', () => {
96
+ expect(kebabIconName('Trash2')).toBe('trash-2');
97
+ expect(kebabIconName('AlertTriangle')).toBe('alert-triangle');
98
+ expect(kebabIconName('ChevronsUpDown')).toBe('chevrons-up-down');
99
+ expect(kebabIconName('BarChart3')).toBe('bar-chart-3');
100
+ expect(kebabIconName('CircleQuestionMark')).toBe('circle-question-mark');
101
+ expect(kebabIconName('ZoomIn')).toBe('zoom-in');
102
+ expect(kebabIconName('Cpu')).toBe('cpu');
103
+ expect(kebabIconName('X')).toBe('x');
104
+ expect(kebabIconName('Settings2')).toBe('settings-2');
105
+ });
106
+
107
+ test('the class is the kebab name behind the component prefix', () => {
108
+ expect(lucideClassName('Trash2')).toBe('lucide-trash-2');
109
+ });
110
+ });
111
+
112
+ describe('the signal table', () => {
113
+ test('every row names an icon this build can import', () => {
114
+ for (const name of Object.keys(ICON_TINTS)) {
115
+ expect((lucide as Record<string, unknown>)[name], `${name} is not a lucide export`).toBeDefined();
116
+ }
117
+ });
118
+
119
+ test('every row renders the class the stylesheet keys on', () => {
120
+ for (const name of Object.keys(ICON_TINTS)) {
121
+ const Icon = (lucide as unknown as Record<string, (props: object) => unknown>)[name] as (props: object) => unknown;
122
+ render(h(Icon as never, { 'aria-hidden': true }), container);
123
+ const svg = container.querySelector('svg');
124
+ expect(svg, `${name} draws an svg`).not.toBeNull();
125
+ expect(svg?.classList.contains(lucideClassName(name)), `${name} -> ${lucideClassName(name)}`).toBe(true);
126
+ render(null, container);
127
+ }
128
+ });
129
+
130
+ test('an unlisted icon has no role, so it takes its own hue', () => {
131
+ expect(iconTintRole('Sparkles')).toBeNull();
132
+ });
133
+
134
+ test('a signal role answers its own token', () => {
135
+ expect(iconTintRole('Trash2')).toBe('error');
136
+ expect(iconTintRole('CheckCircle2')).toBe('success');
137
+ expect(iconTintRole('Hourglass')).toBe('warning');
138
+ expect(iconTintRole('Info')).toBe('info');
139
+ });
140
+
141
+ test('every role paints a theme token, never a hex', () => {
142
+ for (const role of new Set(Object.values(ICON_TINTS))) {
143
+ expect(ICON_TINT_TOKENS[role], role).toMatch(/^var\(--theme-[a-z]+\)$/);
144
+ }
145
+ });
146
+
147
+ test('the signal rows are unique, so no rule can be shadowed', () => {
148
+ const classes = ICON_TINT_ROWS.map((row) => row.className);
149
+ expect(new Set(classes).size).toBe(classes.length);
150
+ });
151
+ });
152
+
153
+ describe('the generated hues', () => {
154
+ test('the table has one entry per imported, non-signal icon', () => {
155
+ expect(Object.keys(ICON_HUES).length).toBeGreaterThan(100);
156
+ for (const name of Object.keys(ICON_TINTS)) {
157
+ expect(ICON_HUES[name], `${name} is a signal and must not carry a hue`).toBeUndefined();
158
+ }
159
+ });
160
+
161
+ test('every hue is a step on the 36-hue wheel', () => {
162
+ for (const [name, hue] of Object.entries(ICON_HUES)) {
163
+ expect(hue % 10, name).toBe(0);
164
+ expect(hue, name).toBeGreaterThanOrEqual(0);
165
+ expect(hue, name).toBeLessThan(360);
166
+ }
167
+ });
168
+
169
+ test('neighbouring icons are not all the same colour', () => {
170
+ const hues = new Set(Object.values(ICON_HUES));
171
+ // The whole point of a per-icon hue: a dense list must not be one colour.
172
+ expect(hues.size).toBeGreaterThan(20);
173
+ });
174
+
175
+ test('the hue table matches the icons this repo imports', async () => {
176
+ // The generator is the source of truth; running its `--check` here is what
177
+ // makes a stale table a test failure instead of a review miss.
178
+ //
179
+ // `Bun.fileURLToPath`, not `URL.pathname`: on a Windows host the pathname
180
+ // is `/D:/a/kabmo/kabmo/`, which no process can open, so the spawn failed
181
+ // for a reason that had nothing to do with the table — measured on the
182
+ // Windows gate, where this case failed while every other row passed.
183
+ //
184
+ // The script is resolved THROUGH the URL rather than by string-joining onto
185
+ // the directory: `fileURLToPath` keeps a trailing separator (`…/kabmo/`),
186
+ // and a hand-written join would then carry one separator style into a path
187
+ // the other half spelled the other way.
188
+ const repoUrl = new URL('../../../..', import.meta.url);
189
+ const repoRoot = Bun.fileURLToPath(repoUrl);
190
+ const script = Bun.fileURLToPath(new URL('scripts/icon-tints.mjs', repoUrl));
191
+ const check = Bun.spawnSync(['bun', 'run', script, '--check'], {
192
+ cwd: repoRoot,
193
+ stdout: 'pipe',
194
+ stderr: 'pipe',
195
+ });
196
+ expect(check.exitCode, check.stderr.toString()).toBe(0);
197
+ });
198
+
199
+ test('every hue clears the non-text floor on every palette of its variant', () => {
200
+ for (const variant of ['light', 'dark'] as const) {
201
+ const { saturation, lightness } = ICON_HUE_PAINT[variant];
202
+ const papers = THEMES.filter((theme) => theme.variant === variant).map((theme) => theme.paper);
203
+ for (const hue of new Set(Object.values(ICON_HUES))) {
204
+ const color = hslHex(hue, saturation, lightness);
205
+ const worst = Math.min(...papers.map((paper) => contrastRatio(color, paper)));
206
+ expect(worst, `hue ${hue} ${variant} (${color})`).toBeGreaterThanOrEqual(BRAND_CONTRAST_FLOOR);
207
+ }
208
+ }
209
+ });
210
+
211
+ test('the paint rule and the concrete colour share one formula', () => {
212
+ // The stylesheet leaves the hue to `--icon-hue`; the settings preview needs a
213
+ // real colour. Both must come from the same numbers, or the preview lies.
214
+ for (const variant of ['light', 'dark'] as const) {
215
+ const { saturation, lightness } = ICON_HUE_PAINT[variant];
216
+ expect(iconHuePaint(variant)).toBe(`hsl(var(--icon-hue, ${DEFAULT_ICON_HUE}) ${saturation}% ${lightness}%)`);
217
+ expect(iconHueColor(120, variant)).toBe(`hsl(120 ${saturation}% ${lightness}%)`);
218
+ }
219
+ });
220
+
221
+ test('the table is exactly what the runtime hash produces', () => {
222
+ // One formula for both: a plugin's mark is coloured by `hashHue` at runtime,
223
+ // so if the generated rows drifted from it, an installed plugin would sit on
224
+ // a different wheel than the glyphs beside it.
225
+ for (const [name, hue] of Object.entries(ICON_HUES)) {
226
+ expect(hashHue(name), name).toBe(hue);
227
+ }
228
+ });
229
+
230
+ test('a plugin name gets a stable hue on the same wheel', () => {
231
+ expect(hashHue('Demo Plugin')).toBe(hashHue('Demo Plugin'));
232
+ expect(hashHue('Demo Plugin')).not.toBe(hashHue('Other Plugin'));
233
+ for (const name of ['Demo', 'Session Info', 'git-forge', 'Stats — CPU & RAM']) {
234
+ expect(hashHue(name) % 10, name).toBe(0);
235
+ expect(hashHue(name), name).toBeLessThan(360);
236
+ }
237
+ });
238
+
239
+ test('the rail gives every panel its OWN hue, even when two hashes collide', () => {
240
+ // Fourteen buttons on a 36-slot wheel collide about nine times in ten
241
+ // (birthday bound) — measured, three right-rail icons shared one blue.
242
+ const ids = [
243
+ 'context', 'files', 'search', 'git', 'wiki', 'terminal', 'user-browser',
244
+ 'browser', 'usage', 'todo', 'plan', 'plugin:command-runner',
245
+ 'plugin:git-forge', 'plugin:stats',
246
+ ];
247
+ const hues = assignPanelHues(ids);
248
+
249
+ expect(hues.size).toBe(ids.length);
250
+ expect(new Set(hues.values()).size).toBe(ids.length);
251
+ });
252
+
253
+ test('the assignment does not depend on the catalog order', () => {
254
+ // Reordering a rail must not recolour it: the ids are sorted before probing.
255
+ const ids = ['b', 'a', 'c', 'plugin:x'];
256
+ expect([...assignPanelHues(ids)]).toEqual([...assignPanelHues([...ids].reverse())]);
257
+ });
258
+
259
+ test('an unassigned panel falls back to the plain hash', () => {
260
+ expect(assignPanelHues(['only']).get('only')).toBe(hashHue('only'));
261
+ });
262
+
263
+ test('an icon outside the table keeps a neutral default', () => {
264
+ expect(iconHue('NotAnIcon')).toBe(DEFAULT_ICON_HUE);
265
+ expect(iconHue('Trash2')).toBe(DEFAULT_ICON_HUE);
266
+ });
267
+
268
+ test('the rows name classes, one per hue', () => {
269
+ const classes = ICON_HUE_ROWS.map((row) => row.className);
270
+ expect(new Set(classes).size).toBe(classes.length);
271
+ expect(classes.every((className) => className.startsWith('lucide-'))).toBe(true);
272
+ });
273
+ });