@portnet/ui 6.0.1 → 6.0.3

package/dist/v2/patterns/FormSection.js

@@ -1,30 +1,18 @@
 "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;
+exports.default = void 0;
 var React = _interopRequireWildcard(require("react"));
 var _Box = _interopRequireDefault(require("@mui/material/Box"));
 var _Typography = _interopRequireDefault(require("@mui/material/Typography"));
 var _FormGrid = _interopRequireDefault(require("../components/FormGrid"));
 var _Surface = _interopRequireDefault(require("../components/Surface"));
 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 ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
-function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
-function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
-function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return _typeof(key) === "symbol" ? key : String(key); }
-function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (_typeof(res) !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
-function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
-function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
-function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
-function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
-function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
-function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; } /**
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+/**
  * FormSection - Portnet UI v2 (pattern)
  *
  * Charter R-3.1 — groups form fields into named, numbered sections.
@@ -35,7 +23,8 @@ function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len
  *   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.
+ *   "none"  — no grid wrapper — children manage their own layout, stacked in
+ *             a flex column with `gap` (default --s-4).
  *             Use for: KVGrid, DataGrid, nested FormGrid.
  *
  * Full-width items within a 3-col section:
@@ -54,9 +43,8 @@ function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len
  *     <KVGrid minColumnWidth={180}>...</KVGrid>
  *   </FormSection>
  */
