@etic-insa/ui 0.6.0 → 0.7.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 (76) hide show
  1. package/README.md +250 -62
  2. package/dist/components/etic/app-shell.d.ts +10 -0
  3. package/dist/components/etic/app-shell.js +144 -117
  4. package/dist/components/etic/app-shell.js.map +1 -1
  5. package/dist/components/etic/code-block.d.ts +15 -0
  6. package/dist/components/etic/code-block.js +21 -0
  7. package/dist/components/etic/code-block.js.map +1 -0
  8. package/dist/components/etic/data-table-toolbar.d.ts +12 -1
  9. package/dist/components/etic/data-table-toolbar.js +50 -39
  10. package/dist/components/etic/data-table-toolbar.js.map +1 -1
  11. package/dist/components/etic/data-table-view-options.d.ts +2 -1
  12. package/dist/components/etic/data-table-view-options.js +1 -1
  13. package/dist/components/etic/data-table-view-options.js.map +1 -1
  14. package/dist/components/etic/detail-meta.d.ts +28 -0
  15. package/dist/components/etic/detail-meta.js +51 -0
  16. package/dist/components/etic/detail-meta.js.map +1 -0
  17. package/dist/components/etic/detail-sheet.d.ts +36 -0
  18. package/dist/components/etic/detail-sheet.js +37 -0
  19. package/dist/components/etic/detail-sheet.js.map +1 -0
  20. package/dist/components/etic/empty-state.d.ts +15 -0
  21. package/dist/components/etic/empty-state.js +24 -12
  22. package/dist/components/etic/empty-state.js.map +1 -1
  23. package/dist/components/etic/external-link.d.ts +40 -0
  24. package/dist/components/etic/external-link.js +47 -0
  25. package/dist/components/etic/external-link.js.map +1 -0
  26. package/dist/components/etic/file-upload.d.ts +19 -0
  27. package/dist/components/etic/file-upload.js +24 -1
  28. package/dist/components/etic/file-upload.js.map +1 -1
  29. package/dist/components/etic/nav-tabs.d.ts +27 -0
  30. package/dist/components/etic/nav-tabs.js +22 -0
  31. package/dist/components/etic/nav-tabs.js.map +1 -0
  32. package/dist/components/etic/phone-input.d.ts +4 -3
  33. package/dist/components/etic/phone-input.js +51 -37
  34. package/dist/components/etic/phone-input.js.map +1 -1
  35. package/dist/components/etic/save-bar.d.ts +3 -2
  36. package/dist/components/etic/save-bar.js +16 -15
  37. package/dist/components/etic/save-bar.js.map +1 -1
  38. package/dist/components/etic/select-field.d.ts +38 -0
  39. package/dist/components/etic/select-field.js +42 -0
  40. package/dist/components/etic/select-field.js.map +1 -0
  41. package/dist/components/etic/sub-section.d.ts +15 -0
  42. package/dist/components/etic/sub-section.js +23 -0
  43. package/dist/components/etic/sub-section.js.map +1 -0
  44. package/dist/components/etic/use-detail-sheet.d.ts +58 -0
  45. package/dist/components/etic/use-detail-sheet.js +35 -0
  46. package/dist/components/etic/use-detail-sheet.js.map +1 -0
  47. package/dist/components/etic/use-server-pagination.d.ts +55 -0
  48. package/dist/components/etic/use-server-pagination.js +31 -0
  49. package/dist/components/etic/use-server-pagination.js.map +1 -0
  50. package/dist/components/etic/use-server-sorting.d.ts +29 -0
  51. package/dist/components/etic/use-server-sorting.js +19 -0
  52. package/dist/components/etic/use-server-sorting.js.map +1 -0
  53. package/dist/components/ui/sheet.d.ts +20 -2
  54. package/dist/components/ui/sheet.js +21 -8
  55. package/dist/components/ui/sheet.js.map +1 -1
  56. package/dist/hooks/use-column-prefs.d.ts +25 -7
  57. package/dist/hooks/use-column-prefs.js +44 -35
  58. package/dist/hooks/use-column-prefs.js.map +1 -1
  59. package/dist/hooks/use-debounced-search.d.ts +29 -0
  60. package/dist/hooks/use-debounced-search.js +29 -0
  61. package/dist/hooks/use-debounced-search.js.map +1 -0
  62. package/dist/hooks/use-fresh-dialog.d.ts +33 -0
  63. package/dist/hooks/use-fresh-dialog.js +17 -0
  64. package/dist/hooks/use-fresh-dialog.js.map +1 -0
  65. package/dist/hooks/use-load-on-open.d.ts +23 -0
  66. package/dist/hooks/use-load-on-open.js +21 -0
  67. package/dist/hooks/use-load-on-open.js.map +1 -0
  68. package/dist/hooks/use-save-by-key.d.ts +45 -0
  69. package/dist/hooks/use-save-by-key.js +49 -0
  70. package/dist/hooks/use-save-by-key.js.map +1 -0
  71. package/dist/index.d.ts +18 -4
  72. package/dist/index.js +117 -103
  73. package/dist/lib/format.d.ts +31 -0
  74. package/dist/lib/format.js +53 -18
  75. package/dist/lib/format.js.map +1 -1
  76. package/package.json +1 -1
@@ -6,7 +6,7 @@ import { jsx as i, jsxs as a } from "react/jsx-runtime";
6
6
  import { CheckIcon as o } from "lucide-react";
7
7
  // src/components/etic/save-bar.tsx
