@portnet/ui 5.0.27 → 6.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"Field.js","names":["React","_interopRequireWildcard","require","_FormControl","_interopRequireDefault","_FormLabel","_FormHelperText","_Box","_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","role","_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\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.\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;\r\n  required?: boolean;\r\n  hint?: React.ReactNode;\r\n  error?: React.ReactNode;\r\n  htmlFor?: string;\r\n  fullWidth?: boolean;\r\n  disabled?: boolean;\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;\r\n  /** Optional <FieldHelp> element rendered next to the label. */\r\n  helpAdornment?: React.ReactNode;\r\n  /** The single form-control element to wrap. */\r\n  children: React.ReactElement;\r\n  sx?: SxProps<Theme>;\r\n  className?: string;\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        <FormHelperText\r\n          id={errorId}\r\n          role=\"alert\"\r\n          sx={{\r\n            ...helperResetSx,\r\n            color: \"var(--danger) !important\",\r\n            fontWeight: \"var(--fw-medium)\",\r\n          }}\r\n        >\r\n          {error}\r\n        </FormHelperText>\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/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.
+ */
+type FieldHelpVariant = "auto" | "tooltip" | "popover";
+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;
+    /** @default "auto" */
+    variant?: FieldHelpVariant;
+    /** @default "help" */
+    icon?: FieldHelpIcon;
+    /** Tooltip placement. @default "top" */
+    placement?: TooltipProps["placement"];
+    /** @default "Aide" */
+    ariaLabel?: string;
+}
+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,KAAK,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AACvD,KAAK,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC;AAErC,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,wEAAwE;IACxE,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,sBAAsB;IACtB,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,sBAAsB;IACtB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,wCAAwC;IACxC,SAAS,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,CAAC;IACtC,sBAAsB;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA2DD,iBAAS,SAAS,CAAC,EACjB,OAAO,EACP,KAAK,EACL,OAAgB,EAChB,IAAa,EACb,SAAiB,EACjB,SAAkB,GACnB,EAAE,cAAc,qBAwEhB;AAED,eAAe,SAAS,CAAC"}

package/dist/v2/components/FieldHelp.js

