@kabmo-labs/kabmo 0.17.0 → 0.18.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 (269) hide show
  1. package/dist/client/index.html +1 -1
  2. package/dist/client/index.js +538 -457
  3. package/dist/client/static/js/index-hp75vsv9.css +1 -0
  4. package/dist/client/static/js/{index-rerjq5th.js → index-tc09dtca.js} +823 -814
  5. package/package.json +1 -1
  6. package/src/client/components/common/MarkdownRenderer.tsx +136 -89
  7. package/src/client/components/common/anchored-menu/index.test.tsx +141 -0
  8. package/src/client/components/common/anchored-menu/index.tsx +143 -0
  9. package/src/client/components/common/markdown-review/ReviewPopover.tsx +144 -0
  10. package/src/client/components/common/markdown-review/ReviewSummary.tsx +108 -0
  11. package/src/client/components/common/markdown-review/index.tsx +129 -0
  12. package/src/client/components/common/server-control/Panel.tsx +33 -23
  13. package/src/client/components/common/server-control/index.test.tsx +11 -5
  14. package/src/client/components/common/server-control/index.tsx +10 -8
  15. package/src/client/components/layout/session-sidebar/CategoryHeader.tsx +42 -21
  16. package/src/client/components/layout/session-sidebar/CategoryHeader.worktree.test.tsx +36 -17
  17. package/src/client/components/layout/session-sidebar/CategoryItem.tsx +8 -7
  18. package/src/client/components/layout/session-sidebar/about-modal/NotesDialog.tsx +94 -0
  19. package/src/client/components/layout/session-sidebar/about-modal/VersionLine.test.tsx +68 -0
  20. package/src/client/components/layout/session-sidebar/about-modal/VersionLine.tsx +36 -0
  21. package/src/client/components/layout/session-sidebar/about-modal/index.tsx +57 -34
  22. package/src/client/components/layout/session-sidebar/modern/WorkspaceHeader.tsx +28 -10
  23. package/src/client/components/layout/session-sidebar/modern/WorkspaceSection.tsx +7 -6
  24. package/src/client/components/layout/session-sidebar/modern/workspace-header.test.tsx +1 -1
  25. package/src/client/components/layout/update-popup/ReleaseNotes.tsx +8 -3
  26. package/src/client/components/layout/update-popup/index.tsx +5 -1
  27. package/src/client/components/mobile/mobile-right-sidebar/FullEditor.tsx +13 -15
  28. package/src/client/components/mobile/mobile-right-sidebar/Header.tsx +23 -1
  29. package/src/client/components/mobile/mobile-right-sidebar/MissingFileBanner.tsx +30 -0
  30. package/src/client/components/mobile/mobile-right-sidebar/PreviewScroller.tsx +18 -2
  31. package/src/client/components/mobile/mobile-session-sidebar/Item.tsx +22 -67
  32. package/src/client/components/mobile/mobile-session-sidebar/ItemMenu.tsx +110 -0
  33. package/src/client/components/settings/SettingsSidebarList.tsx +20 -0
  34. package/src/client/components/settings/categories/AgentSettings.tsx +23 -50
  35. package/src/client/components/settings/categories/CommandSettings.tsx +2 -2
  36. package/src/client/components/settings/categories/McpSettings.tsx +4 -21
  37. package/src/client/components/settings/categories/OmpSettings.tsx +147 -194
  38. package/src/client/components/settings/categories/SkillSettings.tsx +2 -2
  39. package/src/client/components/settings/categories/TokenUsageSettings.tsx +211 -229
  40. package/src/client/components/settings/categories/agent-settings/DetailPane.tsx +229 -237
  41. package/src/client/components/settings/categories/agent-settings/ModelPicker.tsx +71 -0
  42. package/src/client/components/settings/categories/agent-settings/SidebarList.tsx +9 -2
  43. package/src/client/components/settings/categories/agent-settings/levels.ts +38 -0
  44. package/src/client/components/settings/categories/behavior-settings/Editor.tsx +27 -7
  45. package/src/client/components/settings/categories/chat-settings/ToolRenderSection.tsx +23 -5
  46. package/src/client/components/settings/categories/command-settings/DetailPane.tsx +75 -33
  47. package/src/client/components/settings/categories/command-settings/SidebarList.tsx +7 -0
  48. package/src/client/components/settings/categories/mcp-settings/DetailPane.tsx +91 -76
  49. package/src/client/components/settings/categories/mcp-settings/EnvVarsSection.tsx +83 -0
  50. package/src/client/components/settings/categories/mcp-settings/ImportModal.tsx +26 -13
  51. package/src/client/components/settings/categories/mcp-settings/SidebarList.tsx +20 -0
  52. package/src/client/components/settings/categories/omp-settings/ConfigTabs.tsx +97 -36
  53. package/src/client/components/settings/categories/omp-settings/EngineHeader.tsx +151 -0
  54. package/src/client/components/settings/categories/omp-settings/ExtensionsPanel.tsx +68 -32
  55. package/src/client/components/settings/categories/omp-settings/OrderedChips.tsx +119 -0
  56. package/src/client/components/settings/categories/omp-settings/PresetBar.tsx +14 -7
  57. package/src/client/components/settings/categories/omp-settings/RoleEditor.tsx +15 -6
  58. package/src/client/components/settings/categories/omp-settings/RowEditor.tsx +165 -226
  59. package/src/client/components/settings/categories/omp-settings/types.ts +28 -0
  60. package/src/client/components/settings/categories/skill-settings/DetailHeader.tsx +35 -7
  61. package/src/client/components/settings/categories/skill-settings/DetailPane.tsx +34 -14
  62. package/src/client/components/settings/categories/skill-settings/SidebarList.tsx +21 -0
  63. package/src/client/components/settings/categories/skill-settings/pane.test.tsx +15 -6
  64. package/src/client/components/settings/categories/token-usage-settings/Breakdown.tsx +242 -102
  65. package/src/client/components/settings/categories/token-usage-settings/Chart.tsx +130 -56
  66. package/src/client/components/settings/categories/token-usage-settings/Controls.tsx +135 -0
  67. package/src/client/components/settings/categories/token-usage-settings/MetricsGrid.tsx +55 -33
  68. package/src/client/components/settings/categories/token-usage-settings/Provenance.tsx +59 -0
  69. package/src/client/components/settings/categories/token-usage-settings/panel.test.tsx +239 -0
  70. package/src/client/components/workspace/browser-panel/Screencast.test.ts +1 -0
  71. package/src/client/components/workspace/browser-panel/Screencast.tsx +17 -22
  72. package/src/client/components/workspace/browser-panel/TabStrip.test.tsx +158 -0
  73. package/src/client/components/workspace/browser-panel/TabStrip.tsx +90 -0
  74. package/src/client/components/workspace/browser-panel/index.tsx +50 -4
  75. package/src/client/components/workspace/browser-toolbar/index.tsx +41 -1
  76. package/src/client/components/workspace/chat-timeline/ThinkingSection.tsx +3 -1
  77. package/src/client/components/workspace/chat-timeline/ToolCallingSection.tsx +2 -0
  78. package/src/client/components/workspace/chat-timeline/block-chrome.test.tsx +13 -2
  79. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Bash.test.ts +88 -0
  80. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Bash.tsx +24 -1
  81. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Read.test.ts +34 -0
  82. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Read.tsx +5 -1
  83. package/src/client/components/workspace/chat-timeline/tool-renderers/shared/ArtifactChip.tsx +7 -6
  84. package/src/client/components/workspace/chat-timeline/tool-renderers/styles/Tui.test.tsx +237 -0
  85. package/src/client/components/workspace/chat-timeline/tool-renderers/styles/Tui.tsx +191 -0
  86. package/src/client/components/workspace/chat-timeline/tool-renderers/styles/styles.test.tsx +1 -1
  87. package/src/client/components/workspace/diff-panel/MergeDiffView.tsx +21 -7
  88. package/src/client/components/workspace/diff-panel/changes.test.ts +51 -0
  89. package/src/client/components/workspace/diff-panel/changes.ts +28 -12
  90. package/src/client/components/workspace/diff-panel/merge.test.ts +28 -0
  91. package/src/client/components/workspace/diff-panel/merge.ts +21 -1
  92. package/src/client/components/workspace/editor/Body.tsx +7 -0
  93. package/src/client/components/workspace/editor/FileDocument.tsx +15 -21
  94. package/src/client/components/workspace/editor/FilePane.tsx +12 -0
  95. package/src/client/components/workspace/editor/PreviewPane.tsx +70 -0
  96. package/src/client/components/workspace/editor/Toolbar.tsx +17 -1
  97. package/src/client/components/workspace/editor/index.tsx +25 -22
  98. package/src/client/components/workspace/editor/toolbar-clusters.test.ts +14 -0
  99. package/src/client/components/workspace/editor/toolbar-clusters.tsx +12 -86
  100. package/src/client/components/workspace/editor/toolbar-toggle.tsx +53 -0
  101. package/src/client/components/workspace/editor/toolbar-write-clusters.tsx +112 -0
  102. package/src/client/components/workspace/git-panel/commit-modal.test.ts +5 -3
  103. package/src/client/components/workspace/user-browser-panel/AddressBar.tsx +5 -0
  104. package/src/client/components/workspace/user-browser-panel/AnnotateBar.test.tsx +201 -0
  105. package/src/client/components/workspace/user-browser-panel/AnnotateBar.tsx +112 -0
  106. package/src/client/components/workspace/user-browser-panel/AnnotateLayer.test.tsx +225 -0
  107. package/src/client/components/workspace/user-browser-panel/AnnotateLayer.tsx +217 -0
  108. package/src/client/components/workspace/user-browser-panel/AnnotateTarget.tsx +99 -0
  109. package/src/client/components/workspace/user-browser-panel/Frame.tsx +30 -1
  110. package/src/client/components/workspace/user-browser-panel/index.tsx +81 -2
  111. package/src/client/data/agent-data/builtin.ts +0 -10
  112. package/src/client/data/agent-data/orchestrator.ts +0 -45
  113. package/src/client/data/agent-data/specialist.ts +0 -100
  114. package/src/client/data/mock/token-usage.ts +170 -120
  115. package/src/client/data/settings/omp-schema.json +33 -1
  116. package/src/client/hooks/browser/use-annotate.test.ts +143 -0
  117. package/src/client/hooks/browser/use-annotate.ts +98 -0
  118. package/src/client/hooks/browser/use-close-tab.test.ts +148 -0
  119. package/src/client/hooks/browser/use-close-tab.ts +67 -0
  120. package/src/client/hooks/browser/use-screencast.ts +13 -1
  121. package/src/client/hooks/chat/composer/browser-context.test.ts +117 -0
  122. package/src/client/hooks/chat/composer/browser-context.ts +40 -16
  123. package/src/client/hooks/chat/composer/items.test.ts +1 -1
  124. package/src/client/hooks/chat/composer/review-context.ts +38 -0
  125. package/src/client/hooks/chat/composer/use-draft.test.ts +132 -0
  126. package/src/client/hooks/chat/composer/use-draft.ts +31 -2
  127. package/src/client/hooks/chat/timeline/row-window.test.ts +15 -2
  128. package/src/client/hooks/editor/use-document-annotations.ts +124 -0
  129. package/src/client/hooks/editor/use-editor-panel-ui.ts +52 -0
  130. package/src/client/hooks/editor/use-file-review-mode.ts +35 -0
  131. package/src/client/hooks/editor/use-preview-review.ts +148 -0
  132. package/src/client/hooks/settings/agents.ts +149 -0
  133. package/src/client/hooks/settings/crud-list.test.ts +28 -6
  134. package/src/client/hooks/settings/crud-list.ts +96 -57
  135. package/src/client/hooks/settings/omp-config.ts +164 -0
  136. package/src/client/hooks/settings/useTokenUsage.ts +125 -0
  137. package/src/client/hooks/settings/write-feedback.test.ts +104 -0
  138. package/src/client/hooks/settings/write-feedback.ts +63 -0
  139. package/src/client/hooks/ui/markdown-hydration.ts +125 -0
  140. package/src/client/hooks/ui/updates/index.test.ts +100 -1
  141. package/src/client/hooks/ui/updates/index.ts +50 -0
  142. package/src/client/hooks/ui/updates/notes.test.ts +138 -0
  143. package/src/client/hooks/ui/updates/notes.ts +57 -0
  144. package/src/client/lib/browser/element-at.test.ts +229 -0
  145. package/src/client/lib/browser/element-at.ts +139 -0
  146. package/src/client/lib/review/client.ts +73 -0
  147. package/src/client/lib/router/search-params.ts +42 -20
  148. package/src/client/tailwind.css +65 -0
  149. package/src/server/lib/btw/lifecycle.server.ts +2 -2
  150. package/src/server/lib/db/schema.ts +7 -0
  151. package/src/server/lib/db/seed-terminal.test.ts +4 -0
  152. package/src/server/lib/omp/config/agent-definitions.test.ts +273 -0
  153. package/src/server/lib/omp/config/agents.ts +231 -61
  154. package/src/server/lib/omp/config/definitions.test.ts +9 -105
  155. package/src/server/lib/omp/config/extensions.ts +16 -7
  156. package/src/server/lib/omp/config/omp-config-files.test.ts +27 -0
  157. package/src/server/lib/omp/rpc/constants.test.ts +11 -0
  158. package/src/server/lib/omp/rpc/constants.ts +15 -0
  159. package/src/server/lib/omp/rpc/process.ts +11 -14
  160. package/src/server/lib/omp/rpc/session-commands.ts +6 -3
  161. package/src/server/lib/omp/rpc/utility-agent-dir.test.ts +134 -0
  162. package/src/server/lib/omp/rpc/utility-agent-dir.ts +138 -0
  163. package/src/server/lib/omp/rpc/utility.ts +12 -0
  164. package/src/server/lib/review/schema.server.ts +45 -0
  165. package/src/server/lib/review/store.server.ts +138 -0
  166. package/src/server/lib/terminal/attach-replay.test.ts +132 -0
  167. package/src/server/lib/terminal/output.test.ts +166 -0
  168. package/src/server/lib/terminal/output.ts +104 -0
  169. package/src/server/lib/terminal/runtime.server.ts +5 -0
  170. package/src/server/lib/terminal/send-result.test.ts +33 -0
  171. package/src/server/lib/terminal/send-result.ts +32 -0
  172. package/src/server/lib/terminal/session.server.ts +45 -11
  173. package/src/server/lib/terminal/store-liveness.test.ts +4 -0
  174. package/src/server/lib/updates/active-notes.test.ts +149 -0
  175. package/src/server/lib/updates/active-notes.ts +75 -0
  176. package/src/server/lib/updates/changelog-file.ts +42 -11
  177. package/src/server/lib/updates/changelog.test.ts +15 -1
  178. package/src/server/lib/updates/omp.ts +42 -15
  179. package/src/server/lib/updates/release-url.ts +27 -1
  180. package/src/server/lib/usage/index-parse.test.ts +200 -0
  181. package/src/server/lib/usage/index-parse.ts +178 -0
  182. package/src/server/lib/usage/index-query.server.ts +248 -0
  183. package/src/server/lib/usage/index-scan.server.ts +343 -0
  184. package/src/server/lib/usage/index-schema.server.ts +82 -0
  185. package/src/server/lib/usage/index.test.ts +234 -0
  186. package/src/server/lib/usage/providers.server.ts +4 -53
  187. package/src/server/routes/browser/index.ts +3 -0
  188. package/src/server/routes/browser/stream.ts +31 -2
  189. package/src/server/routes/browser/tabs.test.ts +94 -0
  190. package/src/server/routes/browser/tabs.ts +85 -0
  191. package/src/server/routes/index.ts +2 -0
  192. package/src/server/routes/review/bindings.ts +11 -0
  193. package/src/server/routes/review/index.ts +127 -0
  194. package/src/server/routes/review/routes.test.ts +191 -0
  195. package/src/server/routes/settings/agents.test.ts +180 -0
  196. package/src/server/routes/settings/agents.ts +95 -102
  197. package/src/server/routes/settings/mcp.test.ts +135 -0
  198. package/src/server/routes/settings/mcp.ts +14 -6
  199. package/src/server/routes/settings/settings-store-routes.test.ts +6 -113
  200. package/src/server/routes/telemetry/tokens.test.ts +145 -0
  201. package/src/server/routes/telemetry/tokens.ts +70 -149
  202. package/src/server/routes/terminal/ws.ts +6 -5
  203. package/src/server/routes/updates/index.ts +2 -0
  204. package/src/server/routes/updates/notes.ts +34 -0
  205. package/src/server/routes/updates/routes.test.ts +49 -0
  206. package/src/shared/lib/browser/annotate.test.ts +283 -0
  207. package/src/shared/lib/browser/annotate.ts +231 -0
  208. package/src/shared/lib/browser/browser-viewer.test.ts +26 -4
  209. package/src/shared/lib/browser/frame-gate.test.ts +91 -0
  210. package/src/shared/lib/browser/frame-gate.ts +69 -0
  211. package/src/shared/lib/browser/frame-params.test.ts +43 -0
  212. package/src/shared/lib/browser/frame-params.ts +60 -0
  213. package/src/shared/lib/browser/frame-pipeline.test.ts +132 -0
  214. package/src/shared/lib/browser/frame-pipeline.ts +80 -0
  215. package/src/shared/lib/browser/page-context.ts +60 -4
  216. package/src/shared/lib/browser/snapshot.test.ts +115 -0
  217. package/src/shared/lib/browser/snapshot.ts +112 -0
  218. package/src/shared/lib/browser/tab-close.test.ts +74 -0
  219. package/src/shared/lib/browser/tab-close.ts +77 -0
  220. package/src/shared/lib/browser/viewer.ts +45 -26
  221. package/src/shared/lib/chat/timeline/block-chrome.ts +19 -0
  222. package/src/shared/lib/chat/timeline/tool-render-mode.ts +17 -4
  223. package/src/shared/lib/chat/tool/artifact.ts +55 -20
  224. package/src/shared/lib/chat/tool/bash-facts.ts +96 -0
  225. package/src/shared/lib/chat/tool/minimized.test.ts +98 -0
  226. package/src/shared/lib/chat/tool/minimized.ts +64 -0
  227. package/src/shared/lib/chat/tool/summary.test.ts +28 -8
  228. package/src/shared/lib/chat/tool/summary.ts +3 -32
  229. package/src/shared/lib/markdown/blocks/anchor.ts +63 -0
  230. package/src/shared/lib/markdown/blocks/blocks.test.ts +141 -0
  231. package/src/shared/lib/markdown/blocks/renderer.ts +120 -0
  232. package/src/shared/lib/markdown/blocks/scan.ts +100 -0
  233. package/src/shared/lib/markdown/blocks/types.ts +62 -0
  234. package/src/shared/lib/markdown/marked.ts +58 -147
  235. package/src/shared/lib/markdown/math-extensions.ts +168 -0
  236. package/src/shared/lib/markdown/review/prompt.ts +77 -0
  237. package/src/shared/lib/markdown/review/reconcile.ts +55 -0
  238. package/src/shared/lib/markdown/review/review.test.ts +96 -0
  239. package/src/shared/lib/markdown/xml-sections.test.ts +140 -0
  240. package/src/shared/lib/markdown/xml-sections.ts +139 -0
  241. package/src/shared/lib/models/provider/label.ts +57 -0
  242. package/src/shared/lib/omp/config/agent-file.test.ts +54 -0
  243. package/src/shared/lib/omp/config/agent-file.ts +43 -0
  244. package/src/shared/lib/omp/config/row-value.test.ts +95 -0
  245. package/src/shared/lib/omp/config/row-value.ts +97 -0
  246. package/src/shared/lib/omp/config/schema.test.ts +31 -0
  247. package/src/shared/lib/omp/config/schema.ts +6 -0
  248. package/src/shared/lib/omp/rpc/frame.test.ts +48 -47
  249. package/src/shared/lib/omp/rpc/frame.ts +49 -40
  250. package/src/shared/lib/ui/menu-anchor.test.ts +69 -0
  251. package/src/shared/lib/ui/menu-anchor.ts +89 -0
  252. package/src/shared/lib/usage/breakdown.test.ts +197 -0
  253. package/src/shared/lib/usage/breakdown.ts +241 -0
  254. package/src/shared/lib/usage/range.test.ts +204 -0
  255. package/src/shared/lib/usage/range.ts +240 -0
  256. package/src/shared/lib/usage/view.test.ts +85 -0
  257. package/src/shared/lib/usage/view.ts +74 -0
  258. package/src/shared/types/browser.ts +78 -0
  259. package/src/shared/types/index.ts +1 -0
  260. package/src/shared/types/settings/agent.ts +28 -6
  261. package/src/shared/types/settings/state.ts +4 -3
  262. package/src/shared/types/settings/write.ts +6 -0
  263. package/src/shared/types/tokenUsage.ts +128 -21
  264. package/src/shared/types/updates.ts +20 -0
  265. package/dist/client/static/js/index-3ve31rzx.css +0 -1
  266. package/src/server/lib/omp/session/usage/aggregate-shaping.test.ts +0 -149
  267. package/src/server/lib/omp/session/usage/aggregate.test.ts +0 -243
  268. package/src/server/lib/omp/session/usage/aggregate.ts +0 -330
  269. package/src/server/lib/omp/session/usage/shaping.ts +0 -130
