@sriinnu/runic 1.2.0 → 2.0.0

package/Sources/Runic/Controllers/StatusItemController.swift

@@ -1,51 +1,51 @@
 import AppKit
-import RunicCore
 import Observation
 import QuartzCore
+import RunicCore
 import SwiftUI
 
-/// **StatusItemController** - Manages macOS menubar status item and dropdown menu
-///
-/// **Purpose:**
-/// Coordinates the menubar icon, animations, menu construction, and user interactions.
-/// Acts as the bridge between AppKit (NSStatusItem) and SwiftUI (menu cards).
-///
-/// **Responsibilities:**
-/// - Create and manage NSStatusItem in menubar
-/// - Coordinate icon rendering via IconRenderer
-/// - Build rich NSMenu with embedded SwiftUI views
-/// - Handle animation lifecycle (60 FPS during pings)
-/// - Schedule background "ping" operations when menu opens
-/// - Manage keyboard shortcuts and user actions
-///
-/// **Architecture Pattern:**
-/// This file is split across 4 files via extensions:
-/// - `StatusItemController.swift` - Core setup (318 lines)
-/// - `StatusItemController+Menu.swift` - Menu construction (1878 lines)
-/// - `StatusItemController+Actions.swift` - User actions (200 lines)
-/// - `StatusItemController+Animation.swift` - Animation system (469 lines)
-///
-/// **Performance:**
-/// - **60 FPS cap** during active pings (PerformanceConstants.menubarFPS)
-/// - **Auto-stop animations** when data loaded or error encountered
-/// - **1.2s delay** before background ping when menu opens (reduce perceived lag)
-///
-/// **Dependencies:**
-/// - `UsageStore` - Data source
-/// - `SettingsStore` - User preferences
-/// - `IconRenderer` - Icon generation
-/// - `MenuCardView` - SwiftUI menu content
-///
-/// **Usage:**
-/// ```swift
-/// let controller = StatusItemController(
-///     store: usageStore,
-///     settings: settingsStore,
-///     account: accountInfo,
-///     updater: updater,
-///     preferencesSelection: selection
-/// )
-/// ```
+// **StatusItemController** - Manages macOS menubar status item and dropdown menu
+//
+// **Purpose:**
+// Coordinates the menubar icon, animations, menu construction, and user interactions.
+// Acts as the bridge between AppKit (NSStatusItem) and SwiftUI (menu cards).
+//
+// **Responsibilities:**
+// - Create and manage NSStatusItem in menubar
+// - Coordinate icon rendering via IconRenderer
+// - Build rich NSMenu with embedded SwiftUI views
+// - Handle animation lifecycle (60 FPS during pings)
+// - Schedule background "ping" operations when menu opens
+// - Manage keyboard shortcuts and user actions
+//
+// **Architecture Pattern:**
+// This file is split across 4 files via extensions:
+// - `StatusItemController.swift` - Core setup (318 lines)
+// - `StatusItemController+Menu.swift` - Menu construction (1878 lines)
+// - `StatusItemController+Actions.swift` - User actions (200 lines)
+// - `StatusItemController+Animation.swift` - Animation system (469 lines)
+//
+// **Performance:**
+// - **60 FPS cap** during active pings (PerformanceConstants.menubarFPS)
+// - **Auto-stop animations** when data loaded or error encountered
+// - **1.2s delay** before background ping when menu opens (reduce perceived lag)
+//
+// **Dependencies:**
+// - `UsageStore` - Data source
+// - `SettingsStore` - User preferences
+// - `IconRenderer` - Icon generation
+// - `MenuCardView` - SwiftUI menu content
+//
+// **Usage:**
+// ```swift
+// let controller = StatusItemController(
+//     store: usageStore,
+//     settings: settingsStore,
+//     account: accountInfo,
+//     updater: updater,
+//     preferencesSelection: selection
+// )
+// ```
 
 // MARK: - Status item controller (AppKit-hosted icons, SwiftUI popovers)
 

