markupr 2.1.8

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 (299) hide show
  1. package/.claude/commands/review-feedback.md +47 -0
  2. package/.eslintrc.json +35 -0
  3. package/.github/CODEOWNERS +16 -0
  4. package/.github/FUNDING.yml +1 -0
  5. package/.github/ISSUE_TEMPLATE/bug_report.md +56 -0
  6. package/.github/ISSUE_TEMPLATE/feature_request.md +54 -0
  7. package/.github/PULL_REQUEST_TEMPLATE.md +89 -0
  8. package/.github/dependabot.yml +70 -0
  9. package/.github/workflows/ci.yml +184 -0
  10. package/.github/workflows/deploy-landing.yml +134 -0
  11. package/.github/workflows/nightly.yml +288 -0
  12. package/.github/workflows/release.yml +318 -0
  13. package/CHANGELOG.md +127 -0
  14. package/CLAUDE.md +137 -0
  15. package/CODE_OF_CONDUCT.md +9 -0
  16. package/CONTRIBUTING.md +390 -0
  17. package/LICENSE +21 -0
  18. package/PRODUCT_VISION.md +277 -0
  19. package/README.md +517 -0
  20. package/SECURITY.md +51 -0
  21. package/SIGNING_INSTRUCTIONS.md +284 -0
  22. package/assets/DMG_BACKGROUND_INSTRUCTIONS.md +130 -0
  23. package/assets/svg-source/dmg-background.svg +70 -0
  24. package/assets/svg-source/icon.svg +20 -0
  25. package/assets/svg-source/tray-icon-processing.svg +7 -0
  26. package/assets/svg-source/tray-icon-recording.svg +7 -0
  27. package/assets/svg-source/tray-icon.svg +6 -0
  28. package/assets/tray-complete.png +0 -0
  29. package/assets/tray-complete@2x.png +0 -0
  30. package/assets/tray-completeTemplate.png +0 -0
  31. package/assets/tray-completeTemplate@2x.png +0 -0
  32. package/assets/tray-error.png +0 -0
  33. package/assets/tray-error@2x.png +0 -0
  34. package/assets/tray-errorTemplate.png +0 -0
  35. package/assets/tray-errorTemplate@2x.png +0 -0
  36. package/assets/tray-icon-processing.png +0 -0
  37. package/assets/tray-icon-processing@2x.png +0 -0
  38. package/assets/tray-icon-processingTemplate.png +0 -0
  39. package/assets/tray-icon-processingTemplate@2x.png +0 -0
  40. package/assets/tray-icon-recording.png +0 -0
  41. package/assets/tray-icon-recording@2x.png +0 -0
  42. package/assets/tray-icon-recordingTemplate.png +0 -0
  43. package/assets/tray-icon-recordingTemplate@2x.png +0 -0
  44. package/assets/tray-icon.png +0 -0
  45. package/assets/tray-icon@2x.png +0 -0
  46. package/assets/tray-iconTemplate.png +0 -0
  47. package/assets/tray-iconTemplate@2x.png +0 -0
  48. package/assets/tray-idle.png +0 -0
  49. package/assets/tray-idle@2x.png +0 -0
  50. package/assets/tray-idleTemplate.png +0 -0
  51. package/assets/tray-idleTemplate@2x.png +0 -0
  52. package/assets/tray-processing-0.png +0 -0
  53. package/assets/tray-processing-0@2x.png +0 -0
  54. package/assets/tray-processing-0Template.png +0 -0
  55. package/assets/tray-processing-0Template@2x.png +0 -0
  56. package/assets/tray-processing-1.png +0 -0
  57. package/assets/tray-processing-1@2x.png +0 -0
  58. package/assets/tray-processing-1Template.png +0 -0
  59. package/assets/tray-processing-1Template@2x.png +0 -0
  60. package/assets/tray-processing-2.png +0 -0
  61. package/assets/tray-processing-2@2x.png +0 -0
  62. package/assets/tray-processing-2Template.png +0 -0
  63. package/assets/tray-processing-2Template@2x.png +0 -0
  64. package/assets/tray-processing-3.png +0 -0
  65. package/assets/tray-processing-3@2x.png +0 -0
  66. package/assets/tray-processing-3Template.png +0 -0
  67. package/assets/tray-processing-3Template@2x.png +0 -0
  68. package/assets/tray-processing.png +0 -0
  69. package/assets/tray-processing@2x.png +0 -0
  70. package/assets/tray-processingTemplate.png +0 -0
  71. package/assets/tray-processingTemplate@2x.png +0 -0
  72. package/assets/tray-recording.png +0 -0
  73. package/assets/tray-recording@2x.png +0 -0
  74. package/assets/tray-recordingTemplate.png +0 -0
  75. package/assets/tray-recordingTemplate@2x.png +0 -0
  76. package/build/DMG_BACKGROUND_SPEC.md +50 -0
  77. package/build/dmg-background.png +0 -0
  78. package/build/dmg-background@2x.png +0 -0
  79. package/build/entitlements.mac.inherit.plist +27 -0
  80. package/build/entitlements.mac.plist +41 -0
  81. package/build/favicon-16.png +0 -0
  82. package/build/favicon-180.png +0 -0
  83. package/build/favicon-192.png +0 -0
  84. package/build/favicon-32.png +0 -0
  85. package/build/favicon-48.png +0 -0
  86. package/build/favicon-512.png +0 -0
  87. package/build/favicon-64.png +0 -0
  88. package/build/icon-128.png +0 -0
  89. package/build/icon-16.png +0 -0
  90. package/build/icon-24.png +0 -0
  91. package/build/icon-256.png +0 -0
  92. package/build/icon-32.png +0 -0
  93. package/build/icon-48.png +0 -0
  94. package/build/icon-64.png +0 -0
  95. package/build/icon.icns +0 -0
  96. package/build/icon.ico +0 -0
  97. package/build/icon.iconset/icon_128x128.png +0 -0
  98. package/build/icon.iconset/icon_128x128@2x.png +0 -0
  99. package/build/icon.iconset/icon_16x16.png +0 -0
  100. package/build/icon.iconset/icon_16x16@2x.png +0 -0
  101. package/build/icon.iconset/icon_256x256.png +0 -0
  102. package/build/icon.iconset/icon_256x256@2x.png +0 -0
  103. package/build/icon.iconset/icon_32x32.png +0 -0
  104. package/build/icon.iconset/icon_32x32@2x.png +0 -0
  105. package/build/icon.iconset/icon_512x512.png +0 -0
  106. package/build/icon.iconset/icon_512x512@2x.png +0 -0
  107. package/build/icon.png +0 -0
  108. package/build/installer-header.bmp +0 -0
  109. package/build/installer-header.png +0 -0
  110. package/build/installer-sidebar.bmp +0 -0
  111. package/build/installer-sidebar.png +0 -0
  112. package/build/installer.nsh +45 -0
  113. package/build/overlay-processing.png +0 -0
  114. package/build/overlay-recording.png +0 -0
  115. package/build/toolbar-record.png +0 -0
  116. package/build/toolbar-screenshot.png +0 -0
  117. package/build/toolbar-settings.png +0 -0
  118. package/build/toolbar-stop.png +0 -0
  119. package/dist/main/index.mjs +12612 -0
  120. package/dist/preload/index.mjs +907 -0
  121. package/dist/renderer/assets/index-CCmUjl9K.js +19495 -0
  122. package/dist/renderer/assets/index-CUqz_Gs6.css +2270 -0
  123. package/dist/renderer/index.html +27 -0
  124. package/docs/AI_AGENT_QUICKSTART.md +42 -0
  125. package/docs/AI_PIPELINE_DESIGN.md +595 -0
  126. package/docs/API.md +514 -0
  127. package/docs/ARCHITECTURE.md +460 -0
  128. package/docs/CONFIGURATION.md +336 -0
  129. package/docs/DEVELOPMENT.md +508 -0
  130. package/docs/EXPORT_FORMATS.md +451 -0
  131. package/docs/GETTING_STARTED.md +236 -0
  132. package/docs/KEYBOARD_SHORTCUTS.md +334 -0
  133. package/docs/TROUBLESHOOTING.md +418 -0
  134. package/docs/landing/index.html +672 -0
  135. package/docs/landing/script.js +342 -0
  136. package/docs/landing/styles.css +1543 -0
  137. package/electron-builder.yml +140 -0
  138. package/electron.vite.config.ts +63 -0
  139. package/package.json +108 -0
  140. package/railway.json +12 -0
  141. package/scripts/build.mjs +51 -0
  142. package/scripts/generate-icons.mjs +314 -0
  143. package/scripts/generate-installer-images.cjs +253 -0
  144. package/scripts/generate-tray-icons.mjs +258 -0
  145. package/scripts/notarize.cjs +180 -0
  146. package/scripts/one-click-clean-test.sh +147 -0
  147. package/scripts/postinstall.mjs +36 -0
  148. package/scripts/setup-markupr.sh +55 -0
  149. package/setup +17 -0
  150. package/site/index.html +1835 -0
  151. package/site/package.json +11 -0
  152. package/site/railway.json +12 -0
  153. package/site/server.js +31 -0
  154. package/src/main/AutoUpdater.ts +392 -0
  155. package/src/main/CrashRecovery.ts +655 -0
  156. package/src/main/ErrorHandler.ts +703 -0
  157. package/src/main/HotkeyManager.ts +399 -0
  158. package/src/main/MenuManager.ts +529 -0
  159. package/src/main/PermissionManager.ts +420 -0
  160. package/src/main/SessionController.ts +1465 -0
  161. package/src/main/TrayManager.ts +540 -0
  162. package/src/main/ai/AIPipelineManager.ts +199 -0
  163. package/src/main/ai/ClaudeAnalyzer.ts +339 -0
  164. package/src/main/ai/ImageOptimizer.ts +176 -0
  165. package/src/main/ai/StructuredMarkdownBuilder.ts +379 -0
  166. package/src/main/ai/index.ts +16 -0
  167. package/src/main/ai/types.ts +258 -0
  168. package/src/main/analysis/ClarificationGenerator.ts +385 -0
  169. package/src/main/analysis/FeedbackAnalyzer.ts +531 -0
  170. package/src/main/analysis/index.ts +19 -0
  171. package/src/main/audio/AudioCapture.ts +978 -0
  172. package/src/main/audio/audioUtils.ts +100 -0
  173. package/src/main/audio/index.ts +20 -0
  174. package/src/main/capture/index.ts +1 -0
  175. package/src/main/index.ts +1693 -0
  176. package/src/main/ipc/captureHandlers.ts +272 -0
  177. package/src/main/ipc/index.ts +45 -0
  178. package/src/main/ipc/outputHandlers.ts +302 -0
  179. package/src/main/ipc/sessionHandlers.ts +56 -0
  180. package/src/main/ipc/settingsHandlers.ts +471 -0
  181. package/src/main/ipc/types.ts +56 -0
  182. package/src/main/ipc/windowHandlers.ts +277 -0
  183. package/src/main/output/ClipboardService.ts +369 -0
  184. package/src/main/output/ExportService.ts +539 -0
  185. package/src/main/output/FileManager.ts +416 -0
  186. package/src/main/output/MarkdownGenerator.ts +791 -0
  187. package/src/main/output/MarkdownPatcher.ts +299 -0
  188. package/src/main/output/index.ts +186 -0
  189. package/src/main/output/sessionAdapter.ts +207 -0
  190. package/src/main/output/templates/html-template.ts +553 -0
  191. package/src/main/pipeline/FrameExtractor.ts +330 -0
  192. package/src/main/pipeline/PostProcessor.ts +399 -0
  193. package/src/main/pipeline/TranscriptAnalyzer.ts +226 -0
  194. package/src/main/pipeline/index.ts +36 -0
  195. package/src/main/platform/WindowsTaskbar.ts +600 -0
  196. package/src/main/platform/index.ts +16 -0
  197. package/src/main/settings/SettingsManager.ts +730 -0
  198. package/src/main/settings/index.ts +19 -0
  199. package/src/main/transcription/ModelDownloadManager.ts +494 -0
  200. package/src/main/transcription/TierManager.ts +219 -0
  201. package/src/main/transcription/TranscriptionRecoveryService.ts +340 -0
  202. package/src/main/transcription/WhisperService.ts +748 -0
  203. package/src/main/transcription/index.ts +56 -0
  204. package/src/main/transcription/types.ts +135 -0
  205. package/src/main/windows/PopoverManager.ts +284 -0
  206. package/src/main/windows/TaskbarIntegration.ts +452 -0
  207. package/src/main/windows/index.ts +23 -0
  208. package/src/preload/index.ts +1047 -0
  209. package/src/renderer/App.tsx +515 -0
  210. package/src/renderer/AppWrapper.tsx +28 -0
  211. package/src/renderer/assets/logo-dark.svg +7 -0
  212. package/src/renderer/assets/logo.svg +7 -0
  213. package/src/renderer/audio/AudioCaptureRenderer.ts +454 -0
  214. package/src/renderer/capture/ScreenRecordingRenderer.ts +492 -0
  215. package/src/renderer/components/AnnotationOverlay.tsx +836 -0
  216. package/src/renderer/components/AudioWaveform.tsx +811 -0
  217. package/src/renderer/components/ClarificationQuestions.tsx +656 -0
  218. package/src/renderer/components/CountdownTimer.tsx +495 -0
  219. package/src/renderer/components/CrashRecoveryDialog.tsx +632 -0
  220. package/src/renderer/components/DonateButton.tsx +127 -0
  221. package/src/renderer/components/ErrorBoundary.tsx +308 -0
  222. package/src/renderer/components/ExportDialog.tsx +872 -0
  223. package/src/renderer/components/HotkeyHint.tsx +261 -0
  224. package/src/renderer/components/KeyboardShortcuts.tsx +787 -0
  225. package/src/renderer/components/ModelDownloadDialog.tsx +844 -0
  226. package/src/renderer/components/Onboarding.tsx +1830 -0
  227. package/src/renderer/components/ProcessingOverlay.tsx +157 -0
  228. package/src/renderer/components/RecordingOverlay.tsx +423 -0
  229. package/src/renderer/components/SessionHistory.tsx +1746 -0
  230. package/src/renderer/components/SessionReview.tsx +1321 -0
  231. package/src/renderer/components/SettingsPanel.tsx +217 -0
  232. package/src/renderer/components/Skeleton.tsx +347 -0
  233. package/src/renderer/components/StatusIndicator.tsx +86 -0
  234. package/src/renderer/components/ThemeProvider.tsx +429 -0
  235. package/src/renderer/components/Tooltip.tsx +370 -0
  236. package/src/renderer/components/TranscriptionPreview.tsx +183 -0
  237. package/src/renderer/components/TranscriptionTierSelector.tsx +640 -0
  238. package/src/renderer/components/UpdateNotification.tsx +377 -0
  239. package/src/renderer/components/WindowSelector.tsx +947 -0
  240. package/src/renderer/components/index.ts +99 -0
  241. package/src/renderer/components/primitives/ApiKeyInput.tsx +98 -0
  242. package/src/renderer/components/primitives/ColorPicker.tsx +65 -0
  243. package/src/renderer/components/primitives/DangerButton.tsx +45 -0
  244. package/src/renderer/components/primitives/DirectoryPicker.tsx +41 -0
  245. package/src/renderer/components/primitives/Dropdown.tsx +34 -0
  246. package/src/renderer/components/primitives/KeyRecorder.tsx +117 -0
  247. package/src/renderer/components/primitives/SettingsSection.tsx +32 -0
  248. package/src/renderer/components/primitives/Slider.tsx +43 -0
  249. package/src/renderer/components/primitives/Toggle.tsx +36 -0
  250. package/src/renderer/components/primitives/index.ts +10 -0
  251. package/src/renderer/components/settings/AdvancedTab.tsx +174 -0
  252. package/src/renderer/components/settings/AppearanceTab.tsx +77 -0
  253. package/src/renderer/components/settings/GeneralTab.tsx +40 -0
  254. package/src/renderer/components/settings/HotkeysTab.tsx +79 -0
  255. package/src/renderer/components/settings/RecordingTab.tsx +84 -0
  256. package/src/renderer/components/settings/index.ts +9 -0
  257. package/src/renderer/components/settings/settingsStyles.ts +673 -0
  258. package/src/renderer/components/settings/tabConfig.tsx +85 -0
  259. package/src/renderer/components/settings/useSettingsPanel.ts +447 -0
  260. package/src/renderer/contexts/ProcessingContext.tsx +227 -0
  261. package/src/renderer/contexts/RecordingContext.tsx +683 -0
  262. package/src/renderer/contexts/UIContext.tsx +326 -0
  263. package/src/renderer/contexts/index.ts +24 -0
  264. package/src/renderer/donateMessages.ts +69 -0
  265. package/src/renderer/hooks/index.ts +75 -0
  266. package/src/renderer/hooks/useAnimation.tsx +544 -0
  267. package/src/renderer/hooks/useTheme.ts +313 -0
  268. package/src/renderer/index.html +26 -0
  269. package/src/renderer/main.tsx +52 -0
  270. package/src/renderer/styles/animations.css +1093 -0
  271. package/src/renderer/styles/app-shell.css +662 -0
  272. package/src/renderer/styles/globals.css +515 -0
  273. package/src/renderer/styles/theme.ts +578 -0
  274. package/src/renderer/types/electron.d.ts +385 -0
  275. package/src/shared/hotkeys.ts +283 -0
  276. package/src/shared/types.ts +809 -0
  277. package/tests/clipboard.test.ts +228 -0
  278. package/tests/e2e/criticalPaths.test.ts +594 -0
  279. package/tests/feedbackAnalyzer.test.ts +303 -0
  280. package/tests/integration/sessionFlow.test.ts +583 -0
  281. package/tests/markdownGenerator.test.ts +418 -0
  282. package/tests/output.test.ts +96 -0
  283. package/tests/setup.ts +486 -0
  284. package/tests/unit/appIntegration.test.ts +676 -0
  285. package/tests/unit/appViewState.test.ts +281 -0
  286. package/tests/unit/audioIpcChannels.test.ts +17 -0
  287. package/tests/unit/exportService.test.ts +492 -0
  288. package/tests/unit/hotkeys.test.ts +92 -0
  289. package/tests/unit/navigationPreload.test.ts +94 -0
  290. package/tests/unit/onboardingFlow.test.ts +345 -0
  291. package/tests/unit/permissionManager.test.ts +175 -0
  292. package/tests/unit/permissionManagerExpanded.test.ts +296 -0
  293. package/tests/unit/screenRecordingRenderer.test.ts +368 -0
  294. package/tests/unit/sessionController.test.ts +515 -0
  295. package/tests/unit/tierManager.test.ts +61 -0
  296. package/tests/unit/tierManagerExpanded.test.ts +142 -0
  297. package/tests/unit/transcriptAnalyzer.test.ts +64 -0
  298. package/tsconfig.json +25 -0
  299. package/vitest.config.ts +46 -0