@@ -46,8 +46,11 @@
46
46
  * behind it are canvas.
47
47
  */
48
48
 
49
+ import { useRef, useState } from 'preact/hooks';
49
50
  import type { ReactNode } from 'preact/compat';
50
51
  import { ChevronDown, ChevronRight, MoreHorizontal, Pin, Plus } from 'lucide-preact';
52
+ import { AnchoredMenu } from '@/client/components/common/anchored-menu';
53
+ import { anchorRectOf, type AnchorRect } from '@/shared/lib/ui/menu-anchor';
51
54
  import { SelectionCheckbox } from '@/client/components/common/batch-selection/SelectionCheckbox';
52
55
  import type { CategoryHeaderCheckbox } from '@/client/components/layout/session-sidebar/CategoryHeader';
53
56
  import { getProjectIcon } from '@/shared/lib/workspace/project-icon';
@@ -61,11 +64,12 @@ export interface WorkspaceHeaderProps {
61
64
  sessionCount: number;
62
65
  checkbox: CategoryHeaderCheckbox | null;
63
66
  batchActive: boolean;
64
- menuRef: { current: HTMLDivElement | null };
65
67
  showMenu: boolean;
66
68
  onToggleMenu: () => void;
69
+ /** The `⋯` menu, dismissed by its own backdrop, Escape, or this call. */
70
+ onCloseMenu: () => void;
67
71
  onNewSession: () => void;
68
- /** The menu body, drawn in this header's anchored container while open. */
72
+ /** The menu body, drawn in a portalled panel while open. */
69
73
  menu?: ReactNode;
70
74
  /** Taller row and larger tap targets for the phone drawer. */
71
75
  touch?: boolean;
@@ -78,15 +82,20 @@ export function WorkspaceHeader({
78
82
  sessionCount,
79
83
  checkbox,
80
84
  batchActive,
81
- menuRef,
82
85
  showMenu,
83
86
  onToggleMenu,
87
+ onCloseMenu,
84
88
  onNewSession,
85
89
  menu,
86
90
  touch = false,
87
91
  }: WorkspaceHeaderProps) {
88
92
  const ProjectIcon = getProjectIcon(folder.icon);
89
93
  const accent = folder.accentColor || undefined;
94
+ const triggerRef = useRef<HTMLButtonElement>(null);
95
+ // Captured when the menu OPENS, not while it is open: the list scrolls under
96
+ // it, so a rectangle read on every render would drag the panel along with the
97
+ // rows instead of leaving it where the click put it.
98
+ const [anchor, setAnchor] = useState<AnchorRect | null>(null);
90
99
 
91
100
  return (
92
101
  <div
@@ -161,8 +170,9 @@ export function WorkspaceHeader({
161
170
  <Plus size={touch ? 15 : 12} />
162
171
  </button>
163
172
 
164
- <div className="relative flex items-center" ref={menuRef}>
173
+ <div className="relative flex items-center">
165
174
  <button
175
+ ref={triggerRef}
166
176
  type="button"
167
177
  title={`Options for ${folder.name}`}
168
178
  aria-label={`Options for ${folder.name}`}
@@ -170,6 +180,7 @@ export function WorkspaceHeader({
170
180
  aria-expanded={showMenu}
171
181
  onClick={(event) => {
172
182
  event.stopPropagation();
183
+ if (triggerRef.current) setAnchor(anchorRectOf(triggerRef.current));
173
184
  onToggleMenu();
174
185
  }}
175
186
  className={`flex items-center justify-center rounded text-ink/40 transition-colors cursor-pointer hover:bg-ink/10 hover:text-ink ${
@@ -179,12 +190,19 @@ export function WorkspaceHeader({
179
190
  <MoreHorizontal size={touch ? 15 : 12} />
180
191
  </button>
181
192
  {/* The menu body is the caller's: it owns the state the menu acts
182
- on (pin, delete confirmation, the worktree dialog). */}
183
- {showMenu && menu && (
184
- <div className="absolute right-0 top-full z-50 mt-1 w-44 rounded-md border border-ink/15 bg-paper py-1 text-xs shadow-lg">
185
- {menu}
186
- </div>
187
- )}
193
+ on (pin, delete confirmation, the worktree dialog). The PANEL is
194
+ this file's, portalled and measured, because the header is a
195
+ `sticky z-10` stacking context — a `z-50` child of it still
196
+ painted under the NEXT workspace's sticky header. */}
197
+ <AnchoredMenu
198
+ anchor={showMenu && menu ? anchor : null}
199
+ align="end"
200
+ ariaLabel={`Options for ${folder.name}`}
201
+ className="w-44 rounded-md border border-ink/15 bg-paper py-1 text-xs shadow-lg"
202
+ onClose={onCloseMenu}
203
+ >
204
+ {menu}
205
+ </AnchoredMenu>
188
206
  </div>
189
207
  </div>
190
208
  )}
@@ -24,11 +24,10 @@
24
24
  * is not silently hidden.
25
25
  */
26
26
 
27
- import { useEffect, useRef, useState } from 'preact/hooks';
27
+ import { useEffect, useState } from 'preact/hooks';
28
28
  import { ChevronDown, ChevronUp } from 'lucide-preact';
29
29
  import { useSearchParams } from '@/client/lib/router/search-params';
30
30
  import { useFetcher } from '@/client/lib/router/fetcher';
31
- import { useOnClickOutside } from '@/client/hooks/ui/on-click-outside';
32
31
  import { useShowMore } from '@/client/hooks/ui/show-more';
33
32
  import { useWorkspaceFolderActions } from '@/client/hooks/workspace/workspace-folder-actions';
34
33
  import { useSessionDelete } from '@/client/hooks/workspace/session-delete';
@@ -87,7 +86,6 @@ export function WorkspaceSection({
87
86
  const urlSubagentId = searchParams.get('subagent');
88
87
  const urlSessionId = searchParams.get('sessionId');
89
88
  const { expandedSessionIds, toggleSession } = useExpandedSessions();
90
- const menuRef = useRef<HTMLDivElement>(null);
91
89
  const { refresh } = useSidebarData();
92
90
  const toggleFetcher = useFetcher<{ success?: boolean }>();
93
91
  const {
@@ -110,10 +108,13 @@ export function WorkspaceSection({
110
108
  if (typeof folder.isExpanded === 'boolean') setIsOpen(folder.isExpanded);
111
109
  }, [folder.isExpanded]);
112
110
 
113
- useOnClickOutside(menuRef, () => {
111
+ // ONE dismissal path for the `⋯` menu: its own backdrop (in the header's
112
+ // portalled panel) is the click that closes it, so the sidebar no longer
113
+ // listens for outside clicks that the portal would read as "outside" anyway.
114
+ const closeMenu = () => {
114
115
  setShowMenu(false);
115
116
  cancelDelete();
116
- });
117
+ };
117
118
 
118
119
  const toggleFolder = () => {
119
120
  const next = !isOpen;
@@ -169,9 +170,9 @@ export function WorkspaceSection({
169
170
  : null
170
171
  }
171
172
  batchActive={Boolean(batch)}
172
- menuRef={menuRef}
173
173
  showMenu={showMenu}
174
174
  onToggleMenu={() => setShowMenu((open) => !open)}
175
+ onCloseMenu={closeMenu}
175
176
  onNewSession={() => onNewSessionForFolder(folder.id)}
176
177
  touch={density === 'touch'}
177
178
  menu={
@@ -75,9 +75,9 @@ function mount(overrides: Partial<WorkspaceHeaderProps> = {}) {
75
75
  sessionCount: 0,
76
76
  checkbox: null,
77
77
  batchActive: false,
78
- menuRef: { current: null },
79
78
  showMenu: false,
80
79
  onToggleMenu: () => {},
80
+ onCloseMenu: () => {},
81
81
  onNewSession: () => {},
82
82
  ...overrides,
83
83
  }),
@@ -20,8 +20,11 @@ const LINK_CLASS = 'inline-flex items-center gap-1 text-[10px] font-medium text-
20
20
  * A changelog body is full of links — commits, compare ranges, pull requests.
21
21
  * Without this, one click navigates the console away from the user's session;
22
22
  * a release note is a reference, so every link leaves in a new tab.
23
+ *
24
+ * Exported because the About modal's per-target dialog renders a single section
25
+ * through the same handler; a second copy would let one path navigate in place.
23
26
  */
24
- function openLinksExternally(event: TargetedMouseEvent<HTMLDivElement>) {
27
+ export function openLinksExternally(event: TargetedMouseEvent<HTMLDivElement>) {
25
28
  const link = (event.target as HTMLElement).closest<HTMLAnchorElement>('a[href]');
26
29
  if (!link) return;
27
30
  event.preventDefault();
@@ -29,7 +32,7 @@ function openLinksExternally(event: TargetedMouseEvent<HTMLDivElement>) {
29
32
  window.open(link.href, '_blank', 'noopener,noreferrer');
30
33
  }
31
34
 
32
- function ReleaseSection({ note }: { note: ReleaseNote }) {
35
+ export function ReleaseSection({ note }: { note: ReleaseNote }) {
33
36
  return (
34
37
  <article className="border-t border-ink/10 pt-4 first:border-t-0 first:pt-0">
35
38
  <header className="flex items-baseline justify-between gap-3">
@@ -44,8 +47,10 @@ function ReleaseSection({ note }: { note: ReleaseNote }) {
44
47
  </a>
45
48
  )}
46
49
  </header>
50
+ {/* `text-[13px]`, not the 12px a narrow column needed: at this width the
51
+ smaller size left lines too short to read as prose. */}
47
52
  {note.body ? (
48
- <MarkdownRenderer content={note.body} className="mt-2 text-[12px]" />
53
+ <MarkdownRenderer content={note.body} className="mt-2 text-[13px]" />
49
54
  ) : (
50
55
  <p className="mt-2 text-[11px] text-ink/40">This release was published without notes.</p>
51
56
  )}
@@ -94,7 +94,11 @@ export function UpdatePopup({ updates }: UpdatePopupProps) {
94
94
  <Modal
95
95
  onClose={close}
96
96
  zClass="z-[65]"
97
- maxWidthClass="max-w-[560px]"
97
+ // Same width as the About modal's per-version notes: both render release
98
+ // prose through `ReleaseNotes`, and a panel that fits a commit subject
99
+ // once at 768px takes three lines for it at 560px. This dialog is the one
100
+ // with the MOST of that prose — up to 20 releases in one scroll.
101
+ maxWidthClass="max-w-3xl"
98
102
  header={
99
103
  <div className="flex items-center gap-3 min-w-0">
100
104
  <Sparkles size={16} className="shrink-0 text-ink/70" />
@@ -1,11 +1,11 @@
1
1
  import { useCallback, useRef, useState } from 'preact/hooks';
2
- import { AlertTriangle } from 'lucide-preact';
3
2
  import { CodeSurface, type CodeSurfaceHandle } from '@/client/components/common/code-surface';
4
3
  import { countConflicts } from '@/client/components/common/code-surface/conflict-markers';
5
4
  import { ImageViewer } from '@/client/components/common/image-viewer';
6
5
  import { EditorHeader } from '@/client/components/mobile/mobile-right-sidebar/Header';
7
6
  import { PreviewScroller } from '@/client/components/mobile/mobile-right-sidebar/PreviewScroller';
8
7
  import { SaveDeletedFileModal } from '@/client/components/workspace/editor/SaveDeletedFileModal';
8
+ import { MissingFileBanner } from '@/client/components/mobile/mobile-right-sidebar/MissingFileBanner';
9
9
  import { EditorStatusBar } from '@/client/components/mobile/mobile-right-sidebar/StatusBar';
10
10
  import { EditorDropOverlay } from '@/client/components/workspace/editor/EditorDropOverlay';
11
11
  import { useEditorDrop } from '@/client/hooks/editor/use-editor-drop';
@@ -28,6 +28,7 @@ import { useEditorFontStack } from '@/client/hooks/editor/font';
28
28
  import { useEditorTheme } from '@/client/hooks/editor/theme';
29
29
  import { indentUnitFor, useEditorIndent } from '@/client/hooks/editor/indent-settings';
30
30
  import { useEditorTyping } from '@/client/hooks/editor/typing-settings';
31
+ import { useFileReviewMode } from '@/client/hooks/editor/use-file-review-mode';
31
32
  import { MOBILE_SCROLL_POSITIONS_KEY } from '@/shared/lib/workspace/scroll-positions';
32
33
  import { ViewerSurface, hasViewerSurface } from '@/client/components/workspace/editor/viewers/dispatch';
33
34
  import { BINARY_VIEWERS, RENDERED_VIEWERS, VIEWER_LABELS, viewerKindFor } from '@/shared/lib/fs/document-kind';
@@ -60,6 +61,11 @@ export function MobileFullEditor({ file, missing = false, onClose, onFileSaved,
60
61
  // The picture/grid/prose is what the file was opened to read, so a rendered
61
62
  // kind defaults to its preview and only a user's own toggle moves it.
62
63
  const isPreview = previewOverrides[fileKey] ?? hasPreview;
64
+ // Review mode is the same per-tab toggle the desktop pane uses (one key, one
65
+ // rule), and it exists only where a rendered markdown document is on screen —
66
+ // a CSV grid and an SVG picture have no markdown blocks to judge.
67
+ const review = useFileReviewMode(String(fileKey));
68
+ const hasReview = isMd && isPreview;
63
69
  const togglePreview = () => setPreviewOverrides((prev) => ({ ...prev, [fileKey]: !isPreview }));
64
70
 
65
71
  // The full-screen editor is the phone's editor panel, so it is a drop target
@@ -191,6 +197,9 @@ export function MobileFullEditor({ file, missing = false, onClose, onFileSaved,
191
197
  onSave={editor.saveNow}
192
198
  onClose={onClose}
193
199
  onTogglePreview={togglePreview}
200
+ hasReview={hasReview}
201
+ isReviewing={hasReview && review.active}
202
+ onToggleReview={review.toggle}
194
203
  onToggleFind={() => (find.open ? find.close() : find.openFind())}
195
204
  findOpen={find.open}
196
205
  onToggleWrap={() => setWordWrap(!wordWrap)}
@@ -200,20 +209,7 @@ export function MobileFullEditor({ file, missing = false, onClose, onFileSaved,
200
209
  onDownload={editor.download}
201
210
  />
202
211
 
203
- {/* A deleted file: the buffer is still on screen and still editable, so
204
- the state has to be stated where the user is looking, and the Save
205
- that recreates it has to be confirmed. Same rule as the desktop pane. */}
206
- {missing && (
207
- <div className="flex items-start gap-2 px-3 py-2 border-b border-error/30 bg-error/10 text-error shrink-0">
208
- <AlertTriangle size={14} className="shrink-0 mt-0.5" />
209
- <div className="min-w-0">
210
- <div className="text-[11.5px] font-sans">This file was deleted from disk.</div>
211
- <div className="text-[11px] font-sans text-error/80">
212
- The buffer is still here. Saving recreates the file — autosave is off until then.
213
- </div>
214
- </div>
215
- </div>
216
- )}
212
+ {missing && <MissingFileBanner />}
217
213
 
218
214
  {/* Find/replace, as a ROW under the header rather than a floating card: the
219
215
  desktop bar is 330px wide, and on a 390px screen a floating card would cover
@@ -266,6 +262,8 @@ export function MobileFullEditor({ file, missing = false, onClose, onFileSaved,
266
262
  isLoading={editor.isLoading}
267
263
  unsupported={editor.unsupported}
268
264
  loadError={editor.loadError}
265
+ reviewActive={hasReview && review.active}
266
+ onExitReview={review.toggle}
269
267
  />
270
268
  ) : (
271
269
  /* The code surface owns its own scroller (CodeMirror's), so it is NOT
@@ -1,4 +1,4 @@
1
- import { ArrowLeft, Check, Copy, Download, Eye, EyeOff, Save, Search, WrapText, ZoomIn, ZoomOut } from 'lucide-preact';
1
+ import { ArrowLeft, Check, Copy, Download, Eye, EyeOff, MessageSquare, Save, Search, WrapText, ZoomIn, ZoomOut } from 'lucide-preact';
2
2
  import { FileIcon } from '@/client/components/common/file-icon';
3
3
  import { titlebarPaddingLeft, titlebarPaddingRight } from '@/shared/lib/ui/titlebar';
4
4
 
@@ -7,6 +7,10 @@ interface EditorHeaderProps {
7
7
  /** The file has a rendered form (markdown prose, CSV grid, SVG), so the eye toggles. */
8
8
  hasPreview: boolean;
9
9
  isPreview: boolean;
10
+ /** A rendered markdown document is on screen, so its blocks can be judged. */
11
+ hasReview: boolean;
12
+ isReviewing: boolean;
13
+ onToggleReview: () => void;
10
14
  wordWrap: boolean;
11
15
  copied: boolean;
12
16
  /** A byte-drawing viewer (image, PDF, DOCX, workbook): wrap and zoom are text-only, so both are hidden. */
@@ -33,6 +37,9 @@ export function EditorHeader({
33
37
  fileName,
34
38
  hasPreview,
35
39
  isPreview,
40
+ hasReview,
41
+ isReviewing,
42
+ onToggleReview,
36
43
  wordWrap,
37
44
  copied,
38
45
  byteViewer = false,
@@ -106,6 +113,21 @@ export function EditorHeader({
106
113
  </button>
107
114
  )}
108
115
 
116
+ {/* Beside the eye, and only while the RENDERED document is on screen:
117
+ reviewing the source has no blocks to judge. */}
118
+ {hasReview && (
119
+ <button
120
+ type="button"
121
+ onClick={onToggleReview}
122
+ className={`p-1.5 rounded hover:bg-ink/10 transition-colors cursor-pointer ${isReviewing ? 'bg-ink text-canvas' : ''}`}
123
+ title={isReviewing ? 'Exit review mode' : 'Review this document'}
124
+ aria-label={isReviewing ? 'Exit review mode' : 'Review this document'}
125
+ aria-pressed={isReviewing}
126
+ >
127
+ <MessageSquare size={15} />
128
+ </button>
129
+ )}
130
+
109
131
  {hasPreview && (
110
132
  <button
111
133
  type="button"
@@ -0,0 +1,30 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The phone editor's "this file was deleted from disk" strip.
8
+ *
9
+ * Extracted from `FullEditor` for the per-file ceiling. It is a banner rather
10
+ * than a dialog because the buffer is still on screen and still editable: the
11
+ * user has to be able to see, and act on, the file they are editing while the
12
+ * fact sits above it. The desktop pane says the same thing in the same words —
13
+ * the two layouts are one product.
14
+ */
15
+
16
+ import { AlertTriangle } from 'lucide-preact';
17
+
18
+ export function MissingFileBanner() {
19
+ return (
20
+ <div className="flex items-start gap-2 px-3 py-2 border-b border-error/30 bg-error/10 text-error shrink-0">
21
+ <AlertTriangle size={14} className="shrink-0 mt-0.5" />
22
+ <div className="min-w-0">
23
+ <div className="text-[11.5px] font-sans">This file was deleted from disk.</div>
24
+ <div className="text-[11px] font-sans text-error/80">
25
+ The buffer is still here. Saving recreates the file — autosave is off until then.
26
+ </div>
27
+ </div>
28
+ </div>
29
+ );
30
+ }
@@ -18,7 +18,7 @@
18
18
  */
19
19
 
20
20
  import { AlertTriangle, FileX, Loader2 } from 'lucide-preact';
21
- import { MarkdownRenderer } from '@/client/components/common/MarkdownRenderer';
21
+ import { MarkdownReview } from '@/client/components/common/markdown-review';
22
22
 
23
23
  interface PreviewScrollerProps {
24
24
  fileName: string;
@@ -36,6 +36,15 @@ interface PreviewScrollerProps {
36
36
  unsupported: string | null | undefined;
37
37
  /** The read's failure message, when the bytes could not be fetched. */
38
38
  loadError: string | null | undefined;
39
+ /**
40
+ * Review mode, owned by the phone's own header.
41
+ *
42
+ * The same surface as the desktop preview, deliberately: the phone had no way
43
+ * to review a document before, and a second implementation would let the two
44
+ * disagree about what a mark means.
45
+ */
46
+ reviewActive: boolean;
47
+ onExitReview: () => void;
39
48
  }
40
49
 
41
50
  export function PreviewScroller({
@@ -50,6 +59,8 @@ export function PreviewScroller({
50
59
  isLoading,
51
60
  unsupported,
52
61
  loadError,
62
+ reviewActive,
63
+ onExitReview,
53
64
  }: PreviewScrollerProps) {
54
65
  return (
55
66
  <div
@@ -85,7 +96,12 @@ export function PreviewScroller({
85
96
  timeline's system), see the desktop editor for why there is no
86
97
  `prose` wrapper. */
87
98
  <div className="p-4 bg-paper text-ink min-h-full font-sans" style={{ fontSize: `${fontSize}px` }}>
88
- <MarkdownRenderer content={content} document scope={{ path, root, repo }} />
99
+ <MarkdownReview
100
+ content={content}
101
+ file={{ name: fileName, path, root, repo }}
102
+ active={reviewActive}
103
+ onExit={onExitReview}
104
+ />
89
105
  </div>
90
106
  )}
91
107
  </div>
@@ -1,9 +1,8 @@
1
- import { useRef, useState } from 'preact/hooks';
2
- import { ChevronDown, ChevronRight, GitBranch, MessageSquare, MoreHorizontal, Plus } from 'lucide-preact';
1
+ import { ChevronDown, ChevronRight, GitBranch, MessageSquare, Plus } from 'lucide-preact';
2
+ import { FolderItemMenu } from '@/client/components/mobile/mobile-session-sidebar/ItemMenu';
3
3
  import { useSearchParams } from '@/client/lib/router/search-params';
4
4
  import { MobileSessionRow } from '@/client/components/mobile/mobile-session-sidebar/SessionRow';
5
5
  import { SubagentList } from '@/client/components/common/subagent-list';
6
- import { WorkspaceOptionsMenu } from '@/client/components/common/workspace-options-menu';
7
6
  import { useWorktreeDialog } from '@/client/components/mobile/mobile-session-sidebar/WorktreeDialog';
8
7
  import { useShowMore } from '@/client/hooks/ui/show-more';
9
8
  import { useExpandedSessions } from '@/client/hooks/workspace/expanded-sessions';
@@ -12,7 +11,6 @@ import { useSessionDelete } from '@/client/hooks/workspace/session-delete';
12
11
  import { SessionDeleteModal } from '@/client/components/common/session-delete-modal';
13
12
  import { getProjectIcon } from '@/shared/lib/workspace/project-icon';
14
13
  import { relativeTimeAgo } from '@/shared/lib/workspace/relative-time';
15
- import { useOnClickOutside } from '@/client/hooks/ui/on-click-outside';
16
14
  import { useSidebarData } from '@/client/hooks/chat/omp/session-list';
17
15
  import type { WorkspaceFolderData } from '@/shared/types';
18
16
  import type { BatchBinding } from '@/client/components/common/batch-selection/types';
@@ -69,8 +67,6 @@ export function MobileSessionCategory({
69
67
  const [searchParams] = useSearchParams();
70
68
  const urlSubagentId = searchParams.get('subagent');
71
69
  const urlSessionId = searchParams.get('sessionId');
72
- const [showMenu, setShowMenu] = useState(false);
73
- const menuRef = useRef<HTMLDivElement>(null);
74
70
  const {
75
71
  confirmDelete,
76
72
  requestDelete,
@@ -84,29 +80,12 @@ export function MobileSessionCategory({
84
80
  } = useWorkspaceFolderActions(folder, refresh, onToast);
85
81
  const sessionDelete = useSessionDelete();
86
82
 
87
- useOnClickOutside(menuRef, () => {
88
- setShowMenu(false);
89
- cancelDelete();
90
- });
91
-
92
- const onPin = () => {
93
- handlePin();
94
- setShowMenu(false);
95
- };
96
-
97
- const onDelete = () => {
98
- handleDelete();
99
- setShowMenu(false);
100
- };
101
-
102
- // Same rule as the desktop header: reveal is an action, so the menu closes
103
- // on it — otherwise the toast would render behind the menu that triggered it.
104
- const onOpenFolder = handleOpenFolder
105
- ? () => {
106
- handleOpenFolder();
107
- setShowMenu(false);
108
- }
109
- : undefined;
83
+ // The `⋯` menu closes itself around each action (`ItemMenu`), so these stay
84
+ // plain: the reveal path is the one that used to leave the menu over its own
85
+ // toast.
86
+ const onPin = handlePin;
87
+ const onDelete = handleDelete;
88
+ const onOpenFolder = handleOpenFolder ?? undefined;
110
89
 
111
90
  // Archived rows are filtered first; the badge reports the visible set so the
112
91
  // count always matches what the list can actually show.
@@ -213,44 +192,20 @@ export function MobileSessionCategory({
213
192
  <Plus size={15} />
214
193
  </button>
215
194
 
216
- <div className="relative flex items-center" ref={menuRef} onClick={(event) => event.stopPropagation()}>
217
- <button
218
- type="button"
219
- onClick={(event) => {
220
- event.stopPropagation();
221
- setShowMenu(value => !value);
222
- }}
223
- className="p-1.5 rounded-lg hover:bg-ink/10 active:bg-ink/15 text-ink/60 hover:text-ink"
224
- title="Workspace options"
225
- aria-label={`Options for ${folder.name}`}
226
- >
227
- <MoreHorizontal size={15} />
228
- </button>
229
- {showMenu && (
230
- <div className="absolute right-0 top-full mt-1 w-48 bg-paper border border-ink/15 rounded-lg shadow-lg z-50 py-1 text-xs">
231
- <WorkspaceOptionsMenu
232
- variant="mobile"
233
- isPinned={folder.isPinned}
234
- onOpenFolder={onOpenFolder}
235
- onNewWorktree={
236
- onNewWorktreeSession && folder.project_path
237
- ? () => { setShowMenu(false); worktreeDialog.open(); }
238
- : undefined
239
- }
240
- onSelectSessions={
241
- onStartSessionSelection
242
- ? () => { setShowMenu(false); onStartSessionSelection(folder.id); }
243
- : undefined
244
- }
245
- confirmDelete={confirmDelete}
246
- onPin={onPin}
247
- onDelete={onDelete}
248
- onRequestDelete={requestDelete}
249
- onCancelDelete={cancelDelete}
250
- />
251
- </div>
252
- )}
253
- </div>
195
+ <FolderItemMenu
196
+ folder={folder}
197
+ canWorktree={Boolean(onNewWorktreeSession && folder.project_path)}
198
+ onOpenFolder={onOpenFolder}
199
+ onNewWorktree={onNewWorktreeSession ? () => worktreeDialog.open() : undefined}
200
+ onSelectSessions={
201
+ onStartSessionSelection ? () => onStartSessionSelection(folder.id) : undefined
202
+ }
203
+ confirmDelete={confirmDelete}
204
+ onPin={onPin}
205
+ onDelete={onDelete}
206
+ onRequestDelete={requestDelete}
207
+ onCancelDelete={cancelDelete}
208
+ />
254
209
 
255
210
  {/* The disclosure glyph's BOX ends on the list's content edge — the
256
211
  same x the toolbar row's last control ends on above it — and its
@@ -0,0 +1,110 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The phone drawer's folder `⋯`: the trigger and its menu, in one module.
8
+ *
9
+ * Split out of the drawer row because the panel is PORTALLED (see
10
+ * `common/anchored-menu/`): the drawer list is a scroller, and the panel it used
11
+ * to hang inside was clipped at the scroller's edge and lost to the sticky
12
+ * workspace headers once the list scrolled — measured with `elementFromPoint`.
13
+ * Keeping the trigger and the panel together means the anchor is captured where
14
+ * the click happens and the drawer row holds no menu state of its own.
15
+ *
16
+ * Every action closes the menu before it runs: Pin and Delete paint a toast, and
17
+ * a menu left standing over it hides the answer to the click.
18
+ */
19
+
20
+ import { useRef, useState } from 'preact/hooks';
21
+ import { MoreHorizontal } from 'lucide-preact';
22
+ import { AnchoredMenu } from '@/client/components/common/anchored-menu';
23
+ import { anchorRectOf, type AnchorRect } from '@/shared/lib/ui/menu-anchor';
24
+ import { WorkspaceOptionsMenu } from '@/client/components/common/workspace-options-menu';
25
+ import type { WorkspaceFolderData } from '@/shared/types';
26
+
27
+ export interface FolderItemMenuProps {
28
+ folder: WorkspaceFolderData;
29
+ /** True when this folder is bound to a repository the menu may branch from. */
30
+ canWorktree: boolean;
31
+ onOpenFolder?: () => void;
32
+ onNewWorktree?: () => void;
33
+ onSelectSessions?: () => void;
34
+ confirmDelete: boolean;
35
+ onPin: () => void;
36
+ onDelete: () => void;
37
+ onRequestDelete: () => void;
38
+ onCancelDelete: () => void;
39
+ }
40
+
41
+ /** The row's trailing control box, matched to its `+` beside it. */
42
+ const TRIGGER_CLASS =
43
+ 'p-1.5 rounded-lg hover:bg-ink/10 active:bg-ink/15 text-ink/60 hover:text-ink';
44
+
45
+ export function FolderItemMenu({
46
+ folder,
47
+ canWorktree,
48
+ onOpenFolder,
49
+ onNewWorktree,
50
+ onSelectSessions,
51
+ confirmDelete,
52
+ onPin,
53
+ onDelete,
54
+ onRequestDelete,
55
+ onCancelDelete,
56
+ }: FolderItemMenuProps) {
57
+ const [open, setOpen] = useState(false);
58
+ const triggerRef = useRef<HTMLButtonElement>(null);
59
+ const [anchor, setAnchor] = useState<AnchorRect | null>(null);
60
+
61
+ const run = (action: () => void) => () => {
62
+ setOpen(false);
63
+ action();
64
+ };
65
+
66
+ return (
67
+ <div className="relative flex items-center" onClick={(event) => event.stopPropagation()}>
68
+ <button
69
+ ref={triggerRef}
70
+ type="button"
71
+ onClick={(event) => {
72
+ event.stopPropagation();
73
+ if (triggerRef.current) setAnchor(anchorRectOf(triggerRef.current));
74
+ setOpen((was) => !was);
75
+ }}
76
+ className={TRIGGER_CLASS}
77
+ title="Workspace options"
78
+ aria-label={`Options for ${folder.name}`}
79
+ aria-haspopup="menu"
80
+ aria-expanded={open}
81
+ >
82
+ <MoreHorizontal size={15} />
83
+ </button>
84
+
85
+ <AnchoredMenu
86
+ anchor={open ? anchor : null}
87
+ align="end"
88
+ ariaLabel={`Options for ${folder.name}`}
89
+ className="w-48 rounded-lg border border-ink/15 bg-paper py-1 text-xs shadow-lg"
90
+ onClose={() => {
91
+ setOpen(false);
92
+ onCancelDelete();
93
+ }}
94
+ >
95
+ <WorkspaceOptionsMenu
96
+ variant="mobile"
97
+ isPinned={folder.isPinned}
98
+ onOpenFolder={onOpenFolder ? run(onOpenFolder) : undefined}
99
+ onNewWorktree={canWorktree && onNewWorktree ? run(onNewWorktree) : undefined}
100
+ onSelectSessions={onSelectSessions ? run(onSelectSessions) : undefined}
101
+ confirmDelete={confirmDelete}
102
+ onPin={run(onPin)}
103
+ onDelete={run(onDelete)}
104
+ onRequestDelete={onRequestDelete}
105
+ onCancelDelete={onCancelDelete}
106
+ />
107
+ </AnchoredMenu>
108
+ </div>
109
+ );
110
+ }