@portnet/ui 6.0.0 → 6.0.2

package/dist/esm/v2/patterns/FormikReferentielField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormikReferentielField.js","names":["React","useField","useFormikContext","Field","ReferentielField","jsx","_jsx","FormikReferentielField","_ref","name","label","required","disabled","hint","htmlFor","getOptionValue","getDescription","onPick","seenRows","refProps","_objectWithoutProperties","_excluded","_useField","_useField2","_slicedToArray","field","meta","_useFormikContext","setFieldValue","setFieldTouched","hasError","Boolean","touched","error","cacheRef","useRef","Map","forEach","row","current","set","valueRow","useMemo","_cacheRef$current$get","value","get","handleChange","val","display","useCallback","rowOrVal","_typeof","String","cached","_objectSpread","undefined","children","onChange","getDisplayValue"],"sources":["../../../../src/lib/v2/patterns/FormikReferentielField.tsx"],"sourcesContent":["/**\r\n * FormikReferentielField — bridge between Formik state and\r\n * v2.ReferentielField.\r\n *\r\n * Mirrors the API surface of the legacy AppFormikSearchField wrapper:\r\n *   - stores `getOptionValue(row)` in Formik state under `name`\r\n *   - displays `getDescription(row)` in the trigger Input (resolves\r\n *     via a host-supplied lookup or a cached map of seen rows)\r\n *   - calls `onPick(row)` after a successful selection so the host\r\n *     can mirror sibling fields (e.g. *.id + *.description pairs)\r\n *\r\n * Charter R-Sel.1 → R-Sel.4. Peer dependency: formik >= 2.x.\r\n */\r\n\r\nimport * as React from \"react\";\r\nimport { useField, useFormikContext } from \"formik\";\r\nimport Field from \"../components/Field\";\r\nimport ReferentielField, { type ReferentielFieldProps } from \"./ReferentielField\";\r\n\r\nexport interface FormikReferentielFieldProps<T>\r\n  extends Omit<\r\n    ReferentielFieldProps<T>,\r\n    \"value\" | \"onChange\" | \"getDisplayValue\" | \"name\"\r\n  > {\r\n  name: string;\r\n  label?: React.ReactNode | undefined;\r\n  required?: boolean | undefined;\r\n  hint?: React.ReactNode | undefined;\r\n  htmlFor?: string | undefined;\r\n  /** Resolve the primitive stored in Formik state from a picked row. */\r\n  getOptionValue?: ((row: T) => unknown) | undefined;\r\n  /** Resolve the trigger display string from a row. */\r\n  getDescription?: ((row: T) => string) | undefined;\r\n  /** Called after a successful pick so the host can mirror siblings. */\r\n  onPick?: ((row: T) => void) | undefined;\r\n  /** Rows to seed the label cache with (e.g. an edit form's initial value). */\r\n  seenRows?: T[] | undefined;\r\n}\r\n\r\nfunction FormikReferentielField<T>({\r\n  name,\r\n  label,\r\n  required,\r\n  disabled,\r\n  hint,\r\n  htmlFor,\r\n  getOptionValue,\r\n  getDescription,\r\n  onPick,\r\n  seenRows,\r\n  ...refProps\r\n}: FormikReferentielFieldProps<T>) {\r\n  const [field, meta] = useField<unknown>(name);\r\n  const { setFieldValue, setFieldTouched } = useFormikContext();\r\n  const hasError = Boolean(meta.touched && meta.error);\r\n\r\n  /* Cache of rows the user has picked in this session, keyed by the\r\n   * resolved option value. Lets us render the trigger label after a\r\n   * pick without re-fetching. */\r\n  const cacheRef = React.useRef(new Map<unknown, T>());\r\n  // `seenRows` (if provided) seeds the cache and is NOT forwarded to\r\n  // ReferentielField — consuming it via the destructure keeps refProps clean.\r\n  if (seenRows) {\r\n    seenRows.forEach((row) => {\r\n      cacheRef.current.set(getOptionValue ? getOptionValue(row) : row, row);\r\n    });\r\n  }\r\n\r\n  const valueRow = React.useMemo<T | null>(() => {\r\n    if (field.value == null || field.value === \"\") return null;\r\n    return cacheRef.current.get(field.value) ?? null;\r\n  }, [field.value]);\r\n\r\n  const handleChange = (row: T | null) => {\r\n    if (row == null) {\r\n      setFieldValue(name, \"\");\r\n      setFieldTouched(name, true, false);\r\n      return;\r\n    }\r\n    const val = getOptionValue ? getOptionValue(row) : row;\r\n    cacheRef.current.set(val, row);\r\n    setFieldValue(name, val);\r\n    setFieldTouched(name, true, false);\r\n    if (typeof onPick === \"function\") onPick(row);\r\n  };\r\n\r\n  const display = React.useCallback(\r\n    (rowOrVal: T): string => {\r\n      // ReferentielField calls getDisplayValue(value) — `value` here is\r\n      // either the cached row (if available) or the raw formik primitive.\r\n      // Resolve through the cache when we have it.\r\n      if (rowOrVal && typeof rowOrVal === \"object\") {\r\n        return getDescription ? getDescription(rowOrVal) : String(rowOrVal);\r\n      }\r\n      const cached = cacheRef.current.get(rowOrVal);\r\n      if (cached)\r\n        return getDescription ? getDescription(cached) : String(cached);\r\n      return rowOrVal == null ? \"\" : String(rowOrVal);\r\n    },\r\n    [getDescription]\r\n  );\r\n\r\n  return (\r\n    <Field\r\n      label={label}\r\n      error={hasError ? meta.error : null}\r\n      hint={!hasError ? hint : undefined}\r\n      htmlFor={htmlFor || name}\r\n      {...(required !== undefined ? { required } : {})}\r\n      {...(disabled !== undefined ? { disabled } : {})}\r\n    >\r\n      <ReferentielField\r\n        name={name}\r\n        value={(valueRow ?? field.value) as T | null}\r\n        onChange={handleChange}\r\n        getDisplayValue={display}\r\n        {...refProps}\r\n        {...(disabled !== undefined ? { disabled } : {})}\r\n      />\r\n    </Field>\r\n  );\r\n}\r\n\r\nexport default FormikReferentielField;\r\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/v2/patterns/FormikSelect.js

