@portnet/ui 6.0.1 → 6.0.3

package/dist/v2/patterns/rowActions.d.ts

@@ -0,0 +1,150 @@
+import * as React from "react";
+import type { OverflowMenuAction } from "../components/OverflowMenu";
+/**
+ * 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. */
+export declare 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.
+ */
+export interface RowActionDescriptor<T> {
+    /** Stable identifier — render key and test anchor. */
+    id: string;
+    /** Menu label. Verb + object (R-B.3, §9.2). */
+    label: React.ReactNode;
+    icon?: React.ReactNode | undefined;
+    onClick: (row: T) => void;
+    /** Hides the action for this row. */
+    hidden?: ((row: T) => boolean) | undefined;
+    /** Shows the action but disables it for this row. */
+    disabled?: ((row: T) => boolean) | undefined;
+    /** Destructive: separator before, danger styling (R-B.6). */
+    danger?: boolean | undefined;
+    /** Keyboard shortcut rendered at the end of the item. */
+    shortcut?: React.ReactNode | undefined;
+}
+/**
+ * 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 declare function buildRowActionMenu<T>(descriptors: readonly RowActionDescriptor<T>[], row: T): OverflowMenuAction[];
+/**
+ * Options of {@link buildRowActions}.
+ */
+export interface BuildRowActionsOptions {
+    /**
+     * Render the row's VISIBLE actions as icon buttons while their count is
+     * at most this value; fall back to the kebab menu above it.
+     *
+     * Omitted — the default — always renders the kebab, so existing callers
+     * are untouched.
+     *
+     * The threshold counts actions visible FOR THAT ROW, never the number
+     * declared: five descriptors whose `hidden` predicates are mutually
+     * exclusive by status typically leave two or three per row.
+     */
+    iconsUpTo?: number | undefined;
+}
+/**
+ * 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 declare function buildRowActions<T>(descriptors: readonly RowActionDescriptor<T>[], ariaLabel?: string, options?: BuildRowActionsOptions): (row: T) => React.ReactNode;
+//# sourceMappingURL=rowActions.d.ts.map

package/dist/v2/patterns/rowActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rowActions.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/patterns/rowActions.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAIrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAEH,4EAA4E;AAC5E,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAC;IACX,+CAA+C;IAC/C,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IACnC,OAAO,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC;IAC1B,qCAAqC;IACrC,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;IAC3C,qDAAqD;IACrD,QAAQ,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;IAC7C,6DAA6D;IAC7D,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,yDAAyD;IACzD,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;CACxC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,WAAW,EAAE,SAAS,mBAAmB,CAAC,CAAC,CAAC,EAAE,EAC9C,GAAG,EAAE,CAAC,GACL,kBAAkB,EAAE,CA4CtB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;;;;;;OAUG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,WAAW,EAAE,SAAS,mBAAmB,CAAC,CAAC,CAAC,EAAE,EAC9C,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,CAAC,GAAG,EAAE,CAAC,KAAK,KAAK,CAAC,SAAS,CA2D7B"}

package/dist/v2/patterns/rowActions.js

@@ -0,0 +1,232 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.MAX_ROW_ACTIONS = void 0;
+exports.buildRowActionMenu = buildRowActionMenu;
+exports.buildRowActions = buildRowActions;
+var React = _interopRequireWildcard(require("react"));
+var _OverflowMenu = _interopRequireDefault(require("../components/OverflowMenu"));
+var _Button = _interopRequireDefault(require("../components/Button"));
+var _Tooltip = _interopRequireDefault(require("../components/Tooltip"));
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+/**
+ * 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. */
+const MAX_ROW_ACTIONS = exports.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.
+ */
+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}
+ */
+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__*/(0, _jsxRuntime.jsx)(_Tooltip.default, {
+          title: d.label,
+          children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Button.default, {
+            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__*/(0, _jsxRuntime.jsx)(_OverflowMenu.default, {
+      actions: items,
+      ...(ariaLabel !== undefined ? {
+        ariaLabel
+      } : {})
+    });
+  };
+}
+//# sourceMappingURL=rowActions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rowActions.js","names":["React","_interopRequireWildcard","require","_OverflowMenu","_interopRequireDefault","_Button","_Tooltip","_jsxRuntime","e","__esModule","default","t","WeakMap","r","n","o","i","f","__proto__","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","MAX_ROW_ACTIONS","exports","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","jsx","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":[]}

package/dist/v2/personalization/PersonalizationProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PersonalizationProvider.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/personalization/PersonalizationProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAM/B,OAAO,KAAK,EAEV,qBAAqB,EACtB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAEhF,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAS,MAAM,SAAS,CAAC;AAO/D;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;EAqBT,CAAC;AAEnC,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IACvC,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,qFAAqF;IACrF,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC/C,qDAAqD;IACrD,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,SAAS,CAAC;IACpD,gFAAgF;IAChF,OAAO,CAAC,EAAE,2BAA2B,GAAG,SAAS,CAAC;IAClD,qGAAqG;IACrG,eAAe,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;CAC/C;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,gCAAgC,GACtC,KAAK,CAAC,GAAG,CAAC,OAAO,CA6HnB;AAED,eAAe,2BAA2B,CAAC"}
+{"version":3,"file":"PersonalizationProvider.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/personalization/PersonalizationProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAM/B,OAAO,KAAK,EAEV,qBAAqB,EACtB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAEhF,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAS,MAAM,SAAS,CAAC;AAO/D;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;EAqBT,CAAC;AAEnC,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IACvC,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,qFAAqF;IACrF,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC/C,qDAAqD;IACrD,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,SAAS,CAAC;IACpD,gFAAgF;IAChF,OAAO,CAAC,EAAE,2BAA2B,GAAG,SAAS,CAAC;IAClD,qGAAqG;IACrG,eAAe,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;CAC/C;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,gCAAgC,GACtC,KAAK,CAAC,GAAG,CAAC,OAAO,CA+HnB;AAED,eAAe,2BAA2B,CAAC"}

package/dist/v2/personalization/PersonalizationProvider.js

@@ -5,21 +5,15 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.DEFAULT_PERSONALIZATION_LABELS = void 0;
 exports.UserPersonalizationProvider = UserPersonalizationProvider;
-exports["default"] = void 0;
+exports.default = void 0;
 var React = _interopRequireWildcard(require("react"));
 var _personalizationContext = require("./personalizationContext");
 var _createPersonalizationStore = _interopRequireDefault(require("./createPersonalizationStore"));
 var _createLocalStorageAdapter = _interopRequireDefault(require("./adapters/createLocalStorageAdapter"));
 var _jsxRuntime = require("react/jsx-runtime");
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
-function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { "default": obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj["default"] = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
-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); } /**
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+/**
  * UserPersonalizationProvider — Portnet UI v2 · personalization
  *
  * The single configuration point for per-user personalization. Mount it
@@ -47,7 +41,8 @@ function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input ==
  *
  * React 18/19 compatible: no 19-only API is required.
  */
