feat: headlines widget v61 + OS widget

[jvsena42]

FIGMA

Stacks on top of #914. This PR:

1. Adds a Glance-backed Headlines home screen widget with Wide and Compact layouts
2. Rebuilds the Headlines preview screen to match the v61 carousel/settings layout used by the price widget
3. Restructures the Headlines edit screen with sectioned settings (Title / Source / Time)
4. Adapts the in-app HeadlineCard to the v61 design (drops the widget-title row and source label)
5. Wires Headlines preferences through the shared AppWidgetConfigActivity / preferences store / refresh worker

Description

The Headlines widget now ships as a system widget. HeadlinesGlanceWidget is registered via HeadlinesGlanceReceiver in the manifest, uses SizeMode.Responsive to switch between a Wide layout (343x152dp, source/time row under the headline) and a Compact layout (163x192dp, headline-only with optional time pinned bottom-right), and reuses the foundation's GlanceWidgetScaffold + tap-to-edit intent. Tapping the widget opens the article URL when present, falling back to AppWidgetConfigActivity for unconfigured/no-data instances. The Glance content reads cached articles from AppWidgetPreferencesStore and renders a random one.

The shared AppWidgetConfigViewModel and AppWidgetConfigScreen were extended to handle Headlines: a HeadlinePreferences field (in-app) mapped to/from HomeHeadlinePreferences (datastore), toggleShowTime / toggleShowSource actions, branched resetPreferences / saveAndFinish per AppWidgetType, and a CONTENT section listing Title / Source / Time toggles. Save now persists the entry, registers the widget, and warms the article cache via AppWidgetDataRepository.fetchArticles(). AppWidgetRefreshWorker was updated to refresh Headlines instances alongside Price.

In-app, HeadlineCard is split into wide and compact variants. Wide: full-width card with a 4-line Title, plus a Brand-colored source / White64 time row. Compact: 163x192dp card with a 4-line title and optional time at the bottom. The widget title row, newspaper icon, and "Source" label have all been removed in favor of the v61 layout. HeadlinesPreviewScreen mirrors the price preview — top-bar title, description, divider, Widget Settings row showing Default/Custom, WidgetSizeCarousel between the small and wide cards, and Save/Delete buttons. HeadlinesEditScreen is restructured into a CONTENT section using Caption13Up headers and toggle rows (Title is locked-on, Source and Time are user-toggleable) with dividers, replacing the previous flat list.

Manifest, XML widget info (appwidget_info_headlines.xml), and a static preview layout (appwidget_preview_headlines.xml) are added to register the new provider with a 4x2 default placement and 2x2 minimum, matching the price widget. Three new strings (widgets__widget__content, widgets__widget__save, widgets__widget__settings) were added to strings.xml.

Preview

os-widget.webm

app-widget.webm

QA Notes

System widget

1. Long-press the home screen → Widgets → find "Bitcoin Headlines"
   • Verify the picker preview shows the wide layout (headline + source in Brand orange + time in White64)
2. Drop the widget at the default 4x2 placement
   • Verify it lands on the wide layout (4-line headline title + source/time row)
3. Resize down to 2x2
   • Verify it switches to the compact layout (4-line headline only, time pinned bottom-right when enabled)
4. Tap the widget while it's populated
   • Verify the article URL opens in the browser
5. Tap a freshly-added widget before any data is cached
   • Verify the loading caption shows briefly, then a real article appears once the worker finishes
6. Open the system config screen (long-press → Edit / tap on a fresh add)
   • Verify the title is "Bitcoin Headlines" and the CONTENT section lists Title / Source / Time
   • Verify Title is locked on
   • Verify Source / Time toggles flip between Brand and White50 and persist on Save

In-app widget

7. Open Widgets feed → Bitcoin Headlines
   • Verify the preview screen shows the v61 layout: top-bar "Bitcoin Headlines" title, description, divider, Widget Settings row, size carousel, Save Widget button
   • Verify the Widget Settings value reads "Default" with default prefs and "Custom" once Source or Time is toggled off
8. Swipe the carousel
   • Verify the small and wide cards render correctly with the same article and the size label flips between Small / Wide
9. Tap Widget Settings → HeadlinesEditScreen
   • Verify the CONTENT section header is uppercase and rendered with Caption13Up
   • Verify Title row is non-interactive, Source and Time rows toggle independently
   • Verify the article preview at the top reflects toggle state
10. Save and verify the in-app HeadlineCard on Home reflects the new prefs (no source row when Source is off, no time when Time is off)
11. With the widget already added, reopen the preview screen
    • Verify both Delete and Save buttons appear and Delete removes the in-app card

Build & lint

• ./gradlew compileDevDebugKotlin clean
• ./gradlew testDevDebugUnitTest clean (existing HeadlineCardTest / HeadlinesPreviewContentTest updated for the new layout)
• ./gradlew detekt clean

[jvsena42]

The OS widget is taller than the in-app because it has to fit in two cell. Tested with one cell height, it got too short

[claude]

These are hardcoded English strings in the live, user-facing widget configuration UI. HeadlinesConfigContent is called from the production AppWidgetConfigScreen dispatch (not from a @Preview-annotated composable), so real users will see these strings.

Per the CLAUDE.md rule:

NEVER hardcode strings and always preserve string resources

The exception ("NEVER add string resources for strings used only in dev settings screens and previews") does not apply here.

These three strings (title, timeAgo, publisher) should be added as entries in strings.xml (in alphabetical order) and referenced via stringResource(R.string.…) at the call site.

Reference:

bitkit-android/app/src/main/java/to/bitkit/appwidget/config/AppWidgetConfigScreen.kt

Lines 157 to 163 in eee104b

	private fun HeadlinesConfigContent(
	state: AppWidgetConfigUiState,
	onToggleSource: () -> Unit,
	onToggleTime: () -> Unit,
	onReset: () -> Unit,
	onSave: () -> Unit,
	onCancel: () -> Unit,

[claude]

The articleRotationTick is used only as a remember() invalidation key — it is never used to index into cachedArticles. Article selection is purely random (randomOrNull()), so:

• The same article can appear on consecutive refreshes.
• Articles can be skipped entirely.

The rotation counter built in AppWidgetPreferencesStore.bumpArticleRotationTick() and wired up in AppWidgetRefreshWorker has no effect on which article is displayed.

To make rotation deterministic as intended, use the tick as an index:

val article = remember(data.cachedArticles, data.articleRotationTick) {
    val articles = data.cachedArticles
    articles.getOrNull(data.articleRotationTick.toInt() % articles.size.coerceAtLeast(1))
        ?.toArticleModel()
}

Reference:

bitkit-android/app/src/main/java/to/bitkit/appwidget/ui/headlines/HeadlinesGlanceWidget.kt

Lines 34 to 38 in eee104b

	val entry = data.entries.find { it.appWidgetId == appWidgetId }
	?: AppWidgetEntry(appWidgetId = appWidgetId, type = AppWidgetType.HEADLINES)
	val article = remember(data.cachedArticles, data.articleRotationTick) {
	data.cachedArticles.randomOrNull()?.toArticleModel()
	}