@portnet/ui 6.0.0 → 6.0.2

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

@@ -0,0 +1,64 @@
+/**
+ * @portnet/ui · v2 · User Personalization Foundation
+ * Public surface.
+ *
+ * Import via the dedicated subpath:
+ *   import {
+ *     UserPersonalizationProvider,
+ *     useFavorites,
+ *     useFavoritesView,
+ *     useSavedFilters,
+ *     FavoriteToggle,
+ *   } from "@portnet/ui/v2/personalization";
+ *
+ * Surface is intentionally minimal (architecture doc §2.8 — minimum API
+ * surface). The store handle and the internal selector primitive are NOT
+ * exported; hosts interact through the provider, the capability hooks,
+ * and the capability components.
+ *
+ * The grid-bound composites — SaveFilterDialog / SavedFiltersMenu (saved
+ * filters) and makeFavoriteColumn / FavoritesFilter (favorites) — are
+ * exposed via @portnet/ui/v2 (patterns/), not re-exported here, so the
+ * personalization barrel never imports from patterns/.
+ */
+
+/* Provider — the single configuration point. */
+export { default as UserPersonalizationProvider } from "./PersonalizationProvider";
+
+/* Built-in storage adapters (a remote adapter will join them, swap-in). */
+export { default as createLocalStorageAdapter } from "./adapters/createLocalStorageAdapter";
+export { default as createMemoryAdapter } from "./adapters/createMemoryAdapter";
+
+/* Capability registration seam — for custom/host-defined capabilities. */
+export { registerCapability, makeEnvelope } from "./schema";
+
+/* Canonical domain types — the TS contract that replaced the runtime
+ * PropTypes shapes (Scope / Adapter / FavoriteRef / SavedFilter). Type-only:
+ * erased from the runtime bundle. */
+
+/* Favorites capability (Batch 3) + view logic (Batch 5). */
+export { useFavorites, useIsFavorite, FAVORITES_CAPABILITY_ID } from "./capabilities/favorites";
+export { useFavoritesView, filterRowsByFavorites, sortRowsByFavorites, FAVORITES_FILTER, FAVORITES_SORT } from "./capabilities/favoritesView";
+export { default as FavoriteToggle } from "../components/FavoriteToggle";
+
+/* Saved filters capability (Batch 4). Composites in v2 patterns/. */
+export { useSavedFilters, SAVED_FILTERS_CAPABILITY_ID } from "./capabilities/savedFilters";
+
+/**
+ * Grid preferences capability (gap G-35) — per-user, per-resource hidden
+ * columns.
+ *
+ * `DataGridToolbar` owns the column-visibility UI but holds no state, so every
+ * host persisted the choice itself in a bare `localStorage` key, which is NOT
+ * user-scoped — unlike this foundation's `…:{userId}:{capabilityId}` scheme.
+ * On a shared workstation one user inherited another's hidden columns.
+ *
+ * A host could not fix it: `registerCapability` is exported below as a seam
+ * "for custom/host-defined capabilities", but `usePersonalizationStore` and
+ * `useStoreSelector` are deliberately private (§2.8, minimum API surface), so
+ * a registered capability had no way to be read or written. The seam is
+ * advertised without being complete; until that is resolved, a new capability
+ * has to ship here.
+ */
+export { useGridPreferences, GRID_PREFERENCES_CAPABILITY_ID } from "./capabilities/gridPreferences";
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,108 @@
+/**
+ * personalizationContext — Portnet UI v2 · personalization
+ *
+ * Two contexts, by design (architecture doc §2.5):
+ *   - PersonalizationConfigContext : STABLE config { scope, labels }, set
+ *     once by the provider. Low churn.
+ *   - PersonalizationStoreContext  : the store handle. Mutable preference
+ *     state NEVER travels through context — it is read via
+ *     useSyncExternalStore selectors. A component toggling a favorite
+ *     cannot re-render a component reading saved filters.
+ *
+ * `useStoreSelector` is the internal subscription primitive: a
+ * useSyncExternalStore wrapper that caches by (snapshot, selector) and
+ * supports an optional equality function so derived/object selections stay
+ * referentially stable. It is NOT exported from the public surface — the
+ * capability slices (Batch 3/4) consume it; hosts use the capability hooks.
+ */
+
+import * as React from "react";
+
+/**
+ * Merged label bag (provider defaults + host overrides). The concrete
+ * default values live in DEFAULT_PERSONALIZATION_LABELS in the provider;
+ * this is the canonical type both the provider and the capability slices
+ * import.
+ */
+
+/** Stable configuration carried by PersonalizationConfigContext. */
+
+export var PersonalizationConfigContext = /*#__PURE__*/React.createContext(null);
+export var PersonalizationStoreContext = /*#__PURE__*/React.createContext(null);
+export function usePersonalizationConfig() {
+  var ctx = React.useContext(PersonalizationConfigContext);
+  if (!ctx) {
+    throw new Error("[@portnet/ui v2] usePersonalizationConfig() must be used inside <UserPersonalizationProvider>.");
+  }
+  return ctx;
+}
+
+/** The store handle. */
+export function usePersonalizationStore() {
+  var store = React.useContext(PersonalizationStoreContext);
+  if (!store) {
+    throw new Error("[@portnet/ui v2] personalization hooks must be used inside <UserPersonalizationProvider>.");
+  }
+  return store;
+}
+
+/** Convenience: the current scope. */
+export function useScope() {
+  return usePersonalizationConfig().scope;
+}
+
+/** Convenience: merged labels (provider defaults + host overrides). */
+export function usePersonalizationLabels() {
+  return usePersonalizationConfig().labels;
+}
+/**
+ * Subscribe to the store with a selector. Returns a referentially stable
+ * value when the selected slice is unchanged — required by
+ * useSyncExternalStore and the basis of the no-cross-capability-re-render
+ * guarantee.
+ *
+ * The cache is keyed on (snapshot identity, selector identity, isEqual
+ * identity). When the snapshot is unchanged for the same selector, the
+ * memoised selection is returned without re-running the selector. When the
+ * snapshot changes, the selector re-runs; if `isEqual` is supplied and the
+ * new value is equal to the previous one, the previous reference is kept.
+ *
+ * Selectors should be stable (e.g. useCallback) OR rely on the store's
+ * structural sharing returning stable slice references — both keep this
+ * loop-free.
+ */
+export function useStoreSelector(selector, isEqual) {
+  var store = usePersonalizationStore();
+  var cacheRef = React.useRef(null);
+  function getSelection() {
+    var snapshot = store.getSnapshot();
+    var cache = cacheRef.current;
+    if (cache && Object.is(cache.snapshot, snapshot) && cache.selector === selector && cache.isEqual === isEqual) {
+      return cache.selection;
+    }
+    var nextSelection = selector(snapshot);
+    if (cache && cache.hasValue && typeof isEqual === "function" && isEqual(cache.selection, nextSelection)) {
+      cacheRef.current = {
+        snapshot: snapshot,
+        selector: selector,
+        isEqual: isEqual,
+        selection: cache.selection,
+        hasValue: true
+      };
+      return cache.selection;
+    }
+    cacheRef.current = {
+      snapshot: snapshot,
+      selector: selector,
+      isEqual: isEqual,
+      selection: nextSelection,
+      hasValue: true
+    };
+    return nextSelection;
+  }
+  function getServerSelection() {
+    return selector(store.getServerSnapshot());
+  }
+  return React.useSyncExternalStore(store.subscribe, getSelection, getServerSelection);
+}
+//# sourceMappingURL=personalizationContext.js.map

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

