@portnet/ui 5.0.27 → 6.0.0

package/dist/v2/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["_theme","require","_hooks","_utils","_modalContext","_components","_patterns","_personalization","_referentiel","_models","Object","keys","forEach","key","prototype","hasOwnProperty","call","_exportNames","exports","defineProperty","enumerable","get","_types","_getRequireWildcardCache","nodeInterop","WeakMap","cacheBabelInterop","cacheNodeInterop","_interopRequireWildcard","obj","__esModule","_typeof","cache","has","newObj","hasPropertyDescriptor","getOwnPropertyDescriptor","desc","set","VERSION"],"sources":["../../src/lib/v2/index.ts"],"sourcesContent":["/**\r\n * @portnet/ui v2 — Public surface\r\n */\r\n\r\n/**\r\n * Public version constant. MUST stay in sync with package.json `version`.\r\n *\r\n * Audit Batch 6 external (B6-EXT-1): this constant was previously\r\n * stuck at \"0.1.4\" through the v0.2.x and MUI v9 migration cycles —\r\n * a silent metadata drift that broke host introspection (analytics,\r\n * version dashboards, debug reports).\r\n *\r\n * Future: ideally generated at build time from package.json (e.g.\r\n * via babel-plugin-transform-define) to remove the manual-sync\r\n * footgun. Tracked as Batch 7 P3 follow-up (R19 migration backlog).\r\n */\r\nexport const VERSION = \"0.8.0-react19.1\";\r\n\r\nexport * as tokens from \"./tokens\";\r\n\r\nexport {\r\n  createPortnetTheme,\r\n  getCssVariables,\r\n  injectCssVariables,\r\n  removeCssVariables,\r\n} from \"./theme\";\r\n\r\n/**\r\n * Theme factory typed contract (see ./theme for the rationale). Surfaced at\r\n * the package root so hosts can `import type { CreatePortnetThemeOptions,\r\n * BrandTokens } from \"@portnet/ui/v2\"` alongside the runtime API.\r\n */\r\nexport type {\r\n  CreatePortnetThemeOptions,\r\n  BrandTokens,\r\n  BrandSecondaryTokens,\r\n} from \"./theme\";\r\n\r\nexport {\r\n  useFocusTrap,\r\n  useTabLoading,\r\n  useDelayedFlag,\r\n  useDensity,\r\n  useResolvedDensity,\r\n  useSortedRows,\r\n  useFormAutoSave,\r\n  useFormCompletionProgress,\r\n  PERCEPTION_THRESHOLD_MS,\r\n} from \"./hooks\";\r\n\r\nexport {\r\n  cx,\r\n  fmtMoney,\r\n  contrast,\r\n  downloadBase64File,\r\n  getMimeType,\r\n  openBase64FileInTab,\r\n  downloadBlobFile,\r\n} from \"./utils\";\r\n\r\nexport { MODAL_POPPER_PROPS, MODAL_ZINDEX } from \"./modalContext\";\r\n\r\nexport {\r\n  Spinner,\r\n  Button,\r\n  Field,\r\n  Input,\r\n  Select,\r\n  Textarea,\r\n  Checkbox,\r\n  CheckboxGroup,\r\n  Radio,\r\n  RadioGroup,\r\n  Switch,\r\n  Combobox,\r\n  TelInput,\r\n  NumberInput,\r\n  FR_DECIMAL_SEPARATOR,\r\n  FR_THOUSAND_SEPARATOR,\r\n  DatePicker,\r\n  DATE_FORMAT_CHARTER,\r\n  DateTimePicker,\r\n  DATETIME_FORMAT_CHARTER,\r\n  TimePicker,\r\n  TIME_FORMAT_CHARTER,\r\n  DateRangePicker,\r\n  Status,\r\n  Chip,\r\n  Skeleton,\r\n  SkeletonKPI,\r\n  SkeletonRow,\r\n  SkeletonDetailHero,\r\n  SkeletonTabContent,\r\n  SkeletonText,\r\n  Modal,\r\n  Drawer,\r\n  ConfirmDialog,\r\n  Tabs,\r\n  HStepper,\r\n  VStepper,\r\n  FilterTab,\r\n  EmptyState,\r\n  Banner,\r\n  ToastProvider,\r\n  useToast,\r\n  KV,\r\n  KPICard,\r\n  MobileRowCard,\r\n  OverflowMenu,\r\n  FieldHelp,\r\n  SkipLink,\r\n  ProgressBar,\r\n  Segmented,\r\n  Dropzone,\r\n  CommandPalette,\r\n  SectionBusy,\r\n  PageBusy,\r\n  FormGrid,\r\n  KVGrid,\r\n  SectionHeader,\r\n  Accordion,\r\n  Tooltip,\r\n  ActionStrip,\r\n  CategoryTag,\r\n  FavoriteToggle,\r\n  PdfViewer,\r\n  ForbiddenPage,\r\n  NotFoundPage,\r\n  ServerErrorPage,\r\n  NetworkErrorPage,\r\n} from \"./components\";\r\n\r\n/**\r\n * Component prop / option types — public typed surface (Gap-TS-003).\r\n *\r\n * The value exports above were reachable from `@portnet/ui/v2`, but the\r\n * component TYPES were not: `./components` re-exported them from each module,\r\n * yet this barrel only forwarded the values, and no `exports` subpath reaches\r\n * `dist/v2/components` directly. Consumers were therefore forced to either\r\n * deep-import `@portnet/ui/dist/v2/components/…` (fragile, bypasses the\r\n * `exports` map) or redeclare a local twin of a shared contract — which the\r\n * Platform TypeScript Guidelines forbid (\"Reusable types belong inside Shared\r\n * UI Library. Modules must consume shared types. Never duplicate.\").\r\n *\r\n * Surfaced here so a host can write, for example:\r\n *\r\n *   import type { DrawerProps, OverflowMenuAction } from \"@portnet/ui/v2\";\r\n *\r\n * Additive and type-only: no runtime change, no existing export altered.\r\n */\r\nexport type {\r\n  SelectOption,\r\n  SelectOptionObject,\r\n  SelectOptionValue,\r\n  SelectValue,\r\n  SelectChangeLike,\r\n  SelectLabels,\r\n  ComboboxOption,\r\n  ComboboxOptionValue,\r\n  ComboboxValue,\r\n  ComboboxLabels,\r\n  ComboboxProps,\r\n  DrawerProps,\r\n  DrawerLabels,\r\n  DrawerAnchor,\r\n  FilterTabVariant,\r\n  FilterTabLabels,\r\n  BannerVariant,\r\n  BannerAction,\r\n  ToastVariant,\r\n  ToastProviderLabels,\r\n  ToastUndoOptions,\r\n  ToastProgressHandle,\r\n  ToastApi,\r\n  MobileRowCardProps,\r\n  OverflowMenuAction,\r\n  OverflowMenuProps,\r\n  OverflowMenuLabels,\r\n  DropzoneProps,\r\n  DropzoneFile,\r\n  DropzoneFileStatus,\r\n  DropzoneRejection,\r\n  DropzoneRejectReason,\r\n  DropzoneReasons,\r\n  DropzoneLabels,\r\n  PdfViewerProps,\r\n} from \"./components\";\r\n\r\nexport {\r\n  ActionBar,\r\n  BulkActionBar,\r\n  ColumnsToggle,\r\n  FormSection,\r\n  FormPageShell,\r\n  FormErrorSummary,\r\n  PageContent,\r\n  DataGrid,\r\n  DataGridVirtualized,\r\n  DataGridSettingsMenu,\r\n  DataGridToolbar,\r\n  CollapsibleDataGrid,\r\n  SortableHeader,\r\n  NetworkErrorBanner,\r\n  ReferentielField,\r\n  Tour,\r\n  KeyboardShortcutsHelp,\r\n  DeleteResourceConfirmDialog,\r\n  SaveFilterDialog,\r\n  SavedFiltersMenu,\r\n  makeFavoriteColumn,\r\n  FavoritesFilter,\r\n  applySort,\r\n  getAriaSort,\r\n  FormikInput,\r\n  FormikTextarea,\r\n  FormikSelect,\r\n  FormikCombobox,\r\n  FormikDatePicker,\r\n  FormikFile,\r\n  FormikCheckboxGroup,\r\n  FormikReferentielField,\r\n  /** Valeurs système non-éditables — fond grisé, pas d'interaction */\r\n  FormikDisplay,\r\n} from \"./patterns\";\r\n\r\n/**\r\n * Pattern prop / configuration types — public typed surface.\r\n *\r\n * Extends the Gap-TS-003 fix (which covered `./components`) to `./patterns`.\r\n * `ReferentielField` / `FormikReferentielField` were exported as VALUES while\r\n * the types describing their required props were not, forcing consumers to\r\n * deep-import `dist/v2/patterns/…` or duplicate a shared contract — both\r\n * forbidden by the Platform TypeScript Guidelines.\r\n *\r\n * Surfaced so a host can write, for example:\r\n *\r\n *   import type { ReferentielCriterion } from \"@portnet/ui/v2\";\r\n *\r\n * Kept deliberately MINIMAL. `ReferentielSearchParams` and\r\n * `ReferentielSearchResult` are excluded: identically-named types already come\r\n * from `./models` and `./referentiel`, and re-exporting either would be a\r\n * TS2308 ambiguity. Other pattern types (ActionBar*, FormErrorSummary*,\r\n * FavoritesFilter*) are already reachable from the library root via\r\n * `src/lib/index.ts`'s star-export of `./v2/patterns`; they are not forwarded\r\n * here without a consumer needing them, to keep the collision surface of a\r\n * certified library as small as possible.\r\n *\r\n * Additive and type-only: no runtime change, no existing export altered.\r\n */\r\nexport type {\r\n  ReferentielFieldProps,\r\n  ReferentielCriterion,\r\n  ReferentielFieldLabels,\r\n  FormikReferentielFieldProps,\r\n} from \"./patterns\";\r\n\r\n/**\r\n * User Personalization Foundation (favorites, saved filters, and future\r\n * slices). Also available via the dedicated subpath\r\n * \"@portnet/ui/v2/personalization\".\r\n *\r\n * The grid-bound composites are exported above via ./patterns\r\n * (makeFavoriteColumn, FavoritesFilter, SaveFilterDialog, SavedFiltersMenu);\r\n * FavoriteToggle via ./components. Here we surface the provider, the\r\n * capability hooks, and the favorites view logic.\r\n */\r\nexport {\r\n  UserPersonalizationProvider,\r\n  createLocalStorageAdapter,\r\n  createMemoryAdapter,\r\n  registerCapability,\r\n  useFavorites,\r\n  useIsFavorite,\r\n  useFavoritesView,\r\n  filterRowsByFavorites,\r\n  sortRowsByFavorites,\r\n  FAVORITES_FILTER,\r\n  FAVORITES_SORT,\r\n  useSavedFilters,\r\n} from \"./personalization\";\r\n\r\n/**\r\n * Referential data-access (config provider + hooks).\r\n *\r\n * The referential field UI is exported above via ./patterns\r\n * (ReferentielField, FormikReferentielField). This is the data layer that\r\n * backs them:\r\n *  - ReferentielProvider   — app-root config (baseURL / token / secret /\r\n *                            langue) + per-searchKey option cache.\r\n *  - useReferentielOptions — simple searchKey -> option list (getAll, cached).\r\n *  - useReferentielSearch  — paginated search builder (getPage) producing a\r\n *                            ReferentielField `search` fn.\r\n *  - useReferentielClient  — auth-configured axios instance (shared by the\r\n *                            options + search hooks).\r\n */\r\nexport {\r\n  ReferentielProvider,\r\n  ReferentielContext,\r\n  useReferentielClient,\r\n  useReferentielOptions,\r\n  useReferentielSearch,\r\n} from \"./referentiel\";\r\n\r\n/**\r\n * Domain models & shared UI/structural types.\r\n *\r\n * Surfaces the public type layer at the package root so hosts can import\r\n * types alongside the runtime API:\r\n *  - ./models — domain shapes (Scope, FavoriteRef, SavedFilter, Referentiel*\r\n *               DTO/param/result contracts, adapter/capability descriptors).\r\n *  - ./types  — UI/structural types (RowId, SortDescriptor, DataGrid types).\r\n * Type-only re-exports (no runtime cost). Conflicting names across the two\r\n * star-exports are omitted per ES module semantics rather than erroring.\r\n */\r\nexport * from \"./models\";\r\nexport * from \"./types\";\r\n"],"mappings":"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AA,CAAAS,cAAA,IAAAT,MAAA,CAAA0B,wBAAA,WAAAvB,GAAA,IAAAgB,GAAA,QAAAhB,GAAA,kBAAAH,MAAA,CAAAI,SAAA,CAAAC,cAAA,CAAAC,IAAA,CAAAa,GAAA,EAAAhB,GAAA,SAAAwB,IAAA,GAAAF,qBAAA,GAAAzB,MAAA,CAAA0B,wBAAA,CAAAP,GAAA,EAAAhB,GAAA,cAAAwB,IAAA,KAAAA,IAAA,CAAAhB,GAAA,IAAAgB,IAAA,CAAAC,GAAA,KAAA5B,MAAA,CAAAS,cAAA,CAAAe,MAAA,EAAArB,GAAA,EAAAwB,IAAA,YAAAH,MAAA,CAAArB,GAAA,IAAAgB,GAAA,CAAAhB,GAAA,SAAAqB,MAAA,cAAAL,GAAA,MAAAG,KAAA,IAAAA,KAAA,CAAAM,GAAA,CAAAT,GAAA,EAAAK,MAAA,YAAAA,MAAA;AA3TxB;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,IAAMK,OAAO,GAAArB,OAAA,CAAAqB,OAAA,GAAG,iBAAiB;;AAWxC;AACA;AACA;AACA;AACA;;AAqGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AA4EA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAgBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AASA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA","ignoreList":[]}

