✨ Feature: Widget

[ngapp-dev]

Summary

feature/widget adds the first home-screen widget, "Price and nearest station", on Android (Jetpack Glance) and iOS (WidgetKit). It has 5 commits on top of master and touches 77 files (+5921 / −12
lines; 64 added, 13 modified). Main areas:

📊 Data layer

• WidgetData (core:model), WidgetDataRepository (core:domain) and CompositeWidgetDataRepository (core:data) build the widget data from the existing station, price and location repositories.
• Widgets only show the app's local data. They never call the API.

🧱 New widget/ module group

• :widget:core holds what every widget shares:
  • WidgetPublisher re-renders the widgets when local data changes (a sync, a new location or a favourite change);
  • the appearance model, its per-widget storage, the palette and the shared Glance surfaces;
  • the generic settings screen.
• :widget:nearest-station is the widget itself.
• Widgets depend only on core:*, never on feature:*. A tap on a station opens it through the existing ecogas-map deep link.

🤖 Android widget (Glance)

• Price tile and nearest-station tile with distance, address and status dot. The look follows the app's design tokens.
• The layout follows the size: a narrow widget shows one tile and a wide one shows the chosen tiles. One tile on a wide widget takes half its width.
• Per-widget settings screen (long press → Settings) with a live preview over the real wallpaper:
  • Show: Price / Distance / Both;
  • Theme: System / Light / Dark;
  • background and tile colour (black / white / blue / auto) and opacity;
  • imitated liquid glass with tint and strength, for the background and for the tiles.
• The status dot gets a contrasting ring when it matches the tile colour.

🍏 iOS widget (WidgetKit)

• New MetanMobileWidgetExtension target (iOS 17+), small and medium sizes.
• The app writes a JSON snapshot into the App Group group.com.ngapp.metanmobile. The texts in it are already translated into the app's language, and the nearest station is already picked by the same Kotlin logic as
  on Android.
• WidgetKit reloads through a Swift bridge (WidgetReloader), and only when the snapshot actually changed, because iOS rations reloads.
• Settings in the system "Edit Widget" sheet: tiles, theme, background and tile colour, and opacity steps.
• Supports the iOS 26 Clear and Tinted home screen modes (the system draws the glass). Strings in en/ru/be.

🐞 Fix

• A cold start from a deep link (the widget or an App Link) crashed with You must call setGraph() before calling getGraph(). The link now waits until the NavHost graph is set. This affects both Android and iOS.

🧪 Tests

• Kotlin:
  • CompositeWidgetDataRepository and WidgetPublisher (JVM + iOS simulator);
  • palette and settings storage;
  • the iOS snapshot and its JSON contract;
  • the Glance layout (glance-appwidget-testing + Robolectric).
• Swift: new MetanMobileWidgetTests target (Swift Testing, no host app). It covers the JSON contract with Kotlin, the palette rules, the widget rules and ru/be translations.

👷 CI

• The iOS job selects Xcode 27 and now also runs the widget's Kotlin tests on the iOS simulator and its Swift tests.
• Caches for what was downloaded on every run: the Kotlin/Native toolchain (~/.konan), Swift packages and Robolectric's Android SDK jars.

🛠 Versions

• Android 2.4.0 (2400), iOS 1.1.0 (3). The widget extension has the same version as the app, as App Store requires.

Review notes

• CI on Xcode 27: if macos-latest doesn't ship Xcode 27 / iOS 27 simulators yet, the iOS job fails at setup-xcode. Then switch runs-on to a newer macOS image.
• iOS widget on a device: its look, the "Edit Widget" settings and taps haven't been checked on a real iPhone yet. Only the data path was verified, on the iOS 27 simulator (the snapshot in the App Group).
• App Group: group.com.ngapp.metanmobile has to exist in the Apple Developer account for release signing of both targets.
• Location freshness: the widget's distance is as fresh as the last location the app saved. The widget doesn't request location on its own.
• Lint gap (not from this PR): lintDebug doesn't analyse the Android code of KMP modules, so core:*, feature:* and widget:* androidMain aren't linted. This was checked with a deliberate probe error.
• New library: androidx.glance:glance-appwidget 1.2.0, plus glance-appwidget-testing for tests.