@etic-insa/ui 0.6.0 → 0.8.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 (82) hide show
  1. package/README.md +283 -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-pagination.d.ts +4 -1
  9. package/dist/components/etic/data-table-pagination.js +39 -38
  10. package/dist/components/etic/data-table-pagination.js.map +1 -1
  11. package/dist/components/etic/data-table-toolbar.d.ts +12 -1
  12. package/dist/components/etic/data-table-toolbar.js +50 -39
  13. package/dist/components/etic/data-table-toolbar.js.map +1 -1
  14. package/dist/components/etic/data-table-view-options.d.ts +2 -1
  15. package/dist/components/etic/data-table-view-options.js +1 -1
  16. package/dist/components/etic/data-table-view-options.js.map +1 -1
  17. package/dist/components/etic/detail-meta.d.ts +28 -0
  18. package/dist/components/etic/detail-meta.js +51 -0
  19. package/dist/components/etic/detail-meta.js.map +1 -0
  20. package/dist/components/etic/detail-sheet.d.ts +36 -0
  21. package/dist/components/etic/detail-sheet.js +37 -0
  22. package/dist/components/etic/detail-sheet.js.map +1 -0
  23. package/dist/components/etic/empty-state.d.ts +15 -0
  24. package/dist/components/etic/empty-state.js +24 -12
  25. package/dist/components/etic/empty-state.js.map +1 -1
  26. package/dist/components/etic/external-link.d.ts +40 -0
  27. package/dist/components/etic/external-link.js +47 -0
  28. package/dist/components/etic/external-link.js.map +1 -0
  29. package/dist/components/etic/file-upload.d.ts +19 -0
  30. package/dist/components/etic/file-upload.js +24 -1
  31. package/dist/components/etic/file-upload.js.map +1 -1
  32. package/dist/components/etic/nav-tabs.d.ts +27 -0
  33. package/dist/components/etic/nav-tabs.js +22 -0
  34. package/dist/components/etic/nav-tabs.js.map +1 -0
  35. package/dist/components/etic/phone-input.d.ts +4 -3
  36. package/dist/components/etic/phone-input.js +51 -37
  37. package/dist/components/etic/phone-input.js.map +1 -1
  38. package/dist/components/etic/save-bar.d.ts +3 -2
  39. package/dist/components/etic/save-bar.js +16 -15
  40. package/dist/components/etic/save-bar.js.map +1 -1
  41. package/dist/components/etic/select-field.d.ts +38 -0
  42. package/dist/components/etic/select-field.js +42 -0
  43. package/dist/components/etic/select-field.js.map +1 -0
  44. package/dist/components/etic/sub-section.d.ts +15 -0
  45. package/dist/components/etic/sub-section.js +23 -0
  46. package/dist/components/etic/sub-section.js.map +1 -0
  47. package/dist/components/etic/use-detail-sheet.d.ts +58 -0
  48. package/dist/components/etic/use-detail-sheet.js +35 -0
  49. package/dist/components/etic/use-detail-sheet.js.map +1 -0
  50. package/dist/components/etic/use-server-pagination.d.ts +55 -0
  51. package/dist/components/etic/use-server-pagination.js +31 -0
  52. package/dist/components/etic/use-server-pagination.js.map +1 -0
  53. package/dist/components/etic/use-server-sorting.d.ts +29 -0
  54. package/dist/components/etic/use-server-sorting.js +19 -0
  55. package/dist/components/etic/use-server-sorting.js.map +1 -0
  56. package/dist/components/ui/sheet.d.ts +20 -2
  57. package/dist/components/ui/sheet.js +21 -8
  58. package/dist/components/ui/sheet.js.map +1 -1
  59. package/dist/hooks/use-column-prefs.d.ts +25 -7
  60. package/dist/hooks/use-column-prefs.js +44 -35
  61. package/dist/hooks/use-column-prefs.js.map +1 -1
  62. package/dist/hooks/use-debounced-search.d.ts +29 -0
  63. package/dist/hooks/use-debounced-search.js +29 -0
  64. package/dist/hooks/use-debounced-search.js.map +1 -0
  65. package/dist/hooks/use-fresh-dialog.d.ts +33 -0
  66. package/dist/hooks/use-fresh-dialog.js +17 -0
  67. package/dist/hooks/use-fresh-dialog.js.map +1 -0
  68. package/dist/hooks/use-list-url-state.d.ts +90 -0
  69. package/dist/hooks/use-list-url-state.js +71 -0
  70. package/dist/hooks/use-list-url-state.js.map +1 -0
  71. package/dist/hooks/use-load-on-open.d.ts +23 -0
  72. package/dist/hooks/use-load-on-open.js +21 -0
  73. package/dist/hooks/use-load-on-open.js.map +1 -0
  74. package/dist/hooks/use-save-by-key.d.ts +45 -0
  75. package/dist/hooks/use-save-by-key.js +49 -0
  76. package/dist/hooks/use-save-by-key.js.map +1 -0
  77. package/dist/index.d.ts +20 -5
  78. package/dist/index.js +118 -103
  79. package/dist/lib/format.d.ts +32 -0
  80. package/dist/lib/format.js +54 -18
  81. package/dist/lib/format.js.map +1 -1
  82. package/package.json +1 -1