package/dist/v2/modalContext.d.ts

@@ -0,0 +1,96 @@
+/**
+ * modalContext — Portnet UI v2 (public)
+ *
+ * Convenience constants for v2 form components rendered inside a
+ * Modal or Drawer. Their Popper (MUI Autocomplete listbox, X date-picker
+ * calendar) must paint ABOVE the surrounding overlay to stay clickable —
+ * otherwise the Drawer/Modal backdrop can intercept pointer events on it.
+ *
+ * z-index (audit Batch 4): the v2 theme remaps MUI's 1100–1500 scale down
+ * to the 0–250 token range (see tokens/zIndex + Modal.tsx: drawer 80,
+ * modal 100). MODAL_ZINDEX therefore uses the `modal` token (100): it
+ * clears the Drawer (80) and rides the Modal layer (painting above it by
+ * DOM order — MUI's Dialog+popup contract) while staying BELOW toast (200)
+ * and tooltip (250). A previous build hardcoded 1400 here — a leftover
+ * from the pre-remap MUI scale that floated these Poppers above the whole
+ * notification layer.
+ *
+ * MUI v9 surface notes (audit Batch 6):
+ *   Both keys (combobox, datepicker) now use the v9-idiomatic
+ *   slots/slotProps API. The previous implementation used the v5/v6
+ *   `componentsProps` (Combobox) and `PopperProps` (DatePicker), both
+ *   removed in MUI v9 — the constant was silently broken until this
+ *   refactor.
+ *
+ * Usage (symmetric — both spread):
+ *
+ *   import { MODAL_POPPER_PROPS } from '@portnet/ui';
+ *
+ *   // Combobox / Autocomplete inside a Drawer
+ *   <FormikCombobox
+ *     {...MODAL_POPPER_PROPS.combobox}
+ *     name="typeId"
+ *     options={types}
+ *   />
+ *
+ *   // FormikDatePicker inside a Drawer
+ *   <FormikDatePicker
+ *     {...MODAL_POPPER_PROPS.datepicker}
+ *     name="dateCreation"
+ *     outputFormat="DD-MM-YYYY"
+ *   />
+ *
+ *   // v2.DatePicker directly inside a Drawer
+ *   <DatePicker
+ *     {...MODAL_POPPER_PROPS.datepicker}
+ *     value={date}
+ *     onChange={setDate}
+ *   />
+ *
+ * Migration from 0.2.x (v5/v6) to 0.3.0 (v9):
+ *   - The `combobox` key spread shape is unchanged at the call
+ *     site, but its inner contents migrated from componentsProps
+ *     to slotProps.
+ *   - The `datepicker` key MUST now be SPREAD (was previously passed
+ *     as PopperProps={...}). Old call sites using `PopperProps=`
+ *     were already broken in MUI X v9 — this constant is the migration
+ *     path.
+ */
+/** Shape spread onto a v2 form component's Popper slot to lift its z-index. */
+export interface PopperZIndexProps {
+    readonly slotProps: {
+        readonly popper: {
+            readonly sx: {
+                readonly zIndex: number;
+            };
+        };
+    };
+}
+/** Public shape of {@link MODAL_POPPER_PROPS}. */
+export interface ModalPopperProps {
+    /** Spread onto FormikCombobox or Combobox. */
+    readonly combobox: PopperZIndexProps;
+    /** Spread onto FormikDatePicker or DatePicker. */
+    readonly datepicker: PopperZIndexProps;
+}
+/**
+ * z-index for a form Popper opened inside a v2 Drawer (80) or Modal (100).
+ * Token-driven (`zIndex.modal` = 100): clears the Drawer, rides the Modal
+ * layer via DOM order, stays below toast (200) / tooltip (250). Replaces a
+ * stale pre-remap 1400 (audit Batch 4).
+ */
+export declare const MODAL_ZINDEX: number;
+/**
+ * MODAL_POPPER_PROPS — spread onto v2 form components rendered
+ * inside a v2.Drawer or MUI Modal.
+ *
+ * combobox   → spread onto FormikCombobox / Combobox
+ * datepicker → spread onto FormikDatePicker / DatePicker
+ *
+ * Both keys carry the same shape ({ slotProps: { popper: { sx: {...} } } })
+ * — the symmetry is intentional, making the API easier to learn and
+ * removing the v5-era asymmetry between Autocomplete (componentsProps)
+ * and Pickers (PopperProps).
+ */
+export declare const MODAL_POPPER_PROPS: ModalPopperProps;
+//# sourceMappingURL=modalContext.d.ts.map

