@portnet/ui 6.0.0 → 6.0.1

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

@@ -0,0 +1,195 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+function _iterableToArrayLimit(arr, i) { var _i = null == arr ? null : "undefined" != typeof Symbol && arr[Symbol.iterator] || arr["@@iterator"]; if (null != _i) { var _s, _e, _x, _r, _arr = [], _n = !0, _d = !1; try { if (_x = (_i = _i.call(arr)).next, 0 === i) { if (Object(_i) !== _i) return; _n = !1; } else for (; !(_n = (_s = _x.call(_i)).done) && (_arr.push(_s.value), _arr.length !== i); _n = !0) { ; } } catch (err) { _d = !0, _e = err; } finally { try { if (!_n && null != _i["return"] && (_r = _i["return"](), Object(_r) !== _r)) return; } finally { if (_d) throw _e; } } return _arr; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+import * as React from "react";
+import Modal from "../components/Modal";
+import { mergeLabels } from "../utils/mergeLabels";
+
+/* ── Body-only focus guard ────────────────────────────────────────
+ * The "?" key is a printable character. If a user types "?" inside an
+ * Input / Textarea / contentEditable element we must NOT hijack the
+ * keypress to open the help — they're trying to type a question mark.
+ *
+ * BUTTON / A focus is NOT blocking by design: when the user has tabbed
+ * onto an interactive non-text element, hitting "?" makes sense as a
+ * help affordance (navigation mode, not text-entry mode).
+ */
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+function isFocusOnTextEntry() {
+  var el = typeof document !== "undefined" ? document.activeElement : null;
+  if (!el) return false;
+  var tag = el.tagName;
+  if (tag === "INPUT" || tag === "TEXTAREA" || tag === "SELECT") return true;
+  if (el instanceof HTMLElement && el.isContentEditable) return true;
+  return false;
+}
+function ShortcutKey(_ref) {
+  var children = _ref.children;
+  return /*#__PURE__*/_jsx("kbd", {
+    style: {
+      display: "inline-block",
+      minWidth: "1.75em",
+      padding: "0.15em 0.5em",
+      background: "var(--bg-subtle)",
+      border: "1px solid var(--border)",
+      borderBottomColor: "var(--border-strong, var(--border))",
+      borderRadius: "var(--r-sm)",
+      boxShadow: "inset 0 -1px 0 var(--border)",
+      fontFamily: "var(--font-mono, monospace)",
+      fontSize: "var(--text-sm)",
+      textAlign: "center",
+      lineHeight: 1.4,
+      color: "var(--fg)"
+    },
+    children: children
+  });
+}
+var SHORTCUT_ROW_SX = {
+  display: "grid",
+  gridTemplateColumns: "auto 1fr",
+  gap: "var(--s-4)",
+  alignItems: "center",
+  padding: "var(--s-2) 0",
+  borderBottom: "1px solid var(--border-subtle, var(--border))"
+};
+var SHORTCUT_KEYS_SX = {
+  display: "flex",
+  gap: "var(--s-1)",
+  alignItems: "center",
+  flexWrap: "wrap"
+};
+var HELP_FOOTNOTE_SX = {
+  marginTop: "var(--s-4)",
+  paddingTop: "var(--s-3)",
+  borderTop: "1px solid var(--border)",
+  fontSize: "var(--text-xs)",
+  color: "var(--fg-subtle)",
+  lineHeight: 1.5
+};
+var DEFAULT_LABELS = Object.freeze({
+  /* Footnote rendered below the shortcut list. Split into two parts so the
+   * keycap can be embedded in the middle without forcing the i18n string to
+   * carry HTML tags. */
+  footnoteIntro: "Astuce : appuyez sur",
+  footnoteOutro: "à tout moment pour ouvrir ou fermer cette aide. Les raccourcis s'activent uniquement quand votre curseur n'est pas dans un champ de saisie.",
+  /* aria-label on the <dl> listing every shortcut. */
+  listAriaLabel: "Liste des raccourcis clavier disponibles sur cette page",
+  /* Joiner rendered between alternative keys for the same shortcut. */
+  keyJoiner: "ou"
+});
+
+/**
+ * KeyboardShortcutsHelp — Portnet UI v2
+ *
+ * Charter §5.2 SHOULD — discoverable help overlay for page-level keyboard
+ * shortcuts. Listens globally for "?" and opens a v2.Modal listing every
+ * shortcut as <kbd> elements (WCAG 1.3.1 semantic).
+ *
+ * Self-contained: the host page only declares the shortcuts array and renders
+ * <KeyboardShortcutsHelp shortcuts={…} /> once.
+ *
+ * Localisation (FR / EN / AR):
+ *   <KeyboardShortcutsHelp
+ *     title="Keyboard shortcuts"
+ *     labels={{
+ *       footnoteIntro: "Tip: press",
+ *       footnoteOutro: "anytime to toggle this help…",
+ *       listAriaLabel: "List of keyboard shortcuts available on this page",
+ *       keyJoiner:     "or",
+ *     }}
+ *     shortcuts={…}
+ *   />
+ *
+ * Charter §5.2 SHOULD + WCAG 1.3.1 (semantic <kbd>) + 2.1.1 (keyboard
+ * reachable) + R-M.* (modal focus trap inherited from v2.Modal).
+ */
+
+function KeyboardShortcutsHelp(_ref2) {
+  var _ref2$shortcuts = _ref2.shortcuts,
+    shortcuts = _ref2$shortcuts === void 0 ? [] : _ref2$shortcuts,
+    _ref2$title = _ref2.title,
+    title = _ref2$title === void 0 ? "Raccourcis clavier" : _ref2$title,
+    labels = _ref2.labels;
+  var _React$useState = React.useState(false),
+    _React$useState2 = _slicedToArray(_React$useState, 2),
+    isOpen = _React$useState2[0],
+    setIsOpen = _React$useState2[1];
+  var L = mergeLabels(DEFAULT_LABELS, labels);
+  React.useEffect(function () {
+    var handler = function handler(event) {
+      // Only react to "?" (Shift+/ on US, AltGr+, on many AZERTY layouts).
+      // event.key gives us the resolved character regardless of physical key.
+      if (event.key !== "?") return;
+
+      // Modifier keys (Ctrl, Meta, Alt) reserved for browser / OS shortcuts.
+      if (event.ctrlKey || event.metaKey || event.altKey) return;
+
+      // User is typing in a text field — let "?" through.
+      if (isFocusOnTextEntry()) return;
+      event.preventDefault();
+      setIsOpen(function (prev) {
+        return !prev;
+      });
+    };
+    window.addEventListener("keydown", handler);
+    return function () {
+      return window.removeEventListener("keydown", handler);
+    };
+  }, []);
+  if (!Array.isArray(shortcuts) || shortcuts.length === 0) {
+    return null;
+  }
+  return /*#__PURE__*/_jsxs(Modal, {
+    open: isOpen,
+    title: title,
+    onClose: function onClose() {
+      return setIsOpen(false);
+    },
+    size: "md",
+    children: [/*#__PURE__*/_jsx("dl", {
+      style: {
+        margin: 0,
+        padding: 0
+      },
+      "aria-label": L.listAriaLabel,
+      children: shortcuts.map(function (sc, i) {
+        return /*#__PURE__*/_jsxs("div", {
+          style: SHORTCUT_ROW_SX,
+          children: [/*#__PURE__*/_jsx("dt", {
+            style: SHORTCUT_KEYS_SX,
+            children: sc.keys.map(function (k, j) {
+              return /*#__PURE__*/_jsxs(React.Fragment, {
+                children: [/*#__PURE__*/_jsx(ShortcutKey, {
+                  children: k
+                }), j < sc.keys.length - 1 && /*#__PURE__*/_jsx("span", {
+                  "aria-hidden": "true",
+                  style: {
+                    color: "var(--fg-subtle)",
+                    fontSize: "var(--text-xs)"
+                  },
+                  children: L.keyJoiner
+                })]
+              }, j);
+            })
+          }), /*#__PURE__*/_jsx("dd", {
+            style: {
+              margin: 0,
+              fontSize: "var(--text-body)"
+            },
+            children: sc.description
+          })]
+        }, i);
+      })
+    }), /*#__PURE__*/_jsxs("div", {
+      style: HELP_FOOTNOTE_SX,
+      children: [L.footnoteIntro, " ", /*#__PURE__*/_jsx(ShortcutKey, {
+        children: "?"
+      }), " ", L.footnoteOutro]
+    })]
+  });
+}
+export default KeyboardShortcutsHelp;
+//# sourceMappingURL=KeyboardShortcutsHelp.js.map

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

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

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

@@ -0,0 +1,72 @@
+import * as React from "react";
+import Box from "@mui/material/Box";
+import ErrorIcon from "@mui/icons-material/ErrorOutlined";
+
+/**
+ * NetworkErrorBanner - Portnet UI v2 (pattern)
+ *
+ * Charter R-4.3 - erreur réseau globale = bandeau persistant top, "Réessayer".
+ * Z-index 2000 (above modals).
+ *
+ *   <NetworkErrorBanner
+ *     visible={!online}
+ *     message="Connexion perdue."
+ *     onRetry={refresh}
+ *   />
+ *
+ * Localisation (FR / EN / AR):
+ *   `message` and `retryLabel` are direct overrides on the props.
+ *   Defaults stay French for back-compat.
+ */
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+function NetworkErrorBanner(_ref) {
+  var visible = _ref.visible,
+    _ref$message = _ref.message,
+    message = _ref$message === void 0 ? "Connexion perdue." : _ref$message,
+    onRetry = _ref.onRetry,
+    _ref$retryLabel = _ref.retryLabel,
+    retryLabel = _ref$retryLabel === void 0 ? "Réessayer" : _ref$retryLabel;
+  if (!visible) return null;
+  return /*#__PURE__*/_jsxs(Box, {
+    role: "alert",
+    "aria-live": "assertive",
+    className: "pui-net-error-banner",
+    children: [/*#__PURE__*/_jsx(ErrorIcon, {
+      fontSize: "small",
+      "aria-hidden": "true"
+    }), /*#__PURE__*/_jsx("span", {
+      children: message
+    }), onRetry && /*#__PURE__*/_jsx(Box, {
+      component: "button",
+      type: "button",
+      onClick: onRetry,
+      className: "pui-net-error-banner-retry",
+      sx: {
+        // R-AI.1 - tokenised inverse colour mix (was rgba(255,255,255,...))
+        background: "color-mix(in srgb, var(--fg-inverse) 20%, transparent)",
+        border: "1px solid color-mix(in srgb, var(--fg-inverse) 35%, transparent)",
+        color: "inherit",
+        borderRadius: "var(--r-sm)",
+        padding: "var(--s-1) var(--s-3)",
+        fontSize: "var(--text-xs)",
+        fontWeight: "var(--fw-semibold)",
+        cursor: "pointer",
+        fontFamily: "inherit",
+        // NEB-1 - logical inline-start margin so it sits correctly under RTL.
+        marginInlineStart: 0.5,
+        transition: "background var(--duration-fast, 80ms) ease",
+        "&:hover": {
+          background: "color-mix(in srgb, var(--fg-inverse) 30%, transparent)"
+        },
+        // R-F.1 - focus visible required, charter §05.
+        "&:focus-visible": {
+          outline: "2px solid var(--fg-inverse)",
+          outlineOffset: "var(--pui-outline-offset)"
+        }
+      },
+      children: retryLabel
+    })]
+  });
+}
+export default NetworkErrorBanner;
+//# sourceMappingURL=NetworkErrorBanner.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkErrorBanner.js","names":["React","Box","ErrorIcon","jsx","_jsx","jsxs","_jsxs","NetworkErrorBanner","_ref","visible","_ref$message","message","onRetry","_ref$retryLabel","retryLabel","role","className","children","fontSize","component","type","onClick","sx","background","border","color","borderRadius","padding","fontWeight","cursor","fontFamily","marginInlineStart","transition","outline","outlineOffset"],"sources":["../../../../src/lib/v2/patterns/NetworkErrorBanner.tsx"],"sourcesContent":["import * as React from \"react\";\r\nimport Box from \"@mui/material/Box\";\r\nimport ErrorIcon from \"@mui/icons-material/ErrorOutlined\";\r\n\r\n/**\r\n * NetworkErrorBanner - Portnet UI v2 (pattern)\r\n *\r\n * Charter R-4.3 - erreur réseau globale = bandeau persistant top, \"Réessayer\".\r\n * Z-index 2000 (above modals).\r\n *\r\n *   <NetworkErrorBanner\r\n *     visible={!online}\r\n *     message=\"Connexion perdue.\"\r\n *     onRetry={refresh}\r\n *   />\r\n *\r\n * Localisation (FR / EN / AR):\r\n *   `message` and `retryLabel` are direct overrides on the props.\r\n *   Defaults stay French for back-compat.\r\n */\r\n\r\nexport interface NetworkErrorBannerProps {\r\n  visible?: boolean | undefined;\r\n  message?: React.ReactNode | undefined;\r\n  onRetry?: (() => void) | undefined;\r\n  retryLabel?: React.ReactNode | undefined;\r\n}\r\n\r\nfunction NetworkErrorBanner({\r\n  visible,\r\n  message = \"Connexion perdue.\",\r\n  onRetry,\r\n  retryLabel = \"Réessayer\",\r\n}: NetworkErrorBannerProps) {\r\n  if (!visible) return null;\r\n  return (\r\n    <Box role=\"alert\" aria-live=\"assertive\" className=\"pui-net-error-banner\">\r\n      <ErrorIcon fontSize=\"small\" aria-hidden=\"true\" />\r\n      <span>{message}</span>\r\n      {onRetry && (\r\n        <Box\r\n          component=\"button\"\r\n          type=\"button\"\r\n          onClick={onRetry}\r\n          className=\"pui-net-error-banner-retry\"\r\n          sx={{\r\n            // R-AI.1 - tokenised inverse colour mix (was rgba(255,255,255,...))\r\n            background: \"color-mix(in srgb, var(--fg-inverse) 20%, transparent)\",\r\n            border:\r\n              \"1px solid color-mix(in srgb, var(--fg-inverse) 35%, transparent)\",\r\n            color: \"inherit\",\r\n            borderRadius: \"var(--r-sm)\",\r\n            padding: \"var(--s-1) var(--s-3)\",\r\n            fontSize: \"var(--text-xs)\",\r\n            fontWeight: \"var(--fw-semibold)\",\r\n            cursor: \"pointer\",\r\n            fontFamily: \"inherit\",\r\n            // NEB-1 - logical inline-start margin so it sits correctly under RTL.\r\n            marginInlineStart: 0.5,\r\n            transition: \"background var(--duration-fast, 80ms) ease\",\r\n            \"&:hover\": {\r\n              background:\r\n                \"color-mix(in srgb, var(--fg-inverse) 30%, transparent)\",\r\n            },\r\n            // R-F.1 - focus visible required, charter §05.\r\n            \"&:focus-visible\": {\r\n              outline: \"2px solid var(--fg-inverse)\",\r\n              outlineOffset: \"var(--pui-outline-offset)\",\r\n            },\r\n          }}\r\n        >\r\n          {retryLabel}\r\n        </Box>\r\n      )}\r\n    </Box>\r\n  );\r\n}\r\n\r\nexport default NetworkErrorBanner;\r\n"],"mappings":"AAAA,OAAO,KAAKA,KAAK,MAAM,OAAO;AAC9B,OAAOC,GAAG,MAAM,mBAAmB;AACnC,OAAOC,SAAS,MAAM,mCAAmC;;AAEzD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAfA,SAAAC,GAAA,IAAAC,IAAA,EAAAC,IAAA,IAAAC,KAAA;AAwBA,SAASC,kBAAkBA,CAAAC,IAAA,EAKC;EAAA,IAJ1BC,OAAO,GAAAD,IAAA,CAAPC,OAAO;IAAAC,YAAA,GAAAF,IAAA,CACPG,OAAO;IAAPA,OAAO,GAAAD,YAAA,cAAG,mBAAmB,GAAAA,YAAA;IAC7BE,OAAO,GAAAJ,IAAA,CAAPI,OAAO;IAAAC,eAAA,GAAAL,IAAA,CACPM,UAAU;IAAVA,UAAU,GAAAD,eAAA,cAAG,WAAW,GAAAA,eAAA;EAExB,IAAI,CAACJ,OAAO,EAAE,OAAO,IAAI;EACzB,oBACEH,KAAA,CAACL,GAAG;IAACc,IAAI,EAAC,OAAO;IAAC,aAAU,WAAW;IAACC,SAAS,EAAC,sBAAsB;IAAAC,QAAA,gBACtEb,IAAA,CAACF,SAAS;MAACgB,QAAQ,EAAC,OAAO;MAAC,eAAY;IAAM,CAAE,CAAC,eACjDd,IAAA;MAAAa,QAAA,EAAON;IAAO,CAAO,CAAC,EACrBC,OAAO,iBACNR,IAAA,CAACH,GAAG;MACFkB,SAAS,EAAC,QAAQ;MAClBC,IAAI,EAAC,QAAQ;MACbC,OAAO,EAAET,OAAQ;MACjBI,SAAS,EAAC,4BAA4B;MACtCM,EAAE,EAAE;QACF;QACAC,UAAU,EAAE,wDAAwD;QACpEC,MAAM,EACJ,kEAAkE;QACpEC,KAAK,EAAE,SAAS;QAChBC,YAAY,EAAE,aAAa;QAC3BC,OAAO,EAAE,uBAAuB;QAChCT,QAAQ,EAAE,gBAAgB;QAC1BU,UAAU,EAAE,oBAAoB;QAChCC,MAAM,EAAE,SAAS;QACjBC,UAAU,EAAE,SAAS;QACrB;QACAC,iBAAiB,EAAE,GAAG;QACtBC,UAAU,EAAE,4CAA4C;QACxD,SAAS,EAAE;UACTT,UAAU,EACR;QACJ,CAAC;QACD;QACA,iBAAiB,EAAE;UACjBU,OAAO,EAAE,6BAA6B;UACtCC,aAAa,EAAE;QACjB;MACF,CAAE;MAAAjB,QAAA,EAEDH;IAAU,CACR,CACN;EAAA,CACE,CAAC;AAEV;AAEA,eAAeP,kBAAkB","ignoreList":[]}

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

@@ -0,0 +1,62 @@
+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 Box from "@mui/material/Box";
+
+/**
+ * PageContent — Portnet UI v2 (pattern)
+ *
+ * Charter §07 · Template canonique — zone contenu (§7.1 bis).
+ *
+ * Wraps the main content zone inside the shell applicatif with the
+ * canonical responsive padding and vertical gap defined in §7.1 bis:
+ *
+ *   xs  ( 0 – 480 px )  → padding  12 px  (--s-3)
+ *   sm  ( 481 – 1023 px) → padding  16 px  (--s-4)
+ *   lg  ( 1024 px +    ) → padding  24 px  (--s-6)
+ *
+ * Usage:
+ *   import { PageContent } from "@portnet/ui";
+ *
+ *   <PageContent>
+ *     <FilterCard />
+ *     <DataGrid ... />
+ *   </PageContent>
+ *
+ * Override gap or add extra sx when the default section gap
+ * (var(--s-4) = 16 px) is not appropriate for the context.
+ *
+ *   <PageContent gap="var(--s-6)" sx={{ maxWidth: 720 }}>
+ *     ...
+ *   </PageContent>
+ */
+import { jsx as _jsx } from "react/jsx-runtime";
+function PageContent(_ref) {
+  var children = _ref.children,
+    gap = _ref.gap,
+    sx = _ref.sx;
+  return /*#__PURE__*/_jsx(Box, {
+    sx: _objectSpread({
+      /* Responsive padding — charter §7.1 bis */
+      padding: {
+        xs: "var(--s-3)" /* 12 px — mobile */,
+        sm: "var(--s-4)" /* 16 px — tablet */,
+        lg: "var(--s-6)" /* 24 px — desktop */
+      },
+      /* Section layout */
+      display: "flex",
+      flexDirection: "column",
+      gap: gap !== null && gap !== void 0 ? gap : "var(--s-4)",
+      /* Prevent content from overflowing the viewport on narrow screens
+         while still allowing inner scroll containers (DataGrid) to work. */
+      minWidth: 0
+    }, sx),
+    children: children
+  });
+}
+export default PageContent;
+//# sourceMappingURL=PageContent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PageContent.js","names":["React","Box","jsx","_jsx","PageContent","_ref","children","gap","sx","_objectSpread","padding","xs","sm","lg","display","flexDirection","minWidth"],"sources":["../../../../src/lib/v2/patterns/PageContent.tsx"],"sourcesContent":["import * as React from \"react\";\r\nimport Box from \"@mui/material/Box\";\r\nimport type { SxProps, Theme } from \"@mui/material/styles\";\r\nimport type { SystemStyleObject } from \"@mui/system\";\r\n\r\n/**\r\n * PageContent — Portnet UI v2 (pattern)\r\n *\r\n * Charter §07 · Template canonique — zone contenu (§7.1 bis).\r\n *\r\n * Wraps the main content zone inside the shell applicatif with the\r\n * canonical responsive padding and vertical gap defined in §7.1 bis:\r\n *\r\n *   xs  ( 0 – 480 px )  → padding  12 px  (--s-3)\r\n *   sm  ( 481 – 1023 px) → padding  16 px  (--s-4)\r\n *   lg  ( 1024 px +    ) → padding  24 px  (--s-6)\r\n *\r\n * Usage:\r\n *   import { PageContent } from \"@portnet/ui\";\r\n *\r\n *   <PageContent>\r\n *     <FilterCard />\r\n *     <DataGrid ... />\r\n *   </PageContent>\r\n *\r\n * Override gap or add extra sx when the default section gap\r\n * (var(--s-4) = 16 px) is not appropriate for the context.\r\n *\r\n *   <PageContent gap=\"var(--s-6)\" sx={{ maxWidth: 720 }}>\r\n *     ...\r\n *   </PageContent>\r\n */\r\n\r\nexport interface PageContentProps {\r\n  /** Page sections / content */\r\n  children?: React.ReactNode | undefined;\r\n  /** Override the vertical gap between direct children (default var(--s-4)) */\r\n  gap?: string | undefined;\r\n  /** MUI sx overrides applied to the root Box */\r\n  sx?: SxProps<Theme> | undefined;\r\n}\r\n\r\nfunction PageContent({ children, gap, sx }: PageContentProps) {\r\n  return (\r\n    <Box\r\n      sx={{\r\n        /* Responsive padding — charter §7.1 bis */\r\n        padding: {\r\n          xs: \"var(--s-3)\" /* 12 px — mobile */,\r\n          sm: \"var(--s-4)\" /* 16 px — tablet */,\r\n          lg: \"var(--s-6)\" /* 24 px — desktop */,\r\n        },\r\n        /* Section layout */\r\n        display: \"flex\",\r\n        flexDirection: \"column\",\r\n        gap: gap ?? \"var(--s-4)\",\r\n        /* Prevent content from overflowing the viewport on narrow screens\r\n           while still allowing inner scroll containers (DataGrid) to work. */\r\n        minWidth: 0,\r\n        ...(sx as SystemStyleObject<Theme>),\r\n      }}\r\n    >\r\n      {children}\r\n    </Box>\r\n  );\r\n}\r\n\r\nexport default PageContent;\r\n"],"mappings":";;;;;;AAAA,OAAO,KAAKA,KAAK,MAAM,OAAO;AAC9B,OAAOC,GAAG,MAAM,mBAAmB;;AAInC;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;AA1BA,SAAAC,GAAA,IAAAC,IAAA;AAqCA,SAASC,WAAWA,CAAAC,IAAA,EAA0C;EAAA,IAAvCC,QAAQ,GAAAD,IAAA,CAARC,QAAQ;IAAEC,GAAG,GAAAF,IAAA,CAAHE,GAAG;IAAEC,EAAE,GAAAH,IAAA,CAAFG,EAAE;EACtC,oBACEL,IAAA,CAACF,GAAG;IACFO,EAAE,EAAAC,aAAA;MACA;MACAC,OAAO,EAAE;QACPC,EAAE,EAAE,YAAY,CAAC;QACjBC,EAAE,EAAE,YAAY,CAAC;QACjBC,EAAE,EAAE,YAAY,CAAC;MACnB,CAAC;MACD;MACAC,OAAO,EAAE,MAAM;MACfC,aAAa,EAAE,QAAQ;MACvBR,GAAG,EAAEA,GAAG,aAAHA,GAAG,cAAHA,GAAG,GAAI,YAAY;MACxB;AACR;MACQS,QAAQ,EAAE;IAAC,GACPR,EAAE,CACN;IAAAF,QAAA,EAEDA;EAAQ,CACN,CAAC;AAEV;AAEA,eAAeF,WAAW","ignoreList":[]}