@sriinnu/runic 1.0.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 (584) hide show
  1. package/.swiftformat +50 -0
  2. package/.swiftlint.yml +160 -0
  3. package/CHANGELOG.md +307 -0
  4. package/CONTRIBUTING.md +456 -0
  5. package/Icon.icns +0 -0
  6. package/Icon.icon/Assets/runic.png +0 -0
  7. package/Icon.icon/icon.json +36 -0
  8. package/LICENSE +21 -0
  9. package/Package.resolved +51 -0
  10. package/Package.swift +136 -0
  11. package/Packages/Helix/LICENSE +21 -0
  12. package/Packages/Helix/Package.swift +29 -0
  13. package/Packages/Helix/README.md +976 -0
  14. package/Packages/Helix/Sources/Helix/Binding.swift +111 -0
  15. package/Packages/Helix/Sources/Helix/CommandParser.swift +160 -0
  16. package/Packages/Helix/Sources/Helix/CommandSignature.swift +117 -0
  17. package/Packages/Helix/Sources/Helix/ExpressibleFromArgument.swift +72 -0
  18. package/Packages/Helix/Sources/Helix/HelpGenerator.swift +175 -0
  19. package/Packages/Helix/Sources/Helix/NameSpecification.swift +98 -0
  20. package/Packages/Helix/Sources/Helix/ParsableCommand.swift +204 -0
  21. package/Packages/Helix/Sources/Helix/Platform/DarwinPlatformContext.swift +44 -0
  22. package/Packages/Helix/Sources/Helix/Platform/LinuxPlatformContext.swift +34 -0
  23. package/Packages/Helix/Sources/Helix/Platform/PlatformContext+Default.swift +91 -0
  24. package/Packages/Helix/Sources/Helix/Platform/PlatformContext.swift +94 -0
  25. package/Packages/Helix/Sources/Helix/Platform/PlatformPath.swift +167 -0
  26. package/Packages/Helix/Sources/Helix/Platform/Stdio.swift +99 -0
  27. package/Packages/Helix/Sources/Helix/Platform/WebPlatformContext.swift +146 -0
  28. package/Packages/Helix/Sources/Helix/Platform/WindowsPlatformContext.swift +97 -0
  29. package/Packages/Helix/Sources/Helix/Program.swift +204 -0
  30. package/Packages/Helix/Sources/Helix/PropertyWrappers.swift +367 -0
  31. package/Packages/Silo/LICENSE +21 -0
  32. package/Packages/Silo/Package.swift +34 -0
  33. package/Packages/Silo/README.md +466 -0
  34. package/Packages/Silo/Sources/Silo/BinaryCookiesReader.swift +169 -0
  35. package/Packages/Silo/Sources/Silo/BrowserCookieAnalytics.swift +365 -0
  36. package/Packages/Silo/Sources/Silo/BrowserCookieBackends.swift +594 -0
  37. package/Packages/Silo/Sources/Silo/BrowserCookieClient.swift +326 -0
  38. package/Packages/Silo/Sources/Silo/BrowserCookieExport.swift +154 -0
  39. package/Packages/Silo/Sources/Silo/BrowserCookieImport.swift +119 -0
  40. package/Packages/Silo/Sources/Silo/BrowserCookieMockStore.swift +121 -0
  41. package/Packages/Silo/Sources/Silo/BrowserCookieModels.swift +391 -0
  42. package/Packages/Silo/Sources/Silo/ChromiumCookieReader.swift +240 -0
  43. package/Packages/Silo/Sources/Silo/CryptoSupport.swift +86 -0
  44. package/Packages/Silo/Sources/Silo/FirefoxCookieReader.swift +172 -0
  45. package/Packages/Silo/Sources/Silo/LinuxChromiumCookieReader.swift +172 -0
  46. package/Packages/Silo/Sources/Silo/LinuxSecretService.swift +105 -0
  47. package/Packages/Silo/Sources/Silo/MacOSChromiumCookieReader.swift +191 -0
  48. package/Packages/Silo/Sources/Silo/SQLiteSnapshot.swift +41 -0
  49. package/Packages/Silo/Sources/Silo/WindowsChromiumCookieReader.swift +110 -0
  50. package/README.md +109 -0
  51. package/RuniciOS/App/RuniciOSApp.swift +105 -0
  52. package/RuniciOS/Core/iOSUsageStore.swift +192 -0
  53. package/RuniciOS/Views/ProviderDetailView.swift +312 -0
  54. package/RuniciOS/Views/ProviderListView.swift +228 -0
  55. package/RuniciOS/Widgets/LargeWidget.swift +367 -0
  56. package/RuniciOS/Widgets/LiveActivity.swift +342 -0
  57. package/RuniciOS/Widgets/LockScreenWidget.swift +273 -0
  58. package/RuniciOS/Widgets/MediumWidget.swift +370 -0
  59. package/RuniciOS/Widgets/RunicWidget.swift +274 -0
  60. package/RuniciOS/Widgets/SmallWidget.swift +281 -0
  61. package/RuniciOS/Widgets/WidgetModels.swift +285 -0
  62. package/RuniciOS/Widgets/WidgetTimeline.swift +270 -0
  63. package/Scripts/CREATION-SUMMARY.md +367 -0
  64. package/Scripts/DIRECTORY-STRUCTURE.md +358 -0
  65. package/Scripts/GETTING-STARTED-CHECKLIST.md +364 -0
  66. package/Scripts/INDEX.md +365 -0
  67. package/Scripts/QUICK-REFERENCE.md +164 -0
  68. package/Scripts/README-SCRIPTS.md +926 -0
  69. package/Scripts/build-android.sh +526 -0
  70. package/Scripts/build-ios.sh +529 -0
  71. package/Scripts/build-macos.sh +603 -0
  72. package/Scripts/build-windows.sh +504 -0
  73. package/Scripts/build_icon.sh +49 -0
  74. package/Scripts/changelog-to-html.sh +89 -0
  75. package/Scripts/check-release-assets.sh +10 -0
  76. package/Scripts/ci-config.yml +474 -0
  77. package/Scripts/compile_and_run.sh +219 -0
  78. package/Scripts/compile_and_run_adhoc.sh +4 -0
  79. package/Scripts/docs-list.mjs +119 -0
  80. package/Scripts/make_appcast.sh +58 -0
  81. package/Scripts/package_app.sh +409 -0
  82. package/Scripts/release-lib.sh +214 -0
  83. package/Scripts/release.sh +76 -0
  84. package/Scripts/setup-all.sh +387 -0
  85. package/Scripts/setup-ios.sh +404 -0
  86. package/Scripts/setup-react-native.sh +523 -0
  87. package/Scripts/sign-and-notarize.sh +122 -0
  88. package/Scripts/test_live_update.sh +38 -0
  89. package/Scripts/validate_changelog.sh +23 -0
  90. package/Scripts/verify_appcast.sh +92 -0
  91. package/Sources/Runic/About.swift +93 -0
  92. package/Sources/Runic/AppNotifications.swift +115 -0
  93. package/Sources/Runic/Controllers/StatusItemController+Actions.swift +657 -0
  94. package/Sources/Runic/Controllers/StatusItemController+Animation.swift +518 -0
  95. package/Sources/Runic/Controllers/StatusItemController+ChartSubmenus.swift +810 -0
  96. package/Sources/Runic/Controllers/StatusItemController+CustomProviders.swift +87 -0
  97. package/Sources/Runic/Controllers/StatusItemController+Menu.swift +1379 -0
  98. package/Sources/Runic/Controllers/StatusItemController+MenuCards.swift +337 -0
  99. package/Sources/Runic/Controllers/StatusItemController+MenuHelpers.swift +395 -0
  100. package/Sources/Runic/Controllers/StatusItemController.swift +360 -0
  101. package/Sources/Runic/Core/BudgetNotificationManager.swift +80 -0
  102. package/Sources/Runic/Core/Login/ClaudeLoginRunner.swift +103 -0
  103. package/Sources/Runic/Core/Login/CodexLoginRunner.swift +154 -0
  104. package/Sources/Runic/Core/Login/CursorLoginRunner.swift +206 -0
  105. package/Sources/Runic/Core/Login/GeminiLoginRunner.swift +95 -0
  106. package/Sources/Runic/Core/Rendering/IconRenderer.swift +1216 -0
  107. package/Sources/Runic/Core/Rendering/IconView.swift +120 -0
  108. package/Sources/Runic/Core/Rendering/ProviderBrandIcon.swift +71 -0
  109. package/Sources/Runic/Core/RunicAnimation.swift +53 -0
  110. package/Sources/Runic/Core/RunicColors.swift +73 -0
  111. package/Sources/Runic/Core/RunicCornerRadius.swift +15 -0
  112. package/Sources/Runic/Core/RunicSpacing.swift +68 -0
  113. package/Sources/Runic/Core/Stores/AuggieTokenStore.swift +143 -0
  114. package/Sources/Runic/Core/Stores/AzureOpenAITokenStore.swift +143 -0
  115. package/Sources/Runic/Core/Stores/CerebrasTokenStore.swift +143 -0
  116. package/Sources/Runic/Core/Stores/CohereTokenStore.swift +143 -0
  117. package/Sources/Runic/Core/Stores/CopilotTokenStore.swift +143 -0
  118. package/Sources/Runic/Core/Stores/CustomProviderStore.swift +158 -0
  119. package/Sources/Runic/Core/Stores/DeepSeekTokenStore.swift +143 -0
  120. package/Sources/Runic/Core/Stores/FireworksTokenStore.swift +143 -0
  121. package/Sources/Runic/Core/Stores/GroqTokenStore.swift +143 -0
  122. package/Sources/Runic/Core/Stores/KimiTokenStore.swift +143 -0
  123. package/Sources/Runic/Core/Stores/MiniMaxCookieHeaderStore.swift +143 -0
  124. package/Sources/Runic/Core/Stores/MiniMaxGroupIDStore.swift +143 -0
  125. package/Sources/Runic/Core/Stores/MiniMaxTokenStore.swift +143 -0
  126. package/Sources/Runic/Core/Stores/MistralTokenStore.swift +143 -0
  127. package/Sources/Runic/Core/Stores/OpenRouterTokenStore.swift +143 -0
  128. package/Sources/Runic/Core/Stores/PerplexityTokenStore.swift +143 -0
  129. package/Sources/Runic/Core/Stores/ProviderToggleStore.swift +30 -0
  130. package/Sources/Runic/Core/Stores/QwenTokenStore.swift +143 -0
  131. package/Sources/Runic/Core/Stores/SambaNovaTokenStore.swift +143 -0
  132. package/Sources/Runic/Core/Stores/SettingsStore.swift +1702 -0
  133. package/Sources/Runic/Core/Stores/TogetherTokenStore.swift +143 -0
  134. package/Sources/Runic/Core/Stores/UsageStore+Accessors.swift +20 -0
  135. package/Sources/Runic/Core/Stores/UsageStore+Status.swift +189 -0
  136. package/Sources/Runic/Core/Stores/UsageStore+TokenCost.swift +33 -0
  137. package/Sources/Runic/Core/Stores/UsageStore+WidgetSnapshot.swift +67 -0
  138. package/Sources/Runic/Core/Stores/UsageStore.swift +3564 -0
  139. package/Sources/Runic/Core/Stores/XAITokenStore.swift +143 -0
  140. package/Sources/Runic/Core/Stores/ZaiTokenStore.swift +143 -0
  141. package/Sources/Runic/Core/UsageExporter.swift +193 -0
  142. package/Sources/Runic/Date+RelativeDescription.swift +21 -0
  143. package/Sources/Runic/HiddenWindowView.swift +32 -0
  144. package/Sources/Runic/InstallOrigin.swift +9 -0
  145. package/Sources/Runic/KeyboardShortcuts+Names.swift +6 -0
  146. package/Sources/Runic/MouseLocationReader.swift +65 -0
  147. package/Sources/Runic/Notifications+Runic.swift +6 -0
  148. package/Sources/Runic/OpenAICreditsPurchaseWindowController.swift +503 -0
  149. package/Sources/Runic/ProviderRegistry.swift +100 -0
  150. package/Sources/Runic/ProviderSwitcherButtons.swift +267 -0
  151. package/Sources/Runic/Providers/Antigravity/AntigravityLoginFlow.swift +11 -0
  152. package/Sources/Runic/Providers/Antigravity/AntigravityProviderImplementation.swift +14 -0
  153. package/Sources/Runic/Providers/Auggie/AuggieProviderImplementation.swift +24 -0
  154. package/Sources/Runic/Providers/Azure/AzureProviderImplementation.swift +52 -0
  155. package/Sources/Runic/Providers/Bedrock/BedrockProviderImplementation.swift +42 -0
  156. package/Sources/Runic/Providers/Cerebras/CerebrasProviderImplementation.swift +24 -0
  157. package/Sources/Runic/Providers/Claude/ClaudeLoginFlow.swift +26 -0
  158. package/Sources/Runic/Providers/Claude/ClaudeProviderImplementation.swift +14 -0
  159. package/Sources/Runic/Providers/Codex/CodexLoginFlow.swift +18 -0
  160. package/Sources/Runic/Providers/Codex/CodexProviderImplementation.swift +15 -0
  161. package/Sources/Runic/Providers/Cohere/CohereProviderImplementation.swift +24 -0
  162. package/Sources/Runic/Providers/Copilot/CopilotLoginFlow.swift +193 -0
  163. package/Sources/Runic/Providers/Copilot/CopilotProviderImplementation.swift +110 -0
  164. package/Sources/Runic/Providers/Cursor/CursorLoginFlow.swift +28 -0
  165. package/Sources/Runic/Providers/Cursor/CursorProviderImplementation.swift +15 -0
  166. package/Sources/Runic/Providers/DeepSeek/DeepSeekProviderImplementation.swift +24 -0
  167. package/Sources/Runic/Providers/Factory/FactoryLoginFlow.swift +12 -0
  168. package/Sources/Runic/Providers/Factory/FactoryProviderImplementation.swift +15 -0
  169. package/Sources/Runic/Providers/Fireworks/FireworksProviderImplementation.swift +24 -0
  170. package/Sources/Runic/Providers/Gemini/GeminiLoginFlow.swift +20 -0
  171. package/Sources/Runic/Providers/Gemini/GeminiProviderImplementation.swift +15 -0
  172. package/Sources/Runic/Providers/Groq/GroqProviderImplementation.swift +24 -0
  173. package/Sources/Runic/Providers/Kimi/KimiProviderImplementation.swift +24 -0
  174. package/Sources/Runic/Providers/MiniMax/MiniMaxProviderImplementation.swift +32 -0
  175. package/Sources/Runic/Providers/Mistral/MistralProviderImplementation.swift +24 -0
  176. package/Sources/Runic/Providers/OpenRouter/OpenRouterProviderImplementation.swift +24 -0
  177. package/Sources/Runic/Providers/Perplexity/PerplexityProviderImplementation.swift +24 -0
  178. package/Sources/Runic/Providers/SambaNova/SambaNovaProviderImplementation.swift +24 -0
  179. package/Sources/Runic/Providers/Shared/ProviderCatalog.swift +15 -0
  180. package/Sources/Runic/Providers/Shared/ProviderImplementation.swift +48 -0
  181. package/Sources/Runic/Providers/Shared/ProviderImplementationRegistry.swift +66 -0
  182. package/Sources/Runic/Providers/Shared/ProviderLoginFlow.swift +12 -0
  183. package/Sources/Runic/Providers/Shared/ProviderSettingsDescriptors.swift +99 -0
  184. package/Sources/Runic/Providers/Shared/SystemSettingsLinks.swift +18 -0
  185. package/Sources/Runic/Providers/Together/TogetherProviderImplementation.swift +24 -0
  186. package/Sources/Runic/Providers/XAI/XAIProviderImplementation.swift +24 -0
  187. package/Sources/Runic/Providers/Zai/ZaiProviderImplementation.swift +24 -0
  188. package/Sources/Runic/Resources/ProviderIcon-antigravity.svg +2 -0
  189. package/Sources/Runic/Resources/ProviderIcon-auggie.svg +3 -0
  190. package/Sources/Runic/Resources/ProviderIcon-azure.svg +5 -0
  191. package/Sources/Runic/Resources/ProviderIcon-bedrock.svg +7 -0
  192. package/Sources/Runic/Resources/ProviderIcon-cerebras.svg +3 -0
  193. package/Sources/Runic/Resources/ProviderIcon-claude.svg +1 -0
  194. package/Sources/Runic/Resources/ProviderIcon-codex.svg +1 -0
  195. package/Sources/Runic/Resources/ProviderIcon-cohere.svg +3 -0
  196. package/Sources/Runic/Resources/ProviderIcon-copilot.svg +1 -0
  197. package/Sources/Runic/Resources/ProviderIcon-cursor.svg +3 -0
  198. package/Sources/Runic/Resources/ProviderIcon-deepseek.svg +4 -0
  199. package/Sources/Runic/Resources/ProviderIcon-factory.svg +3 -0
  200. package/Sources/Runic/Resources/ProviderIcon-fireworks.svg +3 -0
  201. package/Sources/Runic/Resources/ProviderIcon-gemini.svg +1 -0
  202. package/Sources/Runic/Resources/ProviderIcon-groq.svg +1 -0
  203. package/Sources/Runic/Resources/ProviderIcon-kimi.svg +4 -0
  204. package/Sources/Runic/Resources/ProviderIcon-minimax.svg +1 -0
  205. package/Sources/Runic/Resources/ProviderIcon-mistral.svg +5 -0
  206. package/Sources/Runic/Resources/ProviderIcon-openrouter.svg +7 -0
  207. package/Sources/Runic/Resources/ProviderIcon-perplexity.svg +4 -0
  208. package/Sources/Runic/Resources/ProviderIcon-qwen.svg +9 -0
  209. package/Sources/Runic/Resources/ProviderIcon-sambanova.svg +4 -0
  210. package/Sources/Runic/Resources/ProviderIcon-together.svg +5 -0
  211. package/Sources/Runic/Resources/ProviderIcon-vertexai.svg +17 -0
  212. package/Sources/Runic/Resources/ProviderIcon-xai.svg +3 -0
  213. package/Sources/Runic/Resources/ProviderIcon-zai.svg +5 -0
  214. package/Sources/Runic/Resources/RunicMenubarIcon.svg +7 -0
  215. package/Sources/Runic/RunicApp.swift +357 -0
  216. package/Sources/Runic/SessionQuotaNotifications.swift +58 -0
  217. package/Sources/Runic/UsagePaceText.swift +52 -0
  218. package/Sources/Runic/UsageProgressBar.swift +224 -0
  219. package/Sources/Runic/Utilities/DisplayLink.swift +96 -0
  220. package/Sources/Runic/Utilities/LoadingPattern.swift +60 -0
  221. package/Sources/Runic/Utilities/PerformanceConstants.swift +85 -0
  222. package/Sources/Runic/Views/Menu/AlertsMenuView.swift +256 -0
  223. package/Sources/Runic/Views/Menu/ChartPanelStyle.swift +22 -0
  224. package/Sources/Runic/Views/Menu/CostComparativeChartMenuView.swift +275 -0
  225. package/Sources/Runic/Views/Menu/CostHistoryChartMenuView.swift +377 -0
  226. package/Sources/Runic/Views/Menu/CreditsHistoryChartMenuView.swift +312 -0
  227. package/Sources/Runic/Views/Menu/EfficiencyMetricsMenuView.swift +312 -0
  228. package/Sources/Runic/Views/Menu/HeroStatCardsMenuView.swift +228 -0
  229. package/Sources/Runic/Views/Menu/HourlyActivityChartMenuView.swift +228 -0
  230. package/Sources/Runic/Views/Menu/InlineUsageChartView.swift +162 -0
  231. package/Sources/Runic/Views/Menu/MenuCardEntranceModifier.swift +64 -0
  232. package/Sources/Runic/Views/Menu/MenuCardSidebarView.swift +268 -0
  233. package/Sources/Runic/Views/Menu/MenuCardSkeletonView.swift +104 -0
  234. package/Sources/Runic/Views/Menu/MenuCardView.swift +1900 -0
  235. package/Sources/Runic/Views/Menu/MenuContent.swift +150 -0
  236. package/Sources/Runic/Views/Menu/MenuDescriptor.swift +369 -0
  237. package/Sources/Runic/Views/Menu/MenuHighlightStyle.swift +42 -0
  238. package/Sources/Runic/Views/Menu/ModelBreakdownMenuView.swift +235 -0
  239. package/Sources/Runic/Views/Menu/OverviewMenuView.swift +141 -0
  240. package/Sources/Runic/Views/Menu/ProjectBreakdownMenuView.swift +209 -0
  241. package/Sources/Runic/Views/Menu/ProjectBudgetMenuView.swift +220 -0
  242. package/Sources/Runic/Views/Menu/ProviderTabBarView.swift +88 -0
  243. package/Sources/Runic/Views/Menu/SubscriptionUtilizationChartMenuView.swift +201 -0
  244. package/Sources/Runic/Views/Menu/UsageBreakdownChartMenuView.swift +398 -0
  245. package/Sources/Runic/Views/Menu/UsageHeatmapMenuView.swift +232 -0
  246. package/Sources/Runic/Views/Menu/UsageTimelineChartMenuView.swift +417 -0
  247. package/Sources/Runic/Views/Menu/UsageWindowComparisonChartMenuView.swift +190 -0
  248. package/Sources/Runic/Views/Menu/WeeklyActivityChartMenuView.swift +132 -0
  249. package/Sources/Runic/Views/Performance/PerformanceDashboardView.swift +618 -0
  250. package/Sources/Runic/Views/Preferences/LiquidComponents.swift +305 -0
  251. package/Sources/Runic/Views/Preferences/PreferencesAboutPane.swift +271 -0
  252. package/Sources/Runic/Views/Preferences/PreferencesAdvancedPane.swift +268 -0
  253. package/Sources/Runic/Views/Preferences/PreferencesAlertsPane.swift +422 -0
  254. package/Sources/Runic/Views/Preferences/PreferencesAnalyticsPane.swift +641 -0
  255. package/Sources/Runic/Views/Preferences/PreferencesBudgetsPane.swift +344 -0
  256. package/Sources/Runic/Views/Preferences/PreferencesComponents.swift +230 -0
  257. package/Sources/Runic/Views/Preferences/PreferencesCustomProvidersPane.swift +322 -0
  258. package/Sources/Runic/Views/Preferences/PreferencesDebugPane.swift +469 -0
  259. package/Sources/Runic/Views/Preferences/PreferencesGeneralPane.swift +231 -0
  260. package/Sources/Runic/Views/Preferences/PreferencesHelpPane.swift +50 -0
  261. package/Sources/Runic/Views/Preferences/PreferencesIntegrationsPane.swift +497 -0
  262. package/Sources/Runic/Views/Preferences/PreferencesPerformancePane.swift +288 -0
  263. package/Sources/Runic/Views/Preferences/PreferencesProvidersPane.swift +3435 -0
  264. package/Sources/Runic/Views/Preferences/PreferencesSelection.swift +25 -0
  265. package/Sources/Runic/Views/Preferences/PreferencesSyncPane.swift +59 -0
  266. package/Sources/Runic/Views/Preferences/PreferencesView.swift +206 -0
  267. package/Sources/Runic/Views/Rating/QualityRatingView.swift +238 -0
  268. package/Sources/Runic/Views/Team/TeamDashboardView.swift +371 -0
  269. package/Sources/Runic/Views/Team/TeamInviteSheet.swift +175 -0
  270. package/Sources/Runic/Views/Team/TeamManagementView.swift +761 -0
  271. package/Sources/Runic/Views/Team/TeamMemberRow.swift +181 -0
  272. package/Sources/RunicCLI/CLIEntry.swift +942 -0
  273. package/Sources/RunicCLI/CLIRenderer.swift +87 -0
  274. package/Sources/RunicCLI/Commands/EnhancedUsageCommand.swift +588 -0
  275. package/Sources/RunicCLI/Commands/ModelsCommand.swift +362 -0
  276. package/Sources/RunicCLI/Commands/ProjectsCommand.swift +439 -0
  277. package/Sources/RunicCLI/Commands/ResetCommand.swift +429 -0
  278. package/Sources/RunicCLI/Commands/UsageLedgerSourceFactory.swift +168 -0
  279. package/Sources/RunicClaudeWatchdog/main.swift +122 -0
  280. package/Sources/RunicClaudeWebProbe/main.swift +62 -0
  281. package/Sources/RunicCore/AlertRuleStore.swift +187 -0
  282. package/Sources/RunicCore/BrowserCookieImportOrder.swift +25 -0
  283. package/Sources/RunicCore/CopilotUsageModels.swift +84 -0
  284. package/Sources/RunicCore/CostUsageFetcher.swift +119 -0
  285. package/Sources/RunicCore/CostUsageModels.swift +479 -0
  286. package/Sources/RunicCore/CreditsModels.swift +50 -0
  287. package/Sources/RunicCore/CustomProviders/CustomProviderModels.swift +269 -0
  288. package/Sources/RunicCore/CustomProviders/GenericProviderFetcher.swift +622 -0
  289. package/Sources/RunicCore/CustomProviders/ProviderTemplates.swift +500 -0
  290. package/Sources/RunicCore/Host/PTY/TTYCommandRunner.swift +679 -0
  291. package/Sources/RunicCore/Host/Process/SubprocessRunner.swift +135 -0
  292. package/Sources/RunicCore/Integrations/GitHubIntegration.swift +173 -0
  293. package/Sources/RunicCore/Logging/JSONStderrLogHandler.swift +79 -0
  294. package/Sources/RunicCore/Logging/OSLogLogHandler.swift +86 -0
  295. package/Sources/RunicCore/Logging/RunicLog.swift +123 -0
  296. package/Sources/RunicCore/Models/EnhancedUsageModels.swift +371 -0
  297. package/Sources/RunicCore/OpenAIDashboardModels.swift +210 -0
  298. package/Sources/RunicCore/OpenAIWeb/OpenAIDashboardBrowserCookieImporter.swift +676 -0
  299. package/Sources/RunicCore/OpenAIWeb/OpenAIDashboardFetcher.swift +492 -0
  300. package/Sources/RunicCore/OpenAIWeb/OpenAIDashboardNavigationDelegate.swift +51 -0
  301. package/Sources/RunicCore/OpenAIWeb/OpenAIDashboardParser.swift +483 -0
  302. package/Sources/RunicCore/OpenAIWeb/OpenAIDashboardScrapeScript.swift +558 -0
  303. package/Sources/RunicCore/OpenAIWeb/OpenAIDashboardWebViewCache.swift +204 -0
  304. package/Sources/RunicCore/OpenAIWeb/OpenAIDashboardWebsiteDataStore.swift +78 -0
  305. package/Sources/RunicCore/PathEnvironment.swift +482 -0
  306. package/Sources/RunicCore/Performance/PerformanceModels.swift +371 -0
  307. package/Sources/RunicCore/Performance/PerformanceStorageImpl.swift +409 -0
  308. package/Sources/RunicCore/Policy/UsagePolicyEngine.swift +178 -0
  309. package/Sources/RunicCore/ProjectBudgetStore.swift +99 -0
  310. package/Sources/RunicCore/ProviderCostSnapshot.swift +29 -0
  311. package/Sources/RunicCore/Providers/Antigravity/AntigravityProviderDescriptor.swift +66 -0
  312. package/Sources/RunicCore/Providers/Antigravity/AntigravityStatusProbe.swift +685 -0
  313. package/Sources/RunicCore/Providers/Auggie/AuggieProviderDescriptor.swift +83 -0
  314. package/Sources/RunicCore/Providers/Auggie/AuggieUsageFetcher.swift +142 -0
  315. package/Sources/RunicCore/Providers/Azure/AzureProviderDescriptor.swift +141 -0
  316. package/Sources/RunicCore/Providers/Azure/AzureUsageFetcher.swift +186 -0
  317. package/Sources/RunicCore/Providers/Bedrock/BedrockProviderDescriptor.swift +126 -0
  318. package/Sources/RunicCore/Providers/Bedrock/BedrockUsageFetcher.swift +168 -0
  319. package/Sources/RunicCore/Providers/Cerebras/CerebrasProviderDescriptor.swift +84 -0
  320. package/Sources/RunicCore/Providers/Cerebras/CerebrasUsageFetcher.swift +75 -0
  321. package/Sources/RunicCore/Providers/Claude/ClaudeCLISession.swift +332 -0
  322. package/Sources/RunicCore/Providers/Claude/ClaudeOAuth/ClaudeOAuthCredentials.swift +180 -0
  323. package/Sources/RunicCore/Providers/Claude/ClaudeOAuth/ClaudeOAuthUsageFetcher.swift +137 -0
  324. package/Sources/RunicCore/Providers/Claude/ClaudeProviderDescriptor.swift +207 -0
  325. package/Sources/RunicCore/Providers/Claude/ClaudeStatusProbe.swift +654 -0
  326. package/Sources/RunicCore/Providers/Claude/ClaudeUsageDataSource.swift +28 -0
  327. package/Sources/RunicCore/Providers/Claude/ClaudeUsageFetcher.swift +480 -0
  328. package/Sources/RunicCore/Providers/Claude/ClaudeWeb/ClaudeWebAPIFetcher.swift +780 -0
  329. package/Sources/RunicCore/Providers/Codex/CodexOAuth/CodexOAuthCredentials.swift +146 -0
  330. package/Sources/RunicCore/Providers/Codex/CodexOAuth/CodexOAuthUsageFetcher.swift +269 -0
  331. package/Sources/RunicCore/Providers/Codex/CodexOAuth/CodexTokenRefresher.swift +100 -0
  332. package/Sources/RunicCore/Providers/Codex/CodexProviderDescriptor.swift +243 -0
  333. package/Sources/RunicCore/Providers/Codex/CodexStatusProbe.swift +125 -0
  334. package/Sources/RunicCore/Providers/Codex/CodexUsageDataSource.swift +24 -0
  335. package/Sources/RunicCore/Providers/Codex/CodexWebDashboardStrategy.swift +181 -0
  336. package/Sources/RunicCore/Providers/Cohere/CohereProviderDescriptor.swift +83 -0
  337. package/Sources/RunicCore/Providers/Cohere/CohereUsageFetcher.swift +85 -0
  338. package/Sources/RunicCore/Providers/Copilot/CopilotDeviceFlow.swift +123 -0
  339. package/Sources/RunicCore/Providers/Copilot/CopilotGitHubCLITokenReader.swift +114 -0
  340. package/Sources/RunicCore/Providers/Copilot/CopilotProviderDescriptor.swift +100 -0
  341. package/Sources/RunicCore/Providers/Copilot/CopilotUsageFetcher.swift +291 -0
  342. package/Sources/RunicCore/Providers/Copilot/CopilotVSCodeTokenReader.swift +386 -0
  343. package/Sources/RunicCore/Providers/Cursor/CursorProviderDescriptor.swift +65 -0
  344. package/Sources/RunicCore/Providers/Cursor/CursorStatusProbe.swift +594 -0
  345. package/Sources/RunicCore/Providers/DeepSeek/DeepSeekProviderDescriptor.swift +85 -0
  346. package/Sources/RunicCore/Providers/DeepSeek/DeepSeekUsageFetcher.swift +108 -0
  347. package/Sources/RunicCore/Providers/Factory/FactoryLocalStorageImporter.swift +398 -0
  348. package/Sources/RunicCore/Providers/Factory/FactoryProviderDescriptor.swift +65 -0
  349. package/Sources/RunicCore/Providers/Factory/FactoryStatusProbe.swift +1275 -0
  350. package/Sources/RunicCore/Providers/Fireworks/FireworksProviderDescriptor.swift +84 -0
  351. package/Sources/RunicCore/Providers/Fireworks/FireworksUsageFetcher.swift +75 -0
  352. package/Sources/RunicCore/Providers/Gemini/GeminiProviderDescriptor.swift +65 -0
  353. package/Sources/RunicCore/Providers/Gemini/GeminiStatusProbe.swift +835 -0
  354. package/Sources/RunicCore/Providers/Groq/GroqProviderDescriptor.swift +83 -0
  355. package/Sources/RunicCore/Providers/Groq/GroqUsageFetcher.swift +71 -0
  356. package/Sources/RunicCore/Providers/Kimi/KimiProviderDescriptor.swift +83 -0
  357. package/Sources/RunicCore/Providers/Kimi/KimiUsageFetcher.swift +77 -0
  358. package/Sources/RunicCore/Providers/MiniMax/MiniMaxProviderDescriptor.swift +92 -0
  359. package/Sources/RunicCore/Providers/MiniMax/MiniMaxSettingsReader.swift +54 -0
  360. package/Sources/RunicCore/Providers/MiniMax/MiniMaxUsageFetcher.swift +171 -0
  361. package/Sources/RunicCore/Providers/MiniMax/MiniMaxWebUsageFetcher.swift +911 -0
  362. package/Sources/RunicCore/Providers/Mistral/MistralProviderDescriptor.swift +84 -0
  363. package/Sources/RunicCore/Providers/Mistral/MistralUsageFetcher.swift +75 -0
  364. package/Sources/RunicCore/Providers/OpenRouter/OpenRouterProviderDescriptor.swift +87 -0
  365. package/Sources/RunicCore/Providers/OpenRouter/OpenRouterUsageFetcher.swift +207 -0
  366. package/Sources/RunicCore/Providers/Perplexity/PerplexityProviderDescriptor.swift +84 -0
  367. package/Sources/RunicCore/Providers/Perplexity/PerplexityUsageFetcher.swift +75 -0
  368. package/Sources/RunicCore/Providers/ProviderBranding.swift +25 -0
  369. package/Sources/RunicCore/Providers/ProviderCLIConfig.swift +17 -0
  370. package/Sources/RunicCore/Providers/ProviderDescriptor.swift +129 -0
  371. package/Sources/RunicCore/Providers/ProviderFetchPlan.swift +263 -0
  372. package/Sources/RunicCore/Providers/ProviderSettingsSnapshot.swift +98 -0
  373. package/Sources/RunicCore/Providers/ProviderTokenResolver.swift +501 -0
  374. package/Sources/RunicCore/Providers/ProviderVersionDetector.swift +68 -0
  375. package/Sources/RunicCore/Providers/Providers.swift +184 -0
  376. package/Sources/RunicCore/Providers/Qwen/QwenProviderDescriptor.swift +84 -0
  377. package/Sources/RunicCore/Providers/Qwen/QwenSettingsReader.swift +30 -0
  378. package/Sources/RunicCore/Providers/Qwen/QwenUsageStats.swift +317 -0
  379. package/Sources/RunicCore/Providers/SambaNova/SambaNovaProviderDescriptor.swift +84 -0
  380. package/Sources/RunicCore/Providers/SambaNova/SambaNovaUsageFetcher.swift +75 -0
  381. package/Sources/RunicCore/Providers/Together/TogetherProviderDescriptor.swift +83 -0
  382. package/Sources/RunicCore/Providers/Together/TogetherUsageFetcher.swift +75 -0
  383. package/Sources/RunicCore/Providers/VertexAI/VertexAIProviderDescriptor.swift +123 -0
  384. package/Sources/RunicCore/Providers/VertexAI/VertexAISettingsReader.swift +48 -0
  385. package/Sources/RunicCore/Providers/VertexAI/VertexAIUsageFetcher.swift +144 -0
  386. package/Sources/RunicCore/Providers/XAI/XAIProviderDescriptor.swift +83 -0
  387. package/Sources/RunicCore/Providers/XAI/XAIUsageFetcher.swift +75 -0
  388. package/Sources/RunicCore/Providers/Zai/ZaiProviderDescriptor.swift +72 -0
  389. package/Sources/RunicCore/Providers/Zai/ZaiSettingsReader.swift +41 -0
  390. package/Sources/RunicCore/Providers/Zai/ZaiUsageStats.swift +724 -0
  391. package/Sources/RunicCore/Sync/BackgroundSyncManager.swift +385 -0
  392. package/Sources/RunicCore/Sync/SyncConflictResolver.swift +310 -0
  393. package/Sources/RunicCore/Sync/SyncProtocol.swift +288 -0
  394. package/Sources/RunicCore/Sync/SyncRecord.swift +405 -0
  395. package/Sources/RunicCore/Sync/SyncUsageExample.swift +294 -0
  396. package/Sources/RunicCore/Sync/TeamSyncRecords.swift +775 -0
  397. package/Sources/RunicCore/Sync/iCloudSyncEngine.swift +333 -0
  398. package/Sources/RunicCore/Team/TeamModels.swift +583 -0
  399. package/Sources/RunicCore/Team/TeamShowbackExporter.swift +495 -0
  400. package/Sources/RunicCore/Team/TeamStore.swift +792 -0
  401. package/Sources/RunicCore/TextParsing.swift +55 -0
  402. package/Sources/RunicCore/UsageFetcher.swift +694 -0
  403. package/Sources/RunicCore/UsageFormatter.swift +410 -0
  404. package/Sources/RunicCore/UsageLedger/ClaudeUsageLogSource.swift +329 -0
  405. package/Sources/RunicCore/UsageLedger/CodexUsageLogSource.swift +448 -0
  406. package/Sources/RunicCore/UsageLedger/OTelGenAILedgerAdapter.swift +550 -0
  407. package/Sources/RunicCore/UsageLedger/UsageLedger.swift +29 -0
  408. package/Sources/RunicCore/UsageLedger/UsageLedgerAggregator.swift +660 -0
  409. package/Sources/RunicCore/UsageLedger/UsageLedgerInsightsAdvisor.swift +209 -0
  410. package/Sources/RunicCore/UsageLedger/UsageLedgerModels.swift +417 -0
  411. package/Sources/RunicCore/UsageLedger/UsageLedgerProjectIdentity.swift +245 -0
  412. package/Sources/RunicCore/UsagePace.swift +81 -0
  413. package/Sources/RunicCore/Vendored/CostUsage/CostUsageCache.swift +73 -0
  414. package/Sources/RunicCore/Vendored/CostUsage/CostUsageJsonl.swift +74 -0
  415. package/Sources/RunicCore/Vendored/CostUsage/CostUsagePricing.swift +208 -0
  416. package/Sources/RunicCore/Vendored/CostUsage/CostUsageScanner+Claude.swift +455 -0
  417. package/Sources/RunicCore/Vendored/CostUsage/CostUsageScanner+Timestamp.swift +132 -0
  418. package/Sources/RunicCore/Vendored/CostUsage/CostUsageScanner.swift +589 -0
  419. package/Sources/RunicCore/WidgetSnapshot.swift +183 -0
  420. package/Sources/RunicMacroSupport/ProviderRegistrationMacros.swift +14 -0
  421. package/Sources/RunicMacros/ProviderRegistrationMacros.swift +216 -0
  422. package/Sources/RunicWidget/RunicWidgetBundle.swift +79 -0
  423. package/Sources/RunicWidget/RunicWidgetProvider.swift +283 -0
  424. package/Sources/RunicWidget/RunicWidgetViews.swift +680 -0
  425. package/Tests/RunicTests/AntigravityStatusProbeTests.swift +50 -0
  426. package/Tests/RunicTests/AppDelegateTests.swift +43 -0
  427. package/Tests/RunicTests/BrowserCookieOrderLabelTests.swift +22 -0
  428. package/Tests/RunicTests/CLIArgumentParsingTests.swift +70 -0
  429. package/Tests/RunicTests/CLICostTests.swift +65 -0
  430. package/Tests/RunicTests/CLIProviderSelectionTests.swift +22 -0
  431. package/Tests/RunicTests/CLISnapshotTests.swift +72 -0
  432. package/Tests/RunicTests/CLIWebFallbackTests.swift +58 -0
  433. package/Tests/RunicTests/ClaudeOAuthTests.swift +164 -0
  434. package/Tests/RunicTests/ClaudeResilienceTests.swift +30 -0
  435. package/Tests/RunicTests/ClaudeUsageTests.swift +370 -0
  436. package/Tests/RunicTests/CodexOAuthTests.swift +122 -0
  437. package/Tests/RunicTests/CodexUsageLogSourceTests.swift +82 -0
  438. package/Tests/RunicTests/CopilotTokenResolverTests.swift +75 -0
  439. package/Tests/RunicTests/CopilotVSCodeTokenReaderTests.swift +75 -0
  440. package/Tests/RunicTests/CostUsageDecodingTests.swift +394 -0
  441. package/Tests/RunicTests/CostUsagePricingTests.swift +50 -0
  442. package/Tests/RunicTests/CostUsageScannerTests.swift +700 -0
  443. package/Tests/RunicTests/CursorStatusProbeTests.swift +323 -0
  444. package/Tests/RunicTests/FactoryStatusProbeTests.swift +69 -0
  445. package/Tests/RunicTests/GeminiAPITestHelpers.swift +94 -0
  446. package/Tests/RunicTests/GeminiLoginAlertTests.swift +28 -0
  447. package/Tests/RunicTests/GeminiStatusProbeAPITests.swift +283 -0
  448. package/Tests/RunicTests/GeminiStatusProbePlanTests.swift +279 -0
  449. package/Tests/RunicTests/GeminiStatusProbeTests.swift +233 -0
  450. package/Tests/RunicTests/GeminiTestEnvironment.swift +87 -0
  451. package/Tests/RunicTests/GoogleWorkspaceStatusTests.swift +73 -0
  452. package/Tests/RunicTests/InstallOriginTests.swift +18 -0
  453. package/Tests/RunicTests/KeyboardShortcutsBundleTests.swift +9 -0
  454. package/Tests/RunicTests/LiveAccountTests.swift +24 -0
  455. package/Tests/RunicTests/LoadingPatternTests.swift +35 -0
  456. package/Tests/RunicTests/MenuCardModelTests.swift +545 -0
  457. package/Tests/RunicTests/MiniMaxCookieHeaderStoreTestSupport.swift +8 -0
  458. package/Tests/RunicTests/MiniMaxGroupIDStoreTestSupport.swift +8 -0
  459. package/Tests/RunicTests/MiniMaxParsingTests.swift +68 -0
  460. package/Tests/RunicTests/MiniMaxTokenStoreTestSupport.swift +8 -0
  461. package/Tests/RunicTests/OTelGenAILedgerAdapterTests.swift +112 -0
  462. package/Tests/RunicTests/OpenAIDashboardBrowserCookieImporterTests.swift +17 -0
  463. package/Tests/RunicTests/OpenAIDashboardFetcherCreditsWaitTests.swift +75 -0
  464. package/Tests/RunicTests/OpenAIDashboardOffscreenHostTests.swift +27 -0
  465. package/Tests/RunicTests/OpenAIDashboardParserTests.swift +134 -0
  466. package/Tests/RunicTests/OpenAIWebAccountSwitchTests.swift +53 -0
  467. package/Tests/RunicTests/OpenRouterTokenStoreTestSupport.swift +92 -0
  468. package/Tests/RunicTests/PathBuilderTests.swift +237 -0
  469. package/Tests/RunicTests/ProviderFetchPipelineTests.swift +160 -0
  470. package/Tests/RunicTests/ProviderIconResourcesTests.swift +38 -0
  471. package/Tests/RunicTests/ProviderMetadataStatusLinkTests.swift +16 -0
  472. package/Tests/RunicTests/ProviderRegistryTests.swift +29 -0
  473. package/Tests/RunicTests/ProviderSettingsDescriptorTests.swift +202 -0
  474. package/Tests/RunicTests/ProviderToggleStoreTests.swift +51 -0
  475. package/Tests/RunicTests/RunicTests.swift +120 -0
  476. package/Tests/RunicTests/SessionQuotaNotificationLogicTests.swift +36 -0
  477. package/Tests/RunicTests/SettingsStoreTests.swift +161 -0
  478. package/Tests/RunicTests/StatusItemAnimationTests.swift +49 -0
  479. package/Tests/RunicTests/StatusMenuTests.swift +434 -0
  480. package/Tests/RunicTests/StatusProbeTests.swift +377 -0
  481. package/Tests/RunicTests/SubprocessRunnerTests.swift +20 -0
  482. package/Tests/RunicTests/SubscriptionDetectionTests.swift +65 -0
  483. package/Tests/RunicTests/TTYCommandRunnerTests.swift +148 -0
  484. package/Tests/RunicTests/TTYIntegrationTests.swift +41 -0
  485. package/Tests/RunicTests/TeamShowbackExporterTests.swift +159 -0
  486. package/Tests/RunicTests/TextParsingTests.swift +12 -0
  487. package/Tests/RunicTests/UsageFormatterTests.swift +112 -0
  488. package/Tests/RunicTests/UsageLedgerAnomalyDetectionTests.swift +172 -0
  489. package/Tests/RunicTests/UsageLedgerForecastTests.swift +213 -0
  490. package/Tests/RunicTests/UsageLedgerInsightsAdvisorTests.swift +83 -0
  491. package/Tests/RunicTests/UsageLedgerProjectNameTests.swift +170 -0
  492. package/Tests/RunicTests/UsagePaceTests.swift +77 -0
  493. package/Tests/RunicTests/UsagePaceTextTests.swift +109 -0
  494. package/Tests/RunicTests/UsagePolicyEngineTests.swift +91 -0
  495. package/Tests/RunicTests/WidgetSnapshotTests.swift +45 -0
  496. package/Tests/RunicTests/ZaiProviderTests.swift +61 -0
  497. package/Tests/RunicTests/ZaiTokenStoreTestSupport.swift +6 -0
  498. package/TestsLinux/PlatformGatingTests.swift +46 -0
  499. package/appcast.xml +105 -0
  500. package/assets/logo-concept-stack.svg +24 -0
  501. package/assets/logo-minimal-bars.svg +15 -0
  502. package/assets/logo.svg +20 -0
  503. package/assets/logo2.svg +43 -0
  504. package/bin/docs-list +5 -0
  505. package/bin/install-runic-cli.sh +32 -0
  506. package/build-and-run.sh +369 -0
  507. package/docs/.nojekyll +1 -0
  508. package/docs/CNAME +1 -0
  509. package/docs/antigravity.md +75 -0
  510. package/docs/architecture.md +32 -0
  511. package/docs/claude.md +93 -0
  512. package/docs/cli-commands/integration_guide.md +371 -0
  513. package/docs/cli-commands/quick_reference.md +362 -0
  514. package/docs/cli-commands/readme.md +361 -0
  515. package/docs/cli.md +156 -0
  516. package/docs/cloudkit_sync_guide.md +495 -0
  517. package/docs/codebase_review.md +288 -0
  518. package/docs/codex-oauth.md +635 -0
  519. package/docs/codex.md +104 -0
  520. package/docs/codexbar.png +0 -0
  521. package/docs/copilot.md +44 -0
  522. package/docs/cursor.md +46 -0
  523. package/docs/design/designcomparisonchart.md +510 -0
  524. package/docs/design/implementationguide.md +792 -0
  525. package/docs/design/menubaricondesignconcepts.md +796 -0
  526. package/docs/design/mockups/hybridiconconcept.svg +62 -0
  527. package/docs/design/mockups/infinityiconconcept.svg +41 -0
  528. package/docs/design/mockups/infinityiconstates.svg +129 -0
  529. package/docs/design/mockups/wavelogorefined.svg +48 -0
  530. package/docs/design/quick_summary.md +426 -0
  531. package/docs/design/readme.md +478 -0
  532. package/docs/design/sizespecifications.md +575 -0
  533. package/docs/design-system.md +836 -0
  534. package/docs/factory.md +103 -0
  535. package/docs/gemini.md +73 -0
  536. package/docs/icon.md +37 -0
  537. package/docs/icon.png +0 -0
  538. package/docs/index.html +175 -0
  539. package/docs/keychain_fix.md +274 -0
  540. package/docs/minimax.md +71 -0
  541. package/docs/packaging.md +25 -0
  542. package/docs/progress-bar-improvements.md +240 -0
  543. package/docs/progress-bar-quick-reference.md +283 -0
  544. package/docs/progress-bar-technical-details.md +432 -0
  545. package/docs/progress-bar-visual-test.swift +375 -0
  546. package/docs/provider.md +202 -0
  547. package/docs/providers.md +86 -0
  548. package/docs/refactor/macros.md +35 -0
  549. package/docs/refresh-loop.md +22 -0
  550. package/docs/releasing-homebrew.md +35 -0
  551. package/docs/releasing.md +121 -0
  552. package/docs/research/concrete_todo_2026-02-22.md +47 -0
  553. package/docs/research/core-feature-research.md +248 -0
  554. package/docs/research/feature_uiux_roadmap_2026-02-22.md +202 -0
  555. package/docs/research/parity_matrix.md +49 -0
  556. package/docs/research/provider_expansion_candidates_2026-02-22.md +80 -0
  557. package/docs/research/provider_model_token_project_matrix_2026-02-23.md +46 -0
  558. package/docs/research/release_gate_checklist.md +57 -0
  559. package/docs/site.css +505 -0
  560. package/docs/sparkle.md +28 -0
  561. package/docs/status.md +28 -0
  562. package/docs/sync/implementation.md +393 -0
  563. package/docs/sync/readme.md +317 -0
  564. package/docs/sync_files_summary.md +391 -0
  565. package/docs/sync_quick_reference.md +225 -0
  566. package/docs/todo.md +11 -0
  567. package/docs/ui.md +29 -0
  568. package/docs/web-integration.md +9 -0
  569. package/docs/widgets.md +85 -0
  570. package/docs/workflows/error-handling-improvements.md +434 -0
  571. package/docs/workflows/folder_structure.md +299 -0
  572. package/docs/workflows/loading_states.md +446 -0
  573. package/docs/workflows/loading_states_examples.md +565 -0
  574. package/docs/workflows/loading_states_flow.md +430 -0
  575. package/docs/workflows/performance_optimizations.md +457 -0
  576. package/docs/workflows/phase1-cli-testing-report.md +313 -0
  577. package/docs/workflows/quick_reference.md +228 -0
  578. package/docs/workflows/readme.md +59 -0
  579. package/docs/workflows/recent_improvements.md +275 -0
  580. package/docs/workflows/sync_enablement_summary.md +400 -0
  581. package/docs/zai.md +43 -0
  582. package/package.json +36 -0
  583. package/runic.png +0 -0
  584. package/version.env +2 -0
