Merge branch 'main' into feat/eval-gauge-neutral-indicator

Author: flcsezz

CLAUDE.md

@@ -79,6 +79,21 @@ dart format --output=none --set-exit-if-changed $(find test -name "*.dart" -not
 dart format lib/src test
 ```
 
+### Formatting Rules (CRITICAL)
+
+**Always run `dart format` on every file you edit before finishing.** CI will fail if formatting is wrong.
+
+```bash
+dart format path/to/file.dart
+```
+
+The formatter is configured via `analysis_options.yaml` (`formatter: page_width: 100`) and `dart format` picks this up automatically. Key rules enforced by the formatter:
+
+- **Page width: 100 characters** — lines exceeding 100 chars will be reflowed
+- **Trailing commas drive formatting**: a trailing comma after the last argument/parameter forces the formatter to expand the list to one-item-per-line; omitting it allows the formatter to keep items on one line if they fit within 100 chars
+- **Do not manually wrap lines** — let the formatter decide based on trailing commas and line length; hand-wrapping without trailing commas will be reformatted by the tool
+- The formatter may reformat code you didn't touch in the same expression if you change surrounding structure
+
 ## Translations (i18n)
 
 **CRITICAL**: Never manually edit `lib/l10n/app_*.arb` files - they are generated.

ios/EXTENSIONS.md

@@ -0,0 +1,42 @@
+# iOS Extensions
+
+## Building extensions as a contributor
+
+Each iOS app extension (e.g. the Lichess widgets) is a separate Xcode target with its own bundle ID. For the extension to be installed on a device, that bundle ID must be registered in the Lichess Apple Developer account with a matching provisioning profile.
+
+As an external contributor you won't have access to that account, so `flutter run` will silently drop the extension from the bundle — you can add the app to your home screen but the widget won't appear in the widget catalog.
+
+### Testing locally
+
+You can still build and test extensions using your own Apple Developer account and iOS Simulator. A free account is enough for device testing.
+
+1. Open `ios/Runner.xcworkspace` in Xcode.
+2. Select the **Runner** target → **Signing & Capabilities** → set **Team** to your account and change the bundle ID to something you own (e.g. `com.yourname.lichess`).
+3. Do the same for the extension target (e.g. **LichessWidgetsExtension**), using a matching sub-ID (e.g. `com.yourname.lichess.widget`).
+4. Build and run from Xcode — the extension will be signed with your profile and work on your device.
+
+These changes are local only and should not be committed.
+
+### Merging new extensions
+
+When a PR that adds a new extension is ready to merge, a Lichess org member with Apple Developer access needs to:
+
+1. Register the new App ID (for the extension's bundle ID) in the Apple Developer portal.
+2. Create a provisioning profile for it.
+
+## Deploying extensions via fastlane
+
+Extensions have their own bundle ID (`org.lichess.mobileV2.<ExtensionName>`) and require a separate provisioning profile managed by `match`. The `Matchfile` and `Fastfile` list all extension bundle IDs alongside the main app.
+
+### Adding a new extension to the fastlane setup
+
+After registering the App ID in the developer portal (see above), run `match` once to create and store the provisioning profile:
+
+```sh
+cd ios
+bundle exec fastlane match appstore --app_identifier org.lichess.mobileV2.<ExtensionName>
+```
+
+This will generate the profile, push it to the certificates repo, and set the correct `PROVISIONING_PROFILE_SPECIFIER` in the Xcode project. After that, `fastlane beta` handles signing for all targets automatically — including in CI.
+
+Also add the new bundle ID to both `app_identifier` arrays in `fastlane/Matchfile` and the `sync_code_signing` call in `fastlane/Fastfile`.

ios/Gemfile.lock

@@ -3,33 +3,33 @@ GEM
   specs:
     CFPropertyList (3.0.8)
     abbrev (0.1.2)
-    addressable (2.8.8)
+    addressable (2.8.9)
       public_suffix (>= 2.0.2, < 8.0)
     artifactory (3.0.17)
     atomos (0.1.3)
     aws-eventstream (1.4.0)
-    aws-partitions (1.1213.0)
-    aws-sdk-core (3.242.0)
+    aws-partitions (1.1232.0)
+    aws-sdk-core (3.244.0)
       aws-eventstream (~> 1, >= 1.3.0)
       aws-partitions (~> 1, >= 1.992.0)
       aws-sigv4 (~> 1.9)
       base64
       bigdecimal
       jmespath (~> 1, >= 1.6.1)
       logger
-    aws-sdk-kms (1.121.0)
-      aws-sdk-core (~> 3, >= 3.241.4)
+    aws-sdk-kms (1.123.0)
+      aws-sdk-core (~> 3, >= 3.244.0)
       aws-sigv4 (~> 1.5)
-    aws-sdk-s3 (1.213.0)
-      aws-sdk-core (~> 3, >= 3.241.4)
+    aws-sdk-s3 (1.217.1)
+      aws-sdk-core (~> 3, >= 3.244.0)
       aws-sdk-kms (~> 1)
       aws-sigv4 (~> 1.5)
     aws-sigv4 (1.12.1)
       aws-eventstream (~> 1, >= 1.0.2)
     babosa (1.0.4)
     base64 (0.2.0)
     benchmark (0.5.0)
-    bigdecimal (4.0.1)
+    bigdecimal (4.1.0)
     claide (1.1.0)
     colored (1.2)
     colored2 (3.1.2)
@@ -68,11 +68,11 @@ GEM
     faraday-net_http_persistent (1.2.0)
     faraday-patron (1.0.0)
     faraday-rack (1.0.0)
-    faraday-retry (1.0.3)
+    faraday-retry (1.0.4)
     faraday_middleware (1.2.1)
       faraday (~> 1.0)
-    fastimage (2.4.0)
-    fastlane (2.232.0)
+    fastimage (2.4.1)
+    fastlane (2.232.2)
       CFPropertyList (>= 2.3, < 4.0.0)
       abbrev (~> 0.1.2)
       addressable (>= 2.8, < 3.0.0)
@@ -125,7 +125,7 @@ GEM
     fastlane-sirp (1.0.0)
       sysrandom (~> 1.0)
     gh_inspector (1.1.3)
-    google-apis-androidpublisher_v3 (0.96.0)
+    google-apis-androidpublisher_v3 (0.98.0)
       google-apis-core (>= 0.15.0, < 2.a)
     google-apis-core (0.18.0)
       addressable (~> 2.5, >= 2.5.1)
@@ -139,15 +139,15 @@ GEM
       google-apis-core (>= 0.15.0, < 2.a)
     google-apis-playcustomapp_v1 (0.17.0)
       google-apis-core (>= 0.15.0, < 2.a)
-    google-apis-storage_v1 (0.60.0)
+    google-apis-storage_v1 (0.61.0)
       google-apis-core (>= 0.15.0, < 2.a)
     google-cloud-core (1.8.0)
       google-cloud-env (>= 1.0, < 3.a)
       google-cloud-errors (~> 1.0)
     google-cloud-env (2.1.1)
       faraday (>= 1.0, < 3.a)
-    google-cloud-errors (1.5.0)
-    google-cloud-storage (1.58.0)
+    google-cloud-errors (1.6.0)
+    google-cloud-storage (1.59.0)
       addressable (~> 2.8)
       digest-crc (~> 0.4)
       google-apis-core (>= 0.18, < 2)
@@ -169,7 +169,7 @@ GEM
     httpclient (2.9.0)
       mutex_m
     jmespath (1.6.2)
-    json (2.19.2)
+    json (2.19.3)
     jwt (2.10.2)
       base64
     logger (1.7.0)
@@ -185,13 +185,13 @@ GEM
     os (1.1.4)
     ostruct (0.6.3)
     plist (3.7.2)
-    public_suffix (7.0.2)
+    public_suffix (7.0.5)
     rake (13.3.1)
     representable (3.2.0)
       declarative (< 0.1.0)
       trailblazer-option (>= 0.1.1, < 0.2.0)
       uber (< 0.2.0)
-    retriable (3.1.2)
+    retriable (3.4.1)
     rexml (3.4.4)
     rouge (3.28.0)
     ruby2_keywords (0.0.5)

ios/LichessWidgets/Blog Feed Widget/BlogFeedFetcher.swift

@@ -0,0 +1,70 @@
+import FeedKit
+import UIKit
+import WidgetKit
+internal import XMLKit
+
+struct BlogFeedFetcher {
+    static var nextUpdateDate: Date {
+        Calendar.current.date(byAdding: .hour, value: 1, to: .now)!
+    }
+
+    private func fetchThumbnail(urlString: String, spec: BlogThumbnailSpec) async -> Data? {
+        guard let url = URL(string: urlString),
+              let (data, _) = try? await URLSession.shared.data(from: url),
+              let source = UIImage(data: data)
+        else { return nil }
+        let scale = UITraitCollection.current.displayScale
+        let size = CGSize(width: spec.width * scale, height: spec.height * scale)
+        return await source.byPreparingThumbnail(ofSize: size)?.jpegData(compressionQuality: 0.85)
+    }
+
+    func fetchEntry(feed: BlogFeedChoice, username: String?, family: WidgetFamily) async -> BlogFeedEntry {
+        let (items, error) = await fetchFeed(feed: feed, username: username, family: family)
+        return BlogFeedEntry(date: .now, feed: feed, username: username, items: items, error: error)
+    }
+
+    private func fetchFeed(feed: BlogFeedChoice,
+                           username: String?,
+                           family: WidgetFamily) async -> (items: [BlogFeedItem], error: String?) {
+        guard let urlString = feed.feedURL(username: username) else {
+            return ([], "Enter a username in widget settings")
+        }
+        do {
+            guard case .atom(let atomFeed) = try await Feed(urlString: urlString) else {
+                return ([], "Unexpected feed format")
+            }
+            let thumbSpec = family.thumbnailSpec
+            let items = await withTaskGroup(of: (Int, BlogFeedItem).self) { group in
+                for (index, entry) in (atomFeed.entries ?? []).prefix(family.maxItems).enumerated() {
+                    group.addTask {
+                        let thumbData: Data? = if let thumbSpec,
+                                                  let thumbURL = entry.media?.thumbnails?.first?.attributes?.url {
+                            await fetchThumbnail(urlString: thumbURL, spec: thumbSpec)
+                        } else {
+                            nil
+                        }
+                        let entryURL = entry.links?
+                            .first(where: { $0.attributes?.rel == "alternate" })?
+                            .attributes?.href
+                            ?? entry.links?.first?.attributes?.href
+                        return (index, BlogFeedItem(
+                            id: entry.id ?? "\(index)",
+                            title: entry.title ?? "Untitled",
+                            url: entryURL,
+                            publishedDate: entry.published,
+                            author: entry.authors?.first?.name,
+                            thumbnailData: thumbData,
+                            thumbnailImageName: nil
+                        ))
+                    }
+                }
+                var results: [(Int, BlogFeedItem)] = []
+                for await result in group { results.append(result) }
+                return results.sorted { $0.0 < $1.0 }.map(\.1)
+            }
+            return (items, nil)
+        } catch {
+            return ([], error.localizedDescription)
+        }
+    }
+}

ios/LichessWidgets/Blog Feed Widget/BlogFeedPlaceholder.swift

@@ -0,0 +1,121 @@
+import Foundation
+import WidgetKit
+
+/// Static placeholder data shown in the widget gallery and while a widget loads.
+enum BlogFeedPlaceholder {
+    static func entry(feed: BlogFeedChoice, username: String? = nil, family: WidgetFamily) -> BlogFeedEntry {
+        BlogFeedEntry(
+            date: .now,
+            feed: feed,
+            username: username,
+            items: Array(items(for: feed).prefix(family.maxItems)),
+            error: nil
+        )
+    }
+
+    private static func items(for feed: BlogFeedChoice) -> [BlogFeedItem] {
+        switch feed {
+        case .officialBlog: return officialBlogItems
+        case .communityBlog: return communityBlogItems
+        case .userBlog: return userBlogItems
+        }
+    }
+
+    // MARK: Official Blog
+
+    private static let officialBlogItems: [BlogFeedItem] = [
+        BlogFeedItem(id: "1",
+                     title: "Lichess Mobile App Update",
+                     url: nil,
+                     publishedDate: daysAgo(1),
+                     author: nil,
+                     thumbnailData: nil,
+                     thumbnailImageName: "OfficialBlogPlaceholderImage1"),
+        BlogFeedItem(id: "2",
+                     title: "Queens' Online Chess Festival",
+                     url: nil,
+                     publishedDate: daysAgo(31),
+                     author: nil,
+                     thumbnailData: nil,
+                     thumbnailImageName: "OfficialBlogPlaceholderImage2"),
+        BlogFeedItem(id: "3",
+                     title: "Announcing the ChessMood 20/20 Grand Prix 2026",
+                     url: nil,
+                     publishedDate: daysAgo(35),
+                     author: nil,
+                     thumbnailData: nil,
+                     thumbnailImageName: "OfficialBlogPlaceholderImage3"),
+        BlogFeedItem(id: "4",
+                     title: "Streamer Arenas Announcement — February to July 2026",
+                     url: nil,
+                     publishedDate: daysAgo(39),
+                     author: nil,
+                     thumbnailData: nil,
+                     thumbnailImageName: "OfficialBlogPlaceholderImage4"),
+    ]
+
+    // MARK: Community Blog
+
+    private static let communityBlogItems: [BlogFeedItem] = [
+        BlogFeedItem(id: "1",
+                     title: "How To Analyse Your Game Like a 2000-Rated Player",
+                     url: nil,
+                     publishedDate: daysAgo(0),
+                     author: "VihaanRathodBhuj",
+                     thumbnailData: nil,
+                     thumbnailImageName: "CommunityBlogPlaceholderImage1"),
+        BlogFeedItem(id: "2",
+                     title: "What a Figure Skater Can Teach You About Chess Improvement",
+                     url: nil,
+                     publishedDate: daysAgo(0),
+                     author: "FM MattyDPerrine",
+                     thumbnailData: nil,
+                     thumbnailImageName: "CommunityBlogPlaceholderImage2"),
+        BlogFeedItem(id: "3", title: "Slow Growth in Chess: The Truth Most People Don't Want to Hear",
+                     url: nil, publishedDate: daysAgo(2),
+                     author: "IM nikhildixit",
+                     thumbnailData: nil,
+                     thumbnailImageName: "CommunityBlogPlaceholderImage3"),
+        BlogFeedItem(id: "4", title: "Everyone's favorite: A modern Kortchnoi seeking to change his history",
+                     url: nil,
+                     publishedDate: daysAgo(0),
+                     author: "FM Reynold9402",
+                     thumbnailData: nil,
+                     thumbnailImageName: "CommunityBlogPlaceholderImage4"),
+    ]
+
+    // MARK: User Blog
+
+    private static let userBlogItems: [BlogFeedItem] = [
+        BlogFeedItem(id: "1",
+                     title: "Did you know Lichess can do this? Opening Explorer and Tablebase",
+                     url: nil,
+                     publishedDate: daysAgo(2),
+                     author: nil,
+                     thumbnailData: nil,
+                     thumbnailImageName: "UserBlogPlaceholderImage1"),
+        BlogFeedItem(id: "2",
+                     title: "Annotated: Sicilian Accelerated Dragon Deep Dive",
+                     url: nil,
+                     publishedDate: daysAgo(7),
+                     author: nil,
+                     thumbnailData: nil, thumbnailImageName: "UserBlogPlaceholderImage2"),
+        BlogFeedItem(id: "3",
+                     title: "Tournament Report: City Open 2026",
+                     url: nil,
+                     publishedDate: daysAgo(14),
+                     author: nil,
+                     thumbnailData: nil, thumbnailImageName: "UserBlogPlaceholderImage3"),
+        BlogFeedItem(id: "4",
+                     title: "Endgame Studies I Recommend",
+                     url: nil,
+                     publishedDate: daysAgo(21),
+                     author: nil,
+                     thumbnailData: nil,
+                     thumbnailImageName: "UserBlogPlaceholderImage4"),
+    ]
+
+    private static func daysAgo(_ days: Int) -> Date? {
+        Calendar.current.date(byAdding: .day, value: -days, to: .now)
+    }
+}

ios/LichessWidgets/Blog Feed Widget/CommunityBlogWidget.swift

@@ -0,0 +1,17 @@
+import SwiftUI
+import WidgetKit
+
+struct CommunityBlogWidget: Widget {
+    let kind = "CommunityBlogWidget"
+
+    var body: some WidgetConfiguration {
+        StaticConfiguration(kind: kind,
+                            provider: GenericBlogFeedProvider(feed: .communityBlog)) { entry in
+            BlogFeedWidgetEntryView(entry: entry)
+                .containerBackground(.background, for: .widget)
+        }
+        .configurationDisplayName("Community Blog")
+        .description("Latest posts from the Lichess community blog.")
+        .supportedFamilies([.systemSmall, .systemMedium, .systemLarge])
+    }
+}