@pi-spi/app 1.3.0 → 1.4.0

package/src/modules/qrcode/presentation/pages/qrcode_alias_page.tsx

@@ -2,7 +2,7 @@ import { MaterialIcons } from '@expo/vector-icons';
 import { File, Paths } from 'expo-file-system';
 import * as Sharing from 'expo-sharing';
 import { useRef, useState } from 'react';
-import { ActivityIndicator, Platform, Pressable, ScrollView, StyleSheet, useWindowDimensions, View } from 'react-native';
+import { ActivityIndicator, Platform, Pressable, ScrollView, StyleSheet, useWindowDimensions, View, type ViewInstance } from 'react-native';
 import { captureRef } from 'react-native-view-shot';
 
 import { useBloc, useBlocListener, useCreateBloc } from '../../../../core/bloc_react';
@@ -42,7 +42,7 @@ export function QrCodeAliasPage() {
   const aliasCle = alias?.getCle() ?? '';
   const [qrCode, setQrCode] = useState<string | null>(null);
   const [showQrcodeName, setShowQrcodeName] = useState(false);
-  const qrRef = useRef<View>(null);
+  const qrRef = useRef<ViewInstance>(null);
   const bloc = useCreateBloc(() => {
     const created = new QrcodeAliasBloc(Di.getQrcodeInputPort());
     if (alias != null) created.add(new QrcodeAliasEncodeEvent(alias));

package/src/modules/qrcode/presentation/pages/qrcode_alias_page_share.tsx

@@ -5,7 +5,7 @@ import { Images } from '../../../../core/assets';
 import { AppRouter, useAppRouter } from '../../../../core/router';
 import { useTheme } from '../../../../core/theme';
 import { useAppLocalizations } from '../../../../l10n/localizations';
-import { MenuActionItem, MenuActionsWiget } from '../../../../shared/widgets/menu_actions_widget';
+import { MenuActionItem, MenuActionsWidget } from '../../../../shared/widgets/menu_actions_widget';
 
 /** Feuille « Partager » : le QR code (image) ou l'alias (texte). */
 export function QrcodeAliasPageShare({
@@ -28,7 +28,7 @@ export function QrcodeAliasPageShare({
       <ScrollView contentContainerStyle={[styles.content, { paddingBottom: 20 + insets.bottom }]}>
         <Text style={theme.textTheme.headlineMedium}>{traductions.qrcodePagePartageTitle}</Text>
         <View style={styles.gap20} />
-        <MenuActionsWiget
+        <MenuActionsWidget
           items={[
             new MenuActionItem(
               Images.homeFooterQrcode,

package/src/modules/search/domain/models/fonctionnalite.ts

@@ -0,0 +1,217 @@
+/** Lettres accentuées et ligatures ramenées à leur forme simple. */
+const ACCENTS: Record<string, string> = {
+  à: 'a',
+  â: 'a',
+  ä: 'a',
+  á: 'a',
+  ã: 'a',
+  å: 'a',
+  ç: 'c',
+  é: 'e',
+  è: 'e',
+  ê: 'e',
+  ë: 'e',
+  î: 'i',
+  ï: 'i',
+  í: 'i',
+  ì: 'i',
+  ô: 'o',
+  ö: 'o',
+  ó: 'o',
+  ò: 'o',
+  õ: 'o',
+  ù: 'u',
+  û: 'u',
+  ü: 'u',
+  ú: 'u',
+  ÿ: 'y',
+  ñ: 'n',
+  œ: 'oe',
+  æ: 'ae',
+};
+
+/**
+ * Une fonctionnalité de l'application que l'utilisateur peut retrouver
+ * depuis la recherche.
+ *
+ * La recherche ignore les majuscules, les accents et la ponctuation :
+ * « Sécurité », « securite » et « SECURITÉ » donnent le même résultat.
+ */
+export class Fonctionnalite {
+  /** Icône (module Metro, voir `Images`). */
+  readonly icon: number;
+
+  /** Libellé affiché, déjà traduit. C'est le champ le plus pertinent. */
+  readonly titre: string;
+
+  /** Courte description affichée sous le titre, déjà traduite. */
+  readonly sousTitre?: string;
+
+  /**
+   * Synonymes non affichés, dans toutes les langues de l'application.
+   * Ils doivent être écrits sans accents (voir {@link Fonctionnalite.normaliser}).
+   */
+  readonly motsCles: readonly string[];
+
+  /**
+   * Ouvre la fonctionnalité. Appelé par la page appelante une fois la
+   * recherche fermée, jamais par la page de recherche elle-même.
+   */
+  readonly ouvrir: () => void;
+
+  constructor(options: {
+    icon: number;
+    titre: string;
+    sousTitre?: string;
+    motsCles?: readonly string[];
+    ouvrir: () => void;
+  }) {
+    this.icon = options.icon;
+    this.titre = options.titre;
+    this.sousTitre = options.sousTitre;
+    this.motsCles = options.motsCles ?? [];
+    this.ouvrir = options.ouvrir;
+  }
+
+  /**
+   * Met [texte] en minuscules sans accents, et remplace tout ce qui
+   * n'est ni lettre ni chiffre par un seul espace.
+   * Exemple : « Code QR — Scanner ! » devient « code qr scanner ».
+   */
+  static normaliser(texte: string): string {
+    let resultat = '';
+    for (const lettre of texte.toLowerCase()) {
+      resultat += ACCENTS[lettre] ?? lettre;
+    }
+    return resultat.replace(/[^a-z0-9]+/g, ' ').trim();
+  }
+
+  /** Mots normalisés de [texte], sans les vides. */
+  private static mots(texte: string): string[] {
+    return Fonctionnalite.normaliser(texte)
+      .split(' ')
+      .filter((mot) => mot.length > 0);
+  }
+
+  /**
+   * Mots utiles de la saisie. Si elle ne contient que des mots courants
+   * (« de » en cours de frappe de « demander »), ils sont tous gardés.
+   */
+  private static motsUtiles(recherche: string): string[] {
+    const mots = Fonctionnalite.mots(recherche);
+    const utiles = mots.filter((mot) => !MOTS_VIDES.has(mot));
+    return utiles.length === 0 ? mots : utiles;
+  }
+
+  /**
+   * Qualité de la correspondance entre un mot [saisi] et un [mot] de la
+   * fonctionnalité, 0 s'ils ne correspondent pas :
+   * - 3 : mots identiques ;
+   * - 2 : [mot] commence par [saisi] (frappe en cours : « envo » trouve
+   *   « envoi »), ou l'inverse pour un [mot] d'au moins 4 lettres
+   *   (pluriel : « abonnements » trouve « abonnement ») ;
+   * - 1 : une seule faute de frappe, sur des mots d'au moins 5 lettres
+   *   (« securiter », « abonement »).
+   */
+  private static qualite(saisi: string, mot: string): number {
+    if (saisi === mot) return 3;
+    if (mot.startsWith(saisi)) return 2;
+    if (mot.length >= 4 && saisi.startsWith(mot)) return 2;
+    if (saisi.length >= 5 && mot.length >= 5 && uneFaute(saisi, mot)) return 1;
+    return 0;
+  }
+
+  /**
+   * Nombre de mots de la saisie trouvés dans la fonctionnalité, et points
+   * cumulés (qualité de la correspondance × poids du champ, la meilleure
+   * pour chaque mot saisi).
+   */
+  private score(saisis: readonly string[]): { trouves: number; points: number } {
+    const champs: [string[], number][] = [
+      [Fonctionnalite.mots(this.titre), POIDS_TITRE],
+      [this.motsCles.flatMap((motCle) => Fonctionnalite.mots(motCle)), POIDS_MOTS_CLES],
+      [Fonctionnalite.mots(this.sousTitre ?? ''), POIDS_SOUS_TITRE],
+    ];
+    let trouves = 0;
+    let points = 0;
+    for (const saisi of saisis) {
+      let meilleur = 0;
+      for (const [mots, poids] of champs) {
+        for (const mot of mots) {
+          meilleur = Math.max(meilleur, Fonctionnalite.qualite(saisi, mot) * poids);
+        }
+      }
+      if (meilleur > 0) {
+        trouves++;
+        points += meilleur;
+      }
+    }
+    return { trouves, points };
+  }
+
+  /**
+   * Fonctionnalités de [catalogue] dont au moins un mot utile de
+   * [recherche] est trouvé, triées par nombre de mots trouvés puis par
+   * points. À égalité, l'ordre du catalogue est conservé.
+   * Une saisie vide renvoie tout le catalogue.
+   */
+  static rechercher(catalogue: readonly Fonctionnalite[], recherche: string): Fonctionnalite[] {
+    const saisis = Fonctionnalite.motsUtiles(recherche);
+    if (saisis.length === 0) return [...catalogue];
+    return catalogue
+      .map((item, ordre) => ({ item, ordre, ...item.score(saisis) }))
+      .filter(({ trouves }) => trouves > 0)
+      .sort((a, b) => b.trouves - a.trouves || b.points - a.points || a.ordre - b.ordre)
+      .map(({ item }) => item);
+  }
+}
+
+/**
+ * Mots trop courants pour désigner une fonctionnalité, en français,
+ * anglais et portugais, sans accents. Ils sont ignorés dans la saisie,
+ * pour qu'une phrase dictée (« je veux envoyer de l'argent ») ne
+ * retienne que les mots utiles.
+ */
+const MOTS_VIDES: ReadonlySet<string> = new Set([
+  // Français
+  'je', 'j', 'tu', 'il', 'elle', 'on', 'nous', 'vous', 'me', 'm', 'te',
+  't', 'se', 's', 'le', 'la', 'les', 'l', 'un', 'une', 'des', 'du', 'de',
+  'd', 'au', 'aux', 'a', 'et', 'ou', 'en', 'y', 'pour', 'par', 'sur',
+  'avec', 'dans', 'mon', 'ma', 'mes', 'ton', 'ta', 'tes', 'son', 'sa',
+  'ses', 'notre', 'nos', 'votre', 'vos', 'ce', 'cet', 'cette', 'ces', 'c',
+  'qu', 'que', 'qui', 'quoi', 'comment', 'est', 'veux', 'voudrais',
+  'souhaite', 'aimerais', 'faire', 'peux', 'puis', 'voir', 'ne', 'n',
+  'pas', 'svp', 'stp',
+  // Anglais
+  'i', 'my', 'the', 'an', 'to', 'of', 'for', 'in', 'at', 'and', 'or',
+  'is', 'want', 'would', 'like', 'how', 'can', 'do', 'please', 'make',
+  // Portugais
+  'eu', 'o', 'os', 'as', 'um', 'uma', 'da', 'dos', 'das', 'no',
+  'na', 'em', 'para', 'por', 'com', 'meu', 'minha', 'meus', 'minhas',
+  'quero', 'queria', 'gostaria', 'como', 'fazer', 'ver', 'e',
+]);
+
+/** Poids d'un mot trouvé selon le champ où il l'est. */
+const POIDS_TITRE = 3;
+const POIDS_MOTS_CLES = 2;
+const POIDS_SOUS_TITRE = 1;
+
+/** [a] et [b] ne diffèrent que d'une lettre remplacée, ajoutée ou retirée. */
+function uneFaute(a: string, b: string): boolean {
+  if (Math.abs(a.length - b.length) > 1) return false;
+  const [court, long] = a.length <= b.length ? [a, b] : [b, a];
+  let i = 0;
+  let j = 0;
+  let fautes = 0;
+  while (i < court.length && j < long.length) {
+    if (court[i] === long[j]) {
+      i++;
+      j++;
+      continue;
+    }
+    if (++fautes > 1) return false;
+    if (court.length === long.length) i++;
+    j++;
+  }
+  return fautes + (long.length - j) <= 1;
+}

package/src/modules/search/presentation/pages/search_fonctionnalites.ts

@@ -0,0 +1,135 @@
+import { Platform } from 'react-native';
+
+import { Images } from '../../../../core/assets';
+import { AppRouter, type SdkRouter } from '../../../../core/router';
+import type { AppLocalizations } from '../../../../l10n/app_localizations';
+import { Fonctionnalite } from '../../domain/models/fonctionnalite';
+
+/**
+ * Catalogue des fonctionnalités accessibles depuis la recherche.
+ *
+ * [router] est celui de la page qui ouvre la recherche : la navigation
+ * part de là une fois la recherche fermée.
+ * [ouvrirOnglet] change d'onglet sur l'accueil (0 : compte, 1 : abonnements).
+ * Seules les pages présentes dans le SDK sont proposées (pas de
+ * sécurité ni d'à-propos : c'est l'app hôte qui les gère).
+ *
+ * L'ordre de la liste sert d'ordre d'affichage à pertinence égale :
+ * les fonctionnalités les plus utilisées sont en tête.
+ * Pour en ajouter une : titre et sous-titre traduits, mots-clés sans
+ * accents en français, anglais et portugais.
+ */
+export function fonctionnalitesRecherchables(
+  router: SdkRouter,
+  traductions: AppLocalizations,
+  { ouvrirOnglet }: { ouvrirOnglet: (onglet: number) => void },
+): Fonctionnalite[] {
+  const aller = (route: string, params?: unknown) => void AppRouter.push(router, route, { params });
+  const web = Platform.OS === 'web';
+
+  return [
+    // Paiements
+    new Fonctionnalite({
+      icon: Images.arrowUp,
+      titre: traductions.homeActionSend,
+      sousTitre: traductions.searchSendSubTitle,
+      motsCles: ['envoi', 'transfert', 'payer', 'virement', 'send', 'pay', 'transfer', 'enviar', 'pagar'],
+      ouvrir: () => aller(AppRouter.transactionSend),
+    }),
+    new Fonctionnalite({
+      icon: Images.arrowDown,
+      titre: traductions.homeActionRequest,
+      sousTitre: traductions.searchReceiveSubTitle,
+      motsCles: ['demander', 'demande', 'rtp', 'request', 'receive', 'pedir', 'receber'],
+      ouvrir: () => aller(AppRouter.transactionReceive),
+    }),
+    new Fonctionnalite({
+      icon: Images.homeFooterQrcode,
+      titre: traductions.searchQrScanTitle,
+      sousTitre: traductions.searchQrScanSubTitle,
+      motsCles: ['qr', 'qrcode', 'scanner', 'scan', 'camera'],
+      // Le QR scanné ouvre directement l'envoi, comme depuis l'accueil.
+      ouvrir: () => aller(AppRouter.qrcodeScan, 'send_now'),
+    }),
+    new Fonctionnalite({
+      icon: Images.homeFooterQr,
+      titre: traductions.qrcodePagePartageQrCodeTitle,
+      sousTitre: traductions.searchQrShowSubTitle,
+      motsCles: ['qr', 'qrcode', 'partager', 'share', 'partilhar'],
+      ouvrir: () => aller(AppRouter.qrcodeShow),
+    }),
+    new Fonctionnalite({
+      icon: Images.iconSend,
+      titre: traductions.transactionSearchTitle,
+      sousTitre: traductions.searchTransactionsSubTitle,
+      motsCles: ['historique', 'paiement', 'operation', 'releve', 'history', 'payment', 'historico', 'pagamento'],
+      ouvrir: () => aller(AppRouter.transactionSearch),
+    }),
+
+    // Abonnements
+    new Fonctionnalite({
+      icon: Images.transactionPlanifier,
+      titre: traductions.homeActionMoreSheetProgrammerTitle,
+      sousTitre: traductions.homeActionMoreSheetProgrammerSubTitle,
+      motsCles: ['programmer', 'planifier', 'recurrent', 'schedule', 'agendar'],
+      ouvrir: () => aller(AppRouter.subscriptionSchedule),
+    }),
+    new Fonctionnalite({
+      icon: Images.homeMoreFindSubscription,
+      titre: traductions.homePageToolbarTabbarAbonnement,
+      sousTitre: traductions.searchAbonnementsSubTitle,
+      motsCles: ['abonnement', 'echeance', 'programme', 'subscription', 'assinatura'],
+      ouvrir: () => ouvrirOnglet(1),
+    }),
+    new Fonctionnalite({
+      icon: Images.homeMoreFindSubscription,
+      titre: traductions.homeActionMoreSheetAbonnementTitle,
+      sousTitre: traductions.homeActionMoreSheetAbonnementSubTitle,
+      motsCles: ['abonnement', 'subscription', 'assinatura'],
+      ouvrir: () => aller(AppRouter.subscriptionSubscribe),
+    }),
+    new Fonctionnalite({
+      icon: Images.homeMoreSplitPayments,
+      titre: traductions.homeActionMoreSheetPartagerTitle,
+      sousTitre: traductions.homeActionMoreSheetPartagerSubTitle,
+      motsCles: ['partager', 'repartir', 'diviser', 'amis', 'split', 'share', 'dividir'],
+      ouvrir: () => aller(AppRouter.transactionSplitPaymentTx),
+    }),
+
+    // Profil
+    new Fonctionnalite({
+      icon: Images.iconsCircleUser,
+      titre: traductions.profilePageMenuCompteTitle,
+      sousTitre: traductions.searchCompteSubTitle,
+      motsCles: ['profil', 'compte', 'iban', 'rib', 'profile', 'account', 'perfil', 'conta'],
+      ouvrir: () => aller(AppRouter.profileCompte),
+    }),
+    new Fonctionnalite({
+      icon: Images.iconsSetting,
+      titre: traductions.profilePageMenuParametreTitle,
+      sousTitre: traductions.searchParametreSubTitle,
+      motsCles: ['parametre', 'reglage', 'theme', 'langue', 'notification', 'sombre', 'settings', 'language', 'dark', 'definicoes', 'idioma'],
+      ouvrir: () => aller(AppRouter.profileParametre),
+    }),
+    // Sur le web, le profil n'a pas ces pages : pas de contacts,
+    // et l'aide est un lien externe.
+    ...(web
+      ? []
+      : [
+          new Fonctionnalite({
+            icon: Images.iconTransactionSendByAlias,
+            titre: traductions.profilePageMenuAliasContactTitle,
+            sousTitre: traductions.searchContactsSubTitle,
+            motsCles: ['contact', 'alias', 'repertoire', 'contacts', 'contactos'],
+            ouvrir: () => aller(AppRouter.profileContacts),
+          }),
+          new Fonctionnalite({
+            icon: Images.iconsHelp,
+            titre: traductions.profilePageMenuHelpTitle,
+            sousTitre: traductions.searchAideSubTitle,
+            motsCles: ['aide', 'faq', 'assistance', 'support', 'help', 'ajuda'],
+            ouvrir: () => aller(AppRouter.profileHelpCenter),
+          }),
+        ]),
+  ];
+}