@etic-insa/ui 0.8.0 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. package/README.md +110 -63
  2. package/dist/components/etic/data-table.d.ts +13 -2
  3. package/dist/components/etic/data-table.js +227 -213
  4. package/dist/components/etic/data-table.js.map +1 -1
  5. package/dist/components/etic/empty-value.d.ts +17 -0
  6. package/dist/components/etic/empty-value.js +20 -0
  7. package/dist/components/etic/empty-value.js.map +1 -0
  8. package/dist/components/etic/external-link.d.ts +5 -2
  9. package/dist/components/etic/external-link.js +7 -3
  10. package/dist/components/etic/external-link.js.map +1 -1
  11. package/dist/components/etic/form-field.d.ts +6 -6
  12. package/dist/components/etic/form-field.js +40 -38
  13. package/dist/components/etic/form-field.js.map +1 -1
  14. package/dist/components/etic/lien.d.ts +22 -0
  15. package/dist/components/etic/lien.js +10 -1
  16. package/dist/components/etic/lien.js.map +1 -1
  17. package/dist/components/etic/save-bar.d.ts +16 -0
  18. package/dist/components/etic/save-bar.js +4 -1
  19. package/dist/components/etic/save-bar.js.map +1 -1
  20. package/dist/components/etic/search-select.js +77 -76
  21. package/dist/components/etic/search-select.js.map +1 -1
  22. package/dist/components/etic/unit-input.d.ts +25 -0
  23. package/dist/components/etic/unit-input.js +21 -0
  24. package/dist/components/etic/unit-input.js.map +1 -0
  25. package/dist/components/etic/use-unsaved-changes-guard.d.ts +32 -0
  26. package/dist/components/etic/use-unsaved-changes-guard.js +25 -0
  27. package/dist/components/etic/use-unsaved-changes-guard.js.map +1 -0
  28. package/dist/hooks/use-debounced-search.d.ts +2 -1
  29. package/dist/hooks/use-debounced-search.js.map +1 -1
  30. package/dist/hooks/use-debounced-value.js +8 -7
  31. package/dist/hooks/use-debounced-value.js.map +1 -1
  32. package/dist/index.d.ts +8 -4
  33. package/dist/index.js +122 -118
  34. package/dist/lib/delai-frappe.d.ts +3 -0
  35. package/dist/lib/delai-frappe.js +15 -0
  36. package/dist/lib/delai-frappe.js.map +1 -0
  37. package/dist/lib/format.d.ts +18 -0
  38. package/dist/lib/format.js +31 -24
  39. package/dist/lib/format.js.map +1 -1
  40. package/dist/lib/grouper.d.ts +20 -0
  41. package/dist/lib/grouper.js +16 -0
  42. package/dist/lib/grouper.js.map +1 -0
  43. package/dist/testing/controles.d.ts +35 -0
  44. package/dist/testing/controles.js +33 -0
  45. package/dist/testing/controles.js.map +1 -0
  46. package/dist/testing/index.d.ts +8 -0
  47. package/dist/testing/index.js +21 -17
  48. package/dist/testing/index.js.map +1 -1
  49. package/package.json +9 -1
