@portnet/ui 5.0.32 → 6.0.1

package/dist/v2/patterns/FormErrorSummary.d.ts

@@ -0,0 +1,39 @@
+import * as React from "react";
+/**
+ * FormErrorSummary — Portnet UI v2
+ *
+ * Charter §05 / R-FV.2. Synthesis banner rendered above a form after a
+ * failed-submit so the user sees, at-a-glance, every field that needs
+ * attention. Each entry is a clickable jump-to-field affordance; the host
+ * supplies the navigation behaviour via `onItemClick`.
+ *
+ * Composition: pure v2.Banner + a semantic <ul> of <button> jump-links.
+ * No host-specific scroll/focus logic baked in.
+ *
+ * Renders nothing when `errors` is empty / nullish — host can mount
+ * unconditionally above the form.
+ *
+ * Accessibility:
+ *   - <button type="button"> instead of <a href="#…">. The entries trigger
+ *     an action (focus/scroll) and don't navigate.
+ *   - Explicit role="list" + role="listitem" because some screen readers
+ *     strip list semantics when CSS list-style:none is applied.
+ *   - Banner already carries the alert/role semantics for the region.
+ *   - Explicit :focus-visible outline on each jump-button on --danger-fg,
+ *     which passes WCAG 1.4.11 ≥ 3:1 on danger-soft (finding B4-EXT-2).
+ *
+ * Charter R-AI.2: composition of v2.Banner only — no local primitive.
+ */
+export interface FormErrorSummaryError {
+    name: string;
+    message: string;
+}
+export interface FormErrorSummaryProps {
+    errors?: FormErrorSummaryError[] | undefined;
+    labelByName?: Record<string, string> | undefined;
+    onItemClick?: ((name: string) => void) | undefined;
+    title?: string | undefined;
+}
+declare function FormErrorSummary({ errors, labelByName, onItemClick, title, }: FormErrorSummaryProps): React.JSX.Element | null;
+export default FormErrorSummary;
+//# sourceMappingURL=FormErrorSummary.d.ts.map

package/dist/v2/patterns/FormErrorSummary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormErrorSummary.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/patterns/FormErrorSummary.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,qBAAqB,EAAE,GAAG,SAAS,CAAC;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACjD,WAAW,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACnD,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,iBAAS,gBAAgB,CAAC,EACxB,MAAM,EACN,WAAW,EACX,WAAW,EACX,KAAK,GACN,EAAE,qBAAqB,4BAwEvB;AAED,eAAe,gBAAgB,CAAC"}

package/dist/v2/patterns/FormErrorSummary.js

