@portnet/ui 6.0.2 → 6.0.3

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

@@ -8,14 +8,8 @@ exports.useGridPreferences = useGridPreferences;
 var React = _interopRequireWildcard(require("react"));
 var _schema = require("../schema");
 var _personalizationContext = require("../personalizationContext");
-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 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); } /**
+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); }
+/**
  * gridPreferences — Portnet UI v2 · personalization capability
  *
  * Per-user, per-resource DataGrid preferences. Self-registers the
@@ -85,15 +79,16 @@ function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" =
  * memoised on the stored array, so its identity survives re-renders and does
  * not defeat DataGrid's memoisation.
  */
+
 /** One resource's grid preferences. Optional members so the shape can grow
  *  (column order, widths) without a schemaVersion bump. */
 
 /** The gridPreferences capability payload: entries keyed by resourceKey. */
 
-var GRID_PREFERENCES_CAPABILITY_ID = exports.GRID_PREFERENCES_CAPABILITY_ID = "gridPreferences";
-var SCHEMA_VERSION = 1;
-var EMPTY_LIST = Object.freeze([]);
-var EMPTY_MAP = Object.freeze({});
+const GRID_PREFERENCES_CAPABILITY_ID = exports.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";
 }
@@ -111,16 +106,15 @@ function isString(value) {
      * 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
       };
@@ -132,22 +126,22 @@ function isString(value) {
 /* ── 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.
@@ -159,9 +153,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;
 }
@@ -178,28 +173,28 @@ function useEnsureGridPreferences(store) {
  * one resource.
  */
 function useGridPreferences(resourceKey) {
-  var store = (0, _personalizationContext.usePersonalizationStore)();
+  const store = (0, _personalizationContext.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 = (0, _personalizationContext.useStoreSelector)(selectList);
+  const keys = (0, _personalizationContext.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/v2/personalization/capabilities/gridPreferences.js.map

@@ -1 +1 @@
-{"version":3,"file":"gridPreferences.js","names":["React","_interopRequireWildcard","require","_schema","_personalizationContext","_getRequireWildcardCache","nodeInterop","WeakMap","cacheBabelInterop","cacheNodeInterop","obj","__esModule","_typeof","cache","has","get","newObj","hasPropertyDescriptor","Object","defineProperty","getOwnPropertyDescriptor","key","prototype","hasOwnProperty","call","desc","set","ownKeys","object","enumerableOnly","keys","getOwnPropertySymbols","symbols","filter","sym","enumerable","push","apply","_objectSpread","target","i","arguments","length","source","forEach","_defineProperty","getOwnPropertyDescriptors","defineProperties","value","_toPropertyKey","configurable","writable","arg","_toPrimitive","String","input","hint","prim","Symbol","toPrimitive","undefined","res","TypeError","Number","iterator","constructor","GRID_PREFERENCES_CAPABILITY_ID","exports","SCHEMA_VERSION","EMPTY_LIST","freeze","EMPTY_MAP","isString","registerCapability","id","schemaVersion","defaultState","migrate","migrateGridPreferences","_fromVersion","payload","next","_i","_Object$keys","resourceKey","entry","raw","Array","isArray","hiddenColumns","listFor","map","list","sameMembers","a","b","setList","base","assign","slice","useEnsureGridPreferences","store","useEffect","ensure","ensureCapability","useGridPreferences","usePersonalizationStore","selectList","useCallback","snapshot","useStoreSelector","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","_interopRequireWildcard","require","_schema","_personalizationContext","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","GRID_PREFERENCES_CAPABILITY_ID","exports","SCHEMA_VERSION","EMPTY_LIST","freeze","EMPTY_MAP","isString","value","registerCapability","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","setList","base","assign","slice","useEnsureGridPreferences","store","useEffect","ensure","ensureCapability","useGridPreferences","usePersonalizationStore","selectList","useCallback","snapshot","useStoreSelector","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/v2/personalization/capabilities/index.js

@@ -5,73 +5,73 @@ Object.defineProperty(exports, "__esModule", {
 });
 Object.defineProperty(exports, "FAVORITES_CAPABILITY_ID", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _favorites.FAVORITES_CAPABILITY_ID;
   }
 });
 Object.defineProperty(exports, "FAVORITES_FILTER", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _favoritesView.FAVORITES_FILTER;
   }
 });
 Object.defineProperty(exports, "FAVORITES_SORT", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _favoritesView.FAVORITES_SORT;
   }
 });
 Object.defineProperty(exports, "GRID_PREFERENCES_CAPABILITY_ID", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _gridPreferences.GRID_PREFERENCES_CAPABILITY_ID;
   }
 });
 Object.defineProperty(exports, "SAVED_FILTERS_CAPABILITY_ID", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _savedFilters.SAVED_FILTERS_CAPABILITY_ID;
   }
 });
 Object.defineProperty(exports, "filterRowsByFavorites", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _favoritesView.filterRowsByFavorites;
   }
 });
 Object.defineProperty(exports, "sortRowsByFavorites", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _favoritesView.sortRowsByFavorites;
   }
 });
 Object.defineProperty(exports, "useFavorites", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _favorites.useFavorites;
   }
 });
 Object.defineProperty(exports, "useFavoritesView", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _favoritesView.useFavoritesView;
   }
 });
 Object.defineProperty(exports, "useGridPreferences", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _gridPreferences.useGridPreferences;
   }
 });
 Object.defineProperty(exports, "useIsFavorite", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _favorites.useIsFavorite;
   }
 });
 Object.defineProperty(exports, "useSavedFilters", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _savedFilters.useSavedFilters;
   }
 });

package/dist/v2/personalization/capabilities/reviveSavedCriteria.d.ts

@@ -0,0 +1,88 @@
+/**
+ * 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.
+ */
+/**
+ * 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 declare function reviveSavedCriteria<TValues extends Record<keyof TValues, unknown>>(defaults: TValues, criteria: Record<string, unknown> | null | undefined): TValues;
+export default reviveSavedCriteria;
+//# sourceMappingURL=reviveSavedCriteria.d.ts.map

package/dist/v2/personalization/capabilities/reviveSavedCriteria.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviveSavedCriteria.d.ts","sourceRoot":"","sources":["../../../../src/lib/v2/personalization/capabilities/reviveSavedCriteria.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AAmBH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,SAAS,MAAM,CAAC,MAAM,OAAO,EAAE,OAAO,CAAC,EAE9C,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACnD,OAAO,CAiBT;AAED,eAAe,mBAAmB,CAAC"}

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

@@ -0,0 +1,126 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+exports.reviveSavedCriteria = reviveSavedCriteria;
+/**
+ * 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.
+ */
+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;
+}
+var _default = exports.default = reviveSavedCriteria;
+//# sourceMappingURL=reviveSavedCriteria.js.map

package/dist/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","_default","exports","default"],"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;AACO,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;AAAC,IAAAQ,QAAA,GAAAC,OAAA,CAAAC,OAAA,GAEcb,mBAAmB","ignoreList":[]}