8
8
  function s({ enCours: s = !1, desactive: c = !1, enregistre: l = !1, modifie: u = !1, collante: d = !1, masqueeAuRepos: f = !1, onEnregistrer: p, onAnnuler: m, retablirDefauts: h, className: g }) {
9
- let _ = r(null), v = d && f && !u && !s && !l, y = /* @__PURE__ */ i(e, {
9
+ let _ = r(null), v = h?.masque ? void 0 : h, y = d && f && !u && !s && !l && !v, b = /* @__PURE__ */ i(e, {
10
10
  ref: _,
11
11
  type: p ? "button" : "submit",
12
12
  onClick: p,
@@ -15,7 +15,7 @@ function s({ enCours: s = !1, desactive: c = !1, enregistre: l = !1, modifie: u
15
15
  disabled: c,
16
16
  focusableWhenDisabled: !0,
17
17
  children: "Enregistrer"
18
- }), b = m ? /* @__PURE__ */ i(e, {
18
+ }), x = m ? /* @__PURE__ */ i(e, {
19
19
  variant: "outline",
20
20
  onClick: () => {
21
21
  _.current?.focus(), m();
@@ -23,14 +23,15 @@ function s({ enCours: s = !1, desactive: c = !1, enregistre: l = !1, modifie: u
23
23
  disabled: s,
24
24
  focusableWhenDisabled: !0,
25
25
  children: "Annuler"
26
- }) : null, x = h ? /* @__PURE__ */ i(t, {
27
- masque: h.masque,
26
+ }) : null, S = v ? /* @__PURE__ */ i(t, {
28
27
  disabled: s,
29
- cible: () => _.current,
30
- onRetablir: h.onRetablir
31
- }) : null, S = /* @__PURE__ */ i("p", {
28
+ className: "starting:opacity-0",
29
+ onRetablir: () => {
30
+ _.current?.focus(), v.onRetablir();
31
+ }
32
+ }) : null, C = /* @__PURE__ */ i("p", {
32
33
  role: "status",
33
- className: n("text-sm text-muted-foreground", d && "me-auto min-w-0 flex-1", v && "sr-only"),
34
+ className: n("text-sm text-muted-foreground", d && "me-auto min-w-0 flex-1", y && "sr-only"),
34
35
  children: u ? "Modifications non enregistrées" : l ? /* @__PURE__ */ a("span", {
35
36
  className: "inline-flex items-center gap-1.5 font-medium text-success",
36
37
  children: [/* @__PURE__ */ i(o, {
@@ -38,21 +39,21 @@ function s({ enCours: s = !1, desactive: c = !1, enregistre: l = !1, modifie: u
38
39
  "aria-hidden": !0
39
40
  }), "Enregistré"]
40
41
  }) : null
41
- }), C = v ? null : /* @__PURE__ */ a("div", {
42
+ }), w = y ? null : /* @__PURE__ */ a("div", {
42
43
  "data-slot": "save-bar-actions",
43
44
  className: "flex shrink-0 items-center gap-3",
44
45
  children: [
45
- d ? x : y,
46
- b,
47
- d ? y : x
46
+ d ? S : b,
47
+ x,
48
+ d ? b : S
48
49
  ]
49
50
  });
50
51
  return /* @__PURE__ */ a("div", {
51
52
  "data-slot": "save-bar",
52
53
  "data-collante": d || void 0,
53
- "data-repos": v || void 0,
54
- className: n("flex items-center gap-3", !d && "flex-wrap", v && "contents", d && !v && "justify-end rounded-xl border border-border bg-card px-4 py-3", d && (u || s) && "sticky bottom-4 z-10 shadow-sm", g),
55
- children: [d ? S : C, d ? C : S]
54
+ "data-repos": y || void 0,
55
+ className: n("flex items-center gap-3", !d && "flex-wrap", y && "contents", d && !y && "justify-end rounded-xl border border-border bg-card px-4 py-3", d && (u || s) && "sticky bottom-4 z-10 shadow-sm", g),
56
+ children: [d ? C : w, d ? w : C]
56
57
  });
57
58
  }
58
59
  export { s as SaveBar };
@@ -1 +1 @@
1
- {"version":3,"file":"save-bar.js","names":["SaveBar","refEnregistrer","useRef","auRepos","collante","masqueeAuRepos","modifie","enCours","enregistre","enregistrer","Button","onEnregistrer","desactive","annuler","onAnnuler","retablir","retablirDefauts","ResetButton","statut","cn","CheckIcon","boutons","className"],"sources":["../../../src/components/etic/save-bar.tsx"],"sourcesContent":["import { useRef } from \"react\"\nimport { cn } from \"cn\"\nimport { CheckIcon } from \"lucide-react\"\n\nimport { Button } from \"@etic-ui/components/ui/button\"\nimport { ResetButton } from \"@etic-ui/components/etic/reset-button\"\n\nexport interface SaveBarProps {\n /** Enregistrement en cours : « Enregistrer » devient « Enregistrement… »,\n * occupé (`aria-busy`), ignore les clics, mais garde le focus ;\n * « Annuler » attend la fin. */\n enCours?: boolean\n /** Rien à enregistrer, ou une saisie à corriger d'abord. */\n desactive?: boolean\n /** Affiche « Enregistré » : la dernière mutation a réussi\n * (`mutation.isSuccess`). `modifie` l'emporte. */\n enregistre?: boolean\n /** Des modifications attendent : le statut dit « Modifications non\n * enregistrées », la raison pour laquelle « Enregistrer » est actif,\n * même après un enregistrement réussi. */\n modifie?: boolean\n /** Pied d'un formulaire plus haut que l'écran, sur une carte opaque,\n * boutons à droite, statut à gauche. Tant que `modifie` est vrai (ou\n * pendant l'envoi), la barre se colle en bas de l'écran ; sinon, elle\n * reste à sa place : elle ne flotte pas sur le contenu sans raison. Les\n * bords de la carte s'alignent sur ceux des cartes de la page. */\n collante?: boolean\n /** Avec `collante` : la barre n'apparaît que lorsqu'elle a quelque chose\n * à dire (modifications, envoi en cours, « Enregistré »). Au repos, il ne\n * reste que sa zone de statut, invisible et sans place, pour que le\n * premier message soit annoncé. */\n masqueeAuRepos?: boolean\n /** Sans gestionnaire, « Enregistrer » soumet le formulaire qui l'entoure. */\n onEnregistrer?: () => void\n /** Revenir à ce qui est enregistré : affiche « Annuler ». À ne passer que\n * s'il y a des modifications (`onAnnuler={modifie ? annuler : undefined}`).\n * Au clic, le focus passe à « Enregistrer » : « Annuler » disparaît.\n * Avec `masqueeAuRepos`, toute la barre disparaît : c'est à l'application\n * de rendre le focus (au formulaire). */\n onAnnuler?: () => void\n /**\n * Formulaire dont les champs ont une valeur par défaut : le bouton\n * général ↶ (`ResetButton`), devant « Annuler », qui remet tous les\n * champs à leur défaut sans rien enregistrer. `masque` quand aucun champ\n * ne s'en écarte (il garde sa place). Au clic, le focus passe à\n * « Enregistrer », l'étape suivante.\n */\n retablirDefauts?: {\n onRetablir: () => void\n masque?: boolean\n }\n className?: string\n}\n\n/**\n * Pied d'un formulaire de page (profil, paramètres) : « Enregistrer »,\n * « Annuler » au besoin, le retour général aux valeurs par défaut au\n * besoin, et le statut, annoncé (« Enregistré », « Modifications non\n * enregistrées »).\n */\nexport function SaveBar({\n enCours = false,\n desactive = false,\n enregistre = false,\n modifie = false,\n collante = false,\n masqueeAuRepos = false,\n onEnregistrer,\n onAnnuler,\n retablirDefauts,\n className,\n}: SaveBarProps) {\n const refEnregistrer = useRef<HTMLButtonElement>(null)\n const auRepos =\n collante && masqueeAuRepos && !modifie && !enCours && !enregistre\n const enregistrer = (\n <Button\n ref={refEnregistrer}\n type={onEnregistrer ? \"button\" : \"submit\"}\n onClick={onEnregistrer}\n enCours={enCours}\n libelleEnCours=\"Enregistrement…\"\n // Désactivé mais focalisable : le bouton qu'on vient d'activer ne\n // rend pas le focus à <body> quand l'enregistrement finit et qu'il ne\n // reste rien à enregistrer.\n disabled={desactive}\n focusableWhenDisabled\n >\n Enregistrer\n </Button>\n )\n const annuler = onAnnuler ? (\n <Button\n variant=\"outline\"\n onClick={() => {\n // « Annuler » disparaît avec les modifications : sans cela, le\n // focus tomberait sur la page.\n refEnregistrer.current?.focus()\n onAnnuler()\n }}\n disabled={enCours}\n focusableWhenDisabled\n >\n Annuler\n </Button>\n ) : null\n const retablir = retablirDefauts ? (\n <ResetButton\n masque={retablirDefauts.masque}\n disabled={enCours}\n cible={() => refEnregistrer.current}\n onRetablir={retablirDefauts.onRetablir}\n />\n ) : null\n // Toujours présent : une zone `status` ajoutée en même temps que son texte\n // n'est pas annoncée.\n const statut = (\n <p\n role=\"status\"\n className={cn(\n \"text-sm text-muted-foreground\",\n // Le statut se replie sur deux lignes plutôt que de séparer les\n // boutons de la barre.\n collante && \"me-auto min-w-0 flex-1\",\n auRepos && \"sr-only\"\n )}\n >\n {/* Une modification faite après l'enregistrement l'emporte :\n « Enregistré » ne vaut que pour ce qui est à l'écran. */}\n {modifie ? (\n \"Modifications non enregistrées\"\n ) : enregistre ? (\n <span className=\"inline-flex items-center gap-1.5 font-medium text-success\">\n <CheckIcon className=\"size-4\" aria-hidden />\n Enregistré\n </span>\n ) : null}\n </p>\n )\n\n // Les deux boutons ne se séparent jamais : au téléphone, c'est le statut\n // qui passe à la ligne (barre simple) ou se replie (barre collante).\n const boutons = auRepos ? null : (\n <div\n data-slot=\"save-bar-actions\"\n className=\"flex shrink-0 items-center gap-3\"\n >\n {/* Ordre du DOM = ordre visuel : « Enregistrer » d'abord, ou à droite\n quand la barre est collante ; le retour aux défauts, l'action la\n plus rare, à l'autre bout. */}\n {collante ? retablir : enregistrer}\n {annuler}\n {collante ? enregistrer : retablir}\n </div>\n )\n\n return (\n <div\n data-slot=\"save-bar\"\n data-collante={collante || undefined}\n data-repos={auRepos || undefined}\n className={cn(\n \"flex items-center gap-3\",\n !collante && \"flex-wrap\",\n // Au repos, la barre ne prend aucune place : seule reste la zone de\n // statut (une zone `status` ajoutée en même temps que son texte\n // n'est pas annoncée).\n auRepos && \"contents\",\n // Toujours sur sa carte : sans elle, les marges intérieures\n // décalaient les boutons par rapport aux cartes de la page. Carte\n // pleinement opaque : un fond translucide laissait deviner, flou, le\n // texte qu'elle recouvre.\n collante &&\n !auRepos &&\n \"justify-end rounded-xl border border-border bg-card px-4 py-3\",\n collante && (modifie || enCours) && \"sticky bottom-4 z-10 shadow-sm\",\n className\n )}\n >\n {collante ? statut : boutons}\n {collante ? boutons : statut}\n </div>\n )\n}\n"],"mappings":";;;;;;;AA4DA,SAAgBA,EAAQ,EACtB,aAAU,IACV,eAAY,IACZ,gBAAa,IACb,aAAU,IACV,cAAW,IACX,oBAAiB,IACjB,kBACA,cACA,oBACA,gBACe;CACf,IAAMC,IAAiBC,EAA0B,IAAI,GAC/CC,IACJC,KAAYC,KAAkB,CAACC,KAAW,CAACC,KAAW,CAACC,GACnDC,IACJ,kBAACC,GAAD;EACE,KAAKT;EACL,MAAMU,IAAgB,WAAW;EACjC,SAASA;EACA;EACT,gBAAe;EAIf,UAAUC;EACV,uBAAA;EACD,UAAA;CAEO,CAAA,GAEJC,IAAUC,IACd,kBAACJ,GAAD;EACE,SAAQ;EACR,eAAe;GAIb,AADAT,EAAe,SAAS,MAAM,GAC9Ba,EAAU;EACZ;EACA,UAAUP;EACV,uBAAA;EACD,UAAA;CAEO,CAAA,IACN,MACEQ,IAAWC,IACf,kBAACC,GAAD;EACE,QAAQD,EAAgB;EACxB,UAAUT;EACV,aAAaN,EAAe;EAC5B,YAAYe,EAAgB;CAC7B,CAAA,IACC,MAGEE,IACJ,kBAAC,KAAD;EACE,MAAK;EACL,WAAWC,EACT,iCAGAf,KAAY,0BACZD,KAAW,SACb;EAIC,UAAAG,IACC,mCACEE,IACF,kBAAC,QAAD;GAAM,WAAU;GAAhB,UAAA,CACE,kBAACY,GAAD;IAAW,WAAU;IAAS,eAAA;GAAa,CAAA,GAAC,YAExC;EACJ,CAAA,IAAA;CACH,CAAA,GAKCC,IAAUlB,IAAU,OACxB,kBAAC,OAAD;EACE,aAAU;EACV,WAAU;EAFZ,UAAA;GAOGC,IAAWW,IAAWN;GACtBI;GACAT,IAAWK,IAAcM;EACvB;;CAGP,OACE,kBAAC,OAAD;EACE,aAAU;EACV,iBAAeX,KAAY,KAAA;EAC3B,cAAYD,KAAW,KAAA;EACvB,WAAWgB,EACT,2BACA,CAACf,KAAY,aAIbD,KAAW,YAKXC,KACE,CAACD,KACD,iEACFC,MAAaE,KAAWC,MAAY,kCACpCe,CACF;EApBF,UAAA,CAsBGlB,IAAWc,IAASG,GACpBjB,IAAWiB,IAAUH,CACnB;;AAET"}
1
+ {"version":3,"file":"save-bar.js","names":["SaveBar","refEnregistrer","useRef","retablirOffert","retablirDefauts","auRepos","collante","masqueeAuRepos","modifie","enCours","enregistre","enregistrer","Button","onEnregistrer","desactive","annuler","onAnnuler","retablir","ResetButton","statut","cn","CheckIcon","boutons","className"],"sources":["../../../src/components/etic/save-bar.tsx"],"sourcesContent":["import { useRef } from \"react\"\nimport { cn } from \"cn\"\nimport { CheckIcon } from \"lucide-react\"\n\nimport { Button } from \"@etic-ui/components/ui/button\"\nimport { ResetButton } from \"@etic-ui/components/etic/reset-button\"\n\nexport interface SaveBarProps {\n /** Enregistrement en cours : « Enregistrer » devient « Enregistrement… »,\n * occupé (`aria-busy`), ignore les clics, mais garde le focus ;\n * « Annuler » attend la fin. */\n enCours?: boolean\n /** Rien à enregistrer, ou une saisie à corriger d'abord. */\n desactive?: boolean\n /** Affiche « Enregistré » : la dernière mutation a réussi\n * (`mutation.isSuccess`). `modifie` l'emporte. */\n enregistre?: boolean\n /** Des modifications attendent : le statut dit « Modifications non\n * enregistrées », la raison pour laquelle « Enregistrer » est actif,\n * même après un enregistrement réussi. */\n modifie?: boolean\n /** Pied d'un formulaire plus haut que l'écran, sur une carte opaque,\n * boutons à droite, statut à gauche. Tant que `modifie` est vrai (ou\n * pendant l'envoi), la barre se colle en bas de l'écran ; sinon, elle\n * reste à sa place : elle ne flotte pas sur le contenu sans raison. Les\n * bords de la carte s'alignent sur ceux des cartes de la page. */\n collante?: boolean\n /** Avec `collante` : la barre n'apparaît que lorsqu'elle a quelque chose\n * à dire (modifications, envoi en cours, « Enregistré »). Au repos, il ne\n * reste que sa zone de statut, invisible et sans place, pour que le\n * premier message soit annoncé. */\n masqueeAuRepos?: boolean\n /** Sans gestionnaire, « Enregistrer » soumet le formulaire qui l'entoure. */\n onEnregistrer?: () => void\n /** Revenir à ce qui est enregistré : affiche « Annuler ». À ne passer que\n * s'il y a des modifications (`onAnnuler={modifie ? annuler : undefined}`).\n * Au clic, le focus passe à « Enregistrer » : « Annuler » disparaît.\n * Avec `masqueeAuRepos`, toute la barre disparaît : c'est à l'application\n * de rendre le focus (au formulaire). */\n onAnnuler?: () => void\n /**\n * Formulaire dont les champs ont une valeur par défaut : le bouton\n * général ↶ (`ResetButton`), devant « Annuler », qui remet tous les\n * champs à leur défaut sans rien enregistrer. `masque` quand il n'y a rien\n * à rétablir : il n'est alors pas rendu. Offert, il garde la barre visible\n * même au repos (`masqueeAuRepos`). Au clic, le focus passe à\n * « Enregistrer », l'étape suivante.\n */\n retablirDefauts?: {\n onRetablir: () => void\n masque?: boolean\n }\n className?: string\n}\n\n/**\n * Pied d'un formulaire de page (profil, paramètres) : « Enregistrer »,\n * « Annuler » au besoin, le retour général aux valeurs par défaut au\n * besoin, et le statut, annoncé (« Enregistré », « Modifications non\n * enregistrées »).\n */\nexport function SaveBar({\n enCours = false,\n desactive = false,\n enregistre = false,\n modifie = false,\n collante = false,\n masqueeAuRepos = false,\n onEnregistrer,\n onAnnuler,\n retablirDefauts,\n className,\n}: SaveBarProps) {\n const refEnregistrer = useRef<HTMLButtonElement>(null)\n // Le ↶ général offert est quelque chose à dire : la barre ne se cache pas.\n const retablirOffert = retablirDefauts?.masque ? undefined : retablirDefauts\n const auRepos =\n collante &&\n masqueeAuRepos &&\n !modifie &&\n !enCours &&\n !enregistre &&\n !retablirOffert\n const enregistrer = (\n <Button\n ref={refEnregistrer}\n type={onEnregistrer ? \"button\" : \"submit\"}\n onClick={onEnregistrer}\n enCours={enCours}\n libelleEnCours=\"Enregistrement…\"\n // Désactivé mais focalisable : le bouton qu'on vient d'activer ne\n // rend pas le focus à <body> quand l'enregistrement finit et qu'il ne\n // reste rien à enregistrer.\n disabled={desactive}\n focusableWhenDisabled\n >\n Enregistrer\n </Button>\n )\n const annuler = onAnnuler ? (\n <Button\n variant=\"outline\"\n onClick={() => {\n // « Annuler » disparaît avec les modifications : sans cela, le\n // focus tomberait sur la page.\n refEnregistrer.current?.focus()\n onAnnuler()\n }}\n disabled={enCours}\n focusableWhenDisabled\n >\n Annuler\n </Button>\n ) : null\n // Masqué, le ↶ général n'est pas rendu. Celui d'un champ garde sa place\n // pour ne pas s'effacer sous le curseur pendant la frappe ; celui-ci ne\n // change pas pendant qu'on le vise, et sa place vide repoussait le statut\n // sur trois lignes au téléphone. Il apparaît en fondu (`starting:`).\n const retablir = retablirOffert ? (\n <ResetButton\n disabled={enCours}\n className=\"starting:opacity-0\"\n onRetablir={() => {\n // Il disparaît d'ordinaire avec l'écart : le focus va d'abord à\n // « Enregistrer », l'étape suivante, plutôt que sur la page.\n refEnregistrer.current?.focus()\n retablirOffert.onRetablir()\n }}\n />\n ) : null\n // Toujours présent : une zone `status` ajoutée en même temps que son texte\n // n'est pas annoncée.\n const statut = (\n <p\n role=\"status\"\n className={cn(\n \"text-sm text-muted-foreground\",\n // Le statut se replie sur deux lignes plutôt que de séparer les\n // boutons de la barre.\n collante && \"me-auto min-w-0 flex-1\",\n auRepos && \"sr-only\"\n )}\n >\n {/* Une modification faite après l'enregistrement l'emporte :\n « Enregistré » ne vaut que pour ce qui est à l'écran. */}\n {modifie ? (\n \"Modifications non enregistrées\"\n ) : enregistre ? (\n <span className=\"inline-flex items-center gap-1.5 font-medium text-success\">\n <CheckIcon className=\"size-4\" aria-hidden />\n Enregistré\n </span>\n ) : null}\n </p>\n )\n\n // Les deux boutons ne se séparent jamais : au téléphone, c'est le statut\n // qui passe à la ligne (barre simple) ou se replie (barre collante).\n const boutons = auRepos ? null : (\n <div\n data-slot=\"save-bar-actions\"\n className=\"flex shrink-0 items-center gap-3\"\n >\n {/* Ordre du DOM = ordre visuel : « Enregistrer » d'abord, ou à droite\n quand la barre est collante ; le retour aux défauts, l'action la\n plus rare, à l'autre bout. */}\n {collante ? retablir : enregistrer}\n {annuler}\n {collante ? enregistrer : retablir}\n </div>\n )\n\n return (\n <div\n data-slot=\"save-bar\"\n data-collante={collante || undefined}\n data-repos={auRepos || undefined}\n className={cn(\n \"flex items-center gap-3\",\n !collante && \"flex-wrap\",\n // Au repos, la barre ne prend aucune place : seule reste la zone de\n // statut (une zone `status` ajoutée en même temps que son texte\n // n'est pas annoncée).\n auRepos && \"contents\",\n // Toujours sur sa carte : sans elle, les marges intérieures\n // décalaient les boutons par rapport aux cartes de la page. Carte\n // pleinement opaque : un fond translucide laissait deviner, flou, le\n // texte qu'elle recouvre.\n collante &&\n !auRepos &&\n \"justify-end rounded-xl border border-border bg-card px-4 py-3\",\n collante && (modifie || enCours) && \"sticky bottom-4 z-10 shadow-sm\",\n className\n )}\n >\n {collante ? statut : boutons}\n {collante ? boutons : statut}\n </div>\n )\n}\n"],"mappings":";;;;;;;AA6DA,SAAgBA,EAAQ,EACtB,aAAU,IACV,eAAY,IACZ,gBAAa,IACb,aAAU,IACV,cAAW,IACX,oBAAiB,IACjB,kBACA,cACA,oBACA,gBACe;CACf,IAAMC,IAAiBC,EAA0B,IAAI,GAE/CC,IAAiBC,GAAiB,SAAS,KAAA,IAAYA,GACvDC,IACJC,KACAC,KACA,CAACC,KACD,CAACC,KACD,CAACC,KACD,CAACP,GACGQ,IACJ,kBAACC,GAAD;EACE,KAAKX;EACL,MAAMY,IAAgB,WAAW;EACjC,SAASA;EACA;EACT,gBAAe;EAIf,UAAUC;EACV,uBAAA;EACD,UAAA;CAEO,CAAA,GAEJC,IAAUC,IACd,kBAACJ,GAAD;EACE,SAAQ;EACR,eAAe;GAIb,AADAX,EAAe,SAAS,MAAM,GAC9Be,EAAU;EACZ;EACA,UAAUP;EACV,uBAAA;EACD,UAAA;CAEO,CAAA,IACN,MAKEQ,IAAWd,IACf,kBAACe,GAAD;EACE,UAAUT;EACV,WAAU;EACV,kBAAkB;GAIhB,AADAR,EAAe,SAAS,MAAM,GAC9BE,EAAe,WAAW;EAC5B;CACD,CAAA,IACC,MAGEgB,IACJ,kBAAC,KAAD;EACE,MAAK;EACL,WAAWC,EACT,iCAGAd,KAAY,0BACZD,KAAW,SACb;EAIC,UAAAG,IACC,mCACEE,IACF,kBAAC,QAAD;GAAM,WAAU;GAAhB,UAAA,CACE,kBAACW,GAAD;IAAW,WAAU;IAAS,eAAA;GAAa,CAAA,GAAC,YAExC;EACJ,CAAA,IAAA;CACH,CAAA,GAKCC,IAAUjB,IAAU,OACxB,kBAAC,OAAD;EACE,aAAU;EACV,WAAU;EAFZ,UAAA;GAOGC,IAAWW,IAAWN;GACtBI;GACAT,IAAWK,IAAcM;EACvB;;CAGP,OACE,kBAAC,OAAD;EACE,aAAU;EACV,iBAAeX,KAAY,KAAA;EAC3B,cAAYD,KAAW,KAAA;EACvB,WAAWe,EACT,2BACA,CAACd,KAAY,aAIbD,KAAW,YAKXC,KACE,CAACD,KACD,iEACFC,MAAaE,KAAWC,MAAY,kCACpCc,CACF;EApBF,UAAA,CAsBGjB,IAAWa,IAASG,GACpBhB,IAAWgB,IAAUH,CACnB;;AAET"}
@@ -0,0 +1,38 @@
1
+ import { ReactNode } from 'react';
2
+ export interface SelectFieldOption<V extends string = string> {
3
+ valeur: V;
4
+ libelle: string;
5
+ /** Option visible mais impossible à choisir. */
6
+ desactive?: boolean;
7
+ /** Ligne d'aide sous le libellé de l'option. */
8
+ description?: ReactNode;
9
+ }
10
+ export interface SelectFieldProps<V extends string = string> {
11
+ libelle: ReactNode;
12
+ /** Option choisie ; `null` : rien n'est choisi, `placeholder` s'affiche. */
13
+ valeur: V | null;
14
+ options: readonly SelectFieldOption<V>[];
15
+ onValeurChange: (valeur: V) => void;
16
+ /** Texte du champ vide. « Choisir… » par défaut. */
17
+ placeholder?: string;
18
+ description?: ReactNode;
19
+ /** Message d'erreur, ou plusieurs (un par ligne). */
20
+ erreur?: ReactNode | string[];
21
+ obligatoire?: boolean;
22
+ desactive?: boolean;
23
+ /** Nom du champ dans le formulaire (entrée cachée qui porte la valeur). */
24
+ name?: string;
25
+ /** Affiché à la place des options quand il n'y en a aucune. */
26
+ vide?: ReactNode;
27
+ /** Bouton à droite du contrôle (`action` de `FormField`). */
28
+ action?: ReactNode;
29
+ /** Classes du champ (sa largeur). */
30
+ className?: string;
31
+ }
32
+ /**
33
+ * Liste de choix d'un formulaire : le `Select` dans son `FormField`
34
+ * (libellé, aide, erreur, obligatoire). Rien de choisi, le `placeholder`
35
+ * s'affiche : aucune option « Choisir… » ne le remplace, qui serait
36
+ * sélectionnable et cochée ; un choix est toujours une valeur.
37
+ */
38
+ export declare function SelectField<V extends string>({ libelle, valeur, options, onValeurChange, placeholder, description, erreur, obligatoire, desactive, name, vide, action, className, }: SelectFieldProps<V>): import("react").JSX.Element;
@@ -0,0 +1,42 @@
1
+ import { Select as e, SelectContent as t, SelectItem as n, SelectTrigger as r, SelectValue as i } from "../ui/select.js";
2
+ import { FormField as a } from "./form-field.js";
3
+ import { jsx as o, jsxs as s } from "react/jsx-runtime";
4
+ // src/components/etic/select-field.tsx
5
+ function c({ libelle: c, valeur: l, options: u, onValeurChange: d, placeholder: f = "Choisir…", description: p, erreur: m, obligatoire: h, desactive: g, name: _, vide: v, action: y, className: b }) {
6
+ return /* @__PURE__ */ s(e, {
7
+ items: u.map((e) => ({
8
+ value: e.valeur,
9
+ label: e.libelle
10
+ })),
11
+ value: l,
12
+ disabled: g,
13
+ required: h,
14
+ name: _,
15
+ onValueChange: (e) => {
16
+ e !== null && d(e);
17
+ },
18
+ children: [/* @__PURE__ */ o(a, {
19
+ libelle: c,
20
+ description: p,
21
+ erreur: m ?? void 0,
22
+ obligatoire: h,
23
+ action: y,
24
+ className: b,
25
+ children: /* @__PURE__ */ o(r, {
26
+ className: "w-full",
27
+ children: /* @__PURE__ */ o(i, { placeholder: f })
28
+ })
29
+ }), /* @__PURE__ */ o(t, {
30
+ vide: v,
31
+ children: u.map((e) => /* @__PURE__ */ o(n, {
32
+ value: e.valeur,
33
+ disabled: e.desactive,
34
+ description: e.description,
35
+ children: e.libelle
36
+ }, e.valeur))
37
+ })]
38
+ });
39
+ }
40
+ export { c as SelectField };
41
+
42
+ //# sourceMappingURL=select-field.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"select-field.js","names":["SelectField","Select","options","option","valeur","desactive","obligatoire","choisie","onValeurChange","FormField","erreur","SelectTrigger","SelectValue","SelectContent","SelectItem"],"sources":["../../../src/components/etic/select-field.tsx"],"sourcesContent":["import type { ReactNode } from \"react\"\n\nimport {\n Select,\n SelectContent,\n SelectItem,\n SelectTrigger,\n SelectValue,\n} from \"@etic-ui/components/ui/select\"\nimport { FormField } from \"@etic-ui/components/etic/form-field\"\n\nexport interface SelectFieldOption<V extends string = string> {\n valeur: V\n libelle: string\n /** Option visible mais impossible à choisir. */\n desactive?: boolean\n /** Ligne d'aide sous le libellé de l'option. */\n description?: ReactNode\n}\n\nexport interface SelectFieldProps<V extends string = string> {\n libelle: ReactNode\n /** Option choisie ; `null` : rien n'est choisi, `placeholder` s'affiche. */\n valeur: V | null\n options: readonly SelectFieldOption<V>[]\n onValeurChange: (valeur: V) => void\n /** Texte du champ vide. « Choisir… » par défaut. */\n placeholder?: string\n description?: ReactNode\n /** Message d'erreur, ou plusieurs (un par ligne). */\n erreur?: ReactNode | string[]\n obligatoire?: boolean\n desactive?: boolean\n /** Nom du champ dans le formulaire (entrée cachée qui porte la valeur). */\n name?: string\n /** Affiché à la place des options quand il n'y en a aucune. */\n vide?: ReactNode\n /** Bouton à droite du contrôle (`action` de `FormField`). */\n action?: ReactNode\n /** Classes du champ (sa largeur). */\n className?: string\n}\n\n/**\n * Liste de choix d'un formulaire : le `Select` dans son `FormField`\n * (libellé, aide, erreur, obligatoire). Rien de choisi, le `placeholder`\n * s'affiche : aucune option « Choisir… » ne le remplace, qui serait\n * sélectionnable et cochée ; un choix est toujours une valeur.\n */\nexport function SelectField<V extends string>({\n libelle,\n valeur,\n options,\n onValeurChange,\n placeholder = \"Choisir…\",\n description,\n erreur,\n obligatoire,\n desactive,\n name,\n vide,\n action,\n className,\n}: SelectFieldProps<V>) {\n return (\n <Select\n items={options.map((option) => ({\n value: option.valeur,\n label: option.libelle,\n }))}\n value={valeur}\n disabled={desactive}\n required={obligatoire}\n name={name}\n // Le type admet `null` (rien de choisi), mais aucune option ne le\n // porte : un choix de la personne est toujours une valeur.\n onValueChange={(choisie) => {\n if (choisie !== null) onValeurChange(choisie)\n }}\n >\n <FormField\n libelle={libelle}\n description={description}\n erreur={erreur ?? undefined}\n obligatoire={obligatoire}\n action={action}\n className={className}\n >\n <SelectTrigger className=\"w-full\">\n <SelectValue placeholder={placeholder} />\n </SelectTrigger>\n </FormField>\n <SelectContent vide={vide}>\n {options.map((option) => (\n <SelectItem\n key={option.valeur}\n value={option.valeur}\n disabled={option.desactive}\n description={option.description}\n >\n {option.libelle}\n </SelectItem>\n ))}\n </SelectContent>\n </Select>\n )\n}\n"],"mappings":";;;;AAiDA,SAAgBA,EAA8B,EAC5C,YACA,WACA,YACA,mBACA,iBAAc,YACd,gBACA,WACA,gBACA,cACA,SACA,SACA,WACA,gBACsB;CACtB,OACE,kBAACC,GAAD;EACE,OAAOC,EAAQ,KAAK,OAAY;GAC9B,OAAOC,EAAO;GACd,OAAOA,EAAO;EAChB,EAAE;EACF,OAAOC;EACP,UAAUC;EACV,UAAUC;EACJ;EAGN,gBAAgB,MAAY;GAC1B,AAAIC,MAAY,QAAMC,EAAeD,CAAO;EAC9C;EAbF,UAAA,CAeE,kBAACE,GAAD;GACW;GACI;GACb,QAAQC,KAAU,KAAA;GACL;GACL;GACG;GAEX,UAAA,kBAACC,GAAD;IAAe,WAAU;IACvB,UAAA,kBAACC,GAAD,EAA0B,eAAc,CAAA;GAC3B,CAAA;EACN,CAAA,GACX,kBAACC,GAAD;GAAqB;GAClB,UAAAX,EAAQ,KAAK,MACZ,kBAACY,GAAD;IAEE,OAAOX,EAAO;IACd,UAAUA,EAAO;IACjB,aAAaA,EAAO;IAEnB,UAAAA,EAAO;GACE,GANLA,EAAO,MAMF,CACb;EACY,CAAA,CACT;;AAEZ"}
@@ -0,0 +1,15 @@
1
+ import { ReactNode } from 'react';
2
+ export interface SubSectionProps {
3
+ titre: ReactNode;
4
+ /** Sur la ligne du titre : un badge d'état, une action discrète. */
5
+ aCote?: ReactNode;
6
+ /** Écart entre le titre et le contenu (`gap-2` par défaut), largeur. */
7
+ className?: string;
8
+ children: ReactNode;
9
+ }
10
+ /**
11
+ * Un bloc titré dans une carte, un tiroir ou un dialogue : une `section`
12
+ * nommée par son titre (`<h3>`, sous le `<h2>` d'une `SectionCard`), puis
13
+ * son contenu.
14
+ */
15
+ export declare function SubSection({ titre, aCote, className, children, }: SubSectionProps): import("react").JSX.Element;
@@ -0,0 +1,23 @@
1
+ import { cn as e } from "cn";
2
+ import { useId as t } from "react";
3
+ import { jsx as n, jsxs as r } from "react/jsx-runtime";
4
+ // src/components/etic/sub-section.tsx
5
+ function i({ titre: i, aCote: a, className: o, children: s }) {
6
+ let c = t(), l = /* @__PURE__ */ n("h3", {
7
+ id: c,
8
+ className: "text-sm font-medium",
9
+ children: i
10
+ });
11
+ return /* @__PURE__ */ r("section", {
12
+ "aria-labelledby": c,
13
+ "data-slot": "sub-section",
14
+ className: e("flex min-w-0 flex-col gap-2", o),
15
+ children: [a ? /* @__PURE__ */ r("div", {
16
+ className: "flex flex-wrap items-center gap-2",
17
+ children: [l, a]
18
+ }) : l, s]
19
+ });
20
+ }
21
+ export { i as SubSection };
22
+
23
+ //# sourceMappingURL=sub-section.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sub-section.js","names":["SubSection","id","useId","entete","titre","cn","className","aCote","children"],"sources":["../../../src/components/etic/sub-section.tsx"],"sourcesContent":["import { useId, type ReactNode } from \"react\"\nimport { cn } from \"cn\"\n\nexport interface SubSectionProps {\n titre: ReactNode\n /** Sur la ligne du titre : un badge d'état, une action discrète. */\n aCote?: ReactNode\n /** Écart entre le titre et le contenu (`gap-2` par défaut), largeur. */\n className?: string\n children: ReactNode\n}\n\n/**\n * Un bloc titré dans une carte, un tiroir ou un dialogue : une `section`\n * nommée par son titre (`<h3>`, sous le `<h2>` d'une `SectionCard`), puis\n * son contenu.\n */\nexport function SubSection({\n titre,\n aCote,\n className,\n children,\n}: SubSectionProps) {\n const id = useId()\n const entete = (\n <h3 id={id} className=\"text-sm font-medium\">\n {titre}\n </h3>\n )\n return (\n <section\n aria-labelledby={id}\n data-slot=\"sub-section\"\n className={cn(\"flex min-w-0 flex-col gap-2\", className)}\n >\n {aCote ? (\n <div className=\"flex flex-wrap items-center gap-2\">\n {entete}\n {aCote}\n </div>\n ) : (\n entete\n )}\n {children}\n </section>\n )\n}\n"],"mappings":";;;;AAiBA,SAAgBA,EAAW,EACzB,UACA,UACA,cACA,eACkB;CAClB,IAAMC,IAAKC,EAAM,GACXC,IACJ,kBAAC,MAAD;EAAQ;EAAI,WAAU;EACnB,UAAAC;CACC,CAAA;CAEN,OACE,kBAAC,WAAD;EACE,mBAAiBH;EACjB,aAAU;EACV,WAAWI,EAAG,+BAA+BC,CAAS;EAHxD,UAAA,CAKGC,IACC,kBAAC,OAAD;GAAK,WAAU;GAAf,UAAA,CACGJ,GACAI,CACE;EAEL,CAAA,IAAAJ,GAEDK,CACM;;AAEb"}
@@ -0,0 +1,58 @@
1
+ export interface UseDetailSheetOptions<T> {
2
+ /**
3
+ * Identifiant de l'élément demandé (un paramètre d'URL, `?document=12`) ;
4
+ * `null` : tiroir fermé.
5
+ */
6
+ id: string | null;
7
+ /** Éléments chargés (la page affichée de la liste). */
8
+ elements: readonly T[] | undefined;
9
+ /** Identifiant d'un élément, comparé à `id`. */
10
+ idElement: (element: T) => string;
11
+ /**
12
+ * La liste se charge encore : un élément absent est en attente
13
+ * (`undefined`), pas introuvable. Faux une fois la liste arrivée ou en
14
+ * échec (`isPending` de TanStack Query).
15
+ */
16
+ enChargement: boolean;
17
+ /** Pose ou retire l'identifiant (`null`). */
18
+ onIdChange: (id: string | null) => void;
19
+ }
20
+ export interface UseDetailSheetResultat<T> {
21
+ /** Un identifiant est demandé. */
22
+ ouvert: boolean;
23
+ /** L'élément à afficher (`element` de `DetailSheet`) : `undefined` en
24
+ * attente, `null` introuvable. */
25
+ element: T | null | undefined;
26
+ /** Ouvre le tiroir sur cet élément. Stable, comme `fermer` et
27
+ * `onOuvertChange`. */
28
+ ouvrir: (element: T) => void;
29
+ fermer: () => void;
30
+ /** Pour `onOuvertChange` du tiroir : seule la fermeture agit. */
31
+ onOuvertChange: (ouvert: boolean) => void;
32
+ }
33
+ /**
34
+ * Le tiroir de détail d'une liste, piloté par un identifiant gardé ailleurs
35
+ * (l'URL, le plus souvent : un lien ouvre le tiroir, le retour arrière le
36
+ * ferme). L'élément affiché est celui de la liste chargée, ou le dernier
37
+ * ouvert : un tri, un filtre ou une action qui le fait sortir de la liste
38
+ * ne referme pas le tiroir. Un identifiant absent de la liste arrivée (lien
39
+ * abîmé, élément supprimé, liste en échec) rend `null` : le tiroir s'ouvre
40
+ * sur « introuvable », avec de quoi le fermer, au lieu d'être ignoré en
41
+ * silence.
42
+ *
43
+ * ```tsx
44
+ * const [params, setParams] = useSearchParams()
45
+ * const tiroir = useDetailSheet({
46
+ * id: params.get("document"),
47
+ * elements: requete.data?.items,
48
+ * idElement: (d) => String(d.id),
49
+ * enChargement: requete.isPending,
50
+ * onIdChange: definirDocument,
51
+ * })
52
+ * <DetailSheet element={tiroir.element} ouvert={tiroir.ouvert}
53
+ * onOuvertChange={tiroir.onOuvertChange} introuvable={…}>
54
+ * {(document) => …}
55
+ * </DetailSheet>
56
+ * ```
57
+ */
58
+ export declare function useDetailSheet<T>({ id, elements, idElement, enChargement, onIdChange, }: UseDetailSheetOptions<T>): UseDetailSheetResultat<T>;
@@ -0,0 +1,35 @@
1
+ import { useCallback as e, useLayoutEffect as t, useRef as n, useState as r } from "react";
2
+ // src/components/etic/use-detail-sheet.ts
3
+ function i({ id: i, elements: a, idElement: o, enChargement: s, onIdChange: c }) {
4
+ let [l, u] = r(null), d = i === null ? void 0 : a?.find((e) => o(e) === i), f = l === null ? null : o(l);
5
+ d !== void 0 && f !== i && u(d);
6
+ let p;
7
+ i !== null && (p = d ?? (l !== null && f === i ? l : void 0) ?? (s ? void 0 : null));
8
+ let m = n({
9
+ idElement: o,
10
+ onIdChange: c
11
+ });
12
+ t(() => {
13
+ m.current = {
14
+ idElement: o,
15
+ onIdChange: c
16
+ };
17
+ });
18
+ let h = e((e) => {
19
+ u(e);
20
+ let { idElement: t, onIdChange: n } = m.current;
21
+ n(t(e));
22
+ }, []), g = e(() => m.current.onIdChange(null), []), _ = e((e) => {
23
+ e || g();
24
+ }, [g]);
25
+ return {
26
+ ouvert: i !== null,
27
+ element: p,
28
+ ouvrir: h,
29
+ fermer: g,
30
+ onOuvertChange: _
31
+ };
32
+ }
33
+ export { i as useDetailSheet };
34
+
35
+ //# sourceMappingURL=use-detail-sheet.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-detail-sheet.js","names":["useDetailSheet","dernier","setDernier","useState","dansLaListe","id","elements","idElement","element","dernierId","enChargement","dernierRendu","useRef","ouvrir","useCallback","choisi","fermer","onOuvertChange","ouvert"],"sources":["../../../src/components/etic/use-detail-sheet.ts"],"sourcesContent":["import { useCallback, useLayoutEffect, useRef, useState } from \"react\"\n\nexport interface UseDetailSheetOptions<T> {\n /**\n * Identifiant de l'élément demandé (un paramètre d'URL, `?document=12`) ;\n * `null` : tiroir fermé.\n */\n id: string | null\n /** Éléments chargés (la page affichée de la liste). */\n elements: readonly T[] | undefined\n /** Identifiant d'un élément, comparé à `id`. */\n idElement: (element: T) => string\n /**\n * La liste se charge encore : un élément absent est en attente\n * (`undefined`), pas introuvable. Faux une fois la liste arrivée ou en\n * échec (`isPending` de TanStack Query).\n */\n enChargement: boolean\n /** Pose ou retire l'identifiant (`null`). */\n onIdChange: (id: string | null) => void\n}\n\nexport interface UseDetailSheetResultat<T> {\n /** Un identifiant est demandé. */\n ouvert: boolean\n /** L'élément à afficher (`element` de `DetailSheet`) : `undefined` en\n * attente, `null` introuvable. */\n element: T | null | undefined\n /** Ouvre le tiroir sur cet élément. Stable, comme `fermer` et\n * `onOuvertChange`. */\n ouvrir: (element: T) => void\n fermer: () => void\n /** Pour `onOuvertChange` du tiroir : seule la fermeture agit. */\n onOuvertChange: (ouvert: boolean) => void\n}\n\n/**\n * Le tiroir de détail d'une liste, piloté par un identifiant gardé ailleurs\n * (l'URL, le plus souvent : un lien ouvre le tiroir, le retour arrière le\n * ferme). L'élément affiché est celui de la liste chargée, ou le dernier\n * ouvert : un tri, un filtre ou une action qui le fait sortir de la liste\n * ne referme pas le tiroir. Un identifiant absent de la liste arrivée (lien\n * abîmé, élément supprimé, liste en échec) rend `null` : le tiroir s'ouvre\n * sur « introuvable », avec de quoi le fermer, au lieu d'être ignoré en\n * silence.\n *\n * ```tsx\n * const [params, setParams] = useSearchParams()\n * const tiroir = useDetailSheet({\n * id: params.get(\"document\"),\n * elements: requete.data?.items,\n * idElement: (d) => String(d.id),\n * enChargement: requete.isPending,\n * onIdChange: definirDocument,\n * })\n * <DetailSheet element={tiroir.element} ouvert={tiroir.ouvert}\n * onOuvertChange={tiroir.onOuvertChange} introuvable={…}>\n * {(document) => …}\n * </DetailSheet>\n * ```\n */\nexport function useDetailSheet<T>({\n id,\n elements,\n idElement,\n enChargement,\n onIdChange,\n}: UseDetailSheetOptions<T>): UseDetailSheetResultat<T> {\n const [dernier, setDernier] = useState<T | null>(null)\n const dansLaListe =\n id === null\n ? undefined\n : elements?.find((element) => idElement(element) === id)\n // Retenu dès qu'il paraît dans la liste, même ouvert par un lien : il reste\n // affiché, en repli, quand la liste ne le contient plus. Retenu par son\n // identifiant, pas par sa référence : des éléments recréés à chaque rendu\n // (`items.map(…)` en ligne) ne relancent pas le rendu sans fin. Tant qu'il\n // est dans la liste, c'est la version de la liste qui s'affiche.\n const dernierId = dernier === null ? null : idElement(dernier)\n if (dansLaListe !== undefined && dernierId !== id) setDernier(dansLaListe)\n\n let element: T | null | undefined\n if (id !== null) {\n element =\n dansLaListe ??\n (dernier !== null && dernierId === id ? dernier : undefined) ??\n (enChargement ? undefined : null)\n }\n\n // Les fonctions rendues sont stables même si l'application écrit\n // `idElement` ou `onIdChange` en ligne : elles lisent ceux du dernier rendu.\n const dernierRendu = useRef({ idElement, onIdChange })\n useLayoutEffect(() => {\n dernierRendu.current = { idElement, onIdChange }\n })\n const ouvrir = useCallback((choisi: T) => {\n setDernier(choisi)\n const { idElement, onIdChange } = dernierRendu.current\n onIdChange(idElement(choisi))\n }, [])\n const fermer = useCallback(() => dernierRendu.current.onIdChange(null), [])\n const onOuvertChange = useCallback(\n (ouvert: boolean) => {\n if (!ouvert) fermer()\n },\n [fermer]\n )\n\n return { ouvert: id !== null, element, ouvrir, fermer, onOuvertChange }\n}\n"],"mappings":";;AA6DA,SAAgBA,EAAkB,EAChC,OACA,aACA,cACA,iBACA,iBACsD;CACtD,IAAM,CAACC,GAASC,KAAcC,EAAmB,IAAI,GAC/CC,IACJC,MAAO,OACH,KAAA,IACAC,GAAU,MAAM,MAAYC,EAAUC,CAAO,MAAMH,CAAE,GAMrDI,IAAYR,MAAY,OAAO,OAAOM,EAAUN,CAAO;CAC7D,AAAIG,MAAgB,KAAA,KAAaK,MAAcJ,KAAIH,EAAWE,CAAW;CAEzE,IAAII;CACJ,AAAIH,MAAO,SACT,IACED,MACCH,MAAY,QAAQQ,MAAcJ,IAAKJ,IAAU,KAAA,OACjDS,IAAe,KAAA,IAAY;CAKhC,IAAMC,IAAeC,EAAO;EAAE;EAAW;CAAW,CAAC;CACrD,QAAsB;EACpB,EAAa,UAAU;GAAE;GAAW;EAAW;CACjD,CAAC;CACD,IAAMC,IAASC,GAAa,MAAc;EACxC,EAAWC,CAAM;EACjB,IAAM,EAAE,cAAW,kBAAeJ,EAAa;EAC/C,EAAWJ,EAAUQ,CAAM,CAAC;CAC9B,GAAG,CAAC,CAAC,GACCC,IAASF,QAAkBH,EAAa,QAAQ,WAAW,IAAI,GAAG,CAAC,CAAC,GACpEM,IAAiBH,GACpB,MAAoB;EACnB,AAAKI,KAAQF,EAAO;CACtB,GACA,CAACA,CAAM,CACT;CAEA,OAAO;EAAE,QAAQX,MAAO;EAAM;EAAS;EAAQ;EAAQ;CAAe;AACxE"}
@@ -0,0 +1,55 @@
1
+ import { DataTableUnite } from './data-table-format';
2
+ import { DataTablePaginationDecalageProps } from './data-table-pagination';
3
+ import { DataTableCountNombresProps } from './data-table-toolbar';
4
+ /** La requête d'une page, telle que la rend `useQuery` (TanStack Query). */
5
+ export interface ServerPageRequete {
6
+ data?: {
7
+ total: number;
8
+ items: readonly unknown[];
9
+ };
10
+ /** Page conservée d'une requête précédente (`keepPreviousData`) : son
11
+ * total ne vaut pas pour le décalage demandé. */
12
+ isPlaceholderData?: boolean;
13
+ }
14
+ export interface UseServerPaginationOptions {
15
+ /** Rang (à partir de 0) du premier élément demandé. */
16
+ decalage: number;
17
+ /** Nombre d'éléments par page. */
18
+ limite: number;
19
+ onDecalageChange: (decalage: number) => void;
20
+ /** Sans lui, pas de choix du nombre par page. */
21
+ onLimiteChange?: (limite: number) => void;
22
+ requete: ServerPageRequete;
23
+ /** Nom des éléments, pour le compteur. */
24
+ unite?: DataTableUnite;
25
+ /** Accorde « affichées » au féminin. */
26
+ feminin?: boolean;
27
+ /** Nombres d'éléments par page proposés (ceux de `DataTablePagination`
28
+ * par défaut). */
29
+ limites?: readonly number[];
30
+ }
31
+ export interface UseServerPaginationResultat {
32
+ /** Pour `compteur` de `DataTableToolbar` ; `undefined` avant la première
33
+ * page. */
34
+ compteur?: DataTableCountNombresProps;
35
+ /** Pour `DataTablePagination` ; `undefined` avant la première page. */
36
+ pagination?: DataTablePaginationDecalageProps;
37
+ }
38
+ /**
39
+ * La page reçue d'une liste paginée côté serveur, prête pour le compteur de
40
+ * `DataTableToolbar` et pour `DataTablePagination`. Un décalage au-delà du
41
+ * total (lien vers la page 5 d'une liste qui n'en compte plus que deux,
42
+ * suppression qui vide la dernière page) ramène à la dernière page, au lieu
43
+ * d'afficher « aucun élément » sans pagination pour revenir. Seule la
44
+ * réponse de la requête courante compte, pas une page conservée.
45
+ *
46
+ * ```tsx
47
+ * const page = useServerPagination({
48
+ * decalage, limite, onDecalageChange: setDecalage, onLimiteChange: setLimite,
49
+ * requete: membres, unite: { singulier: "membre", pluriel: "membres" },
50
+ * })
51
+ * <DataTableToolbar compteur={page.compteur} … />
52
+ * {page.pagination ? <DataTablePagination {...page.pagination} /> : null}
53
+ * ```
54
+ */
55
+ export declare function useServerPagination({ decalage, limite, onDecalageChange, onLimiteChange, requete, unite, feminin, limites, }: UseServerPaginationOptions): UseServerPaginationResultat;
@@ -0,0 +1,31 @@
1
+ import { useEffect as e, useLayoutEffect as t, useRef as n } from "react";
2
+ // src/components/etic/use-server-pagination.ts
3
+ function r({ decalage: r, limite: i, onDecalageChange: a, onLimiteChange: o, requete: s, unite: c, feminin: l = !1, limites: u }) {
4
+ let d = s.isPlaceholderData ? void 0 : s.data, f = d !== void 0 && d.items.length === 0 && d.total > 0 && r >= d.total, p = d ? Math.floor((d.total - 1) / i) * i : 0, m = n(a);
5
+ t(() => {
6
+ m.current = a;
7
+ }), e(() => {
8
+ f && m.current(p);
9
+ }, [f, p]);
10
+ let h = s.data;
11
+ return h ? {
12
+ compteur: {
13
+ total: h.total,
14
+ decalage: r,
15
+ nombre: h.items.length,
16
+ unite: c,
17
+ feminin: l
18
+ },
19
+ pagination: {
20
+ total: h.total,
21
+ decalage: r,
22
+ limite: i,
23
+ limites: u,
24
+ onDecalageChange: a,
25
+ onLimiteChange: o
26
+ }
27
+ } : {};
28
+ }
29
+ export { r as useServerPagination };
30
+
31
+ //# sourceMappingURL=use-server-pagination.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-server-pagination.js","names":["useServerPagination","reelle","requete","horsLimites","decalage","derniere","limite","recadrer","useRef","onDecalageChange","useLayoutEffect","useEffect","page"],"sources":["../../../src/components/etic/use-server-pagination.ts"],"sourcesContent":["import { useEffect, useLayoutEffect, useRef } from \"react\"\n\nimport type { DataTableUnite } from \"@etic-ui/components/etic/data-table-format\"\nimport type { DataTablePaginationDecalageProps } from \"@etic-ui/components/etic/data-table-pagination\"\nimport type { DataTableCountNombresProps } from \"@etic-ui/components/etic/data-table-toolbar\"\n\n/** La requête d'une page, telle que la rend `useQuery` (TanStack Query). */\nexport interface ServerPageRequete {\n data?: { total: number; items: readonly unknown[] }\n /** Page conservée d'une requête précédente (`keepPreviousData`) : son\n * total ne vaut pas pour le décalage demandé. */\n isPlaceholderData?: boolean\n}\n\nexport interface UseServerPaginationOptions {\n /** Rang (à partir de 0) du premier élément demandé. */\n decalage: number\n /** Nombre d'éléments par page. */\n limite: number\n onDecalageChange: (decalage: number) => void\n /** Sans lui, pas de choix du nombre par page. */\n onLimiteChange?: (limite: number) => void\n requete: ServerPageRequete\n /** Nom des éléments, pour le compteur. */\n unite?: DataTableUnite\n /** Accorde « affichées » au féminin. */\n feminin?: boolean\n /** Nombres d'éléments par page proposés (ceux de `DataTablePagination`\n * par défaut). */\n limites?: readonly number[]\n}\n\nexport interface UseServerPaginationResultat {\n /** Pour `compteur` de `DataTableToolbar` ; `undefined` avant la première\n * page. */\n compteur?: DataTableCountNombresProps\n /** Pour `DataTablePagination` ; `undefined` avant la première page. */\n pagination?: DataTablePaginationDecalageProps\n}\n\n/**\n * La page reçue d'une liste paginée côté serveur, prête pour le compteur de\n * `DataTableToolbar` et pour `DataTablePagination`. Un décalage au-delà du\n * total (lien vers la page 5 d'une liste qui n'en compte plus que deux,\n * suppression qui vide la dernière page) ramène à la dernière page, au lieu\n * d'afficher « aucun élément » sans pagination pour revenir. Seule la\n * réponse de la requête courante compte, pas une page conservée.\n *\n * ```tsx\n * const page = useServerPagination({\n * decalage, limite, onDecalageChange: setDecalage, onLimiteChange: setLimite,\n * requete: membres, unite: { singulier: \"membre\", pluriel: \"membres\" },\n * })\n * <DataTableToolbar compteur={page.compteur} … />\n * {page.pagination ? <DataTablePagination {...page.pagination} /> : null}\n * ```\n */\nexport function useServerPagination({\n decalage,\n limite,\n onDecalageChange,\n onLimiteChange,\n requete,\n unite,\n feminin = false,\n limites,\n}: UseServerPaginationOptions): UseServerPaginationResultat {\n const reelle = requete.isPlaceholderData ? undefined : requete.data\n const horsLimites =\n reelle !== undefined &&\n reelle.items.length === 0 &&\n reelle.total > 0 &&\n decalage >= reelle.total\n const derniere = reelle ? Math.floor((reelle.total - 1) / limite) * limite : 0\n // `onDecalageChange` écrit en ligne ne doit pas relancer le recadrage : il\n // est lu du dernier rendu.\n const recadrer = useRef(onDecalageChange)\n useLayoutEffect(() => {\n recadrer.current = onDecalageChange\n })\n useEffect(() => {\n if (horsLimites) recadrer.current(derniere)\n }, [horsLimites, derniere])\n\n const page = requete.data\n if (!page) return {}\n return {\n compteur: {\n total: page.total,\n decalage,\n nombre: page.items.length,\n unite,\n feminin,\n },\n pagination: {\n total: page.total,\n decalage,\n limite,\n limites,\n onDecalageChange,\n onLimiteChange,\n },\n }\n}\n"],"mappings":";;AAyDA,SAAgBA,EAAoB,EAClC,aACA,WACA,qBACA,mBACA,YACA,UACA,aAAU,IACV,cAC0D;CAC1D,IAAMC,IAASC,EAAQ,oBAAoB,KAAA,IAAYA,EAAQ,MACzDC,IACJF,MAAW,KAAA,KACXA,EAAO,MAAM,WAAW,KACxBA,EAAO,QAAQ,KACfG,KAAYH,EAAO,OACfI,IAAWJ,IAAS,KAAK,OAAOA,EAAO,QAAQ,KAAKK,CAAM,IAAIA,IAAS,GAGvEC,IAAWC,EAAOC,CAAgB;CAIxC,AAHAC,QAAsB;EACpB,EAAS,UAAUD;CACrB,CAAC,GACDE,QAAgB;EACd,AAAIR,KAAaI,EAAS,QAAQF,CAAQ;CAC5C,GAAG,CAACF,GAAaE,CAAQ,CAAC;CAE1B,IAAMO,IAAOV,EAAQ;CAErB,OADKU,IACE;EACL,UAAU;GACR,OAAOA,EAAK;GACZ;GACA,QAAQA,EAAK,MAAM;GACnB;GACA;EACF;EACA,YAAY;GACV,OAAOA,EAAK;GACZ;GACA;GACA;GACA;GACA;EACF;CACF,IAjBkB,CAAC;AAkBrB"}
@@ -0,0 +1,29 @@
1
+ import { OnChangeFn, SortingState } from '@tanstack/react-table';
2
+ /** Sens d'un tri. */
3
+ export type SensTri = "asc" | "desc";
4
+ export interface UseServerSortingOptions<K extends string> {
5
+ /** Colonne triée (son identifiant est la clé de tri du serveur). */
6
+ tri: K;
7
+ sens: SensTri;
8
+ /** Tri demandé par un en-tête ; `null` : tri retiré, l'application
9
+ * revient à son tri par défaut. */
10
+ definirTri: (tri: K | null, sens: SensTri) => void;
11
+ }
12
+ export interface UseServerSortingResultat {
13
+ tri: SortingState;
14
+ onTriChange: OnChangeFn<SortingState>;
15
+ triManuel: true;
16
+ }
17
+ /**
18
+ * Le tri d'une liste triée par le serveur, tel que `useDataTable` le lit et
19
+ * l'écrit : à étaler dans ses options. Les identifiants des colonnes
20
+ * triables sont les clés de tri du serveur ; un seul tri à la fois.
21
+ *
22
+ * ```tsx
23
+ * const table = useDataTable({
24
+ * donnees, colonnes, idLigne,
25
+ * ...useServerSorting({ tri, sens, definirTri }),
26
+ * })
27
+ * ```
28
+ */
29
+ export declare function useServerSorting<K extends string>({ tri: cle, sens, definirTri, }: UseServerSortingOptions<K>): UseServerSortingResultat;
@@ -0,0 +1,19 @@
1
+ import { useMemo as e } from "react";
2
+ // src/components/etic/use-server-sorting.ts
3
+ function t({ tri: t, sens: n, definirTri: r }) {
4
+ let i = e(() => [{
5
+ id: t,
6
+ desc: n === "desc"
7
+ }], [t, n]);
8
+ return {
9
+ tri: i,
10
+ onTriChange: (e) => {
11
+ let [t] = typeof e == "function" ? e(i) : e;
12
+ r(t?.id ?? null, t?.desc ? "desc" : "asc");
13
+ },
14
+ triManuel: !0
15
+ };
16
+ }
17
+ export { t as useServerSorting };
18
+
19
+ //# sourceMappingURL=use-server-sorting.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-server-sorting.js","names":["useServerSorting","cle","tri","useMemo","sens","premier","miseAJour"],"sources":["../../../src/components/etic/use-server-sorting.ts"],"sourcesContent":["import { useMemo } from \"react\"\nimport type { OnChangeFn, SortingState } from \"@tanstack/react-table\"\n\n/** Sens d'un tri. */\nexport type SensTri = \"asc\" | \"desc\"\n\nexport interface UseServerSortingOptions<K extends string> {\n /** Colonne triée (son identifiant est la clé de tri du serveur). */\n tri: K\n sens: SensTri\n /** Tri demandé par un en-tête ; `null` : tri retiré, l'application\n * revient à son tri par défaut. */\n definirTri: (tri: K | null, sens: SensTri) => void\n}\n\nexport interface UseServerSortingResultat {\n tri: SortingState\n onTriChange: OnChangeFn<SortingState>\n triManuel: true\n}\n\n/**\n * Le tri d'une liste triée par le serveur, tel que `useDataTable` le lit et\n * l'écrit : à étaler dans ses options. Les identifiants des colonnes\n * triables sont les clés de tri du serveur ; un seul tri à la fois.\n *\n * ```tsx\n * const table = useDataTable({\n * donnees, colonnes, idLigne,\n * ...useServerSorting({ tri, sens, definirTri }),\n * })\n * ```\n */\nexport function useServerSorting<K extends string>({\n tri: cle,\n sens,\n definirTri,\n}: UseServerSortingOptions<K>): UseServerSortingResultat {\n const tri: SortingState = useMemo(\n () => [{ id: cle, desc: sens === \"desc\" }],\n [cle, sens]\n )\n const onTriChange: OnChangeFn<SortingState> = (miseAJour) => {\n const [premier] =\n typeof miseAJour === \"function\" ? miseAJour(tri) : miseAJour\n definirTri(\n (premier?.id as K | undefined) ?? null,\n premier?.desc ? \"desc\" : \"asc\"\n )\n }\n return { tri, onTriChange, triManuel: true }\n}\n"],"mappings":";;AAiCA,SAAgBA,EAAmC,EACjD,KAAKC,GACL,SACA,iBACuD;CACvD,IAAMC,IAAoBC,QAClB,CAAC;EAAE,IAAIF;EAAK,MAAMG,MAAS;CAAO,CAAC,GACzC,CAACH,GAAKG,CAAI,CACZ;CASA,OAAO;EAAE;EAAK,cARiC,MAAc;GAC3D,IAAM,CAACC,KACL,OAAOC,KAAc,aAAaA,EAAUJ,CAAG,IAAII;GACrD,EACGD,GAAS,MAAwB,MAClCA,GAAS,OAAO,SAAS,KAC3B;EACF;EAC2B,WAAW;CAAK;AAC7C"}
@@ -3,12 +3,30 @@ import * as React from "react";
3
3
  declare function Sheet({ ...props }: SheetPrimitive.Root.Props): React.JSX.Element;
4
4
  declare function SheetTrigger({ ...props }: SheetPrimitive.Trigger.Props): React.JSX.Element;
5
5
  declare function SheetClose({ ...props }: SheetPrimitive.Close.Props): React.JSX.Element;
6
- declare function SheetContent({ className, children, side, showCloseButton, ...props }: SheetPrimitive.Popup.Props & {
6
+ declare const TAILLES_SHEET: {
7
+ readonly sm: "data-[side=left]:w-full data-[side=right]:w-full data-[side=left]:sm:max-w-sm data-[side=right]:sm:max-w-sm";
8
+ readonly md: "data-[side=left]:w-full data-[side=right]:w-full data-[side=left]:sm:max-w-md data-[side=right]:sm:max-w-md";
9
+ readonly lg: "data-[side=left]:w-full data-[side=right]:w-full data-[side=left]:sm:max-w-lg data-[side=right]:sm:max-w-lg";
10
+ readonly xl: "data-[side=left]:w-full data-[side=right]:w-full data-[side=left]:sm:max-w-xl data-[side=right]:sm:max-w-xl";
11
+ };
12
+ type SheetTaille = keyof typeof TAILLES_SHEET;
13
+ declare function SheetContent({ className, children, side, showCloseButton, taille, ...props }: SheetPrimitive.Popup.Props & {
7
14
  side?: "top" | "right" | "bottom" | "left";
8
15
  showCloseButton?: boolean;
16
+ /** ETIC : largeur d'un tiroir à gauche ou à droite au-delà de 640 px
17
+ * (`sm` 384 px, `md` 448, `lg` 512, `xl` 576) ; en dessous, tout l'écran.
18
+ * Sans elle, les trois quarts de l'écran puis 384 px, comme shadcn. */
19
+ taille?: SheetTaille;
9
20
  }): React.JSX.Element;
10
21
  declare function SheetHeader({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
22
+ /**
23
+ * ETIC : le corps d'un tiroir, entre son en-tête et son pied, qui défile
24
+ * seul : titre, croix et pied restent visibles (comme `DialogBody`). Sans
25
+ * lui, tout le contenu déborde du tiroir. Blocs espacés de 24 px
26
+ * (`className="gap-4"` pour les resserrer).
27
+ */
28
+ declare function SheetBody({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
11
29
  declare function SheetFooter({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
12
30
  declare function SheetTitle({ className, ...props }: SheetPrimitive.Title.Props): React.JSX.Element;
13
31
  declare function SheetDescription({ className, ...props }: SheetPrimitive.Description.Props): React.JSX.Element;
14
- export { Sheet, SheetTrigger, SheetClose, SheetContent, SheetHeader, SheetFooter, SheetTitle, SheetDescription, };
32
+ export { Sheet, SheetTrigger, SheetClose, SheetContent, SheetHeader, SheetBody, SheetFooter, SheetTitle, SheetDescription, type SheetTaille, };