@@ -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":";;;;;AA6EA,SAAgBA,EACd,GACA,GACA,GACa;CACb,IAAMC,IAAiBC,EAAQC,GAAmBC,CAAQ;CAE1D,IAAI,MAAM,QAAQC,CAAK,GACrB,OAAO;EAAE,OAAO,CAAC,GAAGD,CAAQ;EAAG,SAASF,EAAQG,GAAOD,CAAQ;CAAE;CACnE,IAAI,CAACC,KAAS,OAAOA,KAAU,UAC7B,OAAO;EAAE,OAAO,CAAC,GAAGD,CAAQ;EAAG,SAASH;CAAe;CACzD,IAAM,EAAE,UAAO,eAAYI,GACrBC,IAAQC,EAAS,MAAM,QAAQC,CAAK,IAAIA,IAAQ,CAAC,GAAGJ,CAAQ,GAG5DK,IAAWH,EAAM,MAAMJ,EAAQM,GAAOJ,CAAQ,CAAC,CAAC,MAAM;CAC5D,OAAO;EACL,OAAOE;EACP,SACEI,MAAY,KAAA,IACRT,IACAC,EACE,CACE,GAAI,MAAM,QAAQQ,CAAO,IAAIA,IAAU,CAAC,GACxC,GAAGD,EAAS,QAAQ,MAAON,EAAkB,SAASQ,CAAE,CAAC,CAC3D,GACAP,CACF;CACR;AACF;AAIA,SAASF,EAAQ,GAAiB,GAAuC;CACvE,IAAI,CAAC,MAAM,QAAQU,CAAM,GAAG,OAAO,CAAC;CACpC,IAAMC,IAAS,IAAI,IAAID,CAAM;CAC7B,OAAOL,EAASK,GAAQR,CAAQ,CAAC,CAAC,QAAQ,MAAOS,EAAO,IAAIF,CAAE,CAAC;AACjE;AAIA,SAASG,EAAe,GAA6C;CACnE,IAAMC,IAAMC,EAAM,KAAK,IAAQ;CAE/B,OAAOC,QAAcD,GAAO,CAACD,CAAG,CAAC;AACnC;AAqBA,SAAgBG,EAAe,EAC7B,QACA,UAAUC,GACV,mBAAmBC,GACnB,aAAaC,GACb,aAAaC,IAAe,CAAC,GAC7B,aAC6C;CAC7C,IAAMlB,IAAWU,EAAeK,CAAe,GACzChB,IAAoBW,EAAeM,CAAe,GAClDG,IAAcT,EAAeO,KAAsBF,CAAe,GAClEK,IAAcV,EAAeQ,CAAY,GAEzC,CAACjB,GAAOoB,KAAYC,EAA2BX,GAAK,MAAM,EAAE,UAAO,CAAC;CAE1E,OAAOE,QAAc;EACnB,IAAMU,IAAQ3B,EAAwBK,GAAOD,GAAUD,CAAiB,GAGlEyB,IAAYL,EAAY,QAC3B,MAAOnB,EAAS,SAASO,CAAE,KAAK,CAACa,EAAY,SAASb,CAAE,CAC3D,GACMkB,KAAiB,MAAeD,EAAU,SAASjB,CAAE,GAErDmB,KAAY,MAChBL,GAAU,MACRM,EAAI/B,EAAwBgC,GAAO5B,GAAUD,CAAiB,CAAC,CACjE,GACI8B,KAAgB,MACpB,OAAO,YAAYL,EAAU,KAAK,MAAO,CAACjB,GAAIuB,EAAE,QAAQ,SAASvB,CAAE,CAAC,CAAC,CAAC,GAClEwB,KAAW,MAAqC,CACpD,GAAGX,GACH,GAAGU,EAAE,MAAM,OAAOL,CAAa,CACjC;EAEA,OAAO;GACL,OAAOF,EAAM;GACb,UAAUA,EAAM;GAChB,WAAW,MACTG,GAAU,OAAO;IACf,GAAGI;IACH,SAASA,EAAE,QAAQ,SAASvB,CAAE,IAC1BuB,EAAE,QAAQ,QAAQ,MAAME,MAAMzB,CAAE,IAChC,CAAC,GAAGuB,EAAE,SAASvB,CAAE;GACvB,EAAE;GAGJ,qBAAqBc,EAAS,IAAI;GAClC,gBAAgB;IACd,oBAAoBQ,EAAaN,CAAK;IAEtC,6BAA6B,MAC3BG,GAAU,MAAM;KACd,IAAMO,IAAWC,EAAiBP,GAAKE,EAAaC,CAAC,CAAC;KACtD,OAAO;MACL,GAAGA;MACH,SAAS,CACP,GAAGA,EAAE,QAAQ,QAAQ,MAAO,CAACL,EAAclB,CAAE,CAAC,GAC9C,GAAGiB,EAAU,QAAQ,MAAOS,EAAS1B,OAAQ,EAAK,CACpD;KACF;IACF,CAAC;IACH,eAAewB,EAAQR,CAAK;IAG5B,wBAAwB,MACtBG,GAAU,OAAO;KACf,GAAGI;KACH,OAAOK,EACLL,EAAE,OACFL,GACAS,EAAiBP,GAAKI,EAAQD,CAAC,CAAC,CAClC;IACF,EAAE;IACJ,mBAAmBN;GACrB;EACF;CACF,GAAG;EAACvB;EAAOoB;EAAUrB;EAAUD;EAAmBoB;EAAaC;CAAW,CAAC;AAC7E"}
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":";;;;;;AAgGA,SAAgBA,EACd,GACA,GACA,GACa;CACb,IAAMC,IAAiBC,EAAQC,GAAmBC,CAAQ;CAE1D,IAAI,MAAM,QAAQC,CAAK,GACrB,OAAO;EAAE,OAAO,CAAC,GAAGD,CAAQ;EAAG,SAASF,EAAQG,GAAOD,CAAQ;CAAE;CACnE,IAAI,CAACC,KAAS,OAAOA,KAAU,UAC7B,OAAO;EAAE,OAAO,CAAC,GAAGD,CAAQ;EAAG,SAASH;CAAe;CACzD,IAAM,EAAE,UAAO,eAAYI,GACrBC,IAAQC,EAAS,MAAM,QAAQC,CAAK,IAAIA,IAAQ,CAAC,GAAGJ,CAAQ,GAG5DK,IAAWH,EAAM,MAAMJ,EAAQM,GAAOJ,CAAQ,CAAC,CAAC,MAAM;CAC5D,OAAO;EACL,OAAOE;EACP,SACEI,MAAY,KAAA,IACRT,IACAC,EACE,CACE,GAAI,MAAM,QAAQQ,CAAO,IAAIA,IAAU,CAAC,GACxC,GAAGD,EAAS,QAAQ,MAAON,EAAkB,SAASQ,CAAE,CAAC,CAC3D,GACAP,CACF;CACR;AACF;AAIA,SAASF,EAAQ,GAAiB,GAAuC;CACvE,IAAI,CAAC,MAAM,QAAQU,CAAM,GAAG,OAAO,CAAC;CACpC,IAAMC,IAAS,IAAI,IAAID,CAAM;CAC7B,OAAOL,EAASK,GAAQR,CAAQ,CAAC,CAAC,QAAQ,MAAOS,EAAO,IAAIF,CAAE,CAAC;AACjE;AAIA,SAASG,EAAe,GAA6C;CACnE,IAAMC,IAAMC,EAAM,KAAK,IAAQ;CAE/B,OAAOC,QAAcD,GAAO,CAACD,CAAG,CAAC;AACnC;AAqBA,SAAgBG,EAAe,EAC7B,QACA,UAAUC,GACV,mBAAmBC,GACnB,aAAaC,GACb,WAAWC,IAAmB,CAAC,GAC/B,QAAQC,GACR,aAAaC,IAAe,CAAC,GAC7B,aAC6C;CAC7C,IAAMpB,IAAWU,EAAeK,CAAe,GACzChB,IAAoBW,EAAeM,CAAe,GAClDK,IAAcX,EAAeO,KAAsBF,CAAe,GAClEO,IAAYZ,EAAeQ,CAAgB,GAC3CK,IAAgBb,EAAeS,KAAiB,CAAC,CAAC,GAClDK,IAAcd,EAAeU,CAAY,GACzCK,IAAYC,EAAY,KAAKP,MAAkB,KAAA,GAE/C,CAAClB,GAAO0B,KAAYC,EAA2BjB,GAAK,MAAM,EAAE,UAAO,CAAC;CAE1E,OAAOE,QAAc;EACnB,IAAMgB,IAAQjC,EAAwBK,GAAOD,GAAUD,CAAiB,GAGlE+B,IAAYT,EAAY,QAC3B,MAAOrB,EAAS,SAASO,CAAE,KAAK,CAACiB,EAAY,SAASjB,CAAE,CAC3D,GACMwB,KAAiB,MAAeD,EAAU,SAASvB,CAAE,GAGrDyB,IAAgBhC,EAAS,QAC5B,MAAO,CAAC+B,EAAcxB,CAAE,KAAK,CAACiB,EAAY,SAASjB,CAAE,CACxD,GACM0B,IAAmBX,EAAU,OAAOS,CAAa,GACjDG,IAAmBT,IACrBK,EAAU,QACP,MAAO,CAACP,EAAc,SAAShB,CAAE,KAAK,CAACe,EAAU,SAASf,CAAE,CAC/D,IACA,CAAC,GACC4B,oBAAW,IAAI,IAAI,CAAC,GAAGF,GAAkB,GAAGC,CAAgB,CAAC,GAE7DE,KAAY,MAChBT,GAAU,MACRU,EAAIzC,EAAwB0C,GAAOtC,GAAUD,CAAiB,CAAC,CACjE,GACIwC,KAAgB,MACpB,OAAO,YAAYT,EAAU,KAAK,MAAO,CAACvB,GAAIiC,EAAE,QAAQ,SAASjC,CAAE,CAAC,CAAC,CAAC,GAClEkC,IAA4C;GAChD,GAAG,OAAO,YAAYT,EAAc,KAAK,MAAO,CAACzB,GAAI,EAAK,CAAC,CAAC;GAC5D,GAAGgC,EAAaV,CAAK;GACrB,GAAG,OAAO,YAAYK,EAAiB,KAAK,MAAO,CAAC3B,GAAI,EAAK,CAAC,CAAC;GAC/D,GAAG,OAAO,YAAY0B,EAAiB,KAAK,MAAO,CAAC1B,GAAI,EAAI,CAAC,CAAC;EAChE,GACMmC,KAAW,MAAqC,CACpD,GAAGlB,GACH,GAAGgB,EAAE,MAAM,OAAOT,CAAa,CACjC;EAEA,OAAO;GACL,OAAOF,EAAM;GACb,UAAUA,EAAM;GAChB,WAAW,MACTO,GAAU,OAAO;IACf,GAAGI;IACH,SAASA,EAAE,QAAQ,SAASjC,CAAE,IAC1BiC,EAAE,QAAQ,QAAQ,MAAMG,MAAMpC,CAAE,IAChC,CAAC,GAAGiC,EAAE,SAASjC,CAAE;GACvB,EAAE;GAGJ,qBAAqBoB,EAAS,IAAI;GAClC,gBAAgB;IACd,oBAAoBc;IAIpB,6BAA6B,MAC3BL,GAAU,MAAM;KACd,IAAME,IAAQC,EAAaC,CAAC,GACtBI,IAAWC,EAAiBR,GAAKC,CAAK,GACtCQ,KAAU,MACdX,EAAS,IAAI5B,CAAE,IAAI+B,EAAM/B,KAAMqC,EAASrC,OAAQ;KAClD,OAAO;MACL,GAAGiC;MACH,SAAS,CACP,GAAGA,EAAE,QAAQ,QAAQ,MAAO,CAACT,EAAcxB,CAAE,CAAC,GAC9C,GAAGuB,EAAU,OAAOgB,CAAM,CAC5B;KACF;IACF,CAAC;IACH,eAAeJ,EAAQb,CAAK;IAG5B,wBAAwB,MACtBO,GAAU,OAAO;KACf,GAAGI;KACH,OAAOO,EACLP,EAAE,OACFT,GACAc,EAAiBR,GAAKK,EAAQF,CAAC,CAAC,CAClC;IACF,EAAE;IACJ,mBAAmBf,IACf,CAAC,IACDK,EAAU,QAAQ,MAAO,CAACK,EAAS,IAAI5B,CAAE,CAAC;GAChD;EACF;CACF,GAAG;EACDN;EACA0B;EACA3B;EACAD;EACAsB;EACAC;EACAC;EACAE;EACAD;CACF,CAAC;AACH"}
@@ -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,90 @@
1
+ import { SensTri } from '../components/etic/use-server-sorting';
2
+ export interface UseListUrlStateOptions<K extends string> {
3
+ /** Paramètres de l'URL courante (`useSearchParams()[0]` de react-router). */
4
+ params: URLSearchParams;
5
+ /**
6
+ * Remplace les paramètres de l'URL, **sans nouvelle entrée d'historique** :
7
+ * `(p) => setSearchParams(p, { replace: true })`. Peut être écrite en ligne.
8
+ */
9
+ onParamsChange: (params: URLSearchParams) => void;
10
+ /** Clés de tri acceptées (celles du serveur) : un `?tri=` inconnu ou
11
+ * périmé retombe sur le tri par défaut au lieu d'être envoyé. */
12
+ clesTri: readonly K[];
13
+ /** Tri par défaut, jamais écrit dans l'URL. */
14
+ tri: K;
15
+ sens: SensTri;
16
+ /** Nombre par page par défaut (25), jamais écrit dans l'URL. */
17
+ limite?: number;
18
+ /** Nombres par page acceptés (`LIMITES_PAGINATION` par défaut) : les
19
+ * mêmes que ceux de `DataTablePagination`. */
20
+ limites?: readonly number[];
21
+ /** Paramètres de vue (élément ouvert dans un tiroir…) : ni filtres ni
22
+ * disposition, une réinitialisation des filtres les garde. */
23
+ vue?: readonly string[];
24
+ }
25
+ export interface UseListUrlStateResultat<K extends string> {
26
+ /** Rang du premier élément de la page (`offset`). */
27
+ decalage: number;
28
+ /** Nombre d'éléments par page (`limit`). */
29
+ limite: number;
30
+ tri: K;
31
+ sens: SensTri;
32
+ /** Valeur d'un filtre, `""` s'il est absent. */
33
+ filtre: (cle: string) => string;
34
+ /** Nombre de filtres posés, recherche comprise (`filtresActifs` de
35
+ * `DataTableToolbar`). */
36
+ filtresActifs: number;
37
+ /** Saisie du champ de recherche, recopiée dans l'URL (`?recherche=`)
38
+ * après une pause de frappe. */
39
+ recherche: string;
40
+ saisirRecherche: (valeur: string) => void;
41
+ definirDecalage: (decalage: number) => void;
42
+ definirLimite: (limite: number) => void;
43
+ /** `null` : retour au tri par défaut. */
44
+ definirTri: (tri: K | null, sens: SensTri) => void;
45
+ /** Pose un filtre ; une valeur vide le retire. */
46
+ definirFiltre: (cle: string, valeur: string) => void;
47
+ /** Pose ou retire (`null`) un paramètre de vue ; garde la page. */
48
+ definirVue: (cle: string, valeur: string | null) => void;
49
+ /** Retire les filtres et la recherche, garde la disposition et la vue. */
50
+ reinitialiserFiltres: () => void;
51
+ }
52
+ /**
53
+ * État d'une liste paginée gardé dans l'URL : page (`offset`), taille
54
+ * (`limit`), tri (`tri`, `sens`), recherche (`recherche`) et filtres. Ouvrir
55
+ * un élément puis revenir en arrière retrouve la liste telle qu'on l'a
56
+ * laissée ; un lien ou un rechargement aussi. Seuls les écarts aux valeurs
57
+ * par défaut sont écrits.
58
+ *
59
+ * Chaque réglage **remplace** l'entrée d'historique courante : le retour
60
+ * arrière quitte la liste au lieu de défaire les filtres un à un. Tout
61
+ * changement de filtre, de recherche, de tri ou de taille ramène en première
62
+ * page (rester au décalage 50 d'un résultat de trois lignes afficherait une
63
+ * page vide) ; la pagination et la vue la gardent.
64
+ *
65
+ * Indépendant du routeur : il lit `params` et écrit par `onParamsChange`.
66
+ * Les fonctions rendues sont stables et partent de l'URL **demandée en
67
+ * dernier**, pas de celle du dernier rendu : deux réglages dans le même
68
+ * geste s'additionnent. `clesTri` et `limites` doivent être stables (des
69
+ * constantes de module).
70
+ *
71
+ * ```tsx
72
+ * const [params, setParams] = useSearchParams()
73
+ * const liste = useListUrlState({
74
+ * params,
75
+ * onParamsChange: (p) => setParams(p, { replace: true }),
76
+ * clesTri: CLES_TRI, tri: "nom", sens: "asc",
77
+ * })
78
+ * const table = useDataTable({ …, ...useServerSorting(liste) })
79
+ * const page = useServerPagination({
80
+ * decalage: liste.decalage, limite: liste.limite,
81
+ * onDecalageChange: liste.definirDecalage,
82
+ * onLimiteChange: liste.definirLimite, requete,
83
+ * })
84
+ * <DataTableToolbar
85
+ * recherche={{ valeur: liste.recherche, onValeurChange: liste.saisirRecherche }}
86
+ * filtresActifs={liste.filtresActifs}
87
+ * onReinitialiser={liste.reinitialiserFiltres} … />
88
+ * ```
89
+ */
90
+ export declare function useListUrlState<K extends string>({ params, onParamsChange, clesTri, tri: triDefaut, sens: sensDefaut, limite: limiteDefaut, limites, vue, }: UseListUrlStateOptions<K>): UseListUrlStateResultat<K>;
@@ -0,0 +1,71 @@
1
+ import { LIMITES_PAGINATION as e } from "../components/etic/data-table-pagination.js";
2
+ import { useDebouncedSearch as t } from "./use-debounced-search.js";
3
+ import { useCallback as n, useLayoutEffect as r, useMemo as i, useRef as a } from "react";
4
+ // src/hooks/use-list-url-state.ts
5
+ var o = /* @__PURE__ */ new Set([
6
+ "offset",
7
+ "limit",
8
+ "tri",
9
+ "sens"
10
+ ]), s = "recherche";
11
+ function c({ params: c, onParamsChange: l, clesTri: u, tri: d, sens: f, limite: p = 25, limites: m = e, vue: h = [] }) {
12
+ let g = h.join("\n"), _ = c.get("tri"), v = c.get("sens"), y = u.includes(_) ? _ : d, b = v === "asc" || v === "desc" ? v : f, x = Number(c.get("limit")), S = m.includes(x) ? x : p, C = Math.trunc(Number(c.get("offset"))), w = Number.isFinite(C) ? Math.max(0, C) : 0, T = a(c), E = a(l);
13
+ r(() => {
14
+ T.current = c;
15
+ }, [c]), r(() => {
16
+ E.current = l;
17
+ });
18
+ let D = n((e, t = !1) => {
19
+ let n = new URLSearchParams(T.current);
20
+ e(n), t || n.delete("offset"), n.toString() !== T.current.toString() && (T.current = n, E.current(n));
21
+ }, []), O = n((e) => D((t) => {
22
+ e > 0 ? t.set("offset", String(e)) : t.delete("offset");
23
+ }, !0), [D]), k = n((e) => D((t) => {
24
+ e === p ? t.delete("limit") : t.set("limit", String(e));
25
+ }), [D, p]), A = n((e, t) => D((n) => {
26
+ e === null || e === d && t === f ? (n.delete("tri"), n.delete("sens")) : (n.set("tri", e), n.set("sens", t));
27
+ }), [
28
+ D,
29
+ d,
30
+ f
31
+ ]), j = n((e, t) => D((n) => {
32
+ t === "" ? n.delete(e) : n.set(e, t);
33
+ }), [D]), M = n((e, t) => D((n) => {
34
+ t === null ? n.delete(e) : n.set(e, t);
35
+ }, !0), [D]), N = n((e) => j(s, e), [j]), [P, F] = t(c.get(s) ?? "", N), I = n(() => {
36
+ F(""), D((e) => {
37
+ let t = g.split("\n");
38
+ for (let n of [...e.keys()]) !o.has(n) && !t.includes(n) && e.delete(n);
39
+ });
40
+ }, [
41
+ D,
42
+ g,
43
+ F
44
+ ]);
45
+ return {
46
+ decalage: w,
47
+ limite: S,
48
+ tri: y,
49
+ sens: b,
50
+ filtre: n((e) => c.get(e) ?? "", [c]),
51
+ filtresActifs: i(() => {
52
+ let e = g.split("\n");
53
+ return new Set([...c.keys()].filter((t) => t !== s && !o.has(t) && !e.includes(t))).size + +!!P.trim();
54
+ }, [
55
+ c,
56
+ g,
57
+ P
58
+ ]),
59
+ recherche: P,
60
+ saisirRecherche: F,
61
+ definirDecalage: O,
62
+ definirLimite: k,
63
+ definirTri: A,
64
+ definirFiltre: j,
65
+ definirVue: M,
66
+ reinitialiserFiltres: I
67
+ };
68
+ }
69
+ export { c as useListUrlState };
70
+
71
+ //# sourceMappingURL=use-list-url-state.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-list-url-state.js","names":["CLES_DISPOSITION","RECHERCHE","useListUrlState","triDefaut","sensDefaut","limiteDefaut","LIMITES_PAGINATION","clesVue","vue","triLu","params","sensLu","tri","clesTri","sens","limiteLue","limite","limites","decalageLu","decalage","courante","useRef","ecrire","onParamsChange","useLayoutEffect","modifier","useCallback","suivant","transformer","garderPage","definirDecalage","valeur","definirLimite","definirTri","cle","sensDemande","definirFiltre","definirVue","rechercher","recherche","saisirRecherche","useDebouncedSearch","reinitialiserFiltres","gardees","useMemo"],"sources":["../../src/hooks/use-list-url-state.ts"],"sourcesContent":["import { useCallback, useLayoutEffect, useMemo, useRef } from \"react\"\n\nimport { LIMITES_PAGINATION } from \"@etic-ui/components/etic/data-table-pagination\"\nimport type { SensTri } from \"@etic-ui/components/etic/use-server-sorting\"\nimport { useDebouncedSearch } from \"@etic-ui/hooks/use-debounced-search\"\n\n/** Paramètres d'URL de la disposition d'une liste (page, taille, tri) : une\n * réinitialisation des filtres les garde. */\nconst CLES_DISPOSITION = new Set([\"offset\", \"limit\", \"tri\", \"sens\"])\n\n/** Paramètre de la recherche libre. */\nconst RECHERCHE = \"recherche\"\n\nexport interface UseListUrlStateOptions<K extends string> {\n /** Paramètres de l'URL courante (`useSearchParams()[0]` de react-router). */\n params: URLSearchParams\n /**\n * Remplace les paramètres de l'URL, **sans nouvelle entrée d'historique** :\n * `(p) => setSearchParams(p, { replace: true })`. Peut être écrite en ligne.\n */\n onParamsChange: (params: URLSearchParams) => void\n /** Clés de tri acceptées (celles du serveur) : un `?tri=` inconnu ou\n * périmé retombe sur le tri par défaut au lieu d'être envoyé. */\n clesTri: readonly K[]\n /** Tri par défaut, jamais écrit dans l'URL. */\n tri: K\n sens: SensTri\n /** Nombre par page par défaut (25), jamais écrit dans l'URL. */\n limite?: number\n /** Nombres par page acceptés (`LIMITES_PAGINATION` par défaut) : les\n * mêmes que ceux de `DataTablePagination`. */\n limites?: readonly number[]\n /** Paramètres de vue (élément ouvert dans un tiroir…) : ni filtres ni\n * disposition, une réinitialisation des filtres les garde. */\n vue?: readonly string[]\n}\n\nexport interface UseListUrlStateResultat<K extends string> {\n /** Rang du premier élément de la page (`offset`). */\n decalage: number\n /** Nombre d'éléments par page (`limit`). */\n limite: number\n tri: K\n sens: SensTri\n /** Valeur d'un filtre, `\"\"` s'il est absent. */\n filtre: (cle: string) => string\n /** Nombre de filtres posés, recherche comprise (`filtresActifs` de\n * `DataTableToolbar`). */\n filtresActifs: number\n /** Saisie du champ de recherche, recopiée dans l'URL (`?recherche=`)\n * après une pause de frappe. */\n recherche: string\n saisirRecherche: (valeur: string) => void\n definirDecalage: (decalage: number) => void\n definirLimite: (limite: number) => void\n /** `null` : retour au tri par défaut. */\n definirTri: (tri: K | null, sens: SensTri) => void\n /** Pose un filtre ; une valeur vide le retire. */\n definirFiltre: (cle: string, valeur: string) => void\n /** Pose ou retire (`null`) un paramètre de vue ; garde la page. */\n definirVue: (cle: string, valeur: string | null) => void\n /** Retire les filtres et la recherche, garde la disposition et la vue. */\n reinitialiserFiltres: () => void\n}\n\n/**\n * État d'une liste paginée gardé dans l'URL : page (`offset`), taille\n * (`limit`), tri (`tri`, `sens`), recherche (`recherche`) et filtres. Ouvrir\n * un élément puis revenir en arrière retrouve la liste telle qu'on l'a\n * laissée ; un lien ou un rechargement aussi. Seuls les écarts aux valeurs\n * par défaut sont écrits.\n *\n * Chaque réglage **remplace** l'entrée d'historique courante : le retour\n * arrière quitte la liste au lieu de défaire les filtres un à un. Tout\n * changement de filtre, de recherche, de tri ou de taille ramène en première\n * page (rester au décalage 50 d'un résultat de trois lignes afficherait une\n * page vide) ; la pagination et la vue la gardent.\n *\n * Indépendant du routeur : il lit `params` et écrit par `onParamsChange`.\n * Les fonctions rendues sont stables et partent de l'URL **demandée en\n * dernier**, pas de celle du dernier rendu : deux réglages dans le même\n * geste s'additionnent. `clesTri` et `limites` doivent être stables (des\n * constantes de module).\n *\n * ```tsx\n * const [params, setParams] = useSearchParams()\n * const liste = useListUrlState({\n * params,\n * onParamsChange: (p) => setParams(p, { replace: true }),\n * clesTri: CLES_TRI, tri: \"nom\", sens: \"asc\",\n * })\n * const table = useDataTable({ …, ...useServerSorting(liste) })\n * const page = useServerPagination({\n * decalage: liste.decalage, limite: liste.limite,\n * onDecalageChange: liste.definirDecalage,\n * onLimiteChange: liste.definirLimite, requete,\n * })\n * <DataTableToolbar\n * recherche={{ valeur: liste.recherche, onValeurChange: liste.saisirRecherche }}\n * filtresActifs={liste.filtresActifs}\n * onReinitialiser={liste.reinitialiserFiltres} … />\n * ```\n */\nexport function useListUrlState<K extends string>({\n params,\n onParamsChange,\n clesTri,\n tri: triDefaut,\n sens: sensDefaut,\n limite: limiteDefaut = 25,\n limites = LIMITES_PAGINATION,\n vue = [],\n}: UseListUrlStateOptions<K>): UseListUrlStateResultat<K> {\n // Clé de dépendance : `vue` est souvent écrite en ligne.\n const clesVue = vue.join(\"\\n\")\n\n const triLu = params.get(\"tri\")\n const sensLu = params.get(\"sens\")\n const tri = clesTri.includes(triLu as K) ? (triLu as K) : triDefaut\n const sens: SensTri =\n sensLu === \"asc\" || sensLu === \"desc\" ? sensLu : sensDefaut\n const limiteLue = Number(params.get(\"limit\"))\n const limite = limites.includes(limiteLue) ? limiteLue : limiteDefaut\n const decalageLu = Math.trunc(Number(params.get(\"offset\")))\n const decalage = Number.isFinite(decalageLu) ? Math.max(0, decalageLu) : 0\n\n // L'URL que le prochain réglage prolonge : celle du rendu, ou celle qu'un\n // réglage vient de demander et que le routeur n'a pas encore rendue.\n const courante = useRef(params)\n const ecrire = useRef(onParamsChange)\n useLayoutEffect(() => {\n courante.current = params\n }, [params])\n useLayoutEffect(() => {\n ecrire.current = onParamsChange\n })\n\n const modifier = useCallback(\n (transformer: (suivant: URLSearchParams) => void, garderPage = false) => {\n const suivant = new URLSearchParams(courante.current)\n transformer(suivant)\n if (!garderPage) suivant.delete(\"offset\")\n if (suivant.toString() === courante.current.toString()) return\n courante.current = suivant\n ecrire.current(suivant)\n },\n []\n )\n\n const definirDecalage = useCallback(\n (valeur: number) =>\n modifier((suivant) => {\n if (valeur > 0) suivant.set(\"offset\", String(valeur))\n else suivant.delete(\"offset\")\n }, true),\n [modifier]\n )\n\n const definirLimite = useCallback(\n (valeur: number) =>\n modifier((suivant) => {\n if (valeur === limiteDefaut) suivant.delete(\"limit\")\n else suivant.set(\"limit\", String(valeur))\n }),\n [modifier, limiteDefaut]\n )\n\n const definirTri = useCallback(\n (cle: K | null, sensDemande: SensTri) =>\n modifier((suivant) => {\n if (cle === null || (cle === triDefaut && sensDemande === sensDefaut)) {\n suivant.delete(\"tri\")\n suivant.delete(\"sens\")\n } else {\n suivant.set(\"tri\", cle)\n suivant.set(\"sens\", sensDemande)\n }\n }),\n [modifier, triDefaut, sensDefaut]\n )\n\n const definirFiltre = useCallback(\n (cle: string, valeur: string) =>\n modifier((suivant) => {\n if (valeur === \"\") suivant.delete(cle)\n else suivant.set(cle, valeur)\n }),\n [modifier]\n )\n\n const definirVue = useCallback(\n (cle: string, valeur: string | null) =>\n modifier((suivant) => {\n if (valeur === null) suivant.delete(cle)\n else suivant.set(cle, valeur)\n }, true),\n [modifier]\n )\n\n const rechercher = useCallback(\n (valeur: string) => definirFiltre(RECHERCHE, valeur),\n [definirFiltre]\n )\n const [recherche, saisirRecherche] = useDebouncedSearch(\n params.get(RECHERCHE) ?? \"\",\n rechercher\n )\n\n const reinitialiserFiltres = useCallback(() => {\n saisirRecherche(\"\")\n modifier((suivant) => {\n const gardees = clesVue.split(\"\\n\")\n for (const cle of [...suivant.keys()]) {\n if (!CLES_DISPOSITION.has(cle) && !gardees.includes(cle))\n suivant.delete(cle)\n }\n })\n }, [modifier, clesVue, saisirRecherche])\n\n const filtre = useCallback((cle: string) => params.get(cle) ?? \"\", [params])\n\n // La recherche compte dès la frappe, pas seulement une fois recopiée.\n const filtresActifs = useMemo(() => {\n const gardees = clesVue.split(\"\\n\")\n const cles = new Set(\n [...params.keys()].filter(\n (cle) =>\n cle !== RECHERCHE &&\n !CLES_DISPOSITION.has(cle) &&\n !gardees.includes(cle)\n )\n )\n return cles.size + (recherche.trim() ? 1 : 0)\n }, [params, clesVue, recherche])\n\n return {\n decalage,\n limite,\n tri,\n sens,\n filtre,\n filtresActifs,\n recherche,\n saisirRecherche,\n definirDecalage,\n definirLimite,\n definirTri,\n definirFiltre,\n definirVue,\n reinitialiserFiltres,\n }\n}\n"],"mappings":"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"}
@@ -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>;
@@ -0,0 +1,49 @@
1
+ import { useCallback as e, useState as t } from "react";
2
+ // src/hooks/use-save-by-key.ts
3
+ function n() {
4
+ let [n, r] = t({}), [i, a] = t(null), [o, s] = t(!1), [c, l] = t(!1);
5
+ async function u(e, t, n) {
6
+ s(!0), a(null), l(!1);
7
+ let i = {}, o = null;
8
+ try {
9
+ for (let r of e) try {
10
+ await t(r);
11
+ } catch (e) {
12
+ let t = n(e);
13
+ if (t === null) {
14
+ o = e;
15
+ break;
16
+ }
17
+ i[r.cle] = t;
18
+ }
19
+ } catch (e) {
20
+ o = e;
21
+ } finally {
22
+ r(i), a(o), s(!1), l(o === null && Object.keys(i).length === 0);
23
+ }
24
+ }
25
+ let d = e((e) => {
26
+ r((t) => {
27
+ if (!(e in t)) return t;
28
+ let n = { ...t };
29
+ return delete n[e], n;
30
+ });
31
+ }, []);
32
+ return {
33
+ refus: n,
34
+ panne: i,
35
+ enCours: o,
36
+ enregistre: c,
37
+ enregistrer: u,
38
+ saisieChangee: e((e) => {
39
+ l(!1), d(e);
40
+ }, [d]),
41
+ oublierRefus: d,
42
+ oublierTout: e(() => {
43
+ r({}), a(null);
44
+ }, [])
45
+ };
46
+ }
47
+ export { n as useSaveByKey };
48
+
49
+ //# sourceMappingURL=use-save-by-key.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-save-by-key.js","names":["useSaveByKey","refus","setRefus","useState","panne","setPanne","enCours","setEnCours","enregistre","setEnregistre","enregistrer","refuses","echec","envoi","envois","envoyer","erreur","motif","refusDe","oublierRefus","useCallback","cle","avant","reste"],"sources":["../../src/hooks/use-save-by-key.ts"],"sourcesContent":["import { useCallback, useState } from \"react\"\n\nexport interface SaveByKeyEtat<R> {\n /** Le refus de chaque clé refusée, à afficher sous son champ. */\n refus: Readonly<Record<string, R>>\n /** La panne qui a arrêté l'enregistrement (bandeau), ou `null`. */\n panne: unknown\n enCours: boolean\n /** Tout est parti sans refus ni panne (« Enregistré »). */\n enregistre: boolean\n /**\n * Envoie chaque élément, dans l'ordre. `refusDe` lit le refus d'une\n * saisie (une erreur de validation), ou rend `null` pour une panne, qui\n * arrête l'enregistrement.\n */\n enregistrer: <E extends { cle: string }>(\n envois: readonly E[],\n envoyer: (envoi: E) => Promise<unknown>,\n refusDe: (erreur: unknown) => R | null\n ) => Promise<void>\n /** Une saisie change : son refus visait la précédente, et « Enregistré »\n * ne vaut plus. Stable. */\n saisieChangee: (cle: string) => void\n /** Retire le refus d'une clé. Stable. */\n oublierRefus: (cle: string) => void\n /** « Annuler » : refus et panne disparaissent avec la saisie. Stable. */\n oublierTout: () => void\n}\n\n/**\n * L'enregistrement d'un formulaire de réglages dont chaque valeur part\n * seule (une requête par clé) : les clés modifiées partent l'une après\n * l'autre. Un refus de la saisie reste sous son champ et les suivantes\n * partent quand même ; une panne (réseau, serveur) arrête l'enregistrement\n * et s'affiche en bandeau. `R` : ce que le champ refusé affiche (l'erreur,\n * ou son message).\n *\n * ```tsx\n * const sauvegarde = useSaveByKey<string>()\n * await sauvegarde.enregistrer(\n * modifiees, // [{ cle: \"delai\", valeur: 30 }, …]\n * ({ cle, valeur }) => api.reglages.ecrire(cle, valeur),\n * (erreur) => (estRefusDeSaisie(erreur) ? erreur.message : null)\n * )\n * <FormField erreur={sauvegarde.refus.delai} …>\n * <ErrorBanner erreur={sauvegarde.panne} />\n * <SaveBar enCours={sauvegarde.enCours} enregistre={sauvegarde.enregistre} … />\n * ```\n */\nexport function useSaveByKey<R>(): SaveByKeyEtat<R> {\n const [refus, setRefus] = useState<Readonly<Record<string, R>>>({})\n const [panne, setPanne] = useState<unknown>(null)\n const [enCours, setEnCours] = useState(false)\n const [enregistre, setEnregistre] = useState(false)\n\n async function enregistrer<E extends { cle: string }>(\n envois: readonly E[],\n envoyer: (envoi: E) => Promise<unknown>,\n refusDe: (erreur: unknown) => R | null\n ) {\n setEnCours(true)\n setPanne(null)\n setEnregistre(false)\n const refuses: Record<string, R> = {}\n let echec: unknown = null\n try {\n for (const envoi of envois) {\n try {\n await envoyer(envoi)\n } catch (erreur) {\n const motif = refusDe(erreur)\n if (motif === null) {\n echec = erreur\n break\n }\n refuses[envoi.cle] = motif\n }\n }\n } catch (erreur) {\n // Une lecture du refus qui lève : une panne, pas un formulaire\n // bloqué « en cours ».\n echec = erreur\n } finally {\n setRefus(refuses)\n setPanne(echec)\n setEnCours(false)\n setEnregistre(echec === null && Object.keys(refuses).length === 0)\n }\n }\n\n const oublierRefus = useCallback((cle: string) => {\n setRefus((avant) => {\n if (!(cle in avant)) return avant\n const reste = { ...avant }\n delete reste[cle]\n return reste\n })\n }, [])\n\n const saisieChangee = useCallback(\n (cle: string) => {\n setEnregistre(false)\n oublierRefus(cle)\n },\n [oublierRefus]\n )\n\n const oublierTout = useCallback(() => {\n setRefus({})\n setPanne(null)\n }, [])\n\n return {\n refus,\n panne,\n enCours,\n enregistre,\n enregistrer,\n saisieChangee,\n oublierRefus,\n oublierTout,\n }\n}\n"],"mappings":";;AAiDA,SAAgBA,IAAoC;CAClD,IAAM,CAACC,GAAOC,KAAYC,EAAsC,CAAC,CAAC,GAC5D,CAACC,GAAOC,KAAYF,EAAkB,IAAI,GAC1C,CAACG,GAASC,KAAcJ,EAAS,EAAK,GACtC,CAACK,GAAYC,KAAiBN,EAAS,EAAK;CAElD,eAAeO,EACb,GACA,GACA,GACA;EAGA,AAFAH,EAAW,EAAI,GACfF,EAAS,IAAI,GACbI,EAAc,EAAK;EACnB,IAAME,IAA6B,CAAC,GAChCC,IAAiB;EACrB,IAAI;GACF,KAAK,IAAMC,KAASC,GAClB,IAAI;IACF,MAAMC,EAAQF,CAAK;GACrB,SAASG,GAAQ;IACf,IAAMC,IAAQC,EAAQF,CAAM;IAC5B,IAAIC,MAAU,MAAM;KAClB,IAAQD;KACR;IACF;IACA,EAAQH,EAAM,OAAOI;GACvB;EAEJ,SAASD,GAAQ;GAGf,IAAQA;EACV,UAAU;GAIR,AAHAd,EAASS,CAAO,GAChBN,EAASO,CAAK,GACdL,EAAW,EAAK,GAChBE,EAAcG,MAAU,QAAQ,OAAO,KAAKD,CAAO,CAAC,CAAC,WAAW,CAAC;EACnE;CACF;CAEA,IAAMQ,IAAeC,GAAa,MAAgB;EAChD,GAAU,MAAU;GAClB,IAAI,EAAEC,KAAOC,IAAQ,OAAOA;GAC5B,IAAMC,IAAQ,EAAE,GAAGD,EAAM;GAEzB,OADA,OAAOC,EAAMF,IACNE;EACT,CAAC;CACH,GAAG,CAAC,CAAC;CAeL,OAAO;EACL;EACA;EACA;EACA;EACA;EACA,eAnBoBH,GACnB,MAAgB;GAEf,AADAX,EAAc,EAAK,GACnBU,EAAaE,CAAG;EAClB,GACA,CAACF,CAAY,CAcb;EACA;EACA,aAbkBC,QAAkB;GAEpC,AADAlB,EAAS,CAAC,CAAC,GACXG,EAAS,IAAI;EACf,GAAG,CAAC,CAUF;CACF;AACF"}