fix(firebase_ui_localizations): expose all Firebase UI localizations for overriding (#309)

Author: russellwheatley

docs/firebase-ui-localizations.md

@@ -13,14 +13,16 @@ dependencies:
 
 ## Usage
 
-If your app supports only a single language, and you want to override labels – you will need to provide a custom class that implements [`DefaultLocalizations`](https://pub.dev/documentation/firebase_ui_localizations/latest/DefaultLocalizations-class.html),
-for example:
+If your app supports only a single language, and you want to override labels – you will need to provide a custom class that implements one of the [exposed localizations](https://github.com/firebase/FirebaseUI-Flutter/blob/main/packages/firebase_ui_localizations/lib/src/lang).
+
+For example, we could override the Spanish localization class and customize the email and password labels:
 
 ```dart
 import 'package:flutter_localizations/flutter_localizations.dart';
 import 'package:firebase_ui_localizations/firebase_ui_localizations.dart';
 
-class LabelOverrides extends DefaultLocalizations {
+// EsLocalizations is a class that provides Spanish labels. We override it here:
+class LabelOverrides extends EsLocalizations {
   const LabelOverrides();
 
   @override

packages/firebase_ui_auth/example/lib/main.dart

@@ -275,7 +275,7 @@ class FirebaseAuthUIExample extends StatelessWidget {
       },
       title: 'Firebase UI demo',
       debugShowCheckedModeBanner: false,
-      locale: const Locale('en'),
+      supportedLocales: const [Locale('en')],
       localizationsDelegates: [
         FirebaseUILocalizations.withDefaultOverrides(const LabelOverrides()),
         GlobalMaterialLocalizations.delegate,

packages/firebase_ui_localizations/lib/firebase_ui_localizations.dart

@@ -7,3 +7,5 @@ export 'src/l10n.dart'
 
 export 'src/default_localizations.dart'
     show DefaultLocalizations, FirebaseUILocalizationLabels;
+
+export 'src/all_localizations.dart';

packages/firebase_ui_localizations/lib/src/all_localizations.dart

@@ -0,0 +1,28 @@
+// Copyright 2024, the Chromium project authors.  Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
+export 'lang/ar.dart';
+export 'lang/de.dart';
+export 'lang/en.dart';
+export 'lang/es.dart';
+export 'lang/es_419.dart';
+export 'lang/fr.dart';
+export 'lang/he.dart';
+export 'lang/hi.dart';
+export 'lang/hu.dart';
+export 'lang/id.dart';
+export 'lang/it.dart';
+export 'lang/ja.dart';
+export 'lang/ko.dart';
+export 'lang/nb.dart';
+export 'lang/nl.dart';
+export 'lang/pl.dart';
+export 'lang/pt.dart';
+export 'lang/ro.dart';
+export 'lang/ru.dart';
+export 'lang/th.dart';
+export 'lang/tr.dart';
+export 'lang/uk.dart';
+export 'lang/zh.dart';
+export 'lang/zh_tw.dart';

packages/firebase_ui_localizations/lib/src/all_languages.dart packages/firebase_ui_localizations/lib/src/get_localization.dart

@@ -4,30 +4,7 @@
 import 'dart:ui';
 
 import "./default_localizations.dart";
-import 'lang/ar.dart';
-import 'lang/de.dart';
-import 'lang/en.dart';
-import 'lang/es.dart';
-import 'lang/es_419.dart';
-import 'lang/fr.dart';
-import 'lang/he.dart';
-import 'lang/hi.dart';
-import 'lang/hu.dart';
-import 'lang/id.dart';
-import 'lang/it.dart';
-import 'lang/ja.dart';
-import 'lang/ko.dart';
-import 'lang/nb.dart';
-import 'lang/nl.dart';
-import 'lang/pl.dart';
-import 'lang/pt.dart';
-import 'lang/ro.dart';
-import 'lang/ru.dart';
-import 'lang/th.dart';
-import 'lang/tr.dart';
-import 'lang/uk.dart';
-import 'lang/zh.dart';
-import 'lang/zh_tw.dart';
+import 'all_localizations.dart';
 
 final Set<String> kSupportedLanguages = {
   'ar', // Arabic

packages/firebase_ui_localizations/lib/src/l10n.dart

@@ -5,7 +5,7 @@
 import 'package:flutter/foundation.dart';
 import 'package:flutter/material.dart';
 
-import 'all_languages.dart';
+import 'get_localization.dart';
 import 'default_localizations.dart';
 
 const kDefaultLocale = Locale('en');
@@ -54,7 +54,8 @@ class FirebaseUILocalizations<T extends FirebaseUILocalizationLabels> {
   ///
   /// See [FirebaseUILocalizationLabels].
   static FirebaseUILocalizationDelegate
-      withDefaultOverrides<T extends DefaultLocalizations>(T overrides) {
+      withDefaultOverrides<T extends FirebaseUILocalizationLabels>(
+          T overrides) {
     return FirebaseUILocalizationDelegate<T>(overrides);
   }
 }

packages/firebase_ui_localizations/test/firebase_ui_localizations_test.dart

@@ -3,7 +3,6 @@
 // BSD-style license that can be found in the LICENSE file.
 
 import 'package:firebase_ui_localizations/firebase_ui_localizations.dart';
-import 'package:firebase_ui_localizations/src/lang/zh_tw.dart';
 import 'package:flutter/material.dart';
 import 'package:flutter_localizations/flutter_localizations.dart';
 import 'package:flutter_test/flutter_test.dart';
@@ -118,7 +117,8 @@ Future<void> main() async {
         (tester) async {
           await tester.pumpWidget(
             TestMaterialApp(
-              locale: localeTW,
+              // Test that 'en' labels are overridden by `ZhTWLocalizationsOverrides` overrides
+              locale: const Locale('en'),
               localizationsOverride: const FirebaseUILocalizationDelegate(
                 ZhTWLocalizationsOverrides(),
               ),