@portnet/ui 5.0.32 → 6.0.1

package/dist/v2/components/Field.js

@@ -0,0 +1,204 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var React = _interopRequireWildcard(require("react"));
+var _FormControl = _interopRequireDefault(require("@mui/material/FormControl"));
+var _FormLabel = _interopRequireDefault(require("@mui/material/FormLabel"));
+var _FormHelperText = _interopRequireDefault(require("@mui/material/FormHelperText"));
+var _Box = _interopRequireDefault(require("@mui/material/Box"));
+var _FieldError = _interopRequireDefault(require("./FieldError"));
+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); } /**
+ * Field — Portnet UI v2
+ *
+ * Charter §03 · Component "Input · Field".
+ * Universal wrapper providing label / required marker / hint / error / a11y bindings
+ * for any form control (Input, Select, Textarea, Autocomplete, Combobox, …).
+ *
+ * Strict rules enforced:
+ *   R-I.1 — Label is associated to the control via `htmlFor` / `id`.
+ *   R-I.2 — Required adds the asterisk + `aria-required`.
+ *   R-I.3 — Error: `aria-invalid` + `aria-describedby` linking the message.
+ *           Field MERGES with the child's existing `aria-describedby` so a
+ *           consumer-supplied external help id is never lost. The message
+ *           itself is rendered by the shared `FieldError` primitive, which
+ *           carries the R-4.1 MUST icon (gap G-18) — previously this component
+ *           rendered a bare red `FormHelperText` with no icon, so the canonical
+ *           field wrapper did not satisfy a MUST and every module inherited the
+ *           gap on every form.
+ *   R-I.4 — Validation in `blur`, not `change` (caller's responsibility).
+ *   R-I.6 — Hint visible above error; never both at once.
+ *
+ *   <Field label="Référence" required hint="Format AAAA-IM-NNNNN" error={errors.ref}>
+ *     <Input value={value} onChange={onChange} />
+ *   </Field>
+ *
+ * Grouping controls (RadioGroup / CheckboxGroup) — pass `group`:
+ *   A native `<label htmlFor>` cannot name an ARIA group (only labelable
+ *   elements can be `for`-targeted), so in `group` mode the label is rendered
+ *   as a <span> with an id and the child group is associated via
+ *   `aria-labelledby` instead. The child must forward `aria-labelledby`
+ *   (and `aria-describedby`) onto its `role="group"`/`"radiogroup"` element.
+ *
+ *   <Field label="Genre" group error={errors.genre}>
+ *     <RadioGroup … />
+ *   </Field>
+ */
+function Field(_ref) {
+  var label = _ref.label,
+    _ref$required = _ref.required,
+    required = _ref$required === void 0 ? false : _ref$required,
+    hint = _ref.hint,
+    error = _ref.error,
+    htmlFor = _ref.htmlFor,
+    _ref$fullWidth = _ref.fullWidth,
+    fullWidth = _ref$fullWidth === void 0 ? true : _ref$fullWidth,
+    disabled = _ref.disabled,
+    _ref$group = _ref.group,
+    group = _ref$group === void 0 ? false : _ref$group,
+    children = _ref.children,
+    helpAdornment = _ref.helpAdornment,
+    sx = _ref.sx,
+    className = _ref.className;
+  // R-I.1 — useId provides SSR-safe, per-instance, stable IDs.
+  // Replaces the previous module-scoped counter (`let __uid = 0`) which broke
+  // hydration and Concurrent Mode.
+  var reactId = React.useId();
+  var auto = "pui-".concat(reactId.replace(/:/g, ""));
+  var inputId = htmlFor || auto;
+  var hintId = "".concat(inputId, "-h");
+  var errorId = "".concat(inputId, "-e");
+  var labelId = "".concat(inputId, "-l");
+  var hasError = !!error;
+  var child = React.Children.only(children);
+  // The wrapped control is polymorphic (Input/Select/NumberInput/Combobox/…);
+  // type only the props Field reads/merges, replacing React's `props: any`.
+  var childProps = child.props;
+
+  // R-I.3 — MERGE the child's existing aria-describedby with our hint/error
+  // ids. cloneElement replaces props, so without an explicit merge any
+  // consumer-supplied describedby was silently discarded.
+  var describedBy = [childProps["aria-describedby"], hint && !hasError ? hintId : null, hasError ? errorId : null].filter(Boolean).join(" ") || undefined;
+
+  // CC-6 — in group mode the label names the group via aria-labelledby.
+  // Merge with any consumer-supplied labelledby so it is never lost.
+  var labelledBy = group ? [childProps["aria-labelledby"], label ? labelId : null].filter(Boolean).join(" ") || undefined : undefined;
+  var enhanced = /*#__PURE__*/React.cloneElement(child, _objectSpread(_objectSpread({
+    id: childProps.id || inputId,
+    "aria-invalid": hasError ? "true" : undefined,
+    "aria-required": required ? "true" : undefined,
+    "aria-describedby": describedBy
+  }, group ? {
+    "aria-labelledby": labelledBy
+  } : {}), {}, {
+    // `error` / `disabled` are broadcast by FormControl via context for MUI
+    // inputs, but several v2 inputs (NumberInput, Combobox renderInput) are
+    // not pure MUI children and read the props directly — keep them explicit.
+    error: hasError,
+    disabled: disabled || childProps.disabled,
+    // Respect the child's explicit fullWidth when defined (e.g. a narrow
+    // inline filter input). Only fall back to Field's value when the child
+    // hasn't expressed an opinion.
+    fullWidth: childProps.fullWidth !== undefined ? childProps.fullWidth : fullWidth
+  }));
+
+  // R-I.6 — RTL-safe margin reset. `marginLeft: 0` only zeroes the LTR
+  // inline-start; in [dir="rtl"] the helper picks up MUI's default on
+  // the (now physical-right but logical-start) side and is mis-aligned.
+  // `marginInlineStart` resets the correct edge in both directions.
+  var helperResetSx = {
+    marginInlineStart: 0,
+    fontSize: "var(--text-xs)"
+  };
+  var LABEL_SX = {
+    display: "flex",
+    alignItems: "center",
+    gap: "var(--s-1)",
+    fontSize: "var(--text-xs, 12px)",
+    fontWeight: "var(--fw-semibold, 600)",
+    color: "var(--fg-muted)",
+    marginBottom: "var(--s-2)",
+    "&.Mui-focused": {
+      color: "var(--fg-muted)"
+    },
+    "&.Mui-error": {
+      color: "var(--fg-muted)"
+    }
+  };
+
+  // Shared label content (text + required marker + optional help adornment).
+  var labelContent = /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
+    children: [label, required && /*#__PURE__*/(0, _jsxRuntime.jsx)(_Box["default"], {
+      component: "span",
+      "aria-hidden": "true",
+      sx: {
+        color: "var(--danger)",
+        fontWeight: "var(--fw-bold, 700)"
+      },
+      children: "*"
+    }), helpAdornment]
+  });
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_FormControl["default"], {
+    error: hasError,
+    required: required,
+    disabled: disabled,
+    fullWidth: fullWidth,
+    className: className,
+    sx: sx,
+    children: [label && (group ?
+    /*#__PURE__*/
+    // Group mode: render as a <span> carrying an id (no <label for>),
+    // referenced by the group's aria-labelledby.
+    (0, _jsxRuntime.jsx)(_FormLabel["default"], {
+      component: "span",
+      id: labelId,
+      required: false,
+      sx: LABEL_SX,
+      children: labelContent
+    }) : /*#__PURE__*/(0, _jsxRuntime.jsx)(_FormLabel["default"], {
+      htmlFor: inputId,
+      required: false /* we render the * ourselves */,
+      sx: LABEL_SX,
+      children: labelContent
+    })), enhanced, hint && !hasError && /*#__PURE__*/(0, _jsxRuntime.jsx)(_FormHelperText["default"], {
+      id: hintId,
+      sx: _objectSpread(_objectSpread({}, helperResetSx), {}, {
+        color: "var(--fg-subtle)"
+      }),
+      children: hint
+    }), hasError &&
+    /*#__PURE__*/
+    /*
+     * Rendered by the shared `FieldError` (gap G-18) rather than an inline
+     * `FormHelperText`: R-4.1 MUST requires the icon, and a host with a
+     * LIST-level error (a Formik array, an upload slot) has no single
+     * control to wrap in a `Field` and needs the exact same renderer
+     * standalone. One component, both paths, no drift.
+     *
+     * `marginTop: var(--s-1)` (4px) replaces `FormHelperText`'s hard-coded
+     * 3px default — same optical result, on the spacing scale (R-S.1).
+     * Dropping FormHelperText also removed a `color: … !important` that
+     * only existed to beat MUI's own `Mui-error` colour.
+     */
+    (0, _jsxRuntime.jsx)(_FieldError["default"], {
+      id: errorId,
+      sx: {
+        marginTop: "var(--s-1)"
+      },
+      children: error
+    })]
+  });
+}
+var _default = exports["default"] = Field;
+//# sourceMappingURL=Field.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Field.js","names":["React","_interopRequireWildcard","require","_FormControl","_interopRequireDefault","_FormLabel","_FormHelperText","_Box","_FieldError","_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","Field","_ref","label","_ref$required","required","error","htmlFor","_ref$fullWidth","fullWidth","disabled","_ref$group","group","children","helpAdornment","sx","className","reactId","useId","auto","concat","replace","inputId","hintId","errorId","labelId","hasError","child","Children","only","childProps","props","describedBy","Boolean","join","labelledBy","enhanced","cloneElement","id","helperResetSx","marginInlineStart","fontSize","LABEL_SX","display","alignItems","gap","fontWeight","color","marginBottom","labelContent","jsxs","Fragment","jsx","component","marginTop","_default","exports"],"sources":["../../../src/lib/v2/components/Field.tsx"],"sourcesContent":["import * as React from \"react\";\r\nimport FormControl from \"@mui/material/FormControl\";\r\nimport FormLabel from \"@mui/material/FormLabel\";\r\nimport FormHelperText from \"@mui/material/FormHelperText\";\r\nimport Box from \"@mui/material/Box\";\r\nimport type { SxProps, Theme } from \"@mui/material/styles\";\r\nimport FieldError from \"./FieldError\";\r\n\r\n/**\r\n * Field — Portnet UI v2\r\n *\r\n * Charter §03 · Component \"Input · Field\".\r\n * Universal wrapper providing label / required marker / hint / error / a11y bindings\r\n * for any form control (Input, Select, Textarea, Autocomplete, Combobox, …).\r\n *\r\n * Strict rules enforced:\r\n *   R-I.1 — Label is associated to the control via `htmlFor` / `id`.\r\n *   R-I.2 — Required adds the asterisk + `aria-required`.\r\n *   R-I.3 — Error: `aria-invalid` + `aria-describedby` linking the message.\r\n *           Field MERGES with the child's existing `aria-describedby` so a\r\n *           consumer-supplied external help id is never lost. The message\r\n *           itself is rendered by the shared `FieldError` primitive, which\r\n *           carries the R-4.1 MUST icon (gap G-18) — previously this component\r\n *           rendered a bare red `FormHelperText` with no icon, so the canonical\r\n *           field wrapper did not satisfy a MUST and every module inherited the\r\n *           gap on every form.\r\n *   R-I.4 — Validation in `blur`, not `change` (caller's responsibility).\r\n *   R-I.6 — Hint visible above error; never both at once.\r\n *\r\n *   <Field label=\"Référence\" required hint=\"Format AAAA-IM-NNNNN\" error={errors.ref}>\r\n *     <Input value={value} onChange={onChange} />\r\n *   </Field>\r\n *\r\n * Grouping controls (RadioGroup / CheckboxGroup) — pass `group`:\r\n *   A native `<label htmlFor>` cannot name an ARIA group (only labelable\r\n *   elements can be `for`-targeted), so in `group` mode the label is rendered\r\n *   as a <span> with an id and the child group is associated via\r\n *   `aria-labelledby` instead. The child must forward `aria-labelledby`\r\n *   (and `aria-describedby`) onto its `role=\"group\"`/`\"radiogroup\"` element.\r\n *\r\n *   <Field label=\"Genre\" group error={errors.genre}>\r\n *     <RadioGroup … />\r\n *   </Field>\r\n */\r\nexport interface FieldProps {\r\n  label?: React.ReactNode | undefined;\r\n  required?: boolean | undefined;\r\n  hint?: React.ReactNode | undefined;\r\n  error?: React.ReactNode | undefined;\r\n  htmlFor?: string | undefined;\r\n  fullWidth?: boolean | undefined;\r\n  disabled?: boolean | undefined;\r\n  /**\r\n   * The wrapped child is an ARIA group (RadioGroup / CheckboxGroup) rather than\r\n   * a single labelable control. Associates the label via `aria-labelledby`\r\n   * instead of `htmlFor` / `id`.\r\n   */\r\n  group?: boolean | undefined;\r\n  /** Optional <FieldHelp> element rendered next to the label. */\r\n  helpAdornment?: React.ReactNode | undefined;\r\n  /** The single form-control element to wrap. */\r\n  children: React.ReactElement;\r\n  sx?: SxProps<Theme> | undefined;\r\n  className?: string | undefined;\r\n}\r\n\r\nfunction Field({\r\n  label,\r\n  required = false,\r\n  hint,\r\n  error,\r\n  htmlFor,\r\n  fullWidth = true,\r\n  disabled,\r\n  group = false,\r\n  children,\r\n  helpAdornment, // optional <FieldHelp> element\r\n  sx,\r\n  className,\r\n}: FieldProps) {\r\n  // R-I.1 — useId provides SSR-safe, per-instance, stable IDs.\r\n  // Replaces the previous module-scoped counter (`let __uid = 0`) which broke\r\n  // hydration and Concurrent Mode.\r\n  const reactId = React.useId();\r\n  const auto = `pui-${reactId.replace(/:/g, \"\")}`;\r\n  const inputId = htmlFor || auto;\r\n  const hintId  = `${inputId}-h`;\r\n  const errorId = `${inputId}-e`;\r\n  const labelId = `${inputId}-l`;\r\n  const hasError = !!error;\r\n\r\n  const child = React.Children.only(children);\r\n  // The wrapped control is polymorphic (Input/Select/NumberInput/Combobox/…);\r\n  // type only the props Field reads/merges, replacing React's `props: any`.\r\n  const childProps = child.props as {\r\n    id?: string;\r\n    disabled?: boolean;\r\n    fullWidth?: boolean;\r\n    \"aria-describedby\"?: string;\r\n    \"aria-labelledby\"?: string;\r\n  };\r\n\r\n  // R-I.3 — MERGE the child's existing aria-describedby with our hint/error\r\n  // ids. cloneElement replaces props, so without an explicit merge any\r\n  // consumer-supplied describedby was silently discarded.\r\n  const describedBy = [\r\n    childProps[\"aria-describedby\"],\r\n    hint && !hasError ? hintId : null,\r\n    hasError ? errorId : null,\r\n  ].filter(Boolean).join(\" \") || undefined;\r\n\r\n  // CC-6 — in group mode the label names the group via aria-labelledby.\r\n  // Merge with any consumer-supplied labelledby so it is never lost.\r\n  const labelledBy = group\r\n    ? [childProps[\"aria-labelledby\"], label ? labelId : null]\r\n        .filter(Boolean)\r\n        .join(\" \") || undefined\r\n    : undefined;\r\n\r\n  const enhanced = React.cloneElement(child as React.ReactElement<Record<string, unknown>>, {\r\n    id: childProps.id || inputId,\r\n    \"aria-invalid\":   hasError ? \"true\" : undefined,\r\n    \"aria-required\":  required ? \"true\" : undefined,\r\n    \"aria-describedby\": describedBy,\r\n    // Only in group mode — a single labelable control is named by the\r\n    // htmlFor/id pair below, not by aria-labelledby.\r\n    ...(group ? { \"aria-labelledby\": labelledBy } : {}),\r\n    // `error` / `disabled` are broadcast by FormControl via context for MUI\r\n    // inputs, but several v2 inputs (NumberInput, Combobox renderInput) are\r\n    // not pure MUI children and read the props directly — keep them explicit.\r\n    error: hasError,\r\n    disabled: disabled || childProps.disabled,\r\n    // Respect the child's explicit fullWidth when defined (e.g. a narrow\r\n    // inline filter input). Only fall back to Field's value when the child\r\n    // hasn't expressed an opinion.\r\n    fullWidth: childProps.fullWidth !== undefined ? childProps.fullWidth : fullWidth,\r\n  });\r\n\r\n  // R-I.6 — RTL-safe margin reset. `marginLeft: 0` only zeroes the LTR\r\n  // inline-start; in [dir=\"rtl\"] the helper picks up MUI's default on\r\n  // the (now physical-right but logical-start) side and is mis-aligned.\r\n  // `marginInlineStart` resets the correct edge in both directions.\r\n  const helperResetSx = { marginInlineStart: 0, fontSize: \"var(--text-xs)\" };\r\n\r\n  const LABEL_SX = {\r\n    display: \"flex\",\r\n    alignItems: \"center\",\r\n    gap: \"var(--s-1)\",\r\n    fontSize: \"var(--text-xs, 12px)\",\r\n    fontWeight: \"var(--fw-semibold, 600)\",\r\n    color: \"var(--fg-muted)\",\r\n    marginBottom: \"var(--s-2)\",\r\n    \"&.Mui-focused\": { color: \"var(--fg-muted)\" },\r\n    \"&.Mui-error\":   { color: \"var(--fg-muted)\" },\r\n  } as const;\r\n\r\n  // Shared label content (text + required marker + optional help adornment).\r\n  const labelContent = (\r\n    <>\r\n      {label}\r\n      {required && (\r\n        <Box\r\n          component=\"span\"\r\n          aria-hidden=\"true\"\r\n          sx={{ color: \"var(--danger)\", fontWeight: \"var(--fw-bold, 700)\" }}\r\n        >\r\n          *\r\n        </Box>\r\n      )}\r\n      {helpAdornment}\r\n    </>\r\n  );\r\n\r\n  return (\r\n    <FormControl\r\n      error={hasError}\r\n      required={required}\r\n      disabled={disabled}\r\n      fullWidth={fullWidth}\r\n      className={className}\r\n      sx={sx}\r\n    >\r\n      {label &&\r\n        (group ? (\r\n          // Group mode: render as a <span> carrying an id (no <label for>),\r\n          // referenced by the group's aria-labelledby.\r\n          <FormLabel component=\"span\" id={labelId} required={false} sx={LABEL_SX}>\r\n            {labelContent}\r\n          </FormLabel>\r\n        ) : (\r\n          <FormLabel htmlFor={inputId} required={false /* we render the * ourselves */} sx={LABEL_SX}>\r\n            {labelContent}\r\n          </FormLabel>\r\n        ))}\r\n\r\n      {enhanced}\r\n\r\n      {hint && !hasError && (\r\n        <FormHelperText\r\n          id={hintId}\r\n          sx={{ ...helperResetSx, color: \"var(--fg-subtle)\" }}\r\n        >\r\n          {hint}\r\n        </FormHelperText>\r\n      )}\r\n\r\n      {hasError && (\r\n        /*\r\n         * Rendered by the shared `FieldError` (gap G-18) rather than an inline\r\n         * `FormHelperText`: R-4.1 MUST requires the icon, and a host with a\r\n         * LIST-level error (a Formik array, an upload slot) has no single\r\n         * control to wrap in a `Field` and needs the exact same renderer\r\n         * standalone. One component, both paths, no drift.\r\n         *\r\n         * `marginTop: var(--s-1)` (4px) replaces `FormHelperText`'s hard-coded\r\n         * 3px default — same optical result, on the spacing scale (R-S.1).\r\n         * Dropping FormHelperText also removed a `color: … !important` that\r\n         * only existed to beat MUI's own `Mui-error` colour.\r\n         */\r\n        <FieldError id={errorId} sx={{ marginTop: \"var(--s-1)\" }}>\r\n          {error}\r\n        </FieldError>\r\n      )}\r\n    </FormControl>\r\n  );\r\n}\r\n\r\nexport default Field;\r\n"],"mappings":"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","ignoreList":[]}