package/Sources/Runic/Core/BudgetNotificationManager.swift

@@ -59,7 +59,8 @@ final class BudgetNotificationManager {
                 let title = "Budget Alert: \(projectName)"
                 let body = "Projected to exceed \(limitStr) limit by \(overshootStr) this month"
 
-                self.logger.info("posting budget breach notification",
+                self.logger.info(
+                    "posting budget breach notification",
                     metadata: [
                         "provider": provider.rawValue,
                         "project": projectKey,

package/Sources/Runic/Core/Login/ClaudeLoginRunner.swift

@@ -1,9 +1,9 @@
-import RunicCore
 import Darwin
 import Foundation
+import RunicCore
 
 struct ClaudeLoginRunner {
-    enum Phase: Sendable {
+    enum Phase {
         case requesting
         case waitingBrowser
     }

package/Sources/Runic/Core/Login/CodexLoginRunner.swift

@@ -1,6 +1,6 @@
-import RunicCore
 import Darwin
 import Foundation
+import RunicCore
 
 struct CodexLoginRunner {
     struct Result {

package/Sources/Runic/Core/Login/CursorLoginRunner.swift

@@ -1,21 +1,21 @@
 import AppKit
-import RunicCore
 import Foundation
+import RunicCore
 import WebKit
 
 /// Handles Cursor login flow using a WebKit-based browser window.
 /// Captures session cookies after successful authentication.
 @MainActor
 final class CursorLoginRunner: NSObject {
-    enum Phase: Sendable {
+    enum Phase {
         case loading
         case waitingLogin
         case success
         case failed(String)
     }
 
-    struct Result: Sendable {
-        enum Outcome: Sendable {
+    struct Result {
+        enum Outcome {
             case success
             case cancelled
             case failed(String)

package/Sources/Runic/Core/Login/GeminiLoginRunner.swift

@@ -1,6 +1,6 @@
 import AppKit
-import RunicCore
 import Foundation
+import RunicCore
 
 enum GeminiLoginRunner {
     private static let geminiConfigDir = FileManager.default.homeDirectoryForCurrentUser

package/Sources/Runic/Core/Rendering/IconRenderer.swift

@@ -1,49 +1,49 @@
 import AppKit
 import RunicCore
 
-/// **IconRenderer** - Generates menubar status item icons with usage visualization
-///
-/// **Purpose:**
-/// Creates pixel-perfect 18×18pt (36×36px @2x) template images for the macOS menubar.
-/// Renders usage bars, stale indicators, and provider status into the icon.
-///
-/// **Responsibilities:**
-/// - Generate icons showing session/weekly usage patterns
-/// - Apply stale data dimming when data is > 5 minutes old
-/// - Cache rendered icons for performance (64 icon cache, 512 morph cache)
-/// - Support template (adapts to menubar theme) and vibrant appearances
-/// - Render loading animations and error states
-///
-/// **Performance:**
-/// - **O(1) icon cache lookup** via IconCacheKey hash
-/// - **O(1) morph cache** for animation frames
-/// - Cap cache sizes via `PerformanceConstants`
-/// - All rendering happens off main thread in `dispatchPrecondition(condition: .notOnQueue(.main))`
-///
-/// **Dependencies:**
-/// - `PerformanceConstants` - Cache sizes and timing
-/// - `UsageProvider` - Provider-specific rendering
-/// - `AppKit/CoreGraphics` - Image generation
-///
-/// **Usage:**
-/// ```swift
-/// let icon = IconRenderer.render(
-///     state: .usage(snap, status),
-///     indicator: .none,
-///     appearance: .template,
-///     dataMode: .remaining
-/// )
-/// statusItem.button?.image = icon
-/// ```
-
-enum IconAppearance: Sendable {
-    case template   // Adapts to menubar theme (light/dark mode)
-    case vibrant    // Full color rendering
+// **IconRenderer** - Generates menubar status item icons with usage visualization
+//
+// **Purpose:**
+// Creates pixel-perfect 18×18pt (36×36px @2x) template images for the macOS menubar.
+// Renders usage bars, stale indicators, and provider status into the icon.
+//
+// **Responsibilities:**
+// - Generate icons showing session/weekly usage patterns
+// - Apply stale data dimming when data is > 5 minutes old
+// - Cache rendered icons for performance (64 icon cache, 512 morph cache)
+// - Support template (adapts to menubar theme) and vibrant appearances
+// - Render loading animations and error states
+//
+// **Performance:**
+// - **O(1) icon cache lookup** via IconCacheKey hash
+// - **O(1) morph cache** for animation frames
+// - Cap cache sizes via `PerformanceConstants`
+// - All rendering happens off main thread in `dispatchPrecondition(condition: .notOnQueue(.main))`
+//
+// **Dependencies:**
+// - `PerformanceConstants` - Cache sizes and timing
+// - `UsageProvider` - Provider-specific rendering
+// - `AppKit/CoreGraphics` - Image generation
+//
+// **Usage:**
+// ```swift
+// let icon = IconRenderer.render(
+//     state: .usage(snap, status),
+//     indicator: .none,
+//     appearance: .template,
+//     dataMode: .remaining
+// )
+// statusItem.button?.image = icon
+// ```
+
+enum IconAppearance {
+    case template // Adapts to menubar theme (light/dark mode)
+    case vibrant // Full color rendering
 }
 
-enum IconDataMode: Sendable {
-    case remaining  // Show remaining quota
-    case used       // Show used quota
+enum IconDataMode {
+    case remaining // Show remaining quota
+    case used // Show used quota
 }
 
 enum IconRenderer {
@@ -53,17 +53,18 @@ enum IconRenderer {
     private static let outputSize = NSSize(width: 38, height: 22)
     private static let outputScale: CGFloat = 2
     private static let canvasPx = Int(outputSize.width * outputScale)
-    
-    // Infinity symbol base template - loaded lazily from Resources
+
+    /// Infinity symbol base template - loaded lazily from Resources
     private static let waveLogoTemplate: NSImage? = {
         guard let url = Bundle.main.url(forResource: "RunicMenubarIcon", withExtension: "svg"),
-              let image = NSImage(contentsOf: url) else {
+              let image = NSImage(contentsOf: url)
+        else {
             return nil
         }
         return image
     }()
 
-    private struct PixelGrid: Sendable {
+    private struct PixelGrid {
         let scale: CGFloat
 
         func pt(_ px: Int) -> CGFloat {
@@ -142,14 +143,19 @@ enum IconRenderer {
         }
     }
 
-    private struct RectPx: Hashable, Sendable {
+    private struct RectPx: Hashable {
         let x: Int
         let y: Int
         let w: Int
         let h: Int
 
-        var midXPx: Int { self.x + self.w / 2 }
-        var midYPx: Int { self.y + self.h / 2 }
+        var midXPx: Int {
+            self.x + self.w / 2
+        }
+
+        var midYPx: Int {
+            self.y + self.h / 2
+        }
 
         func rect() -> CGRect {
             Self.grid.rect(x: self.x, y: self.y, w: self.w, h: self.h)
@@ -215,13 +221,13 @@ enum IconRenderer {
                     dataMode: dataMode)
                 let accentColor = Self.vibrantAccentColor(pressure: pressure, stale: stale)
                 let baseColor = appearance == .template ? NSColor.labelColor : accentColor
-                
+
                 // Disable blink effect to prevent flicker
                 let opacityMultiplier = 1.0
-                
+
                 let fillColor = baseColor.withAlphaComponent((stale ? 0.55 : 1.0) * opacityMultiplier)
                 let baseAlpha: CGFloat = (stale ? 0.18 : (appearance == .template ? 0.28 : 0.38)) * opacityMultiplier
-                
+
                 let fillPercent = Self.iconFillPercent(
                     primary: topValue,
                     weekly: bottomValue,
@@ -265,33 +271,33 @@ enum IconRenderer {
 
     private static func sigilStyle(for style: IconStyle) -> SigilStyle {
         switch style {
-        case .codex: return .codex
-        case .claude: return .claude
-        case .zai: return .zai
-        case .gemini: return .gemini
-        case .antigravity: return .antigravity
-        case .cursor: return .cursor
-        case .factory: return .factory
-        case .copilot: return .copilot
-        case .minimax: return .minimax
-        case .openrouter: return .openrouter
-        case .groq: return .groq
-        case .deepseek: return .deepseek
-        case .fireworks: return .fireworks
-        case .mistral: return .mistral
-        case .perplexity: return .perplexity
-        case .kimi: return .kimi
-        case .auggie: return .auggie
-        case .together: return .together
-        case .cohere: return .cohere
-        case .xai: return .xai
-        case .cerebras: return .cerebras
-        case .sambanova: return .sambanova
-        case .azure: return .azure
-        case .bedrock: return .bedrock
-        case .vertexai: return .vertexai
-        case .qwen: return .qwen
-        case .combined: return .combined
+        case .codex: .codex
+        case .claude: .claude
+        case .zai: .zai
+        case .gemini: .gemini
+        case .antigravity: .antigravity
+        case .cursor: .cursor
+        case .factory: .factory
+        case .copilot: .copilot
+        case .minimax: .minimax
+        case .openrouter: .openrouter
+        case .groq: .groq
+        case .deepseek: .deepseek
+        case .fireworks: .fireworks
+        case .mistral: .mistral
+        case .perplexity: .perplexity
+        case .kimi: .kimi
+        case .auggie: .auggie
+        case .together: .together
+        case .cohere: .cohere
+        case .xai: .xai
+        case .cerebras: .cerebras
+        case .sambanova: .sambanova
+        case .azure: .azure
+        case .bedrock: .bedrock
+        case .vertexai: .vertexai
+        case .qwen: .qwen
+        case .combined: .combined
         }
     }
 
@@ -515,7 +521,7 @@ enum IconRenderer {
             let barHeightPx = 6
             let totalWidth = barWidthPx * 3 + barGapPx * 2
             let startX = centerXPx - totalWidth / 2
-            for idx in 0 ..< 3 {
+            for idx in 0..<3 {
                 let x = startX + idx * (barWidthPx + barGapPx)
                 let rect = Self.grid.rect(
                     x: x,
@@ -835,7 +841,8 @@ enum IconRenderer {
         fillColor: NSColor)
     {
         guard let waveLogo = self.waveLogoTemplate,
-              let ctx = NSGraphicsContext.current?.cgContext else {
+              let ctx = NSGraphicsContext.current?.cgContext
+        else {
             return
         }
 
@@ -867,7 +874,7 @@ enum IconRenderer {
         credits: Double?,
         dataMode: IconDataMode) -> Double
     {
-        let values = [primary, weekly, credits].compactMap { $0 }
+        let values = [primary, weekly, credits].compactMap(\.self)
         guard !values.isEmpty else { return 0 }
         let normalized = values.map { max(0, min($0 / 100, 1)) }
         switch dataMode {
@@ -884,11 +891,10 @@ enum IconRenderer {
         let safe = NSColor(calibratedRed: 0.12, green: 0.86, blue: 0.78, alpha: 1)
         let warn = NSColor(calibratedRed: 1.00, green: 0.72, blue: 0.30, alpha: 1)
         let hot = NSColor(calibratedRed: 1.00, green: 0.31, blue: 0.44, alpha: 1)
-        let color: NSColor
-        if clamped <= 0.5 {
-            color = self.mixColor(safe, warn, p: clamped / 0.5)
+        let color: NSColor = if clamped <= 0.5 {
+            self.mixColor(safe, warn, p: clamped / 0.5)
         } else {
-            color = self.mixColor(warn, hot, p: (clamped - 0.5) / 0.5)
+            self.mixColor(warn, hot, p: (clamped - 0.5) / 0.5)
         }
         if stale {
             return color.withAlphaComponent(0.72)

package/Sources/Runic/Core/Rendering/IconView.swift

@@ -19,7 +19,9 @@ struct IconView: View {
     private let cycleIntervalTicks = 20
     private let patterns = LoadingPattern.allCases
 
-    private var isLoading: Bool { self.showLoadingAnimation && self.snapshot == nil }
+    private var isLoading: Bool {
+        self.showLoadingAnimation && self.snapshot == nil
+    }
 
     var body: some View {
         Group {

package/Sources/Runic/Core/RunicColors.swift

@@ -14,12 +14,12 @@ enum RunicColors {
     /// Ordered palette for chart series. Colors chosen for distinguishability in
     /// both light and dark mode and for common color-vision deficiencies.
     static let chartPalette: [Color] = [
-        Color(red: 0.26, green: 0.55, blue: 0.96),  // blue
-        Color(red: 0.94, green: 0.53, blue: 0.18),  // orange
-        Color(red: 0.46, green: 0.75, blue: 0.36),  // green
-        Color(red: 0.80, green: 0.45, blue: 0.92),  // purple
-        Color(red: 0.26, green: 0.78, blue: 0.86),  // teal
-        Color(red: 0.94, green: 0.74, blue: 0.26),  // yellow
+        Color(red: 0.26, green: 0.55, blue: 0.96), // blue
+        Color(red: 0.94, green: 0.53, blue: 0.18), // orange
+        Color(red: 0.46, green: 0.75, blue: 0.36), // green
+        Color(red: 0.80, green: 0.45, blue: 0.92), // purple
+        Color(red: 0.26, green: 0.78, blue: 0.86), // teal
+        Color(red: 0.94, green: 0.74, blue: 0.26), // yellow
     ]
 
     /// Returns a chart color for the given index, wrapping around if needed.

package/Sources/Runic/Core/RunicSpacing.swift

@@ -33,16 +33,16 @@ enum RunicSpacing {
     // MARK: - Semantic Spacing
 
     /// Horizontal padding for menu content
-    static let menuHorizontalPadding: CGFloat = sm  // 12pt
+    static let menuHorizontalPadding: CGFloat = sm // 12pt
 
     /// Vertical padding for menu content
-    static let menuVerticalPadding: CGFloat = xs  // 8pt
+    static let menuVerticalPadding: CGFloat = xs // 8pt
 
     /// Spacing between cards in menu
-    static let cardSpacing: CGFloat = xs  // 8pt
+    static let cardSpacing: CGFloat = xs // 8pt
 
     /// Spacing between major sections
-    static let sectionSpacing: CGFloat = lg  // 24pt
+    static let sectionSpacing: CGFloat = lg // 24pt
 
     // MARK: - Preferences Spacing
 
@@ -50,13 +50,13 @@ enum RunicSpacing {
     static let compact: CGFloat = 6
 
     /// Standardized spacing for toggle rows
-    static let toggleRowSpacing: CGFloat = xs  // 8pt
+    static let toggleRowSpacing: CGFloat = xs // 8pt
 
     /// Spacing after section headers
-    static let sectionHeaderSpacing: CGFloat = md  // 16pt
+    static let sectionHeaderSpacing: CGFloat = md // 16pt
 
     /// Spacing within stepper controls
-    static let stepperControlSpacing: CGFloat = xs  // 8pt
+    static let stepperControlSpacing: CGFloat = xs // 8pt
 
     // MARK: - Chart Metrics