@starterlib/util 0.1.0

package/README.md

@@ -0,0 +1,64 @@
+# Util
+
+This project was generated using [Angular CLI](https://github.com/angular/angular-cli) version 22.1.0.
+
+## Code scaffolding
+
+Angular CLI includes powerful code scaffolding tools. To generate a new component, run:
+
+```bash
+ng generate component component-name
+```
+
+For a complete list of available schematics (such as `components`, `directives`, or `pipes`), run:
+
+```bash
+ng generate --help
+```
+
+## Building
+
+To build the library, run:
+
+```bash
+ng build util
+```
+
+This command will compile your project, and the build artifacts will be placed in the `dist/` directory.
+
+### Publishing the Library
+
+Once the project is built, you can publish your library by following these steps:
+
+1. Navigate to the `dist` directory:
+
+   ```bash
+   cd dist/util
+   ```
+
+2. Run the `npm publish` command to publish your library to the npm registry:
+   ```bash
+   npm publish
+   ```
+
+## Running unit tests
+
+To execute unit tests with the [Vitest](https://vitest.dev/) test runner, use the following command:
+
+```bash
+ng test
+```
+
+## Running end-to-end tests
+
+For end-to-end (e2e) testing, run:
+
+```bash
+ng e2e
+```
+
+Angular CLI does not come with an end-to-end testing framework by default. You can choose one that suits your needs.
+
+## Additional Resources
+
+For more information on using the Angular CLI, including detailed command references, visit the [Angular CLI Overview and Command Reference](https://angular.dev/tools/cli) page.

package/fesm2022/starterlib-util.mjs

@@ -0,0 +1,225 @@
+/**
+ * Formatage monetaire. Il vit dans le socle et non dans chaque SPA parce
+ * qu'une somme mal arrondie ou mal signee est un defaut bancaire, pas un
+ * defaut d'affichage.
+ */
+/** Devises a zero decimale : le yen n'a pas de centime. */
+const SANS_DECIMALE = new Set(['JPY', 'KRW', 'VND', 'XAF', 'XOF', 'CLP', 'ISK']);
+/** Devises a trois decimales. */
+const TROIS_DECIMALES = new Set(['BHD', 'IQD', 'JOD', 'KWD', 'LYD', 'OMR', 'TND']);
+function decimalesDe(devise) {
+    const code = devise.toUpperCase();
+    if (SANS_DECIMALE.has(code))
+        return 0;
+    if (TROIS_DECIMALES.has(code))
+        return 3;
+    return 2;
+}
+function montant(unitesMineures, devise) {
+    if (!/^[A-Za-z]{3}$/.test(devise)) {
+        throw new Error(`Code devise invalide : ${devise}`);
+    }
+    if (typeof unitesMineures === 'number' && !Number.isInteger(unitesMineures)) {
+        throw new Error(`Un montant se compte en unites mineures entieres, recu : ${String(unitesMineures)}`);
+    }
+    return { unitesMineures: BigInt(unitesMineures), devise: devise.toUpperCase() };
+}
+/**
+ * Rend un montant dans la locale demandee. La conversion en nombre n'a lieu
+ * qu'a l'instant du rendu, sur une valeur bornee par la precision d'affichage :
+ * le calcul, lui, n'a jamais quitte l'entier.
+ */
+function formaterMontant(valeur, options = {}) {
+    const { locale = 'fr-FR', signeExplicite = false, sansDevise = false } = options;
+    const decimales = decimalesDe(valeur.devise);
+    const negatif = valeur.unitesMineures < 0n;
+    const absolu = negatif ? -valeur.unitesMineures : valeur.unitesMineures;
+    const diviseur = 10n ** BigInt(decimales);
+    const entiere = absolu / diviseur;
+    const fraction = absolu % diviseur;
+    const formateur = new Intl.NumberFormat(locale, {
+        style: sansDevise ? 'decimal' : 'currency',
+        currency: valeur.devise,
+        minimumFractionDigits: decimales,
+        maximumFractionDigits: decimales,
+        signDisplay: 'never',
+    });
+    const nombre = decimales === 0
+        ? Number(entiere)
+        : Number(`${entiere.toString()}.${fraction.toString().padStart(decimales, '0')}`);
+    const rendu = formateur.format(nombre);
+    if (negatif)
+        return `−${rendu}`;
+    return signeExplicite && valeur.unitesMineures > 0n ? `+${rendu}` : rendu;
+}
+
+/**
+ * IBAN : validation par la cle ISO 7064 mod 97-10 et presentation par groupes
+ * de quatre. La validation vit ici pour qu'un champ de saisie refuse une
+ * frappe fautive sans aller-retour serveur ; elle ne remplace jamais le
+ * controle du backend.
+ */
+const LONGUEURS = {
+    FR: 27,
+    DE: 22,
+    ES: 24,
+    IT: 27,
+    BE: 16,
+    PT: 25,
+    NL: 18,
+    LU: 20,
+    CH: 21,
+    GB: 22,
+    IE: 22,
+    AT: 20,
+    PL: 28,
+    SE: 24,
+    NO: 15,
+    DK: 18,
+    FI: 18,
+    CZ: 24,
+    GR: 27,
+    RO: 24,
+    BG: 22,
+    HR: 21,
+    HU: 28,
+    SK: 24,
+    SI: 19,
+    LT: 20,
+    LV: 21,
+    EE: 20,
+    MT: 31,
+    CY: 28,
+    MC: 27,
+    SM: 27,
+};
+function normaliserIban(saisie) {
+    return saisie.replace(/[\s-]/g, '').toUpperCase();
+}
+/** Modulo 97 sur la chaine, chiffre par chiffre : un IBAN depasse la
+ * precision d'un nombre JavaScript. */
+function mod97(chaine) {
+    let reste = 0;
+    for (const caractere of chaine) {
+        reste = (reste * 10 + Number(caractere)) % 97;
+    }
+    return reste;
+}
+function ibanEstValide(saisie) {
+    const iban = normaliserIban(saisie);
+    if (!/^[A-Z]{2}[0-9]{2}[A-Z0-9]{10,30}$/.test(iban))
+        return false;
+    const pays = iban.slice(0, 2);
+    const longueurAttendue = LONGUEURS[pays];
+    if (longueurAttendue !== undefined && iban.length !== longueurAttendue)
+        return false;
+    const permute = iban.slice(4) + iban.slice(0, 4);
+    const numerique = permute.replace(/[A-Z]/g, (l) => (l.charCodeAt(0) - 55).toString());
+    return mod97(numerique) === 1;
+}
+/** Presentation par groupes de quatre, la seule lisible a l'oeil. */
+function formaterIban(saisie) {
+    return normaliserIban(saisie)
+        .replace(/(.{4})/g, '$1 ')
+        .trim();
+}
+/**
+ * Masque tout sauf le pays et les quatre derniers caracteres. Un IBAN complet
+ * ne s'affiche jamais dans une liste : il suffit a initier un prelevement.
+ */
+function masquerIban(saisie) {
+    const iban = normaliserIban(saisie);
+    if (iban.length < 8)
+        return '•'.repeat(iban.length);
+    const tete = iban.slice(0, 4);
+    const queue = iban.slice(-4);
+    return formaterIban(tete + '•'.repeat(iban.length - 8) + queue);
+}
+
+/**
+ * Masques d'affichage des identifiants sensibles.
+ *
+ * Regle commune : on garde de quoi RECONNAITRE, jamais de quoi UTILISER. Un
+ * numero complet affiche dans une liste suffit a initier une operation ; les
+ * quatre derniers caracteres suffisent a l'utilisateur pour savoir de quel
+ * moyen il s'agit.
+ */
+/** Groupe par quatre, la seule presentation lisible a l'oeil. */
+function grouperParQuatre(valeur) {
+    return valeur.replace(/(.{4})/g, '$1 ').trim();
+}
+function normaliserCarte(saisie) {
+    return saisie.replace(/[\s-]/g, '');
+}
+/**
+ * Ne laisse voir que les quatre derniers chiffres. Le reseau (les premiers
+ * chiffres) est volontairement masque : il identifie l'emetteur.
+ */
+function masquerCarte(saisie) {
+    const carte = normaliserCarte(saisie);
+    if (carte.length <= 4)
+        return '•'.repeat(carte.length);
+    return grouperParQuatre('•'.repeat(carte.length - 4) + carte.slice(-4));
+}
+/**
+ * Validation de carte par la cle de Luhn. Elle sert a refuser une frappe
+ * fautive sans aller-retour serveur ; elle ne prouve rien sur l'existence du
+ * moyen de paiement.
+ */
+function carteEstValide(saisie) {
+    const carte = normaliserCarte(saisie);
+    if (!/^[0-9]{12,19}$/.test(carte))
+        return false;
+    let somme = 0;
+    let double = false;
+    for (let index = carte.length - 1; index >= 0; index--) {
+        let chiffre = Number(carte[index]);
+        if (double) {
+            chiffre *= 2;
+            if (chiffre > 9)
+                chiffre -= 9;
+        }
+        somme += chiffre;
+        double = !double;
+    }
+    return somme % 10 === 0;
+}
+function normaliserTelephone(saisie) {
+    return saisie.replace(/[\s.\-()]/g, '');
+}
+/**
+ * Garde l'indicatif international et les deux derniers chiffres. Un numero
+ * entier permet d'usurper, de harceler, ou de tenter une prise de controle
+ * par message.
+ */
+function masquerTelephone(saisie) {
+    const numero = normaliserTelephone(saisie);
+    const indicatif = numero.startsWith('+') ? numero.slice(0, 3) : '';
+    const reste = numero.slice(indicatif.length);
+    if (reste.length <= 2)
+        return indicatif + '•'.repeat(reste.length);
+    return `${indicatif}${'•'.repeat(reste.length - 2)}${reste.slice(-2)}`;
+}
+/**
+ * Fin lisible d'un identifiant, pour composer un nom accessible : une suite de
+ * puces est epelee caractere par caractere par plusieurs lecteurs d'ecran.
+ */
+function quatreDerniers(saisie) {
+    const valeur = saisie.replace(/[\s-]/g, '');
+    return valeur.slice(-4);
+}
+
+/**
+ * @starterlib/util — fonctions pures partagees.
+ *
+ * Regle du paquet : aucune dependance Angular, aucun effet de bord, aucune
+ * lecture d'horloge ni de `window`. Tout ce qui vit ici doit se tester sans
+ * banc d'essai Angular.
+ */
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { carteEstValide, decimalesDe, formaterIban, formaterMontant, ibanEstValide, masquerCarte, masquerIban, masquerTelephone, montant, normaliserCarte, normaliserIban, normaliserTelephone, quatreDerniers };
+//# sourceMappingURL=starterlib-util.mjs.map

package/fesm2022/starterlib-util.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"starterlib-util.mjs","sources":["../../../../packages/util/src/lib/montant.ts","../../../../packages/util/src/lib/iban.ts","../../../../packages/util/src/lib/masque.ts","../../../../packages/util/src/public-api.ts","../../../../packages/util/src/starterlib-util.ts"],"sourcesContent":["/**\n * Formatage monetaire. Il vit dans le socle et non dans chaque SPA parce\n * qu'une somme mal arrondie ou mal signee est un defaut bancaire, pas un\n * defaut d'affichage.\n */\n\n/**\n * Un montant ne se represente JAMAIS par un nombre a virgule flottante :\n * 0.1 + 0.2 ne fait pas 0.3. On transporte des unites mineures entieres\n * (centimes) et la devise qui leur donne leur echelle.\n */\nexport interface Montant {\n  /** Unites mineures. 12,34 EUR s'ecrit 1234. */\n  readonly unitesMineures: bigint;\n  /** Code ISO 4217, trois lettres majuscules. */\n  readonly devise: string;\n}\n\n/** Devises a zero decimale : le yen n'a pas de centime. */\nconst SANS_DECIMALE = new Set(['JPY', 'KRW', 'VND', 'XAF', 'XOF', 'CLP', 'ISK']);\n/** Devises a trois decimales. */\nconst TROIS_DECIMALES = new Set(['BHD', 'IQD', 'JOD', 'KWD', 'LYD', 'OMR', 'TND']);\n\nexport function decimalesDe(devise: string): number {\n  const code = devise.toUpperCase();\n  if (SANS_DECIMALE.has(code)) return 0;\n  if (TROIS_DECIMALES.has(code)) return 3;\n  return 2;\n}\n\nexport function montant(unitesMineures: bigint | number, devise: string): Montant {\n  if (!/^[A-Za-z]{3}$/.test(devise)) {\n    throw new Error(`Code devise invalide : ${devise}`);\n  }\n  if (typeof unitesMineures === 'number' && !Number.isInteger(unitesMineures)) {\n    throw new Error(\n      `Un montant se compte en unites mineures entieres, recu : ${String(unitesMineures)}`,\n    );\n  }\n  return { unitesMineures: BigInt(unitesMineures), devise: devise.toUpperCase() };\n}\n\nexport interface OptionsDeFormatage {\n  readonly locale?: string;\n  /** Affiche `+` devant un montant positif. Utile sur un releve. */\n  readonly signeExplicite?: boolean;\n  /** Masque le symbole de devise (colonnes de tableau deja titrees). */\n  readonly sansDevise?: boolean;\n}\n\n/**\n * Rend un montant dans la locale demandee. La conversion en nombre n'a lieu\n * qu'a l'instant du rendu, sur une valeur bornee par la precision d'affichage :\n * le calcul, lui, n'a jamais quitte l'entier.\n */\nexport function formaterMontant(valeur: Montant, options: OptionsDeFormatage = {}): string {\n  const { locale = 'fr-FR', signeExplicite = false, sansDevise = false } = options;\n  const decimales = decimalesDe(valeur.devise);\n  const negatif = valeur.unitesMineures < 0n;\n  const absolu = negatif ? -valeur.unitesMineures : valeur.unitesMineures;\n  const diviseur = 10n ** BigInt(decimales);\n  const entiere = absolu / diviseur;\n  const fraction = absolu % diviseur;\n\n  const formateur = new Intl.NumberFormat(locale, {\n    style: sansDevise ? 'decimal' : 'currency',\n    currency: valeur.devise,\n    minimumFractionDigits: decimales,\n    maximumFractionDigits: decimales,\n    signDisplay: 'never',\n  });\n\n  const nombre =\n    decimales === 0\n      ? Number(entiere)\n      : Number(`${entiere.toString()}.${fraction.toString().padStart(decimales, '0')}`);\n\n  const rendu = formateur.format(nombre);\n  if (negatif) return `−${rendu}`;\n  return signeExplicite && valeur.unitesMineures > 0n ? `+${rendu}` : rendu;\n}\n","/**\n * IBAN : validation par la cle ISO 7064 mod 97-10 et presentation par groupes\n * de quatre. La validation vit ici pour qu'un champ de saisie refuse une\n * frappe fautive sans aller-retour serveur ; elle ne remplace jamais le\n * controle du backend.\n */\n\nconst LONGUEURS: Readonly<Record<string, number>> = {\n  FR: 27,\n  DE: 22,\n  ES: 24,\n  IT: 27,\n  BE: 16,\n  PT: 25,\n  NL: 18,\n  LU: 20,\n  CH: 21,\n  GB: 22,\n  IE: 22,\n  AT: 20,\n  PL: 28,\n  SE: 24,\n  NO: 15,\n  DK: 18,\n  FI: 18,\n  CZ: 24,\n  GR: 27,\n  RO: 24,\n  BG: 22,\n  HR: 21,\n  HU: 28,\n  SK: 24,\n  SI: 19,\n  LT: 20,\n  LV: 21,\n  EE: 20,\n  MT: 31,\n  CY: 28,\n  MC: 27,\n  SM: 27,\n};\n\nexport function normaliserIban(saisie: string): string {\n  return saisie.replace(/[\\s-]/g, '').toUpperCase();\n}\n\n/** Modulo 97 sur la chaine, chiffre par chiffre : un IBAN depasse la\n * precision d'un nombre JavaScript. */\nfunction mod97(chaine: string): number {\n  let reste = 0;\n  for (const caractere of chaine) {\n    reste = (reste * 10 + Number(caractere)) % 97;\n  }\n  return reste;\n}\n\nexport function ibanEstValide(saisie: string): boolean {\n  const iban = normaliserIban(saisie);\n  if (!/^[A-Z]{2}[0-9]{2}[A-Z0-9]{10,30}$/.test(iban)) return false;\n\n  const pays = iban.slice(0, 2);\n  const longueurAttendue = LONGUEURS[pays];\n  if (longueurAttendue !== undefined && iban.length !== longueurAttendue) return false;\n\n  const permute = iban.slice(4) + iban.slice(0, 4);\n  const numerique = permute.replace(/[A-Z]/g, (l) => (l.charCodeAt(0) - 55).toString());\n  return mod97(numerique) === 1;\n}\n\n/** Presentation par groupes de quatre, la seule lisible a l'oeil. */\nexport function formaterIban(saisie: string): string {\n  return normaliserIban(saisie)\n    .replace(/(.{4})/g, '$1 ')\n    .trim();\n}\n\n/**\n * Masque tout sauf le pays et les quatre derniers caracteres. Un IBAN complet\n * ne s'affiche jamais dans une liste : il suffit a initier un prelevement.\n */\nexport function masquerIban(saisie: string): string {\n  const iban = normaliserIban(saisie);\n  if (iban.length < 8) return '•'.repeat(iban.length);\n  const tete = iban.slice(0, 4);\n  const queue = iban.slice(-4);\n  return formaterIban(tete + '•'.repeat(iban.length - 8) + queue);\n}\n","/**\n * Masques d'affichage des identifiants sensibles.\n *\n * Regle commune : on garde de quoi RECONNAITRE, jamais de quoi UTILISER. Un\n * numero complet affiche dans une liste suffit a initier une operation ; les\n * quatre derniers caracteres suffisent a l'utilisateur pour savoir de quel\n * moyen il s'agit.\n */\n\n/** Groupe par quatre, la seule presentation lisible a l'oeil. */\nfunction grouperParQuatre(valeur: string): string {\n  return valeur.replace(/(.{4})/g, '$1 ').trim();\n}\n\nexport function normaliserCarte(saisie: string): string {\n  return saisie.replace(/[\\s-]/g, '');\n}\n\n/**\n * Ne laisse voir que les quatre derniers chiffres. Le reseau (les premiers\n * chiffres) est volontairement masque : il identifie l'emetteur.\n */\nexport function masquerCarte(saisie: string): string {\n  const carte = normaliserCarte(saisie);\n  if (carte.length <= 4) return '•'.repeat(carte.length);\n  return grouperParQuatre('•'.repeat(carte.length - 4) + carte.slice(-4));\n}\n\n/**\n * Validation de carte par la cle de Luhn. Elle sert a refuser une frappe\n * fautive sans aller-retour serveur ; elle ne prouve rien sur l'existence du\n * moyen de paiement.\n */\nexport function carteEstValide(saisie: string): boolean {\n  const carte = normaliserCarte(saisie);\n  if (!/^[0-9]{12,19}$/.test(carte)) return false;\n\n  let somme = 0;\n  let double = false;\n  for (let index = carte.length - 1; index >= 0; index--) {\n    let chiffre = Number(carte[index]);\n    if (double) {\n      chiffre *= 2;\n      if (chiffre > 9) chiffre -= 9;\n    }\n    somme += chiffre;\n    double = !double;\n  }\n  return somme % 10 === 0;\n}\n\nexport function normaliserTelephone(saisie: string): string {\n  return saisie.replace(/[\\s.\\-()]/g, '');\n}\n\n/**\n * Garde l'indicatif international et les deux derniers chiffres. Un numero\n * entier permet d'usurper, de harceler, ou de tenter une prise de controle\n * par message.\n */\nexport function masquerTelephone(saisie: string): string {\n  const numero = normaliserTelephone(saisie);\n  const indicatif = numero.startsWith('+') ? numero.slice(0, 3) : '';\n  const reste = numero.slice(indicatif.length);\n  if (reste.length <= 2) return indicatif + '•'.repeat(reste.length);\n  return `${indicatif}${'•'.repeat(reste.length - 2)}${reste.slice(-2)}`;\n}\n\n/**\n * Fin lisible d'un identifiant, pour composer un nom accessible : une suite de\n * puces est epelee caractere par caractere par plusieurs lecteurs d'ecran.\n */\nexport function quatreDerniers(saisie: string): string {\n  const valeur = saisie.replace(/[\\s-]/g, '');\n  return valeur.slice(-4);\n}\n","/**\n * @starterlib/util — fonctions pures partagees.\n *\n * Regle du paquet : aucune dependance Angular, aucun effet de bord, aucune\n * lecture d'horloge ni de `window`. Tout ce qui vit ici doit se tester sans\n * banc d'essai Angular.\n */\nexport * from './lib/montant';\nexport * from './lib/iban';\nexport * from './lib/masque';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"AAAA;;;;AAIG;AAcH;AACA,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAChF;AACA,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAE5E,SAAU,WAAW,CAAC,MAAc,EAAA;AACxC,IAAA,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE;AACjC,IAAA,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC;AAAE,QAAA,OAAO,CAAC;AACrC,IAAA,IAAI,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC;AAAE,QAAA,OAAO,CAAC;AACvC,IAAA,OAAO,CAAC;AACV;AAEM,SAAU,OAAO,CAAC,cAA+B,EAAE,MAAc,EAAA;IACrE,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;AACjC,QAAA,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,CAAA,CAAE,CAAC;IACrD;AACA,IAAA,IAAI,OAAO,cAAc,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE;QAC3E,MAAM,IAAI,KAAK,CACb,CAAA,yDAAA,EAA4D,MAAM,CAAC,cAAc,CAAC,CAAA,CAAE,CACrF;IACH;AACA,IAAA,OAAO,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,EAAE;AACjF;AAUA;;;;AAIG;SACa,eAAe,CAAC,MAAe,EAAE,UAA8B,EAAE,EAAA;AAC/E,IAAA,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,cAAc,GAAG,KAAK,EAAE,UAAU,GAAG,KAAK,EAAE,GAAG,OAAO;IAChF,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC;AAC5C,IAAA,MAAM,OAAO,GAAG,MAAM,CAAC,cAAc,GAAG,EAAE;AAC1C,IAAA,MAAM,MAAM,GAAG,OAAO,GAAG,CAAC,MAAM,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc;IACvE,MAAM,QAAQ,GAAG,GAAG,IAAI,MAAM,CAAC,SAAS,CAAC;AACzC,IAAA,MAAM,OAAO,GAAG,MAAM,GAAG,QAAQ;AACjC,IAAA,MAAM,QAAQ,GAAG,MAAM,GAAG,QAAQ;IAElC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE;QAC9C,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,UAAU;QAC1C,QAAQ,EAAE,MAAM,CAAC,MAAM;AACvB,QAAA,qBAAqB,EAAE,SAAS;AAChC,QAAA,qBAAqB,EAAE,SAAS;AAChC,QAAA,WAAW,EAAE,OAAO;AACrB,KAAA,CAAC;AAEF,IAAA,MAAM,MAAM,GACV,SAAS,KAAK;AACZ,UAAE,MAAM,CAAC,OAAO;UACd,MAAM,CAAC,CAAA,EAAG,OAAO,CAAC,QAAQ,EAAE,CAAA,CAAA,EAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,CAAA,CAAE,CAAC;IAErF,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC;AACtC,IAAA,IAAI,OAAO;QAAE,OAAO,CAAA,CAAA,EAAI,KAAK,CAAA,CAAE;AAC/B,IAAA,OAAO,cAAc,IAAI,MAAM,CAAC,cAAc,GAAG,EAAE,GAAG,IAAI,KAAK,CAAA,CAAE,GAAG,KAAK;AAC3E;;AChFA;;;;;AAKG;AAEH,MAAM,SAAS,GAAqC;AAClD,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;CACP;AAEK,SAAU,cAAc,CAAC,MAAc,EAAA;IAC3C,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE;AACnD;AAEA;AACuC;AACvC,SAAS,KAAK,CAAC,MAAc,EAAA;IAC3B,IAAI,KAAK,GAAG,CAAC;AACb,IAAA,KAAK,MAAM,SAAS,IAAI,MAAM,EAAE;AAC9B,QAAA,KAAK,GAAG,CAAC,KAAK,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE;IAC/C;AACA,IAAA,OAAO,KAAK;AACd;AAEM,SAAU,aAAa,CAAC,MAAc,EAAA;AAC1C,IAAA,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,CAAC;AACnC,IAAA,IAAI,CAAC,mCAAmC,CAAC,IAAI,CAAC,IAAI,CAAC;AAAE,QAAA,OAAO,KAAK;IAEjE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;AAC7B,IAAA,MAAM,gBAAgB,GAAG,SAAS,CAAC,IAAI,CAAC;IACxC,IAAI,gBAAgB,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,gBAAgB;AAAE,QAAA,OAAO,KAAK;AAEpF,IAAA,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,CAAC;AACrF,IAAA,OAAO,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC;AAC/B;AAEA;AACM,SAAU,YAAY,CAAC,MAAc,EAAA;IACzC,OAAO,cAAc,CAAC,MAAM;AACzB,SAAA,OAAO,CAAC,SAAS,EAAE,KAAK;AACxB,SAAA,IAAI,EAAE;AACX;AAEA;;;AAGG;AACG,SAAU,WAAW,CAAC,MAAc,EAAA;AACxC,IAAA,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,CAAC;AACnC,IAAA,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;IACnD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC5B,IAAA,OAAO,YAAY,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;AACjE;;ACtFA;;;;;;;AAOG;AAEH;AACA,SAAS,gBAAgB,CAAC,MAAc,EAAA;IACtC,OAAO,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE;AAChD;AAEM,SAAU,eAAe,CAAC,MAAc,EAAA;IAC5C,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;AACrC;AAEA;;;AAGG;AACG,SAAU,YAAY,CAAC,MAAc,EAAA;AACzC,IAAA,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC;AACrC,IAAA,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;IACtD,OAAO,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACzE;AAEA;;;;AAIG;AACG,SAAU,cAAc,CAAC,MAAc,EAAA;AAC3C,IAAA,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC;AACrC,IAAA,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC;AAAE,QAAA,OAAO,KAAK;IAE/C,IAAI,KAAK,GAAG,CAAC;IACb,IAAI,MAAM,GAAG,KAAK;AAClB,IAAA,KAAK,IAAI,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE;QACtD,IAAI,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,MAAM,EAAE;YACV,OAAO,IAAI,CAAC;YACZ,IAAI,OAAO,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC/B;QACA,KAAK,IAAI,OAAO;QAChB,MAAM,GAAG,CAAC,MAAM;IAClB;AACA,IAAA,OAAO,KAAK,GAAG,EAAE,KAAK,CAAC;AACzB;AAEM,SAAU,mBAAmB,CAAC,MAAc,EAAA;IAChD,OAAO,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;AACzC;AAEA;;;;AAIG;AACG,SAAU,gBAAgB,CAAC,MAAc,EAAA;AAC7C,IAAA,MAAM,MAAM,GAAG,mBAAmB,CAAC,MAAM,CAAC;IAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE;IAClE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC;AAC5C,IAAA,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;IAClE,OAAO,CAAA,EAAG,SAAS,CAAA,EAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA,EAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA,CAAE;AACxE;AAEA;;;AAGG;AACG,SAAU,cAAc,CAAC,MAAc,EAAA;IAC3C,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;AAC3C,IAAA,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACzB;;AC3EA;;;;;;AAMG;;ACNH;;AAEG;;"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@starterlib/util",
+  "version": "0.1.0",
+  "description": "Fonctions pures du socle frontal starter : montants en unites mineures, IBAN, formatage. Aucune dependance Angular.",
+  "license": "UNLICENSED",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Arnoldkom/starter-web-platform.git",
+    "directory": "packages/util"
+  },
+  "homepage": "https://github.com/Arnoldkom/starter-web-platform/tree/main/packages/util#readme",
+  "keywords": [
+    "starter",
+    "socle-frontal",
+    "util"
+  ],
+  "module": "fesm2022/starterlib-util.mjs",
+  "typings": "types/starterlib-util.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/starterlib-util.d.ts",
+      "default": "./fesm2022/starterlib-util.mjs"
+    }
+  },
+  "type": "module",
+  "dependencies": {
+    "tslib": "^2.3.0"
+  }
+}