@@ -0,0 +1,111 @@
+"use strict";
+
+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); }
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var React = _interopRequireWildcard(require("react"));
+var _Box = _interopRequireDefault(require("@mui/material/Box"));
+var _Banner = _interopRequireDefault(require("../components/Banner"));
+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; }
+/**
+ * FormErrorSummary — Portnet UI v2
+ *
+ * Charter §05 / R-FV.2. Synthesis banner rendered above a form after a
+ * failed-submit so the user sees, at-a-glance, every field that needs
+ * attention. Each entry is a clickable jump-to-field affordance; the host
+ * supplies the navigation behaviour via `onItemClick`.
+ *
+ * Composition: pure v2.Banner + a semantic <ul> of <button> jump-links.
+ * No host-specific scroll/focus logic baked in.
+ *
+ * Renders nothing when `errors` is empty / nullish — host can mount
+ * unconditionally above the form.
+ *
+ * Accessibility:
+ *   - <button type="button"> instead of <a href="#…">. The entries trigger
+ *     an action (focus/scroll) and don't navigate.
+ *   - Explicit role="list" + role="listitem" because some screen readers
+ *     strip list semantics when CSS list-style:none is applied.
+ *   - Banner already carries the alert/role semantics for the region.
+ *   - Explicit :focus-visible outline on each jump-button on --danger-fg,
+ *     which passes WCAG 1.4.11 ≥ 3:1 on danger-soft (finding B4-EXT-2).
+ *
+ * Charter R-AI.2: composition of v2.Banner only — no local primitive.
+ */
+
+function FormErrorSummary(_ref) {
+  var errors = _ref.errors,
+    labelByName = _ref.labelByName,
+    onItemClick = _ref.onItemClick,
+    title = _ref.title;
+  if (!errors || errors.length === 0) return null;
+  var heading = title || "Veuillez corriger les erreurs ci-dessous";
+  var handleClick = function handleClick(e, name) {
+    e.preventDefault();
+    if (typeof onItemClick === "function") {
+      onItemClick(name);
+    }
+  };
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Banner["default"], {
+    variant: "error",
+    title: heading,
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Box["default"], {
+      component: "ul",
+      role: "list",
+      sx: {
+        margin: 0,
+        paddingInlineStart: "var(--s-5)",
+        fontSize: "var(--text-sm)",
+        listStyle: "disc"
+      },
+      children: errors.map(function (err, idx) {
+        var label = labelByName && labelByName[err.name] || err.name;
+        return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_Box["default"], {
+          component: "li",
+          role: "listitem",
+          sx: {
+            marginBottom: "var(--s-1)"
+          },
+          children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_Box["default"], {
+            component: "button",
+            type: "button",
+            onClick: function onClick(e) {
+              return handleClick(e, err.name);
+            },
+            sx: {
+              // Reset default <button> chrome so the link reads visually
+              // as a hyperlink in the banner body.
+              background: "transparent",
+              border: "none",
+              padding: 0,
+              margin: 0,
+              font: "inherit",
+              cursor: "pointer",
+              color: "var(--danger-fg)",
+              textDecoration: "underline",
+              fontWeight: "var(--fw-medium)",
+              // R-F.1 — explicit focus-visible outline. Outline on
+              // currentColor (danger-fg) passes 1.4.11 ≥ 3:1 on the soft
+              // danger background; borderRadius aligns the ring with the DS.
+              "&:focus-visible": {
+                outline: "2px solid var(--danger-fg)",
+                outlineOffset: "var(--pui-outline-offset)",
+                borderRadius: "var(--r-sm)"
+              }
+            },
+            children: label
+          }), ": ", /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
+            children: err.message
+          })]
+        }, "".concat(err.name, "-").concat(idx));
+      })
+    })
+  });
+}
+var _default = exports["default"] = FormErrorSummary;
+//# sourceMappingURL=FormErrorSummary.js.map

