@portnet/ui 5.0.27 → 6.0.0

package/dist/v2/patterns/index.js

@@ -0,0 +1,246 @@
+"use strict";
+
+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); }
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "ActionBar", {
+  enumerable: true,
+  get: function get() {
+    return _ActionBar["default"];
+  }
+});
+Object.defineProperty(exports, "BulkActionBar", {
+  enumerable: true,
+  get: function get() {
+    return _BulkActionBar["default"];
+  }
+});
+Object.defineProperty(exports, "CollapsibleDataGrid", {
+  enumerable: true,
+  get: function get() {
+    return _CollapsibleDataGrid["default"];
+  }
+});
+Object.defineProperty(exports, "ColumnsToggle", {
+  enumerable: true,
+  get: function get() {
+    return _ColumnsToggle["default"];
+  }
+});
+Object.defineProperty(exports, "DataGrid", {
+  enumerable: true,
+  get: function get() {
+    return _DataGrid["default"];
+  }
+});
+Object.defineProperty(exports, "DataGridSettingsMenu", {
+  enumerable: true,
+  get: function get() {
+    return _DataGridSettingsMenu["default"];
+  }
+});
+Object.defineProperty(exports, "DataGridToolbar", {
+  enumerable: true,
+  get: function get() {
+    return _DataGridToolbar["default"];
+  }
+});
+Object.defineProperty(exports, "DataGridVirtualized", {
+  enumerable: true,
+  get: function get() {
+    return _DataGridVirtualized["default"];
+  }
+});
+Object.defineProperty(exports, "DeleteResourceConfirmDialog", {
+  enumerable: true,
+  get: function get() {
+    return _DeleteResourceConfirmDialog["default"];
+  }
+});
+Object.defineProperty(exports, "FavoritesFilter", {
+  enumerable: true,
+  get: function get() {
+    return _FavoritesFilter["default"];
+  }
+});
+Object.defineProperty(exports, "FormErrorSummary", {
+  enumerable: true,
+  get: function get() {
+    return _FormErrorSummary["default"];
+  }
+});
+Object.defineProperty(exports, "FormPageShell", {
+  enumerable: true,
+  get: function get() {
+    return _FormPageShell["default"];
+  }
+});
+Object.defineProperty(exports, "FormSection", {
+  enumerable: true,
+  get: function get() {
+    return _FormSection["default"];
+  }
+});
+Object.defineProperty(exports, "FormikCheckboxGroup", {
+  enumerable: true,
+  get: function get() {
+    return _FormikCheckboxGroup["default"];
+  }
+});
+Object.defineProperty(exports, "FormikCombobox", {
+  enumerable: true,
+  get: function get() {
+    return _FormikCombobox["default"];
+  }
+});
+Object.defineProperty(exports, "FormikDatePicker", {
+  enumerable: true,
+  get: function get() {
+    return _FormikDatePicker["default"];
+  }
+});
+Object.defineProperty(exports, "FormikDisplay", {
+  enumerable: true,
+  get: function get() {
+    return _FormikDisplay["default"];
+  }
+});
+Object.defineProperty(exports, "FormikErrorFocus", {
+  enumerable: true,
+  get: function get() {
+    return _FormikErrorFocus["default"];
+  }
+});
+Object.defineProperty(exports, "FormikFile", {
+  enumerable: true,
+  get: function get() {
+    return _FormikFile["default"];
+  }
+});
+Object.defineProperty(exports, "FormikInput", {
+  enumerable: true,
+  get: function get() {
+    return _FormikInput["default"];
+  }
+});
+Object.defineProperty(exports, "FormikReferentielField", {
+  enumerable: true,
+  get: function get() {
+    return _FormikReferentielField["default"];
+  }
+});
+Object.defineProperty(exports, "FormikSelect", {
+  enumerable: true,
+  get: function get() {
+    return _FormikSelect["default"];
+  }
+});
+Object.defineProperty(exports, "FormikTextarea", {
+  enumerable: true,
+  get: function get() {
+    return _FormikTextarea["default"];
+  }
+});
+Object.defineProperty(exports, "KeyboardShortcutsHelp", {
+  enumerable: true,
+  get: function get() {
+    return _KeyboardShortcutsHelp["default"];
+  }
+});
+Object.defineProperty(exports, "NetworkErrorBanner", {
+  enumerable: true,
+  get: function get() {
+    return _NetworkErrorBanner["default"];
+  }
+});
+Object.defineProperty(exports, "PageContent", {
+  enumerable: true,
+  get: function get() {
+    return _PageContent["default"];
+  }
+});
+Object.defineProperty(exports, "ReferentielField", {
+  enumerable: true,
+  get: function get() {
+    return _ReferentielField["default"];
+  }
+});
+Object.defineProperty(exports, "SaveFilterDialog", {
+  enumerable: true,
+  get: function get() {
+    return _SaveFilterDialog["default"];
+  }
+});
+Object.defineProperty(exports, "SavedFiltersMenu", {
+  enumerable: true,
+  get: function get() {
+    return _SavedFiltersMenu["default"];
+  }
+});
+Object.defineProperty(exports, "SortableHeader", {
+  enumerable: true,
+  get: function get() {
+    return _SortableHeader["default"];
+  }
+});
+Object.defineProperty(exports, "Tour", {
+  enumerable: true,
+  get: function get() {
+    return _Tour["default"];
+  }
+});
+Object.defineProperty(exports, "applySort", {
+  enumerable: true,
+  get: function get() {
+    return _DataGrid.applySort;
+  }
+});
+Object.defineProperty(exports, "getAriaSort", {
+  enumerable: true,
+  get: function get() {
+    return _SortableHeader.getAriaSort;
+  }
+});
+Object.defineProperty(exports, "makeFavoriteColumn", {
+  enumerable: true,
+  get: function get() {
+    return _FavoriteColumn["default"];
+  }
+});
+var _ActionBar = _interopRequireDefault(require("./ActionBar"));
+var _BulkActionBar = _interopRequireDefault(require("./BulkActionBar"));
+var _ColumnsToggle = _interopRequireDefault(require("./ColumnsToggle"));
+var _FormSection = _interopRequireDefault(require("./FormSection"));
+var _FormPageShell = _interopRequireDefault(require("./FormPageShell"));
+var _FormErrorSummary = _interopRequireDefault(require("./FormErrorSummary"));
+var _FormikErrorFocus = _interopRequireDefault(require("./FormikErrorFocus"));
+var _PageContent = _interopRequireDefault(require("./PageContent"));
+var _DataGrid = _interopRequireWildcard(require("./DataGrid"));
+var _DataGridVirtualized = _interopRequireDefault(require("./DataGridVirtualized"));
+var _DataGridSettingsMenu = _interopRequireDefault(require("./DataGridSettingsMenu"));
+var _DataGridToolbar = _interopRequireDefault(require("./DataGridToolbar"));
+var _CollapsibleDataGrid = _interopRequireDefault(require("./CollapsibleDataGrid"));
+var _SortableHeader = _interopRequireWildcard(require("./SortableHeader"));
+var _NetworkErrorBanner = _interopRequireDefault(require("./NetworkErrorBanner"));
+var _ReferentielField = _interopRequireDefault(require("./ReferentielField"));
+var _Tour = _interopRequireDefault(require("./Tour"));
+var _KeyboardShortcutsHelp = _interopRequireDefault(require("./KeyboardShortcutsHelp"));
+var _DeleteResourceConfirmDialog = _interopRequireDefault(require("./DeleteResourceConfirmDialog"));
+var _SaveFilterDialog = _interopRequireDefault(require("./SaveFilterDialog"));
+var _SavedFiltersMenu = _interopRequireDefault(require("./SavedFiltersMenu"));
+var _FavoriteColumn = _interopRequireDefault(require("./FavoriteColumn"));
+var _FavoritesFilter = _interopRequireDefault(require("./FavoritesFilter"));
+var _FormikInput = _interopRequireDefault(require("./FormikInput"));
+var _FormikTextarea = _interopRequireDefault(require("./FormikTextarea"));
+var _FormikSelect = _interopRequireDefault(require("./FormikSelect"));
+var _FormikCombobox = _interopRequireDefault(require("./FormikCombobox"));
+var _FormikDatePicker = _interopRequireDefault(require("./FormikDatePicker"));
+var _FormikFile = _interopRequireDefault(require("./FormikFile"));
+var _FormikCheckboxGroup = _interopRequireDefault(require("./FormikCheckboxGroup"));
+var _FormikReferentielField = _interopRequireDefault(require("./FormikReferentielField"));
+var _FormikDisplay = _interopRequireDefault(require("../components/FormikDisplay"));
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { "default": obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj["default"] = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["_ActionBar","_interopRequireDefault","require","_BulkActionBar","_ColumnsToggle","_FormSection","_FormPageShell","_FormErrorSummary","_FormikErrorFocus","_PageContent","_DataGrid","_interopRequireWildcard","_DataGridVirtualized","_DataGridSettingsMenu","_DataGridToolbar","_CollapsibleDataGrid","_SortableHeader","_NetworkErrorBanner","_ReferentielField","_Tour","_KeyboardShortcutsHelp","_DeleteResourceConfirmDialog","_SaveFilterDialog","_SavedFiltersMenu","_FavoriteColumn","_FavoritesFilter","_FormikInput","_FormikTextarea","_FormikSelect","_FormikCombobox","_FormikDatePicker","_FormikFile","_FormikCheckboxGroup","_FormikReferentielField","_FormikDisplay","_getRequireWildcardCache","nodeInterop","WeakMap","cacheBabelInterop","cacheNodeInterop","obj","__esModule","_typeof","cache","has","get","newObj","hasPropertyDescriptor","Object","defineProperty","getOwnPropertyDescriptor","key","prototype","hasOwnProperty","call","desc","set"],"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\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":"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","ignoreList":[]}

