@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
@@ -38,12 +38,18 @@ function f({ className: e, ...n }) {
38
38
  ...n
39
39
  });
40
40
  }
41
- function p({ className: n, children: s, side: c = "right", showCloseButton: l = !0, ...p }) {
41
+ var p = {
42
+ 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",
43
+ 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",
44
+ 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",
45
+ 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"
46
+ };
47
+ function m({ className: n, children: s, side: c = "right", showCloseButton: l = !0, taille: m, ...h }) {
42
48
  return /* @__PURE__ */ i(d, { children: [/* @__PURE__ */ r(f, {}), /* @__PURE__ */ i(o.Popup, {
43
49
  "data-slot": "sheet-content",
44
50
  "data-side": c,
45
- className: t("fixed z-50 flex flex-col gap-4 bg-popover bg-clip-padding text-sm text-popover-foreground shadow-lg transition duration-200 ease-in-out data-ending-style:opacity-0 data-starting-style:opacity-0 data-[side=bottom]:inset-x-0 data-[side=bottom]:bottom-0 data-[side=bottom]:h-auto data-[side=bottom]:border-t data-[side=bottom]:data-ending-style:translate-y-[2.5rem] data-[side=bottom]:data-starting-style:translate-y-[2.5rem] data-[side=left]:inset-y-0 data-[side=left]:left-0 data-[side=left]:h-full data-[side=left]:w-3/4 data-[side=left]:border-r data-[side=left]:data-ending-style:translate-x-[-2.5rem] data-[side=left]:data-starting-style:translate-x-[-2.5rem] data-[side=right]:inset-y-0 data-[side=right]:right-0 data-[side=right]:h-full data-[side=right]:w-3/4 data-[side=right]:border-l data-[side=right]:data-ending-style:translate-x-[2.5rem] data-[side=right]:data-starting-style:translate-x-[2.5rem] data-[side=top]:inset-x-0 data-[side=top]:top-0 data-[side=top]:h-auto data-[side=top]:border-b data-[side=top]:data-ending-style:translate-y-[-2.5rem] data-[side=top]:data-starting-style:translate-y-[-2.5rem] data-[side=left]:sm:max-w-sm data-[side=right]:sm:max-w-sm", n),
46
- ...p,
51
+ className: t("fixed z-50 flex flex-col gap-4 bg-popover bg-clip-padding text-sm text-popover-foreground shadow-lg transition duration-200 ease-in-out data-ending-style:opacity-0 data-starting-style:opacity-0 data-[side=bottom]:inset-x-0 data-[side=bottom]:bottom-0 data-[side=bottom]:h-auto data-[side=bottom]:border-t data-[side=bottom]:data-ending-style:translate-y-[2.5rem] data-[side=bottom]:data-starting-style:translate-y-[2.5rem] data-[side=left]:inset-y-0 data-[side=left]:left-0 data-[side=left]:h-full data-[side=left]:w-3/4 data-[side=left]:border-r data-[side=left]:data-ending-style:translate-x-[-2.5rem] data-[side=left]:data-starting-style:translate-x-[-2.5rem] data-[side=right]:inset-y-0 data-[side=right]:right-0 data-[side=right]:h-full data-[side=right]:w-3/4 data-[side=right]:border-l data-[side=right]:data-ending-style:translate-x-[2.5rem] data-[side=right]:data-starting-style:translate-x-[2.5rem] data-[side=top]:inset-x-0 data-[side=top]:top-0 data-[side=top]:h-auto data-[side=top]:border-b data-[side=top]:data-ending-style:translate-y-[-2.5rem] data-[side=top]:data-starting-style:translate-y-[-2.5rem] data-[side=left]:sm:max-w-sm data-[side=right]:sm:max-w-sm", m && p[m], n),
52
+ ...h,
47
53
  children: [/* @__PURE__ */ r(u.Provider, {
48
54
  value: l,
49
55
  children: s
@@ -61,7 +67,7 @@ function p({ className: n, children: s, side: c = "right", showCloseButton: l =
61
67
  })]
62
68
  })] });
63
69
  }
64
- function m({ className: e, ...i }) {
70
+ function h({ className: e, ...i }) {
65
71
  let a = n.useContext(u);
66
72
  return /* @__PURE__ */ r("div", {
67
73
  "data-slot": "sheet-header",
@@ -69,27 +75,34 @@ function m({ className: e, ...i }) {
69
75
  ...i
70
76
  });
71
77
  }
72
- function h({ className: e, ...n }) {
78
+ function g({ className: e, ...n }) {
79
+ return /* @__PURE__ */ r("div", {
80
+ "data-slot": "sheet-body",
81
+ className: t("-mt-1 flex min-h-0 flex-1 flex-col gap-6 overflow-x-hidden overflow-y-auto px-4 pt-1 pb-6", e),
82
+ ...n
83
+ });
84
+ }
85
+ function _({ className: e, ...n }) {
73
86
  return /* @__PURE__ */ r("div", {
74
87
  "data-slot": "sheet-footer",
75
88
  className: t("mt-auto flex flex-col gap-2 p-4", e),
76
89
  ...n
77
90
  });
78
91
  }
79
- function g({ className: e, ...n }) {
92
+ function v({ className: e, ...n }) {
80
93
  return /* @__PURE__ */ r(o.Title, {
81
94
  "data-slot": "sheet-title",
82
95
  className: t("font-heading text-base font-medium text-foreground", e),
83
96
  ...n
84
97
  });
85
98
  }
86
- function _({ className: e, ...n }) {
99
+ function y({ className: e, ...n }) {
87
100
  return /* @__PURE__ */ r(o.Description, {
88
101
  "data-slot": "sheet-description",
89
102
  className: t("text-sm text-muted-foreground", e),
90
103
  ...n
91
104
  });
92
105
  }
93
- export { s as Sheet, l as SheetClose, p as SheetContent, _ as SheetDescription, h as SheetFooter, m as SheetHeader, g as SheetTitle, c as SheetTrigger };
106
+ export { s as Sheet, g as SheetBody, l as SheetClose, m as SheetContent, y as SheetDescription, _ as SheetFooter, h as SheetHeader, v as SheetTitle, c as SheetTrigger };
94
107
 
95
108
  //# sourceMappingURL=sheet.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"sheet.js","names":["SheetPrimitive","React","Sheet","props","Dialog","SheetTrigger","SheetClose","ContexteCroixSheet","SheetPortal","SheetOverlay","cn","className","SheetContent","side","showCloseButton","Button","XIcon","SheetHeader","croix","SheetFooter","SheetTitle","SheetDescription"],"sources":["../../../src/components/ui/sheet.tsx"],"sourcesContent":["\"use client\"\n\nimport * as React from \"react\"\nimport { Dialog as SheetPrimitive } from \"@base-ui/react/dialog\"\nimport { cn } from \"cn\"\n\nimport { Button } from \"@etic-ui/components/ui/button\"\nimport { XIcon } from \"lucide-react\"\n\nfunction Sheet({ ...props }: SheetPrimitive.Root.Props) {\n return <SheetPrimitive.Root data-slot=\"sheet\" {...props} />\n}\n\nfunction SheetTrigger({ ...props }: SheetPrimitive.Trigger.Props) {\n return <SheetPrimitive.Trigger data-slot=\"sheet-trigger\" {...props} />\n}\n\nfunction SheetClose({ ...props }: SheetPrimitive.Close.Props) {\n return <SheetPrimitive.Close data-slot=\"sheet-close\" {...props} />\n}\n\n// ETIC : le tiroir dit à son en-tête s'il porte la croix, pour que le titre\n// ne passe pas dessous (voir le README, écarts).\nconst ContexteCroixSheet = React.createContext(false)\n\nfunction SheetPortal({ ...props }: SheetPrimitive.Portal.Props) {\n return <SheetPrimitive.Portal data-slot=\"sheet-portal\" {...props} />\n}\n\nfunction SheetOverlay({ className, ...props }: SheetPrimitive.Backdrop.Props) {\n return (\n <SheetPrimitive.Backdrop\n data-slot=\"sheet-overlay\"\n className={cn(\n \"fixed inset-0 z-50 bg-black/10 transition-opacity duration-150 data-ending-style:opacity-0 data-starting-style:opacity-0 supports-backdrop-filter:backdrop-blur-xs\",\n className\n )}\n {...props}\n />\n )\n}\n\nfunction SheetContent({\n className,\n children,\n side = \"right\",\n showCloseButton = true,\n ...props\n}: SheetPrimitive.Popup.Props & {\n side?: \"top\" | \"right\" | \"bottom\" | \"left\"\n showCloseButton?: boolean\n}) {\n return (\n <SheetPortal>\n <SheetOverlay />\n <SheetPrimitive.Popup\n data-slot=\"sheet-content\"\n data-side={side}\n className={cn(\n \"fixed z-50 flex flex-col gap-4 bg-popover bg-clip-padding text-sm text-popover-foreground shadow-lg transition duration-200 ease-in-out data-ending-style:opacity-0 data-starting-style:opacity-0 data-[side=bottom]:inset-x-0 data-[side=bottom]:bottom-0 data-[side=bottom]:h-auto data-[side=bottom]:border-t data-[side=bottom]:data-ending-style:translate-y-[2.5rem] data-[side=bottom]:data-starting-style:translate-y-[2.5rem] data-[side=left]:inset-y-0 data-[side=left]:left-0 data-[side=left]:h-full data-[side=left]:w-3/4 data-[side=left]:border-r data-[side=left]:data-ending-style:translate-x-[-2.5rem] data-[side=left]:data-starting-style:translate-x-[-2.5rem] data-[side=right]:inset-y-0 data-[side=right]:right-0 data-[side=right]:h-full data-[side=right]:w-3/4 data-[side=right]:border-l data-[side=right]:data-ending-style:translate-x-[2.5rem] data-[side=right]:data-starting-style:translate-x-[2.5rem] data-[side=top]:inset-x-0 data-[side=top]:top-0 data-[side=top]:h-auto data-[side=top]:border-b data-[side=top]:data-ending-style:translate-y-[-2.5rem] data-[side=top]:data-starting-style:translate-y-[-2.5rem] data-[side=left]:sm:max-w-sm data-[side=right]:sm:max-w-sm\",\n className\n )}\n {...props}\n >\n <ContexteCroixSheet.Provider value={showCloseButton}>\n {children}\n </ContexteCroixSheet.Provider>\n {showCloseButton && (\n <SheetPrimitive.Close\n data-slot=\"sheet-close\"\n render={\n <Button\n variant=\"ghost\"\n className=\"absolute top-3 right-3\"\n size=\"icon-sm\"\n />\n }\n >\n <XIcon />\n <span className=\"sr-only\">Fermer</span>\n </SheetPrimitive.Close>\n )}\n </SheetPrimitive.Popup>\n </SheetPortal>\n )\n}\n\nfunction SheetHeader({ className, ...props }: React.ComponentProps<\"div\">) {\n const croix = React.useContext(ContexteCroixSheet)\n return (\n <div\n data-slot=\"sheet-header\"\n // ETIC : place de la croix réservée (28 px à 12 px du bord).\n className={cn(\"flex flex-col gap-0.5 p-4\", croix && \"pr-12\", className)}\n {...props}\n />\n )\n}\n\nfunction SheetFooter({ className, ...props }: React.ComponentProps<\"div\">) {\n return (\n <div\n data-slot=\"sheet-footer\"\n className={cn(\"mt-auto flex flex-col gap-2 p-4\", className)}\n {...props}\n />\n )\n}\n\nfunction SheetTitle({ className, ...props }: SheetPrimitive.Title.Props) {\n return (\n <SheetPrimitive.Title\n data-slot=\"sheet-title\"\n className={cn(\n \"font-heading text-base font-medium text-foreground\",\n className\n )}\n {...props}\n />\n )\n}\n\nfunction SheetDescription({\n className,\n ...props\n}: SheetPrimitive.Description.Props) {\n return (\n <SheetPrimitive.Description\n data-slot=\"sheet-description\"\n className={cn(\"text-sm text-muted-foreground\", className)}\n {...props}\n />\n )\n}\n\nexport {\n Sheet,\n SheetTrigger,\n SheetClose,\n SheetContent,\n SheetHeader,\n SheetFooter,\n SheetTitle,\n SheetDescription,\n}\n"],"mappings":";;;;;;;;AASA,SAASE,EAAM,EAAE,GAAGC,KAAoC;CACtD,OAAO,kBAACH,EAAe,MAAhB;EAAqB,aAAU;EAAQ,GAAIG;CAAQ,CAAA;AAC5D;AAEA,SAASE,EAAa,EAAE,GAAGF,KAAuC;CAChE,OAAO,kBAACH,EAAe,SAAhB;EAAwB,aAAU;EAAgB,GAAIG;CAAQ,CAAA;AACvE;AAEA,SAASG,EAAW,EAAE,GAAGH,KAAqC;CAC5D,OAAO,kBAACH,EAAe,OAAhB;EAAsB,aAAU;EAAc,GAAIG;CAAQ,CAAA;AACnE;AAIA,IAAMI,IAAqBN,EAAM,cAAc,EAAK;AAEpD,SAASO,EAAY,EAAE,GAAGL,KAAsC;CAC9D,OAAO,kBAACH,EAAe,QAAhB;EAAuB,aAAU;EAAe,GAAIG;CAAQ,CAAA;AACrE;AAEA,SAASM,EAAa,EAAE,cAAW,GAAGN,KAAwC;CAC5E,OACE,kBAACH,EAAe,UAAhB;EACE,aAAU;EACV,WAAWU,EACT,sKACAC,CACF;EACA,GAAIR;CACL,CAAA;AAEL;AAEA,SAASS,EAAa,EACpB,cACA,aACA,UAAO,SACP,qBAAkB,IAClB,GAAGT,KAIF;CACD,OACE,kBAACK,GAAD,EAAA,UAAA,CACE,kBAACC,GAAD,CAAe,CAAA,GACf,kBAACT,EAAe,OAAhB;EACE,aAAU;EACV,aAAWa;EACX,WAAWH,EACT,6pCACAC,CACF;EACA,GAAIR;EAPN,UAAA,CASE,kBAACI,EAAmB,UAApB;GAA6B,OAAOO;GACjC;EAC0B,CAAA,GAC5BA,KACC,kBAACd,EAAe,OAAhB;GACE,aAAU;GACV,QACE,kBAACe,GAAD;IACE,SAAQ;IACR,WAAU;IACV,MAAK;GACN,CAAA;GAPL,UAAA,CAUE,kBAACC,GAAD,CAAQ,CAAA,GACR,kBAAC,QAAD;IAAM,WAAU;IAAU,UAAA;GAAY,CAAA,CAClB;EAEJ,CAAA,CAAA;CACX,CAAA,CAAA,EAAA,CAAA;AAEjB;AAEA,SAASC,EAAY,EAAE,cAAW,GAAGd,KAAsC;CACzE,IAAMe,IAAQjB,EAAM,WAAWM,CAAkB;CACjD,OACE,kBAAC,OAAD;EACE,aAAU;EAEV,WAAWG,EAAG,6BAA6BQ,KAAS,SAASP,CAAS;EACtE,GAAIR;CACL,CAAA;AAEL;AAEA,SAASgB,EAAY,EAAE,cAAW,GAAGhB,KAAsC;CACzE,OACE,kBAAC,OAAD;EACE,aAAU;EACV,WAAWO,EAAG,mCAAmCC,CAAS;EAC1D,GAAIR;CACL,CAAA;AAEL;AAEA,SAASiB,EAAW,EAAE,cAAW,GAAGjB,KAAqC;CACvE,OACE,kBAACH,EAAe,OAAhB;EACE,aAAU;EACV,WAAWU,EACT,sDACAC,CACF;EACA,GAAIR;CACL,CAAA;AAEL;AAEA,SAASkB,EAAiB,EACxB,cACA,GAAGlB,KACgC;CACnC,OACE,kBAACH,EAAe,aAAhB;EACE,aAAU;EACV,WAAWU,EAAG,iCAAiCC,CAAS;EACxD,GAAIR;CACL,CAAA;AAEL"}
1
+ {"version":3,"file":"sheet.js","names":["SheetPrimitive","React","Sheet","props","Dialog","SheetTrigger","SheetClose","ContexteCroixSheet","SheetPortal","SheetOverlay","cn","className","TAILLES_SHEET","SheetContent","side","taille","showCloseButton","Button","XIcon","SheetHeader","croix","SheetBody","SheetFooter","SheetTitle","SheetDescription"],"sources":["../../../src/components/ui/sheet.tsx"],"sourcesContent":["\"use client\"\n\nimport * as React from \"react\"\nimport { Dialog as SheetPrimitive } from \"@base-ui/react/dialog\"\nimport { cn } from \"cn\"\n\nimport { Button } from \"@etic-ui/components/ui/button\"\nimport { XIcon } from \"lucide-react\"\n\nfunction Sheet({ ...props }: SheetPrimitive.Root.Props) {\n return <SheetPrimitive.Root data-slot=\"sheet\" {...props} />\n}\n\nfunction SheetTrigger({ ...props }: SheetPrimitive.Trigger.Props) {\n return <SheetPrimitive.Trigger data-slot=\"sheet-trigger\" {...props} />\n}\n\nfunction SheetClose({ ...props }: SheetPrimitive.Close.Props) {\n return <SheetPrimitive.Close data-slot=\"sheet-close\" {...props} />\n}\n\n// ETIC : le tiroir dit à son en-tête s'il porte la croix, pour que le titre\n// ne passe pas dessous (voir le README, écarts).\nconst ContexteCroixSheet = React.createContext(false)\n\nfunction SheetPortal({ ...props }: SheetPrimitive.Portal.Props) {\n return <SheetPrimitive.Portal data-slot=\"sheet-portal\" {...props} />\n}\n\nfunction SheetOverlay({ className, ...props }: SheetPrimitive.Backdrop.Props) {\n return (\n <SheetPrimitive.Backdrop\n data-slot=\"sheet-overlay\"\n className={cn(\n \"fixed inset-0 z-50 bg-black/10 transition-opacity duration-150 data-ending-style:opacity-0 data-starting-style:opacity-0 supports-backdrop-filter:backdrop-blur-xs\",\n className\n )}\n {...props}\n />\n )\n}\n\n// ETIC : largeurs d'un tiroir latéral au-delà de 640 px ; en dessous, il\n// prend tout l'écran (voir le README, écarts).\nconst TAILLES_SHEET = {\n 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\",\n 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\",\n 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\",\n 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\",\n} as const\n\ntype SheetTaille = keyof typeof TAILLES_SHEET\n\nfunction SheetContent({\n className,\n children,\n side = \"right\",\n showCloseButton = true,\n taille,\n ...props\n}: SheetPrimitive.Popup.Props & {\n side?: \"top\" | \"right\" | \"bottom\" | \"left\"\n showCloseButton?: boolean\n /** ETIC : largeur d'un tiroir à gauche ou à droite au-delà de 640 px\n * (`sm` 384 px, `md` 448, `lg` 512, `xl` 576) ; en dessous, tout l'écran.\n * Sans elle, les trois quarts de l'écran puis 384 px, comme shadcn. */\n taille?: SheetTaille\n}) {\n return (\n <SheetPortal>\n <SheetOverlay />\n <SheetPrimitive.Popup\n data-slot=\"sheet-content\"\n data-side={side}\n className={cn(\n \"fixed z-50 flex flex-col gap-4 bg-popover bg-clip-padding text-sm text-popover-foreground shadow-lg transition duration-200 ease-in-out data-ending-style:opacity-0 data-starting-style:opacity-0 data-[side=bottom]:inset-x-0 data-[side=bottom]:bottom-0 data-[side=bottom]:h-auto data-[side=bottom]:border-t data-[side=bottom]:data-ending-style:translate-y-[2.5rem] data-[side=bottom]:data-starting-style:translate-y-[2.5rem] data-[side=left]:inset-y-0 data-[side=left]:left-0 data-[side=left]:h-full data-[side=left]:w-3/4 data-[side=left]:border-r data-[side=left]:data-ending-style:translate-x-[-2.5rem] data-[side=left]:data-starting-style:translate-x-[-2.5rem] data-[side=right]:inset-y-0 data-[side=right]:right-0 data-[side=right]:h-full data-[side=right]:w-3/4 data-[side=right]:border-l data-[side=right]:data-ending-style:translate-x-[2.5rem] data-[side=right]:data-starting-style:translate-x-[2.5rem] data-[side=top]:inset-x-0 data-[side=top]:top-0 data-[side=top]:h-auto data-[side=top]:border-b data-[side=top]:data-ending-style:translate-y-[-2.5rem] data-[side=top]:data-starting-style:translate-y-[-2.5rem] data-[side=left]:sm:max-w-sm data-[side=right]:sm:max-w-sm\",\n taille && TAILLES_SHEET[taille],\n className\n )}\n {...props}\n >\n <ContexteCroixSheet.Provider value={showCloseButton}>\n {children}\n </ContexteCroixSheet.Provider>\n {showCloseButton && (\n <SheetPrimitive.Close\n data-slot=\"sheet-close\"\n render={\n <Button\n variant=\"ghost\"\n className=\"absolute top-3 right-3\"\n size=\"icon-sm\"\n />\n }\n >\n <XIcon />\n <span className=\"sr-only\">Fermer</span>\n </SheetPrimitive.Close>\n )}\n </SheetPrimitive.Popup>\n </SheetPortal>\n )\n}\n\nfunction SheetHeader({ className, ...props }: React.ComponentProps<\"div\">) {\n const croix = React.useContext(ContexteCroixSheet)\n return (\n <div\n data-slot=\"sheet-header\"\n // ETIC : place de la croix réservée (28 px à 12 px du bord).\n className={cn(\"flex flex-col gap-0.5 p-4\", croix && \"pr-12\", className)}\n {...props}\n />\n )\n}\n\n/**\n * ETIC : le corps d'un tiroir, entre son en-tête et son pied, qui défile\n * seul : titre, croix et pied restent visibles (comme `DialogBody`). Sans\n * lui, tout le contenu déborde du tiroir. Blocs espacés de 24 px\n * (`className=\"gap-4\"` pour les resserrer).\n */\nfunction SheetBody({ className, ...props }: React.ComponentProps<\"div\">) {\n return (\n <div\n data-slot=\"sheet-body\"\n className={cn(\n // `-mt-1 pt-1` : l'anneau de focus du premier bloc n'est pas coupé\n // par le bord du défilement.\n \"-mt-1 flex min-h-0 flex-1 flex-col gap-6 overflow-x-hidden overflow-y-auto px-4 pt-1 pb-6\",\n className\n )}\n {...props}\n />\n )\n}\n\nfunction SheetFooter({ className, ...props }: React.ComponentProps<\"div\">) {\n return (\n <div\n data-slot=\"sheet-footer\"\n className={cn(\"mt-auto flex flex-col gap-2 p-4\", className)}\n {...props}\n />\n )\n}\n\nfunction SheetTitle({ className, ...props }: SheetPrimitive.Title.Props) {\n return (\n <SheetPrimitive.Title\n data-slot=\"sheet-title\"\n className={cn(\n \"font-heading text-base font-medium text-foreground\",\n className\n )}\n {...props}\n />\n )\n}\n\nfunction SheetDescription({\n className,\n ...props\n}: SheetPrimitive.Description.Props) {\n return (\n <SheetPrimitive.Description\n data-slot=\"sheet-description\"\n className={cn(\"text-sm text-muted-foreground\", className)}\n {...props}\n />\n )\n}\n\nexport {\n Sheet,\n SheetTrigger,\n SheetClose,\n SheetContent,\n SheetHeader,\n SheetBody,\n SheetFooter,\n SheetTitle,\n SheetDescription,\n type SheetTaille,\n}\n"],"mappings":";;;;;;;;AASA,SAASE,EAAM,EAAE,GAAGC,KAAoC;CACtD,OAAO,kBAACH,EAAe,MAAhB;EAAqB,aAAU;EAAQ,GAAIG;CAAQ,CAAA;AAC5D;AAEA,SAASE,EAAa,EAAE,GAAGF,KAAuC;CAChE,OAAO,kBAACH,EAAe,SAAhB;EAAwB,aAAU;EAAgB,GAAIG;CAAQ,CAAA;AACvE;AAEA,SAASG,EAAW,EAAE,GAAGH,KAAqC;CAC5D,OAAO,kBAACH,EAAe,OAAhB;EAAsB,aAAU;EAAc,GAAIG;CAAQ,CAAA;AACnE;AAIA,IAAMI,IAAqBN,EAAM,cAAc,EAAK;AAEpD,SAASO,EAAY,EAAE,GAAGL,KAAsC;CAC9D,OAAO,kBAACH,EAAe,QAAhB;EAAuB,aAAU;EAAe,GAAIG;CAAQ,CAAA;AACrE;AAEA,SAASM,EAAa,EAAE,cAAW,GAAGN,KAAwC;CAC5E,OACE,kBAACH,EAAe,UAAhB;EACE,aAAU;EACV,WAAWU,EACT,sKACAC,CACF;EACA,GAAIR;CACL,CAAA;AAEL;AAIA,IAAMS,IAAgB;CACpB,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;AACN;AAIA,SAASC,EAAa,EACpB,cACA,aACA,UAAO,SACP,qBAAkB,IAClB,WACA,GAAGV,KAQF;CACD,OACE,kBAACK,GAAD,EAAA,UAAA,CACE,kBAACC,GAAD,CAAe,CAAA,GACf,kBAACT,EAAe,OAAhB;EACE,aAAU;EACV,aAAWc;EACX,WAAWJ,EACT,6pCACAK,KAAUH,EAAcG,IACxBJ,CACF;EACA,GAAIR;EARN,UAAA,CAUE,kBAACI,EAAmB,UAApB;GAA6B,OAAOS;GACjC;EAC0B,CAAA,GAC5BA,KACC,kBAAChB,EAAe,OAAhB;GACE,aAAU;GACV,QACE,kBAACiB,GAAD;IACE,SAAQ;IACR,WAAU;IACV,MAAK;GACN,CAAA;GAPL,UAAA,CAUE,kBAACC,GAAD,CAAQ,CAAA,GACR,kBAAC,QAAD;IAAM,WAAU;IAAU,UAAA;GAAY,CAAA,CAClB;EAEJ,CAAA,CAAA;CACX,CAAA,CAAA,EAAA,CAAA;AAEjB;AAEA,SAASC,EAAY,EAAE,cAAW,GAAGhB,KAAsC;CACzE,IAAMiB,IAAQnB,EAAM,WAAWM,CAAkB;CACjD,OACE,kBAAC,OAAD;EACE,aAAU;EAEV,WAAWG,EAAG,6BAA6BU,KAAS,SAAST,CAAS;EACtE,GAAIR;CACL,CAAA;AAEL;AAQA,SAASkB,EAAU,EAAE,cAAW,GAAGlB,KAAsC;CACvE,OACE,kBAAC,OAAD;EACE,aAAU;EACV,WAAWO,EAGT,6FACAC,CACF;EACA,GAAIR;CACL,CAAA;AAEL;AAEA,SAASmB,EAAY,EAAE,cAAW,GAAGnB,KAAsC;CACzE,OACE,kBAAC,OAAD;EACE,aAAU;EACV,WAAWO,EAAG,mCAAmCC,CAAS;EAC1D,GAAIR;CACL,CAAA;AAEL;AAEA,SAASoB,EAAW,EAAE,cAAW,GAAGpB,KAAqC;CACvE,OACE,kBAACH,EAAe,OAAhB;EACE,aAAU;EACV,WAAWU,EACT,sDACAC,CACF;EACA,GAAIR;CACL,CAAA;AAEL;AAEA,SAASqB,EAAiB,EACxB,cACA,GAAGrB,KACgC;CACnC,OACE,kBAACH,EAAe,aAAhB;EACE,aAAU;EACV,WAAWU,EAAG,iCAAiCC,CAAS;EACxD,GAAIR;CACL,CAAA;AAEL"}
@@ -17,12 +17,28 @@ export interface UseColumnPrefsOptions {
17
17
  /** Colonnes affichées tant que la personne n'a rien choisi. */
18
18
  visiblesParDefaut: readonly string[];
19
19
  /**
20
- * Colonnes offertes ici, parmi `colonnes` (droit manquant, type de
21
- * compte…) ; toutes par défaut. Les autres gardent leur état et leur place
22
- * dans les préférences, et réapparaissent telles quelles quand elles
23
- * redeviennent disponibles.
20
+ * Colonnes offertes ici, parmi `colonnes` (droit manquant, donnée non
21
+ * servie, colonne qui ne dirait rien dans cette vue) ; toutes par défaut.
22
+ * Les autres sont masquées, hors du panneau « Colonnes », et gardent leur
23
+ * état et leur place dans les préférences : elles réapparaissent telles
24
+ * quelles quand elles redeviennent disponibles.
24
25
  */
25
26
  disponibles?: readonly string[];
27
+ /**
28
+ * Colonnes que la vue impose à l'écran, quelles que soient les
29
+ * préférences (un filtre posé sur leur donnée montre sa colonne). Elles
30
+ * sortent du panneau « Colonnes » le temps de l'imposition, et leur
31
+ * préférence reste intacte.
32
+ */
33
+ affichees?: readonly string[];
34
+ /**
35
+ * Sur téléphone (`useIsMobile`), les seules colonnes réglables affichées :
36
+ * un tableau qui défile de côté couperait sans le dire la colonne utile.
37
+ * Les préférences restent intactes, et le panneau « Colonnes », sans objet,
38
+ * disparaît (`colonnesReglables` vide). Sans elle, rien ne change sur
39
+ * téléphone.
40
+ */
41
+ mobile?: readonly string[];
26
42
  /** Colonnes toujours en tête du tableau, hors préférences (sélection,
27
43
  * nom…). */
28
44
  fixesEnTete?: readonly string[];
@@ -37,13 +53,15 @@ export interface ColumnPrefsOptionsTableau {
37
53
  ordreColonnes: ColumnOrderState;
38
54
  onOrdreColonnesChange: OnChangeFn<ColumnOrderState>;
39
55
  /** Les seules colonnes que « Colonnes » peut masquer et déplacer : les
40
- * disponibles, ni fixes en tête ni absentes de `colonnes`. */
56
+ * disponibles, ni fixes en tête, ni imposées (`affichees`), ni absentes
57
+ * de `colonnes` ; aucune sur téléphone avec `mobile`. */
41
58
  colonnesReglables: readonly string[];
42
59
  }
43
60
  export interface ColumnPrefsResultat {
44
61
  /** Ordre de toutes les colonnes réglables. */
45
62
  ordre: string[];
46
- /** Colonnes affichées. */
63
+ /** Colonnes affichées selon les préférences (disponibles ou non) ; ce qui
64
+ * est à l'écran : `optionsTableau.visibiliteColonnes`. */
47
65
  visibles: string[];
48
66
  /** Affiche une colonne masquée, ou l'inverse. */
49
67
  basculer: (id: string) => void;
@@ -81,4 +99,4 @@ export declare function lirePreferencesColonnes(brute: unknown, colonnes: readon
81
99
  * Pour un tableau rendu à la main : `ordre`, `visibles` et `basculer`, et
82
100
  * `<DataTableViewOptions colonnes={…} {...prefs.optionsTableau} />`.
83
101
  */
84
- export declare function useColumnPrefs({ cle, colonnes: colonnesDonnees, visiblesParDefaut: visiblesDonnees, disponibles: disponiblesDonnees, fixesEnTete: fixesDonnees, portee, }: UseColumnPrefsOptions): ColumnPrefsResultat;
102
+ export declare function useColumnPrefs({ cle, colonnes: colonnesDonnees, visiblesParDefaut: visiblesDonnees, disponibles: disponiblesDonnees, affichees: afficheesDonnees, mobile: mobileDonnees, fixesEnTete: fixesDonnees, portee, }: UseColumnPrefsOptions): ColumnPrefsResultat;
@@ -1,71 +1,80 @@
1
- import { usePersistedState as e } from "./use-persisted-state.js";
2
- import { ordonner as t, replacer as n } from "../lib/ordre-colonnes.js";
3
- import { useMemo as r } from "react";
4
- import { functionalUpdate as i } from "@tanstack/react-table";
1
+ import { useIsMobile as e } from "./use-mobile.js";
2
+ import { usePersistedState as t } from "./use-persisted-state.js";
3
+ import { ordonner as n, replacer as r } from "../lib/ordre-colonnes.js";
4
+ import { useMemo as i } from "react";
5
+ import { functionalUpdate as a } from "@tanstack/react-table";
5
6
  // src/hooks/use-column-prefs.ts
6
- function a(e, n, r) {
7
- let i = o(r, n);
7
+ function o(e, t, r) {
8
+ let i = s(r, t);
8
9
  if (Array.isArray(e)) return {
9
- order: [...n],
10
- visible: o(e, n)
10
+ order: [...t],
11
+ visible: s(e, t)
11
12
  };
12
13
  if (!e || typeof e != "object") return {
13
- order: [...n],
14
+ order: [...t],
14
15
  visible: i
15
16
  };
16
- let { order: a, visible: s } = e, c = t(Array.isArray(a) ? a : [], n), l = c.slice(o(a, n).length);
17
+ let { order: a, visible: o } = e, c = n(Array.isArray(a) ? a : [], t), l = c.slice(s(a, t).length);
17
18
  return {
18
19
  order: c,
19
- visible: s === void 0 ? i : o([...Array.isArray(s) ? s : [], ...l.filter((e) => r.includes(e))], n)
20
+ visible: o === void 0 ? i : s([...Array.isArray(o) ? o : [], ...l.filter((e) => r.includes(e))], t)
20
21
  };
21
22
  }
22
- function o(e, n) {
23
+ function s(e, t) {
23
24
  if (!Array.isArray(e)) return [];
24
25
  let r = new Set(e);
25
- return t(e, n).filter((e) => r.has(e));
26
+ return n(e, t).filter((e) => r.has(e));
26
27
  }
27
- function s(e) {
28
+ function c(e) {
28
29
  let t = e.join("\0");
29
- return r(() => e, [t]);
30
+ return i(() => e, [t]);
30
31
  }
31
- function c({ cle: t, colonnes: o, visiblesParDefaut: c, disponibles: l, fixesEnTete: u = [], portee: d }) {
32
- let f = s(o), p = s(c), m = s(l ?? o), h = s(u), [g, _] = e(t, null, { portee: d });
33
- return r(() => {
34
- let e = a(g, f, p), t = m.filter((e) => f.includes(e) && !h.includes(e)), r = (e) => t.includes(e), o = (e) => _((t) => e(a(t, f, p))), s = (e) => Object.fromEntries(t.map((t) => [t, e.visible.includes(t)])), c = (e) => [...h, ...e.order.filter(r)];
32
+ function l({ cle: n, colonnes: s, visiblesParDefaut: l, disponibles: u, affichees: d = [], mobile: f, fixesEnTete: p = [], portee: m }) {
33
+ let h = c(s), g = c(l), _ = c(u ?? s), v = c(d), y = c(f ?? []), b = c(p), x = e() && f !== void 0, [S, C] = t(n, null, { portee: m });
34
+ return i(() => {
35
+ let e = o(S, h, g), t = _.filter((e) => h.includes(e) && !b.includes(e)), n = (e) => t.includes(e), i = h.filter((e) => !n(e) && !b.includes(e)), s = v.filter(n), c = x ? t.filter((e) => !y.includes(e) && !v.includes(e)) : [], l = /* @__PURE__ */ new Set([...s, ...c]), u = (e) => C((t) => e(o(t, h, g))), d = (e) => Object.fromEntries(t.map((t) => [t, e.visible.includes(t)])), f = {
36
+ ...Object.fromEntries(i.map((e) => [e, !1])),
37
+ ...d(e),
38
+ ...Object.fromEntries(c.map((e) => [e, !1])),
39
+ ...Object.fromEntries(s.map((e) => [e, !0]))
40
+ }, p = (e) => [...b, ...e.order.filter(n)];
35
41
  return {
36
42
  ordre: e.order,
37
43
  visibles: e.visible,
38
- basculer: (e) => o((t) => ({
44
+ basculer: (e) => u((t) => ({
39
45
  ...t,
40
46
  visible: t.visible.includes(e) ? t.visible.filter((t) => t !== e) : [...t.visible, e]
41
47
  })),
42
- reinitialiser: () => _(null),
48
+ reinitialiser: () => C(null),
43
49
  optionsTableau: {
44
- visibiliteColonnes: s(e),
45
- onVisibiliteColonnesChange: (e) => o((n) => {
46
- let a = i(e, s(n));
50
+ visibiliteColonnes: f,
51
+ onVisibiliteColonnesChange: (e) => u((r) => {
52
+ let i = d(r), o = a(e, i), s = (e) => l.has(e) ? i[e] : o[e] !== !1;
47
53
  return {
48
- ...n,
49
- visible: [...n.visible.filter((e) => !r(e)), ...t.filter((e) => a[e] !== !1)]
54
+ ...r,
55
+ visible: [...r.visible.filter((e) => !n(e)), ...t.filter(s)]
50
56
  };
51
57
  }),
52
- ordreColonnes: c(e),
53
- onOrdreColonnesChange: (e) => o((t) => ({
58
+ ordreColonnes: p(e),
59
+ onOrdreColonnesChange: (e) => u((t) => ({
54
60
  ...t,
55
- order: n(t.order, r, i(e, c(t)))
61
+ order: r(t.order, n, a(e, p(t)))
56
62
  })),
57
- colonnesReglables: t
63
+ colonnesReglables: x ? [] : t.filter((e) => !l.has(e))
58
64
  }
59
65
  };
60
66
  }, [
67
+ S,
68
+ C,
69
+ h,
61
70
  g,
62
71
  _,
63
- f,
64
- p,
65
- m,
66
- h
72
+ v,
73
+ y,
74
+ x,
75
+ b
67
76
  ]);
68
77
  }
69
- export { a as lirePreferencesColonnes, c as useColumnPrefs };
78
+ export { o as lirePreferencesColonnes, l as useColumnPrefs };
70
79
 
71
80
  //# sourceMappingURL=use-column-prefs.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"use-column-prefs.js","names":["lirePreferencesColonnes","visiblesDefaut","connues","visiblesParDefaut","colonnes","brute","ordre","ordonner","order","ajoutees","visible","id","valeur","citees","useListeStable","cle","liste","useMemo","useColumnPrefs","colonnesDonnees","visiblesDonnees","disponiblesDonnees","fixesDonnees","disponibles","fixesEnTete","setBrute","usePersistedState","prefs","reglables","estDisponible","modifier","maj","avant","visibiliteDe","p","ordreDe","v","suivante","functionalUpdate","replacer"],"sources":["../../src/hooks/use-column-prefs.ts"],"sourcesContent":["import { useMemo } from \"react\"\nimport {\n functionalUpdate,\n type ColumnOrderState,\n type ColumnVisibilityState,\n type OnChangeFn,\n} from \"@tanstack/react-table\"\n\nimport { usePersistedState } from \"@etic-ui/hooks/use-persisted-state\"\nimport { ordonner, replacer } from \"@etic-ui/lib/ordre-colonnes\"\n\n/**\n * Préférences de colonnes enregistrées : l'ordre de toutes les colonnes\n * réglables et celles qui sont affichées. Noms anglais gardés : c'est le\n * format déjà écrit dans les navigateurs par ETIC Members.\n */\nexport interface ColumnPrefs {\n order: string[]\n visible: string[]\n}\n\nexport interface UseColumnPrefsOptions {\n /** Clé de la liste, préfixée par la portée (`PorteeStockageLocal`) :\n * « membres:actifs ». Une nouvelle clé repart des valeurs par défaut. */\n cle: string\n /** Toutes les colonnes réglables, dans leur ordre par défaut. */\n colonnes: readonly string[]\n /** Colonnes affichées tant que la personne n'a rien choisi. */\n visiblesParDefaut: readonly string[]\n /**\n * Colonnes offertes ici, parmi `colonnes` (droit manquant, type de\n * compte…) ; toutes par défaut. Les autres gardent leur état et leur place\n * dans les préférences, et réapparaissent telles quelles quand elles\n * redeviennent disponibles.\n */\n disponibles?: readonly string[]\n /** Colonnes toujours en tête du tableau, hors préférences (sélection,\n * nom…). */\n fixesEnTete?: readonly string[]\n /** Remplace la portée de `PorteeStockageLocal`. */\n portee?: string | null\n}\n\n/** Les options de `useDataTable` (et de `DataTableViewOptions` sans\n * `table`) qui règlent visibilité et ordre des colonnes. */\nexport interface ColumnPrefsOptionsTableau {\n visibiliteColonnes: ColumnVisibilityState\n onVisibiliteColonnesChange: OnChangeFn<ColumnVisibilityState>\n ordreColonnes: ColumnOrderState\n onOrdreColonnesChange: OnChangeFn<ColumnOrderState>\n /** Les seules colonnes que « Colonnes » peut masquer et déplacer : les\n * disponibles, ni fixes en tête ni absentes de `colonnes`. */\n colonnesReglables: readonly string[]\n}\n\nexport interface ColumnPrefsResultat {\n /** Ordre de toutes les colonnes réglables. */\n ordre: string[]\n /** Colonnes affichées. */\n visibles: string[]\n /** Affiche une colonne masquée, ou l'inverse. */\n basculer: (id: string) => void\n /** Revient aux colonnes et à l'ordre par défaut. */\n reinitialiser: () => void\n /** À étaler dans `useDataTable` (ou `DataTableViewOptions`) : visibilité\n * et ordre des colonnes disponibles, colonnes fixes en tête. Stable tant\n * que les préférences ne changent pas. */\n optionsTableau: ColumnPrefsOptionsTableau\n}\n\n/**\n * Préférences lues, remises en forme pour les colonnes d'aujourd'hui :\n * colonnes inconnues retirées ; ancien format (simple liste des colonnes\n * affichées) repris ; colonnes apparues depuis l'enregistrement ajoutées à\n * la fin, et affichées si elles le sont par défaut (l'enregistrement, plus\n * ancien qu'elles, n'a pas pu les masquer exprès).\n */\nexport function lirePreferencesColonnes(\n brute: unknown,\n colonnes: readonly string[],\n visiblesParDefaut: readonly string[]\n): ColumnPrefs {\n const visiblesDefaut = connues(visiblesParDefaut, colonnes)\n // Ancien format : la liste des colonnes affichées, sans ordre.\n if (Array.isArray(brute))\n return { order: [...colonnes], visible: connues(brute, colonnes) }\n if (!brute || typeof brute !== \"object\")\n return { order: [...colonnes], visible: visiblesDefaut }\n const { order, visible } = brute as { order?: unknown; visible?: unknown }\n const ordre = ordonner(Array.isArray(order) ? order : [], colonnes)\n // Après les colonnes citées, `ordonner` met celles que l'enregistrement\n // ne connaissait pas : les colonnes apparues depuis.\n const ajoutees = ordre.slice(connues(order, colonnes).length)\n return {\n order: ordre,\n visible:\n visible === undefined\n ? visiblesDefaut\n : connues(\n [\n ...(Array.isArray(visible) ? visible : []),\n ...ajoutees.filter((id) => visiblesParDefaut.includes(id)),\n ],\n colonnes\n ),\n }\n}\n\n/** Les identifiants connus d'une liste lue (stockage), sans doublon, dans\n * son ordre : la partie citée d'`ordonner`, seule règle de nettoyage. */\nfunction connues(valeur: unknown, colonnes: readonly string[]): string[] {\n if (!Array.isArray(valeur)) return []\n const citees = new Set(valeur)\n return ordonner(valeur, colonnes).filter((id) => citees.has(id))\n}\n\n/** Liste stable tant que son contenu ne change pas (tableaux écrits en\n * ligne par l'application). */\nfunction useListeStable(liste: readonly string[]): readonly string[] {\n const cle = liste.join(\"\\u0000\")\n // eslint-disable-next-line react-hooks/exhaustive-deps -- `cle` résume `liste`.\n return useMemo(() => liste, [cle])\n}\n\n/**\n * Colonnes affichées et leur ordre, gardés dans le navigateur pour chaque\n * liste et chaque personne (portée de `PorteeStockageLocal`), branchés sur\n * le sélecteur de colonnes d'un `DataTable` :\n *\n * ```tsx\n * const prefs = useColumnPrefs({\n * cle: \"membres:actifs\",\n * colonnes: [\"email\", \"statut\", \"telephone\"],\n * visiblesParDefaut: [\"email\", \"statut\"],\n * fixesEnTete: [\"select\", \"nom\"],\n * })\n * const table = useDataTable({ donnees, colonnes: COLONNES, idLigne,\n * ...prefs.optionsTableau })\n * ```\n *\n * Pour un tableau rendu à la main : `ordre`, `visibles` et `basculer`, et\n * `<DataTableViewOptions colonnes={…} {...prefs.optionsTableau} />`.\n */\nexport function useColumnPrefs({\n cle,\n colonnes: colonnesDonnees,\n visiblesParDefaut: visiblesDonnees,\n disponibles: disponiblesDonnees,\n fixesEnTete: fixesDonnees = [],\n portee,\n}: UseColumnPrefsOptions): ColumnPrefsResultat {\n const colonnes = useListeStable(colonnesDonnees)\n const visiblesParDefaut = useListeStable(visiblesDonnees)\n const disponibles = useListeStable(disponiblesDonnees ?? colonnesDonnees)\n const fixesEnTete = useListeStable(fixesDonnees)\n\n const [brute, setBrute] = usePersistedState<unknown>(cle, null, { portee })\n\n return useMemo(() => {\n const prefs = lirePreferencesColonnes(brute, colonnes, visiblesParDefaut)\n // Réglables : disponibles ici, connues des préférences, pas fixes en\n // tête. Les seules que le panneau « Colonnes » propose.\n const reglables = disponibles.filter(\n (id) => colonnes.includes(id) && !fixesEnTete.includes(id)\n )\n const estDisponible = (id: string) => reglables.includes(id)\n // Toujours à partir de la valeur enregistrée la plus récente.\n const modifier = (maj: (avant: ColumnPrefs) => ColumnPrefs) =>\n setBrute((avant: unknown) =>\n maj(lirePreferencesColonnes(avant, colonnes, visiblesParDefaut))\n )\n const visibiliteDe = (p: ColumnPrefs): ColumnVisibilityState =>\n Object.fromEntries(reglables.map((id) => [id, p.visible.includes(id)]))\n const ordreDe = (p: ColumnPrefs): ColumnOrderState => [\n ...fixesEnTete,\n ...p.order.filter(estDisponible),\n ]\n\n return {\n ordre: prefs.order,\n visibles: prefs.visible,\n basculer: (id) =>\n modifier((p) => ({\n ...p,\n visible: p.visible.includes(id)\n ? p.visible.filter((v) => v !== id)\n : [...p.visible, id],\n })),\n // `null` plutôt que les valeurs par défaut d'aujourd'hui : celles de\n // demain s'appliqueront aussi.\n reinitialiser: () => setBrute(null),\n optionsTableau: {\n visibiliteColonnes: visibiliteDe(prefs),\n // Les colonnes non disponibles gardent leur état.\n onVisibiliteColonnesChange: (maj) =>\n modifier((p) => {\n const suivante = functionalUpdate(maj, visibiliteDe(p))\n return {\n ...p,\n visible: [\n ...p.visible.filter((id) => !estDisponible(id)),\n ...reglables.filter((id) => suivante[id] !== false),\n ],\n }\n }),\n ordreColonnes: ordreDe(prefs),\n // Seules les colonnes disponibles changent de place ; les fixes et\n // celles hors préférences sont ignorées.\n onOrdreColonnesChange: (maj) =>\n modifier((p) => ({\n ...p,\n order: replacer(\n p.order,\n estDisponible,\n functionalUpdate(maj, ordreDe(p))\n ),\n })),\n colonnesReglables: reglables,\n },\n }\n }, [brute, setBrute, colonnes, visiblesParDefaut, disponibles, fixesEnTete])\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"use-column-prefs.js","names":["lirePreferencesColonnes","visiblesDefaut","connues","visiblesParDefaut","colonnes","brute","ordre","ordonner","order","ajoutees","visible","id","valeur","citees","useListeStable","cle","liste","useMemo","useColumnPrefs","colonnesDonnees","visiblesDonnees","disponiblesDonnees","afficheesDonnees","mobileDonnees","fixesDonnees","disponibles","affichees","gardeesMobile","fixesEnTete","restreint","useIsMobile","setBrute","usePersistedState","prefs","reglables","estDisponible","indisponibles","imposeesVisibles","imposeesMasquees","imposees","modifier","maj","avant","visibiliteDe","p","visibiliteAffichee","ordreDe","v","suivante","functionalUpdate","garder","replacer"],"sources":["../../src/hooks/use-column-prefs.ts"],"sourcesContent":["import { useMemo } from \"react\"\nimport {\n functionalUpdate,\n type ColumnOrderState,\n type ColumnVisibilityState,\n type OnChangeFn,\n} from \"@tanstack/react-table\"\n\nimport { useIsMobile } from \"@etic-ui/hooks/use-mobile\"\nimport { usePersistedState } from \"@etic-ui/hooks/use-persisted-state\"\nimport { ordonner, replacer } from \"@etic-ui/lib/ordre-colonnes\"\n\n/**\n * Préférences de colonnes enregistrées : l'ordre de toutes les colonnes\n * réglables et celles qui sont affichées. Noms anglais gardés : c'est le\n * format déjà écrit dans les navigateurs par ETIC Members.\n */\nexport interface ColumnPrefs {\n order: string[]\n visible: string[]\n}\n\nexport interface UseColumnPrefsOptions {\n /** Clé de la liste, préfixée par la portée (`PorteeStockageLocal`) :\n * « membres:actifs ». Une nouvelle clé repart des valeurs par défaut. */\n cle: string\n /** Toutes les colonnes réglables, dans leur ordre par défaut. */\n colonnes: readonly string[]\n /** Colonnes affichées tant que la personne n'a rien choisi. */\n visiblesParDefaut: readonly string[]\n /**\n * Colonnes offertes ici, parmi `colonnes` (droit manquant, donnée non\n * servie, colonne qui ne dirait rien dans cette vue) ; toutes par défaut.\n * Les autres sont masquées, hors du panneau « Colonnes », et gardent leur\n * état et leur place dans les préférences : elles réapparaissent telles\n * quelles quand elles redeviennent disponibles.\n */\n disponibles?: readonly string[]\n /**\n * Colonnes que la vue impose à l'écran, quelles que soient les\n * préférences (un filtre posé sur leur donnée montre sa colonne). Elles\n * sortent du panneau « Colonnes » le temps de l'imposition, et leur\n * préférence reste intacte.\n */\n affichees?: readonly string[]\n /**\n * Sur téléphone (`useIsMobile`), les seules colonnes réglables affichées :\n * un tableau qui défile de côté couperait sans le dire la colonne utile.\n * Les préférences restent intactes, et le panneau « Colonnes », sans objet,\n * disparaît (`colonnesReglables` vide). Sans elle, rien ne change sur\n * téléphone.\n */\n mobile?: readonly string[]\n /** Colonnes toujours en tête du tableau, hors préférences (sélection,\n * nom…). */\n fixesEnTete?: readonly string[]\n /** Remplace la portée de `PorteeStockageLocal`. */\n portee?: string | null\n}\n\n/** Les options de `useDataTable` (et de `DataTableViewOptions` sans\n * `table`) qui règlent visibilité et ordre des colonnes. */\nexport interface ColumnPrefsOptionsTableau {\n visibiliteColonnes: ColumnVisibilityState\n onVisibiliteColonnesChange: OnChangeFn<ColumnVisibilityState>\n ordreColonnes: ColumnOrderState\n onOrdreColonnesChange: OnChangeFn<ColumnOrderState>\n /** Les seules colonnes que « Colonnes » peut masquer et déplacer : les\n * disponibles, ni fixes en tête, ni imposées (`affichees`), ni absentes\n * de `colonnes` ; aucune sur téléphone avec `mobile`. */\n colonnesReglables: readonly string[]\n}\n\nexport interface ColumnPrefsResultat {\n /** Ordre de toutes les colonnes réglables. */\n ordre: string[]\n /** Colonnes affichées selon les préférences (disponibles ou non) ; ce qui\n * est à l'écran : `optionsTableau.visibiliteColonnes`. */\n visibles: string[]\n /** Affiche une colonne masquée, ou l'inverse. */\n basculer: (id: string) => void\n /** Revient aux colonnes et à l'ordre par défaut. */\n reinitialiser: () => void\n /** À étaler dans `useDataTable` (ou `DataTableViewOptions`) : visibilité\n * et ordre des colonnes disponibles, colonnes fixes en tête. Stable tant\n * que les préférences ne changent pas. */\n optionsTableau: ColumnPrefsOptionsTableau\n}\n\n/**\n * Préférences lues, remises en forme pour les colonnes d'aujourd'hui :\n * colonnes inconnues retirées ; ancien format (simple liste des colonnes\n * affichées) repris ; colonnes apparues depuis l'enregistrement ajoutées à\n * la fin, et affichées si elles le sont par défaut (l'enregistrement, plus\n * ancien qu'elles, n'a pas pu les masquer exprès).\n */\nexport function lirePreferencesColonnes(\n brute: unknown,\n colonnes: readonly string[],\n visiblesParDefaut: readonly string[]\n): ColumnPrefs {\n const visiblesDefaut = connues(visiblesParDefaut, colonnes)\n // Ancien format : la liste des colonnes affichées, sans ordre.\n if (Array.isArray(brute))\n return { order: [...colonnes], visible: connues(brute, colonnes) }\n if (!brute || typeof brute !== \"object\")\n return { order: [...colonnes], visible: visiblesDefaut }\n const { order, visible } = brute as { order?: unknown; visible?: unknown }\n const ordre = ordonner(Array.isArray(order) ? order : [], colonnes)\n // Après les colonnes citées, `ordonner` met celles que l'enregistrement\n // ne connaissait pas : les colonnes apparues depuis.\n const ajoutees = ordre.slice(connues(order, colonnes).length)\n return {\n order: ordre,\n visible:\n visible === undefined\n ? visiblesDefaut\n : connues(\n [\n ...(Array.isArray(visible) ? visible : []),\n ...ajoutees.filter((id) => visiblesParDefaut.includes(id)),\n ],\n colonnes\n ),\n }\n}\n\n/** Les identifiants connus d'une liste lue (stockage), sans doublon, dans\n * son ordre : la partie citée d'`ordonner`, seule règle de nettoyage. */\nfunction connues(valeur: unknown, colonnes: readonly string[]): string[] {\n if (!Array.isArray(valeur)) return []\n const citees = new Set(valeur)\n return ordonner(valeur, colonnes).filter((id) => citees.has(id))\n}\n\n/** Liste stable tant que son contenu ne change pas (tableaux écrits en\n * ligne par l'application). */\nfunction useListeStable(liste: readonly string[]): readonly string[] {\n const cle = liste.join(\"\\u0000\")\n // eslint-disable-next-line react-hooks/exhaustive-deps -- `cle` résume `liste`.\n return useMemo(() => liste, [cle])\n}\n\n/**\n * Colonnes affichées et leur ordre, gardés dans le navigateur pour chaque\n * liste et chaque personne (portée de `PorteeStockageLocal`), branchés sur\n * le sélecteur de colonnes d'un `DataTable` :\n *\n * ```tsx\n * const prefs = useColumnPrefs({\n * cle: \"membres:actifs\",\n * colonnes: [\"email\", \"statut\", \"telephone\"],\n * visiblesParDefaut: [\"email\", \"statut\"],\n * fixesEnTete: [\"select\", \"nom\"],\n * })\n * const table = useDataTable({ donnees, colonnes: COLONNES, idLigne,\n * ...prefs.optionsTableau })\n * ```\n *\n * Pour un tableau rendu à la main : `ordre`, `visibles` et `basculer`, et\n * `<DataTableViewOptions colonnes={…} {...prefs.optionsTableau} />`.\n */\nexport function useColumnPrefs({\n cle,\n colonnes: colonnesDonnees,\n visiblesParDefaut: visiblesDonnees,\n disponibles: disponiblesDonnees,\n affichees: afficheesDonnees = [],\n mobile: mobileDonnees,\n fixesEnTete: fixesDonnees = [],\n portee,\n}: UseColumnPrefsOptions): ColumnPrefsResultat {\n const colonnes = useListeStable(colonnesDonnees)\n const visiblesParDefaut = useListeStable(visiblesDonnees)\n const disponibles = useListeStable(disponiblesDonnees ?? colonnesDonnees)\n const affichees = useListeStable(afficheesDonnees)\n const gardeesMobile = useListeStable(mobileDonnees ?? [])\n const fixesEnTete = useListeStable(fixesDonnees)\n const restreint = useIsMobile() && mobileDonnees !== undefined\n\n const [brute, setBrute] = usePersistedState<unknown>(cle, null, { portee })\n\n return useMemo(() => {\n const prefs = lirePreferencesColonnes(brute, colonnes, visiblesParDefaut)\n // Disponibles ici, connues des préférences, pas fixes en tête : celles\n // dont les préférences règlent l'affichage.\n const reglables = disponibles.filter(\n (id) => colonnes.includes(id) && !fixesEnTete.includes(id)\n )\n const estDisponible = (id: string) => reglables.includes(id)\n // Indisponibles : masquées, sans quoi TanStack affiche une colonne que\n // la visibilité ne cite pas.\n const indisponibles = colonnes.filter(\n (id) => !estDisponible(id) && !fixesEnTete.includes(id)\n )\n const imposeesVisibles = affichees.filter(estDisponible)\n const imposeesMasquees = restreint\n ? reglables.filter(\n (id) => !gardeesMobile.includes(id) && !affichees.includes(id)\n )\n : []\n const imposees = new Set([...imposeesVisibles, ...imposeesMasquees])\n // Toujours à partir de la valeur enregistrée la plus récente.\n const modifier = (maj: (avant: ColumnPrefs) => ColumnPrefs) =>\n setBrute((avant: unknown) =>\n maj(lirePreferencesColonnes(avant, colonnes, visiblesParDefaut))\n )\n const visibiliteDe = (p: ColumnPrefs): ColumnVisibilityState =>\n Object.fromEntries(reglables.map((id) => [id, p.visible.includes(id)]))\n const visibiliteAffichee: ColumnVisibilityState = {\n ...Object.fromEntries(indisponibles.map((id) => [id, false])),\n ...visibiliteDe(prefs),\n ...Object.fromEntries(imposeesMasquees.map((id) => [id, false])),\n ...Object.fromEntries(imposeesVisibles.map((id) => [id, true])),\n }\n const ordreDe = (p: ColumnPrefs): ColumnOrderState => [\n ...fixesEnTete,\n ...p.order.filter(estDisponible),\n ]\n\n return {\n ordre: prefs.order,\n visibles: prefs.visible,\n basculer: (id) =>\n modifier((p) => ({\n ...p,\n visible: p.visible.includes(id)\n ? p.visible.filter((v) => v !== id)\n : [...p.visible, id],\n })),\n // `null` plutôt que les valeurs par défaut d'aujourd'hui : celles de\n // demain s'appliqueront aussi.\n reinitialiser: () => setBrute(null),\n optionsTableau: {\n visibiliteColonnes: visibiliteAffichee,\n // Les colonnes non disponibles gardent leur état, les colonnes\n // imposées leur préférence : un geste parti de l'état affiché ne la\n // change pas.\n onVisibiliteColonnesChange: (maj) =>\n modifier((p) => {\n const avant = visibiliteDe(p)\n const suivante = functionalUpdate(maj, avant)\n const garder = (id: string) =>\n imposees.has(id) ? avant[id] : suivante[id] !== false\n return {\n ...p,\n visible: [\n ...p.visible.filter((id) => !estDisponible(id)),\n ...reglables.filter(garder),\n ],\n }\n }),\n ordreColonnes: ordreDe(prefs),\n // Seules les colonnes disponibles changent de place ; les fixes et\n // celles hors préférences sont ignorées.\n onOrdreColonnesChange: (maj) =>\n modifier((p) => ({\n ...p,\n order: replacer(\n p.order,\n estDisponible,\n functionalUpdate(maj, ordreDe(p))\n ),\n })),\n colonnesReglables: restreint\n ? []\n : reglables.filter((id) => !imposees.has(id)),\n },\n }\n }, [\n brute,\n setBrute,\n colonnes,\n visiblesParDefaut,\n disponibles,\n affichees,\n gardeesMobile,\n restreint,\n fixesEnTete,\n ])\n}\n"],"mappings":"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"}
@@ -0,0 +1,29 @@
1
+ export interface UseDebouncedSearchOptions {
2
+ /** Pause de frappe avant la recopie, en millisecondes (300 par défaut). */
3
+ delai?: number;
4
+ /**
5
+ * Un champ démonté avant la fin de la pause (panneau refermé) recopie
6
+ * aussitôt la saisie en attente, au lieu de la perdre.
7
+ */
8
+ recopierAuDemontage?: boolean;
9
+ }
10
+ /**
11
+ * Champ de recherche dont la valeur vit ailleurs (l'URL, l'état d'une liste)
12
+ * mais n'y est recopiée qu'après une pause de frappe, sans les espaces de
13
+ * tête et de fin : la requête ne part pas à chaque caractère, et la saisie
14
+ * reste fluide. Rend la saisie et son setter, comme un `useState`.
15
+ *
16
+ * Si la valeur change d'ailleurs (retour arrière, filtres réinitialisés), la
17
+ * saisie suit ; si c'est la saisie qui vient d'être recopiée, rien ne bouge,
18
+ * sans quoi une frappe rapide serait écrasée par la valeur recopiée 300 ms
19
+ * plus tôt.
20
+ *
21
+ * ```tsx
22
+ * const [saisie, setSaisie] = useDebouncedSearch(
23
+ * params.get("recherche") ?? "",
24
+ * (valeur) => definirFiltre("recherche", valeur)
25
+ * )
26
+ * <DataTableToolbar recherche={{ valeur: saisie, onValeurChange: setSaisie }} />
27
+ * ```
28
+ */
29
+ export declare function useDebouncedSearch(valeur: string, onValeurChange: (valeur: string) => void, { delai, recopierAuDemontage }?: UseDebouncedSearchOptions): readonly [string, import('react').Dispatch<import('react').SetStateAction<string>>];
@@ -0,0 +1,29 @@
1
+ import { useDebouncedValue as e } from "./use-debounced-value.js";
2
+ import { useEffect as t, useLayoutEffect as n, useRef as r, useState as i } from "react";
3
+ // src/hooks/use-debounced-search.ts
4
+ function a(a, o, { delai: s, recopierAuDemontage: c = !1 } = {}) {
5
+ let [l, u] = i(a), d = e(l.trim(), s), [f, p] = i(a);
6
+ a !== f && (p(a), a !== d && u(a));
7
+ let m = r({
8
+ valeur: a,
9
+ onValeurChange: o,
10
+ saisie: l.trim()
11
+ });
12
+ return n(() => {
13
+ m.current = {
14
+ valeur: a,
15
+ onValeurChange: o,
16
+ saisie: l.trim()
17
+ };
18
+ }), t(() => {
19
+ d !== m.current.valeur && m.current.onValeurChange(d);
20
+ }, [d]), t(() => {
21
+ if (c) return () => {
22
+ let e = m.current;
23
+ e.saisie !== e.valeur && e.onValeurChange(e.saisie);
24
+ };
25
+ }, [c]), [l, u];
26
+ }
27
+ export { a as useDebouncedSearch };
28
+
29
+ //# sourceMappingURL=use-debounced-search.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-debounced-search.js","names":["useDebouncedSearch","saisie","setSaisie","useState","valeur","differee","useDebouncedValue","delai","derniere","setDerniere","contexte","useRef","useLayoutEffect","useEffect","recopierAuDemontage","dernier"],"sources":["../../src/hooks/use-debounced-search.ts"],"sourcesContent":["import { useEffect, useLayoutEffect, useRef, useState } from \"react\"\n\nimport { useDebouncedValue } from \"@etic-ui/hooks/use-debounced-value\"\n\nexport interface UseDebouncedSearchOptions {\n /** Pause de frappe avant la recopie, en millisecondes (300 par défaut). */\n delai?: number\n /**\n * Un champ démonté avant la fin de la pause (panneau refermé) recopie\n * aussitôt la saisie en attente, au lieu de la perdre.\n */\n recopierAuDemontage?: boolean\n}\n\n/**\n * Champ de recherche dont la valeur vit ailleurs (l'URL, l'état d'une liste)\n * mais n'y est recopiée qu'après une pause de frappe, sans les espaces de\n * tête et de fin : la requête ne part pas à chaque caractère, et la saisie\n * reste fluide. Rend la saisie et son setter, comme un `useState`.\n *\n * Si la valeur change d'ailleurs (retour arrière, filtres réinitialisés), la\n * saisie suit ; si c'est la saisie qui vient d'être recopiée, rien ne bouge,\n * sans quoi une frappe rapide serait écrasée par la valeur recopiée 300 ms\n * plus tôt.\n *\n * ```tsx\n * const [saisie, setSaisie] = useDebouncedSearch(\n * params.get(\"recherche\") ?? \"\",\n * (valeur) => definirFiltre(\"recherche\", valeur)\n * )\n * <DataTableToolbar recherche={{ valeur: saisie, onValeurChange: setSaisie }} />\n * ```\n */\nexport function useDebouncedSearch(\n valeur: string,\n onValeurChange: (valeur: string) => void,\n { delai, recopierAuDemontage = false }: UseDebouncedSearchOptions = {}\n) {\n const [saisie, setSaisie] = useState(valeur)\n const differee = useDebouncedValue(saisie.trim(), delai)\n\n const [derniere, setDerniere] = useState(valeur)\n if (valeur !== derniere) {\n setDerniere(valeur)\n if (valeur !== differee) setSaisie(valeur)\n }\n\n // L'effet ne dépend que de la valeur différée : y ajouter `valeur` le\n // rejouerait quand elle change d'ailleurs, et il y recopierait la saisie\n // périmée. Il lit donc `valeur` et `onValeurChange` du dernier rendu.\n const contexte = useRef({ valeur, onValeurChange, saisie: saisie.trim() })\n useLayoutEffect(() => {\n contexte.current = { valeur, onValeurChange, saisie: saisie.trim() }\n })\n useEffect(() => {\n if (differee !== contexte.current.valeur)\n contexte.current.onValeurChange(differee)\n }, [differee])\n useEffect(() => {\n if (!recopierAuDemontage) return\n return () => {\n const dernier = contexte.current\n if (dernier.saisie !== dernier.valeur)\n dernier.onValeurChange(dernier.saisie)\n }\n }, [recopierAuDemontage])\n\n return [saisie, setSaisie] as const\n}\n"],"mappings":";;;AAiCA,SAAgBA,EACd,GACA,GACA,EAAE,UAAO,yBAAsB,OAAqC,CAAC,GACrE;CACA,IAAM,CAACC,GAAQC,KAAaC,EAASC,CAAM,GACrCC,IAAWC,EAAkBL,EAAO,KAAK,GAAGM,CAAK,GAEjD,CAACC,GAAUC,KAAeN,EAASC,CAAM;CAC/C,AAAIA,MAAWI,MACbC,EAAYL,CAAM,GACdA,MAAWC,KAAUH,EAAUE,CAAM;CAM3C,IAAMM,IAAWC,EAAO;EAAE;EAAQ;EAAgB,QAAQV,EAAO,KAAK;CAAE,CAAC;CAiBzE,OAhBAW,QAAsB;EACpB,EAAS,UAAU;GAAE;GAAQ;GAAgB,QAAQX,EAAO,KAAK;EAAE;CACrE,CAAC,GACDY,QAAgB;EACd,AAAIR,MAAaK,EAAS,QAAQ,UAChCA,EAAS,QAAQ,eAAeL,CAAQ;CAC5C,GAAG,CAACA,CAAQ,CAAC,GACbQ,QAAgB;EACd,IAAKC,GACL,aAAa;GACX,IAAMC,IAAUL,EAAS;GACzB,AAAIK,EAAQ,WAAWA,EAAQ,UAC7BA,EAAQ,eAAeA,EAAQ,MAAM;EACzC;CACF,GAAG,CAACD,CAAmB,CAAC,GAEjB,CAACb,GAAQC,CAAS;AAC3B"}
@@ -0,0 +1,33 @@
1
+ export interface FreshDialogEtat {
2
+ /** À passer en `key` au dialogue : elle change à chaque demande, et le
3
+ * formulaire repart neuf. */
4
+ cle: number;
5
+ /** Le dialogue a été demandé au moins une fois : avant, rien n'est monté
6
+ * ni lu. */
7
+ monte: boolean;
8
+ ouvert: boolean;
9
+ /** Ouvre le dialogue, neuf. Stable. */
10
+ ouvrir: () => void;
11
+ /** Pour `onOuvertChange` du dialogue : seule la fermeture agit. */
12
+ onOuvertChange: (ouvert: boolean) => void;
13
+ }
14
+ /**
15
+ * Un dialogue qui repart d'un formulaire neuf à chaque ouverture, sans
16
+ * vider ses champs à la main : sa `key` change à chaque demande, et fermé,
17
+ * il reste monté le temps de son animation (son contenu ne disparaît pas en
18
+ * glissant).
19
+ *
20
+ * `demandesExternes` : un compteur de demandes tenu ailleurs (un geste de la
21
+ * page parente, un raccourci) ; chaque incrément ouvre le dialogue, comme
22
+ * `ouvrir`.
23
+ *
24
+ * ```tsx
25
+ * const creation = useFreshDialog()
26
+ * <Button onClick={creation.ouvrir}>Nouveau groupe</Button>
27
+ * {creation.monte ? (
28
+ * <FormDialog key={creation.cle} ouvert={creation.ouvert}
29
+ * onOuvertChange={creation.onOuvertChange} … />
30
+ * ) : null}
31
+ * ```
32
+ */
33
+ export declare function useFreshDialog(demandesExternes?: number): FreshDialogEtat;
@@ -0,0 +1,17 @@
1
+ import { useCallback as e, useState as t } from "react";
2
+ // src/hooks/use-fresh-dialog.ts
3
+ function n(n = 0) {
4
+ let [r, i] = t(0), [a, o] = t(0), s = n + r, c = e(() => i((e) => e + 1), []), l = e((e) => {
5
+ e || o(s);
6
+ }, [s]);
7
+ return {
8
+ cle: s,
9
+ monte: s > 0,
10
+ ouvert: s > a,
11
+ ouvrir: c,
12
+ onOuvertChange: l
13
+ };
14
+ }
15
+ export { n as useFreshDialog };
16
+
17
+ //# sourceMappingURL=use-fresh-dialog.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-fresh-dialog.js","names":["useFreshDialog","demandesLocales","setDemandesLocales","useState","fermeA","setFermeA","demandes","demandesExternes","ouvrir","useCallback","n","onOuvertChange","ouvert"],"sources":["../../src/hooks/use-fresh-dialog.ts"],"sourcesContent":["import { useCallback, useState } from \"react\"\n\nexport interface FreshDialogEtat {\n /** À passer en `key` au dialogue : elle change à chaque demande, et le\n * formulaire repart neuf. */\n cle: number\n /** Le dialogue a été demandé au moins une fois : avant, rien n'est monté\n * ni lu. */\n monte: boolean\n ouvert: boolean\n /** Ouvre le dialogue, neuf. Stable. */\n ouvrir: () => void\n /** Pour `onOuvertChange` du dialogue : seule la fermeture agit. */\n onOuvertChange: (ouvert: boolean) => void\n}\n\n/**\n * Un dialogue qui repart d'un formulaire neuf à chaque ouverture, sans\n * vider ses champs à la main : sa `key` change à chaque demande, et fermé,\n * il reste monté le temps de son animation (son contenu ne disparaît pas en\n * glissant).\n *\n * `demandesExternes` : un compteur de demandes tenu ailleurs (un geste de la\n * page parente, un raccourci) ; chaque incrément ouvre le dialogue, comme\n * `ouvrir`.\n *\n * ```tsx\n * const creation = useFreshDialog()\n * <Button onClick={creation.ouvrir}>Nouveau groupe</Button>\n * {creation.monte ? (\n * <FormDialog key={creation.cle} ouvert={creation.ouvert}\n * onOuvertChange={creation.onOuvertChange} … />\n * ) : null}\n * ```\n */\nexport function useFreshDialog(demandesExternes = 0): FreshDialogEtat {\n const [demandesLocales, setDemandesLocales] = useState(0)\n // Le nombre de demandes à la dernière fermeture : ouvert tant qu'une\n // demande l'a suivie.\n const [fermeA, setFermeA] = useState(0)\n const demandes = demandesExternes + demandesLocales\n\n const ouvrir = useCallback(() => setDemandesLocales((n) => n + 1), [])\n const onOuvertChange = useCallback(\n (ouvert: boolean) => {\n if (!ouvert) setFermeA(demandes)\n },\n [demandes]\n )\n\n return {\n cle: demandes,\n monte: demandes > 0,\n ouvert: demandes > fermeA,\n ouvrir,\n onOuvertChange,\n }\n}\n"],"mappings":";;AAmCA,SAAgBA,EAAe,IAAmB,GAAoB;CACpE,IAAM,CAACC,GAAiBC,KAAsBC,EAAS,CAAC,GAGlD,CAACC,GAAQC,KAAaF,EAAS,CAAC,GAChCG,IAAWC,IAAmBN,GAE9BO,IAASC,QAAkBP,GAAoB,MAAMQ,IAAI,CAAC,GAAG,CAAC,CAAC,GAC/DC,IAAiBF,GACpB,MAAoB;EACnB,AAAKG,KAAQP,EAAUC,CAAQ;CACjC,GACA,CAACA,CAAQ,CACX;CAEA,OAAO;EACL,KAAKA;EACL,OAAOA,IAAW;EAClB,QAAQA,IAAWF;EACnB;EACA;CACF;AACF"}
@@ -0,0 +1,23 @@
1
+ /** Une lecture qui se lance et s'oublie : la forme d'une mutation de
2
+ * TanStack Query (`useMutation`), sans en dépendre. */
3
+ export interface LectureAOuverture {
4
+ mutate: () => void;
5
+ reset: () => void;
6
+ }
7
+ /**
8
+ * Lance une lecture à chaque ouverture d'un dialogue (des données qui ont
9
+ * pu changer ailleurs depuis la dernière fois), et l'oublie à sa fermeture :
10
+ * la prochaine ouverture ne montre pas, le temps d'un rendu, la réponse
11
+ * précédente. Rend la relecture, stable, pour « Réessayer ».
12
+ *
13
+ * Seul `ouvert` relance la lecture : `mutate` et `reset` peuvent être écrits
14
+ * en ligne (`mutate: () => lecture.mutate(id)`), ceux du dernier rendu
15
+ * servent.
16
+ *
17
+ * ```tsx
18
+ * const lecture = useMutation({ mutationFn: lireTaux })
19
+ * const relire = useLoadOnOpen(lecture, ouvert)
20
+ * <QueryErrorBanner requete={…} /> // ou ErrorBanner onReessayer={relire}
21
+ * ```
22
+ */
23
+ export declare function useLoadOnOpen(lecture: LectureAOuverture, ouvert: boolean): () => void;
@@ -0,0 +1,21 @@
1
+ import { useCallback as e, useEffect as t, useLayoutEffect as n, useRef as r } from "react";
2
+ // src/hooks/use-load-on-open.ts
3
+ function i(i, a) {
4
+ let { mutate: o, reset: s } = i, c = r({
5
+ mutate: o,
6
+ reset: s
7
+ });
8
+ n(() => {
9
+ c.current = {
10
+ mutate: o,
11
+ reset: s
12
+ };
13
+ });
14
+ let l = e(() => c.current.mutate(), []);
15
+ return t(() => {
16
+ if (a) return l(), () => c.current.reset();
17
+ }, [a, l]), l;
18
+ }
19
+ export { i as useLoadOnOpen };
20
+
21
+ //# sourceMappingURL=use-load-on-open.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-load-on-open.js","names":["useLoadOnOpen","lecture","dernierRendu","useRef","relire","useCallback","useEffect","ouvert"],"sources":["../../src/hooks/use-load-on-open.ts"],"sourcesContent":["import { useCallback, useEffect, useLayoutEffect, useRef } from \"react\"\n\n/** Une lecture qui se lance et s'oublie : la forme d'une mutation de\n * TanStack Query (`useMutation`), sans en dépendre. */\nexport interface LectureAOuverture {\n mutate: () => void\n reset: () => void\n}\n\n/**\n * Lance une lecture à chaque ouverture d'un dialogue (des données qui ont\n * pu changer ailleurs depuis la dernière fois), et l'oublie à sa fermeture :\n * la prochaine ouverture ne montre pas, le temps d'un rendu, la réponse\n * précédente. Rend la relecture, stable, pour « Réessayer ».\n *\n * Seul `ouvert` relance la lecture : `mutate` et `reset` peuvent être écrits\n * en ligne (`mutate: () => lecture.mutate(id)`), ceux du dernier rendu\n * servent.\n *\n * ```tsx\n * const lecture = useMutation({ mutationFn: lireTaux })\n * const relire = useLoadOnOpen(lecture, ouvert)\n * <QueryErrorBanner requete={…} /> // ou ErrorBanner onReessayer={relire}\n * ```\n */\nexport function useLoadOnOpen(\n lecture: LectureAOuverture,\n ouvert: boolean\n): () => void {\n const { mutate, reset } = lecture\n const dernierRendu = useRef({ mutate, reset })\n useLayoutEffect(() => {\n dernierRendu.current = { mutate, reset }\n })\n const relire = useCallback(() => dernierRendu.current.mutate(), [])\n useEffect(() => {\n if (!ouvert) return\n relire()\n return () => dernierRendu.current.reset()\n }, [ouvert, relire])\n return relire\n}\n"],"mappings":";;AAyBA,SAAgBA,EACd,GACA,GACY;CACZ,IAAM,EAAE,WAAQ,aAAUC,GACpBC,IAAeC,EAAO;EAAE;EAAQ;CAAM,CAAC;CAC7C,QAAsB;EACpB,EAAa,UAAU;GAAE;GAAQ;EAAM;CACzC,CAAC;CACD,IAAMC,IAASC,QAAkBH,EAAa,QAAQ,OAAO,GAAG,CAAC,CAAC;CAMlE,OALAI,QAAgB;EACd,IAAKC,GAEL,OADAH,EAAO,SACMF,EAAa,QAAQ,MAAM;CAC1C,GAAG,CAACK,GAAQH,CAAM,CAAC,GACZA;AACT"}
@@ -0,0 +1,45 @@
1
+ export interface SaveByKeyEtat<R> {
2
+ /** Le refus de chaque clé refusée, à afficher sous son champ. */
3
+ refus: Readonly<Record<string, R>>;
4
+ /** La panne qui a arrêté l'enregistrement (bandeau), ou `null`. */
5
+ panne: unknown;
6
+ enCours: boolean;
7
+ /** Tout est parti sans refus ni panne (« Enregistré »). */
8
+ enregistre: boolean;
9
+ /**
10
+ * Envoie chaque élément, dans l'ordre. `refusDe` lit le refus d'une
11
+ * saisie (une erreur de validation), ou rend `null` pour une panne, qui
12
+ * arrête l'enregistrement.
13
+ */
14
+ enregistrer: <E extends {
15
+ cle: string;
16
+ }>(envois: readonly E[], envoyer: (envoi: E) => Promise<unknown>, refusDe: (erreur: unknown) => R | null) => Promise<void>;
17
+ /** Une saisie change : son refus visait la précédente, et « Enregistré »
18
+ * ne vaut plus. Stable. */
19
+ saisieChangee: (cle: string) => void;
20
+ /** Retire le refus d'une clé. Stable. */
21
+ oublierRefus: (cle: string) => void;
22
+ /** « Annuler » : refus et panne disparaissent avec la saisie. Stable. */
23
+ oublierTout: () => void;
24
+ }
25
+ /**
26
+ * L'enregistrement d'un formulaire de réglages dont chaque valeur part
27
+ * seule (une requête par clé) : les clés modifiées partent l'une après
28
+ * l'autre. Un refus de la saisie reste sous son champ et les suivantes
29
+ * partent quand même ; une panne (réseau, serveur) arrête l'enregistrement
30
+ * et s'affiche en bandeau. `R` : ce que le champ refusé affiche (l'erreur,
31
+ * ou son message).
32
+ *
33
+ * ```tsx
34
+ * const sauvegarde = useSaveByKey<string>()
35
+ * await sauvegarde.enregistrer(
36
+ * modifiees, // [{ cle: "delai", valeur: 30 }, …]
37
+ * ({ cle, valeur }) => api.reglages.ecrire(cle, valeur),
38
+ * (erreur) => (estRefusDeSaisie(erreur) ? erreur.message : null)
39
+ * )
40
+ * <FormField erreur={sauvegarde.refus.delai} …>
41
+ * <ErrorBanner erreur={sauvegarde.panne} />
42
+ * <SaveBar enCours={sauvegarde.enCours} enregistre={sauvegarde.enregistre} … />
43
+ * ```
44
+ */
45
+ export declare function useSaveByKey<R>(): SaveByKeyEtat<R>;