@@ -0,0 +1,162 @@
+var _excluded = ["name", "label", "required", "hint", "options", "getOptionValue", "getOptionLabel", "loading", "disabled", "readOnly", "mono", "placeholder", "htmlFor", "width", "onSelectionChange"];
+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 _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 _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
+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); }
+/**
+ * FormikSelect — bridge between Formik state and v2.Field + v2.Select.
+ *
+ * Charter §03 · R-Sel.1 → R-Sel.5. Peer dependency: formik >= 2.x.
+ *
+ * Use for short / medium option lists. For large referential lists that
+ * need free-text filtering, prefer FormikCombobox, or pass `searchThreshold`
+ * straight through to the underlying v2.Select.
+ *
+ * Maps caller-supplied raw options to v2.Select's {value, label} shape and
+ * exposes onSelectionChange(rawOption) for consumers that need cross-field
+ * side effects on pick.
+ *
+ *   <FormikSelect
+ *     name="bureau"
+ *     label="Bureau douanier"
+ *     options={bureaux}
+ *     getOptionValue={(b) => b.id}
+ *     getOptionLabel={(b) => b.libelle}
+ *   />
+ */
+
+import * as React from "react";
+import { useField, useFormikContext } from "formik";
+import Field from "../components/Field";
+import Select from "../components/Select";
+import FormikDisplay from "../components/FormikDisplay";
+import { labelFromValue, sameOptionValue } from "../components/Select";
+import { jsx as _jsx } from "react/jsx-runtime";
+function defaultGetOptionValue(opt) {
+  if (opt == null || _typeof(opt) !== "object") return opt;
+  var rec = opt;
+  if (rec["value"] !== undefined && rec["value"] !== null) return rec["value"];
+  if (rec["id"] !== undefined && rec["id"] !== null) return rec["id"];
+  // Unreachable for well-formed options: an object exposing neither value nor
+  // id can never be a valid Select value/key, so collapse to empty selection.
+  return "";
+}
+function defaultGetOptionLabel(opt) {
+  if (opt == null) return "";
+  if (_typeof(opt) !== "object") return String(opt);
+  var rec = opt;
+  if (rec["description"]) return String(rec["description"]);
+  if (rec["label"]) return String(rec["label"]);
+  if (rec["code"]) return String(rec["code"]);
+  return String(opt);
+}
+var FormikSelect = function FormikSelect(_ref) {
+  var _field$value;
+  var name = _ref.name,
+    label = _ref.label,
+    required = _ref.required,
+    hint = _ref.hint,
+    _ref$options = _ref.options,
+    options = _ref$options === void 0 ? [] : _ref$options,
+    _ref$getOptionValue = _ref.getOptionValue,
+    getOptionValue = _ref$getOptionValue === void 0 ? defaultGetOptionValue : _ref$getOptionValue,
+    _ref$getOptionLabel = _ref.getOptionLabel,
+    getOptionLabel = _ref$getOptionLabel === void 0 ? defaultGetOptionLabel : _ref$getOptionLabel,
+    _ref$loading = _ref.loading,
+    loading = _ref$loading === void 0 ? false : _ref$loading,
+    _ref$disabled = _ref.disabled,
+    disabled = _ref$disabled === void 0 ? false : _ref$disabled,
+    _ref$readOnly = _ref.readOnly,
+    readOnly = _ref$readOnly === void 0 ? false : _ref$readOnly,
+    mono = _ref.mono,
+    placeholder = _ref.placeholder,
+    htmlFor = _ref.htmlFor,
+    width = _ref.width,
+    onSelectionChange = _ref.onSelectionChange,
+    rest = _objectWithoutProperties(_ref, _excluded);
+  var _useField = useField(name),
+    _useField2 = _slicedToArray(_useField, 2),
+    field = _useField2[0],
+    meta = _useField2[1];
+  var _useFormikContext = useFormikContext(),
+    setFieldValue = _useFormikContext.setFieldValue,
+    setFieldTouched = _useFormikContext.setFieldTouched;
+  var hasError = Boolean(meta.touched && meta.error);
+  var v2Options = options.map(function (opt) {
+    var raw = opt;
+    if (raw == null || _typeof(raw) !== "object") return raw;
+    return {
+      value: getOptionValue(opt),
+      label: getOptionLabel(opt),
+      __raw: opt
+    };
+  });
+  var handleChange = function handleChange(e) {
+    var next = e && e.target ? e.target.value : e;
+    setFieldValue(name, next === "" ? null : next);
+    setFieldTouched(name, true, false);
+    if (typeof onSelectionChange === "function") {
+      var found = v2Options.find(function (o) {
+        return _typeof(o) === "object" && o !== null && o.value === next;
+      });
+      var picked = found && _typeof(found) === "object" ? found.__raw : null;
+      onSelectionChange(picked);
+    }
+  };
+  var resolvedPlaceholder = loading ? "Chargement…" : placeholder;
+
+  /* Lecture seule : on résout le libellé de l'option avant de déléguer, sinon
+   * FormikDisplay afficherait la VALEUR brute (un code, ou un objet dont il ne
+   * lirait que `.description`). */
+  if (readOnly && !disabled) {
+    return /*#__PURE__*/_jsx(FormikDisplay, _objectSpread(_objectSpread(_objectSpread({
+      name: name,
+      label: label
+    }, hint !== undefined ? {
+      hint: hint
+    } : {}), mono !== undefined ? {
+      mono: mono
+    } : {}), {}, {
+      format: function format(raw) {
+        var match = options.find(function (opt) {
+          return sameOptionValue(getOptionValue(opt), raw);
+        });
+        if (match !== undefined) return getOptionLabel(match);
+        return labelFromValue(raw);
+      }
+    }));
+  }
+  return /*#__PURE__*/_jsx(Field, _objectSpread(_objectSpread(_objectSpread({
+    label: label,
+    error: hasError ? meta.error : null,
+    hint: !hasError ? hint : undefined,
+    htmlFor: htmlFor || name,
+    disabled: disabled
+  }, required !== undefined ? {
+    required: required
+  } : {}), width !== undefined ? {
+    width: width
+  } : {}), {}, {
+    children: /*#__PURE__*/_jsx(Select, _objectSpread(_objectSpread({
+      value: (_field$value = field.value) !== null && _field$value !== void 0 ? _field$value : "",
+      onChange: handleChange,
+      onBlur: field.onBlur,
+      options: v2Options,
+      disabled: Boolean(disabled || loading)
+    }, rest), resolvedPlaceholder !== undefined ? {
+      placeholder: resolvedPlaceholder
+    } : {}))
+  }));
+};
+export default FormikSelect;
+//# sourceMappingURL=FormikSelect.js.map