package/dist/v2/components/FieldError.d.ts

@@ -0,0 +1,78 @@
+import * as React from "react";
+import type { SxProps, Theme } from "@mui/material/styles";
+/**
+ * FieldError — Portnet UI v2
+ *
+ * Charter R-4.1 MUST: « Toute erreur de champ s'affiche SOUS le champ, en rouge,
+ * AVEC ICÔNE, max 1 phrase, verbe d'action. »
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * WHY THIS BELONGS IN THE LIBRARY (capability gap G-18)
+ *
+ * Two defects closed at once, and they were the same defect seen from both ends.
+ *
+ * 1. `Field` rendered its error message as a bare `FormHelperText` — red, under
+ *    the field, one sentence, and NO ICON. R-4.1 is a MUST and the canonical
+ *    field wrapper of the design system did not satisfy it, so every module
+ *    inherited the gap on every form.
+ *
+ * 2. A field error is not always attached to a `Field`. A LIST-level error
+ *    (`errors.articles`, `errors.autorisationPdf` — a Formik array or an upload
+ *    slot) has no single control to wrap, and `Field` requires exactly one
+ *    `children` element. Hosts therefore hand-rolled the block: addpe-fe's
+ *    `InlineFieldAlert` reimplemented the icon + `role="alert"` + danger token
+ *    recipe locally — and, ironically, was MORE charter-compliant than the
+ *    shared component it could not use.
+ *
+ * Owning the renderer here means the two paths cannot drift: the error a user
+ * sees under an `<Input>` and the one under an articles table are the same
+ * component.
+ * ─────────────────────────────────────────────────────────────────────────────
+ *
+ * Used INSIDE `Field` (it supplies `id`, wired to the control's
+ * `aria-describedby`), and standalone by a host:
+ *
+ *   {typeof errors.articles === "string" && (
+ *     <FieldError sx={{ marginTop: "var(--s-2)" }}>{errors.articles}</FieldError>
+ *   )}
+ *
+ * Accessibility
+ *   - `role="alert"`: the element MOUNTS when the error appears, which is what
+ *     makes a screen reader announce it. Do not render it permanently with empty
+ *     content — an always-present live region announces nothing on change.
+ *   - The icon is `aria-hidden`: it is redundant with the message, and R-Ar.2
+ *     forbids a decorative icon carrying an accessible name.
+ *   - Iconography is deliberately the SAME as `Banner`'s error variant
+ *     (`ErrorOutlined`), so "something is wrong" reads identically whether it
+ *     surfaces inline or in a banner.
+ *
+ * Colour: the message TEXT takes `--danger-fg`, the icon takes `--danger`. That
+ * split is not cosmetic and it is the rule `KPICard` already documents for its
+ * delta indicator: `--danger` is the VIVID UI colour, held to WCAG 1.4.11's 3:1
+ * non-text threshold, while `--danger-fg` is the TEXT colour, held to 1.4.3's
+ * 4.5:1. Using `--danger` for the message would render it at a ratio calibrated
+ * for icons and borders — which is what the module-local `InlineFieldAlert` this
+ * component replaced did, and what `Field`'s own error text did before it
+ * delegated here. Promoting that mistake into a shared component would have made
+ * it fleet-wide, on every field error of every module.
+ *
+ * No `!important` — the previous `FormHelperText` needed one to beat MUI's own
+ * `Mui-error` colour; rendering a plain Box removes the specificity fight.
+ */
+export interface FieldErrorProps {
+    /** The message. One sentence, action verb (Charter §09.3). */
+    children: React.ReactNode;
+    /**
+     * DOM id referenced by the control's `aria-describedby`. `Field` supplies it;
+     * a standalone list-level error usually has nothing to bind to and omits it.
+     */
+    id?: string | undefined;
+    /**
+     * Spacing / layout overrides. Standalone call sites typically need a
+     * `marginTop`; inside `Field` the vertical rhythm is already handled.
+     */
+    sx?: SxProps<Theme> | undefined;
+}
+declare function FieldError({ children, id, sx }: FieldErrorProps): React.JSX.Element;
+export default FieldError;
+//# sourceMappingURL=FieldError.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FieldError.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/components/FieldError.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAG3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AAEH,MAAM,WAAW,eAAe;IAC9B,8DAA8D;IAC9D,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB;;;OAGG;IACH,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;CACjC;AAED,iBAAS,UAAU,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,eAAe,qBA+CxD;AAED,eAAe,UAAU,CAAC"}