package/dist/v2/patterns/FormErrorSummary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormErrorSummary.js","names":["React","_interopRequireWildcard","require","_Box","_interopRequireDefault","_Banner","_jsxRuntime","obj","__esModule","_getRequireWildcardCache","nodeInterop","WeakMap","cacheBabelInterop","cacheNodeInterop","_typeof","cache","has","get","newObj","hasPropertyDescriptor","Object","defineProperty","getOwnPropertyDescriptor","key","prototype","hasOwnProperty","call","desc","set","FormErrorSummary","_ref","errors","labelByName","onItemClick","title","length","heading","handleClick","e","name","preventDefault","jsx","variant","children","component","role","sx","margin","paddingInlineStart","fontSize","listStyle","map","err","idx","label","jsxs","marginBottom","type","onClick","background","border","padding","font","cursor","color","textDecoration","fontWeight","outline","outlineOffset","borderRadius","message","concat","_default","exports"],"sources":["../../../src/lib/v2/patterns/FormErrorSummary.tsx"],"sourcesContent":["import * as React from \"react\";\r\nimport Box from \"@mui/material/Box\";\r\nimport Banner from \"../components/Banner\";\r\n\r\n/**\r\n * FormErrorSummary — Portnet UI v2\r\n *\r\n * Charter §05 / R-FV.2. Synthesis banner rendered above a form after a\r\n * failed-submit so the user sees, at-a-glance, every field that needs\r\n * attention. Each entry is a clickable jump-to-field affordance; the host\r\n * supplies the navigation behaviour via `onItemClick`.\r\n *\r\n * Composition: pure v2.Banner + a semantic <ul> of <button> jump-links.\r\n * No host-specific scroll/focus logic baked in.\r\n *\r\n * Renders nothing when `errors` is empty / nullish — host can mount\r\n * unconditionally above the form.\r\n *\r\n * Accessibility:\r\n *   - <button type=\"button\"> instead of <a href=\"#…\">. The entries trigger\r\n *     an action (focus/scroll) and don't navigate.\r\n *   - Explicit role=\"list\" + role=\"listitem\" because some screen readers\r\n *     strip list semantics when CSS list-style:none is applied.\r\n *   - Banner already carries the alert/role semantics for the region.\r\n *   - Explicit :focus-visible outline on each jump-button on --danger-fg,\r\n *     which passes WCAG 1.4.11 ≥ 3:1 on danger-soft (finding B4-EXT-2).\r\n *\r\n * Charter R-AI.2: composition of v2.Banner only — no local primitive.\r\n */\r\n\r\nexport interface FormErrorSummaryError {\r\n  name: string;\r\n  message: string;\r\n}\r\n\r\nexport interface FormErrorSummaryProps {\r\n  errors?: FormErrorSummaryError[] | undefined;\r\n  labelByName?: Record<string, string> | undefined;\r\n  onItemClick?: ((name: string) => void) | undefined;\r\n  title?: string | undefined;\r\n}\r\n\r\nfunction FormErrorSummary({\r\n  errors,\r\n  labelByName,\r\n  onItemClick,\r\n  title,\r\n}: FormErrorSummaryProps) {\r\n  if (!errors || errors.length === 0) return null;\r\n\r\n  const heading = title || \"Veuillez corriger les erreurs ci-dessous\";\r\n\r\n  const handleClick = (\r\n    e: React.MouseEvent<HTMLButtonElement>,\r\n    name: string\r\n  ) => {\r\n    e.preventDefault();\r\n    if (typeof onItemClick === \"function\") {\r\n      onItemClick(name);\r\n    }\r\n  };\r\n\r\n  return (\r\n    <Banner variant=\"error\" title={heading}>\r\n      <Box\r\n        component=\"ul\"\r\n        role=\"list\"\r\n        sx={{\r\n          margin: 0,\r\n          paddingInlineStart: \"var(--s-5)\",\r\n          fontSize: \"var(--text-sm)\",\r\n          listStyle: \"disc\",\r\n        }}\r\n      >\r\n        {errors.map((err, idx) => {\r\n          const label = (labelByName && labelByName[err.name]) || err.name;\r\n          return (\r\n            <Box\r\n              component=\"li\"\r\n              role=\"listitem\"\r\n              key={`${err.name}-${idx}`}\r\n              sx={{ marginBottom: \"var(--s-1)\" }}\r\n            >\r\n              <Box\r\n                component=\"button\"\r\n                type=\"button\"\r\n                onClick={(e) => handleClick(e, err.name)}\r\n                sx={{\r\n                  // Reset default <button> chrome so the link reads visually\r\n                  // as a hyperlink in the banner body.\r\n                  background: \"transparent\",\r\n                  border: \"none\",\r\n                  padding: 0,\r\n                  margin: 0,\r\n                  font: \"inherit\",\r\n                  cursor: \"pointer\",\r\n                  color: \"var(--danger-fg)\",\r\n                  textDecoration: \"underline\",\r\n                  fontWeight: \"var(--fw-medium)\",\r\n                  // R-F.1 — explicit focus-visible outline. Outline on\r\n                  // currentColor (danger-fg) passes 1.4.11 ≥ 3:1 on the soft\r\n                  // danger background; borderRadius aligns the ring with the DS.\r\n                  \"&:focus-visible\": {\r\n                    outline: \"2px solid var(--danger-fg)\",\r\n                    outlineOffset: \"var(--pui-outline-offset)\",\r\n                    borderRadius: \"var(--r-sm)\",\r\n                  },\r\n                }}\r\n              >\r\n                {label}\r\n              </Box>\r\n              {\": \"}\r\n              <span>{err.message}</span>\r\n            </Box>\r\n          );\r\n        })}\r\n      </Box>\r\n    </Banner>\r\n  );\r\n}\r\n\r\nexport default FormErrorSummary;\r\n"],"mappings":"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","ignoreList":[]}

