@portnet/ui 5.0.28 → 6.0.0

package/dist/v2/patterns/ReferentielField.js

@@ -0,0 +1,617 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var React = _interopRequireWildcard(require("react"));
+var _Box = _interopRequireDefault(require("@mui/material/Box"));
+var _IconButton = _interopRequireDefault(require("@mui/material/IconButton"));
+var _Search = _interopRequireDefault(require("@mui/icons-material/Search"));
+var _Close = _interopRequireDefault(require("@mui/icons-material/Close"));
+var _Field = _interopRequireDefault(require("../components/Field"));
+var _Input = _interopRequireDefault(require("../components/Input"));
+var _Combobox = _interopRequireDefault(require("../components/Combobox"));
+var _DatePicker = _interopRequireDefault(require("../components/DatePicker"));
+var _Button = _interopRequireDefault(require("../components/Button"));
+var _Banner = _interopRequireDefault(require("../components/Banner"));
+var _Modal = _interopRequireDefault(require("../components/Modal"));
+var _DataGrid = _interopRequireDefault(require("./DataGrid"));
+var _EmptyState = _interopRequireDefault(require("../components/EmptyState"));
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { "default": obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj["default"] = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+function _regeneratorRuntime() { "use strict"; /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */ _regeneratorRuntime = function _regeneratorRuntime() { return exports; }; var exports = {}, Op = Object.prototype, hasOwn = Op.hasOwnProperty, defineProperty = Object.defineProperty || function (obj, key, desc) { obj[key] = desc.value; }, $Symbol = "function" == typeof Symbol ? Symbol : {}, iteratorSymbol = $Symbol.iterator || "@@iterator", asyncIteratorSymbol = $Symbol.asyncIterator || "@@asyncIterator", toStringTagSymbol = $Symbol.toStringTag || "@@toStringTag"; function define(obj, key, value) { return Object.defineProperty(obj, key, { value: value, enumerable: !0, configurable: !0, writable: !0 }), obj[key]; } try { define({}, ""); } catch (err) { define = function define(obj, key, value) { return obj[key] = value; }; } function wrap(innerFn, outerFn, self, tryLocsList) { var protoGenerator = outerFn && outerFn.prototype instanceof Generator ? outerFn : Generator, generator = Object.create(protoGenerator.prototype), context = new Context(tryLocsList || []); return defineProperty(generator, "_invoke", { value: makeInvokeMethod(innerFn, self, context) }), generator; } function tryCatch(fn, obj, arg) { try { return { type: "normal", arg: fn.call(obj, arg) }; } catch (err) { return { type: "throw", arg: err }; } } exports.wrap = wrap; var ContinueSentinel = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} var IteratorPrototype = {}; define(IteratorPrototype, iteratorSymbol, function () { return this; }); var getProto = Object.getPrototypeOf, NativeIteratorPrototype = getProto && getProto(getProto(values([]))); NativeIteratorPrototype && NativeIteratorPrototype !== Op && hasOwn.call(NativeIteratorPrototype, iteratorSymbol) && (IteratorPrototype = NativeIteratorPrototype); var Gp = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(IteratorPrototype); function defineIteratorMethods(prototype) { ["next", "throw", "return"].forEach(function (method) { define(prototype, method, function (arg) { return this._invoke(method, arg); }); }); } function AsyncIterator(generator, PromiseImpl) { function invoke(method, arg, resolve, reject) { var record = tryCatch(generator[method], generator, arg); if ("throw" !== record.type) { var result = record.arg, value = result.value; return value && "object" == _typeof(value) && hasOwn.call(value, "__await") ? PromiseImpl.resolve(value.__await).then(function (value) { invoke("next", value, resolve, reject); }, function (err) { invoke("throw", err, resolve, reject); }) : PromiseImpl.resolve(value).then(function (unwrapped) { result.value = unwrapped, resolve(result); }, function (error) { return invoke("throw", error, resolve, reject); }); } reject(record.arg); } var previousPromise; defineProperty(this, "_invoke", { value: function value(method, arg) { function callInvokeWithMethodAndArg() { return new PromiseImpl(function (resolve, reject) { invoke(method, arg, resolve, reject); }); } return previousPromise = previousPromise ? previousPromise.then(callInvokeWithMethodAndArg, callInvokeWithMethodAndArg) : callInvokeWithMethodAndArg(); } }); } function makeInvokeMethod(innerFn, self, context) { var state = "suspendedStart"; return function (method, arg) { if ("executing" === state) throw new Error("Generator is already running"); if ("completed" === state) { if ("throw" === method) throw arg; return doneResult(); } for (context.method = method, context.arg = arg;;) { var delegate = context.delegate; if (delegate) { var delegateResult = maybeInvokeDelegate(delegate, context); if (delegateResult) { if (delegateResult === ContinueSentinel) continue; return delegateResult; } } if ("next" === context.method) context.sent = context._sent = context.arg;else if ("throw" === context.method) { if ("suspendedStart" === state) throw state = "completed", context.arg; context.dispatchException(context.arg); } else "return" === context.method && context.abrupt("return", context.arg); state = "executing"; var record = tryCatch(innerFn, self, context); if ("normal" === record.type) { if (state = context.done ? "completed" : "suspendedYield", record.arg === ContinueSentinel) continue; return { value: record.arg, done: context.done }; } "throw" === record.type && (state = "completed", context.method = "throw", context.arg = record.arg); } }; } function maybeInvokeDelegate(delegate, context) { var methodName = context.method, method = delegate.iterator[methodName]; if (undefined === method) return context.delegate = null, "throw" === methodName && delegate.iterator["return"] && (context.method = "return", context.arg = undefined, maybeInvokeDelegate(delegate, context), "throw" === context.method) || "return" !== methodName && (context.method = "throw", context.arg = new TypeError("The iterator does not provide a '" + methodName + "' method")), ContinueSentinel; var record = tryCatch(method, delegate.iterator, context.arg); if ("throw" === record.type) return context.method = "throw", context.arg = record.arg, context.delegate = null, ContinueSentinel; var info = record.arg; return info ? info.done ? (context[delegate.resultName] = info.value, context.next = delegate.nextLoc, "return" !== context.method && (context.method = "next", context.arg = undefined), context.delegate = null, ContinueSentinel) : info : (context.method = "throw", context.arg = new TypeError("iterator result is not an object"), context.delegate = null, ContinueSentinel); } function pushTryEntry(locs) { var entry = { tryLoc: locs[0] }; 1 in locs && (entry.catchLoc = locs[1]), 2 in locs && (entry.finallyLoc = locs[2], entry.afterLoc = locs[3]), this.tryEntries.push(entry); } function resetTryEntry(entry) { var record = entry.completion || {}; record.type = "normal", delete record.arg, entry.completion = record; } function Context(tryLocsList) { this.tryEntries = [{ tryLoc: "root" }], tryLocsList.forEach(pushTryEntry, this), this.reset(!0); } function values(iterable) { if (iterable) { var iteratorMethod = iterable[iteratorSymbol]; if (iteratorMethod) return iteratorMethod.call(iterable); if ("function" == typeof iterable.next) return iterable; if (!isNaN(iterable.length)) { var i = -1, next = function next() { for (; ++i < iterable.length;) { if (hasOwn.call(iterable, i)) return next.value = iterable[i], next.done = !1, next; } return next.value = undefined, next.done = !0, next; }; return next.next = next; } } return { next: doneResult }; } function doneResult() { return { value: undefined, done: !0 }; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, defineProperty(Gp, "constructor", { value: GeneratorFunctionPrototype, configurable: !0 }), defineProperty(GeneratorFunctionPrototype, "constructor", { value: GeneratorFunction, configurable: !0 }), GeneratorFunction.displayName = define(GeneratorFunctionPrototype, toStringTagSymbol, "GeneratorFunction"), exports.isGeneratorFunction = function (genFun) { var ctor = "function" == typeof genFun && genFun.constructor; return !!ctor && (ctor === GeneratorFunction || "GeneratorFunction" === (ctor.displayName || ctor.name)); }, exports.mark = function (genFun) { return Object.setPrototypeOf ? Object.setPrototypeOf(genFun, GeneratorFunctionPrototype) : (genFun.__proto__ = GeneratorFunctionPrototype, define(genFun, toStringTagSymbol, "GeneratorFunction")), genFun.prototype = Object.create(Gp), genFun; }, exports.awrap = function (arg) { return { __await: arg }; }, defineIteratorMethods(AsyncIterator.prototype), define(AsyncIterator.prototype, asyncIteratorSymbol, function () { return this; }), exports.AsyncIterator = AsyncIterator, exports.async = function (innerFn, outerFn, self, tryLocsList, PromiseImpl) { void 0 === PromiseImpl && (PromiseImpl = Promise); var iter = new AsyncIterator(wrap(innerFn, outerFn, self, tryLocsList), PromiseImpl); return exports.isGeneratorFunction(outerFn) ? iter : iter.next().then(function (result) { return result.done ? result.value : iter.next(); }); }, defineIteratorMethods(Gp), define(Gp, toStringTagSymbol, "Generator"), define(Gp, iteratorSymbol, function () { return this; }), define(Gp, "toString", function () { return "[object Generator]"; }), exports.keys = function (val) { var object = Object(val), keys = []; for (var key in object) { keys.push(key); } return keys.reverse(), function next() { for (; keys.length;) { var key = keys.pop(); if (key in object) return next.value = key, next.done = !1, next; } return next.done = !0, next; }; }, exports.values = values, Context.prototype = { constructor: Context, reset: function reset(skipTempReset) { if (this.prev = 0, this.next = 0, this.sent = this._sent = undefined, this.done = !1, this.delegate = null, this.method = "next", this.arg = undefined, this.tryEntries.forEach(resetTryEntry), !skipTempReset) for (var name in this) { "t" === name.charAt(0) && hasOwn.call(this, name) && !isNaN(+name.slice(1)) && (this[name] = undefined); } }, stop: function stop() { this.done = !0; var rootRecord = this.tryEntries[0].completion; if ("throw" === rootRecord.type) throw rootRecord.arg; return this.rval; }, dispatchException: function dispatchException(exception) { if (this.done) throw exception; var context = this; function handle(loc, caught) { return record.type = "throw", record.arg = exception, context.next = loc, caught && (context.method = "next", context.arg = undefined), !!caught; } for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i], record = entry.completion; if ("root" === entry.tryLoc) return handle("end"); if (entry.tryLoc <= this.prev) { var hasCatch = hasOwn.call(entry, "catchLoc"), hasFinally = hasOwn.call(entry, "finallyLoc"); if (hasCatch && hasFinally) { if (this.prev < entry.catchLoc) return handle(entry.catchLoc, !0); if (this.prev < entry.finallyLoc) return handle(entry.finallyLoc); } else if (hasCatch) { if (this.prev < entry.catchLoc) return handle(entry.catchLoc, !0); } else { if (!hasFinally) throw new Error("try statement without catch or finally"); if (this.prev < entry.finallyLoc) return handle(entry.finallyLoc); } } } }, abrupt: function abrupt(type, arg) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.tryLoc <= this.prev && hasOwn.call(entry, "finallyLoc") && this.prev < entry.finallyLoc) { var finallyEntry = entry; break; } } finallyEntry && ("break" === type || "continue" === type) && finallyEntry.tryLoc <= arg && arg <= finallyEntry.finallyLoc && (finallyEntry = null); var record = finallyEntry ? finallyEntry.completion : {}; return record.type = type, record.arg = arg, finallyEntry ? (this.method = "next", this.next = finallyEntry.finallyLoc, ContinueSentinel) : this.complete(record); }, complete: function complete(record, afterLoc) { if ("throw" === record.type) throw record.arg; return "break" === record.type || "continue" === record.type ? this.next = record.arg : "return" === record.type ? (this.rval = this.arg = record.arg, this.method = "return", this.next = "end") : "normal" === record.type && afterLoc && (this.next = afterLoc), ContinueSentinel; }, finish: function finish(finallyLoc) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.finallyLoc === finallyLoc) return this.complete(entry.completion, entry.afterLoc), resetTryEntry(entry), ContinueSentinel; } }, "catch": function _catch(tryLoc) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.tryLoc === tryLoc) { var record = entry.completion; if ("throw" === record.type) { var thrown = record.arg; resetTryEntry(entry); } return thrown; } } throw new Error("illegal catch attempt"); }, delegateYield: function delegateYield(iterable, resultName, nextLoc) { return this.delegate = { iterator: values(iterable), resultName: resultName, nextLoc: nextLoc }, "next" === this.method && (this.arg = undefined), ContinueSentinel; } }, exports; }
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { Promise.resolve(value).then(_next, _throw); } }
+function _asyncToGenerator(fn) { return function () { var self = this, args = arguments; return new Promise(function (resolve, reject) { var gen = fn.apply(self, args); function _next(value) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value); } function _throw(err) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err); } _next(undefined); }); }; }
+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); }
+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); } /**
+ * ReferentielField — Portnet UI v2 (pattern)
+ *
+ * Charter §03 · Component "Referentiel · Search-and-select".
+ *
+ * Use this when:
+ *   - The selectable population is too large for <Combobox> to load.
+ *   - The host needs MULTI-CRITERIA search.
+ *   - The result rows benefit from a structured view.
+ *
+ * Criteria shape (B17 extension)
+ * ------------------------------
+ * Each criterion descriptor accepts:
+ *
+ *   { name, label, placeholder, hint, kind, options, loading,
+ *     getOptionValue, getOptionLabel, disableFuture }
+ *
+ *   - kind — discriminator: "input" (default) | "combobox" | "date"
+ *
+ * The B17 extension is purely additive: existing call sites with
+ * `criteria=[{name, label}]` keep rendering plain Inputs because
+ * `kind` defaults to "input".
+ *
+ * A11y trigger (audit Batch 5, finding B4-3):
+ *   The trigger Input acts as a combobox-like disclosure for a dialog
+ *   (the search Modal). aria-haspopup="dialog" + aria-expanded MUST sit
+ *   on the FOCUSABLE element (the <input/>), so every aria-* on the
+ *   trigger is routed through `inputProps` → slotProps.input. This
+ *   includes the Field-injected aria-invalid / aria-required /
+ *   aria-describedby so the whole aria contract lives on one element.
+ */ /** Localisable strings; `resultsHeading` is a function for plural rules. */ /** One search criterion. combobox/date-only fields reuse the real
+ *  component prop types so they stay exactly aligned. */
+var DEFAULT_LABELS = Object.freeze({
+  searchAria: "Rechercher",
+  clearAria: "Effacer la sélection",
+  modalCancel: "Annuler",
+  modalConfirm: "Sélectionner",
+  searchSubmit: "Rechercher",
+  resultsHeading: function resultsHeading(n) {
+    return "".concat(n, " r\xE9sultat").concat(n > 1 ? "s" : "");
+  },
+  initialEmptyTitle: "Aucune recherche",
+  initialEmptyHint: "Saisissez un critère puis lancez la recherche.",
+  noResultsTitle: "Aucun résultat",
+  noResultsHint: "Modifiez vos critères et relancez la recherche.",
+  errorTitle: "Recherche impossible",
+  errorRetry: "Réessayer",
+  loadingHint: "Recherche en cours…",
+  placeholder: "Sélectionner…"
+});
+var DEFAULT_PAGE_SIZE = 25;
+var DEFAULT_PAGE_SIZES = [25, 50, 100];
+
+/* Default getRowId (`(r) => r.id`); `(unknown) => RowId` is assignable to
+ * the declared `(row: T) => RowId` by parameter contravariance. */
+var defaultGetRowId = function defaultGetRowId(row) {
+  return row.id;
+};
+
+/* B17 — render a single criterion based on its `kind` discriminator.
+ * Falls back to Input for unknown kinds. The draft value is `unknown`
+ * (criteria are heterogeneous); one assertion at each value seam. */
+function renderCriterionField(c, value, _onChange) {
+  var _c$options;
+  var kind = c.kind || "input";
+  switch (kind) {
+    case "combobox":
+      return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Combobox["default"], _objectSpread(_objectSpread({
+        value: value !== null && value !== void 0 ? value : "",
+        onChange: function onChange(next) {
+          var _target$value, _target;
+          // Combobox may emit either a raw value or an event-like object;
+          // extract defensively in a way that is sound for any shape.
+          var extracted = next && _typeof(next) === "object" && "target" in next ? (_target$value = (_target = next.target) === null || _target === void 0 ? void 0 : _target.value) !== null && _target$value !== void 0 ? _target$value : next : next;
+          _onChange(extracted);
+        },
+        options: (_c$options = c.options) !== null && _c$options !== void 0 ? _c$options : [],
+        loading: Boolean(c.loading)
+      }, c.getOptionLabel !== undefined ? {
+        getOptionLabel: c.getOptionLabel
+      } : {}), c.placeholder !== undefined ? {
+        placeholder: c.placeholder
+      } : {}));
+    case "date":
+      return /*#__PURE__*/(0, _jsxRuntime.jsx)(_DatePicker["default"], _objectSpread({
+        name: c.name,
+        value: value !== null && value !== void 0 ? value : null,
+        onChange: function onChange(next) {
+          return _onChange(next);
+        },
+        disableFuture: Boolean(c.disableFuture)
+      }, c.placeholder !== undefined ? {
+        placeholder: c.placeholder
+      } : {}));
+    case "input":
+    default:
+      return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Input["default"], {
+        name: c.name,
+        value: value !== null && value !== void 0 ? value : "",
+        onChange: function onChange(e) {
+          return _onChange(e.target.value);
+        },
+        placeholder: c.placeholder
+      });
+  }
+}
+function ReferentielField(_ref) {
+  var value = _ref.value,
+    onChange = _ref.onChange,
+    getDisplayValue = _ref.getDisplayValue,
+    placeholder = _ref.placeholder,
+    _ref$disabled = _ref.disabled,
+    disabled = _ref$disabled === void 0 ? false : _ref$disabled,
+    _ref$readOnly = _ref.readOnly,
+    readOnly = _ref$readOnly === void 0 ? false : _ref$readOnly,
+    _ref$clearable = _ref.clearable,
+    clearable = _ref$clearable === void 0 ? true : _ref$clearable,
+    _ref$title = _ref.title,
+    title = _ref$title === void 0 ? "Rechercher" : _ref$title,
+    subtitle = _ref.subtitle,
+    _ref$size = _ref.size,
+    size = _ref$size === void 0 ? "lg" : _ref$size,
+    modalProps = _ref.modalProps,
+    search = _ref.search,
+    _ref$criteria = _ref.criteria,
+    criteria = _ref$criteria === void 0 ? [] : _ref$criteria,
+    initialCriteria = _ref.initialCriteria,
+    _ref$columns = _ref.columns,
+    columns = _ref$columns === void 0 ? [] : _ref$columns,
+    _ref$pageSize = _ref.pageSize,
+    pageSizeProp = _ref$pageSize === void 0 ? DEFAULT_PAGE_SIZE : _ref$pageSize,
+    _ref$pageSizes = _ref.pageSizes,
+    pageSizes = _ref$pageSizes === void 0 ? DEFAULT_PAGE_SIZES : _ref$pageSizes,
+    _ref$getRowId = _ref.getRowId,
+    getRowId = _ref$getRowId === void 0 ? defaultGetRowId : _ref$getRowId,
+    _ref$confirmOnSelecti = _ref.confirmOnSelection,
+    confirmOnSelection = _ref$confirmOnSelecti === void 0 ? false : _ref$confirmOnSelecti,
+    sort = _ref.sort,
+    onSortChange = _ref.onSortChange,
+    labels = _ref.labels,
+    locale = _ref.locale,
+    id = _ref.id,
+    name = _ref.name,
+    ariaInvalid = _ref["aria-invalid"],
+    ariaRequired = _ref["aria-required"],
+    ariaDescribedBy = _ref["aria-describedby"];
+  var L = React.useMemo(function () {
+    return labels ? _objectSpread(_objectSpread({}, DEFAULT_LABELS), labels) : DEFAULT_LABELS;
+  }, [labels]);
+
+  /* ── Modal lifecycle ──────────────────────────────────────── */
+  var _React$useState = React.useState(false),
+    _React$useState2 = _slicedToArray(_React$useState, 2),
+    open = _React$useState2[0],
+    setOpen = _React$useState2[1];
+  var triggerRef = React.useRef(null);
+  var openModal = React.useCallback(function () {
+    if (disabled || readOnly) return;
+    setOpen(true);
+  }, [disabled, readOnly]);
+  var closeModal = React.useCallback(function () {
+    setOpen(false);
+    setTimeout(function () {
+      // triggerRef's element type resolves to `{}` via React.ElementRef<typeof
+      // Input> (a TS inference gap, not a real absence of .focus at runtime —
+      // Input forwards its ref to a real focusable element). Cast narrowly at
+      // the point of use rather than widening the ref's declared type, so the
+      // `ref={triggerRef}` binding on <Input> below is unaffected.
+      var el = triggerRef.current;
+      if (el && typeof el.focus === "function") {
+        el.focus({
+          preventScroll: true
+        });
+      }
+    }, 0);
+  }, []);
+
+  /* ── Criteria draft + search state ───────────────────────── */
+  var seedCriteria = React.useMemo(function () {
+    var seed = {};
+    (criteria || []).forEach(function (c) {
+      seed[c.name] = initialCriteria && initialCriteria[c.name] || "";
+    });
+    return seed;
+  }, [criteria, initialCriteria]);
+  var _React$useState3 = React.useState(seedCriteria),
+    _React$useState4 = _slicedToArray(_React$useState3, 2),
+    draft = _React$useState4[0],
+    setDraft = _React$useState4[1];
+  React.useEffect(function () {
+    if (open) setDraft(seedCriteria);
+  }, [open, seedCriteria]);
+  var _React$useState5 = React.useState(1),
+    _React$useState6 = _slicedToArray(_React$useState5, 2),
+    page = _React$useState6[0],
+    setPage = _React$useState6[1];
+  var _React$useState7 = React.useState(pageSizeProp),
+    _React$useState8 = _slicedToArray(_React$useState7, 2),
+    pageSize = _React$useState8[0],
+    setPageSize = _React$useState8[1];
+  var _React$useState9 = React.useState([]),
+    _React$useState0 = _slicedToArray(_React$useState9, 2),
+    items = _React$useState0[0],
+    setItems = _React$useState0[1];
+  var _React$useState1 = React.useState(0),
+    _React$useState10 = _slicedToArray(_React$useState1, 2),
+    total = _React$useState10[0],
+    setTotal = _React$useState10[1];
+  var _React$useState11 = React.useState(false),
+    _React$useState12 = _slicedToArray(_React$useState11, 2),
+    loading = _React$useState12[0],
+    setLoading = _React$useState12[1];
+  var _React$useState13 = React.useState(null),
+    _React$useState14 = _slicedToArray(_React$useState13, 2),
+    error = _React$useState14[0],
+    setError = _React$useState14[1];
+  var _React$useState15 = React.useState(false),
+    _React$useState16 = _slicedToArray(_React$useState15, 2),
+    hasSearched = _React$useState16[0],
+    setHasSearched = _React$useState16[1];
+  var _React$useState17 = React.useState(null),
+    _React$useState18 = _slicedToArray(_React$useState17, 2),
+    pendingSelection = _React$useState18[0],
+    setPendingSelection = _React$useState18[1];
+
+  /* ── Search executor ─────────────────────────────────────── */
+  var requestSeq = React.useRef(0);
+  var runSearch = React.useCallback(/*#__PURE__*/_asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee() {
+    var _overrides$criteria, _overrides$page, _overrides$pageSize;
+    var overrides,
+      myReq,
+      effective,
+      result,
+      nextTotal,
+      _args = arguments;
+    return _regeneratorRuntime().wrap(function _callee$(_context) {
+      while (1) {
+        switch (_context.prev = _context.next) {
+          case 0:
+            overrides = _args.length > 0 && _args[0] !== undefined ? _args[0] : {};
+            if (!(typeof search !== "function")) {
+              _context.next = 3;
+              break;
+            }
+            return _context.abrupt("return");
+          case 3:
+            myReq = ++requestSeq.current;
+            effective = {
+              criteria: (_overrides$criteria = overrides.criteria) !== null && _overrides$criteria !== void 0 ? _overrides$criteria : draft,
+              page: (_overrides$page = overrides.page) !== null && _overrides$page !== void 0 ? _overrides$page : 1,
+              pageSize: (_overrides$pageSize = overrides.pageSize) !== null && _overrides$pageSize !== void 0 ? _overrides$pageSize : pageSize,
+              sort: sort
+            };
+            setLoading(true);
+            setError(null);
+            setHasSearched(true);
+            _context.prev = 8;
+            _context.next = 11;
+            return search(effective);
+          case 11:
+            result = _context.sent;
+            if (!(myReq !== requestSeq.current)) {
+              _context.next = 14;
+              break;
+            }
+            return _context.abrupt("return");
+          case 14:
+            setItems(Array.isArray(result.items) ? result.items : []);
+            nextTotal = typeof result.total === "number" && Number.isFinite(result.total) ? result.total : result.items.length;
+            setTotal(nextTotal);
+            setPage(effective.page);
+            setPageSize(effective.pageSize);
+            _context.next = 28;
+            break;
+          case 21:
+            _context.prev = 21;
+            _context.t0 = _context["catch"](8);
+            if (!(myReq !== requestSeq.current)) {
+              _context.next = 25;
+              break;
+            }
+            return _context.abrupt("return");
+          case 25:
+            setError(_context.t0 instanceof Error ? _context.t0 : new Error("search failed"));
+            setItems([]);
+            setTotal(0);
+          case 28:
+            _context.prev = 28;
+            if (myReq === requestSeq.current) setLoading(false);
+            return _context.finish(28);
+          case 31:
+          case "end":
+            return _context.stop();
+        }
+      }
+    }, _callee, null, [[8, 21, 28, 31]]);
+  })), [search, draft, pageSize, sort]);
+
+  /* ── Form submission inside the modal ────────────────────── */
+  var onSubmitCriteria = function onSubmitCriteria(e) {
+    e.preventDefault();
+    setPendingSelection(null);
+    runSearch({
+      criteria: draft,
+      page: 1
+    });
+  };
+  var onPageChange = function onPageChange(nextPage) {
+    runSearch({
+      page: nextPage
+    });
+  };
+  var onPageSizeChange = function onPageSizeChange(nextPageSize) {
+    runSearch({
+      page: 1,
+      pageSize: nextPageSize
+    });
+  };
+
+  /* ── Selection ───────────────────────────────────────────── */
+  var handleRowClick = function handleRowClick(row) {
+    if (confirmOnSelection) {
+      setPendingSelection(row);
+      return;
+    }
+    onChange === null || onChange === void 0 ? void 0 : onChange(row);
+    closeModal();
+  };
+  var handleConfirmSelection = function handleConfirmSelection() {
+    if (!pendingSelection) return;
+    onChange === null || onChange === void 0 ? void 0 : onChange(pendingSelection);
+    setPendingSelection(null);
+    closeModal();
+  };
+  var handleClear = function handleClear(e) {
+    e.stopPropagation();
+    if (disabled || readOnly) return;
+    onChange === null || onChange === void 0 ? void 0 : onChange(null);
+  };
+
+  /* ── Trigger display ─────────────────────────────────────── */
+  var display = React.useMemo(function () {
+    if (value == null || value === "") return "";
+    if (typeof getDisplayValue === "function") {
+      try {
+        var _getDisplayValue;
+        return (_getDisplayValue = getDisplayValue(value)) !== null && _getDisplayValue !== void 0 ? _getDisplayValue : "";
+      } catch (_unused) {
+        return "";
+      }
+    }
+    if (typeof value === "string") return value;
+    if (value && _typeof(value) === "object") {
+      var v = value;
+      return v.description || v.label || v.name || v.code || "";
+    }
+    return String(value);
+  }, [value, getDisplayValue]);
+
+  /* ── DataGrid pagination contract ────────────────────────── */
+  var pagination = React.useMemo(function () {
+    return {
+      page: page,
+      pageSize: pageSize,
+      total: total,
+      pageSizes: pageSizes,
+      onPageChange: onPageChange,
+      onPageSizeChange: onPageSizeChange
+    };
+  },
+  // eslint-disable-next-line react-hooks/exhaustive-deps
+  [page, pageSize, total, pageSizes]);
+
+  /* ── Empty / error states for DataGrid ───────────────────── */
+  var initialEmpty = /*#__PURE__*/(0, _jsxRuntime.jsx)(_EmptyState["default"], {
+    variant: "initial",
+    title: L.initialEmptyTitle,
+    description: L.initialEmptyHint
+  });
+  var filteredEmpty = /*#__PURE__*/(0, _jsxRuntime.jsx)(_EmptyState["default"], {
+    variant: "filtered",
+    title: L.noResultsTitle,
+    description: L.noResultsHint
+  });
+  var errorState = /*#__PURE__*/(0, _jsxRuntime.jsx)(_Banner["default"], {
+    variant: "error",
+    title: L.errorTitle,
+    action: {
+      label: L.errorRetry,
+      onClick: function onClick() {
+        return runSearch({
+          page: 1
+        });
+      }
+    },
+    children: (error === null || error === void 0 ? void 0 : error.message) || String(error || "")
+  });
+
+  /* ── Render the trigger ──────────────────────────────────── */
+  var showClear = clearable && !disabled && !readOnly && Boolean(display);
+
+  // B4-3 fix — bundle every aria-* attribute of the trigger so v2.Input
+  // routes them into slotProps.input → the native <input/>. Typed as
+  // AriaAttributes so "aria-haspopup":"dialog" stays a valid literal.
+  var triggerAria = React.useMemo(function () {
+    return _objectSpread(_objectSpread(_objectSpread({
+      "aria-haspopup": "dialog",
+      "aria-expanded": open
+    }, ariaInvalid != null ? {
+      "aria-invalid": ariaInvalid
+    } : {}), ariaRequired != null ? {
+      "aria-required": ariaRequired
+    } : {}), ariaDescribedBy ? {
+      "aria-describedby": ariaDescribedBy
+    } : {});
+  }, [open, ariaInvalid, ariaRequired, ariaDescribedBy]);
+  var trigger = /*#__PURE__*/(0, _jsxRuntime.jsx)(_Input["default"], {
+    ref: triggerRef,
+    id: id,
+    name: name,
+    value: display,
+    placeholder: placeholder !== null && placeholder !== void 0 ? placeholder : L.placeholder,
+    readOnly: true,
+    disabled: disabled,
+    onClick: openModal,
+    onKeyDown: function onKeyDown(e) {
+      if (e.key === "Enter" || e.key === " ") {
+        e.preventDefault();
+        openModal();
+      }
+    },
+    inputProps: triggerAria,
+    sx: {
+      cursor: disabled ? "not-allowed" : "pointer",
+      "& input": {
+        cursor: disabled ? "not-allowed" : "pointer"
+      }
+    },
+    endIcon: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_Box["default"], {
+      sx: {
+        display: "inline-flex",
+        alignItems: "center",
+        gap: "var(--s-1)"
+      },
+      children: [showClear && /*#__PURE__*/(0, _jsxRuntime.jsx)(_IconButton["default"], {
+        type: "button",
+        size: "small",
+        onClick: handleClear,
+        "aria-label": L.clearAria,
+        edge: "end",
+        sx: {
+          color: "var(--fg-subtle)"
+        },
+        children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Close["default"], {
+          fontSize: "small"
+        })
+      }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_IconButton["default"], {
+        type: "button",
+        size: "small",
+        onClick: function onClick(e) {
+          e.stopPropagation();
+          openModal();
+        },
+        "aria-label": L.searchAria,
+        edge: "end",
+        disabled: disabled,
+        sx: {
+          color: "var(--accent)"
+        },
+        children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Search["default"], {
+          fontSize: "small"
+        })
+      })]
+    })
+  });
+
+  /* ── Modal body ──────────────────────────────────────────── */
+  var criteriaRow = criteria.length > 0 && /*#__PURE__*/(0, _jsxRuntime.jsxs)(_Box["default"], {
+    component: "form",
+    onSubmit: onSubmitCriteria,
+    sx: {
+      display: "grid",
+      gap: "var(--s-3)",
+      gridTemplateColumns: {
+        xs: "1fr",
+        sm: criteria.length > 1 ? "1fr 1fr" : "1fr",
+        md: "repeat(".concat(Math.min(criteria.length, 3), ", 1fr) auto")
+      },
+      alignItems: "end",
+      marginBottom: "var(--s-4)"
+    },
+    children: [criteria.map(function (c) {
+      return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Field["default"], {
+        label: c.label,
+        hint: c.hint,
+        children: renderCriterionField(c, draft[c.name], function (next) {
+          return setDraft(function (d) {
+            return _objectSpread(_objectSpread({}, d), {}, _defineProperty({}, c.name, next));
+          });
+        })
+      }, c.name);
+    }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_Box["default"], {
+      sx: {
+        display: "flex",
+        justifyContent: "flex-end"
+      },
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Button["default"], {
+        variant: "primary",
+        type: "submit",
+        loading: loading,
+        children: L.searchSubmit
+      })
+    })]
+  });
+  var liveResults = /*#__PURE__*/(0, _jsxRuntime.jsx)(_Box["default"], {
+    "aria-live": "polite",
+    "aria-atomic": "true",
+    className: "pui-sr-only",
+    children: hasSearched && !loading && !error ? L.resultsHeading(total) : ""
+  });
+  var decoratedRows = React.useMemo(function () {
+    if (!confirmOnSelection || !pendingSelection) return items;
+    var pendingId = getRowId(pendingSelection);
+    return items.map(function (r) {
+      return getRowId(r) === pendingId ? _objectSpread(_objectSpread({}, r), {}, {
+        __pending: true
+      }) : r;
+    });
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [items, pendingSelection, confirmOnSelection]);
+
+  /* ── Modal footer ────────────────────────────────────────── */
+  var footer = /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_Button["default"], {
+      variant: "ghost",
+      onClick: closeModal,
+      children: L.modalCancel
+    }), confirmOnSelection && /*#__PURE__*/(0, _jsxRuntime.jsx)(_Button["default"], {
+      variant: "primary",
+      disabled: !pendingSelection,
+      onClick: handleConfirmSelection,
+      children: L.modalConfirm
+    })]
+  });
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
+    children: [trigger, /*#__PURE__*/(0, _jsxRuntime.jsxs)(_Modal["default"], _objectSpread(_objectSpread({
+      open: open,
+      onClose: closeModal,
+      title: title,
+      subtitle: subtitle,
+      size: size,
+      footer: footer
+    }, modalProps), {}, {
+      children: [criteriaRow, liveResults, /*#__PURE__*/(0, _jsxRuntime.jsx)(_DataGrid["default"], _objectSpread(_objectSpread(_objectSpread(_objectSpread({
+        rows: decoratedRows,
+        columns: columns,
+        loading: loading,
+        error: error,
+        onRowClick: handleRowClick,
+        pagination: pagination,
+        getRowId: getRowId,
+        emptyState: initialEmpty,
+        filteredEmptyState: filteredEmpty,
+        errorState: errorState,
+        filtered: hasSearched
+      }, sort !== undefined ? {
+        sort: sort
+      } : {}), onSortChange !== undefined ? {
+        onSortChange: onSortChange
+      } : {}), locale !== undefined ? {
+        locale: locale
+      } : {}), confirmOnSelection && pendingSelection ? {
+        rowFlashId: getRowId(pendingSelection)
+      } : {}))]
+    }))]
+  });
+}
+var _default = exports["default"] = ReferentielField;
+//# sourceMappingURL=ReferentielField.js.map