package/dist/v2/modalContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modalContext.d.ts","sourceRoot":"","sources":["../../src/lib/v2/modalContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AAIH,+EAA+E;AAC/E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE;QAClB,QAAQ,CAAC,MAAM,EAAE;YACf,QAAQ,CAAC,EAAE,EAAE;gBAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;aAAE,CAAC;SAC1C,CAAC;KACH,CAAC;CACH;AAED,kDAAkD;AAClD,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,kDAAkD;IAClD,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;CACxC;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,QAAe,CAAC;AAEzC;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,EAAE,gBAkB/B,CAAC"}

package/dist/v2/modalContext.js

@@ -0,0 +1,113 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.MODAL_ZINDEX = exports.MODAL_POPPER_PROPS = void 0;
+var _tokens = require("./tokens");
+/**
+ * modalContext — Portnet UI v2 (public)
+ *
+ * Convenience constants for v2 form components rendered inside a
+ * Modal or Drawer. Their Popper (MUI Autocomplete listbox, X date-picker
+ * calendar) must paint ABOVE the surrounding overlay to stay clickable —
+ * otherwise the Drawer/Modal backdrop can intercept pointer events on it.
+ *
+ * z-index (audit Batch 4): the v2 theme remaps MUI's 1100–1500 scale down
+ * to the 0–250 token range (see tokens/zIndex + Modal.tsx: drawer 80,
+ * modal 100). MODAL_ZINDEX therefore uses the `modal` token (100): it
+ * clears the Drawer (80) and rides the Modal layer (painting above it by
+ * DOM order — MUI's Dialog+popup contract) while staying BELOW toast (200)
+ * and tooltip (250). A previous build hardcoded 1400 here — a leftover
+ * from the pre-remap MUI scale that floated these Poppers above the whole
+ * notification layer.
+ *
+ * MUI v9 surface notes (audit Batch 6):
+ *   Both keys (combobox, datepicker) now use the v9-idiomatic
+ *   slots/slotProps API. The previous implementation used the v5/v6
+ *   `componentsProps` (Combobox) and `PopperProps` (DatePicker), both
+ *   removed in MUI v9 — the constant was silently broken until this
+ *   refactor.
+ *
+ * Usage (symmetric — both spread):
+ *
+ *   import { MODAL_POPPER_PROPS } from '@portnet/ui';
+ *
+ *   // Combobox / Autocomplete inside a Drawer
+ *   <FormikCombobox
+ *     {...MODAL_POPPER_PROPS.combobox}
+ *     name="typeId"
+ *     options={types}
+ *   />
+ *
+ *   // FormikDatePicker inside a Drawer
+ *   <FormikDatePicker
+ *     {...MODAL_POPPER_PROPS.datepicker}
+ *     name="dateCreation"
+ *     outputFormat="DD-MM-YYYY"
+ *   />
+ *
+ *   // v2.DatePicker directly inside a Drawer
+ *   <DatePicker
+ *     {...MODAL_POPPER_PROPS.datepicker}
+ *     value={date}
+ *     onChange={setDate}
+ *   />
+ *
+ * Migration from 0.2.x (v5/v6) to 0.3.0 (v9):
+ *   - The `combobox` key spread shape is unchanged at the call
+ *     site, but its inner contents migrated from componentsProps
+ *     to slotProps.
+ *   - The `datepicker` key MUST now be SPREAD (was previously passed
+ *     as PopperProps={...}). Old call sites using `PopperProps=`
+ *     were already broken in MUI X v9 — this constant is the migration
+ *     path.
+ */
+
+/** Shape spread onto a v2 form component's Popper slot to lift its z-index. */
+
+/** Public shape of {@link MODAL_POPPER_PROPS}. */
+
+/**
+ * z-index for a form Popper opened inside a v2 Drawer (80) or Modal (100).
+ * Token-driven (`zIndex.modal` = 100): clears the Drawer, rides the Modal
+ * layer via DOM order, stays below toast (200) / tooltip (250). Replaces a
+ * stale pre-remap 1400 (audit Batch 4).
+ */
+var MODAL_ZINDEX = exports.MODAL_ZINDEX = _tokens.zIndex.modal;
+
+/**
+ * MODAL_POPPER_PROPS — spread onto v2 form components rendered
+ * inside a v2.Drawer or MUI Modal.
+ *
+ * combobox   → spread onto FormikCombobox / Combobox
+ * datepicker → spread onto FormikDatePicker / DatePicker
+ *
+ * Both keys carry the same shape ({ slotProps: { popper: { sx: {...} } } })
+ * — the symmetry is intentional, making the API easier to learn and
+ * removing the v5-era asymmetry between Autocomplete (componentsProps)
+ * and Pickers (PopperProps).
+ */
+var MODAL_POPPER_PROPS = exports.MODAL_POPPER_PROPS = Object.freeze({
+  /** Spread onto FormikCombobox or Combobox. */
+  combobox: Object.freeze({
+    slotProps: Object.freeze({
+      popper: Object.freeze({
+        sx: Object.freeze({
+          zIndex: MODAL_ZINDEX
+        })
+      })
+    })
+  }),
+  /** Spread onto FormikDatePicker or DatePicker. */
+  datepicker: Object.freeze({
+    slotProps: Object.freeze({
+      popper: Object.freeze({
+        sx: Object.freeze({
+          zIndex: MODAL_ZINDEX
+        })
+      })
+    })
+  })
+});
+//# sourceMappingURL=modalContext.js.map

