@portnet/ui 6.0.1 → 6.0.3

package/dist/esm/v2/patterns/index.js

@@ -1,5 +1,38 @@
 export { default as ActionBar } from "./ActionBar";
+/**
+ * AppMain — the `<main>` landmark (gap G-53).
+ *
+ * The library shipped HALF of a two-part contract: `SkipLink`'s docblock
+ * prescribes `<main id="main-content">` as its target and the library never
+ * provided it, so every module wrote the landmark — with `tabIndex={-1}`
+ * (without which the skip link scrolls but does not move focus in Safari),
+ * `outline: none` (R-F.1: the ring belongs on controls, not on a whole page),
+ * and the content measure of R-L.5, a MUST nothing here honoured:
+ * `PageContent` owns the canonical padding and caps NOTHING, so a certified
+ * module still stretched its tables across a 1920 px display.
+ *
+ * Two copies existed in the portfolio (autorisation-admis-pour-conforme-fe and
+ * the reference module ms-ti-fe), which is what a gap looks like from the
+ * outside.
+ */
+export { default as AppMain } from "./AppMain";
 export { default as BulkActionBar } from "./BulkActionBar";
+/**
+ * ChartFigure — a chart, its title, and its TEXT EQUIVALENT (gap G-55).
+ *
+ * `tokens/chart` states the obligation and shipped nothing to meet it, in its
+ * own words: the palette "does not make a chart accessible. Every consumer
+ * still owes a legend with text labels, and a text equivalent of the data —
+ * 1.1.1 for the chart as a whole." A rule stated without a component to carry
+ * it is met by whoever remembers it, and the text equivalent is the part that
+ * goes missing first — the only one nobody SEES missing.
+ *
+ * Hence `caption` being REQUIRED: a chart rendered through here cannot ship
+ * without its numbers in text. The canvas is `aria-hidden` (a renderer emits
+ * dozens of unstructured SVG text nodes, which is noise worse than silence) —
+ * so no interactive control goes inside it.
+ */
+export { default as ChartFigure } from "./ChartFigure";
 export { default as ColumnsToggle } from "./ColumnsToggle";
 export { default as FormSection } from "./FormSection";
 export { default as FormPageShell } from "./FormPageShell";
@@ -7,11 +40,153 @@ export { default as FormErrorSummary } from "./FormErrorSummary";
 // R-FV.3 companion to FormErrorSummary (R-FV.2) — renders nothing, moves
 // focus to the first field in error after a failed submit. Adopt both.
 export { default as FormikErrorFocus } from "./FormikErrorFocus";
+/**
+ * FormikErrorSummary — the Formik bridge for FormErrorSummary (R-FV.2).
+ *
+ * The library owned all three parts of the failed-submit recipe and no way to
+ * assemble them inside the form shape modules actually write:
+ * `FormErrorSummary` renders the banner from a flat list,
+ * `flattenFormikErrors` (G-38) produces that list, `focusFieldByName`
+ * (R-FV.3) resolves an item back to its control.
+ *
+ * Reaching `errors` / `submitCount` needs the Formik CONTEXT, and the
+ * prevailing shape is `<Formik><Form>…</Form></Formik>` with STATIC children —
+ * the host's body sits outside the provider, and `innerRef` does not help
+ * because mutating a ref does not re-render the holder when `errors` changes.
+ * So each host had to convert its form to a render-prop purely to reach the
+ * errors, or write a local null-rendering context reader.
+ *
+ * Raised from ms-ti-fe (Area 11), where ONE of eleven Formik forms had the
+ * banner: wiring the other ten meant ten copies of that wrapper. The sibling
+ * rule HAS a bridge (`FormikErrorFocus`), which is why field adoption of the
+ * two MUSTs diverged — the one needing boilerplate is the one nobody applied.
+ */
+export { default as FormikErrorSummary } from "./FormikErrorSummary";
 export { default as PageContent } from "./PageContent";
+/**
+ * DetailSplit — content + progression rail on a consultation page (gap G-44).
+ *
+ * §Detail / Consultation Pattern makes the vertical progress rail a MUST on
+ * every consultation page, and §07 R-L.7 fixes the skeleton. The library shipped
+ * the rail (`VStepper`) and not the geometry that places it beside the record,
+ * so each host wrote the same three-value flex row by hand.
+ *
+ * Promoted from `refonte-frontend` (Area 4), where the SAME row existed twice
+ * — `DetailPage` and `TraitementDemande` — with `560` / `300` / `260` written
+ * out in both (R-2.3), and already drifting: neither `<aside>` had an
+ * accessible name. Widths now live in `tokens.layout.detail`.
+ */
+export { default as DetailSplit } from "./DetailSplit";
+/**
+ * PreviewDrawer — the listing preview, body included (gap G-40).
+ *
+ * §Row Interaction and §Preview Drawer are MUST on every listing page of the
+ * platform, and the library shipped only `Drawer`, the empty shell. Each module
+ * assembled the same summary by hand, and the copies drifted where it shows
+ * least: `ms-ti-fe` uses `KVGrid` + `KV`, `refonte-frontend` had built a local
+ * `<dl>` with its own grid — one concept, two renderings (R-2.1).
+ *
+ * Promoted from `refonte-frontend` (Area 5). Reads NO field of `row`, which is
+ * what removed the `as unknown as` assertion its single-component ancestor
+ * needed; business defaults live in a host wrapper over a concrete row type.
+ */
+export { default as PreviewDrawer } from "./PreviewDrawer";
 export { default as DataGrid, applySort } from "./DataGrid";
+/**
+ * DataGridVirtualized — la seconde table, pour les grands volumes.
+ *
+ * Sa frontière d'emploi est énoncée dans son propre en-tête : au-delà de mille
+ * lignes où la pagination paraîtrait artificielle (journaux d'audit, « tout
+ * afficher ») ; sous cent lignes, `DataGrid` est plus simple.
+ *
+ * >>> LES TYPES SONT AJOUTÉS ICI (audit lot 12, Area 13) — MÊME CLASSE
+ * >>> GAP-TS-003 QUE CE FICHIER DOCUMENTE DÉJÀ CINQ FOIS. La VALEUR était
+ * >>> exportée, les types décrivant ses props ne l'étaient pas : un hôte ne
+ * >>> pouvait donc ni écrire un adaptateur typé autour de ce composant, ni
+ * >>> nommer `DataGridVirtualizedDensity` — dont il a besoin, puisque ce
+ * >>> palier de HAUTEUR DE LIGNE compte quatre valeurs là où le `Density`
+ * >>> canonique en a deux. Le repli aurait été un jumeau local, que les
+ * >>> Platform TypeScript Guidelines interdisent.
+ * >>>
+ * >>> Relevé depuis `autorisation-admis-pour-conforme-fe` (Area 13) : ce
+ * >>> module n'utilise pas ce composant — il pagine côté serveur — mais son
+ * >>> audit RGESN a dû établir où vivait la virtualisation, et a trouvé une
+ * >>> capacité complète dont la surface type était muette.
+ * >>>
+ * >>> Additif et purement typographique : aucun changement d'exécution. <<<
+ */
 export { default as DataGridVirtualized } from "./DataGridVirtualized";
 export { default as DataGridSettingsMenu } from "./DataGridSettingsMenu";
 export { default as DataGridToolbar } from "./DataGridToolbar";
+/**
+ * rowActions — business descriptors → the row's kebab menu (gap G-41).
+ *
+ * The library shipped both halves — `OverflowMenu` renders flat actions,
+ * `DataGrid.rowActions` takes a `(row) => ReactNode` — and not the step
+ * between them, which every listing wrote for itself while carrying three
+ * Charter rules (R-3.3, R-B.6, R-K.1).
+ *
+ * `buildRowActionMenu` is exported alongside the renderer on purpose: a row
+ * appears twice, as a table row and as a `MobileRowCard` whose `actions` prop
+ * takes `OverflowMenuAction[]` rather than a node. Without it, hosts rebuilt
+ * the menu by hand for the card and the two copies drifted — the same failure
+ * the library records for `RowFavoriteToggle` (G-36).
+ *
+ * Promoted from `refonte-frontend` (Area 5), where it served twelve screens.
+ */
+export { buildRowActions, buildRowActionMenu, MAX_ROW_ACTIONS } from "./rowActions";
+/**
+ * FilterTabBar — the status-chip bar of a listing card (gap G-45).
+ *
+ * §Status Chips is a MUST on every listing, and the library shipped the PILL
+ * (`FilterTab`) without the bar that seats it — so each listing re-derived the
+ * row geometry, the card-header separator, and the split between the status
+ * group and the personalization controls.
+ *
+ * Promoted from `refonte-frontend` (Area 5), where FOUR listings carried the
+ * same `BARRE_CHIPS_STATUT` + `GROUPE_BARRE` pair — and had already drifted:
+ * one of the four omitted `justifyContent: "space-between"`, so the same
+ * listing family rendered two different layouts (R-2.1).
+ */
+export { default as FilterTabBar } from "./FilterTabBar";
+/**
+ * filterCriteria — active criteria as removable chips (gap G-42).
+ *
+ * The library owned the RENDERING (`DataGridToolbar.filterChips` and the
+ * `DataGridToolbarFilterChip` type, itself added at this module's request) and
+ * not the builder. Ten local copies would have drifted on the two things that
+ * are not obvious: what counts as SET (`0` is the unset value of a reference
+ * mirror on several hosts) and what a removal must CLEAR (reference criteria
+ * are held as pairs, so clearing only the displayed key leaves an invisible
+ * filter that still filters).
+ *
+ * Pair with `useAppliedFilters`. Promoted from `refonte-frontend` (Area 5).
+ */
+export { buildFilterChips, filterCriteriaKeys, isCriterionSet } from "./filterCriteria";
+
+/**
+ * DataGridToolbar contracts — public typed surface (gap G-I).
+ *
+ * Meme defaut que les blocs `StepStatus`, `FieldHelp`, `Status` et `Field` :
+ * la barre d'outils etait exportee comme VALEUR, sans les types de ses props.
+ * `DataGridToolbarFilterChip` est celui qui manque le plus : §Filters et
+ * §Search des Platform Mandatory UX Patterns imposent des criteres actifs
+ * retirables, `filterChips` est la capacite qui les rend, et un hote qui
+ * construit ce tableau a besoin de la forme d'une entree.
+ *
+ * Sans le type, il redeclare `{ key, label, onRemove }` au point d'appel — ce
+ * que les Platform TypeScript Guidelines interdisent (« Reusable types belong
+ * inside Shared UI Library … Never duplicate »). Releve depuis
+ * `refonte-frontend` (lot 8, ecart A9), ou dix listings doivent construire ces
+ * pastilles a partir d'une brique partagee.
+ *
+ * `DataGridToolbarLabels` voyage avec : un hote qui traduit la barre d'outils
+ * en a besoin, et c'est la meme duplication un niveau plus bas.
+ *
+ * FLAT-ONLY, per the policy note in src/lib/index.ts.
+ * Additive and type-only: no runtime change, no existing export altered.
+ */
+
 export { default as CollapsibleDataGrid } from "./CollapsibleDataGrid";
 export { default as SortableHeader, getAriaSort } from "./SortableHeader";
 export { default as NetworkErrorBanner } from "./NetworkErrorBanner";
