@portnet/ui 5.0.32 → 6.0.1

package/dist/v2/components/Segmented.js

@@ -0,0 +1,261 @@
+"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 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 _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); } /**
+ * Segmented - Portnet UI v2
+ *
+ * Charter §03 · Component "Segmented control". Single-selection input
+ * for 2-4 mutually exclusive options. Use when Radio would feel
+ * overweighted (R-Sel.2). For panel switching use <Tabs> instead.
+ *
+ *   <Segmented
+ *     value={density}
+ *     onChange={setDensity}
+ *     options={[
+ *       { value: "comfortable", label: "Confort" },
+ *       { value: "compact",     label: "Compact" },
+ *     ]}
+ *     aria-label="Densité d'affichage"
+ *   />
+ *
+ *   With icons (icon-only is allowed but each option MUST then have its
+ *   own aria-label):
+ *
+ *   <Segmented
+ *     value={view} onChange={setView}
+ *     options={[
+ *       { value: "list", icon: <ViewListIcon />,    "aria-label": "Liste" },
+ *       { value: "grid", icon: <ViewModuleIcon />, "aria-label": "Grille" },
+ *     ]}
+ *     aria-label="Mode d'affichage"
+ *   />
+ *
+ * A11y note (R-K.1):
+ *   role="radiogroup" + role="radio" with roving tabindex per WAI-ARIA.
+ *   Arrow keys move focus AND auto-select (selection follows focus).
+ *   Space/Enter re-affirm the focused option (no-op under auto-select,
+ *   but consumes the keystroke so automated a11y audits don't flag the
+ *   role and so users following the alternative WAI-ARIA radiogroup
+ *   pattern aren't surprised).
+ */
+function Segmented(_ref) {
+  var _options$selectedInde;
+  var value = _ref.value,
+    onChange = _ref.onChange,
+    options = _ref.options,
+    _ref$size = _ref.size,
+    size = _ref$size === void 0 ? "md" : _ref$size,
+    _ref$fullWidth = _ref.fullWidth,
+    fullWidth = _ref$fullWidth === void 0 ? false : _ref$fullWidth,
+    _ref$disabled = _ref.disabled,
+    disabled = _ref$disabled === void 0 ? false : _ref$disabled,
+    ariaLabel = _ref["aria-label"],
+    ariaLabelledBy = _ref["aria-labelledby"],
+    sx = _ref.sx;
+  if (process.env["NODE_ENV"] !== "production") {
+    if (!ariaLabel && !ariaLabelledBy) {
+      // eslint-disable-next-line no-console
+      console.warn("[@portnet/ui v2] <Segmented> requires aria-label or aria-labelledby on the radiogroup.");
+    }
+    if (options.length < 2 || options.length > 4) {
+      // eslint-disable-next-line no-console
+      console.warn("[@portnet/ui v2] <Segmented> with ".concat(options.length, " options - charter R-Sel.2 says 2-4. ") + "Below 2: drop the control. Above 4: use <Select> or <Tabs>.");
+    }
+  }
+  var refs = React.useRef([]);
+
+  // Index of the currently-selected option drives aria-checked + styling.
+  var selectedIndex = Math.max(0, options.findIndex(function (o) {
+    return o.value === value;
+  }));
+
+  // SEG-1 — Roving tabindex target. Per WAI-ARIA only ONE option is tabbable;
+  // normally that's the selected one, but if the current value points at a
+  // disabled option we fall back to the first enabled option so the group is
+  // still reachable by Tab (WCAG 2.1.1). -1 when every option is disabled.
+  var tabbableIndex = !((_options$selectedInde = options[selectedIndex]) !== null && _options$selectedInde !== void 0 && _options$selectedInde.disabled) ? selectedIndex : options.findIndex(function (o) {
+    return !o.disabled;
+  });
+  var focusOption = function focusOption(i) {
+    var node = refs.current[i];
+    if (node) node.focus();
+  };
+  var move = function move(delta) {
+    var len = options.length;
+    var next = selectedIndex;
+    for (var step = 0; step < len; step += 1) {
+      var _options$next;
+      next = (next + delta + len) % len;
+      if (!((_options$next = options[next]) !== null && _options$next !== void 0 && _options$next.disabled)) break;
+    }
+    var target = options[next];
+    if (target && !target.disabled) {
+      onChange === null || onChange === void 0 ? void 0 : onChange(target.value);
+      // schedule focus to land after React commits the new selectedIndex
+      requestAnimationFrame(function () {
+        return focusOption(next);
+      });
+    }
+  };
+  var handleKeyDown = function handleKeyDown(e) {
+    if (disabled) return;
+    switch (e.key) {
+      case "ArrowRight":
+      case "ArrowDown":
+        e.preventDefault();
+        move(+1);
+        break;
+      case "ArrowLeft":
+      case "ArrowUp":
+        e.preventDefault();
+        move(-1);
+        break;
+      case "Home":
+        {
+          e.preventDefault();
+          var first = options.findIndex(function (o) {
+            return !o.disabled;
+          });
+          var opt = first >= 0 ? options[first] : undefined;
+          if (opt) {
+            onChange === null || onChange === void 0 ? void 0 : onChange(opt.value);
+            requestAnimationFrame(function () {
+              return focusOption(first);
+            });
+          }
+          break;
+        }
+      case "End":
+        {
+          e.preventDefault();
+          var _loop = function _loop(i) {
+            var opt = options[i];
+            if (opt && !opt.disabled) {
+              onChange === null || onChange === void 0 ? void 0 : onChange(opt.value);
+              requestAnimationFrame(function () {
+                return focusOption(i);
+              });
+              return {
+                v: void 0
+              };
+            }
+          };
+          for (var i = options.length - 1; i >= 0; i -= 1) {
+            var _ret = _loop(i);
+            if (_typeof(_ret) === "object") return _ret.v;
+          }
+          break;
+        }
+      case " ":
+      case "Enter":
+        {
+          // R-K.1 - Space/Enter re-affirm the focused (= selected) option.
+          var _opt = options[selectedIndex];
+          if (_opt && !_opt.disabled) {
+            e.preventDefault();
+            onChange === null || onChange === void 0 ? void 0 : onChange(_opt.value);
+          }
+          break;
+        }
+      default:
+    }
+  };
+
+  // Per-option padding pulled from the spacing scale (var(--s-1) = 4 px,
+  // var(--s-2) = 8 px). The "+2" on the small horizontal padding
+  // mirrors the +2 button padding offset in createPortnetTheme — all
+  // small interactive elements add a 2 px breathing offset to the
+  // base grid for visual rhythm.
+  var padY = size === "sm" ? "var(--s-1)" : "calc(var(--s-1) + 2px)";
+  var padX = size === "sm" ? "calc(var(--s-2) + 2px)" : "var(--s-3)";
+  var fontSize = size === "sm" ? "var(--text-xs)" : "var(--text-sm)";
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Box["default"], {
+    role: "radiogroup",
+    "aria-label": ariaLabel,
+    "aria-labelledby": ariaLabelledBy,
+    "aria-disabled": disabled || undefined,
+    onKeyDown: handleKeyDown,
+    sx: _objectSpread({
+      display: "inline-flex",
+      width: fullWidth ? "100%" : "auto",
+      padding: "2px",
+      background: "var(--bg-subtle)",
+      border: "1px solid var(--border)",
+      borderRadius: "var(--r-md)",
+      gap: "2px",
+      opacity: disabled ? 0.55 : 1
+    }, sx),
+    children: options.map(function (opt, i) {
+      var isSelected = i === selectedIndex;
+      var isDisabled = disabled || opt.disabled;
+      return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_Box["default"], {
+        ref: function ref(el) {
+          refs.current[i] = el;
+        },
+        role: "radio",
+        "aria-checked": isSelected,
+        "aria-disabled": isDisabled || undefined,
+        "aria-label": opt["aria-label"],
+        tabIndex: i === tabbableIndex && !isDisabled ? 0 : -1,
+        onClick: function onClick() {
+          if (isDisabled || isSelected) return;
+          onChange === null || onChange === void 0 ? void 0 : onChange(opt.value);
+        },
+        sx: {
+          flex: fullWidth ? 1 : "0 0 auto",
+          display: "inline-flex",
+          alignItems: "center",
+          justifyContent: "center",
+          gap: 0.75,
+          padding: "".concat(padY, " ").concat(padX),
+          borderRadius: "calc(var(--r-md) - 2px)",
+          fontSize: fontSize,
+          fontWeight: isSelected ? "var(--fw-semibold)" : "var(--fw-medium)",
+          color: isSelected ? "var(--fg)" : "var(--fg-muted)",
+          background: isSelected ? "var(--surface)" : "transparent",
+          boxShadow: isSelected ? "var(--shadow-xs)" : "none",
+          cursor: isDisabled ? "not-allowed" : isSelected ? "default" : "pointer",
+          userSelect: "none",
+          whiteSpace: "nowrap",
+          transition: "background var(--duration-fast, 80ms) ease, color var(--duration-fast, 80ms) ease",
+          "&:hover": _objectSpread({}, !isSelected && !isDisabled ? {
+            background: "var(--bg-hover)",
+            color: "var(--fg)"
+          } : {}),
+          "&:focus-visible": {
+            outline: "2px solid var(--accent)",
+            outlineOffset: "var(--pui-outline-offset)"
+          }
+        },
+        children: [opt.icon && /*#__PURE__*/(0, _jsxRuntime.jsx)(_Box["default"], {
+          component: "span",
+          "aria-hidden": "true",
+          sx: {
+            display: "inline-flex",
+            color: "currentColor"
+          },
+          children: opt.icon
+        }), opt.label && /*#__PURE__*/(0, _jsxRuntime.jsx)(_Box["default"], {
+          component: "span",
+          children: opt.label
+        })]
+      }, opt.value);
+    })
+  });
+}
+var _default = exports["default"] = Segmented;
+//# sourceMappingURL=Segmented.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Segmented.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","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","iterator","constructor","Segmented","_ref","_options$selectedInde","onChange","options","_ref$size","size","_ref$fullWidth","fullWidth","_ref$disabled","disabled","ariaLabel","ariaLabelledBy","sx","process","env","console","warn","concat","refs","useRef","selectedIndex","Math","max","findIndex","o","tabbableIndex","focusOption","node","current","focus","move","delta","len","next","step","_options$next","requestAnimationFrame","handleKeyDown","e","preventDefault","first","opt","_loop","v","_ret","padY","padX","fontSize","jsx","role","onKeyDown","display","width","padding","background","border","borderRadius","gap","opacity","children","map","isSelected","isDisabled","jsxs","ref","el","tabIndex","onClick","flex","alignItems","justifyContent","fontWeight","color","boxShadow","cursor","userSelect","whiteSpace","transition","outline","outlineOffset","icon","component","label","_default","exports"],"sources":["../../../src/lib/v2/components/Segmented.tsx"],"sourcesContent":["import * as React from \"react\";\r\nimport Box from \"@mui/material/Box\";\r\nimport type { SxProps, Theme } from \"@mui/material/styles\";\r\n\r\n/**\r\n * Segmented - Portnet UI v2\r\n *\r\n * Charter §03 · Component \"Segmented control\". Single-selection input\r\n * for 2-4 mutually exclusive options. Use when Radio would feel\r\n * overweighted (R-Sel.2). For panel switching use <Tabs> instead.\r\n *\r\n *   <Segmented\r\n *     value={density}\r\n *     onChange={setDensity}\r\n *     options={[\r\n *       { value: \"comfortable\", label: \"Confort\" },\r\n *       { value: \"compact\",     label: \"Compact\" },\r\n *     ]}\r\n *     aria-label=\"Densité d'affichage\"\r\n *   />\r\n *\r\n *   With icons (icon-only is allowed but each option MUST then have its\r\n *   own aria-label):\r\n *\r\n *   <Segmented\r\n *     value={view} onChange={setView}\r\n *     options={[\r\n *       { value: \"list\", icon: <ViewListIcon />,    \"aria-label\": \"Liste\" },\r\n *       { value: \"grid\", icon: <ViewModuleIcon />, \"aria-label\": \"Grille\" },\r\n *     ]}\r\n *     aria-label=\"Mode d'affichage\"\r\n *   />\r\n *\r\n * A11y note (R-K.1):\r\n *   role=\"radiogroup\" + role=\"radio\" with roving tabindex per WAI-ARIA.\r\n *   Arrow keys move focus AND auto-select (selection follows focus).\r\n *   Space/Enter re-affirm the focused option (no-op under auto-select,\r\n *   but consumes the keystroke so automated a11y audits don't flag the\r\n *   role and so users following the alternative WAI-ARIA radiogroup\r\n *   pattern aren't surprised).\r\n */\r\n\r\nexport type SegmentedValue = string | number;\r\n\r\nexport interface SegmentedOption {\r\n  value: SegmentedValue;\r\n  label?: React.ReactNode | undefined;\r\n  icon?: React.ReactElement | undefined;\r\n  disabled?: boolean | undefined;\r\n  \"aria-label\"?: string | undefined;\r\n}\r\n\r\nexport interface SegmentedProps {\r\n  value: SegmentedValue;\r\n  onChange?: ((value: SegmentedValue) => void) | undefined;\r\n  options: SegmentedOption[];\r\n  size?: \"sm\" | \"md\" | undefined;\r\n  fullWidth?: boolean | undefined;\r\n  disabled?: boolean | undefined;\r\n  \"aria-label\"?: string | undefined;\r\n  \"aria-labelledby\"?: string | undefined;\r\n  sx?: SxProps<Theme> | undefined;\r\n}\r\n\r\nfunction Segmented({\r\n  value,\r\n  onChange,\r\n  options,\r\n  size = \"md\",\r\n  fullWidth = false,\r\n  disabled = false,\r\n  \"aria-label\": ariaLabel,\r\n  \"aria-labelledby\": ariaLabelledBy,\r\n  sx,\r\n}: SegmentedProps) {\r\n  if (process.env[\"NODE_ENV\"] !== \"production\") {\r\n    if (!ariaLabel && !ariaLabelledBy) {\r\n      // eslint-disable-next-line no-console\r\n      console.warn(\r\n        \"[@portnet/ui v2] <Segmented> requires aria-label or aria-labelledby on the radiogroup.\"\r\n      );\r\n    }\r\n    if (options.length < 2 || options.length > 4) {\r\n      // eslint-disable-next-line no-console\r\n      console.warn(\r\n        `[@portnet/ui v2] <Segmented> with ${options.length} options - charter R-Sel.2 says 2-4. ` +\r\n        \"Below 2: drop the control. Above 4: use <Select> or <Tabs>.\"\r\n      );\r\n    }\r\n  }\r\n\r\n  const refs = React.useRef<Array<HTMLDivElement | null>>([]);\r\n\r\n  // Index of the currently-selected option drives aria-checked + styling.\r\n  const selectedIndex = Math.max(\r\n    0,\r\n    options.findIndex((o) => o.value === value)\r\n  );\r\n\r\n  // SEG-1 — Roving tabindex target. Per WAI-ARIA only ONE option is tabbable;\r\n  // normally that's the selected one, but if the current value points at a\r\n  // disabled option we fall back to the first enabled option so the group is\r\n  // still reachable by Tab (WCAG 2.1.1). -1 when every option is disabled.\r\n  const tabbableIndex = !options[selectedIndex]?.disabled\r\n    ? selectedIndex\r\n    : options.findIndex((o) => !o.disabled);\r\n\r\n  const focusOption = (i: number) => {\r\n    const node = refs.current[i];\r\n    if (node) node.focus();\r\n  };\r\n\r\n  const move = (delta: number) => {\r\n    const len = options.length;\r\n    let next = selectedIndex;\r\n    for (let step = 0; step < len; step += 1) {\r\n      next = (next + delta + len) % len;\r\n      if (!options[next]?.disabled) break;\r\n    }\r\n    const target = options[next];\r\n    if (target && !target.disabled) {\r\n      onChange?.(target.value);\r\n      // schedule focus to land after React commits the new selectedIndex\r\n      requestAnimationFrame(() => focusOption(next));\r\n    }\r\n  };\r\n\r\n  const handleKeyDown = (e: React.KeyboardEvent<HTMLDivElement>) => {\r\n    if (disabled) return;\r\n    switch (e.key) {\r\n      case \"ArrowRight\":\r\n      case \"ArrowDown\":\r\n        e.preventDefault();\r\n        move(+1);\r\n        break;\r\n      case \"ArrowLeft\":\r\n      case \"ArrowUp\":\r\n        e.preventDefault();\r\n        move(-1);\r\n        break;\r\n      case \"Home\": {\r\n        e.preventDefault();\r\n        const first = options.findIndex((o) => !o.disabled);\r\n        const opt = first >= 0 ? options[first] : undefined;\r\n        if (opt) {\r\n          onChange?.(opt.value);\r\n          requestAnimationFrame(() => focusOption(first));\r\n        }\r\n        break;\r\n      }\r\n      case \"End\": {\r\n        e.preventDefault();\r\n        for (let i = options.length - 1; i >= 0; i -= 1) {\r\n          const opt = options[i];\r\n          if (opt && !opt.disabled) {\r\n            onChange?.(opt.value);\r\n            requestAnimationFrame(() => focusOption(i));\r\n            return;\r\n          }\r\n        }\r\n        break;\r\n      }\r\n      case \" \":\r\n      case \"Enter\": {\r\n        // R-K.1 - Space/Enter re-affirm the focused (= selected) option.\r\n        const opt = options[selectedIndex];\r\n        if (opt && !opt.disabled) {\r\n          e.preventDefault();\r\n          onChange?.(opt.value);\r\n        }\r\n        break;\r\n      }\r\n      default:\r\n    }\r\n  };\r\n\r\n  // Per-option padding pulled from the spacing scale (var(--s-1) = 4 px,\r\n  // var(--s-2) = 8 px). The \"+2\" on the small horizontal padding\r\n  // mirrors the +2 button padding offset in createPortnetTheme — all\r\n  // small interactive elements add a 2 px breathing offset to the\r\n  // base grid for visual rhythm.\r\n  const padY = size === \"sm\" ? \"var(--s-1)\" : \"calc(var(--s-1) + 2px)\";\r\n  const padX = size === \"sm\" ? \"calc(var(--s-2) + 2px)\" : \"var(--s-3)\";\r\n  const fontSize = size === \"sm\" ? \"var(--text-xs)\" : \"var(--text-sm)\";\r\n\r\n  return (\r\n    <Box\r\n      role=\"radiogroup\"\r\n      aria-label={ariaLabel}\r\n      aria-labelledby={ariaLabelledBy}\r\n      aria-disabled={disabled || undefined}\r\n      onKeyDown={handleKeyDown}\r\n      sx={{\r\n        display: \"inline-flex\",\r\n        width: fullWidth ? \"100%\" : \"auto\",\r\n        padding: \"2px\",\r\n        background: \"var(--bg-subtle)\",\r\n        border: \"1px solid var(--border)\",\r\n        borderRadius: \"var(--r-md)\",\r\n        gap: \"2px\",\r\n        opacity: disabled ? 0.55 : 1,\r\n        ...sx,\r\n      }}\r\n    >\r\n      {options.map((opt, i) => {\r\n        const isSelected = i === selectedIndex;\r\n        const isDisabled = disabled || opt.disabled;\r\n        return (\r\n          <Box\r\n            key={opt.value}\r\n            ref={(el) => { refs.current[i] = el as HTMLDivElement | null; }}\r\n            role=\"radio\"\r\n            aria-checked={isSelected}\r\n            aria-disabled={isDisabled || undefined}\r\n            aria-label={opt[\"aria-label\"]}\r\n            tabIndex={i === tabbableIndex && !isDisabled ? 0 : -1}\r\n            onClick={() => {\r\n              if (isDisabled || isSelected) return;\r\n              onChange?.(opt.value);\r\n            }}\r\n            sx={{\r\n              flex: fullWidth ? 1 : \"0 0 auto\",\r\n              display: \"inline-flex\",\r\n              alignItems: \"center\",\r\n              justifyContent: \"center\",\r\n              gap: 0.75,\r\n              padding: `${padY} ${padX}`,\r\n              borderRadius: \"calc(var(--r-md) - 2px)\",\r\n              fontSize,\r\n              fontWeight: isSelected ? \"var(--fw-semibold)\" : \"var(--fw-medium)\",\r\n              color: isSelected ? \"var(--fg)\" : \"var(--fg-muted)\",\r\n              background: isSelected ? \"var(--surface)\" : \"transparent\",\r\n              boxShadow: isSelected ? \"var(--shadow-xs)\" : \"none\",\r\n              cursor: isDisabled ? \"not-allowed\" : isSelected ? \"default\" : \"pointer\",\r\n              userSelect: \"none\",\r\n              whiteSpace: \"nowrap\",\r\n              transition:\r\n                \"background var(--duration-fast, 80ms) ease, color var(--duration-fast, 80ms) ease\",\r\n              \"&:hover\": {\r\n                ...(!isSelected && !isDisabled\r\n                  ? { background: \"var(--bg-hover)\", color: \"var(--fg)\" }\r\n                  : {}),\r\n              },\r\n              \"&:focus-visible\": {\r\n                outline: \"2px solid var(--accent)\",\r\n                outlineOffset: \"var(--pui-outline-offset)\",\r\n              },\r\n            }}\r\n          >\r\n            {opt.icon && (\r\n              <Box\r\n                component=\"span\"\r\n                aria-hidden=\"true\"\r\n                sx={{ display: \"inline-flex\", color: \"currentColor\" }}\r\n              >\r\n                {opt.icon}\r\n              </Box>\r\n            )}\r\n            {opt.label && <Box component=\"span\">{opt.label}</Box>}\r\n          </Box>\r\n        );\r\n      })}\r\n    </Box>\r\n  );\r\n}\r\n\r\nexport default Segmented;\r\n"],"mappings":";;;;;;AAAA,IAAAA,KAAA,GAAAC,uBAAA,CAAAC,OAAA;AACA,IAAAC,IAAA,GAAAC,sBAAA,CAAAF,OAAA;AAAoC,IAAAG,WAAA,GAAAH,OAAA;AAAA,SAAAE,uBAAAE,GAAA,WAAAA,GAAA,IAAAA,GAAA,CAAAC,UAAA,GAAAD,GAAA,gBAAAA,GAAA;AAAA,SAAAE,yBAAAC,WAAA,eAAAC,OAAA,kCAAAC,iBAAA,OAAAD,OAAA,QAAAE,gBAAA,OAAAF,OAAA,YAAAF,wBAAA,YAAAA,yBAAAC,WAAA,WAAAA,WAAA,GAAAG,gBAAA,GAAAD,iBAAA,KAAAF,WAAA;AAAA,SAAAR,wBAAAK,GAAA,EAAAG,WAAA,SAAAA,WAAA,IAAAH,GAAA,IAAAA,GAAA,CAAAC,UAAA,WAAAD,GAAA,QAAAA,GAAA,aAAAO,OAAA,CAAAP,GAAA,yBAAAA,GAAA,uCAAAA,GAAA,UAAAQ,KAAA,GAAAN,wBAAA,CAAAC,WAAA,OAAAK,KAAA,IAAAA,KAAA,CAAAC,GAAA,CAAAT,GAAA,YAAAQ,KAAA,CAAAE,GAAA,CAAAV,GAAA,SAAAW,MAAA,WAAAC,qBAAA,GAAAC,MAAA,CAAAC,cAAA,IAAAD,MAAA,CAAAE,wBAAA,WAAAC,GAAA,IAAAhB,GAAA,QAAAgB,GAAA,kBAAAH,MAAA,CAAAI,SAAA,CAAAC,cAAA,CAAAC,IAAA,CAAAnB,GAAA,EAAAgB,GAAA,SAAAI,IAAA,GAAAR,qBAAA,GAAAC,MAAA,CAAAE,wBAAA,CAAAf,GAAA,EAAAgB,GAAA,cAAAI,IAAA,KAAAA,IAAA,CAAAV,GAAA,IAAAU,IAAA,CAAAC,GAAA,KAAAR,MAAA,CAAAC,cAAA,CAAAH,MAAA,EAAAK,GAAA,EAAAI,IAAA,YAAAT,MAAA,CAAAK,GAAA,IAAAhB,GAAA,CAAAgB,GAAA,SAAAL,MAAA,cAAAX,GAAA,MAAAQ,KAAA,IAAAA,KAAA,CAAAa,GAAA,CAAArB,GAAA,EAAAW,MAAA,YAAAA,MAAA;AAAA,SAAAW,QAAAC,MAAA,EAAAC,cAAA,QAAAC,IAAA,GAAAZ,MAAA,CAAAY,IAAA,CAAAF,MAAA,OAAAV,MAAA,CAAAa,qBAAA,QAAAC,OAAA,GAAAd,MAAA,CAAAa,qBAAA,CAAAH,MAAA,GAAAC,cAAA,KAAAG,OAAA,GAAAA,OAAA,CAAAC,MAAA,WAAAC,GAAA,WAAAhB,MAAA,CAAAE,wBAAA,CAAAQ,MAAA,EAAAM,GAAA,EAAAC,UAAA,OAAAL,IAAA,CAAAM,IAAA,CAAAC,KAAA,CAAAP,IAAA,EAAAE,OAAA,YAAAF,IAAA;AAAA,SAAAQ,cAAAC,MAAA,aAAAC,CAAA,MAAAA,CAAA,GAAAC,SAAA,CAAAC,MAAA,EAAAF,CAAA,UAAAG,MAAA,WAAAF,SAAA,CAAAD,CAAA,IAAAC,SAAA,CAAAD,CAAA,QAAAA,CAAA,OAAAb,OAAA,CAAAT,MAAA,CAAAyB,MAAA,OAAAC,OAAA,WAAAvB,GAAA,IAAAwB,eAAA,CAAAN,MAAA,EAAAlB,GAAA,EAAAsB,MAAA,CAAAtB,GAAA,SAAAH,MAAA,CAAA4B,yBAAA,GAAA5B,MAAA,CAAA6B,gBAAA,CAAAR,MAAA,EAAArB,MAAA,CAAA4B,yBAAA,CAAAH,MAAA,KAAAhB,OAAA,CAAAT,MAAA,CAAAyB,MAAA,GAAAC,OAAA,WAAAvB,GAAA,IAAAH,MAAA,CAAAC,cAAA,CAAAoB,MAAA,EAAAlB,GAAA,EAAAH,MAAA,CAAAE,wBAAA,CAAAuB,MAAA,EAAAtB,GAAA,iBAAAkB,MAAA;AAAA,SAAAM,gBAAAxC,GAAA,EAAAgB,GAAA,EAAA2B,KAAA,IAAA3B,GAAA,GAAA4B,cAAA,CAAA5B,GAAA,OAAAA,GAAA,IAAAhB,GAAA,IAAAa,MAAA,CAAAC,cAAA,CAAAd,GAAA,EAAAgB,GAAA,IAAA2B,KAAA,EAAAA,KAAA,EAAAb,UAAA,QAAAe,YAAA,QAAAC,QAAA,oBAAA9C,GAAA,CAAAgB,GAAA,IAAA2B,KAAA,WAAA3C,GAAA;AAAA,SAAA4C,eAAAG,GAAA,QAAA/B,GAAA,GAAAgC,YAAA,CAAAD,GAAA,oBAAAxC,OAAA,CAAAS,GAAA,iBAAAA,GAAA,GAAAiC,MAAA,CAAAjC,GAAA;AAAA,SAAAgC,aAAAE,KAAA,EAAAC,IAAA,QAAA5C,OAAA,CAAA2C,KAAA,kBAAAA,KAAA,kBAAAA,KAAA,MAAAE,IAAA,GAAAF,KAAA,CAAAG,MAAA,CAAAC,WAAA,OAAAF,IAAA,KAAAG,SAAA,QAAAC,GAAA,GAAAJ,IAAA,CAAAjC,IAAA,CAAA+B,KAAA,EAAAC,IAAA,oBAAA5C,OAAA,CAAAiD,GAAA,uBAAAA,GAAA,YAAAC,SAAA,4DAAAN,IAAA,gBAAAF,MAAA,GAAAS,MAAA,EAAAR,KAAA;AAAA,SAAA3C,QAAAP,GAAA,sCAAAO,OAAA,wBAAA8C,MAAA,uBAAAA,MAAA,CAAAM,QAAA,aAAA3D,GAAA,kBAAAA,GAAA,gBAAAA,GAAA,WAAAA,GAAA,yBAAAqD,MAAA,IAAArD,GAAA,CAAA4D,WAAA,KAAAP,MAAA,IAAArD,GAAA,KAAAqD,MAAA,CAAApC,SAAA,qBAAAjB,GAAA,KAAAO,OAAA,CAAAP,GAAA,KAGpC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAwBA,SAAS6D,SAASA,CAAAC,IAAA,EAUC;EAAA,IAAAC,qBAAA;EAAA,IATjBpB,KAAK,GAAAmB,IAAA,CAALnB,KAAK;IACLqB,QAAQ,GAAAF,IAAA,CAARE,QAAQ;IACRC,OAAO,GAAAH,IAAA,CAAPG,OAAO;IAAAC,SAAA,GAAAJ,IAAA,CACPK,IAAI;IAAJA,IAAI,GAAAD,SAAA,cAAG,IAAI,GAAAA,SAAA;IAAAE,cAAA,GAAAN,IAAA,CACXO,SAAS;IAATA,SAAS,GAAAD,cAAA,cAAG,KAAK,GAAAA,cAAA;IAAAE,aAAA,GAAAR,IAAA,CACjBS,QAAQ;IAARA,QAAQ,GAAAD,aAAA,cAAG,KAAK,GAAAA,aAAA;IACFE,SAAS,GAAAV,IAAA,CAAvB,YAAY;IACOW,cAAc,GAAAX,IAAA,CAAjC,iBAAiB;IACjBY,EAAE,GAAAZ,IAAA,CAAFY,EAAE;EAEF,IAAIC,OAAO,CAACC,GAAG,CAAC,UAAU,CAAC,KAAK,YAAY,EAAE;IAC5C,IAAI,CAACJ,SAAS,IAAI,CAACC,cAAc,EAAE;MACjC;MACAI,OAAO,CAACC,IAAI,CACV,wFACF,CAAC;IACH;IACA,IAAIb,OAAO,CAAC5B,MAAM,GAAG,CAAC,IAAI4B,OAAO,CAAC5B,MAAM,GAAG,CAAC,EAAE;MAC5C;MACAwC,OAAO,CAACC,IAAI,CACV,qCAAAC,MAAA,CAAqCd,OAAO,CAAC5B,MAAM,6CACnD,6DACF,CAAC;IACH;EACF;EAEA,IAAM2C,IAAI,GAAGtF,KAAK,CAACuF,MAAM,CAA+B,EAAE,CAAC;;EAE3D;EACA,IAAMC,aAAa,GAAGC,IAAI,CAACC,GAAG,CAC5B,CAAC,EACDnB,OAAO,CAACoB,SAAS,CAAC,UAACC,CAAC;IAAA,OAAKA,CAAC,CAAC3C,KAAK,KAAKA,KAAK;EAAA,EAC5C,CAAC;;EAED;EACA;EACA;EACA;EACA,IAAM4C,aAAa,GAAG,GAAAxB,qBAAA,GAACE,OAAO,CAACiB,aAAa,CAAC,cAAAnB,qBAAA,eAAtBA,qBAAA,CAAwBQ,QAAQ,IACnDW,aAAa,GACbjB,OAAO,CAACoB,SAAS,CAAC,UAACC,CAAC;IAAA,OAAK,CAACA,CAAC,CAACf,QAAQ;EAAA,EAAC;EAEzC,IAAMiB,WAAW,GAAG,SAAdA,WAAWA,CAAIrD,CAAS,EAAK;IACjC,IAAMsD,IAAI,GAAGT,IAAI,CAACU,OAAO,CAACvD,CAAC,CAAC;IAC5B,IAAIsD,IAAI,EAAEA,IAAI,CAACE,KAAK,CAAC,CAAC;EACxB,CAAC;EAED,IAAMC,IAAI,GAAG,SAAPA,IAAIA,CAAIC,KAAa,EAAK;IAC9B,IAAMC,GAAG,GAAG7B,OAAO,CAAC5B,MAAM;IAC1B,IAAI0D,IAAI,GAAGb,aAAa;IACxB,KAAK,IAAIc,IAAI,GAAG,CAAC,EAAEA,IAAI,GAAGF,GAAG,EAAEE,IAAI,IAAI,CAAC,EAAE;MAAA,IAAAC,aAAA;MACxCF,IAAI,GAAG,CAACA,IAAI,GAAGF,KAAK,GAAGC,GAAG,IAAIA,GAAG;MACjC,IAAI,GAAAG,aAAA,GAAChC,OAAO,CAAC8B,IAAI,CAAC,cAAAE,aAAA,eAAbA,aAAA,CAAe1B,QAAQ,GAAE;IAChC;IACA,IAAMrC,MAAM,GAAG+B,OAAO,CAAC8B,IAAI,CAAC;IAC5B,IAAI7D,MAAM,IAAI,CAACA,MAAM,CAACqC,QAAQ,EAAE;MAC9BP,QAAQ,aAARA,QAAQ,uBAARA,QAAQ,CAAG9B,MAAM,CAACS,KAAK,CAAC;MACxB;MACAuD,qBAAqB,CAAC;QAAA,OAAMV,WAAW,CAACO,IAAI,CAAC;MAAA,EAAC;IAChD;EACF,CAAC;EAED,IAAMI,aAAa,GAAG,SAAhBA,aAAaA,CAAIC,CAAsC,EAAK;IAChE,IAAI7B,QAAQ,EAAE;IACd,QAAQ6B,CAAC,CAACpF,GAAG;MACX,KAAK,YAAY;MACjB,KAAK,WAAW;QACdoF,CAAC,CAACC,cAAc,CAAC,CAAC;QAClBT,IAAI,CAAC,CAAC,CAAC,CAAC;QACR;MACF,KAAK,WAAW;MAChB,KAAK,SAAS;QACZQ,CAAC,CAACC,cAAc,CAAC,CAAC;QAClBT,IAAI,CAAC,CAAC,CAAC,CAAC;QACR;MACF,KAAK,MAAM;QAAE;UACXQ,CAAC,CAACC,cAAc,CAAC,CAAC;UAClB,IAAMC,KAAK,GAAGrC,OAAO,CAACoB,SAAS,CAAC,UAACC,CAAC;YAAA,OAAK,CAACA,CAAC,CAACf,QAAQ;UAAA,EAAC;UACnD,IAAMgC,GAAG,GAAGD,KAAK,IAAI,CAAC,GAAGrC,OAAO,CAACqC,KAAK,CAAC,GAAG/C,SAAS;UACnD,IAAIgD,GAAG,EAAE;YACPvC,QAAQ,aAARA,QAAQ,uBAARA,QAAQ,CAAGuC,GAAG,CAAC5D,KAAK,CAAC;YACrBuD,qBAAqB,CAAC;cAAA,OAAMV,WAAW,CAACc,KAAK,CAAC;YAAA,EAAC;UACjD;UACA;QACF;MACA,KAAK,KAAK;QAAE;UACVF,CAAC,CAACC,cAAc,CAAC,CAAC;UAAC,IAAAG,KAAA,YAAAA,MACVrE,CAAC;YACR,IAAMoE,GAAG,GAAGtC,OAAO,CAAC9B,CAAC,CAAC;YACtB,IAAIoE,GAAG,IAAI,CAACA,GAAG,CAAChC,QAAQ,EAAE;cACxBP,QAAQ,aAARA,QAAQ,uBAARA,QAAQ,CAAGuC,GAAG,CAAC5D,KAAK,CAAC;cACrBuD,qBAAqB,CAAC;gBAAA,OAAMV,WAAW,CAACrD,CAAC,CAAC;cAAA,EAAC;cAC3C;gBAAAsE,CAAA;cAAA;YACF;UAAC;UANH,KAAK,IAAItE,CAAC,GAAG8B,OAAO,CAAC5B,MAAM,GAAG,CAAC,EAAEF,CAAC,IAAI,CAAC,EAAEA,CAAC,IAAI,CAAC,EAAE;YAAA,IAAAuE,IAAA,GAAAF,KAAA,CAAxCrE,CAAC;YAAA,IAAA5B,OAAA,CAAAmG,IAAA,uBAAAA,IAAA,CAAAD,CAAA;UAOV;UACA;QACF;MACA,KAAK,GAAG;MACR,KAAK,OAAO;QAAE;UACZ;UACA,IAAMF,IAAG,GAAGtC,OAAO,CAACiB,aAAa,CAAC;UAClC,IAAIqB,IAAG,IAAI,CAACA,IAAG,CAAChC,QAAQ,EAAE;YACxB6B,CAAC,CAACC,cAAc,CAAC,CAAC;YAClBrC,QAAQ,aAARA,QAAQ,uBAARA,QAAQ,CAAGuC,IAAG,CAAC5D,KAAK,CAAC;UACvB;UACA;QACF;MACA;IACF;EACF,CAAC;;EAED;EACA;EACA;EACA;EACA;EACA,IAAMgE,IAAI,GAAGxC,IAAI,KAAK,IAAI,GAAG,YAAY,GAAG,wBAAwB;EACpE,IAAMyC,IAAI,GAAGzC,IAAI,KAAK,IAAI,GAAG,wBAAwB,GAAG,YAAY;EACpE,IAAM0C,QAAQ,GAAG1C,IAAI,KAAK,IAAI,GAAG,gBAAgB,GAAG,gBAAgB;EAEpE,oBACE,IAAApE,WAAA,CAAA+G,GAAA,EAACjH,IAAA,WAAG;IACFkH,IAAI,EAAC,YAAY;IACjB,cAAYvC,SAAU;IACtB,mBAAiBC,cAAe;IAChC,iBAAeF,QAAQ,IAAIhB,SAAU;IACrCyD,SAAS,EAAEb,aAAc;IACzBzB,EAAE,EAAAzC,aAAA;MACAgF,OAAO,EAAE,aAAa;MACtBC,KAAK,EAAE7C,SAAS,GAAG,MAAM,GAAG,MAAM;MAClC8C,OAAO,EAAE,KAAK;MACdC,UAAU,EAAE,kBAAkB;MAC9BC,MAAM,EAAE,yBAAyB;MACjCC,YAAY,EAAE,aAAa;MAC3BC,GAAG,EAAE,KAAK;MACVC,OAAO,EAAEjD,QAAQ,GAAG,IAAI,GAAG;IAAC,GACzBG,EAAE,CACL;IAAA+C,QAAA,EAEDxD,OAAO,CAACyD,GAAG,CAAC,UAACnB,GAAG,EAAEpE,CAAC,EAAK;MACvB,IAAMwF,UAAU,GAAGxF,CAAC,KAAK+C,aAAa;MACtC,IAAM0C,UAAU,GAAGrD,QAAQ,IAAIgC,GAAG,CAAChC,QAAQ;MAC3C,oBACE,IAAAxE,WAAA,CAAA8H,IAAA,EAAChI,IAAA,WAAG;QAEFiI,GAAG,EAAE,SAAAA,IAACC,EAAE,EAAK;UAAE/C,IAAI,CAACU,OAAO,CAACvD,CAAC,CAAC,GAAG4F,EAA2B;QAAE,CAAE;QAChEhB,IAAI,EAAC,OAAO;QACZ,gBAAcY,UAAW;QACzB,iBAAeC,UAAU,IAAIrE,SAAU;QACvC,cAAYgD,GAAG,CAAC,YAAY,CAAE;QAC9ByB,QAAQ,EAAE7F,CAAC,KAAKoD,aAAa,IAAI,CAACqC,UAAU,GAAG,CAAC,GAAG,CAAC,CAAE;QACtDK,OAAO,EAAE,SAAAA,QAAA,EAAM;UACb,IAAIL,UAAU,IAAID,UAAU,EAAE;UAC9B3D,QAAQ,aAARA,QAAQ,uBAARA,QAAQ,CAAGuC,GAAG,CAAC5D,KAAK,CAAC;QACvB,CAAE;QACF+B,EAAE,EAAE;UACFwD,IAAI,EAAE7D,SAAS,GAAG,CAAC,GAAG,UAAU;UAChC4C,OAAO,EAAE,aAAa;UACtBkB,UAAU,EAAE,QAAQ;UACpBC,cAAc,EAAE,QAAQ;UACxBb,GAAG,EAAE,IAAI;UACTJ,OAAO,KAAApC,MAAA,CAAK4B,IAAI,OAAA5B,MAAA,CAAI6B,IAAI,CAAE;UAC1BU,YAAY,EAAE,yBAAyB;UACvCT,QAAQ,EAARA,QAAQ;UACRwB,UAAU,EAAEV,UAAU,GAAG,oBAAoB,GAAG,kBAAkB;UAClEW,KAAK,EAAEX,UAAU,GAAG,WAAW,GAAG,iBAAiB;UACnDP,UAAU,EAAEO,UAAU,GAAG,gBAAgB,GAAG,aAAa;UACzDY,SAAS,EAAEZ,UAAU,GAAG,kBAAkB,GAAG,MAAM;UACnDa,MAAM,EAAEZ,UAAU,GAAG,aAAa,GAAGD,UAAU,GAAG,SAAS,GAAG,SAAS;UACvEc,UAAU,EAAE,MAAM;UAClBC,UAAU,EAAE,QAAQ;UACpBC,UAAU,EACR,mFAAmF;UACrF,SAAS,EAAA1G,aAAA,KACH,CAAC0F,UAAU,IAAI,CAACC,UAAU,GAC1B;YAAER,UAAU,EAAE,iBAAiB;YAAEkB,KAAK,EAAE;UAAY,CAAC,GACrD,CAAC,CAAC,CACP;UACD,iBAAiB,EAAE;YACjBM,OAAO,EAAE,yBAAyB;YAClCC,aAAa,EAAE;UACjB;QACF,CAAE;QAAApB,QAAA,GAEDlB,GAAG,CAACuC,IAAI,iBACP,IAAA/I,WAAA,CAAA+G,GAAA,EAACjH,IAAA,WAAG;UACFkJ,SAAS,EAAC,MAAM;UAChB,eAAY,MAAM;UAClBrE,EAAE,EAAE;YAAEuC,OAAO,EAAE,aAAa;YAAEqB,KAAK,EAAE;UAAe,CAAE;UAAAb,QAAA,EAErDlB,GAAG,CAACuC;QAAI,CACN,CACN,EACAvC,GAAG,CAACyC,KAAK,iBAAI,IAAAjJ,WAAA,CAAA+G,GAAA,EAACjH,IAAA,WAAG;UAACkJ,SAAS,EAAC,MAAM;UAAAtB,QAAA,EAAElB,GAAG,CAACyC;QAAK,CAAM,CAAC;MAAA,GAjDhDzC,GAAG,CAAC5D,KAkDN,CAAC;IAEV,CAAC;EAAC,CACC,CAAC;AAEV;AAAC,IAAAsG,QAAA,GAAAC,OAAA,cAEcrF,SAAS","ignoreList":[]}

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

