@portnet/ui 5.0.32 → 6.0.1

package/dist/v2/components/Chip.js

@@ -0,0 +1,132 @@
+"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 _Chip = _interopRequireDefault(require("@mui/material/Chip"));
+var _Close = _interopRequireDefault(require("@mui/icons-material/Close"));
+var _mergeLabels = require("../utils/mergeLabels");
+var _jsxRuntime = require("react/jsx-runtime");
+var _excluded = ["active", "removable", "onRemove", "size", "labels", "children", "sx"];
+/**
+ * Chip - Portnet UI v2
+ *
+ * Generic filter / tag chip.
+ * For workflow status, use <Status> instead - its colour palette is canonical.
+ *
+ *   <Chip>Importateur</Chip>
+ *   <Chip active>Actif</Chip>
+ *   <Chip removable onRemove={() => …}>Banque · BMCE</Chip>
+ *
+ * Localisation (FR / EN / AR):
+ *   <Chip removable
+ *         labels={{
+ *           remove:         (text) => `Remove ${text}`,
+ *           removeFallback: "Remove this filter",
+ *         }}>
+ *     Bank · BMCE
+ *   </Chip>
+ *
+ * A11y note (R-Ar.2):
+ *   When `removable`, the delete trigger gets a derived aria-label
+ *   ("Retirer X" by default, or whatever `labels.remove(text)`
+ *   returns) so SR users hear a meaningful name instead of MUI's
+ *   default rendering ("delete" English / unnamed icon button).
+ *
+ *   Keyboard delete is supported at the chip level (the chip itself is
+ *   focusable; Backspace / Delete fires onDelete per MUI Chip
+ *   semantics). The custom delete handle is therefore intentionally
+ *   non-focusable - duplicating focus on it would create two tab-stops
+ *   for the same action.
+ */
+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 _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
+var DEFAULT_LABELS = Object.freeze({
+  remove: function remove(text) {
+    return "Retirer ".concat(text);
+  },
+  removeFallback: "Retirer ce filtre"
+});
+
+// Best-effort plain-text extraction from a chip's children. Used to
+// build the delete-button aria-label. Falls back gracefully when the
+// children are non-text (e.g. an Avatar or a complex JSX tree).
+function extractText(node) {
+  if (node == null || node === false) return "";
+  if (typeof node === "string" || typeof node === "number") return String(node);
+  if (Array.isArray(node)) return node.map(extractText).join(" ").trim();
+  if (/*#__PURE__*/React.isValidElement(node)) {
+    return extractText(node.props.children);
+  }
+  return "";
+}
+function Chip(_ref) {
+  var _ref$active = _ref.active,
+    active = _ref$active === void 0 ? false : _ref$active,
+    _ref$removable = _ref.removable,
+    removable = _ref$removable === void 0 ? false : _ref$removable,
+    onRemove = _ref.onRemove,
+    _ref$size = _ref.size,
+    size = _ref$size === void 0 ? "md" : _ref$size,
+    labels = _ref.labels,
+    children = _ref.children,
+    sx = _ref.sx,
+    rest = _objectWithoutProperties(_ref, _excluded);
+  var L = React.useMemo(function () {
+    return (0, _mergeLabels.mergeLabels)(DEFAULT_LABELS, labels);
+  }, [labels]);
+
+  // R-Ar.2 - derive a meaningful aria-label for the delete trigger.
+  var removeLabel = React.useMemo(function () {
+    if (!removable) return undefined;
+    var text = extractText(children).trim();
+    return text ? L.remove(text) : L.removeFallback;
+  }, [removable, children, L]);
+
+  // Plain aria-labeled span. MuiChip clones onClick onto it (turning
+  // it into the delete trigger). NOT focusable on its own - keyboard
+  // delete works via the chip itself (Backspace/Delete on focused chip
+  // fires onDelete per MUI Chip semantics).
+  var deleteIconNode = removable ? /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
+    "aria-label": removeLabel,
+    style: {
+      display: "inline-flex",
+      alignItems: "center"
+    },
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Close["default"], {
+      fontSize: "small",
+      "aria-hidden": "true"
+    })
+  }) : undefined;
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Chip["default"], _objectSpread({
+    label: children,
+    size: size === "sm" ? "small" : "medium",
+    onDelete: removable ? onRemove : undefined,
+    deleteIcon: deleteIconNode,
+    sx: _objectSpread({
+      backgroundColor: active ? "var(--accent-soft)" : "var(--bg-subtle)",
+      color: active ? "var(--accent)" : "var(--fg-muted)",
+      fontWeight: active ? "var(--fw-semibold, 600)" : "var(--fw-medium, 500)",
+      border: active ? "1px solid var(--accent)" : "1px solid var(--border)",
+      "& .MuiChip-deleteIcon": {
+        color: "var(--fg-subtle)",
+        "&:hover": {
+          color: "var(--danger)"
+        }
+      }
+    }, sx)
+  }, rest));
+}
+var _default = exports["default"] = Chip;
+//# sourceMappingURL=Chip.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Chip.js","names":["React","_interopRequireWildcard","require","_Chip","_interopRequireDefault","_Close","_mergeLabels","_jsxRuntime","_excluded","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","_objectWithoutProperties","excluded","_objectWithoutPropertiesLoose","sourceSymbolKeys","indexOf","propertyIsEnumerable","sourceKeys","DEFAULT_LABELS","freeze","remove","text","concat","removeFallback","extractText","node","Array","isArray","map","join","trim","isValidElement","props","children","Chip","_ref","_ref$active","active","_ref$removable","removable","onRemove","_ref$size","size","labels","sx","rest","L","useMemo","mergeLabels","removeLabel","deleteIconNode","jsx","style","display","alignItems","fontSize","label","onDelete","deleteIcon","backgroundColor","color","fontWeight","border","_default","exports"],"sources":["../../../src/lib/v2/components/Chip.tsx"],"sourcesContent":["import * as React from \"react\";\r\nimport MuiChip from \"@mui/material/Chip\";\r\nimport type { ChipProps as MuiChipProps } from \"@mui/material/Chip\";\r\nimport CloseIcon from \"@mui/icons-material/Close\";\r\nimport { mergeLabels } from \"../utils/mergeLabels\";\r\n\r\n/**\r\n * Chip - Portnet UI v2\r\n *\r\n * Generic filter / tag chip.\r\n * For workflow status, use <Status> instead - its colour palette is canonical.\r\n *\r\n *   <Chip>Importateur</Chip>\r\n *   <Chip active>Actif</Chip>\r\n *   <Chip removable onRemove={() => …}>Banque · BMCE</Chip>\r\n *\r\n * Localisation (FR / EN / AR):\r\n *   <Chip removable\r\n *         labels={{\r\n *           remove:         (text) => `Remove ${text}`,\r\n *           removeFallback: \"Remove this filter\",\r\n *         }}>\r\n *     Bank · BMCE\r\n *   </Chip>\r\n *\r\n * A11y note (R-Ar.2):\r\n *   When `removable`, the delete trigger gets a derived aria-label\r\n *   (\"Retirer X\" by default, or whatever `labels.remove(text)`\r\n *   returns) so SR users hear a meaningful name instead of MUI's\r\n *   default rendering (\"delete\" English / unnamed icon button).\r\n *\r\n *   Keyboard delete is supported at the chip level (the chip itself is\r\n *   focusable; Backspace / Delete fires onDelete per MUI Chip\r\n *   semantics). The custom delete handle is therefore intentionally\r\n *   non-focusable - duplicating focus on it would create two tab-stops\r\n *   for the same action.\r\n */\r\n\r\nexport interface ChipLabels {\r\n  remove?: ((text: string) => string) | undefined;\r\n  removeFallback?: string | undefined;\r\n}\r\n\r\nexport interface ChipProps\r\n  extends Omit<MuiChipProps, \"label\" | \"size\" | \"onDelete\" | \"deleteIcon\" | \"children\"> {\r\n  active?: boolean | undefined;\r\n  removable?: boolean | undefined;\r\n  onRemove?: MuiChipProps[\"onDelete\"] | undefined;\r\n  size?: \"sm\" | \"md\" | undefined;\r\n  labels?: ChipLabels | undefined;\r\n  children?: React.ReactNode | undefined;\r\n}\r\n\r\nconst DEFAULT_LABELS = Object.freeze({\r\n  remove:         (text: string): string => `Retirer ${text}`,\r\n  removeFallback: \"Retirer ce filtre\",\r\n});\r\n\r\n// Best-effort plain-text extraction from a chip's children. Used to\r\n// build the delete-button aria-label. Falls back gracefully when the\r\n// children are non-text (e.g. an Avatar or a complex JSX tree).\r\nfunction extractText(node: React.ReactNode): string {\r\n  if (node == null || node === false) return \"\";\r\n  if (typeof node === \"string\" || typeof node === \"number\") return String(node);\r\n  if (Array.isArray(node)) return node.map(extractText).join(\" \").trim();\r\n  if (React.isValidElement(node)) {\r\n    return extractText((node.props as { children?: React.ReactNode }).children);\r\n  }\r\n  return \"\";\r\n}\r\n\r\nfunction Chip({\r\n  active = false,\r\n  removable = false,\r\n  onRemove,\r\n  size = \"md\",\r\n  labels,\r\n  children,\r\n  sx,\r\n  ...rest\r\n}: ChipProps) {\r\n  const L = React.useMemo(\r\n    () => (mergeLabels(DEFAULT_LABELS, labels)),\r\n    [labels]\r\n  );\r\n\r\n  // R-Ar.2 - derive a meaningful aria-label for the delete trigger.\r\n  const removeLabel = React.useMemo(() => {\r\n    if (!removable) return undefined;\r\n    const text = extractText(children).trim();\r\n    return text ? L.remove(text) : L.removeFallback;\r\n  }, [removable, children, L]);\r\n\r\n  // Plain aria-labeled span. MuiChip clones onClick onto it (turning\r\n  // it into the delete trigger). NOT focusable on its own - keyboard\r\n  // delete works via the chip itself (Backspace/Delete on focused chip\r\n  // fires onDelete per MUI Chip semantics).\r\n  const deleteIconNode = removable ? (\r\n    <span\r\n      aria-label={removeLabel}\r\n      style={{ display: \"inline-flex\", alignItems: \"center\" }}\r\n    >\r\n      <CloseIcon fontSize=\"small\" aria-hidden=\"true\" />\r\n    </span>\r\n  ) : undefined;\r\n\r\n  return (\r\n    <MuiChip\r\n      label={children}\r\n      size={size === \"sm\" ? \"small\" : \"medium\"}\r\n      onDelete={removable ? onRemove : undefined}\r\n      deleteIcon={deleteIconNode}\r\n      sx={{\r\n        backgroundColor: active ? \"var(--accent-soft)\" : \"var(--bg-subtle)\",\r\n        color: active ? \"var(--accent)\" : \"var(--fg-muted)\",\r\n        fontWeight: active ? \"var(--fw-semibold, 600)\" : \"var(--fw-medium, 500)\",\r\n        border: active ? \"1px solid var(--accent)\" : \"1px solid var(--border)\",\r\n        \"& .MuiChip-deleteIcon\": {\r\n          color: \"var(--fg-subtle)\",\r\n          \"&:hover\": { color: \"var(--danger)\" },\r\n        },\r\n        ...sx,\r\n      }}\r\n      {...rest}\r\n    />\r\n  );\r\n}\r\n\r\nexport default Chip;\r\n"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,134 @@
+import * as React from "react";
+import type { AutocompleteProps } from "@mui/material/Autocomplete";
+import type { SxProps, Theme } from "@mui/material/styles";
+/**
+ * Combobox — Portnet UI v2
+ *
+ * Charter §03 · Component "Combobox / Autocomplete". Required by R-Sel.1
+ * for any Select with > 30 options.
+ *
+ * Single:
+ *   <Field label="Pays">
+ *     <Combobox
+ *       value={country}
+ *       onChange={setCountry}
+ *       options={countries}                         // strings or {value,label}
+ *     />
+ *   </Field>
+ *
+ * Multi (with helper text per option):
+ *   <Field label="Régime">
+ *     <Combobox
+ *       value={regime}
+ *       onChange={setRegime}
+ *       options={[
+ *         { value: "atpa", label: "ATPA",
+ *           helper: "Admission Temporaire avec Paiement" },
+ *         { value: "atpf", label: "ATPF",
+ *           helper: "Admission Temporaire en Franchise" },
+ *       ]}
+ *     />
+ *   </Field>
+ *
+ * Async (server-side filter):
+ *   const [input, setInput] = useState("");
+ *   const [opts,  setOpts]  = useState([]);
+ *   const [loading, setLoading] = useState(false);
+ *   useEffect(() => {
+ *     const t = setTimeout(() => {
+ *       setLoading(true);
+ *       fetch(`/api/companies?q=${input}`)
+ *         .then(r => r.json()).then(setOpts)
+ *         .finally(() => setLoading(false));
+ *     }, 250);
+ *     return () => clearTimeout(t);
+ *   }, [input]);
+ *
+ *   <Combobox
+ *     value={company}
+ *     onChange={setCompany}
+ *     onInputChange={(_, v) => setInput(v)}
+ *     options={opts}
+ *     loading={loading}
+ *     filterOptions={(x) => x}              // disable client-side filter
+ *   />
+ *
+ * Localisation (FR / EN / AR):
+ *   <Combobox labels={{
+ *     noOptions: "No results",
+ *     loading:   "Loading…",
+ *     clear:     "Clear",
+ *     close:     "Close",
+ *     open:      "Open",
+ *     placeholder: "Select…",
+ *   }} />
+ *
+ *   Defaults are French; partial overrides are merged onto the defaults.
+ *
+ * A11y:
+ *   - Built on MuiAutocomplete (full WAI-ARIA combobox pattern).
+ *   - When option.helper is present, it is rendered visually AND
+ *     becomes part of the option's accessible name (so screen-reader
+ *     users hear "ATPA, Admission Temporaire avec Paiement" when
+ *     navigating).
+ *   - Loading spinner is decorative (aria-hidden); the listbox already
+ *     announces "Chargement…" via the loadingText prop.
+ *   - COMBO-1: Field-injected aria-describedby / aria-invalid / aria-required
+ *     are threaded onto the native <input> via renderInput's htmlInput slot.
+ *     MUI spreads unknown top-level props onto the Autocomplete ROOT, so
+ *     without this the error association / invalid state would never reach
+ *     the combobox input for screen-reader users.
+ */
+export type ComboboxOptionValue = string | number | boolean;
+export interface ComboboxOption {
+    value: ComboboxOptionValue;
+    label?: React.ReactNode | undefined;
+    group?: string | undefined;
+    helper?: React.ReactNode | undefined;
+}
+/**
+ * Loose-but-honest value union used for BOTH the `value` input and the
+ * `onChange` output, matching the any-based JS: callers may pass bare
+ * values or option objects (single or array), and onChange re-emits bare
+ * values (objects unwrapped to their `.value`).
+ */
+export type ComboboxValue = ComboboxOptionValue | ComboboxOption | null | Array<ComboboxOptionValue | ComboboxOption>;
+export interface ComboboxLabels {
+    noOptions?: string | undefined;
+    loading?: string | undefined;
+    clear?: string | undefined;
+    close?: string | undefined;
+    open?: string | undefined;
+    placeholder?: string | undefined;
+}
+/**
+ * The option generic handed to MUI Autocomplete. It must admit raw
+ * primitive values (not just option objects) because resolvedValue and
+ * handleChange deliberately round-trip bare values (a numeric id stored
+ * by FormikCombobox, a freeSolo string, etc.).
+ */
+type ComboboxItem = ComboboxOption | ComboboxOptionValue;
+type MuiACProps = AutocompleteProps<ComboboxItem, boolean, false, boolean>;
+export interface ComboboxProps extends Omit<MuiACProps, "value" | "onChange" | "options" | "multiple" | "freeSolo" | "renderInput" | "renderTags" | "renderOption" | "getOptionLabel" | "isOptionEqualToValue" | "groupBy" | "filterOptions" | "onInputChange" | "loading" | "disabled" | "fullWidth" | "sx" | "ref"> {
+    value?: ComboboxValue | undefined;
+    onChange?: ((value: ComboboxValue) => void) | undefined;
+    options?: Array<string | ComboboxOption> | undefined;
+    multiple?: boolean | undefined;
+    freeSolo?: boolean | undefined;
+    placeholder?: string | undefined;
+    disabled?: boolean | undefined;
+    error?: boolean | undefined;
+    fullWidth?: boolean | undefined;
+    loading?: boolean | undefined;
+    groupBy?: ((option: ComboboxItem) => string) | undefined;
+    getOptionLabel?: ((option: ComboboxItem) => string) | undefined;
+    isOptionEqualToValue?: ((option: ComboboxItem, value: ComboboxItem) => boolean) | undefined;
+    filterOptions?: MuiACProps["filterOptions"] | undefined;
+    renderOption?: MuiACProps["renderOption"] | undefined;
+    onInputChange?: MuiACProps["onInputChange"] | undefined;
+    labels?: ComboboxLabels | undefined;
+    sx?: SxProps<Theme> | undefined;
+}
+declare const Combobox: React.ForwardRefExoticComponent<ComboboxProps & React.RefAttributes<HTMLDivElement>>;
+export default Combobox;
+//# sourceMappingURL=Combobox.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Combobox.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/components/Combobox.tsx"],"names":[],"mappings":"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"}