-var isDev = typeof process !== "undefined" && process.env && process.env["NODE_ENV"] !== "production";
+
+const isDev = typeof process !== "undefined" && process.env && process.env["NODE_ENV"] !== "production";
 
 /**
  * Default labels for the whole foundation (FR — charter default). Hosts
@@ -55,7 +50,7 @@ var isDev = typeof process !== "undefined" && process.env && process.env["NODE_E
  * Front-loaded here so the favorites (Batch 3) and saved-filters (Batch 4)
  * components read consistent copy from one place.
  */
-var DEFAULT_PERSONALIZATION_LABELS = exports.DEFAULT_PERSONALIZATION_LABELS = Object.freeze({
+const DEFAULT_PERSONALIZATION_LABELS = exports.DEFAULT_PERSONALIZATION_LABELS = Object.freeze({
   // Follow / "suivis" (Batch 3)
   addFavorite: "Suivre",
   removeFavorite: "Ne plus suivre",
@@ -78,51 +73,57 @@ var DEFAULT_PERSONALIZATION_LABELS = exports.DEFAULT_PERSONALIZATION_LABELS = Ob
   cancel: "Annuler"
 });
 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;
+  const {
+    children,
+    userId,
+    tenantId,
+    appId,
+    adapter,
+    defaults,
+    labels,
+    onError,
+    hydrateStrategy = "remote-wins"
+  } = props;
+
+  // eslint-disable-next-line no-console
   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
-    } : {});
+  const resolvedUserId = userId || "anonymous";
+  const scope = React.useMemo(function buildScope() {
+    return {
+      userId: resolvedUserId,
+      ...(tenantId !== undefined ? {
+        tenantId
+      } : {}),
+      ...(appId !== undefined ? {
+        appId
+      } : {})
+    };
   }, [resolvedUserId, tenantId, appId]);
 
   // Default adapter created once; a provided adapter is trusted to be stable.
