Add the region map, permanent attribution and the Sources screen

Puts a MapLibre map on screen framed on the region, with the credit
obligations that come with showing third-party data satisfied structurally
rather than by remembering to add a label.

The base map style comes from MAP_STYLE_URL, and with no key configured the
app generates a fallback style from the region's own bounding box: a flat
background and the extent outline, no network sources at all. That keeps a
fresh clone runnable offline without pulling in a boundary dataset that would
carry its own licence, and it deliberately looks like a placeholder so it is
not mistaken for a finished map.

Attribution is driven by what is actually rendered. The bar lists the credits
for the active sources only, because crediting OpenStreetMap while showing the
fallback style would be a false attribution, and it says plainly when no base
map is configured. It sits below the map rather than floating over it so no
map control or gesture overlay can occlude a credit that the ODbL and CC BY-SA
terms require to be visible.

The Sources screen leads with the independence disclaimer, before the sources
it qualifies, so a reader who stops after the first screenful has still seen
it. Sources with no stated licence — ARPA publishes none for the alert
bulletin — say so explicitly rather than being shown bare or given an invented
one. A separate note explains that the rendered radar frames inherit CC BY-SA
from the DPC source data.

Also declares the INTERNET permission in the main manifest: Flutter injects it
into the debug and profile manifests only, so a release build would otherwise
fail every request on device.

Verified: analyze clean, 66 tests passing, appbundle builds with the native
MapLibre plugin. Not verified visually — this machine has no Android device or
emulator image, so nobody has watched the map render.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
2026-09-10 11:35:14 +02:00
co-authored by Claude Opus 5
parent 85b2c99949
commit d84095b5a8
13 changed files with 998 additions and 57 deletions
@@ -0,0 +1,185 @@
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:url_launcher/url_launcher.dart';
import '../../core/region/region_config.dart';
import '../../core/region/region_repository.dart';
import '../../l10n/app_localizations.dart';
/// Sources, licences and the independence disclaimer.
///
/// Reachable from the attribution bar on every screen that shows data. The
/// content is driven by the region config so a new region cannot ship without
/// its credits.
class SourcesScreen extends ConsumerWidget {
const SourcesScreen({super.key});
@override
Widget build(BuildContext context, WidgetRef ref) {
final l10n = AppLocalizations.of(context);
final region = ref.watch(regionConfigProvider);
return Scaffold(
appBar: AppBar(title: Text(l10n.sourcesTitle)),
body: switch (region) {
AsyncData(:final value) => _SourcesBody(region: value),
AsyncError(:final error) => Center(
child: Padding(
padding: const EdgeInsets.all(24),
child: Text('${l10n.dataUnavailable}\n$error'),
),
),
_ => Center(child: Text(l10n.loading)),
},
);
}
}
class _SourcesBody extends StatelessWidget {
const _SourcesBody({required this.region});
final RegionConfig region;
@override
Widget build(BuildContext context) {
final l10n = AppLocalizations.of(context);
final theme = Theme.of(context);
return ListView(
padding: const EdgeInsets.symmetric(vertical: 8),
children: [
// The disclaimer comes first, before the sources it qualifies: a reader
// who stops after the first screenful must still have seen it.
_Card(
icon: Icons.info_outline,
title: l10n.sourcesDisclaimerTitle,
body: l10n.sourcesDisclaimerBody,
),
_SectionHeader(l10n.sourcesDataSection),
for (final attribution in region.attributions)
_AttributionTile(attribution: attribution),
_Card(
icon: Icons.copyright_outlined,
title: l10n.sourcesShareAlikeTitle,
body: l10n.sourcesShareAlikeBody,
),
Padding(
padding: const EdgeInsets.fromLTRB(16, 8, 16, 24),
child: OutlinedButton.icon(
onPressed: () => _open(region.alerts.officialBulletinUrl),
icon: const Icon(Icons.open_in_new),
label: Text(l10n.sourcesOfficialBulletin),
),
),
Padding(
padding: const EdgeInsets.fromLTRB(16, 0, 16, 24),
child: Text(
region.displayName,
style: theme.textTheme.bodySmall?.copyWith(
color: theme.colorScheme.outline,
),
),
),
],
);
}
}
class _AttributionTile extends StatelessWidget {
const _AttributionTile({required this.attribution});
final Attribution attribution;
@override
Widget build(BuildContext context) {
final l10n = AppLocalizations.of(context);
final license = attribution.license;
return ListTile(
title: Text(attribution.text),
subtitle: Text(
license == null
? l10n.sourcesNoLicenseStated
: l10n.sourcesLicenseLabel(license),
),
trailing: IconButton(
icon: const Icon(Icons.open_in_new),
tooltip: l10n.openLink,
onPressed: () => _open(attribution.url),
),
onTap: () => _open(attribution.url),
);
}
}
class _SectionHeader extends StatelessWidget {
const _SectionHeader(this.title);
final String title;
@override
Widget build(BuildContext context) {
final theme = Theme.of(context);
return Padding(
padding: const EdgeInsets.fromLTRB(16, 16, 16, 8),
child: Text(
title,
style: theme.textTheme.titleSmall?.copyWith(
color: theme.colorScheme.primary,
),
),
);
}
}
class _Card extends StatelessWidget {
const _Card({required this.icon, required this.title, required this.body});
final IconData icon;
final String title;
final String body;
@override
Widget build(BuildContext context) {
final theme = Theme.of(context);
return Card(
margin: const EdgeInsets.fromLTRB(16, 8, 16, 8),
child: Padding(
padding: const EdgeInsets.all(16),
child: Row(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Icon(icon, color: theme.colorScheme.primary),
const SizedBox(width: 12),
Expanded(
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(title, style: theme.textTheme.titleSmall),
const SizedBox(height: 4),
Text(body, style: theme.textTheme.bodyMedium),
],
),
),
],
),
),
);
}
}
/// Opens [url] in the browser, ignoring a failure to launch.
///
/// A dead link is a poor experience but not a reason to crash the screen the
/// disclaimer lives on.
Future<void> _open(String url) async {
final uri = Uri.tryParse(url);
if (uri == null) return;
await launchUrl(uri, mode: LaunchMode.externalApplication);
}