package/dist/v2/patterns/FormPageShell.d.ts

@@ -0,0 +1,55 @@
+import * as React from "react";
+import type { SxProps, Theme } from "@mui/material/styles";
+import { type ActionBarProps } from "./ActionBar";
+/**
+ * FormPageShell — Portnet UI v2 (pattern)
+ *
+ * Charter §07 R-L.2 — canonical shell for create/edit form pages.
+ *
+ * Combines a sticky ActionBar (surface=false, accent title) with a
+ * responsive PageContent wrapper so every module's form page has the
+ * same structure without reimplementing it.
+ *
+ * ┌───────────────────────────────────────────────────────────────┐
+ * │ 🏠 > Breadcrumb                                               │  sticky
+ * │ Title                        [secondary] [primary] [overflow…] │
+ * │ Subtitle                                                      │
+ * └───────────────────────────────────────────────────────────────┘
+ * ┌───────────────────────────────────────────────────────────────┐
+ * │  [ProgressBar ── progressLabel]      ← if progress prop given │
+ * │  children                                                      │
+ * └───────────────────────────────────────────────────────────────┘
+ *
+ * @example
+ *   <FormPageShell
+ *     home={() => navigate("/")}
+ *     back={() => navigate("/list")}
+ *     breadcrumb={["Autorisations", "Nouvelle autorisation"]}
+ *     title="Nouvelle autorisation"
+ *     subtitle="Saisissez les informations…"
+ *     secondary={[{ label: "Enregistrer", icon: <SaveIcon />, onClick: handleSave }]}
+ *     primary={{ label: "Déposer", iconRight: <ArrowIcon />, onClick: handleDeposit }}
+ *     overflow={[{ label: "Retour à la liste", onClick: goBack }]}
+ *     progress={requiredPct}
+ *     progressLabel={isComplete ? "Prêt à déposer ✓" : `${filled}/${total} requis`}
+ *   >
+ *     <FormSection number={1} title="Informations">…</FormSection>
+ *   </FormPageShell>
+ */
+export interface FormPageShellProps extends Pick<ActionBarProps, "home" | "back" | "breadcrumb" | "title" | "subtitle" | "icon" | "secondary" | "primary" | "overflow"> {
+    /** 0-100; renders a ProgressBar when provided. */
+    progress?: number | undefined;
+    /** Companion text beside the progress bar. */
+    progressLabel?: React.ReactNode | undefined;
+    children?: React.ReactNode | undefined;
+    /** MUI sx override for PageContent. */
+    contentSx?: SxProps<Theme> | undefined;
+}
+/**
+ * Valeurs par défaut inline — plus de defaultProps.
+ * React 18.3+ supprime le support de defaultProps pour les function
+ * components. Aligné sur le pattern DataGridToolbar (B14).
+ */
+declare function FormPageShell({ home, back, breadcrumb, title, subtitle, icon, secondary, primary, overflow, progress, progressLabel, children, contentSx, }: FormPageShellProps): React.JSX.Element;
+export default FormPageShell;
+//# sourceMappingURL=FormPageShell.d.ts.map

package/dist/v2/patterns/FormPageShell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormPageShell.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/patterns/FormPageShell.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAkB,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAI7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,MAAM,WAAW,kBACf,SAAQ,IAAI,CACV,cAAc,EACZ,MAAM,GACN,MAAM,GACN,YAAY,GACZ,OAAO,GACP,UAAU,GACV,MAAM,GACN,WAAW,GACX,SAAS,GACT,UAAU,CACb;IACD,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,8CAA8C;IAC9C,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IACvC,uCAAuC;IACvC,SAAS,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;CACxC;AAmBD;;;;GAIG;AACH,iBAAS,aAAa,CAAC,EAErB,IAAI,EACJ,IAAI,EACJ,UAAU,EACV,KAAK,EACL,QAAQ,EACR,IAAI,EACJ,SAAc,EACd,OAAO,EACP,QAAa,EAEb,QAAQ,EACR,aAAa,EAEb,QAAQ,EACR,SAAS,GACV,EAAE,kBAAkB,qBAoCpB;AAED,eAAe,aAAa,CAAC"}

