@portnet/ui 6.0.2 → 6.0.3

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["default","UserPersonalizationProvider","createLocalStorageAdapter","createMemoryAdapter","registerCapability","makeEnvelope","useFavorites","useIsFavorite","FAVORITES_CAPABILITY_ID","useFavoritesView","filterRowsByFavorites","sortRowsByFavorites","FAVORITES_FILTER","FAVORITES_SORT","FavoriteToggle","useSavedFilters","SAVED_FILTERS_CAPABILITY_ID","useGridPreferences","GRID_PREFERENCES_CAPABILITY_ID"],"sources":["../../../../src/lib/v2/personalization/index.ts"],"sourcesContent":["/**\r\n * @portnet/ui · v2 · User Personalization Foundation\r\n * Public surface.\r\n *\r\n * Import via the dedicated subpath:\r\n *   import {\r\n *     UserPersonalizationProvider,\r\n *     useFavorites,\r\n *     useFavoritesView,\r\n *     useSavedFilters,\r\n *     FavoriteToggle,\r\n *   } from \"@portnet/ui/v2/personalization\";\r\n *\r\n * Surface is intentionally minimal (architecture doc §2.8 — minimum API\r\n * surface). The store handle and the internal selector primitive are NOT\r\n * exported; hosts interact through the provider, the capability hooks,\r\n * and the capability components.\r\n *\r\n * The grid-bound composites — SaveFilterDialog / SavedFiltersMenu (saved\r\n * filters) and makeFavoriteColumn / FavoritesFilter (favorites) — are\r\n * exposed via @portnet/ui/v2 (patterns/), not re-exported here, so the\r\n * personalization barrel never imports from patterns/.\r\n */\r\n\r\n/* Provider — the single configuration point. */\r\nexport { default as UserPersonalizationProvider } from \"./PersonalizationProvider\";\r\n\r\n/* Built-in storage adapters (a remote adapter will join them, swap-in). */\r\nexport { default as createLocalStorageAdapter } from \"./adapters/createLocalStorageAdapter\";\r\nexport { default as createMemoryAdapter } from \"./adapters/createMemoryAdapter\";\r\n\r\n/* Capability registration seam — for custom/host-defined capabilities. */\r\nexport { registerCapability, makeEnvelope } from \"./schema\";\r\n\r\n/* Canonical domain types — the TS contract that replaced the runtime\r\n * PropTypes shapes (Scope / Adapter / FavoriteRef / SavedFilter). Type-only:\r\n * erased from the runtime bundle. */\r\nexport type { Scope, Adapter, FavoriteRef, SavedFilter } from \"./types\";\r\n\r\n/* Favorites capability (Batch 3) + view logic (Batch 5). */\r\nexport { useFavorites, useIsFavorite, FAVORITES_CAPABILITY_ID } from \"./capabilities/favorites\";\r\nexport {\r\n  useFavoritesView,\r\n  filterRowsByFavorites,\r\n  sortRowsByFavorites,\r\n  FAVORITES_FILTER,\r\n  FAVORITES_SORT,\r\n} from \"./capabilities/favoritesView\";\r\nexport { default as FavoriteToggle } from \"../components/FavoriteToggle\";\r\n\r\n/* Saved filters capability (Batch 4). Composites in v2 patterns/. */\r\nexport { useSavedFilters, SAVED_FILTERS_CAPABILITY_ID } from \"./capabilities/savedFilters\";\r\n\r\n/**\r\n * Grid preferences capability (gap G-35) — per-user, per-resource hidden\r\n * columns.\r\n *\r\n * `DataGridToolbar` owns the column-visibility UI but holds no state, so every\r\n * host persisted the choice itself in a bare `localStorage` key, which is NOT\r\n * user-scoped — unlike this foundation's `…:{userId}:{capabilityId}` scheme.\r\n * On a shared workstation one user inherited another's hidden columns.\r\n *\r\n * A host could not fix it: `registerCapability` is exported below as a seam\r\n * \"for custom/host-defined capabilities\", but `usePersonalizationStore` and\r\n * `useStoreSelector` are deliberately private (§2.8, minimum API surface), so\r\n * a registered capability had no way to be read or written. The seam is\r\n * advertised without being complete; until that is resolved, a new capability\r\n * has to ship here.\r\n */\r\nexport {\r\n  useGridPreferences,\r\n  GRID_PREFERENCES_CAPABILITY_ID,\r\n} from \"./capabilities/gridPreferences\";\r\nexport type {\r\n  UseGridPreferencesResult,\r\n  GridPreferencesEntry,\r\n} from \"./capabilities/gridPreferences\";\r\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA,SAASA,OAAO,IAAIC,2BAA2B,QAAQ,2BAA2B;;AAElF;AACA,SAASD,OAAO,IAAIE,yBAAyB,QAAQ,sCAAsC;AAC3F,SAASF,OAAO,IAAIG,mBAAmB,QAAQ,gCAAgC;;AAE/E;AACA,SAASC,kBAAkB,EAAEC,YAAY,QAAQ,UAAU;;AAE3D;AACA;AACA;;AAGA;AACA,SAASC,YAAY,EAAEC,aAAa,EAAEC,uBAAuB,QAAQ,0BAA0B;AAC/F,SACEC,gBAAgB,EAChBC,qBAAqB,EACrBC,mBAAmB,EACnBC,gBAAgB,EAChBC,cAAc,QACT,8BAA8B;AACrC,SAASb,OAAO,IAAIc,cAAc,QAAQ,8BAA8B;;AAExE;AACA,SAASC,eAAe,EAAEC,2BAA2B,QAAQ,6BAA6B;;AAE1F;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SACEC,kBAAkB,EAClBC,8BAA8B,QACzB,gCAAgC","ignoreList":[]}
+{"version":3,"file":"index.js","names":["default","UserPersonalizationProvider","createLocalStorageAdapter","createMemoryAdapter","registerCapability","makeEnvelope","useFavorites","useIsFavorite","FAVORITES_CAPABILITY_ID","useFavoritesView","filterRowsByFavorites","sortRowsByFavorites","FAVORITES_FILTER","FAVORITES_SORT","FavoriteToggle","useSavedFilters","SAVED_FILTERS_CAPABILITY_ID","reviveSavedCriteria","useGridPreferences","GRID_PREFERENCES_CAPABILITY_ID"],"sources":["../../../../src/lib/v2/personalization/index.ts"],"sourcesContent":["/**\r\n * @portnet/ui · v2 · User Personalization Foundation\r\n * Public surface.\r\n *\r\n * Import via the dedicated subpath:\r\n *   import {\r\n *     UserPersonalizationProvider,\r\n *     useFavorites,\r\n *     useFavoritesView,\r\n *     useSavedFilters,\r\n *     FavoriteToggle,\r\n *   } from \"@portnet/ui/v2/personalization\";\r\n *\r\n * Surface is intentionally minimal (architecture doc §2.8 — minimum API\r\n * surface). The store handle and the internal selector primitive are NOT\r\n * exported; hosts interact through the provider, the capability hooks,\r\n * and the capability components.\r\n *\r\n * The grid-bound composites — SaveFilterDialog / SavedFiltersMenu (saved\r\n * filters) and makeFavoriteColumn / FavoritesFilter (favorites) — are\r\n * exposed via @portnet/ui/v2 (patterns/), not re-exported here, so the\r\n * personalization barrel never imports from patterns/.\r\n */\r\n\r\n/* Provider — the single configuration point. */\r\nexport { default as UserPersonalizationProvider } from \"./PersonalizationProvider\";\r\n\r\n/* Built-in storage adapters (a remote adapter will join them, swap-in). */\r\nexport { default as createLocalStorageAdapter } from \"./adapters/createLocalStorageAdapter\";\r\nexport { default as createMemoryAdapter } from \"./adapters/createMemoryAdapter\";\r\n\r\n/* Capability registration seam — for custom/host-defined capabilities. */\r\nexport { registerCapability, makeEnvelope } from \"./schema\";\r\n\r\n/* Canonical domain types — the TS contract that replaced the runtime\r\n * PropTypes shapes (Scope / Adapter / FavoriteRef / SavedFilter). Type-only:\r\n * erased from the runtime bundle. */\r\nexport type { Scope, Adapter, FavoriteRef, SavedFilter } from \"./types\";\r\n\r\n/* Favorites capability (Batch 3) + view logic (Batch 5). */\r\nexport { useFavorites, useIsFavorite, FAVORITES_CAPABILITY_ID } from \"./capabilities/favorites\";\r\nexport {\r\n  useFavoritesView,\r\n  filterRowsByFavorites,\r\n  sortRowsByFavorites,\r\n  FAVORITES_FILTER,\r\n  FAVORITES_SORT,\r\n} from \"./capabilities/favoritesView\";\r\nexport { default as FavoriteToggle } from \"../components/FavoriteToggle\";\r\n\r\n/* Saved filters capability (Batch 4). Composites in v2 patterns/. */\r\nexport { useSavedFilters, SAVED_FILTERS_CAPABILITY_ID } from \"./capabilities/savedFilters\";\r\n\r\n/**\r\n * Reading a saved filter BACK (gap G-50).\r\n *\r\n * `criteria` is opaque here on purpose, but the round trip is not symmetrical:\r\n * `createLocalStorageAdapter` writes with `JSON.stringify` (so a `Date` becomes\r\n * an ISO string) and reads with a bare `JSON.parse`, with NO reviver. Every host\r\n * that persists a date therefore got a string back, in a field its own types\r\n * declare as a `Date` — straight into `<DatePicker value>` and into the search\r\n * payload, silently, since the only way to assign the parsed payload into typed\r\n * form state is an assertion.\r\n *\r\n * Nine list screens of one module carried a DOUBLE conversion per `onApply` to\r\n * get around it. See the file header for why the fix belongs here and not in the\r\n * adapter.\r\n */\r\nexport { reviveSavedCriteria } from \"./capabilities/reviveSavedCriteria\";\r\n\r\n/**\r\n * Grid preferences capability (gap G-35) — per-user, per-resource hidden\r\n * columns.\r\n *\r\n * `DataGridToolbar` owns the column-visibility UI but holds no state, so every\r\n * host persisted the choice itself in a bare `localStorage` key, which is NOT\r\n * user-scoped — unlike this foundation's `…:{userId}:{capabilityId}` scheme.\r\n * On a shared workstation one user inherited another's hidden columns.\r\n *\r\n * A host could not fix it: `registerCapability` is exported below as a seam\r\n * \"for custom/host-defined capabilities\", but `usePersonalizationStore` and\r\n * `useStoreSelector` are deliberately private (§2.8, minimum API surface), so\r\n * a registered capability had no way to be read or written. The seam is\r\n * advertised without being complete; until that is resolved, a new capability\r\n * has to ship here.\r\n */\r\nexport {\r\n  useGridPreferences,\r\n  GRID_PREFERENCES_CAPABILITY_ID,\r\n} from \"./capabilities/gridPreferences\";\r\nexport type {\r\n  UseGridPreferencesResult,\r\n  GridPreferencesEntry,\r\n} from \"./capabilities/gridPreferences\";\r\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA,SAASA,OAAO,IAAIC,2BAA2B,QAAQ,2BAA2B;;AAElF;AACA,SAASD,OAAO,IAAIE,yBAAyB,QAAQ,sCAAsC;AAC3F,SAASF,OAAO,IAAIG,mBAAmB,QAAQ,gCAAgC;;AAE/E;AACA,SAASC,kBAAkB,EAAEC,YAAY,QAAQ,UAAU;;AAE3D;AACA;AACA;;AAGA;AACA,SAASC,YAAY,EAAEC,aAAa,EAAEC,uBAAuB,QAAQ,0BAA0B;AAC/F,SACEC,gBAAgB,EAChBC,qBAAqB,EACrBC,mBAAmB,EACnBC,gBAAgB,EAChBC,cAAc,QACT,8BAA8B;AACrC,SAASb,OAAO,IAAIc,cAAc,QAAQ,8BAA8B;;AAExE;AACA,SAASC,eAAe,EAAEC,2BAA2B,QAAQ,6BAA6B;;AAE1F;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,mBAAmB,QAAQ,oCAAoC;;AAExE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SACEC,kBAAkB,EAClBC,8BAA8B,QACzB,gCAAgC","ignoreList":[]}

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

@@ -27,10 +27,10 @@ import * as React from "react";
 
 /** Stable configuration carried by PersonalizationConfigContext. */
 
-export var PersonalizationConfigContext = /*#__PURE__*/React.createContext(null);
-export var PersonalizationStoreContext = /*#__PURE__*/React.createContext(null);
+export const PersonalizationConfigContext = /*#__PURE__*/React.createContext(null);
+export const PersonalizationStoreContext = /*#__PURE__*/React.createContext(null);
 export function usePersonalizationConfig() {
-  var ctx = React.useContext(PersonalizationConfigContext);
+  const ctx = React.useContext(PersonalizationConfigContext);
   if (!ctx) {
     throw new Error("[@portnet/ui v2] usePersonalizationConfig() must be used inside <UserPersonalizationProvider>.");
   }
@@ -39,7 +39,7 @@ export function usePersonalizationConfig() {
 
 /** The store handle. */
 export function usePersonalizationStore() {
-  var store = React.useContext(PersonalizationStoreContext);
+  const store = React.useContext(PersonalizationStoreContext);
   if (!store) {
     throw new Error("[@portnet/ui v2] personalization hooks must be used inside <UserPersonalizationProvider>.");
   }
@@ -72,15 +72,15 @@ export function usePersonalizationLabels() {
  * loop-free.
  */
 export function useStoreSelector(selector, isEqual) {
-  var store = usePersonalizationStore();
-  var cacheRef = React.useRef(null);
+  const store = usePersonalizationStore();
+  const cacheRef = React.useRef(null);
   function getSelection() {
-    var snapshot = store.getSnapshot();
-    var cache = cacheRef.current;
+    const snapshot = store.getSnapshot();
+    const cache = cacheRef.current;
     if (cache && Object.is(cache.snapshot, snapshot) && cache.selector === selector && cache.isEqual === isEqual) {
       return cache.selection;
     }
-    var nextSelection = selector(snapshot);
+    const nextSelection = selector(snapshot);
     if (cache && cache.hasValue && typeof isEqual === "function" && isEqual(cache.selection, nextSelection)) {
       cacheRef.current = {
         snapshot: snapshot,

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

@@ -1 +1 @@
-{"version":3,"file":"personalizationContext.js","names":["React","PersonalizationConfigContext","createContext","PersonalizationStoreContext","usePersonalizationConfig","ctx","useContext","Error","usePersonalizationStore","store","useScope","scope","usePersonalizationLabels","labels","useStoreSelector","selector","isEqual","cacheRef","useRef","getSelection","snapshot","getSnapshot","cache","current","Object","is","selection","nextSelection","hasValue","getServerSelection","getServerSnapshot","useSyncExternalStore","subscribe"],"sources":["../../../../src/lib/v2/personalization/personalizationContext.ts"],"sourcesContent":["/**\r\n * personalizationContext — Portnet UI v2 · personalization\r\n *\r\n * Two contexts, by design (architecture doc §2.5):\r\n *   - PersonalizationConfigContext : STABLE config { scope, labels }, set\r\n *     once by the provider. Low churn.\r\n *   - PersonalizationStoreContext  : the store handle. Mutable preference\r\n *     state NEVER travels through context — it is read via\r\n *     useSyncExternalStore selectors. A component toggling a favorite\r\n *     cannot re-render a component reading saved filters.\r\n *\r\n * `useStoreSelector` is the internal subscription primitive: a\r\n * useSyncExternalStore wrapper that caches by (snapshot, selector) and\r\n * supports an optional equality function so derived/object selections stay\r\n * referentially stable. It is NOT exported from the public surface — the\r\n * capability slices (Batch 3/4) consume it; hosts use the capability hooks.\r\n */\r\n\r\nimport * as React from \"react\";\r\n\r\nimport type {\r\n  PersonalizationSnapshot,\r\n  PersonalizationStore,\r\n} from \"./createPersonalizationStore\";\r\nimport type { Scope } from \"./types\";\r\n\r\n/**\r\n * Merged label bag (provider defaults + host overrides). The concrete\r\n * default values live in DEFAULT_PERSONALIZATION_LABELS in the provider;\r\n * this is the canonical type both the provider and the capability slices\r\n * import.\r\n */\r\nexport interface PersonalizationLabels {\r\n  // Follow / \"suivis\" (Batch 3)\r\n  addFavorite: string;\r\n  removeFavorite: string;\r\n  favoritesOnly: string;\r\n  showAll: string;\r\n  favoriteColumnHeader: string;\r\n  // Saved filters (Batch 4)\r\n  savedFilters: string;\r\n  saveCurrentFilter: string;\r\n  filterNameLabel: string;\r\n  filterNamePlaceholder: string;\r\n  saveFilter: string;\r\n  updateFilter: string;\r\n  deleteFilter: string;\r\n  deleteFilterConfirm: string;\r\n  setAsDefault: string;\r\n  defaultBadge: string;\r\n  manageFilters: string;\r\n  noSavedFilters: string;\r\n  cancel: string;\r\n}\r\n\r\n/** Stable configuration carried by PersonalizationConfigContext. */\r\nexport interface PersonalizationConfig {\r\n  scope: Scope;\r\n  labels: PersonalizationLabels;\r\n}\r\n\r\nexport const PersonalizationConfigContext =\r\n  React.createContext<PersonalizationConfig | null>(null);\r\nexport const PersonalizationStoreContext =\r\n  React.createContext<PersonalizationStore | null>(null);\r\n\r\nexport function usePersonalizationConfig(): PersonalizationConfig {\r\n  const ctx = React.useContext(PersonalizationConfigContext);\r\n  if (!ctx) {\r\n    throw new Error(\r\n      \"[@portnet/ui v2] usePersonalizationConfig() must be used inside <UserPersonalizationProvider>.\"\r\n    );\r\n  }\r\n  return ctx;\r\n}\r\n\r\n/** The store handle. */\r\nexport function usePersonalizationStore(): PersonalizationStore {\r\n  const store = React.useContext(PersonalizationStoreContext);\r\n  if (!store) {\r\n    throw new Error(\r\n      \"[@portnet/ui v2] personalization hooks must be used inside <UserPersonalizationProvider>.\"\r\n    );\r\n  }\r\n  return store;\r\n}\r\n\r\n/** Convenience: the current scope. */\r\nexport function useScope(): Scope {\r\n  return usePersonalizationConfig().scope;\r\n}\r\n\r\n/** Convenience: merged labels (provider defaults + host overrides). */\r\nexport function usePersonalizationLabels(): PersonalizationLabels {\r\n  return usePersonalizationConfig().labels;\r\n}\r\n\r\ninterface SelectorCache<T> {\r\n  snapshot: PersonalizationSnapshot;\r\n  selector: (snapshot: PersonalizationSnapshot) => T;\r\n  isEqual: ((a: T, b: T) => boolean) | undefined;\r\n  selection: T;\r\n  hasValue: boolean;\r\n}\r\n\r\n/**\r\n * Subscribe to the store with a selector. Returns a referentially stable\r\n * value when the selected slice is unchanged — required by\r\n * useSyncExternalStore and the basis of the no-cross-capability-re-render\r\n * guarantee.\r\n *\r\n * The cache is keyed on (snapshot identity, selector identity, isEqual\r\n * identity). When the snapshot is unchanged for the same selector, the\r\n * memoised selection is returned without re-running the selector. When the\r\n * snapshot changes, the selector re-runs; if `isEqual` is supplied and the\r\n * new value is equal to the previous one, the previous reference is kept.\r\n *\r\n * Selectors should be stable (e.g. useCallback) OR rely on the store's\r\n * structural sharing returning stable slice references — both keep this\r\n * loop-free.\r\n */\r\nexport function useStoreSelector<T>(\r\n  selector: (snapshot: PersonalizationSnapshot) => T,\r\n  isEqual?: (a: T, b: T) => boolean\r\n): T {\r\n  const store = usePersonalizationStore();\r\n  const cacheRef = React.useRef<SelectorCache<T> | null>(null);\r\n\r\n  function getSelection(): T {\r\n    const snapshot = store.getSnapshot();\r\n    const cache = cacheRef.current;\r\n    if (\r\n      cache &&\r\n      Object.is(cache.snapshot, snapshot) &&\r\n      cache.selector === selector &&\r\n      cache.isEqual === isEqual\r\n    ) {\r\n      return cache.selection;\r\n    }\r\n    const nextSelection = selector(snapshot);\r\n    if (\r\n      cache &&\r\n      cache.hasValue &&\r\n      typeof isEqual === \"function\" &&\r\n      isEqual(cache.selection, nextSelection)\r\n    ) {\r\n      cacheRef.current = {\r\n        snapshot: snapshot,\r\n        selector: selector,\r\n        isEqual: isEqual,\r\n        selection: cache.selection,\r\n        hasValue: true,\r\n      };\r\n      return cache.selection;\r\n    }\r\n    cacheRef.current = {\r\n      snapshot: snapshot,\r\n      selector: selector,\r\n      isEqual: isEqual,\r\n      selection: nextSelection,\r\n      hasValue: true,\r\n    };\r\n    return nextSelection;\r\n  }\r\n\r\n  function getServerSelection(): T {\r\n    return selector(store.getServerSnapshot());\r\n  }\r\n\r\n  return React.useSyncExternalStore(\r\n    store.subscribe,\r\n    getSelection,\r\n    getServerSelection\r\n  );\r\n}\r\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"personalizationContext.js","names":["React","PersonalizationConfigContext","createContext","PersonalizationStoreContext","usePersonalizationConfig","ctx","useContext","Error","usePersonalizationStore","store","useScope","scope","usePersonalizationLabels","labels","useStoreSelector","selector","isEqual","cacheRef","useRef","getSelection","snapshot","getSnapshot","cache","current","Object","is","selection","nextSelection","hasValue","getServerSelection","getServerSnapshot","useSyncExternalStore","subscribe"],"sources":["../../../../src/lib/v2/personalization/personalizationContext.ts"],"sourcesContent":["/**\r\n * personalizationContext — Portnet UI v2 · personalization\r\n *\r\n * Two contexts, by design (architecture doc §2.5):\r\n *   - PersonalizationConfigContext : STABLE config { scope, labels }, set\r\n *     once by the provider. Low churn.\r\n *   - PersonalizationStoreContext  : the store handle. Mutable preference\r\n *     state NEVER travels through context — it is read via\r\n *     useSyncExternalStore selectors. A component toggling a favorite\r\n *     cannot re-render a component reading saved filters.\r\n *\r\n * `useStoreSelector` is the internal subscription primitive: a\r\n * useSyncExternalStore wrapper that caches by (snapshot, selector) and\r\n * supports an optional equality function so derived/object selections stay\r\n * referentially stable. It is NOT exported from the public surface — the\r\n * capability slices (Batch 3/4) consume it; hosts use the capability hooks.\r\n */\r\n\r\nimport * as React from \"react\";\r\n\r\nimport type {\r\n  PersonalizationSnapshot,\r\n  PersonalizationStore,\r\n} from \"./createPersonalizationStore\";\r\nimport type { Scope } from \"./types\";\r\n\r\n/**\r\n * Merged label bag (provider defaults + host overrides). The concrete\r\n * default values live in DEFAULT_PERSONALIZATION_LABELS in the provider;\r\n * this is the canonical type both the provider and the capability slices\r\n * import.\r\n */\r\nexport interface PersonalizationLabels {\r\n  // Follow / \"suivis\" (Batch 3)\r\n  addFavorite: string;\r\n  removeFavorite: string;\r\n  favoritesOnly: string;\r\n  showAll: string;\r\n  favoriteColumnHeader: string;\r\n  // Saved filters (Batch 4)\r\n  savedFilters: string;\r\n  saveCurrentFilter: string;\r\n  filterNameLabel: string;\r\n  filterNamePlaceholder: string;\r\n  saveFilter: string;\r\n  updateFilter: string;\r\n  deleteFilter: string;\r\n  deleteFilterConfirm: string;\r\n  setAsDefault: string;\r\n  defaultBadge: string;\r\n  manageFilters: string;\r\n  noSavedFilters: string;\r\n  cancel: string;\r\n}\r\n\r\n/** Stable configuration carried by PersonalizationConfigContext. */\r\nexport interface PersonalizationConfig {\r\n  scope: Scope;\r\n  labels: PersonalizationLabels;\r\n}\r\n\r\nexport const PersonalizationConfigContext =\r\n  React.createContext<PersonalizationConfig | null>(null);\r\nexport const PersonalizationStoreContext =\r\n  React.createContext<PersonalizationStore | null>(null);\r\n\r\nexport function usePersonalizationConfig(): PersonalizationConfig {\r\n  const ctx = React.useContext(PersonalizationConfigContext);\r\n  if (!ctx) {\r\n    throw new Error(\r\n      \"[@portnet/ui v2] usePersonalizationConfig() must be used inside <UserPersonalizationProvider>.\"\r\n    );\r\n  }\r\n  return ctx;\r\n}\r\n\r\n/** The store handle. */\r\nexport function usePersonalizationStore(): PersonalizationStore {\r\n  const store = React.useContext(PersonalizationStoreContext);\r\n  if (!store) {\r\n    throw new Error(\r\n      \"[@portnet/ui v2] personalization hooks must be used inside <UserPersonalizationProvider>.\"\r\n    );\r\n  }\r\n  return store;\r\n}\r\n\r\n/** Convenience: the current scope. */\r\nexport function useScope(): Scope {\r\n  return usePersonalizationConfig().scope;\r\n}\r\n\r\n/** Convenience: merged labels (provider defaults + host overrides). */\r\nexport function usePersonalizationLabels(): PersonalizationLabels {\r\n  return usePersonalizationConfig().labels;\r\n}\r\n\r\ninterface SelectorCache<T> {\r\n  snapshot: PersonalizationSnapshot;\r\n  selector: (snapshot: PersonalizationSnapshot) => T;\r\n  isEqual: ((a: T, b: T) => boolean) | undefined;\r\n  selection: T;\r\n  hasValue: boolean;\r\n}\r\n\r\n/**\r\n * Subscribe to the store with a selector. Returns a referentially stable\r\n * value when the selected slice is unchanged — required by\r\n * useSyncExternalStore and the basis of the no-cross-capability-re-render\r\n * guarantee.\r\n *\r\n * The cache is keyed on (snapshot identity, selector identity, isEqual\r\n * identity). When the snapshot is unchanged for the same selector, the\r\n * memoised selection is returned without re-running the selector. When the\r\n * snapshot changes, the selector re-runs; if `isEqual` is supplied and the\r\n * new value is equal to the previous one, the previous reference is kept.\r\n *\r\n * Selectors should be stable (e.g. useCallback) OR rely on the store's\r\n * structural sharing returning stable slice references — both keep this\r\n * loop-free.\r\n */\r\nexport function useStoreSelector<T>(\r\n  selector: (snapshot: PersonalizationSnapshot) => T,\r\n  isEqual?: (a: T, b: T) => boolean\r\n): T {\r\n  const store = usePersonalizationStore();\r\n  const cacheRef = React.useRef<SelectorCache<T> | null>(null);\r\n\r\n  function getSelection(): T {\r\n    const snapshot = store.getSnapshot();\r\n    const cache = cacheRef.current;\r\n    if (\r\n      cache &&\r\n      Object.is(cache.snapshot, snapshot) &&\r\n      cache.selector === selector &&\r\n      cache.isEqual === isEqual\r\n    ) {\r\n      return cache.selection;\r\n    }\r\n    const nextSelection = selector(snapshot);\r\n    if (\r\n      cache &&\r\n      cache.hasValue &&\r\n      typeof isEqual === \"function\" &&\r\n      isEqual(cache.selection, nextSelection)\r\n    ) {\r\n      cacheRef.current = {\r\n        snapshot: snapshot,\r\n        selector: selector,\r\n        isEqual: isEqual,\r\n        selection: cache.selection,\r\n        hasValue: true,\r\n      };\r\n      return cache.selection;\r\n    }\r\n    cacheRef.current = {\r\n      snapshot: snapshot,\r\n      selector: selector,\r\n      isEqual: isEqual,\r\n      selection: nextSelection,\r\n      hasValue: true,\r\n    };\r\n    return nextSelection;\r\n  }\r\n\r\n  function getServerSelection(): T {\r\n    return selector(store.getServerSnapshot());\r\n  }\r\n\r\n  return React.useSyncExternalStore(\r\n    store.subscribe,\r\n    getSelection,\r\n    getServerSelection\r\n  );\r\n}\r\n"],"mappings":"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","ignoreList":[]}

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

@@ -18,7 +18,7 @@
  * the OPAQUE envelope; the `payload` shape is owned by the slice.
  */
 
-var isDev = typeof process !== "undefined" && !!process.env && process.env["NODE_ENV"] !== "production";
+const isDev = typeof process !== "undefined" && !!process.env && process.env["NODE_ENV"] !== "production";
 
 /** A capability's migrate function: upgrade an old payload to the current version. */
 
@@ -27,7 +27,7 @@ var isDev = typeof process !== "undefined" && !!process.env && process.env["NODE
 /** Frozen, normalised capability descriptor stored in the registry. */
 
 /** id -> frozen descriptor. Module-level (same lifecycle model as useDensity's store). */
-var registry = new Map();
+const registry = new Map();
 
 /**
  * Register a capability descriptor. Idempotent: the first registration for an
@@ -42,16 +42,15 @@ export function registerCapability(descriptor) {
     }
     return null;
   }
-  var existing = registry.get(descriptor.id);
+  const existing = registry.get(descriptor.id);
   if (existing) {
-    var _descriptor$schemaVer;
-    if (isDev && existing.schemaVersion !== ((_descriptor$schemaVer = descriptor.schemaVersion) !== null && _descriptor$schemaVer !== void 0 ? _descriptor$schemaVer : 1)) {
+    if (isDev && existing.schemaVersion !== (descriptor.schemaVersion ?? 1)) {
       // eslint-disable-next-line no-console
-      console.warn("[@portnet/ui v2] registerCapability: \"".concat(descriptor.id, "\" re-registered with a different ") + "schemaVersion (".concat(existing.schemaVersion, " \u2192 ").concat(descriptor.schemaVersion, "). Keeping the first ") + "registration. This usually means two @portnet/ui copies are loaded.");
+      console.warn(`[@portnet/ui v2] registerCapability: "${descriptor.id}" re-registered with a different ` + `schemaVersion (${existing.schemaVersion} → ${descriptor.schemaVersion}). Keeping the first ` + `registration. This usually means two @portnet/ui copies are loaded.`);
     }
     return existing;
   }
-  var frozen = Object.freeze({
+  const frozen = Object.freeze({
     id: descriptor.id,
     schemaVersion: typeof descriptor.schemaVersion === "number" ? descriptor.schemaVersion : 1,
     defaultState: descriptor.defaultState !== undefined ? descriptor.defaultState : Object.freeze({}),
@@ -79,7 +78,7 @@ export function makeEnvelope(schemaVersion, payload) {
   return {
     schemaVersion: typeof schemaVersion === "number" ? schemaVersion : 1,
     updatedAt: new Date().toISOString(),
-    payload: payload
+    payload
   };
 }
 
@@ -88,5 +87,5 @@ export function makeEnvelope(schemaVersion, payload) {
  * capability's payload `schemaVersion`). Bumped only on a global re-partition.
  * Mirrored by adapters/_storageKey.ts.
  */
-export var KEY_SCHEME_VERSION = "v1";
+export const KEY_SCHEME_VERSION = "v1";
 //# sourceMappingURL=schema.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"schema.js","names":["isDev","process","env","registry","Map","registerCapability","descriptor","id","console","warn","existing","get","_descriptor$schemaVer","schemaVersion","concat","frozen","Object","freeze","defaultState","undefined","migrate","set","getCapability","getRegisteredCapabilities","Array","from","values","makeEnvelope","payload","updatedAt","Date","toISOString","KEY_SCHEME_VERSION"],"sources":["../../../../src/lib/v2/personalization/schema.ts"],"sourcesContent":["/**\r\n * schema — Portnet UI v2 · User Personalization Foundation\r\n *\r\n * Capability registry + persistence envelope. The foundation is deliberately\r\n * capability-AGNOSTIC: the store and provider know nothing about \"favorites\"\r\n * or \"savedFilters\". Each capability *slice* registers itself here at import\r\n * time:\r\n *\r\n *   import { registerCapability } from \"../schema\";\r\n *   registerCapability({\r\n *     id: \"favorites\",\r\n *     schemaVersion: 1,\r\n *     defaultState: Object.freeze({}),\r\n *     migrate: (fromVersion, payload) => payload,\r\n *   });\r\n *\r\n * Adding a new capability is therefore purely additive. The adapter persists\r\n * the OPAQUE envelope; the `payload` shape is owned by the slice.\r\n */\r\n\r\nimport type { Envelope } 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/** A capability's migrate function: upgrade an old payload to the current version. */\r\nexport type CapabilityMigrate = (\r\n  fromVersion: number,\r\n  payload: unknown\r\n) => unknown;\r\n\r\n/** Registration input for a capability slice. */\r\nexport interface CapabilityDescriptorInput {\r\n  /** Unique capability id (e.g. \"favorites\"). */\r\n  id: string;\r\n  schemaVersion?: number | undefined;\r\n  /** Seed when nothing is persisted (should be a STABLE/frozen ref). */\r\n  defaultState?: unknown;\r\n  migrate?: CapabilityMigrate | undefined;\r\n}\r\n\r\n/** Frozen, normalised capability descriptor stored in the registry. */\r\nexport interface CapabilityDescriptor {\r\n  id: string;\r\n  schemaVersion: number;\r\n  defaultState: unknown;\r\n  migrate: CapabilityMigrate | null;\r\n}\r\n\r\n/** id -> frozen descriptor. Module-level (same lifecycle model as useDensity's store). */\r\nconst registry = new Map<string, CapabilityDescriptor>();\r\n\r\n/**\r\n * Register a capability descriptor. Idempotent: the first registration for an\r\n * id wins; a second registration with a *different* schemaVersion is reported\r\n * in development (usually two library copies or a mismatched host version).\r\n */\r\nexport function registerCapability(\r\n  descriptor: CapabilityDescriptorInput\r\n): CapabilityDescriptor | null {\r\n  if (!descriptor || typeof descriptor.id !== \"string\" || !descriptor.id) {\r\n    if (isDev) {\r\n      // eslint-disable-next-line no-console\r\n      console.warn(\r\n        \"[@portnet/ui v2] registerCapability: a non-empty string `id` is required.\"\r\n      );\r\n    }\r\n    return null;\r\n  }\r\n\r\n  const existing = registry.get(descriptor.id);\r\n  if (existing) {\r\n    if (isDev && existing.schemaVersion !== (descriptor.schemaVersion ?? 1)) {\r\n      // eslint-disable-next-line no-console\r\n      console.warn(\r\n        `[@portnet/ui v2] registerCapability: \"${descriptor.id}\" re-registered with a different ` +\r\n          `schemaVersion (${existing.schemaVersion} → ${descriptor.schemaVersion}). Keeping the first ` +\r\n          `registration. This usually means two @portnet/ui copies are loaded.`\r\n      );\r\n    }\r\n    return existing;\r\n  }\r\n\r\n  const frozen: CapabilityDescriptor = Object.freeze({\r\n    id: descriptor.id,\r\n    schemaVersion:\r\n      typeof descriptor.schemaVersion === \"number\"\r\n        ? descriptor.schemaVersion\r\n        : 1,\r\n    defaultState:\r\n      descriptor.defaultState !== undefined\r\n        ? descriptor.defaultState\r\n        : Object.freeze({}),\r\n    migrate:\r\n      typeof descriptor.migrate === \"function\" ? descriptor.migrate : null,\r\n  });\r\n  registry.set(frozen.id, frozen);\r\n  return frozen;\r\n}\r\n\r\n/** @returns the descriptor registered for `id`, or null. */\r\nexport function getCapability(id: string): CapabilityDescriptor | null {\r\n  return registry.get(id) || null;\r\n}\r\n\r\n/** @returns every registered descriptor (snapshot array). */\r\nexport function getRegisteredCapabilities(): CapabilityDescriptor[] {\r\n  return Array.from(registry.values());\r\n}\r\n\r\n/**\r\n * Build the versioned persistence envelope. The adapter treats `payload` as\r\n * opaque; `schemaVersion` lets a slice's migrate() upgrade old payloads on load.\r\n */\r\nexport function makeEnvelope(schemaVersion: number, payload: unknown): Envelope {\r\n  return {\r\n    schemaVersion: typeof schemaVersion === \"number\" ? schemaVersion : 1,\r\n    updatedAt: new Date().toISOString(),\r\n    payload,\r\n  };\r\n}\r\n\r\n/**\r\n * Key-scheme version (the layout of the *storage key*, distinct from a\r\n * capability's payload `schemaVersion`). Bumped only on a global re-partition.\r\n * Mirrored by adapters/_storageKey.ts.\r\n */\r\nexport const KEY_SCHEME_VERSION = \"v1\";\r\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,IAAMA,KAAK,GACT,OAAOC,OAAO,KAAK,WAAW,IAC9B,CAAC,CAACA,OAAO,CAACC,GAAG,IACbD,OAAO,CAACC,GAAG,CAAC,UAAU,CAAC,KAAK,YAAY;;AAE1C;;AAMA;;AAUA;;AAQA;AACA,IAAMC,QAAQ,GAAG,IAAIC,GAAG,CAA+B,CAAC;;AAExD;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,kBAAkBA,CAChCC,UAAqC,EACR;EAC7B,IAAI,CAACA,UAAU,IAAI,OAAOA,UAAU,CAACC,EAAE,KAAK,QAAQ,IAAI,CAACD,UAAU,CAACC,EAAE,EAAE;IACtE,IAAIP,KAAK,EAAE;MACT;MACAQ,OAAO,CAACC,IAAI,CACV,2EACF,CAAC;IACH;IACA,OAAO,IAAI;EACb;EAEA,IAAMC,QAAQ,GAAGP,QAAQ,CAACQ,GAAG,CAACL,UAAU,CAACC,EAAE,CAAC;EAC5C,IAAIG,QAAQ,EAAE;IAAA,IAAAE,qBAAA;IACZ,IAAIZ,KAAK,IAAIU,QAAQ,CAACG,aAAa,OAAAD,qBAAA,GAAMN,UAAU,CAACO,aAAa,cAAAD,qBAAA,cAAAA,qBAAA,GAAI,CAAC,CAAC,EAAE;MACvE;MACAJ,OAAO,CAACC,IAAI,CACV,0CAAAK,MAAA,CAAyCR,UAAU,CAACC,EAAE,4DAAAO,MAAA,CAClCJ,QAAQ,CAACG,aAAa,cAAAC,MAAA,CAAMR,UAAU,CAACO,aAAa,0BAAuB,wEAEjG,CAAC;IACH;IACA,OAAOH,QAAQ;EACjB;EAEA,IAAMK,MAA4B,GAAGC,MAAM,CAACC,MAAM,CAAC;IACjDV,EAAE,EAAED,UAAU,CAACC,EAAE;IACjBM,aAAa,EACX,OAAOP,UAAU,CAACO,aAAa,KAAK,QAAQ,GACxCP,UAAU,CAACO,aAAa,GACxB,CAAC;IACPK,YAAY,EACVZ,UAAU,CAACY,YAAY,KAAKC,SAAS,GACjCb,UAAU,CAACY,YAAY,GACvBF,MAAM,CAACC,MAAM,CAAC,CAAC,CAAC,CAAC;IACvBG,OAAO,EACL,OAAOd,UAAU,CAACc,OAAO,KAAK,UAAU,GAAGd,UAAU,CAACc,OAAO,GAAG;EACpE,CAAC,CAAC;EACFjB,QAAQ,CAACkB,GAAG,CAACN,MAAM,CAACR,EAAE,EAAEQ,MAAM,CAAC;EAC/B,OAAOA,MAAM;AACf;;AAEA;AACA,OAAO,SAASO,aAAaA,CAACf,EAAU,EAA+B;EACrE,OAAOJ,QAAQ,CAACQ,GAAG,CAACJ,EAAE,CAAC,IAAI,IAAI;AACjC;;AAEA;AACA,OAAO,SAASgB,yBAAyBA,CAAA,EAA2B;EAClE,OAAOC,KAAK,CAACC,IAAI,CAACtB,QAAQ,CAACuB,MAAM,CAAC,CAAC,CAAC;AACtC;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,YAAYA,CAACd,aAAqB,EAAEe,OAAgB,EAAY;EAC9E,OAAO;IACLf,aAAa,EAAE,OAAOA,aAAa,KAAK,QAAQ,GAAGA,aAAa,GAAG,CAAC;IACpEgB,SAAS,EAAE,IAAIC,IAAI,CAAC,CAAC,CAACC,WAAW,CAAC,CAAC;IACnCH,OAAO,EAAPA;EACF,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,IAAMI,kBAAkB,GAAG,IAAI","ignoreList":[]}
+{"version":3,"file":"schema.js","names":["isDev","process","env","registry","Map","registerCapability","descriptor","id","console","warn","existing","get","schemaVersion","frozen","Object","freeze","defaultState","undefined","migrate","set","getCapability","getRegisteredCapabilities","Array","from","values","makeEnvelope","payload","updatedAt","Date","toISOString","KEY_SCHEME_VERSION"],"sources":["../../../../src/lib/v2/personalization/schema.ts"],"sourcesContent":["/**\r\n * schema — Portnet UI v2 · User Personalization Foundation\r\n *\r\n * Capability registry + persistence envelope. The foundation is deliberately\r\n * capability-AGNOSTIC: the store and provider know nothing about \"favorites\"\r\n * or \"savedFilters\". Each capability *slice* registers itself here at import\r\n * time:\r\n *\r\n *   import { registerCapability } from \"../schema\";\r\n *   registerCapability({\r\n *     id: \"favorites\",\r\n *     schemaVersion: 1,\r\n *     defaultState: Object.freeze({}),\r\n *     migrate: (fromVersion, payload) => payload,\r\n *   });\r\n *\r\n * Adding a new capability is therefore purely additive. The adapter persists\r\n * the OPAQUE envelope; the `payload` shape is owned by the slice.\r\n */\r\n\r\nimport type { Envelope } 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/** A capability's migrate function: upgrade an old payload to the current version. */\r\nexport type CapabilityMigrate = (\r\n  fromVersion: number,\r\n  payload: unknown\r\n) => unknown;\r\n\r\n/** Registration input for a capability slice. */\r\nexport interface CapabilityDescriptorInput {\r\n  /** Unique capability id (e.g. \"favorites\"). */\r\n  id: string;\r\n  schemaVersion?: number | undefined;\r\n  /** Seed when nothing is persisted (should be a STABLE/frozen ref). */\r\n  defaultState?: unknown;\r\n  migrate?: CapabilityMigrate | undefined;\r\n}\r\n\r\n/** Frozen, normalised capability descriptor stored in the registry. */\r\nexport interface CapabilityDescriptor {\r\n  id: string;\r\n  schemaVersion: number;\r\n  defaultState: unknown;\r\n  migrate: CapabilityMigrate | null;\r\n}\r\n\r\n/** id -> frozen descriptor. Module-level (same lifecycle model as useDensity's store). */\r\nconst registry = new Map<string, CapabilityDescriptor>();\r\n\r\n/**\r\n * Register a capability descriptor. Idempotent: the first registration for an\r\n * id wins; a second registration with a *different* schemaVersion is reported\r\n * in development (usually two library copies or a mismatched host version).\r\n */\r\nexport function registerCapability(\r\n  descriptor: CapabilityDescriptorInput\r\n): CapabilityDescriptor | null {\r\n  if (!descriptor || typeof descriptor.id !== \"string\" || !descriptor.id) {\r\n    if (isDev) {\r\n      // eslint-disable-next-line no-console\r\n      console.warn(\r\n        \"[@portnet/ui v2] registerCapability: a non-empty string `id` is required.\"\r\n      );\r\n    }\r\n    return null;\r\n  }\r\n\r\n  const existing = registry.get(descriptor.id);\r\n  if (existing) {\r\n    if (isDev && existing.schemaVersion !== (descriptor.schemaVersion ?? 1)) {\r\n      // eslint-disable-next-line no-console\r\n      console.warn(\r\n        `[@portnet/ui v2] registerCapability: \"${descriptor.id}\" re-registered with a different ` +\r\n          `schemaVersion (${existing.schemaVersion} → ${descriptor.schemaVersion}). Keeping the first ` +\r\n          `registration. This usually means two @portnet/ui copies are loaded.`\r\n      );\r\n    }\r\n    return existing;\r\n  }\r\n\r\n  const frozen: CapabilityDescriptor = Object.freeze({\r\n    id: descriptor.id,\r\n    schemaVersion:\r\n      typeof descriptor.schemaVersion === \"number\"\r\n        ? descriptor.schemaVersion\r\n        : 1,\r\n    defaultState:\r\n      descriptor.defaultState !== undefined\r\n        ? descriptor.defaultState\r\n        : Object.freeze({}),\r\n    migrate:\r\n      typeof descriptor.migrate === \"function\" ? descriptor.migrate : null,\r\n  });\r\n  registry.set(frozen.id, frozen);\r\n  return frozen;\r\n}\r\n\r\n/** @returns the descriptor registered for `id`, or null. */\r\nexport function getCapability(id: string): CapabilityDescriptor | null {\r\n  return registry.get(id) || null;\r\n}\r\n\r\n/** @returns every registered descriptor (snapshot array). */\r\nexport function getRegisteredCapabilities(): CapabilityDescriptor[] {\r\n  return Array.from(registry.values());\r\n}\r\n\r\n/**\r\n * Build the versioned persistence envelope. The adapter treats `payload` as\r\n * opaque; `schemaVersion` lets a slice's migrate() upgrade old payloads on load.\r\n */\r\nexport function makeEnvelope(schemaVersion: number, payload: unknown): Envelope {\r\n  return {\r\n    schemaVersion: typeof schemaVersion === \"number\" ? schemaVersion : 1,\r\n    updatedAt: new Date().toISOString(),\r\n    payload,\r\n  };\r\n}\r\n\r\n/**\r\n * Key-scheme version (the layout of the *storage key*, distinct from a\r\n * capability's payload `schemaVersion`). Bumped only on a global re-partition.\r\n * Mirrored by adapters/_storageKey.ts.\r\n */\r\nexport const KEY_SCHEME_VERSION = \"v1\";\r\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,MAAMA,KAAK,GACT,OAAOC,OAAO,KAAK,WAAW,IAC9B,CAAC,CAACA,OAAO,CAACC,GAAG,IACbD,OAAO,CAACC,GAAG,CAAC,UAAU,CAAC,KAAK,YAAY;;AAE1C;;AAMA;;AAUA;;AAQA;AACA,MAAMC,QAAQ,GAAG,IAAIC,GAAG,CAA+B,CAAC;;AAExD;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,kBAAkBA,CAChCC,UAAqC,EACR;EAC7B,IAAI,CAACA,UAAU,IAAI,OAAOA,UAAU,CAACC,EAAE,KAAK,QAAQ,IAAI,CAACD,UAAU,CAACC,EAAE,EAAE;IACtE,IAAIP,KAAK,EAAE;MACT;MACAQ,OAAO,CAACC,IAAI,CACV,2EACF,CAAC;IACH;IACA,OAAO,IAAI;EACb;EAEA,MAAMC,QAAQ,GAAGP,QAAQ,CAACQ,GAAG,CAACL,UAAU,CAACC,EAAE,CAAC;EAC5C,IAAIG,QAAQ,EAAE;IACZ,IAAIV,KAAK,IAAIU,QAAQ,CAACE,aAAa,MAAMN,UAAU,CAACM,aAAa,IAAI,CAAC,CAAC,EAAE;MACvE;MACAJ,OAAO,CAACC,IAAI,CACV,yCAAyCH,UAAU,CAACC,EAAE,mCAAmC,GACvF,kBAAkBG,QAAQ,CAACE,aAAa,MAAMN,UAAU,CAACM,aAAa,uBAAuB,GAC7F,qEACJ,CAAC;IACH;IACA,OAAOF,QAAQ;EACjB;EAEA,MAAMG,MAA4B,GAAGC,MAAM,CAACC,MAAM,CAAC;IACjDR,EAAE,EAAED,UAAU,CAACC,EAAE;IACjBK,aAAa,EACX,OAAON,UAAU,CAACM,aAAa,KAAK,QAAQ,GACxCN,UAAU,CAACM,aAAa,GACxB,CAAC;IACPI,YAAY,EACVV,UAAU,CAACU,YAAY,KAAKC,SAAS,GACjCX,UAAU,CAACU,YAAY,GACvBF,MAAM,CAACC,MAAM,CAAC,CAAC,CAAC,CAAC;IACvBG,OAAO,EACL,OAAOZ,UAAU,CAACY,OAAO,KAAK,UAAU,GAAGZ,UAAU,CAACY,OAAO,GAAG;EACpE,CAAC,CAAC;EACFf,QAAQ,CAACgB,GAAG,CAACN,MAAM,CAACN,EAAE,EAAEM,MAAM,CAAC;EAC/B,OAAOA,MAAM;AACf;;AAEA;AACA,OAAO,SAASO,aAAaA,CAACb,EAAU,EAA+B;EACrE,OAAOJ,QAAQ,CAACQ,GAAG,CAACJ,EAAE,CAAC,IAAI,IAAI;AACjC;;AAEA;AACA,OAAO,SAASc,yBAAyBA,CAAA,EAA2B;EAClE,OAAOC,KAAK,CAACC,IAAI,CAACpB,QAAQ,CAACqB,MAAM,CAAC,CAAC,CAAC;AACtC;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,YAAYA,CAACb,aAAqB,EAAEc,OAAgB,EAAY;EAC9E,OAAO;IACLd,aAAa,EAAE,OAAOA,aAAa,KAAK,QAAQ,GAAGA,aAAa,GAAG,CAAC;IACpEe,SAAS,EAAE,IAAIC,IAAI,CAAC,CAAC,CAACC,WAAW,CAAC,CAAC;IACnCH;EACF,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMI,kBAAkB,GAAG,IAAI","ignoreList":[]}

package/dist/esm/v2/referentiel/ReferentielProvider.js

@@ -1,15 +1,3 @@
-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 _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
-function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
-function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
-function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
-function _iterableToArrayLimit(arr, i) { var _i = null == arr ? null : "undefined" != typeof Symbol && arr[Symbol.iterator] || arr["@@iterator"]; if (null != _i) { var _s, _e, _x, _r, _arr = [], _n = !0, _d = !1; try { if (_x = (_i = _i.call(arr)).next, 0 === i) { if (Object(_i) !== _i) return; _n = !1; } else for (; !(_n = (_s = _x.call(_i)).done) && (_arr.push(_s.value), _arr.length !== i); _n = !0) { ; } } catch (err) { _d = !0, _e = err; } finally { try { if (!_n && null != _i["return"] && (_r = _i["return"](), Object(_r) !== _r)) return; } finally { if (_d) throw _e; } } return _arr; } }
-function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
-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); }
 import * as React from "react";
 
 /**
@@ -20,21 +8,25 @@ import * as React from "react";
  * paginated search builder for ReferentielField.
  */
 import { jsx as _jsx } from "react/jsx-runtime";
-export var ReferentielContext = /*#__PURE__*/React.createContext({
+export const ReferentielContext = /*#__PURE__*/React.createContext({
   baseURL: "",
   token: "",
   secret: false,
   langue: "fr",
   cache: {},
-  cacheDispatch: function cacheDispatch() {}
+  cacheDispatch: () => {}
 });
-var INITIAL_CACHE = {};
-function cacheReducer(state, _ref) {
-  var type = _ref.type,
-    payload = _ref.payload;
+const INITIAL_CACHE = {};
+function cacheReducer(state, {
+  type,
+  payload
+}) {
   switch (type) {
     case "SET":
-      return _objectSpread(_objectSpread({}, state), {}, _defineProperty({}, payload.key, payload.data));
+      return {
+        ...state,
+        [payload.key]: payload.data
+      };
     default:
       return state;
   }
@@ -56,29 +48,22 @@ function cacheReducer(state, _ref) {
  * Auth contract (see useReferentielClient): secret => the raw token is sent
  * in the Authorization header; otherwise a Bearer prefix is used.
  */
-export default function ReferentielProvider(_ref2) {
-  var baseURL = _ref2.baseURL,
-    _ref2$token = _ref2.token,
-    token = _ref2$token === void 0 ? "" : _ref2$token,
-    _ref2$secret = _ref2.secret,
-    secret = _ref2$secret === void 0 ? false : _ref2$secret,
-    _ref2$langue = _ref2.langue,
-    langue = _ref2$langue === void 0 ? "fr" : _ref2$langue,
-    children = _ref2.children;
-  var _React$useReducer = React.useReducer(cacheReducer, INITIAL_CACHE),
-    _React$useReducer2 = _slicedToArray(_React$useReducer, 2),
-    cache = _React$useReducer2[0],
-    cacheDispatch = _React$useReducer2[1];
-  var value = React.useMemo(function () {
-    return {
-      baseURL: baseURL,
-      token: token,
-      secret: secret,
-      langue: langue,
-      cache: cache,
-      cacheDispatch: cacheDispatch
-    };
-  }, [baseURL, token, secret, langue, cache]);
+export default function ReferentielProvider({
+  baseURL,
+  token = "",
+  secret = false,
+  langue = "fr",
+  children
+}) {
+  const [cache, cacheDispatch] = React.useReducer(cacheReducer, INITIAL_CACHE);
+  const value = React.useMemo(() => ({
+    baseURL,
+    token,
+    secret,
+    langue,
+    cache,
+    cacheDispatch
+  }), [baseURL, token, secret, langue, cache]);
   return /*#__PURE__*/_jsx(ReferentielContext.Provider, {
     value: value,
     children: children

package/dist/esm/v2/referentiel/ReferentielProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"ReferentielProvider.js","names":["React","jsx","_jsx","ReferentielContext","createContext","baseURL","token","secret","langue","cache","cacheDispatch","INITIAL_CACHE","cacheReducer","state","_ref","type","payload","_objectSpread","_defineProperty","key","data","ReferentielProvider","_ref2","_ref2$token","_ref2$secret","_ref2$langue","children","_React$useReducer","useReducer","_React$useReducer2","_slicedToArray","value","useMemo","Provider"],"sources":["../../../../src/lib/v2/referentiel/ReferentielProvider.tsx"],"sourcesContent":["import * as React from \"react\";\r\n\r\n/**\r\n * ReferentielContext — Portnet UI v2\r\n *\r\n * Carries the referential API configuration + a per-searchKey option cache.\r\n * Consumed by useReferentielClient / useReferentielOptions and (later) the\r\n * paginated search builder for ReferentielField.\r\n */\r\n\r\nexport type ReferentielCache = Record<string, unknown>;\r\n\r\ninterface ReferentielCacheSetPayload {\r\n  key: string;\r\n  data: unknown;\r\n}\r\n\r\nexport type ReferentielCacheAction = {\r\n  type: \"SET\";\r\n  payload: ReferentielCacheSetPayload;\r\n};\r\n\r\nexport interface ReferentielContextValue {\r\n  baseURL: string;\r\n  token: string;\r\n  secret: boolean;\r\n  langue: string;\r\n  cache: ReferentielCache;\r\n  cacheDispatch: React.Dispatch<ReferentielCacheAction>;\r\n}\r\n\r\nexport const ReferentielContext = React.createContext<ReferentielContextValue>({\r\n  baseURL: \"\",\r\n  token: \"\",\r\n  secret: false,\r\n  langue: \"fr\",\r\n  cache: {},\r\n  cacheDispatch: () => {},\r\n});\r\n\r\nconst INITIAL_CACHE: ReferentielCache = {};\r\n\r\nfunction cacheReducer(\r\n  state: ReferentielCache,\r\n  { type, payload }: ReferentielCacheAction\r\n): ReferentielCache {\r\n  switch (type) {\r\n    case \"SET\":\r\n      return { ...state, [payload.key]: payload.data };\r\n    default:\r\n      return state;\r\n  }\r\n}\r\n\r\nexport interface ReferentielProviderProps {\r\n  baseURL: string;\r\n  token?: string | undefined;\r\n  secret?: boolean | undefined;\r\n  langue?: string | undefined;\r\n  children?: React.ReactNode | undefined;\r\n}\r\n\r\n/**\r\n * ReferentielProvider\r\n *\r\n * Set once at the app root with the referential API configuration:\r\n *\r\n *   <ReferentielProvider\r\n *     baseURL={config.referentielBaseURL}\r\n *     token={config.referentielToken}\r\n *     secret={config.referentielTypeAuth === \"SECRET\"}\r\n *     langue=\"fr\"\r\n *   >\r\n *     {app}\r\n *   </ReferentielProvider>\r\n *\r\n * Auth contract (see useReferentielClient): secret => the raw token is sent\r\n * in the Authorization header; otherwise a Bearer prefix is used.\r\n */\r\nexport default function ReferentielProvider({\r\n  baseURL,\r\n  token = \"\",\r\n  secret = false,\r\n  langue = \"fr\",\r\n  children,\r\n}: ReferentielProviderProps): React.JSX.Element {\r\n  const [cache, cacheDispatch] = React.useReducer(cacheReducer, INITIAL_CACHE);\r\n\r\n  const value = React.useMemo<ReferentielContextValue>(\r\n    () => ({ baseURL, token, secret, langue, cache, cacheDispatch }),\r\n    [baseURL, token, secret, langue, cache]\r\n  );\r\n\r\n  return (\r\n    <ReferentielContext.Provider value={value}>\r\n      {children}\r\n    </ReferentielContext.Provider>\r\n  );\r\n}\r\n"],"mappings":";;;;;;;;;;;;AAAA,OAAO,KAAKA,KAAK,MAAM,OAAO;;AAE9B;AACA;AACA;AACA;AACA;AACA;AACA;AANA,SAAAC,GAAA,IAAAC,IAAA;AA6BA,OAAO,IAAMC,kBAAkB,gBAAGH,KAAK,CAACI,aAAa,CAA0B;EAC7EC,OAAO,EAAE,EAAE;EACXC,KAAK,EAAE,EAAE;EACTC,MAAM,EAAE,KAAK;EACbC,MAAM,EAAE,IAAI;EACZC,KAAK,EAAE,CAAC,CAAC;EACTC,aAAa,EAAE,SAAAA,cAAA,EAAM,CAAC;AACxB,CAAC,CAAC;AAEF,IAAMC,aAA+B,GAAG,CAAC,CAAC;AAE1C,SAASC,YAAYA,CACnBC,KAAuB,EAAAC,IAAA,EAEL;EAAA,IADhBC,IAAI,GAAAD,IAAA,CAAJC,IAAI;IAAEC,OAAO,GAAAF,IAAA,CAAPE,OAAO;EAEf,QAAQD,IAAI;IACV,KAAK,KAAK;MACR,OAAAE,aAAA,CAAAA,aAAA,KAAYJ,KAAK,OAAAK,eAAA,KAAGF,OAAO,CAACG,GAAG,EAAGH,OAAO,CAACI,IAAI;IAChD;MACE,OAAOP,KAAK;EAChB;AACF;AAUA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,eAAe,SAASQ,mBAAmBA,CAAAC,KAAA,EAMK;EAAA,IAL9CjB,OAAO,GAAAiB,KAAA,CAAPjB,OAAO;IAAAkB,WAAA,GAAAD,KAAA,CACPhB,KAAK;IAALA,KAAK,GAAAiB,WAAA,cAAG,EAAE,GAAAA,WAAA;IAAAC,YAAA,GAAAF,KAAA,CACVf,MAAM;IAANA,MAAM,GAAAiB,YAAA,cAAG,KAAK,GAAAA,YAAA;IAAAC,YAAA,GAAAH,KAAA,CACdd,MAAM;IAANA,MAAM,GAAAiB,YAAA,cAAG,IAAI,GAAAA,YAAA;IACbC,QAAQ,GAAAJ,KAAA,CAARI,QAAQ;EAER,IAAAC,iBAAA,GAA+B3B,KAAK,CAAC4B,UAAU,CAAChB,YAAY,EAAED,aAAa,CAAC;IAAAkB,kBAAA,GAAAC,cAAA,CAAAH,iBAAA;IAArElB,KAAK,GAAAoB,kBAAA;IAAEnB,aAAa,GAAAmB,kBAAA;EAE3B,IAAME,KAAK,GAAG/B,KAAK,CAACgC,OAAO,CACzB;IAAA,OAAO;MAAE3B,OAAO,EAAPA,OAAO;MAAEC,KAAK,EAALA,KAAK;MAAEC,MAAM,EAANA,MAAM;MAAEC,MAAM,EAANA,MAAM;MAAEC,KAAK,EAALA,KAAK;MAAEC,aAAa,EAAbA;IAAc,CAAC;EAAA,CAAC,EAChE,CAACL,OAAO,EAAEC,KAAK,EAAEC,MAAM,EAAEC,MAAM,EAAEC,KAAK,CACxC,CAAC;EAED,oBACEP,IAAA,CAACC,kBAAkB,CAAC8B,QAAQ;IAACF,KAAK,EAAEA,KAAM;IAAAL,QAAA,EACvCA;EAAQ,CACkB,CAAC;AAElC","ignoreList":[]}
+{"version":3,"file":"ReferentielProvider.js","names":["React","jsx","_jsx","ReferentielContext","createContext","baseURL","token","secret","langue","cache","cacheDispatch","INITIAL_CACHE","cacheReducer","state","type","payload","key","data","ReferentielProvider","children","useReducer","value","useMemo","Provider"],"sources":["../../../../src/lib/v2/referentiel/ReferentielProvider.tsx"],"sourcesContent":["import * as React from \"react\";\r\n\r\n/**\r\n * ReferentielContext — Portnet UI v2\r\n *\r\n * Carries the referential API configuration + a per-searchKey option cache.\r\n * Consumed by useReferentielClient / useReferentielOptions and (later) the\r\n * paginated search builder for ReferentielField.\r\n */\r\n\r\nexport type ReferentielCache = Record<string, unknown>;\r\n\r\ninterface ReferentielCacheSetPayload {\r\n  key: string;\r\n  data: unknown;\r\n}\r\n\r\nexport type ReferentielCacheAction = {\r\n  type: \"SET\";\r\n  payload: ReferentielCacheSetPayload;\r\n};\r\n\r\nexport interface ReferentielContextValue {\r\n  baseURL: string;\r\n  token: string;\r\n  secret: boolean;\r\n  langue: string;\r\n  cache: ReferentielCache;\r\n  cacheDispatch: React.Dispatch<ReferentielCacheAction>;\r\n}\r\n\r\nexport const ReferentielContext = React.createContext<ReferentielContextValue>({\r\n  baseURL: \"\",\r\n  token: \"\",\r\n  secret: false,\r\n  langue: \"fr\",\r\n  cache: {},\r\n  cacheDispatch: () => {},\r\n});\r\n\r\nconst INITIAL_CACHE: ReferentielCache = {};\r\n\r\nfunction cacheReducer(\r\n  state: ReferentielCache,\r\n  { type, payload }: ReferentielCacheAction\r\n): ReferentielCache {\r\n  switch (type) {\r\n    case \"SET\":\r\n      return { ...state, [payload.key]: payload.data };\r\n    default:\r\n      return state;\r\n  }\r\n}\r\n\r\nexport interface ReferentielProviderProps {\r\n  baseURL: string;\r\n  token?: string | undefined;\r\n  secret?: boolean | undefined;\r\n  langue?: string | undefined;\r\n  children?: React.ReactNode | undefined;\r\n}\r\n\r\n/**\r\n * ReferentielProvider\r\n *\r\n * Set once at the app root with the referential API configuration:\r\n *\r\n *   <ReferentielProvider\r\n *     baseURL={config.referentielBaseURL}\r\n *     token={config.referentielToken}\r\n *     secret={config.referentielTypeAuth === \"SECRET\"}\r\n *     langue=\"fr\"\r\n *   >\r\n *     {app}\r\n *   </ReferentielProvider>\r\n *\r\n * Auth contract (see useReferentielClient): secret => the raw token is sent\r\n * in the Authorization header; otherwise a Bearer prefix is used.\r\n */\r\nexport default function ReferentielProvider({\r\n  baseURL,\r\n  token = \"\",\r\n  secret = false,\r\n  langue = \"fr\",\r\n  children,\r\n}: ReferentielProviderProps): React.JSX.Element {\r\n  const [cache, cacheDispatch] = React.useReducer(cacheReducer, INITIAL_CACHE);\r\n\r\n  const value = React.useMemo<ReferentielContextValue>(\r\n    () => ({ baseURL, token, secret, langue, cache, cacheDispatch }),\r\n    [baseURL, token, secret, langue, cache]\r\n  );\r\n\r\n  return (\r\n    <ReferentielContext.Provider value={value}>\r\n      {children}\r\n    </ReferentielContext.Provider>\r\n  );\r\n}\r\n"],"mappings":"AAAA,OAAO,KAAKA,KAAK,MAAM,OAAO;;AAE9B;AACA;AACA;AACA;AACA;AACA;AACA;AANA,SAAAC,GAAA,IAAAC,IAAA;AA6BA,OAAO,MAAMC,kBAAkB,gBAAGH,KAAK,CAACI,aAAa,CAA0B;EAC7EC,OAAO,EAAE,EAAE;EACXC,KAAK,EAAE,EAAE;EACTC,MAAM,EAAE,KAAK;EACbC,MAAM,EAAE,IAAI;EACZC,KAAK,EAAE,CAAC,CAAC;EACTC,aAAa,EAAEA,CAAA,KAAM,CAAC;AACxB,CAAC,CAAC;AAEF,MAAMC,aAA+B,GAAG,CAAC,CAAC;AAE1C,SAASC,YAAYA,CACnBC,KAAuB,EACvB;EAAEC,IAAI;EAAEC;AAAgC,CAAC,EACvB;EAClB,QAAQD,IAAI;IACV,KAAK,KAAK;MACR,OAAO;QAAE,GAAGD,KAAK;QAAE,CAACE,OAAO,CAACC,GAAG,GAAGD,OAAO,CAACE;MAAK,CAAC;IAClD;MACE,OAAOJ,KAAK;EAChB;AACF;AAUA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,eAAe,SAASK,mBAAmBA,CAAC;EAC1Cb,OAAO;EACPC,KAAK,GAAG,EAAE;EACVC,MAAM,GAAG,KAAK;EACdC,MAAM,GAAG,IAAI;EACbW;AACwB,CAAC,EAAqB;EAC9C,MAAM,CAACV,KAAK,EAAEC,aAAa,CAAC,GAAGV,KAAK,CAACoB,UAAU,CAACR,YAAY,EAAED,aAAa,CAAC;EAE5E,MAAMU,KAAK,GAAGrB,KAAK,CAACsB,OAAO,CACzB,OAAO;IAAEjB,OAAO;IAAEC,KAAK;IAAEC,MAAM;IAAEC,MAAM;IAAEC,KAAK;IAAEC;EAAc,CAAC,CAAC,EAChE,CAACL,OAAO,EAAEC,KAAK,EAAEC,MAAM,EAAEC,MAAM,EAAEC,KAAK,CACxC,CAAC;EAED,oBACEP,IAAA,CAACC,kBAAkB,CAACoB,QAAQ;IAACF,KAAK,EAAEA,KAAM;IAAAF,QAAA,EACvCA;EAAQ,CACkB,CAAC;AAElC","ignoreList":[]}

package/dist/esm/v2/referentiel/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/v2/referentiel/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../../../../src/lib/v2/referentiel/types.ts"],"sourcesContent":["/**\r\n * @portnet/ui v2 — Referentiel data-access types (canonical).\r\n *\r\n * ─────────────────────────────────────────────────────────────────────────\r\n * WHY THIS FILE EXISTS (Area 2 audit — duplicate public models)\r\n *\r\n * `useReferentielSearch.ts` and `useReferentielOptions.ts` used to declare\r\n * their request/response contracts inline, and `models/referentiel.ts`\r\n * (the public catalog surfaced at `@portnet/ui/v2`) independently REDECLARED\r\n * the same concepts under the same or parallel names. The two had already\r\n * drifted: the public `ReferentielSearchArgs` (reachable via\r\n * `import type { ReferentielSearchArgs } from \"@portnet/ui/v2\"`) was missing\r\n * `sort`, a field the real search function built by `useReferentielSearch`\r\n * accepts and forwards — so a host typing a variable against the exported\r\n * type could not see a field the function actually uses.\r\n *\r\n * Centralising the contracts here and having both the hooks and\r\n * `models/referentiel.ts` alias them removes the possibility of that drift\r\n * recurring. This is the single source of truth; `useReferentielSearch.ts`\r\n * and `useReferentielOptions.ts` re-export from here for backward\r\n * compatibility with existing import sites (`referentiel/index.ts`,\r\n * direct deep imports), and `models/referentiel.ts` aliases the same names.\r\n * ─────────────────────────────────────────────────────────────────────────\r\n */\r\nimport type { SortDescriptor } from \"../types/common\";\r\n\r\n/** Response envelope for the paginated referential endpoint (getPage). */\r\nexport interface ReferentielGetPageResponse<TItem = unknown> {\r\n  succes?: boolean | undefined;\r\n  results: TItem[];\r\n  totalElements: number;\r\n  message?: string | undefined;\r\n}\r\n\r\n/** Response envelope for the \"simple\" referential endpoint (getAll). */\r\nexport interface ReferentielGetAllResponse<T = unknown> {\r\n  succes?: boolean | undefined;\r\n  results?: T[] | undefined;\r\n  message?: string | undefined;\r\n}\r\n\r\n/**\r\n * Arguments accepted by the search function returned from\r\n * {@link useReferentielSearch}.\r\n *\r\n * Every member is `?: T | undefined` rather than plain `?: T`. This is\r\n * REQUIRED for the documented composition below to type-check under\r\n * `exactOptionalPropertyTypes: true` — which the Platform TypeScript\r\n * Guidelines make mandatory:\r\n *\r\n *   const search = useReferentielSearch<Operateur>({ path: \"operateurImpExp\" });\r\n *   <FormikReferentielField search={search} … />\r\n *\r\n * ReferentielField invokes `search` with `ReferentielSearchParams`, whose\r\n * `sort` is declared `SortDescriptor[] | undefined` (a REQUIRED property that\r\n * may hold undefined). Under exactOptionalPropertyTypes a target member typed\r\n * `sort?: SortDescriptor[]` means \"absent, or an array — never undefined\", so\r\n * that argument was not assignable and the socle's own documented pairing\r\n * failed to compile in every strict-mode host. Widening here fixes the\r\n * composition once for the whole fleet instead of pushing a local adapter\r\n * into each consuming module.\r\n *\r\n * Type-only and permissive-only: no runtime change, no caller broken.\r\n */\r\nexport interface ReferentielSearchArgs<TCriteria = Record<string, unknown>> {\r\n  /** ReferentielField criteria (mapped to request-body fields). */\r\n  criteria?: TCriteria | undefined;\r\n  /** 1-based page (forwarded to the API as 0-based `pageNumber`). */\r\n  page?: number | undefined;\r\n  /** Page size (default 5). */\r\n  pageSize?: number | undefined;\r\n  /** Sort descriptors — accepted for API parity; forwarding is host-driven. */\r\n  sort?: SortDescriptor[] | undefined;\r\n}\r\n\r\n/** One page of referential results. */\r\nexport interface ReferentielSearchResult<TItem = unknown> {\r\n  items: TItem[];\r\n  total: number;\r\n}\r\n\r\n/** The paginated search function powering ReferentielField / FormikReferentielField. */\r\nexport type ReferentielSearchFn<\r\n  TItem = unknown,\r\n  TCriteria = Record<string, unknown>,\r\n> = (\r\n  args?: ReferentielSearchArgs<TCriteria>,\r\n) => Promise<ReferentielSearchResult<TItem>>;\r\n\r\n/** Arguments for {@link useReferentielSearch}. */\r\nexport interface UseReferentielSearchParams<\r\n  TCriteria extends Record<string, unknown> = Record<string, unknown>,\r\n> {\r\n  /** API segment, e.g. \"operateurImpExp\" -> POST /api/operateurImpExp/getPage. */\r\n  path?: string | undefined;\r\n  /** Extra request-body fields merged into every page request. */\r\n  specifications?: Record<string, unknown> | undefined;\r\n  /** Maps ReferentielField criteria -> request-body fields (default: spread as-is). */\r\n  mapCriteria?: ((\r\n    criteria: TCriteria | undefined,\r\n  ) => Record<string, unknown> | undefined) | undefined;\r\n}\r\n\r\n/** Arguments for {@link useReferentielOptions}. */\r\nexport interface UseReferentielOptionsParams<T = unknown> {\r\n  /** Referential key (cleReferentiel). When empty, nothing is fetched. */\r\n  searchKey?: string | undefined;\r\n  /** Overrides the provider `langue`. */\r\n  langue?: string | undefined;\r\n  /** Extra request-body fields merged into the getAll payload. */\r\n  specifications?: Record<string, unknown> | undefined;\r\n  /** Client-side option filter (defaults to pass-through). */\r\n  filterFunc?: ((option: T) => boolean) | undefined;\r\n}\r\n\r\n/** Result of {@link useReferentielOptions}. */\r\nexport interface UseReferentielOptionsResult<T = unknown> {\r\n  options: T[];\r\n  loading: boolean;\r\n  error: Error | null;\r\n}\r\n"],"mappings":"","ignoreList":[]}

package/dist/esm/v2/referentiel/useReferentielClient.js

@@ -15,20 +15,19 @@ import { ReferentielContext } from "./ReferentielProvider";
  * @returns A memoised {@link AxiosInstance} for the referential API.
  */
 export default function useReferentielClient() {
-  var _React$useContext = React.useContext(ReferentielContext),
-    baseURL = _React$useContext.baseURL,
-    token = _React$useContext.token,
-    secret = _React$useContext.secret;
-  return React.useMemo(function () {
-    var instance = axios.create({
-      baseURL: baseURL,
+  const {
+    baseURL,
+    token,
+    secret
+  } = React.useContext(ReferentielContext);
+  return React.useMemo(() => {
+    const instance = axios.create({
+      baseURL,
       headers: {
-        Authorization: secret ? token : "Bearer ".concat(token)
+        Authorization: secret ? token : `Bearer ${token}`
       }
     });
-    instance.interceptors.response.use(function (response) {
-      return response;
-    }, function (error) {
+    instance.interceptors.response.use(response => response, error => {
       throw error;
     });
     return instance;

package/dist/esm/v2/referentiel/useReferentielClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"useReferentielClient.js","names":["React","axios","ReferentielContext","useReferentielClient","_React$useContext","useContext","baseURL","token","secret","useMemo","instance","create","headers","Authorization","concat","interceptors","response","use","error"],"sources":["../../../../src/lib/v2/referentiel/useReferentielClient.ts"],"sourcesContent":["import * as React from \"react\";\r\nimport axios from \"axios\";\r\nimport type { AxiosInstance, AxiosResponse } from \"axios\";\r\nimport { ReferentielContext } from \"./ReferentielProvider\";\r\n\r\n/**\r\n * useReferentielClient — Portnet UI v2\r\n *\r\n * Returns a memoised axios instance targeting the referential API, configured\r\n * from ReferentielProvider. Auth mirrors the legacy contract:\r\n *   - secret === true  -> Authorization: <token>        (raw, e.g. SECRET keys)\r\n *   - secret === false -> Authorization: Bearer <token>\r\n *\r\n * Re-created only when baseURL / token / secret change.\r\n *\r\n * @returns A memoised {@link AxiosInstance} for the referential API.\r\n */\r\nexport default function useReferentielClient(): AxiosInstance {\r\n  const { baseURL, token, secret } = React.useContext(ReferentielContext);\r\n\r\n  return React.useMemo<AxiosInstance>(() => {\r\n    const instance = axios.create({\r\n      baseURL,\r\n      headers: { Authorization: secret ? token : `Bearer ${token}` },\r\n    });\r\n    instance.interceptors.response.use(\r\n      (response: AxiosResponse) => response,\r\n      (error: unknown) => {\r\n        throw error;\r\n      },\r\n    );\r\n    return instance;\r\n  }, [baseURL, token, secret]);\r\n}\r\n"],"mappings":"AAAA,OAAO,KAAKA,KAAK,MAAM,OAAO;AAC9B,OAAOC,KAAK,MAAM,OAAO;AAEzB,SAASC,kBAAkB,QAAQ,uBAAuB;;AAE1D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,eAAe,SAASC,oBAAoBA,CAAA,EAAkB;EAC5D,IAAAC,iBAAA,GAAmCJ,KAAK,CAACK,UAAU,CAACH,kBAAkB,CAAC;IAA/DI,OAAO,GAAAF,iBAAA,CAAPE,OAAO;IAAEC,KAAK,GAAAH,iBAAA,CAALG,KAAK;IAAEC,MAAM,GAAAJ,iBAAA,CAANI,MAAM;EAE9B,OAAOR,KAAK,CAACS,OAAO,CAAgB,YAAM;IACxC,IAAMC,QAAQ,GAAGT,KAAK,CAACU,MAAM,CAAC;MAC5BL,OAAO,EAAPA,OAAO;MACPM,OAAO,EAAE;QAAEC,aAAa,EAAEL,MAAM,GAAGD,KAAK,aAAAO,MAAA,CAAaP,KAAK;MAAG;IAC/D,CAAC,CAAC;IACFG,QAAQ,CAACK,YAAY,CAACC,QAAQ,CAACC,GAAG,CAChC,UAACD,QAAuB;MAAA,OAAKA,QAAQ;IAAA,GACrC,UAACE,KAAc,EAAK;MAClB,MAAMA,KAAK;IACb,CACF,CAAC;IACD,OAAOR,QAAQ;EACjB,CAAC,EAAE,CAACJ,OAAO,EAAEC,KAAK,EAAEC,MAAM,CAAC,CAAC;AAC9B","ignoreList":[]}
+{"version":3,"file":"useReferentielClient.js","names":["React","axios","ReferentielContext","useReferentielClient","baseURL","token","secret","useContext","useMemo","instance","create","headers","Authorization","interceptors","response","use","error"],"sources":["../../../../src/lib/v2/referentiel/useReferentielClient.ts"],"sourcesContent":["import * as React from \"react\";\r\nimport axios from \"axios\";\r\nimport type { AxiosInstance, AxiosResponse } from \"axios\";\r\nimport { ReferentielContext } from \"./ReferentielProvider\";\r\n\r\n/**\r\n * useReferentielClient — Portnet UI v2\r\n *\r\n * Returns a memoised axios instance targeting the referential API, configured\r\n * from ReferentielProvider. Auth mirrors the legacy contract:\r\n *   - secret === true  -> Authorization: <token>        (raw, e.g. SECRET keys)\r\n *   - secret === false -> Authorization: Bearer <token>\r\n *\r\n * Re-created only when baseURL / token / secret change.\r\n *\r\n * @returns A memoised {@link AxiosInstance} for the referential API.\r\n */\r\nexport default function useReferentielClient(): AxiosInstance {\r\n  const { baseURL, token, secret } = React.useContext(ReferentielContext);\r\n\r\n  return React.useMemo<AxiosInstance>(() => {\r\n    const instance = axios.create({\r\n      baseURL,\r\n      headers: { Authorization: secret ? token : `Bearer ${token}` },\r\n    });\r\n    instance.interceptors.response.use(\r\n      (response: AxiosResponse) => response,\r\n      (error: unknown) => {\r\n        throw error;\r\n      },\r\n    );\r\n    return instance;\r\n  }, [baseURL, token, secret]);\r\n}\r\n"],"mappings":"AAAA,OAAO,KAAKA,KAAK,MAAM,OAAO;AAC9B,OAAOC,KAAK,MAAM,OAAO;AAEzB,SAASC,kBAAkB,QAAQ,uBAAuB;;AAE1D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,eAAe,SAASC,oBAAoBA,CAAA,EAAkB;EAC5D,MAAM;IAAEC,OAAO;IAAEC,KAAK;IAAEC;EAAO,CAAC,GAAGN,KAAK,CAACO,UAAU,CAACL,kBAAkB,CAAC;EAEvE,OAAOF,KAAK,CAACQ,OAAO,CAAgB,MAAM;IACxC,MAAMC,QAAQ,GAAGR,KAAK,CAACS,MAAM,CAAC;MAC5BN,OAAO;MACPO,OAAO,EAAE;QAAEC,aAAa,EAAEN,MAAM,GAAGD,KAAK,GAAG,UAAUA,KAAK;MAAG;IAC/D,CAAC,CAAC;IACFI,QAAQ,CAACI,YAAY,CAACC,QAAQ,CAACC,GAAG,CAC/BD,QAAuB,IAAKA,QAAQ,EACpCE,KAAc,IAAK;MAClB,MAAMA,KAAK;IACb,CACF,CAAC;IACD,OAAOP,QAAQ;EACjB,CAAC,EAAE,CAACL,OAAO,EAAEC,KAAK,EAAEC,MAAM,CAAC,CAAC;AAC9B","ignoreList":[]}