@portnet/ui 5.0.32 → 6.0.1

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

@@ -0,0 +1,216 @@
+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; }
+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); }
+/**
+ * favorites — Portnet UI v2 · personalization capability
+ *
+ * The Favorites framework. Self-registers the "favorites" capability with
+ * the schema registry at import time, so the capability-agnostic
+ * foundation discovers its schemaVersion / defaultState / migrate without
+ * any hardcoding.
+ *
+ * State model (the capability payload):
+ *   { [resourceKey]: FavoriteRef[] }     FavoriteRef = { id, addedAt }
+ *
+ * `resourceKey` namespaces favorites per list/entity type (e.g.
+ * "ti:list", "declarations:list"), so one user's favorites across
+ * different screens never collide. `id` is the business row id.
+ *
+ * Performance: the pure helpers below rebuild only the touched
+ * resourceKey's array and shallow-copy the map, so the store's structural
+ * sharing keeps every OTHER resource's list referentially stable —
+ * toggling a favorite on screen B does not re-render screen A, and a
+ * boolean per-row selector lets each grid cell re-render only when its own
+ * membership flips.
+ */
+
+import * as React from "react";
+import { registerCapability } from "../schema";
+import { usePersonalizationStore, useStoreSelector } from "../personalizationContext";
+
+/** The favorites capability payload: favorites arrays keyed by resourceKey. */
+
+export var FAVORITES_CAPABILITY_ID = "favorites";
+var SCHEMA_VERSION = 1;
+var EMPTY_LIST = Object.freeze([]);
+var EMPTY_MAP = Object.freeze({});
+
+/* Register at import time — the foundation reads this at hydration. */
+registerCapability({
+  id: FAVORITES_CAPABILITY_ID,
+  schemaVersion: SCHEMA_VERSION,
+  defaultState: EMPTY_MAP,
+  // { [resourceKey]: FavoriteRef[] }
+  migrate: function migrateFavorites(_fromVersion, payload) {
+    // v1 is the initial schema. Defensive normalisation only.
+    return payload && _typeof(payload) === "object" ? payload : {};
+  }
+});
+
+/* ── pure, resourceKey-scoped state helpers (structural sharing) ────── */
+
+function listFor(map, resourceKey) {
+  var list = map ? map[resourceKey] : undefined;
+  return Array.isArray(list) ? list : EMPTY_LIST;
+}
+function hasRef(map, resourceKey, id) {
+  var list = listFor(map, resourceKey);
+  var _iterator = _createForOfIteratorHelper(list),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var ref = _step.value;
+      if (ref.id === id) return true;
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  return false;
+}
+function addRef(map, resourceKey, id) {
+  var base = map || EMPTY_MAP;
+  if (hasRef(base, resourceKey, id)) return base; // no-op → store short-circuits
+  var nextList = listFor(base, resourceKey).concat([{
+    id: id,
+    addedAt: new Date().toISOString()
+  }]);
+  var next = Object.assign({}, base);
+  next[resourceKey] = nextList;
+  return next;
+}
+function removeRef(map, resourceKey, id) {
+  var base = map || EMPTY_MAP;
+  if (!hasRef(base, resourceKey, id)) return base; // no-op
+  var nextList = listFor(base, resourceKey).filter(function keep(r) {
+    return r.id !== id;
+  });
+  var next = Object.assign({}, base);
+  if (nextList.length === 0) delete next[resourceKey]; // keep the map tidy
+  else next[resourceKey] = nextList;
+  return next;
+}
+function toggleRef(map, resourceKey, id) {
+  return hasRef(map, resourceKey, id) ? removeRef(map, resourceKey, id) : addRef(map, resourceKey, id);
+}
+function clearRefs(map, resourceKey) {
+  var base = map || EMPTY_MAP;
+  if (!base[resourceKey]) return base;
+  var next = Object.assign({}, base);
+  delete next[resourceKey];
+  return next;
+}
+
+/* ── hooks ──────────────────────────────────────────────────────────── */
+
+function useEnsureFavorites(store) {
+  React.useEffect(function ensure() {
+    store.ensureCapability(FAVORITES_CAPABILITY_ID);
+  }, [store]);
+}
+/**
+ * useFavorites(resourceKey) — list, membership and actions for one resource.
+ */
+export function useFavorites(resourceKey) {
+  var store = usePersonalizationStore();
+  useEnsureFavorites(store);
+  var selectList = React.useCallback(function selectList(snapshot) {
+    var slice = snapshot[FAVORITES_CAPABILITY_ID];
+    return slice ? listFor(slice, resourceKey) : EMPTY_LIST;
+  }, [resourceKey]);
+  var items = useStoreSelector(selectList);
+
+  // Stable while `items` is stable (structural sharing) → O(1) membership.
+  var ids = React.useMemo(function buildIdSet() {
+    var set = new Set();
+    var _iterator2 = _createForOfIteratorHelper(items),
+      _step2;
+    try {
+      for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+        var ref = _step2.value;
+        set.add(ref.id);
+      }
+    } catch (err) {
+      _iterator2.e(err);
+    } finally {
+      _iterator2.f();
+    }
+    return set;
+  }, [items]);
+  var add = React.useCallback(function add(id) {
+    store.write(FAVORITES_CAPABILITY_ID, function (prev) {
+      return addRef(prev, resourceKey, id);
+    });
+  }, [store, resourceKey]);
+  var remove = React.useCallback(function remove(id) {
+    store.write(FAVORITES_CAPABILITY_ID, function (prev) {
+      return removeRef(prev, resourceKey, id);
+    });
+  }, [store, resourceKey]);
+  var toggle = React.useCallback(function toggle(id) {
+    store.write(FAVORITES_CAPABILITY_ID, function (prev) {
+      return toggleRef(prev, resourceKey, id);
+    });
+  }, [store, resourceKey]);
+  var clear = React.useCallback(function clear() {
+    store.write(FAVORITES_CAPABILITY_ID, function (prev) {
+      return clearRefs(prev, resourceKey);
+    });
+  }, [store, resourceKey]);
+  var isFavorite = React.useCallback(function isFavorite(id) {
+    return ids.has(id);
+  }, [ids]);
+  return React.useMemo(function value() {
+    return {
+      items: items,
+      ids: ids,
+      count: items.length,
+      isFavorite: isFavorite,
+      add: add,
+      remove: remove,
+      toggle: toggle,
+      clear: clear
+    };
+  }, [items, ids, isFavorite, add, remove, toggle, clear]);
+}
+/**
+ * useIsFavorite(resourceKey, id) — focused per-row hook. Returns a boolean
+ * (Object.is bail-out: a row re-renders only when ITS membership flips)
+ * plus a bound toggle/add/remove. This is the cell-level hook the DataGrid
+ * favorite column consumes (Batch 5).
+ */
+export function useIsFavorite(resourceKey, id) {
+  var store = usePersonalizationStore();
+  useEnsureFavorites(store);
+  var selectIsFavorite = React.useCallback(function selectIsFavorite(snapshot) {
+    var slice = snapshot[FAVORITES_CAPABILITY_ID];
+    return slice ? hasRef(slice, resourceKey, id) : false;
+  }, [resourceKey, id]);
+  var isFavorite = useStoreSelector(selectIsFavorite);
+  var toggle = React.useCallback(function toggle() {
+    store.write(FAVORITES_CAPABILITY_ID, function (prev) {
+      return toggleRef(prev, resourceKey, id);
+    });
+  }, [store, resourceKey, id]);
+  var add = React.useCallback(function add() {
+    store.write(FAVORITES_CAPABILITY_ID, function (prev) {
+      return addRef(prev, resourceKey, id);
+    });
+  }, [store, resourceKey, id]);
+  var remove = React.useCallback(function remove() {
+    store.write(FAVORITES_CAPABILITY_ID, function (prev) {
+      return removeRef(prev, resourceKey, id);
+    });
+  }, [store, resourceKey, id]);
+  return React.useMemo(function value() {
+    return {
+      isFavorite: isFavorite,
+      toggle: toggle,
+      add: add,
+      remove: remove
+    };
+  }, [isFavorite, toggle, add, remove]);
+}
+//# sourceMappingURL=favorites.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"favorites.js","names":["React","registerCapability","usePersonalizationStore","useStoreSelector","FAVORITES_CAPABILITY_ID","SCHEMA_VERSION","EMPTY_LIST","Object","freeze","EMPTY_MAP","id","schemaVersion","defaultState","migrate","migrateFavorites","_fromVersion","payload","_typeof","listFor","map","resourceKey","list","undefined","Array","isArray","hasRef","_iterator","_createForOfIteratorHelper","_step","s","n","done","ref","value","err","e","f","addRef","base","nextList","concat","addedAt","Date","toISOString","next","assign","removeRef","filter","keep","r","length","toggleRef","clearRefs","useEnsureFavorites","store","useEffect","ensure","ensureCapability","useFavorites","selectList","useCallback","snapshot","slice","items","ids","useMemo","buildIdSet","set","Set","_iterator2","_step2","add","write","prev","remove","toggle","clear","isFavorite","has","count","useIsFavorite","selectIsFavorite"],"sources":["../../../../../src/lib/v2/personalization/capabilities/favorites.ts"],"sourcesContent":["/**\r\n * favorites — Portnet UI v2 · personalization capability\r\n *\r\n * The Favorites framework. Self-registers the \"favorites\" capability with\r\n * the schema registry at import time, so the capability-agnostic\r\n * foundation discovers its schemaVersion / defaultState / migrate without\r\n * any hardcoding.\r\n *\r\n * State model (the capability payload):\r\n *   { [resourceKey]: FavoriteRef[] }     FavoriteRef = { id, addedAt }\r\n *\r\n * `resourceKey` namespaces favorites per list/entity type (e.g.\r\n * \"ti:list\", \"declarations:list\"), so one user's favorites across\r\n * different screens never collide. `id` is the business row id.\r\n *\r\n * Performance: the pure helpers below rebuild only the touched\r\n * resourceKey's array and shallow-copy the map, so the store's structural\r\n * sharing keeps every OTHER resource's list referentially stable —\r\n * toggling a favorite on screen B does not re-render screen A, and a\r\n * boolean per-row selector lets each grid cell re-render only when its own\r\n * membership flips.\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\nimport type { FavoriteRef } from \"../types\";\r\nimport type { RowId } from \"../../types/common\";\r\n\r\n/** The favorites capability payload: favorites arrays keyed by resourceKey. */\r\ntype FavoritesState = Record<string, FavoriteRef[]>;\r\n\r\nexport const FAVORITES_CAPABILITY_ID = \"favorites\";\r\nconst SCHEMA_VERSION = 1;\r\n\r\nconst EMPTY_LIST: readonly FavoriteRef[] = Object.freeze([]);\r\nconst EMPTY_MAP: FavoritesState = Object.freeze({});\r\n\r\n/* Register at import time — the foundation reads this at hydration. */\r\nregisterCapability({\r\n  id: FAVORITES_CAPABILITY_ID,\r\n  schemaVersion: SCHEMA_VERSION,\r\n  defaultState: EMPTY_MAP, // { [resourceKey]: FavoriteRef[] }\r\n  migrate: function migrateFavorites(\r\n    _fromVersion: number,\r\n    payload: unknown\r\n  ): unknown {\r\n    // v1 is the initial schema. Defensive normalisation only.\r\n    return payload && typeof payload === \"object\" ? payload : {};\r\n  },\r\n});\r\n\r\n/* ── pure, resourceKey-scoped state helpers (structural sharing) ────── */\r\n\r\nfunction listFor(\r\n  map: FavoritesState | null | undefined,\r\n  resourceKey: string\r\n): readonly FavoriteRef[] {\r\n  const list = map ? map[resourceKey] : undefined;\r\n  return Array.isArray(list) ? list : EMPTY_LIST;\r\n}\r\n\r\nfunction hasRef(\r\n  map: FavoritesState | null | undefined,\r\n  resourceKey: string,\r\n  id: RowId\r\n): boolean {\r\n  const list = listFor(map, resourceKey);\r\n  for (const ref of list) {\r\n    if (ref.id === id) return true;\r\n  }\r\n  return false;\r\n}\r\n\r\nfunction addRef(\r\n  map: FavoritesState | null | undefined,\r\n  resourceKey: string,\r\n  id: RowId\r\n): FavoritesState {\r\n  const base = map || EMPTY_MAP;\r\n  if (hasRef(base, resourceKey, id)) return base; // no-op → store short-circuits\r\n  const nextList = listFor(base, resourceKey).concat([\r\n    { id: id, addedAt: new Date().toISOString() },\r\n  ]);\r\n  const next: FavoritesState = Object.assign({}, base);\r\n  next[resourceKey] = nextList;\r\n  return next;\r\n}\r\n\r\nfunction removeRef(\r\n  map: FavoritesState | null | undefined,\r\n  resourceKey: string,\r\n  id: RowId\r\n): FavoritesState {\r\n  const base = map || EMPTY_MAP;\r\n  if (!hasRef(base, resourceKey, id)) return base; // no-op\r\n  const nextList = listFor(base, resourceKey).filter(function keep(r) {\r\n    return r.id !== id;\r\n  });\r\n  const next: FavoritesState = Object.assign({}, base);\r\n  if (nextList.length === 0) delete next[resourceKey]; // keep the map tidy\r\n  else next[resourceKey] = nextList;\r\n  return next;\r\n}\r\n\r\nfunction toggleRef(\r\n  map: FavoritesState | null | undefined,\r\n  resourceKey: string,\r\n  id: RowId\r\n): FavoritesState {\r\n  return hasRef(map, resourceKey, id)\r\n    ? removeRef(map, resourceKey, id)\r\n    : addRef(map, resourceKey, id);\r\n}\r\n\r\nfunction clearRefs(\r\n  map: FavoritesState | null | undefined,\r\n  resourceKey: string\r\n): FavoritesState {\r\n  const base = map || EMPTY_MAP;\r\n  if (!base[resourceKey]) return base;\r\n  const next: FavoritesState = Object.assign({}, base);\r\n  delete next[resourceKey];\r\n  return next;\r\n}\r\n\r\n/* ── hooks ──────────────────────────────────────────────────────────── */\r\n\r\nfunction useEnsureFavorites(store: PersonalizationStore): void {\r\n  React.useEffect(\r\n    function ensure() {\r\n      store.ensureCapability(FAVORITES_CAPABILITY_ID);\r\n    },\r\n    [store]\r\n  );\r\n}\r\n\r\nexport interface UseFavoritesResult {\r\n  items: readonly FavoriteRef[];\r\n  ids: Set<RowId>;\r\n  count: number;\r\n  isFavorite: (id: RowId) => boolean;\r\n  add: (id: RowId) => void;\r\n  remove: (id: RowId) => void;\r\n  toggle: (id: RowId) => void;\r\n  clear: () => void;\r\n}\r\n\r\n/**\r\n * useFavorites(resourceKey) — list, membership and actions for one resource.\r\n */\r\nexport function useFavorites(resourceKey: string): UseFavoritesResult {\r\n  const store = usePersonalizationStore();\r\n  useEnsureFavorites(store);\r\n\r\n  const selectList = React.useCallback(\r\n    function selectList(snapshot: PersonalizationSnapshot): readonly FavoriteRef[] {\r\n      const slice = snapshot[FAVORITES_CAPABILITY_ID] as\r\n        | FavoritesState\r\n        | undefined;\r\n      return slice ? listFor(slice, resourceKey) : EMPTY_LIST;\r\n    },\r\n    [resourceKey]\r\n  );\r\n  const items = useStoreSelector(selectList);\r\n\r\n  // Stable while `items` is stable (structural sharing) → O(1) membership.\r\n  const ids = React.useMemo(\r\n    function buildIdSet(): Set<RowId> {\r\n      const set = new Set<RowId>();\r\n      for (const ref of items) set.add(ref.id);\r\n      return set;\r\n    },\r\n    [items]\r\n  );\r\n\r\n  const add = React.useCallback(\r\n    function add(id: RowId): void {\r\n      store.write<FavoritesState>(FAVORITES_CAPABILITY_ID, function (prev) {\r\n        return addRef(prev, resourceKey, id);\r\n      });\r\n    },\r\n    [store, resourceKey]\r\n  );\r\n  const remove = React.useCallback(\r\n    function remove(id: RowId): void {\r\n      store.write<FavoritesState>(FAVORITES_CAPABILITY_ID, function (prev) {\r\n        return removeRef(prev, resourceKey, id);\r\n      });\r\n    },\r\n    [store, resourceKey]\r\n  );\r\n  const toggle = React.useCallback(\r\n    function toggle(id: RowId): void {\r\n      store.write<FavoritesState>(FAVORITES_CAPABILITY_ID, function (prev) {\r\n        return toggleRef(prev, resourceKey, id);\r\n      });\r\n    },\r\n    [store, resourceKey]\r\n  );\r\n  const clear = React.useCallback(\r\n    function clear(): void {\r\n      store.write<FavoritesState>(FAVORITES_CAPABILITY_ID, function (prev) {\r\n        return clearRefs(prev, resourceKey);\r\n      });\r\n    },\r\n    [store, resourceKey]\r\n  );\r\n  const isFavorite = React.useCallback(\r\n    function isFavorite(id: RowId): boolean {\r\n      return ids.has(id);\r\n    },\r\n    [ids]\r\n  );\r\n\r\n  return React.useMemo(\r\n    function value(): UseFavoritesResult {\r\n      return {\r\n        items: items,\r\n        ids: ids,\r\n        count: items.length,\r\n        isFavorite: isFavorite,\r\n        add: add,\r\n        remove: remove,\r\n        toggle: toggle,\r\n        clear: clear,\r\n      };\r\n    },\r\n    [items, ids, isFavorite, add, remove, toggle, clear]\r\n  );\r\n}\r\n\r\nexport interface UseIsFavoriteResult {\r\n  isFavorite: boolean;\r\n  toggle: () => void;\r\n  add: () => void;\r\n  remove: () => void;\r\n}\r\n\r\n/**\r\n * useIsFavorite(resourceKey, id) — focused per-row hook. Returns a boolean\r\n * (Object.is bail-out: a row re-renders only when ITS membership flips)\r\n * plus a bound toggle/add/remove. This is the cell-level hook the DataGrid\r\n * favorite column consumes (Batch 5).\r\n */\r\nexport function useIsFavorite(\r\n  resourceKey: string,\r\n  id: RowId\r\n): UseIsFavoriteResult {\r\n  const store = usePersonalizationStore();\r\n  useEnsureFavorites(store);\r\n\r\n  const selectIsFavorite = React.useCallback(\r\n    function selectIsFavorite(snapshot: PersonalizationSnapshot): boolean {\r\n      const slice = snapshot[FAVORITES_CAPABILITY_ID] as\r\n        | FavoritesState\r\n        | undefined;\r\n      return slice ? hasRef(slice, resourceKey, id) : false;\r\n    },\r\n    [resourceKey, id]\r\n  );\r\n  const isFavorite = useStoreSelector(selectIsFavorite);\r\n\r\n  const toggle = React.useCallback(\r\n    function toggle(): void {\r\n      store.write<FavoritesState>(FAVORITES_CAPABILITY_ID, function (prev) {\r\n        return toggleRef(prev, resourceKey, id);\r\n      });\r\n    },\r\n    [store, resourceKey, id]\r\n  );\r\n  const add = React.useCallback(\r\n    function add(): void {\r\n      store.write<FavoritesState>(FAVORITES_CAPABILITY_ID, function (prev) {\r\n        return addRef(prev, resourceKey, id);\r\n      });\r\n    },\r\n    [store, resourceKey, id]\r\n  );\r\n  const remove = React.useCallback(\r\n    function remove(): void {\r\n      store.write<FavoritesState>(FAVORITES_CAPABILITY_ID, function (prev) {\r\n        return removeRef(prev, resourceKey, id);\r\n      });\r\n    },\r\n    [store, resourceKey, id]\r\n  );\r\n\r\n  return React.useMemo(\r\n    function value(): UseIsFavoriteResult {\r\n      return {\r\n        isFavorite: isFavorite,\r\n        toggle: toggle,\r\n        add: add,\r\n        remove: remove,\r\n      };\r\n    },\r\n    [isFavorite, toggle, add, remove]\r\n  );\r\n}\r\n"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,111 @@
+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
+ *
+ * Grid-agnostic favorites VIEW logic: filter (all / favorites-only) and
+ * sort (favorites-first / favorites-last). Pure helpers usable anywhere,
+ * plus a useFavoritesView hook that wires them to the favorites capability.
+ *
+ * The host owns its row id contract and the toggle UI (use FavoritesFilter
+ * or any control bound to `filterMode` / `sortPlacement`). These helpers
+ * only reorder/subset the rows array the host already has — they never
+ * fetch or mutate.
+ */
+
+import * as React from "react";
+import { useFavorites } from "./favorites";
+export var FAVORITES_FILTER = Object.freeze({
+  ALL: "all",
+  ONLY: "only"
+});
+export var FAVORITES_SORT = Object.freeze({
+  NONE: "none",
+  FIRST: "first",
+  LAST: "last"
+});
+var EMPTY_ROWS = Object.freeze([]);
+function toIdSet(ids) {
+  return ids instanceof Set ? ids : new Set(ids || []);
+}
+function resolveGetRowId(getRowId) {
+  return typeof getRowId === "function" ? getRowId : function defaultGetRowId(r) {
+    return r.id;
+  };
+}
+
+/**
+ * Keep only favorited rows when mode === "only"; otherwise return `rows`
+ * unchanged (same reference).
+ */
+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);
+  return source.filter(function keepFavorite(r) {
+    return ids.has(getId(r));
+  });
+}
+
+/**
+ * Move favorited rows to the front ("first") or back ("last"), preserving
+ * the host's existing order WITHIN each group (stable partition). Returns
+ * `rows` unchanged when placement is "none" or when reordering is a no-op.
+ */
+export function sortRowsByFavorites(rows, favoriteIds, getRowId, placement) {
+  if (placement !== FAVORITES_SORT.FIRST && placement !== FAVORITES_SORT.LAST || !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);
+  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();
+  }
+  if (fav.length === 0 || rest.length === 0) return source; // nothing to reorder
+  return placement === FAVORITES_SORT.FIRST ? fav.concat(rest) : rest.concat(fav);
+}
+/**
+ * useFavoritesView(resourceKey, rows, options)
+ *
+ * Reads the favorites id Set for `resourceKey` and applies the favorites
+ * filter + sort to `rows`. In the all/none case the original `rows`
+ * 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);
+    return sortRowsByFavorites(filtered, ids, getRowId, sortPlacement);
+  }, [rows, ids, getRowId, filterMode, sortPlacement]);
+  return React.useMemo(function value() {
+    return {
+      rows: processed,
+      favoriteIds: ids,
+      favoriteCount: fav.count,
+      isFiltering: filterMode === FAVORITES_FILTER.ONLY
+    };
+  }, [processed, ids, fav.count, filterMode]);
+}
+//# sourceMappingURL=favoritesView.js.map

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

@@ -0,0 +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":[]}

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

@@ -0,0 +1,17 @@
+/**
+ * capabilities — Portnet UI v2 · personalization
+ *
+ * Capability slices. Each slice self-registers with the schema registry
+ * at import time, so importing a slice's hook is enough to activate its
+ * capability — no manual wiring on the host.
+ *
+ *   - favorites     (Batch 3) — useFavorites, useIsFavorite
+ *                   (Batch 5) — useFavoritesView + filter/sort helpers
+ *   - savedFilters  (Batch 4) — useSavedFilters (+ SaveFilterDialog,
+ *                               SavedFiltersMenu in patterns/)
+ */
+
+export { useFavorites, useIsFavorite, FAVORITES_CAPABILITY_ID } from "./favorites";
+export { useSavedFilters, SAVED_FILTERS_CAPABILITY_ID } from "./savedFilters";
+export { useFavoritesView, filterRowsByFavorites, sortRowsByFavorites, FAVORITES_FILTER, FAVORITES_SORT } from "./favoritesView";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["useFavorites","useIsFavorite","FAVORITES_CAPABILITY_ID","useSavedFilters","SAVED_FILTERS_CAPABILITY_ID","useFavoritesView","filterRowsByFavorites","sortRowsByFavorites","FAVORITES_FILTER","FAVORITES_SORT"],"sources":["../../../../../src/lib/v2/personalization/capabilities/index.ts"],"sourcesContent":["/**\r\n * capabilities — Portnet UI v2 · personalization\r\n *\r\n * Capability slices. Each slice self-registers with the schema registry\r\n * at import time, so importing a slice's hook is enough to activate its\r\n * capability — no manual wiring on the host.\r\n *\r\n *   - favorites     (Batch 3) — useFavorites, useIsFavorite\r\n *                   (Batch 5) — useFavoritesView + filter/sort helpers\r\n *   - savedFilters  (Batch 4) — useSavedFilters (+ SaveFilterDialog,\r\n *                               SavedFiltersMenu in patterns/)\r\n */\r\n\r\nexport {\r\n  useFavorites,\r\n  useIsFavorite,\r\n  FAVORITES_CAPABILITY_ID,\r\n} from \"./favorites\";\r\nexport { useSavedFilters, SAVED_FILTERS_CAPABILITY_ID } from \"./savedFilters\";\r\nexport {\r\n  useFavoritesView,\r\n  filterRowsByFavorites,\r\n  sortRowsByFavorites,\r\n  FAVORITES_FILTER,\r\n  FAVORITES_SORT,\r\n} from \"./favoritesView\";\r\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SACEA,YAAY,EACZC,aAAa,EACbC,uBAAuB,QAClB,aAAa;AACpB,SAASC,eAAe,EAAEC,2BAA2B,QAAQ,gBAAgB;AAC7E,SACEC,gBAAgB,EAChBC,qBAAqB,EACrBC,mBAAmB,EACnBC,gBAAgB,EAChBC,cAAc,QACT,iBAAiB","ignoreList":[]}