package/dist/v2/patterns/FormPageShell.js

@@ -0,0 +1,133 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var React = _interopRequireWildcard(require("react"));
+var _Box = _interopRequireDefault(require("@mui/material/Box"));
+var _ActionBar = _interopRequireDefault(require("./ActionBar"));
+var _PageContent = _interopRequireDefault(require("./PageContent"));
+var _ProgressBar = _interopRequireDefault(require("../components/ProgressBar"));
+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); } /**
+ * FormPageShell — Portnet UI v2 (pattern)
+ *
+ * Charter §07 R-L.2 — canonical shell for create/edit form pages.
+ *
+ * Combines a sticky ActionBar (surface=false, accent title) with a
+ * responsive PageContent wrapper so every module's form page has the
+ * same structure without reimplementing it.
+ *
+ * ┌───────────────────────────────────────────────────────────────┐
+ * │ 🏠 > Breadcrumb                                               │  sticky
+ * │ Title                        [secondary] [primary] [overflow…] │
+ * │ Subtitle                                                      │
+ * └───────────────────────────────────────────────────────────────┘
+ * ┌───────────────────────────────────────────────────────────────┐
+ * │  [ProgressBar ── progressLabel]      ← if progress prop given │
+ * │  children                                                      │
+ * └───────────────────────────────────────────────────────────────┘
+ *
+ * @example
+ *   <FormPageShell
+ *     home={() => navigate("/")}
+ *     back={() => navigate("/list")}
+ *     breadcrumb={["Autorisations", "Nouvelle autorisation"]}
+ *     title="Nouvelle autorisation"
+ *     subtitle="Saisissez les informations…"
+ *     secondary={[{ label: "Enregistrer", icon: <SaveIcon />, onClick: handleSave }]}
+ *     primary={{ label: "Déposer", iconRight: <ArrowIcon />, onClick: handleDeposit }}
+ *     overflow={[{ label: "Retour à la liste", onClick: goBack }]}
+ *     progress={requiredPct}
+ *     progressLabel={isComplete ? "Prêt à déposer ✓" : `${filled}/${total} requis`}
+ *   >
+ *     <FormSection number={1} title="Informations">…</FormSection>
+ *   </FormPageShell>
+ */
+var PROGRESS_ROW_SX = Object.freeze({
+  display: "flex",
+  alignItems: "center",
+  gap: "var(--s-3)",
+  marginBottom: "var(--s-5)"
+});
+var PROGRESS_BAR_WRAPPER_SX = Object.freeze({
+  flex: 1,
+  minWidth: 0
+});
+var PROGRESS_LABEL_SX = Object.freeze({
+  fontSize: "var(--text-xs)",
+  color: "var(--fg-muted)",
+  whiteSpace: "nowrap",
+  fontVariantNumeric: "tabular-nums",
+  flexShrink: 0
+});
+
+/**
+ * Valeurs par défaut inline — plus de defaultProps.
+ * React 18.3+ supprime le support de defaultProps pour les function
+ * components. Aligné sur le pattern DataGridToolbar (B14).
+ */
+function FormPageShell(_ref) {
+  var home = _ref.home,
+    back = _ref.back,
+    breadcrumb = _ref.breadcrumb,
+    title = _ref.title,
+    subtitle = _ref.subtitle,
+    icon = _ref.icon,
+    _ref$secondary = _ref.secondary,
+    secondary = _ref$secondary === void 0 ? [] : _ref$secondary,
+    primary = _ref.primary,
+    _ref$overflow = _ref.overflow,
+    overflow = _ref$overflow === void 0 ? [] : _ref$overflow,
+    progress = _ref.progress,
+    progressLabel = _ref.progressLabel,
+    children = _ref.children,
+    contentSx = _ref.contentSx;
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_ActionBar["default"], _objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({
+      surface: false,
+      title: title,
+      subtitle: subtitle,
+      secondary: secondary,
+      overflow: overflow
+    }, home !== undefined ? {
+      home: home
+    } : {}), back !== undefined ? {
+      back: back
+    } : {}), breadcrumb !== undefined ? {
+      breadcrumb: breadcrumb
+    } : {}), icon !== undefined ? {
+      icon: icon
+    } : {}), primary !== undefined ? {
+      primary: primary
+    } : {})), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_PageContent["default"], _objectSpread(_objectSpread({}, contentSx !== undefined ? {
+      sx: contentSx
+    } : {}), {}, {
+      children: [typeof progress === "number" && /*#__PURE__*/(0, _jsxRuntime.jsxs)(_Box["default"], {
+        sx: PROGRESS_ROW_SX,
+        children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_Box["default"], {
+          sx: PROGRESS_BAR_WRAPPER_SX,
+          children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_ProgressBar["default"], {
+            value: progress,
+            "aria-label": "Avancement de la saisie"
+          })
+        }), progressLabel && /*#__PURE__*/(0, _jsxRuntime.jsx)(_Box["default"], {
+          component: "span",
+          sx: PROGRESS_LABEL_SX,
+          children: progressLabel
+        })]
+      }), children]
+    }))]
+  });
+}
+var _default = exports["default"] = FormPageShell;
+//# sourceMappingURL=FormPageShell.js.map

