@portnet/ui 6.0.0 → 6.0.2

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

@@ -0,0 +1,124 @@
+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); }
+/**
+ * createLocalStorageAdapter — Portnet UI v2 · personalization
+ *
+ * Default Adapter. Persists each capability as an opaque envelope under a
+ * scoped key (see adapters/_storageKey.ts). The adapter never interprets
+ * `envelope.payload`.
+ *
+ * Safety:
+ *   - SSR-safe: with no `window`, the adapter is inert (load → {}, save →
+ *     resolved no-op) so it can be constructed anywhere.
+ *   - Every storage access is try/catch-wrapped. `save` REJECTS on quota/
+ *     private-mode failure so the store can keep the optimistic value for the
+ *     session and surface the error via onError.
+ *   - Reads self-heal: malformed entries are removed on sight.
+ *   - Reserved-key hardening: capability ids of `__proto__` / `constructor` /
+ *     `prototype` are skipped while scanning so a crafted same-origin key can't
+ *     reach the `__proto__` setter on the accumulator (SEC-LS1).
+ *   - NOTE: localStorage is readable by any same-origin script. Do NOT persist
+ *     secrets or PII in a capability payload (SEC-LS2).
+ *
+ * Cross-tab: `subscribe` listens to the `storage` event, which the spec fires
+ * in OTHER tabs only — the writing tab is reconciled via the store's in-memory
+ * path.
+ */
+
+import { buildKey, buildScopePrefix } from "./_storageKey";
+/** Object keys that must never be written from external (storage-derived) data. */
+var RESERVED_KEYS = new Set(["__proto__", "constructor", "prototype"]);
+export default function createLocalStorageAdapter(options) {
+  var opts = options || {};
+  var storage = opts.storage || (typeof window !== "undefined" && window.localStorage ? window.localStorage : null);
+  function isValidEnvelope(env) {
+    return !!env && _typeof(env) === "object" && Object.prototype.hasOwnProperty.call(env, "payload");
+  }
+  function safeRemove(key) {
+    if (!storage) return;
+    try {
+      storage.removeItem(key);
+    } catch (_unused) {
+      /* ignore */
+    }
+  }
+
+  /** Synchronous scan of every capability blob for `scope`. */
+  function loadSync(scope) {
+    if (!storage) return {};
+    var out = {};
+    try {
+      var prefix = buildScopePrefix(scope);
+      for (var i = 0; i < storage.length; i++) {
+        var key = storage.key(i);
+        if (!key || key.indexOf(prefix) !== 0) continue;
+        var capId = key.slice(prefix.length);
+        // Skip empty + reserved keys: a same-origin writer could craft a
+        // `<prefix>__proto__` key, and `out[capId] = env` would otherwise hit
+        // the __proto__ setter on the accumulator (SEC-LS1).
+        if (!capId || RESERVED_KEYS.has(capId)) continue;
+        var raw = storage.getItem(key);
+        if (!raw) continue;
+        try {
+          var env = JSON.parse(raw);
+          if (isValidEnvelope(env)) out[capId] = env;else safeRemove(key);
+        } catch (_unused2) {
+          safeRemove(key);
+        }
+      }
+    } catch (_unused3) {
+      /* enumeration blocked (sandboxed) — return what we have */
+    }
+    return out;
+  }
+  function load(scope) {
+    return Promise.resolve(loadSync(scope));
+  }
+  function save(scope, capabilityId, envelope) {
+    if (!storage) return Promise.resolve();
+    try {
+      storage.setItem(buildKey(scope, capabilityId), JSON.stringify(envelope));
+      return Promise.resolve();
+    } catch (e) {
+      // Quota exceeded / private mode / sandboxed: reject so the store keeps
+      // the optimistic in-memory value and notifies onError.
+      return Promise.reject(e);
+    }
+  }
+  function remove(scope, capabilityId) {
+    if (!storage) return Promise.resolve();
+    safeRemove(buildKey(scope, capabilityId));
+    return Promise.resolve();
+  }
+  function subscribe(scope, onChange) {
+    if (typeof window === "undefined" || typeof window.addEventListener !== "function") {
+      return function noop() {};
+    }
+    var prefix = buildScopePrefix(scope);
+    var handler = function handleStorage(e) {
+      if (!e || e.key == null) return; // e.key === null on storage.clear()
+      // storageArea may be undefined in some environments; only filter when present.
+      if (e.storageArea && e.storageArea !== storage) return;
+      if (e.key.indexOf(prefix) !== 0) return;
+      var capId = e.key.slice(prefix.length);
+      if (capId && !RESERVED_KEYS.has(capId)) onChange(capId);
+    };
+    window.addEventListener("storage", handler);
+    return function unsubscribe() {
+      window.removeEventListener("storage", handler);
+    };
+  }
+  return Object.freeze({
+    name: "localStorage",
+    load: load,
+    loadSync: loadSync,
+    save: save,
+    remove: remove,
+    subscribe: subscribe,
+    capabilities: Object.freeze({
+      crossTab: true,
+      remote: false,
+      shared: false
+    })
+  });
+}
+//# sourceMappingURL=createLocalStorageAdapter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createLocalStorageAdapter.js","names":["buildKey","buildScopePrefix","RESERVED_KEYS","Set","createLocalStorageAdapter","options","opts","storage","window","localStorage","isValidEnvelope","env","_typeof","Object","prototype","hasOwnProperty","call","safeRemove","key","removeItem","_unused","loadSync","scope","out","prefix","i","length","indexOf","capId","slice","has","raw","getItem","JSON","parse","_unused2","_unused3","load","Promise","resolve","save","capabilityId","envelope","setItem","stringify","e","reject","remove","subscribe","onChange","addEventListener","noop","handler","handleStorage","storageArea","unsubscribe","removeEventListener","freeze","name","capabilities","crossTab","remote","shared"],"sources":["../../../../../src/lib/v2/personalization/adapters/createLocalStorageAdapter.ts"],"sourcesContent":["/**\r\n * createLocalStorageAdapter — Portnet UI v2 · personalization\r\n *\r\n * Default Adapter. Persists each capability as an opaque envelope under a\r\n * scoped key (see adapters/_storageKey.ts). The adapter never interprets\r\n * `envelope.payload`.\r\n *\r\n * Safety:\r\n *   - SSR-safe: with no `window`, the adapter is inert (load → {}, save →\r\n *     resolved no-op) so it can be constructed anywhere.\r\n *   - Every storage access is try/catch-wrapped. `save` REJECTS on quota/\r\n *     private-mode failure so the store can keep the optimistic value for the\r\n *     session and surface the error via onError.\r\n *   - Reads self-heal: malformed entries are removed on sight.\r\n *   - Reserved-key hardening: capability ids of `__proto__` / `constructor` /\r\n *     `prototype` are skipped while scanning so a crafted same-origin key can't\r\n *     reach the `__proto__` setter on the accumulator (SEC-LS1).\r\n *   - NOTE: localStorage is readable by any same-origin script. Do NOT persist\r\n *     secrets or PII in a capability payload (SEC-LS2).\r\n *\r\n * Cross-tab: `subscribe` listens to the `storage` event, which the spec fires\r\n * in OTHER tabs only — the writing tab is reconciled via the store's in-memory\r\n * path.\r\n */\r\n\r\nimport { buildKey, buildScopePrefix } from \"./_storageKey\";\r\nimport type { Adapter, Envelope, Scope } from \"../types\";\r\n\r\nexport interface LocalStorageAdapterOptions {\r\n  /** Inject a Storage impl (tests / custom). */\r\n  storage?: Storage | undefined;\r\n}\r\n\r\n/** Object keys that must never be written from external (storage-derived) data. */\r\nconst RESERVED_KEYS = new Set([\"__proto__\", \"constructor\", \"prototype\"]);\r\n\r\nexport default function createLocalStorageAdapter(\r\n  options?: LocalStorageAdapterOptions\r\n): Adapter {\r\n  const opts: LocalStorageAdapterOptions = options || {};\r\n  const storage: Storage | null =\r\n    opts.storage ||\r\n    (typeof window !== \"undefined\" && window.localStorage\r\n      ? window.localStorage\r\n      : null);\r\n\r\n  function isValidEnvelope(env: unknown): env is Envelope {\r\n    return (\r\n      !!env &&\r\n      typeof env === \"object\" &&\r\n      Object.prototype.hasOwnProperty.call(env, \"payload\")\r\n    );\r\n  }\r\n\r\n  function safeRemove(key: string): void {\r\n    if (!storage) return;\r\n    try {\r\n      storage.removeItem(key);\r\n    } catch {\r\n      /* ignore */\r\n    }\r\n  }\r\n\r\n  /** Synchronous scan of every capability blob for `scope`. */\r\n  function loadSync(scope: Scope): Record<string, Envelope> {\r\n    if (!storage) return {};\r\n    const out: Record<string, Envelope> = {};\r\n    try {\r\n      const prefix = buildScopePrefix(scope);\r\n      for (let i = 0; i < storage.length; i++) {\r\n        const key = storage.key(i);\r\n        if (!key || key.indexOf(prefix) !== 0) continue;\r\n        const capId = key.slice(prefix.length);\r\n        // Skip empty + reserved keys: a same-origin writer could craft a\r\n        // `<prefix>__proto__` key, and `out[capId] = env` would otherwise hit\r\n        // the __proto__ setter on the accumulator (SEC-LS1).\r\n        if (!capId || RESERVED_KEYS.has(capId)) continue;\r\n        const raw = storage.getItem(key);\r\n        if (!raw) continue;\r\n        try {\r\n          const env: unknown = JSON.parse(raw);\r\n          if (isValidEnvelope(env)) out[capId] = env;\r\n          else safeRemove(key);\r\n        } catch {\r\n          safeRemove(key);\r\n        }\r\n      }\r\n    } catch {\r\n      /* enumeration blocked (sandboxed) — return what we have */\r\n    }\r\n    return out;\r\n  }\r\n\r\n  function load(scope: Scope): Promise<Record<string, Envelope>> {\r\n    return Promise.resolve(loadSync(scope));\r\n  }\r\n\r\n  function save(\r\n    scope: Scope,\r\n    capabilityId: string,\r\n    envelope: Envelope\r\n  ): Promise<void> {\r\n    if (!storage) return Promise.resolve();\r\n    try {\r\n      storage.setItem(buildKey(scope, capabilityId), JSON.stringify(envelope));\r\n      return Promise.resolve();\r\n    } catch (e) {\r\n      // Quota exceeded / private mode / sandboxed: reject so the store keeps\r\n      // the optimistic in-memory value and notifies onError.\r\n      return Promise.reject(e);\r\n    }\r\n  }\r\n\r\n  function remove(scope: Scope, capabilityId: string): Promise<void> {\r\n    if (!storage) return Promise.resolve();\r\n    safeRemove(buildKey(scope, capabilityId));\r\n    return Promise.resolve();\r\n  }\r\n\r\n  function subscribe(\r\n    scope: Scope,\r\n    onChange: (capabilityId: string) => void\r\n  ): () => void {\r\n    if (\r\n      typeof window === \"undefined\" ||\r\n      typeof window.addEventListener !== \"function\"\r\n    ) {\r\n      return function noop() {};\r\n    }\r\n    const prefix = buildScopePrefix(scope);\r\n    const handler = function handleStorage(e: StorageEvent) {\r\n      if (!e || e.key == null) return; // e.key === null on storage.clear()\r\n      // storageArea may be undefined in some environments; only filter when present.\r\n      if (e.storageArea && e.storageArea !== storage) return;\r\n      if (e.key.indexOf(prefix) !== 0) return;\r\n      const capId = e.key.slice(prefix.length);\r\n      if (capId && !RESERVED_KEYS.has(capId)) onChange(capId);\r\n    };\r\n    window.addEventListener(\"storage\", handler);\r\n    return function unsubscribe() {\r\n      window.removeEventListener(\"storage\", handler);\r\n    };\r\n  }\r\n\r\n  return Object.freeze({\r\n    name: \"localStorage\",\r\n    load,\r\n    loadSync,\r\n    save,\r\n    remove,\r\n    subscribe,\r\n    capabilities: Object.freeze({\r\n      crossTab: true,\r\n      remote: false,\r\n      shared: false,\r\n    }),\r\n  });\r\n}\r\n"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,70 @@
+/**
+ * createMemoryAdapter — Portnet UI v2 · personalization
+ *
+ * An Adapter that keeps everything in a Map. Use it for:
+ *   - unit tests (deterministic, no global storage state),
+ *   - SSR / sandboxed environments where localStorage is unavailable,
+ *   - Storybook stories (optionally pre-seeded),
+ *   - an explicit "do not persist" opt-out.
+ *
+ * Same contract as the localStorage adapter minus `subscribe` (a single
+ * in-memory context has no cross-tab notion). `remote:false` lets the store
+ * skip the redundant async re-hydrate after a synchronous seed.
+ */
+
+export default function createMemoryAdapter(options) {
+  var opts = options || {};
+  /** composite key -> envelope */
+  var map = new Map();
+  function compositeKey(scope, capabilityId) {
+    var tenant = scope && scope.tenantId ? scope.tenantId : "";
+    var user = scope && scope.userId ? scope.userId : "";
+    return tenant + "::" + user + "::" + capabilityId;
+  }
+  function scopePrefix(scope) {
+    var tenant = scope && scope.tenantId ? scope.tenantId : "";
+    var user = scope && scope.userId ? scope.userId : "";
+    return tenant + "::" + user + "::";
+  }
+  if (Array.isArray(opts.seed)) {
+    opts.seed.forEach(function seedEntry(entry) {
+      if (entry && entry.scope && entry.capabilityId && entry.envelope) {
+        map.set(compositeKey(entry.scope, entry.capabilityId), entry.envelope);
+      }
+    });
+  }
+  function loadSync(scope) {
+    var out = {};
+    var prefix = scopePrefix(scope);
+    map.forEach(function collect(envelope, key) {
+      if (key.indexOf(prefix) === 0) {
+        out[key.slice(prefix.length)] = envelope;
+      }
+    });
+    return out;
+  }
+  function load(scope) {
+    return Promise.resolve(loadSync(scope));
+  }
+  function save(scope, capabilityId, envelope) {
+    map.set(compositeKey(scope, capabilityId), envelope);
+    return Promise.resolve();
+  }
+  function remove(scope, capabilityId) {
+    map["delete"](compositeKey(scope, capabilityId));
+    return Promise.resolve();
+  }
+  return Object.freeze({
+    name: "memory",
+    load: load,
+    loadSync: loadSync,
+    save: save,
+    remove: remove,
+    capabilities: Object.freeze({
+      crossTab: false,
+      remote: false,
+      shared: false
+    })
+  });
+}
+//# sourceMappingURL=createMemoryAdapter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createMemoryAdapter.js","names":["createMemoryAdapter","options","opts","map","Map","compositeKey","scope","capabilityId","tenant","tenantId","user","userId","scopePrefix","Array","isArray","seed","forEach","seedEntry","entry","envelope","set","loadSync","out","prefix","collect","key","indexOf","slice","length","load","Promise","resolve","save","remove","Object","freeze","name","capabilities","crossTab","remote","shared"],"sources":["../../../../../src/lib/v2/personalization/adapters/createMemoryAdapter.ts"],"sourcesContent":["/**\r\n * createMemoryAdapter — Portnet UI v2 · personalization\r\n *\r\n * An Adapter that keeps everything in a Map. Use it for:\r\n *   - unit tests (deterministic, no global storage state),\r\n *   - SSR / sandboxed environments where localStorage is unavailable,\r\n *   - Storybook stories (optionally pre-seeded),\r\n *   - an explicit \"do not persist\" opt-out.\r\n *\r\n * Same contract as the localStorage adapter minus `subscribe` (a single\r\n * in-memory context has no cross-tab notion). `remote:false` lets the store\r\n * skip the redundant async re-hydrate after a synchronous seed.\r\n */\r\n\r\nimport type { Adapter, Envelope, Scope } from \"../types\";\r\n\r\nexport interface MemoryAdapterSeedEntry {\r\n  scope: Scope;\r\n  capabilityId: string;\r\n  envelope: Envelope;\r\n}\r\n\r\nexport interface MemoryAdapterOptions {\r\n  /** Optional pre-populated entries for tests/stories. */\r\n  seed?: MemoryAdapterSeedEntry[] | undefined;\r\n}\r\n\r\nexport default function createMemoryAdapter(\r\n  options?: MemoryAdapterOptions\r\n): Adapter {\r\n  const opts: MemoryAdapterOptions = options || {};\r\n  /** composite key -> envelope */\r\n  const map = new Map<string, Envelope>();\r\n\r\n  function compositeKey(scope: Scope, capabilityId: string): string {\r\n    const tenant = scope && scope.tenantId ? scope.tenantId : \"\";\r\n    const user = scope && scope.userId ? scope.userId : \"\";\r\n    return tenant + \"::\" + user + \"::\" + capabilityId;\r\n  }\r\n\r\n  function scopePrefix(scope: Scope): string {\r\n    const tenant = scope && scope.tenantId ? scope.tenantId : \"\";\r\n    const user = scope && scope.userId ? scope.userId : \"\";\r\n    return tenant + \"::\" + user + \"::\";\r\n  }\r\n\r\n  if (Array.isArray(opts.seed)) {\r\n    opts.seed.forEach(function seedEntry(entry) {\r\n      if (entry && entry.scope && entry.capabilityId && entry.envelope) {\r\n        map.set(compositeKey(entry.scope, entry.capabilityId), entry.envelope);\r\n      }\r\n    });\r\n  }\r\n\r\n  function loadSync(scope: Scope): Record<string, Envelope> {\r\n    const out: Record<string, Envelope> = {};\r\n    const prefix = scopePrefix(scope);\r\n    map.forEach(function collect(envelope, key) {\r\n      if (key.indexOf(prefix) === 0) {\r\n        out[key.slice(prefix.length)] = envelope;\r\n      }\r\n    });\r\n    return out;\r\n  }\r\n\r\n  function load(scope: Scope): Promise<Record<string, Envelope>> {\r\n    return Promise.resolve(loadSync(scope));\r\n  }\r\n\r\n  function save(\r\n    scope: Scope,\r\n    capabilityId: string,\r\n    envelope: Envelope\r\n  ): Promise<void> {\r\n    map.set(compositeKey(scope, capabilityId), envelope);\r\n    return Promise.resolve();\r\n  }\r\n\r\n  function remove(scope: Scope, capabilityId: string): Promise<void> {\r\n    map.delete(compositeKey(scope, capabilityId));\r\n    return Promise.resolve();\r\n  }\r\n\r\n  return Object.freeze({\r\n    name: \"memory\",\r\n    load,\r\n    loadSync,\r\n    save,\r\n    remove,\r\n    capabilities: Object.freeze({\r\n      crossTab: false,\r\n      remote: false,\r\n      shared: false,\r\n    }),\r\n  });\r\n}\r\n"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,11 @@
+/**
+ * adapters — Portnet UI v2 · personalization
+ *
+ * Built-in storage adapters. A future remote adapter
+ * (createRestPersonalizationAdapter) drops in here and is swappable with
+ * zero changes to the store, the slices, the hooks, or the components.
+ */
+
+export { default as createLocalStorageAdapter } from "./createLocalStorageAdapter";
+export { default as createMemoryAdapter } from "./createMemoryAdapter";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["default","createLocalStorageAdapter","createMemoryAdapter"],"sources":["../../../../../src/lib/v2/personalization/adapters/index.ts"],"sourcesContent":["/**\r\n * adapters — Portnet UI v2 · personalization\r\n *\r\n * Built-in storage adapters. A future remote adapter\r\n * (createRestPersonalizationAdapter) drops in here and is swappable with\r\n * zero changes to the store, the slices, the hooks, or the components.\r\n */\r\n\r\nexport { default as createLocalStorageAdapter } from \"./createLocalStorageAdapter\";\r\nexport { default as createMemoryAdapter } from \"./createMemoryAdapter\";\r\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,OAAO,IAAIC,yBAAyB,QAAQ,6BAA6B;AAClF,SAASD,OAAO,IAAIE,mBAAmB,QAAQ,uBAAuB","ignoreList":[]}

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":[]}