package/types/starterlib-util.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Formatage monetaire. Il vit dans le socle et non dans chaque SPA parce
+ * qu'une somme mal arrondie ou mal signee est un defaut bancaire, pas un
+ * defaut d'affichage.
+ */
+/**
+ * Un montant ne se represente JAMAIS par un nombre a virgule flottante :
+ * 0.1 + 0.2 ne fait pas 0.3. On transporte des unites mineures entieres
+ * (centimes) et la devise qui leur donne leur echelle.
+ */
+interface Montant {
+    /** Unites mineures. 12,34 EUR s'ecrit 1234. */
+    readonly unitesMineures: bigint;
+    /** Code ISO 4217, trois lettres majuscules. */
+    readonly devise: string;
+}
+declare function decimalesDe(devise: string): number;
+declare function montant(unitesMineures: bigint | number, devise: string): Montant;
+interface OptionsDeFormatage {
+    readonly locale?: string;
+    /** Affiche `+` devant un montant positif. Utile sur un releve. */
+    readonly signeExplicite?: boolean;
+    /** Masque le symbole de devise (colonnes de tableau deja titrees). */
+    readonly sansDevise?: boolean;
+}
+/**
+ * Rend un montant dans la locale demandee. La conversion en nombre n'a lieu
+ * qu'a l'instant du rendu, sur une valeur bornee par la precision d'affichage :
+ * le calcul, lui, n'a jamais quitte l'entier.
+ */
+declare function formaterMontant(valeur: Montant, options?: OptionsDeFormatage): string;
+
+/**
+ * IBAN : validation par la cle ISO 7064 mod 97-10 et presentation par groupes
+ * de quatre. La validation vit ici pour qu'un champ de saisie refuse une
+ * frappe fautive sans aller-retour serveur ; elle ne remplace jamais le
+ * controle du backend.
+ */
+declare function normaliserIban(saisie: string): string;
+declare function ibanEstValide(saisie: string): boolean;
+/** Presentation par groupes de quatre, la seule lisible a l'oeil. */
+declare function formaterIban(saisie: string): string;
+/**
+ * Masque tout sauf le pays et les quatre derniers caracteres. Un IBAN complet
+ * ne s'affiche jamais dans une liste : il suffit a initier un prelevement.
+ */
+declare function masquerIban(saisie: string): string;
+
+/**
+ * Masques d'affichage des identifiants sensibles.
+ *
+ * Regle commune : on garde de quoi RECONNAITRE, jamais de quoi UTILISER. Un
+ * numero complet affiche dans une liste suffit a initier une operation ; les
+ * quatre derniers caracteres suffisent a l'utilisateur pour savoir de quel
+ * moyen il s'agit.
+ */
+declare function normaliserCarte(saisie: string): string;
+/**
+ * Ne laisse voir que les quatre derniers chiffres. Le reseau (les premiers
+ * chiffres) est volontairement masque : il identifie l'emetteur.
+ */
+declare function masquerCarte(saisie: string): string;
+/**
+ * Validation de carte par la cle de Luhn. Elle sert a refuser une frappe
+ * fautive sans aller-retour serveur ; elle ne prouve rien sur l'existence du
+ * moyen de paiement.
+ */
+declare function carteEstValide(saisie: string): boolean;
+declare function normaliserTelephone(saisie: string): string;
+/**
+ * Garde l'indicatif international et les deux derniers chiffres. Un numero
+ * entier permet d'usurper, de harceler, ou de tenter une prise de controle
+ * par message.
+ */
+declare function masquerTelephone(saisie: string): string;
+/**
+ * Fin lisible d'un identifiant, pour composer un nom accessible : une suite de
+ * puces est epelee caractere par caractere par plusieurs lecteurs d'ecran.
+ */
+declare function quatreDerniers(saisie: string): string;
+
+export { carteEstValide, decimalesDe, formaterIban, formaterMontant, ibanEstValide, masquerCarte, masquerIban, masquerTelephone, montant, normaliserCarte, normaliserIban, normaliserTelephone, quatreDerniers };
+export type { Montant, OptionsDeFormatage };