@pi-spi/app 1.6.0 → 2.1.0

package/src/core/pi_spi_sdk_config.ts

@@ -1,6 +1,6 @@
 import { supportedLocales, type SupportedLocaleCode } from '../l10n/app_localizations';
 import type { PiSpiCustomTheme } from './pi_spi_custom_theme';
-import { Themes } from './theme';
+import { Accents, Themes } from './theme';
 
 /**
  * Équivalent des `assert` Dart : vérifié uniquement en développement
@@ -226,18 +226,31 @@ export class PiSpiAppConfig {
    * SDK lors d'une session précédente (voir {@link canChangeTheme}). Si
    * absent, la préférence locale actuelle est conservée telle quelle (ou
    * le défaut du SDK, `Themes.light`, si aucune n'existe encore).
+   * Valeurs : `Themes.system`, `Themes.light` ou `Themes.dark` ; la couleur
+   * se choisit avec {@link defaultAccent}.
    */
   readonly defaultTheme?: Themes;
 
+  /**
+   * Couleur d'accentuation avec laquelle le SDK s'ouvre (boutons, liens,
+   * pastilles), en clair comme en sombre. Optionnelle : si fournie, elle
+   * est appliquée et **persistée** à chaque ouverture du SDK, comme
+   * {@link defaultTheme}. Si absente, la préférence locale est conservée
+   * (ou la couleur PI-SPI, `Accents.pispi`, si aucune n'existe encore).
+   * Ignorée si {@link customTheme} est fourni.
+   */
+  readonly defaultAccent?: Accents;
+
   /**
    * Thème personnalisé de l'application hôte, quand aucun des thèmes du
    * SDK (`Themes`) ne convient : défini par ses couleurs ou par un
    * `ThemeData` complet (voir {@link PiSpiCustomTheme}). Optionnel : si
-   * fourni, il est appliqué et **persisté** à chaque ouverture du SDK, et
-   * il prime sur {@link defaultTheme}. L'entrée « Thème » des paramètres
-   * est alors masquée, sauf si {@link canChangeTheme} vaut `true` : le
-   * client peut alors choisir entre « Thème de l'application » (ce thème)
-   * et les thèmes du SDK.
+   * fourni, sa couleur est appliquée et **persistée** à chaque ouverture
+   * du SDK, en clair comme en sombre, et elle prime sur
+   * {@link defaultAccent}. L'entrée « Thème » des paramètres est alors
+   * masquée, sauf si {@link canChangeTheme} vaut `true` : le client peut
+   * alors choisir entre la couleur « Thème de l'application » et celles du
+   * SDK.
    */
   readonly customTheme?: PiSpiCustomTheme;
 
@@ -248,8 +261,9 @@ export class PiSpiAppConfig {
    * la préférence déjà persistée, voir sa documentation) pour toute la
    * session — comme pour {@link defaultLocale}.
    *
-   * Non fourni, sa valeur par défaut dépend de {@link defaultTheme} et de
-   * {@link customTheme} : `false` si l'hôte a fourni l'un des deux (il impose alors ce
+   * Non fourni, sa valeur par défaut dépend de {@link defaultTheme},
+   * {@link defaultAccent} et {@link customTheme} : `false` si l'hôte a
+   * fourni l'un d'eux (il impose alors ce
    * thème, cohérent avec le comportement de `defaultLocale`), `true` sinon
    * (l'hôte n'a exprimé aucun avis sur le thème, donc autant laisser le
    * client choisir). Passez explicitement `true`/`false` pour imposer un
@@ -268,6 +282,7 @@ export class PiSpiAppConfig {
     appstoreLink?: string;
     defaultLocale?: SupportedLocaleCode;
     defaultTheme?: Themes;
+    defaultAccent?: Accents;
     customTheme?: PiSpiCustomTheme;
     canChangeTheme?: boolean;
   }) {
@@ -281,8 +296,11 @@ export class PiSpiAppConfig {
     this.appstoreLink = params.appstoreLink ?? '';
     this.defaultLocale = params.defaultLocale ?? 'fr';
     this.defaultTheme = params.defaultTheme;
+    this.defaultAccent = params.defaultAccent;
     this.customTheme = params.customTheme;
-    this.canChangeTheme = params.canChangeTheme ?? (params.defaultTheme === undefined && params.customTheme === undefined);
+    this.canChangeTheme =
+      params.canChangeTheme ??
+      (params.defaultTheme === undefined && params.defaultAccent === undefined && params.customTheme === undefined);
 
     devAssert(
       (PiSpiAppConfig.supportedLocaleCodes as readonly string[]).includes(this.defaultLocale),