@pi-spi/app 0.0.0-stage → 1.2.1

package/lib/typescript/src/core/router.d.ts

@@ -0,0 +1,218 @@
+import { type ParamListBase } from '@react-navigation/native';
+import { type ReactElement, type ReactNode } from 'react';
+import type { BlocBase } from './bloc.js';
+import { Logger } from './logger.js';
+import { ValueNotifier } from './value_notifier.js';
+import type { OverlayEntry, OverlayKind } from '../shared/material/overlays.js';
+/** État de la route affichée, équivalent de `GoRouterState`. */
+export type RouteState = {
+    /** Emplacement complet demandé (ex. `/transaction/cancel/ABC`). */
+    location: string;
+    /** Modèle de la route correspondante (ex. `/transaction/cancel/:id`). */
+    path: string;
+    pathParameters: Record<string, string>;
+    queryParameters: Record<string, string>;
+    /** Objet passé à la navigation (`params` des helpers d'{@link AppRouter}), comme `state.extra`. */
+    extra?: unknown;
+};
+/** Accès aux blocs globaux du SDK depuis un redirect (≈ `context.read<B>()`). */
+export type RedirectContext = {
+    read<B extends BlocBase<any>>(type: abstract new (...args: any[]) => B): B;
+};
+/**
+ * Définition d'une route, équivalent d'une `GoRoute` :
+ * - `page` : plein écran, transition horizontale (`Page` en Flutter) ;
+ * - `dialog` : par-dessus l'écran précédent, 50 px sous le haut, coins
+ *   supérieurs arrondis, fond assombri (`DialogPage` en Flutter).
+ */
+export type RouteDef = {
+    path: string;
+    kind: 'page' | 'dialog';
+    builder: (state: RouteState) => ReactElement;
+    /** Retourne une autre route vers laquelle rediriger, ou `null` pour afficher celle-ci. */
+    redirect?: (state: RouteState, context: RedirectContext) => Promise<string | null> | string | null;
+};
+type ScreenParams = {
+    location: string;
+    pathParameters: Record<string, string>;
+    queryParameters: Record<string, string>;
+    extraId?: string;
+    resultId?: string;
+};
+/**
+ * Routeur d'une instance du SDK (équivalent du `GoRouter` créé par
+ * `AppRouter.routes()`) : un `navigationRef` propre, donc aucune collision
+ * si le SDK est ouvert plusieurs fois dans la vie de l'application hôte.
+ */
+export declare class SdkRouter {
+    readonly definitions: readonly RouteDef[];
+    readonly initialLocation: string;
+    static readonly logger: Logger;
+    readonly navigationRef: import("@react-navigation/core").NavigationContainerRefWithCurrent<ParamListBase>;
+    /** Route initiale, après résolution des redirects (voir {@link resolveInitial}). */
+    initialState?: {
+        name: string;
+        params: ScreenParams;
+    };
+    /** Accès aux blocs globaux pour les redirects, fourni par `PiSpiSdkEntry`. */
+    redirectContext: RedirectContext;
+    /** Feuilles du bas et dialogues ouverts (voir `shared/material/overlays.tsx`), du plus ancien au plus récent. */
+    readonly overlays: ValueNotifier<OverlayEntry[]>;
+    private readonly extras;
+    private readonly results;
+    private sequence;
+    constructor(definitions: readonly RouteDef[], initialLocation: string);
+    /** Toutes les routes déclarées, plus la page « introuvable ». */
+    get screens(): readonly RouteDef[];
+    definition(path: string): RouteDef;
+    /** Trouve la route correspondant à [location] (les routes sans paramètre sont prioritaires). */
+    match(location: string, extra?: unknown): {
+        def: RouteDef;
+        state: RouteState;
+    };
+    /** Applique les redirects de la route demandée (et des suivantes), comme GoRouter. */
+    resolve(location: string, extra?: unknown): Promise<{
+        def: RouteDef;
+        state: RouteState;
+    }>;
+    /** Résout la route initiale avant le premier affichage du navigateur. */
+    resolveInitial(): Promise<void>;
+    /** `extra` passé à la route affichée par l'écran de [params]. */
+    extraOf(params: ScreenParams | undefined): unknown;
+    /** Appelé au démontage d'un écran : libère son `extra` et résout un `push` encore en attente. */
+    release(params: ScreenParams | undefined): void;
+    /** Empile [location] ; la promesse est résolue avec la valeur passée à `pop` (≈ `context.push`). */
+    push<T>(location: string, extra?: unknown): Promise<T | undefined>;
+    /** Remplace toute la pile par [location] (≈ `context.go`). */
+    go(location: string, extra?: unknown): Promise<void>;
+    /** Remplace l'écran courant par [location] (≈ `context.pushReplacement`). */
+    replace(location: string, extra?: unknown): Promise<void>;
+    /** Ouvre une feuille ou un dialogue ; résolu à sa fermeture avec la valeur passée à `pop`. */
+    showOverlay<T>(kind: OverlayKind, builder: () => ReactNode, barrierDismissible: boolean, options?: {
+        themed?: boolean;
+    }): Promise<T | undefined>;
+    isTopOverlay(entry: OverlayEntry): boolean;
+    /**
+     * Ferme la feuille/le dialogue le plus récent s'il y en a un, sinon
+     * l'écran courant, en transmettant [value] à celui qui l'a ouvert
+     * (≈ `context.pop`).
+     */
+    pop(value?: unknown): void;
+    canPop(): boolean;
+    currentRoute(): string;
+    private toParams;
+    private completeResult;
+    private nextId;
+}
+export declare const SdkRouterContext: import("react").Context<SdkRouter | null>;
+/** Routeur de l'instance courante du SDK (≈ `GoRouter.of(context)`). */
+export declare function useAppRouter(): SdkRouter;
+/** État de la route de l'écran courant (≈ `GoRouterState.of(context)`). */
+export declare function useRouteState(): RouteState;
+/**
+ * Écran générique du navigateur : retrouve la {@link RouteDef} de la route
+ * affichée, construit son contenu et l'habille en `Page` ou `DialogPage`.
+ */
+export declare function RouteScreen({ route }: {
+    route: {
+        name: string;
+        params?: object;
+    };
+}): import("react").JSX.Element;
+/** Page affichée si aucune page trouvée */
+export declare function NotFoundPage(): import("react").JSX.Element;
+/**
+ * Définit la logique de routage / navigation entre les différentes pages
+ * du SDK. Contrairement à l'application de référence, ce router ne
+ * possède pas de routes de connexion/sécurité (login, PIN, permissions) :
+ * l'application hôte gère l'authentification avant d'afficher le SDK.
+ */
+export declare class AppRouter {
+    static readonly logger: Logger;
+    static readonly alias = "/alias";
+    static readonly aliasMBNOcreate = "/alias/mbno";
+    static readonly aliasMBNOconfirm = "/alias/mbno/confirm";
+    static readonly aliasClaimDetails = "/alias/revendications/:id";
+    static readonly home = "/home";
+    static readonly introduction = "/introduction";
+    static readonly permissions = "/permissions";
+    static readonly selectAccount = "/select-account";
+    static readonly contactCreate = "/contact";
+    static readonly contactSelect = "/contact/select";
+    static readonly transactionSend = "/transaction/send_now";
+    static readonly transactionSendDetails = "/transaction/send_now/:id";
+    static readonly transactionSendDetailsCategorie = "/transaction/send_now/details/categorie";
+    static readonly transactionReceive = "/transaction/receive_now";
+    static readonly transactionReceiveDetails = "/transaction/receive_now/:id";
+    static readonly transactionFormPage = "/transaction-form-fields";
+    static readonly transactionFormVerification = "/transaction-form-verification";
+    static readonly transactionFormSchedule = "/transaction-form-schedule";
+    static readonly transactionSearch = "/transaction-search";
+    static readonly transactionSearchFilters = "/transaction-search/filters";
+    static readonly transactionCancel = "/transaction/cancel/:id";
+    static readonly transactionSplitPayment = "/transaction/split-payment";
+    static readonly transactionSplitPaymentTx = "/transaction/split-payment/transaction";
+    static readonly transactionSplitPaymentRepartition = "/transaction/split-payment/repartition";
+    static readonly subscriptionList = "/subscriptions/list";
+    static readonly subscriptionDetails = "/subscriptions/details";
+    static readonly subscriptionSchedule = "/transaction/schedule";
+    static readonly subscriptionSubscribe = "/subscriptions/create";
+    static readonly qrcodeScan = "/qrcode/scan";
+    static readonly qrcodeShow = "/qrcode/show";
+    static readonly qrcodeTransactionSend = "/qrcode/send";
+    static readonly categories = "/categories";
+    static readonly categoriesSelect = "/categories/select";
+    static readonly categoriesAdd = "/categories/add";
+    static readonly categoriesEdit = "/categories/edit";
+    static readonly profile = "/profile";
+    static readonly profileCompte = "/profile/compte";
+    static readonly profileParametre = "/profile/parametre";
+    static readonly profileContacts = "/profile/contacts";
+    static readonly profileParametreTheme = "/profile/parametre/theme";
+    static readonly profileParametreNotifications = "/profile/parametre/notifications";
+    static readonly profileParametreNotificationsSon = "/profile/parametre/notifications/son";
+    static readonly profileHelpCenter = "/profile/help-center";
+    static readonly loginCgu = "/profile/cgu";
+    static readonly loginPoc = "/profile/poc";
+    static readonly notifications = "/notifications";
+    /** Constructeur privé : la classe n'est jamais instanciée. */
+    private constructor();
+    /**
+     * Méthode qui retourne la configuration des routes. Un nouveau routeur
+     * (et un nouveau `navigationRef`) est créé à chaque appel : si le SDK est
+     * ouvert plusieurs fois dans la vie de l'application hôte, chaque
+     * instance a son propre navigateur, sans collision.
+     *
+     * [definitions] : les routes des modules (voir `routes.tsx`, séparé de
+     * ce fichier pour que le routeur n'importe aucun écran — les écrans
+     * importent le routeur, l'inverse créerait des cycles d'import).
+     */
+    static routes(initial: string, definitions: readonly RouteDef[]): SdkRouter;
+    /**
+     * Route à afficher une fois l'onboarding (introduction/permissions)
+     * terminé ou sauté : la sélection de compte si le client en a
+     * plusieurs, sinon directement l'accueil (avec `Di.activeCompte` déjà
+     * correctement initialisé par `Di.init`).
+     */
+    static postOnboardingRoute(): string;
+    /** Permet de naviguer entre les pages (empile la page, comme en Flutter). */
+    static go(router: SdkRouter, route: string, options?: {
+        params?: unknown;
+    }): void;
+    /** Permet de naviguer entre les pages, en attendant la valeur de retour de la page ouverte. */
+    static push<T>(router: SdkRouter, route: string, options?: {
+        params?: unknown;
+    }): Promise<T | undefined>;
+    /** Permet de naviguer entre les pages, en remplaçant la page courante (l'accueil remplace toute la pile). */
+    static pushReplacement(router: SdkRouter, route: string, options?: {
+        params?: unknown;
+    }): void;
+    /** Fermer un dialogue */
+    static pop(router: SdkRouter, options?: {
+        value?: unknown;
+    }): void;
+    static canPop(router: SdkRouter): boolean;
+    static currentRoute(router: SdkRouter): string;
+}
+export {};
+//# sourceMappingURL=router.d.ts.map

