@starterlib/ui 0.8.0 → 0.9.1

package/types/starterlib-ui-qr.d.ts

@@ -0,0 +1,105 @@
+import * as i0 from "@angular/core";
+/**
+ * Encodeur QR pur (lot 264) : ISO/IEC 18004, versions 1 a 40, niveaux L, M, Q et H, modes
+ * numerique, alphanumerique et octets (UTF-8), un seul segment. Aucune dependance, aucun acces au
+ * DOM : une matrice de booleens que `st-qr-code` dessine.
+ *
+ * Ni au tronc ni dans `util` (ADR 0004, N06) : il ne sert qu'a `@starterlib/ui/qr`, et son poids ne
+ * se paie que la ou un code s'affiche.
+ */
+/** Niveau de correction (7.5.1) : environ 7, 15, 25 et 30 % des mots de code recuperables. */
+export type CorrectionQr = 'L' | 'M' | 'Q' | 'H';
+export interface OptionsQr {
+  /** Defaut : `M`, le compromis d'un ecran (reflets, capteur mediocre). */
+  readonly correction?: CorrectionQr;
+  /** Bornes de version, 1 a 40 (defaut : toutes). */
+  readonly versionMin?: number;
+  readonly versionMax?: number;
+  /** Un masque impose (0 a 7) ; defaut : celui de moindre penalite (7.8.3). */
+  readonly masque?: number | null;
+}
+/** Le symbole encode : `modules[y][x]` est vrai pour un module sombre, zone silencieuse exclue. */
+export interface MatriceQr {
+  readonly version: number;
+  readonly taille: number;
+  readonly correction: CorrectionQr;
+  readonly masque: number;
+  readonly modules: readonly (readonly boolean[])[];
+}
+/**
+ * Encode `texte` en symbole QR. Leve une `RangeError` quand il ne tient dans aucune version
+ * permise, ou quand une option sort de ses bornes.
+ */
+export declare function encoderQr(texte: string, options?: OptionsQr): MatriceQr;
+/** Un module sombre, en coordonnees du symbole (zone silencieuse comprise). */
+interface ModuleSombre {
+  readonly x: number;
+  readonly y: number;
+}
+/**
+ * Un code QR (lot 264) : l'URI d'enrolement d'un authentificateur (`otpauth://`, reponse
+ * `EnrollTotpResponse.otpauthUri` d'identity), ou un virement SEPA a scanner (EPC QR).
+ *
+ * ```html
+ * <st-qr-code [valeur]="enrolement().otpauthUri" etiquette="Code QR de votre authentificateur">
+ *   <p complement>
+ *     Ou saisissez la cle :
+ *     <st-code etiquette="Cle de l'authentificateur" [valeur]="enrolement().secret" />
+ *   </p>
+ * </st-qr-code>
+ * ```
+ *
+ * - La cle est un SECRET : `st-code` la copie, mais ne la met jamais dans le nom de son bouton
+ *   (« Copier : Cle de l'authentificateur », audit du 2026-09-27, A-11).
+ * - Un `svg` `role="img"` NOMME, dessine module par module (`@for`, un `rect` par module sombre) :
+ *   aucun `innerHTML`, aucune chaine SVG fabriquee (regles-front, §4).
+ * - Toujours sombre sur clair, zone silencieuse de quatre modules comprise, meme en theme sombre :
+ *   un symbole inverse n'est pas lu par tous les lecteurs (sous contraste force, les couleurs du
+ *   systeme).
+ * - Le `[complement]` projete est OBLIGATOIRE (avertissement en developpement) : un code QR ne se
+ *   lit ni a l'oreille ni sur l'ecran qui l'affiche ; le complement dit la meme chose en texte (la
+ *   cle a saisir, les coordonnees du virement).
+ * - Une valeur trop longue pour le niveau demande ne dessine rien (erreur en developpement) : le
+ *   complement reste.
+ */
+export declare class StQrCode {
+  /** Le texte encode (URI `otpauth://`, charge utile EPC), jamais affiche tel quel. */
+  readonly valeur: import("@angular/core").InputSignal<string>;
+  /** Le nom du symbole pour les technologies d'assistance, deja traduit. */
+  readonly etiquette: import("@angular/core").InputSignal<string>;
+  /** Le cote du symbole en pixels CSS, zone silencieuse comprise. */
+  readonly taille: import("@angular/core").InputSignal<number>;
+  /** Defaut : `M`, le compromis d'un ecran. */
+  readonly correction: import("@angular/core").InputSignal<CorrectionQr>;
+  private readonly complement;
+  protected readonly matrice: import("@angular/core").Signal<MatriceQr | null>;
+  /** Le cote du symbole en modules, zone silencieuse comprise. */
+  protected readonly cote: import("@angular/core").Signal<number>;
+  protected readonly sombres: import("@angular/core").Signal<readonly ModuleSombre[]>;
+  constructor();
+  static ɵfac: i0.ɵɵFactoryDeclaration<StQrCode, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<StQrCode, "st-qr-code", never, {
+    "valeur": {
+      "alias": "valeur";
+      "required": true;
+      "isSignal": true;
+    };
+    "etiquette": {
+      "alias": "etiquette";
+      "required": true;
+      "isSignal": true;
+    };
+    "taille": {
+      "alias": "taille";
+      "required": false;
+      "isSignal": true;
+    };
+    "correction": {
+      "alias": "correction";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, ["[complement]"], true, never>;
+}
+
+export {};