@@ -0,0 +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":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAO,KAAKA,KAAK,MAAM,OAAO;;AAQ9B;AACA;AACA;AACA;AACA;AACA;;AAwBA;;AAMA,OAAO,IAAMC,4BAA4B,gBACvCD,KAAK,CAACE,aAAa,CAA+B,IAAI,CAAC;AACzD,OAAO,IAAMC,2BAA2B,gBACtCH,KAAK,CAACE,aAAa,CAA8B,IAAI,CAAC;AAExD,OAAO,SAASE,wBAAwBA,CAAA,EAA0B;EAChE,IAAMC,GAAG,GAAGL,KAAK,CAACM,UAAU,CAACL,4BAA4B,CAAC;EAC1D,IAAI,CAACI,GAAG,EAAE;IACR,MAAM,IAAIE,KAAK,CACb,gGACF,CAAC;EACH;EACA,OAAOF,GAAG;AACZ;;AAEA;AACA,OAAO,SAASG,uBAAuBA,CAAA,EAAyB;EAC9D,IAAMC,KAAK,GAAGT,KAAK,CAACM,UAAU,CAACH,2BAA2B,CAAC;EAC3D,IAAI,CAACM,KAAK,EAAE;IACV,MAAM,IAAIF,KAAK,CACb,2FACF,CAAC;EACH;EACA,OAAOE,KAAK;AACd;;AAEA;AACA,OAAO,SAASC,QAAQA,CAAA,EAAU;EAChC,OAAON,wBAAwB,CAAC,CAAC,CAACO,KAAK;AACzC;;AAEA;AACA,OAAO,SAASC,wBAAwBA,CAAA,EAA0B;EAChE,OAAOR,wBAAwB,CAAC,CAAC,CAACS,MAAM;AAC1C;AAUA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAC9BC,QAAkD,EAClDC,OAAiC,EAC9B;EACH,IAAMP,KAAK,GAAGD,uBAAuB,CAAC,CAAC;EACvC,IAAMS,QAAQ,GAAGjB,KAAK,CAACkB,MAAM,CAA0B,IAAI,CAAC;EAE5D,SAASC,YAAYA,CAAA,EAAM;IACzB,IAAMC,QAAQ,GAAGX,KAAK,CAACY,WAAW,CAAC,CAAC;IACpC,IAAMC,KAAK,GAAGL,QAAQ,CAACM,OAAO;IAC9B,IACED,KAAK,IACLE,MAAM,CAACC,EAAE,CAACH,KAAK,CAACF,QAAQ,EAAEA,QAAQ,CAAC,IACnCE,KAAK,CAACP,QAAQ,KAAKA,QAAQ,IAC3BO,KAAK,CAACN,OAAO,KAAKA,OAAO,EACzB;MACA,OAAOM,KAAK,CAACI,SAAS;IACxB;IACA,IAAMC,aAAa,GAAGZ,QAAQ,CAACK,QAAQ,CAAC;IACxC,IACEE,KAAK,IACLA,KAAK,CAACM,QAAQ,IACd,OAAOZ,OAAO,KAAK,UAAU,IAC7BA,OAAO,CAACM,KAAK,CAACI,SAAS,EAAEC,aAAa,CAAC,EACvC;MACAV,QAAQ,CAACM,OAAO,GAAG;QACjBH,QAAQ,EAAEA,QAAQ;QAClBL,QAAQ,EAAEA,QAAQ;QAClBC,OAAO,EAAEA,OAAO;QAChBU,SAAS,EAAEJ,KAAK,CAACI,SAAS;QAC1BE,QAAQ,EAAE;MACZ,CAAC;MACD,OAAON,KAAK,CAACI,SAAS;IACxB;IACAT,QAAQ,CAACM,OAAO,GAAG;MACjBH,QAAQ,EAAEA,QAAQ;MAClBL,QAAQ,EAAEA,QAAQ;MAClBC,OAAO,EAAEA,OAAO;MAChBU,SAAS,EAAEC,aAAa;MACxBC,QAAQ,EAAE;IACZ,CAAC;IACD,OAAOD,aAAa;EACtB;EAEA,SAASE,kBAAkBA,CAAA,EAAM;IAC/B,OAAOd,QAAQ,CAACN,KAAK,CAACqB,iBAAiB,CAAC,CAAC,CAAC;EAC5C;EAEA,OAAO9B,KAAK,CAAC+B,oBAAoB,CAC/BtB,KAAK,CAACuB,SAAS,EACfb,YAAY,EACZU,kBACF,CAAC;AACH","ignoreList":[]}

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