@@ -0,0 +1,305 @@
1
+ import AppKit
2
+ import SwiftUI
3
+
4
+ // MARK: - Ambient liquid mesh
5
+
6
+ @MainActor
7
+ struct LiquidMeshBackground: View {
8
+ @State private var phase: Double = 0
9
+ @Environment(\.accessibilityReduceMotion) private var reduceMotion
10
+
11
+ private static let palette: [Color] = [
12
+ Color(red: 0.30, green: 0.52, blue: 0.96),
13
+ Color(red: 0.62, green: 0.34, blue: 0.92),
14
+ Color(red: 0.24, green: 0.78, blue: 0.76),
15
+ Color(red: 0.44, green: 0.28, blue: 0.88),
16
+ Color(red: 0.18, green: 0.60, blue: 0.94),
17
+ ]
18
+
19
+ var body: some View {
20
+ TimelineView(.animation(minimumInterval: 1 / 30.0, paused: self.reduceMotion)) { timeline in
21
+ Canvas { context, size in
22
+ let t = self.reduceMotion ? 0 : timeline.date.timeIntervalSinceReferenceDate
23
+ let cx = size.width / 2
24
+ let cy = size.height / 2
25
+
26
+ for (i, color) in Self.palette.enumerated() {
27
+ let fi = Double(i)
28
+ let angle = t * (0.12 + fi * 0.03) + fi * 1.25
29
+ let r = min(cx, cy) * (0.28 + 0.18 * sin(t * 0.15 + fi * 0.9))
30
+ let x = cx + cos(angle) * r * 0.6
31
+ let y = cy + sin(angle) * r * 0.5
32
+ let blob = min(size.width, size.height) * (0.52 + 0.12 * sin(t * 0.2 + fi))
33
+
34
+ let rect = CGRect(x: x - blob / 2, y: y - blob / 2, width: blob, height: blob)
35
+ context.fill(
36
+ Ellipse().path(in: rect),
37
+ with: .radialGradient(
38
+ Gradient(colors: [color.opacity(0.35), color.opacity(0.08), color.opacity(0)]),
39
+ center: CGPoint(x: x, y: y),
40
+ startRadius: 0,
41
+ endRadius: blob / 2))
42
+ }
43
+ }
44
+ .blur(radius: 40)
45
+ }
46
+ }
47
+ }
48
+
49
+ // MARK: - Cursor spotlight overlay
50
+
51
+ @MainActor
52
+ private struct CursorSpotlight: View {
53
+ let cursorPoint: UnitPoint
54
+ let isActive: Bool
55
+
56
+ var body: some View {
57
+ GeometryReader { geo in
58
+ RadialGradient(
59
+ colors: [
60
+ Color.primary.opacity(self.isActive ? 0.10 : 0),
61
+ Color.primary.opacity(self.isActive ? 0.04 : 0),
62
+ Color.clear,
63
+ ],
64
+ center: UnitPoint(
65
+ x: geo.size.width > 0 ? max(0, min(1, self.cursorPoint.x)) : 0.5,
66
+ y: geo.size.height > 0 ? max(0, min(1, self.cursorPoint.y)) : 0.5),
67
+ startRadius: 0,
68
+ endRadius: 160)
69
+ .animation(.easeOut(duration: 0.15), value: self.isActive)
70
+ }
71
+ .allowsHitTesting(false)
72
+ .accessibilityHidden(true)
73
+ }
74
+ }
75
+
76
+ // MARK: - Shimmer sweep overlay
77
+
78
+ @MainActor
79
+ private struct ShimmerSweep: View {
80
+ @State private var offset: CGFloat = -0.4
81
+ @Environment(\.accessibilityReduceMotion) private var reduceMotion
82
+ let stableDelay: Double
83
+
84
+ var body: some View {
85
+ GeometryReader { geo in
86
+ if !self.reduceMotion {
87
+ LinearGradient(
88
+ colors: [.clear, Color.primary.opacity(0.04), Color.primary.opacity(0.07), Color.primary.opacity(0.04), .clear],
89
+ startPoint: .leading,
90
+ endPoint: .trailing)
91
+ .frame(width: geo.size.width * 0.35)
92
+ .offset(x: geo.size.width * self.offset)
93
+ }
94
+ }
95
+ .clipped()
96
+ .allowsHitTesting(false)
97
+ .accessibilityHidden(true)
98
+ .onAppear {
99
+ guard !self.reduceMotion else { return }
100
+ withAnimation(
101
+ .easeInOut(duration: 2.8)
102
+ .repeatForever(autoreverses: false)
103
+ .delay(self.stableDelay))
104
+ {
105
+ self.offset = 1.4
106
+ }
107
+ }
108
+ }
109
+ }
110
+
111
+ // MARK: - Rotating gradient border (Magic Card)
112
+
113
+ @MainActor
114
+ private struct RotatingGradientBorder: View {
115
+ let cornerRadius: CGFloat
116
+ let isActive: Bool
117
+ @Environment(\.accessibilityReduceMotion) private var reduceMotion
118
+
119
+ private static let borderColors: [Color] = [
120
+ Color(red: 0.36, green: 0.86, blue: 1.0),
121
+ Color(red: 0.24, green: 0.40, blue: 0.89),
122
+ Color(red: 0.31, green: 0.00, blue: 0.76),
123
+ Color(red: 0.24, green: 0.40, blue: 0.89),
124
+ Color(red: 0.36, green: 0.86, blue: 1.0),
125
+ ]
126
+
127
+ var body: some View {
128
+ if self.isActive && !self.reduceMotion {
129
+ TimelineView(.animation(minimumInterval: 1 / 60.0, paused: !self.isActive)) { timeline in
130
+ let rotation = timeline.date.timeIntervalSinceReferenceDate * 72
131
+ RoundedRectangle(cornerRadius: self.cornerRadius, style: .continuous)
132
+ .strokeBorder(
133
+ AngularGradient(
134
+ gradient: Gradient(colors: Self.borderColors),
135
+ center: .center,
136
+ angle: .degrees(rotation)),
137
+ lineWidth: 1.5)
138
+ .opacity(0.7)
139
+ }
140
+ .transition(.opacity.animation(.easeInOut(duration: 0.35)))
141
+ }
142
+ }
143
+ }
144
+
145
+ // MARK: - Shared glass modifier (single source of truth)
146
+
147
+ @MainActor
148
+ private struct LiquidGlassCore: ViewModifier {
149
+ let shimmerIndex: Int
150
+ @State private var hovering = false
151
+ @State private var cursorUnit: UnitPoint = .center
152
+ @Environment(\.accessibilityReduceMotion) private var reduceMotion
153
+
154
+ func body(content: Content) -> some View {
155
+ content
156
+ .padding(RunicSpacing.md)
157
+ .frame(maxWidth: .infinity, alignment: .leading)
158
+ .background(
159
+ RoundedRectangle(cornerRadius: RunicCornerRadius.lg, style: .continuous)
160
+ .fill(.ultraThinMaterial)
161
+ .shadow(
162
+ color: self.hovering ? Color.accentColor.opacity(0.12) : .black.opacity(0.04),
163
+ radius: self.hovering ? 12 : 4,
164
+ y: self.hovering ? 4 : 2))
165
+ .overlay(
166
+ RoundedRectangle(cornerRadius: RunicCornerRadius.lg, style: .continuous)
167
+ .strokeBorder(
168
+ LinearGradient(
169
+ colors: [
170
+ Color.primary.opacity(self.hovering ? 0.18 : 0.10),
171
+ Color.primary.opacity(self.hovering ? 0.06 : 0.03),
172
+ ],
173
+ startPoint: .topLeading,
174
+ endPoint: .bottomTrailing),
175
+ lineWidth: 0.5))
176
+ .overlay { RotatingGradientBorder(cornerRadius: RunicCornerRadius.lg, isActive: self.hovering) }
177
+ .overlay {
178
+ GeometryReader { geo in
179
+ CursorSpotlight(
180
+ cursorPoint: UnitPoint(
181
+ x: geo.size.width > 0 ? self.cursorUnit.x / geo.size.width : 0.5,
182
+ y: geo.size.height > 0 ? self.cursorUnit.y / geo.size.height : 0.5),
183
+ isActive: self.hovering)
184
+ }
185
+ }
186
+ .clipShape(RoundedRectangle(cornerRadius: RunicCornerRadius.lg, style: .continuous))
187
+ .overlay {
188
+ ShimmerSweep(stableDelay: Double(self.shimmerIndex) * 0.8 + 1.0)
189
+ .clipShape(RoundedRectangle(cornerRadius: RunicCornerRadius.lg, style: .continuous))
190
+ }
191
+ .scaleEffect(self.hovering && !self.reduceMotion ? 1.01 : 1.0)
192
+ .animation(.spring(response: 0.35, dampingFraction: 0.72), value: self.hovering)
193
+ .background(
194
+ GeometryReader { geo in
195
+ Color.clear
196
+ .onContinuousHover { phase in
197
+ switch phase {
198
+ case .active(let pt):
199
+ self.hovering = true
200
+ self.cursorUnit = UnitPoint(x: pt.x, y: pt.y)
201
+ case .ended:
202
+ self.hovering = false
203
+ }
204
+ }
205
+ .frame(width: geo.size.width, height: geo.size.height)
206
+ }
207
+ )
208
+ }
209
+ }
210
+
211
+ // MARK: - Public components using the shared core
212
+
213
+ @MainActor
214
+ struct LiquidSection<Content: View>: View {
215
+ let title: String?
216
+ let content: Content
217
+
218
+ init(title: String? = nil, @ViewBuilder content: () -> Content) {
219
+ self.title = title
220
+ self.content = content()
221
+ }
222
+
223
+ var body: some View {
224
+ VStack(alignment: .leading, spacing: RunicSpacing.sm) {
225
+ if let title {
226
+ Text(title)
227
+ .font(.system(.caption, design: .rounded).weight(.semibold))
228
+ .foregroundStyle(.secondary)
229
+ .textCase(.uppercase)
230
+ .padding(.leading, RunicSpacing.xxs)
231
+ }
232
+ self.content
233
+ }
234
+ .modifier(LiquidGlassCore(shimmerIndex: self.title.hashValue & 0xF))
235
+ }
236
+ }
237
+
238
+ @MainActor
239
+ struct GlassCard<Content: View>: View {
240
+ let content: Content
241
+
242
+ init(@ViewBuilder content: () -> Content) {
243
+ self.content = content()
244
+ }
245
+
246
+ var body: some View {
247
+ self.content
248
+ .modifier(LiquidGlassCore(shimmerIndex: 0))
249
+ }
250
+ }
251
+
252
+ // MARK: - View modifiers
253
+
254
+ extension View {
255
+ func liquidGlass() -> some View {
256
+ modifier(LiquidGlassCore(shimmerIndex: 3))
257
+ }
258
+
259
+ func liquidEntrance(appeared: Bool, index: Int) -> some View {
260
+ self
261
+ .opacity(appeared ? 1 : 0)
262
+ .offset(y: appeared ? 0 : 14)
263
+ .scaleEffect(appeared ? 1 : 0.97, anchor: .top)
264
+ .animation(
265
+ .spring(response: 0.5, dampingFraction: 0.78)
266
+ .delay(Double(index) * 0.07),
267
+ value: appeared)
268
+ }
269
+ }
270
+
271
+ // MARK: - Liquid preferences pane wrapper
272
+
273
+ @MainActor
274
+ struct LiquidPreferencesPane<Content: View>: View {
275
+ let meshOpacity: Double
276
+ let showsIndicators: Bool
277
+ private let content: () -> Content
278
+
279
+ init(
280
+ meshOpacity: Double = 0.3,
281
+ showsIndicators: Bool = true,
282
+ @ViewBuilder content: @escaping () -> Content)
283
+ {
284
+ self.meshOpacity = meshOpacity
285
+ self.showsIndicators = showsIndicators
286
+ self.content = content
287
+ }
288
+
289
+ var body: some View {
290
+ ZStack {
291
+ LiquidMeshBackground()
292
+ .ignoresSafeArea()
293
+ .opacity(self.meshOpacity)
294
+
295
+ ScrollView(.vertical, showsIndicators: self.showsIndicators) {
296
+ VStack(alignment: .leading, spacing: RunicSpacing.md) {
297
+ self.content()
298
+ }
299
+ .frame(maxWidth: .infinity, alignment: .leading)
300
+ .padding(.horizontal, PreferencesLayoutMetrics.paneHorizontal)
301
+ .padding(.vertical, PreferencesLayoutMetrics.paneVertical)
302
+ }
303
+ }
304
+ }
305
+ }
@@ -0,0 +1,271 @@
1
+ import AppKit
2
+ import SwiftUI
3
+
4
+ // MARK: - Floating orb accent (About-specific)
5
+
6
+ @MainActor
7
+ private struct FloatingOrb: View {
8
+ let color: Color
9
+ let size: CGFloat
10
+ let speed: Double
11
+ let offset: Double
12
+ @State private var phase: Double = 0
13
+ private let timer = Timer.publish(every: 1 / 24.0, on: .main, in: .common).autoconnect()
14
+
15
+ var body: some View {
16
+ Circle()
17
+ .fill(
18
+ RadialGradient(
19
+ colors: [self.color.opacity(0.5), self.color.opacity(0)],
20
+ center: .center,
21
+ startRadius: 0,
22
+ endRadius: self.size / 2))
23
+ .frame(width: self.size, height: self.size)
24
+ .offset(
25
+ x: sin(self.phase * self.speed + self.offset) * 20,
26
+ y: cos(self.phase * self.speed * 0.7 + self.offset) * 14)
27
+ .onReceive(self.timer) { _ in self.phase += 1 / 24.0 }
28
+ }
29
+ }
30
+
31
+ // MARK: - Liquid link button (About-specific)
32
+
33
+ @MainActor
34
+ private struct LiquidLinkButton: View {
35
+ let icon: String
36
+ let title: String
37
+ let url: String
38
+ @State private var hovering = false
39
+
40
+ var body: some View {
41
+ Button {
42
+ if let url = URL(string: self.url) { NSWorkspace.shared.open(url) }
43
+ } label: {
44
+ HStack(spacing: RunicSpacing.xs) {
45
+ Image(systemName: self.icon)
46
+ .font(.system(size: 12, weight: .medium))
47
+ .frame(width: 18)
48
+ Text(self.title)
49
+ .font(.system(size: 12.5, weight: .medium))
50
+ }
51
+ .foregroundStyle(self.hovering ? .primary : .secondary)
52
+ .padding(.horizontal, RunicSpacing.sm)
53
+ .padding(.vertical, RunicSpacing.compact)
54
+ .background(
55
+ Capsule(style: .continuous)
56
+ .fill(.ultraThinMaterial)
57
+ .opacity(self.hovering ? 1 : 0))
58
+ .overlay(
59
+ Capsule(style: .continuous)
60
+ .strokeBorder(
61
+ Color.white.opacity(self.hovering ? 0.18 : 0),
62
+ lineWidth: 0.5))
63
+ }
64
+ .buttonStyle(.plain)
65
+ .contentShape(Capsule())
66
+ .onHover { over in
67
+ withAnimation(.easeOut(duration: 0.18)) { self.hovering = over }
68
+ }
69
+ .scaleEffect(self.hovering ? 1.04 : 1.0)
70
+ .animation(.spring(response: 0.28, dampingFraction: 0.75), value: self.hovering)
71
+ }
72
+ }
73
+
74
+ // MARK: - About pane
75
+
76
+ @MainActor
77
+ struct AboutPane: View {
78
+ let updater: UpdaterProviding
79
+ @State private var iconHover = false
80
+ @State private var appeared = false
81
+ @AppStorage("autoUpdateEnabled") private var autoUpdateEnabled: Bool = true
82
+ @State private var didLoadUpdaterState = false
83
+
84
+ private var versionString: String {
85
+ let version = Bundle.main.object(forInfoDictionaryKey: "CFBundleShortVersionString") as? String ?? "–"
86
+ let build = Bundle.main.object(forInfoDictionaryKey: "CFBundleVersion") as? String
87
+ return build.map { "\(version) (\($0))" } ?? version
88
+ }
89
+
90
+ private var buildTimestamp: String? {
91
+ guard let raw = Bundle.main.object(forInfoDictionaryKey: "CodexBuildTimestamp") as? String else { return nil }
92
+ let parser = ISO8601DateFormatter()
93
+ parser.formatOptions = [.withInternetDateTime]
94
+ guard let date = parser.date(from: raw) else { return raw }
95
+
96
+ let formatter = DateFormatter()
97
+ formatter.dateStyle = .medium
98
+ formatter.timeStyle = .short
99
+ formatter.locale = .current
100
+ return formatter.string(from: date)
101
+ }
102
+
103
+ var body: some View {
104
+ ZStack {
105
+ LiquidMeshBackground()
106
+ .ignoresSafeArea()
107
+ .opacity(0.6)
108
+
109
+ ScrollView(.vertical, showsIndicators: false) {
110
+ VStack(spacing: RunicSpacing.lg) {
111
+ self.heroSection
112
+ self.linksSection
113
+ self.updaterSection
114
+ self.footerSection
115
+ }
116
+ .padding(.horizontal, PreferencesLayoutMetrics.paneHorizontal)
117
+ .padding(.vertical, PreferencesLayoutMetrics.paneVertical)
118
+ }
119
+ }
120
+ .onAppear {
121
+ guard !self.didLoadUpdaterState else { return }
122
+ self.updater.automaticallyChecksForUpdates = self.autoUpdateEnabled
123
+ self.updater.automaticallyDownloadsUpdates = self.autoUpdateEnabled
124
+ self.didLoadUpdaterState = true
125
+ withAnimation(.easeOut(duration: 0.8)) { self.appeared = true }
126
+ }
127
+ .onChange(of: self.autoUpdateEnabled) { _, newValue in
128
+ self.updater.automaticallyChecksForUpdates = newValue
129
+ self.updater.automaticallyDownloadsUpdates = newValue
130
+ }
131
+ }
132
+
133
+ // MARK: - Hero
134
+
135
+ private var heroSection: some View {
136
+ VStack(spacing: RunicSpacing.md) {
137
+ ZStack {
138
+ FloatingOrb(color: .blue, size: 120, speed: 0.4, offset: 0)
139
+ .offset(x: -30, y: -10)
140
+ FloatingOrb(color: .purple, size: 90, speed: 0.5, offset: 2.1)
141
+ .offset(x: 25, y: 15)
142
+
143
+ if let image = NSApplication.shared.applicationIconImage {
144
+ Button(action: self.openProjectHome) {
145
+ Image(nsImage: image)
146
+ .resizable()
147
+ .frame(width: 96, height: 96)
148
+ .clipShape(RoundedRectangle(cornerRadius: RunicCornerRadius.xl, style: .continuous))
149
+ .shadow(
150
+ color: .black.opacity(0.18),
151
+ radius: self.iconHover ? 16 : 8,
152
+ y: self.iconHover ? 6 : 3)
153
+ .scaleEffect(self.iconHover ? 1.06 : 1.0)
154
+ }
155
+ .buttonStyle(.plain)
156
+ .accessibilityLabel("Open Runic project on GitHub")
157
+ .onHover { hovering in
158
+ withAnimation(.spring(response: 0.32, dampingFraction: 0.72)) {
159
+ self.iconHover = hovering
160
+ }
161
+ }
162
+ }
163
+ }
164
+ .frame(height: 120)
165
+
166
+ VStack(spacing: RunicSpacing.xxs) {
167
+ Text("Runic")
168
+ .font(.system(size: 26, weight: .bold, design: .rounded))
169
+
170
+ Text("Version \(self.versionString)")
171
+ .font(.system(size: 12, weight: .medium, design: .rounded))
172
+ .foregroundStyle(.secondary)
173
+
174
+ if let buildTimestamp {
175
+ Text("Built \(buildTimestamp)")
176
+ .font(.system(size: 11, design: .rounded))
177
+ .foregroundStyle(.tertiary)
178
+ }
179
+ }
180
+
181
+ VStack(spacing: RunicSpacing.xs) {
182
+ Text("पूर्णमदः पूर्णमिदं पूर्णात् पूर्णमुदच्यते")
183
+ .font(.system(size: 12, weight: .regular, design: .serif))
184
+ .foregroundStyle(.secondary)
185
+ .multilineTextAlignment(.center)
186
+ Text("From fullness comes fullness.\nWhen fullness is taken from fullness,\nfullness alone remains.")
187
+ .font(.system(size: 11.5, weight: .regular, design: .rounded))
188
+ .foregroundStyle(.tertiary)
189
+ .multilineTextAlignment(.center)
190
+ .lineSpacing(2)
191
+ Text("— Isha Upanishad")
192
+ .font(.system(size: 10, weight: .medium, design: .rounded))
193
+ .foregroundStyle(.quaternary)
194
+ }
195
+ }
196
+ .frame(maxWidth: .infinity)
197
+ .opacity(self.appeared ? 1 : 0)
198
+ .offset(y: self.appeared ? 0 : 12)
199
+ }
200
+
201
+ // MARK: - Links
202
+
203
+ private var linksSection: some View {
204
+ GlassCard {
205
+ HStack(spacing: RunicSpacing.xs) {
206
+ LiquidLinkButton(
207
+ icon: "chevron.left.slash.chevron.right",
208
+ title: "GitHub",
209
+ url: "https://github.com/sriinnu/Runic")
210
+ LiquidLinkButton(
211
+ icon: "globe",
212
+ title: "Web",
213
+ url: "https://www.srinivas.dev")
214
+ LiquidLinkButton(
215
+ icon: "bird",
216
+ title: "Twitter",
217
+ url: "https://x.com/sriinnu")
218
+ LiquidLinkButton(
219
+ icon: "envelope",
220
+ title: "Email",
221
+ url: "mailto:sriinnu@users.noreply.github.com")
222
+ }
223
+ .frame(maxWidth: .infinity)
224
+ }
225
+ .opacity(self.appeared ? 1 : 0)
226
+ .offset(y: self.appeared ? 0 : 16)
227
+ .animation(.easeOut(duration: 0.7).delay(0.15), value: self.appeared)
228
+ }
229
+
230
+ // MARK: - Updater
231
+
232
+ private var updaterSection: some View {
233
+ GlassCard {
234
+ if self.updater.isAvailable {
235
+ VStack(spacing: RunicSpacing.sm) {
236
+ Toggle("Check for updates automatically", isOn: self.$autoUpdateEnabled)
237
+ .toggleStyle(.checkbox)
238
+ .font(.system(size: 12.5))
239
+ .frame(maxWidth: .infinity, alignment: .center)
240
+ Button("Check for Updates…") { self.updater.checkForUpdates(nil) }
241
+ .buttonStyle(.bordered)
242
+ .controlSize(.small)
243
+ }
244
+ } else {
245
+ Text(self.updater.unavailableReason ?? "Updates unavailable in this build.")
246
+ .font(.system(size: 12, design: .rounded))
247
+ .foregroundStyle(.secondary)
248
+ .frame(maxWidth: .infinity)
249
+ }
250
+ }
251
+ .opacity(self.appeared ? 1 : 0)
252
+ .offset(y: self.appeared ? 0 : 20)
253
+ .animation(.easeOut(duration: 0.7).delay(0.25), value: self.appeared)
254
+ }
255
+
256
+ // MARK: - Footer
257
+
258
+ private var footerSection: some View {
259
+ Text("© 2025–2026 Srinivas Pendela. MIT License.")
260
+ .font(.system(size: 11, design: .rounded))
261
+ .foregroundStyle(.tertiary)
262
+ .frame(maxWidth: .infinity)
263
+ .opacity(self.appeared ? 1 : 0)
264
+ .animation(.easeOut(duration: 0.6).delay(0.35), value: self.appeared)
265
+ }
266
+
267
+ private func openProjectHome() {
268
+ guard let url = URL(string: "https://github.com/sriinnu/Runic") else { return }
269
+ NSWorkspace.shared.open(url)
270
+ }
271
+ }