feat: add contribution graph widget with adaptive layoutv2.12.0

Add small and medium widget families showing a trailing contribution
heatmap. Cell size is derived from available height to fill 7 rows,
columns scale with width. Trailing empty weeks are trimmed.

1 files changed, 36 insertions, 0 deletions

diff --git a/Shared/ContributionWidgetContext.swift b/Shared/ContributionWidgetContext.swift
new file mode 100644
index 0000000..3fadc8a
--- /dev/null
+++ b/Shared/ContributionWidgetContext.swift
@@ -0,0 +1,36 @@
+import Foundation
+#if canImport(WidgetKit)
+import WidgetKit
+#endif
+
+enum ContributionGraphWidgetConfiguration {
+    static let kind = "ContributionGraphWidget"
+}
+
+enum ContributionWidgetContextStore {
+    private static let actorKey = "contributionWidget.actor"
+
+    static func loadActor(defaults: UserDefaults? = sharedDefaults()) -> String? {
+        defaults?.string(forKey: actorKey)
+    }
+
+    static func saveActor(_ actor: String, defaults: UserDefaults? = sharedDefaults()) {
+        defaults?.set(actor, forKey: actorKey)
+        reloadWidgetTimelines()
+    }
+
+    static func clear(defaults: UserDefaults? = sharedDefaults()) {
+        defaults?.removeObject(forKey: actorKey)
+        reloadWidgetTimelines()
+    }
+
+    private static func sharedDefaults() -> UserDefaults? {
+        UserDefaults(suiteName: HutchAppGroup.identifier)
+    }
+
+    private static func reloadWidgetTimelines() {
+        #if canImport(WidgetKit)
+        WidgetCenter.shared.reloadTimelines(ofKind: ContributionGraphWidgetConfiguration.kind)
+        #endif
+    }
+}