package/dist/v2/modalContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modalContext.js","names":["_tokens","require","MODAL_ZINDEX","exports","zIndex","modal","MODAL_POPPER_PROPS","Object","freeze","combobox","slotProps","popper","sx","datepicker"],"sources":["../../src/lib/v2/modalContext.ts"],"sourcesContent":["/**\r\n * modalContext — Portnet UI v2 (public)\r\n *\r\n * Convenience constants for v2 form components rendered inside a\r\n * Modal or Drawer. Their Popper (MUI Autocomplete listbox, X date-picker\r\n * calendar) must paint ABOVE the surrounding overlay to stay clickable —\r\n * otherwise the Drawer/Modal backdrop can intercept pointer events on it.\r\n *\r\n * z-index (audit Batch 4): the v2 theme remaps MUI's 1100–1500 scale down\r\n * to the 0–250 token range (see tokens/zIndex + Modal.tsx: drawer 80,\r\n * modal 100). MODAL_ZINDEX therefore uses the `modal` token (100): it\r\n * clears the Drawer (80) and rides the Modal layer (painting above it by\r\n * DOM order — MUI's Dialog+popup contract) while staying BELOW toast (200)\r\n * and tooltip (250). A previous build hardcoded 1400 here — a leftover\r\n * from the pre-remap MUI scale that floated these Poppers above the whole\r\n * notification layer.\r\n *\r\n * MUI v9 surface notes (audit Batch 6):\r\n *   Both keys (combobox, datepicker) now use the v9-idiomatic\r\n *   slots/slotProps API. The previous implementation used the v5/v6\r\n *   `componentsProps` (Combobox) and `PopperProps` (DatePicker), both\r\n *   removed in MUI v9 — the constant was silently broken until this\r\n *   refactor.\r\n *\r\n * Usage (symmetric — both spread):\r\n *\r\n *   import { MODAL_POPPER_PROPS } from '@portnet/ui';\r\n *\r\n *   // Combobox / Autocomplete inside a Drawer\r\n *   <FormikCombobox\r\n *     {...MODAL_POPPER_PROPS.combobox}\r\n *     name=\"typeId\"\r\n *     options={types}\r\n *   />\r\n *\r\n *   // FormikDatePicker inside a Drawer\r\n *   <FormikDatePicker\r\n *     {...MODAL_POPPER_PROPS.datepicker}\r\n *     name=\"dateCreation\"\r\n *     outputFormat=\"DD-MM-YYYY\"\r\n *   />\r\n *\r\n *   // v2.DatePicker directly inside a Drawer\r\n *   <DatePicker\r\n *     {...MODAL_POPPER_PROPS.datepicker}\r\n *     value={date}\r\n *     onChange={setDate}\r\n *   />\r\n *\r\n * Migration from 0.2.x (v5/v6) to 0.3.0 (v9):\r\n *   - The `combobox` key spread shape is unchanged at the call\r\n *     site, but its inner contents migrated from componentsProps\r\n *     to slotProps.\r\n *   - The `datepicker` key MUST now be SPREAD (was previously passed\r\n *     as PopperProps={...}). Old call sites using `PopperProps=`\r\n *     were already broken in MUI X v9 — this constant is the migration\r\n *     path.\r\n */\r\n\r\nimport { zIndex } from \"./tokens\";\r\n\r\n/** Shape spread onto a v2 form component's Popper slot to lift its z-index. */\r\nexport interface PopperZIndexProps {\r\n  readonly slotProps: {\r\n    readonly popper: {\r\n      readonly sx: { readonly zIndex: number };\r\n    };\r\n  };\r\n}\r\n\r\n/** Public shape of {@link MODAL_POPPER_PROPS}. */\r\nexport interface ModalPopperProps {\r\n  /** Spread onto FormikCombobox or Combobox. */\r\n  readonly combobox: PopperZIndexProps;\r\n  /** Spread onto FormikDatePicker or DatePicker. */\r\n  readonly datepicker: PopperZIndexProps;\r\n}\r\n\r\n/**\r\n * z-index for a form Popper opened inside a v2 Drawer (80) or Modal (100).\r\n * Token-driven (`zIndex.modal` = 100): clears the Drawer, rides the Modal\r\n * layer via DOM order, stays below toast (200) / tooltip (250). Replaces a\r\n * stale pre-remap 1400 (audit Batch 4).\r\n */\r\nexport const MODAL_ZINDEX = zIndex.modal;\r\n\r\n/**\r\n * MODAL_POPPER_PROPS — spread onto v2 form components rendered\r\n * inside a v2.Drawer or MUI Modal.\r\n *\r\n * combobox   → spread onto FormikCombobox / Combobox\r\n * datepicker → spread onto FormikDatePicker / DatePicker\r\n *\r\n * Both keys carry the same shape ({ slotProps: { popper: { sx: {...} } } })\r\n * — the symmetry is intentional, making the API easier to learn and\r\n * removing the v5-era asymmetry between Autocomplete (componentsProps)\r\n * and Pickers (PopperProps).\r\n */\r\nexport const MODAL_POPPER_PROPS: ModalPopperProps = Object.freeze({\r\n  /** Spread onto FormikCombobox or Combobox. */\r\n  combobox: Object.freeze({\r\n    slotProps: Object.freeze({\r\n      popper: Object.freeze({\r\n        sx: Object.freeze({ zIndex: MODAL_ZINDEX }),\r\n      }),\r\n    }),\r\n  }),\r\n\r\n  /** Spread onto FormikDatePicker or DatePicker. */\r\n  datepicker: Object.freeze({\r\n    slotProps: Object.freeze({\r\n      popper: Object.freeze({\r\n        sx: Object.freeze({ zIndex: MODAL_ZINDEX }),\r\n      }),\r\n    }),\r\n  }),\r\n});\r\n"],"mappings":";;;;;;AA2DA,IAAAA,OAAA,GAAAC,OAAA;AA3DA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA;;AASA;;AAQA;AACA;AACA;AACA;AACA;AACA;AACO,IAAMC,YAAY,GAAAC,OAAA,CAAAD,YAAA,GAAGE,cAAM,CAACC,KAAK;;AAExC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,IAAMC,kBAAoC,GAAAH,OAAA,CAAAG,kBAAA,GAAGC,MAAM,CAACC,MAAM,CAAC;EAChE;EACAC,QAAQ,EAAEF,MAAM,CAACC,MAAM,CAAC;IACtBE,SAAS,EAAEH,MAAM,CAACC,MAAM,CAAC;MACvBG,MAAM,EAAEJ,MAAM,CAACC,MAAM,CAAC;QACpBI,EAAE,EAAEL,MAAM,CAACC,MAAM,CAAC;UAAEJ,MAAM,EAAEF;QAAa,CAAC;MAC5C,CAAC;IACH,CAAC;EACH,CAAC,CAAC;EAEF;EACAW,UAAU,EAAEN,MAAM,CAACC,MAAM,CAAC;IACxBE,SAAS,EAAEH,MAAM,CAACC,MAAM,CAAC;MACvBG,MAAM,EAAEJ,MAAM,CAACC,MAAM,CAAC;QACpBI,EAAE,EAAEL,MAAM,CAACC,MAAM,CAAC;UAAEJ,MAAM,EAAEF;QAAa,CAAC;MAC5C,CAAC;IACH,CAAC;EACH,CAAC;AACH,CAAC,CAAC","ignoreList":[]}