package/lib/typescript/src/core/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../../../src/core/router.tsx"],"names":[],"mappings":"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"}

package/lib/typescript/src/core/routes.d.ts

@@ -0,0 +1,9 @@
+import { type RouteDef } from './router.js';
+/**
+ * Routes déclarées par les modules déjà portés depuis le SDK Flutter
+ * (équivalent de la liste `routes:` du `GoRouter` dans router.dart). Toute
+ * route encore absente de cette liste affiche `NotFoundPage` (« A venir »),
+ * comme l'`errorPageBuilder` de GoRouter.
+ */
+export declare function appRoutes(): RouteDef[];
+//# sourceMappingURL=routes.d.ts.map

package/lib/typescript/src/core/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../../src/core/routes.tsx"],"names":[],"mappings":"AA0DA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,aAAU,CAAC;AAIpD;;;;;GAKG;AACH,wBAAgB,SAAS,IAAI,QAAQ,EAAE,CAyBtC"}

package/lib/typescript/src/core/sounds.d.ts

@@ -0,0 +1,21 @@
+export declare class SoundItem {
+    readonly name: string;
+    /** Identifiant du son, persisté dans les préférences (identique au SDK Flutter). */
+    readonly path: string;
+    /** Module Metro du fichier audio. */
+    readonly source: number;
+    constructor(name: string, 
+    /** Identifiant du son, persisté dans les préférences (identique au SDK Flutter). */
+    path: string, 
+    /** Module Metro du fichier audio. */
+    source: number);
+}
+export declare class SoundManager {
+    /** Lecteur dédié au SDK, créé à la première lecture. */
+    private static audioPlayer?;
+    static readonly liste: readonly SoundItem[];
+    static nameFromPath(path: string): string;
+    static playSound(soundPath: string): Promise<void>;
+    static dispose(): void;
+}
+//# sourceMappingURL=sounds.d.ts.map

