@portnet/ui 6.0.2 → 6.0.3

package/dist/esm/v2/personalization/capabilities/favoritesView.js

@@ -1,6 +1,3 @@
-function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
-function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
-function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
 /**
  * favoritesView — Portnet UI v2 · personalization
  *
@@ -16,16 +13,16 @@ function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len
 
 import * as React from "react";
 import { useFavorites } from "./favorites";
-export var FAVORITES_FILTER = Object.freeze({
+export const FAVORITES_FILTER = Object.freeze({
   ALL: "all",
   ONLY: "only"
 });
-export var FAVORITES_SORT = Object.freeze({
+export const FAVORITES_SORT = Object.freeze({
   NONE: "none",
   FIRST: "first",
   LAST: "last"
 });
-var EMPTY_ROWS = Object.freeze([]);
+const EMPTY_ROWS = Object.freeze([]);
 function toIdSet(ids) {
   return ids instanceof Set ? ids : new Set(ids || []);
 }
@@ -42,9 +39,9 @@ function resolveGetRowId(getRowId) {
 export function filterRowsByFavorites(rows, favoriteIds, getRowId, mode) {
   if (mode !== FAVORITES_FILTER.ONLY || !Array.isArray(rows)) return rows;
   // Array.isArray widened `rows` to any[]; re-establish the element type.
-  var source = rows;
-  var ids = toIdSet(favoriteIds);
-  var getId = resolveGetRowId(getRowId);
+  const source = rows;
+  const ids = toIdSet(favoriteIds);
+  const getId = resolveGetRowId(getRowId);
   return source.filter(function keepFavorite(r) {
     return ids.has(getId(r));
   });
@@ -60,22 +57,13 @@ export function sortRowsByFavorites(rows, favoriteIds, getRowId, placement) {
     return rows;
   }
   // Array.isArray widened `rows` to any[]; re-establish the element type.
-  var source = rows;
-  var ids = toIdSet(favoriteIds);
-  var getId = resolveGetRowId(getRowId);
-  var fav = [];
-  var rest = [];
-  var _iterator = _createForOfIteratorHelper(source),
-    _step;
-  try {
-    for (_iterator.s(); !(_step = _iterator.n()).done;) {
-      var row = _step.value;
-      if (ids.has(getId(row))) fav.push(row);else rest.push(row);
-    }
-  } catch (err) {
-    _iterator.e(err);
-  } finally {
-    _iterator.f();
+  const source = rows;
+  const ids = toIdSet(favoriteIds);
+  const getId = resolveGetRowId(getRowId);
+  const fav = [];
+  const rest = [];
+  for (const row of source) {
+    if (ids.has(getId(row))) fav.push(row);else rest.push(row);
   }
   if (fav.length === 0 || rest.length === 0) return source; // nothing to reorder
   return placement === FAVORITES_SORT.FIRST ? fav.concat(rest) : rest.concat(fav);
@@ -88,15 +76,15 @@ export function sortRowsByFavorites(rows, favoriteIds, getRowId, placement) {
  * reference is returned unchanged.
  */
 export function useFavoritesView(resourceKey, rows, options) {
-  var opts = options || {};
-  var getRowId = opts.getRowId;
-  var filterMode = opts.filterMode || FAVORITES_FILTER.ALL;
-  var sortPlacement = opts.sortPlacement || FAVORITES_SORT.NONE;
-  var fav = useFavorites(resourceKey);
-  var ids = fav.ids;
-  var processed = React.useMemo(function compute() {
-    var base = Array.isArray(rows) ? rows : EMPTY_ROWS;
-    var filtered = filterRowsByFavorites(base, ids, getRowId, filterMode);
+  const opts = options || {};
+  const getRowId = opts.getRowId;
+  const filterMode = opts.filterMode || FAVORITES_FILTER.ALL;
+  const sortPlacement = opts.sortPlacement || FAVORITES_SORT.NONE;
+  const fav = useFavorites(resourceKey);
+  const ids = fav.ids;
+  const processed = React.useMemo(function compute() {
+    const base = Array.isArray(rows) ? rows : EMPTY_ROWS;
+    const filtered = filterRowsByFavorites(base, ids, getRowId, filterMode);
     return sortRowsByFavorites(filtered, ids, getRowId, sortPlacement);
   }, [rows, ids, getRowId, filterMode, sortPlacement]);
   return React.useMemo(function value() {

package/dist/esm/v2/personalization/capabilities/favoritesView.js.map

@@ -1 +1 @@
-{"version":3,"file":"favoritesView.js","names":["React","useFavorites","FAVORITES_FILTER","Object","freeze","ALL","ONLY","FAVORITES_SORT","NONE","FIRST","LAST","EMPTY_ROWS","toIdSet","ids","Set","resolveGetRowId","getRowId","defaultGetRowId","r","id","filterRowsByFavorites","rows","favoriteIds","mode","Array","isArray","source","getId","filter","keepFavorite","has","sortRowsByFavorites","placement","fav","rest","_iterator","_createForOfIteratorHelper","_step","s","n","done","row","value","push","err","e","f","length","concat","useFavoritesView","resourceKey","options","opts","filterMode","sortPlacement","processed","useMemo","compute","base","filtered","favoriteCount","count","isFiltering"],"sources":["../../../../../src/lib/v2/personalization/capabilities/favoritesView.ts"],"sourcesContent":["/**\r\n * favoritesView — Portnet UI v2 · personalization\r\n *\r\n * Grid-agnostic favorites VIEW logic: filter (all / favorites-only) and\r\n * sort (favorites-first / favorites-last). Pure helpers usable anywhere,\r\n * plus a useFavoritesView hook that wires them to the favorites capability.\r\n *\r\n * The host owns its row id contract and the toggle UI (use FavoritesFilter\r\n * or any control bound to `filterMode` / `sortPlacement`). These helpers\r\n * only reorder/subset the rows array the host already has — they never\r\n * fetch or mutate.\r\n */\r\n\r\nimport * as React from \"react\";\r\n\r\nimport { useFavorites } from \"./favorites\";\r\nimport type { RowId } from \"../../types/common\";\r\n\r\nexport const FAVORITES_FILTER = Object.freeze({\r\n  ALL: \"all\",\r\n  ONLY: \"only\",\r\n} as const);\r\nexport const FAVORITES_SORT = Object.freeze({\r\n  NONE: \"none\",\r\n  FIRST: \"first\",\r\n  LAST: \"last\",\r\n} as const);\r\n\r\nexport type FavoritesFilterMode =\r\n  (typeof FAVORITES_FILTER)[keyof typeof FAVORITES_FILTER];\r\nexport type FavoritesSortPlacement =\r\n  (typeof FAVORITES_SORT)[keyof typeof FAVORITES_SORT];\r\n\r\nconst EMPTY_ROWS: readonly never[] = Object.freeze([]);\r\n\r\nfunction toIdSet(\r\n  ids: Set<RowId> | readonly RowId[] | null | undefined\r\n): Set<RowId> {\r\n  return ids instanceof Set ? ids : new Set(ids || []);\r\n}\r\n\r\nfunction resolveGetRowId<T>(getRowId?: (row: T) => RowId): (row: T) => RowId {\r\n  return typeof getRowId === \"function\"\r\n    ? getRowId\r\n    : function defaultGetRowId(r: T): RowId {\r\n        return (r as { id: RowId }).id;\r\n      };\r\n}\r\n\r\n/**\r\n * Keep only favorited rows when mode === \"only\"; otherwise return `rows`\r\n * unchanged (same reference).\r\n */\r\nexport function filterRowsByFavorites<T>(\r\n  rows: readonly T[],\r\n  favoriteIds: Set<RowId> | readonly RowId[] | null | undefined,\r\n  getRowId: ((row: T) => RowId) | undefined,\r\n  mode: FavoritesFilterMode\r\n): readonly T[] {\r\n  if (mode !== FAVORITES_FILTER.ONLY || !Array.isArray(rows)) return rows;\r\n  // Array.isArray widened `rows` to any[]; re-establish the element type.\r\n  const source: readonly T[] = rows;\r\n  const ids = toIdSet(favoriteIds);\r\n  const getId = resolveGetRowId(getRowId);\r\n  return source.filter(function keepFavorite(r) {\r\n    return ids.has(getId(r));\r\n  });\r\n}\r\n\r\n/**\r\n * Move favorited rows to the front (\"first\") or back (\"last\"), preserving\r\n * the host's existing order WITHIN each group (stable partition). Returns\r\n * `rows` unchanged when placement is \"none\" or when reordering is a no-op.\r\n */\r\nexport function sortRowsByFavorites<T>(\r\n  rows: readonly T[],\r\n  favoriteIds: Set<RowId> | readonly RowId[] | null | undefined,\r\n  getRowId: ((row: T) => RowId) | undefined,\r\n  placement: FavoritesSortPlacement\r\n): readonly T[] {\r\n  if (\r\n    (placement !== FAVORITES_SORT.FIRST && placement !== FAVORITES_SORT.LAST) ||\r\n    !Array.isArray(rows)\r\n  ) {\r\n    return rows;\r\n  }\r\n  // Array.isArray widened `rows` to any[]; re-establish the element type.\r\n  const source: readonly T[] = rows;\r\n  const ids = toIdSet(favoriteIds);\r\n  const getId = resolveGetRowId(getRowId);\r\n  const fav: T[] = [];\r\n  const rest: T[] = [];\r\n  for (const row of source) {\r\n    if (ids.has(getId(row))) fav.push(row);\r\n    else rest.push(row);\r\n  }\r\n  if (fav.length === 0 || rest.length === 0) return source; // nothing to reorder\r\n  return placement === FAVORITES_SORT.FIRST\r\n    ? fav.concat(rest)\r\n    : rest.concat(fav);\r\n}\r\n\r\nexport interface UseFavoritesViewOptions<T> {\r\n  /** Should be stable; MUST match the grid's getRowId. Defaults to (r) => r.id. */\r\n  getRowId?: ((row: T) => RowId) | undefined;\r\n  /** @default \"all\" */\r\n  filterMode?: FavoritesFilterMode | undefined;\r\n  /** @default \"none\" */\r\n  sortPlacement?: FavoritesSortPlacement | undefined;\r\n}\r\n\r\nexport interface UseFavoritesViewResult<T> {\r\n  rows: readonly T[];\r\n  favoriteIds: Set<RowId>;\r\n  favoriteCount: number;\r\n  isFiltering: boolean;\r\n}\r\n\r\n/**\r\n * useFavoritesView(resourceKey, rows, options)\r\n *\r\n * Reads the favorites id Set for `resourceKey` and applies the favorites\r\n * filter + sort to `rows`. In the all/none case the original `rows`\r\n * reference is returned unchanged.\r\n */\r\nexport function useFavoritesView<T>(\r\n  resourceKey: string,\r\n  rows: readonly T[],\r\n  options?: UseFavoritesViewOptions<T>\r\n): UseFavoritesViewResult<T> {\r\n  const opts: UseFavoritesViewOptions<T> = options || {};\r\n  const getRowId = opts.getRowId;\r\n  const filterMode = opts.filterMode || FAVORITES_FILTER.ALL;\r\n  const sortPlacement = opts.sortPlacement || FAVORITES_SORT.NONE;\r\n\r\n  const fav = useFavorites(resourceKey);\r\n  const ids = fav.ids;\r\n\r\n  const processed = React.useMemo(\r\n    function compute(): readonly T[] {\r\n      const base: readonly T[] = Array.isArray(rows) ? rows : EMPTY_ROWS;\r\n      const filtered = filterRowsByFavorites(base, ids, getRowId, filterMode);\r\n      return sortRowsByFavorites(filtered, ids, getRowId, sortPlacement);\r\n    },\r\n    [rows, ids, getRowId, filterMode, sortPlacement]\r\n  );\r\n\r\n  return React.useMemo(\r\n    function value(): UseFavoritesViewResult<T> {\r\n      return {\r\n        rows: processed,\r\n        favoriteIds: ids,\r\n        favoriteCount: fav.count,\r\n        isFiltering: filterMode === FAVORITES_FILTER.ONLY,\r\n      };\r\n    },\r\n    [processed, ids, fav.count, filterMode]\r\n  );\r\n}\r\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"favoritesView.js","names":["React","useFavorites","FAVORITES_FILTER","Object","freeze","ALL","ONLY","FAVORITES_SORT","NONE","FIRST","LAST","EMPTY_ROWS","toIdSet","ids","Set","resolveGetRowId","getRowId","defaultGetRowId","r","id","filterRowsByFavorites","rows","favoriteIds","mode","Array","isArray","source","getId","filter","keepFavorite","has","sortRowsByFavorites","placement","fav","rest","row","push","length","concat","useFavoritesView","resourceKey","options","opts","filterMode","sortPlacement","processed","useMemo","compute","base","filtered","value","favoriteCount","count","isFiltering"],"sources":["../../../../../src/lib/v2/personalization/capabilities/favoritesView.ts"],"sourcesContent":["/**\r\n * favoritesView — Portnet UI v2 · personalization\r\n *\r\n * Grid-agnostic favorites VIEW logic: filter (all / favorites-only) and\r\n * sort (favorites-first / favorites-last). Pure helpers usable anywhere,\r\n * plus a useFavoritesView hook that wires them to the favorites capability.\r\n *\r\n * The host owns its row id contract and the toggle UI (use FavoritesFilter\r\n * or any control bound to `filterMode` / `sortPlacement`). These helpers\r\n * only reorder/subset the rows array the host already has — they never\r\n * fetch or mutate.\r\n */\r\n\r\nimport * as React from \"react\";\r\n\r\nimport { useFavorites } from \"./favorites\";\r\nimport type { RowId } from \"../../types/common\";\r\n\r\nexport const FAVORITES_FILTER = Object.freeze({\r\n  ALL: \"all\",\r\n  ONLY: \"only\",\r\n} as const);\r\nexport const FAVORITES_SORT = Object.freeze({\r\n  NONE: \"none\",\r\n  FIRST: \"first\",\r\n  LAST: \"last\",\r\n} as const);\r\n\r\nexport type FavoritesFilterMode =\r\n  (typeof FAVORITES_FILTER)[keyof typeof FAVORITES_FILTER];\r\nexport type FavoritesSortPlacement =\r\n  (typeof FAVORITES_SORT)[keyof typeof FAVORITES_SORT];\r\n\r\nconst EMPTY_ROWS: readonly never[] = Object.freeze([]);\r\n\r\nfunction toIdSet(\r\n  ids: Set<RowId> | readonly RowId[] | null | undefined\r\n): Set<RowId> {\r\n  return ids instanceof Set ? ids : new Set(ids || []);\r\n}\r\n\r\nfunction resolveGetRowId<T>(getRowId?: (row: T) => RowId): (row: T) => RowId {\r\n  return typeof getRowId === \"function\"\r\n    ? getRowId\r\n    : function defaultGetRowId(r: T): RowId {\r\n        return (r as { id: RowId }).id;\r\n      };\r\n}\r\n\r\n/**\r\n * Keep only favorited rows when mode === \"only\"; otherwise return `rows`\r\n * unchanged (same reference).\r\n */\r\nexport function filterRowsByFavorites<T>(\r\n  rows: readonly T[],\r\n  favoriteIds: Set<RowId> | readonly RowId[] | null | undefined,\r\n  getRowId: ((row: T) => RowId) | undefined,\r\n  mode: FavoritesFilterMode\r\n): readonly T[] {\r\n  if (mode !== FAVORITES_FILTER.ONLY || !Array.isArray(rows)) return rows;\r\n  // Array.isArray widened `rows` to any[]; re-establish the element type.\r\n  const source: readonly T[] = rows;\r\n  const ids = toIdSet(favoriteIds);\r\n  const getId = resolveGetRowId(getRowId);\r\n  return source.filter(function keepFavorite(r) {\r\n    return ids.has(getId(r));\r\n  });\r\n}\r\n\r\n/**\r\n * Move favorited rows to the front (\"first\") or back (\"last\"), preserving\r\n * the host's existing order WITHIN each group (stable partition). Returns\r\n * `rows` unchanged when placement is \"none\" or when reordering is a no-op.\r\n */\r\nexport function sortRowsByFavorites<T>(\r\n  rows: readonly T[],\r\n  favoriteIds: Set<RowId> | readonly RowId[] | null | undefined,\r\n  getRowId: ((row: T) => RowId) | undefined,\r\n  placement: FavoritesSortPlacement\r\n): readonly T[] {\r\n  if (\r\n    (placement !== FAVORITES_SORT.FIRST && placement !== FAVORITES_SORT.LAST) ||\r\n    !Array.isArray(rows)\r\n  ) {\r\n    return rows;\r\n  }\r\n  // Array.isArray widened `rows` to any[]; re-establish the element type.\r\n  const source: readonly T[] = rows;\r\n  const ids = toIdSet(favoriteIds);\r\n  const getId = resolveGetRowId(getRowId);\r\n  const fav: T[] = [];\r\n  const rest: T[] = [];\r\n  for (const row of source) {\r\n    if (ids.has(getId(row))) fav.push(row);\r\n    else rest.push(row);\r\n  }\r\n  if (fav.length === 0 || rest.length === 0) return source; // nothing to reorder\r\n  return placement === FAVORITES_SORT.FIRST\r\n    ? fav.concat(rest)\r\n    : rest.concat(fav);\r\n}\r\n\r\nexport interface UseFavoritesViewOptions<T> {\r\n  /** Should be stable; MUST match the grid's getRowId. Defaults to (r) => r.id. */\r\n  getRowId?: ((row: T) => RowId) | undefined;\r\n  /** @default \"all\" */\r\n  filterMode?: FavoritesFilterMode | undefined;\r\n  /** @default \"none\" */\r\n  sortPlacement?: FavoritesSortPlacement | undefined;\r\n}\r\n\r\nexport interface UseFavoritesViewResult<T> {\r\n  rows: readonly T[];\r\n  favoriteIds: Set<RowId>;\r\n  favoriteCount: number;\r\n  isFiltering: boolean;\r\n}\r\n\r\n/**\r\n * useFavoritesView(resourceKey, rows, options)\r\n *\r\n * Reads the favorites id Set for `resourceKey` and applies the favorites\r\n * filter + sort to `rows`. In the all/none case the original `rows`\r\n * reference is returned unchanged.\r\n */\r\nexport function useFavoritesView<T>(\r\n  resourceKey: string,\r\n  rows: readonly T[],\r\n  options?: UseFavoritesViewOptions<T>\r\n): UseFavoritesViewResult<T> {\r\n  const opts: UseFavoritesViewOptions<T> = options || {};\r\n  const getRowId = opts.getRowId;\r\n  const filterMode = opts.filterMode || FAVORITES_FILTER.ALL;\r\n  const sortPlacement = opts.sortPlacement || FAVORITES_SORT.NONE;\r\n\r\n  const fav = useFavorites(resourceKey);\r\n  const ids = fav.ids;\r\n\r\n  const processed = React.useMemo(\r\n    function compute(): readonly T[] {\r\n      const base: readonly T[] = Array.isArray(rows) ? rows : EMPTY_ROWS;\r\n      const filtered = filterRowsByFavorites(base, ids, getRowId, filterMode);\r\n      return sortRowsByFavorites(filtered, ids, getRowId, sortPlacement);\r\n    },\r\n    [rows, ids, getRowId, filterMode, sortPlacement]\r\n  );\r\n\r\n  return React.useMemo(\r\n    function value(): UseFavoritesViewResult<T> {\r\n      return {\r\n        rows: processed,\r\n        favoriteIds: ids,\r\n        favoriteCount: fav.count,\r\n        isFiltering: filterMode === FAVORITES_FILTER.ONLY,\r\n      };\r\n    },\r\n    [processed, ids, fav.count, filterMode]\r\n  );\r\n}\r\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/v2/personalization/capabilities/gridPreferences.js

@@ -1,9 +1,3 @@
-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 _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); }
 /**
  * gridPreferences — Portnet UI v2 · personalization capability
  *
@@ -84,10 +78,10 @@ import { usePersonalizationStore, useStoreSelector } from "../personalizationCon
 
 /** The gridPreferences capability payload: entries keyed by resourceKey. */
 
-export var GRID_PREFERENCES_CAPABILITY_ID = "gridPreferences";
-var SCHEMA_VERSION = 1;
-var EMPTY_LIST = Object.freeze([]);
-var EMPTY_MAP = Object.freeze({});
+export const GRID_PREFERENCES_CAPABILITY_ID = "gridPreferences";
+const SCHEMA_VERSION = 1;
+const EMPTY_LIST = Object.freeze([]);
+const EMPTY_MAP = Object.freeze({});
 function isString(value) {
   return typeof value === "string";
 }
@@ -105,16 +99,15 @@ registerCapability({
      * to hide grid columns; a number or an object arriving from an older build
      * (or from hand-edited devtools storage) must not reach the DataGrid as if
      * it were one. Anything unrecognised is dropped rather than repaired. */
-    if (!payload || _typeof(payload) !== "object") return {};
-    var source = payload;
-    var next = {};
-    for (var _i = 0, _Object$keys = Object.keys(source); _i < _Object$keys.length; _i++) {
-      var resourceKey = _Object$keys[_i];
-      var entry = source[resourceKey];
-      if (!entry || _typeof(entry) !== "object") continue;
-      var raw = entry["hiddenColumns"];
+    if (!payload || typeof payload !== "object") return {};
+    const source = payload;
+    const next = {};
+    for (const resourceKey of Object.keys(source)) {
+      const entry = source[resourceKey];
+      if (!entry || typeof entry !== "object") continue;
+      const raw = entry["hiddenColumns"];
       if (!Array.isArray(raw)) continue;
-      var keys = raw.filter(isString);
+      const keys = raw.filter(isString);
       if (keys.length > 0) next[resourceKey] = {
         hiddenColumns: keys
       };
@@ -126,22 +119,22 @@ registerCapability({
 /* ── pure, resourceKey-scoped state helpers (structural sharing) ────── */
 
 function listFor(map, resourceKey) {
-  var entry = map ? map[resourceKey] : undefined;
-  var list = entry ? entry.hiddenColumns : undefined;
+  const entry = map ? map[resourceKey] : undefined;
+  const list = entry ? entry.hiddenColumns : undefined;
   return Array.isArray(list) ? list : EMPTY_LIST;
 }
 function sameMembers(a, b) {
   if (a.length !== b.length) return false;
-  for (var i = 0; i < a.length; i++) {
+  for (let i = 0; i < a.length; i++) {
     if (a[i] !== b[i]) return false;
   }
   return true;
 }
 function setList(map, resourceKey, keys) {
-  var base = map || EMPTY_MAP;
+  const base = map || EMPTY_MAP;
   // No-op when unchanged → the store short-circuits and nothing re-renders.
   if (sameMembers(listFor(base, resourceKey), keys)) return base;
-  var next = Object.assign({}, base);
+  const next = Object.assign({}, base);
   if (keys.length === 0) {
     // Nothing hidden is the default; drop the entry rather than persist an
     // empty array, so the payload stays tidy and a reset leaves no residue.
@@ -153,9 +146,10 @@ function setList(map, resourceKey, keys) {
     // containing undefined. Spreading undefined is well-defined ({}), and it
     // preserves any sibling preference a future schema adds alongside
     // hiddenColumns.
-    next[resourceKey] = _objectSpread(_objectSpread({}, base[resourceKey]), {}, {
+    next[resourceKey] = {
+      ...base[resourceKey],
       hiddenColumns: keys.slice()
-    });
+    };
   }
   return next;
 }
@@ -172,28 +166,28 @@ function useEnsureGridPreferences(store) {
  * one resource.
  */
 export function useGridPreferences(resourceKey) {
-  var store = usePersonalizationStore();
+  const store = usePersonalizationStore();
   useEnsureGridPreferences(store);
-  var selectList = React.useCallback(function selectList(snapshot) {
-    var slice = snapshot[GRID_PREFERENCES_CAPABILITY_ID];
+  const selectList = React.useCallback(function selectList(snapshot) {
+    const slice = snapshot[GRID_PREFERENCES_CAPABILITY_ID];
     return slice ? listFor(slice, resourceKey) : EMPTY_LIST;
   }, [resourceKey]);
-  var keys = useStoreSelector(selectList);
+  const keys = useStoreSelector(selectList);
 
   // Stable while `keys` is stable (structural sharing), so the Set identity
   // does not churn on every render and DataGrid's memoisation still holds.
-  var hiddenColumns = React.useMemo(function buildSet() {
+  const hiddenColumns = React.useMemo(function buildSet() {
     return new Set(keys);
   }, [keys]);
-  var setHiddenColumns = React.useCallback(function setHiddenColumns(hidden) {
+  const setHiddenColumns = React.useCallback(function setHiddenColumns(hidden) {
     // Normalise at the write boundary too: the caller is UI code, but the
     // value is about to be persisted and re-read by a later session.
-    var nextKeys = Array.from(hidden).filter(isString);
+    const nextKeys = Array.from(hidden).filter(isString);
     store.write(GRID_PREFERENCES_CAPABILITY_ID, function (prev) {
       return setList(prev, resourceKey, nextKeys);
     });
   }, [store, resourceKey]);
-  var resetHiddenColumns = React.useCallback(function resetHiddenColumns() {
+  const resetHiddenColumns = React.useCallback(function resetHiddenColumns() {
     store.write(GRID_PREFERENCES_CAPABILITY_ID, function (prev) {
       return setList(prev, resourceKey, EMPTY_LIST);
     });

package/dist/esm/v2/personalization/capabilities/gridPreferences.js.map

@@ -1 +1 @@
-{"version":3,"file":"gridPreferences.js","names":["React","registerCapability","usePersonalizationStore","useStoreSelector","GRID_PREFERENCES_CAPABILITY_ID","SCHEMA_VERSION","EMPTY_LIST","Object","freeze","EMPTY_MAP","isString","value","id","schemaVersion","defaultState","migrate","migrateGridPreferences","_fromVersion","payload","_typeof","source","next","_i","_Object$keys","keys","length","resourceKey","entry","raw","Array","isArray","filter","hiddenColumns","listFor","map","undefined","list","sameMembers","a","b","i","setList","base","assign","_objectSpread","slice","useEnsureGridPreferences","store","useEffect","ensure","ensureCapability","useGridPreferences","selectList","useCallback","snapshot","useMemo","buildSet","Set","setHiddenColumns","hidden","nextKeys","from","write","prev","resetHiddenColumns"],"sources":["../../../../../src/lib/v2/personalization/capabilities/gridPreferences.ts"],"sourcesContent":["/**\r\n * gridPreferences — Portnet UI v2 · personalization capability\r\n *\r\n * Per-user, per-resource DataGrid preferences. Self-registers the\r\n * \"gridPreferences\" capability with the schema registry at import time, so the\r\n * capability-agnostic foundation discovers its schemaVersion / defaultState /\r\n * migrate without any hardcoding.\r\n *\r\n * State model (the capability payload):\r\n *   { [resourceKey]: { hiddenColumns: string[] } }\r\n *\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n * WHY THIS BELONGS IN THE LIBRARY (capability gap G-35)\r\n *\r\n * `DataGridToolbar` owns the column-visibility UI (`hiddenColumns` +\r\n * `onHiddenColumnsChange`) but deliberately holds no state, so PERSISTING the\r\n * choice is left to the host. Every listing screen therefore reached for raw\r\n * `localStorage` — observed in onssa-export-fe as\r\n * `\"onssaCertificates:listing:hiddenColumns\"`, hand-written JSON.parse\r\n * included.\r\n *\r\n * That is not merely duplication. A bare `localStorage` key is NOT USER-SCOPED,\r\n * while this foundation's own key scheme is:\r\n *\r\n *     portnet-ui:perso:v1:{tenantId?}:{userId}:{capabilityId}\r\n *\r\n * So on a shared workstation — the norm at a port — user B inherited user A's\r\n * hidden columns, and a column A had hidden stayed invisible to B with no\r\n * affordance explaining why. Favorites and saved filters were already immune\r\n * because they route through this foundation; column visibility was the one\r\n * grid preference that did not.\r\n *\r\n * It could not be fixed in a host, either. `registerCapability` is exported as\r\n * a \"capability registration seam — for custom/host-defined capabilities\", but\r\n * the two primitives every capability hook needs — `usePersonalizationStore`\r\n * and `useStoreSelector` — are deliberately private (\"architecture doc §2.8 —\r\n * minimum API surface\"). A host could register a descriptor and then had no way\r\n * to read or write its payload. The seam was advertised but not complete, so\r\n * the slice has to live here, exactly like favorites and savedFilters.\r\n *\r\n * DENSITY IS DELIBERATELY NOT PART OF THIS. `useDensity` (v2/hooks) owns the\r\n * density preference as a GLOBAL, non-resource-scoped value on its own\r\n * `portnet-ui-density` key, and it applies `data-density` to <html>. Folding it\r\n * in here would give one preference two owners. Note however that it is\r\n * unscoped for the same reason this capability exists — tracked separately,\r\n * since moving it into the foundation changes its storage key and would make it\r\n * require a provider (a breaking change for current callers).\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n *\r\n * Usage:\r\n *\r\n *   const { hiddenColumns, setHiddenColumns } = useGridPreferences(\"ti:list\");\r\n *\r\n *   <DataGridToolbar\r\n *     columns={columns}\r\n *     hiddenColumns={hiddenColumns}\r\n *     onHiddenColumnsChange={setHiddenColumns}\r\n *     … />\r\n *   <DataGrid columns={columns} hiddenColumns={hiddenColumns} … />\r\n *\r\n * `resourceKey` namespaces preferences per list (e.g. \"ti:list\",\r\n * \"declarations:list\") so two grids in one app never collide. Requires a\r\n * <UserPersonalizationProvider> ancestor.\r\n *\r\n * Performance: the pure helpers rebuild only the touched resourceKey's entry\r\n * and shallow-copy the map, so the store's structural sharing keeps every OTHER\r\n * resource's preferences referentially stable — and the exposed `Set` is\r\n * memoised on the stored array, so its identity survives re-renders and does\r\n * not defeat DataGrid's memoisation.\r\n */\r\n\r\nimport * as React from \"react\";\r\n\r\nimport { registerCapability } from \"../schema\";\r\nimport {\r\n  usePersonalizationStore,\r\n  useStoreSelector,\r\n} from \"../personalizationContext\";\r\nimport type {\r\n  PersonalizationSnapshot,\r\n  PersonalizationStore,\r\n} from \"../createPersonalizationStore\";\r\n\r\n/** One resource's grid preferences. Optional members so the shape can grow\r\n *  (column order, widths) without a schemaVersion bump. */\r\nexport interface GridPreferencesEntry {\r\n  hiddenColumns?: string[] | undefined;\r\n}\r\n\r\n/** The gridPreferences capability payload: entries keyed by resourceKey. */\r\ntype GridPreferencesState = Record<string, GridPreferencesEntry>;\r\n\r\nexport const GRID_PREFERENCES_CAPABILITY_ID = \"gridPreferences\";\r\nconst SCHEMA_VERSION = 1;\r\n\r\nconst EMPTY_LIST: readonly string[] = Object.freeze([]);\r\nconst EMPTY_MAP: GridPreferencesState = Object.freeze({});\r\n\r\nfunction isString(value: unknown): value is string {\r\n  return typeof value === \"string\";\r\n}\r\n\r\n/* Register at import time — the foundation reads this at hydration. */\r\nregisterCapability({\r\n  id: GRID_PREFERENCES_CAPABILITY_ID,\r\n  schemaVersion: SCHEMA_VERSION,\r\n  defaultState: EMPTY_MAP, // { [resourceKey]: { hiddenColumns: string[] } }\r\n  migrate: function migrateGridPreferences(\r\n    _fromVersion: number,\r\n    payload: unknown\r\n  ): unknown {\r\n    /* v1 is the initial schema, so there is no version to upgrade FROM — but\r\n     * this is the load-time trust boundary for a payload that came back from\r\n     * storage, and it is the right place to normalise it. A column key is used\r\n     * to hide grid columns; a number or an object arriving from an older build\r\n     * (or from hand-edited devtools storage) must not reach the DataGrid as if\r\n     * it were one. Anything unrecognised is dropped rather than repaired. */\r\n    if (!payload || typeof payload !== \"object\") return {};\r\n    const source = payload as Record<string, unknown>;\r\n    const next: GridPreferencesState = {};\r\n    for (const resourceKey of Object.keys(source)) {\r\n      const entry = source[resourceKey];\r\n      if (!entry || typeof entry !== \"object\") continue;\r\n      const raw = (entry as Record<string, unknown>)[\"hiddenColumns\"];\r\n      if (!Array.isArray(raw)) continue;\r\n      const keys = raw.filter(isString);\r\n      if (keys.length > 0) next[resourceKey] = { hiddenColumns: keys };\r\n    }\r\n    return next;\r\n  },\r\n});\r\n\r\n/* ── pure, resourceKey-scoped state helpers (structural sharing) ────── */\r\n\r\nfunction listFor(\r\n  map: GridPreferencesState | null | undefined,\r\n  resourceKey: string\r\n): readonly string[] {\r\n  const entry = map ? map[resourceKey] : undefined;\r\n  const list = entry ? entry.hiddenColumns : undefined;\r\n  return Array.isArray(list) ? list : EMPTY_LIST;\r\n}\r\n\r\nfunction sameMembers(a: readonly string[], b: readonly string[]): boolean {\r\n  if (a.length !== b.length) return false;\r\n  for (let i = 0; i < a.length; i++) {\r\n    if (a[i] !== b[i]) return false;\r\n  }\r\n  return true;\r\n}\r\n\r\nfunction setList(\r\n  map: GridPreferencesState | null | undefined,\r\n  resourceKey: string,\r\n  keys: readonly string[]\r\n): GridPreferencesState {\r\n  const base = map || EMPTY_MAP;\r\n  // No-op when unchanged → the store short-circuits and nothing re-renders.\r\n  if (sameMembers(listFor(base, resourceKey), keys)) return base;\r\n\r\n  const next: GridPreferencesState = Object.assign({}, base);\r\n  if (keys.length === 0) {\r\n    // Nothing hidden is the default; drop the entry rather than persist an\r\n    // empty array, so the payload stays tidy and a reset leaves no residue.\r\n    delete next[resourceKey];\r\n  } else {\r\n    // Spread, not Object.assign: `base[resourceKey]` is\r\n    // `GridPreferencesEntry | undefined` under noUncheckedIndexedAccess, and\r\n    // passing undefined as an Object.assign source yields an intersection\r\n    // containing undefined. Spreading undefined is well-defined ({}), and it\r\n    // preserves any sibling preference a future schema adds alongside\r\n    // hiddenColumns.\r\n    next[resourceKey] = {\r\n      ...base[resourceKey],\r\n      hiddenColumns: keys.slice(),\r\n    };\r\n  }\r\n  return next;\r\n}\r\n\r\n/* ── hook ───────────────────────────────────────────────────────────── */\r\n\r\nfunction useEnsureGridPreferences(store: PersonalizationStore): void {\r\n  React.useEffect(\r\n    function ensure() {\r\n      store.ensureCapability(GRID_PREFERENCES_CAPABILITY_ID);\r\n    },\r\n    [store]\r\n  );\r\n}\r\n\r\nexport interface UseGridPreferencesResult {\r\n  /**\r\n   * Hidden column keys, ready to hand straight to DataGrid /\r\n   * DataGridToolbar.\r\n   *\r\n   * A mutable `Set`, not a `ReadonlySet`, on purpose: both components declare\r\n   * `hiddenColumns?: Set<string> | string[]`, and `ReadonlySet` is not\r\n   * assignable to `Set` (no add/delete/clear), so a readonly type would force\r\n   * every call site into a cast. This mirrors `useFavorites().ids`. Treat it\r\n   * as read-only regardless — it is memoised and shared, so mutating it in\r\n   * place would desynchronise the store without persisting anything.\r\n   */\r\n  hiddenColumns: Set<string>;\r\n  /** Replace the hidden-column set. Accepts a Set or an array. */\r\n  setHiddenColumns: (hidden: Iterable<string>) => void;\r\n  /** Show every column again (drops this resource's entry). */\r\n  resetHiddenColumns: () => void;\r\n}\r\n\r\n/**\r\n * useGridPreferences(resourceKey) — persisted, per-user grid preferences for\r\n * one resource.\r\n */\r\nexport function useGridPreferences(\r\n  resourceKey: string\r\n): UseGridPreferencesResult {\r\n  const store = usePersonalizationStore();\r\n  useEnsureGridPreferences(store);\r\n\r\n  const selectList = React.useCallback(\r\n    function selectList(snapshot: PersonalizationSnapshot): readonly string[] {\r\n      const slice = snapshot[GRID_PREFERENCES_CAPABILITY_ID] as\r\n        | GridPreferencesState\r\n        | undefined;\r\n      return slice ? listFor(slice, resourceKey) : EMPTY_LIST;\r\n    },\r\n    [resourceKey]\r\n  );\r\n  const keys = useStoreSelector(selectList);\r\n\r\n  // Stable while `keys` is stable (structural sharing), so the Set identity\r\n  // does not churn on every render and DataGrid's memoisation still holds.\r\n  const hiddenColumns = React.useMemo(\r\n    function buildSet(): Set<string> {\r\n      return new Set<string>(keys);\r\n    },\r\n    [keys]\r\n  );\r\n\r\n  const setHiddenColumns = React.useCallback(\r\n    function setHiddenColumns(hidden: Iterable<string>): void {\r\n      // Normalise at the write boundary too: the caller is UI code, but the\r\n      // value is about to be persisted and re-read by a later session.\r\n      const nextKeys = Array.from(hidden).filter(isString);\r\n      store.write<GridPreferencesState>(\r\n        GRID_PREFERENCES_CAPABILITY_ID,\r\n        function (prev) {\r\n          return setList(prev, resourceKey, nextKeys);\r\n        }\r\n      );\r\n    },\r\n    [store, resourceKey]\r\n  );\r\n\r\n  const resetHiddenColumns = React.useCallback(\r\n    function resetHiddenColumns(): void {\r\n      store.write<GridPreferencesState>(\r\n        GRID_PREFERENCES_CAPABILITY_ID,\r\n        function (prev) {\r\n          return setList(prev, resourceKey, EMPTY_LIST);\r\n        }\r\n      );\r\n    },\r\n    [store, resourceKey]\r\n  );\r\n\r\n  return React.useMemo(\r\n    function value(): UseGridPreferencesResult {\r\n      return {\r\n        hiddenColumns: hiddenColumns,\r\n        setHiddenColumns: setHiddenColumns,\r\n        resetHiddenColumns: resetHiddenColumns,\r\n      };\r\n    },\r\n    [hiddenColumns, setHiddenColumns, resetHiddenColumns]\r\n  );\r\n}\r\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"gridPreferences.js","names":["React","registerCapability","usePersonalizationStore","useStoreSelector","GRID_PREFERENCES_CAPABILITY_ID","SCHEMA_VERSION","EMPTY_LIST","Object","freeze","EMPTY_MAP","isString","value","id","schemaVersion","defaultState","migrate","migrateGridPreferences","_fromVersion","payload","source","next","resourceKey","keys","entry","raw","Array","isArray","filter","length","hiddenColumns","listFor","map","undefined","list","sameMembers","a","b","i","setList","base","assign","slice","useEnsureGridPreferences","store","useEffect","ensure","ensureCapability","useGridPreferences","selectList","useCallback","snapshot","useMemo","buildSet","Set","setHiddenColumns","hidden","nextKeys","from","write","prev","resetHiddenColumns"],"sources":["../../../../../src/lib/v2/personalization/capabilities/gridPreferences.ts"],"sourcesContent":["/**\r\n * gridPreferences — Portnet UI v2 · personalization capability\r\n *\r\n * Per-user, per-resource DataGrid preferences. Self-registers the\r\n * \"gridPreferences\" capability with the schema registry at import time, so the\r\n * capability-agnostic foundation discovers its schemaVersion / defaultState /\r\n * migrate without any hardcoding.\r\n *\r\n * State model (the capability payload):\r\n *   { [resourceKey]: { hiddenColumns: string[] } }\r\n *\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n * WHY THIS BELONGS IN THE LIBRARY (capability gap G-35)\r\n *\r\n * `DataGridToolbar` owns the column-visibility UI (`hiddenColumns` +\r\n * `onHiddenColumnsChange`) but deliberately holds no state, so PERSISTING the\r\n * choice is left to the host. Every listing screen therefore reached for raw\r\n * `localStorage` — observed in onssa-export-fe as\r\n * `\"onssaCertificates:listing:hiddenColumns\"`, hand-written JSON.parse\r\n * included.\r\n *\r\n * That is not merely duplication. A bare `localStorage` key is NOT USER-SCOPED,\r\n * while this foundation's own key scheme is:\r\n *\r\n *     portnet-ui:perso:v1:{tenantId?}:{userId}:{capabilityId}\r\n *\r\n * So on a shared workstation — the norm at a port — user B inherited user A's\r\n * hidden columns, and a column A had hidden stayed invisible to B with no\r\n * affordance explaining why. Favorites and saved filters were already immune\r\n * because they route through this foundation; column visibility was the one\r\n * grid preference that did not.\r\n *\r\n * It could not be fixed in a host, either. `registerCapability` is exported as\r\n * a \"capability registration seam — for custom/host-defined capabilities\", but\r\n * the two primitives every capability hook needs — `usePersonalizationStore`\r\n * and `useStoreSelector` — are deliberately private (\"architecture doc §2.8 —\r\n * minimum API surface\"). A host could register a descriptor and then had no way\r\n * to read or write its payload. The seam was advertised but not complete, so\r\n * the slice has to live here, exactly like favorites and savedFilters.\r\n *\r\n * DENSITY IS DELIBERATELY NOT PART OF THIS. `useDensity` (v2/hooks) owns the\r\n * density preference as a GLOBAL, non-resource-scoped value on its own\r\n * `portnet-ui-density` key, and it applies `data-density` to <html>. Folding it\r\n * in here would give one preference two owners. Note however that it is\r\n * unscoped for the same reason this capability exists — tracked separately,\r\n * since moving it into the foundation changes its storage key and would make it\r\n * require a provider (a breaking change for current callers).\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n *\r\n * Usage:\r\n *\r\n *   const { hiddenColumns, setHiddenColumns } = useGridPreferences(\"ti:list\");\r\n *\r\n *   <DataGridToolbar\r\n *     columns={columns}\r\n *     hiddenColumns={hiddenColumns}\r\n *     onHiddenColumnsChange={setHiddenColumns}\r\n *     … />\r\n *   <DataGrid columns={columns} hiddenColumns={hiddenColumns} … />\r\n *\r\n * `resourceKey` namespaces preferences per list (e.g. \"ti:list\",\r\n * \"declarations:list\") so two grids in one app never collide. Requires a\r\n * <UserPersonalizationProvider> ancestor.\r\n *\r\n * Performance: the pure helpers rebuild only the touched resourceKey's entry\r\n * and shallow-copy the map, so the store's structural sharing keeps every OTHER\r\n * resource's preferences referentially stable — and the exposed `Set` is\r\n * memoised on the stored array, so its identity survives re-renders and does\r\n * not defeat DataGrid's memoisation.\r\n */\r\n\r\nimport * as React from \"react\";\r\n\r\nimport { registerCapability } from \"../schema\";\r\nimport {\r\n  usePersonalizationStore,\r\n  useStoreSelector,\r\n} from \"../personalizationContext\";\r\nimport type {\r\n  PersonalizationSnapshot,\r\n  PersonalizationStore,\r\n} from \"../createPersonalizationStore\";\r\n\r\n/** One resource's grid preferences. Optional members so the shape can grow\r\n *  (column order, widths) without a schemaVersion bump. */\r\nexport interface GridPreferencesEntry {\r\n  hiddenColumns?: string[] | undefined;\r\n}\r\n\r\n/** The gridPreferences capability payload: entries keyed by resourceKey. */\r\ntype GridPreferencesState = Record<string, GridPreferencesEntry>;\r\n\r\nexport const GRID_PREFERENCES_CAPABILITY_ID = \"gridPreferences\";\r\nconst SCHEMA_VERSION = 1;\r\n\r\nconst EMPTY_LIST: readonly string[] = Object.freeze([]);\r\nconst EMPTY_MAP: GridPreferencesState = Object.freeze({});\r\n\r\nfunction isString(value: unknown): value is string {\r\n  return typeof value === \"string\";\r\n}\r\n\r\n/* Register at import time — the foundation reads this at hydration. */\r\nregisterCapability({\r\n  id: GRID_PREFERENCES_CAPABILITY_ID,\r\n  schemaVersion: SCHEMA_VERSION,\r\n  defaultState: EMPTY_MAP, // { [resourceKey]: { hiddenColumns: string[] } }\r\n  migrate: function migrateGridPreferences(\r\n    _fromVersion: number,\r\n    payload: unknown\r\n  ): unknown {\r\n    /* v1 is the initial schema, so there is no version to upgrade FROM — but\r\n     * this is the load-time trust boundary for a payload that came back from\r\n     * storage, and it is the right place to normalise it. A column key is used\r\n     * to hide grid columns; a number or an object arriving from an older build\r\n     * (or from hand-edited devtools storage) must not reach the DataGrid as if\r\n     * it were one. Anything unrecognised is dropped rather than repaired. */\r\n    if (!payload || typeof payload !== \"object\") return {};\r\n    const source = payload as Record<string, unknown>;\r\n    const next: GridPreferencesState = {};\r\n    for (const resourceKey of Object.keys(source)) {\r\n      const entry = source[resourceKey];\r\n      if (!entry || typeof entry !== \"object\") continue;\r\n      const raw = (entry as Record<string, unknown>)[\"hiddenColumns\"];\r\n      if (!Array.isArray(raw)) continue;\r\n      const keys = raw.filter(isString);\r\n      if (keys.length > 0) next[resourceKey] = { hiddenColumns: keys };\r\n    }\r\n    return next;\r\n  },\r\n});\r\n\r\n/* ── pure, resourceKey-scoped state helpers (structural sharing) ────── */\r\n\r\nfunction listFor(\r\n  map: GridPreferencesState | null | undefined,\r\n  resourceKey: string\r\n): readonly string[] {\r\n  const entry = map ? map[resourceKey] : undefined;\r\n  const list = entry ? entry.hiddenColumns : undefined;\r\n  return Array.isArray(list) ? list : EMPTY_LIST;\r\n}\r\n\r\nfunction sameMembers(a: readonly string[], b: readonly string[]): boolean {\r\n  if (a.length !== b.length) return false;\r\n  for (let i = 0; i < a.length; i++) {\r\n    if (a[i] !== b[i]) return false;\r\n  }\r\n  return true;\r\n}\r\n\r\nfunction setList(\r\n  map: GridPreferencesState | null | undefined,\r\n  resourceKey: string,\r\n  keys: readonly string[]\r\n): GridPreferencesState {\r\n  const base = map || EMPTY_MAP;\r\n  // No-op when unchanged → the store short-circuits and nothing re-renders.\r\n  if (sameMembers(listFor(base, resourceKey), keys)) return base;\r\n\r\n  const next: GridPreferencesState = Object.assign({}, base);\r\n  if (keys.length === 0) {\r\n    // Nothing hidden is the default; drop the entry rather than persist an\r\n    // empty array, so the payload stays tidy and a reset leaves no residue.\r\n    delete next[resourceKey];\r\n  } else {\r\n    // Spread, not Object.assign: `base[resourceKey]` is\r\n    // `GridPreferencesEntry | undefined` under noUncheckedIndexedAccess, and\r\n    // passing undefined as an Object.assign source yields an intersection\r\n    // containing undefined. Spreading undefined is well-defined ({}), and it\r\n    // preserves any sibling preference a future schema adds alongside\r\n    // hiddenColumns.\r\n    next[resourceKey] = {\r\n      ...base[resourceKey],\r\n      hiddenColumns: keys.slice(),\r\n    };\r\n  }\r\n  return next;\r\n}\r\n\r\n/* ── hook ───────────────────────────────────────────────────────────── */\r\n\r\nfunction useEnsureGridPreferences(store: PersonalizationStore): void {\r\n  React.useEffect(\r\n    function ensure() {\r\n      store.ensureCapability(GRID_PREFERENCES_CAPABILITY_ID);\r\n    },\r\n    [store]\r\n  );\r\n}\r\n\r\nexport interface UseGridPreferencesResult {\r\n  /**\r\n   * Hidden column keys, ready to hand straight to DataGrid /\r\n   * DataGridToolbar.\r\n   *\r\n   * A mutable `Set`, not a `ReadonlySet`, on purpose: both components declare\r\n   * `hiddenColumns?: Set<string> | string[]`, and `ReadonlySet` is not\r\n   * assignable to `Set` (no add/delete/clear), so a readonly type would force\r\n   * every call site into a cast. This mirrors `useFavorites().ids`. Treat it\r\n   * as read-only regardless — it is memoised and shared, so mutating it in\r\n   * place would desynchronise the store without persisting anything.\r\n   */\r\n  hiddenColumns: Set<string>;\r\n  /** Replace the hidden-column set. Accepts a Set or an array. */\r\n  setHiddenColumns: (hidden: Iterable<string>) => void;\r\n  /** Show every column again (drops this resource's entry). */\r\n  resetHiddenColumns: () => void;\r\n}\r\n\r\n/**\r\n * useGridPreferences(resourceKey) — persisted, per-user grid preferences for\r\n * one resource.\r\n */\r\nexport function useGridPreferences(\r\n  resourceKey: string\r\n): UseGridPreferencesResult {\r\n  const store = usePersonalizationStore();\r\n  useEnsureGridPreferences(store);\r\n\r\n  const selectList = React.useCallback(\r\n    function selectList(snapshot: PersonalizationSnapshot): readonly string[] {\r\n      const slice = snapshot[GRID_PREFERENCES_CAPABILITY_ID] as\r\n        | GridPreferencesState\r\n        | undefined;\r\n      return slice ? listFor(slice, resourceKey) : EMPTY_LIST;\r\n    },\r\n    [resourceKey]\r\n  );\r\n  const keys = useStoreSelector(selectList);\r\n\r\n  // Stable while `keys` is stable (structural sharing), so the Set identity\r\n  // does not churn on every render and DataGrid's memoisation still holds.\r\n  const hiddenColumns = React.useMemo(\r\n    function buildSet(): Set<string> {\r\n      return new Set<string>(keys);\r\n    },\r\n    [keys]\r\n  );\r\n\r\n  const setHiddenColumns = React.useCallback(\r\n    function setHiddenColumns(hidden: Iterable<string>): void {\r\n      // Normalise at the write boundary too: the caller is UI code, but the\r\n      // value is about to be persisted and re-read by a later session.\r\n      const nextKeys = Array.from(hidden).filter(isString);\r\n      store.write<GridPreferencesState>(\r\n        GRID_PREFERENCES_CAPABILITY_ID,\r\n        function (prev) {\r\n          return setList(prev, resourceKey, nextKeys);\r\n        }\r\n      );\r\n    },\r\n    [store, resourceKey]\r\n  );\r\n\r\n  const resetHiddenColumns = React.useCallback(\r\n    function resetHiddenColumns(): void {\r\n      store.write<GridPreferencesState>(\r\n        GRID_PREFERENCES_CAPABILITY_ID,\r\n        function (prev) {\r\n          return setList(prev, resourceKey, EMPTY_LIST);\r\n        }\r\n      );\r\n    },\r\n    [store, resourceKey]\r\n  );\r\n\r\n  return React.useMemo(\r\n    function value(): UseGridPreferencesResult {\r\n      return {\r\n        hiddenColumns: hiddenColumns,\r\n        setHiddenColumns: setHiddenColumns,\r\n        resetHiddenColumns: resetHiddenColumns,\r\n      };\r\n    },\r\n    [hiddenColumns, setHiddenColumns, resetHiddenColumns]\r\n  );\r\n}\r\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/v2/personalization/capabilities/reviveSavedCriteria.js

@@ -0,0 +1,119 @@
+/**
+ * reviveSavedCriteria — Portnet UI v2 · personalization capability
+ *
+ * Restores a persisted `SavedFilter.criteria` payload into the shape of a
+ * search form's values.
+ *
+ *   const [filters, setFilters] = React.useState(EMPTY_FILTERS);
+ *
+ *   <SavedFiltersMenu
+ *     onApply={(filter) =>
+ *       setFilters(reviveSavedCriteria(EMPTY_FILTERS, filter.criteria))
+ *     }
+ *   />
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * WHY THIS BELONGS IN THE LIBRARY (capability gap G-50)
+ *
+ * `criteria` is OPAQUE by design, and that design is right: `savedFilters`
+ * stores and re-emits it verbatim — "criteria is never interpreted here" — which
+ * is what keeps one saved-filters framework usable by every list regardless of
+ * its filter schema. The host owns `apply()`.
+ *
+ * But the round trip is NOT symmetrical, and the asymmetry is the library's,
+ * not the host's:
+ *
+ *   - search forms type their date fields `Date | null`;
+ *   - `createLocalStorageAdapter` serialises with `JSON.stringify`, which calls
+ *     `Date.prototype.toJSON` — so a `Date` is written as an ISO STRING;
+ *   - the same adapter reads back with a plain `JSON.parse`, WITH NO REVIVER.
+ *
+ * So every host that persists a date gets a string back, in a field its own
+ * types declare as a `Date`. Two consequences, both silent: the string goes
+ * straight into `<DatePicker value={…}>`, and it goes into the search payload
+ * sent to the back-end. The type system does not catch it, because the only way
+ * to assign the parsed payload into a typed form state is an assertion — and an
+ * assertion is exactly what a host writes when the library hands it
+ * `Record<string, unknown>` and asks it to produce `TValues`.
+ *
+ * Observed in `autorisation-admis-pour-conforme-fe` (Area 5): NINE list screens
+ * converted the payload TWICE inside their own `onApply` — a single conversion
+ * would not compile — which is the shape a missing library capability takes when
+ * a host has to work around it under a strict typecheck.
+ *
+ * A second, quieter effect this closes: a filter saved under an OLDER form shape
+ * (renamed key, dropped field) was spread into the form state as-is, unknown
+ * keys included. Keying off the caller's defaults bounds that.
+ *
+ * WHY NOT FIX THE ADAPTER INSTEAD. A reviver inside
+ * `createLocalStorageAdapter` would apply to EVERY capability payload — grid
+ * preferences, favorites — and would have to guess which strings are dates for
+ * data it knows nothing about. Reviving belongs where the shape is known, i.e.
+ * at the point where the host hands in its own defaults. That also keeps the
+ * remote adapter, when it arrives, free of the same guesswork.
+ * ─────────────────────────────────────────────────────────────────────────────
+ *
+ * WHAT IT GUARANTEES, EXACTLY: the KEYS are the caller's, and the DATES are
+ * dates. It deliberately does NOT validate referentiel shapes (`{ id, code,
+ * description }`): those round-trip as flat JSON objects with every field
+ * optional, and inventing a shape check here would reject valid saved filters
+ * without protecting anything. A persisted value of some other kind still lands
+ * in its field — but in a field the screen reads with optional access, rather
+ * than behind an assertion that claimed to have checked it.
+ */
+
+/**
+ * The format `Date.prototype.toJSON` produces (hence `JSON.stringify`).
+ *
+ * Deliberately STRICT: only the exact shape the save wrote is read back as a
+ * date, so a business string — a reference, a code, a customs nomenclature —
+ * cannot be mistaken for one by accident.
+ */
+const ISO_INSTANT = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,3})?(?:Z|[+-]\d{2}:\d{2})$/;
+
+/** Give one value read back from storage its original type. */
+const revive = value => {
+  if (typeof value !== "string" || !ISO_INSTANT.test(value)) return value;
+  const date = new Date(value);
+  return Number.isNaN(date.getTime()) ? null : date;
+};
+
+/**
+ * Read a persisted `criteria` payload back into a search form's shape.
+ *
+ * @param defaults - The form's empty values. They define BOTH the accepted keys
+ *                   and the value kept when a key is absent from the payload.
+ * @param criteria - The opaque payload, as `SavedFilter.criteria` re-emits it.
+ * @returns A complete value set, shaped like `defaults`.
+ *
+ * @remarks
+ * The constraint is written `Record<keyof TValues, unknown>` and NOT
+ * `Record<string, unknown>`: the latter is satisfied only by type ALIASES, to
+ * which TypeScript grants an implicit index signature, so any caller declaring
+ * its form shape with an `interface` would be rejected — five of the nine forms
+ * in the module this came from do exactly that. The mapped constraint accepts
+ * both, which is the point: no assertion is pushed back to the call site.
+ *
+ * The only two assertions on this path are here, on the way in and on the way
+ * out: TypeScript cannot follow a copy built key by key against a type
+ * parameter. They are isolated in twenty reviewed lines instead of being
+ * repeated per screen, and they PRESERVE the caller's type instead of erasing
+ * it.
+ */
+export function reviveSavedCriteria(defaults, criteria) {
+  if (!criteria) return defaults;
+  const restored = {
+    ...defaults
+  };
+  for (const key of Object.keys(restored)) {
+    if (!Object.prototype.hasOwnProperty.call(criteria, key)) continue;
+    const value = revive(criteria[key]);
+    /* `undefined` must not overwrite the default: under
+       `exactOptionalPropertyTypes`, a present key holding `undefined` is not
+       the same thing as an absent key. */
+    if (value !== undefined) restored[key] = value;
+  }
+  return restored;
+}
+export default reviveSavedCriteria;
+//# sourceMappingURL=reviveSavedCriteria.js.map

package/dist/esm/v2/personalization/capabilities/reviveSavedCriteria.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviveSavedCriteria.js","names":["ISO_INSTANT","revive","value","test","date","Date","Number","isNaN","getTime","reviveSavedCriteria","defaults","criteria","restored","key","Object","keys","prototype","hasOwnProperty","call","undefined"],"sources":["../../../../../src/lib/v2/personalization/capabilities/reviveSavedCriteria.ts"],"sourcesContent":["/**\r\n * reviveSavedCriteria — Portnet UI v2 · personalization capability\r\n *\r\n * Restores a persisted `SavedFilter.criteria` payload into the shape of a\r\n * search form's values.\r\n *\r\n *   const [filters, setFilters] = React.useState(EMPTY_FILTERS);\r\n *\r\n *   <SavedFiltersMenu\r\n *     onApply={(filter) =>\r\n *       setFilters(reviveSavedCriteria(EMPTY_FILTERS, filter.criteria))\r\n *     }\r\n *   />\r\n *\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n * WHY THIS BELONGS IN THE LIBRARY (capability gap G-50)\r\n *\r\n * `criteria` is OPAQUE by design, and that design is right: `savedFilters`\r\n * stores and re-emits it verbatim — \"criteria is never interpreted here\" — which\r\n * is what keeps one saved-filters framework usable by every list regardless of\r\n * its filter schema. The host owns `apply()`.\r\n *\r\n * But the round trip is NOT symmetrical, and the asymmetry is the library's,\r\n * not the host's:\r\n *\r\n *   - search forms type their date fields `Date | null`;\r\n *   - `createLocalStorageAdapter` serialises with `JSON.stringify`, which calls\r\n *     `Date.prototype.toJSON` — so a `Date` is written as an ISO STRING;\r\n *   - the same adapter reads back with a plain `JSON.parse`, WITH NO REVIVER.\r\n *\r\n * So every host that persists a date gets a string back, in a field its own\r\n * types declare as a `Date`. Two consequences, both silent: the string goes\r\n * straight into `<DatePicker value={…}>`, and it goes into the search payload\r\n * sent to the back-end. The type system does not catch it, because the only way\r\n * to assign the parsed payload into a typed form state is an assertion — and an\r\n * assertion is exactly what a host writes when the library hands it\r\n * `Record<string, unknown>` and asks it to produce `TValues`.\r\n *\r\n * Observed in `autorisation-admis-pour-conforme-fe` (Area 5): NINE list screens\r\n * converted the payload TWICE inside their own `onApply` — a single conversion\r\n * would not compile — which is the shape a missing library capability takes when\r\n * a host has to work around it under a strict typecheck.\r\n *\r\n * A second, quieter effect this closes: a filter saved under an OLDER form shape\r\n * (renamed key, dropped field) was spread into the form state as-is, unknown\r\n * keys included. Keying off the caller's defaults bounds that.\r\n *\r\n * WHY NOT FIX THE ADAPTER INSTEAD. A reviver inside\r\n * `createLocalStorageAdapter` would apply to EVERY capability payload — grid\r\n * preferences, favorites — and would have to guess which strings are dates for\r\n * data it knows nothing about. Reviving belongs where the shape is known, i.e.\r\n * at the point where the host hands in its own defaults. That also keeps the\r\n * remote adapter, when it arrives, free of the same guesswork.\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n *\r\n * WHAT IT GUARANTEES, EXACTLY: the KEYS are the caller's, and the DATES are\r\n * dates. It deliberately does NOT validate referentiel shapes (`{ id, code,\r\n * description }`): those round-trip as flat JSON objects with every field\r\n * optional, and inventing a shape check here would reject valid saved filters\r\n * without protecting anything. A persisted value of some other kind still lands\r\n * in its field — but in a field the screen reads with optional access, rather\r\n * than behind an assertion that claimed to have checked it.\r\n */\r\n\r\n/**\r\n * The format `Date.prototype.toJSON` produces (hence `JSON.stringify`).\r\n *\r\n * Deliberately STRICT: only the exact shape the save wrote is read back as a\r\n * date, so a business string — a reference, a code, a customs nomenclature —\r\n * cannot be mistaken for one by accident.\r\n */\r\nconst ISO_INSTANT =\r\n  /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,3})?(?:Z|[+-]\\d{2}:\\d{2})$/;\r\n\r\n/** Give one value read back from storage its original type. */\r\nconst revive = (value: unknown): unknown => {\r\n  if (typeof value !== \"string\" || !ISO_INSTANT.test(value)) return value;\r\n  const date = new Date(value);\r\n  return Number.isNaN(date.getTime()) ? null : date;\r\n};\r\n\r\n/**\r\n * Read a persisted `criteria` payload back into a search form's shape.\r\n *\r\n * @param defaults - The form's empty values. They define BOTH the accepted keys\r\n *                   and the value kept when a key is absent from the payload.\r\n * @param criteria - The opaque payload, as `SavedFilter.criteria` re-emits it.\r\n * @returns A complete value set, shaped like `defaults`.\r\n *\r\n * @remarks\r\n * The constraint is written `Record<keyof TValues, unknown>` and NOT\r\n * `Record<string, unknown>`: the latter is satisfied only by type ALIASES, to\r\n * which TypeScript grants an implicit index signature, so any caller declaring\r\n * its form shape with an `interface` would be rejected — five of the nine forms\r\n * in the module this came from do exactly that. The mapped constraint accepts\r\n * both, which is the point: no assertion is pushed back to the call site.\r\n *\r\n * The only two assertions on this path are here, on the way in and on the way\r\n * out: TypeScript cannot follow a copy built key by key against a type\r\n * parameter. They are isolated in twenty reviewed lines instead of being\r\n * repeated per screen, and they PRESERVE the caller's type instead of erasing\r\n * it.\r\n */\r\nexport function reviveSavedCriteria<\r\n  TValues extends Record<keyof TValues, unknown>,\r\n>(\r\n  defaults: TValues,\r\n  criteria: Record<string, unknown> | null | undefined,\r\n): TValues {\r\n  if (!criteria) return defaults;\r\n\r\n  const restored: Record<string, unknown> = {\r\n    ...(defaults as Record<string, unknown>),\r\n  };\r\n\r\n  for (const key of Object.keys(restored)) {\r\n    if (!Object.prototype.hasOwnProperty.call(criteria, key)) continue;\r\n    const value = revive(criteria[key]);\r\n    /* `undefined` must not overwrite the default: under\r\n       `exactOptionalPropertyTypes`, a present key holding `undefined` is not\r\n       the same thing as an absent key. */\r\n    if (value !== undefined) restored[key] = value;\r\n  }\r\n\r\n  return restored as TValues;\r\n}\r\n\r\nexport default reviveSavedCriteria;\r\n"],"mappings":"AAAA;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;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;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMA,WAAW,GACf,0EAA0E;;AAE5E;AACA,MAAMC,MAAM,GAAIC,KAAc,IAAc;EAC1C,IAAI,OAAOA,KAAK,KAAK,QAAQ,IAAI,CAACF,WAAW,CAACG,IAAI,CAACD,KAAK,CAAC,EAAE,OAAOA,KAAK;EACvE,MAAME,IAAI,GAAG,IAAIC,IAAI,CAACH,KAAK,CAAC;EAC5B,OAAOI,MAAM,CAACC,KAAK,CAACH,IAAI,CAACI,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,GAAGJ,IAAI;AACnD,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASK,mBAAmBA,CAGjCC,QAAiB,EACjBC,QAAoD,EAC3C;EACT,IAAI,CAACA,QAAQ,EAAE,OAAOD,QAAQ;EAE9B,MAAME,QAAiC,GAAG;IACxC,GAAIF;EACN,CAAC;EAED,KAAK,MAAMG,GAAG,IAAIC,MAAM,CAACC,IAAI,CAACH,QAAQ,CAAC,EAAE;IACvC,IAAI,CAACE,MAAM,CAACE,SAAS,CAACC,cAAc,CAACC,IAAI,CAACP,QAAQ,EAAEE,GAAG,CAAC,EAAE;IAC1D,MAAMX,KAAK,GAAGD,MAAM,CAACU,QAAQ,CAACE,GAAG,CAAC,CAAC;IACnC;AACJ;AACA;IACI,IAAIX,KAAK,KAAKiB,SAAS,EAAEP,QAAQ,CAACC,GAAG,CAAC,GAAGX,KAAK;EAChD;EAEA,OAAOU,QAAQ;AACjB;AAEA,eAAeH,mBAAmB","ignoreList":[]}