package/dist/v2/components/FieldError.js

@@ -0,0 +1,131 @@
+"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 _ErrorOutlined = _interopRequireDefault(require("@mui/icons-material/ErrorOutlined"));
+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); } /**
+ * FieldError — Portnet UI v2
+ *
+ * Charter R-4.1 MUST: « Toute erreur de champ s'affiche SOUS le champ, en rouge,
+ * AVEC ICÔNE, max 1 phrase, verbe d'action. »
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * WHY THIS BELONGS IN THE LIBRARY (capability gap G-18)
+ *
+ * Two defects closed at once, and they were the same defect seen from both ends.
+ *
+ * 1. `Field` rendered its error message as a bare `FormHelperText` — red, under
+ *    the field, one sentence, and NO ICON. R-4.1 is a MUST and the canonical
+ *    field wrapper of the design system did not satisfy it, so every module
+ *    inherited the gap on every form.
+ *
+ * 2. A field error is not always attached to a `Field`. A LIST-level error
+ *    (`errors.articles`, `errors.autorisationPdf` — a Formik array or an upload
+ *    slot) has no single control to wrap, and `Field` requires exactly one
+ *    `children` element. Hosts therefore hand-rolled the block: addpe-fe's
+ *    `InlineFieldAlert` reimplemented the icon + `role="alert"` + danger token
+ *    recipe locally — and, ironically, was MORE charter-compliant than the
+ *    shared component it could not use.
+ *
+ * Owning the renderer here means the two paths cannot drift: the error a user
+ * sees under an `<Input>` and the one under an articles table are the same
+ * component.
+ * ─────────────────────────────────────────────────────────────────────────────
+ *
+ * Used INSIDE `Field` (it supplies `id`, wired to the control's
+ * `aria-describedby`), and standalone by a host:
+ *
+ *   {typeof errors.articles === "string" && (
+ *     <FieldError sx={{ marginTop: "var(--s-2)" }}>{errors.articles}</FieldError>
+ *   )}
+ *
+ * Accessibility
+ *   - `role="alert"`: the element MOUNTS when the error appears, which is what
+ *     makes a screen reader announce it. Do not render it permanently with empty
+ *     content — an always-present live region announces nothing on change.
+ *   - The icon is `aria-hidden`: it is redundant with the message, and R-Ar.2
+ *     forbids a decorative icon carrying an accessible name.
+ *   - Iconography is deliberately the SAME as `Banner`'s error variant
+ *     (`ErrorOutlined`), so "something is wrong" reads identically whether it
+ *     surfaces inline or in a banner.
+ *
+ * Colour: the message TEXT takes `--danger-fg`, the icon takes `--danger`. That
+ * split is not cosmetic and it is the rule `KPICard` already documents for its
+ * delta indicator: `--danger` is the VIVID UI colour, held to WCAG 1.4.11's 3:1
+ * non-text threshold, while `--danger-fg` is the TEXT colour, held to 1.4.3's
+ * 4.5:1. Using `--danger` for the message would render it at a ratio calibrated
+ * for icons and borders — which is what the module-local `InlineFieldAlert` this
+ * component replaced did, and what `Field`'s own error text did before it
+ * delegated here. Promoting that mistake into a shared component would have made
+ * it fleet-wide, on every field error of every module.
+ *
+ * No `!important` — the previous `FormHelperText` needed one to beat MUI's own
+ * `Mui-error` colour; rendering a plain Box removes the specificity fight.
+ */
+function FieldError(_ref) {
+  var children = _ref.children,
+    id = _ref.id,
+    sx = _ref.sx;
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_Box["default"], {
+    role: "alert",
+    id: id,
+    sx: _objectSpread({
+      display: "flex",
+      // `flex-start`, not `center`: a message that wraps to two lines must
+      // keep its icon aligned with the FIRST line, not vertically centred
+      // against the whole block.
+      alignItems: "flex-start",
+      gap: "var(--s-1)",
+      // WCAG 1.4.3 — message text at the 4.5:1-calibrated token, NOT `--danger`
+      // (see the colour note in this file's header).
+      color: "var(--danger-fg)",
+      fontSize: "var(--text-xs)",
+      fontWeight: "var(--fw-medium)",
+      lineHeight: "var(--lh-normal)",
+      // RTL-safe: resets the logical inline-start edge, so the message is
+      // flush with the control in both directions.
+      marginInlineStart: 0
+    }, sx),
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_ErrorOutlined["default"], {
+      "aria-hidden": "true"
+      /* Test hook — the glyph has no role and no accessible name by design
+       * (R-Ar.2), so no semantic query reaches it. Same sanctioned escape
+       * hatch as FileCard's filecard-icon, and it guards the same contract:
+       * a decorative icon must not be announced. */,
+      "data-testid": "fielderror-icon",
+      sx: {
+        // --text-h3 is the 16px token; matches the message's optical scale.
+        fontSize: "var(--text-h3)",
+        flexShrink: 0,
+        // WCAG 1.4.11 — the glyph stays VIVID at the 3:1 non-text threshold,
+        // which is the whole point of keeping two danger tokens.
+        color: "var(--danger)"
+      }
+      // Optical alignment of the glyph with the first text line. Same
+      // rationale (and same 1px order of magnitude) as Banner's leading icon:
+      // a deliberate non-token value, not a spacing-scale concern.
+      ,
+      style: {
+        marginTop: 1
+      }
+    }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_Box["default"], {
+      component: "span",
+      children: children
+    })]
+  });
+}
+var _default = exports["default"] = FieldError;
+//# sourceMappingURL=FieldError.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FieldError.js","names":["React","_interopRequireWildcard","require","_Box","_interopRequireDefault","_ErrorOutlined","_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","FieldError","_ref","children","id","sx","jsxs","role","display","alignItems","gap","color","fontSize","fontWeight","lineHeight","marginInlineStart","jsx","flexShrink","style","marginTop","component","_default","exports"],"sources":["../../../src/lib/v2/components/FieldError.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 ErrorIcon from \"@mui/icons-material/ErrorOutlined\";\r\n\r\n/**\r\n * FieldError — Portnet UI v2\r\n *\r\n * Charter R-4.1 MUST: « Toute erreur de champ s'affiche SOUS le champ, en rouge,\r\n * AVEC ICÔNE, max 1 phrase, verbe d'action. »\r\n *\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n * WHY THIS BELONGS IN THE LIBRARY (capability gap G-18)\r\n *\r\n * Two defects closed at once, and they were the same defect seen from both ends.\r\n *\r\n * 1. `Field` rendered its error message as a bare `FormHelperText` — red, under\r\n *    the field, one sentence, and NO ICON. R-4.1 is a MUST and the canonical\r\n *    field wrapper of the design system did not satisfy it, so every module\r\n *    inherited the gap on every form.\r\n *\r\n * 2. A field error is not always attached to a `Field`. A LIST-level error\r\n *    (`errors.articles`, `errors.autorisationPdf` — a Formik array or an upload\r\n *    slot) has no single control to wrap, and `Field` requires exactly one\r\n *    `children` element. Hosts therefore hand-rolled the block: addpe-fe's\r\n *    `InlineFieldAlert` reimplemented the icon + `role=\"alert\"` + danger token\r\n *    recipe locally — and, ironically, was MORE charter-compliant than the\r\n *    shared component it could not use.\r\n *\r\n * Owning the renderer here means the two paths cannot drift: the error a user\r\n * sees under an `<Input>` and the one under an articles table are the same\r\n * component.\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n *\r\n * Used INSIDE `Field` (it supplies `id`, wired to the control's\r\n * `aria-describedby`), and standalone by a host:\r\n *\r\n *   {typeof errors.articles === \"string\" && (\r\n *     <FieldError sx={{ marginTop: \"var(--s-2)\" }}>{errors.articles}</FieldError>\r\n *   )}\r\n *\r\n * Accessibility\r\n *   - `role=\"alert\"`: the element MOUNTS when the error appears, which is what\r\n *     makes a screen reader announce it. Do not render it permanently with empty\r\n *     content — an always-present live region announces nothing on change.\r\n *   - The icon is `aria-hidden`: it is redundant with the message, and R-Ar.2\r\n *     forbids a decorative icon carrying an accessible name.\r\n *   - Iconography is deliberately the SAME as `Banner`'s error variant\r\n *     (`ErrorOutlined`), so \"something is wrong\" reads identically whether it\r\n *     surfaces inline or in a banner.\r\n *\r\n * Colour: the message TEXT takes `--danger-fg`, the icon takes `--danger`. That\r\n * split is not cosmetic and it is the rule `KPICard` already documents for its\r\n * delta indicator: `--danger` is the VIVID UI colour, held to WCAG 1.4.11's 3:1\r\n * non-text threshold, while `--danger-fg` is the TEXT colour, held to 1.4.3's\r\n * 4.5:1. Using `--danger` for the message would render it at a ratio calibrated\r\n * for icons and borders — which is what the module-local `InlineFieldAlert` this\r\n * component replaced did, and what `Field`'s own error text did before it\r\n * delegated here. Promoting that mistake into a shared component would have made\r\n * it fleet-wide, on every field error of every module.\r\n *\r\n * No `!important` — the previous `FormHelperText` needed one to beat MUI's own\r\n * `Mui-error` colour; rendering a plain Box removes the specificity fight.\r\n */\r\n\r\nexport interface FieldErrorProps {\r\n  /** The message. One sentence, action verb (Charter §09.3). */\r\n  children: React.ReactNode;\r\n  /**\r\n   * DOM id referenced by the control's `aria-describedby`. `Field` supplies it;\r\n   * a standalone list-level error usually has nothing to bind to and omits it.\r\n   */\r\n  id?: string | undefined;\r\n  /**\r\n   * Spacing / layout overrides. Standalone call sites typically need a\r\n   * `marginTop`; inside `Field` the vertical rhythm is already handled.\r\n   */\r\n  sx?: SxProps<Theme> | undefined;\r\n}\r\n\r\nfunction FieldError({ children, id, sx }: FieldErrorProps) {\r\n  return (\r\n    <Box\r\n      role=\"alert\"\r\n      id={id}\r\n      sx={{\r\n        display: \"flex\",\r\n        // `flex-start`, not `center`: a message that wraps to two lines must\r\n        // keep its icon aligned with the FIRST line, not vertically centred\r\n        // against the whole block.\r\n        alignItems: \"flex-start\",\r\n        gap: \"var(--s-1)\",\r\n        // WCAG 1.4.3 — message text at the 4.5:1-calibrated token, NOT `--danger`\r\n        // (see the colour note in this file's header).\r\n        color: \"var(--danger-fg)\",\r\n        fontSize: \"var(--text-xs)\",\r\n        fontWeight: \"var(--fw-medium)\",\r\n        lineHeight: \"var(--lh-normal)\",\r\n        // RTL-safe: resets the logical inline-start edge, so the message is\r\n        // flush with the control in both directions.\r\n        marginInlineStart: 0,\r\n        ...sx,\r\n      }}\r\n    >\r\n      <ErrorIcon\r\n        aria-hidden=\"true\"\r\n        /* Test hook — the glyph has no role and no accessible name by design\r\n         * (R-Ar.2), so no semantic query reaches it. Same sanctioned escape\r\n         * hatch as FileCard's filecard-icon, and it guards the same contract:\r\n         * a decorative icon must not be announced. */\r\n        data-testid=\"fielderror-icon\"\r\n        sx={{\r\n          // --text-h3 is the 16px token; matches the message's optical scale.\r\n          fontSize: \"var(--text-h3)\",\r\n          flexShrink: 0,\r\n          // WCAG 1.4.11 — the glyph stays VIVID at the 3:1 non-text threshold,\r\n          // which is the whole point of keeping two danger tokens.\r\n          color: \"var(--danger)\",\r\n        }}\r\n        // Optical alignment of the glyph with the first text line. Same\r\n        // rationale (and same 1px order of magnitude) as Banner's leading icon:\r\n        // a deliberate non-token value, not a spacing-scale concern.\r\n        style={{ marginTop: 1 }}\r\n      />\r\n      <Box component=\"span\">{children}</Box>\r\n    </Box>\r\n  );\r\n}\r\n\r\nexport default FieldError;\r\n"],"mappings":"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","ignoreList":[]}