package/dist/esm/v2/patterns/FormikSelect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormikSelect.js","names":["React","useField","useFormikContext","Field","Select","FormikDisplay","labelFromValue","sameOptionValue","jsx","_jsx","defaultGetOptionValue","opt","_typeof","rec","undefined","defaultGetOptionLabel","String","FormikSelect","_ref","_field$value","name","label","required","hint","_ref$options","options","_ref$getOptionValue","getOptionValue","_ref$getOptionLabel","getOptionLabel","_ref$loading","loading","_ref$disabled","disabled","_ref$readOnly","readOnly","mono","placeholder","htmlFor","width","onSelectionChange","rest","_objectWithoutProperties","_excluded","_useField","_useField2","_slicedToArray","field","meta","_useFormikContext","setFieldValue","setFieldTouched","hasError","Boolean","touched","error","v2Options","map","raw","value","__raw","handleChange","e","next","target","found","find","o","picked","resolvedPlaceholder","_objectSpread","format","match","children","onChange","onBlur"],"sources":["../../../../src/lib/v2/patterns/FormikSelect.tsx"],"sourcesContent":["/**\r\n * FormikSelect — bridge between Formik state and v2.Field + v2.Select.\r\n *\r\n * Charter §03 · R-Sel.1 → R-Sel.5. Peer dependency: formik >= 2.x.\r\n *\r\n * Use for short / medium option lists. For large referential lists that\r\n * need free-text filtering, prefer FormikCombobox, or pass `searchThreshold`\r\n * straight through to the underlying v2.Select.\r\n *\r\n * Maps caller-supplied raw options to v2.Select's {value, label} shape and\r\n * exposes onSelectionChange(rawOption) for consumers that need cross-field\r\n * side effects on pick.\r\n *\r\n *   <FormikSelect\r\n *     name=\"bureau\"\r\n *     label=\"Bureau douanier\"\r\n *     options={bureaux}\r\n *     getOptionValue={(b) => b.id}\r\n *     getOptionLabel={(b) => b.libelle}\r\n *   />\r\n */\r\n\r\nimport * as React from \"react\";\r\nimport { useField, useFormikContext } from \"formik\";\r\nimport Field from \"../components/Field\";\r\nimport Select from \"../components/Select\";\r\nimport FormikDisplay from \"../components/FormikDisplay\";\r\nimport { labelFromValue, sameOptionValue } from \"../components/Select\";\r\nimport type { FieldWidth } from \"../components/Field\";\r\nimport type {\r\n  SelectOptionValue,\r\n  SelectProps,\r\n  SelectValue,\r\n  SelectChangeLike,\r\n} from \"../components/Select\";\r\n\r\nfunction defaultGetOptionValue(opt: unknown): SelectOptionValue {\r\n  if (opt == null || typeof opt !== \"object\") return opt as SelectOptionValue;\r\n  const rec = opt as Record<string, unknown>;\r\n  if (rec[\"value\"] !== undefined && rec[\"value\"] !== null) return rec[\"value\"] as SelectOptionValue;\r\n  if (rec[\"id\"] !== undefined && rec[\"id\"] !== null) return rec[\"id\"] as SelectOptionValue;\r\n  // Unreachable for well-formed options: an object exposing neither value nor\r\n  // id can never be a valid Select value/key, so collapse to empty selection.\r\n  return \"\";\r\n}\r\n\r\nfunction defaultGetOptionLabel(opt: unknown): string {\r\n  if (opt == null) return \"\";\r\n  if (typeof opt !== \"object\") return String(opt);\r\n  const rec = opt as Record<string, unknown>;\r\n  if (rec[\"description\"]) return String(rec[\"description\"]);\r\n  if (rec[\"label\"]) return String(rec[\"label\"]);\r\n  if (rec[\"code\"]) return String(rec[\"code\"]);\r\n  return String(opt);\r\n}\r\n\r\nexport interface FormikSelectProps<TOption = unknown>\r\n  extends Omit<\r\n    SelectProps,\r\n    | \"value\"\r\n    | \"onChange\"\r\n    | \"onBlur\"\r\n    | \"options\"\r\n    | \"disabled\"\r\n    | \"placeholder\"\r\n    | \"label\"\r\n    | \"required\"\r\n    | \"error\"\r\n    // SelectProps carries its own loosely-typed `ref` (Ref<unknown>, likely\r\n    // inherited from its underlying MUI base) that isn't the real ref for\r\n    // this wrapper. Excluding it here stops it leaking into ...rest below\r\n    // and colliding with <Select>'s real RefAttributes<HTMLInputElement>.\r\n    | \"ref\"\r\n  > {\r\n  name: string;\r\n  label?: React.ReactNode | undefined;\r\n  required?: boolean | undefined;\r\n  hint?: React.ReactNode | undefined;\r\n  options?: TOption[] | undefined;\r\n  getOptionValue?: ((opt: TOption) => SelectOptionValue) | undefined;\r\n  getOptionLabel?: ((opt: TOption) => React.ReactNode) | undefined;\r\n  loading?: boolean | undefined;\r\n  disabled?: boolean | undefined;\r\n  /**\r\n   * Render the RESOLVED OPTION LABEL as read-only text via FormikDisplay,\r\n   * instead of a Select.\r\n   *\r\n   * Resolution matters here in a way it does not for FormikInput: the Formik\r\n   * value is whatever `getOptionValue` produced — often a code, sometimes a\r\n   * whole referentiel object — and printing it raw would show\r\n   * \"DOMAIN_ACTIVITE_1\" where the user expects \"Domaine médical\". So the value is\r\n   * matched back against `options` and `getOptionLabel` supplies the text.\r\n   *\r\n   * Matching goes through the same `sameOptionValue` the Select itself uses, so\r\n   * a value seeded from an API payload still matches a separately-fetched\r\n   * option (structural comparison, not reference identity). When nothing\r\n   * matches, `labelFromValue` derives something readable from the value rather\r\n   * than showing a code.\r\n   *\r\n   * `disabled` wins when both are passed — same rule as FormikInput.\r\n   */\r\n  readOnly?: boolean | undefined;\r\n  /** Tabular-nums monospace in read-only mode. */\r\n  mono?: boolean | undefined;\r\n  placeholder?: string | undefined;\r\n  htmlFor?: string | undefined;\r\n  /**\r\n   * Gabarit de largeur semantique (G-H). Sur un select, le gabarit se choisit\r\n   * d'apres la longueur des LIBELLES d'options, pas d'une contrainte de\r\n   * saisie : le standard range les « simple dropdowns » en `m` et les « long\r\n   * dropdowns » en `l`. Ne s'applique pas en mode `readOnly`.\r\n   */\r\n  width?: FieldWidth | undefined;\r\n  onSelectionChange?: ((picked: TOption | null) => void) | undefined;\r\n}\r\n\r\nconst FormikSelect = <TOption,>({\r\n  name,\r\n  label,\r\n  required,\r\n  hint,\r\n  options = [],\r\n  getOptionValue = defaultGetOptionValue,\r\n  getOptionLabel = defaultGetOptionLabel,\r\n  loading = false,\r\n  disabled = false,\r\n  readOnly = false,\r\n  mono,\r\n  placeholder,\r\n  htmlFor,\r\n  width,\r\n  onSelectionChange,\r\n  ...rest\r\n}: FormikSelectProps<TOption>) => {\r\n  const [field, meta] = useField<SelectValue>(name);\r\n  const { setFieldValue, setFieldTouched } = useFormikContext();\r\n  const hasError = Boolean(meta.touched && meta.error);\r\n\r\n  const v2Options = options.map(\r\n    (opt): string | { value: SelectOptionValue; label: React.ReactNode; __raw: TOption } => {\r\n      const raw: unknown = opt;\r\n      if (raw == null || typeof raw !== \"object\") return raw as string;\r\n      return {\r\n        value: getOptionValue(opt),\r\n        label: getOptionLabel(opt),\r\n        __raw: opt,\r\n      };\r\n    },\r\n  );\r\n\r\n  const handleChange = (e: SelectChangeLike) => {\r\n    const next = e && e.target ? e.target.value : e;\r\n    setFieldValue(name, next === \"\" ? null : next);\r\n    setFieldTouched(name, true, false);\r\n    if (typeof onSelectionChange === \"function\") {\r\n      const found = v2Options.find(\r\n        (o) => typeof o === \"object\" && o !== null && o.value === next,\r\n      );\r\n      const picked = found && typeof found === \"object\" ? found.__raw : null;\r\n      onSelectionChange(picked);\r\n    }\r\n  };\r\n\r\n  const resolvedPlaceholder = loading ? \"Chargement…\" : placeholder;\r\n\r\n  /* Lecture seule : on résout le libellé de l'option avant de déléguer, sinon\r\n   * FormikDisplay afficherait la VALEUR brute (un code, ou un objet dont il ne\r\n   * lirait que `.description`). */\r\n  if (readOnly && !disabled) {\r\n    return (\r\n      <FormikDisplay\r\n        name={name}\r\n        label={label}\r\n        {...(hint !== undefined ? { hint } : {})}\r\n        {...(mono !== undefined ? { mono } : {})}\r\n        format={(raw) => {\r\n          const match = options.find((opt) =>\r\n            sameOptionValue(getOptionValue(opt), raw),\r\n          );\r\n          if (match !== undefined) return getOptionLabel(match);\r\n          return labelFromValue(raw);\r\n        }}\r\n      />\r\n    );\r\n  }\r\n\r\n  return (\r\n    <Field\r\n      label={label}\r\n      error={hasError ? meta.error : null}\r\n      hint={!hasError ? hint : undefined}\r\n      htmlFor={htmlFor || name}\r\n      disabled={disabled}\r\n      {...(required !== undefined ? { required } : {})}\r\n      {...(width !== undefined ? { width } : {})}\r\n    >\r\n      <Select\r\n        value={field.value ?? \"\"}\r\n        onChange={handleChange}\r\n        onBlur={field.onBlur}\r\n        options={v2Options}\r\n        disabled={Boolean(disabled || loading)}\r\n        {...rest}\r\n        {...(resolvedPlaceholder !== undefined ? { placeholder: resolvedPlaceholder } : {})}\r\n      />\r\n    </Field>\r\n  );\r\n};\r\n\r\nexport default FormikSelect;\r\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/v2/patterns/FormikTextarea.js

