@starterlib/testing 0.1.0

package/README.md

@@ -0,0 +1,64 @@
+# Testing
+
+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 testing
+```
+
+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/testing
+   ```
+
+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-testing.mjs

@@ -0,0 +1,69 @@
+import axe from 'axe-core';
+
+/**
+ * Verification d'accessibilite d'un fragment rendu. Elle sert dans CHAQUE test
+ * de composant : une violation qui entre dans la librairie se retrouve dans
+ * toutes les SPA qui la consomment.
+ *
+ * ⚠️ Limite honnete : jsdom ne calcule pas la mise en page, donc la regle de
+ * contraste d'axe ne peut pas s'executer ici. Le contraste est couvert
+ * autrement, et mieux : `@starterlib/tokens` verifie chaque paire semantique
+ * dans les deux themes par calcul WCAG. Desactiver la regle ici n'ouvre donc
+ * aucun trou, mais le dire evite de croire qu'elle a tourne.
+ */
+const REGLES_INAPPLICABLES_EN_JSDOM = {
+    'color-contrast': { enabled: false },
+};
+function decrire(violation) {
+    const cibles = violation.nodes
+        .map((noeud) => noeud.target.join(' '))
+        .slice(0, 3)
+        .join(', ');
+    return (`  [${violation.impact ?? 'inconnu'}] ${violation.id} : ${violation.help}\n` +
+        `      elements : ${cibles}\n` +
+        `      aide     : ${violation.helpUrl}`);
+}
+/**
+ * Execute axe et leve si une violation bloquante subsiste. Le message nomme
+ * TOUTES les violations d'un coup, pas la premiere : corriger une regle a la
+ * fois sur un composant fait perdre un cycle par violation.
+ */
+async function verifierAccessibilite(cible, options = {}) {
+    const exemptions = options.exemptions ?? {};
+    const regles = { ...REGLES_INAPPLICABLES_EN_JSDOM };
+    for (const identifiant of Object.keys(exemptions)) {
+        regles[identifiant] = { enabled: false };
+    }
+    const configuration = { rules: regles };
+    const resultats = await axe.run(cible, configuration);
+    const bloquantes = options.gravitesBloquantes;
+    const violations = bloquantes === undefined
+        ? resultats.violations
+        : resultats.violations.filter((violation) => violation.impact !== null &&
+            violation.impact !== undefined &&
+            bloquantes.includes(violation.impact));
+    if (violations.length > 0) {
+        const detail = violations.map(decrire).join('\n');
+        throw new Error(`${violations.length.toString()} violation(s) d'accessibilite :\n${detail}`);
+    }
+}
+/** Les regles desactivees et leur raison, pour qu'un test puisse les afficher. */
+const REGLES_DESACTIVEES_PAR_DEFAUT = {
+    'color-contrast': 'jsdom ne calcule pas la mise en page. Le contraste est verifie par calcul ' +
+        'WCAG dans @starterlib/tokens, sur chaque paire semantique et dans les deux themes.',
+};
+
+/**
+ * @starterlib/testing — surface publique.
+ *
+ * Le paquet est cree, outille et publiable ; son contenu arrive par vagues
+ * (voir docs/plan-librairie.md). Rien n'est exporte tant que rien n'est
+ * eprouve : un export vide vaut mieux qu'un composant a moitie monte.
+ */
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { REGLES_DESACTIVEES_PAR_DEFAUT, verifierAccessibilite };
+//# sourceMappingURL=starterlib-testing.mjs.map