@@ -0,0 +1,209 @@
+"use strict";
+
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var React = _interopRequireWildcard(require("react"));
+var _Tooltip = _interopRequireDefault(require("@mui/material/Tooltip"));
+var _IconButton = _interopRequireDefault(require("@mui/material/IconButton"));
+var _Box = _interopRequireDefault(require("@mui/material/Box"));
+var _Popover = _interopRequireDefault(require("@mui/material/Popover"));
+var _HelpOutlineOutlined = _interopRequireDefault(require("@mui/icons-material/HelpOutlineOutlined"));
+var _InfoOutlined = _interopRequireDefault(require("@mui/icons-material/InfoOutlined"));
+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 _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+function _iterableToArrayLimit(arr, i) { var _i = null == arr ? null : "undefined" != typeof Symbol && arr[Symbol.iterator] || arr["@@iterator"]; if (null != _i) { var _s, _e, _x, _r, _arr = [], _n = !0, _d = !1; try { if (_x = (_i = _i.call(arr)).next, 0 === i) { if (Object(_i) !== _i) return; _n = !1; } else for (; !(_n = (_s = _x.call(_i)).done) && (_arr.push(_s.value), _arr.length !== i); _n = !0) { ; } } catch (err) { _d = !0, _e = err; } finally { try { if (!_n && null != _i["return"] && (_r = _i["return"](), Object(_r) !== _r)) return; } finally { if (_d) throw _e; } } return _arr; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; } /**
+ * 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.
+ */
+var HELP_THRESHOLD_CHARS = 80;
+var HELP_ICON_SX = Object.freeze({
+  padding: "2px",
+  color: "var(--fg-subtle)",
+  marginInlineStart: "var(--s-1)",
+  "&:hover, &:focus-visible": {
+    color: "var(--accent)",
+    background: "var(--bg-hover)"
+  }
+});
+var POPOVER_PAPER_SX = Object.freeze({
+  // Cap at 360 on desktop, but never exceed the viewport on small
+  // phones (320–392px): MUI Popover positions the anchor but does NOT
+  // shrink the paper width to the viewport, so a bare maxWidth:360
+  // overflows the screen edge and forces horizontal scroll (WCAG 1.4.10
+  // Reflow). The min() inset keeps the paper on screen with a single
+  // --s-4 gutter on either side.
+  maxWidth: "min(360px, calc(100vw - var(--s-4) * 2))",
+  padding: "var(--s-4)",
+  borderRadius: "var(--r-md)",
+  border: "1px solid var(--border)",
+  boxShadow: "var(--shadow-md)"
+});
+var POPOVER_TITLE_SX = Object.freeze({
+  fontSize: "var(--text-sm)",
+  fontWeight: "var(--fw-semibold)",
+  color: "var(--fg)",
+  marginBottom: "var(--s-1)"
+});
+var POPOVER_BODY_SX = Object.freeze({
+  fontSize: "var(--text-sm)",
+  color: "var(--fg-muted)",
+  // --lh-loose = 1.6 (typography.js). Was `var(--lh-relaxed, 1.6)` —
+  // a dangling reference to a token that doesn't exist in the v2
+  // lineHeight scale (only tight/snug/normal/loose are emitted). The
+  // fallback `1.6` happened to match --lh-loose by coincidence; this
+  // makes the dependency explicit and lets future retuning flow.
+  lineHeight: "var(--lh-loose)"
+});
+function resolveVariant(variant, content, title) {
+  if (variant !== "auto") return variant;
+  if (title) return "popover";
+  if (typeof content === "string" && content.length > HELP_THRESHOLD_CHARS) {
+    return "popover";
+  }
+  return "tooltip";
+}
+function FieldHelp(_ref) {
+  var content = _ref.content,
+    title = _ref.title,
+    _ref$variant = _ref.variant,
+    variant = _ref$variant === void 0 ? "auto" : _ref$variant,
+    _ref$icon = _ref.icon,
+    icon = _ref$icon === void 0 ? "help" : _ref$icon,
+    _ref$placement = _ref.placement,
+    placement = _ref$placement === void 0 ? "top" : _ref$placement,
+    _ref$ariaLabel = _ref.ariaLabel,
+    ariaLabel = _ref$ariaLabel === void 0 ? "Aide" : _ref$ariaLabel;
+  var _React$useState = React.useState(null),
+    _React$useState2 = _slicedToArray(_React$useState, 2),
+    anchorEl = _React$useState2[0],
+    setAnchorEl = _React$useState2[1];
+  // FH-1 — stable id so the dialog paper can be labelled by its visible
+  // title (used only when a title is rendered; see slotProps below).
+  var titleId = React.useId();
+  var effectiveVariant = resolveVariant(variant, content, title);
+  var IconComponent = icon === "info" ? _InfoOutlined["default"] : _HelpOutlineOutlined["default"];
+  if (effectiveVariant === "tooltip") {
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Tooltip["default"], {
+      title: content,
+      arrow: true,
+      placement: placement,
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_IconButton["default"], {
+        size: "small",
+        "aria-label": ariaLabel,
+        sx: HELP_ICON_SX,
+        tabIndex: 0,
+        children: /*#__PURE__*/(0, _jsxRuntime.jsx)(IconComponent, {
+          sx: {
+            fontSize: 16
+          }
+        })
+      })
+    });
+  }
+  var handleOpen = function handleOpen(e) {
+    return setAnchorEl(e.currentTarget);
+  };
+  var handleClose = function handleClose() {
+    return setAnchorEl(null);
+  };
+  var open = !!anchorEl;
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_IconButton["default"], {
+      size: "small",
+      "aria-label": ariaLabel
+      // R-Ar.6 / WAI-ARIA disclosure pattern — surfaces the
+      // overlay nature of the trigger to assistive tech. Without
+      // these attrs SR users hear a generic "Aide button" with
+      // no indication that activation opens content.
+      ,
+      "aria-haspopup": "dialog",
+      "aria-expanded": open,
+      onClick: handleOpen,
+      sx: HELP_ICON_SX,
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(IconComponent, {
+        sx: {
+          fontSize: 16
+        }
+      })
+    }), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_Popover["default"], {
+      open: open,
+      anchorEl: anchorEl,
+      onClose: handleClose,
+      anchorOrigin: {
+        vertical: "bottom",
+        horizontal: "left"
+      },
+      transformOrigin: {
+        vertical: "top",
+        horizontal: "left"
+      },
+      slotProps: {
+        paper: _objectSpread({
+          sx: POPOVER_PAPER_SX,
+          // FH-1 — the trigger promises a dialog; make the paper one and
+          // name it. Prefer the visible title (aria-labelledby, avoids a
+          // Label-in-Name mismatch); fall back to the ariaLabel prop.
+          role: "dialog"
+        }, title ? {
+          "aria-labelledby": titleId
+        } : {
+          "aria-label": ariaLabel
+        })
+      },
+      children: [title && /*#__PURE__*/(0, _jsxRuntime.jsx)(_Box["default"], {
+        id: titleId,
+        sx: POPOVER_TITLE_SX,
+        children: title
+      }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_Box["default"], {
+        sx: POPOVER_BODY_SX,
+        children: content
+      })]
+    })]
+  });
+}
+var _default = exports["default"] = FieldHelp;
+//# sourceMappingURL=FieldHelp.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FieldHelp.js","names":["React","_interopRequireWildcard","require","_Tooltip","_interopRequireDefault","_IconButton","_Box","_Popover","_HelpOutlineOutlined","_InfoOutlined","_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","_slicedToArray","arr","_arrayWithHoles","_iterableToArrayLimit","_unsupportedIterableToArray","_nonIterableRest","o","minLen","_arrayLikeToArray","n","toString","slice","constructor","name","Array","from","test","len","arr2","_i","iterator","_s","_e","_x","_r","_arr","_n","_d","next","done","err","isArray","HELP_THRESHOLD_CHARS","HELP_ICON_SX","freeze","padding","color","marginInlineStart","background","POPOVER_PAPER_SX","maxWidth","borderRadius","border","boxShadow","POPOVER_TITLE_SX","fontSize","fontWeight","marginBottom","POPOVER_BODY_SX","lineHeight","resolveVariant","variant","content","title","FieldHelp","_ref","_ref$variant","_ref$icon","icon","_ref$placement","placement","_ref$ariaLabel","ariaLabel","_React$useState","useState","_React$useState2","anchorEl","setAnchorEl","titleId","useId","effectiveVariant","IconComponent","InfoOutlinedIcon","HelpOutlineIcon","jsx","arrow","children","size","sx","tabIndex","handleOpen","e","currentTarget","handleClose","open","jsxs","Fragment","onClick","onClose","anchorOrigin","vertical","horizontal","transformOrigin","slotProps","paper","role","id","_default","exports"],"sources":["../../../src/lib/v2/components/FieldHelp.tsx"],"sourcesContent":["import * as React from \"react\";\r\nimport Tooltip from \"@mui/material/Tooltip\";\r\nimport type { TooltipProps } from \"@mui/material/Tooltip\";\r\nimport IconButton from \"@mui/material/IconButton\";\r\nimport Box from \"@mui/material/Box\";\r\nimport Popover from \"@mui/material/Popover\";\r\nimport HelpOutlineIcon from \"@mui/icons-material/HelpOutlineOutlined\";\r\nimport InfoOutlinedIcon from \"@mui/icons-material/InfoOutlined\";\r\n\r\n/**\r\n * FieldHelp - Portnet UI v2 (component)\r\n *\r\n * Charter §03 · Component \"FieldHelp · Contextual help\".\r\n *\r\n * A small icon-button affordance that hosts drop next to labels,\r\n * section titles, or anywhere a user might benefit from just-in-\r\n * time guidance without cluttering the primary visual hierarchy.\r\n *\r\n * Behaviour modes:\r\n *   - tooltip: MUI Tooltip (default for short string content).\r\n *   - popover: MUI Popover, click to open. Used when content is\r\n *     long (>80 chars) or when a distinct `title` is provided.\r\n *   - auto:    Picks tooltip vs popover via the heuristic above.\r\n *\r\n * Usage:\r\n *   <FieldHelp content=\"Référence unique de l'autorisation\" />\r\n *   <FieldHelp\r\n *     title=\"Détails\"\r\n *     content={<>Texte long avec <b>JSX</b>.</>}\r\n *     variant=\"popover\"\r\n *   />\r\n *\r\n * A11y (audit Batch 5, finding B5-1; Batch 19, FH-1):\r\n *   Popover variant trigger carries aria-haspopup=\"dialog\" +\r\n *   aria-expanded reflecting the open state — WAI-ARIA disclosure\r\n *   pattern. The Popover paper itself carries role=\"dialog\" and an\r\n *   accessible name (FH-1): aria-labelledby the visible title when\r\n *   one is rendered, else aria-label from the ariaLabel prop — so\r\n *   the region the trigger promises actually resolves as a named\r\n *   dialog to assistive tech. Tooltip variant relies on MUI\r\n *   Tooltip's automatic aria-describedby plumbing on the wrapped child.\r\n */\r\n\r\ntype FieldHelpVariant = \"auto\" | \"tooltip\" | \"popover\";\r\ntype FieldHelpIcon = \"help\" | \"info\";\r\n\r\nexport interface FieldHelpProps {\r\n  /** Help content (tooltip title or popover body). */\r\n  content: React.ReactNode;\r\n  /** Optional popover title. When present, forces the popover variant. */\r\n  title?: React.ReactNode;\r\n  /** @default \"auto\" */\r\n  variant?: FieldHelpVariant;\r\n  /** @default \"help\" */\r\n  icon?: FieldHelpIcon;\r\n  /** Tooltip placement. @default \"top\" */\r\n  placement?: TooltipProps[\"placement\"];\r\n  /** @default \"Aide\" */\r\n  ariaLabel?: string;\r\n}\r\n\r\nconst HELP_THRESHOLD_CHARS = 80;\r\n\r\nconst HELP_ICON_SX = Object.freeze({\r\n  padding: \"2px\",\r\n  color: \"var(--fg-subtle)\",\r\n  marginInlineStart: \"var(--s-1)\",\r\n  \"&:hover, &:focus-visible\": {\r\n    color: \"var(--accent)\",\r\n    background: \"var(--bg-hover)\",\r\n  },\r\n});\r\n\r\nconst POPOVER_PAPER_SX = Object.freeze({\r\n  // Cap at 360 on desktop, but never exceed the viewport on small\r\n  // phones (320–392px): MUI Popover positions the anchor but does NOT\r\n  // shrink the paper width to the viewport, so a bare maxWidth:360\r\n  // overflows the screen edge and forces horizontal scroll (WCAG 1.4.10\r\n  // Reflow). The min() inset keeps the paper on screen with a single\r\n  // --s-4 gutter on either side.\r\n  maxWidth: \"min(360px, calc(100vw - var(--s-4) * 2))\",\r\n  padding: \"var(--s-4)\",\r\n  borderRadius: \"var(--r-md)\",\r\n  border: \"1px solid var(--border)\",\r\n  boxShadow: \"var(--shadow-md)\",\r\n});\r\n\r\nconst POPOVER_TITLE_SX = Object.freeze({\r\n  fontSize: \"var(--text-sm)\",\r\n  fontWeight: \"var(--fw-semibold)\",\r\n  color: \"var(--fg)\",\r\n  marginBottom: \"var(--s-1)\",\r\n});\r\n\r\nconst POPOVER_BODY_SX = Object.freeze({\r\n  fontSize: \"var(--text-sm)\",\r\n  color: \"var(--fg-muted)\",\r\n  // --lh-loose = 1.6 (typography.js). Was `var(--lh-relaxed, 1.6)` —\r\n  // a dangling reference to a token that doesn't exist in the v2\r\n  // lineHeight scale (only tight/snug/normal/loose are emitted). The\r\n  // fallback `1.6` happened to match --lh-loose by coincidence; this\r\n  // makes the dependency explicit and lets future retuning flow.\r\n  lineHeight: \"var(--lh-loose)\",\r\n});\r\n\r\nfunction resolveVariant(\r\n  variant: FieldHelpVariant,\r\n  content: React.ReactNode,\r\n  title: React.ReactNode,\r\n): \"tooltip\" | \"popover\" {\r\n  if (variant !== \"auto\") return variant;\r\n  if (title) return \"popover\";\r\n  if (typeof content === \"string\" && content.length > HELP_THRESHOLD_CHARS) {\r\n    return \"popover\";\r\n  }\r\n  return \"tooltip\";\r\n}\r\n\r\nfunction FieldHelp({\r\n  content,\r\n  title,\r\n  variant = \"auto\",\r\n  icon = \"help\",\r\n  placement = \"top\",\r\n  ariaLabel = \"Aide\",\r\n}: FieldHelpProps) {\r\n  const [anchorEl, setAnchorEl] = React.useState<HTMLElement | null>(null);\r\n  // FH-1 — stable id so the dialog paper can be labelled by its visible\r\n  // title (used only when a title is rendered; see slotProps below).\r\n  const titleId = React.useId();\r\n\r\n  const effectiveVariant = resolveVariant(variant, content, title);\r\n  const IconComponent = icon === \"info\" ? InfoOutlinedIcon : HelpOutlineIcon;\r\n\r\n  if (effectiveVariant === \"tooltip\") {\r\n    return (\r\n      <Tooltip title={content} arrow placement={placement}>\r\n        <IconButton\r\n          size=\"small\"\r\n          aria-label={ariaLabel}\r\n          sx={HELP_ICON_SX}\r\n          tabIndex={0}\r\n        >\r\n          <IconComponent sx={{ fontSize: 16 }} />\r\n        </IconButton>\r\n      </Tooltip>\r\n    );\r\n  }\r\n\r\n  const handleOpen = (e: React.MouseEvent<HTMLElement>) => setAnchorEl(e.currentTarget);\r\n  const handleClose = () => setAnchorEl(null);\r\n  const open = !!anchorEl;\r\n\r\n  return (\r\n    <>\r\n      <IconButton\r\n        size=\"small\"\r\n        aria-label={ariaLabel}\r\n        // R-Ar.6 / WAI-ARIA disclosure pattern — surfaces the\r\n        // overlay nature of the trigger to assistive tech. Without\r\n        // these attrs SR users hear a generic \"Aide button\" with\r\n        // no indication that activation opens content.\r\n        aria-haspopup=\"dialog\"\r\n        aria-expanded={open}\r\n        onClick={handleOpen}\r\n        sx={HELP_ICON_SX}\r\n      >\r\n        <IconComponent sx={{ fontSize: 16 }} />\r\n      </IconButton>\r\n      <Popover\r\n        open={open}\r\n        anchorEl={anchorEl}\r\n        onClose={handleClose}\r\n        anchorOrigin={{ vertical: \"bottom\", horizontal: \"left\" }}\r\n        transformOrigin={{ vertical: \"top\", horizontal: \"left\" }}\r\n        slotProps={{\r\n          paper: {\r\n            sx: POPOVER_PAPER_SX,\r\n            // FH-1 — the trigger promises a dialog; make the paper one and\r\n            // name it. Prefer the visible title (aria-labelledby, avoids a\r\n            // Label-in-Name mismatch); fall back to the ariaLabel prop.\r\n            role: \"dialog\",\r\n            ...(title\r\n              ? { \"aria-labelledby\": titleId }\r\n              : { \"aria-label\": ariaLabel }),\r\n          },\r\n        }}\r\n      >\r\n        {title && (\r\n          <Box id={titleId} sx={POPOVER_TITLE_SX}>\r\n            {title}\r\n          </Box>\r\n        )}\r\n        <Box sx={POPOVER_BODY_SX}>{content}</Box>\r\n      </Popover>\r\n    </>\r\n  );\r\n}\r\n\r\nexport default FieldHelp;\r\n"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,35 @@
+import * as React from "react";
+/**
+ * FilterTab - Portnet UI v2
+ *
+ * Charter §03 · Component "FilterTabs". Pills used to quickly filter a list
+ * by status, with an active-state count and pop animation on update.
+ *
+ *   <FilterTab active={filter === "all"} count={42} onClick={() => setFilter("all")}>
+ *     Tous
+ *   </FilterTab>
+ *
+ * Localisation (FR / EN / AR):
+ *   <FilterTab labels={{
+ *     countLabel:   (n) => `${n} items`,
+ *     shortcutHint: (s) => `Shortcut: ${s}`,
+ *   }} ... />
+ */
+export type FilterTabVariant = "neutral" | "new" | "sent" | "pending" | "approved" | "rejected";
+export interface FilterTabLabels {
+    countLabel?: (n: number) => string;
+    shortcutHint?: (s: string) => string;
+}
+export interface FilterTabProps {
+    active?: boolean;
+    count?: number;
+    /** neutral | new | sent | pending | approved | rejected */
+    variant?: FilterTabVariant;
+    onClick?: React.MouseEventHandler<HTMLButtonElement>;
+    shortcut?: string;
+    labels?: FilterTabLabels;
+    children?: React.ReactNode;
+}
+declare function FilterTab({ active, count, variant, onClick, shortcut, labels, children, }: FilterTabProps): React.JSX.Element;
+export default FilterTab;
+//# sourceMappingURL=FilterTab.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FilterTab.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/components/FilterTab.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,KAAK,GACL,MAAM,GACN,SAAS,GACT,UAAU,GACV,UAAU,CAAC;AAwBf,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACnC,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,OAAO,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,CAAC;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED,iBAAS,SAAS,CAAC,EACjB,MAAc,EACd,KAAK,EACL,OAAmB,EACnB,OAAO,EACP,QAAQ,EACR,MAAM,EACN,QAAQ,GACT,EAAE,cAAc,qBAuEhB;AAED,eAAe,SAAS,CAAC"}