@@ -0,0 +1,79 @@
+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); }
+var _excluded = ["name", "label", "required", "rows", "htmlFor", "hint", "disabled", "width"];
+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 _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 _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
+/**
+ * FormikTextarea — bridge between Formik state and v2.Field + v2.Textarea.
+ *
+ * Default rows = 4 (matches the legacy Pui multiline default
+ * across ms-ti-fe / addpe-fe usage).
+ *
+ * Usage:
+ *
+ *   import { FormikTextarea } from "@portnet/ui/lib/v2";
+ *
+ *   <FormikTextarea
+ *     name="observation"
+ *     label="Observations"
+ *     rows={4}
+ *   />
+ *
+ * Charter §03 / R-I.1 → R-I.6. Peer dependency: `formik` >= 2.x.
+ */
+
+import * as React from "react";
+import { useField } from "formik";
+import Field from "../components/Field";
+import Textarea from "../components/Textarea";
+import { jsx as _jsx } from "react/jsx-runtime";
+var FormikTextarea = function FormikTextarea(_ref) {
+  var _field$value;
+  var name = _ref.name,
+    label = _ref.label,
+    required = _ref.required,
+    _ref$rows = _ref.rows,
+    rows = _ref$rows === void 0 ? 4 : _ref$rows,
+    htmlFor = _ref.htmlFor,
+    hint = _ref.hint,
+    disabled = _ref.disabled,
+    width = _ref.width,
+    rest = _objectWithoutProperties(_ref, _excluded);
+  var _useField = useField(name),
+    _useField2 = _slicedToArray(_useField, 2),
+    field = _useField2[0],
+    meta = _useField2[1];
+  var hasError = Boolean(meta.touched && meta.error);
+  return /*#__PURE__*/_jsx(Field, _objectSpread(_objectSpread(_objectSpread(_objectSpread({
+    label: label,
+    error: hasError ? meta.error : null,
+    hint: !hasError ? hint : undefined,
+    htmlFor: htmlFor || name
+  }, required !== undefined ? {
+    required: required
+  } : {}), disabled !== undefined ? {
+    disabled: disabled
+  } : {}), width !== undefined ? {
+    width: width
+  } : {}), {}, {
+    children: /*#__PURE__*/_jsx(Textarea, _objectSpread({
+      name: field.name,
+      value: (_field$value = field.value) !== null && _field$value !== void 0 ? _field$value : "",
+      onChange: field.onChange,
+      onBlur: field.onBlur,
+      rows: rows
+    }, rest))
+  }));
+};
+export default FormikTextarea;
+//# sourceMappingURL=FormikTextarea.js.map