@@ -0,0 +1,92 @@
+/**
+ * schema — Portnet UI v2 · User Personalization Foundation
+ *
+ * Capability registry + persistence envelope. The foundation is deliberately
+ * capability-AGNOSTIC: the store and provider know nothing about "favorites"
+ * or "savedFilters". Each capability *slice* registers itself here at import
+ * time:
+ *
+ *   import { registerCapability } from "../schema";
+ *   registerCapability({
+ *     id: "favorites",
+ *     schemaVersion: 1,
+ *     defaultState: Object.freeze({}),
+ *     migrate: (fromVersion, payload) => payload,
+ *   });
+ *
+ * Adding a new capability is therefore purely additive. The adapter persists
+ * the OPAQUE envelope; the `payload` shape is owned by the slice.
+ */
+
+var isDev = typeof process !== "undefined" && !!process.env && process.env["NODE_ENV"] !== "production";
+
+/** A capability's migrate function: upgrade an old payload to the current version. */
+
+/** Registration input for a capability slice. */
+
+/** Frozen, normalised capability descriptor stored in the registry. */
+
+/** id -> frozen descriptor. Module-level (same lifecycle model as useDensity's store). */
+var registry = new Map();
+
+/**
+ * Register a capability descriptor. Idempotent: the first registration for an
+ * id wins; a second registration with a *different* schemaVersion is reported
+ * in development (usually two library copies or a mismatched host version).
+ */
+export function registerCapability(descriptor) {
+  if (!descriptor || typeof descriptor.id !== "string" || !descriptor.id) {
+    if (isDev) {
+      // eslint-disable-next-line no-console
+      console.warn("[@portnet/ui v2] registerCapability: a non-empty string `id` is required.");
+    }
+    return null;
+  }
+  var 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)) {
+      // 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.");
+    }
+    return existing;
+  }
+  var frozen = Object.freeze({
+    id: descriptor.id,
+    schemaVersion: typeof descriptor.schemaVersion === "number" ? descriptor.schemaVersion : 1,
+    defaultState: descriptor.defaultState !== undefined ? descriptor.defaultState : Object.freeze({}),
+    migrate: typeof descriptor.migrate === "function" ? descriptor.migrate : null
+  });
+  registry.set(frozen.id, frozen);
+  return frozen;
+}
+
+/** @returns the descriptor registered for `id`, or null. */
+export function getCapability(id) {
+  return registry.get(id) || null;
+}
+
+/** @returns every registered descriptor (snapshot array). */
+export function getRegisteredCapabilities() {
+  return Array.from(registry.values());
+}
+
+/**
+ * Build the versioned persistence envelope. The adapter treats `payload` as
+ * opaque; `schemaVersion` lets a slice's migrate() upgrade old payloads on load.
+ */
+export function makeEnvelope(schemaVersion, payload) {
+  return {
+    schemaVersion: typeof schemaVersion === "number" ? schemaVersion : 1,
+    updatedAt: new Date().toISOString(),
+    payload: payload
+  };
+}
+
+/**
+ * Key-scheme version (the layout of the *storage key*, distinct from a
+ * capability's payload `schemaVersion`). Bumped only on a global re-partition.
+ * Mirrored by adapters/_storageKey.ts.
+ */
+export var KEY_SCHEME_VERSION = "v1";
+//# sourceMappingURL=schema.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../../../../src/lib/v2/personalization/types.ts"],"sourcesContent":["/**\r\n * types — Portnet UI v2 · User Personalization Foundation\r\n *\r\n * Canonical TypeScript contracts for the personalization foundation. Replaces\r\n * the former runtime propTypes.js \"type surface\": the provider, the\r\n * store-backed hooks, and the capability components all type against these\r\n * shared interfaces.\r\n */\r\n\r\nimport type { RowId } from \"../types/common\";\r\n\r\n/**\r\n * Scope — partitions persisted preferences. `userId` is required; the rest\r\n * are optional partitions (multi-tenant / per-app).\r\n */\r\nexport interface Scope {\r\n  userId: string;\r\n  tenantId?: string | undefined;\r\n  appId?: string | undefined;\r\n}\r\n\r\n/**\r\n * Versioned persistence envelope. The adapter treats `payload` as opaque;\r\n * `schemaVersion` lets a capability slice migrate old payloads on load.\r\n */\r\nexport interface Envelope<T = unknown> {\r\n  schemaVersion: number;\r\n  updatedAt: string;\r\n  payload: T;\r\n}\r\n\r\n/** Behaviour flags an adapter advertises to the store. */\r\nexport interface AdapterCapabilities {\r\n  crossTab?: boolean | undefined;\r\n  remote?: boolean | undefined;\r\n  shared?: boolean | undefined;\r\n}\r\n\r\n/**\r\n * Storage adapter contract. `load` + `save` are mandatory; the rest are\r\n * optional capabilities the store feature-detects:\r\n *   - loadSync   : synchronous hydrate (removes the initial empty flash for\r\n *                  local adapters; absent on remote adapters)\r\n *   - remove     : drop one capability blob\r\n *   - subscribe  : external-change notifications (cross-tab / server push);\r\n *                  returns an unsubscribe function\r\n *   - capabilities : { crossTab, remote, shared } behaviour flags\r\n *\r\n * `load` / `loadSync` return a map of capabilityId -> envelope for the scope.\r\n */\r\nexport interface Adapter {\r\n  name?: string | undefined;\r\n  load: (scope: Scope) => Promise<Record<string, Envelope>>;\r\n  loadSync?: ((scope: Scope) => Record<string, Envelope>) | undefined;\r\n  save: (\r\n    scope: Scope,\r\n    capabilityId: string,\r\n    envelope: Envelope\r\n  ) => Promise<void>;\r\n  remove?: ((scope: Scope, capabilityId: string) => Promise<void>) | undefined;\r\n  subscribe?: ((\r\n    scope: Scope,\r\n    onChange: (capabilityId: string) => void\r\n  ) => () => void) | undefined;\r\n  capabilities?: AdapterCapabilities | undefined;\r\n}\r\n\r\n/** Reconciliation strategy between optimistic local state and adapter truth. */\r\nexport type HydrateStrategy = \"local-wins\" | \"remote-wins\" | \"merge\";\r\n\r\n/**\r\n * Favorites — a single favorited entity reference. `id` is the business row\r\n * id; `addedAt` enables future \"recently favorited\" ordering.\r\n */\r\nexport interface FavoriteRef {\r\n  id: RowId;\r\n  addedAt?: string | undefined;\r\n}\r\n\r\n/**\r\n * Saved filter. `criteria` is opaque — the host's own filter payload,\r\n * persisted and re-emitted verbatim so the framework stays reusable across\r\n * every list regardless of its filter schema.\r\n */\r\nexport interface SavedFilter {\r\n  id: string;\r\n  name?: string | undefined;\r\n  resourceKey?: string | undefined;\r\n  criteria?: Record<string, unknown> | undefined;\r\n  ownerId?: string | undefined;\r\n  isDefault?: boolean | undefined;\r\n  shared?: boolean | undefined;\r\n  createdAt?: string | undefined;\r\n  updatedAt?: string | undefined;\r\n}\r\n"],"mappings":"","ignoreList":[]}

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