package/lib/typescript/src/core/sounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sounds.d.ts","sourceRoot":"","sources":["../../../../src/core/sounds.ts"],"names":[],"mappings":"AAGA,qBAAa,SAAS;IAElB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,oFAAoF;IACpF,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM;gBAJd,IAAI,EAAE,MAAM;IACrB,oFAAoF;IAC3E,IAAI,EAAE,MAAM;IACrB,qCAAqC;IAC5B,MAAM,EAAE,MAAM;CAE1B;AAED,qBAAa,YAAY;IACvB,wDAAwD;IACxD,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAc;IAEzC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAUzC;IAEF,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;WAM5B,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYxD,MAAM,CAAC,OAAO,IAAI,IAAI;CAIvB"}

package/lib/typescript/src/core/sse.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Client SSE (Server-Sent Events) minimal, équivalent de
+ * `SSEClient.subscribeToSSE` (flutter_client_sse) : `fetch` ne sait pas
+ * lire un flux sous React Native, mais `XMLHttpRequest` reçoit la réponse
+ * au fil de l'eau (événements `progress`).
+ */
+/** Aucun événement reçu dans le délai imparti (≈ `TimeoutException` Dart). */
+export declare class TimeoutException extends Error {
+    readonly durationMs: number;
+    constructor(durationMs: number);
+}
+export type SseEvent = {
+    id?: string;
+    event?: string;
+    data?: string;
+};
+export type SseSubscription = {
+    close(): void;
+};
+export declare function subscribeToSSE(params: {
+    url: string;
+    headers: Record<string, string>;
+    onEvent: (event: SseEvent) => void;
+    onError: (error: unknown) => void;
+    /** Délai sans événement au-delà duquel [onError] reçoit une erreur de timeout. */
+    timeoutMs?: number;
+}): SseSubscription;
+//# sourceMappingURL=sse.d.ts.map