@@ -52,6 +227,26 @@ export { default as SavedFiltersMenu } from "./SavedFiltersMenu";
 // FavoritesFilter is the all/favorites-only segmented control.
 export { default as makeFavoriteColumn } from "./FavoriteColumn";
 export { default as FavoritesFilter } from "./FavoritesFilter";
+/**
+ * RowFavoriteToggle — the per-row follow star, standalone (gap G-36).
+ *
+ * It already existed as a PRIVATE `FavoriteCell` inside `makeFavoriteColumn`,
+ * which made the follow control reachable as a DataGrid column and nowhere
+ * else. The other place a row always appears is the mobile card: `DataGrid`
+ * swaps to `renderMobileCard` below its `mobileBreakpoint`, and
+ * `MobileRowCard` has a `leading` slot for exactly this — but a column
+ * definition cannot be rendered into a slot, so hosts rebuilt the star by
+ * hand (`onssa-export-fe`'s `MobileFavoriteToggle`; `ms-ti-fe` destructures
+ * the same MobileRowCard + FavoriteToggle + useIsFavorite trio).
+ *
+ * Same failure mode as G-10: the library owned the behaviour but exposed it at
+ * one composition point only. And the copies drifted where it is least visible
+ * and matters most — the local twin announced "Ajouter aux favoris" while the
+ * grid column on the same page said "Suivre", and it dropped the status
+ * tooltip. `makeFavoriteColumn` now renders this component, so the two agree
+ * by construction.
+ */
+export { default as RowFavoriteToggle, DEFAULT_ROW_FAVORITE_LABELS } from "./RowFavoriteToggle";
 // ── Formik bridges ────────────────────────────────────────────────────────────
 export { default as FormikInput } from "./FormikInput";
 export { default as FormikTextarea } from "./FormikTextarea";
@@ -87,6 +282,46 @@ export { default as FormikCombobox } from "./FormikCombobox";
 export { default as FormikDatePicker } from "./FormikDatePicker";
 export { default as FormikFile } from "./FormikFile";
 export { default as FormikCheckboxGroup } from "./FormikCheckboxGroup";