package/fesm2022/starterlib-testing.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"starterlib-testing.mjs","sources":["../../../../packages/testing/src/lib/accessibilite.ts","../../../../packages/testing/src/public-api.ts","../../../../packages/testing/src/starterlib-testing.ts"],"sourcesContent":["import axe, { type AxeResults, type ElementContext, type RunOptions, type Result } from 'axe-core';\n\n/**\n * Verification d'accessibilite d'un fragment rendu. Elle sert dans CHAQUE test\n * de composant : une violation qui entre dans la librairie se retrouve dans\n * toutes les SPA qui la consomment.\n *\n * ⚠️ Limite honnete : jsdom ne calcule pas la mise en page, donc la regle de\n * contraste d'axe ne peut pas s'executer ici. Le contraste est couvert\n * autrement, et mieux : `@starterlib/tokens` verifie chaque paire semantique\n * dans les deux themes par calcul WCAG. Desactiver la regle ici n'ouvre donc\n * aucun trou, mais le dire evite de croire qu'elle a tourne.\n */\nconst REGLES_INAPPLICABLES_EN_JSDOM: Readonly<Record<string, { enabled: false }>> = {\n  'color-contrast': { enabled: false },\n};\n\nexport interface OptionsAccessibilite {\n  /** Regles a desactiver en plus, chacune avec sa raison ecrite. */\n  readonly exemptions?: Readonly<Record<string, string>>;\n  /** Niveaux a faire echouer. Par defaut toute violation echoue. */\n  readonly gravitesBloquantes?: readonly ('minor' | 'moderate' | 'serious' | 'critical')[];\n}\n\nfunction decrire(violation: Result): string {\n  const cibles = violation.nodes\n    .map((noeud) => noeud.target.join(' '))\n    .slice(0, 3)\n    .join(', ');\n  return (\n    `  [${violation.impact ?? 'inconnu'}] ${violation.id} : ${violation.help}\\n` +\n    `      elements : ${cibles}\\n` +\n    `      aide     : ${violation.helpUrl}`\n  );\n}\n\n/**\n * Execute axe et leve si une violation bloquante subsiste. Le message nomme\n * TOUTES les violations d'un coup, pas la premiere : corriger une regle a la\n * fois sur un composant fait perdre un cycle par violation.\n */\nexport async function verifierAccessibilite(\n  cible: ElementContext,\n  options: OptionsAccessibilite = {},\n): Promise<void> {\n  const exemptions = options.exemptions ?? {};\n  const regles: Record<string, { enabled: false }> = { ...REGLES_INAPPLICABLES_EN_JSDOM };\n  for (const identifiant of Object.keys(exemptions)) {\n    regles[identifiant] = { enabled: false };\n  }\n\n  const configuration: RunOptions = { rules: regles };\n  const resultats: AxeResults = await axe.run(cible, configuration);\n\n  const bloquantes = options.gravitesBloquantes;\n  const violations =\n    bloquantes === undefined\n      ? resultats.violations\n      : resultats.violations.filter(\n          (violation) =>\n            violation.impact !== null &&\n            violation.impact !== undefined &&\n            (bloquantes as readonly string[]).includes(violation.impact),\n        );\n\n  if (violations.length > 0) {\n    const detail = violations.map(decrire).join('\\n');\n    throw new Error(`${violations.length.toString()} violation(s) d'accessibilite :\\n${detail}`);\n  }\n}\n\n/** Les regles desactivees et leur raison, pour qu'un test puisse les afficher. */\nexport const REGLES_DESACTIVEES_PAR_DEFAUT: Readonly<Record<string, string>> = {\n  'color-contrast':\n    'jsdom ne calcule pas la mise en page. Le contraste est verifie par calcul ' +\n    'WCAG dans @starterlib/tokens, sur chaque paire semantique et dans les deux themes.',\n};\n","/**\n * @starterlib/testing — surface publique.\n *\n * Le paquet est cree, outille et publiable ; son contenu arrive par vagues\n * (voir docs/plan-librairie.md). Rien n'est exporte tant que rien n'est\n * eprouve : un export vide vaut mieux qu'un composant a moitie monte.\n */\nexport * from './lib/accessibilite';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":";;AAEA;;;;;;;;;;AAUG;AACH,MAAM,6BAA6B,GAAiD;AAClF,IAAA,gBAAgB,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE;CACrC;AASD,SAAS,OAAO,CAAC,SAAiB,EAAA;AAChC,IAAA,MAAM,MAAM,GAAG,SAAS,CAAC;AACtB,SAAA,GAAG,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;AACrC,SAAA,KAAK,CAAC,CAAC,EAAE,CAAC;SACV,IAAI,CAAC,IAAI,CAAC;AACb,IAAA,QACE,CAAA,GAAA,EAAM,SAAS,CAAC,MAAM,IAAI,SAAS,CAAA,EAAA,EAAK,SAAS,CAAC,EAAE,CAAA,GAAA,EAAM,SAAS,CAAC,IAAI,CAAA,EAAA,CAAI;AAC5E,QAAA,CAAA,iBAAA,EAAoB,MAAM,CAAA,EAAA,CAAI;AAC9B,QAAA,CAAA,iBAAA,EAAoB,SAAS,CAAC,OAAO,CAAA,CAAE;AAE3C;AAEA;;;;AAIG;AACI,eAAe,qBAAqB,CACzC,KAAqB,EACrB,UAAgC,EAAE,EAAA;AAElC,IAAA,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,EAAE;AAC3C,IAAA,MAAM,MAAM,GAAuC,EAAE,GAAG,6BAA6B,EAAE;IACvF,KAAK,MAAM,WAAW,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE;QACjD,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE;IAC1C;AAEA,IAAA,MAAM,aAAa,GAAe,EAAE,KAAK,EAAE,MAAM,EAAE;IACnD,MAAM,SAAS,GAAe,MAAM,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,aAAa,CAAC;AAEjE,IAAA,MAAM,UAAU,GAAG,OAAO,CAAC,kBAAkB;AAC7C,IAAA,MAAM,UAAU,GACd,UAAU,KAAK;UACX,SAAS,CAAC;AACZ,UAAE,SAAS,CAAC,UAAU,CAAC,MAAM,CACzB,CAAC,SAAS,KACR,SAAS,CAAC,MAAM,KAAK,IAAI;YACzB,SAAS,CAAC,MAAM,KAAK,SAAS;YAC7B,UAAgC,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAC/D;AAEP,IAAA,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE;AACzB,QAAA,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;AACjD,QAAA,MAAM,IAAI,KAAK,CAAC,CAAA,EAAG,UAAU,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAA,iCAAA,EAAoC,MAAM,CAAA,CAAE,CAAC;IAC9F;AACF;AAEA;AACO,MAAM,6BAA6B,GAAqC;AAC7E,IAAA,gBAAgB,EACd,4EAA4E;QAC5E,oFAAoF;;;AC3ExF;;;;;;AAMG;;ACNH;;AAEG;;"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@starterlib/testing",
+  "version": "0.1.0",
+  "description": "Outils de test du socle frontal starter : harnais, fixtures, simulateurs. Jamais en dependance de production.",
+  "license": "UNLICENSED",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Arnoldkom/starter-web-platform.git",
+    "directory": "packages/testing"
+  },
+  "homepage": "https://github.com/Arnoldkom/starter-web-platform/tree/main/packages/testing#readme",
+  "keywords": [
+    "starter",
+    "socle-frontal",
+    "testing"
+  ],
+  "peerDependencies": {
+    "@angular/core": "^22.1.0",
+    "@angular/common": "^22.1.0"
+  },
+  "module": "fesm2022/starterlib-testing.mjs",
+  "typings": "types/starterlib-testing.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/starterlib-testing.d.ts",
+      "default": "./fesm2022/starterlib-testing.mjs"
+    }
+  },
+  "type": "module",
+  "dependencies": {
+    "tslib": "^2.3.0"
+  }
+}

package/types/starterlib-testing.d.ts

@@ -0,0 +1,19 @@
+import { ElementContext } from 'axe-core';
+
+interface OptionsAccessibilite {
+    /** Regles a desactiver en plus, chacune avec sa raison ecrite. */
+    readonly exemptions?: Readonly<Record<string, string>>;
+    /** Niveaux a faire echouer. Par defaut toute violation echoue. */
+    readonly gravitesBloquantes?: readonly ('minor' | 'moderate' | 'serious' | 'critical')[];
+}
+/**
+ * Execute axe et leve si une violation bloquante subsiste. Le message nomme
+ * TOUTES les violations d'un coup, pas la premiere : corriger une regle a la
+ * fois sur un composant fait perdre un cycle par violation.
+ */
+declare function verifierAccessibilite(cible: ElementContext, options?: OptionsAccessibilite): Promise<void>;
+/** Les regles desactivees et leur raison, pour qu'un test puisse les afficher. */
+declare const REGLES_DESACTIVEES_PAR_DEFAUT: Readonly<Record<string, string>>;
+
+export { REGLES_DESACTIVEES_PAR_DEFAUT, verifierAccessibilite };
+export type { OptionsAccessibilite };