package/lib/typescript/src/core/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../../../src/core/sse.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,8EAA8E;AAC9E,qBAAa,gBAAiB,SAAQ,KAAK;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM;gBAAlB,UAAU,EAAE,MAAM;CAIxC;AAED,MAAM,MAAM,QAAQ,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtE,MAAM,MAAM,eAAe,GAAG;IAAE,KAAK,IAAI,IAAI,CAAA;CAAE,CAAC;AAEhD,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;IACnC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAClC,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,eAAe,CA0ElB"}

package/lib/typescript/src/core/storage.d.ts

@@ -0,0 +1,95 @@
+import CryptoJS from 'crypto-js';
+import { Logger } from './logger.js';
+import { type Stream } from './stream.js';
+/**
+ * Équivalent de `SharedPreferences` (Flutter) : préférences simples
+ * clé/valeur (thème, introduction passée, ...), stockées dans
+ * AsyncStorage. Toutes les valeurs du SDK sont chargées en mémoire par
+ * {@link SharedPreferences.getInstance}, ce qui permet, comme en Flutter,
+ * de les lire de façon synchrone ensuite (`ConfigService.recuperer()`).
+ */
+export declare class SharedPreferences {
+    private readonly cache;
+    private static instance?;
+    private constructor();
+    static getInstance(): Promise<SharedPreferences>;
+    getString(key: string): string | null;
+    setString(key: string, value: string): Promise<boolean>;
+    remove(key: string): Promise<boolean>;
+}
+/**
+ * Équivalent de `FlutterSecureStorage` : Keychain (iOS) / Keystore
+ * (Android) via `expo-secure-store`.
+ */
+export declare class SecureStorage {
+    read(key: string): Promise<string | null>;
+    write(key: string, value: string): Promise<void>;
+    containsKey(key: string): Promise<boolean>;
+    delete(key: string): Promise<void>;
+}
+type Item = Record<string, any>;
+/** Événement émis par {@link Box.watch}, comme `BoxEvent` (Hive). */
+export type BoxEvent = {
+    key: string;
+    value: Item | undefined;
+    deleted: boolean;
+};
+/**
+ * Équivalent d'une `Box` Hive chiffrée : collection clé → objet JSON,
+ * entièrement chargée en mémoire à l'ouverture, et réécrite chiffrée
+ * (AES-256-CBC, IV aléatoire à chaque écriture) dans AsyncStorage après
+ * chaque modification.
+ */
+export declare class Box {
+    readonly name: string;
+    private readonly entries;
+    private readonly dek;
+    private readonly events;
+    constructor(name: string, entries: Map<string, Item>, dek: CryptoJS.lib.WordArray);
+    get length(): number;
+    get values(): Item[];
+    get(key: string | null | undefined): Item | undefined;
+    put(key: string, value: Item): Promise<void>;
+    delete(key: string): Promise<void>;
+    /** Événements de modification de la boîte (ou d'une seule clé). */
+    watch(key?: string | null): Stream<BoxEvent>;
+    private flush;
+    static storageKey(name: string): string;
+    static open(name: string, dek: CryptoJS.lib.WordArray): Promise<Box>;
+}
+/**
+ * Stockage local chiffré du SDK (équivalent de `AppStorage` + Hive en
+ * Flutter) : collections d'objets JSON, chiffrées avec une clé (DEK)
+ * générée au premier lancement et conservée dans le stockage sécurisé.
+ */
+export declare class AppStorage {
+    static isInit: boolean;
+    static readonly logger: Logger;
+    /** NE JAMAIS STOCKER UNE AUTRE CLÉ AVEC CE NOM DANS LE STOCKAGE SÉCURISÉ */
+    static readonly keyId = "DEK";
+    /** The Data Encryption Key */
+    private static dek;
+    /** Collections ouvertes (chargées entièrement en mémoire, comme les boîtes Hive). */
+    static collections: Map<string, Promise<Box>>;
+    /** Init Storage Params */
+    static init(secureStorage: SecureStorage): Promise<void>;
+    /** Retrieve data collection */
+    static collection(collectionId: string): Promise<Box>;
+    /** Retrieve list of datas */
+    static list<T>(collectionId: string, fromJson: (json: Item) => T): Promise<T[]>;
+    /** Retrieve data */
+    static get<T>(collectionId: string, itemid: string | null | undefined, fromJson: (json: Item) => T): Promise<T | null>;
+    /** Stream list of datas */
+    static streamList<T>(collectionId: string, fromJson: (json: Item) => T): Promise<Stream<T[]>>;
+    /** Stream data item */
+    static streamItem<T>(collectionId: string, itemid: string | null | undefined, fromJson: (json: Item) => T): Promise<Stream<T>>;
+    /** Save a data in the collection */
+    static save(collectionId: string, id: string, data: Item): Promise<void>;
+    static saveList(collectionId: string, id: string, items: Item[]): Promise<void>;
+    /** Delete a data from the collection */
+    static delete(collectionId: string, id: string): Promise<void>;
+    /** All updates : fusionne [newData] (hors valeurs nulles) dans l'élément existant. */
+    static patch(collectionId: string, id: string, newData: Item): Promise<void>;
+}
+export {};
+//# sourceMappingURL=storage.d.ts.map