+/**
+ * FormikCheckbox — pont pour une case a cocher BOOLEENNE simple (gap G-A).
+ *
+ * `FormikCheckboxGroup` porte un TABLEAU de valeurs selectionnees : un hote
+ * dont l'etat est un booleen (`autreInfo.fabrication`,
+ * `objectDeclaration.premiereDeclaration`) ne peut pas l'adopter sans changer
+ * ce que son payload envoie. Faute de pont, les modules recablaient
+ * `Checkbox` + `useField` a la main — duplication interdite par R-2.1, et qui
+ * perdait systematiquement le rendu de l'erreur (R-4.1 MUST).
+ *
+ * Le type de props est expose : meme classe que Gap-TS-003 ci-dessus.
+ */
+export { default as FormikCheckbox } from "./FormikCheckbox";
+/**
+ * FormikRadioGroup — pont pour un groupe de radios (gap G-C).
+ *
+ * R-Sel.2 est un MUST : 2-3 options -> Radio ou Segmented, jamais un Select.
+ * Toute question metier binaire passe donc par `RadioGroup`, qui n'avait aucun
+ * pont Formik la ou `FormikSelect`, `FormikCombobox`, `FormikCheckboxGroup` et
+ * les autres en ont un. Les hotes recablaient `useField` + `RadioGroup` a la
+ * main, et y perdaient `FieldError`.
+ *
+ * Contrat invisible a connaitre : la valeur ECRITE est celle DECLAREE dans
+ * `options`, pas la chaine que rapporte le DOM — un hote aux options
+ * numeriques continue de stocker des nombres.
+ */
+export { default as FormikRadioGroup } from "./FormikRadioGroup";
+/**
+ * FormikDateTimePicker — pont date + HEURE (gap G-E).
+ *
+ * `FormikDatePicker` etait le seul pont de date de la library, et il est
+ * date-seule. Un hote ayant besoin de l'heure devait soit la perdre — ce qui
+ * change ce que recoit le backend, pas seulement l'affichage — soit recabler
+ * `useField` + le `DateTimePicker` nu, donc dupliquer.
+ *
+ * Les deux ponts PARTAGENT `coerceToDate` / `serialiseDate`
+ * (`./_pickerSerialisation`) : voir la note S-03 de `FormikDatePicker` pour ce
+ * qui arrive quand la lecture et l'ecriture d'une date divergent.
+ */
+export { default as FormikDateTimePicker } from "./FormikDateTimePicker";
 export { default as FormikReferentielField } from "./FormikReferentielField";
 /** Affichage valeur système — fond grisé, aucune interaction.
  *  Utiliser à la place de FormikInput disabled pour les champs

package/dist/esm/v2/patterns/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["default","ActionBar","BulkActionBar","ColumnsToggle","FormSection","FormPageShell","FormErrorSummary","FormikErrorFocus","PageContent","DataGrid","applySort","DataGridVirtualized","DataGridSettingsMenu","DataGridToolbar","CollapsibleDataGrid","SortableHeader","getAriaSort","NetworkErrorBanner","ReferentielField","Tour","KeyboardShortcutsHelp","DeleteResourceConfirmDialog","SaveFilterDialog","SavedFiltersMenu","makeFavoriteColumn","FavoritesFilter","FormikInput","FormikTextarea","FormikSelect","FormikCombobox","FormikDatePicker","FormikFile","FormikCheckboxGroup","FormikReferentielField","FormikDisplay"],"sources":["../../../../src/lib/v2/patterns/index.ts"],"sourcesContent":["export { default as ActionBar }            from \"./ActionBar\";\r\nexport type { ActionBarProps, ActionBarAction, ActionBarLabels, BreadcrumbItem, CrumbEntry } from \"./ActionBar\";\r\nexport { default as BulkActionBar }        from \"./BulkActionBar\";\r\nexport { default as ColumnsToggle }        from \"./ColumnsToggle\";\r\nexport { default as FormSection }          from \"./FormSection\";\r\nexport { default as FormPageShell }        from \"./FormPageShell\";\r\nexport { default as FormErrorSummary }     from \"./FormErrorSummary\";\r\nexport type { FormErrorSummaryProps, FormErrorSummaryError } from \"./FormErrorSummary\";\r\n// R-FV.3 companion to FormErrorSummary (R-FV.2) — renders nothing, moves\r\n// focus to the first field in error after a failed submit. Adopt both.\r\nexport { default as FormikErrorFocus }     from \"./FormikErrorFocus\";\r\nexport type { FormikErrorFocusProps }      from \"./FormikErrorFocus\";\r\nexport { default as PageContent }          from \"./PageContent\";\r\nexport { default as DataGrid, applySort }  from \"./DataGrid\";\r\nexport { default as DataGridVirtualized }  from \"./DataGridVirtualized\";\r\nexport { default as DataGridSettingsMenu } from \"./DataGridSettingsMenu\";\r\nexport { default as DataGridToolbar }      from \"./DataGridToolbar\";\r\nexport { default as CollapsibleDataGrid }  from \"./CollapsibleDataGrid\";\r\nexport { default as SortableHeader, getAriaSort } from \"./SortableHeader\";\r\nexport { default as NetworkErrorBanner }   from \"./NetworkErrorBanner\";\r\nexport { default as ReferentielField }     from \"./ReferentielField\";\r\n/**\r\n * ReferentielField configuration types — public typed surface.\r\n *\r\n * Same class of gap as Gap-TS-003 (component types), which was fixed for\r\n * `./components` but never extended to `./patterns`: the VALUE above was\r\n * exported while the types describing its own REQUIRED props were not.\r\n * `columns` and `criteria` are mandatory-to-configure, so a consumer had no\r\n * way to type them without either deep-importing\r\n * `@portnet/ui/dist/v2/patterns/…` (fragile, bypasses the `exports` map) or\r\n * declaring a local twin — which the Platform TypeScript Guidelines forbid\r\n * (\"Reusable types belong inside Shared UI Library … Never duplicate\").\r\n *\r\n * `ReferentielSearchResult` and `ReferentielSearchParams` are deliberately\r\n * NOT re-exported here: identically-named types are already surfaced from\r\n * `./referentiel` (useReferentielSearch) and `./v2/models` respectively, and\r\n * `src/lib/index.ts` star-exports all three barrels — a second named export of\r\n * either identifier is a hard TS2308 ambiguity at the library root.\r\n *\r\n * Additive and type-only: no runtime change, no existing export altered.\r\n */\r\nexport type {\r\n  ReferentielFieldProps,\r\n  ReferentielCriterion,\r\n  ReferentielFieldLabels,\r\n} from \"./ReferentielField\";\r\nexport { default as Tour }                 from \"./Tour\";\r\nexport { default as KeyboardShortcutsHelp } from \"./KeyboardShortcutsHelp\";\r\nexport { default as DeleteResourceConfirmDialog } from \"./DeleteResourceConfirmDialog\";\r\n\r\n// ── Personalization · Saved Filters framework (v2/personalization) ────────────\r\n// SaveFilterDialog is presentational; SavedFiltersMenu is connected to the\r\n// savedFilters capability via useSavedFilters.\r\nexport { default as SaveFilterDialog }     from \"./SaveFilterDialog\";\r\nexport { default as SavedFiltersMenu }     from \"./SavedFiltersMenu\";\r\n\r\n// ── Personalization · Favorites DataGrid integration (v2/personalization) ─────\r\n// makeFavoriteColumn builds an always-visible favorites column for v2.DataGrid;\r\n// FavoritesFilter is the all/favorites-only segmented control.\r\nexport { default as makeFavoriteColumn }   from \"./FavoriteColumn\";\r\nexport { default as FavoritesFilter }      from \"./FavoritesFilter\";\r\nexport type { FavoritesFilterProps, FavoritesFilterLabels } from \"./FavoritesFilter\";\r\n\r\n// ── Formik bridges ────────────────────────────────────────────────────────────\r\nexport { default as FormikInput }          from \"./FormikInput\";\r\nexport { default as FormikTextarea }       from \"./FormikTextarea\";\r\nexport { default as FormikSelect }         from \"./FormikSelect\";\r\nexport { default as FormikCombobox }       from \"./FormikCombobox\";\r\n/**\r\n * FormikCombobox props — public typed surface.\r\n *\r\n * SAME GAP-TS-003 CLASS as the ReferentielField note above. That fix covered\r\n * `ReferentielField` and `FormikReferentielField` but was not extended to the\r\n * other Formik bridges: the VALUE is exported while the type describing its props\r\n * is not, so a consumer cannot write `Omit<FormikComboboxProps<T>, …>`.\r\n *\r\n * REQUESTED BY bmdav-fe (TypeScript migration, batch 6f). That module stores the\r\n * OPTION OBJECT in Formik rather than a primitive key, because its payload mapper\r\n * reads `values.typeDemande.id` and sends `delegationTraitement` as a whole\r\n * object — so it cannot adopt the primitive-key model without changing the\r\n * request body sent to bmdav-be. It contains the resulting variance in ONE local\r\n * adapter (`ObjectValuedFormikCombobox`) rather than scattering assertions across\r\n * call sites, and that adapter must restate this component's prop contract minus\r\n * `getOptionValue`. The deep-import fallback is unavailable under\r\n * `moduleResolution: \"bundler\"`, since the package `exports` map does not expose\r\n * `dist/v2/patterns/*`.\r\n *\r\n * `ComboboxOptionValue` is deliberately NOT re-exported here — it is already\r\n * surfaced from `./components` (Combobox), and a second named export at the\r\n * library root would be a TS2308 ambiguity, exactly as recorded above for\r\n * `ReferentielSearchResult` / `ReferentielSearchParams`.\r\n *\r\n * Additive and type-only: no runtime change, no existing export altered.\r\n */\r\nexport type { FormikComboboxProps }        from \"./FormikCombobox\";\r\nexport { default as FormikDatePicker }     from \"./FormikDatePicker\";\r\nexport { default as FormikFile }           from \"./FormikFile\";\r\nexport { default as FormikCheckboxGroup }  from \"./FormikCheckboxGroup\";\r\nexport { default as FormikReferentielField } from \"./FormikReferentielField\";\r\nexport type { FormikReferentielFieldProps } from \"./FormikReferentielField\";\r\n\r\n/** Affichage valeur système — fond grisé, aucune interaction.\r\n *  Utiliser à la place de FormikInput disabled pour les champs\r\n *  auto-générés ou non modifiables par l'utilisateur. */\r\nexport { default as FormikDisplay }        from \"../components/FormikDisplay\";\r\n"],"mappings":"AAAA,SAASA,OAAO,IAAIC,SAAS,QAAmB,aAAa;AAE7D,SAASD,OAAO,IAAIE,aAAa,QAAe,iBAAiB;AACjE,SAASF,OAAO,IAAIG,aAAa,QAAe,iBAAiB;AACjE,SAASH,OAAO,IAAII,WAAW,QAAiB,eAAe;AAC/D,SAASJ,OAAO,IAAIK,aAAa,QAAe,iBAAiB;AACjE,SAASL,OAAO,IAAIM,gBAAgB,QAAY,oBAAoB;AAEpE;AACA;AACA,SAASN,OAAO,IAAIO,gBAAgB,QAAY,oBAAoB;AAEpE,SAASP,OAAO,IAAIQ,WAAW,QAAiB,eAAe;AAC/D,SAASR,OAAO,IAAIS,QAAQ,EAAEC,SAAS,QAAS,YAAY;AAC5D,SAASV,OAAO,IAAIW,mBAAmB,QAAS,uBAAuB;AACvE,SAASX,OAAO,IAAIY,oBAAoB,QAAQ,wBAAwB;AACxE,SAASZ,OAAO,IAAIa,eAAe,QAAa,mBAAmB;AACnE,SAASb,OAAO,IAAIc,mBAAmB,QAAS,uBAAuB;AACvE,SAASd,OAAO,IAAIe,cAAc,EAAEC,WAAW,QAAQ,kBAAkB;AACzE,SAAShB,OAAO,IAAIiB,kBAAkB,QAAU,sBAAsB;AACtE,SAASjB,OAAO,IAAIkB,gBAAgB,QAAY,oBAAoB;AACpE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMA,SAASlB,OAAO,IAAImB,IAAI,QAAwB,QAAQ;AACxD,SAASnB,OAAO,IAAIoB,qBAAqB,QAAQ,yBAAyB;AAC1E,SAASpB,OAAO,IAAIqB,2BAA2B,QAAQ,+BAA+B;;AAEtF;AACA;AACA;AACA,SAASrB,OAAO,IAAIsB,gBAAgB,QAAY,oBAAoB;AACpE,SAAStB,OAAO,IAAIuB,gBAAgB,QAAY,oBAAoB;;AAEpE;AACA;AACA;AACA,SAASvB,OAAO,IAAIwB,kBAAkB,QAAU,kBAAkB;AAClE,SAASxB,OAAO,IAAIyB,eAAe,QAAa,mBAAmB;AAGnE;AACA,SAASzB,OAAO,IAAI0B,WAAW,QAAiB,eAAe;AAC/D,SAAS1B,OAAO,IAAI2B,cAAc,QAAc,kBAAkB;AAClE,SAAS3B,OAAO,IAAI4B,YAAY,QAAgB,gBAAgB;AAChE,SAAS5B,OAAO,IAAI6B,cAAc,QAAc,kBAAkB;AAClE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAAS7B,OAAO,IAAI8B,gBAAgB,QAAY,oBAAoB;AACpE,SAAS9B,OAAO,IAAI+B,UAAU,QAAkB,cAAc;AAC9D,SAAS/B,OAAO,IAAIgC,mBAAmB,QAAS,uBAAuB;AACvE,SAAShC,OAAO,IAAIiC,sBAAsB,QAAQ,0BAA0B;AAG5E;AACA;AACA;AACA,SAASjC,OAAO,IAAIkC,aAAa,QAAe,6BAA6B","ignoreList":[]}
+{"version":3,"file":"index.js","names":["default","ActionBar","AppMain","BulkActionBar","ChartFigure","ColumnsToggle","FormSection","FormPageShell","FormErrorSummary","FormikErrorFocus","FormikErrorSummary","PageContent","DetailSplit","PreviewDrawer","DataGrid","applySort","DataGridVirtualized","DataGridSettingsMenu","DataGridToolbar","buildRowActions","buildRowActionMenu","MAX_ROW_ACTIONS","FilterTabBar","buildFilterChips","filterCriteriaKeys","isCriterionSet","CollapsibleDataGrid","SortableHeader","getAriaSort","NetworkErrorBanner","ReferentielField","Tour","KeyboardShortcutsHelp","DeleteResourceConfirmDialog","SaveFilterDialog","SavedFiltersMenu","makeFavoriteColumn","FavoritesFilter","RowFavoriteToggle","DEFAULT_ROW_FAVORITE_LABELS","FormikInput","FormikTextarea","FormikSelect","FormikCombobox","FormikDatePicker","FormikFile","FormikCheckboxGroup","FormikCheckbox","FormikRadioGroup","FormikDateTimePicker","FormikReferentielField","FormikDisplay"],"sources":["../../../../src/lib/v2/patterns/index.ts"],"sourcesContent":["export { default as ActionBar }            from \"./ActionBar\";\r\nexport type { ActionBarProps, ActionBarAction, ActionBarLabels, BreadcrumbItem, CrumbEntry } from \"./ActionBar\";\r\n/**\r\n * AppMain — the `<main>` landmark (gap G-53).\r\n *\r\n * The library shipped HALF of a two-part contract: `SkipLink`'s docblock\r\n * prescribes `<main id=\"main-content\">` as its target and the library never\r\n * provided it, so every module wrote the landmark — with `tabIndex={-1}`\r\n * (without which the skip link scrolls but does not move focus in Safari),\r\n * `outline: none` (R-F.1: the ring belongs on controls, not on a whole page),\r\n * and the content measure of R-L.5, a MUST nothing here honoured:\r\n * `PageContent` owns the canonical padding and caps NOTHING, so a certified\r\n * module still stretched its tables across a 1920 px display.\r\n *\r\n * Two copies existed in the portfolio (autorisation-admis-pour-conforme-fe and\r\n * the reference module ms-ti-fe), which is what a gap looks like from the\r\n * outside.\r\n */\r\nexport { default as AppMain }              from \"./AppMain\";\r\nexport type { AppMainProps, AppMainMeasure } from \"./AppMain\";\r\nexport { default as BulkActionBar }        from \"./BulkActionBar\";\r\n/**\r\n * ChartFigure — a chart, its title, and its TEXT EQUIVALENT (gap G-55).\r\n *\r\n * `tokens/chart` states the obligation and shipped nothing to meet it, in its\r\n * own words: the palette \"does not make a chart accessible. Every consumer\r\n * still owes a legend with text labels, and a text equivalent of the data —\r\n * 1.1.1 for the chart as a whole.\" A rule stated without a component to carry\r\n * it is met by whoever remembers it, and the text equivalent is the part that\r\n * goes missing first — the only one nobody SEES missing.\r\n *\r\n * Hence `caption` being REQUIRED: a chart rendered through here cannot ship\r\n * without its numbers in text. The canvas is `aria-hidden` (a renderer emits\r\n * dozens of unstructured SVG text nodes, which is noise worse than silence) —\r\n * so no interactive control goes inside it.\r\n */\r\nexport { default as ChartFigure }          from \"./ChartFigure\";\r\nexport type { ChartFigureProps }           from \"./ChartFigure\";\r\nexport { default as ColumnsToggle }        from \"./ColumnsToggle\";\r\nexport { default as FormSection }          from \"./FormSection\";\r\nexport { default as FormPageShell }        from \"./FormPageShell\";\r\nexport { default as FormErrorSummary }     from \"./FormErrorSummary\";\r\nexport type { FormErrorSummaryProps, FormErrorSummaryError } from \"./FormErrorSummary\";\r\n// R-FV.3 companion to FormErrorSummary (R-FV.2) — renders nothing, moves\r\n// focus to the first field in error after a failed submit. Adopt both.\r\nexport { default as FormikErrorFocus }     from \"./FormikErrorFocus\";\r\nexport type { FormikErrorFocusProps }      from \"./FormikErrorFocus\";\r\n/**\r\n * FormikErrorSummary — the Formik bridge for FormErrorSummary (R-FV.2).\r\n *\r\n * The library owned all three parts of the failed-submit recipe and no way to\r\n * assemble them inside the form shape modules actually write:\r\n * `FormErrorSummary` renders the banner from a flat list,\r\n * `flattenFormikErrors` (G-38) produces that list, `focusFieldByName`\r\n * (R-FV.3) resolves an item back to its control.\r\n *\r\n * Reaching `errors` / `submitCount` needs the Formik CONTEXT, and the\r\n * prevailing shape is `<Formik><Form>…</Form></Formik>` with STATIC children —\r\n * the host's body sits outside the provider, and `innerRef` does not help\r\n * because mutating a ref does not re-render the holder when `errors` changes.\r\n * So each host had to convert its form to a render-prop purely to reach the\r\n * errors, or write a local null-rendering context reader.\r\n *\r\n * Raised from ms-ti-fe (Area 11), where ONE of eleven Formik forms had the\r\n * banner: wiring the other ten meant ten copies of that wrapper. The sibling\r\n * rule HAS a bridge (`FormikErrorFocus`), which is why field adoption of the\r\n * two MUSTs diverged — the one needing boilerplate is the one nobody applied.\r\n */\r\nexport { default as FormikErrorSummary }   from \"./FormikErrorSummary\";\r\nexport type { FormikErrorSummaryProps }    from \"./FormikErrorSummary\";\r\nexport { default as PageContent }          from \"./PageContent\";\r\n/**\r\n * DetailSplit — content + progression rail on a consultation page (gap G-44).\r\n *\r\n * §Detail / Consultation Pattern makes the vertical progress rail a MUST on\r\n * every consultation page, and §07 R-L.7 fixes the skeleton. The library shipped\r\n * the rail (`VStepper`) and not the geometry that places it beside the record,\r\n * so each host wrote the same three-value flex row by hand.\r\n *\r\n * Promoted from `refonte-frontend` (Area 4), where the SAME row existed twice\r\n * — `DetailPage` and `TraitementDemande` — with `560` / `300` / `260` written\r\n * out in both (R-2.3), and already drifting: neither `<aside>` had an\r\n * accessible name. Widths now live in `tokens.layout.detail`.\r\n */\r\nexport { default as DetailSplit }          from \"./DetailSplit\";\r\nexport type { DetailSplitProps }           from \"./DetailSplit\";\r\n/**\r\n * PreviewDrawer — the listing preview, body included (gap G-40).\r\n *\r\n * §Row Interaction and §Preview Drawer are MUST on every listing page of the\r\n * platform, and the library shipped only `Drawer`, the empty shell. Each module\r\n * assembled the same summary by hand, and the copies drifted where it shows\r\n * least: `ms-ti-fe` uses `KVGrid` + `KV`, `refonte-frontend` had built a local\r\n * `<dl>` with its own grid — one concept, two renderings (R-2.1).\r\n *\r\n * Promoted from `refonte-frontend` (Area 5). Reads NO field of `row`, which is\r\n * what removed the `as unknown as` assertion its single-component ancestor\r\n * needed; business defaults live in a host wrapper over a concrete row type.\r\n */\r\nexport { default as PreviewDrawer }        from \"./PreviewDrawer\";\r\nexport type {\r\n  PreviewDrawerProps,\r\n  PreviewDrawerItem,\r\n  PreviewDrawerLabels,\r\n} from \"./PreviewDrawer\";\r\nexport { default as DataGrid, applySort }  from \"./DataGrid\";\r\n/**\r\n * DataGridVirtualized — la seconde table, pour les grands volumes.\r\n *\r\n * Sa frontière d'emploi est énoncée dans son propre en-tête : au-delà de mille\r\n * lignes où la pagination paraîtrait artificielle (journaux d'audit, « tout\r\n * afficher ») ; sous cent lignes, `DataGrid` est plus simple.\r\n *\r\n * >>> LES TYPES SONT AJOUTÉS ICI (audit lot 12, Area 13) — MÊME CLASSE\r\n * >>> GAP-TS-003 QUE CE FICHIER DOCUMENTE DÉJÀ CINQ FOIS. La VALEUR était\r\n * >>> exportée, les types décrivant ses props ne l'étaient pas : un hôte ne\r\n * >>> pouvait donc ni écrire un adaptateur typé autour de ce composant, ni\r\n * >>> nommer `DataGridVirtualizedDensity` — dont il a besoin, puisque ce\r\n * >>> palier de HAUTEUR DE LIGNE compte quatre valeurs là où le `Density`\r\n * >>> canonique en a deux. Le repli aurait été un jumeau local, que les\r\n * >>> Platform TypeScript Guidelines interdisent.\r\n * >>>\r\n * >>> Relevé depuis `autorisation-admis-pour-conforme-fe` (Area 13) : ce\r\n * >>> module n'utilise pas ce composant — il pagine côté serveur — mais son\r\n * >>> audit RGESN a dû établir où vivait la virtualisation, et a trouvé une\r\n * >>> capacité complète dont la surface type était muette.\r\n * >>>\r\n * >>> Additif et purement typographique : aucun changement d'exécution. <<<\r\n */\r\nexport { default as DataGridVirtualized }  from \"./DataGridVirtualized\";\r\nexport type {\r\n  DataGridVirtualizedProps,\r\n  DataGridVirtualizedDensity,\r\n} from \"./DataGridVirtualized\";\r\nexport { default as DataGridSettingsMenu } from \"./DataGridSettingsMenu\";\r\nexport { default as DataGridToolbar }      from \"./DataGridToolbar\";\r\n/**\r\n * rowActions — business descriptors → the row's kebab menu (gap G-41).\r\n *\r\n * The library shipped both halves — `OverflowMenu` renders flat actions,\r\n * `DataGrid.rowActions` takes a `(row) => ReactNode` — and not the step\r\n * between them, which every listing wrote for itself while carrying three\r\n * Charter rules (R-3.3, R-B.6, R-K.1).\r\n *\r\n * `buildRowActionMenu` is exported alongside the renderer on purpose: a row\r\n * appears twice, as a table row and as a `MobileRowCard` whose `actions` prop\r\n * takes `OverflowMenuAction[]` rather than a node. Without it, hosts rebuilt\r\n * the menu by hand for the card and the two copies drifted — the same failure\r\n * the library records for `RowFavoriteToggle` (G-36).\r\n *\r\n * Promoted from `refonte-frontend` (Area 5), where it served twelve screens.\r\n */\r\nexport {\r\n  buildRowActions,\r\n  buildRowActionMenu,\r\n  MAX_ROW_ACTIONS,\r\n} from \"./rowActions\";\r\nexport type { RowActionDescriptor, BuildRowActionsOptions } from \"./rowActions\";\r\n/**\r\n * FilterTabBar — the status-chip bar of a listing card (gap G-45).\r\n *\r\n * §Status Chips is a MUST on every listing, and the library shipped the PILL\r\n * (`FilterTab`) without the bar that seats it — so each listing re-derived the\r\n * row geometry, the card-header separator, and the split between the status\r\n * group and the personalization controls.\r\n *\r\n * Promoted from `refonte-frontend` (Area 5), where FOUR listings carried the\r\n * same `BARRE_CHIPS_STATUT` + `GROUPE_BARRE` pair — and had already drifted:\r\n * one of the four omitted `justifyContent: \"space-between\"`, so the same\r\n * listing family rendered two different layouts (R-2.1).\r\n */\r\nexport { default as FilterTabBar }         from \"./FilterTabBar\";\r\nexport type { FilterTabBarProps }          from \"./FilterTabBar\";\r\n/**\r\n * filterCriteria — active criteria as removable chips (gap G-42).\r\n *\r\n * The library owned the RENDERING (`DataGridToolbar.filterChips` and the\r\n * `DataGridToolbarFilterChip` type, itself added at this module's request) and\r\n * not the builder. Ten local copies would have drifted on the two things that\r\n * are not obvious: what counts as SET (`0` is the unset value of a reference\r\n * mirror on several hosts) and what a removal must CLEAR (reference criteria\r\n * are held as pairs, so clearing only the displayed key leaves an invisible\r\n * filter that still filters).\r\n *\r\n * Pair with `useAppliedFilters`. Promoted from `refonte-frontend` (Area 5).\r\n */\r\nexport {\r\n  buildFilterChips,\r\n  filterCriteriaKeys,\r\n  isCriterionSet,\r\n} from \"./filterCriteria\";\r\nexport type { FilterCriterion } from \"./filterCriteria\";\r\n/**\r\n * DataGridToolbar contracts — public typed surface (gap G-I).\r\n *\r\n * Meme defaut que les blocs `StepStatus`, `FieldHelp`, `Status` et `Field` :\r\n * la barre d'outils etait exportee comme VALEUR, sans les types de ses props.\r\n * `DataGridToolbarFilterChip` est celui qui manque le plus : §Filters et\r\n * §Search des Platform Mandatory UX Patterns imposent des criteres actifs\r\n * retirables, `filterChips` est la capacite qui les rend, et un hote qui\r\n * construit ce tableau a besoin de la forme d'une entree.\r\n *\r\n * Sans le type, il redeclare `{ key, label, onRemove }` au point d'appel — ce\r\n * que les Platform TypeScript Guidelines interdisent (« Reusable types belong\r\n * inside Shared UI Library … Never duplicate »). Releve depuis\r\n * `refonte-frontend` (lot 8, ecart A9), ou dix listings doivent construire ces\r\n * pastilles a partir d'une brique partagee.\r\n *\r\n * `DataGridToolbarLabels` voyage avec : un hote qui traduit la barre d'outils\r\n * en a besoin, et c'est la meme duplication un niveau plus bas.\r\n *\r\n * FLAT-ONLY, per the policy note in src/lib/index.ts.\r\n * Additive and type-only: no runtime change, no existing export altered.\r\n */\r\nexport type {\r\n  DataGridToolbarProps,\r\n  DataGridToolbarFilterChip,\r\n  DataGridToolbarLabels,\r\n} from \"./DataGridToolbar\";\r\nexport { default as CollapsibleDataGrid }  from \"./CollapsibleDataGrid\";\r\nexport { default as SortableHeader, getAriaSort } from \"./SortableHeader\";\r\nexport { default as NetworkErrorBanner }   from \"./NetworkErrorBanner\";\r\nexport { default as ReferentielField }     from \"./ReferentielField\";\r\n/**\r\n * ReferentielField configuration types — public typed surface.\r\n *\r\n * Same class of gap as Gap-TS-003 (component types), which was fixed for\r\n * `./components` but never extended to `./patterns`: the VALUE above was\r\n * exported while the types describing its own REQUIRED props were not.\r\n * `columns` and `criteria` are mandatory-to-configure, so a consumer had no\r\n * way to type them without either deep-importing\r\n * `@portnet/ui/dist/v2/patterns/…` (fragile, bypasses the `exports` map) or\r\n * declaring a local twin — which the Platform TypeScript Guidelines forbid\r\n * (\"Reusable types belong inside Shared UI Library … Never duplicate\").\r\n *\r\n * `ReferentielSearchResult` and `ReferentielSearchParams` are deliberately\r\n * NOT re-exported here: identically-named types are already surfaced from\r\n * `./referentiel` (useReferentielSearch) and `./v2/models` respectively, and\r\n * `src/lib/index.ts` star-exports all three barrels — a second named export of\r\n * either identifier is a hard TS2308 ambiguity at the library root.\r\n *\r\n * Additive and type-only: no runtime change, no existing export altered.\r\n */\r\nexport type {\r\n  ReferentielFieldProps,\r\n  ReferentielCriterion,\r\n  ReferentielFieldLabels,\r\n} from \"./ReferentielField\";\r\nexport { default as Tour }                 from \"./Tour\";\r\nexport { default as KeyboardShortcutsHelp } from \"./KeyboardShortcutsHelp\";\r\nexport { default as DeleteResourceConfirmDialog } from \"./DeleteResourceConfirmDialog\";\r\n\r\n// ── Personalization · Saved Filters framework (v2/personalization) ────────────\r\n// SaveFilterDialog is presentational; SavedFiltersMenu is connected to the\r\n// savedFilters capability via useSavedFilters.\r\nexport { default as SaveFilterDialog }     from \"./SaveFilterDialog\";\r\nexport { default as SavedFiltersMenu }     from \"./SavedFiltersMenu\";\r\n\r\n// ── Personalization · Favorites DataGrid integration (v2/personalization) ─────\r\n// makeFavoriteColumn builds an always-visible favorites column for v2.DataGrid;\r\n// FavoritesFilter is the all/favorites-only segmented control.\r\nexport { default as makeFavoriteColumn }   from \"./FavoriteColumn\";\r\nexport { default as FavoritesFilter }      from \"./FavoritesFilter\";\r\nexport type { FavoritesFilterProps, FavoritesFilterLabels } from \"./FavoritesFilter\";\r\n\r\n/**\r\n * RowFavoriteToggle — the per-row follow star, standalone (gap G-36).\r\n *\r\n * It already existed as a PRIVATE `FavoriteCell` inside `makeFavoriteColumn`,\r\n * which made the follow control reachable as a DataGrid column and nowhere\r\n * else. The other place a row always appears is the mobile card: `DataGrid`\r\n * swaps to `renderMobileCard` below its `mobileBreakpoint`, and\r\n * `MobileRowCard` has a `leading` slot for exactly this — but a column\r\n * definition cannot be rendered into a slot, so hosts rebuilt the star by\r\n * hand (`onssa-export-fe`'s `MobileFavoriteToggle`; `ms-ti-fe` destructures\r\n * the same MobileRowCard + FavoriteToggle + useIsFavorite trio).\r\n *\r\n * Same failure mode as G-10: the library owned the behaviour but exposed it at\r\n * one composition point only. And the copies drifted where it is least visible\r\n * and matters most — the local twin announced \"Ajouter aux favoris\" while the\r\n * grid column on the same page said \"Suivre\", and it dropped the status\r\n * tooltip. `makeFavoriteColumn` now renders this component, so the two agree\r\n * by construction.\r\n */\r\nexport { default as RowFavoriteToggle, DEFAULT_ROW_FAVORITE_LABELS } from \"./RowFavoriteToggle\";\r\nexport type {\r\n  RowFavoriteToggleProps,\r\n  RowFavoriteToggleLabels,\r\n  FavoriteToggleSize,\r\n} from \"./RowFavoriteToggle\";\r\n\r\n// ── Formik bridges ────────────────────────────────────────────────────────────\r\nexport { default as FormikInput }          from \"./FormikInput\";\r\nexport { default as FormikTextarea }       from \"./FormikTextarea\";\r\nexport { default as FormikSelect }         from \"./FormikSelect\";\r\nexport { default as FormikCombobox }       from \"./FormikCombobox\";\r\n/**\r\n * FormikCombobox props — public typed surface.\r\n *\r\n * SAME GAP-TS-003 CLASS as the ReferentielField note above. That fix covered\r\n * `ReferentielField` and `FormikReferentielField` but was not extended to the\r\n * other Formik bridges: the VALUE is exported while the type describing its props\r\n * is not, so a consumer cannot write `Omit<FormikComboboxProps<T>, …>`.\r\n *\r\n * REQUESTED BY bmdav-fe (TypeScript migration, batch 6f). That module stores the\r\n * OPTION OBJECT in Formik rather than a primitive key, because its payload mapper\r\n * reads `values.typeDemande.id` and sends `delegationTraitement` as a whole\r\n * object — so it cannot adopt the primitive-key model without changing the\r\n * request body sent to bmdav-be. It contains the resulting variance in ONE local\r\n * adapter (`ObjectValuedFormikCombobox`) rather than scattering assertions across\r\n * call sites, and that adapter must restate this component's prop contract minus\r\n * `getOptionValue`. The deep-import fallback is unavailable under\r\n * `moduleResolution: \"bundler\"`, since the package `exports` map does not expose\r\n * `dist/v2/patterns/*`.\r\n *\r\n * `ComboboxOptionValue` is deliberately NOT re-exported here — it is already\r\n * surfaced from `./components` (Combobox), and a second named export at the\r\n * library root would be a TS2308 ambiguity, exactly as recorded above for\r\n * `ReferentielSearchResult` / `ReferentielSearchParams`.\r\n *\r\n * Additive and type-only: no runtime change, no existing export altered.\r\n */\r\nexport type { FormikComboboxProps }        from \"./FormikCombobox\";\r\nexport { default as FormikDatePicker }     from \"./FormikDatePicker\";\r\nexport { default as FormikFile }           from \"./FormikFile\";\r\nexport { default as FormikCheckboxGroup }  from \"./FormikCheckboxGroup\";\r\n/**\r\n * FormikCheckbox — pont pour une case a cocher BOOLEENNE simple (gap G-A).\r\n *\r\n * `FormikCheckboxGroup` porte un TABLEAU de valeurs selectionnees : un hote\r\n * dont l'etat est un booleen (`autreInfo.fabrication`,\r\n * `objectDeclaration.premiereDeclaration`) ne peut pas l'adopter sans changer\r\n * ce que son payload envoie. Faute de pont, les modules recablaient\r\n * `Checkbox` + `useField` a la main — duplication interdite par R-2.1, et qui\r\n * perdait systematiquement le rendu de l'erreur (R-4.1 MUST).\r\n *\r\n * Le type de props est expose : meme classe que Gap-TS-003 ci-dessus.\r\n */\r\nexport { default as FormikCheckbox }       from \"./FormikCheckbox\";\r\nexport type { FormikCheckboxProps }        from \"./FormikCheckbox\";\r\n/**\r\n * FormikRadioGroup — pont pour un groupe de radios (gap G-C).\r\n *\r\n * R-Sel.2 est un MUST : 2-3 options -> Radio ou Segmented, jamais un Select.\r\n * Toute question metier binaire passe donc par `RadioGroup`, qui n'avait aucun\r\n * pont Formik la ou `FormikSelect`, `FormikCombobox`, `FormikCheckboxGroup` et\r\n * les autres en ont un. Les hotes recablaient `useField` + `RadioGroup` a la\r\n * main, et y perdaient `FieldError`.\r\n *\r\n * Contrat invisible a connaitre : la valeur ECRITE est celle DECLAREE dans\r\n * `options`, pas la chaine que rapporte le DOM — un hote aux options\r\n * numeriques continue de stocker des nombres.\r\n */\r\nexport { default as FormikRadioGroup }     from \"./FormikRadioGroup\";\r\nexport type { FormikRadioGroupProps }      from \"./FormikRadioGroup\";\r\n/**\r\n * FormikDateTimePicker — pont date + HEURE (gap G-E).\r\n *\r\n * `FormikDatePicker` etait le seul pont de date de la library, et il est\r\n * date-seule. Un hote ayant besoin de l'heure devait soit la perdre — ce qui\r\n * change ce que recoit le backend, pas seulement l'affichage — soit recabler\r\n * `useField` + le `DateTimePicker` nu, donc dupliquer.\r\n *\r\n * Les deux ponts PARTAGENT `coerceToDate` / `serialiseDate`\r\n * (`./_pickerSerialisation`) : voir la note S-03 de `FormikDatePicker` pour ce\r\n * qui arrive quand la lecture et l'ecriture d'une date divergent.\r\n */\r\nexport { default as FormikDateTimePicker } from \"./FormikDateTimePicker\";\r\nexport type { FormikDateTimePickerProps }  from \"./FormikDateTimePicker\";\r\nexport { default as FormikReferentielField } from \"./FormikReferentielField\";\r\nexport type { FormikReferentielFieldProps } from \"./FormikReferentielField\";\r\n\r\n/** Affichage valeur système — fond grisé, aucune interaction.\r\n *  Utiliser à la place de FormikInput disabled pour les champs\r\n *  auto-générés ou non modifiables par l'utilisateur. */\r\nexport { default as FormikDisplay }        from \"../components/FormikDisplay\";\r\n"],"mappings":"AAAA,SAASA,OAAO,IAAIC,SAAS,QAAmB,aAAa;AAE7D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASD,OAAO,IAAIE,OAAO,QAAqB,WAAW;AAE3D,SAASF,OAAO,IAAIG,aAAa,QAAe,iBAAiB;AACjE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASH,OAAO,IAAII,WAAW,QAAiB,eAAe;AAE/D,SAASJ,OAAO,IAAIK,aAAa,QAAe,iBAAiB;AACjE,SAASL,OAAO,IAAIM,WAAW,QAAiB,eAAe;AAC/D,SAASN,OAAO,IAAIO,aAAa,QAAe,iBAAiB;AACjE,SAASP,OAAO,IAAIQ,gBAAgB,QAAY,oBAAoB;AAEpE;AACA;AACA,SAASR,OAAO,IAAIS,gBAAgB,QAAY,oBAAoB;AAEpE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAAST,OAAO,IAAIU,kBAAkB,QAAU,sBAAsB;AAEtE,SAASV,OAAO,IAAIW,WAAW,QAAiB,eAAe;AAC/D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASX,OAAO,IAAIY,WAAW,QAAiB,eAAe;AAE/D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASZ,OAAO,IAAIa,aAAa,QAAe,iBAAiB;AAMjE,SAASb,OAAO,IAAIc,QAAQ,EAAEC,SAAS,QAAS,YAAY;AAC5D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASf,OAAO,IAAIgB,mBAAmB,QAAS,uBAAuB;AAKvE,SAAShB,OAAO,IAAIiB,oBAAoB,QAAQ,wBAAwB;AACxE,SAASjB,OAAO,IAAIkB,eAAe,QAAa,mBAAmB;AACnE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SACEC,eAAe,EACfC,kBAAkB,EAClBC,eAAe,QACV,cAAc;AAErB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASrB,OAAO,IAAIsB,YAAY,QAAgB,gBAAgB;AAEhE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SACEC,gBAAgB,EAChBC,kBAAkB,EAClBC,cAAc,QACT,kBAAkB;;AAEzB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMA,SAASzB,OAAO,IAAI0B,mBAAmB,QAAS,uBAAuB;AACvE,SAAS1B,OAAO,IAAI2B,cAAc,EAAEC,WAAW,QAAQ,kBAAkB;AACzE,SAAS5B,OAAO,IAAI6B,kBAAkB,QAAU,sBAAsB;AACtE,SAAS7B,OAAO,IAAI8B,gBAAgB,QAAY,oBAAoB;AACpE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMA,SAAS9B,OAAO,IAAI+B,IAAI,QAAwB,QAAQ;AACxD,SAAS/B,OAAO,IAAIgC,qBAAqB,QAAQ,yBAAyB;AAC1E,SAAShC,OAAO,IAAIiC,2BAA2B,QAAQ,+BAA+B;;AAEtF;AACA;AACA;AACA,SAASjC,OAAO,IAAIkC,gBAAgB,QAAY,oBAAoB;AACpE,SAASlC,OAAO,IAAImC,gBAAgB,QAAY,oBAAoB;;AAEpE;AACA;AACA;AACA,SAASnC,OAAO,IAAIoC,kBAAkB,QAAU,kBAAkB;AAClE,SAASpC,OAAO,IAAIqC,eAAe,QAAa,mBAAmB;AAGnE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASrC,OAAO,IAAIsC,iBAAiB,EAAEC,2BAA2B,QAAQ,qBAAqB;AAO/F;AACA,SAASvC,OAAO,IAAIwC,WAAW,QAAiB,eAAe;AAC/D,SAASxC,OAAO,IAAIyC,cAAc,QAAc,kBAAkB;AAClE,SAASzC,OAAO,IAAI0C,YAAY,QAAgB,gBAAgB;AAChE,SAAS1C,OAAO,IAAI2C,cAAc,QAAc,kBAAkB;AAClE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAAS3C,OAAO,IAAI4C,gBAAgB,QAAY,oBAAoB;AACpE,SAAS5C,OAAO,IAAI6C,UAAU,QAAkB,cAAc;AAC9D,SAAS7C,OAAO,IAAI8C,mBAAmB,QAAS,uBAAuB;AACvE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAAS9C,OAAO,IAAI+C,cAAc,QAAc,kBAAkB;AAElE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAAS/C,OAAO,IAAIgD,gBAAgB,QAAY,oBAAoB;AAEpE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAAShD,OAAO,IAAIiD,oBAAoB,QAAQ,wBAAwB;AAExE,SAASjD,OAAO,IAAIkD,sBAAsB,QAAQ,0BAA0B;AAG5E;AACA;AACA;AACA,SAASlD,OAAO,IAAImD,aAAa,QAAe,6BAA6B","ignoreList":[]}

