@portnet/ui 5.0.32 → 6.0.1

package/dist/v2/components/Stepper.js

@@ -0,0 +1,441 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.HStepper = HStepper;
+exports.VStepper = VStepper;
+exports["default"] = void 0;
+var React = _interopRequireWildcard(require("react"));
+var _Check = _interopRequireDefault(require("@mui/icons-material/Check"));
+var _Box = _interopRequireDefault(require("@mui/material/Box"));
+var _mergeLabels = require("../utils/mergeLabels");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { "default": obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj["default"] = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+function _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); } /**
+ * Stepper - Portnet UI v2
+ *
+ * Charter §03 · Component "Stepper". Required on flows ≥ 3 steps (R-3.4).
+ *
+ * Two ways to drive HStepper:
+ *
+ *  1. SIMPLE mode — plain labels + `current` index (Charter default):
+ *
+ *       <HStepper
+ *         steps={["Identification", "Marchandise", "Banque", "Validation"]}
+ *         current={1}
+ *         onJump={i => goTo(i)}
+ *       />
+ *
+ *  2. RICH mode — objects carry their own state, including a "disabled"
+ *     state for locked future steps (used by wizards where step N is
+ *     unavailable until step N-1 has been submitted):
+ *
+ *       <HStepper
+ *         steps={[
+ *           { id: "importateur", label: "Importateur",  status: "completed" },
+ *           { id: "donneesTI",   label: "Données",      status: "current"   },
+ *           { id: "marchandises",label: "Marchandises", status: "disabled"  },
+ *           { id: "revision",    label: "Révision",     status: "pending"   },
+ *         ]}
+ *         onStepClick={i => goTo(i)}
+ *         ariaLabel="Étapes de création du titre"
+ *       />
+ *
+ *     status values: "current" | "active" | "completed" | "complete" |
+ *                    "pending" | "disabled"
+ *     ("current"/"active" and "completed"/"complete" are accepted as
+ *     synonyms to ease migration from host modules.)
+ *
+ *  VStepper — vertical history/progression timeline. Each item may carry
+ *  `timestamp` (date/time of the action) and `actor` (the user who did it);
+ *  they render as a muted "timestamp · actor" line under the title. `meta`
+ *  still works for free-form text (e.g. "En cours" on the active step):
+ *
+ *    <VStepper items={[
+ *       { status: "completed", title: "Titre d'importation créé",
+ *         timestamp: "27/03/2025 09:48", actor: "dsmoimp" },
+ *       { status: "completed", title: "Soumis à la banque (CITIBANK)",
+ *         timestamp: "27/03/2025 10:16", actor: "Transit Jebli" },
+ *       { status: "active",    title: "En attente de réponse banque", meta: "En cours" },
+ *    ]} />
+ *
+ * Localisation (FR / EN / AR):
+ *   <HStepper labels={{
+ *     nav:  "Form steps",
+ *     item: (n, label, state) =>
+ *       `Step ${n}: ${label} (${
+ *         state === "complete" ? "completed" :
+ *         state === "active"   ? "in progress" : "upcoming"
+ *       })`,
+ *   }} />
+ *
+ *   <VStepper labels={{
+ *     nav:   "Step history",
+ *     state: { complete: "Completed step.", active: "Current step.", pending: "Upcoming step." },
+ *   }} />
+ *
+ * A11y note (R-Ar.1):
+ *   Clickable HStepper steps render as real <button> elements.
+ *   VStepper's per-item title element is host-configurable via
+ *   `titleAs` so the page heading hierarchy stays consistent.
+ */
+var 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);
+  }
+});
+var DEFAULT_V_LABELS = Object.freeze({
+  nav: "Historique des étapes",
+  state: Object.freeze({
+    complete: "Étape complétée. ",
+    active: "Étape en cours. ",
+    pending: "Étape à venir. ",
+    /* WCAG 1.4.1 — the fourth state was MISSING. VStepper accepts the same rich
+     * item shape as HStepper (see normalisedItems below: "so host modules can pass
+     * the same array to both steppers"), and HStepper documents
+     * `status: "disabled"` for wizard steps locked until the previous one is
+     * submitted. So a disabled step could reach VStepper and render an EMPTY
+     * sr-only span — its state conveyed by colour alone, which is precisely what
+     * the comment on that span forbids. No host had to do anything wrong. */
+    disabled: "Étape verrouillée. "
+  })
+});
+var dotBaseStyle = {
+  width: 24,
+  height: 24,
+  borderRadius: "50%",
+  display: "grid",
+  placeItems: "center",
+  fontSize: "var(--text-xs)",
+  fontWeight: "var(--fw-semibold)",
+  flex: "0 0 auto",
+  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) {
+  if (state === "complete") {
+    return {
+      background: "var(--accent)",
+      borderColor: "var(--accent)",
+      color: "var(--accent-fg)"
+    };
+  }
+  if (state === "active") {
+    return {
+      background: "var(--surface)",
+      borderColor: "var(--accent)",
+      color: "var(--accent)"
+    };
+  }
+  if (state === "disabled") {
+    return {
+      background: "var(--bg-subtle)",
+      borderColor: "var(--border)",
+      color: "var(--fg-subtle)"
+    };
+  }
+  return {
+    background: "var(--surface)",
+    borderColor: "var(--border-strong)",
+    color: "var(--fg-subtle)"
+  };
+};
+// 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;
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
+      style: _objectSpread(_objectSpread({}, dotBaseStyle), stateStyle(state)),
+      children: state === "complete" ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_Check["default"], {
+        fontSize: "inherit"
+      }) : index + 1
+    }), /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
+      style: {
+        fontSize: "var(--text-sm)",
+        // Was 650 (non-standard, banned by Batch 1 typography tokens).
+        // var(--fw-semibold) (600) is the canonical "emphasised" weight.
+        fontWeight: state === "active" ? "var(--fw-semibold)" : "var(--fw-medium)",
+        color: state === "pending" ? "var(--fg-subtle)" : state === "disabled" ? "var(--fg-muted)" : "var(--fg)",
+        whiteSpace: "nowrap"
+      },
+      children: label
+    })]
+  });
+}
+var stepBoxSx = {
+  display: "flex",
+  alignItems: "center",
+  gap: 1,
+  padding: "var(--s-1) calc(var(--s-1) + 2px)",
+  borderRadius: "var(--r-md)",
+  // Reset native <button> styling to match the previous Box look.
+  background: "transparent",
+  border: 0,
+  font: "inherit",
+  textAlign: "left",
+  "&:focus-visible": {
+    outline: "2px solid var(--accent)",
+    outlineOffset: "var(--pui-outline-offset)"
+  }
+};
+
+/* Detect whether the `steps` array carries plain labels (legacy)
+ * or rich {id, label, status} objects. ReactElements (icons,
+ * fragments) and strings are treated as plain labels.
+ * Plain boolean predicate (not a type guard): the rich object shape
+ * 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);
+}
+function normaliseStatusToState(status) {
+  if (status === "current" || status === "active") return "active";
+  if (status === "completed" || status === "complete") return "complete";
+  if (status === "disabled") return "disabled";
+  return "pending";
+}
+
+/* Convert rich steps to the legacy { label, state, clickable, key }
+ * shape consumed by the rendering loop. */
+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 {
+        key: (_rich$id = rich.id) !== null && _rich$id !== void 0 ? _rich$id : i,
+        label: rich.label,
+        state: state,
+        // Disabled steps are never clickable. Other rich states
+        // remain clickable so the host can offer free navigation.
+        clickable: state !== "disabled"
+      };
+    });
+  }
+  // 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
+    };
+  });
+}
+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 = (0, _mergeLabels.mergeLabels)(DEFAULT_H_LABELS, labels);
+  var navLabel = ariaLabel || L.nav;
+  var jumpHandler = onJump || onStepClick;
+  var normalised = normaliseSteps(steps, current);
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)("nav", {
+    "aria-label": navLabel,
+    style: {
+      display: "flex",
+      alignItems: "center",
+      gap: 8,
+      padding: "12px 0",
+      overflowX: "auto"
+    },
+    children: normalised.map(function (step, i) {
+      var a11yLabel = L.item(i + 1, step.label, step.state);
+      return /*#__PURE__*/(0, _jsxRuntime.jsxs)(React.Fragment, {
+        children: [step.clickable ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_Box["default"], {
+          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), {}, {
+            cursor: "pointer"
+          }),
+          children: /*#__PURE__*/(0, _jsxRuntime.jsx)(StepInner, {
+            index: i,
+            label: step.label,
+            state: step.state
+          })
+        }) : /*#__PURE__*/(0, _jsxRuntime.jsx)(_Box["default"], {
+          component: "span",
+          "aria-label": a11yLabel,
+          "aria-disabled": step.state === "disabled" ? "true" : undefined,
+          sx: _objectSpread(_objectSpread({}, stepBoxSx), {}, {
+            cursor: "default"
+          }),
+          children: /*#__PURE__*/(0, _jsxRuntime.jsx)(StepInner, {
+            index: i,
+            label: step.label,
+            state: step.state
+          })
+        }), i < normalised.length - 1 && /*#__PURE__*/(0, _jsxRuntime.jsx)(_Box["default"], {
+          "aria-hidden": "true",
+          sx: {
+            flex: 1,
+            minWidth: 24,
+            height: 2,
+            background: step.state === "complete" ? "var(--accent)" : "var(--border)",
+            borderRadius: 1
+          }
+        })]
+      }, step.key);
+    })
+  });
+}
+/**
+ * VStepper - vertical historical / progression stepper.
+ *
+ * @param items     - list of { state|status, title, meta?, timestamp?, actor? }.
+ *                    `timestamp` (date/time) + `actor` (user) render as a
+ *                    muted "timestamp · actor" line under the title; `meta`
+ *                    renders on its own line (free-form, e.g. "En cours").
+ * @param titleAs   - element used for each step title. Defaults to "h4".
+ *                    Hosts whose outline already used h2/h3 above the
+ *                    stepper should pick the next level (e.g. titleAs="h3"
+ *                    after an h2 ActionBar title). Pass "div"/"span" to
+ *                    opt out of heading semantics entirely.
+ * @param labels    - i18n overrides; see file header.
+ */
+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;
+  /*
+   * Nested-dictionary merge, both levels through the shared undefined-safe helper
+   * (gap G-24, fourth instance after Dropzone.reasons and DataGridLabels.
+   * pagination).
+   *
+   * The previous form spread `...labels` at the top level, so an explicitly-passed
+   * `undefined` on `nav` DELETED the default and left the <ol> without an
+   * accessible name (R-Ar.5). And the inner `|| {}` guarded the `state` sub-object
+   * against being undefined without guarding its VALUES — so
+   * `state: { complete: undefined }` emptied the sr-only span below and reduced the
+   * step's state to colour alone, defeating the WCAG 1.4.1 rule its own comment
+   * invokes.
+   *
+   * `state` is merged at its OWN level rather than through a recursive deep merge:
+   * two explicit levels can be read, a recursive helper hides how deep it goes.
+   * Same convention as _dataGridShared.
+   */
+  var L = labels ? (0, _mergeLabels.mergeLabels)(DEFAULT_V_LABELS, _objectSpread(_objectSpread({}, labels), {}, {
+    state: (0, _mergeLabels.mergeLabels)(DEFAULT_V_LABELS.state, labels.state)
+  })) : DEFAULT_V_LABELS;
+  var 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) {
+    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,
+        meta: it.meta,
+        timestamp: it.timestamp,
+        actor: it.actor
+      };
+    }
+    return it;
+  });
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)("ol", {
+    style: {
+      listStyle: "none",
+      padding: 0,
+      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";
+      return /*#__PURE__*/(0, _jsxRuntime.jsxs)("li", {
+        "aria-current": st === "active" ? "step" : undefined,
+        style: {
+          display: "flex",
+          gap: 12,
+          paddingBottom: i < normalisedItems.length - 1 ? 16 : 0,
+          position: "relative"
+        },
+        children: [/*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
+          "aria-hidden": "true",
+          style: _objectSpread(_objectSpread({}, dotBaseStyle), stateStyle(st)),
+          children: st === "complete" ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_Check["default"], {
+            fontSize: "inherit"
+          }) : i + 1
+        }), /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
+          className: "pui-sr-only",
+          children: L.state[st]
+        }), /*#__PURE__*/(0, _jsxRuntime.jsxs)("div", {
+          style: {
+            flex: 1
+          },
+          children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_Box["default"], {
+            component: titleAs,
+            sx: {
+              margin: 0,
+              fontSize: "var(--text-sm)",
+              fontWeight: "var(--fw-semibold)",
+              color: "var(--fg)",
+              lineHeight: "var(--lh-snug)"
+            },
+            children: it.title
+          }), (it.timestamp != null || it.actor != null) && /*#__PURE__*/(0, _jsxRuntime.jsxs)("p", {
+            style: {
+              margin: "2px 0 0",
+              fontSize: "var(--text-xs)",
+              color: "var(--fg-subtle)"
+            },
+            children: [it.timestamp != null ? it.timestamp : null, it.timestamp != null && it.actor != null ? " · " : null, it.actor != null ? /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
+              style: {
+                color: "var(--fg-muted)",
+                fontWeight: "var(--fw-medium)"
+              },
+              children: it.actor
+            }) : null]
+          }), it.meta != null && it.meta !== "" && /*#__PURE__*/(0, _jsxRuntime.jsx)("p", {
+            style: {
+              margin: "2px 0 0",
+              fontSize: "var(--text-xs)",
+              color: "var(--fg-subtle)"
+            },
+            children: it.meta
+          })]
+        }), i < normalisedItems.length - 1 && /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
+          "aria-hidden": "true",
+          style: {
+            position: "absolute",
+            left: 11,
+            top: 26,
+            bottom: 0,
+            width: 2,
+            background: "var(--border)"
+          }
+        })]
+      }, i);
+    })
+  });
+}
+var _default = exports["default"] = HStepper;
+//# sourceMappingURL=Stepper.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Stepper.js","names":["React","_interopRequireWildcard","require","_Check","_interopRequireDefault","_Box","_mergeLabels","_jsxRuntime","obj","__esModule","_getRequireWildcardCache","nodeInterop","WeakMap","cacheBabelInterop","cacheNodeInterop","_typeof","cache","has","get","newObj","hasPropertyDescriptor","Object","defineProperty","getOwnPropertyDescriptor","key","prototype","hasOwnProperty","call","desc","set","Symbol","iterator","constructor","ownKeys","object","enumerableOnly","keys","getOwnPropertySymbols","symbols","filter","sym","enumerable","push","apply","_objectSpread","target","i","arguments","length","source","forEach","_defineProperty","getOwnPropertyDescriptors","defineProperties","value","_toPropertyKey","configurable","writable","arg","_toPrimitive","String","input","hint","prim","toPrimitive","undefined","res","TypeError","Number","DEFAULT_H_LABELS","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","jsxs","Fragment","children","jsx","style","whiteSpace","stepBoxSx","alignItems","gap","padding","font","textAlign","outline","outlineOffset","isRichStep","s","Array","isArray","isValidElement","normaliseStatusToState","status","normaliseSteps","steps","current","map","_rich$id","rich","id","clickable","HStepper","_ref2","_ref2$current","onJump","onStepClick","ariaLabel","labels","L","mergeLabels","navLabel","jumpHandler","normalised","overflowX","step","a11yLabel","component","type","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","_default","exports"],"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/v2/components/Surface.d.ts