package/dist/v2/models/favorite.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @portnet/ui v2 — Favorite domain model (personalization capability).
+ *
+ * Derived from personalization/propTypes.js FavoriteRefShape.
+ */
+import type { RowId } from "../types/common";
+/** A single favorited entity reference. `addedAt` enables "recently favorited" ordering. */
+export interface FavoriteRef {
+    /** Business row id of the favorited entity. */
+    id: RowId;
+    /** ISO-8601 timestamp of when it was favorited. */
+    addedAt?: string;
+}
+//# sourceMappingURL=favorite.d.ts.map

package/dist/v2/models/favorite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"favorite.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/models/favorite.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,4FAA4F;AAC5F,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,EAAE,EAAE,KAAK,CAAC;IACV,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/v2/models/favorite.js

@@ -0,0 +1,6 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+//# sourceMappingURL=favorite.js.map

package/dist/v2/models/favorite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"favorite.js","names":[],"sources":["../../../src/lib/v2/models/favorite.ts"],"sourcesContent":["/**\r\n * @portnet/ui v2 — Favorite domain model (personalization capability).\r\n *\r\n * Derived from personalization/propTypes.js FavoriteRefShape.\r\n */\r\nimport type { RowId } from \"../types/common\";\r\n\r\n/** A single favorited entity reference. `addedAt` enables \"recently favorited\" ordering. */\r\nexport interface FavoriteRef {\r\n  /** Business row id of the favorited entity. */\r\n  id: RowId;\r\n  /** ISO-8601 timestamp of when it was favorited. */\r\n  addedAt?: string;\r\n}\r\n"],"mappings":"","ignoreList":[]}