package/dist/esm/v2/patterns/rowActions.js

@@ -0,0 +1,223 @@
+import * as React from "react";
+import OverflowMenu from "../components/OverflowMenu";
+import Button from "../components/Button";
+import Tooltip from "../components/Tooltip";
+
+/**
+ * rowActions — business action descriptors → the row's kebab menu
+ * (capability gap G-41).
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * WHY THIS BELONGS IN THE LIBRARY
+ *
+ * The library ships both halves already: `OverflowMenu` renders a flat list of
+ * actions, and `DataGrid.rowActions` takes a `(row) => ReactNode` renderer. The
+ * step between them is what every listing writes for itself — turning the
+ * BUSINESS description of an action ("visible only on a draft", "greyed out
+ * while the request is in flight") into a menu for ONE row.
+ *
+ * That step is not glue. It carries three rules the Charter imposes, and each
+ * one is a rule a host can only get right by re-deriving it:
+ *
+ *   R-3.3   ≤ 1 primary + ≤ 3 secondary actions per screen, hence the kebab.
+ *   R-B.6   a destructive action is separated and marked, not merely last.
+ *   R-K.1   every mouse-reachable action is keyboard-reachable — which is what
+ *           `OverflowMenu` gives and what hover-revealed icon rows never did.
+ *
+ * Promoted from `refonte-frontend` (Area 5), where it served TWELVE screens and
+ * had already replaced a local `TableActions` that revealed its actions on
+ * hover, via a `mouseup` listener on `document`, with no keyboard equivalent
+ * and no `role` / `aria-*`. On those screens, consulting, editing or deleting a
+ * file was unreachable without a mouse — the Charter lists "hover-only
+ * interactions" among its Forbidden Practices for exactly this reason.
+ * ─────────────────────────────────────────────────────────────────────────────
+ *
+ * PREDICATES, NOT BOOLEANS, AND THAT IS THE WHOLE POINT. `hidden` and
+ * `disabled` take the ROW: an action's availability depends on the state of
+ * that row, so it must be evaluated per row, at render. A boolean would force
+ * the host to rebuild the descriptor array per row — which is how a card and a
+ * table row end up offering different actions for the same record.
+ *
+ * >>> THE TWO SURFACES ARE WHY `buildRowActionMenu` IS EXPORTED SEPARATELY.
+ * >>> A row appears twice: as a table row and, below the mobile breakpoint, as
+ * >>> a `MobileRowCard` whose `actions` prop takes `OverflowMenuAction[]` —
+ * >>> not a node. With only the renderer exported, a host had to rebuild the
+ * >>> menu by hand for the card, and the two copies drifted on the danger
+ * >>> separator, the overflow warning and the evaluation of the predicates.
+ * >>> The library documents that exact failure for `RowFavoriteToggle`
+ * >>> (gap G-36): the local twin announced "Ajouter aux favoris" while the
+ * >>> grid column on the same page said "Suivre". Same shape, one level up. <
+ *
+ * Usage:
+ *
+ *   const descriptors: RowActionDescriptor<Dossier>[] = [
+ *     { id: "open", label: "Consulter le dossier", icon: <Visibility />, onClick: open },
+ *     { id: "del",  label: "Supprimer définitivement", icon: <Delete />,
+ *       onClick: remove, danger: true, hidden: (row) => row.status !== "DRAFT" },
+ *   ];
+ *
+ *   <DataGrid rowActions={buildRowActions(descriptors, `Actions sur ${row.reference}`)} />
+ *   <MobileRowCard actions={buildRowActionMenu(descriptors, row)} />
+ */
+
+/** Charter contract of `OverflowMenu`: ancillary row actions, ≤ 7 items. */
+import { jsx as _jsx } from "react/jsx-runtime";
+export const MAX_ROW_ACTIONS = 7;
+
+/**
+ * One row action, described by the business.
+ *
+ * `hidden` and `disabled` are PREDICATES on the row, not booleans — see the
+ * note above.
+ */
+
+/**
+ * Menu items for ONE row. Predicates are evaluated here, per call.
+ *
+ * Returns an empty array when nothing is visible, so a caller can decide to
+ * render no trigger at all rather than an empty menu.
+ */
+export function buildRowActionMenu(descriptors, row) {
+  const visible = descriptors.filter(d => !d.hidden?.(row));
+  if (visible.length === 0) return [];
+
+  /* `process.env["NODE_ENV"]` and not `.NODE_ENV`:
+   * `noPropertyAccessFromIndexSignature` is mandatory platform-wide, precisely
+   * so a missing key cannot read as a guaranteed field. */
+  if (process.env["NODE_ENV"] !== "production" && visible.length > MAX_ROW_ACTIONS) {
+    // eslint-disable-next-line no-console
+    console.warn(`[@portnet/ui] buildRowActionMenu: ${visible.length} actions visible on ` + `one row; OverflowMenu's contract recommends at most ${MAX_ROW_ACTIONS} ` + `(R-3.3). Group them, or move some to the detail page.`);
+  }
+  const items = [];
+  let separatorPlaced = false;
+  visible.forEach(d => {
+    /* Separator before the FIRST destructive action, and only if something
+     * precedes it — a menu does not open on a rule. */
+    if (d.danger && !separatorPlaced && items.length > 0) {
+      items.push({
+        divider: true
+      });
+      separatorPlaced = true;
+    }
+    /* Conditional spreads, not `undefined` values: `exactOptionalPropertyTypes`
+     * is mandatory platform-wide, so an explicit `undefined` is not the same as
+     * an absent key — and `mergeLabels` exists in this library because a spread
+     * of `undefined` had silently deleted defaults elsewhere. */
+    items.push({
+      label: d.label,
+      ...(d.icon !== undefined ? {
+        icon: d.icon
+      } : {}),
+      onClick: () => d.onClick(row),
+      ...(d.danger !== undefined ? {
+        danger: d.danger
+      } : {}),
+      ...(d.disabled ? {
+        disabled: d.disabled(row)
+      } : {}),
+      ...(d.shortcut !== undefined ? {
+        shortcut: d.shortcut
+      } : {})
+    });
+  });
+  return items;
+}
+
+/**
+ * Options of {@link buildRowActions}.
+ */
+
+/**
+ * Renderer for `DataGrid.rowActions`.
+ *
+ * Predicates are evaluated per row, at each cell render. Renders nothing when
+ * no action is visible for that row, rather than a trigger that opens an empty
+ * menu.
+ *
+ * NO DEFAULT `ariaLabel` (defect D-12). It used to default to the literal
+ * "Actions", which was forwarded to `OverflowMenu`'s `ariaLabel` — and that
+ * prop WINS over `labels.trigger`. So a row kebab built here announced
+ * "Actions" while every other kebab in the fleet announced OverflowMenu's
+ * canonical "Plus d'actions": one concept, two names, which R-2.4 forbids.
+ * `MobileRowCard` had the identical defect and was fixed by removing its
+ * default; this is the same repair, applied one level up. Omit the argument
+ * and OverflowMenu now names itself.
+ *
+ * PASS A CONTEXTUAL NAME ANYWAY. Neither default is good in a list: twenty
+ * identically-named kebabs give a screen-reader user no way to tell which row
+ * they are on. `Actions sur le dossier 2025-IM-00042` does.
+ *
+ * TWO SHAPES, ONE CONTRACT (`iconsUpTo` — promoted from `refonte-frontend`,
+ * Area 5). The kebab is the right shape for many or ancillary actions; a row
+ * with two or three primary ones reads better as icon buttons, and
+ * §Row Interaction treats those as COMPLEMENTARY to the row click. Hosts were
+ * writing that second shape themselves — this module served twelve screens
+ * with a local copy — which put the R-B.5 `aria-label`, the danger variant and
+ * the fallback rule outside the library.
+ *
+ * NOT hover-only, and that distinction is what makes it admissible: `DataGrid`
+ * reveals this renderer's output through `ROW_ACTIONS_OVERLAY_SX`, which keys
+ * on `tr:hover`, `tr:focus-within` AND `@media (pointer: coarse)` — so the
+ * buttons are reachable by keyboard and on touch (R-K.1). A host that renders
+ * an icon row elsewhere, without that overlay, owns that requirement itself.
+ *
+ * Above the threshold the menu is built by {@link buildRowActionMenu}, so the
+ * danger separator and the R-3.3 overflow warning are not re-derived here.
+ *
+ * @param descriptors actions in display order
+ * @param ariaLabel   accessible name of the trigger. Omit to inherit
+ *                    OverflowMenu's canonical name; prefer a row-specific one.
+ * @param options     `{ iconsUpTo }` — see {@link BuildRowActionsOptions}
+ */
+export function buildRowActions(descriptors, ariaLabel, options) {
+  const iconsUpTo = options?.iconsUpTo;
+  return row => {
+    /* SAME predicate as `buildRowActionMenu`: how many actions this row
+     * actually shows decides the shape, so it must be known before the menu
+     * is built. */
+    const visible = descriptors.filter(d => !d.hidden?.(row));
+    if (visible.length === 0) return null;
+    if (iconsUpTo !== undefined && visible.length <= iconsUpTo) {
+      /* No spacing container here: `ROW_ACTIONS_OVERLAY_SX` (DataGrid) is
+       * already a flex row with `gap: var(--s-1)`. Re-posing one would
+       * duplicate the same token one level lower. */
+      return visible.map(d => {
+        const textLabel = typeof d.label === "string" ? d.label : undefined;
+        if (process.env["NODE_ENV"] !== "production" && textLabel === undefined) {
+          // eslint-disable-next-line no-console
+          console.warn(`[@portnet/ui] buildRowActions: action "${d.id}" has a non-textual ` + "label, so its icon button gets no explicit aria-label (R-B.5). " + "Give the descriptor a string label, or drop `iconsUpTo` for this grid.");
+        }
+        return /*#__PURE__*/_jsx(Tooltip, {
+          title: d.label,
+          children: /*#__PURE__*/_jsx(Button, {
+            iconOnly: true,
+            variant: d.danger ? "danger" : "ghost",
+            size: "sm",
+            ...(d.icon !== undefined ? {
+              icon: d.icon
+            } : {}),
+            onClick: () => d.onClick(row),
+            ...(d.disabled ? {
+              disabled: d.disabled(row)
+            } : {}),
+            ...(textLabel !== undefined ? {
+              "aria-label": textLabel
+            } : {})
+          })
+        }, d.id);
+      });
+    }
+    const items = buildRowActionMenu(descriptors, row);
+    if (items.length === 0) return null;
+    /* Conditional spread rather than ariaLabel={ariaLabel}: passing an
+     * explicit undefined would still override OverflowMenu's own label
+     * under exactOptionalPropertyTypes semantics (defect D-12). */
+    return /*#__PURE__*/_jsx(OverflowMenu, {
+      actions: items,
+      ...(ariaLabel !== undefined ? {
+        ariaLabel
+      } : {})
+    });
+  };
+}
+//# sourceMappingURL=rowActions.js.map

