@portnet/ui 6.0.0 → 6.0.1

package/dist/esm/v2/patterns/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["default","ActionBar","BulkActionBar","ColumnsToggle","FormSection","FormPageShell","FormErrorSummary","FormikErrorFocus","PageContent","DataGrid","applySort","DataGridVirtualized","DataGridSettingsMenu","DataGridToolbar","CollapsibleDataGrid","SortableHeader","getAriaSort","NetworkErrorBanner","ReferentielField","Tour","KeyboardShortcutsHelp","DeleteResourceConfirmDialog","SaveFilterDialog","SavedFiltersMenu","makeFavoriteColumn","FavoritesFilter","FormikInput","FormikTextarea","FormikSelect","FormikCombobox","FormikDatePicker","FormikFile","FormikCheckboxGroup","FormikReferentielField","FormikDisplay"],"sources":["../../../../src/lib/v2/patterns/index.ts"],"sourcesContent":["export { default as ActionBar }            from \"./ActionBar\";\r\nexport type { ActionBarProps, ActionBarAction, ActionBarLabels, BreadcrumbItem, CrumbEntry } from \"./ActionBar\";\r\nexport { default as BulkActionBar }        from \"./BulkActionBar\";\r\nexport { default as ColumnsToggle }        from \"./ColumnsToggle\";\r\nexport { default as FormSection }          from \"./FormSection\";\r\nexport { default as FormPageShell }        from \"./FormPageShell\";\r\nexport { default as FormErrorSummary }     from \"./FormErrorSummary\";\r\nexport type { FormErrorSummaryProps, FormErrorSummaryError } from \"./FormErrorSummary\";\r\n// R-FV.3 companion to FormErrorSummary (R-FV.2) — renders nothing, moves\r\n// focus to the first field in error after a failed submit. Adopt both.\r\nexport { default as FormikErrorFocus }     from \"./FormikErrorFocus\";\r\nexport type { FormikErrorFocusProps }      from \"./FormikErrorFocus\";\r\nexport { default as PageContent }          from \"./PageContent\";\r\nexport { default as DataGrid, applySort }  from \"./DataGrid\";\r\nexport { default as DataGridVirtualized }  from \"./DataGridVirtualized\";\r\nexport { default as DataGridSettingsMenu } from \"./DataGridSettingsMenu\";\r\nexport { default as DataGridToolbar }      from \"./DataGridToolbar\";\r\nexport { default as CollapsibleDataGrid }  from \"./CollapsibleDataGrid\";\r\nexport { default as SortableHeader, getAriaSort } from \"./SortableHeader\";\r\nexport { default as NetworkErrorBanner }   from \"./NetworkErrorBanner\";\r\nexport { default as ReferentielField }     from \"./ReferentielField\";\r\n/**\r\n * ReferentielField configuration types — public typed surface.\r\n *\r\n * Same class of gap as Gap-TS-003 (component types), which was fixed for\r\n * `./components` but never extended to `./patterns`: the VALUE above was\r\n * exported while the types describing its own REQUIRED props were not.\r\n * `columns` and `criteria` are mandatory-to-configure, so a consumer had no\r\n * way to type them without either deep-importing\r\n * `@portnet/ui/dist/v2/patterns/…` (fragile, bypasses the `exports` map) or\r\n * declaring a local twin — which the Platform TypeScript Guidelines forbid\r\n * (\"Reusable types belong inside Shared UI Library … Never duplicate\").\r\n *\r\n * `ReferentielSearchResult` and `ReferentielSearchParams` are deliberately\r\n * NOT re-exported here: identically-named types are already surfaced from\r\n * `./referentiel` (useReferentielSearch) and `./v2/models` respectively, and\r\n * `src/lib/index.ts` star-exports all three barrels — a second named export of\r\n * either identifier is a hard TS2308 ambiguity at the library root.\r\n *\r\n * Additive and type-only: no runtime change, no existing export altered.\r\n */\r\nexport type {\r\n  ReferentielFieldProps,\r\n  ReferentielCriterion,\r\n  ReferentielFieldLabels,\r\n} from \"./ReferentielField\";\r\nexport { default as Tour }                 from \"./Tour\";\r\nexport { default as KeyboardShortcutsHelp } from \"./KeyboardShortcutsHelp\";\r\nexport { default as DeleteResourceConfirmDialog } from \"./DeleteResourceConfirmDialog\";\r\n\r\n// ── Personalization · Saved Filters framework (v2/personalization) ────────────\r\n// SaveFilterDialog is presentational; SavedFiltersMenu is connected to the\r\n// savedFilters capability via useSavedFilters.\r\nexport { default as SaveFilterDialog }     from \"./SaveFilterDialog\";\r\nexport { default as SavedFiltersMenu }     from \"./SavedFiltersMenu\";\r\n\r\n// ── Personalization · Favorites DataGrid integration (v2/personalization) ─────\r\n// makeFavoriteColumn builds an always-visible favorites column for v2.DataGrid;\r\n// FavoritesFilter is the all/favorites-only segmented control.\r\nexport { default as makeFavoriteColumn }   from \"./FavoriteColumn\";\r\nexport { default as FavoritesFilter }      from \"./FavoritesFilter\";\r\nexport type { FavoritesFilterProps, FavoritesFilterLabels } from \"./FavoritesFilter\";\r\n\r\n// ── Formik bridges ────────────────────────────────────────────────────────────\r\nexport { default as FormikInput }          from \"./FormikInput\";\r\nexport { default as FormikTextarea }       from \"./FormikTextarea\";\r\nexport { default as FormikSelect }         from \"./FormikSelect\";\r\nexport { default as FormikCombobox }       from \"./FormikCombobox\";\r\n/**\r\n * FormikCombobox props — public typed surface.\r\n *\r\n * SAME GAP-TS-003 CLASS as the ReferentielField note above. That fix covered\r\n * `ReferentielField` and `FormikReferentielField` but was not extended to the\r\n * other Formik bridges: the VALUE is exported while the type describing its props\r\n * is not, so a consumer cannot write `Omit<FormikComboboxProps<T>, …>`.\r\n *\r\n * REQUESTED BY bmdav-fe (TypeScript migration, batch 6f). That module stores the\r\n * OPTION OBJECT in Formik rather than a primitive key, because its payload mapper\r\n * reads `values.typeDemande.id` and sends `delegationTraitement` as a whole\r\n * object — so it cannot adopt the primitive-key model without changing the\r\n * request body sent to bmdav-be. It contains the resulting variance in ONE local\r\n * adapter (`ObjectValuedFormikCombobox`) rather than scattering assertions across\r\n * call sites, and that adapter must restate this component's prop contract minus\r\n * `getOptionValue`. The deep-import fallback is unavailable under\r\n * `moduleResolution: \"bundler\"`, since the package `exports` map does not expose\r\n * `dist/v2/patterns/*`.\r\n *\r\n * `ComboboxOptionValue` is deliberately NOT re-exported here — it is already\r\n * surfaced from `./components` (Combobox), and a second named export at the\r\n * library root would be a TS2308 ambiguity, exactly as recorded above for\r\n * `ReferentielSearchResult` / `ReferentielSearchParams`.\r\n *\r\n * Additive and type-only: no runtime change, no existing export altered.\r\n */\r\nexport type { FormikComboboxProps }        from \"./FormikCombobox\";\r\nexport { default as FormikDatePicker }     from \"./FormikDatePicker\";\r\nexport { default as FormikFile }           from \"./FormikFile\";\r\nexport { default as FormikCheckboxGroup }  from \"./FormikCheckboxGroup\";\r\nexport { default as FormikReferentielField } from \"./FormikReferentielField\";\r\nexport type { FormikReferentielFieldProps } from \"./FormikReferentielField\";\r\n\r\n/** Affichage valeur système — fond grisé, aucune interaction.\r\n *  Utiliser à la place de FormikInput disabled pour les champs\r\n *  auto-générés ou non modifiables par l'utilisateur. */\r\nexport { default as FormikDisplay }        from \"../components/FormikDisplay\";\r\n"],"mappings":"AAAA,SAASA,OAAO,IAAIC,SAAS,QAAmB,aAAa;AAE7D,SAASD,OAAO,IAAIE,aAAa,QAAe,iBAAiB;AACjE,SAASF,OAAO,IAAIG,aAAa,QAAe,iBAAiB;AACjE,SAASH,OAAO,IAAII,WAAW,QAAiB,eAAe;AAC/D,SAASJ,OAAO,IAAIK,aAAa,QAAe,iBAAiB;AACjE,SAASL,OAAO,IAAIM,gBAAgB,QAAY,oBAAoB;AAEpE;AACA;AACA,SAASN,OAAO,IAAIO,gBAAgB,QAAY,oBAAoB;AAEpE,SAASP,OAAO,IAAIQ,WAAW,QAAiB,eAAe;AAC/D,SAASR,OAAO,IAAIS,QAAQ,EAAEC,SAAS,QAAS,YAAY;AAC5D,SAASV,OAAO,IAAIW,mBAAmB,QAAS,uBAAuB;AACvE,SAASX,OAAO,IAAIY,oBAAoB,QAAQ,wBAAwB;AACxE,SAASZ,OAAO,IAAIa,eAAe,QAAa,mBAAmB;AACnE,SAASb,OAAO,IAAIc,mBAAmB,QAAS,uBAAuB;AACvE,SAASd,OAAO,IAAIe,cAAc,EAAEC,WAAW,QAAQ,kBAAkB;AACzE,SAAShB,OAAO,IAAIiB,kBAAkB,QAAU,sBAAsB;AACtE,SAASjB,OAAO,IAAIkB,gBAAgB,QAAY,oBAAoB;AACpE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMA,SAASlB,OAAO,IAAImB,IAAI,QAAwB,QAAQ;AACxD,SAASnB,OAAO,IAAIoB,qBAAqB,QAAQ,yBAAyB;AAC1E,SAASpB,OAAO,IAAIqB,2BAA2B,QAAQ,+BAA+B;;AAEtF;AACA;AACA;AACA,SAASrB,OAAO,IAAIsB,gBAAgB,QAAY,oBAAoB;AACpE,SAAStB,OAAO,IAAIuB,gBAAgB,QAAY,oBAAoB;;AAEpE;AACA;AACA;AACA,SAASvB,OAAO,IAAIwB,kBAAkB,QAAU,kBAAkB;AAClE,SAASxB,OAAO,IAAIyB,eAAe,QAAa,mBAAmB;AAGnE;AACA,SAASzB,OAAO,IAAI0B,WAAW,QAAiB,eAAe;AAC/D,SAAS1B,OAAO,IAAI2B,cAAc,QAAc,kBAAkB;AAClE,SAAS3B,OAAO,IAAI4B,YAAY,QAAgB,gBAAgB;AAChE,SAAS5B,OAAO,IAAI6B,cAAc,QAAc,kBAAkB;AAClE;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,SAAS7B,OAAO,IAAI8B,gBAAgB,QAAY,oBAAoB;AACpE,SAAS9B,OAAO,IAAI+B,UAAU,QAAkB,cAAc;AAC9D,SAAS/B,OAAO,IAAIgC,mBAAmB,QAAS,uBAAuB;AACvE,SAAShC,OAAO,IAAIiC,sBAAsB,QAAQ,0BAA0B;AAG5E;AACA;AACA;AACA,SAASjC,OAAO,IAAIkC,aAAa,QAAe,6BAA6B","ignoreList":[]}

