@portnet/ui 6.0.0 → 6.0.2

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

@@ -0,0 +1 @@
+{"version":3,"file":"_useColumnResize.js","names":["React","KEYBOARD_STEP","useColumnResize","columnWidths","onColumnWidthsChange","_options$minWidth","options","arguments","length","undefined","minWidth","_React$useState","useState","_React$useState2","_slicedToArray","draggingKey","setDraggingKey","_React$useState3","_React$useState4","liveWidth","setLiveWidth","liveWidthRef","useRef","dragStateRef","columnWidthsRef","useEffect","current","cellDirection","grip","cell","closest","window","getComputedStyle","direction","handleMouseDown","useCallback","key","e","_ref","preventDefault","stopPropagation","currentTarget","currentWidth","offsetWidth","x","clientX","width","handleKeyDown","_ref2","isLeft","isRight","isHome","next","clamped","Math","max","round","_objectSpread","_defineProperty","onMove","start","delta","onUp","_liveWidthRef$current","finalWidth","addEventListener","removeEventListener","liveWidths","useMemo","isResizing"],"sources":["../../../../src/lib/v2/patterns/_useColumnResize.ts"],"sourcesContent":["import * as React from \"react\";\r\n\r\n/**\r\n * useColumnResize — Portnet UI v2 (private)\r\n *\r\n * Internal hook for the DataGrid + DataGridVirtualized resize\r\n * feature. NOT exported from the patterns barrel; underscore filename\r\n * prefix is the convention.\r\n *\r\n *   const { handleMouseDown, handleKeyDown, liveWidths, isResizing, minWidth } =\r\n *     useColumnResize(\r\n *       columnWidths,            // controlled\r\n *       onColumnWidthsChange,    // controlled\r\n *       { minWidth: 50 }\r\n *     );\r\n *\r\n * Behaviour (pointer):\r\n *   - handleMouseDown(key) returns an onMouseDown handler. Attach to\r\n *     the grip element on each `<th>` border.\r\n *   - On mousedown: captures starting clientX + current width + the\r\n *     direction of the cell's writing mode (LTR vs RTL). Sets\r\n *     `isResizing = true` so callers (e.g. the reorder hook) can\r\n *     short-circuit.\r\n *   - On mousemove (window-bound): computes the resize delta\r\n *     respecting RTL and updates a local \"live\" width via state.\r\n *     Floors at `minWidth`.\r\n *   - On mouseup (window-bound): commits the live width to the host\r\n *     via `onColumnWidthsChange`. Clears all internal state.\r\n *\r\n * Behaviour (keyboard, DG-2 / WCAG 2.1.1):\r\n *   - handleKeyDown(key) returns an onKeyDown handler for the SAME grip\r\n *     (the grip is a focusable role=\"separator\"). ArrowRight / ArrowLeft\r\n *     nudge the width by KEYBOARD_STEP px, RTL-aware so the direction\r\n *     matches a rightward drag; Home resets to `minWidth`. Each press\r\n *     commits immediately via `onColumnWidthsChange` (no drag session).\r\n *   - `minWidth` is returned so the separator can advertise aria-valuemin.\r\n */\r\n\r\nexport type ColumnWidths = Record<string, number>;\r\n\r\n/** Width delta (px) applied per Arrow key press in keyboard resize. */\r\nconst KEYBOARD_STEP = 16;\r\n\r\nexport interface UseColumnResizeOptions {\r\n  minWidth?: number | undefined;\r\n}\r\n\r\nexport interface UseColumnResizeResult {\r\n  handleMouseDown: (key: string) => (e: React.MouseEvent) => void;\r\n  handleKeyDown: (key: string) => (e: React.KeyboardEvent) => void;\r\n  liveWidths: ColumnWidths | undefined;\r\n  isResizing: boolean;\r\n  minWidth: number;\r\n}\r\n\r\ninterface DragState {\r\n  x: number;\r\n  width: number;\r\n  key: string;\r\n  direction: 1 | -1;\r\n}\r\n\r\nexport default function useColumnResize(\r\n  columnWidths: ColumnWidths | undefined,\r\n  onColumnWidthsChange: ((widths: ColumnWidths) => void) | undefined,\r\n  options: UseColumnResizeOptions = {}\r\n): UseColumnResizeResult {\r\n  const minWidth = options.minWidth ?? 50;\r\n\r\n  // React state for \"draggingKey\" + \"liveWidth\" drives the rendered\r\n  // width during drag. Refs carry the latest values across the\r\n  // mouseup closure (avoids the stale-closure bug).\r\n  const [draggingKey, setDraggingKey] = React.useState<string | null>(null);\r\n  const [liveWidth, setLiveWidth] = React.useState<number | null>(null);\r\n  const liveWidthRef = React.useRef<number | null>(null);\r\n  const dragStateRef = React.useRef<DragState | null>(null);\r\n\r\n  // Keep the latest columnWidths reference reachable from the\r\n  // mouseup closure without re-binding listeners on every prop\r\n  // change. Avoids tearing down + re-adding the window listeners\r\n  // on each parent re-render that ships a fresh widths object.\r\n  const columnWidthsRef = React.useRef<ColumnWidths | undefined>(columnWidths);\r\n  React.useEffect(() => {\r\n    columnWidthsRef.current = columnWidths;\r\n  }, [columnWidths]);\r\n\r\n  // Shared RTL probe for a grip's owning <th>: -1 in RTL, 1 otherwise.\r\n  const cellDirection = (grip: HTMLElement): 1 | -1 => {\r\n    const cell = grip.closest(\"th\");\r\n    return cell &&\r\n      typeof window !== \"undefined\" &&\r\n      typeof window.getComputedStyle === \"function\" &&\r\n      window.getComputedStyle(cell).direction === \"rtl\"\r\n      ? -1\r\n      : 1;\r\n  };\r\n\r\n  const handleMouseDown = React.useCallback((key: string) => (e: React.MouseEvent) => {\r\n    // Block native browser drag (text selection, image drag, the\r\n    // ancestor `<th draggable>` if reorder is also on) and the\r\n    // sortable-header click that lives next door in the same `<th>`.\r\n    e.preventDefault();\r\n    e.stopPropagation();\r\n\r\n    const grip = e.currentTarget as HTMLElement;\r\n    const cell = grip.closest(\"th\");\r\n    if (!cell) return;\r\n\r\n    // RTL detection at the cell level — most accurate (a `dir`\r\n    // attribute may be set anywhere up the ancestor chain).\r\n    const direction = cellDirection(grip);\r\n\r\n    // Starting width: prefer the host-controlled value, fall back to\r\n    // the rendered offsetWidth for a column the host hasn't sized.\r\n    const currentWidth =\r\n      (columnWidthsRef.current && columnWidthsRef.current[key]) ??\r\n      cell.offsetWidth;\r\n\r\n    dragStateRef.current = {\r\n      x: e.clientX,\r\n      width: currentWidth,\r\n      key,\r\n      direction,\r\n    };\r\n\r\n    liveWidthRef.current = currentWidth;\r\n    setLiveWidth(currentWidth);\r\n    setDraggingKey(key);\r\n  }, []);\r\n\r\n  // DG-2 — keyboard resize on the focusable grip. Commits immediately;\r\n  // no drag session / window listeners involved.\r\n  const handleKeyDown = React.useCallback(\r\n    (key: string) => (e: React.KeyboardEvent) => {\r\n      const isLeft = e.key === \"ArrowLeft\";\r\n      const isRight = e.key === \"ArrowRight\";\r\n      const isHome = e.key === \"Home\";\r\n      if (!isLeft && !isRight && !isHome) return;\r\n      e.preventDefault();\r\n      e.stopPropagation();\r\n\r\n      const grip = e.currentTarget as HTMLElement;\r\n      const cell = grip.closest(\"th\");\r\n      const direction = cellDirection(grip);\r\n\r\n      const current =\r\n        (columnWidthsRef.current && columnWidthsRef.current[key]) ??\r\n        (cell ? cell.offsetWidth : minWidth);\r\n\r\n      // RTL-aware so ArrowRight matches a rightward drag (which grows the\r\n      // column in LTR and shrinks it in RTL, the grip being on the\r\n      // inline-end edge).\r\n      const next = isHome\r\n        ? minWidth\r\n        : current + (isRight ? 1 : -1) * KEYBOARD_STEP * direction;\r\n\r\n      const clamped = Math.max(minWidth, Math.round(next));\r\n      if (onColumnWidthsChange) {\r\n        onColumnWidthsChange({ ...(columnWidthsRef.current || {}), [key]: clamped });\r\n      }\r\n    },\r\n    [minWidth, onColumnWidthsChange]\r\n  );\r\n\r\n  React.useEffect(() => {\r\n    if (!draggingKey) return undefined;\r\n\r\n    const onMove = (e: MouseEvent) => {\r\n      const start = dragStateRef.current;\r\n      if (!start) return;\r\n      const delta = (e.clientX - start.x) * start.direction;\r\n      const next = Math.max(minWidth, start.width + delta);\r\n      liveWidthRef.current = next;\r\n      setLiveWidth(next);\r\n    };\r\n\r\n    const onUp = () => {\r\n      const start = dragStateRef.current;\r\n      const finalWidth = liveWidthRef.current ?? (start ? start.width : null);\r\n      if (start && finalWidth != null && onColumnWidthsChange) {\r\n        onColumnWidthsChange({\r\n          ...(columnWidthsRef.current || {}),\r\n          [start.key]: finalWidth,\r\n        });\r\n      }\r\n      dragStateRef.current = null;\r\n      liveWidthRef.current = null;\r\n      setLiveWidth(null);\r\n      setDraggingKey(null);\r\n    };\r\n\r\n    window.addEventListener(\"mousemove\", onMove);\r\n    window.addEventListener(\"mouseup\", onUp);\r\n    return () => {\r\n      window.removeEventListener(\"mousemove\", onMove);\r\n      window.removeEventListener(\"mouseup\", onUp);\r\n    };\r\n    // onColumnWidthsChange is intentionally listed — re-creates the\r\n    // mouseup closure with the latest setter ref. minWidth is rare\r\n    // to change but listed for correctness.\r\n  }, [draggingKey, onColumnWidthsChange, minWidth]);\r\n\r\n  // Live widths map = host columnWidths with the in-flight drag value\r\n  // patched in. Memoised on [draggingKey, liveWidth, columnWidths] so\r\n  // the reference is stable when nothing is dragging.\r\n  const liveWidths = React.useMemo(() => {\r\n    if (!draggingKey || liveWidth == null) return columnWidths;\r\n    return { ...(columnWidths || {}), [draggingKey]: liveWidth };\r\n  }, [draggingKey, liveWidth, columnWidths]);\r\n\r\n  return {\r\n    handleMouseDown,\r\n    handleKeyDown,\r\n    liveWidths,\r\n    isResizing: draggingKey != null,\r\n    minWidth,\r\n  };\r\n}\r\n"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,178 @@
+export { default as ActionBar } from "./ActionBar";
+export { default as BulkActionBar } from "./BulkActionBar";
+export { default as ColumnsToggle } from "./ColumnsToggle";
+export { default as FormSection } from "./FormSection";
+export { default as FormPageShell } from "./FormPageShell";
+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";
+export { default as PageContent } from "./PageContent";
+export { default as DataGrid, applySort } from "./DataGrid";
+export { default as DataGridVirtualized } from "./DataGridVirtualized";
+export { default as DataGridSettingsMenu } from "./DataGridSettingsMenu";
+export { default as DataGridToolbar } from "./DataGridToolbar";
+/**
+ * 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";
+export { default as ReferentielField } from "./ReferentielField";
+/**
+ * ReferentielField configuration types — public typed surface.
+ *
+ * Same class of gap as Gap-TS-003 (component types), which was fixed for
+ * `./components` but never extended to `./patterns`: the VALUE above was
+ * exported while the types describing its own REQUIRED props were not.
+ * `columns` and `criteria` are mandatory-to-configure, so a consumer had no
+ * way to type them without either deep-importing
+ * `@portnet/ui/dist/v2/patterns/…` (fragile, bypasses the `exports` map) or
+ * declaring a local twin — which the Platform TypeScript Guidelines forbid
+ * ("Reusable types belong inside Shared UI Library … Never duplicate").
+ *
+ * `ReferentielSearchResult` and `ReferentielSearchParams` are deliberately
+ * NOT re-exported here: identically-named types are already surfaced from
+ * `./referentiel` (useReferentielSearch) and `./v2/models` respectively, and
+ * `src/lib/index.ts` star-exports all three barrels — a second named export of
+ * either identifier is a hard TS2308 ambiguity at the library root.
+ *
+ * Additive and type-only: no runtime change, no existing export altered.
+ */
+
+export { default as Tour } from "./Tour";
+export { default as KeyboardShortcutsHelp } from "./KeyboardShortcutsHelp";
+export { default as DeleteResourceConfirmDialog } from "./DeleteResourceConfirmDialog";
+
+// ── Personalization · Saved Filters framework (v2/personalization) ────────────
+// SaveFilterDialog is presentational; SavedFiltersMenu is connected to the
+// savedFilters capability via useSavedFilters.
+export { default as SaveFilterDialog } from "./SaveFilterDialog";
+export { default as SavedFiltersMenu } from "./SavedFiltersMenu";
+
+// ── Personalization · Favorites DataGrid integration (v2/personalization) ─────
+// makeFavoriteColumn builds an always-visible favorites column for v2.DataGrid;
+// 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";
+export { default as FormikSelect } from "./FormikSelect";
+export { default as FormikCombobox } from "./FormikCombobox";
+/**
+ * FormikCombobox props — public typed surface.
+ *
+ * SAME GAP-TS-003 CLASS as the ReferentielField note above. That fix covered
+ * `ReferentielField` and `FormikReferentielField` but was not extended to the
+ * other Formik bridges: the VALUE is exported while the type describing its props
+ * is not, so a consumer cannot write `Omit<FormikComboboxProps<T>, …>`.
+ *
+ * REQUESTED BY bmdav-fe (TypeScript migration, batch 6f). That module stores the
+ * OPTION OBJECT in Formik rather than a primitive key, because its payload mapper
+ * reads `values.typeDemande.id` and sends `delegationTraitement` as a whole
+ * object — so it cannot adopt the primitive-key model without changing the
+ * request body sent to bmdav-be. It contains the resulting variance in ONE local
+ * adapter (`ObjectValuedFormikCombobox`) rather than scattering assertions across
+ * call sites, and that adapter must restate this component's prop contract minus
+ * `getOptionValue`. The deep-import fallback is unavailable under
+ * `moduleResolution: "bundler"`, since the package `exports` map does not expose
+ * `dist/v2/patterns/*`.
+ *
+ * `ComboboxOptionValue` is deliberately NOT re-exported here — it is already
+ * surfaced from `./components` (Combobox), and a second named export at the
+ * library root would be a TS2308 ambiguity, exactly as recorded above for
+ * `ReferentielSearchResult` / `ReferentielSearchParams`.
+ *
+ * Additive and type-only: no runtime change, no existing export altered.
+ */
+
+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
+ *  auto-générés ou non modifiables par l'utilisateur. */
+export { default as FormikDisplay } from "../components/FormikDisplay";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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","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\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\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,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;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMA,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;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASzB,OAAO,IAAI0B,iBAAiB,EAAEC,2BAA2B,QAAQ,qBAAqB;AAO/F;AACA,SAAS3B,OAAO,IAAI4B,WAAW,QAAiB,eAAe;AAC/D,SAAS5B,OAAO,IAAI6B,cAAc,QAAc,kBAAkB;AAClE,SAAS7B,OAAO,IAAI8B,YAAY,QAAgB,gBAAgB;AAChE,SAAS9B,OAAO,IAAI+B,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,SAAS/B,OAAO,IAAIgC,gBAAgB,QAAY,oBAAoB;AACpE,SAAShC,OAAO,IAAIiC,UAAU,QAAkB,cAAc;AAC9D,SAASjC,OAAO,IAAIkC,mBAAmB,QAAS,uBAAuB;AACvE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASlC,OAAO,IAAImC,cAAc,QAAc,kBAAkB;AAElE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASnC,OAAO,IAAIoC,gBAAgB,QAAY,oBAAoB;AAEpE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASpC,OAAO,IAAIqC,oBAAoB,QAAQ,wBAAwB;AAExE,SAASrC,OAAO,IAAIsC,sBAAsB,QAAQ,0BAA0B;AAG5E;AACA;AACA;AACA,SAAStC,OAAO,IAAIuC,aAAa,QAAe,6BAA6B","ignoreList":[]}

package/dist/esm/v2/personalization/PersonalizationProvider.js

@@ -0,0 +1,168 @@
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return _typeof(key) === "symbol" ? key : String(key); }
+function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (_typeof(res) !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+/**
+ * UserPersonalizationProvider — Portnet UI v2 · personalization
+ *
+ * The single configuration point for per-user personalization. Mount it
+ * once near the app root; every capability (favorites, saved filters, and
+ * future slices) reads through the one store it establishes.
+ *
+ *   import {
+ *     UserPersonalizationProvider,
+ *     createLocalStorageAdapter,
+ *   } from "@portnet/ui/v2/personalization";
+ *
+ *   <UserPersonalizationProvider userId={user.id} tenantId={tenant.id}>
+ *     <App />
+ *   </UserPersonalizationProvider>
+ *
+ * Store lifecycle
+ *   - Exactly one store per scope. Memoised on (scope, adapter) ONLY;
+ *     onError / hydrateStrategy are pushed in live via store.setRuntime so
+ *     inline handlers never recreate the store.
+ *   - The default localStorage adapter is created once (ref). A PROVIDED
+ *     adapter must be stable (useMemo/module singleton) — a dev guard warns
+ *     if its identity changes between renders.
+ *   - A lifecycle effect runs hydrate() + connect() and dispose()s the old
+ *     store on scope change / unmount (cross-tab listener torn down).
+ *
+ * React 18/19 compatible: no 19-only API is required.
+ */
+
+import * as React from "react";
+import { PersonalizationConfigContext, PersonalizationStoreContext } from "./personalizationContext";
+import createPersonalizationStore from "./createPersonalizationStore";
+import createLocalStorageAdapter from "./adapters/createLocalStorageAdapter";
+import { jsx as _jsx } from "react/jsx-runtime";
+var isDev = typeof process !== "undefined" && process.env && process.env["NODE_ENV"] !== "production";
+
+/**
+ * Default labels for the whole foundation (FR — charter default). Hosts
+ * override any subset via the `labels` prop; EN/AR overrides supported.
+ * Front-loaded here so the favorites (Batch 3) and saved-filters (Batch 4)
+ * components read consistent copy from one place.
+ */
+export var DEFAULT_PERSONALIZATION_LABELS = Object.freeze({
+  // Follow / "suivis" (Batch 3)
+  addFavorite: "Suivre",
+  removeFavorite: "Ne plus suivre",
+  favoritesOnly: "Suivis uniquement",
+  showAll: "Tout afficher",
+  favoriteColumnHeader: "Suivis",
+  // Saved filters (Batch 4)
+  savedFilters: "Filtres enregistrés",
+  saveCurrentFilter: "Enregistrer le filtre actuel…",
+  filterNameLabel: "Nom du filtre",
+  filterNamePlaceholder: "ex. Dossiers en attente",
+  saveFilter: "Enregistrer",
+  updateFilter: "Mettre à jour",
+  deleteFilter: "Supprimer",
+  deleteFilterConfirm: "Supprimer ce filtre enregistré ?",
+  setAsDefault: "Définir par défaut",
+  defaultBadge: "Par défaut",
+  manageFilters: "Gérer les filtres",
+  noSavedFilters: "Aucun filtre enregistré",
+  cancel: "Annuler"
+});
+export function UserPersonalizationProvider(props) {
+  var children = props.children,
+    userId = props.userId,
+    tenantId = props.tenantId,
+    appId = props.appId,
+    adapter = props.adapter,
+    defaults = props.defaults,
+    labels = props.labels,
+    onError = props.onError,
+    _props$hydrateStrateg = props.hydrateStrategy,
+    hydrateStrategy = _props$hydrateStrateg === void 0 ? "remote-wins" : _props$hydrateStrateg;
+  if (isDev && !userId && typeof console !== "undefined" && console.warn) {
+    // eslint-disable-next-line no-console
+    console.warn("[@portnet/ui v2] UserPersonalizationProvider: `userId` is required to scope personalization. " + "Falling back to 'anonymous' — persisted preferences will be shared across unauthenticated sessions.");
+  }
+  var resolvedUserId = userId || "anonymous";
+  var scope = React.useMemo(function buildScope() {
+    return _objectSpread(_objectSpread({
+      userId: resolvedUserId
+    }, tenantId !== undefined ? {
+      tenantId: tenantId
+    } : {}), appId !== undefined ? {
+      appId: appId
+    } : {});
+  }, [resolvedUserId, tenantId, appId]);
+
+  // Default adapter created once; a provided adapter is trusted to be stable.
+  var defaultAdapterRef = React.useRef(null);
+  if (!adapter && !defaultAdapterRef.current) {
+    defaultAdapterRef.current = createLocalStorageAdapter();
+  }
+  var resolvedAdapter = adapter || defaultAdapterRef.current;
+
+  // One store per (scope, adapter). Intentionally NOT keyed on
+  // defaults/onError/hydrateStrategy: those are fed live below.
+  var store = React.useMemo(function buildStore() {
+    return createPersonalizationStore(_objectSpread(_objectSpread(_objectSpread({
+      scope: scope,
+      adapter: resolvedAdapter
+    }, defaults !== undefined ? {
+      defaults: defaults
+    } : {}), onError !== undefined ? {
+      onError: onError
+    } : {}), {}, {
+      hydrateStrategy: hydrateStrategy
+    }));
+  },
+  // eslint-disable-next-line react-hooks/exhaustive-deps
+  [scope, resolvedAdapter]);
+
+  // Hydrate + cross-tab connect; dispose on store change / unmount.
+  React.useEffect(function lifecycle() {
+    store.hydrate();
+    var off = store.connect();
+    return function teardown() {
+      if (typeof off === "function") off();
+      store.dispose();
+    };
+  }, [store]);
+
+  // Push live runtime options without recreating the store.
+  React.useEffect(function syncRuntime() {
+    store.setRuntime(_objectSpread(_objectSpread({}, onError !== undefined ? {
+      onError: onError
+    } : {}), {}, {
+      hydrateStrategy: hydrateStrategy
+    }));
+  }, [store, onError, hydrateStrategy]);
+
+  // Dev guard: a non-memoised adapter prop would recreate the store each
+  // render and wipe in-memory state. Warn so it's caught early.
+  var prevAdapterRef = React.useRef(resolvedAdapter);
+  React.useEffect(function guardAdapterIdentity() {
+    if (isDev && prevAdapterRef.current !== resolvedAdapter && typeof console !== "undefined" && console.warn) {
+      // eslint-disable-next-line no-console
+      console.warn("[@portnet/ui v2] UserPersonalizationProvider: the `adapter` prop changed identity between " + "renders. Memoise it (useMemo or a module singleton) to avoid re-creating the personalization store.");
+    }
+    prevAdapterRef.current = resolvedAdapter;
+  }, [resolvedAdapter]);
+  var mergedLabels = React.useMemo(function mergeLabels() {
+    return labels ? Object.assign({}, DEFAULT_PERSONALIZATION_LABELS, labels) : DEFAULT_PERSONALIZATION_LABELS;
+  }, [labels]);
+  var configValue = React.useMemo(function buildConfig() {
+    return {
+      scope: scope,
+      labels: mergedLabels
+    };
+  }, [scope, mergedLabels]);
+  return /*#__PURE__*/_jsx(PersonalizationConfigContext.Provider, {
+    value: configValue,
+    children: /*#__PURE__*/_jsx(PersonalizationStoreContext.Provider, {
+      value: store,
+      children: children
+    })
+  });
+}
+export default UserPersonalizationProvider;
+//# sourceMappingURL=PersonalizationProvider.js.map

package/dist/esm/v2/personalization/PersonalizationProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PersonalizationProvider.js","names":["React","PersonalizationConfigContext","PersonalizationStoreContext","createPersonalizationStore","createLocalStorageAdapter","jsx","_jsx","isDev","process","env","DEFAULT_PERSONALIZATION_LABELS","Object","freeze","addFavorite","removeFavorite","favoritesOnly","showAll","favoriteColumnHeader","savedFilters","saveCurrentFilter","filterNameLabel","filterNamePlaceholder","saveFilter","updateFilter","deleteFilter","deleteFilterConfirm","setAsDefault","defaultBadge","manageFilters","noSavedFilters","cancel","UserPersonalizationProvider","props","children","userId","tenantId","appId","adapter","defaults","labels","onError","_props$hydrateStrateg","hydrateStrategy","console","warn","resolvedUserId","scope","useMemo","buildScope","_objectSpread","undefined","defaultAdapterRef","useRef","current","resolvedAdapter","store","buildStore","useEffect","lifecycle","hydrate","off","connect","teardown","dispose","syncRuntime","setRuntime","prevAdapterRef","guardAdapterIdentity","mergedLabels","mergeLabels","assign","configValue","buildConfig","Provider","value"],"sources":["../../../../src/lib/v2/personalization/PersonalizationProvider.tsx"],"sourcesContent":["/**\r\n * UserPersonalizationProvider — Portnet UI v2 · personalization\r\n *\r\n * The single configuration point for per-user personalization. Mount it\r\n * once near the app root; every capability (favorites, saved filters, and\r\n * future slices) reads through the one store it establishes.\r\n *\r\n *   import {\r\n *     UserPersonalizationProvider,\r\n *     createLocalStorageAdapter,\r\n *   } from \"@portnet/ui/v2/personalization\";\r\n *\r\n *   <UserPersonalizationProvider userId={user.id} tenantId={tenant.id}>\r\n *     <App />\r\n *   </UserPersonalizationProvider>\r\n *\r\n * Store lifecycle\r\n *   - Exactly one store per scope. Memoised on (scope, adapter) ONLY;\r\n *     onError / hydrateStrategy are pushed in live via store.setRuntime so\r\n *     inline handlers never recreate the store.\r\n *   - The default localStorage adapter is created once (ref). A PROVIDED\r\n *     adapter must be stable (useMemo/module singleton) — a dev guard warns\r\n *     if its identity changes between renders.\r\n *   - A lifecycle effect runs hydrate() + connect() and dispose()s the old\r\n *     store on scope change / unmount (cross-tab listener torn down).\r\n *\r\n * React 18/19 compatible: no 19-only API is required.\r\n */\r\n\r\nimport * as React from \"react\";\r\n\r\nimport {\r\n  PersonalizationConfigContext,\r\n  PersonalizationStoreContext,\r\n} from \"./personalizationContext\";\r\nimport type {\r\n  PersonalizationConfig,\r\n  PersonalizationLabels,\r\n} from \"./personalizationContext\";\r\nimport createPersonalizationStore from \"./createPersonalizationStore\";\r\nimport type { PersonalizationErrorHandler } from \"./createPersonalizationStore\";\r\nimport createLocalStorageAdapter from \"./adapters/createLocalStorageAdapter\";\r\nimport type { Adapter, HydrateStrategy, Scope } from \"./types\";\r\n\r\nconst isDev =\r\n  typeof process !== \"undefined\" &&\r\n  process.env &&\r\n  process.env[\"NODE_ENV\"] !== \"production\";\r\n\r\n/**\r\n * Default labels for the whole foundation (FR — charter default). Hosts\r\n * override any subset via the `labels` prop; EN/AR overrides supported.\r\n * Front-loaded here so the favorites (Batch 3) and saved-filters (Batch 4)\r\n * components read consistent copy from one place.\r\n */\r\nexport const DEFAULT_PERSONALIZATION_LABELS = Object.freeze({\r\n  // Follow / \"suivis\" (Batch 3)\r\n  addFavorite: \"Suivre\",\r\n  removeFavorite: \"Ne plus suivre\",\r\n  favoritesOnly: \"Suivis uniquement\",\r\n  showAll: \"Tout afficher\",\r\n  favoriteColumnHeader: \"Suivis\",\r\n  // Saved filters (Batch 4)\r\n  savedFilters: \"Filtres enregistrés\",\r\n  saveCurrentFilter: \"Enregistrer le filtre actuel…\",\r\n  filterNameLabel: \"Nom du filtre\",\r\n  filterNamePlaceholder: \"ex. Dossiers en attente\",\r\n  saveFilter: \"Enregistrer\",\r\n  updateFilter: \"Mettre à jour\",\r\n  deleteFilter: \"Supprimer\",\r\n  deleteFilterConfirm: \"Supprimer ce filtre enregistré ?\",\r\n  setAsDefault: \"Définir par défaut\",\r\n  defaultBadge: \"Par défaut\",\r\n  manageFilters: \"Gérer les filtres\",\r\n  noSavedFilters: \"Aucun filtre enregistré\",\r\n  cancel: \"Annuler\",\r\n} satisfies PersonalizationLabels);\r\n\r\nexport interface UserPersonalizationProviderProps {\r\n  children?: React.ReactNode | undefined;\r\n  /** Required (in practice) — scopes all persisted preferences to this user. */\r\n  userId?: string | undefined;\r\n  /** Optional multi-tenant partition. */\r\n  tenantId?: string | undefined;\r\n  /** Optional per-app partition. */\r\n  appId?: string | undefined;\r\n  /** Persistence boundary. Defaults to createLocalStorageAdapter(). Must be stable. */\r\n  adapter?: Adapter | undefined;\r\n  /** Per-capability seed overrides, e.g. { favorites: {}, savedFilters: {} }. */\r\n  defaults?: Record<string, unknown> | undefined;\r\n  /** Label overrides (FR default; EN/AR supported). */\r\n  labels?: Partial<PersonalizationLabels> | undefined;\r\n  /** Central persistence-error hook: (error, { scope, capabilityId }) => void. */\r\n  onError?: PersonalizationErrorHandler | undefined;\r\n  /** Reconciliation policy between optimistic local state and adapter truth. @default \"remote-wins\" */\r\n  hydrateStrategy?: HydrateStrategy | undefined;\r\n}\r\n\r\nexport function UserPersonalizationProvider(\r\n  props: UserPersonalizationProviderProps\r\n): React.JSX.Element {\r\n  const {\r\n    children,\r\n    userId,\r\n    tenantId,\r\n    appId,\r\n    adapter,\r\n    defaults,\r\n    labels,\r\n    onError,\r\n    hydrateStrategy = \"remote-wins\",\r\n  } = props;\r\n\r\n  if (isDev && !userId && typeof console !== \"undefined\" && console.warn) {\r\n    // eslint-disable-next-line no-console\r\n    console.warn(\r\n      \"[@portnet/ui v2] UserPersonalizationProvider: `userId` is required to scope personalization. \" +\r\n        \"Falling back to 'anonymous' — persisted preferences will be shared across unauthenticated sessions.\"\r\n    );\r\n  }\r\n  const resolvedUserId = userId || \"anonymous\";\r\n\r\n  const scope = React.useMemo<Scope>(\r\n    function buildScope() {\r\n      return {\r\n        userId: resolvedUserId,\r\n        ...(tenantId !== undefined ? { tenantId } : {}),\r\n        ...(appId !== undefined ? { appId } : {}),\r\n      };\r\n    },\r\n    [resolvedUserId, tenantId, appId]\r\n  );\r\n\r\n  // Default adapter created once; a provided adapter is trusted to be stable.\r\n  const defaultAdapterRef = React.useRef<Adapter | null>(null);\r\n  if (!adapter && !defaultAdapterRef.current) {\r\n    defaultAdapterRef.current = createLocalStorageAdapter();\r\n  }\r\n  const resolvedAdapter = adapter || defaultAdapterRef.current;\r\n\r\n  // One store per (scope, adapter). Intentionally NOT keyed on\r\n  // defaults/onError/hydrateStrategy: those are fed live below.\r\n  const store = React.useMemo(\r\n    function buildStore() {\r\n      return createPersonalizationStore({\r\n        scope: scope,\r\n        adapter: resolvedAdapter,\r\n        ...(defaults !== undefined ? { defaults } : {}),\r\n        ...(onError !== undefined ? { onError } : {}),\r\n        hydrateStrategy: hydrateStrategy,\r\n      });\r\n    },\r\n    // eslint-disable-next-line react-hooks/exhaustive-deps\r\n    [scope, resolvedAdapter]\r\n  );\r\n\r\n  // Hydrate + cross-tab connect; dispose on store change / unmount.\r\n  React.useEffect(\r\n    function lifecycle() {\r\n      store.hydrate();\r\n      const off = store.connect();\r\n      return function teardown() {\r\n        if (typeof off === \"function\") off();\r\n        store.dispose();\r\n      };\r\n    },\r\n    [store]\r\n  );\r\n\r\n  // Push live runtime options without recreating the store.\r\n  React.useEffect(\r\n    function syncRuntime() {\r\n      store.setRuntime({\r\n        ...(onError !== undefined ? { onError } : {}),\r\n        hydrateStrategy: hydrateStrategy,\r\n      });\r\n    },\r\n    [store, onError, hydrateStrategy]\r\n  );\r\n\r\n  // Dev guard: a non-memoised adapter prop would recreate the store each\r\n  // render and wipe in-memory state. Warn so it's caught early.\r\n  const prevAdapterRef = React.useRef<Adapter | null>(resolvedAdapter);\r\n  React.useEffect(\r\n    function guardAdapterIdentity() {\r\n      if (\r\n        isDev &&\r\n        prevAdapterRef.current !== resolvedAdapter &&\r\n        typeof console !== \"undefined\" &&\r\n        console.warn\r\n      ) {\r\n        // eslint-disable-next-line no-console\r\n        console.warn(\r\n          \"[@portnet/ui v2] UserPersonalizationProvider: the `adapter` prop changed identity between \" +\r\n            \"renders. Memoise it (useMemo or a module singleton) to avoid re-creating the personalization store.\"\r\n        );\r\n      }\r\n      prevAdapterRef.current = resolvedAdapter;\r\n    },\r\n    [resolvedAdapter]\r\n  );\r\n\r\n  const mergedLabels = React.useMemo<PersonalizationLabels>(\r\n    function mergeLabels() {\r\n      return labels\r\n        ? Object.assign({}, DEFAULT_PERSONALIZATION_LABELS, labels)\r\n        : DEFAULT_PERSONALIZATION_LABELS;\r\n    },\r\n    [labels]\r\n  );\r\n\r\n  const configValue = React.useMemo<PersonalizationConfig>(\r\n    function buildConfig() {\r\n      return { scope: scope, labels: mergedLabels };\r\n    },\r\n    [scope, mergedLabels]\r\n  );\r\n\r\n  return (\r\n    <PersonalizationConfigContext.Provider value={configValue}>\r\n      <PersonalizationStoreContext.Provider value={store}>\r\n        {children}\r\n      </PersonalizationStoreContext.Provider>\r\n    </PersonalizationConfigContext.Provider>\r\n  );\r\n}\r\n\r\nexport default UserPersonalizationProvider;\r\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/v2/personalization/adapters/_storageKey.js

@@ -0,0 +1,60 @@
+/**
+ * _storageKey — Portnet UI v2 · personalization adapters (private)
+ *
+ * Composite key scheme shared by storage adapters:
+ *
+ *     portnet-ui:perso:v1:{tenantId?}:{userId}:{capabilityId}
+ *
+ * Design notes
+ *   - `resourceKey` is NOT in the key — it lives inside the capability
+ *     payload. One storage entry per (scope, capability) → cheap prefix scan
+ *     on load, one removeItem to clear.
+ *   - Scope segments (tenantId, userId) are encodeURIComponent-escaped so
+ *     arbitrary host identifiers — including ones containing ':' — remain
+ *     unambiguous. `capabilityId` is a controlled slug and is left raw so
+ *     `buildScopePrefix` + `slice()` recover it directly.
+ *   - `:v1:` is the KEY-SCHEME version (storage layout), independent of a
+ *     capability payload's `schemaVersion`.
+ *
+ * Underscore-prefixed: internal, never re-exported from the public surface.
+ */
+
+import { KEY_SCHEME_VERSION } from "../schema";
+export var KEY_PREFIX = "portnet-ui:perso";
+function enc(value) {
+  return encodeURIComponent(String(value == null ? "" : value));
+}
+
+/** Full storage key for one (scope, capability). */
+export function buildKey(scope, capabilityId) {
+  var parts = [KEY_PREFIX, KEY_SCHEME_VERSION];
+  if (scope && scope.tenantId) parts.push(enc(scope.tenantId));
+  parts.push(enc(scope ? scope.userId : ""));
+  parts.push(capabilityId);
+  return parts.join(":");
+}
+
+/**
+ * Prefix shared by every capability key of a scope — terminated by ':' so the
+ * capability segment follows immediately.
+ */
+export function buildScopePrefix(scope) {
+  var parts = [KEY_PREFIX, KEY_SCHEME_VERSION];
+  if (scope && scope.tenantId) parts.push(enc(scope.tenantId));
+  parts.push(enc(scope ? scope.userId : ""));
+  parts.push(""); // trailing ':' after join
+  return parts.join(":");
+}
+
+/**
+ * Recover the capabilityId from a storage key for a given scope, or null when
+ * the key does not belong to this scope.
+ */
+export function parseCapabilityFromKey(key, scope) {
+  if (typeof key !== "string") return null;
+  var prefix = buildScopePrefix(scope);
+  if (key.indexOf(prefix) !== 0) return null;
+  var capId = key.slice(prefix.length);
+  return capId || null;
+}
+//# sourceMappingURL=_storageKey.js.map

package/dist/esm/v2/personalization/adapters/_storageKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_storageKey.js","names":["KEY_SCHEME_VERSION","KEY_PREFIX","enc","value","encodeURIComponent","String","buildKey","scope","capabilityId","parts","tenantId","push","userId","join","buildScopePrefix","parseCapabilityFromKey","key","prefix","indexOf","capId","slice","length"],"sources":["../../../../../src/lib/v2/personalization/adapters/_storageKey.ts"],"sourcesContent":["/**\r\n * _storageKey — Portnet UI v2 · personalization adapters (private)\r\n *\r\n * Composite key scheme shared by storage adapters:\r\n *\r\n *     portnet-ui:perso:v1:{tenantId?}:{userId}:{capabilityId}\r\n *\r\n * Design notes\r\n *   - `resourceKey` is NOT in the key — it lives inside the capability\r\n *     payload. One storage entry per (scope, capability) → cheap prefix scan\r\n *     on load, one removeItem to clear.\r\n *   - Scope segments (tenantId, userId) are encodeURIComponent-escaped so\r\n *     arbitrary host identifiers — including ones containing ':' — remain\r\n *     unambiguous. `capabilityId` is a controlled slug and is left raw so\r\n *     `buildScopePrefix` + `slice()` recover it directly.\r\n *   - `:v1:` is the KEY-SCHEME version (storage layout), independent of a\r\n *     capability payload's `schemaVersion`.\r\n *\r\n * Underscore-prefixed: internal, never re-exported from the public surface.\r\n */\r\n\r\nimport { KEY_SCHEME_VERSION } from \"../schema\";\r\nimport type { Scope } from \"../types\";\r\n\r\nexport const KEY_PREFIX = \"portnet-ui:perso\";\r\n\r\nfunction enc(value: string | undefined): string {\r\n  return encodeURIComponent(String(value == null ? \"\" : value));\r\n}\r\n\r\n/** Full storage key for one (scope, capability). */\r\nexport function buildKey(scope: Scope, capabilityId: string): string {\r\n  const parts = [KEY_PREFIX, KEY_SCHEME_VERSION];\r\n  if (scope && scope.tenantId) parts.push(enc(scope.tenantId));\r\n  parts.push(enc(scope ? scope.userId : \"\"));\r\n  parts.push(capabilityId);\r\n  return parts.join(\":\");\r\n}\r\n\r\n/**\r\n * Prefix shared by every capability key of a scope — terminated by ':' so the\r\n * capability segment follows immediately.\r\n */\r\nexport function buildScopePrefix(scope: Scope): string {\r\n  const parts = [KEY_PREFIX, KEY_SCHEME_VERSION];\r\n  if (scope && scope.tenantId) parts.push(enc(scope.tenantId));\r\n  parts.push(enc(scope ? scope.userId : \"\"));\r\n  parts.push(\"\"); // trailing ':' after join\r\n  return parts.join(\":\");\r\n}\r\n\r\n/**\r\n * Recover the capabilityId from a storage key for a given scope, or null when\r\n * the key does not belong to this scope.\r\n */\r\nexport function parseCapabilityFromKey(\r\n  key: string,\r\n  scope: Scope\r\n): string | null {\r\n  if (typeof key !== \"string\") return null;\r\n  const prefix = buildScopePrefix(scope);\r\n  if (key.indexOf(prefix) !== 0) return null;\r\n  const capId = key.slice(prefix.length);\r\n  return capId || null;\r\n}\r\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,kBAAkB,QAAQ,WAAW;AAG9C,OAAO,IAAMC,UAAU,GAAG,kBAAkB;AAE5C,SAASC,GAAGA,CAACC,KAAyB,EAAU;EAC9C,OAAOC,kBAAkB,CAACC,MAAM,CAACF,KAAK,IAAI,IAAI,GAAG,EAAE,GAAGA,KAAK,CAAC,CAAC;AAC/D;;AAEA;AACA,OAAO,SAASG,QAAQA,CAACC,KAAY,EAAEC,YAAoB,EAAU;EACnE,IAAMC,KAAK,GAAG,CAACR,UAAU,EAAED,kBAAkB,CAAC;EAC9C,IAAIO,KAAK,IAAIA,KAAK,CAACG,QAAQ,EAAED,KAAK,CAACE,IAAI,CAACT,GAAG,CAACK,KAAK,CAACG,QAAQ,CAAC,CAAC;EAC5DD,KAAK,CAACE,IAAI,CAACT,GAAG,CAACK,KAAK,GAAGA,KAAK,CAACK,MAAM,GAAG,EAAE,CAAC,CAAC;EAC1CH,KAAK,CAACE,IAAI,CAACH,YAAY,CAAC;EACxB,OAAOC,KAAK,CAACI,IAAI,CAAC,GAAG,CAAC;AACxB;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAACP,KAAY,EAAU;EACrD,IAAME,KAAK,GAAG,CAACR,UAAU,EAAED,kBAAkB,CAAC;EAC9C,IAAIO,KAAK,IAAIA,KAAK,CAACG,QAAQ,EAAED,KAAK,CAACE,IAAI,CAACT,GAAG,CAACK,KAAK,CAACG,QAAQ,CAAC,CAAC;EAC5DD,KAAK,CAACE,IAAI,CAACT,GAAG,CAACK,KAAK,GAAGA,KAAK,CAACK,MAAM,GAAG,EAAE,CAAC,CAAC;EAC1CH,KAAK,CAACE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;EAChB,OAAOF,KAAK,CAACI,IAAI,CAAC,GAAG,CAAC;AACxB;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASE,sBAAsBA,CACpCC,GAAW,EACXT,KAAY,EACG;EACf,IAAI,OAAOS,GAAG,KAAK,QAAQ,EAAE,OAAO,IAAI;EACxC,IAAMC,MAAM,GAAGH,gBAAgB,CAACP,KAAK,CAAC;EACtC,IAAIS,GAAG,CAACE,OAAO,CAACD,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,IAAI;EAC1C,IAAME,KAAK,GAAGH,GAAG,CAACI,KAAK,CAACH,MAAM,CAACI,MAAM,CAAC;EACtC,OAAOF,KAAK,IAAI,IAAI;AACtB","ignoreList":[]}