package/dist/v2/components/FilterTab.js

@@ -0,0 +1,144 @@
+"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 _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); } /**
+ * FilterTab - Portnet UI v2
+ *
+ * Charter §03 · Component "FilterTabs". Pills used to quickly filter a list
+ * by status, with an active-state count and pop animation on update.
+ *
+ *   <FilterTab active={filter === "all"} count={42} onClick={() => setFilter("all")}>
+ *     Tous
+ *   </FilterTab>
+ *
+ * Localisation (FR / EN / AR):
+ *   <FilterTab labels={{
+ *     countLabel:   (n) => `${n} items`,
+ *     shortcutHint: (s) => `Shortcut: ${s}`,
+ *   }} ... />
+ */
+// Module-scoped to avoid Temporal Dead Zone when an invalid `variant` is
+// passed: a local-const initialiser referencing palette.neutral before
+// palette finished initialising would throw ReferenceError.
+var PALETTES = {
+  neutral: {
+    activeBg: "var(--accent-soft)",
+    activeFg: "var(--accent)"
+  },
+  "new": {
+    activeBg: "var(--status-new-soft)",
+    activeFg: "var(--status-new-fg)"
+  },
+  sent: {
+    activeBg: "var(--status-sent-soft)",
+    activeFg: "var(--status-sent-fg)"
+  },
+  pending: {
+    activeBg: "var(--status-pending-soft)",
+    activeFg: "var(--status-pending-fg)"
+  },
+  approved: {
+    activeBg: "var(--status-approved-soft)",
+    activeFg: "var(--status-approved-fg)"
+  },
+  rejected: {
+    activeBg: "var(--status-rejected-soft)",
+    activeFg: "var(--status-rejected-fg)"
+  }
+};
+var DEFAULT_LABELS = Object.freeze({
+  countLabel: function countLabel(n) {
+    return "".concat(n, " \xE9l\xE9ments");
+  },
+  shortcutHint: function shortcutHint(s) {
+    return "Raccourci : ".concat(s);
+  }
+});
+function FilterTab(_ref) {
+  var _ref$active = _ref.active,
+    active = _ref$active === void 0 ? false : _ref$active,
+    count = _ref.count,
+    _ref$variant = _ref.variant,
+    variant = _ref$variant === void 0 ? "neutral" : _ref$variant,
+    onClick = _ref.onClick,
+    shortcut = _ref.shortcut,
+    labels = _ref.labels,
+    children = _ref.children;
+  var palette = PALETTES[variant] || PALETTES.neutral;
+  var L = labels ? _objectSpread(_objectSpread({}, DEFAULT_LABELS), labels) : DEFAULT_LABELS;
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_Box["default"], {
+    component: "button",
+    type: "button",
+    "aria-pressed": active,
+    onClick: onClick,
+    title: shortcut ? L.shortcutHint(shortcut) : undefined,
+    sx: {
+      display: "inline-flex",
+      alignItems: "center",
+      gap: "var(--s-2)",
+      // Compact pill: 5/12 px in literal terms, expressed against
+      // the spacing scale so any future rescale propagates.
+      padding: "calc(var(--s-1) + 1px) var(--s-3)",
+      borderRadius: "var(--r-full)",
+      border: "1px solid ".concat(active ? "var(--accent)" : "var(--border)"),
+      background: active ? palette.activeBg : "var(--surface)",
+      color: active ? palette.activeFg : "var(--fg-muted)",
+      fontSize: "var(--text-xs)",
+      // Was 650 (banned) / 500. var(--fw-semibold) is the canonical
+      // emphasised weight; var(--fw-medium) the resting one.
+      fontWeight: active ? "var(--fw-semibold)" : "var(--fw-medium)",
+      cursor: "pointer",
+      fontFamily: "inherit",
+      transition: "background var(--duration-fast, 120ms) ease, " + "color var(--duration-fast, 120ms) ease, " + "border-color var(--duration-fast, 120ms) ease",
+      // R-F.1 - focus-visible required, charter §05. The previous
+      // implementation had NO focus style; keyboard users got no
+      // feedback when tabbing through filter chips.
+      "&:focus-visible": {
+        outline: "2px solid var(--accent)",
+        outlineOffset: "var(--pui-outline-offset)"
+      },
+      "&:hover": _objectSpread({}, !active ? {
+        background: "var(--bg-hover)"
+      } : {})
+    },
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
+      children: children
+    }), count != null && /*#__PURE__*/(0, _jsxRuntime.jsx)(_Box["default"], {
+      component: "span",
+      "aria-label": L.countLabel(count),
+      sx: {
+        display: "inline-block",
+        minWidth: 16,
+        padding: "0 var(--s-1)",
+        fontSize: "var(--text-xs)",
+        fontWeight: "var(--fw-bold)",
+        // Active keeps the accent emphasis (unchanged). Inactive now
+        // takes the variant palette (soft bg + status fg) so status
+        // counts stay colour-coded instead of greying out; neutral
+        // resolves to accent-soft / accent.
+        background: active ? "var(--accent)" : palette.activeBg,
+        color: active ? "var(--accent-fg)" : palette.activeFg,
+        borderRadius: "var(--r-full)",
+        lineHeight: "var(--lh-snug)",
+        textAlign: "center"
+      },
+      children: count
+    })]
+  });
+}
+var _default = exports["default"] = FilterTab;
+//# sourceMappingURL=FilterTab.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FilterTab.js","names":["React","_interopRequireWildcard","require","_Box","_interopRequireDefault","_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","PALETTES","neutral","activeBg","activeFg","sent","pending","approved","rejected","DEFAULT_LABELS","freeze","countLabel","n","concat","shortcutHint","s","FilterTab","_ref","_ref$active","active","count","_ref$variant","variant","onClick","shortcut","labels","children","palette","L","jsxs","component","type","title","sx","display","alignItems","gap","padding","borderRadius","border","background","color","fontSize","fontWeight","cursor","fontFamily","transition","outline","outlineOffset","jsx","minWidth","lineHeight","textAlign","_default","exports"],"sources":["../../../src/lib/v2/components/FilterTab.tsx"],"sourcesContent":["import * as React from \"react\";\r\nimport Box from \"@mui/material/Box\";\r\n\r\n/**\r\n * FilterTab - Portnet UI v2\r\n *\r\n * Charter §03 · Component \"FilterTabs\". Pills used to quickly filter a list\r\n * by status, with an active-state count and pop animation on update.\r\n *\r\n *   <FilterTab active={filter === \"all\"} count={42} onClick={() => setFilter(\"all\")}>\r\n *     Tous\r\n *   </FilterTab>\r\n *\r\n * Localisation (FR / EN / AR):\r\n *   <FilterTab labels={{\r\n *     countLabel:   (n) => `${n} items`,\r\n *     shortcutHint: (s) => `Shortcut: ${s}`,\r\n *   }} ... />\r\n */\r\n\r\nexport type FilterTabVariant =\r\n  | \"neutral\"\r\n  | \"new\"\r\n  | \"sent\"\r\n  | \"pending\"\r\n  | \"approved\"\r\n  | \"rejected\";\r\n\r\ninterface PaletteEntry {\r\n  activeBg: string;\r\n  activeFg: string;\r\n}\r\n\r\n// Module-scoped to avoid Temporal Dead Zone when an invalid `variant` is\r\n// passed: a local-const initialiser referencing palette.neutral before\r\n// palette finished initialising would throw ReferenceError.\r\nconst PALETTES: Record<FilterTabVariant, PaletteEntry> = {\r\n  neutral:  { activeBg: \"var(--accent-soft)\",          activeFg: \"var(--accent)\" },\r\n  new:      { activeBg: \"var(--status-new-soft)\",      activeFg: \"var(--status-new-fg)\" },\r\n  sent:     { activeBg: \"var(--status-sent-soft)\",     activeFg: \"var(--status-sent-fg)\" },\r\n  pending:  { activeBg: \"var(--status-pending-soft)\",  activeFg: \"var(--status-pending-fg)\" },\r\n  approved: { activeBg: \"var(--status-approved-soft)\", activeFg: \"var(--status-approved-fg)\" },\r\n  rejected: { activeBg: \"var(--status-rejected-soft)\", activeFg: \"var(--status-rejected-fg)\" },\r\n};\r\n\r\nconst DEFAULT_LABELS = Object.freeze({\r\n  countLabel:   (n: number): string => `${n} éléments`,\r\n  shortcutHint: (s: string): string => `Raccourci : ${s}`,\r\n});\r\n\r\nexport interface FilterTabLabels {\r\n  countLabel?: (n: number) => string;\r\n  shortcutHint?: (s: string) => string;\r\n}\r\n\r\nexport interface FilterTabProps {\r\n  active?: boolean;\r\n  count?: number;\r\n  /** neutral | new | sent | pending | approved | rejected */\r\n  variant?: FilterTabVariant;\r\n  onClick?: React.MouseEventHandler<HTMLButtonElement>;\r\n  shortcut?: string;\r\n  labels?: FilterTabLabels;\r\n  children?: React.ReactNode;\r\n}\r\n\r\nfunction FilterTab({\r\n  active = false,\r\n  count,\r\n  variant = \"neutral\",\r\n  onClick,\r\n  shortcut,\r\n  labels,\r\n  children,\r\n}: FilterTabProps) {\r\n  const palette = PALETTES[variant] || PALETTES.neutral;\r\n  const L = labels ? { ...DEFAULT_LABELS, ...labels } : DEFAULT_LABELS;\r\n\r\n  return (\r\n    <Box\r\n      component=\"button\"\r\n      type=\"button\"\r\n      aria-pressed={active}\r\n      onClick={onClick}\r\n      title={shortcut ? L.shortcutHint(shortcut) : undefined}\r\n      sx={{\r\n        display: \"inline-flex\",\r\n        alignItems: \"center\",\r\n        gap: \"var(--s-2)\",\r\n        // Compact pill: 5/12 px in literal terms, expressed against\r\n        // the spacing scale so any future rescale propagates.\r\n        padding: \"calc(var(--s-1) + 1px) var(--s-3)\",\r\n        borderRadius: \"var(--r-full)\",\r\n        border: `1px solid ${active ? \"var(--accent)\" : \"var(--border)\"}`,\r\n        background: active ? palette.activeBg : \"var(--surface)\",\r\n        color: active ? palette.activeFg : \"var(--fg-muted)\",\r\n        fontSize: \"var(--text-xs)\",\r\n        // Was 650 (banned) / 500. var(--fw-semibold) is the canonical\r\n        // emphasised weight; var(--fw-medium) the resting one.\r\n        fontWeight: active ? \"var(--fw-semibold)\" : \"var(--fw-medium)\",\r\n        cursor: \"pointer\",\r\n        fontFamily: \"inherit\",\r\n        transition:\r\n          \"background var(--duration-fast, 120ms) ease, \" +\r\n          \"color var(--duration-fast, 120ms) ease, \" +\r\n          \"border-color var(--duration-fast, 120ms) ease\",\r\n        // R-F.1 - focus-visible required, charter §05. The previous\r\n        // implementation had NO focus style; keyboard users got no\r\n        // feedback when tabbing through filter chips.\r\n        \"&:focus-visible\": {\r\n          outline: \"2px solid var(--accent)\",\r\n          outlineOffset: \"var(--pui-outline-offset)\",\r\n        },\r\n        \"&:hover\": {\r\n          ...(!active ? { background: \"var(--bg-hover)\" } : {}),\r\n        },\r\n      }}\r\n    >\r\n      <span>{children}</span>\r\n      {count != null && (\r\n        <Box\r\n          component=\"span\"\r\n          aria-label={L.countLabel(count)}\r\n          sx={{\r\n            display: \"inline-block\",\r\n            minWidth: 16,\r\n            padding: \"0 var(--s-1)\",\r\n            fontSize: \"var(--text-xs)\",\r\n            fontWeight: \"var(--fw-bold)\",\r\n            // Active keeps the accent emphasis (unchanged). Inactive now\r\n            // takes the variant palette (soft bg + status fg) so status\r\n            // counts stay colour-coded instead of greying out; neutral\r\n            // resolves to accent-soft / accent.\r\n            background: active ? \"var(--accent)\" : palette.activeBg,\r\n            color: active ? \"var(--accent-fg)\" : palette.activeFg,\r\n            borderRadius: \"var(--r-full)\",\r\n            lineHeight: \"var(--lh-snug)\",\r\n            textAlign: \"center\",\r\n          }}\r\n        >\r\n          {count}\r\n        </Box>\r\n      )}\r\n    </Box>\r\n  );\r\n}\r\n\r\nexport default FilterTab;\r\n"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,40 @@
+/**
+ * ForbiddenPage — Portnet UI v2 (component)
+ *
+ * Charter §07 · 403 / Accès refusé.
+ *
+ * Router-agnostic by design: the page accepts `onBack` and `onHome`
+ * callback props rather than calling a router hook itself. This
+ * keeps the design system independent of any specific routing lib
+ * (react-router, TanStack Router, Next.js, …).
+ *
+ * Usage:
+ *
+ *   import { ForbiddenPage } from "@portnet/ui/lib/v2";
+ *   import { useNavigate } from "react-router-dom";
+ *
+ *   function ForbiddenRoute() {
+ *     const navigate = useNavigate();
+ *     return (
+ *       <ForbiddenPage
+ *         onBack={() => navigate(-1)}
+ *         onHome={() => navigate("/")}
+ *       />
+ *     );
+ *   }
+ *
+ * Charter rules satisfied:
+ *   R-2.1   no local UI primitive (composes ActionBar + Button only).
+ *   R-Tg.1  44 px tactile floor enforced by v2.Button.
+ *   R-A.1   ARIA landmarks via ActionBar's <header role="banner">.
+ *   R-T.2   contrast verified for var(--fg) on var(--bg).
+ */
+export interface ForbiddenPageProps {
+    /** Callback for the back button (top-bar arrow). */
+    onBack: () => void;
+    /** Callback for the primary "Retour à l'accueil" CTA. */
+    onHome: () => void;
+}
+declare function ForbiddenPage({ onBack, onHome }: ForbiddenPageProps): import("react").JSX.Element;
+export default ForbiddenPage;
+//# sourceMappingURL=ForbiddenPage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ForbiddenPage.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/components/ForbiddenPage.tsx"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,WAAW,kBAAkB;IACjC,oDAAoD;IACpD,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,yDAAyD;IACzD,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,iBAAS,aAAa,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,kBAAkB,+BAqB5D;AAED,eAAe,aAAa,CAAC"}