package/dist/v2/models/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @portnet/ui v2 — Domain / business models (barrel).
+ *
+ * Business/domain shapes, kept separate from ../types (UI/structural types).
+ * The public typed surface is finalised in Batch 5.
+ */
+export * from "./personalization";
+export * from "./savedFilter";
+export * from "./favorite";
+export * from "./referentiel";
+//# sourceMappingURL=index.d.ts.map

package/dist/v2/models/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/models/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}

package/dist/v2/models/index.js

@@ -0,0 +1,50 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _personalization = require("./personalization");
+Object.keys(_personalization).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _personalization[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _personalization[key];
+    }
+  });
+});
+var _savedFilter = require("./savedFilter");
+Object.keys(_savedFilter).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _savedFilter[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _savedFilter[key];
+    }
+  });
+});
+var _favorite = require("./favorite");
+Object.keys(_favorite).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _favorite[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _favorite[key];
+    }
+  });
+});
+var _referentiel = require("./referentiel");
+Object.keys(_referentiel).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _referentiel[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _referentiel[key];
+    }
+  });
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["_personalization","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get","_savedFilter","_favorite","_referentiel"],"sources":["../../../src/lib/v2/models/index.ts"],"sourcesContent":["/**\r\n * @portnet/ui v2 — Domain / business models (barrel).\r\n *\r\n * Business/domain shapes, kept separate from ../types (UI/structural types).\r\n * The public typed surface is finalised in Batch 5.\r\n */\r\n\r\nexport * from \"./personalization\";\r\nexport * from \"./savedFilter\";\r\nexport * from \"./favorite\";\r\nexport * from \"./referentiel\";\r\n"],"mappings":";;;;;AAOA,IAAAA,gBAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,gBAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,gBAAA,CAAAK,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,IAAA;MAAA,OAAAT,gBAAA,CAAAK,GAAA;IAAA;EAAA;AAAA;AACA,IAAAK,YAAA,GAAAT,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAO,YAAA,EAAAN,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAK,YAAA,CAAAL,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,IAAA;MAAA,OAAAC,YAAA,CAAAL,GAAA;IAAA;EAAA;AAAA;AACA,IAAAM,SAAA,GAAAV,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAQ,SAAA,EAAAP,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAM,SAAA,CAAAN,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,IAAA;MAAA,OAAAE,SAAA,CAAAN,GAAA;IAAA;EAAA;AAAA;AACA,IAAAO,YAAA,GAAAX,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAS,YAAA,EAAAR,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAO,YAAA,CAAAP,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,IAAA;MAAA,OAAAG,YAAA,CAAAP,GAAA;IAAA;EAAA;AAAA","ignoreList":[]}

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

@@ -0,0 +1,65 @@
+/**
+ * @portnet/ui v2 — Personalization domain models.
+ *
+ * Derived from personalization/schema.js, personalization/propTypes.js, and
+ * the localStorage/memory adapters. The foundation is capability-agnostic;
+ * capability payloads (favorites, saved filters) live in their own modules.
+ */
+/** Partitions persisted preferences. `userId` required; the rest are optional partitions. */
+export interface Scope {
+    userId: string;
+    tenantId?: string;
+    appId?: string;
+}
+/** Behaviour flags an adapter advertises; the store feature-detects them. */
+export interface AdapterCapabilities {
+    crossTab?: boolean;
+    remote?: boolean;
+    shared?: boolean;
+}
+/** Reconciliation strategy between optimistic local state and adapter truth. */
+export type HydrateStrategy = "local-wins" | "remote-wins" | "merge";
+/** Versioned persistence envelope. The adapter treats `payload` as opaque. */
+export interface PersistenceEnvelope<P = unknown> {
+    schemaVersion: number;
+    /** ISO-8601 timestamp (see schema.makeEnvelope). */
+    updatedAt: string;
+    payload: P;
+}
+/** Capability descriptor passed to `registerCapability` by a capability slice. */
+export interface CapabilityDescriptor<S = unknown> {
+    /** Unique capability id (e.g. "favorites", "savedFilters"). */
+    id: string;
+    /** Payload schema version (default 1). */
+    schemaVersion?: number;
+    /** Seed used when nothing is persisted (should be a stable/frozen ref). */
+    defaultState?: S;
+    /** Upgrades an older persisted payload on load. */
+    migrate?: (fromVersion: number, payload: unknown) => S;
+}
+/** Map of `capabilityId -> envelope` returned by an adapter's load/loadSync. */
+export type CapabilityEnvelopes = Record<string, PersistenceEnvelope>;
+/**
+ * Storage adapter contract. `load` + `save` are mandatory; the rest are
+ * optional capabilities the store feature-detects (localStorage / memory /
+ * custom host adapters implement this).
+ */
+export interface PersonalizationStorageAdapter {
+    name?: string;
+    load: (scope: Scope) => Promise<CapabilityEnvelopes>;
+    /** Synchronous hydrate (removes the initial empty flash for local adapters). */
+    loadSync?: (scope: Scope) => CapabilityEnvelopes;
+    /** Rejects on quota / private-mode failure so the store keeps the optimistic value. */
+    save: (scope: Scope, capabilityId: string, envelope: PersistenceEnvelope) => Promise<void>;
+    remove?: (scope: Scope, capabilityId: string) => Promise<void>;
+    /** Cross-tab notifications; `onChange` receives the changed capabilityId. Returns unsubscribe. */
+    subscribe?: (scope: Scope, onChange: (capabilityId: string) => void) => () => void;
+    capabilities?: AdapterCapabilities;
+}
+/** Pre-seed entry accepted by `createMemoryAdapter({ seed })` (tests / stories). */
+export interface MemoryAdapterSeedEntry {
+    scope: Scope;
+    capabilityId: string;
+    envelope: PersistenceEnvelope;
+}
+//# sourceMappingURL=personalization.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"personalization.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/models/personalization.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,6FAA6F;AAC7F,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,6EAA6E;AAC7E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,gFAAgF;AAChF,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,aAAa,GAAG,OAAO,CAAC;AAErE,8EAA8E;AAC9E,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,OAAO;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,CAAC,CAAC;CACZ;AAED,kFAAkF;AAClF,MAAM,WAAW,oBAAoB,CAAC,CAAC,GAAG,OAAO;IAC/C,+DAA+D;IAC/D,EAAE,EAAE,MAAM,CAAC;IACX,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,CAAC,CAAC;IACjB,mDAAmD;IACnD,OAAO,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,CAAC,CAAC;CACxD;AAED,gFAAgF;AAChF,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;AAEtE;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACrD,gFAAgF;IAChF,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,mBAAmB,CAAC;IACjD,uFAAuF;IACvF,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3F,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,kGAAkG;IAClG,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;IACnF,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC;AAED,oFAAoF;AACpF,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,KAAK,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,mBAAmB,CAAC;CAC/B"}

