@portnet/ui 6.0.2 → 6.0.3

package/dist/esm/v2/components/Status.js.map

@@ -1 +1 @@
-{"version":3,"file":"Status.js","names":["React","STATUS_KEYS","STATUS_LABELS_FR","jsx","_jsx","Status","_ref","_ref2","_ref$kind","kind","label","labels","_ref$className","className","rest","_objectWithoutProperties","_excluded","safe","includes","text","_objectSpread","concat","trim","children"],"sources":["../../../../src/lib/v2/components/Status.tsx"],"sourcesContent":["import * as React from \"react\";\r\nimport { STATUS_KEYS, STATUS_LABELS_FR } from \"../tokens/statusPalette\";\r\n\r\n/**\r\n * Status - Portnet UI v2\r\n *\r\n * Charter §02.1 — workflow status chip. Six and only six kinds.\r\n * Any other business status MUST map onto one of these.\r\n *\r\n *   <Status kind=\"approved\" />               // → \"Approuvé\"  (FR fallback)\r\n *   <Status kind=\"pending\" label=\"Custom\" /> // explicit override (single)\r\n *   <Status kind=\"approved\"\r\n *           labels={{ approved: t(\"status.approved\"),\r\n *                     rejected: t(\"status.rejected\"), ... }} />\r\n *\r\n * Label resolution (highest priority first)\r\n *   1. `label` prop — single explicit override.\r\n *   2. `labels[kind]` — i18n map provided by the host.\r\n *   3. STATUS_LABELS_FR[kind] — legacy FR fallback.\r\n *\r\n * A11y note (R-Ar.1, R-Ar.3):\r\n *   This component renders a plain inline <span>. It does NOT carry\r\n *   role=\"status\" / aria-live — those are reserved for status MESSAGES\r\n *   (toasts, banners). A status pill is a styled label; promoting it\r\n *   to a live region causes SRs to announce every chip on mount and on\r\n *   each re-render (e.g., on every DataGrid pagination tick).\r\n *\r\n *   When the chip's *value* changes (e.g., a workflow transition just\r\n *   succeeded), it is the host's responsibility to surface that change\r\n *   via the canonical feedback channel — toast (R-A.1) or row flash\r\n *   (.pui-row-updated) — NOT by mutating the chip alone.\r\n *\r\n * Forbidden: ad-hoc colours. Use Chip for filter pills, not Status.\r\n */\r\n\r\nexport type StatusKind = keyof typeof STATUS_LABELS_FR;\r\n\r\nexport interface StatusProps extends React.HTMLAttributes<HTMLSpanElement> {\r\n  kind?: StatusKind | undefined;\r\n  label?: React.ReactNode | undefined;\r\n  labels?: Partial<Record<StatusKind, React.ReactNode>> | undefined;\r\n}\r\n\r\nfunction Status({ kind = \"neutral\", label, labels, className = \"\", ...rest }: StatusProps) {\r\n  const safe = STATUS_KEYS.includes(kind) ? kind : \"neutral\";\r\n  const text =\r\n    label\r\n      ?? (labels && labels[safe])\r\n      ?? STATUS_LABELS_FR[safe];\r\n  return (\r\n    <span\r\n      className={`pui-status ${className}`.trim()}\r\n      data-kind={safe}\r\n      {...rest}\r\n    >\r\n      {text}\r\n    </span>\r\n  );\r\n}\r\n\r\nexport default Status;\r\n"],"mappings":";;;;;;;;;AAAA,OAAO,KAAKA,KAAK,MAAM,OAAO;AAC9B,SAASC,WAAW,EAAEC,gBAAgB,QAAQ,yBAAyB;;AAEvE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AA9BA,SAAAC,GAAA,IAAAC,IAAA;AAwCA,SAASC,MAAMA,CAAAC,IAAA,EAA4E;EAAA,IAAAC,KAAA;EAAA,IAAAC,SAAA,GAAAF,IAAA,CAAzEG,IAAI;IAAJA,IAAI,GAAAD,SAAA,cAAG,SAAS,GAAAA,SAAA;IAAEE,KAAK,GAAAJ,IAAA,CAALI,KAAK;IAAEC,MAAM,GAAAL,IAAA,CAANK,MAAM;IAAAC,cAAA,GAAAN,IAAA,CAAEO,SAAS;IAATA,SAAS,GAAAD,cAAA,cAAG,EAAE,GAAAA,cAAA;IAAKE,IAAI,GAAAC,wBAAA,CAAAT,IAAA,EAAAU,SAAA;EACxE,IAAMC,IAAI,GAAGhB,WAAW,CAACiB,QAAQ,CAACT,IAAI,CAAC,GAAGA,IAAI,GAAG,SAAS;EAC1D,IAAMU,IAAI,IAAAZ,KAAA,GACRG,KAAK,aAALA,KAAK,cAALA,KAAK,GACCC,MAAM,IAAIA,MAAM,CAACM,IAAI,CAAC,cAAAV,KAAA,cAAAA,KAAA,GACvBL,gBAAgB,CAACe,IAAI,CAAC;EAC7B,oBACEb,IAAA,SAAAgB,aAAA,CAAAA,aAAA;IACEP,SAAS,EAAE,cAAAQ,MAAA,CAAcR,SAAS,EAAGS,IAAI,CAAC,CAAE;IAC5C,aAAWL;EAAK,GACZH,IAAI;IAAAS,QAAA,EAEPJ;EAAI,EACD,CAAC;AAEX;AAEA,eAAed,MAAM","ignoreList":[]}
+{"version":3,"file":"Status.js","names":["React","STATUS_KEYS","STATUS_LABELS_FR","jsx","_jsx","Status","kind","label","labels","className","rest","safe","includes","text","trim","children"],"sources":["../../../../src/lib/v2/components/Status.tsx"],"sourcesContent":["import * as React from \"react\";\r\nimport { STATUS_KEYS, STATUS_LABELS_FR } from \"../tokens/statusPalette\";\r\n\r\n/**\r\n * Status - Portnet UI v2\r\n *\r\n * Charter §02.1 — workflow status chip. Six and only six kinds.\r\n * Any other business status MUST map onto one of these.\r\n *\r\n *   <Status kind=\"approved\" />               // → \"Approuvé\"  (FR fallback)\r\n *   <Status kind=\"pending\" label=\"Custom\" /> // explicit override (single)\r\n *   <Status kind=\"approved\"\r\n *           labels={{ approved: t(\"status.approved\"),\r\n *                     rejected: t(\"status.rejected\"), ... }} />\r\n *\r\n * Label resolution (highest priority first)\r\n *   1. `label` prop — single explicit override.\r\n *   2. `labels[kind]` — i18n map provided by the host.\r\n *   3. STATUS_LABELS_FR[kind] — legacy FR fallback.\r\n *\r\n * A11y note (R-Ar.1, R-Ar.3):\r\n *   This component renders a plain inline <span>. It does NOT carry\r\n *   role=\"status\" / aria-live — those are reserved for status MESSAGES\r\n *   (toasts, banners). A status pill is a styled label; promoting it\r\n *   to a live region causes SRs to announce every chip on mount and on\r\n *   each re-render (e.g., on every DataGrid pagination tick).\r\n *\r\n *   When the chip's *value* changes (e.g., a workflow transition just\r\n *   succeeded), it is the host's responsibility to surface that change\r\n *   via the canonical feedback channel — toast (R-A.1) or row flash\r\n *   (.pui-row-updated) — NOT by mutating the chip alone.\r\n *\r\n * Forbidden: ad-hoc colours. Use Chip for filter pills, not Status.\r\n */\r\n\r\nexport type StatusKind = keyof typeof STATUS_LABELS_FR;\r\n\r\nexport interface StatusProps extends React.HTMLAttributes<HTMLSpanElement> {\r\n  kind?: StatusKind | undefined;\r\n  label?: React.ReactNode | undefined;\r\n  labels?: Partial<Record<StatusKind, React.ReactNode>> | undefined;\r\n}\r\n\r\nfunction Status({ kind = \"neutral\", label, labels, className = \"\", ...rest }: StatusProps) {\r\n  const safe = STATUS_KEYS.includes(kind) ? kind : \"neutral\";\r\n  const text =\r\n    label\r\n      ?? (labels && labels[safe])\r\n      ?? STATUS_LABELS_FR[safe];\r\n  return (\r\n    <span\r\n      className={`pui-status ${className}`.trim()}\r\n      data-kind={safe}\r\n      {...rest}\r\n    >\r\n      {text}\r\n    </span>\r\n  );\r\n}\r\n\r\nexport default Status;\r\n"],"mappings":"AAAA,OAAO,KAAKA,KAAK,MAAM,OAAO;AAC9B,SAASC,WAAW,EAAEC,gBAAgB,QAAQ,yBAAyB;;AAEvE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AA9BA,SAAAC,GAAA,IAAAC,IAAA;AAwCA,SAASC,MAAMA,CAAC;EAAEC,IAAI,GAAG,SAAS;EAAEC,KAAK;EAAEC,MAAM;EAAEC,SAAS,GAAG,EAAE;EAAE,GAAGC;AAAkB,CAAC,EAAE;EACzF,MAAMC,IAAI,GAAGV,WAAW,CAACW,QAAQ,CAACN,IAAI,CAAC,GAAGA,IAAI,GAAG,SAAS;EAC1D,MAAMO,IAAI,GACRN,KAAK,KACCC,MAAM,IAAIA,MAAM,CAACG,IAAI,CAAC,CAAC,IACxBT,gBAAgB,CAACS,IAAI,CAAC;EAC7B,oBACEP,IAAA;IACEK,SAAS,EAAE,cAAcA,SAAS,EAAE,CAACK,IAAI,CAAC,CAAE;IAC5C,aAAWH,IAAK;IAAA,GACZD,IAAI;IAAAK,QAAA,EAEPF;EAAI,CACD,CAAC;AAEX;AAEA,eAAeR,MAAM","ignoreList":[]}

package/dist/esm/v2/components/Stepper.js