package/dist/v2/personalization/PersonalizationProvider.d.ts

@@ -0,0 +1,80 @@
+/**
+ * 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 type { PersonalizationLabels } from "./personalizationContext";
+import type { PersonalizationErrorHandler } from "./createPersonalizationStore";
+import type { Adapter, HydrateStrategy } from "./types";
+/**
+ * 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 declare const DEFAULT_PERSONALIZATION_LABELS: Readonly<{
+    addFavorite: string;
+    removeFavorite: string;
+    favoritesOnly: string;
+    showAll: string;
+    favoriteColumnHeader: string;
+    savedFilters: string;
+    saveCurrentFilter: string;
+    filterNameLabel: string;
+    filterNamePlaceholder: string;
+    saveFilter: string;
+    updateFilter: string;
+    deleteFilter: string;
+    deleteFilterConfirm: string;
+    setAsDefault: string;
+    defaultBadge: string;
+    manageFilters: string;
+    noSavedFilters: string;
+    cancel: string;
+}>;
+export interface UserPersonalizationProviderProps {
+    children?: React.ReactNode;
+    /** Required (in practice) — scopes all persisted preferences to this user. */
+    userId?: string;
+    /** Optional multi-tenant partition. */
+    tenantId?: string;
+    /** Optional per-app partition. */
+    appId?: string;
+    /** Persistence boundary. Defaults to createLocalStorageAdapter(). Must be stable. */
+    adapter?: Adapter;
+    /** Per-capability seed overrides, e.g. { favorites: {}, savedFilters: {} }. */
+    defaults?: Record<string, unknown>;
+    /** Label overrides (FR default; EN/AR supported). */
+    labels?: Partial<PersonalizationLabels>;
+    /** Central persistence-error hook: (error, { scope, capabilityId }) => void. */
+    onError?: PersonalizationErrorHandler;
+    /** Reconciliation policy between optimistic local state and adapter truth. @default "remote-wins" */
+    hydrateStrategy?: HydrateStrategy;
+}
+export declare function UserPersonalizationProvider(props: UserPersonalizationProviderProps): React.JSX.Element;
+export default UserPersonalizationProvider;
+//# sourceMappingURL=PersonalizationProvider.d.ts.map

