@etic-insa/ui 0.7.0 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (55) hide show
  1. package/README.md +142 -62
  2. package/dist/components/etic/data-table-pagination.d.ts +4 -1
  3. package/dist/components/etic/data-table-pagination.js +39 -38
  4. package/dist/components/etic/data-table-pagination.js.map +1 -1
  5. package/dist/components/etic/data-table.d.ts +13 -2
  6. package/dist/components/etic/data-table.js +227 -213
  7. package/dist/components/etic/data-table.js.map +1 -1
  8. package/dist/components/etic/empty-value.d.ts +17 -0
  9. package/dist/components/etic/empty-value.js +20 -0
  10. package/dist/components/etic/empty-value.js.map +1 -0
  11. package/dist/components/etic/external-link.d.ts +5 -2
  12. package/dist/components/etic/external-link.js +7 -3
  13. package/dist/components/etic/external-link.js.map +1 -1
  14. package/dist/components/etic/form-field.d.ts +6 -6
  15. package/dist/components/etic/form-field.js +40 -38
  16. package/dist/components/etic/form-field.js.map +1 -1
  17. package/dist/components/etic/lien.d.ts +22 -0
  18. package/dist/components/etic/lien.js +10 -1
  19. package/dist/components/etic/lien.js.map +1 -1
  20. package/dist/components/etic/save-bar.d.ts +16 -0
  21. package/dist/components/etic/save-bar.js +4 -1
  22. package/dist/components/etic/save-bar.js.map +1 -1
  23. package/dist/components/etic/search-select.js +77 -76
  24. package/dist/components/etic/search-select.js.map +1 -1
  25. package/dist/components/etic/unit-input.d.ts +25 -0
  26. package/dist/components/etic/unit-input.js +21 -0
  27. package/dist/components/etic/unit-input.js.map +1 -0
  28. package/dist/components/etic/use-unsaved-changes-guard.d.ts +32 -0
  29. package/dist/components/etic/use-unsaved-changes-guard.js +25 -0
  30. package/dist/components/etic/use-unsaved-changes-guard.js.map +1 -0
  31. package/dist/hooks/use-debounced-search.d.ts +2 -1
  32. package/dist/hooks/use-debounced-search.js.map +1 -1
  33. package/dist/hooks/use-debounced-value.js +8 -7
  34. package/dist/hooks/use-debounced-value.js.map +1 -1
  35. package/dist/hooks/use-list-url-state.d.ts +90 -0
  36. package/dist/hooks/use-list-url-state.js +71 -0
  37. package/dist/hooks/use-list-url-state.js.map +1 -0
  38. package/dist/index.d.ts +10 -5
  39. package/dist/index.js +122 -117
  40. package/dist/lib/delai-frappe.d.ts +3 -0
  41. package/dist/lib/delai-frappe.js +15 -0
  42. package/dist/lib/delai-frappe.js.map +1 -0
  43. package/dist/lib/format.d.ts +20 -1
  44. package/dist/lib/format.js +33 -25
  45. package/dist/lib/format.js.map +1 -1
  46. package/dist/lib/grouper.d.ts +20 -0
  47. package/dist/lib/grouper.js +16 -0
  48. package/dist/lib/grouper.js.map +1 -0
  49. package/dist/testing/controles.d.ts +35 -0
  50. package/dist/testing/controles.js +33 -0
  51. package/dist/testing/controles.js.map +1 -0
  52. package/dist/testing/index.d.ts +8 -0
  53. package/dist/testing/index.js +21 -17
  54. package/dist/testing/index.js.map +1 -1
  55. package/package.json +9 -1