@@ -1,9 +1,3 @@
-function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
-function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
-function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
-function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
-function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return _typeof(key) === "symbol" ? key : String(key); }
-function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (_typeof(res) !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
 import * as React from "react";
 import CheckIcon from "@mui/icons-material/Check";
 import Box from "@mui/material/Box";
@@ -78,14 +72,14 @@ import { mergeLabels } from "../utils/mergeLabels";
  *   `titleAs` so the page heading hierarchy stays consistent.
  */
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
-var DEFAULT_H_LABELS = Object.freeze({
+const DEFAULT_H_LABELS = Object.freeze({
   nav: "Étapes du formulaire",
-  item: function item(n, label, state) {
-    var suffix = state === "complete" ? " (complétée)" : state === "active" ? " (en cours)" : state === "disabled" ? " (verrouillée)" : " (à venir)";
-    return "\xC9tape ".concat(n, " : ").concat(label).concat(suffix);
+  item: (n, label, state) => {
+    const suffix = state === "complete" ? " (complétée)" : state === "active" ? " (en cours)" : state === "disabled" ? " (verrouillée)" : " (à venir)";
+    return `Étape ${n} : ${label}${suffix}`;
   }
 });
-var DEFAULT_V_LABELS = Object.freeze({
+const DEFAULT_V_LABELS = Object.freeze({
   nav: "Historique des étapes",
   state: Object.freeze({
     complete: "Étape complétée. ",
@@ -101,7 +95,7 @@ var DEFAULT_V_LABELS = Object.freeze({
     disabled: "Étape verrouillée. "
   })
 });
-var dotBaseStyle = {
+const dotBaseStyle = {
   width: 24,
   height: 24,
   borderRadius: "50%",
@@ -113,7 +107,7 @@ var dotBaseStyle = {
   border: "2px solid",
   transition: "background var(--duration-base, 180ms), color var(--duration-base, 180ms), border-color var(--duration-base, 180ms)"
 };
-var stateStyle = function stateStyle(state) {
+const stateStyle = state => {
   if (state === "complete") {
     return {
       background: "var(--accent)",
@@ -143,13 +137,17 @@ var stateStyle = function stateStyle(state) {
 };
 // Inner content shared between the clickable <button> and the
 // non-interactive <span> renderings of an HStepper step.
-function StepInner(_ref) {
-  var index = _ref.index,
-    label = _ref.label,
-    state = _ref.state;
+function StepInner({
+  index,
+  label,
+  state
+}) {
   return /*#__PURE__*/_jsxs(_Fragment, {
     children: [/*#__PURE__*/_jsx("span", {
-      style: _objectSpread(_objectSpread({}, dotBaseStyle), stateStyle(state)),
+      style: {
+        ...dotBaseStyle,
+        ...stateStyle(state)
+      },
       children: state === "complete" ? /*#__PURE__*/_jsx(CheckIcon, {
         fontSize: "inherit"
       }) : index + 1
@@ -166,7 +164,7 @@ function StepInner(_ref) {
     })]
   });
 }
-var stepBoxSx = {
+const stepBoxSx = {
   display: "flex",
   alignItems: "center",
   gap: 1,
@@ -190,7 +188,7 @@ var stepBoxSx = {
  * for VStepper also carries title/meta/etc., so narrowing to
  * HStepperRichStep here would hide those fields. */
 function isRichStep(s) {
-  return s != null && _typeof(s) === "object" && !Array.isArray(s) && ! /*#__PURE__*/React.isValidElement(s) && ("label" in s || "status" in s);
+  return s != null && typeof s === "object" && !Array.isArray(s) && ! /*#__PURE__*/React.isValidElement(s) && ("label" in s || "status" in s);
 }
 function normaliseStatusToState(status) {
   if (status === "current" || status === "active") return "active";
@@ -204,14 +202,13 @@ function normaliseStatusToState(status) {
 function normaliseSteps(steps, current) {
   if (steps.length === 0) return [];
   if (isRichStep(steps[0])) {
-    return steps.map(function (s, i) {
-      var _rich$id;
-      var rich = s;
-      var state = normaliseStatusToState(rich.status);
+    return steps.map((s, i) => {
+      const rich = s;
+      const state = normaliseStatusToState(rich.status);
       return {
-        key: (_rich$id = rich.id) !== null && _rich$id !== void 0 ? _rich$id : i,
+        key: rich.id ?? i,
         label: rich.label,
-        state: state,
+        state,
         // Disabled steps are never clickable. Other rich states
         // remain clickable so the host can offer free navigation.
         clickable: state !== "disabled"
@@ -219,27 +216,25 @@ function normaliseSteps(steps, current) {
     });
   }
   // Legacy: plain labels driven by `current`.
-  return steps.map(function (label, i) {
-    return {
-      key: i,
-      label: label,
-      state: i < current ? "complete" : i === current ? "active" : "pending",
-      clickable: i <= current
-    };
-  });
+  return steps.map((label, i) => ({
+    key: i,
+    label: label,
+    state: i < current ? "complete" : i === current ? "active" : "pending",
+    clickable: i <= current
+  }));
 }
-export function HStepper(_ref2) {
-  var steps = _ref2.steps,
-    _ref2$current = _ref2.current,
-    current = _ref2$current === void 0 ? 0 : _ref2$current,
-    onJump = _ref2.onJump,
-    onStepClick = _ref2.onStepClick,
-    ariaLabel = _ref2.ariaLabel,
-    labels = _ref2.labels;
-  var L = mergeLabels(DEFAULT_H_LABELS, labels);
-  var navLabel = ariaLabel || L.nav;
-  var jumpHandler = onJump || onStepClick;
-  var normalised = normaliseSteps(steps, current);
+export function HStepper({
+  steps,
+  current = 0,
+  onJump,
+  onStepClick,
+  ariaLabel,
+  labels
+}) {
+  const L = mergeLabels(DEFAULT_H_LABELS, labels);
+  const navLabel = ariaLabel || L.nav;
+  const jumpHandler = onJump || onStepClick;
+  const normalised = normaliseSteps(steps, current);
   return /*#__PURE__*/_jsx("nav", {
     "aria-label": navLabel,
     style: {
@@ -249,20 +244,19 @@ export function HStepper(_ref2) {
       padding: "12px 0",
       overflowX: "auto"
     },
-    children: normalised.map(function (step, i) {
-      var a11yLabel = L.item(i + 1, step.label, step.state);
+    children: normalised.map((step, i) => {
+      const a11yLabel = L.item(i + 1, step.label, step.state);
       return /*#__PURE__*/_jsxs(React.Fragment, {
         children: [step.clickable ? /*#__PURE__*/_jsx(Box, {
           component: "button",
           type: "button",
           "aria-current": step.state === "active" ? "step" : undefined,
           "aria-label": a11yLabel,
-          onClick: function onClick() {
-            return jumpHandler === null || jumpHandler === void 0 ? void 0 : jumpHandler(i);
-          },
-          sx: _objectSpread(_objectSpread({}, stepBoxSx), {}, {
+          onClick: () => jumpHandler?.(i),
+          sx: {
+            ...stepBoxSx,
             cursor: "pointer"
-          }),
+          },
           children: /*#__PURE__*/_jsx(StepInner, {
             index: i,
             label: step.label,
@@ -272,9 +266,10 @@ export function HStepper(_ref2) {
           component: "span",
           "aria-label": a11yLabel,
           "aria-disabled": step.state === "disabled" ? "true" : undefined,
-          sx: _objectSpread(_objectSpread({}, stepBoxSx), {}, {
+          sx: {
+            ...stepBoxSx,
             cursor: "default"
-          }),
+          },
           children: /*#__PURE__*/_jsx(StepInner, {
             index: i,
             label: step.label,
@@ -308,12 +303,12 @@ export function HStepper(_ref2) {
  *                    opt out of heading semantics entirely.
  * @param labels    - i18n overrides; see file header.
  */
-export function VStepper(_ref3) {
-  var items = _ref3.items,
-    _ref3$titleAs = _ref3.titleAs,
-    titleAs = _ref3$titleAs === void 0 ? "h4" : _ref3$titleAs,
-    labels = _ref3.labels,
-    ariaLabel = _ref3.ariaLabel;
+export function VStepper({
+  items,
+  titleAs = "h4",
+  labels,
+  ariaLabel
+}) {
   /*
    * Nested-dictionary merge, both levels through the shared undefined-safe helper
    * (gap G-24, fourth instance after Dropzone.reasons and DataGridLabels.
@@ -331,19 +326,19 @@ export function VStepper(_ref3) {
    * two explicit levels can be read, a recursive helper hides how deep it goes.
    * Same convention as _dataGridShared.
    */
-  var L = labels ? mergeLabels(DEFAULT_V_LABELS, _objectSpread(_objectSpread({}, labels), {}, {
+  const L = labels ? mergeLabels(DEFAULT_V_LABELS, {
+    ...labels,
     state: mergeLabels(DEFAULT_V_LABELS.state, labels.state)
-  })) : DEFAULT_V_LABELS;
-  var navLabel = ariaLabel || L.nav;
+  }) : DEFAULT_V_LABELS;
+  const navLabel = ariaLabel || L.nav;
 
   /* Accept the same rich-step shape HStepper uses, so host modules
    * can pass the same array to both steppers without re-mapping. */
-  var normalisedItems = items.map(function (it) {
+  const normalisedItems = items.map(it => {
     if (isRichStep(it) && it.status !== undefined) {
-      var _it$title;
       return {
         state: normaliseStatusToState(it.status),
-        title: (_it$title = it.title) !== null && _it$title !== void 0 ? _it$title : it.label,
+        title: it.title ?? it.label,
         meta: it.meta,
         timestamp: it.timestamp,
         actor: it.actor
@@ -358,9 +353,8 @@ export function VStepper(_ref3) {
       margin: 0
     },
     "aria-label": navLabel,
-    children: normalisedItems.map(function (it, i) {
-      var _it$state;
-      var st = (_it$state = it.state) !== null && _it$state !== void 0 ? _it$state : "pending";
+    children: normalisedItems.map((it, i) => {
+      const st = it.state ?? "pending";
       return /*#__PURE__*/_jsxs("li", {
         "aria-current": st === "active" ? "step" : undefined,
         style: {
@@ -371,7 +365,10 @@ export function VStepper(_ref3) {
         },
         children: [/*#__PURE__*/_jsx("span", {
           "aria-hidden": "true",
-          style: _objectSpread(_objectSpread({}, dotBaseStyle), stateStyle(st)),
+          style: {
+            ...dotBaseStyle,
+            ...stateStyle(st)
+          },
           children: st === "complete" ? /*#__PURE__*/_jsx(CheckIcon, {
             fontSize: "inherit"
           }) : i + 1

package/dist/esm/v2/components/Stepper.js.map

@@ -1 +1 @@
-{"version":3,"file":"Stepper.js","names":["React","CheckIcon","Box","mergeLabels","jsx","_jsx","Fragment","_Fragment","jsxs","_jsxs","DEFAULT_H_LABELS","Object","freeze","nav","item","n","label","state","suffix","concat","DEFAULT_V_LABELS","complete","active","pending","disabled","dotBaseStyle","width","height","borderRadius","display","placeItems","fontSize","fontWeight","flex","border","transition","stateStyle","background","borderColor","color","StepInner","_ref","index","children","style","_objectSpread","whiteSpace","stepBoxSx","alignItems","gap","padding","font","textAlign","outline","outlineOffset","isRichStep","s","_typeof","Array","isArray","isValidElement","normaliseStatusToState","status","normaliseSteps","steps","current","length","map","i","_rich$id","rich","key","id","clickable","HStepper","_ref2","_ref2$current","onJump","onStepClick","ariaLabel","labels","L","navLabel","jumpHandler","normalised","overflowX","step","a11yLabel","component","type","undefined","onClick","sx","cursor","minWidth","VStepper","_ref3","items","_ref3$titleAs","titleAs","normalisedItems","it","_it$title","title","meta","timestamp","actor","listStyle","margin","_it$state","st","paddingBottom","position","className","lineHeight","left","top","bottom"],"sources":["../../../../src/lib/v2/components/Stepper.tsx"],"sourcesContent":["import * as React from \"react\";\r\nimport CheckIcon from \"@mui/icons-material/Check\";\r\nimport Box from \"@mui/material/Box\";\r\nimport type { SxProps, Theme } from \"@mui/material/styles\";\r\nimport { mergeLabels } from \"../utils/mergeLabels\";\r\n\r\n/**\r\n * Stepper - Portnet UI v2\r\n *\r\n * Charter §03 · Component \"Stepper\". Required on flows ≥ 3 steps (R-3.4).\r\n *\r\n * Two ways to drive HStepper:\r\n *\r\n *  1. SIMPLE mode — plain labels + `current` index (Charter default):\r\n *\r\n *       <HStepper\r\n *         steps={[\"Identification\", \"Marchandise\", \"Banque\", \"Validation\"]}\r\n *         current={1}\r\n *         onJump={i => goTo(i)}\r\n *       />\r\n *\r\n *  2. RICH mode — objects carry their own state, including a \"disabled\"\r\n *     state for locked future steps (used by wizards where step N is\r\n *     unavailable until step N-1 has been submitted):\r\n *\r\n *       <HStepper\r\n *         steps={[\r\n *           { id: \"importateur\", label: \"Importateur\",  status: \"completed\" },\r\n *           { id: \"donneesTI\",   label: \"Données\",      status: \"current\"   },\r\n *           { id: \"marchandises\",label: \"Marchandises\", status: \"disabled\"  },\r\n *           { id: \"revision\",    label: \"Révision\",     status: \"pending\"   },\r\n *         ]}\r\n *         onStepClick={i => goTo(i)}\r\n *         ariaLabel=\"Étapes de création du titre\"\r\n *       />\r\n *\r\n *     status values: \"current\" | \"active\" | \"completed\" | \"complete\" |\r\n *                    \"pending\" | \"disabled\"\r\n *     (\"current\"/\"active\" and \"completed\"/\"complete\" are accepted as\r\n *     synonyms to ease migration from host modules.)\r\n *\r\n *  VStepper — vertical history/progression timeline. Each item may carry\r\n *  `timestamp` (date/time of the action) and `actor` (the user who did it);\r\n *  they render as a muted \"timestamp · actor\" line under the title. `meta`\r\n *  still works for free-form text (e.g. \"En cours\" on the active step):\r\n *\r\n *    <VStepper items={[\r\n *       { status: \"completed\", title: \"Titre d'importation créé\",\r\n *         timestamp: \"27/03/2025 09:48\", actor: \"dsmoimp\" },\r\n *       { status: \"completed\", title: \"Soumis à la banque (CITIBANK)\",\r\n *         timestamp: \"27/03/2025 10:16\", actor: \"Transit Jebli\" },\r\n *       { status: \"active\",    title: \"En attente de réponse banque\", meta: \"En cours\" },\r\n *    ]} />\r\n *\r\n * Localisation (FR / EN / AR):\r\n *   <HStepper labels={{\r\n *     nav:  \"Form steps\",\r\n *     item: (n, label, state) =>\r\n *       `Step ${n}: ${label} (${\r\n *         state === \"complete\" ? \"completed\" :\r\n *         state === \"active\"   ? \"in progress\" : \"upcoming\"\r\n *       })`,\r\n *   }} />\r\n *\r\n *   <VStepper labels={{\r\n *     nav:   \"Step history\",\r\n *     state: { complete: \"Completed step.\", active: \"Current step.\", pending: \"Upcoming step.\" },\r\n *   }} />\r\n *\r\n * A11y note (R-Ar.1):\r\n *   Clickable HStepper steps render as real <button> elements.\r\n *   VStepper's per-item title element is host-configurable via\r\n *   `titleAs` so the page heading hierarchy stays consistent.\r\n */\r\n\r\nexport type StepState = \"complete\" | \"active\" | \"pending\" | \"disabled\";\r\nexport type StepStatus =\r\n  | \"current\"\r\n  | \"active\"\r\n  | \"completed\"\r\n  | \"complete\"\r\n  | \"pending\"\r\n  | \"disabled\";\r\n\r\nexport interface HStepperRichStep {\r\n  id?: string | number | undefined;\r\n  label?: React.ReactNode | undefined;\r\n  status?: StepStatus | undefined;\r\n}\r\n\r\nexport type HStepperStep = React.ReactNode | HStepperRichStep;\r\n\r\ninterface NormalisedStep {\r\n  key: React.Key;\r\n  label: React.ReactNode;\r\n  state: StepState;\r\n  clickable: boolean;\r\n}\r\n\r\nconst DEFAULT_H_LABELS = Object.freeze({\r\n  nav: \"Étapes du formulaire\",\r\n  item: (n: number, label: React.ReactNode, state: StepState): string => {\r\n    const suffix =\r\n      state === \"complete\" ? \" (complétée)\" :\r\n      state === \"active\"   ? \" (en cours)\"   :\r\n      state === \"disabled\" ? \" (verrouillée)\" : \" (à venir)\";\r\n    return `Étape ${n} : ${label}${suffix}`;\r\n  },\r\n});\r\n\r\nconst DEFAULT_V_LABELS: {\r\n  nav: string;\r\n  state: Partial<Record<StepState, string>>;\r\n} = Object.freeze({\r\n  nav: \"Historique des étapes\",\r\n  state: Object.freeze({\r\n    complete: \"Étape complétée. \",\r\n    active:   \"Étape en cours. \",\r\n    pending:  \"Étape à venir. \",\r\n    /* WCAG 1.4.1 — the fourth state was MISSING. VStepper accepts the same rich\r\n     * item shape as HStepper (see normalisedItems below: \"so host modules can pass\r\n     * the same array to both steppers\"), and HStepper documents\r\n     * `status: \"disabled\"` for wizard steps locked until the previous one is\r\n     * submitted. So a disabled step could reach VStepper and render an EMPTY\r\n     * sr-only span — its state conveyed by colour alone, which is precisely what\r\n     * the comment on that span forbids. No host had to do anything wrong. */\r\n    disabled: \"Étape verrouillée. \",\r\n  }),\r\n});\r\n\r\nconst dotBaseStyle: React.CSSProperties = {\r\n  width: 24,\r\n  height: 24,\r\n  borderRadius: \"50%\",\r\n  display: \"grid\",\r\n  placeItems: \"center\",\r\n  fontSize: \"var(--text-xs)\",\r\n  fontWeight: \"var(--fw-semibold)\",\r\n  flex: \"0 0 auto\",\r\n  border: \"2px solid\",\r\n  transition:\r\n    \"background var(--duration-base, 180ms), color var(--duration-base, 180ms), border-color var(--duration-base, 180ms)\",\r\n};\r\n\r\nconst stateStyle = (state: StepState): React.CSSProperties => {\r\n  if (state === \"complete\") {\r\n    return { background: \"var(--accent)\", borderColor: \"var(--accent)\", color: \"var(--accent-fg)\" };\r\n  }\r\n  if (state === \"active\") {\r\n    return { background: \"var(--surface)\", borderColor: \"var(--accent)\", color: \"var(--accent)\" };\r\n  }\r\n  if (state === \"disabled\") {\r\n    return { background: \"var(--bg-subtle)\", borderColor: \"var(--border)\", color: \"var(--fg-subtle)\" };\r\n  }\r\n  return { background: \"var(--surface)\", borderColor: \"var(--border-strong)\", color: \"var(--fg-subtle)\" };\r\n};\r\n\r\ninterface StepInnerProps {\r\n  index: number;\r\n  label: React.ReactNode;\r\n  state: StepState;\r\n}\r\n\r\n// Inner content shared between the clickable <button> and the\r\n// non-interactive <span> renderings of an HStepper step.\r\nfunction StepInner({ index, label, state }: StepInnerProps) {\r\n  return (\r\n    <>\r\n      <span style={{ ...dotBaseStyle, ...stateStyle(state) }}>\r\n        {state === \"complete\" ? <CheckIcon fontSize=\"inherit\" /> : index + 1}\r\n      </span>\r\n      <span\r\n        style={{\r\n          fontSize: \"var(--text-sm)\",\r\n          // Was 650 (non-standard, banned by Batch 1 typography tokens).\r\n          // var(--fw-semibold) (600) is the canonical \"emphasised\" weight.\r\n          fontWeight: state === \"active\" ? \"var(--fw-semibold)\" : \"var(--fw-medium)\",\r\n          color:\r\n            state === \"pending\"  ? \"var(--fg-subtle)\" :\r\n            state === \"disabled\" ? \"var(--fg-muted)\"  : \"var(--fg)\",\r\n          whiteSpace: \"nowrap\",\r\n        }}\r\n      >\r\n        {label}\r\n      </span>\r\n    </>\r\n  );\r\n}\r\n\r\nconst stepBoxSx = {\r\n  display: \"flex\",\r\n  alignItems: \"center\",\r\n  gap: 1,\r\n  padding: \"var(--s-1) calc(var(--s-1) + 2px)\",\r\n  borderRadius: \"var(--r-md)\",\r\n  // Reset native <button> styling to match the previous Box look.\r\n  background: \"transparent\",\r\n  border: 0,\r\n  font: \"inherit\",\r\n  textAlign: \"left\",\r\n  \"&:focus-visible\": {\r\n    outline: \"2px solid var(--accent)\",\r\n    outlineOffset: \"var(--pui-outline-offset)\",\r\n  },\r\n} satisfies SxProps<Theme>;\r\n\r\n/* Detect whether the `steps` array carries plain labels (legacy)\r\n * or rich {id, label, status} objects. ReactElements (icons,\r\n * fragments) and strings are treated as plain labels.\r\n * Plain boolean predicate (not a type guard): the rich object shape\r\n * for VStepper also carries title/meta/etc., so narrowing to\r\n * HStepperRichStep here would hide those fields. */\r\nfunction isRichStep(s: unknown): boolean {\r\n  return (\r\n    s != null &&\r\n    typeof s === \"object\" &&\r\n    !Array.isArray(s) &&\r\n    !React.isValidElement(s) &&\r\n    (\"label\" in s || \"status\" in s)\r\n  );\r\n}\r\n\r\nfunction normaliseStatusToState(status: StepStatus | undefined): StepState {\r\n  if (status === \"current\"   || status === \"active\")    return \"active\";\r\n  if (status === \"completed\" || status === \"complete\")  return \"complete\";\r\n  if (status === \"disabled\") return \"disabled\";\r\n  return \"pending\";\r\n}\r\n\r\n/* Convert rich steps to the legacy { label, state, clickable, key }\r\n * shape consumed by the rendering loop. */\r\nfunction normaliseSteps(steps: HStepperStep[], current: number): NormalisedStep[] {\r\n  if (steps.length === 0) return [];\r\n  if (isRichStep(steps[0])) {\r\n    return steps.map((s, i): NormalisedStep => {\r\n      const rich = s as HStepperRichStep;\r\n      const state = normaliseStatusToState(rich.status);\r\n      return {\r\n        key:       rich.id ?? i,\r\n        label:     rich.label,\r\n        state,\r\n        // Disabled steps are never clickable. Other rich states\r\n        // remain clickable so the host can offer free navigation.\r\n        clickable: state !== \"disabled\",\r\n      };\r\n    });\r\n  }\r\n  // Legacy: plain labels driven by `current`.\r\n  return steps.map((label, i): NormalisedStep => ({\r\n    key:       i,\r\n    label:     label as React.ReactNode,\r\n    state:     i < current ? \"complete\" : i === current ? \"active\" : \"pending\",\r\n    clickable: i <= current,\r\n  }));\r\n}\r\n\r\nexport interface HStepperLabels {\r\n  nav?: string | undefined;\r\n  item?: ((n: number, label: React.ReactNode, state: StepState) => string) | undefined;\r\n}\r\n\r\nexport interface HStepperProps {\r\n  /**\r\n   * Either an array of plain labels (strings/nodes) driven by\r\n   * `current`, or an array of `{ id?, label, status }` objects\r\n   * where status carries the per-step state.\r\n   */\r\n  steps: HStepperStep[];\r\n  /** Legacy: index of the active step. Ignored when `steps` are rich objects. */\r\n  current?: number | undefined;\r\n  /** Click handler. Receives the step index. */\r\n  onJump?: ((index: number) => void) | undefined;\r\n  /** Alias of `onJump` (some host modules used this name). */\r\n  onStepClick?: ((index: number) => void) | undefined;\r\n  /** Shortcut for `labels.nav`. */\r\n  ariaLabel?: string | undefined;\r\n  /** Full i18n override; see file header. */\r\n  labels?: HStepperLabels | undefined;\r\n}\r\n\r\nexport function HStepper({\r\n  steps,\r\n  current = 0,\r\n  onJump,\r\n  onStepClick,\r\n  ariaLabel,\r\n  labels,\r\n}: HStepperProps) {\r\n  const L = mergeLabels(DEFAULT_H_LABELS, labels);\r\n  const navLabel = ariaLabel || L.nav;\r\n  const jumpHandler = onJump || onStepClick;\r\n\r\n  const normalised = normaliseSteps(steps, current);\r\n\r\n  return (\r\n    <nav\r\n      aria-label={navLabel}\r\n      style={{\r\n        display: \"flex\",\r\n        alignItems: \"center\",\r\n        gap: 8,\r\n        padding: \"12px 0\",\r\n        overflowX: \"auto\",\r\n      }}\r\n    >\r\n      {normalised.map((step, i) => {\r\n        const a11yLabel = L.item(i + 1, step.label, step.state);\r\n        return (\r\n          <React.Fragment key={step.key}>\r\n            {step.clickable ? (\r\n              <Box\r\n                component=\"button\"\r\n                type=\"button\"\r\n                aria-current={step.state === \"active\" ? \"step\" : undefined}\r\n                aria-label={a11yLabel}\r\n                onClick={() => jumpHandler?.(i)}\r\n                sx={{ ...stepBoxSx, cursor: \"pointer\" }}\r\n              >\r\n                <StepInner index={i} label={step.label} state={step.state} />\r\n              </Box>\r\n            ) : (\r\n              <Box\r\n                component=\"span\"\r\n                aria-label={a11yLabel}\r\n                aria-disabled={step.state === \"disabled\" ? \"true\" : undefined}\r\n                sx={{ ...stepBoxSx, cursor: \"default\" }}\r\n              >\r\n                <StepInner index={i} label={step.label} state={step.state} />\r\n              </Box>\r\n            )}\r\n            {i < normalised.length - 1 && (\r\n              <Box\r\n                aria-hidden=\"true\"\r\n                sx={{\r\n                  flex: 1,\r\n                  minWidth: 24,\r\n                  height: 2,\r\n                  background: step.state === \"complete\" ? \"var(--accent)\" : \"var(--border)\",\r\n                  borderRadius: 1,\r\n                }}\r\n              />\r\n            )}\r\n          </React.Fragment>\r\n        );\r\n      })}\r\n    </nav>\r\n  );\r\n}\r\n\r\nexport interface VStepperItem {\r\n  state?: StepState | undefined;\r\n  status?: StepStatus | undefined;\r\n  title?: React.ReactNode | undefined;\r\n  label?: React.ReactNode | undefined;\r\n  meta?: React.ReactNode | undefined;\r\n  timestamp?: React.ReactNode | undefined;\r\n  actor?: React.ReactNode | undefined;\r\n}\r\n\r\nexport interface VStepperLabels {\r\n  nav?: string | undefined;\r\n  /**\r\n   * SR-only sentence per step state. Widened from the three visible states to the\r\n   * full `StepState` union: `disabled` was unreachable for hosts even though\r\n   * VStepper accepts disabled items, so its text alternative could not be\r\n   * translated (WCAG 1.4.1 + R-Ar.3).\r\n   */\r\n  state?: Partial<Record<StepState, string>> | undefined;\r\n}\r\n\r\nexport interface VStepperProps {\r\n  items: VStepperItem[];\r\n  titleAs?: \"h2\" | \"h3\" | \"h4\" | \"h5\" | \"h6\" | \"div\" | \"span\" | \"p\" | undefined;\r\n  ariaLabel?: string | undefined;\r\n  labels?: VStepperLabels | undefined;\r\n}\r\n\r\n/**\r\n * VStepper - vertical historical / progression stepper.\r\n *\r\n * @param items     - list of { state|status, title, meta?, timestamp?, actor? }.\r\n *                    `timestamp` (date/time) + `actor` (user) render as a\r\n *                    muted \"timestamp · actor\" line under the title; `meta`\r\n *                    renders on its own line (free-form, e.g. \"En cours\").\r\n * @param titleAs   - element used for each step title. Defaults to \"h4\".\r\n *                    Hosts whose outline already used h2/h3 above the\r\n *                    stepper should pick the next level (e.g. titleAs=\"h3\"\r\n *                    after an h2 ActionBar title). Pass \"div\"/\"span\" to\r\n *                    opt out of heading semantics entirely.\r\n * @param labels    - i18n overrides; see file header.\r\n */\r\nexport function VStepper({ items, titleAs = \"h4\", labels, ariaLabel }: VStepperProps) {\r\n  /*\r\n   * Nested-dictionary merge, both levels through the shared undefined-safe helper\r\n   * (gap G-24, fourth instance after Dropzone.reasons and DataGridLabels.\r\n   * pagination).\r\n   *\r\n   * The previous form spread `...labels` at the top level, so an explicitly-passed\r\n   * `undefined` on `nav` DELETED the default and left the <ol> without an\r\n   * accessible name (R-Ar.5). And the inner `|| {}` guarded the `state` sub-object\r\n   * against being undefined without guarding its VALUES — so\r\n   * `state: { complete: undefined }` emptied the sr-only span below and reduced the\r\n   * step's state to colour alone, defeating the WCAG 1.4.1 rule its own comment\r\n   * invokes.\r\n   *\r\n   * `state` is merged at its OWN level rather than through a recursive deep merge:\r\n   * two explicit levels can be read, a recursive helper hides how deep it goes.\r\n   * Same convention as _dataGridShared.\r\n   */\r\n  const L = labels\r\n    ? mergeLabels(DEFAULT_V_LABELS, {\r\n        ...labels,\r\n        state: mergeLabels(DEFAULT_V_LABELS.state, labels.state),\r\n      })\r\n    : DEFAULT_V_LABELS;\r\n  const navLabel = ariaLabel || L.nav;\r\n\r\n  /* Accept the same rich-step shape HStepper uses, so host modules\r\n   * can pass the same array to both steppers without re-mapping. */\r\n  const normalisedItems = items.map((it) => {\r\n    if (isRichStep(it) && it.status !== undefined) {\r\n      return {\r\n        state: normaliseStatusToState(it.status),\r\n        title: it.title ?? it.label,\r\n        meta:  it.meta,\r\n        timestamp: it.timestamp,\r\n        actor: it.actor,\r\n      };\r\n    }\r\n    return it;\r\n  });\r\n\r\n  return (\r\n    <ol style={{ listStyle: \"none\", padding: 0, margin: 0 }} aria-label={navLabel}>\r\n      {normalisedItems.map((it, i) => {\r\n        const st: StepState = it.state ?? \"pending\";\r\n        return (\r\n          <li\r\n            key={i}\r\n            aria-current={st === \"active\" ? \"step\" : undefined}\r\n            style={{\r\n              display: \"flex\",\r\n              gap: 12,\r\n              paddingBottom: i < normalisedItems.length - 1 ? 16 : 0,\r\n              position: \"relative\",\r\n            }}\r\n          >\r\n            <span aria-hidden=\"true\" style={{ ...dotBaseStyle, ...stateStyle(st) }}>\r\n              {st === \"complete\" ? <CheckIcon fontSize=\"inherit\" /> : i + 1}\r\n            </span>\r\n            {/* WCAG 1.4.1 - convey state in text, not only colour. */}\r\n            <span className=\"pui-sr-only\">{L.state[st]}</span>\r\n            <div style={{ flex: 1 }}>\r\n              <Box\r\n                component={titleAs}\r\n                sx={{\r\n                  margin: 0,\r\n                  fontSize: \"var(--text-sm)\",\r\n                  fontWeight: \"var(--fw-semibold)\",\r\n                  color: \"var(--fg)\",\r\n                  lineHeight: \"var(--lh-snug)\",\r\n                }}\r\n              >\r\n                {it.title}\r\n              </Box>\r\n              {(it.timestamp != null || it.actor != null) && (\r\n                <p\r\n                  style={{\r\n                    margin: \"2px 0 0\",\r\n                    fontSize: \"var(--text-xs)\",\r\n                    color: \"var(--fg-subtle)\",\r\n                  }}\r\n                >\r\n                  {it.timestamp != null ? it.timestamp : null}\r\n                  {it.timestamp != null && it.actor != null ? \" · \" : null}\r\n                  {it.actor != null ? (\r\n                    <span style={{ color: \"var(--fg-muted)\", fontWeight: \"var(--fw-medium)\" }}>\r\n                      {it.actor}\r\n                    </span>\r\n                  ) : null}\r\n                </p>\r\n              )}\r\n              {it.meta != null && it.meta !== \"\" && (\r\n                <p\r\n                  style={{\r\n                    margin: \"2px 0 0\",\r\n                    fontSize: \"var(--text-xs)\",\r\n                    color: \"var(--fg-subtle)\",\r\n                  }}\r\n                >\r\n                  {it.meta}\r\n                </p>\r\n              )}\r\n            </div>\r\n            {i < normalisedItems.length - 1 && (\r\n              <span\r\n                aria-hidden=\"true\"\r\n                style={{\r\n                  position: \"absolute\",\r\n                  left: 11, top: 26, bottom: 0,\r\n                  width: 2,\r\n                  background: \"var(--border)\",\r\n                }}\r\n              />\r\n            )}\r\n          </li>\r\n        );\r\n      })}\r\n    </ol>\r\n  );\r\n}\r\n\r\nexport default HStepper;\r\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"Stepper.js","names":["React","CheckIcon","Box","mergeLabels","jsx","_jsx","Fragment","_Fragment","jsxs","_jsxs","DEFAULT_H_LABELS","Object","freeze","nav","item","n","label","state","suffix","DEFAULT_V_LABELS","complete","active","pending","disabled","dotBaseStyle","width","height","borderRadius","display","placeItems","fontSize","fontWeight","flex","border","transition","stateStyle","background","borderColor","color","StepInner","index","children","style","whiteSpace","stepBoxSx","alignItems","gap","padding","font","textAlign","outline","outlineOffset","isRichStep","s","Array","isArray","isValidElement","normaliseStatusToState","status","normaliseSteps","steps","current","length","map","i","rich","key","id","clickable","HStepper","onJump","onStepClick","ariaLabel","labels","L","navLabel","jumpHandler","normalised","overflowX","step","a11yLabel","component","type","undefined","onClick","sx","cursor","minWidth","VStepper","items","titleAs","normalisedItems","it","title","meta","timestamp","actor","listStyle","margin","st","paddingBottom","position","className","lineHeight","left","top","bottom"],"sources":["../../../../src/lib/v2/components/Stepper.tsx"],"sourcesContent":["import * as React from \"react\";\r\nimport CheckIcon from \"@mui/icons-material/Check\";\r\nimport Box from \"@mui/material/Box\";\r\nimport type { SxProps, Theme } from \"@mui/material/styles\";\r\nimport { mergeLabels } from \"../utils/mergeLabels\";\r\n\r\n/**\r\n * Stepper - Portnet UI v2\r\n *\r\n * Charter §03 · Component \"Stepper\". Required on flows ≥ 3 steps (R-3.4).\r\n *\r\n * Two ways to drive HStepper:\r\n *\r\n *  1. SIMPLE mode — plain labels + `current` index (Charter default):\r\n *\r\n *       <HStepper\r\n *         steps={[\"Identification\", \"Marchandise\", \"Banque\", \"Validation\"]}\r\n *         current={1}\r\n *         onJump={i => goTo(i)}\r\n *       />\r\n *\r\n *  2. RICH mode — objects carry their own state, including a \"disabled\"\r\n *     state for locked future steps (used by wizards where step N is\r\n *     unavailable until step N-1 has been submitted):\r\n *\r\n *       <HStepper\r\n *         steps={[\r\n *           { id: \"importateur\", label: \"Importateur\",  status: \"completed\" },\r\n *           { id: \"donneesTI\",   label: \"Données\",      status: \"current\"   },\r\n *           { id: \"marchandises\",label: \"Marchandises\", status: \"disabled\"  },\r\n *           { id: \"revision\",    label: \"Révision\",     status: \"pending\"   },\r\n *         ]}\r\n *         onStepClick={i => goTo(i)}\r\n *         ariaLabel=\"Étapes de création du titre\"\r\n *       />\r\n *\r\n *     status values: \"current\" | \"active\" | \"completed\" | \"complete\" |\r\n *                    \"pending\" | \"disabled\"\r\n *     (\"current\"/\"active\" and \"completed\"/\"complete\" are accepted as\r\n *     synonyms to ease migration from host modules.)\r\n *\r\n *  VStepper — vertical history/progression timeline. Each item may carry\r\n *  `timestamp` (date/time of the action) and `actor` (the user who did it);\r\n *  they render as a muted \"timestamp · actor\" line under the title. `meta`\r\n *  still works for free-form text (e.g. \"En cours\" on the active step):\r\n *\r\n *    <VStepper items={[\r\n *       { status: \"completed\", title: \"Titre d'importation créé\",\r\n *         timestamp: \"27/03/2025 09:48\", actor: \"dsmoimp\" },\r\n *       { status: \"completed\", title: \"Soumis à la banque (CITIBANK)\",\r\n *         timestamp: \"27/03/2025 10:16\", actor: \"Transit Jebli\" },\r\n *       { status: \"active\",    title: \"En attente de réponse banque\", meta: \"En cours\" },\r\n *    ]} />\r\n *\r\n * Localisation (FR / EN / AR):\r\n *   <HStepper labels={{\r\n *     nav:  \"Form steps\",\r\n *     item: (n, label, state) =>\r\n *       `Step ${n}: ${label} (${\r\n *         state === \"complete\" ? \"completed\" :\r\n *         state === \"active\"   ? \"in progress\" : \"upcoming\"\r\n *       })`,\r\n *   }} />\r\n *\r\n *   <VStepper labels={{\r\n *     nav:   \"Step history\",\r\n *     state: { complete: \"Completed step.\", active: \"Current step.\", pending: \"Upcoming step.\" },\r\n *   }} />\r\n *\r\n * A11y note (R-Ar.1):\r\n *   Clickable HStepper steps render as real <button> elements.\r\n *   VStepper's per-item title element is host-configurable via\r\n *   `titleAs` so the page heading hierarchy stays consistent.\r\n */\r\n\r\nexport type StepState = \"complete\" | \"active\" | \"pending\" | \"disabled\";\r\nexport type StepStatus =\r\n  | \"current\"\r\n  | \"active\"\r\n  | \"completed\"\r\n  | \"complete\"\r\n  | \"pending\"\r\n  | \"disabled\";\r\n\r\nexport interface HStepperRichStep {\r\n  id?: string | number | undefined;\r\n  label?: React.ReactNode | undefined;\r\n  status?: StepStatus | undefined;\r\n}\r\n\r\nexport type HStepperStep = React.ReactNode | HStepperRichStep;\r\n\r\ninterface NormalisedStep {\r\n  key: React.Key;\r\n  label: React.ReactNode;\r\n  state: StepState;\r\n  clickable: boolean;\r\n}\r\n\r\nconst DEFAULT_H_LABELS = Object.freeze({\r\n  nav: \"Étapes du formulaire\",\r\n  item: (n: number, label: React.ReactNode, state: StepState): string => {\r\n    const suffix =\r\n      state === \"complete\" ? \" (complétée)\" :\r\n      state === \"active\"   ? \" (en cours)\"   :\r\n      state === \"disabled\" ? \" (verrouillée)\" : \" (à venir)\";\r\n    return `Étape ${n} : ${label}${suffix}`;\r\n  },\r\n});\r\n\r\nconst DEFAULT_V_LABELS: {\r\n  nav: string;\r\n  state: Partial<Record<StepState, string>>;\r\n} = Object.freeze({\r\n  nav: \"Historique des étapes\",\r\n  state: Object.freeze({\r\n    complete: \"Étape complétée. \",\r\n    active:   \"Étape en cours. \",\r\n    pending:  \"Étape à venir. \",\r\n    /* WCAG 1.4.1 — the fourth state was MISSING. VStepper accepts the same rich\r\n     * item shape as HStepper (see normalisedItems below: \"so host modules can pass\r\n     * the same array to both steppers\"), and HStepper documents\r\n     * `status: \"disabled\"` for wizard steps locked until the previous one is\r\n     * submitted. So a disabled step could reach VStepper and render an EMPTY\r\n     * sr-only span — its state conveyed by colour alone, which is precisely what\r\n     * the comment on that span forbids. No host had to do anything wrong. */\r\n    disabled: \"Étape verrouillée. \",\r\n  }),\r\n});\r\n\r\nconst dotBaseStyle: React.CSSProperties = {\r\n  width: 24,\r\n  height: 24,\r\n  borderRadius: \"50%\",\r\n  display: \"grid\",\r\n  placeItems: \"center\",\r\n  fontSize: \"var(--text-xs)\",\r\n  fontWeight: \"var(--fw-semibold)\",\r\n  flex: \"0 0 auto\",\r\n  border: \"2px solid\",\r\n  transition:\r\n    \"background var(--duration-base, 180ms), color var(--duration-base, 180ms), border-color var(--duration-base, 180ms)\",\r\n};\r\n\r\nconst stateStyle = (state: StepState): React.CSSProperties => {\r\n  if (state === \"complete\") {\r\n    return { background: \"var(--accent)\", borderColor: \"var(--accent)\", color: \"var(--accent-fg)\" };\r\n  }\r\n  if (state === \"active\") {\r\n    return { background: \"var(--surface)\", borderColor: \"var(--accent)\", color: \"var(--accent)\" };\r\n  }\r\n  if (state === \"disabled\") {\r\n    return { background: \"var(--bg-subtle)\", borderColor: \"var(--border)\", color: \"var(--fg-subtle)\" };\r\n  }\r\n  return { background: \"var(--surface)\", borderColor: \"var(--border-strong)\", color: \"var(--fg-subtle)\" };\r\n};\r\n\r\ninterface StepInnerProps {\r\n  index: number;\r\n  label: React.ReactNode;\r\n  state: StepState;\r\n}\r\n\r\n// Inner content shared between the clickable <button> and the\r\n// non-interactive <span> renderings of an HStepper step.\r\nfunction StepInner({ index, label, state }: StepInnerProps) {\r\n  return (\r\n    <>\r\n      <span style={{ ...dotBaseStyle, ...stateStyle(state) }}>\r\n        {state === \"complete\" ? <CheckIcon fontSize=\"inherit\" /> : index + 1}\r\n      </span>\r\n      <span\r\n        style={{\r\n          fontSize: \"var(--text-sm)\",\r\n          // Was 650 (non-standard, banned by Batch 1 typography tokens).\r\n          // var(--fw-semibold) (600) is the canonical \"emphasised\" weight.\r\n          fontWeight: state === \"active\" ? \"var(--fw-semibold)\" : \"var(--fw-medium)\",\r\n          color:\r\n            state === \"pending\"  ? \"var(--fg-subtle)\" :\r\n            state === \"disabled\" ? \"var(--fg-muted)\"  : \"var(--fg)\",\r\n          whiteSpace: \"nowrap\",\r\n        }}\r\n      >\r\n        {label}\r\n      </span>\r\n    </>\r\n  );\r\n}\r\n\r\nconst stepBoxSx = {\r\n  display: \"flex\",\r\n  alignItems: \"center\",\r\n  gap: 1,\r\n  padding: \"var(--s-1) calc(var(--s-1) + 2px)\",\r\n  borderRadius: \"var(--r-md)\",\r\n  // Reset native <button> styling to match the previous Box look.\r\n  background: \"transparent\",\r\n  border: 0,\r\n  font: \"inherit\",\r\n  textAlign: \"left\",\r\n  \"&:focus-visible\": {\r\n    outline: \"2px solid var(--accent)\",\r\n    outlineOffset: \"var(--pui-outline-offset)\",\r\n  },\r\n} satisfies SxProps<Theme>;\r\n\r\n/* Detect whether the `steps` array carries plain labels (legacy)\r\n * or rich {id, label, status} objects. ReactElements (icons,\r\n * fragments) and strings are treated as plain labels.\r\n * Plain boolean predicate (not a type guard): the rich object shape\r\n * for VStepper also carries title/meta/etc., so narrowing to\r\n * HStepperRichStep here would hide those fields. */\r\nfunction isRichStep(s: unknown): boolean {\r\n  return (\r\n    s != null &&\r\n    typeof s === \"object\" &&\r\n    !Array.isArray(s) &&\r\n    !React.isValidElement(s) &&\r\n    (\"label\" in s || \"status\" in s)\r\n  );\r\n}\r\n\r\nfunction normaliseStatusToState(status: StepStatus | undefined): StepState {\r\n  if (status === \"current\"   || status === \"active\")    return \"active\";\r\n  if (status === \"completed\" || status === \"complete\")  return \"complete\";\r\n  if (status === \"disabled\") return \"disabled\";\r\n  return \"pending\";\r\n}\r\n\r\n/* Convert rich steps to the legacy { label, state, clickable, key }\r\n * shape consumed by the rendering loop. */\r\nfunction normaliseSteps(steps: HStepperStep[], current: number): NormalisedStep[] {\r\n  if (steps.length === 0) return [];\r\n  if (isRichStep(steps[0])) {\r\n    return steps.map((s, i): NormalisedStep => {\r\n      const rich = s as HStepperRichStep;\r\n      const state = normaliseStatusToState(rich.status);\r\n      return {\r\n        key:       rich.id ?? i,\r\n        label:     rich.label,\r\n        state,\r\n        // Disabled steps are never clickable. Other rich states\r\n        // remain clickable so the host can offer free navigation.\r\n        clickable: state !== \"disabled\",\r\n      };\r\n    });\r\n  }\r\n  // Legacy: plain labels driven by `current`.\r\n  return steps.map((label, i): NormalisedStep => ({\r\n    key:       i,\r\n    label:     label as React.ReactNode,\r\n    state:     i < current ? \"complete\" : i === current ? \"active\" : \"pending\",\r\n    clickable: i <= current,\r\n  }));\r\n}\r\n\r\nexport interface HStepperLabels {\r\n  nav?: string | undefined;\r\n  item?: ((n: number, label: React.ReactNode, state: StepState) => string) | undefined;\r\n}\r\n\r\nexport interface HStepperProps {\r\n  /**\r\n   * Either an array of plain labels (strings/nodes) driven by\r\n   * `current`, or an array of `{ id?, label, status }` objects\r\n   * where status carries the per-step state.\r\n   */\r\n  steps: HStepperStep[];\r\n  /** Legacy: index of the active step. Ignored when `steps` are rich objects. */\r\n  current?: number | undefined;\r\n  /** Click handler. Receives the step index. */\r\n  onJump?: ((index: number) => void) | undefined;\r\n  /** Alias of `onJump` (some host modules used this name). */\r\n  onStepClick?: ((index: number) => void) | undefined;\r\n  /** Shortcut for `labels.nav`. */\r\n  ariaLabel?: string | undefined;\r\n  /** Full i18n override; see file header. */\r\n  labels?: HStepperLabels | undefined;\r\n}\r\n\r\nexport function HStepper({\r\n  steps,\r\n  current = 0,\r\n  onJump,\r\n  onStepClick,\r\n  ariaLabel,\r\n  labels,\r\n}: HStepperProps) {\r\n  const L = mergeLabels(DEFAULT_H_LABELS, labels);\r\n  const navLabel = ariaLabel || L.nav;\r\n  const jumpHandler = onJump || onStepClick;\r\n\r\n  const normalised = normaliseSteps(steps, current);\r\n\r\n  return (\r\n    <nav\r\n      aria-label={navLabel}\r\n      style={{\r\n        display: \"flex\",\r\n        alignItems: \"center\",\r\n        gap: 8,\r\n        padding: \"12px 0\",\r\n        overflowX: \"auto\",\r\n      }}\r\n    >\r\n      {normalised.map((step, i) => {\r\n        const a11yLabel = L.item(i + 1, step.label, step.state);\r\n        return (\r\n          <React.Fragment key={step.key}>\r\n            {step.clickable ? (\r\n              <Box\r\n                component=\"button\"\r\n                type=\"button\"\r\n                aria-current={step.state === \"active\" ? \"step\" : undefined}\r\n                aria-label={a11yLabel}\r\n                onClick={() => jumpHandler?.(i)}\r\n                sx={{ ...stepBoxSx, cursor: \"pointer\" }}\r\n              >\r\n                <StepInner index={i} label={step.label} state={step.state} />\r\n              </Box>\r\n            ) : (\r\n              <Box\r\n                component=\"span\"\r\n                aria-label={a11yLabel}\r\n                aria-disabled={step.state === \"disabled\" ? \"true\" : undefined}\r\n                sx={{ ...stepBoxSx, cursor: \"default\" }}\r\n              >\r\n                <StepInner index={i} label={step.label} state={step.state} />\r\n              </Box>\r\n            )}\r\n            {i < normalised.length - 1 && (\r\n              <Box\r\n                aria-hidden=\"true\"\r\n                sx={{\r\n                  flex: 1,\r\n                  minWidth: 24,\r\n                  height: 2,\r\n                  background: step.state === \"complete\" ? \"var(--accent)\" : \"var(--border)\",\r\n                  borderRadius: 1,\r\n                }}\r\n              />\r\n            )}\r\n          </React.Fragment>\r\n        );\r\n      })}\r\n    </nav>\r\n  );\r\n}\r\n\r\nexport interface VStepperItem {\r\n  state?: StepState | undefined;\r\n  status?: StepStatus | undefined;\r\n  title?: React.ReactNode | undefined;\r\n  label?: React.ReactNode | undefined;\r\n  meta?: React.ReactNode | undefined;\r\n  timestamp?: React.ReactNode | undefined;\r\n  actor?: React.ReactNode | undefined;\r\n}\r\n\r\nexport interface VStepperLabels {\r\n  nav?: string | undefined;\r\n  /**\r\n   * SR-only sentence per step state. Widened from the three visible states to the\r\n   * full `StepState` union: `disabled` was unreachable for hosts even though\r\n   * VStepper accepts disabled items, so its text alternative could not be\r\n   * translated (WCAG 1.4.1 + R-Ar.3).\r\n   */\r\n  state?: Partial<Record<StepState, string>> | undefined;\r\n}\r\n\r\nexport interface VStepperProps {\r\n  items: VStepperItem[];\r\n  titleAs?: \"h2\" | \"h3\" | \"h4\" | \"h5\" | \"h6\" | \"div\" | \"span\" | \"p\" | undefined;\r\n  ariaLabel?: string | undefined;\r\n  labels?: VStepperLabels | undefined;\r\n}\r\n\r\n/**\r\n * VStepper - vertical historical / progression stepper.\r\n *\r\n * @param items     - list of { state|status, title, meta?, timestamp?, actor? }.\r\n *                    `timestamp` (date/time) + `actor` (user) render as a\r\n *                    muted \"timestamp · actor\" line under the title; `meta`\r\n *                    renders on its own line (free-form, e.g. \"En cours\").\r\n * @param titleAs   - element used for each step title. Defaults to \"h4\".\r\n *                    Hosts whose outline already used h2/h3 above the\r\n *                    stepper should pick the next level (e.g. titleAs=\"h3\"\r\n *                    after an h2 ActionBar title). Pass \"div\"/\"span\" to\r\n *                    opt out of heading semantics entirely.\r\n * @param labels    - i18n overrides; see file header.\r\n */\r\nexport function VStepper({ items, titleAs = \"h4\", labels, ariaLabel }: VStepperProps) {\r\n  /*\r\n   * Nested-dictionary merge, both levels through the shared undefined-safe helper\r\n   * (gap G-24, fourth instance after Dropzone.reasons and DataGridLabels.\r\n   * pagination).\r\n   *\r\n   * The previous form spread `...labels` at the top level, so an explicitly-passed\r\n   * `undefined` on `nav` DELETED the default and left the <ol> without an\r\n   * accessible name (R-Ar.5). And the inner `|| {}` guarded the `state` sub-object\r\n   * against being undefined without guarding its VALUES — so\r\n   * `state: { complete: undefined }` emptied the sr-only span below and reduced the\r\n   * step's state to colour alone, defeating the WCAG 1.4.1 rule its own comment\r\n   * invokes.\r\n   *\r\n   * `state` is merged at its OWN level rather than through a recursive deep merge:\r\n   * two explicit levels can be read, a recursive helper hides how deep it goes.\r\n   * Same convention as _dataGridShared.\r\n   */\r\n  const L = labels\r\n    ? mergeLabels(DEFAULT_V_LABELS, {\r\n        ...labels,\r\n        state: mergeLabels(DEFAULT_V_LABELS.state, labels.state),\r\n      })\r\n    : DEFAULT_V_LABELS;\r\n  const navLabel = ariaLabel || L.nav;\r\n\r\n  /* Accept the same rich-step shape HStepper uses, so host modules\r\n   * can pass the same array to both steppers without re-mapping. */\r\n  const normalisedItems = items.map((it) => {\r\n    if (isRichStep(it) && it.status !== undefined) {\r\n      return {\r\n        state: normaliseStatusToState(it.status),\r\n        title: it.title ?? it.label,\r\n        meta:  it.meta,\r\n        timestamp: it.timestamp,\r\n        actor: it.actor,\r\n      };\r\n    }\r\n    return it;\r\n  });\r\n\r\n  return (\r\n    <ol style={{ listStyle: \"none\", padding: 0, margin: 0 }} aria-label={navLabel}>\r\n      {normalisedItems.map((it, i) => {\r\n        const st: StepState = it.state ?? \"pending\";\r\n        return (\r\n          <li\r\n            key={i}\r\n            aria-current={st === \"active\" ? \"step\" : undefined}\r\n            style={{\r\n              display: \"flex\",\r\n              gap: 12,\r\n              paddingBottom: i < normalisedItems.length - 1 ? 16 : 0,\r\n              position: \"relative\",\r\n            }}\r\n          >\r\n            <span aria-hidden=\"true\" style={{ ...dotBaseStyle, ...stateStyle(st) }}>\r\n              {st === \"complete\" ? <CheckIcon fontSize=\"inherit\" /> : i + 1}\r\n            </span>\r\n            {/* WCAG 1.4.1 - convey state in text, not only colour. */}\r\n            <span className=\"pui-sr-only\">{L.state[st]}</span>\r\n            <div style={{ flex: 1 }}>\r\n              <Box\r\n                component={titleAs}\r\n                sx={{\r\n                  margin: 0,\r\n                  fontSize: \"var(--text-sm)\",\r\n                  fontWeight: \"var(--fw-semibold)\",\r\n                  color: \"var(--fg)\",\r\n                  lineHeight: \"var(--lh-snug)\",\r\n                }}\r\n              >\r\n                {it.title}\r\n              </Box>\r\n              {(it.timestamp != null || it.actor != null) && (\r\n                <p\r\n                  style={{\r\n                    margin: \"2px 0 0\",\r\n                    fontSize: \"var(--text-xs)\",\r\n                    color: \"var(--fg-subtle)\",\r\n                  }}\r\n                >\r\n                  {it.timestamp != null ? it.timestamp : null}\r\n                  {it.timestamp != null && it.actor != null ? \" · \" : null}\r\n                  {it.actor != null ? (\r\n                    <span style={{ color: \"var(--fg-muted)\", fontWeight: \"var(--fw-medium)\" }}>\r\n                      {it.actor}\r\n                    </span>\r\n                  ) : null}\r\n                </p>\r\n              )}\r\n              {it.meta != null && it.meta !== \"\" && (\r\n                <p\r\n                  style={{\r\n                    margin: \"2px 0 0\",\r\n                    fontSize: \"var(--text-xs)\",\r\n                    color: \"var(--fg-subtle)\",\r\n                  }}\r\n                >\r\n                  {it.meta}\r\n                </p>\r\n              )}\r\n            </div>\r\n            {i < normalisedItems.length - 1 && (\r\n              <span\r\n                aria-hidden=\"true\"\r\n                style={{\r\n                  position: \"absolute\",\r\n                  left: 11, top: 26, bottom: 0,\r\n                  width: 2,\r\n                  background: \"var(--border)\",\r\n                }}\r\n              />\r\n            )}\r\n          </li>\r\n        );\r\n      })}\r\n    </ol>\r\n  );\r\n}\r\n\r\nexport default HStepper;\r\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/v2/components/Surface.js

@@ -1,18 +1,3 @@
-function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
-var _excluded = ["component", "tone", "elevation", "radius", "padding", "clip", "sx", "children"];
-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 _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
-function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread 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 _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
-function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
-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 _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; }
 import * as React from "react";
 import Box from "@mui/material/Box";
 
@@ -85,46 +70,41 @@ import Box from "@mui/material/Box";
  *                 full-width hero whose padding must shrink on a phone.
  */
 import { jsx as _jsx } from "react/jsx-runtime";
-var TONE = {
+const TONE = {
   surface: "var(--surface)",
   subtle: "var(--bg-subtle)"
 };
-var ELEVATION = {
+const ELEVATION = {
   none: "none",
   xs: "var(--shadow-xs)",
   sm: "var(--shadow-sm)"
 };
-var RADIUS = {
+const RADIUS = {
   md: "var(--r-md)",
   lg: "var(--r-lg)"
 };
-var PADDING = {
+const PADDING = {
   none: "0",
   compact: "var(--s-3) var(--s-4)",
-  "default": "var(--s-5)",
+  default: "var(--s-5)",
   responsive: {
     xs: "var(--s-4)",
     sm: "var(--s-5)",
     lg: "var(--s-6)"
   }
 };
-function Surface(_ref) {
-  var _ref$component = _ref.component,
-    component = _ref$component === void 0 ? "div" : _ref$component,
-    _ref$tone = _ref.tone,
-    tone = _ref$tone === void 0 ? "surface" : _ref$tone,
-    _ref$elevation = _ref.elevation,
-    elevation = _ref$elevation === void 0 ? "none" : _ref$elevation,
-    _ref$radius = _ref.radius,
-    radius = _ref$radius === void 0 ? "lg" : _ref$radius,
-    _ref$padding = _ref.padding,
-    padding = _ref$padding === void 0 ? "default" : _ref$padding,
-    _ref$clip = _ref.clip,
-    clip = _ref$clip === void 0 ? false : _ref$clip,
-    sx = _ref.sx,
-    children = _ref.children,
-    rest = _objectWithoutProperties(_ref, _excluded);
-  return /*#__PURE__*/_jsx(Box, _objectSpread(_objectSpread({
+function Surface({
+  component = "div",
+  tone = "surface",
+  elevation = "none",
+  radius = "lg",
+  padding = "default",
+  clip = false,
+  sx,
+  children,
+  ...rest
+}) {
+  return /*#__PURE__*/_jsx(Box, {
     component: component
     /*
      * ARRAY form, not an object spread (gap G-23). `SxProps<Theme>` admits an
@@ -138,7 +118,7 @@ function Surface(_ref) {
      * `KPICard` already did this correctly; 33 other components in this library
      * still spread. I wrote three of those before noticing, including this file.
      */,
-    sx: [_objectSpread({
+    sx: [{
       background: TONE[tone],
       border: "1px solid var(--border)",
       borderRadius: RADIUS[radius],
@@ -147,13 +127,14 @@ function Surface(_ref) {
       // Guards a card whose child is a wide table or a long unbroken string:
       // without it the flex/grid parent refuses to shrink and the page gains a
       // horizontal scrollbar (WCAG 1.4.10 Reflow).
-      minWidth: 0
-    }, clip ? {
-      overflow: "hidden"
-    } : null)].concat(_toConsumableArray(Array.isArray(sx) ? sx : sx ? [sx] : []))
-  }, rest), {}, {
+      minWidth: 0,
+      ...(clip ? {
+        overflow: "hidden"
+      } : null)
+    }, ...(Array.isArray(sx) ? sx : sx ? [sx] : [])],
+    ...rest,
     children: children
-  }));
+  });
 }
 export default Surface;
 //# sourceMappingURL=Surface.js.map

package/dist/esm/v2/components/Surface.js.map

@@ -1 +1 @@
-{"version":3,"file":"Surface.js","names":["React","Box","jsx","_jsx","TONE","surface","subtle","ELEVATION","none","xs","sm","RADIUS","md","lg","PADDING","compact","responsive","Surface","_ref","_ref$component","component","_ref$tone","tone","_ref$elevation","elevation","_ref$radius","radius","_ref$padding","padding","_ref$clip","clip","sx","children","rest","_objectWithoutProperties","_excluded","_objectSpread","background","border","borderRadius","boxShadow","minWidth","overflow","concat","_toConsumableArray","Array","isArray"],"sources":["../../../../src/lib/v2/components/Surface.tsx"],"sourcesContent":["import * as React from \"react\";\r\nimport Box from \"@mui/material/Box\";\r\nimport type { SxProps, Theme } from \"@mui/material/styles\";\r\n\r\n/**\r\n * Surface — Portnet UI v2\r\n *\r\n * The bare card container. Charter §02.4 assigns `-r-lg` to « Cards, datagrid »\r\n * and §02.5 assigns `--shadow-xs` to « Inputs, KPI cards » / `--shadow-sm` to\r\n * « Default cards » — so the charter defines a card, in tokens, precisely.\r\n *\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n * WHY THIS BELONGS IN THE LIBRARY (capability gap G-10)\r\n *\r\n * The card recipe existed in the library, but only WELDED INSIDE `FormSection`,\r\n * which also imposes a numbered heading, a description slot and an inner\r\n * `FormGrid`. A consumer needing just the container — a DataGrid shell, a hero\r\n * card, a sticky side rail, a nested file row — could not reach it and wrote the\r\n * four-line recipe again. In addpe-fe alone: `DATAGRID_CARD_SX`, `HERO_CARD_SX`,\r\n * `LIFECYCLE_CARD_SX`, and a document-card block repeated in three files.\r\n *\r\n * That is the failure mode a design system exists to prevent, and it is worse\r\n * than plain duplication: each copy picked its own elevation and its own radius\r\n * from memory, so cards that should be visually identical drifted apart within a\r\n * single page — and a charter change to `--shadow-sm` or `-r-lg` would have to\r\n * be chased across every module by hand.\r\n *\r\n * The variant axes below are DERIVED from those observed copies, not invented:\r\n * each one is a difference that really existed between two of them.\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n *\r\n *   // DataGrid shell — the grid owns its own padding, and `clip` makes the\r\n *   // rounded corner cut the table's first/last row borders.\r\n *   <Surface padding=\"none\" elevation=\"xs\" clip>\r\n *     <DataGrid … />\r\n *   </Surface>\r\n *\r\n *   // Detail hero — responsive padding ladder, default card elevation.\r\n *   <Surface padding=\"responsive\" elevation=\"sm\">…</Surface>\r\n *\r\n *   // Nested inset block (attached file, document row) — subtle tone, the\r\n *   // smaller radius the charter assigns to inner blocks.\r\n *   <Surface tone=\"subtle\" radius=\"md\" padding=\"compact\">…</Surface>\r\n *\r\n * Composition, not configuration: `Surface` deliberately has NO title, NO\r\n * actions and NO header. A titled section is `FormSection`; a metric tile is\r\n * `KPICard`; an attached file is `FileCard`. Those compose this. If you find\r\n * yourself wanting a `title` prop here, you want one of them instead.\r\n */\r\n\r\n/** Background token. `subtle` is for a block INSET INTO an existing surface. */\r\nexport type SurfaceTone = \"surface\" | \"subtle\";\r\n\r\n/**\r\n * Elevation, restricted to the two card levels of Charter §02.5.\r\n * `md` / `lg` are reserved for popovers and modals and are not offered here —\r\n * a card that needs them is a `Modal` or a `Drawer`.\r\n */\r\nexport type SurfaceElevation = \"none\" | \"xs\" | \"sm\";\r\n\r\n/**\r\n * Corner radius. `lg` = a card (charter §02.4 « Cards, datagrid »); `md` = a\r\n * block nested inside another surface, which reads wrong at the card radius.\r\n */\r\nexport type SurfaceRadius = \"md\" | \"lg\";\r\n\r\n/**\r\n * Inner padding.\r\n *   none        — the child owns it (DataGrid, a nested grid, a table).\r\n *   compact     — a single-row block. Asymmetric on purpose: a one-line row\r\n *                 needs more horizontal than vertical breathing space.\r\n *   default     — charter §2.3 « Padding card body » (--s-5).\r\n *   responsive  — the page-level ladder, aligned with `PageContent`'s, for a\r\n *                 full-width hero whose padding must shrink on a phone.\r\n */\r\nexport type SurfacePadding = \"none\" | \"compact\" | \"default\" | \"responsive\";\r\n\r\nconst TONE: Record<SurfaceTone, string> = {\r\n  surface: \"var(--surface)\",\r\n  subtle: \"var(--bg-subtle)\",\r\n};\r\n\r\nconst ELEVATION: Record<SurfaceElevation, string> = {\r\n  none: \"none\",\r\n  xs: \"var(--shadow-xs)\",\r\n  sm: \"var(--shadow-sm)\",\r\n};\r\n\r\nconst RADIUS: Record<SurfaceRadius, string> = {\r\n  md: \"var(--r-md)\",\r\n  lg: \"var(--r-lg)\",\r\n};\r\n\r\ntype PaddingValue = string | Record<string, string>;\r\n\r\nconst PADDING: Record<SurfacePadding, PaddingValue> = {\r\n  none: \"0\",\r\n  compact: \"var(--s-3) var(--s-4)\",\r\n  default: \"var(--s-5)\",\r\n  responsive: { xs: \"var(--s-4)\", sm: \"var(--s-5)\", lg: \"var(--s-6)\" },\r\n};\r\n\r\nexport interface SurfaceProps\r\n  extends Omit<React.HTMLAttributes<HTMLElement>, \"color\"> {\r\n  /** Rendered element. @default \"div\" */\r\n  component?: React.ElementType | undefined;\r\n  /** @default \"surface\" */\r\n  tone?: SurfaceTone | undefined;\r\n  /** @default \"none\" */\r\n  elevation?: SurfaceElevation | undefined;\r\n  /** @default \"lg\" */\r\n  radius?: SurfaceRadius | undefined;\r\n  /** @default \"default\" */\r\n  padding?: SurfacePadding | undefined;\r\n  /**\r\n   * `overflow: hidden`, so the rounded corner CLIPS a child that draws its own\r\n   * edges — a DataGrid's sticky header and row borders, most commonly. Without\r\n   * it the table's square corners poke through the card's radius.\r\n   * @default false\r\n   */\r\n  clip?: boolean | undefined;\r\n  sx?: SxProps<Theme> | undefined;\r\n  children?: React.ReactNode | undefined;\r\n}\r\n\r\nfunction Surface({\r\n  component = \"div\",\r\n  tone = \"surface\",\r\n  elevation = \"none\",\r\n  radius = \"lg\",\r\n  padding = \"default\",\r\n  clip = false,\r\n  sx,\r\n  children,\r\n  ...rest\r\n}: SurfaceProps) {\r\n  return (\r\n    <Box\r\n      component={component}\r\n      /*\r\n       * ARRAY form, not an object spread (gap G-23). `SxProps<Theme>` admits an\r\n       * object, an ARRAY or a FUNCTION, and spreading the last two destroys them\r\n       * silently: `{...[a, b]}` yields `{0: a, 1: b}` and `{...fn}` yields `{}`.\r\n       * So a host using MUI's own standard idiom —\r\n       * `sx={[base, condition && override]}` — would lose every style, with no\r\n       * error. The array form is what MUI documents for composition, and it\r\n       * handles all three shapes plus null/undefined (falsy entries are ignored).\r\n       *\r\n       * `KPICard` already did this correctly; 33 other components in this library\r\n       * still spread. I wrote three of those before noticing, including this file.\r\n       */\r\n      sx={[\r\n        {\r\n          background: TONE[tone],\r\n          border: \"1px solid var(--border)\",\r\n          borderRadius: RADIUS[radius],\r\n          boxShadow: ELEVATION[elevation],\r\n          padding: PADDING[padding],\r\n          // Guards a card whose child is a wide table or a long unbroken string:\r\n          // without it the flex/grid parent refuses to shrink and the page gains a\r\n          // horizontal scrollbar (WCAG 1.4.10 Reflow).\r\n          minWidth: 0,\r\n          ...(clip ? { overflow: \"hidden\" } : null),\r\n        },\r\n        ...(Array.isArray(sx) ? sx : sx ? [sx] : []),\r\n      ]}\r\n      {...rest}\r\n    >\r\n      {children}\r\n    </Box>\r\n  );\r\n}\r\n\r\nexport default Surface;\r\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"Surface.js","names":["React","Box","jsx","_jsx","TONE","surface","subtle","ELEVATION","none","xs","sm","RADIUS","md","lg","PADDING","compact","default","responsive","Surface","component","tone","elevation","radius","padding","clip","sx","children","rest","background","border","borderRadius","boxShadow","minWidth","overflow","Array","isArray"],"sources":["../../../../src/lib/v2/components/Surface.tsx"],"sourcesContent":["import * as React from \"react\";\r\nimport Box from \"@mui/material/Box\";\r\nimport type { SxProps, Theme } from \"@mui/material/styles\";\r\n\r\n/**\r\n * Surface — Portnet UI v2\r\n *\r\n * The bare card container. Charter §02.4 assigns `-r-lg` to « Cards, datagrid »\r\n * and §02.5 assigns `--shadow-xs` to « Inputs, KPI cards » / `--shadow-sm` to\r\n * « Default cards » — so the charter defines a card, in tokens, precisely.\r\n *\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n * WHY THIS BELONGS IN THE LIBRARY (capability gap G-10)\r\n *\r\n * The card recipe existed in the library, but only WELDED INSIDE `FormSection`,\r\n * which also imposes a numbered heading, a description slot and an inner\r\n * `FormGrid`. A consumer needing just the container — a DataGrid shell, a hero\r\n * card, a sticky side rail, a nested file row — could not reach it and wrote the\r\n * four-line recipe again. In addpe-fe alone: `DATAGRID_CARD_SX`, `HERO_CARD_SX`,\r\n * `LIFECYCLE_CARD_SX`, and a document-card block repeated in three files.\r\n *\r\n * That is the failure mode a design system exists to prevent, and it is worse\r\n * than plain duplication: each copy picked its own elevation and its own radius\r\n * from memory, so cards that should be visually identical drifted apart within a\r\n * single page — and a charter change to `--shadow-sm` or `-r-lg` would have to\r\n * be chased across every module by hand.\r\n *\r\n * The variant axes below are DERIVED from those observed copies, not invented:\r\n * each one is a difference that really existed between two of them.\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n *\r\n *   // DataGrid shell — the grid owns its own padding, and `clip` makes the\r\n *   // rounded corner cut the table's first/last row borders.\r\n *   <Surface padding=\"none\" elevation=\"xs\" clip>\r\n *     <DataGrid … />\r\n *   </Surface>\r\n *\r\n *   // Detail hero — responsive padding ladder, default card elevation.\r\n *   <Surface padding=\"responsive\" elevation=\"sm\">…</Surface>\r\n *\r\n *   // Nested inset block (attached file, document row) — subtle tone, the\r\n *   // smaller radius the charter assigns to inner blocks.\r\n *   <Surface tone=\"subtle\" radius=\"md\" padding=\"compact\">…</Surface>\r\n *\r\n * Composition, not configuration: `Surface` deliberately has NO title, NO\r\n * actions and NO header. A titled section is `FormSection`; a metric tile is\r\n * `KPICard`; an attached file is `FileCard`. Those compose this. If you find\r\n * yourself wanting a `title` prop here, you want one of them instead.\r\n */\r\n\r\n/** Background token. `subtle` is for a block INSET INTO an existing surface. */\r\nexport type SurfaceTone = \"surface\" | \"subtle\";\r\n\r\n/**\r\n * Elevation, restricted to the two card levels of Charter §02.5.\r\n * `md` / `lg` are reserved for popovers and modals and are not offered here —\r\n * a card that needs them is a `Modal` or a `Drawer`.\r\n */\r\nexport type SurfaceElevation = \"none\" | \"xs\" | \"sm\";\r\n\r\n/**\r\n * Corner radius. `lg` = a card (charter §02.4 « Cards, datagrid »); `md` = a\r\n * block nested inside another surface, which reads wrong at the card radius.\r\n */\r\nexport type SurfaceRadius = \"md\" | \"lg\";\r\n\r\n/**\r\n * Inner padding.\r\n *   none        — the child owns it (DataGrid, a nested grid, a table).\r\n *   compact     — a single-row block. Asymmetric on purpose: a one-line row\r\n *                 needs more horizontal than vertical breathing space.\r\n *   default     — charter §2.3 « Padding card body » (--s-5).\r\n *   responsive  — the page-level ladder, aligned with `PageContent`'s, for a\r\n *                 full-width hero whose padding must shrink on a phone.\r\n */\r\nexport type SurfacePadding = \"none\" | \"compact\" | \"default\" | \"responsive\";\r\n\r\nconst TONE: Record<SurfaceTone, string> = {\r\n  surface: \"var(--surface)\",\r\n  subtle: \"var(--bg-subtle)\",\r\n};\r\n\r\nconst ELEVATION: Record<SurfaceElevation, string> = {\r\n  none: \"none\",\r\n  xs: \"var(--shadow-xs)\",\r\n  sm: \"var(--shadow-sm)\",\r\n};\r\n\r\nconst RADIUS: Record<SurfaceRadius, string> = {\r\n  md: \"var(--r-md)\",\r\n  lg: \"var(--r-lg)\",\r\n};\r\n\r\ntype PaddingValue = string | Record<string, string>;\r\n\r\nconst PADDING: Record<SurfacePadding, PaddingValue> = {\r\n  none: \"0\",\r\n  compact: \"var(--s-3) var(--s-4)\",\r\n  default: \"var(--s-5)\",\r\n  responsive: { xs: \"var(--s-4)\", sm: \"var(--s-5)\", lg: \"var(--s-6)\" },\r\n};\r\n\r\nexport interface SurfaceProps\r\n  extends Omit<React.HTMLAttributes<HTMLElement>, \"color\"> {\r\n  /** Rendered element. @default \"div\" */\r\n  component?: React.ElementType | undefined;\r\n  /** @default \"surface\" */\r\n  tone?: SurfaceTone | undefined;\r\n  /** @default \"none\" */\r\n  elevation?: SurfaceElevation | undefined;\r\n  /** @default \"lg\" */\r\n  radius?: SurfaceRadius | undefined;\r\n  /** @default \"default\" */\r\n  padding?: SurfacePadding | undefined;\r\n  /**\r\n   * `overflow: hidden`, so the rounded corner CLIPS a child that draws its own\r\n   * edges — a DataGrid's sticky header and row borders, most commonly. Without\r\n   * it the table's square corners poke through the card's radius.\r\n   * @default false\r\n   */\r\n  clip?: boolean | undefined;\r\n  sx?: SxProps<Theme> | undefined;\r\n  children?: React.ReactNode | undefined;\r\n}\r\n\r\nfunction Surface({\r\n  component = \"div\",\r\n  tone = \"surface\",\r\n  elevation = \"none\",\r\n  radius = \"lg\",\r\n  padding = \"default\",\r\n  clip = false,\r\n  sx,\r\n  children,\r\n  ...rest\r\n}: SurfaceProps) {\r\n  return (\r\n    <Box\r\n      component={component}\r\n      /*\r\n       * ARRAY form, not an object spread (gap G-23). `SxProps<Theme>` admits an\r\n       * object, an ARRAY or a FUNCTION, and spreading the last two destroys them\r\n       * silently: `{...[a, b]}` yields `{0: a, 1: b}` and `{...fn}` yields `{}`.\r\n       * So a host using MUI's own standard idiom —\r\n       * `sx={[base, condition && override]}` — would lose every style, with no\r\n       * error. The array form is what MUI documents for composition, and it\r\n       * handles all three shapes plus null/undefined (falsy entries are ignored).\r\n       *\r\n       * `KPICard` already did this correctly; 33 other components in this library\r\n       * still spread. I wrote three of those before noticing, including this file.\r\n       */\r\n      sx={[\r\n        {\r\n          background: TONE[tone],\r\n          border: \"1px solid var(--border)\",\r\n          borderRadius: RADIUS[radius],\r\n          boxShadow: ELEVATION[elevation],\r\n          padding: PADDING[padding],\r\n          // Guards a card whose child is a wide table or a long unbroken string:\r\n          // without it the flex/grid parent refuses to shrink and the page gains a\r\n          // horizontal scrollbar (WCAG 1.4.10 Reflow).\r\n          minWidth: 0,\r\n          ...(clip ? { overflow: \"hidden\" } : null),\r\n        },\r\n        ...(Array.isArray(sx) ? sx : sx ? [sx] : []),\r\n      ]}\r\n      {...rest}\r\n    >\r\n      {children}\r\n    </Box>\r\n  );\r\n}\r\n\r\nexport default Surface;\r\n"],"mappings":"AAAA,OAAO,KAAKA,KAAK,MAAM,OAAO;AAC9B,OAAOC,GAAG,MAAM,mBAAmB;;AAGnC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;;AAGA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AARA,SAAAC,GAAA,IAAAC,IAAA;AAWA,MAAMC,IAAiC,GAAG;EACxCC,OAAO,EAAE,gBAAgB;EACzBC,MAAM,EAAE;AACV,CAAC;AAED,MAAMC,SAA2C,GAAG;EAClDC,IAAI,EAAE,MAAM;EACZC,EAAE,EAAE,kBAAkB;EACtBC,EAAE,EAAE;AACN,CAAC;AAED,MAAMC,MAAqC,GAAG;EAC5CC,EAAE,EAAE,aAAa;EACjBC,EAAE,EAAE;AACN,CAAC;AAID,MAAMC,OAA6C,GAAG;EACpDN,IAAI,EAAE,GAAG;EACTO,OAAO,EAAE,uBAAuB;EAChCC,OAAO,EAAE,YAAY;EACrBC,UAAU,EAAE;IAAER,EAAE,EAAE,YAAY;IAAEC,EAAE,EAAE,YAAY;IAAEG,EAAE,EAAE;EAAa;AACrE,CAAC;AAyBD,SAASK,OAAOA,CAAC;EACfC,SAAS,GAAG,KAAK;EACjBC,IAAI,GAAG,SAAS;EAChBC,SAAS,GAAG,MAAM;EAClBC,MAAM,GAAG,IAAI;EACbC,OAAO,GAAG,SAAS;EACnBC,IAAI,GAAG,KAAK;EACZC,EAAE;EACFC,QAAQ;EACR,GAAGC;AACS,CAAC,EAAE;EACf,oBACExB,IAAA,CAACF,GAAG;IACFkB,SAAS,EAAEA;IACX;AACN;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAXM;IAYAM,EAAE,EAAE,CACF;MACEG,UAAU,EAAExB,IAAI,CAACgB,IAAI,CAAC;MACtBS,MAAM,EAAE,yBAAyB;MACjCC,YAAY,EAAEnB,MAAM,CAACW,MAAM,CAAC;MAC5BS,SAAS,EAAExB,SAAS,CAACc,SAAS,CAAC;MAC/BE,OAAO,EAAET,OAAO,CAACS,OAAO,CAAC;MACzB;MACA;MACA;MACAS,QAAQ,EAAE,CAAC;MACX,IAAIR,IAAI,GAAG;QAAES,QAAQ,EAAE;MAAS,CAAC,GAAG,IAAI;IAC1C,CAAC,EACD,IAAIC,KAAK,CAACC,OAAO,CAACV,EAAE,CAAC,GAAGA,EAAE,GAAGA,EAAE,GAAG,CAACA,EAAE,CAAC,GAAG,EAAE,CAAC,CAC5C;IAAA,GACEE,IAAI;IAAAD,QAAA,EAEPA;EAAQ,CACN,CAAC;AAEV;AAEA,eAAeR,OAAO","ignoreList":[]}