package/dist/esm/v2/patterns/FormikTextarea.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormikTextarea.js","names":["React","useField","Field","Textarea","jsx","_jsx","FormikTextarea","_ref","_field$value","name","label","required","_ref$rows","rows","htmlFor","hint","disabled","width","rest","_objectWithoutProperties","_excluded","_useField","_useField2","_slicedToArray","field","meta","hasError","Boolean","touched","error","_objectSpread","undefined","children","value","onChange","onBlur"],"sources":["../../../../src/lib/v2/patterns/FormikTextarea.tsx"],"sourcesContent":["/**\r\n * FormikTextarea — bridge between Formik state and v2.Field + v2.Textarea.\r\n *\r\n * Default rows = 4 (matches the legacy Pui multiline default\r\n * across ms-ti-fe / addpe-fe usage).\r\n *\r\n * Usage:\r\n *\r\n *   import { FormikTextarea } from \"@portnet/ui/lib/v2\";\r\n *\r\n *   <FormikTextarea\r\n *     name=\"observation\"\r\n *     label=\"Observations\"\r\n *     rows={4}\r\n *   />\r\n *\r\n * Charter §03 / R-I.1 → R-I.6. Peer dependency: `formik` >= 2.x.\r\n */\r\n\r\nimport * as React from \"react\";\r\nimport { useField } from \"formik\";\r\nimport Field from \"../components/Field\";\r\nimport Textarea from \"../components/Textarea\";\r\nimport type { FieldWidth } from \"../components/Field\";\r\nimport type { TextareaProps } from \"../components/Textarea\";\r\n\r\nexport interface FormikTextareaProps\r\n  extends Omit<\r\n    TextareaProps,\r\n    \"name\" | \"value\" | \"onChange\" | \"onBlur\" | \"label\" | \"required\" | \"disabled\" | \"error\"\r\n  > {\r\n  name: string;\r\n  label?: React.ReactNode | undefined;\r\n  required?: boolean | undefined;\r\n  disabled?: boolean | undefined;\r\n  htmlFor?: string | undefined;\r\n  hint?: React.ReactNode | undefined;\r\n  /**\r\n   * Gabarit de largeur semantique (G-H). Sur une zone de texte, le standard\r\n   * range les descriptions et les editeurs en `xl` (pleine largeur du bloc) :\r\n   * c'est donc rarement autre chose, mais la prop existe pour les cas ou la\r\n   * zone est courte et bornee.\r\n   */\r\n  width?: FieldWidth | undefined;\r\n}\r\n\r\nconst FormikTextarea = ({\r\n  name,\r\n  label,\r\n  required,\r\n  rows = 4,\r\n  htmlFor,\r\n  hint,\r\n  disabled,\r\n  width,\r\n  ...rest\r\n}: FormikTextareaProps) => {\r\n  const [field, meta] = useField<string>(name);\r\n  const hasError = Boolean(meta.touched && meta.error);\r\n\r\n  return (\r\n    <Field\r\n      label={label}\r\n      error={hasError ? meta.error : null}\r\n      hint={!hasError ? hint : undefined}\r\n      htmlFor={htmlFor || name}\r\n      {...(required !== undefined ? { required } : {})}\r\n      {...(disabled !== undefined ? { disabled } : {})}\r\n      {...(width !== undefined ? { width } : {})}\r\n    >\r\n      <Textarea\r\n        name={field.name}\r\n        value={field.value ?? \"\"}\r\n        onChange={field.onChange}\r\n        onBlur={field.onBlur}\r\n        rows={rows}\r\n        {...rest}\r\n      />\r\n    </Field>\r\n  );\r\n};\r\n\r\nexport default FormikTextarea;\r\n"],"mappings":";;;;;;;;;;;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAO,KAAKA,KAAK,MAAM,OAAO;AAC9B,SAASC,QAAQ,QAAQ,QAAQ;AACjC,OAAOC,KAAK,MAAM,qBAAqB;AACvC,OAAOC,QAAQ,MAAM,wBAAwB;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAwB9C,IAAMC,cAAc,GAAG,SAAjBA,cAAcA,CAAAC,IAAA,EAUO;EAAA,IAAAC,YAAA;EAAA,IATzBC,IAAI,GAAAF,IAAA,CAAJE,IAAI;IACJC,KAAK,GAAAH,IAAA,CAALG,KAAK;IACLC,QAAQ,GAAAJ,IAAA,CAARI,QAAQ;IAAAC,SAAA,GAAAL,IAAA,CACRM,IAAI;IAAJA,IAAI,GAAAD,SAAA,cAAG,CAAC,GAAAA,SAAA;IACRE,OAAO,GAAAP,IAAA,CAAPO,OAAO;IACPC,IAAI,GAAAR,IAAA,CAAJQ,IAAI;IACJC,QAAQ,GAAAT,IAAA,CAARS,QAAQ;IACRC,KAAK,GAAAV,IAAA,CAALU,KAAK;IACFC,IAAI,GAAAC,wBAAA,CAAAZ,IAAA,EAAAa,SAAA;EAEP,IAAAC,SAAA,GAAsBpB,QAAQ,CAASQ,IAAI,CAAC;IAAAa,UAAA,GAAAC,cAAA,CAAAF,SAAA;IAArCG,KAAK,GAAAF,UAAA;IAAEG,IAAI,GAAAH,UAAA;EAClB,IAAMI,QAAQ,GAAGC,OAAO,CAACF,IAAI,CAACG,OAAO,IAAIH,IAAI,CAACI,KAAK,CAAC;EAEpD,oBACExB,IAAA,CAACH,KAAK,EAAA4B,aAAA,CAAAA,aAAA,CAAAA,aAAA,CAAAA,aAAA;IACJpB,KAAK,EAAEA,KAAM;IACbmB,KAAK,EAAEH,QAAQ,GAAGD,IAAI,CAACI,KAAK,GAAG,IAAK;IACpCd,IAAI,EAAE,CAACW,QAAQ,GAAGX,IAAI,GAAGgB,SAAU;IACnCjB,OAAO,EAAEA,OAAO,IAAIL;EAAK,GACpBE,QAAQ,KAAKoB,SAAS,GAAG;IAAEpB,QAAQ,EAARA;EAAS,CAAC,GAAG,CAAC,CAAC,GAC1CK,QAAQ,KAAKe,SAAS,GAAG;IAAEf,QAAQ,EAARA;EAAS,CAAC,GAAG,CAAC,CAAC,GAC1CC,KAAK,KAAKc,SAAS,GAAG;IAAEd,KAAK,EAALA;EAAM,CAAC,GAAG,CAAC,CAAC;IAAAe,QAAA,eAEzC3B,IAAA,CAACF,QAAQ,EAAA2B,aAAA;MACPrB,IAAI,EAAEe,KAAK,CAACf,IAAK;MACjBwB,KAAK,GAAAzB,YAAA,GAAEgB,KAAK,CAACS,KAAK,cAAAzB,YAAA,cAAAA,YAAA,GAAI,EAAG;MACzB0B,QAAQ,EAAEV,KAAK,CAACU,QAAS;MACzBC,MAAM,EAAEX,KAAK,CAACW,MAAO;MACrBtB,IAAI,EAAEA;IAAK,GACPK,IAAI,CACT;EAAC,EACG,CAAC;AAEZ,CAAC;AAED,eAAeZ,cAAc","ignoreList":[]}

package/dist/esm/v2/patterns/KeyboardShortcutsHelp.js