package/dist/v2/models/personalization.js

@@ -0,0 +1,6 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+//# sourceMappingURL=personalization.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"personalization.js","names":[],"sources":["../../../src/lib/v2/models/personalization.ts"],"sourcesContent":["/**\r\n * @portnet/ui v2 — Personalization domain models.\r\n *\r\n * Derived from personalization/schema.js, personalization/propTypes.js, and\r\n * the localStorage/memory adapters. The foundation is capability-agnostic;\r\n * capability payloads (favorites, saved filters) live in their own modules.\r\n */\r\n\r\n/** Partitions persisted preferences. `userId` required; the rest are optional partitions. */\r\nexport interface Scope {\r\n  userId: string;\r\n  tenantId?: string;\r\n  appId?: string;\r\n}\r\n\r\n/** Behaviour flags an adapter advertises; the store feature-detects them. */\r\nexport interface AdapterCapabilities {\r\n  crossTab?: boolean;\r\n  remote?: boolean;\r\n  shared?: boolean;\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/** Versioned persistence envelope. The adapter treats `payload` as opaque. */\r\nexport interface PersistenceEnvelope<P = unknown> {\r\n  schemaVersion: number;\r\n  /** ISO-8601 timestamp (see schema.makeEnvelope). */\r\n  updatedAt: string;\r\n  payload: P;\r\n}\r\n\r\n/** Capability descriptor passed to `registerCapability` by a capability slice. */\r\nexport interface CapabilityDescriptor<S = unknown> {\r\n  /** Unique capability id (e.g. \"favorites\", \"savedFilters\"). */\r\n  id: string;\r\n  /** Payload schema version (default 1). */\r\n  schemaVersion?: number;\r\n  /** Seed used when nothing is persisted (should be a stable/frozen ref). */\r\n  defaultState?: S;\r\n  /** Upgrades an older persisted payload on load. */\r\n  migrate?: (fromVersion: number, payload: unknown) => S;\r\n}\r\n\r\n/** Map of `capabilityId -> envelope` returned by an adapter's load/loadSync. */\r\nexport type CapabilityEnvelopes = Record<string, PersistenceEnvelope>;\r\n\r\n/**\r\n * Storage adapter contract. `load` + `save` are mandatory; the rest are\r\n * optional capabilities the store feature-detects (localStorage / memory /\r\n * custom host adapters implement this).\r\n */\r\nexport interface PersonalizationStorageAdapter {\r\n  name?: string;\r\n  load: (scope: Scope) => Promise<CapabilityEnvelopes>;\r\n  /** Synchronous hydrate (removes the initial empty flash for local adapters). */\r\n  loadSync?: (scope: Scope) => CapabilityEnvelopes;\r\n  /** Rejects on quota / private-mode failure so the store keeps the optimistic value. */\r\n  save: (scope: Scope, capabilityId: string, envelope: PersistenceEnvelope) => Promise<void>;\r\n  remove?: (scope: Scope, capabilityId: string) => Promise<void>;\r\n  /** Cross-tab notifications; `onChange` receives the changed capabilityId. Returns unsubscribe. */\r\n  subscribe?: (scope: Scope, onChange: (capabilityId: string) => void) => () => void;\r\n  capabilities?: AdapterCapabilities;\r\n}\r\n\r\n/** Pre-seed entry accepted by `createMemoryAdapter({ seed })` (tests / stories). */\r\nexport interface MemoryAdapterSeedEntry {\r\n  scope: Scope;\r\n  capabilityId: string;\r\n  envelope: PersistenceEnvelope;\r\n}\r\n"],"mappings":"","ignoreList":[]}

package/dist/v2/models/referentiel.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @portnet/ui v2 — Referentiel domain models.
+ *
+ * Derived from referentiel/useReferentielClient.js, useReferentielSearch.js,
+ * and useReferentielOptions.js (the legacy "specific/simple referential"
+ * getPage / getAll contracts).
+ */
+/** Connection config a host supplies to ReferentielProvider. */
+export interface ReferentielApiConfig {
+    baseURL: string;
+    token: string;
+    /** true → `Authorization: <token>` (raw, e.g. SECRET keys); false → `Bearer <token>`. */
+    secret: boolean;
+    /** Default UI/data language (e.g. "fr"); per-hook overridable. */
+    langue?: string;
+}
+/** Legacy "specific referential" getPage response envelope (paginated search). */
+export interface ReferentielGetPageResponse<T = unknown> {
+    succes: boolean;
+    results: T[];
+    totalElements: number;
+    message?: string;
+}
+/** Legacy "simple referential" getAll response envelope (option lists). */
+export interface ReferentielGetAllResponse<T = unknown> {
+    succes: boolean;
+    results: T[];
+    message?: string;
+}
+/** Arguments accepted by the search fn built by useReferentielSearch (`page` is 1-based). */
+export interface ReferentielSearchArgs<TCriteria = Record<string, unknown>> {
+    criteria?: TCriteria;
+    page?: number;
+    pageSize?: number;
+}
+/** Normalised search result returned to ReferentielField / FormikReferentielField. */
+export interface ReferentielSearchResult<T = unknown> {
+    items: T[];
+    total: number;
+}
+/** Parameters to build a paginated referential search fn (useReferentielSearch). */
+export interface ReferentielSearchParams<TCriteria = Record<string, unknown>> {
+    /** API segment (e.g. "operateurImpExp"). */
+    path: string;
+    /** Extra request-body fields merged into every request. */
+    specifications?: Record<string, unknown>;
+    /** Maps ReferentielField criteria to request-body fields (default: spread as-is). */
+    mapCriteria?: (criteria: TCriteria | undefined) => Record<string, unknown>;
+}
+/** Parameters for a simple option-list fetch (useReferentielOptions). */
+export interface ReferentielOptionsParams<TOption = unknown> {
+    /** Referential key (cleReferentiel). */
+    searchKey: string;
+    /** Overrides the provider langue. */
+    langue?: string;
+    /** Extra request-body fields. */
+    specifications?: Record<string, unknown>;
+    /** Client-side option filter. */
+    filterFunc?: (option: TOption) => boolean;
+}
+/** Result of a simple option-list fetch (useReferentielOptions). */
+export interface ReferentielOptionsResult<TOption = unknown> {
+    options: TOption[];
+    loading: boolean;
+    error: Error | null;
+}
+//# sourceMappingURL=referentiel.d.ts.map