@@ -1 +1 @@
1
- {"version":3,"file":"data-table-pagination.js","names":["fenetre","pages","nombre","courante","p","a","b","sortie","precedente","page","DataTablePagination","props","PaginationParDecalage","reste","pagination","paginationDuTableau","table","avertirPaginationManuelle","suivant","limite","suivante","averti","idTaille","useId","nombrePages","total","decalage","tailles","limites","choixTaille","onLimiteChange","decalageMax","ramener","useEffectEvent","onDecalageChange","useEffect","ramenerAuDela","allerA","cible","cn","className","Select","valeur","changerTaille","SelectTrigger","SelectValue","SelectContent","SelectItem","taille","Pagination","PaginationContent","PaginationItem","Button","ChevronLeftIcon","PaginationEllipsis","i","ChevronRightIcon"],"sources":["../../../src/components/etic/data-table-pagination.tsx"],"sourcesContent":["import { useEffect, useEffectEvent, useId } from \"react\"\nimport type { RowData } from \"@tanstack/react-table\"\nimport { cn } from \"cn\"\nimport { ChevronLeftIcon, ChevronRightIcon } from \"lucide-react\"\n\nimport { Button } from \"@etic-ui/components/ui/button\"\nimport {\n Pagination,\n PaginationContent,\n PaginationEllipsis,\n PaginationItem,\n} from \"@etic-ui/components/ui/pagination\"\nimport {\n Select,\n SelectContent,\n SelectItem,\n SelectTrigger,\n SelectValue,\n} from \"@etic-ui/components/ui/select\"\nimport {\n paginationDuTableau,\n type DataTableInstance,\n} from \"@etic-ui/components/etic/data-table\"\n\n/** Fenêtre de pages : la première, la dernière, la courante et ses voisines,\n * « … » pour les pages sautées. Page 6 sur 20 : 1 … 5 6 7 … 20. */\nfunction fenetre(courante: number, nombre: number): (number | \"…\")[] {\n const pages = [...new Set([1, nombre, courante, courante - 1, courante + 1])]\n .filter((p) => p >= 1 && p <= nombre)\n .sort((a, b) => a - b)\n const sortie: (number | \"…\")[] = []\n let precedente = 0\n for (const page of pages) {\n if (page - precedente > 1) sortie.push(\"…\")\n sortie.push(page)\n precedente = page\n }\n return sortie\n}\n\ninterface DataTablePaginationCommun {\n /** Nombres d'éléments par page proposés. 10, 25, 50 et 100 par défaut. */\n limites?: readonly number[]\n className?: string\n}\n\n/** Pagination par décalage, aux nombres de l'application (côté serveur). */\nexport interface DataTablePaginationDecalageProps extends DataTablePaginationCommun {\n table?: never\n /** Nombre total d'éléments, toutes pages comprises. */\n total: number\n /** Rang (à partir de 0) du premier élément de la page. */\n decalage: number\n /** Nombre d'éléments par page. */\n limite: number\n onDecalageChange: (decalage: number) => void\n /** Sans lui, pas de choix du nombre par page. Changer de taille ramène à\n * la première page (`onDecalageChange(0)`). */\n onLimiteChange?: (limite: number) => void\n}\n\n/** Pagination côté client d'un `useDataTable({ paginationClient: true })` :\n * elle lit et règle la page du tableau, sur les lignes filtrées. */\nexport interface DataTablePaginationTableProps<\n TData extends RowData,\n> extends DataTablePaginationCommun {\n table: DataTableInstance<TData>\n}\n\nexport type DataTablePaginationProps<TData extends RowData = RowData> =\n DataTablePaginationDecalageProps | DataTablePaginationTableProps<TData>\n\n/**\n * Pagination par décalage (offset/limit, total connu) sur la Pagination de\n * shadcn : précédente, fenêtre de pages, suivante, et le nombre de lignes par\n * page (Select). Rien ne s'affiche quand tout tient sur une page de la plus\n * petite taille. Avec `table`, celle d'une pagination côté client, comme la\n * pagination du guide Data Table de shadcn.\n */\nexport function DataTablePagination<TData extends RowData>(\n props: DataTablePaginationProps<TData>\n) {\n if (!props.table) return <PaginationParDecalage {...props} />\n const { table, ...reste } = props\n const pagination = paginationDuTableau(table)\n if (pagination.manuelle) {\n // Sans `paginationClient`, la table ne découpe rien : des numéros de\n // page qui ne changeraient pas les lignes seraient trompeurs.\n avertirPaginationManuelle()\n return null\n }\n const { decalage, limite, total } = pagination\n return (\n <PaginationParDecalage\n {...reste}\n total={total}\n decalage={decalage}\n limite={limite}\n onDecalageChange={(suivant) =>\n table.setPageIndex(Math.floor(suivant / limite))\n }\n onLimiteChange={(suivante) => table.setPageSize(suivante)}\n // Une seule mise à jour : taille et retour en première page ensemble.\n // Deux appels successifs (`setPageSize` puis `setPageIndex`) se\n // résoudraient, avec une pagination contrôlée, contre la même valeur\n // rendue, et le second effacerait la nouvelle taille.\n changerTaille={(suivante) =>\n table.setPagination({ pageIndex: 0, pageSize: suivante })\n }\n // `useDataTable` ramène déjà une page passée au-delà de la fin.\n ramenerAuDela={false}\n />\n )\n}\n\nlet averti = false\nfunction avertirPaginationManuelle() {\n if (averti) return\n averti = true\n console.warn(\n \"DataTablePagination : `table` sans `paginationClient` ne pagine rien. \" +\n \"Passez `paginationClient: true` à useDataTable, ou les nombres \" +\n \"(`total`, `decalage`, `limite`) d'une pagination côté serveur.\"\n )\n}\n\nfunction PaginationParDecalage({\n total,\n decalage,\n limite,\n onDecalageChange,\n onLimiteChange,\n limites = [10, 25, 50, 100],\n className,\n ramenerAuDela = true,\n changerTaille,\n}: Omit<DataTablePaginationDecalageProps, \"table\"> & {\n ramenerAuDela?: boolean\n /** Change la taille et revient à la première page en une fois (à la\n * place de `onLimiteChange` puis `onDecalageChange(0)`). */\n changerTaille?: (limite: number) => void\n}) {\n const idTaille = useId()\n const nombrePages = Math.max(1, Math.ceil(total / limite))\n const page = Math.min(Math.floor(decalage / limite) + 1, nombrePages)\n const tailles = [...new Set([...limites, limite])].sort((a, b) => a - b)\n const choixTaille = onLimiteChange !== undefined && total > tailles[0]\n\n // Décalage au-delà de la fin (dernière ligne de la dernière page\n // supprimée) : on ramène l'application sur la dernière page, sans quoi\n // elle afficherait une page vide sous un numéro de page surligné. Pas\n // tant que `total` vaut 0 : c'est souvent un total pas encore connu\n // (requête de la page suivante en cours, décalage lu dans l'URL), et le\n // ramener renverrait à la première page.\n const decalageMax = (nombrePages - 1) * limite\n const ramener = useEffectEvent(() => onDecalageChange(decalageMax))\n useEffect(() => {\n if (ramenerAuDela && total > 0 && decalage >= total) ramener()\n }, [ramenerAuDela, decalage, total])\n\n if (nombrePages <= 1 && !choixTaille) return null\n\n const allerA = (cible: number) =>\n onDecalageChange((Math.min(Math.max(1, cible), nombrePages) - 1) * limite)\n\n return (\n <div\n data-slot=\"data-table-pagination\"\n className={cn(\n \"flex flex-wrap items-center justify-between gap-x-6 gap-y-2\",\n className\n )}\n >\n {choixTaille ? (\n <div className=\"flex items-center gap-2\">\n <span id={idTaille} className=\"text-sm font-medium\">\n Lignes par page\n </span>\n <Select\n value={String(limite)}\n onValueChange={(valeur) => {\n if (valeur === null) return\n if (changerTaille) return changerTaille(Number(valeur))\n onLimiteChange(Number(valeur))\n onDecalageChange(0)\n }}\n >\n <SelectTrigger className=\"w-[4.5rem]\" aria-labelledby={idTaille}>\n <SelectValue />\n </SelectTrigger>\n <SelectContent side=\"top\">\n {tailles.map((taille) => (\n <SelectItem key={taille} value={String(taille)}>\n {taille}\n </SelectItem>\n ))}\n </SelectContent>\n </Select>\n </div>\n ) : null}\n {nombrePages > 1 ? (\n <Pagination className=\"mx-0 ml-auto w-auto\">\n <PaginationContent>\n <PaginationItem>\n {/* Focalisable désactivé : arrivé en bout de liste au clavier,\n le focus reste sur le bouton au lieu de partir sur <body>. */}\n <Button\n variant=\"ghost\"\n className=\"pl-1.5!\"\n aria-label=\"Page précédente\"\n disabled={page === 1}\n focusableWhenDisabled\n onClick={() => allerA(page - 1)}\n >\n <ChevronLeftIcon data-icon=\"inline-start\" />\n <span className=\"hidden sm:block\">Précédente</span>\n </Button>\n </PaginationItem>\n {fenetre(page, nombrePages).map((p, i) => (\n <PaginationItem key={p === \"…\" ? `…${i}` : p}>\n {p === \"…\" ? (\n <PaginationEllipsis />\n ) : (\n <Button\n variant={p === page ? \"outline\" : \"ghost\"}\n size=\"icon\"\n aria-current={p === page ? \"page\" : undefined}\n aria-label={`Page ${p}`}\n onClick={() => allerA(p)}\n >\n {p}\n </Button>\n )}\n </PaginationItem>\n ))}\n <PaginationItem>\n <Button\n variant=\"ghost\"\n className=\"pr-1.5!\"\n aria-label=\"Page suivante\"\n disabled={page === nombrePages}\n focusableWhenDisabled\n onClick={() => allerA(page + 1)}\n >\n <span className=\"hidden sm:block\">Suivante</span>\n <ChevronRightIcon data-icon=\"inline-end\" />\n </Button>\n </PaginationItem>\n </PaginationContent>\n {/* Le focus reste sur la pagination, sous le tableau : la page\n atteinte est annoncée. */}\n <p className=\"sr-only\" aria-live=\"polite\" aria-atomic=\"true\">\n {`Page ${page} sur ${nombrePages}`}\n </p>\n </Pagination>\n ) : null}\n </div>\n )\n}\n"],"mappings":";;;;;;;;;AA0BA,SAASA,EAAQ,GAAkB,GAAkC;CACnE,IAAMC,IAAQ,CAAC,mBAAG,IAAI,IAAI;EAAC;EAAGC;EAAQC;EAAUA,IAAW;EAAGA,IAAW;CAAC,CAAC,CAAC,CAAC,CAC1E,QAAQ,MAAMC,KAAK,KAAKA,KAAKF,CAAM,CAAC,CACpC,MAAM,GAAG,MAAMG,IAAIC,CAAC,GACjBC,IAA2B,CAAC,GAC9BC,IAAa;CACjB,KAAK,IAAMC,KAAQR,GAGjB,AAFIQ,IAAOD,IAAa,KAAGD,EAAO,KAAK,GAAG,GAC1CA,EAAO,KAAKE,CAAI,GAChB,IAAaA;CAEf,OAAOF;AACT;AAyCA,SAAgBG,EACd,GACA;CACA,IAAI,CAACC,EAAM,OAAO,OAAO,kBAACC,GAAD,EAAuB,GAAID,EAAQ,CAAA;CAC5D,IAAM,EAAE,UAAO,GAAGE,MAAUF,GACtBG,IAAaC,EAAoBC,CAAK;CAC5C,IAAIF,EAAW,UAIb,OADAG,EAA0B,GACnB;CAET,IAAM,EAAE,aAAU,WAAQ,aAAUH;CACpC,OACE,kBAACF,GAAD;EACE,GAAIC;EACG;EACG;EACF;EACR,mBAAmB,MACjBG,EAAM,aAAa,KAAK,MAAME,IAAUC,CAAM,CAAC;EAEjD,iBAAiB,MAAaH,EAAM,YAAYI,CAAQ;EAKxD,gBAAgB,MACdJ,EAAM,cAAc;GAAE,WAAW;GAAG,UAAUI;EAAS,CAAC;EAG1D,eAAe;CAChB,CAAA;AAEL;AAEA,IAAIC,IAAS;AACb,SAASJ,IAA4B;CACnC,AAAII,MACJ,IAAS,IACT,QAAQ,KACN,qMAGF;AACF;AAEA,SAAST,EAAsB,EAC7B,UACA,aACA,WACA,qBACA,mBACA,aAAU;CAAC;CAAI;CAAI;CAAI;AAAG,GAC1B,cACA,mBAAgB,IAChB,oBAMC;CACD,IAAMU,IAAWC,EAAM,GACjBC,IAAc,KAAK,IAAI,GAAG,KAAK,KAAKC,IAAQN,CAAM,CAAC,GACnDV,IAAO,KAAK,IAAI,KAAK,MAAMiB,IAAWP,CAAM,IAAI,GAAGK,CAAW,GAC9DG,IAAU,CAAC,mBAAG,IAAI,IAAI,CAAC,GAAGC,GAAST,CAAM,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,MAAMd,IAAIC,CAAC,GACjEuB,IAAcC,MAAmB,KAAA,KAAaL,IAAQE,EAAQ,IAQ9DI,KAAeP,IAAc,KAAKL,GAClCa,IAAUC,QAAqBC,EAAiBH,CAAW,CAAC;CAKlE,IAJAI,QAAgB;EACd,AAAIC,KAAiBX,IAAQ,KAAKC,KAAYD,KAAOO,EAAQ;CAC/D,GAAG;EAACI;EAAeV;EAAUD;CAAK,CAAC,GAE/BD,KAAe,KAAK,CAACK,GAAa,OAAO;CAE7C,IAAMQ,KAAU,MACdH,GAAkB,KAAK,IAAI,KAAK,IAAI,GAAGI,CAAK,GAAGd,CAAW,IAAI,KAAKL,CAAM;CAE3E,OACE,kBAAC,OAAD;EACE,aAAU;EACV,WAAWoB,EACT,+DACAC,CACF;EALF,UAAA,CAOGX,IACC,kBAAC,OAAD;GAAK,WAAU;GAAf,UAAA,CACE,kBAAC,QAAD;IAAM,IAAIP;IAAU,WAAU;IAAsB,UAAA;GAE9C,CAAA,GACN,kBAACmB,GAAD;IACE,OAAO,OAAOtB,CAAM;IACpB,gBAAgB,MAAW;KACzB,IAAIuB,MAAW,MACf;UAAIC,GAAe,OAAOA,EAAc,OAAOD,CAAM,CAAC;MAEtD,AADAZ,EAAe,OAAOY,CAAM,CAAC,GAC7BR,EAAiB,CAAC;KAFoC;IAGxD;IAPF,UAAA,CASE,kBAACU,GAAD;KAAe,WAAU;KAAa,mBAAiBtB;KACrD,UAAA,kBAACuB,GAAD,CAAc,CAAA;IACD,CAAA,GACf,kBAACC,GAAD;KAAe,MAAK;KACjB,UAAAnB,EAAQ,KAAK,MACZ,kBAACoB,GAAD;MAAyB,OAAO,OAAOC,CAAM;MAC1C,UAAAA;KACS,GAFKA,CAEL,CACb;IACY,CAAA,CACT;GACL,CAAA,CAAA;EACH,CAAA,IAAA,MACHxB,IAAc,IACb,kBAACyB,GAAD;GAAY,WAAU;GAAtB,UAAA,CACE,kBAACC,GAAD,EAAA,UAAA;IACE,kBAACC,GAAD,EAAA,UAGE,kBAACC,GAAD;KACE,SAAQ;KACR,WAAU;KACV,cAAW;KACX,UAAU3C,MAAS;KACnB,uBAAA;KACA,eAAe4B,EAAO5B,IAAO,CAAC;KANhC,UAAA,CAQE,kBAAC4C,GAAD,EAAiB,aAAU,eAAgB,CAAA,GAC3C,kBAAC,QAAD;MAAM,WAAU;MAAkB,UAAA;KAAgB,CAAA,CAC5C;IACM,CAAA,EAAA,CAAA;IACfrD,EAAQS,GAAMe,CAAW,CAAC,CAAC,KAAK,GAAG,MAClC,kBAAC2B,GAAD,EAAA,UACG/C,MAAM,MACL,kBAACkD,GAAD,CAAqB,CAAA,IAErB,kBAACF,GAAD;KACE,SAAShD,MAAMK,IAAO,YAAY;KAClC,MAAK;KACL,gBAAcL,MAAMK,IAAO,SAAS,KAAA;KACpC,cAAY,QAAQL;KACpB,eAAeiC,EAAOjC,CAAC;KAEtB,UAAAA;IACK,CAAA,EAEI,GAdKA,MAAM,MAAM,IAAImD,MAAMnD,CAc3B,CACjB;IACD,kBAAC+C,GAAD,EAAA,UACE,kBAACC,GAAD;KACE,SAAQ;KACR,WAAU;KACV,cAAW;KACX,UAAU3C,MAASe;KACnB,uBAAA;KACA,eAAea,EAAO5B,IAAO,CAAC;KANhC,UAAA,CAQE,kBAAC,QAAD;MAAM,WAAU;MAAkB,UAAA;KAAc,CAAA,GAChD,kBAAC+C,GAAD,EAAkB,aAAU,aAAc,CAAA,CACpC;IACM,CAAA,EAAA,CAAA;GACC,EAAA,CAAA,GAGnB,kBAAC,KAAD;IAAG,WAAU;IAAU,aAAU;IAAS,eAAY;IACnD,UAAA,QAAQ/C,EAAK,OAAOe;GACpB,CAAA,CACO;EACV,CAAA,IAAA,IACD;;AAET"}
1
+ {"version":3,"file":"data-table-pagination.js","names":["fenetre","pages","nombre","courante","p","a","b","sortie","precedente","page","LIMITES_PAGINATION","DataTablePagination","props","PaginationParDecalage","reste","pagination","paginationDuTableau","table","avertirPaginationManuelle","suivant","limite","suivante","averti","idTaille","useId","nombrePages","total","decalage","tailles","limites","choixTaille","onLimiteChange","decalageMax","ramener","useEffectEvent","onDecalageChange","useEffect","ramenerAuDela","allerA","cible","cn","className","Select","valeur","changerTaille","SelectTrigger","SelectValue","SelectContent","SelectItem","taille","Pagination","PaginationContent","PaginationItem","Button","ChevronLeftIcon","PaginationEllipsis","i","ChevronRightIcon"],"sources":["../../../src/components/etic/data-table-pagination.tsx"],"sourcesContent":["import { useEffect, useEffectEvent, useId } from \"react\"\nimport type { RowData } from \"@tanstack/react-table\"\nimport { cn } from \"cn\"\nimport { ChevronLeftIcon, ChevronRightIcon } from \"lucide-react\"\n\nimport { Button } from \"@etic-ui/components/ui/button\"\nimport {\n Pagination,\n PaginationContent,\n PaginationEllipsis,\n PaginationItem,\n} from \"@etic-ui/components/ui/pagination\"\nimport {\n Select,\n SelectContent,\n SelectItem,\n SelectTrigger,\n SelectValue,\n} from \"@etic-ui/components/ui/select\"\nimport {\n paginationDuTableau,\n type DataTableInstance,\n} from \"@etic-ui/components/etic/data-table\"\n\n/** Fenêtre de pages : la première, la dernière, la courante et ses voisines,\n * « … » pour les pages sautées. Page 6 sur 20 : 1 … 5 6 7 … 20. */\nfunction fenetre(courante: number, nombre: number): (number | \"…\")[] {\n const pages = [...new Set([1, nombre, courante, courante - 1, courante + 1])]\n .filter((p) => p >= 1 && p <= nombre)\n .sort((a, b) => a - b)\n const sortie: (number | \"…\")[] = []\n let precedente = 0\n for (const page of pages) {\n if (page - precedente > 1) sortie.push(\"…\")\n sortie.push(page)\n precedente = page\n }\n return sortie\n}\n\n/** Nombres d'éléments par page proposés par défaut. */\nexport const LIMITES_PAGINATION: readonly number[] = [10, 25, 50, 100]\n\ninterface DataTablePaginationCommun {\n /** Nombres d'éléments par page proposés (`LIMITES_PAGINATION` par\n * défaut). */\n limites?: readonly number[]\n className?: string\n}\n\n/** Pagination par décalage, aux nombres de l'application (côté serveur). */\nexport interface DataTablePaginationDecalageProps extends DataTablePaginationCommun {\n table?: never\n /** Nombre total d'éléments, toutes pages comprises. */\n total: number\n /** Rang (à partir de 0) du premier élément de la page. */\n decalage: number\n /** Nombre d'éléments par page. */\n limite: number\n onDecalageChange: (decalage: number) => void\n /** Sans lui, pas de choix du nombre par page. Changer de taille ramène à\n * la première page (`onDecalageChange(0)`). */\n onLimiteChange?: (limite: number) => void\n}\n\n/** Pagination côté client d'un `useDataTable({ paginationClient: true })` :\n * elle lit et règle la page du tableau, sur les lignes filtrées. */\nexport interface DataTablePaginationTableProps<\n TData extends RowData,\n> extends DataTablePaginationCommun {\n table: DataTableInstance<TData>\n}\n\nexport type DataTablePaginationProps<TData extends RowData = RowData> =\n DataTablePaginationDecalageProps | DataTablePaginationTableProps<TData>\n\n/**\n * Pagination par décalage (offset/limit, total connu) sur la Pagination de\n * shadcn : précédente, fenêtre de pages, suivante, et le nombre de lignes par\n * page (Select). Rien ne s'affiche quand tout tient sur une page de la plus\n * petite taille. Avec `table`, celle d'une pagination côté client, comme la\n * pagination du guide Data Table de shadcn.\n */\nexport function DataTablePagination<TData extends RowData>(\n props: DataTablePaginationProps<TData>\n) {\n if (!props.table) return <PaginationParDecalage {...props} />\n const { table, ...reste } = props\n const pagination = paginationDuTableau(table)\n if (pagination.manuelle) {\n // Sans `paginationClient`, la table ne découpe rien : des numéros de\n // page qui ne changeraient pas les lignes seraient trompeurs.\n avertirPaginationManuelle()\n return null\n }\n const { decalage, limite, total } = pagination\n return (\n <PaginationParDecalage\n {...reste}\n total={total}\n decalage={decalage}\n limite={limite}\n onDecalageChange={(suivant) =>\n table.setPageIndex(Math.floor(suivant / limite))\n }\n onLimiteChange={(suivante) => table.setPageSize(suivante)}\n // Une seule mise à jour : taille et retour en première page ensemble.\n // Deux appels successifs (`setPageSize` puis `setPageIndex`) se\n // résoudraient, avec une pagination contrôlée, contre la même valeur\n // rendue, et le second effacerait la nouvelle taille.\n changerTaille={(suivante) =>\n table.setPagination({ pageIndex: 0, pageSize: suivante })\n }\n // `useDataTable` ramène déjà une page passée au-delà de la fin.\n ramenerAuDela={false}\n />\n )\n}\n\nlet averti = false\nfunction avertirPaginationManuelle() {\n if (averti) return\n averti = true\n console.warn(\n \"DataTablePagination : `table` sans `paginationClient` ne pagine rien. \" +\n \"Passez `paginationClient: true` à useDataTable, ou les nombres \" +\n \"(`total`, `decalage`, `limite`) d'une pagination côté serveur.\"\n )\n}\n\nfunction PaginationParDecalage({\n total,\n decalage,\n limite,\n onDecalageChange,\n onLimiteChange,\n limites = LIMITES_PAGINATION,\n className,\n ramenerAuDela = true,\n changerTaille,\n}: Omit<DataTablePaginationDecalageProps, \"table\"> & {\n ramenerAuDela?: boolean\n /** Change la taille et revient à la première page en une fois (à la\n * place de `onLimiteChange` puis `onDecalageChange(0)`). */\n changerTaille?: (limite: number) => void\n}) {\n const idTaille = useId()\n const nombrePages = Math.max(1, Math.ceil(total / limite))\n const page = Math.min(Math.floor(decalage / limite) + 1, nombrePages)\n const tailles = [...new Set([...limites, limite])].sort((a, b) => a - b)\n const choixTaille = onLimiteChange !== undefined && total > tailles[0]\n\n // Décalage au-delà de la fin (dernière ligne de la dernière page\n // supprimée) : on ramène l'application sur la dernière page, sans quoi\n // elle afficherait une page vide sous un numéro de page surligné. Pas\n // tant que `total` vaut 0 : c'est souvent un total pas encore connu\n // (requête de la page suivante en cours, décalage lu dans l'URL), et le\n // ramener renverrait à la première page.\n const decalageMax = (nombrePages - 1) * limite\n const ramener = useEffectEvent(() => onDecalageChange(decalageMax))\n useEffect(() => {\n if (ramenerAuDela && total > 0 && decalage >= total) ramener()\n }, [ramenerAuDela, decalage, total])\n\n if (nombrePages <= 1 && !choixTaille) return null\n\n const allerA = (cible: number) =>\n onDecalageChange((Math.min(Math.max(1, cible), nombrePages) - 1) * limite)\n\n return (\n <div\n data-slot=\"data-table-pagination\"\n className={cn(\n \"flex flex-wrap items-center justify-between gap-x-6 gap-y-2\",\n className\n )}\n >\n {choixTaille ? (\n <div className=\"flex items-center gap-2\">\n <span id={idTaille} className=\"text-sm font-medium\">\n Lignes par page\n </span>\n <Select\n value={String(limite)}\n onValueChange={(valeur) => {\n if (valeur === null) return\n if (changerTaille) return changerTaille(Number(valeur))\n onLimiteChange(Number(valeur))\n onDecalageChange(0)\n }}\n >\n <SelectTrigger className=\"w-[4.5rem]\" aria-labelledby={idTaille}>\n <SelectValue />\n </SelectTrigger>\n <SelectContent side=\"top\">\n {tailles.map((taille) => (\n <SelectItem key={taille} value={String(taille)}>\n {taille}\n </SelectItem>\n ))}\n </SelectContent>\n </Select>\n </div>\n ) : null}\n {nombrePages > 1 ? (\n <Pagination className=\"mx-0 ml-auto w-auto\">\n <PaginationContent>\n <PaginationItem>\n {/* Focalisable désactivé : arrivé en bout de liste au clavier,\n le focus reste sur le bouton au lieu de partir sur <body>. */}\n <Button\n variant=\"ghost\"\n className=\"pl-1.5!\"\n aria-label=\"Page précédente\"\n disabled={page === 1}\n focusableWhenDisabled\n onClick={() => allerA(page - 1)}\n >\n <ChevronLeftIcon data-icon=\"inline-start\" />\n <span className=\"hidden sm:block\">Précédente</span>\n </Button>\n </PaginationItem>\n {fenetre(page, nombrePages).map((p, i) => (\n <PaginationItem key={p === \"…\" ? `…${i}` : p}>\n {p === \"…\" ? (\n <PaginationEllipsis />\n ) : (\n <Button\n variant={p === page ? \"outline\" : \"ghost\"}\n size=\"icon\"\n aria-current={p === page ? \"page\" : undefined}\n aria-label={`Page ${p}`}\n onClick={() => allerA(p)}\n >\n {p}\n </Button>\n )}\n </PaginationItem>\n ))}\n <PaginationItem>\n <Button\n variant=\"ghost\"\n className=\"pr-1.5!\"\n aria-label=\"Page suivante\"\n disabled={page === nombrePages}\n focusableWhenDisabled\n onClick={() => allerA(page + 1)}\n >\n <span className=\"hidden sm:block\">Suivante</span>\n <ChevronRightIcon data-icon=\"inline-end\" />\n </Button>\n </PaginationItem>\n </PaginationContent>\n {/* Le focus reste sur la pagination, sous le tableau : la page\n atteinte est annoncée. */}\n <p className=\"sr-only\" aria-live=\"polite\" aria-atomic=\"true\">\n {`Page ${page} sur ${nombrePages}`}\n </p>\n </Pagination>\n ) : null}\n </div>\n )\n}\n"],"mappings":"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"}
@@ -412,20 +412,31 @@ type DataTableCellLinkCommun = {
412
412
  export type DataTableCellLinkProps = DataTableCellLinkCommun & Omit<ComponentProps<"a">, "children" | "className"> & {
413
413
  href: string;
414
414
  /** Lien du routeur de l'application ; par défaut, celui du
415
- * `LienProvider`, sinon un `<a>`. */
415
+ * `LienProvider`, sinon un `<a>`. Ignoré avec `externe`. */
416
416
  lien?: LienComposant;
417
+ /** Page hébergée ailleurs (document partagé…) : un vrai `<a>` ouvert
418
+ * dans un nouvel onglet, flèche sortante et « (nouvel onglet) » pour
419
+ * les lecteurs d'écran, comme `ExternalLink`. */
420
+ externe?: boolean;
421
+ /** Avec `externe`, ce que disent les lecteurs d'écran entre parenthèses
422
+ * après le titre : « nouvel onglet » par défaut ; à préciser pour dire
423
+ * la destination (« ouvrir sur le Drive, nouvel onglet »). */
424
+ libelleExterne?: string;
417
425
  };
418
426
  /** Bouton de cellule : une action sur place (ouvrir la modification…). */
419
427
  export type DataTableCellButtonProps = DataTableCellLinkCommun & Omit<ComponentProps<"button">, "children" | "className"> & {
420
428
  href?: never;
421
429
  lien?: never;
430
+ externe?: never;
431
+ libelleExterne?: never;
422
432
  };
423
433
  /**
424
434
  * Titre d'une ligne qui mène à sa fiche : un vrai lien (`href`, routeur par
425
435
  * `lien` ou le `LienProvider`), ou un bouton sans `href` (ouvrir la modification). Le clic de
426
436
  * ligne (`onActiverLigne`) n'est qu'un raccourci à la souris : ce lien est
427
437
  * le chemin du clavier et des lecteurs d'écran, et garde l'ouverture dans un
428
- * nouvel onglet.
438
+ * nouvel onglet. `externe` : une page hébergée ailleurs, ouverte dans un
439
+ * nouvel onglet, et qui le dit.
429
440
  */
430
441
  export declare function DataTableCellLink(props: DataTableCellLinkProps | DataTableCellButtonProps): import("react").JSX.Element;
431
442
  export {};