package/dist/v2/personalization/PersonalizationProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PersonalizationProvider.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/personalization/PersonalizationProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAM/B,OAAO,KAAK,EAEV,qBAAqB,EACtB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAEhF,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAS,MAAM,SAAS,CAAC;AAO/D;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;EAqBT,CAAC;AAEnC,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,qDAAqD;IACrD,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACxC,gFAAgF;IAChF,OAAO,CAAC,EAAE,2BAA2B,CAAC;IACtC,qGAAqG;IACrG,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,gCAAgC,GACtC,KAAK,CAAC,GAAG,CAAC,OAAO,CA6HnB;AAED,eAAe,2BAA2B,CAAC"}

package/dist/v2/personalization/PersonalizationProvider.js

@@ -0,0 +1,177 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.DEFAULT_PERSONALIZATION_LABELS = void 0;
+exports.UserPersonalizationProvider = UserPersonalizationProvider;
+exports["default"] = void 0;
+var React = _interopRequireWildcard(require("react"));
+var _personalizationContext = require("./personalizationContext");
+var _createPersonalizationStore = _interopRequireDefault(require("./createPersonalizationStore"));
+var _createLocalStorageAdapter = _interopRequireDefault(require("./adapters/createLocalStorageAdapter"));
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { "default": obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj["default"] = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+function _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.
+ */
+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.
+ */
+var DEFAULT_PERSONALIZATION_LABELS = exports.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"
+});
+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 = (0, _createLocalStorageAdapter["default"])();
+  }
+  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 (0, _createPersonalizationStore["default"])(_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__*/(0, _jsxRuntime.jsx)(_personalizationContext.PersonalizationConfigContext.Provider, {
+    value: configValue,
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_personalizationContext.PersonalizationStoreContext.Provider, {
+      value: store,
+      children: children
+    })
+  });
+}
+var _default = exports["default"] = UserPersonalizationProvider;
+//# sourceMappingURL=PersonalizationProvider.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PersonalizationProvider.js","names":["React","_interopRequireWildcard","require","_personalizationContext","_createPersonalizationStore","_interopRequireDefault","_createLocalStorageAdapter","_jsxRuntime","obj","__esModule","_getRequireWildcardCache","nodeInterop","WeakMap","cacheBabelInterop","cacheNodeInterop","_typeof","cache","has","get","newObj","hasPropertyDescriptor","Object","defineProperty","getOwnPropertyDescriptor","key","prototype","hasOwnProperty","call","desc","set","Symbol","iterator","constructor","ownKeys","object","enumerableOnly","keys","getOwnPropertySymbols","symbols","filter","sym","enumerable","push","apply","_objectSpread","target","i","arguments","length","source","forEach","_defineProperty","getOwnPropertyDescriptors","defineProperties","value","_toPropertyKey","configurable","writable","arg","_toPrimitive","String","input","hint","prim","toPrimitive","undefined","res","TypeError","Number","isDev","process","env","DEFAULT_PERSONALIZATION_LABELS","exports","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","defaultAdapterRef","useRef","current","createLocalStorageAdapter","resolvedAdapter","store","buildStore","createPersonalizationStore","useEffect","lifecycle","hydrate","off","connect","teardown","dispose","syncRuntime","setRuntime","prevAdapterRef","guardAdapterIdentity","mergedLabels","mergeLabels","assign","configValue","buildConfig","jsx","PersonalizationConfigContext","Provider","PersonalizationStoreContext","_default"],"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;\r\n  /** Required (in practice) — scopes all persisted preferences to this user. */\r\n  userId?: string;\r\n  /** Optional multi-tenant partition. */\r\n  tenantId?: string;\r\n  /** Optional per-app partition. */\r\n  appId?: string;\r\n  /** Persistence boundary. Defaults to createLocalStorageAdapter(). Must be stable. */\r\n  adapter?: Adapter;\r\n  /** Per-capability seed overrides, e.g. { favorites: {}, savedFilters: {} }. */\r\n  defaults?: Record<string, unknown>;\r\n  /** Label overrides (FR default; EN/AR supported). */\r\n  labels?: Partial<PersonalizationLabels>;\r\n  /** Central persistence-error hook: (error, { scope, capabilityId }) => void. */\r\n  onError?: PersonalizationErrorHandler;\r\n  /** Reconciliation policy between optimistic local state and adapter truth. @default \"remote-wins\" */\r\n  hydrateStrategy?: HydrateStrategy;\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/v2/personalization/adapters/_storageKey.d.ts

@@ -0,0 +1,35 @@
+/**
+ * _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 type { Scope } from "../types";
+export declare const KEY_PREFIX = "portnet-ui:perso";
+/** Full storage key for one (scope, capability). */
+export declare function buildKey(scope: Scope, capabilityId: string): string;
+/**
+ * Prefix shared by every capability key of a scope — terminated by ':' so the
+ * capability segment follows immediately.
+ */
+export declare function buildScopePrefix(scope: Scope): string;
+/**
+ * Recover the capabilityId from a storage key for a given scope, or null when
+ * the key does not belong to this scope.
+ */
+export declare function parseCapabilityFromKey(key: string, scope: Scope): string | null;
+//# sourceMappingURL=_storageKey.d.ts.map

package/dist/v2/personalization/adapters/_storageKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_storageKey.d.ts","sourceRoot":"","sources":["../../../../src/lib/v2/personalization/adapters/_storageKey.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtC,eAAO,MAAM,UAAU,qBAAqB,CAAC;AAM7C,oDAAoD;AACpD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAMnE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAMrD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,KAAK,GACX,MAAM,GAAG,IAAI,CAMf"}