@@ -0,0 +1,212 @@
+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; }
+import * as React from "react";
+import Modal from "../components/Modal";
+import { mergeLabels } from "../utils/mergeLabels";
+
+/* ── Body-only focus guard ────────────────────────────────────────
+ * The "?" key is a printable character. If a user types "?" inside an
+ * Input / Textarea / contentEditable element we must NOT hijack the
+ * keypress to open the help — they're trying to type a question mark.
+ *
+ * BUTTON / A focus is NOT blocking by design: when the user has tabbed
+ * onto an interactive non-text element, hitting "?" makes sense as a
+ * help affordance (navigation mode, not text-entry mode).
+ */
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+function isFocusOnTextEntry() {
+  var el = typeof document !== "undefined" ? document.activeElement : null;
+  if (!el) return false;
+  var tag = el.tagName;
+  if (tag === "INPUT" || tag === "TEXTAREA" || tag === "SELECT") return true;
+  if (el instanceof HTMLElement && el.isContentEditable) return true;
+  return false;
+}
+function ShortcutKey(_ref) {
+  var children = _ref.children;
+  return /*#__PURE__*/_jsx("kbd", {
+    style: {
+      display: "inline-block",
+      minWidth: "1.75em",
+      padding: "0.15em 0.5em",
+      background: "var(--bg-subtle)",
+      border: "1px solid var(--border)",
+      borderBottomColor: "var(--border-strong, var(--border))",
+      borderRadius: "var(--r-sm)",
+      boxShadow: "inset 0 -1px 0 var(--border)",
+      fontFamily: "var(--font-mono, monospace)",
+      fontSize: "var(--text-sm)",
+      textAlign: "center",
+      lineHeight: 1.4,
+      color: "var(--fg)"
+    },
+    children: children
+  });
+}
+var SHORTCUT_ROW_SX = {
+  display: "grid",
+  gridTemplateColumns: "auto 1fr",
+  gap: "var(--s-4)",
+  alignItems: "center",
+  padding: "var(--s-2) 0",
+  borderBottom: "1px solid var(--border-subtle, var(--border))"
+};
+var SHORTCUT_KEYS_SX = {
+  display: "flex",
+  gap: "var(--s-1)",
+  alignItems: "center",
+  flexWrap: "wrap"
+};
+var HELP_FOOTNOTE_SX = {
+  marginTop: "var(--s-4)",
+  paddingTop: "var(--s-3)",
+  borderTop: "1px solid var(--border)",
+  fontSize: "var(--text-xs)",
+  color: "var(--fg-subtle)",
+  lineHeight: 1.5
+};
+var DEFAULT_LABELS = Object.freeze({
+  /* Footnote rendered below the shortcut list. Split into two parts so the
+   * keycap can be embedded in the middle without forcing the i18n string to
+   * carry HTML tags. */
+  footnoteIntro: "Astuce : appuyez sur",
+  footnoteOutro: "à tout moment pour ouvrir ou fermer cette aide. Les raccourcis s'activent uniquement quand votre curseur n'est pas dans un champ de saisie.",
+  /* aria-label on the <dl> listing every shortcut. */
+  listAriaLabel: "Liste des raccourcis clavier disponibles sur cette page",
+  /* Joiner rendered between alternative keys for the same shortcut. */
+  keyJoiner: "ou"
+});
+
+/**
+ * KeyboardShortcutsHelp — Portnet UI v2
+ *
+ * Charter §5.2 SHOULD — discoverable help overlay for page-level keyboard
+ * shortcuts. Listens globally for "?" and opens a v2.Modal listing every
+ * shortcut as <kbd> elements (WCAG 1.3.1 semantic).
+ *
+ * Self-contained: the host page only declares the shortcuts array and renders
+ * <KeyboardShortcutsHelp shortcuts={…} /> once.
+ *
+ * Localisation (FR / EN / AR):
+ *   <KeyboardShortcutsHelp
+ *     title="Keyboard shortcuts"
+ *     labels={{
+ *       footnoteIntro: "Tip: press",
+ *       footnoteOutro: "anytime to toggle this help…",
+ *       listAriaLabel: "List of keyboard shortcuts available on this page",
+ *       keyJoiner:     "or",
+ *     }}
+ *     shortcuts={…}
+ *   />
+ *
+ * Charter §5.2 SHOULD + WCAG 1.3.1 (semantic <kbd>) + 2.1.1 (keyboard
+ * reachable) + R-M.* (modal focus trap inherited from v2.Modal).
+ */
+
+function KeyboardShortcutsHelp(_ref2) {
+  var _ref2$shortcuts = _ref2.shortcuts,
+    shortcuts = _ref2$shortcuts === void 0 ? [] : _ref2$shortcuts,
+    _ref2$title = _ref2.title,
+    title = _ref2$title === void 0 ? "Raccourcis clavier" : _ref2$title,
+    labels = _ref2.labels,
+    open = _ref2.open,
+    onOpenChange = _ref2.onOpenChange;
+  var _React$useState = React.useState(false),
+    _React$useState2 = _slicedToArray(_React$useState, 2),
+    uncontrolledOpen = _React$useState2[0],
+    setUncontrolledOpen = _React$useState2[1];
+  var isControlled = open !== undefined;
+  var isOpen = isControlled ? open : uncontrolledOpen;
+  var L = mergeLabels(DEFAULT_LABELS, labels);
+
+  /* Refs so the "?" listener can stay on a `[]` dependency list — it must not
+   * be torn down and re-added on every open/close, and in controlled mode there
+   * is no functional-update form to fall back on. */
+  var isOpenRef = React.useRef(isOpen);
+  isOpenRef.current = isOpen;
+  var onOpenChangeRef = React.useRef(onOpenChange);
+  onOpenChangeRef.current = onOpenChange;
+  var isControlledRef = React.useRef(isControlled);
+  isControlledRef.current = isControlled;
+  var requestOpen = React.useCallback(function (next) {
+    var _onOpenChangeRef$curr;
+    if (!isControlledRef.current) setUncontrolledOpen(next);
+    (_onOpenChangeRef$curr = onOpenChangeRef.current) === null || _onOpenChangeRef$curr === void 0 ? void 0 : _onOpenChangeRef$curr.call(onOpenChangeRef, next);
+  }, []);
+  React.useEffect(function () {
+    var handler = function handler(event) {
+      // Only react to "?" (Shift+/ on US, AltGr+, on many AZERTY layouts).
+      // event.key gives us the resolved character regardless of physical key.
+      if (event.key !== "?") return;
+
+      // Modifier keys (Ctrl, Meta, Alt) reserved for browser / OS shortcuts.
+      if (event.ctrlKey || event.metaKey || event.altKey) return;
+
+      // User is typing in a text field — let "?" through.
+      if (isFocusOnTextEntry()) return;
+      event.preventDefault();
+      requestOpen(!isOpenRef.current);
+    };
+    window.addEventListener("keydown", handler);
+    return function () {
+      return window.removeEventListener("keydown", handler);
+    };
+  }, [requestOpen]);
+  if (!Array.isArray(shortcuts) || shortcuts.length === 0) {
+    return null;
+  }
+  return /*#__PURE__*/_jsxs(Modal, {
+    open: isOpen,
+    title: title,
+    onClose: function onClose() {
+      return requestOpen(false);
+    },
+    size: "md",
+    children: [/*#__PURE__*/_jsx("dl", {
+      style: {
+        margin: 0,
+        padding: 0
+      },
+      "aria-label": L.listAriaLabel,
+      children: shortcuts.map(function (sc, i) {
+        return /*#__PURE__*/_jsxs("div", {
+          style: SHORTCUT_ROW_SX,
+          children: [/*#__PURE__*/_jsx("dt", {
+            style: SHORTCUT_KEYS_SX,
+            children: sc.keys.map(function (k, j) {
+              return /*#__PURE__*/_jsxs(React.Fragment, {
+                children: [/*#__PURE__*/_jsx(ShortcutKey, {
+                  children: k
+                }), j < sc.keys.length - 1 && /*#__PURE__*/_jsx("span", {
+                  "aria-hidden": "true",
+                  style: {
+                    color: "var(--fg-subtle)",
+                    fontSize: "var(--text-xs)"
+                  },
+                  children: L.keyJoiner
+                })]
+              }, j);
+            })
+          }), /*#__PURE__*/_jsx("dd", {
+            style: {
+              margin: 0,
+              fontSize: "var(--text-body)"
+            },
+            children: sc.description
+          })]
+        }, i);
+      })
+    }), /*#__PURE__*/_jsxs("div", {
+      style: HELP_FOOTNOTE_SX,
+      children: [L.footnoteIntro, " ", /*#__PURE__*/_jsx(ShortcutKey, {
+        children: "?"
+      }), " ", L.footnoteOutro]
+    })]
+  });
+}
+export default KeyboardShortcutsHelp;
+//# sourceMappingURL=KeyboardShortcutsHelp.js.map