package/dist/esm/v2/patterns/rowActions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rowActions.js","names":["React","OverflowMenu","Button","Tooltip","jsx","_jsx","MAX_ROW_ACTIONS","buildRowActionMenu","descriptors","row","visible","filter","d","hidden","length","process","env","console","warn","items","separatorPlaced","forEach","danger","push","divider","label","icon","undefined","onClick","disabled","shortcut","buildRowActions","ariaLabel","options","iconsUpTo","map","textLabel","id","title","children","iconOnly","variant","size","actions"],"sources":["../../../../src/lib/v2/patterns/rowActions.tsx"],"sourcesContent":["import * as React from \"react\";\r\nimport OverflowMenu from \"../components/OverflowMenu\";\r\nimport type { OverflowMenuAction } from \"../components/OverflowMenu\";\r\nimport Button from \"../components/Button\";\r\nimport Tooltip from \"../components/Tooltip\";\r\n\r\n/**\r\n * rowActions — business action descriptors → the row's kebab menu\r\n * (capability gap G-41).\r\n *\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n * WHY THIS BELONGS IN THE LIBRARY\r\n *\r\n * The library ships both halves already: `OverflowMenu` renders a flat list of\r\n * actions, and `DataGrid.rowActions` takes a `(row) => ReactNode` renderer. The\r\n * step between them is what every listing writes for itself — turning the\r\n * BUSINESS description of an action (\"visible only on a draft\", \"greyed out\r\n * while the request is in flight\") into a menu for ONE row.\r\n *\r\n * That step is not glue. It carries three rules the Charter imposes, and each\r\n * one is a rule a host can only get right by re-deriving it:\r\n *\r\n *   R-3.3   ≤ 1 primary + ≤ 3 secondary actions per screen, hence the kebab.\r\n *   R-B.6   a destructive action is separated and marked, not merely last.\r\n *   R-K.1   every mouse-reachable action is keyboard-reachable — which is what\r\n *           `OverflowMenu` gives and what hover-revealed icon rows never did.\r\n *\r\n * Promoted from `refonte-frontend` (Area 5), where it served TWELVE screens and\r\n * had already replaced a local `TableActions` that revealed its actions on\r\n * hover, via a `mouseup` listener on `document`, with no keyboard equivalent\r\n * and no `role` / `aria-*`. On those screens, consulting, editing or deleting a\r\n * file was unreachable without a mouse — the Charter lists \"hover-only\r\n * interactions\" among its Forbidden Practices for exactly this reason.\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n *\r\n * PREDICATES, NOT BOOLEANS, AND THAT IS THE WHOLE POINT. `hidden` and\r\n * `disabled` take the ROW: an action's availability depends on the state of\r\n * that row, so it must be evaluated per row, at render. A boolean would force\r\n * the host to rebuild the descriptor array per row — which is how a card and a\r\n * table row end up offering different actions for the same record.\r\n *\r\n * >>> THE TWO SURFACES ARE WHY `buildRowActionMenu` IS EXPORTED SEPARATELY.\r\n * >>> A row appears twice: as a table row and, below the mobile breakpoint, as\r\n * >>> a `MobileRowCard` whose `actions` prop takes `OverflowMenuAction[]` —\r\n * >>> not a node. With only the renderer exported, a host had to rebuild the\r\n * >>> menu by hand for the card, and the two copies drifted on the danger\r\n * >>> separator, the overflow warning and the evaluation of the predicates.\r\n * >>> The library documents that exact failure for `RowFavoriteToggle`\r\n * >>> (gap G-36): the local twin announced \"Ajouter aux favoris\" while the\r\n * >>> grid column on the same page said \"Suivre\". Same shape, one level up. <\r\n *\r\n * Usage:\r\n *\r\n *   const descriptors: RowActionDescriptor<Dossier>[] = [\r\n *     { id: \"open\", label: \"Consulter le dossier\", icon: <Visibility />, onClick: open },\r\n *     { id: \"del\",  label: \"Supprimer définitivement\", icon: <Delete />,\r\n *       onClick: remove, danger: true, hidden: (row) => row.status !== \"DRAFT\" },\r\n *   ];\r\n *\r\n *   <DataGrid rowActions={buildRowActions(descriptors, `Actions sur ${row.reference}`)} />\r\n *   <MobileRowCard actions={buildRowActionMenu(descriptors, row)} />\r\n */\r\n\r\n/** Charter contract of `OverflowMenu`: ancillary row actions, ≤ 7 items. */\r\nexport const MAX_ROW_ACTIONS = 7;\r\n\r\n/**\r\n * One row action, described by the business.\r\n *\r\n * `hidden` and `disabled` are PREDICATES on the row, not booleans — see the\r\n * note above.\r\n */\r\nexport interface RowActionDescriptor<T> {\r\n  /** Stable identifier — render key and test anchor. */\r\n  id: string;\r\n  /** Menu label. Verb + object (R-B.3, §9.2). */\r\n  label: React.ReactNode;\r\n  icon?: React.ReactNode | undefined;\r\n  onClick: (row: T) => void;\r\n  /** Hides the action for this row. */\r\n  hidden?: ((row: T) => boolean) | undefined;\r\n  /** Shows the action but disables it for this row. */\r\n  disabled?: ((row: T) => boolean) | undefined;\r\n  /** Destructive: separator before, danger styling (R-B.6). */\r\n  danger?: boolean | undefined;\r\n  /** Keyboard shortcut rendered at the end of the item. */\r\n  shortcut?: React.ReactNode | undefined;\r\n}\r\n\r\n/**\r\n * Menu items for ONE row. Predicates are evaluated here, per call.\r\n *\r\n * Returns an empty array when nothing is visible, so a caller can decide to\r\n * render no trigger at all rather than an empty menu.\r\n */\r\nexport function buildRowActionMenu<T>(\r\n  descriptors: readonly RowActionDescriptor<T>[],\r\n  row: T\r\n): OverflowMenuAction[] {\r\n  const visible = descriptors.filter((d) => !d.hidden?.(row));\r\n  if (visible.length === 0) return [];\r\n\r\n  /* `process.env[\"NODE_ENV\"]` and not `.NODE_ENV`:\r\n   * `noPropertyAccessFromIndexSignature` is mandatory platform-wide, precisely\r\n   * so a missing key cannot read as a guaranteed field. */\r\n  if (\r\n    process.env[\"NODE_ENV\"] !== \"production\" &&\r\n    visible.length > MAX_ROW_ACTIONS\r\n  ) {\r\n    // eslint-disable-next-line no-console\r\n    console.warn(\r\n      `[@portnet/ui] buildRowActionMenu: ${visible.length} actions visible on ` +\r\n        `one row; OverflowMenu's contract recommends at most ${MAX_ROW_ACTIONS} ` +\r\n        `(R-3.3). Group them, or move some to the detail page.`\r\n    );\r\n  }\r\n\r\n  const items: OverflowMenuAction[] = [];\r\n  let separatorPlaced = false;\r\n\r\n  visible.forEach((d) => {\r\n    /* Separator before the FIRST destructive action, and only if something\r\n     * precedes it — a menu does not open on a rule. */\r\n    if (d.danger && !separatorPlaced && items.length > 0) {\r\n      items.push({ divider: true });\r\n      separatorPlaced = true;\r\n    }\r\n    /* Conditional spreads, not `undefined` values: `exactOptionalPropertyTypes`\r\n     * is mandatory platform-wide, so an explicit `undefined` is not the same as\r\n     * an absent key — and `mergeLabels` exists in this library because a spread\r\n     * of `undefined` had silently deleted defaults elsewhere. */\r\n    items.push({\r\n      label: d.label,\r\n      ...(d.icon !== undefined ? { icon: d.icon } : {}),\r\n      onClick: () => d.onClick(row),\r\n      ...(d.danger !== undefined ? { danger: d.danger } : {}),\r\n      ...(d.disabled ? { disabled: d.disabled(row) } : {}),\r\n      ...(d.shortcut !== undefined ? { shortcut: d.shortcut } : {}),\r\n    });\r\n  });\r\n\r\n  return items;\r\n}\r\n\r\n/**\r\n * Options of {@link buildRowActions}.\r\n */\r\nexport interface BuildRowActionsOptions {\r\n  /**\r\n   * Render the row's VISIBLE actions as icon buttons while their count is\r\n   * at most this value; fall back to the kebab menu above it.\r\n   *\r\n   * Omitted — the default — always renders the kebab, so existing callers\r\n   * are untouched.\r\n   *\r\n   * The threshold counts actions visible FOR THAT ROW, never the number\r\n   * declared: five descriptors whose `hidden` predicates are mutually\r\n   * exclusive by status typically leave two or three per row.\r\n   */\r\n  iconsUpTo?: number | undefined;\r\n}\r\n\r\n/**\r\n * Renderer for `DataGrid.rowActions`.\r\n *\r\n * Predicates are evaluated per row, at each cell render. Renders nothing when\r\n * no action is visible for that row, rather than a trigger that opens an empty\r\n * menu.\r\n *\r\n * NO DEFAULT `ariaLabel` (defect D-12). It used to default to the literal\r\n * \"Actions\", which was forwarded to `OverflowMenu`'s `ariaLabel` — and that\r\n * prop WINS over `labels.trigger`. So a row kebab built here announced\r\n * \"Actions\" while every other kebab in the fleet announced OverflowMenu's\r\n * canonical \"Plus d'actions\": one concept, two names, which R-2.4 forbids.\r\n * `MobileRowCard` had the identical defect and was fixed by removing its\r\n * default; this is the same repair, applied one level up. Omit the argument\r\n * and OverflowMenu now names itself.\r\n *\r\n * PASS A CONTEXTUAL NAME ANYWAY. Neither default is good in a list: twenty\r\n * identically-named kebabs give a screen-reader user no way to tell which row\r\n * they are on. `Actions sur le dossier 2025-IM-00042` does.\r\n *\r\n * TWO SHAPES, ONE CONTRACT (`iconsUpTo` — promoted from `refonte-frontend`,\r\n * Area 5). The kebab is the right shape for many or ancillary actions; a row\r\n * with two or three primary ones reads better as icon buttons, and\r\n * §Row Interaction treats those as COMPLEMENTARY to the row click. Hosts were\r\n * writing that second shape themselves — this module served twelve screens\r\n * with a local copy — which put the R-B.5 `aria-label`, the danger variant and\r\n * the fallback rule outside the library.\r\n *\r\n * NOT hover-only, and that distinction is what makes it admissible: `DataGrid`\r\n * reveals this renderer's output through `ROW_ACTIONS_OVERLAY_SX`, which keys\r\n * on `tr:hover`, `tr:focus-within` AND `@media (pointer: coarse)` — so the\r\n * buttons are reachable by keyboard and on touch (R-K.1). A host that renders\r\n * an icon row elsewhere, without that overlay, owns that requirement itself.\r\n *\r\n * Above the threshold the menu is built by {@link buildRowActionMenu}, so the\r\n * danger separator and the R-3.3 overflow warning are not re-derived here.\r\n *\r\n * @param descriptors actions in display order\r\n * @param ariaLabel   accessible name of the trigger. Omit to inherit\r\n *                    OverflowMenu's canonical name; prefer a row-specific one.\r\n * @param options     `{ iconsUpTo }` — see {@link BuildRowActionsOptions}\r\n */\r\nexport function buildRowActions<T>(\r\n  descriptors: readonly RowActionDescriptor<T>[],\r\n  ariaLabel?: string,\r\n  options?: BuildRowActionsOptions\r\n): (row: T) => React.ReactNode {\r\n  const iconsUpTo = options?.iconsUpTo;\r\n\r\n  return (row: T) => {\r\n    /* SAME predicate as `buildRowActionMenu`: how many actions this row\r\n     * actually shows decides the shape, so it must be known before the menu\r\n     * is built. */\r\n    const visible = descriptors.filter((d) => !d.hidden?.(row));\r\n    if (visible.length === 0) return null;\r\n\r\n    if (iconsUpTo !== undefined && visible.length <= iconsUpTo) {\r\n      /* No spacing container here: `ROW_ACTIONS_OVERLAY_SX` (DataGrid) is\r\n       * already a flex row with `gap: var(--s-1)`. Re-posing one would\r\n       * duplicate the same token one level lower. */\r\n      return visible.map((d) => {\r\n        const textLabel = typeof d.label === \"string\" ? d.label : undefined;\r\n\r\n        if (\r\n          process.env[\"NODE_ENV\"] !== \"production\" &&\r\n          textLabel === undefined\r\n        ) {\r\n          // eslint-disable-next-line no-console\r\n          console.warn(\r\n            `[@portnet/ui] buildRowActions: action \"${d.id}\" has a non-textual ` +\r\n              \"label, so its icon button gets no explicit aria-label (R-B.5). \" +\r\n              \"Give the descriptor a string label, or drop `iconsUpTo` for this grid.\"\r\n          );\r\n        }\r\n\r\n        return (\r\n          <Tooltip key={d.id} title={d.label}>\r\n            <Button\r\n              iconOnly\r\n              variant={d.danger ? \"danger\" : \"ghost\"}\r\n              size=\"sm\"\r\n              {...(d.icon !== undefined ? { icon: d.icon } : {})}\r\n              onClick={() => d.onClick(row)}\r\n              {...(d.disabled ? { disabled: d.disabled(row) } : {})}\r\n              {...(textLabel !== undefined\r\n                ? { \"aria-label\": textLabel }\r\n                : {})}\r\n            />\r\n          </Tooltip>\r\n        );\r\n      });\r\n    }\r\n\r\n    const items = buildRowActionMenu(descriptors, row);\r\n    if (items.length === 0) return null;\r\n    /* Conditional spread rather than ariaLabel={ariaLabel}: passing an\r\n     * explicit undefined would still override OverflowMenu's own label\r\n     * under exactOptionalPropertyTypes semantics (defect D-12). */\r\n    return (\r\n      <OverflowMenu\r\n        actions={items}\r\n        {...(ariaLabel !== undefined ? { ariaLabel } : {})}\r\n      />\r\n    );\r\n  };\r\n}"],"mappings":"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","ignoreList":[]}