package/dist/v2/patterns/FormPageShell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormPageShell.js","names":["React","_interopRequireWildcard","require","_Box","_interopRequireDefault","_ActionBar","_PageContent","_ProgressBar","_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","PROGRESS_ROW_SX","freeze","display","alignItems","gap","marginBottom","PROGRESS_BAR_WRAPPER_SX","flex","minWidth","PROGRESS_LABEL_SX","fontSize","color","whiteSpace","fontVariantNumeric","flexShrink","FormPageShell","_ref","home","back","breadcrumb","title","subtitle","icon","_ref$secondary","secondary","primary","_ref$overflow","overflow","progress","progressLabel","children","contentSx","jsxs","Fragment","jsx","surface","sx","component","_default","exports"],"sources":["../../../src/lib/v2/patterns/FormPageShell.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 ActionBar, { type ActionBarProps } from \"./ActionBar\";\r\nimport PageContent from \"./PageContent\";\r\nimport ProgressBar from \"../components/ProgressBar\";\r\n\r\n/**\r\n * FormPageShell — Portnet UI v2 (pattern)\r\n *\r\n * Charter §07 R-L.2 — canonical shell for create/edit form pages.\r\n *\r\n * Combines a sticky ActionBar (surface=false, accent title) with a\r\n * responsive PageContent wrapper so every module's form page has the\r\n * same structure without reimplementing it.\r\n *\r\n * ┌───────────────────────────────────────────────────────────────┐\r\n * │ 🏠 > Breadcrumb                                               │  sticky\r\n * │ Title                        [secondary] [primary] [overflow…] │\r\n * │ Subtitle                                                      │\r\n * └───────────────────────────────────────────────────────────────┘\r\n * ┌───────────────────────────────────────────────────────────────┐\r\n * │  [ProgressBar ── progressLabel]      ← if progress prop given │\r\n * │  children                                                      │\r\n * └───────────────────────────────────────────────────────────────┘\r\n *\r\n * @example\r\n *   <FormPageShell\r\n *     home={() => navigate(\"/\")}\r\n *     back={() => navigate(\"/list\")}\r\n *     breadcrumb={[\"Autorisations\", \"Nouvelle autorisation\"]}\r\n *     title=\"Nouvelle autorisation\"\r\n *     subtitle=\"Saisissez les informations…\"\r\n *     secondary={[{ label: \"Enregistrer\", icon: <SaveIcon />, onClick: handleSave }]}\r\n *     primary={{ label: \"Déposer\", iconRight: <ArrowIcon />, onClick: handleDeposit }}\r\n *     overflow={[{ label: \"Retour à la liste\", onClick: goBack }]}\r\n *     progress={requiredPct}\r\n *     progressLabel={isComplete ? \"Prêt à déposer ✓\" : `${filled}/${total} requis`}\r\n *   >\r\n *     <FormSection number={1} title=\"Informations\">…</FormSection>\r\n *   </FormPageShell>\r\n */\r\n\r\nexport interface FormPageShellProps\r\n  extends Pick<\r\n    ActionBarProps,\r\n    | \"home\"\r\n    | \"back\"\r\n    | \"breadcrumb\"\r\n    | \"title\"\r\n    | \"subtitle\"\r\n    | \"icon\"\r\n    | \"secondary\"\r\n    | \"primary\"\r\n    | \"overflow\"\r\n  > {\r\n  /** 0-100; renders a ProgressBar when provided. */\r\n  progress?: number | undefined;\r\n  /** Companion text beside the progress bar. */\r\n  progressLabel?: React.ReactNode | undefined;\r\n  children?: React.ReactNode | undefined;\r\n  /** MUI sx override for PageContent. */\r\n  contentSx?: SxProps<Theme> | undefined;\r\n}\r\n\r\nconst PROGRESS_ROW_SX = Object.freeze({\r\n  display: \"flex\",\r\n  alignItems: \"center\",\r\n  gap: \"var(--s-3)\",\r\n  marginBottom: \"var(--s-5)\",\r\n} satisfies SxProps<Theme>);\r\n\r\nconst PROGRESS_BAR_WRAPPER_SX = Object.freeze({ flex: 1, minWidth: 0 });\r\n\r\nconst PROGRESS_LABEL_SX = Object.freeze({\r\n  fontSize: \"var(--text-xs)\",\r\n  color: \"var(--fg-muted)\",\r\n  whiteSpace: \"nowrap\",\r\n  fontVariantNumeric: \"tabular-nums\",\r\n  flexShrink: 0,\r\n} satisfies SxProps<Theme>);\r\n\r\n/**\r\n * Valeurs par défaut inline — plus de defaultProps.\r\n * React 18.3+ supprime le support de defaultProps pour les function\r\n * components. Aligné sur le pattern DataGridToolbar (B14).\r\n */\r\nfunction FormPageShell({\r\n  /* ActionBar props */\r\n  home,\r\n  back,\r\n  breadcrumb,\r\n  title,\r\n  subtitle,\r\n  icon,\r\n  secondary = [],\r\n  primary,\r\n  overflow = [],\r\n  /* Progress slot */\r\n  progress,\r\n  progressLabel,\r\n  /* Content */\r\n  children,\r\n  contentSx,\r\n}: FormPageShellProps) {\r\n  return (\r\n    <>\r\n      <ActionBar\r\n        surface={false}\r\n        title={title}\r\n        subtitle={subtitle}\r\n        secondary={secondary}\r\n        overflow={overflow}\r\n        {...(home !== undefined ? { home } : {})}\r\n        {...(back !== undefined ? { back } : {})}\r\n        {...(breadcrumb !== undefined ? { breadcrumb } : {})}\r\n        {...(icon !== undefined ? { icon } : {})}\r\n        {...(primary !== undefined ? { primary } : {})}\r\n      />\r\n\r\n      <PageContent {...(contentSx !== undefined ? { sx: contentSx } : {})}>\r\n        {typeof progress === \"number\" && (\r\n          <Box sx={PROGRESS_ROW_SX}>\r\n            <Box sx={PROGRESS_BAR_WRAPPER_SX}>\r\n              <ProgressBar\r\n                value={progress}\r\n                aria-label=\"Avancement de la saisie\"\r\n              />\r\n            </Box>\r\n            {progressLabel && (\r\n              <Box component=\"span\" sx={PROGRESS_LABEL_SX}>\r\n                {progressLabel}\r\n              </Box>\r\n            )}\r\n          </Box>\r\n        )}\r\n        {children}\r\n      </PageContent>\r\n    </>\r\n  );\r\n}\r\n\r\nexport default FormPageShell;\r\n"],"mappings":"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","ignoreList":[]}