package/dist/esm/v2/patterns/KeyboardShortcutsHelp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeyboardShortcutsHelp.js","names":["React","Modal","mergeLabels","jsx","_jsx","jsxs","_jsxs","isFocusOnTextEntry","el","document","activeElement","tag","tagName","HTMLElement","isContentEditable","ShortcutKey","_ref","children","style","display","minWidth","padding","background","border","borderBottomColor","borderRadius","boxShadow","fontFamily","fontSize","textAlign","lineHeight","color","SHORTCUT_ROW_SX","gridTemplateColumns","gap","alignItems","borderBottom","SHORTCUT_KEYS_SX","flexWrap","HELP_FOOTNOTE_SX","marginTop","paddingTop","borderTop","DEFAULT_LABELS","Object","freeze","footnoteIntro","footnoteOutro","listAriaLabel","keyJoiner","KeyboardShortcutsHelp","_ref2","_ref2$shortcuts","shortcuts","_ref2$title","title","labels","open","onOpenChange","_React$useState","useState","_React$useState2","_slicedToArray","uncontrolledOpen","setUncontrolledOpen","isControlled","undefined","isOpen","L","isOpenRef","useRef","current","onOpenChangeRef","isControlledRef","requestOpen","useCallback","next","_onOpenChangeRef$curr","call","useEffect","handler","event","key","ctrlKey","metaKey","altKey","preventDefault","window","addEventListener","removeEventListener","Array","isArray","length","onClose","size","margin","map","sc","i","keys","k","j","Fragment","description"],"sources":["../../../../src/lib/v2/patterns/KeyboardShortcutsHelp.tsx"],"sourcesContent":["import * as React from \"react\";\r\nimport Modal from \"../components/Modal\";\r\nimport { mergeLabels } from \"../utils/mergeLabels\";\r\n\r\n/* ── Body-only focus guard ────────────────────────────────────────\r\n * The \"?\" key is a printable character. If a user types \"?\" inside an\r\n * Input / Textarea / contentEditable element we must NOT hijack the\r\n * keypress to open the help — they're trying to type a question mark.\r\n *\r\n * BUTTON / A focus is NOT blocking by design: when the user has tabbed\r\n * onto an interactive non-text element, hitting \"?\" makes sense as a\r\n * help affordance (navigation mode, not text-entry mode).\r\n */\r\nfunction isFocusOnTextEntry(): boolean {\r\n  const el = typeof document !== \"undefined\" ? document.activeElement : null;\r\n  if (!el) return false;\r\n  const tag = el.tagName;\r\n  if (tag === \"INPUT\" || tag === \"TEXTAREA\" || tag === \"SELECT\") return true;\r\n  if (el instanceof HTMLElement && el.isContentEditable) return true;\r\n  return false;\r\n}\r\n\r\nfunction ShortcutKey({ children }: { children?: React.ReactNode }) {\r\n  return (\r\n    <kbd\r\n      style={{\r\n        display: \"inline-block\",\r\n        minWidth: \"1.75em\",\r\n        padding: \"0.15em 0.5em\",\r\n        background: \"var(--bg-subtle)\",\r\n        border: \"1px solid var(--border)\",\r\n        borderBottomColor: \"var(--border-strong, var(--border))\",\r\n        borderRadius: \"var(--r-sm)\",\r\n        boxShadow: \"inset 0 -1px 0 var(--border)\",\r\n        fontFamily: \"var(--font-mono, monospace)\",\r\n        fontSize: \"var(--text-sm)\",\r\n        textAlign: \"center\",\r\n        lineHeight: 1.4,\r\n        color: \"var(--fg)\",\r\n      }}\r\n    >\r\n      {children}\r\n    </kbd>\r\n  );\r\n}\r\n\r\nconst SHORTCUT_ROW_SX: React.CSSProperties = {\r\n  display: \"grid\",\r\n  gridTemplateColumns: \"auto 1fr\",\r\n  gap: \"var(--s-4)\",\r\n  alignItems: \"center\",\r\n  padding: \"var(--s-2) 0\",\r\n  borderBottom: \"1px solid var(--border-subtle, var(--border))\",\r\n};\r\n\r\nconst SHORTCUT_KEYS_SX: React.CSSProperties = {\r\n  display: \"flex\",\r\n  gap: \"var(--s-1)\",\r\n  alignItems: \"center\",\r\n  flexWrap: \"wrap\",\r\n};\r\n\r\nconst HELP_FOOTNOTE_SX: React.CSSProperties = {\r\n  marginTop: \"var(--s-4)\",\r\n  paddingTop: \"var(--s-3)\",\r\n  borderTop: \"1px solid var(--border)\",\r\n  fontSize: \"var(--text-xs)\",\r\n  color: \"var(--fg-subtle)\",\r\n  lineHeight: 1.5,\r\n};\r\n\r\nconst DEFAULT_LABELS = Object.freeze({\r\n  /* Footnote rendered below the shortcut list. Split into two parts so the\r\n   * keycap can be embedded in the middle without forcing the i18n string to\r\n   * carry HTML tags. */\r\n  footnoteIntro: \"Astuce : appuyez sur\",\r\n  footnoteOutro:\r\n    \"à tout moment pour ouvrir ou fermer cette aide. Les raccourcis s'activent uniquement quand votre curseur n'est pas dans un champ de saisie.\",\r\n  /* aria-label on the <dl> listing every shortcut. */\r\n  listAriaLabel: \"Liste des raccourcis clavier disponibles sur cette page\",\r\n  /* Joiner rendered between alternative keys for the same shortcut. */\r\n  keyJoiner: \"ou\",\r\n});\r\n\r\n/**\r\n * KeyboardShortcutsHelp — Portnet UI v2\r\n *\r\n * Charter §5.2 SHOULD — discoverable help overlay for page-level keyboard\r\n * shortcuts. Listens globally for \"?\" and opens a v2.Modal listing every\r\n * shortcut as <kbd> elements (WCAG 1.3.1 semantic).\r\n *\r\n * Self-contained: the host page only declares the shortcuts array and renders\r\n * <KeyboardShortcutsHelp shortcuts={…} /> once.\r\n *\r\n * Localisation (FR / EN / AR):\r\n *   <KeyboardShortcutsHelp\r\n *     title=\"Keyboard shortcuts\"\r\n *     labels={{\r\n *       footnoteIntro: \"Tip: press\",\r\n *       footnoteOutro: \"anytime to toggle this help…\",\r\n *       listAriaLabel: \"List of keyboard shortcuts available on this page\",\r\n *       keyJoiner:     \"or\",\r\n *     }}\r\n *     shortcuts={…}\r\n *   />\r\n *\r\n * Charter §5.2 SHOULD + WCAG 1.3.1 (semantic <kbd>) + 2.1.1 (keyboard\r\n * reachable) + R-M.* (modal focus trap inherited from v2.Modal).\r\n */\r\n\r\nexport interface KeyboardShortcut {\r\n  keys: string[];\r\n  description: React.ReactNode;\r\n}\r\n\r\nexport interface KeyboardShortcutsHelpLabels {\r\n  footnoteIntro?: string | undefined;\r\n  footnoteOutro?: string | undefined;\r\n  listAriaLabel?: string | undefined;\r\n  keyJoiner?: string | undefined;\r\n}\r\n\r\nexport interface KeyboardShortcutsHelpProps {\r\n  shortcuts?: KeyboardShortcut[] | undefined;\r\n  title?: React.ReactNode | undefined;\r\n  labels?: KeyboardShortcutsHelpLabels | undefined;\r\n  /**\r\n   * Optional CONTROLLED open state. Omit for the original self-contained\r\n   * behaviour (the \"?\" listener owns the state).\r\n   *\r\n   * Added because the panel had no trigger but the keystroke. Hosts wired it\r\n   * correctly and users still reported the shortcuts \"missing\" — they are, in\r\n   * every practical sense, if the only affordance is a key you have to already\r\n   * know about. Charter §05.2 asks for DISCOVERABLE help, and a host cannot add\r\n   * a menu item or button without being able to open this.\r\n   */\r\n  open?: boolean | undefined;\r\n  /** Called with the requested next state, for both \"?\" and the close button. */\r\n  onOpenChange?: ((open: boolean) => void) | undefined;\r\n}\r\n\r\nfunction KeyboardShortcutsHelp({\r\n  shortcuts = [],\r\n  title = \"Raccourcis clavier\",\r\n  labels,\r\n  open,\r\n  onOpenChange,\r\n}: KeyboardShortcutsHelpProps) {\r\n  const [uncontrolledOpen, setUncontrolledOpen] = React.useState(false);\r\n  const isControlled = open !== undefined;\r\n  const isOpen = isControlled ? open : uncontrolledOpen;\r\n  const L = mergeLabels(DEFAULT_LABELS, labels);\r\n\r\n  /* Refs so the \"?\" listener can stay on a `[]` dependency list — it must not\r\n   * be torn down and re-added on every open/close, and in controlled mode there\r\n   * is no functional-update form to fall back on. */\r\n  const isOpenRef = React.useRef(isOpen);\r\n  isOpenRef.current = isOpen;\r\n  const onOpenChangeRef = React.useRef(onOpenChange);\r\n  onOpenChangeRef.current = onOpenChange;\r\n  const isControlledRef = React.useRef(isControlled);\r\n  isControlledRef.current = isControlled;\r\n\r\n  const requestOpen = React.useCallback((next: boolean) => {\r\n    if (!isControlledRef.current) setUncontrolledOpen(next);\r\n    onOpenChangeRef.current?.(next);\r\n  }, []);\r\n\r\n  React.useEffect(() => {\r\n    const handler = (event: KeyboardEvent) => {\r\n      // Only react to \"?\" (Shift+/ on US, AltGr+, on many AZERTY layouts).\r\n      // event.key gives us the resolved character regardless of physical key.\r\n      if (event.key !== \"?\") return;\r\n\r\n      // Modifier keys (Ctrl, Meta, Alt) reserved for browser / OS shortcuts.\r\n      if (event.ctrlKey || event.metaKey || event.altKey) return;\r\n\r\n      // User is typing in a text field — let \"?\" through.\r\n      if (isFocusOnTextEntry()) return;\r\n\r\n      event.preventDefault();\r\n      requestOpen(!isOpenRef.current);\r\n    };\r\n\r\n    window.addEventListener(\"keydown\", handler);\r\n    return () => window.removeEventListener(\"keydown\", handler);\r\n  }, [requestOpen]);\r\n\r\n  if (!Array.isArray(shortcuts) || shortcuts.length === 0) {\r\n    return null;\r\n  }\r\n\r\n  return (\r\n    <Modal\r\n      open={isOpen}\r\n      title={title}\r\n      onClose={() => requestOpen(false)}\r\n      size=\"md\"\r\n    >\r\n      <dl style={{ margin: 0, padding: 0 }} aria-label={L.listAriaLabel}>\r\n        {shortcuts.map((sc, i) => (\r\n          <div key={i} style={SHORTCUT_ROW_SX}>\r\n            <dt style={SHORTCUT_KEYS_SX}>\r\n              {sc.keys.map((k, j) => (\r\n                <React.Fragment key={j}>\r\n                  <ShortcutKey>{k}</ShortcutKey>\r\n                  {j < sc.keys.length - 1 && (\r\n                    <span\r\n                      aria-hidden=\"true\"\r\n                      style={{\r\n                        color: \"var(--fg-subtle)\",\r\n                        fontSize: \"var(--text-xs)\",\r\n                      }}\r\n                    >\r\n                      {L.keyJoiner}\r\n                    </span>\r\n                  )}\r\n                </React.Fragment>\r\n              ))}\r\n            </dt>\r\n            <dd style={{ margin: 0, fontSize: \"var(--text-body)\" }}>\r\n              {sc.description}\r\n            </dd>\r\n          </div>\r\n        ))}\r\n      </dl>\r\n      <div style={HELP_FOOTNOTE_SX}>\r\n        {L.footnoteIntro}{\" \"}\r\n        <ShortcutKey>?</ShortcutKey>{\" \"}\r\n        {L.footnoteOutro}\r\n      </div>\r\n    </Modal>\r\n  );\r\n}\r\n\r\nexport default KeyboardShortcutsHelp;\r\n"],"mappings":"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","ignoreList":[]}