-  var defaultAdapterRef = React.useRef(null);
+  const defaultAdapterRef = React.useRef(null);
   if (!adapter && !defaultAdapterRef.current) {
-    defaultAdapterRef.current = (0, _createLocalStorageAdapter["default"])();
+    defaultAdapterRef.current = (0, _createLocalStorageAdapter.default)();
   }
-  var resolvedAdapter = adapter || defaultAdapterRef.current;
+  const 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 (0, _createPersonalizationStore["default"])(_objectSpread(_objectSpread(_objectSpread({
+  const store = React.useMemo(function buildStore() {
+    return (0, _createPersonalizationStore.default)({
       scope: scope,
-      adapter: resolvedAdapter
-    }, defaults !== undefined ? {
-      defaults: defaults
-    } : {}), onError !== undefined ? {
-      onError: onError
-    } : {}), {}, {
+      adapter: resolvedAdapter,
+      ...(defaults !== undefined ? {
+        defaults
+      } : {}),
+      ...(onError !== undefined ? {
+        onError
+      } : {}),
       hydrateStrategy: hydrateStrategy
-    }));
+    });
   },
   // eslint-disable-next-line react-hooks/exhaustive-deps
   [scope, resolvedAdapter]);
@@ -130,7 +131,7 @@ function UserPersonalizationProvider(props) {
   // Hydrate + cross-tab connect; dispose on store change / unmount.
   React.useEffect(function lifecycle() {
     store.hydrate();
-    var off = store.connect();
+    const off = store.connect();
     return function teardown() {
       if (typeof off === "function") off();
       store.dispose();
@@ -139,27 +140,30 @@ function UserPersonalizationProvider(props) {
 
   // Push live runtime options without recreating the store.
   React.useEffect(function syncRuntime() {
-    store.setRuntime(_objectSpread(_objectSpread({}, onError !== undefined ? {
-      onError: onError
-    } : {}), {}, {
+    store.setRuntime({
+      ...(onError !== undefined ? {
+        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);
+  const prevAdapterRef = React.useRef(resolvedAdapter);
   React.useEffect(function guardAdapterIdentity() {
-    if (isDev && prevAdapterRef.current !== resolvedAdapter && typeof console !== "undefined" && console.warn) {
+    if (isDev && prevAdapterRef.current !== resolvedAdapter && typeof console !== "undefined" &&
+    // eslint-disable-next-line no-console
+    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() {
+  const mergedLabels = React.useMemo(function mergeLabels() {
     return labels ? Object.assign({}, DEFAULT_PERSONALIZATION_LABELS, labels) : DEFAULT_PERSONALIZATION_LABELS;
   }, [labels]);
-  var configValue = React.useMemo(function buildConfig() {
+  const configValue = React.useMemo(function buildConfig() {
     return {
       scope: scope,
       labels: mergedLabels
@@ -173,5 +177,5 @@ function UserPersonalizationProvider(props) {
     })
   });
 }
-var _default = exports["default"] = UserPersonalizationProvider;
+var _default = exports.default = UserPersonalizationProvider;
 //# sourceMappingURL=PersonalizationProvider.js.map