@@ -0,0 +1,94 @@
+import * as React from "react";
+import type { SxProps, Theme } from "@mui/material/styles";
+/**
+ * Surface — Portnet UI v2
+ *
+ * The bare card container. Charter §02.4 assigns `-r-lg` to « Cards, datagrid »
+ * and §02.5 assigns `--shadow-xs` to « Inputs, KPI cards » / `--shadow-sm` to
+ * « Default cards » — so the charter defines a card, in tokens, precisely.
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * WHY THIS BELONGS IN THE LIBRARY (capability gap G-10)
+ *
+ * The card recipe existed in the library, but only WELDED INSIDE `FormSection`,
+ * which also imposes a numbered heading, a description slot and an inner
+ * `FormGrid`. A consumer needing just the container — a DataGrid shell, a hero
+ * card, a sticky side rail, a nested file row — could not reach it and wrote the
+ * four-line recipe again. In addpe-fe alone: `DATAGRID_CARD_SX`, `HERO_CARD_SX`,
+ * `LIFECYCLE_CARD_SX`, and a document-card block repeated in three files.
+ *
+ * That is the failure mode a design system exists to prevent, and it is worse
+ * than plain duplication: each copy picked its own elevation and its own radius
+ * from memory, so cards that should be visually identical drifted apart within a
+ * single page — and a charter change to `--shadow-sm` or `-r-lg` would have to
+ * be chased across every module by hand.
+ *
+ * The variant axes below are DERIVED from those observed copies, not invented:
+ * each one is a difference that really existed between two of them.
+ * ─────────────────────────────────────────────────────────────────────────────
+ *
+ *   // DataGrid shell — the grid owns its own padding, and `clip` makes the
+ *   // rounded corner cut the table's first/last row borders.
+ *   <Surface padding="none" elevation="xs" clip>
+ *     <DataGrid … />
+ *   </Surface>
+ *
+ *   // Detail hero — responsive padding ladder, default card elevation.
+ *   <Surface padding="responsive" elevation="sm">…</Surface>
+ *
+ *   // Nested inset block (attached file, document row) — subtle tone, the
+ *   // smaller radius the charter assigns to inner blocks.
+ *   <Surface tone="subtle" radius="md" padding="compact">…</Surface>
+ *
+ * Composition, not configuration: `Surface` deliberately has NO title, NO
+ * actions and NO header. A titled section is `FormSection`; a metric tile is
+ * `KPICard`; an attached file is `FileCard`. Those compose this. If you find
+ * yourself wanting a `title` prop here, you want one of them instead.
+ */
+/** Background token. `subtle` is for a block INSET INTO an existing surface. */
+export type SurfaceTone = "surface" | "subtle";
+/**
+ * Elevation, restricted to the two card levels of Charter §02.5.
+ * `md` / `lg` are reserved for popovers and modals and are not offered here —
+ * a card that needs them is a `Modal` or a `Drawer`.
+ */
+export type SurfaceElevation = "none" | "xs" | "sm";
+/**
+ * Corner radius. `lg` = a card (charter §02.4 « Cards, datagrid »); `md` = a
+ * block nested inside another surface, which reads wrong at the card radius.
+ */
+export type SurfaceRadius = "md" | "lg";
+/**
+ * Inner padding.
+ *   none        — the child owns it (DataGrid, a nested grid, a table).
+ *   compact     — a single-row block. Asymmetric on purpose: a one-line row
+ *                 needs more horizontal than vertical breathing space.
+ *   default     — charter §2.3 « Padding card body » (--s-5).
+ *   responsive  — the page-level ladder, aligned with `PageContent`'s, for a
+ *                 full-width hero whose padding must shrink on a phone.
+ */
+export type SurfacePadding = "none" | "compact" | "default" | "responsive";
+export interface SurfaceProps extends Omit<React.HTMLAttributes<HTMLElement>, "color"> {
+    /** Rendered element. @default "div" */
+    component?: React.ElementType | undefined;
+    /** @default "surface" */
+    tone?: SurfaceTone | undefined;
+    /** @default "none" */
+    elevation?: SurfaceElevation | undefined;
+    /** @default "lg" */
+    radius?: SurfaceRadius | undefined;
+    /** @default "default" */
+    padding?: SurfacePadding | undefined;
+    /**
+     * `overflow: hidden`, so the rounded corner CLIPS a child that draws its own
+     * edges — a DataGrid's sticky header and row borders, most commonly. Without
+     * it the table's square corners poke through the card's radius.
+     * @default false
+     */
+    clip?: boolean | undefined;
+    sx?: SxProps<Theme> | undefined;
+    children?: React.ReactNode | undefined;
+}
+declare function Surface({ component, tone, elevation, radius, padding, clip, sx, children, ...rest }: SurfaceProps): React.JSX.Element;
+export default Surface;
+//# sourceMappingURL=Surface.d.ts.map

package/dist/v2/components/Surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Surface.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/components/Surface.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAEH,gFAAgF;AAChF,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE/C;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;AAEpD;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,IAAI,CAAC;AAExC;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,YAAY,CAAC;AA2B3E,MAAM,WAAW,YACf,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IACxD,uCAAuC;IACvC,SAAS,CAAC,EAAE,KAAK,CAAC,WAAW,GAAG,SAAS,CAAC;IAC1C,yBAAyB;IACzB,IAAI,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC/B,sBAAsB;IACtB,SAAS,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACzC,oBAAoB;IACpB,MAAM,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACnC,yBAAyB;IACzB,OAAO,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACrC;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;IAChC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;CACxC;AAED,iBAAS,OAAO,CAAC,EACf,SAAiB,EACjB,IAAgB,EAChB,SAAkB,EAClB,MAAa,EACb,OAAmB,EACnB,IAAY,EACZ,EAAE,EACF,QAAQ,EACR,GAAG,IAAI,EACR,EAAE,YAAY,qBAoCd;AAED,eAAe,OAAO,CAAC"}