package/lib/typescript/src/core/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../../src/core/storage.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/core/stream.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Équivalent minimal de `Stream`/`StreamController.broadcast()` (Dart),
+ * utilisé par le bus d'événements du SDK, par `AppStorage` et par les
+ * réponses asynchrones (solde, confirmation de transfert...).
+ */
+export type Unsubscribe = () => void;
+export interface Stream<T> {
+    /** S'abonne aux événements (et aux erreurs) ; retourne la fonction de désabonnement. */
+    listen(listener: (event: T) => void, onError?: (error: unknown) => void): Unsubscribe;
+}
+export declare class StreamController<T> {
+    private readonly listeners;
+    readonly stream: Stream<T>;
+    /** Publie un événement à tous les abonnés courants. */
+    add(event: T): void;
+    /** Publie une erreur à tous les abonnés courants. */
+    addError(error: unknown): void;
+    get hasListener(): boolean;
+    /** Transforme le flux (équivalent de `Stream.map`). */
+    map<R>(transform: (event: T) => R): Stream<R>;
+}
+export declare function mapStream<T, R>(source: Stream<T>, transform: (event: T) => R): Stream<R>;
+/**
+ * Flux « froid » (≈ une fonction `async*` Dart) : chaque abonnement exécute
+ * [producer], qui publie ses valeurs avec `emit` ; après le
+ * désabonnement, plus rien n'est transmis. Une erreur de [producer] est
+ * transmise à `onError`.
+ */
+export declare function coldStream<T>(producer: (emit: (value: T) => void) => Promise<void>): Stream<T>;
+/** Flux qui ne publie que [error] (≈ `Stream.error`). */
+export declare function errorStream<T>(error: unknown): Stream<T>;
+//# sourceMappingURL=stream.d.ts.map

package/lib/typescript/src/core/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../../src/core/stream.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;AAErC,MAAM,WAAW,MAAM,CAAC,CAAC;IACvB,wFAAwF;IACxF,MAAM,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,WAAW,CAAC;CACvF;AAED,qBAAa,gBAAgB,CAAC,CAAC;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiF;IAE3G,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAQxB;IAEF,uDAAuD;IACvD,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAInB,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAI9B,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,uDAAuD;IACvD,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;CAG9C;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAIxF;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAc9F;AAED,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAIxD"}