@@ -0,0 +1,87 @@
+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";
+
+/**
+ * ReferentielContext — Portnet UI v2
+ *
+ * Carries the referential API configuration + a per-searchKey option cache.
+ * Consumed by useReferentielClient / useReferentielOptions and (later) the
+ * paginated search builder for ReferentielField.
+ */
+import { jsx as _jsx } from "react/jsx-runtime";
+export var ReferentielContext = /*#__PURE__*/React.createContext({
+  baseURL: "",
+  token: "",
+  secret: false,
+  langue: "fr",
+  cache: {},
+  cacheDispatch: function cacheDispatch() {}
+});
+var INITIAL_CACHE = {};
+function cacheReducer(state, _ref) {
+  var type = _ref.type,
+    payload = _ref.payload;
+  switch (type) {
+    case "SET":
+      return _objectSpread(_objectSpread({}, state), {}, _defineProperty({}, payload.key, payload.data));
+    default:
+      return state;
+  }
+}
+/**
+ * ReferentielProvider
+ *
+ * Set once at the app root with the referential API configuration:
+ *
+ *   <ReferentielProvider
+ *     baseURL={config.referentielBaseURL}
+ *     token={config.referentielToken}
+ *     secret={config.referentielTypeAuth === "SECRET"}
+ *     langue="fr"
+ *   >
+ *     {app}
+ *   </ReferentielProvider>
+ *
+ * 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]);
+  return /*#__PURE__*/_jsx(ReferentielContext.Provider, {
+    value: value,
+    children: children
+  });
+}
+//# sourceMappingURL=ReferentielProvider.js.map

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * Portnet UI v2 — referential data-access module.
+ *
+ * Configuration provider + hooks that back the referential fields:
+ *  - useReferentielOptions: simple searchKey -> option list (getAll, cached).
+ *  - useReferentielSearch:  paginated search builder (getPage) for
+ *                           ReferentielField / FormikReferentielField.
+ * The field UI lives in ../patterns/ReferentielField and
+ * ../patterns/FormikReferentielField.
+ */
+export { default as ReferentielProvider, ReferentielContext } from "./ReferentielProvider";
+export { default as useReferentielClient } from "./useReferentielClient";
+export { default as useReferentielOptions } from "./useReferentielOptions";
+export { default as useReferentielSearch } from "./useReferentielSearch";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["default","ReferentielProvider","ReferentielContext","useReferentielClient","useReferentielOptions","useReferentielSearch"],"sources":["../../../../src/lib/v2/referentiel/index.ts"],"sourcesContent":["/**\r\n * Portnet UI v2 — referential data-access module.\r\n *\r\n * Configuration provider + hooks that back the referential fields:\r\n *  - useReferentielOptions: simple searchKey -> option list (getAll, cached).\r\n *  - useReferentielSearch:  paginated search builder (getPage) for\r\n *                           ReferentielField / FormikReferentielField.\r\n * The field UI lives in ../patterns/ReferentielField and\r\n * ../patterns/FormikReferentielField.\r\n */\r\nexport {\r\n  default as ReferentielProvider,\r\n  ReferentielContext,\r\n} from \"./ReferentielProvider\";\r\nexport type {\r\n  ReferentielContextValue,\r\n  ReferentielProviderProps,\r\n  ReferentielCache,\r\n  ReferentielCacheAction,\r\n} from \"./ReferentielProvider\";\r\n\r\nexport { default as useReferentielClient } from \"./useReferentielClient\";\r\n\r\nexport { default as useReferentielOptions } from \"./useReferentielOptions\";\r\nexport type {\r\n  UseReferentielOptionsParams,\r\n  UseReferentielOptionsResult,\r\n} from \"./useReferentielOptions\";\r\n\r\nexport { default as useReferentielSearch } from \"./useReferentielSearch\";\r\nexport type {\r\n  UseReferentielSearchParams,\r\n  ReferentielSearchArgs,\r\n  ReferentielSearchResult,\r\n  ReferentielSearchFn,\r\n} from \"./useReferentielSearch\";\r\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SACEA,OAAO,IAAIC,mBAAmB,EAC9BC,kBAAkB,QACb,uBAAuB;AAQ9B,SAASF,OAAO,IAAIG,oBAAoB,QAAQ,wBAAwB;AAExE,SAASH,OAAO,IAAII,qBAAqB,QAAQ,yBAAyB;AAM1E,SAASJ,OAAO,IAAIK,oBAAoB,QAAQ,wBAAwB","ignoreList":[]}

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

@@ -0,0 +1,37 @@
+import * as React from "react";
+import axios from "axios";
+import { ReferentielContext } from "./ReferentielProvider";
+
+/**
+ * useReferentielClient — Portnet UI v2
+ *
+ * Returns a memoised axios instance targeting the referential API, configured
+ * from ReferentielProvider. Auth mirrors the legacy contract:
+ *   - secret === true  -> Authorization: <token>        (raw, e.g. SECRET keys)
+ *   - secret === false -> Authorization: Bearer <token>
+ *
+ * Re-created only when baseURL / token / secret change.
+ *
+ * @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,
+      headers: {
+        Authorization: secret ? token : "Bearer ".concat(token)
+      }
+    });
+    instance.interceptors.response.use(function (response) {
+      return response;
+    }, function (error) {
+      throw error;
+    });
+    return instance;
+  }, [baseURL, token, secret]);
+}
+//# sourceMappingURL=useReferentielClient.js.map

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

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