@@ -0,0 +1,90 @@
+import * as React from "react";
+import type { SelectProps as MuiSelectProps } from "@mui/material/Select";
+/**
+ * Select — Portnet UI v2
+ *
+ * Charter §03 · Component "Select".
+ *
+ *   R-Sel.1 — > 30 options → use searchThreshold or Combobox.
+ *   R-Sel.2 — 2–3 options → prefer Radio or Segmented control.
+ *   R-Sel.3 — Placeholder = "Sélectionner…", never empty.
+ *   R-Sel.4 — Multi-select → chips dans l'input + bouton « Tout effacer ».
+ *   R-Sel.5 — searchThreshold / searchable → auto-search for large lists (NEW).
+ *
+ * Autocomplete / search (R-Sel.5):
+ *   Pass `searchThreshold={N}` to show a search input when options >= N.
+ *   Pass `searchable` as a shorthand to always show search.
+ *
+ *   Generic pattern: set searchThreshold once per component type and ALL
+ *   instances with enough items get free-text filtering automatically.
+ *
+ *   <Select searchThreshold={8} options={pays} value={v} onChange={...} />
+ *
+ * Localisation (FR / EN / AR):
+ *   Pass `labels` to override user-visible strings.
+ *
+ * MUI v9 focus safety:
+ *   MuiSelect focuses its hidden input on click via an internal inputRef.
+ *   We always pass an explicit inputRef (merged with any caller ref) so
+ *   that focus target is never null — otherwise clicking the closed select
+ *   throws "Cannot read properties of null (reading 'focus')" from inside
+ *   MUI's own click handler.
+ */
+export type SelectOptionValue = string | number;
+export interface SelectOptionObject {
+    value: SelectOptionValue;
+    label: React.ReactNode;
+}
+export type SelectOption = string | SelectOptionObject;
+export type SelectValue = SelectOptionValue | SelectOptionValue[];
+/**
+ * onChange event shape. Deliberately loose: the component fires onChange
+ * both from MUI's native SelectChangeEvent AND from a synthetic
+ * { target: { value } } object in the chip-remove / clear-all paths.
+ */
+export interface SelectChangeLike {
+    target: {
+        value: SelectValue;
+    };
+}
+export interface SelectLabels {
+    placeholder?: string | undefined;
+    clearAll?: string | undefined;
+    clearAllAria?: string | undefined;
+    removeChip?: ((label: React.ReactNode) => string) | undefined;
+    searchLabel?: string | undefined;
+    searchClear?: string | undefined;
+    noOptions?: string | undefined;
+}
+export interface SelectProps extends Omit<MuiSelectProps<SelectValue>, "value" | "onChange" | "renderValue" | "children" | "inputRef"> {
+    value?: SelectValue | undefined;
+    onChange?: ((event: SelectChangeLike) => void) | undefined;
+    options?: SelectOption[] | undefined;
+    placeholder?: string | undefined;
+    labels?: SelectLabels | undefined;
+    searchable?: boolean | undefined;
+    searchThreshold?: number | undefined;
+    /** Optional caller-provided input ref; merged with the internal one. */
+    inputRef?: React.Ref<HTMLInputElement> | undefined;
+}
+export declare function isRecord(v: unknown): v is Record<string, unknown>;
+/** Stable string key for a value, primitive or object. "" when undecidable. */
+export declare function valueKey(v: unknown): string;
+/**
+ * Value equality that survives object identity loss.
+ *
+ * Reference/primitive equality first (the common path), then a structural
+ * comparison on the discriminating key. The `!== ""` guard matters: without it
+ * two objects that expose no key would compare equal to each other AND to any
+ * empty value.
+ */
+export declare function sameOptionValue(a: unknown, b: unknown): boolean;
+/**
+ * Best-effort label for a value with no matching option. Returns `null` when
+ * nothing renderable can be derived, so the caller shows the placeholder
+ * instead of throwing.
+ */
+export declare function labelFromValue(v: unknown): React.ReactNode;
+declare const Select: React.ForwardRefExoticComponent<Omit<SelectProps, "ref"> & React.RefAttributes<HTMLInputElement>>;
+export default Select;
+//# sourceMappingURL=Select.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Select.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/components/Select.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,WAAW,IAAI,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAS1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,CAAC;AAEhD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,iBAAiB,CAAC;IACzB,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;CACxB;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,kBAAkB,CAAC;AAEvD,MAAM,MAAM,WAAW,GAAG,iBAAiB,GAAG,iBAAiB,EAAE,CAAC;AAElE;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE;QAAE,KAAK,EAAE,WAAW,CAAA;KAAE,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,UAAU,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,KAAK,MAAM,CAAC,GAAG,SAAS,CAAC;IAC9D,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED,MAAM,WAAW,WACf,SAAQ,IAAI,CACV,cAAc,CAAC,WAAW,CAAC,EAC3B,OAAO,GAAG,UAAU,GAAG,aAAa,GAAG,UAAU,GAAG,UAAU,CAC/D;IACD,KAAK,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAChC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC3D,OAAO,CAAC,EAAE,YAAY,EAAE,GAAG,SAAS,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAClC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,wEAAwE;IACxE,QAAQ,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,GAAG,SAAS,CAAC;CACpD;AA2CD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEjE;AAED,+EAA+E;AAC/E,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAU3C;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAO/D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC,SAAS,CAW1D;AAmBD,QAAA,MAAM,MAAM,mGAoQV,CAAC;AAEH,eAAe,MAAM,CAAC"}