@etic-insa/ui 0.5.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.
- package/README.md +323 -62
- package/dist/charts/index.d.ts +1 -0
- package/dist/charts/index.js +1 -0
- package/dist/components/etic/app-shell.d.ts +10 -0
- package/dist/components/etic/app-shell.js +144 -117
- package/dist/components/etic/app-shell.js.map +1 -1
- package/dist/components/etic/code-block.d.ts +15 -0
- package/dist/components/etic/code-block.js +21 -0
- package/dist/components/etic/code-block.js.map +1 -0
- package/dist/components/etic/data-table-toolbar.d.ts +12 -1
- package/dist/components/etic/data-table-toolbar.js +50 -39
- package/dist/components/etic/data-table-toolbar.js.map +1 -1
- package/dist/components/etic/data-table-view-options.d.ts +2 -1
- package/dist/components/etic/data-table-view-options.js +1 -1
- package/dist/components/etic/data-table-view-options.js.map +1 -1
- package/dist/components/etic/detail-meta.d.ts +28 -0
- package/dist/components/etic/detail-meta.js +51 -0
- package/dist/components/etic/detail-meta.js.map +1 -0
- package/dist/components/etic/detail-sheet.d.ts +36 -0
- package/dist/components/etic/detail-sheet.js +37 -0
- package/dist/components/etic/detail-sheet.js.map +1 -0
- package/dist/components/etic/empty-state.d.ts +15 -0
- package/dist/components/etic/empty-state.js +24 -12
- package/dist/components/etic/empty-state.js.map +1 -1
- package/dist/components/etic/error-banner.js +8 -5
- package/dist/components/etic/error-banner.js.map +1 -1
- package/dist/components/etic/external-link.d.ts +40 -0
- package/dist/components/etic/external-link.js +47 -0
- package/dist/components/etic/external-link.js.map +1 -0
- package/dist/components/etic/file-upload.d.ts +19 -0
- package/dist/components/etic/file-upload.js +24 -1
- package/dist/components/etic/file-upload.js.map +1 -1
- package/dist/components/etic/form-field.d.ts +10 -1
- package/dist/components/etic/form-field.js +32 -28
- package/dist/components/etic/form-field.js.map +1 -1
- package/dist/components/etic/nav-tabs.d.ts +27 -0
- package/dist/components/etic/nav-tabs.js +22 -0
- package/dist/components/etic/nav-tabs.js.map +1 -0
- package/dist/components/etic/phone-input.d.ts +4 -3
- package/dist/components/etic/phone-input.js +51 -37
- package/dist/components/etic/phone-input.js.map +1 -1
- package/dist/components/etic/progress-ring.d.ts +23 -0
- package/dist/components/etic/progress-ring.js +46 -0
- package/dist/components/etic/progress-ring.js.map +1 -0
- package/dist/components/etic/reset-button.d.ts +37 -0
- package/dist/components/etic/reset-button.js +41 -0
- package/dist/components/etic/reset-button.js.map +1 -0
- package/dist/components/etic/save-bar.d.ts +20 -4
- package/dist/components/etic/save-bar.js +39 -24
- package/dist/components/etic/save-bar.js.map +1 -1
- package/dist/components/etic/select-field.d.ts +38 -0
- package/dist/components/etic/select-field.js +42 -0
- package/dist/components/etic/select-field.js.map +1 -0
- package/dist/components/etic/sub-section.d.ts +15 -0
- package/dist/components/etic/sub-section.js +23 -0
- package/dist/components/etic/sub-section.js.map +1 -0
- package/dist/components/etic/use-detail-sheet.d.ts +58 -0
- package/dist/components/etic/use-detail-sheet.js +35 -0
- package/dist/components/etic/use-detail-sheet.js.map +1 -0
- package/dist/components/etic/use-server-pagination.d.ts +55 -0
- package/dist/components/etic/use-server-pagination.js +31 -0
- package/dist/components/etic/use-server-pagination.js.map +1 -0
- package/dist/components/etic/use-server-sorting.d.ts +29 -0
- package/dist/components/etic/use-server-sorting.js +19 -0
- package/dist/components/etic/use-server-sorting.js.map +1 -0
- package/dist/components/etic/verdict-panel.d.ts +25 -0
- package/dist/components/etic/verdict-panel.js +42 -0
- package/dist/components/etic/verdict-panel.js.map +1 -0
- package/dist/components/ui/chart.d.ts +44 -0
- package/dist/components/ui/chart.js +131 -0
- package/dist/components/ui/chart.js.map +1 -0
- package/dist/components/ui/sheet.d.ts +20 -2
- package/dist/components/ui/sheet.js +21 -8
- package/dist/components/ui/sheet.js.map +1 -1
- package/dist/hooks/use-column-prefs.d.ts +25 -7
- package/dist/hooks/use-column-prefs.js +44 -35
- package/dist/hooks/use-column-prefs.js.map +1 -1
- package/dist/hooks/use-debounced-search.d.ts +29 -0
- package/dist/hooks/use-debounced-search.js +29 -0
- package/dist/hooks/use-debounced-search.js.map +1 -0
- package/dist/hooks/use-fresh-dialog.d.ts +33 -0
- package/dist/hooks/use-fresh-dialog.js +17 -0
- package/dist/hooks/use-fresh-dialog.js.map +1 -0
- package/dist/hooks/use-load-on-open.d.ts +23 -0
- package/dist/hooks/use-load-on-open.js +21 -0
- package/dist/hooks/use-load-on-open.js.map +1 -0
- package/dist/hooks/use-save-by-key.d.ts +45 -0
- package/dist/hooks/use-save-by-key.js +49 -0
- package/dist/hooks/use-save-by-key.js.map +1 -0
- package/dist/index.d.ts +21 -4
- package/dist/index.js +117 -100
- package/dist/lib/format.d.ts +31 -0
- package/dist/lib/format.js +53 -18
- package/dist/lib/format.js.map +1 -1
- package/dist/lib/ton.d.ts +7 -0
- package/dist/lib/ton.js +15 -0
- package/dist/lib/ton.js.map +1 -1
- package/package.json +10 -1
- package/vite-plugin.d.ts +3 -3
- package/vite-plugin.js +8 -2
|
@@ -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>;
|
|
@@ -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"}
|
package/dist/index.d.ts
CHANGED
|
@@ -1,10 +1,14 @@
|
|
|
1
1
|
export { cn } from './lib/utils';
|
|
2
2
|
export { MOBILE_MEDIA_QUERY, useIsMobile } from './hooks/use-mobile';
|
|
3
|
-
export { accorde, type AncienneteOptions, compte, formaterAnciennete, formaterDate, formaterDateHeure, formaterDateHeureLongue, formaterDuree, formaterDureeArrondie, formaterHorodatage, formaterOctets, nombreFr, participe, type Unite, uniteAccordee, } from './lib/format';
|
|
3
|
+
export { accorde, type AncienneteOptions, capitaliser, compte, formaterAnciennete, formaterDate, formaterDateHeure, formaterDateHeureLongue, formaterDuree, formaterDureeArrondie, formaterDureePrecise, formaterHeure, formaterHorodatage, formaterMontant, formaterNombre, formaterOctets, formaterPourcentage, initiales, nombreFr, participe, type Unite, uniteAccordee, } from './lib/format';
|
|
4
4
|
export { ecrireDateIso, lireDateIso } from './lib/dates';
|
|
5
5
|
export { comparerFr, correspondance, normaliser, normaliserRecherche, } from './lib/normalize';
|
|
6
6
|
export { NO_AUTOFILL } from './lib/autofill';
|
|
7
7
|
export { useDebouncedValue } from './hooks/use-debounced-value';
|
|
8
|
+
export { useDebouncedSearch, type UseDebouncedSearchOptions, } from './hooks/use-debounced-search';
|
|
9
|
+
export { type FreshDialogEtat, useFreshDialog } from './hooks/use-fresh-dialog';
|
|
10
|
+
export { type LectureAOuverture, useLoadOnOpen } from './hooks/use-load-on-open';
|
|
11
|
+
export { type SaveByKeyEtat, useSaveByKey } from './hooks/use-save-by-key';
|
|
8
12
|
export { useDocumentTitle } from './hooks/use-document-title';
|
|
9
13
|
export { Alert, AlertAction, AlertDescription, AlertTitle, } from './components/ui/alert';
|
|
10
14
|
export { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogMedia, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, } from './components/ui/alert-dialog';
|
|
@@ -35,7 +39,7 @@ export { RadioGroup, RadioGroupItem } from './components/ui/radio-group';
|
|
|
35
39
|
export { ScrollArea, ScrollBar } from './components/ui/scroll-area';
|
|
36
40
|
export { Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, } from './components/ui/select';
|
|
37
41
|
export { Separator } from './components/ui/separator';
|
|
38
|
-
export { Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, } from './components/ui/sheet';
|
|
42
|
+
export { Sheet, SheetBody, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, type SheetTaille, SheetTitle, SheetTrigger, } from './components/ui/sheet';
|
|
39
43
|
export { Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, useSidebar, } from './components/ui/sidebar';
|
|
40
44
|
export { Skeleton } from './components/ui/skeleton';
|
|
41
45
|
export { Slider } from './components/ui/slider';
|
|
@@ -48,6 +52,7 @@ export { Toggle, toggleVariants } from './components/ui/toggle';
|
|
|
48
52
|
export { ToggleGroup, ToggleGroupItem } from './components/ui/toggle-group';
|
|
49
53
|
export { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, } from './components/ui/tooltip';
|
|
50
54
|
export { AppShell, type AppShellCompte, type AppShellEntreeCompte, type AppShellLien, type AppShellLienComposant, type AppShellProps, type AppShellSection, } from './components/etic/app-shell';
|
|
55
|
+
export { NavTabs, type NavTabsLien, type NavTabsProps, } from './components/etic/nav-tabs';
|
|
51
56
|
export { type LienComposant, LienProvider, type LienProviderProps, useLien, } from './components/etic/lien';
|
|
52
57
|
export { ThemeMenu, type ThemeMenuProps } from './components/etic/theme-menu';
|
|
53
58
|
export { appliquerTheme, useThemeApplique } from './theme';
|
|
@@ -56,31 +61,40 @@ export type { ActionDialogue } from './components/etic/action';
|
|
|
56
61
|
export { fermerSaufEnCours } from './components/etic/action';
|
|
57
62
|
export { AuthAvatar, type AuthAvatarProps, AuthImage, type AuthImageCharger, type AuthImageProps, type AuthObjectUrlEtat, useAuthObjectUrl, useAuthObjectUrlEtat, } from './components/etic/auth-image';
|
|
58
63
|
export { ButtonLink, type ButtonLinkProps } from './components/etic/button-link';
|
|
64
|
+
export { DropdownMenuExternalLink, type DropdownMenuExternalLinkProps, ExternalLink, type ExternalLinkProps, } from './components/etic/external-link';
|
|
59
65
|
export { CenteredScreen, type CenteredScreenProps, MessageScreen, type MessageScreenProps, } from './components/etic/centered-screen';
|
|
60
66
|
export { ConfirmDialog, type ConfirmDialogProps, type ConfirmDialogSaisie, type ConfirmDialogTaille, type DialogFinalFocus, } from './components/etic/confirm-dialog';
|
|
61
67
|
export { CopyButton, type CopyButtonProps } from './components/etic/copy-button';
|
|
62
68
|
export { DeleteButton, type DeleteButtonProps, } from './components/etic/delete-button';
|
|
63
69
|
export { DetailItem, type DetailItemProps, DetailList, type DetailListProps, type DetailListDisposition, } from './components/etic/detail-list';
|
|
70
|
+
export { DetailSheet, type DetailSheetIntrouvable, type DetailSheetProps, } from './components/etic/detail-sheet';
|
|
71
|
+
export { useDetailSheet, type UseDetailSheetOptions, type UseDetailSheetResultat, } from './components/etic/use-detail-sheet';
|
|
64
72
|
export { Disclosure, type DisclosureProps, type DisclosureTaille, DisclosureTrigger, type DisclosureTriggerProps, type DisclosureVariante, } from './components/etic/disclosure';
|
|
65
73
|
export { DropdownMenuAction, type DropdownMenuActionProps, } from './components/etic/dropdown-menu-action';
|
|
66
74
|
export { DraftResumeDialog, type DraftResumeDialogProps, } from './components/etic/draft-resume-dialog';
|
|
67
|
-
export { EmptyState, type EmptyStateProps } from './components/etic/empty-state';
|
|
75
|
+
export { EmptyState, type EmptyStateProps, FilteredEmptyState, type FilteredEmptyStateProps, } from './components/etic/empty-state';
|
|
68
76
|
export { BoutonReessayer, type BoutonReessayerProps, decrireErreur, DetailTechnique, type ErreurDecrite, ErrorBanner, type ErrorBannerProps, ErrorBannerProvider, type ErrorBannerProviderProps, } from './components/etic/error-banner';
|
|
69
77
|
export { ErrorBoundary, type ErrorBoundaryProps, } from './components/etic/error-boundary';
|
|
70
78
|
export { FormDialog, type FormDialogActionSecondaire, type FormDialogProps, type FormDialogTaille, } from './components/etic/form-dialog';
|
|
71
79
|
export { IconToggle, type IconToggleProps } from './components/etic/icon-toggle';
|
|
72
80
|
export { Loading, type LoadingProps, SkeletonCard, type SkeletonCardProps, SkeletonPage, type SkeletonPageProps, SkeletonTable, type SkeletonTableProps, } from './components/etic/loading';
|
|
73
81
|
export { DetailHeader, type DetailHeaderActionSecondaire, type DetailHeaderEtape, type DetailHeaderProps, PageHeader, type PageHeaderProps, } from './components/etic/page-header';
|
|
82
|
+
export { DetailMeta, DetailMetaLink, type DetailMetaLinkProps, type DetailMetaProps, } from './components/etic/detail-meta';
|
|
74
83
|
export { PageContainer, type PageContainerLargeur, type PageContainerProps, } from './components/etic/page-container';
|
|
75
84
|
export { QueryBoundary, type QueryBoundaryProps, type QueryBoundaryRequete, QueryErrorBanner, type QueryErrorBannerProps, } from './components/etic/query-boundary';
|
|
76
85
|
export { SectionCard, type SectionCardProps, } from './components/etic/section-card';
|
|
86
|
+
export { SubSection, type SubSectionProps } from './components/etic/sub-section';
|
|
87
|
+
export { CodeBlock, type CodeBlockProps } from './components/etic/code-block';
|
|
77
88
|
export { StatTile, type StatTileProps } from './components/etic/stat-tile';
|
|
89
|
+
export { ProgressRing, type ProgressRingProps, } from './components/etic/progress-ring';
|
|
90
|
+
export { VerdictPanel, type VerdictPanelProps, } from './components/etic/verdict-panel';
|
|
78
91
|
export { type LongueurCss, StatGrid, type StatGridProps, } from './components/etic/stat-grid';
|
|
79
92
|
export { StatusBadge, type StatusBadgeProps, type StatusTon, } from './components/etic/status-badge';
|
|
80
93
|
export { RemovableBadge, type RemovableBadgeProps, } from './components/etic/removable-badge';
|
|
81
94
|
export { ExplainedBadge, type ExplainedBadgeProps, } from './components/etic/explained-badge';
|
|
82
95
|
export { Toggletip, type ToggletipProps } from './components/etic/toggletip';
|
|
83
96
|
export { SaveBar, type SaveBarProps } from './components/etic/save-bar';
|
|
97
|
+
export { ResetButton, type ResetButtonProps, } from './components/etic/reset-button';
|
|
84
98
|
export { TooltipButton, type TooltipButtonProps, } from './components/etic/tooltip-button';
|
|
85
99
|
export { type UnsavedChangesBlocage, UnsavedChangesDialog, type UnsavedChangesDialogProps, } from './components/etic/unsaved-changes';
|
|
86
100
|
export { useUnsavedChangesWarning } from './components/etic/use-unsaved-changes-warning';
|
|
@@ -88,7 +102,8 @@ export { FormField, type FormFieldControleProps, type FormFieldProps, FormSectio
|
|
|
88
102
|
export { type FormFieldContexte, useFormField, } from './components/etic/form-field-context';
|
|
89
103
|
export { DatePicker, type DatePickerDetails, type DatePickerProps, } from './components/etic/date-picker';
|
|
90
104
|
export { type CountryCode, formaterTelephone, PhoneInput, type PhoneInputDetails, type PhoneInputProps, } from './components/etic/phone-input';
|
|
91
|
-
export { FileDropZone, type FileDropZoneProps, type FileUploadAccept, FileUploadButton, type FileUploadButtonProps, type FileUploadOptions, } from './components/etic/file-upload';
|
|
105
|
+
export { FileDropZone, type FileDropZoneProps, type FileUploadAccept, FileUploadButton, type FileUploadButtonProps, type FileUploadOptions, SelectedFile, type SelectedFileProps, } from './components/etic/file-upload';
|
|
106
|
+
export { SelectField, type SelectFieldOption, type SelectFieldProps, } from './components/etic/select-field';
|
|
92
107
|
export { SegmentedControl, type SegmentedControlOption, type SegmentedControlProps, } from './components/etic/segmented-control';
|
|
93
108
|
export { CheckboxList, type CheckboxListOption, type CheckboxListProps, } from './components/etic/checkbox-list';
|
|
94
109
|
export { type DraftAutosave, type DraftAutosaveOptions, useDraftAutosave, } from './components/etic/use-draft-autosave';
|
|
@@ -102,4 +117,6 @@ export { DataTableCount, DataTableSelectFilter, DataTableToolbar, type DataTable
|
|
|
102
117
|
export { DataTableViewOptions, type DataTableViewOptionsProps, type DataTableViewOptionsColonne, type DataTableViewOptionsColonnesProps, type DataTableViewOptionsTableProps, } from './components/etic/data-table-view-options';
|
|
103
118
|
export { PorteeStockageLocal, usePersistedState, type PorteeStockageLocalProps, type UsePersistedStateOptions, } from './hooks/use-persisted-state';
|
|
104
119
|
export { useColumnPrefs, type ColumnPrefs, type ColumnPrefsOptionsTableau, type ColumnPrefsResultat, type UseColumnPrefsOptions, } from './hooks/use-column-prefs';
|
|
120
|
+
export { type ServerPageRequete, useServerPagination, type UseServerPaginationOptions, type UseServerPaginationResultat, } from './components/etic/use-server-pagination';
|
|
121
|
+
export { type SensTri, useServerSorting, type UseServerSortingOptions, type UseServerSortingResultat, } from './components/etic/use-server-sorting';
|
|
105
122
|
export type { ColumnOrderState, ColumnVisibilityState, ExpandedStateList, OnChangeFn, RowSelectionState, SortingState, ColumnFiltersState, PaginationState, } from '@tanstack/react-table';
|