@@ -0,0 +1,20 @@
1
+ /** Un groupe : sa clé, son libellé, ses éléments dans l'ordre d'apparition. */
2
+ export interface Groupe<T> {
3
+ cle: string;
4
+ libelle: string;
5
+ elements: T[];
6
+ }
7
+ /**
8
+ * Regroupe une liste par clé en gardant l'ordre d'apparition, celui dans
9
+ * lequel l'API l'a servie : pour les groupes (dans l'ordre de leur premier
10
+ * élément) comme pour leurs éléments. Le libellé d'un groupe est lu sur son
11
+ * premier élément : de préférence celui que le serveur rédige à côté de
12
+ * chaque élément, pour qu'un groupe nouveau s'affiche sans table locale.
13
+ * Pour des groupes triés, trier le résultat (`comparerFr` sur `libelle`).
14
+ *
15
+ * ```ts
16
+ * grouperPar(templates, (t) => t.format, (t) => t.format_libelle)
17
+ * // [{ cle: "docs", libelle: "Documents", elements: [...] }, …]
18
+ * ```
19
+ */
20
+ export declare function grouperPar<T>(elements: readonly T[], cle: (element: T) => string, libelle: (element: T) => string): Groupe<T>[];
@@ -0,0 +1,16 @@
1
+ // src/lib/grouper.ts
2
+ function e(e, t, n) {
3
+ let r = /* @__PURE__ */ new Map();
4
+ for (let i of e) {
5
+ let e = t(i), a = r.get(e);
6
+ a || (a = {
7
+ cle: e,
8
+ libelle: n(i),
9
+ elements: []
10
+ }, r.set(e, a)), a.elements.push(i);
11
+ }
12
+ return [...r.values()];
13
+ }
14
+ export { e as grouperPar };
15
+
16
+ //# sourceMappingURL=grouper.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"grouper.js","names":["grouperPar","groupes","element","elements","valeur","cle","groupe","libelle"],"sources":["../../src/lib/grouper.ts"],"sourcesContent":["/** Un groupe : sa clé, son libellé, ses éléments dans l'ordre d'apparition. */\nexport interface Groupe<T> {\n cle: string\n libelle: string\n elements: T[]\n}\n\n/**\n * Regroupe une liste par clé en gardant l'ordre d'apparition, celui dans\n * lequel l'API l'a servie : pour les groupes (dans l'ordre de leur premier\n * élément) comme pour leurs éléments. Le libellé d'un groupe est lu sur son\n * premier élément : de préférence celui que le serveur rédige à côté de\n * chaque élément, pour qu'un groupe nouveau s'affiche sans table locale.\n * Pour des groupes triés, trier le résultat (`comparerFr` sur `libelle`).\n *\n * ```ts\n * grouperPar(templates, (t) => t.format, (t) => t.format_libelle)\n * // [{ cle: \"docs\", libelle: \"Documents\", elements: [...] }, …]\n * ```\n */\nexport function grouperPar<T>(\n elements: readonly T[],\n cle: (element: T) => string,\n libelle: (element: T) => string\n): Groupe<T>[] {\n const groupes = new Map<string, Groupe<T>>()\n for (const element of elements) {\n const valeur = cle(element)\n let groupe = groupes.get(valeur)\n if (!groupe) {\n groupe = { cle: valeur, libelle: libelle(element), elements: [] }\n groupes.set(valeur, groupe)\n }\n groupe.elements.push(element)\n }\n return [...groupes.values()]\n}\n"],"mappings":";AAoBA,SAAgBA,EACd,GACA,GACA,GACa;CACb,IAAMC,oBAAU,IAAI,IAAuB;CAC3C,KAAK,IAAMC,KAAWC,GAAU;EAC9B,IAAMC,IAASC,EAAIH,CAAO,GACtBI,IAASL,EAAQ,IAAIG,CAAM;EAK/B,AAJKE,MACH,IAAS;GAAE,KAAKF;GAAQ,SAASG,EAAQL,CAAO;GAAG,UAAU,CAAC;EAAE,GAChED,EAAQ,IAAIG,GAAQE,CAAM,IAE5BA,EAAO,SAAS,KAAKJ,CAAO;CAC9B;CACA,OAAO,CAAC,GAAGD,EAAQ,OAAO,CAAC;AAC7B"}
@@ -0,0 +1,35 @@
1
+ /**
2
+ * Vrai si le bouton est inactif, quelle que soit la forme : `disabled`, ou
3
+ * `aria-disabled` d'un bouton retenu par son `verrou`, qui reste
4
+ * focalisable (`TooltipButton`, `DeleteButton`…).
5
+ */
6
+ export declare function inactif(bouton: HTMLElement): boolean;
7
+ /**
8
+ * Vrai si la case, le bouton radio ou l'interrupteur est coché : `checked`
9
+ * d'un contrôle natif, `aria-checked` d'un contrôle de la bibliothèque.
10
+ */
11
+ export declare function coche(controle: HTMLElement): boolean;
12
+ /**
13
+ * Un appui complet, comme une souris : appui, relâché, clic. Les options de
14
+ * Base UI (`Select`, `Combobox`…) réagissent au relâché, qu'un
15
+ * `fireEvent.click` seul n'envoie pas.
16
+ */
17
+ export declare function appuyer(element: HTMLElement): void;
18
+ /**
19
+ * Choisit une option d'une liste (`Select`, `SelectField`) : l'ouvre,
20
+ * appuie sur l'option, attend qu'elle se referme.
21
+ */
22
+ export declare function choisir(liste: HTMLElement, option: string | RegExp): Promise<void>;
23
+ /** Ce qu'affiche une liste (`Select`) : le libellé de la valeur choisie, ou
24
+ * son texte d'invite. */
25
+ export declare function valeurAffichee(liste: HTMLElement): string;
26
+ /** Les libellés des options d'une liste (`Select`), ouverte le temps de les
27
+ * lire puis refermée par Échap. */
28
+ export declare function optionsDe(liste: HTMLElement): Promise<string[]>;
29
+ /**
30
+ * Tape `texte` dans un champ de recherche (`SearchSelect`) et choisit une
31
+ * suggestion. La liste attend la recherche différée, puis la réponse : si
32
+ * elle tarde, relever le délai des attentes de testing-library
33
+ * (`configure({ asyncUtilTimeout })`) plutôt que d'ajouter des `timeout`.
34
+ */
35
+ export declare function chercher(champ: HTMLElement, texte: string, option: string | RegExp): Promise<void>;
@@ -0,0 +1,33 @@
1
+ import { fireEvent as e, screen as t, waitFor as n } from "@testing-library/react";
2
+ // src/testing/controles.ts
3
+ function r(e) {
4
+ return e.disabled || e.getAttribute("aria-disabled") === "true";
5
+ }
6
+ function i(e) {
7
+ return e.checked === !0 || e.getAttribute("aria-checked") === "true";
8
+ }
9
+ function a(t) {
10
+ e.pointerDown(t), e.mouseDown(t), e.pointerUp(t), e.mouseUp(t), e.click(t);
11
+ }
12
+ function o() {
13
+ return n(() => {
14
+ if (t.queryByRole("listbox")) throw Error("La liste d'options est encore ouverte.");
15
+ });
16
+ }
17
+ async function s(n, r) {
18
+ e.click(n), a(await t.findByRole("option", { name: r })), await o();
19
+ }
20
+ function c(e) {
21
+ return ((e.querySelector("[data-slot=\"select-value\"]") ?? e).textContent ?? "").trim();
22
+ }
23
+ async function l(n) {
24
+ e.click(n);
25
+ let r = (await t.findAllByRole("option")).map((e) => (e.textContent ?? "").trim());
26
+ return e.keyDown(t.getByRole("listbox"), { key: "Escape" }), await o(), r;
27
+ }
28
+ async function u(n, r, i) {
29
+ n.focus(), e.keyDown(n, { key: "ArrowDown" }), e.input(n, { target: { value: r } }), a(await t.findByRole("option", { name: i }));
30
+ }
31
+ export { a as appuyer, u as chercher, s as choisir, i as coche, r as inactif, l as optionsDe, c as valeurAffichee };
32
+
33
+ //# sourceMappingURL=controles.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"controles.js","names":["inactif","bouton","coche","controle","appuyer","fireEvent","element","listeFermee","waitFor","screen","choisir","liste","option","valeurAffichee","optionsDe","libelles","chercher","champ","texte"],"sources":["../../src/testing/controles.ts"],"sourcesContent":["// Contrôles d'@etic-insa/ui lus et manipulés comme un utilisateur le fait.\n// @testing-library/react est une dépendance pair facultative de la\n// bibliothèque : seule cette entrée, `@etic-insa/ui/test/controles`,\n// l'importe ; ni `@etic-insa/ui/test` ni le bundle d'une application.\nimport { fireEvent, screen, waitFor } from \"@testing-library/react\"\n\n/**\n * Vrai si le bouton est inactif, quelle que soit la forme : `disabled`, ou\n * `aria-disabled` d'un bouton retenu par son `verrou`, qui reste\n * focalisable (`TooltipButton`, `DeleteButton`…).\n */\nexport function inactif(bouton: HTMLElement): boolean {\n return (\n (bouton as HTMLButtonElement).disabled ||\n bouton.getAttribute(\"aria-disabled\") === \"true\"\n )\n}\n\n/**\n * Vrai si la case, le bouton radio ou l'interrupteur est coché : `checked`\n * d'un contrôle natif, `aria-checked` d'un contrôle de la bibliothèque.\n */\nexport function coche(controle: HTMLElement): boolean {\n return (\n (controle as HTMLInputElement).checked === true ||\n controle.getAttribute(\"aria-checked\") === \"true\"\n )\n}\n\n/**\n * Un appui complet, comme une souris : appui, relâché, clic. Les options de\n * Base UI (`Select`, `Combobox`…) réagissent au relâché, qu'un\n * `fireEvent.click` seul n'envoie pas.\n */\nexport function appuyer(element: HTMLElement): void {\n fireEvent.pointerDown(element)\n fireEvent.mouseDown(element)\n fireEvent.pointerUp(element)\n fireEvent.mouseUp(element)\n fireEvent.click(element)\n}\n\n/** Attend que la liste d'options se soit refermée. */\nfunction listeFermee() {\n return waitFor(() => {\n if (screen.queryByRole(\"listbox\"))\n throw new Error(\"La liste d'options est encore ouverte.\")\n })\n}\n\n/**\n * Choisit une option d'une liste (`Select`, `SelectField`) : l'ouvre,\n * appuie sur l'option, attend qu'elle se referme.\n */\nexport async function choisir(\n liste: HTMLElement,\n option: string | RegExp\n): Promise<void> {\n fireEvent.click(liste)\n appuyer(await screen.findByRole(\"option\", { name: option }))\n await listeFermee()\n}\n\n/** Ce qu'affiche une liste (`Select`) : le libellé de la valeur choisie, ou\n * son texte d'invite. */\nexport function valeurAffichee(liste: HTMLElement): string {\n const valeur = liste.querySelector('[data-slot=\"select-value\"]') ?? liste\n return (valeur.textContent ?? \"\").trim()\n}\n\n/** Les libellés des options d'une liste (`Select`), ouverte le temps de les\n * lire puis refermée par Échap. */\nexport async function optionsDe(liste: HTMLElement): Promise<string[]> {\n fireEvent.click(liste)\n const libelles = (await screen.findAllByRole(\"option\")).map((option) =>\n (option.textContent ?? \"\").trim()\n )\n fireEvent.keyDown(screen.getByRole(\"listbox\"), { key: \"Escape\" })\n await listeFermee()\n return libelles\n}\n\n/**\n * Tape `texte` dans un champ de recherche (`SearchSelect`) et choisit une\n * suggestion. La liste attend la recherche différée, puis la réponse : si\n * elle tarde, relever le délai des attentes de testing-library\n * (`configure({ asyncUtilTimeout })`) plutôt que d'ajouter des `timeout`.\n */\nexport async function chercher(\n champ: HTMLElement,\n texte: string,\n option: string | RegExp\n): Promise<void> {\n champ.focus()\n fireEvent.keyDown(champ, { key: \"ArrowDown\" })\n fireEvent.input(champ, { target: { value: texte } })\n appuyer(await screen.findByRole(\"option\", { name: option }))\n}\n"],"mappings":";;AAWA,SAAgBA,EAAQ,GAA8B;CACpD,OACGC,EAA6B,YAC9BA,EAAO,aAAa,eAAe,MAAM;AAE7C;AAMA,SAAgBC,EAAM,GAAgC;CACpD,OACGC,EAA8B,YAAY,MAC3CA,EAAS,aAAa,cAAc,MAAM;AAE9C;AAOA,SAAgBC,EAAQ,GAA4B;CAKlD,AAJAC,EAAU,YAAYC,CAAO,GAC7BD,EAAU,UAAUC,CAAO,GAC3BD,EAAU,UAAUC,CAAO,GAC3BD,EAAU,QAAQC,CAAO,GACzBD,EAAU,MAAMC,CAAO;AACzB;AAGA,SAASC,IAAc;CACrB,OAAOC,QAAc;EACnB,IAAIC,EAAO,YAAY,SAAS,GAC9B,MAAU,MAAM,wCAAwC;CAC5D,CAAC;AACH;AAMA,eAAsBC,EACpB,GACA,GACe;CAGf,AAFAL,EAAU,MAAMM,CAAK,GACrBP,EAAQ,MAAMK,EAAO,WAAW,UAAU,EAAE,MAAMG,EAAO,CAAC,CAAC,GAC3D,MAAML,EAAY;AACpB;AAIA,SAAgBM,EAAe,GAA4B;CAEzD,SADeF,EAAM,cAAc,8BAA4B,KAAKA,EAAA,CACrD,eAAe,GAAA,CAAI,KAAK;AACzC;AAIA,eAAsBG,EAAU,GAAuC;CACrE,EAAU,MAAMH,CAAK;CACrB,IAAMI,KAAY,MAAMN,EAAO,cAAc,QAAQ,EAAA,CAAG,KAAK,OAC1DG,EAAO,eAAe,GAAA,CAAI,KAAK,CAClC;CAGA,OAFAP,EAAU,QAAQI,EAAO,UAAU,SAAS,GAAG,EAAE,KAAK,SAAS,CAAC,GAChE,MAAMF,EAAY,GACXQ;AACT;AAQA,eAAsBC,EACpB,GACA,GACA,GACe;CAIf,AAHAC,EAAM,MAAM,GACZZ,EAAU,QAAQY,GAAO,EAAE,KAAK,YAAY,CAAC,GAC7CZ,EAAU,MAAMY,GAAO,EAAE,QAAQ,EAAE,OAAOC,EAAM,EAAE,CAAC,GACnDd,EAAQ,MAAMK,EAAO,WAAW,UAAU,EAAE,MAAMG,EAAO,CAAC,CAAC;AAC7D"}
@@ -1,3 +1,11 @@
1
+ /**
2
+ * Pause de frappe par défaut des recherches (`SearchSelect`,
3
+ * `useDebouncedValue`, `useDebouncedSearch`, recherche des listes) : 300 ms
4
+ * hors test. `setSearchDelay(0)` dans le fichier de mise en place des tests
5
+ * épargne une attente réelle à chaque recherche simulée ; un `delai` passé
6
+ * explicitement reste respecté. Sans argument, rend les 300 ms d'origine.
7
+ */
8
+ export declare function setSearchDelay(millisecondes?: number): void;
1
9
  /**
2
10
  * Passe l'affichage en mobile (`true`) ou en bureau (`false`) pour la
3
11
  * doublure posée par {@link installMatchMedia}. Les composants abonnés
@@ -1,32 +1,36 @@
1
1
  import { MOBILE_MEDIA_QUERY as e } from "../hooks/use-mobile.js";
2
+ import { definirDelaiFrappe as t } from "../lib/delai-frappe.js";
2
3
  // src/testing/index.ts
3
- var t = /* @__PURE__ */ new Set(), n = !1;
4
- function r(r) {
5
- if (n === r) return;
6
- n = r;
7
- let i = {
8
- matches: r,
4
+ function n(e) {
5
+ t(e);
6
+ }
7
+ var r = /* @__PURE__ */ new Set(), i = !1;
8
+ function a(t) {
9
+ if (i === t) return;
10
+ i = t;
11
+ let n = {
12
+ matches: t,
9
13
  media: e
10
14
  };
11
- for (let e of t) e(i);
15
+ for (let e of r) e(n);
12
16
  }
13
- function i() {
17
+ function o() {
14
18
  Object.defineProperty(window, "matchMedia", {
15
19
  configurable: !0,
16
20
  writable: !0,
17
- value: (r) => {
18
- let i = r === e;
21
+ value: (t) => {
22
+ let n = t === e;
19
23
  return {
20
- media: r,
24
+ media: t,
21
25
  get matches() {
22
- return i && n;
26
+ return n && i;
23
27
  },
24
28
  onchange: null,
25
- addEventListener: (e, n) => {
26
- i && typeof n == "function" && t.add(n);
29
+ addEventListener: (e, t) => {
30
+ n && typeof t == "function" && r.add(t);
27
31
  },
28
- removeEventListener: (e, n) => {
29
- typeof n == "function" && t.delete(n);
32
+ removeEventListener: (e, t) => {
33
+ typeof t == "function" && r.delete(t);
30
34
  },
31
35
  addListener: () => {},
32
36
  removeListener: () => {},
@@ -35,6 +39,6 @@ function i() {
35
39
  }
36
40
  });
37
41
  }
38
- export { i as installMatchMedia, r as setMobileViewport };
42
+ export { o as installMatchMedia, a as setMobileViewport, n as setSearchDelay };
39
43
 
40
44
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","names":["ecouteurs","mobile","setMobileViewport","valeur","evenement","MOBILE_MEDIA_QUERY","ecouteur","installMatchMedia","estMobile","media"],"sources":["../../src/testing/index.ts"],"sourcesContent":["// Outils de test des applications : `@etic-insa/ui/test`. Hors de l'index\n// principal, ils n'entrent jamais dans le bundle d'une application.\nimport { MOBILE_MEDIA_QUERY } from \"@etic-ui/hooks/use-mobile\"\n\ntype Ecouteur = (evenement: MediaQueryListEvent) => void\n\nconst ecouteurs = new Set<Ecouteur>()\nlet mobile = false\n\n/**\n * Passe l'affichage en mobile (`true`) ou en bureau (`false`) pour la\n * doublure posée par {@link installMatchMedia}. Les composants abonnés\n * (`useIsMobile`, `AppShell`…) se redessinent aussitôt : sur un composant\n * déjà monté, l'appeler dans un `act()`.\n */\nexport function setMobileViewport(valeur: boolean): void {\n if (mobile === valeur) return\n mobile = valeur\n const evenement = {\n matches: valeur,\n media: MOBILE_MEDIA_QUERY,\n } as MediaQueryListEvent\n for (const ecouteur of ecouteurs) ecouteur(evenement)\n}\n\n/**\n * Remplace `window.matchMedia` par une doublure pilotable : le `matchMedia`\n * de jsdom n'existe pas, celui de happy-dom suit une fenêtre fixe de\n * 1 024 px, donc mobile pour la bibliothèque. Seule la requête de\n * `useIsMobile` (`MOBILE_MEDIA_QUERY`) est connue ; toute autre est réputée\n * ne pas correspondre. Affichage de bureau au départ.\n *\n * À appeler une fois dans le fichier de mise en place des tests, avec\n * `beforeEach(() => setMobileViewport(false))` pour que chaque test parte du\n * bureau.\n */\nexport function installMatchMedia(): void {\n const matchMedia = (media: string): MediaQueryList => {\n const estMobile = media === MOBILE_MEDIA_QUERY\n return {\n media,\n // Un accesseur, pas une valeur : une liste gardée reflète l'état\n // courant à chaque lecture.\n get matches() {\n return estMobile && mobile\n },\n onchange: null,\n addEventListener: (\n _type: string,\n ecouteur: EventListenerOrEventListenerObject\n ) => {\n if (estMobile && typeof ecouteur === \"function\")\n ecouteurs.add(ecouteur as Ecouteur)\n },\n removeEventListener: (\n _type: string,\n ecouteur: EventListenerOrEventListenerObject\n ) => {\n if (typeof ecouteur === \"function\")\n ecouteurs.delete(ecouteur as Ecouteur)\n },\n // API historique, exigée par le type.\n addListener: () => {},\n removeListener: () => {},\n dispatchEvent: () => false,\n } as MediaQueryList\n }\n Object.defineProperty(window, \"matchMedia\", {\n configurable: true,\n writable: true,\n value: matchMedia,\n })\n}\n"],"mappings":";;AAMA,IAAMA,oBAAY,IAAI,IAAc,GAChCC,IAAS;AAQb,SAAgBC,EAAkB,GAAuB;CACvD,IAAID,MAAWE,GAAQ;CACvB,IAASA;CACT,IAAMC,IAAY;EAChB,SAASD;EACT,OAAOE;CACT;CACA,KAAK,IAAMC,KAAYN,GAAW,EAASI,CAAS;AACtD;AAaA,SAAgBG,IAA0B;CA+BxC,OAAO,eAAe,QAAQ,cAAc;EAC1C,cAAc;EACd,UAAU;EACV,QAjCkB,MAAkC;GACpD,IAAMC,IAAYC,MAAUJ;GAC5B,OAAO;IACL;IAGA,IAAI,UAAU;KACZ,OAAOG,KAAaP;IACtB;IACA,UAAU;IACV,mBACE,GACA,MACG;KACH,AAAIO,KAAa,OAAOF,KAAa,cACnCN,EAAU,IAAIM,CAAoB;IACtC;IACA,sBACE,GACA,MACG;KACH,AAAI,OAAOA,KAAa,cACtBN,EAAU,OAAOM,CAAoB;IACzC;IAEA,mBAAmB,CAAC;IACpB,sBAAsB,CAAC;IACvB,qBAAqB;GACvB;EACF;CAKA,CAAC;AACH"}
1
+ {"version":3,"file":"index.js","names":["setSearchDelay","millisecondes","ecouteurs","mobile","setMobileViewport","valeur","evenement","MOBILE_MEDIA_QUERY","ecouteur","installMatchMedia","estMobile","media"],"sources":["../../src/testing/index.ts"],"sourcesContent":["// Outils de test des applications : `@etic-insa/ui/test`. Hors de l'index\n// principal, ils n'entrent jamais dans le bundle d'une application.\nimport { MOBILE_MEDIA_QUERY } from \"@etic-ui/hooks/use-mobile\"\nimport { definirDelaiFrappe } from \"@etic-ui/lib/delai-frappe\"\n\n/**\n * Pause de frappe par défaut des recherches (`SearchSelect`,\n * `useDebouncedValue`, `useDebouncedSearch`, recherche des listes) : 300 ms\n * hors test. `setSearchDelay(0)` dans le fichier de mise en place des tests\n * épargne une attente réelle à chaque recherche simulée ; un `delai` passé\n * explicitement reste respecté. Sans argument, rend les 300 ms d'origine.\n */\nexport function setSearchDelay(millisecondes?: number): void {\n definirDelaiFrappe(millisecondes)\n}\n\ntype Ecouteur = (evenement: MediaQueryListEvent) => void\n\nconst ecouteurs = new Set<Ecouteur>()\nlet mobile = false\n\n/**\n * Passe l'affichage en mobile (`true`) ou en bureau (`false`) pour la\n * doublure posée par {@link installMatchMedia}. Les composants abonnés\n * (`useIsMobile`, `AppShell`…) se redessinent aussitôt : sur un composant\n * déjà monté, l'appeler dans un `act()`.\n */\nexport function setMobileViewport(valeur: boolean): void {\n if (mobile === valeur) return\n mobile = valeur\n const evenement = {\n matches: valeur,\n media: MOBILE_MEDIA_QUERY,\n } as MediaQueryListEvent\n for (const ecouteur of ecouteurs) ecouteur(evenement)\n}\n\n/**\n * Remplace `window.matchMedia` par une doublure pilotable : le `matchMedia`\n * de jsdom n'existe pas, celui de happy-dom suit une fenêtre fixe de\n * 1 024 px, donc mobile pour la bibliothèque. Seule la requête de\n * `useIsMobile` (`MOBILE_MEDIA_QUERY`) est connue ; toute autre est réputée\n * ne pas correspondre. Affichage de bureau au départ.\n *\n * À appeler une fois dans le fichier de mise en place des tests, avec\n * `beforeEach(() => setMobileViewport(false))` pour que chaque test parte du\n * bureau.\n */\nexport function installMatchMedia(): void {\n const matchMedia = (media: string): MediaQueryList => {\n const estMobile = media === MOBILE_MEDIA_QUERY\n return {\n media,\n // Un accesseur, pas une valeur : une liste gardée reflète l'état\n // courant à chaque lecture.\n get matches() {\n return estMobile && mobile\n },\n onchange: null,\n addEventListener: (\n _type: string,\n ecouteur: EventListenerOrEventListenerObject\n ) => {\n if (estMobile && typeof ecouteur === \"function\")\n ecouteurs.add(ecouteur as Ecouteur)\n },\n removeEventListener: (\n _type: string,\n ecouteur: EventListenerOrEventListenerObject\n ) => {\n if (typeof ecouteur === \"function\")\n ecouteurs.delete(ecouteur as Ecouteur)\n },\n // API historique, exigée par le type.\n addListener: () => {},\n removeListener: () => {},\n dispatchEvent: () => false,\n } as MediaQueryList\n }\n Object.defineProperty(window, \"matchMedia\", {\n configurable: true,\n writable: true,\n value: matchMedia,\n })\n}\n"],"mappings":";;;AAYA,SAAgBA,EAAe,GAA8B;CAC3D,EAAmBC,CAAa;AAClC;AAIA,IAAMC,oBAAY,IAAI,IAAc,GAChCC,IAAS;AAQb,SAAgBC,EAAkB,GAAuB;CACvD,IAAID,MAAWE,GAAQ;CACvB,IAASA;CACT,IAAMC,IAAY;EAChB,SAASD;EACT,OAAOE;CACT;CACA,KAAK,IAAMC,KAAYN,GAAW,EAASI,CAAS;AACtD;AAaA,SAAgBG,IAA0B;CA+BxC,OAAO,eAAe,QAAQ,cAAc;EAC1C,cAAc;EACd,UAAU;EACV,QAjCkB,MAAkC;GACpD,IAAMC,IAAYC,MAAUJ;GAC5B,OAAO;IACL;IAGA,IAAI,UAAU;KACZ,OAAOG,KAAaP;IACtB;IACA,UAAU;IACV,mBACE,GACA,MACG;KACH,AAAIO,KAAa,OAAOF,KAAa,cACnCN,EAAU,IAAIM,CAAoB;IACtC;IACA,sBACE,GACA,MACG;KACH,AAAI,OAAOA,KAAa,cACtBN,EAAU,OAAOM,CAAoB;IACzC;IAEA,mBAAmB,CAAC;IACpB,sBAAsB,CAAC;IACvB,qBAAqB;GACvB;EACF;CAKA,CAAC;AACH"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@etic-insa/ui",
3
- "version": "0.8.0",
3
+ "version": "0.9.0",
4
4
  "description": "Bibliothèque de composants React des applications ETIC, construite sur shadcn et Base UI.",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -21,6 +21,10 @@
21
21
  "types": "./dist/testing/index.d.ts",
22
22
  "default": "./dist/testing/index.js"
23
23
  },
24
+ "./test/controles": {
25
+ "types": "./dist/testing/controles.d.ts",
26
+ "default": "./dist/testing/controles.js"
27
+ },
24
28
  "./charts": {
25
29
  "types": "./dist/charts/index.d.ts",
26
30
  "default": "./dist/charts/index.js"
@@ -51,6 +55,7 @@
51
55
  "test": "vitest run"
52
56
  },
53
57
  "peerDependencies": {
58
+ "@testing-library/react": "^16",
54
59
  "lucide-react": "^1.64.0",
55
60
  "react": "^19.2.0",
56
61
  "react-dom": "^19.2.0",
@@ -59,6 +64,9 @@
59
64
  "vite": ">=7"
60
65
  },
61
66
  "peerDependenciesMeta": {
67
+ "@testing-library/react": {
68
+ "optional": true
69
+ },
62
70
  "recharts": {
63
71
  "optional": true
64
72
  },