package/dist/v2/components/FieldHelp.d.ts

@@ -0,0 +1,54 @@
+import * as React from "react";
+import type { TooltipProps } from "@mui/material/Tooltip";
+/**
+ * FieldHelp - Portnet UI v2 (component)
+ *
+ * Charter §03 · Component "FieldHelp · Contextual help".
+ *
+ * A small icon-button affordance that hosts drop next to labels,
+ * section titles, or anywhere a user might benefit from just-in-
+ * time guidance without cluttering the primary visual hierarchy.
+ *
+ * Behaviour modes:
+ *   - tooltip: MUI Tooltip (default for short string content).
+ *   - popover: MUI Popover, click to open. Used when content is
+ *     long (>80 chars) or when a distinct `title` is provided.
+ *   - auto:    Picks tooltip vs popover via the heuristic above.
+ *
+ * Usage:
+ *   <FieldHelp content="Référence unique de l'autorisation" />
+ *   <FieldHelp
+ *     title="Détails"
+ *     content={<>Texte long avec <b>JSX</b>.</>}
+ *     variant="popover"
+ *   />
+ *
+ * A11y (audit Batch 5, finding B5-1; Batch 19, FH-1):
+ *   Popover variant trigger carries aria-haspopup="dialog" +
+ *   aria-expanded reflecting the open state — WAI-ARIA disclosure
+ *   pattern. The Popover paper itself carries role="dialog" and an
+ *   accessible name (FH-1): aria-labelledby the visible title when
+ *   one is rendered, else aria-label from the ariaLabel prop — so
+ *   the region the trigger promises actually resolves as a named
+ *   dialog to assistive tech. Tooltip variant relies on MUI
+ *   Tooltip's automatic aria-describedby plumbing on the wrapped child.
+ */
+export type FieldHelpVariant = "auto" | "tooltip" | "popover";
+export type FieldHelpIcon = "help" | "info";
+export interface FieldHelpProps {
+    /** Help content (tooltip title or popover body). */
+    content: React.ReactNode;
+    /** Optional popover title. When present, forces the popover variant. */
+    title?: React.ReactNode | undefined;
+    /** @default "auto" */
+    variant?: FieldHelpVariant | undefined;
+    /** @default "help" */
+    icon?: FieldHelpIcon | undefined;
+    /** Tooltip placement. @default "top" */
+    placement?: TooltipProps["placement"] | undefined;
+    /** @default "Aide" */
+    ariaLabel?: string | undefined;
+}
+declare function FieldHelp({ content, title, variant, icon, placement, ariaLabel, }: FieldHelpProps): React.JSX.Element;
+export default FieldHelp;
+//# sourceMappingURL=FieldHelp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FieldHelp.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/components/FieldHelp.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAO1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAC9D,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC;AAE5C,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,wEAAwE;IACxE,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IACpC,sBAAsB;IACtB,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACvC,sBAAsB;IACtB,IAAI,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACjC,wCAAwC;IACxC,SAAS,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC;IAClD,sBAAsB;IACtB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AA2DD,iBAAS,SAAS,CAAC,EACjB,OAAO,EACP,KAAK,EACL,OAAgB,EAChB,IAAa,EACb,SAAiB,EACjB,SAAkB,GACnB,EAAE,cAAc,qBAwEhB;AAED,eAAe,SAAS,CAAC"}