-var DEFAULT_SR_LABEL = function DEFAULT_SR_LABEL(n) {
-  return "Section ".concat(n, " : ");
-};
+
+const DEFAULT_SR_LABEL = n => `Section ${n} : `;
 function resolveGridProps(cols) {
   if (!cols || cols === "none") return null;
   if (cols === "auto") return {
@@ -67,22 +55,20 @@ function resolveGridProps(cols) {
   };
   return null;
 }
-function FormSection(_ref) {
-  var number = _ref.number,
-    title = _ref.title,
-    description = _ref.description,
-    actions = _ref.actions,
-    _ref$srLabel = _ref.srLabel,
-    srLabel = _ref$srLabel === void 0 ? DEFAULT_SR_LABEL : _ref$srLabel,
-    _ref$headingLevel = _ref.headingLevel,
-    headingLevel = _ref$headingLevel === void 0 ? 2 : _ref$headingLevel,
-    _ref$cols = _ref.cols,
-    cols = _ref$cols === void 0 ? 3 : _ref$cols,
-    gap = _ref.gap,
-    children = _ref.children,
-    sx = _ref.sx;
-  var HeadingTag = "h".concat(headingLevel);
-  var gridProps = resolveGridProps(cols);
+function FormSection({
+  number,
+  title,
+  description,
+  actions,
+  srLabel = DEFAULT_SR_LABEL,
+  headingLevel = 2,
+  cols = 3,
+  gap,
+  children,
+  sx
+}) {
+  const HeadingTag = `h${headingLevel}`;
+  const gridProps = resolveGridProps(cols);
   return (
     /*#__PURE__*/
     /*
@@ -97,7 +83,7 @@ function FormSection(_ref) {
      * byte for byte: FormSection pads its header and body separately, and never
      * carried a shadow.
      */
-    (0, _jsxRuntime.jsxs)(_Surface["default"], {
+    (0, _jsxRuntime.jsxs)(_Surface.default, {
       padding: "none",
       elevation: "none",
       radius: "lg"
@@ -107,8 +93,8 @@ function FormSection(_ref) {
        * everything. Surface forwards the array through to its own composition. */,
       sx: [{
         marginBottom: 3
-      }].concat(_toConsumableArray(Array.isArray(sx) ? sx : sx ? [sx] : [])),
-      children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)(_Box["default"], {
+      }, ...(Array.isArray(sx) ? sx : sx ? [sx] : [])],
+      children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)(_Box.default, {
         sx: {
           padding: "var(--s-4) var(--s-5)",
           borderBottom: "1px solid var(--border)",
@@ -117,7 +103,7 @@ function FormSection(_ref) {
           justifyContent: "space-between",
           gap: 2
         },
-        children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)(_Box["default"], {
+        children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)(_Box.default, {
           sx: {
             display: "flex",
             gap: 2,
@@ -125,7 +111,7 @@ function FormSection(_ref) {
             flex: 1,
             minWidth: 0
           },
-          children: [number != null && /*#__PURE__*/(0, _jsxRuntime.jsx)(_Box["default"], {
+          children: [number != null && /*#__PURE__*/(0, _jsxRuntime.jsx)(_Box.default, {
             "aria-hidden": "true",
             sx: {
               flexShrink: 0,
@@ -140,11 +126,11 @@ function FormSection(_ref) {
               fontWeight: "var(--fw-bold)"
             },
             children: number
-          }), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_Box["default"], {
+          }), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_Box.default, {
             sx: {
               minWidth: 0
             },
-            children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)(_Typography["default"], {
+            children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)(_Typography.default, {
               component: HeadingTag,
               sx: {
                 /* R-2.3 / R-AI.1 MUST — was a bare `15`, a magic font-size no
@@ -164,7 +150,7 @@ function FormSection(_ref) {
                 className: "pui-sr-only",
                 children: srLabel(number)
               }), title]
-            }), description && /*#__PURE__*/(0, _jsxRuntime.jsx)(_Typography["default"], {
+            }), description && /*#__PURE__*/(0, _jsxRuntime.jsx)(_Typography.default, {
               sx: {
                 fontSize: "var(--text-xs)",
                 color: "var(--fg-muted)",
@@ -174,9 +160,14 @@ function FormSection(_ref) {
             })]
           })]
         }), actions]
-      }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_Box["default"], {
+      }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_Box.default, {
         sx: {
-          padding: "var(--s-5)"
+          padding: "var(--s-5)",
+          ...(gridProps ? null : {
+            display: "flex",
+            flexDirection: "column",
+            gap: gap ?? "var(--s-4)"
+          })
         },
         children: gridProps ?
         /*#__PURE__*/
@@ -184,14 +175,16 @@ function FormSection(_ref) {
          * declares it optional, and forwarding an explicit `undefined` is
          * what breaks under exactOptionalPropertyTypes. Omitting the key is
          * what "inherit the charter default" means. */
-        (0, _jsxRuntime.jsx)(_FormGrid["default"], _objectSpread(_objectSpread(_objectSpread({}, gridProps), gap !== undefined ? {
-          gap: gap
-        } : {}), {}, {
+        (0, _jsxRuntime.jsx)(_FormGrid.default, {
+          ...gridProps,
+          ...(gap !== undefined ? {
+            gap
+          } : {}),
           children: children
-        })) : children
+        }) : children
       })]
     })
   );
 }
-var _default = exports["default"] = FormSection;
+var _default = exports.default = FormSection;
 //# sourceMappingURL=FormSection.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"FormSection.js","names":["React","_interopRequireWildcard","require","_Box","_interopRequireDefault","_Typography","_FormGrid","_Surface","_jsxRuntime","obj","__esModule","_getRequireWildcardCache","nodeInterop","WeakMap","cacheBabelInterop","cacheNodeInterop","_typeof","cache","has","get","newObj","hasPropertyDescriptor","Object","defineProperty","getOwnPropertyDescriptor","key","prototype","hasOwnProperty","call","desc","set","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","Symbol","toPrimitive","undefined","res","TypeError","Number","_toConsumableArray","arr","_arrayWithoutHoles","_iterableToArray","_unsupportedIterableToArray","_nonIterableSpread","o","minLen","_arrayLikeToArray","n","toString","slice","constructor","name","Array","from","test","iter","iterator","isArray","len","arr2","DEFAULT_SR_LABEL","concat","resolveGridProps","cols","minColumnWidth","columns","FormSection","_ref","number","title","description","actions","_ref$srLabel","srLabel","_ref$headingLevel","headingLevel","_ref$cols","gap","children","sx","HeadingTag","gridProps","jsxs","padding","elevation","radius","marginBottom","borderBottom","display","alignItems","justifyContent","flex","minWidth","jsx","flexShrink","width","height","borderRadius","background","color","placeItems","fontSize","fontWeight","component","lineHeight","margin","className","marginTop","_default","exports"],"sources":["../../../src/lib/v2/patterns/FormSection.tsx"],"sourcesContent":["import * as React from \"react\";\r\nimport Box from \"@mui/material/Box\";\r\nimport Typography from \"@mui/material/Typography\";\r\nimport type { SxProps, Theme } from \"@mui/material/styles\";\r\nimport FormGrid from \"../components/FormGrid\";\r\nimport Surface from \"../components/Surface\";\r\n\r\n/**\r\n * FormSection - Portnet UI v2 (pattern)\r\n *\r\n * Charter R-3.1 — groups form fields into named, numbered sections.\r\n * Charter R-3.2 — 3-column grid is the standard for form sections.\r\n *\r\n * cols (default 3):\r\n *   3       — three equal columns (DEFAULT — standard form layout)\r\n *   2       — two equal columns (narrow forms, few fields, wide labels)\r\n *   1       — single column (textareas, file uploads, notes)\r\n *   \"auto\"  — auto-fill tracks min 220px\r\n *   \"none\"  — no grid wrapper — children manage their own layout.\r\n *             Use for: KVGrid, DataGrid, nested FormGrid.\r\n *\r\n * Full-width items within a 3-col section:\r\n *   <FormGrid.Full><FormikTextarea name=\"obs\" /></FormGrid.Full>\r\n *\r\n * Usage:\r\n *   // Standard form section — 3 cols (no need to specify)\r\n *   <FormSection number={1} title=\"Identification\">\r\n *     <FormikInput name=\"nom\" label=\"Nom\" />\r\n *     <FormikInput name=\"prenom\" label=\"Prénom\" />\r\n *     <FormikInput name=\"code\" label=\"Code\" />\r\n *   </FormSection>\r\n *\r\n *   // Read-only section — self-managed layout\r\n *   <FormSection title=\"Importateur\" cols=\"none\">\r\n *     <KVGrid minColumnWidth={180}>...</KVGrid>\r\n *   </FormSection>\r\n */\r\n\r\nexport interface FormSectionProps {\r\n  number?: number | string | undefined;\r\n  title: React.ReactNode;\r\n  description?: React.ReactNode | undefined;\r\n  actions?: React.ReactNode | undefined;\r\n  srLabel?: ((n: number | string) => React.ReactNode) | undefined;\r\n  headingLevel?: 2 | 3 | 4 | 5 | 6 | undefined;\r\n  /**\r\n   * cols — Charter R-3.2 field layout.\r\n   *   3 (DEFAULT) : 3 equal columns — standard form layout.\r\n   *   2 | 1       : fewer columns for narrow/simple forms.\r\n   *   \"auto\"      : auto-fill tracks min 220px.\r\n   *   \"none\"      : no grid wrapper — children manage own layout.\r\n   */\r\n  cols?: number | \"auto\" | \"none\" | undefined;\r\n  /**\r\n   * Gap forwarded to the inner `FormGrid`. Omit to inherit the charter default\r\n   * (`--s-4`). Ignored when `cols=\"none\"`, where the child owns its layout.\r\n   *\r\n   * Added for gap G-13: `FormSection` wrapped its children in a `FormGrid` but\r\n   * exposed no way to set that grid's gap, so a section needing a non-default\r\n   * spacing had to abandon `cols` entirely and nest its own `FormGrid` — or,\r\n   * as every audited module actually did, hand-roll a raw `Box` grid and\r\n   * reimplement the breakpoint ladder.\r\n   */\r\n  gap?: string | number | undefined;\r\n  children: React.ReactNode;\r\n  sx?: SxProps<Theme> | undefined;\r\n}\r\n\r\nconst DEFAULT_SR_LABEL = (n: number | string): string => `Section ${n} : `;\r\n\r\nfunction resolveGridProps(\r\n  cols: number | \"auto\" | \"none\" | undefined\r\n): { minColumnWidth: number } | { columns: number } | null {\r\n  if (!cols || cols === \"none\") return null;\r\n  if (cols === \"auto\") return { minColumnWidth: 220 };\r\n  if (typeof cols === \"number\") return { columns: cols };\r\n  return null;\r\n}\r\n\r\nfunction FormSection({\r\n  number,\r\n  title,\r\n  description,\r\n  actions,\r\n  srLabel = DEFAULT_SR_LABEL,\r\n  headingLevel = 2,\r\n  cols = 3,\r\n  gap,\r\n  children,\r\n  sx,\r\n}: FormSectionProps) {\r\n  const HeadingTag = `h${headingLevel}` as const;\r\n  const gridProps = resolveGridProps(cols);\r\n\r\n  return (\r\n    /*\r\n     * The card container is the shared `Surface` primitive (gap G-10), not an\r\n     * inline recipe. This component USED to hold the only copy of\r\n     * --surface + --border + -r-lg in the library, which is precisely why every\r\n     * consuming module rewrote it: the recipe was reachable only by also taking\r\n     * a numbered heading and an inner FormGrid. Dogfooding it here means a\r\n     * charter change to the card radius or elevation lands in ONE file.\r\n     *\r\n     * `padding=\"none\"` / `elevation=\"none\"` reproduce the previous rendering\r\n     * byte for byte: FormSection pads its header and body separately, and never\r\n     * carried a shadow.\r\n     */\r\n    <Surface\r\n      padding=\"none\"\r\n      elevation=\"none\"\r\n      radius=\"lg\"\r\n      /* ARRAY form (gap G-23). This line previously spread `sx` into an object,\r\n       * which silently destroys the array and function shapes `SxProps<Theme>`\r\n       * allows — so a host writing MUI's own `sx={[base, cond && override]}` lost\r\n       * everything. Surface forwards the array through to its own composition. */\r\n      sx={[{ marginBottom: 3 }, ...(Array.isArray(sx) ? sx : sx ? [sx] : [])]}\r\n    >\r\n      {/* Section header */}\r\n      <Box\r\n        sx={{\r\n          padding: \"var(--s-4) var(--s-5)\",\r\n          borderBottom: \"1px solid var(--border)\",\r\n          display: \"flex\",\r\n          alignItems: \"flex-start\",\r\n          justifyContent: \"space-between\",\r\n          gap: 2,\r\n        }}\r\n      >\r\n        <Box\r\n          sx={{\r\n            display: \"flex\",\r\n            gap: 2,\r\n            alignItems: \"flex-start\",\r\n            flex: 1,\r\n            minWidth: 0,\r\n          }}\r\n        >\r\n          {number != null && (\r\n            <Box\r\n              aria-hidden=\"true\"\r\n              sx={{\r\n                flexShrink: 0,\r\n                width: 28,\r\n                height: 28,\r\n                borderRadius: \"var(--r-full)\",\r\n                background: \"var(--accent-soft)\",\r\n                color: \"var(--accent)\",\r\n                display: \"grid\",\r\n                placeItems: \"center\",\r\n                fontSize: \"var(--text-sm)\",\r\n                fontWeight: \"var(--fw-bold)\",\r\n              }}\r\n            >\r\n              {number}\r\n            </Box>\r\n          )}\r\n          <Box sx={{ minWidth: 0 }}>\r\n            <Typography\r\n              component={HeadingTag}\r\n              sx={{\r\n                /* R-2.3 / R-AI.1 MUST — was a bare `15`, a magic font-size no\r\n                 * token can express (the type scale is 12/13/14/16/20/26).\r\n                 * The Charter's own typography table assigns --text-h3 (16px)\r\n                 * to \"Card / form group\" titles, which is exactly what a\r\n                 * FormSection header is. Fleet-wide 15→16px on section\r\n                 * headers — needs visual confirmation, but 15 could not\r\n                 * remain: it is unrepresentable in the token system. */\r\n                fontSize: \"var(--text-h3)\",\r\n                fontWeight: \"var(--fw-bold)\",\r\n                color: \"var(--fg)\",\r\n                lineHeight: \"var(--lh-snug)\",\r\n                margin: 0,\r\n              }}\r\n            >\r\n              {number != null && (\r\n                <span className=\"pui-sr-only\">{srLabel(number)}</span>\r\n              )}\r\n              {title}\r\n            </Typography>\r\n            {description && (\r\n              <Typography\r\n                sx={{\r\n                  fontSize: \"var(--text-xs)\",\r\n                  color: \"var(--fg-muted)\",\r\n                  marginTop: 0.25,\r\n                }}\r\n              >\r\n                {description}\r\n              </Typography>\r\n            )}\r\n          </Box>\r\n        </Box>\r\n        {actions}\r\n      </Box>\r\n\r\n      {/* Section body */}\r\n      <Box sx={{ padding: \"var(--s-5)\" }}>\r\n        {gridProps ? (\r\n          /* `gap` applied by CONDITIONAL SPREAD, not `gap={gap}`: FormGridProps\r\n           * declares it optional, and forwarding an explicit `undefined` is\r\n           * what breaks under exactOptionalPropertyTypes. Omitting the key is\r\n           * what \"inherit the charter default\" means. */\r\n          <FormGrid {...gridProps} {...(gap !== undefined ? { gap } : {})}>\r\n            {children}\r\n          </FormGrid>\r\n        ) : (\r\n          children\r\n        )}\r\n      </Box>\r\n    </Surface>\r\n  );\r\n}\r\n\r\nexport default FormSection;\r\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"FormSection.js","names":["React","_interopRequireWildcard","require","_Box","_interopRequireDefault","_Typography","_FormGrid","_Surface","_jsxRuntime","e","__esModule","default","t","WeakMap","r","n","o","i","f","__proto__","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","DEFAULT_SR_LABEL","resolveGridProps","cols","minColumnWidth","columns","FormSection","number","title","description","actions","srLabel","headingLevel","gap","children","sx","HeadingTag","gridProps","jsxs","padding","elevation","radius","marginBottom","Array","isArray","borderBottom","display","alignItems","justifyContent","flex","minWidth","jsx","flexShrink","width","height","borderRadius","background","color","placeItems","fontSize","fontWeight","component","lineHeight","margin","className","marginTop","flexDirection","undefined","_default","exports"],"sources":["../../../src/lib/v2/patterns/FormSection.tsx"],"sourcesContent":["import * as React from \"react\";\r\nimport Box from \"@mui/material/Box\";\r\nimport Typography from \"@mui/material/Typography\";\r\nimport type { SxProps, Theme } from \"@mui/material/styles\";\r\nimport FormGrid from \"../components/FormGrid\";\r\nimport Surface from \"../components/Surface\";\r\n\r\n/**\r\n * FormSection - Portnet UI v2 (pattern)\r\n *\r\n * Charter R-3.1 — groups form fields into named, numbered sections.\r\n * Charter R-3.2 — 3-column grid is the standard for form sections.\r\n *\r\n * cols (default 3):\r\n *   3       — three equal columns (DEFAULT — standard form layout)\r\n *   2       — two equal columns (narrow forms, few fields, wide labels)\r\n *   1       — single column (textareas, file uploads, notes)\r\n *   \"auto\"  — auto-fill tracks min 220px\r\n *   \"none\"  — no grid wrapper — children manage their own layout, stacked in\r\n *             a flex column with `gap` (default --s-4).\r\n *             Use for: KVGrid, DataGrid, nested FormGrid.\r\n *\r\n * Full-width items within a 3-col section:\r\n *   <FormGrid.Full><FormikTextarea name=\"obs\" /></FormGrid.Full>\r\n *\r\n * Usage:\r\n *   // Standard form section — 3 cols (no need to specify)\r\n *   <FormSection number={1} title=\"Identification\">\r\n *     <FormikInput name=\"nom\" label=\"Nom\" />\r\n *     <FormikInput name=\"prenom\" label=\"Prénom\" />\r\n *     <FormikInput name=\"code\" label=\"Code\" />\r\n *   </FormSection>\r\n *\r\n *   // Read-only section — self-managed layout\r\n *   <FormSection title=\"Importateur\" cols=\"none\">\r\n *     <KVGrid minColumnWidth={180}>...</KVGrid>\r\n *   </FormSection>\r\n */\r\n\r\nexport interface FormSectionProps {\r\n  number?: number | string | undefined;\r\n  title: React.ReactNode;\r\n  description?: React.ReactNode | undefined;\r\n  actions?: React.ReactNode | undefined;\r\n  srLabel?: ((n: number | string) => React.ReactNode) | undefined;\r\n  headingLevel?: 2 | 3 | 4 | 5 | 6 | undefined;\r\n  /**\r\n   * cols — Charter R-3.2 field layout.\r\n   *   3 (DEFAULT) : 3 equal columns — standard form layout.\r\n   *   2 | 1       : fewer columns for narrow/simple forms.\r\n   *   \"auto\"      : auto-fill tracks min 220px.\r\n   *   \"none\"      : no grid wrapper — children manage own layout.\r\n   */\r\n  cols?: number | \"auto\" | \"none\" | undefined;\r\n  /**\r\n   * Gap between the section's children. Forwarded to the inner `FormGrid`\r\n   * when `cols` is a grid preset; applied to the body's own flex column when\r\n   * `cols=\"none\"`. Omit to inherit the charter default (`--s-4`).\r\n   *\r\n   * Added for gap G-13: `FormSection` wrapped its children in a `FormGrid` but\r\n   * exposed no way to set that grid's gap, so a section needing a non-default\r\n   * spacing had to abandon `cols` entirely and nest its own `FormGrid` — or,\r\n   * as every audited module actually did, hand-roll a raw `Box` grid and\r\n   * reimplement the breakpoint ladder.\r\n   *\r\n   * Extended for gap G-47: it used to be IGNORED under `cols=\"none\"`, where\r\n   * the body was a bare padded box. See the body note below.\r\n   */\r\n  gap?: string | number | undefined;\r\n  children: React.ReactNode;\r\n  sx?: SxProps<Theme> | undefined;\r\n}\r\n\r\nconst DEFAULT_SR_LABEL = (n: number | string): string => `Section ${n} : `;\r\n\r\nfunction resolveGridProps(\r\n  cols: number | \"auto\" | \"none\" | undefined\r\n): { minColumnWidth: number } | { columns: number } | null {\r\n  if (!cols || cols === \"none\") return null;\r\n  if (cols === \"auto\") return { minColumnWidth: 220 };\r\n  if (typeof cols === \"number\") return { columns: cols };\r\n  return null;\r\n}\r\n\r\nfunction FormSection({\r\n  number,\r\n  title,\r\n  description,\r\n  actions,\r\n  srLabel = DEFAULT_SR_LABEL,\r\n  headingLevel = 2,\r\n  cols = 3,\r\n  gap,\r\n  children,\r\n  sx,\r\n}: FormSectionProps) {\r\n  const HeadingTag = `h${headingLevel}` as const;\r\n  const gridProps = resolveGridProps(cols);\r\n\r\n  return (\r\n    /*\r\n     * The card container is the shared `Surface` primitive (gap G-10), not an\r\n     * inline recipe. This component USED to hold the only copy of\r\n     * --surface + --border + -r-lg in the library, which is precisely why every\r\n     * consuming module rewrote it: the recipe was reachable only by also taking\r\n     * a numbered heading and an inner FormGrid. Dogfooding it here means a\r\n     * charter change to the card radius or elevation lands in ONE file.\r\n     *\r\n     * `padding=\"none\"` / `elevation=\"none\"` reproduce the previous rendering\r\n     * byte for byte: FormSection pads its header and body separately, and never\r\n     * carried a shadow.\r\n     */\r\n    <Surface\r\n      padding=\"none\"\r\n      elevation=\"none\"\r\n      radius=\"lg\"\r\n      /* ARRAY form (gap G-23). This line previously spread `sx` into an object,\r\n       * which silently destroys the array and function shapes `SxProps<Theme>`\r\n       * allows — so a host writing MUI's own `sx={[base, cond && override]}` lost\r\n       * everything. Surface forwards the array through to its own composition. */\r\n      sx={[{ marginBottom: 3 }, ...(Array.isArray(sx) ? sx : sx ? [sx] : [])]}\r\n    >\r\n      {/* Section header */}\r\n      <Box\r\n        sx={{\r\n          padding: \"var(--s-4) var(--s-5)\",\r\n          borderBottom: \"1px solid var(--border)\",\r\n          display: \"flex\",\r\n          alignItems: \"flex-start\",\r\n          justifyContent: \"space-between\",\r\n          gap: 2,\r\n        }}\r\n      >\r\n        <Box\r\n          sx={{\r\n            display: \"flex\",\r\n            gap: 2,\r\n            alignItems: \"flex-start\",\r\n            flex: 1,\r\n            minWidth: 0,\r\n          }}\r\n        >\r\n          {number != null && (\r\n            <Box\r\n              aria-hidden=\"true\"\r\n              sx={{\r\n                flexShrink: 0,\r\n                width: 28,\r\n                height: 28,\r\n                borderRadius: \"var(--r-full)\",\r\n                background: \"var(--accent-soft)\",\r\n                color: \"var(--accent)\",\r\n                display: \"grid\",\r\n                placeItems: \"center\",\r\n                fontSize: \"var(--text-sm)\",\r\n                fontWeight: \"var(--fw-bold)\",\r\n              }}\r\n            >\r\n              {number}\r\n            </Box>\r\n          )}\r\n          <Box sx={{ minWidth: 0 }}>\r\n            <Typography\r\n              component={HeadingTag}\r\n              sx={{\r\n                /* R-2.3 / R-AI.1 MUST — was a bare `15`, a magic font-size no\r\n                 * token can express (the type scale is 12/13/14/16/20/26).\r\n                 * The Charter's own typography table assigns --text-h3 (16px)\r\n                 * to \"Card / form group\" titles, which is exactly what a\r\n                 * FormSection header is. Fleet-wide 15→16px on section\r\n                 * headers — needs visual confirmation, but 15 could not\r\n                 * remain: it is unrepresentable in the token system. */\r\n                fontSize: \"var(--text-h3)\",\r\n                fontWeight: \"var(--fw-bold)\",\r\n                color: \"var(--fg)\",\r\n                lineHeight: \"var(--lh-snug)\",\r\n                margin: 0,\r\n              }}\r\n            >\r\n              {number != null && (\r\n                <span className=\"pui-sr-only\">{srLabel(number)}</span>\r\n              )}\r\n              {title}\r\n            </Typography>\r\n            {description && (\r\n              <Typography\r\n                sx={{\r\n                  fontSize: \"var(--text-xs)\",\r\n                  color: \"var(--fg-muted)\",\r\n                  marginTop: 0.25,\r\n                }}\r\n              >\r\n                {description}\r\n              </Typography>\r\n            )}\r\n          </Box>\r\n        </Box>\r\n        {actions}\r\n      </Box>\r\n\r\n      {/* Section body\r\n        *\r\n        * GAP UNDER `cols=\"none\"` (gap G-47). This was a bare padded box, so a\r\n        * section whose children manage their own layout had NO spacing between\r\n        * them — and the only tool left to the host was a margin on the second\r\n        * child, which R-S.2 (MUST) forbids: \"Utiliser flex/grid + gap ; jamais\r\n        * d'espacement par margin sur sibling adjacent\". The library was\r\n        * therefore forcing every read-only or mixed section in the fleet into a\r\n        * charter violation; `refonte-frontend`'s Area 7 audit counted 3 uses of\r\n        * `gap` against ~30 sibling margins, most of them here.\r\n        *\r\n        * A flex column is a no-op for the single-child case (one KVGrid, one\r\n        * DataGrid — the majority), and supplies the missing rhythm as soon as\r\n        * there are two. `gap` is now honoured here too, which is what its own\r\n        * doc above promised and did not deliver. */}\r\n      <Box\r\n        sx={{\r\n          padding: \"var(--s-5)\",\r\n          ...(gridProps\r\n            ? null\r\n            : {\r\n                display: \"flex\",\r\n                flexDirection: \"column\",\r\n                gap: gap ?? \"var(--s-4)\",\r\n              }),\r\n        }}\r\n      >\r\n        {gridProps ? (\r\n          /* `gap` applied by CONDITIONAL SPREAD, not `gap={gap}`: FormGridProps\r\n           * declares it optional, and forwarding an explicit `undefined` is\r\n           * what breaks under exactOptionalPropertyTypes. Omitting the key is\r\n           * what \"inherit the charter default\" means. */\r\n          <FormGrid {...gridProps} {...(gap !== undefined ? { gap } : {})}>\r\n            {children}\r\n          </FormGrid>\r\n        ) : (\r\n          children\r\n        )}\r\n      </Box>\r\n    </Surface>\r\n  );\r\n}\r\n\r\nexport default FormSection;\r\n"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,77 @@
+/**
+ * FormikCheckbox — bridge between Formik state and v2.Field + v2.Checkbox,
+ * for a SINGLE BOOLEAN field.
+ *
+ * ── WHY THIS EXISTS ALONGSIDE FormikCheckboxGroup (gap G-A) ──────────
+ *
+ * `FormikCheckboxGroup` holds an ARRAY of selected values. That is the right
+ * model for "pick several from a list", and the wrong one for a lone flag:
+ *
+ *     autreInfo.fabrication      -> boolean
+ *     objectDeclaration.premiereDeclaration -> boolean
+ *
+ * A host with boolean-shaped state cannot adopt the group bridge without
+ * changing what its payload sends, so every module ended up re-wiring
+ * `Checkbox` + `useField` by hand — the exact duplication R-2.1 forbids, and
+ * the one place where it hurts most: hand-rolled bridges lose the error
+ * rendering. Reported from refonte-frontend (lot 5), whose local masked/checked
+ * inputs displayed no validation message at all, so a required-field error was
+ * invisible to the user (R-4.1 MUST).
+ *
+ * Usage:
+ *
+ *   import { FormikCheckbox } from "@portnet/ui/lib/v2";
+ *
+ *   <FormikCheckbox
+ *     name="autreInfo.fabrication"
+ *     label="Fabrication"
+ *   />
+ *
+ *   <FormikCheckbox
+ *     name="conditions"
+ *     label="J'accepte les conditions"
+ *     required
+ *     hint="Obligatoire pour soumettre la demande"
+ *   />
+ *
+ * ── WHY THE CHECKBOX IS WRAPPED IN A CheckboxGroup ──────────────────
+ *
+ * `Field` clones its child with `error` and `disabled` props, because several
+ * v2 inputs read them directly. `MuiCheckbox` spreads unknown props down to
+ * the native `<input>`, so a bare `Checkbox` inside `Field` would emit
+ * `error="false"` onto the DOM (React warning, invalid attribute).
+ * `CheckboxGroup` destructures its props explicitly and drops the rest, and it
+ * forwards the ARIA grouping attributes `Field` injects. Same composition as
+ * `FormikCheckboxGroup`, for the same reason.
+ *
+ * ── LABEL AND REQUIRED ──────────────────────────────────────────────
+ *
+ * The label belongs to the CHECKBOX (rendered by `FormControlLabel`, which
+ * names the input implicitly), not above the field: a lone checkbox with a
+ * field label AND a control label reads as two questions. `Field` therefore
+ * receives no label, and `required` is expressed twice where it counts —
+ * visually by the asterisk appended to the control label, and to assistive
+ * technology by `aria-required` on the input itself (`Field`'s own injection
+ * lands on the group, which does not forward it).
+ *
+ * Errors surface only once the field is touched, and toggling marks it touched
+ * — same semantics as `FormikCheckboxGroup`. A checkbox has no meaningful
+ * blur-before-change, so waiting for a blur would keep the message hidden.
+ *
+ * Charter §03 · R-I.2, R-I.3, R-4.1. Peer dependency: formik >= 2.x.
+ */
+import * as React from "react";
+export interface FormikCheckboxProps {
+    name: string;
+    /** Label rendered next to the checkbox — it names the control. */
+    label?: React.ReactNode | undefined;
+    /** Adds the asterisk on the label and `aria-required` on the input. */
+    required?: boolean | undefined;
+    disabled?: boolean | undefined;
+    hint?: React.ReactNode | undefined;
+    /** Native `<input>` attributes, routed to the checkbox input (v9 slot). */
+    inputProps?: React.InputHTMLAttributes<HTMLInputElement> | undefined;
+}
+declare const FormikCheckbox: ({ name, label, required, disabled, hint, inputProps, }: FormikCheckboxProps) => React.JSX.Element;
+export default FormikCheckbox;
+//# sourceMappingURL=FormikCheckbox.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FormikCheckbox.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/patterns/FormikCheckbox.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAM/B,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IACpC,uEAAuE;IACvE,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IACnC,2EAA2E;IAC3E,UAAU,CAAC,EAAE,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,GAAG,SAAS,CAAC;CACtE;AAED,QAAA,MAAM,cAAc,GAAI,wDAOrB,mBAAmB,sBAwDrB,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/v2/patterns/FormikCheckbox.js

@@ -0,0 +1,138 @@
+"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 _formik = require("formik");
+var _Field = _interopRequireDefault(require("../components/Field"));
+var _Checkbox = require("../components/Checkbox");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+/**
+ * FormikCheckbox — bridge between Formik state and v2.Field + v2.Checkbox,
+ * for a SINGLE BOOLEAN field.
+ *
+ * ── WHY THIS EXISTS ALONGSIDE FormikCheckboxGroup (gap G-A) ──────────
+ *
+ * `FormikCheckboxGroup` holds an ARRAY of selected values. That is the right
+ * model for "pick several from a list", and the wrong one for a lone flag:
+ *
+ *     autreInfo.fabrication      -> boolean
+ *     objectDeclaration.premiereDeclaration -> boolean
+ *
+ * A host with boolean-shaped state cannot adopt the group bridge without
+ * changing what its payload sends, so every module ended up re-wiring
+ * `Checkbox` + `useField` by hand — the exact duplication R-2.1 forbids, and
+ * the one place where it hurts most: hand-rolled bridges lose the error
+ * rendering. Reported from refonte-frontend (lot 5), whose local masked/checked
+ * inputs displayed no validation message at all, so a required-field error was
+ * invisible to the user (R-4.1 MUST).
+ *
+ * Usage:
+ *
+ *   import { FormikCheckbox } from "@portnet/ui/lib/v2";
+ *
+ *   <FormikCheckbox
+ *     name="autreInfo.fabrication"
+ *     label="Fabrication"
+ *   />
+ *
+ *   <FormikCheckbox
+ *     name="conditions"
+ *     label="J'accepte les conditions"
+ *     required
+ *     hint="Obligatoire pour soumettre la demande"
+ *   />
+ *
+ * ── WHY THE CHECKBOX IS WRAPPED IN A CheckboxGroup ──────────────────
+ *
+ * `Field` clones its child with `error` and `disabled` props, because several
+ * v2 inputs read them directly. `MuiCheckbox` spreads unknown props down to
+ * the native `<input>`, so a bare `Checkbox` inside `Field` would emit
+ * `error="false"` onto the DOM (React warning, invalid attribute).
+ * `CheckboxGroup` destructures its props explicitly and drops the rest, and it
+ * forwards the ARIA grouping attributes `Field` injects. Same composition as
+ * `FormikCheckboxGroup`, for the same reason.
+ *
+ * ── LABEL AND REQUIRED ──────────────────────────────────────────────
+ *
+ * The label belongs to the CHECKBOX (rendered by `FormControlLabel`, which
+ * names the input implicitly), not above the field: a lone checkbox with a
+ * field label AND a control label reads as two questions. `Field` therefore
+ * receives no label, and `required` is expressed twice where it counts —
+ * visually by the asterisk appended to the control label, and to assistive
+ * technology by `aria-required` on the input itself (`Field`'s own injection
+ * lands on the group, which does not forward it).
+ *
+ * Errors surface only once the field is touched, and toggling marks it touched
+ * — same semantics as `FormikCheckboxGroup`. A checkbox has no meaningful
+ * blur-before-change, so waiting for a blur would keep the message hidden.
+ *
+ * Charter §03 · R-I.2, R-I.3, R-4.1. Peer dependency: formik >= 2.x.
+ */
+
+const FormikCheckbox = ({
+  name,
+  label,
+  required,
+  disabled,
+  hint,
+  inputProps
+}) => {
+  const [field, meta] = (0, _formik.useField)(name);
+  const {
+    setFieldValue,
+    setFieldTouched
+  } = (0, _formik.useFormikContext)();
+  const hasError = Boolean(meta.touched && meta.error);
+  const handleChange = event => {
+    setFieldValue(name, event.target.checked);
+    setFieldTouched(name, true, false);
+  };
+
+  /* `=== true` and not a truthy test: hosts seed these fields with `null`
+   * (a not-yet-answered flag), and `checked={null}` makes the input
+   * uncontrolled for one render. */
+  const checked = field.value === true;
+  const controlLabel = required ? /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
+    children: [label, /*#__PURE__*/(0, _jsxRuntime.jsx)(_Box.default, {
+      component: "span",
+      "aria-hidden": "true",
+      sx: {
+        color: "var(--danger)",
+        fontWeight: "var(--fw-bold, 700)",
+        marginInlineStart: "var(--s-1)"
+      },
+      children: "*"
+    })]
+  }) : label;
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Field.default, {
+    error: hasError ? meta.error : null,
+    hint: !hasError ? hint : undefined,
+    group: true,
+    ...(disabled !== undefined ? {
+      disabled
+    } : {}),
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Checkbox.CheckboxGroup, {
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Checkbox.Checkbox, {
+        name: name,
+        label: controlLabel,
+        checked: checked,
+        onChange: handleChange,
+        disabled: disabled,
+        inputProps: {
+          ...(required ? {
+            "aria-required": "true"
+          } : {}),
+          ...inputProps
+        }
+      })
+    })
+  });
+};
+var _default = exports.default = FormikCheckbox;
+//# sourceMappingURL=FormikCheckbox.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FormikCheckbox.js","names":["React","_interopRequireWildcard","require","_Box","_interopRequireDefault","_formik","_Field","_Checkbox","_jsxRuntime","e","__esModule","default","t","WeakMap","r","n","o","i","f","__proto__","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","FormikCheckbox","name","label","required","disabled","hint","inputProps","field","meta","useField","setFieldValue","setFieldTouched","useFormikContext","hasError","Boolean","touched","error","handleChange","event","target","checked","value","controlLabel","jsxs","Fragment","children","jsx","component","sx","color","fontWeight","marginInlineStart","undefined","group","CheckboxGroup","Checkbox","onChange","_default","exports"],"sources":["../../../src/lib/v2/patterns/FormikCheckbox.tsx"],"sourcesContent":["/**\r\n * FormikCheckbox — bridge between Formik state and v2.Field + v2.Checkbox,\r\n * for a SINGLE BOOLEAN field.\r\n *\r\n * ── WHY THIS EXISTS ALONGSIDE FormikCheckboxGroup (gap G-A) ──────────\r\n *\r\n * `FormikCheckboxGroup` holds an ARRAY of selected values. That is the right\r\n * model for \"pick several from a list\", and the wrong one for a lone flag:\r\n *\r\n *     autreInfo.fabrication      -> boolean\r\n *     objectDeclaration.premiereDeclaration -> boolean\r\n *\r\n * A host with boolean-shaped state cannot adopt the group bridge without\r\n * changing what its payload sends, so every module ended up re-wiring\r\n * `Checkbox` + `useField` by hand — the exact duplication R-2.1 forbids, and\r\n * the one place where it hurts most: hand-rolled bridges lose the error\r\n * rendering. Reported from refonte-frontend (lot 5), whose local masked/checked\r\n * inputs displayed no validation message at all, so a required-field error was\r\n * invisible to the user (R-4.1 MUST).\r\n *\r\n * Usage:\r\n *\r\n *   import { FormikCheckbox } from \"@portnet/ui/lib/v2\";\r\n *\r\n *   <FormikCheckbox\r\n *     name=\"autreInfo.fabrication\"\r\n *     label=\"Fabrication\"\r\n *   />\r\n *\r\n *   <FormikCheckbox\r\n *     name=\"conditions\"\r\n *     label=\"J'accepte les conditions\"\r\n *     required\r\n *     hint=\"Obligatoire pour soumettre la demande\"\r\n *   />\r\n *\r\n * ── WHY THE CHECKBOX IS WRAPPED IN A CheckboxGroup ──────────────────\r\n *\r\n * `Field` clones its child with `error` and `disabled` props, because several\r\n * v2 inputs read them directly. `MuiCheckbox` spreads unknown props down to\r\n * the native `<input>`, so a bare `Checkbox` inside `Field` would emit\r\n * `error=\"false\"` onto the DOM (React warning, invalid attribute).\r\n * `CheckboxGroup` destructures its props explicitly and drops the rest, and it\r\n * forwards the ARIA grouping attributes `Field` injects. Same composition as\r\n * `FormikCheckboxGroup`, for the same reason.\r\n *\r\n * ── LABEL AND REQUIRED ──────────────────────────────────────────────\r\n *\r\n * The label belongs to the CHECKBOX (rendered by `FormControlLabel`, which\r\n * names the input implicitly), not above the field: a lone checkbox with a\r\n * field label AND a control label reads as two questions. `Field` therefore\r\n * receives no label, and `required` is expressed twice where it counts —\r\n * visually by the asterisk appended to the control label, and to assistive\r\n * technology by `aria-required` on the input itself (`Field`'s own injection\r\n * lands on the group, which does not forward it).\r\n *\r\n * Errors surface only once the field is touched, and toggling marks it touched\r\n * — same semantics as `FormikCheckboxGroup`. A checkbox has no meaningful\r\n * blur-before-change, so waiting for a blur would keep the message hidden.\r\n *\r\n * Charter §03 · R-I.2, R-I.3, R-4.1. Peer dependency: formik >= 2.x.\r\n */\r\n\r\nimport * as React from \"react\";\r\nimport Box from \"@mui/material/Box\";\r\nimport { useField, useFormikContext } from \"formik\";\r\nimport Field from \"../components/Field\";\r\nimport { Checkbox, CheckboxGroup } from \"../components/Checkbox\";\r\n\r\nexport interface FormikCheckboxProps {\r\n  name: string;\r\n  /** Label rendered next to the checkbox — it names the control. */\r\n  label?: React.ReactNode | undefined;\r\n  /** Adds the asterisk on the label and `aria-required` on the input. */\r\n  required?: boolean | undefined;\r\n  disabled?: boolean | undefined;\r\n  hint?: React.ReactNode | undefined;\r\n  /** Native `<input>` attributes, routed to the checkbox input (v9 slot). */\r\n  inputProps?: React.InputHTMLAttributes<HTMLInputElement> | undefined;\r\n}\r\n\r\nconst FormikCheckbox = ({\r\n  name,\r\n  label,\r\n  required,\r\n  disabled,\r\n  hint,\r\n  inputProps,\r\n}: FormikCheckboxProps) => {\r\n  const [field, meta] = useField<boolean>(name);\r\n  const { setFieldValue, setFieldTouched } = useFormikContext();\r\n  const hasError = Boolean(meta.touched && meta.error);\r\n\r\n  const handleChange = (event: React.ChangeEvent<HTMLInputElement>) => {\r\n    setFieldValue(name, event.target.checked);\r\n    setFieldTouched(name, true, false);\r\n  };\r\n\r\n  /* `=== true` and not a truthy test: hosts seed these fields with `null`\r\n   * (a not-yet-answered flag), and `checked={null}` makes the input\r\n   * uncontrolled for one render. */\r\n  const checked = field.value === true;\r\n\r\n  const controlLabel = required ? (\r\n    <>\r\n      {label}\r\n      <Box\r\n        component=\"span\"\r\n        aria-hidden=\"true\"\r\n        sx={{\r\n          color: \"var(--danger)\",\r\n          fontWeight: \"var(--fw-bold, 700)\",\r\n          marginInlineStart: \"var(--s-1)\",\r\n        }}\r\n      >\r\n        *\r\n      </Box>\r\n    </>\r\n  ) : (\r\n    label\r\n  );\r\n\r\n  return (\r\n    <Field\r\n      error={hasError ? meta.error : null}\r\n      hint={!hasError ? hint : undefined}\r\n      group\r\n      {...(disabled !== undefined ? { disabled } : {})}\r\n    >\r\n      <CheckboxGroup>\r\n        <Checkbox\r\n          name={name}\r\n          label={controlLabel}\r\n          checked={checked}\r\n          onChange={handleChange}\r\n          disabled={disabled}\r\n          inputProps={{\r\n            ...(required ? { \"aria-required\": \"true\" } : {}),\r\n            ...inputProps,\r\n          }}\r\n        />\r\n      </CheckboxGroup>\r\n    </Field>\r\n  );\r\n};\r\n\r\nexport default FormikCheckbox;\r\n"],"mappings":"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","ignoreList":[]}

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

@@ -30,6 +30,14 @@
  * ARIA group). CheckboxGroup renders role="group" and forwards the injected
  * aria-labelledby / aria-describedby / aria-invalid onto that element.
  *
+ * Error focus (P-2): each Checkbox carries the field `name` on its native
+ * <input>, so `focusFieldByName` — and therefore `FormikErrorFocus` after a
+ * failed submit (R-F.3) — can resolve [name=…] and focus the first checkbox
+ * of the group. Note this is NOT the `htmlFor` route the other bridges use:
+ * in group mode there is no labelable element for htmlFor to target, so the
+ * name attribute is the only handle. Without it the field had neither an id
+ * nor a name and was silently skipped.
+ *
  * Charter R-Sel.4. Peer dependency: formik >= 2.x.
  */
 import * as React from "react";
@@ -45,7 +53,15 @@ export interface FormikCheckboxGroupProps {
     hint?: React.ReactNode | undefined;
     disabled?: boolean | undefined;
     row?: boolean | undefined;
+    /**
+     * Native <input> attributes applied to every checkbox in the group.
+     *
+     * The field `name` is added automatically (P-2) and takes precedence, since
+     * it is what makes the group reachable by focusFieldByName. Anything passed
+     * here is merged ahead of it.
+     */
+    inputProps?: React.InputHTMLAttributes<HTMLInputElement> | undefined;
 }
-declare const FormikCheckboxGroup: ({ name, label, required, options, hint, disabled, row, }: FormikCheckboxGroupProps) => React.JSX.Element;
+declare const FormikCheckboxGroup: ({ name, label, required, options, hint, disabled, row, inputProps, }: FormikCheckboxGroupProps) => React.JSX.Element;
 export default FormikCheckboxGroup;
 //# sourceMappingURL=FormikCheckboxGroup.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"FormikCheckboxGroup.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/patterns/FormikCheckboxGroup.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,OAAO,CAAC,EAAE,oBAAoB,EAAE,GAAG,SAAS,CAAC;IAC7C,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC3B;AAED,QAAA,MAAM,mBAAmB,GAAI,0DAQ1B,wBAAwB,sBAwC1B,CAAC;AAEF,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"FormikCheckboxGroup.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/patterns/FormikCheckboxGroup.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,OAAO,CAAC,EAAE,oBAAoB,EAAE,GAAG,SAAS,CAAC;IAC7C,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,GAAG,SAAS,CAAC;CACtE;AAED,QAAA,MAAM,mBAAmB,GAAI,sEAS1B,wBAAwB,sBAmD1B,CAAC;AAEF,eAAe,mBAAmB,CAAC"}