package/dist/v2/models/referentiel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"referentiel.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/models/referentiel.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,gEAAgE;AAChE,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,yFAAyF;IACzF,MAAM,EAAE,OAAO,CAAC;IAChB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,kFAAkF;AAClF,MAAM,WAAW,0BAA0B,CAAC,CAAC,GAAG,OAAO;IACrD,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,2EAA2E;AAC3E,MAAM,WAAW,yBAAyB,CAAC,CAAC,GAAG,OAAO;IACpD,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,6FAA6F;AAC7F,MAAM,WAAW,qBAAqB,CAAC,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACxE,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,sFAAsF;AACtF,MAAM,WAAW,uBAAuB,CAAC,CAAC,GAAG,OAAO;IAClD,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,oFAAoF;AACpF,MAAM,WAAW,uBAAuB,CAAC,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1E,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,qFAAqF;IACrF,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,GAAG,SAAS,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5E;AAED,yEAAyE;AACzE,MAAM,WAAW,wBAAwB,CAAC,OAAO,GAAG,OAAO;IACzD,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,iCAAiC;IACjC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;CAC3C;AAED,oEAAoE;AACpE,MAAM,WAAW,wBAAwB,CAAC,OAAO,GAAG,OAAO;IACzD,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB"}

package/dist/v2/models/referentiel.js

@@ -0,0 +1,6 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+//# sourceMappingURL=referentiel.js.map

package/dist/v2/models/referentiel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"referentiel.js","names":[],"sources":["../../../src/lib/v2/models/referentiel.ts"],"sourcesContent":["/**\r\n * @portnet/ui v2 — Referentiel domain models.\r\n *\r\n * Derived from referentiel/useReferentielClient.js, useReferentielSearch.js,\r\n * and useReferentielOptions.js (the legacy \"specific/simple referential\"\r\n * getPage / getAll contracts).\r\n */\r\n\r\n/** Connection config a host supplies to ReferentielProvider. */\r\nexport interface ReferentielApiConfig {\r\n  baseURL: string;\r\n  token: string;\r\n  /** true → `Authorization: <token>` (raw, e.g. SECRET keys); false → `Bearer <token>`. */\r\n  secret: boolean;\r\n  /** Default UI/data language (e.g. \"fr\"); per-hook overridable. */\r\n  langue?: string;\r\n}\r\n\r\n/** Legacy \"specific referential\" getPage response envelope (paginated search). */\r\nexport interface ReferentielGetPageResponse<T = unknown> {\r\n  succes: boolean;\r\n  results: T[];\r\n  totalElements: number;\r\n  message?: string;\r\n}\r\n\r\n/** Legacy \"simple referential\" getAll response envelope (option lists). */\r\nexport interface ReferentielGetAllResponse<T = unknown> {\r\n  succes: boolean;\r\n  results: T[];\r\n  message?: string;\r\n}\r\n\r\n/** Arguments accepted by the search fn built by useReferentielSearch (`page` is 1-based). */\r\nexport interface ReferentielSearchArgs<TCriteria = Record<string, unknown>> {\r\n  criteria?: TCriteria;\r\n  page?: number;\r\n  pageSize?: number;\r\n}\r\n\r\n/** Normalised search result returned to ReferentielField / FormikReferentielField. */\r\nexport interface ReferentielSearchResult<T = unknown> {\r\n  items: T[];\r\n  total: number;\r\n}\r\n\r\n/** Parameters to build a paginated referential search fn (useReferentielSearch). */\r\nexport interface ReferentielSearchParams<TCriteria = Record<string, unknown>> {\r\n  /** API segment (e.g. \"operateurImpExp\"). */\r\n  path: string;\r\n  /** Extra request-body fields merged into every request. */\r\n  specifications?: Record<string, unknown>;\r\n  /** Maps ReferentielField criteria to request-body fields (default: spread as-is). */\r\n  mapCriteria?: (criteria: TCriteria | undefined) => Record<string, unknown>;\r\n}\r\n\r\n/** Parameters for a simple option-list fetch (useReferentielOptions). */\r\nexport interface ReferentielOptionsParams<TOption = unknown> {\r\n  /** Referential key (cleReferentiel). */\r\n  searchKey: string;\r\n  /** Overrides the provider langue. */\r\n  langue?: string;\r\n  /** Extra request-body fields. */\r\n  specifications?: Record<string, unknown>;\r\n  /** Client-side option filter. */\r\n  filterFunc?: (option: TOption) => boolean;\r\n}\r\n\r\n/** Result of a simple option-list fetch (useReferentielOptions). */\r\nexport interface ReferentielOptionsResult<TOption = unknown> {\r\n  options: TOption[];\r\n  loading: boolean;\r\n  error: Error | null;\r\n}\r\n"],"mappings":"","ignoreList":[]}

package/dist/v2/models/savedFilter.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @portnet/ui v2 — Saved-filter domain model (personalization capability).
+ *
+ * Derived from personalization/propTypes.js SavedFilterShape. `criteria` is
+ * opaque — the host's own filter payload, persisted and re-emitted verbatim
+ * so the framework stays reusable across every list regardless of its schema.
+ */
+export interface SavedFilter {
+    id: string;
+    name?: string;
+    resourceKey?: string;
+    /** Opaque host filter payload (persisted and re-emitted verbatim). */
+    criteria?: Record<string, unknown>;
+    ownerId?: string;
+    isDefault?: boolean;
+    shared?: boolean;
+    /** ISO-8601 timestamp. */
+    createdAt?: string;
+    /** ISO-8601 timestamp. */
+    updatedAt?: string;
+}
+//# sourceMappingURL=savedFilter.d.ts.map

package/dist/v2/models/savedFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"savedFilter.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/models/savedFilter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/v2/models/savedFilter.js

@@ -0,0 +1,6 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+//# sourceMappingURL=savedFilter.js.map

package/dist/v2/models/savedFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"savedFilter.js","names":[],"sources":["../../../src/lib/v2/models/savedFilter.ts"],"sourcesContent":["/**\r\n * @portnet/ui v2 — Saved-filter domain model (personalization capability).\r\n *\r\n * Derived from personalization/propTypes.js SavedFilterShape. `criteria` is\r\n * opaque — the host's own filter payload, persisted and re-emitted verbatim\r\n * so the framework stays reusable across every list regardless of its schema.\r\n */\r\nexport interface SavedFilter {\r\n  id: string;\r\n  name?: string;\r\n  resourceKey?: string;\r\n  /** Opaque host filter payload (persisted and re-emitted verbatim). */\r\n  criteria?: Record<string, unknown>;\r\n  ownerId?: string;\r\n  isDefault?: boolean;\r\n  shared?: boolean;\r\n  /** ISO-8601 timestamp. */\r\n  createdAt?: string;\r\n  /** ISO-8601 timestamp. */\r\n  updatedAt?: string;\r\n}\r\n"],"mappings":"","ignoreList":[]}