chore: import upstream snapshot with attribution

2026-07-13 12:22:33 +08:00
commit fc4fcbab58
1848 changed files with 472303 additions and 0 deletions
@@ -0,0 +1,37 @@
+import Foundation
+
+extension UsageStore {
+    static func resolvedPlanHistoryStore(
+        _ store: PlanUtilizationHistoryStore?,
+        startup: StartupBehavior) -> PlanUtilizationHistoryStore
+    {
+        store ?? (startup.automaticallyStartsBackgroundWork
+            ? .defaultAppSupport()
+            : PlanUtilizationHistoryStore(directoryURL: nil))
+    }
+
+    func startPlanUtilizationHistoryLoad(gate: PlanUtilizationHistoryLoadGate?, enabled: Bool) {
+        guard enabled || gate != nil else {
+            self.planUtilizationHistoryLoaded = true
+            return
+        }
+        let historyStore = self.planUtilizationHistoryStore
+        self.planUtilizationHistoryLoadTask = Task { @MainActor [weak self] in
+            // In-memory starts empty; mutation paths and sync menu accessors gate on
+            // `planUtilizationHistoryLoaded` until the background decode publishes once.
+            if let gate {
+                let shouldLoad = await withTaskCancellationHandler {
+                    await gate.wait()
+                } onCancel: {
+                    gate.cancel()
+                }
+                guard shouldLoad, !Task.isCancelled else { return }
+            }
+            let loaded = await historyStore.loadAsync()
+            guard !Task.isCancelled, let self, !self.planUtilizationHistoryLoaded else { return }
+            self.planUtilizationHistory = loaded
+            self.planUtilizationHistoryLoaded = true
+            self.planUtilizationHistoryRevision &+= 1
+        }
+    }
+}