package/dist/esm/v2/personalization/PersonalizationProvider.js

@@ -0,0 +1,168 @@
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return _typeof(key) === "symbol" ? key : String(key); }
+function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (_typeof(res) !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+/**
+ * UserPersonalizationProvider — Portnet UI v2 · personalization
+ *
+ * The single configuration point for per-user personalization. Mount it
+ * once near the app root; every capability (favorites, saved filters, and
+ * future slices) reads through the one store it establishes.
+ *
+ *   import {
+ *     UserPersonalizationProvider,
+ *     createLocalStorageAdapter,
+ *   } from "@portnet/ui/v2/personalization";
+ *
+ *   <UserPersonalizationProvider userId={user.id} tenantId={tenant.id}>
+ *     <App />
+ *   </UserPersonalizationProvider>
+ *
+ * Store lifecycle
+ *   - Exactly one store per scope. Memoised on (scope, adapter) ONLY;
+ *     onError / hydrateStrategy are pushed in live via store.setRuntime so
+ *     inline handlers never recreate the store.
+ *   - The default localStorage adapter is created once (ref). A PROVIDED
+ *     adapter must be stable (useMemo/module singleton) — a dev guard warns
+ *     if its identity changes between renders.
+ *   - A lifecycle effect runs hydrate() + connect() and dispose()s the old
+ *     store on scope change / unmount (cross-tab listener torn down).
+ *
+ * React 18/19 compatible: no 19-only API is required.
+ */
+
+import * as React from "react";
+import { PersonalizationConfigContext, PersonalizationStoreContext } from "./personalizationContext";
+import createPersonalizationStore from "./createPersonalizationStore";
+import createLocalStorageAdapter from "./adapters/createLocalStorageAdapter";
+import { jsx as _jsx } from "react/jsx-runtime";
+var isDev = typeof process !== "undefined" && process.env && process.env["NODE_ENV"] !== "production";
+
+/**
+ * Default labels for the whole foundation (FR — charter default). Hosts
+ * override any subset via the `labels` prop; EN/AR overrides supported.
+ * Front-loaded here so the favorites (Batch 3) and saved-filters (Batch 4)
+ * components read consistent copy from one place.
+ */
+export var DEFAULT_PERSONALIZATION_LABELS = Object.freeze({
+  // Follow / "suivis" (Batch 3)
+  addFavorite: "Suivre",
+  removeFavorite: "Ne plus suivre",
+  favoritesOnly: "Suivis uniquement",
+  showAll: "Tout afficher",
+  favoriteColumnHeader: "Suivis",
+  // Saved filters (Batch 4)
+  savedFilters: "Filtres enregistrés",
+  saveCurrentFilter: "Enregistrer le filtre actuel…",
+  filterNameLabel: "Nom du filtre",
+  filterNamePlaceholder: "ex. Dossiers en attente",
+  saveFilter: "Enregistrer",
+  updateFilter: "Mettre à jour",
+  deleteFilter: "Supprimer",
+  deleteFilterConfirm: "Supprimer ce filtre enregistré ?",
+  setAsDefault: "Définir par défaut",
+  defaultBadge: "Par défaut",
+  manageFilters: "Gérer les filtres",
+  noSavedFilters: "Aucun filtre enregistré",
+  cancel: "Annuler"
+});
+export function UserPersonalizationProvider(props) {
+  var children = props.children,
+    userId = props.userId,
+    tenantId = props.tenantId,
+    appId = props.appId,
+    adapter = props.adapter,
+    defaults = props.defaults,
+    labels = props.labels,
+    onError = props.onError,
+    _props$hydrateStrateg = props.hydrateStrategy,
+    hydrateStrategy = _props$hydrateStrateg === void 0 ? "remote-wins" : _props$hydrateStrateg;
+  if (isDev && !userId && typeof console !== "undefined" && console.warn) {
+    // eslint-disable-next-line no-console
+    console.warn("[@portnet/ui v2] UserPersonalizationProvider: `userId` is required to scope personalization. " + "Falling back to 'anonymous' — persisted preferences will be shared across unauthenticated sessions.");
+  }
+  var resolvedUserId = userId || "anonymous";
+  var scope = React.useMemo(function buildScope() {
+    return _objectSpread(_objectSpread({
+      userId: resolvedUserId
+    }, tenantId !== undefined ? {
+      tenantId: tenantId
+    } : {}), appId !== undefined ? {
+      appId: appId
+    } : {});
+  }, [resolvedUserId, tenantId, appId]);
+
+  // Default adapter created once; a provided adapter is trusted to be stable.
+  var defaultAdapterRef = React.useRef(null);
+  if (!adapter && !defaultAdapterRef.current) {
+    defaultAdapterRef.current = createLocalStorageAdapter();
+  }
+  var resolvedAdapter = adapter || defaultAdapterRef.current;
+
+  // One store per (scope, adapter). Intentionally NOT keyed on
+  // defaults/onError/hydrateStrategy: those are fed live below.
+  var store = React.useMemo(function buildStore() {
+    return createPersonalizationStore(_objectSpread(_objectSpread(_objectSpread({
+      scope: scope,
+      adapter: resolvedAdapter
+    }, defaults !== undefined ? {
+      defaults: defaults
+    } : {}), onError !== undefined ? {
+      onError: onError
+    } : {}), {}, {
+      hydrateStrategy: hydrateStrategy
+    }));
+  },
+  // eslint-disable-next-line react-hooks/exhaustive-deps
+  [scope, resolvedAdapter]);
+
+  // Hydrate + cross-tab connect; dispose on store change / unmount.
+  React.useEffect(function lifecycle() {
+    store.hydrate();
+    var off = store.connect();
+    return function teardown() {
+      if (typeof off === "function") off();
+      store.dispose();
+    };
+  }, [store]);
+
+  // Push live runtime options without recreating the store.
+  React.useEffect(function syncRuntime() {
+    store.setRuntime(_objectSpread(_objectSpread({}, onError !== undefined ? {
+      onError: onError
+    } : {}), {}, {
+      hydrateStrategy: hydrateStrategy
+    }));
+  }, [store, onError, hydrateStrategy]);
+
+  // Dev guard: a non-memoised adapter prop would recreate the store each
+  // render and wipe in-memory state. Warn so it's caught early.
+  var prevAdapterRef = React.useRef(resolvedAdapter);
+  React.useEffect(function guardAdapterIdentity() {
+    if (isDev && prevAdapterRef.current !== resolvedAdapter && typeof console !== "undefined" && console.warn) {
+      // eslint-disable-next-line no-console
+      console.warn("[@portnet/ui v2] UserPersonalizationProvider: the `adapter` prop changed identity between " + "renders. Memoise it (useMemo or a module singleton) to avoid re-creating the personalization store.");
+    }
+    prevAdapterRef.current = resolvedAdapter;
+  }, [resolvedAdapter]);
+  var mergedLabels = React.useMemo(function mergeLabels() {
+    return labels ? Object.assign({}, DEFAULT_PERSONALIZATION_LABELS, labels) : DEFAULT_PERSONALIZATION_LABELS;
+  }, [labels]);
+  var configValue = React.useMemo(function buildConfig() {
+    return {
+      scope: scope,
+      labels: mergedLabels
+    };
+  }, [scope, mergedLabels]);
+  return /*#__PURE__*/_jsx(PersonalizationConfigContext.Provider, {
+    value: configValue,
+    children: /*#__PURE__*/_jsx(PersonalizationStoreContext.Provider, {
+      value: store,
+      children: children
+    })
+  });
+}
+export default UserPersonalizationProvider;
+//# sourceMappingURL=PersonalizationProvider.js.map

package/dist/esm/v2/personalization/PersonalizationProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PersonalizationProvider.js","names":["React","PersonalizationConfigContext","PersonalizationStoreContext","createPersonalizationStore","createLocalStorageAdapter","jsx","_jsx","isDev","process","env","DEFAULT_PERSONALIZATION_LABELS","Object","freeze","addFavorite","removeFavorite","favoritesOnly","showAll","favoriteColumnHeader","savedFilters","saveCurrentFilter","filterNameLabel","filterNamePlaceholder","saveFilter","updateFilter","deleteFilter","deleteFilterConfirm","setAsDefault","defaultBadge","manageFilters","noSavedFilters","cancel","UserPersonalizationProvider","props","children","userId","tenantId","appId","adapter","defaults","labels","onError","_props$hydrateStrateg","hydrateStrategy","console","warn","resolvedUserId","scope","useMemo","buildScope","_objectSpread","undefined","defaultAdapterRef","useRef","current","resolvedAdapter","store","buildStore","useEffect","lifecycle","hydrate","off","connect","teardown","dispose","syncRuntime","setRuntime","prevAdapterRef","guardAdapterIdentity","mergedLabels","mergeLabels","assign","configValue","buildConfig","Provider","value"],"sources":["../../../../src/lib/v2/personalization/PersonalizationProvider.tsx"],"sourcesContent":["/**\r\n * UserPersonalizationProvider — Portnet UI v2 · personalization\r\n *\r\n * The single configuration point for per-user personalization. Mount it\r\n * once near the app root; every capability (favorites, saved filters, and\r\n * future slices) reads through the one store it establishes.\r\n *\r\n *   import {\r\n *     UserPersonalizationProvider,\r\n *     createLocalStorageAdapter,\r\n *   } from \"@portnet/ui/v2/personalization\";\r\n *\r\n *   <UserPersonalizationProvider userId={user.id} tenantId={tenant.id}>\r\n *     <App />\r\n *   </UserPersonalizationProvider>\r\n *\r\n * Store lifecycle\r\n *   - Exactly one store per scope. Memoised on (scope, adapter) ONLY;\r\n *     onError / hydrateStrategy are pushed in live via store.setRuntime so\r\n *     inline handlers never recreate the store.\r\n *   - The default localStorage adapter is created once (ref). A PROVIDED\r\n *     adapter must be stable (useMemo/module singleton) — a dev guard warns\r\n *     if its identity changes between renders.\r\n *   - A lifecycle effect runs hydrate() + connect() and dispose()s the old\r\n *     store on scope change / unmount (cross-tab listener torn down).\r\n *\r\n * React 18/19 compatible: no 19-only API is required.\r\n */\r\n\r\nimport * as React from \"react\";\r\n\r\nimport {\r\n  PersonalizationConfigContext,\r\n  PersonalizationStoreContext,\r\n} from \"./personalizationContext\";\r\nimport type {\r\n  PersonalizationConfig,\r\n  PersonalizationLabels,\r\n} from \"./personalizationContext\";\r\nimport createPersonalizationStore from \"./createPersonalizationStore\";\r\nimport type { PersonalizationErrorHandler } from \"./createPersonalizationStore\";\r\nimport createLocalStorageAdapter from \"./adapters/createLocalStorageAdapter\";\r\nimport type { Adapter, HydrateStrategy, Scope } from \"./types\";\r\n\r\nconst isDev =\r\n  typeof process !== \"undefined\" &&\r\n  process.env &&\r\n  process.env[\"NODE_ENV\"] !== \"production\";\r\n\r\n/**\r\n * Default labels for the whole foundation (FR — charter default). Hosts\r\n * override any subset via the `labels` prop; EN/AR overrides supported.\r\n * Front-loaded here so the favorites (Batch 3) and saved-filters (Batch 4)\r\n * components read consistent copy from one place.\r\n */\r\nexport const DEFAULT_PERSONALIZATION_LABELS = Object.freeze({\r\n  // Follow / \"suivis\" (Batch 3)\r\n  addFavorite: \"Suivre\",\r\n  removeFavorite: \"Ne plus suivre\",\r\n  favoritesOnly: \"Suivis uniquement\",\r\n  showAll: \"Tout afficher\",\r\n  favoriteColumnHeader: \"Suivis\",\r\n  // Saved filters (Batch 4)\r\n  savedFilters: \"Filtres enregistrés\",\r\n  saveCurrentFilter: \"Enregistrer le filtre actuel…\",\r\n  filterNameLabel: \"Nom du filtre\",\r\n  filterNamePlaceholder: \"ex. Dossiers en attente\",\r\n  saveFilter: \"Enregistrer\",\r\n  updateFilter: \"Mettre à jour\",\r\n  deleteFilter: \"Supprimer\",\r\n  deleteFilterConfirm: \"Supprimer ce filtre enregistré ?\",\r\n  setAsDefault: \"Définir par défaut\",\r\n  defaultBadge: \"Par défaut\",\r\n  manageFilters: \"Gérer les filtres\",\r\n  noSavedFilters: \"Aucun filtre enregistré\",\r\n  cancel: \"Annuler\",\r\n} satisfies PersonalizationLabels);\r\n\r\nexport interface UserPersonalizationProviderProps {\r\n  children?: React.ReactNode | undefined;\r\n  /** Required (in practice) — scopes all persisted preferences to this user. */\r\n  userId?: string | undefined;\r\n  /** Optional multi-tenant partition. */\r\n  tenantId?: string | undefined;\r\n  /** Optional per-app partition. */\r\n  appId?: string | undefined;\r\n  /** Persistence boundary. Defaults to createLocalStorageAdapter(). Must be stable. */\r\n  adapter?: Adapter | undefined;\r\n  /** Per-capability seed overrides, e.g. { favorites: {}, savedFilters: {} }. */\r\n  defaults?: Record<string, unknown> | undefined;\r\n  /** Label overrides (FR default; EN/AR supported). */\r\n  labels?: Partial<PersonalizationLabels> | undefined;\r\n  /** Central persistence-error hook: (error, { scope, capabilityId }) => void. */\r\n  onError?: PersonalizationErrorHandler | undefined;\r\n  /** Reconciliation policy between optimistic local state and adapter truth. @default \"remote-wins\" */\r\n  hydrateStrategy?: HydrateStrategy | undefined;\r\n}\r\n\r\nexport function UserPersonalizationProvider(\r\n  props: UserPersonalizationProviderProps\r\n): React.JSX.Element {\r\n  const {\r\n    children,\r\n    userId,\r\n    tenantId,\r\n    appId,\r\n    adapter,\r\n    defaults,\r\n    labels,\r\n    onError,\r\n    hydrateStrategy = \"remote-wins\",\r\n  } = props;\r\n\r\n  if (isDev && !userId && typeof console !== \"undefined\" && console.warn) {\r\n    // eslint-disable-next-line no-console\r\n    console.warn(\r\n      \"[@portnet/ui v2] UserPersonalizationProvider: `userId` is required to scope personalization. \" +\r\n        \"Falling back to 'anonymous' — persisted preferences will be shared across unauthenticated sessions.\"\r\n    );\r\n  }\r\n  const resolvedUserId = userId || \"anonymous\";\r\n\r\n  const scope = React.useMemo<Scope>(\r\n    function buildScope() {\r\n      return {\r\n        userId: resolvedUserId,\r\n        ...(tenantId !== undefined ? { tenantId } : {}),\r\n        ...(appId !== undefined ? { appId } : {}),\r\n      };\r\n    },\r\n    [resolvedUserId, tenantId, appId]\r\n  );\r\n\r\n  // Default adapter created once; a provided adapter is trusted to be stable.\r\n  const defaultAdapterRef = React.useRef<Adapter | null>(null);\r\n  if (!adapter && !defaultAdapterRef.current) {\r\n    defaultAdapterRef.current = createLocalStorageAdapter();\r\n  }\r\n  const resolvedAdapter = adapter || defaultAdapterRef.current;\r\n\r\n  // One store per (scope, adapter). Intentionally NOT keyed on\r\n  // defaults/onError/hydrateStrategy: those are fed live below.\r\n  const store = React.useMemo(\r\n    function buildStore() {\r\n      return createPersonalizationStore({\r\n        scope: scope,\r\n        adapter: resolvedAdapter,\r\n        ...(defaults !== undefined ? { defaults } : {}),\r\n        ...(onError !== undefined ? { onError } : {}),\r\n        hydrateStrategy: hydrateStrategy,\r\n      });\r\n    },\r\n    // eslint-disable-next-line react-hooks/exhaustive-deps\r\n    [scope, resolvedAdapter]\r\n  );\r\n\r\n  // Hydrate + cross-tab connect; dispose on store change / unmount.\r\n  React.useEffect(\r\n    function lifecycle() {\r\n      store.hydrate();\r\n      const off = store.connect();\r\n      return function teardown() {\r\n        if (typeof off === \"function\") off();\r\n        store.dispose();\r\n      };\r\n    },\r\n    [store]\r\n  );\r\n\r\n  // Push live runtime options without recreating the store.\r\n  React.useEffect(\r\n    function syncRuntime() {\r\n      store.setRuntime({\r\n        ...(onError !== undefined ? { onError } : {}),\r\n        hydrateStrategy: hydrateStrategy,\r\n      });\r\n    },\r\n    [store, onError, hydrateStrategy]\r\n  );\r\n\r\n  // Dev guard: a non-memoised adapter prop would recreate the store each\r\n  // render and wipe in-memory state. Warn so it's caught early.\r\n  const prevAdapterRef = React.useRef<Adapter | null>(resolvedAdapter);\r\n  React.useEffect(\r\n    function guardAdapterIdentity() {\r\n      if (\r\n        isDev &&\r\n        prevAdapterRef.current !== resolvedAdapter &&\r\n        typeof console !== \"undefined\" &&\r\n        console.warn\r\n      ) {\r\n        // eslint-disable-next-line no-console\r\n        console.warn(\r\n          \"[@portnet/ui v2] UserPersonalizationProvider: the `adapter` prop changed identity between \" +\r\n            \"renders. Memoise it (useMemo or a module singleton) to avoid re-creating the personalization store.\"\r\n        );\r\n      }\r\n      prevAdapterRef.current = resolvedAdapter;\r\n    },\r\n    [resolvedAdapter]\r\n  );\r\n\r\n  const mergedLabels = React.useMemo<PersonalizationLabels>(\r\n    function mergeLabels() {\r\n      return labels\r\n        ? Object.assign({}, DEFAULT_PERSONALIZATION_LABELS, labels)\r\n        : DEFAULT_PERSONALIZATION_LABELS;\r\n    },\r\n    [labels]\r\n  );\r\n\r\n  const configValue = React.useMemo<PersonalizationConfig>(\r\n    function buildConfig() {\r\n      return { scope: scope, labels: mergedLabels };\r\n    },\r\n    [scope, mergedLabels]\r\n  );\r\n\r\n  return (\r\n    <PersonalizationConfigContext.Provider value={configValue}>\r\n      <PersonalizationStoreContext.Provider value={store}>\r\n        {children}\r\n      </PersonalizationStoreContext.Provider>\r\n    </PersonalizationConfigContext.Provider>\r\n  );\r\n}\r\n\r\nexport default UserPersonalizationProvider;\r\n"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,60 @@
+/**
+ * _storageKey — Portnet UI v2 · personalization adapters (private)
+ *
+ * Composite key scheme shared by storage adapters:
+ *
+ *     portnet-ui:perso:v1:{tenantId?}:{userId}:{capabilityId}
+ *
+ * Design notes
+ *   - `resourceKey` is NOT in the key — it lives inside the capability
+ *     payload. One storage entry per (scope, capability) → cheap prefix scan
+ *     on load, one removeItem to clear.
+ *   - Scope segments (tenantId, userId) are encodeURIComponent-escaped so
+ *     arbitrary host identifiers — including ones containing ':' — remain
+ *     unambiguous. `capabilityId` is a controlled slug and is left raw so
+ *     `buildScopePrefix` + `slice()` recover it directly.
+ *   - `:v1:` is the KEY-SCHEME version (storage layout), independent of a
+ *     capability payload's `schemaVersion`.
+ *
+ * Underscore-prefixed: internal, never re-exported from the public surface.
+ */
+
+import { KEY_SCHEME_VERSION } from "../schema";
+export var KEY_PREFIX = "portnet-ui:perso";
+function enc(value) {
+  return encodeURIComponent(String(value == null ? "" : value));
+}
+
+/** Full storage key for one (scope, capability). */
+export function buildKey(scope, capabilityId) {
+  var parts = [KEY_PREFIX, KEY_SCHEME_VERSION];
+  if (scope && scope.tenantId) parts.push(enc(scope.tenantId));
+  parts.push(enc(scope ? scope.userId : ""));
+  parts.push(capabilityId);
+  return parts.join(":");
+}
+
+/**
+ * Prefix shared by every capability key of a scope — terminated by ':' so the
+ * capability segment follows immediately.
+ */
+export function buildScopePrefix(scope) {
+  var parts = [KEY_PREFIX, KEY_SCHEME_VERSION];
+  if (scope && scope.tenantId) parts.push(enc(scope.tenantId));
+  parts.push(enc(scope ? scope.userId : ""));
+  parts.push(""); // trailing ':' after join
+  return parts.join(":");
+}
+
+/**
+ * Recover the capabilityId from a storage key for a given scope, or null when
+ * the key does not belong to this scope.
+ */
+export function parseCapabilityFromKey(key, scope) {
+  if (typeof key !== "string") return null;
+  var prefix = buildScopePrefix(scope);
+  if (key.indexOf(prefix) !== 0) return null;
+  var capId = key.slice(prefix.length);
+  return capId || null;
+}
+//# sourceMappingURL=_storageKey.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_storageKey.js","names":["KEY_SCHEME_VERSION","KEY_PREFIX","enc","value","encodeURIComponent","String","buildKey","scope","capabilityId","parts","tenantId","push","userId","join","buildScopePrefix","parseCapabilityFromKey","key","prefix","indexOf","capId","slice","length"],"sources":["../../../../../src/lib/v2/personalization/adapters/_storageKey.ts"],"sourcesContent":["/**\r\n * _storageKey — Portnet UI v2 · personalization adapters (private)\r\n *\r\n * Composite key scheme shared by storage adapters:\r\n *\r\n *     portnet-ui:perso:v1:{tenantId?}:{userId}:{capabilityId}\r\n *\r\n * Design notes\r\n *   - `resourceKey` is NOT in the key — it lives inside the capability\r\n *     payload. One storage entry per (scope, capability) → cheap prefix scan\r\n *     on load, one removeItem to clear.\r\n *   - Scope segments (tenantId, userId) are encodeURIComponent-escaped so\r\n *     arbitrary host identifiers — including ones containing ':' — remain\r\n *     unambiguous. `capabilityId` is a controlled slug and is left raw so\r\n *     `buildScopePrefix` + `slice()` recover it directly.\r\n *   - `:v1:` is the KEY-SCHEME version (storage layout), independent of a\r\n *     capability payload's `schemaVersion`.\r\n *\r\n * Underscore-prefixed: internal, never re-exported from the public surface.\r\n */\r\n\r\nimport { KEY_SCHEME_VERSION } from \"../schema\";\r\nimport type { Scope } from \"../types\";\r\n\r\nexport const KEY_PREFIX = \"portnet-ui:perso\";\r\n\r\nfunction enc(value: string | undefined): string {\r\n  return encodeURIComponent(String(value == null ? \"\" : value));\r\n}\r\n\r\n/** Full storage key for one (scope, capability). */\r\nexport function buildKey(scope: Scope, capabilityId: string): string {\r\n  const parts = [KEY_PREFIX, KEY_SCHEME_VERSION];\r\n  if (scope && scope.tenantId) parts.push(enc(scope.tenantId));\r\n  parts.push(enc(scope ? scope.userId : \"\"));\r\n  parts.push(capabilityId);\r\n  return parts.join(\":\");\r\n}\r\n\r\n/**\r\n * Prefix shared by every capability key of a scope — terminated by ':' so the\r\n * capability segment follows immediately.\r\n */\r\nexport function buildScopePrefix(scope: Scope): string {\r\n  const parts = [KEY_PREFIX, KEY_SCHEME_VERSION];\r\n  if (scope && scope.tenantId) parts.push(enc(scope.tenantId));\r\n  parts.push(enc(scope ? scope.userId : \"\"));\r\n  parts.push(\"\"); // trailing ':' after join\r\n  return parts.join(\":\");\r\n}\r\n\r\n/**\r\n * Recover the capabilityId from a storage key for a given scope, or null when\r\n * the key does not belong to this scope.\r\n */\r\nexport function parseCapabilityFromKey(\r\n  key: string,\r\n  scope: Scope\r\n): string | null {\r\n  if (typeof key !== \"string\") return null;\r\n  const prefix = buildScopePrefix(scope);\r\n  if (key.indexOf(prefix) !== 0) return null;\r\n  const capId = key.slice(prefix.length);\r\n  return capId || null;\r\n}\r\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,kBAAkB,QAAQ,WAAW;AAG9C,OAAO,IAAMC,UAAU,GAAG,kBAAkB;AAE5C,SAASC,GAAGA,CAACC,KAAyB,EAAU;EAC9C,OAAOC,kBAAkB,CAACC,MAAM,CAACF,KAAK,IAAI,IAAI,GAAG,EAAE,GAAGA,KAAK,CAAC,CAAC;AAC/D;;AAEA;AACA,OAAO,SAASG,QAAQA,CAACC,KAAY,EAAEC,YAAoB,EAAU;EACnE,IAAMC,KAAK,GAAG,CAACR,UAAU,EAAED,kBAAkB,CAAC;EAC9C,IAAIO,KAAK,IAAIA,KAAK,CAACG,QAAQ,EAAED,KAAK,CAACE,IAAI,CAACT,GAAG,CAACK,KAAK,CAACG,QAAQ,CAAC,CAAC;EAC5DD,KAAK,CAACE,IAAI,CAACT,GAAG,CAACK,KAAK,GAAGA,KAAK,CAACK,MAAM,GAAG,EAAE,CAAC,CAAC;EAC1CH,KAAK,CAACE,IAAI,CAACH,YAAY,CAAC;EACxB,OAAOC,KAAK,CAACI,IAAI,CAAC,GAAG,CAAC;AACxB;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAACP,KAAY,EAAU;EACrD,IAAME,KAAK,GAAG,CAACR,UAAU,EAAED,kBAAkB,CAAC;EAC9C,IAAIO,KAAK,IAAIA,KAAK,CAACG,QAAQ,EAAED,KAAK,CAACE,IAAI,CAACT,GAAG,CAACK,KAAK,CAACG,QAAQ,CAAC,CAAC;EAC5DD,KAAK,CAACE,IAAI,CAACT,GAAG,CAACK,KAAK,GAAGA,KAAK,CAACK,MAAM,GAAG,EAAE,CAAC,CAAC;EAC1CH,KAAK,CAACE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;EAChB,OAAOF,KAAK,CAACI,IAAI,CAAC,GAAG,CAAC;AACxB;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASE,sBAAsBA,CACpCC,GAAW,EACXT,KAAY,EACG;EACf,IAAI,OAAOS,GAAG,KAAK,QAAQ,EAAE,OAAO,IAAI;EACxC,IAAMC,MAAM,GAAGH,gBAAgB,CAACP,KAAK,CAAC;EACtC,IAAIS,GAAG,CAACE,OAAO,CAACD,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,IAAI;EAC1C,IAAME,KAAK,GAAGH,GAAG,CAACI,KAAK,CAACH,MAAM,CAACI,MAAM,CAAC;EACtC,OAAOF,KAAK,IAAI,IAAI;AACtB","ignoreList":[]}

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