package/dist/v2/patterns/FormSection.d.ts

@@ -0,0 +1,64 @@
+import * as React from "react";
+import type { SxProps, Theme } from "@mui/material/styles";
+/**
+ * FormSection - Portnet UI v2 (pattern)
+ *
+ * Charter R-3.1 — groups form fields into named, numbered sections.
+ * Charter R-3.2 — 3-column grid is the standard for form sections.
+ *
+ * cols (default 3):
+ *   3       — three equal columns (DEFAULT — standard form layout)
+ *   2       — two equal columns (narrow forms, few fields, wide labels)
+ *   1       — single column (textareas, file uploads, notes)
+ *   "auto"  — auto-fill tracks min 220px
+ *   "none"  — no grid wrapper — children manage their own layout.
+ *             Use for: KVGrid, DataGrid, nested FormGrid.
+ *
+ * Full-width items within a 3-col section:
+ *   <FormGrid.Full><FormikTextarea name="obs" /></FormGrid.Full>
+ *
+ * Usage:
+ *   // Standard form section — 3 cols (no need to specify)
+ *   <FormSection number={1} title="Identification">
+ *     <FormikInput name="nom" label="Nom" />
+ *     <FormikInput name="prenom" label="Prénom" />
+ *     <FormikInput name="code" label="Code" />
+ *   </FormSection>
+ *
+ *   // Read-only section — self-managed layout
+ *   <FormSection title="Importateur" cols="none">
+ *     <KVGrid minColumnWidth={180}>...</KVGrid>
+ *   </FormSection>
+ */
+export interface FormSectionProps {
+    number?: number | string | undefined;
+    title: React.ReactNode;
+    description?: React.ReactNode | undefined;
+    actions?: React.ReactNode | undefined;
+    srLabel?: ((n: number | string) => React.ReactNode) | undefined;
+    headingLevel?: 2 | 3 | 4 | 5 | 6 | undefined;
+    /**
+     * cols — Charter R-3.2 field layout.
+     *   3 (DEFAULT) : 3 equal columns — standard form layout.
+     *   2 | 1       : fewer columns for narrow/simple forms.
+     *   "auto"      : auto-fill tracks min 220px.
+     *   "none"      : no grid wrapper — children manage own layout.
+     */
+    cols?: number | "auto" | "none" | undefined;
+    /**
+     * Gap forwarded to the inner `FormGrid`. Omit to inherit the charter default
+     * (`--s-4`). Ignored when `cols="none"`, where the child owns its layout.
+     *
+     * Added for gap G-13: `FormSection` wrapped its children in a `FormGrid` but
+     * exposed no way to set that grid's gap, so a section needing a non-default
+     * spacing had to abandon `cols` entirely and nest its own `FormGrid` — or,
+     * as every audited module actually did, hand-roll a raw `Box` grid and
+     * reimplement the breakpoint ladder.
+     */
+    gap?: string | number | undefined;
+    children: React.ReactNode;
+    sx?: SxProps<Theme> | undefined;
+}
+declare function FormSection({ number, title, description, actions, srLabel, headingLevel, cols, gap, children, sx, }: FormSectionProps): React.JSX.Element;
+export default FormSection;
+//# sourceMappingURL=FormSection.d.ts.map

package/dist/v2/patterns/FormSection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormSection.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/patterns/FormSection.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAI3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACrC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IAC1C,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IACtC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,KAAK,KAAK,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;IAChE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IAC7C;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC5C;;;;;;;;;OASG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;CACjC;AAaD,iBAAS,WAAW,CAAC,EACnB,MAAM,EACN,KAAK,EACL,WAAW,EACX,OAAO,EACP,OAA0B,EAC1B,YAAgB,EAChB,IAAQ,EACR,GAAG,EACH,QAAQ,EACR,EAAE,GACH,EAAE,gBAAgB,qBAyHlB;AAED,eAAe,WAAW,CAAC"}