@@ -0,0 +1,157 @@
1
+ import React, { useRef, useEffect, useState } from 'react';
2
+ import { useTheme } from '../hooks/useTheme';
3
+
4
+ interface ProcessingOverlayProps {
5
+ percent: number;
6
+ step: string;
7
+ onHide?: () => void;
8
+ }
9
+
10
+ export const ProcessingOverlay: React.FC<ProcessingOverlayProps> = ({
11
+ percent,
12
+ step,
13
+ onHide,
14
+ }) => {
15
+ const { colors } = useTheme();
16
+ const boundedPercent = Math.max(0, Math.min(100, Math.round(percent)));
17
+
18
+ // Announce progress at 25% milestones for screen readers
19
+ const lastAnnouncedRef = useRef(0);
20
+ const [announcement, setAnnouncement] = useState('');
21
+ useEffect(() => {
22
+ const milestone = Math.floor(boundedPercent / 25) * 25;
23
+ if (milestone > lastAnnouncedRef.current && milestone > 0) {
24
+ lastAnnouncedRef.current = milestone;
25
+ setAnnouncement(`Processing ${milestone}% complete. ${step}`);
26
+ }
27
+ }, [boundedPercent, step]);
28
+
29
+ return (
30
+ <div
31
+ role="status"
32
+ aria-label={`Processing ${boundedPercent}% complete`}
33
+ style={{
34
+ position: 'fixed',
35
+ left: '50%',
36
+ top: 8,
37
+ transform: 'translateX(-50%)',
38
+ zIndex: 9999,
39
+ width: 'min(304px, calc(100vw - 16px))',
40
+ display: 'grid',
41
+ gap: 8,
42
+ padding: '8px 10px',
43
+ borderRadius: 12,
44
+ border: '1px solid rgba(160, 176, 206, 0.2)',
45
+ background:
46
+ 'linear-gradient(150deg, rgba(14, 22, 36, 0.82), rgba(10, 17, 29, 0.74))',
47
+ boxShadow: '0 6px 20px rgba(0, 0, 0, 0.25)',
48
+ backdropFilter: 'blur(16px) saturate(1.12)',
49
+ WebkitBackdropFilter: 'blur(16px) saturate(1.12)',
50
+ WebkitAppRegion: 'no-drag',
51
+ } as React.CSSProperties & { WebkitAppRegion?: string }}
52
+ >
53
+ <div
54
+ style={{
55
+ display: 'flex',
56
+ alignItems: 'center',
57
+ justifyContent: 'space-between',
58
+ gap: 8,
59
+ }}
60
+ >
61
+ <span
62
+ style={{
63
+ fontSize: 11,
64
+ letterSpacing: '0.05em',
65
+ textTransform: 'uppercase',
66
+ color: 'rgba(178, 194, 218, 0.88)',
67
+ fontWeight: 700,
68
+ }}
69
+ >
70
+ Processing
71
+ </span>
72
+ {onHide && (
73
+ <button
74
+ type="button"
75
+ onClick={onHide}
76
+ style={{
77
+ border: '1px solid rgba(159, 173, 196, 0.28)',
78
+ background: 'rgba(153, 168, 190, 0.16)',
79
+ color: 'rgba(224, 233, 249, 0.95)',
80
+ borderRadius: 999,
81
+ padding: '2px 8px',
82
+ fontSize: 11,
83
+ fontWeight: 600,
84
+ cursor: 'pointer',
85
+ }}
86
+ >
87
+ Hide
88
+ </button>
89
+ )}
90
+ </div>
91
+
92
+ <div style={{ display: 'grid', gap: 5 }}>
93
+ <div
94
+ style={{
95
+ height: 6,
96
+ borderRadius: 999,
97
+ overflow: 'hidden',
98
+ background: 'rgba(81, 104, 136, 0.34)',
99
+ }}
100
+ >
101
+ <div
102
+ style={{
103
+ width: `${boundedPercent}%`,
104
+ height: '100%',
105
+ borderRadius: 999,
106
+ background: 'linear-gradient(90deg, var(--accent-default) 0%, var(--text-link) 100%)',
107
+ transition: 'width 460ms cubic-bezier(0.23, 1, 0.32, 1)',
108
+ }}
109
+ />
110
+ </div>
111
+ <div
112
+ style={{
113
+ display: 'flex',
114
+ alignItems: 'center',
115
+ justifyContent: 'space-between',
116
+ gap: 10,
117
+ }}
118
+ >
119
+ <span
120
+ style={{
121
+ fontFamily:
122
+ 'ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace',
123
+ fontVariantNumeric: 'tabular-nums',
124
+ fontSize: 11,
125
+ color: colors.text.link,
126
+ fontWeight: 700,
127
+ minWidth: 40,
128
+ }}
129
+ >
130
+ {boundedPercent}%
131
+ </span>
132
+ <span
133
+ style={{
134
+ fontSize: 11,
135
+ color: 'rgba(204, 216, 237, 0.92)',
136
+ textAlign: 'right',
137
+ overflow: 'hidden',
138
+ textOverflow: 'ellipsis',
139
+ whiteSpace: 'nowrap',
140
+ flex: 1,
141
+ }}
142
+ title={step}
143
+ >
144
+ {step}
145
+ </span>
146
+ </div>
147
+ </div>
148
+
149
+ {/* Screen reader progress announcements at 25% milestones */}
150
+ <div aria-live="polite" aria-atomic="true" style={{ position: 'absolute', width: 1, height: 1, overflow: 'hidden', clip: 'rect(0,0,0,0)' }}>
151
+ {announcement}
152
+ </div>
153
+ </div>
154
+ );
155
+ };
156
+
157
+ export default ProcessingOverlay;
@@ -0,0 +1,423 @@
1
+ /**
2
+ * Recording Overlay Component
3
+ *
4
+ * A compact floating indicator showing:
5
+ * - Recording duration (MM:SS)
6
+ * - Pulsing red recording dot
7
+ * - Stop button
8
+ * - +1 badge animation on screenshot capture
9
+ *
10
+ * Design: Premium, subtle glass HUD that stays readable without feeling heavy
11
+ * Position persists across sessions via localStorage
12
+ */
13
+
14
+ import React, { useState, useEffect, useRef, useCallback } from 'react';
15
+ import { CompactAudioIndicator } from './AudioWaveform';
16
+ import { useTheme } from '../hooks/useTheme';
17
+
18
+ interface RecordingOverlayProps {
19
+ duration: number; // seconds
20
+ screenshotCount: number;
21
+ onStop: () => void;
22
+ isDarkMode?: boolean;
23
+ audioLevel?: number;
24
+ isVoiceActive?: boolean;
25
+ isPaused?: boolean;
26
+ manualShortcut?: string;
27
+ toggleShortcut?: string;
28
+ pauseShortcut?: string;
29
+ }
30
+
31
+ const DEFAULT_WIDTH = 300;
32
+
33
+ function formatCompactShortcut(accelerator: string, isMac: boolean): string {
34
+ if (!accelerator || accelerator.trim().length === 0) {
35
+ return isMac ? '⌘⇧?' : 'Ctrl+Shift+?';
36
+ }
37
+
38
+ const normalized = accelerator
39
+ .replace(/CommandOrControl/gi, isMac ? 'Command' : 'Control')
40
+ .replace(/CmdOrCtrl/gi, isMac ? 'Command' : 'Control');
41
+ const keys = normalized.split('+').map((part) => part.trim()).filter(Boolean);
42
+
43
+ if (!isMac) {
44
+ return keys
45
+ .map((key) => {
46
+ const lower = key.toLowerCase();
47
+ if (lower === 'control' || lower === 'ctrl') return 'Ctrl';
48
+ if (lower === 'alt' || lower === 'option') return 'Alt';
49
+ if (lower === 'shift') return 'Shift';
50
+ if (lower === 'command' || lower === 'cmd') return 'Ctrl';
51
+ return key.length === 1 ? key.toUpperCase() : key;
52
+ })
53
+ .join('+');
54
+ }
55
+
56
+ const symbolMap: Record<string, string> = {
57
+ command: '⌘',
58
+ cmd: '⌘',
59
+ control: '⌃',
60
+ ctrl: '⌃',
61
+ alt: '⌥',
62
+ option: '⌥',
63
+ shift: '⇧',
64
+ enter: '↩',
65
+ return: '↩',
66
+ space: '␣',
67
+ };
68
+
69
+ return keys
70
+ .map((key) => {
71
+ const lower = key.toLowerCase();
72
+ return symbolMap[lower] || (key.length === 1 ? key.toUpperCase() : key);
73
+ })
74
+ .join('');
75
+ }
76
+
77
+ export const RecordingOverlay: React.FC<RecordingOverlayProps> = ({
78
+ duration,
79
+ screenshotCount,
80
+ onStop,
81
+ isDarkMode = false,
82
+ audioLevel = 0,
83
+ isVoiceActive = false,
84
+ isPaused = false,
85
+ manualShortcut = 'CommandOrControl+Shift+S',
86
+ toggleShortcut = 'CommandOrControl+Shift+F',
87
+ pauseShortcut = 'CommandOrControl+Shift+P',
88
+ }) => {
89
+ const [showBadge, setShowBadge] = useState(false);
90
+ const [badgeKey, setBadgeKey] = useState(0);
91
+ const [displayedMicPercent, setDisplayedMicPercent] = useState(0);
92
+
93
+ const prevCountRef = useRef(screenshotCount);
94
+ const micPercentTargetRef = useRef(0);
95
+ const isMac = typeof navigator !== 'undefined' && navigator.platform.toUpperCase().includes('MAC');
96
+
97
+ // Format duration as MM:SS
98
+ const formatDuration = useCallback((seconds: number): string => {
99
+ const mins = Math.floor(seconds / 60);
100
+ const secs = seconds % 60;
101
+ return `${mins.toString().padStart(2, '0')}:${secs.toString().padStart(2, '0')}`;
102
+ }, []);
103
+
104
+ // Show +1 badge animation when screenshot count increases
105
+ useEffect(() => {
106
+ if (screenshotCount > prevCountRef.current) {
107
+ setShowBadge(true);
108
+ setBadgeKey((prev) => prev + 1); // Force re-render for animation
109
+ const timer = setTimeout(() => setShowBadge(false), 1200);
110
+ prevCountRef.current = screenshotCount;
111
+ return () => clearTimeout(timer);
112
+ }
113
+ prevCountRef.current = screenshotCount;
114
+ }, [screenshotCount]);
115
+
116
+ // Dynamic styles based on theme
117
+ const { colors } = useTheme();
118
+ const theme = {
119
+ bg: isDarkMode
120
+ ? 'rgba(12, 18, 30, 0.44)'
121
+ : 'rgba(244, 247, 252, 0.42)',
122
+ border: isDarkMode ? 'rgba(177, 192, 214, 0.22)' : 'rgba(95, 106, 121, 0.14)',
123
+ text: colors.text.primary,
124
+ textMuted: colors.text.secondary,
125
+ hintBg: isDarkMode ? 'rgba(67, 77, 97, 0.22)' : 'rgba(218, 225, 235, 0.24)',
126
+ stopBg: colors.status.error,
127
+ stopHover: '#d92f25',
128
+ pauseBg: isDarkMode ? 'rgba(255, 159, 10, 0.26)' : 'rgba(255, 159, 10, 0.2)',
129
+ badgeBg: colors.status.success,
130
+ recordingDot: colors.status.error,
131
+ micActive: colors.accent.default,
132
+ micIdle: colors.text.tertiary,
133
+ };
134
+ const manualShortcutText = formatCompactShortcut(manualShortcut, isMac);
135
+ const toggleShortcutText = formatCompactShortcut(toggleShortcut, isMac);
136
+ const pauseShortcutText = formatCompactShortcut(pauseShortcut, isMac);
137
+ const normalizedAudioLevel = Math.max(0, Math.min(1, audioLevel));
138
+ const visualAudioLevel = isPaused
139
+ ? 0
140
+ : isVoiceActive
141
+ ? Math.max(0.08, 1 - Math.exp(-normalizedAudioLevel * 2.4))
142
+ : normalizedAudioLevel * 0.35;
143
+ const micPercentTarget = !isPaused && isVoiceActive
144
+ ? Math.min(96, Math.max(8, Math.round(visualAudioLevel * 100)))
145
+ : 0;
146
+
147
+ useEffect(() => {
148
+ micPercentTargetRef.current = micPercentTarget;
149
+ }, [micPercentTarget]);
150
+
151
+ useEffect(() => {
152
+ let frame = 0;
153
+
154
+ const tick = () => {
155
+ setDisplayedMicPercent((previous) => {
156
+ const target = micPercentTargetRef.current;
157
+ const delta = target - previous;
158
+ if (Math.abs(delta) < 1) {
159
+ return target;
160
+ }
161
+ return previous + delta * 0.2;
162
+ });
163
+ frame = window.requestAnimationFrame(tick);
164
+ };
165
+
166
+ frame = window.requestAnimationFrame(tick);
167
+ return () => {
168
+ window.cancelAnimationFrame(frame);
169
+ };
170
+ }, []);
171
+
172
+ return (
173
+ <>
174
+ {/* pulseScale, badgeFloat keyframes provided by animations.css */}
175
+
176
+ <div
177
+ role="status"
178
+ aria-live="polite"
179
+ aria-label="Recording in progress"
180
+ style={{
181
+ position: 'fixed',
182
+ left: '50%',
183
+ top: 8,
184
+ transform: 'translateX(-50%)',
185
+ zIndex: 9999,
186
+ display: 'grid',
187
+ gap: 3,
188
+ width: `min(${DEFAULT_WIDTH}px, calc(100vw - 16px))`,
189
+ justifyItems: 'center',
190
+ userSelect: 'none',
191
+ transition: 'box-shadow 0.2s ease',
192
+ // Electron-specific: prevent window drag
193
+ WebkitAppRegion: 'no-drag',
194
+ } as React.CSSProperties & { WebkitAppRegion?: string }}
195
+ >
196
+ <div
197
+ style={{
198
+ display: 'flex',
199
+ alignItems: 'center',
200
+ gap: 7,
201
+ width: '100%',
202
+ padding: '3px 7px',
203
+ background: theme.bg,
204
+ border: `1px solid ${theme.border}`,
205
+ borderRadius: 999,
206
+ boxShadow: '0 1px 2px rgba(8, 12, 19, 0.12)',
207
+ backdropFilter: 'blur(24px) saturate(1.05)',
208
+ WebkitBackdropFilter: 'blur(24px) saturate(1.05)',
209
+ }}
210
+ >
211
+ {/* Recording dot */}
212
+ <div
213
+ style={{
214
+ position: 'relative',
215
+ width: 10,
216
+ height: 10,
217
+ }}
218
+ >
219
+ <div
220
+ style={{
221
+ position: 'absolute',
222
+ inset: 0,
223
+ border: `2px solid ${theme.recordingDot}`,
224
+ borderRadius: '50%',
225
+ opacity: 0.25,
226
+ }}
227
+ />
228
+ <div
229
+ style={{
230
+ position: 'relative',
231
+ width: 10,
232
+ height: 10,
233
+ backgroundColor: theme.recordingDot,
234
+ borderRadius: '50%',
235
+ animation: 'pulseScale 1.5s ease-in-out infinite',
236
+ }}
237
+ />
238
+ </div>
239
+
240
+ {/* Duration display */}
241
+ <span
242
+ style={{
243
+ fontFamily: 'ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace',
244
+ fontSize: 11,
245
+ fontWeight: 600,
246
+ fontVariantNumeric: 'tabular-nums',
247
+ color: theme.text,
248
+ minWidth: 40,
249
+ textAlign: 'center',
250
+ letterSpacing: '0.02em',
251
+ }}
252
+ >
253
+ {formatDuration(duration)}
254
+ </span>
255
+
256
+ {/* Live microphone indicator */}
257
+ <div
258
+ style={{
259
+ display: 'inline-flex',
260
+ alignItems: 'center',
261
+ gap: 5,
262
+ borderRadius: 999,
263
+ padding: '2px 5px',
264
+ background: isPaused ? theme.pauseBg : theme.hintBg,
265
+ color: theme.textMuted,
266
+ fontSize: 8,
267
+ fontWeight: 600,
268
+ minWidth: 78,
269
+ }}
270
+ >
271
+ <CompactAudioIndicator
272
+ audioLevel={visualAudioLevel}
273
+ isVoiceActive={isVoiceActive}
274
+ accentColor={theme.micActive}
275
+ inactiveColor={theme.micIdle}
276
+ barCount={11}
277
+ barWidth={2.6}
278
+ barGap={1.2}
279
+ meterHeight={16}
280
+ minBarHeight={4}
281
+ maxBarHeight={16}
282
+ />
283
+ <span
284
+ style={{
285
+ color: isPaused ? colors.status.warning : isVoiceActive ? theme.text : theme.textMuted,
286
+ fontVariantNumeric: 'tabular-nums',
287
+ minWidth: 36,
288
+ textAlign: 'right',
289
+ }}
290
+ >
291
+ {isPaused ? 'Paused' : isVoiceActive ? `${Math.round(displayedMicPercent)}%` : 'Mic'}
292
+ </span>
293
+ </div>
294
+
295
+ {/* Screenshot count */}
296
+ <span
297
+ style={{
298
+ marginLeft: 'auto',
299
+ fontSize: 8,
300
+ color: theme.textMuted,
301
+ borderRadius: 999,
302
+ padding: '2px 5px',
303
+ background: theme.hintBg,
304
+ }}
305
+ title="Manual shot markers confirmed in this session"
306
+ >
307
+ {screenshotCount} marked
308
+ </span>
309
+
310
+ {/* Stop button */}
311
+ <button
312
+ type="button"
313
+ onClick={onStop}
314
+ style={{
315
+ padding: '3px 6px',
316
+ backgroundColor: theme.stopBg,
317
+ border: 'none',
318
+ borderRadius: 9,
319
+ color: colors.text.inverse,
320
+ fontSize: 8.5,
321
+ fontWeight: 700,
322
+ cursor: 'pointer',
323
+ transition: 'all 0.15s ease',
324
+ outline: 'none',
325
+ letterSpacing: '0.01em',
326
+ whiteSpace: 'nowrap',
327
+ }}
328
+ onMouseEnter={(e) => {
329
+ e.currentTarget.style.backgroundColor = theme.stopHover;
330
+ e.currentTarget.style.transform = 'translateY(-1px)';
331
+ }}
332
+ onMouseLeave={(e) => {
333
+ e.currentTarget.style.backgroundColor = theme.stopBg;
334
+ e.currentTarget.style.transform = 'scale(1)';
335
+ }}
336
+ onMouseDown={(e) => {
337
+ e.currentTarget.style.transform = 'translateY(0)';
338
+ }}
339
+ onMouseUp={(e) => {
340
+ e.currentTarget.style.transform = 'translateY(-1px)';
341
+ }}
342
+ >
343
+ Stop
344
+ </button>
345
+ </div>
346
+
347
+ {/* Shortcut reminders */}
348
+ <div
349
+ style={{
350
+ display: 'flex',
351
+ alignItems: 'center',
352
+ gap: 5,
353
+ fontSize: 8,
354
+ color: theme.textMuted,
355
+ whiteSpace: 'nowrap',
356
+ overflow: 'hidden',
357
+ textOverflow: 'ellipsis',
358
+ width: '100%',
359
+ justifyContent: 'center',
360
+ }}
361
+ >
362
+ <span
363
+ style={{
364
+ display: 'inline-flex',
365
+ alignItems: 'center',
366
+ borderRadius: 999,
367
+ padding: '1px 5px',
368
+ background: theme.hintBg,
369
+ }}
370
+ >
371
+ <strong style={{ fontWeight: 700 }}>Mark {manualShortcutText}</strong>
372
+ </span>
373
+ <span
374
+ style={{
375
+ display: 'inline-flex',
376
+ alignItems: 'center',
377
+ borderRadius: 999,
378
+ padding: '1px 5px',
379
+ background: theme.hintBg,
380
+ }}
381
+ >
382
+ <strong style={{ fontWeight: 700 }}>Stop {toggleShortcutText}</strong>
383
+ </span>
384
+ <span
385
+ style={{
386
+ display: 'inline-flex',
387
+ alignItems: 'center',
388
+ borderRadius: 999,
389
+ padding: '1px 5px',
390
+ background: theme.hintBg,
391
+ }}
392
+ >
393
+ <strong style={{ fontWeight: 700 }}>Pause {pauseShortcutText}</strong>
394
+ </span>
395
+ </div>
396
+
397
+ {/* +1 Badge (animated, appears on screenshot) */}
398
+ {showBadge && (
399
+ <span
400
+ key={badgeKey}
401
+ style={{
402
+ position: 'absolute',
403
+ top: -8,
404
+ right: 50,
405
+ padding: '2px 6px',
406
+ backgroundColor: theme.badgeBg,
407
+ color: colors.text.inverse,
408
+ fontSize: 10,
409
+ fontWeight: 700,
410
+ borderRadius: 10,
411
+ animation: 'badgeFloat 1.2s ease-out forwards',
412
+ pointerEvents: 'none',
413
+ }}
414
+ >
415
+ +1
416
+ </span>
417
+ )}
418
+ </div>
419
+ </>
420
+ );
421
+ };
422
+
423
+ export default RecordingOverlay;