@portnet/ui 5.0.27 → 6.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkErrorBanner.js","names":["React","_interopRequireWildcard","require","_Box","_interopRequireDefault","_ErrorOutlined","_jsxRuntime","obj","__esModule","_getRequireWildcardCache","nodeInterop","WeakMap","cacheBabelInterop","cacheNodeInterop","_typeof","cache","has","get","newObj","hasPropertyDescriptor","Object","defineProperty","getOwnPropertyDescriptor","key","prototype","hasOwnProperty","call","desc","set","NetworkErrorBanner","_ref","visible","_ref$message","message","onRetry","_ref$retryLabel","retryLabel","jsxs","role","className","children","jsx","fontSize","component","type","onClick","sx","background","border","color","borderRadius","padding","fontWeight","cursor","fontFamily","marginInlineStart","transition","outline","outlineOffset","_default","exports"],"sources":["../../../src/lib/v2/patterns/NetworkErrorBanner.tsx"],"sourcesContent":["import * as React from \"react\";\r\nimport Box from \"@mui/material/Box\";\r\nimport ErrorIcon from \"@mui/icons-material/ErrorOutlined\";\r\n\r\n/**\r\n * NetworkErrorBanner - Portnet UI v2 (pattern)\r\n *\r\n * Charter R-4.3 - erreur réseau globale = bandeau persistant top, \"Réessayer\".\r\n * Z-index 2000 (above modals).\r\n *\r\n *   <NetworkErrorBanner\r\n *     visible={!online}\r\n *     message=\"Connexion perdue.\"\r\n *     onRetry={refresh}\r\n *   />\r\n *\r\n * Localisation (FR / EN / AR):\r\n *   `message` and `retryLabel` are direct overrides on the props.\r\n *   Defaults stay French for back-compat.\r\n */\r\n\r\nexport interface NetworkErrorBannerProps {\r\n  visible?: boolean;\r\n  message?: React.ReactNode;\r\n  onRetry?: () => void;\r\n  retryLabel?: React.ReactNode;\r\n}\r\n\r\nfunction NetworkErrorBanner({\r\n  visible,\r\n  message = \"Connexion perdue.\",\r\n  onRetry,\r\n  retryLabel = \"Réessayer\",\r\n}: NetworkErrorBannerProps) {\r\n  if (!visible) return null;\r\n  return (\r\n    <Box role=\"alert\" aria-live=\"assertive\" className=\"pui-net-error-banner\">\r\n      <ErrorIcon fontSize=\"small\" aria-hidden=\"true\" />\r\n      <span>{message}</span>\r\n      {onRetry && (\r\n        <Box\r\n          component=\"button\"\r\n          type=\"button\"\r\n          onClick={onRetry}\r\n          className=\"pui-net-error-banner-retry\"\r\n          sx={{\r\n            // R-AI.1 - tokenised inverse colour mix (was rgba(255,255,255,...))\r\n            background: \"color-mix(in srgb, var(--fg-inverse) 20%, transparent)\",\r\n            border:\r\n              \"1px solid color-mix(in srgb, var(--fg-inverse) 35%, transparent)\",\r\n            color: \"inherit\",\r\n            borderRadius: \"var(--r-sm)\",\r\n            padding: \"var(--s-1) var(--s-3)\",\r\n            fontSize: \"var(--text-xs)\",\r\n            fontWeight: \"var(--fw-semibold)\",\r\n            cursor: \"pointer\",\r\n            fontFamily: \"inherit\",\r\n            // NEB-1 - logical inline-start margin so it sits correctly under RTL.\r\n            marginInlineStart: 0.5,\r\n            transition: \"background var(--duration-fast, 80ms) ease\",\r\n            \"&:hover\": {\r\n              background:\r\n                \"color-mix(in srgb, var(--fg-inverse) 30%, transparent)\",\r\n            },\r\n            // R-F.1 - focus visible required, charter §05.\r\n            \"&:focus-visible\": {\r\n              outline: \"2px solid var(--fg-inverse)\",\r\n              outlineOffset: \"var(--pui-outline-offset)\",\r\n            },\r\n          }}\r\n        >\r\n          {retryLabel}\r\n        </Box>\r\n      )}\r\n    </Box>\r\n  );\r\n}\r\n\r\nexport default NetworkErrorBanner;\r\n"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,40 @@
+import * as React from "react";
+import type { SxProps, Theme } from "@mui/material/styles";
+/**
+ * PageContent — Portnet UI v2 (pattern)
+ *
+ * Charter §07 · Template canonique — zone contenu (§7.1 bis).
+ *
+ * Wraps the main content zone inside the shell applicatif with the
+ * canonical responsive padding and vertical gap defined in §7.1 bis:
+ *
+ *   xs  ( 0 – 480 px )  → padding  12 px  (--s-3)
+ *   sm  ( 481 – 1023 px) → padding  16 px  (--s-4)
+ *   lg  ( 1024 px +    ) → padding  24 px  (--s-6)
+ *
+ * Usage:
+ *   import { PageContent } from "@portnet/ui";
+ *
+ *   <PageContent>
+ *     <FilterCard />
+ *     <DataGrid ... />
+ *   </PageContent>
+ *
+ * Override gap or add extra sx when the default section gap
+ * (var(--s-4) = 16 px) is not appropriate for the context.
+ *
+ *   <PageContent gap="var(--s-6)" sx={{ maxWidth: 720 }}>
+ *     ...
+ *   </PageContent>
+ */
+export interface PageContentProps {
+    /** Page sections / content */
+    children?: React.ReactNode;
+    /** Override the vertical gap between direct children (default var(--s-4)) */
+    gap?: string;
+    /** MUI sx overrides applied to the root Box */
+    sx?: SxProps<Theme>;
+}
+declare function PageContent({ children, gap, sx }: PageContentProps): React.JSX.Element;
+export default PageContent;
+//# sourceMappingURL=PageContent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PageContent.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/patterns/PageContent.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAG3D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,6EAA6E;IAC7E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED,iBAAS,WAAW,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,gBAAgB,qBAuB3D;AAED,eAAe,WAAW,CAAC"}

package/dist/v2/patterns/PageContent.js

@@ -0,0 +1,69 @@
+"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); } /**
+ * PageContent — Portnet UI v2 (pattern)
+ *
+ * Charter §07 · Template canonique — zone contenu (§7.1 bis).
+ *
+ * Wraps the main content zone inside the shell applicatif with the
+ * canonical responsive padding and vertical gap defined in §7.1 bis:
+ *
+ *   xs  ( 0 – 480 px )  → padding  12 px  (--s-3)
+ *   sm  ( 481 – 1023 px) → padding  16 px  (--s-4)
+ *   lg  ( 1024 px +    ) → padding  24 px  (--s-6)
+ *
+ * Usage:
+ *   import { PageContent } from "@portnet/ui";
+ *
+ *   <PageContent>
+ *     <FilterCard />
+ *     <DataGrid ... />
+ *   </PageContent>
+ *
+ * Override gap or add extra sx when the default section gap
+ * (var(--s-4) = 16 px) is not appropriate for the context.
+ *
+ *   <PageContent gap="var(--s-6)" sx={{ maxWidth: 720 }}>
+ *     ...
+ *   </PageContent>
+ */
+function PageContent(_ref) {
+  var children = _ref.children,
+    gap = _ref.gap,
+    sx = _ref.sx;
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Box["default"], {
+    sx: _objectSpread({
+      /* Responsive padding — charter §7.1 bis */
+      padding: {
+        xs: "var(--s-3)" /* 12 px — mobile */,
+        sm: "var(--s-4)" /* 16 px — tablet */,
+        lg: "var(--s-6)" /* 24 px — desktop */
+      },
+      /* Section layout */
+      display: "flex",
+      flexDirection: "column",
+      gap: gap !== null && gap !== void 0 ? gap : "var(--s-4)",
+      /* Prevent content from overflowing the viewport on narrow screens
+         while still allowing inner scroll containers (DataGrid) to work. */
+      minWidth: 0
+    }, sx),
+    children: children
+  });
+}
+var _default = exports["default"] = PageContent;
+//# sourceMappingURL=PageContent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PageContent.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","PageContent","_ref","children","gap","sx","jsx","padding","xs","sm","lg","display","flexDirection","minWidth","_default","exports"],"sources":["../../../src/lib/v2/patterns/PageContent.tsx"],"sourcesContent":["import * as React from \"react\";\r\nimport Box from \"@mui/material/Box\";\r\nimport type { SxProps, Theme } from \"@mui/material/styles\";\r\nimport type { SystemStyleObject } from \"@mui/system\";\r\n\r\n/**\r\n * PageContent — Portnet UI v2 (pattern)\r\n *\r\n * Charter §07 · Template canonique — zone contenu (§7.1 bis).\r\n *\r\n * Wraps the main content zone inside the shell applicatif with the\r\n * canonical responsive padding and vertical gap defined in §7.1 bis:\r\n *\r\n *   xs  ( 0 – 480 px )  → padding  12 px  (--s-3)\r\n *   sm  ( 481 – 1023 px) → padding  16 px  (--s-4)\r\n *   lg  ( 1024 px +    ) → padding  24 px  (--s-6)\r\n *\r\n * Usage:\r\n *   import { PageContent } from \"@portnet/ui\";\r\n *\r\n *   <PageContent>\r\n *     <FilterCard />\r\n *     <DataGrid ... />\r\n *   </PageContent>\r\n *\r\n * Override gap or add extra sx when the default section gap\r\n * (var(--s-4) = 16 px) is not appropriate for the context.\r\n *\r\n *   <PageContent gap=\"var(--s-6)\" sx={{ maxWidth: 720 }}>\r\n *     ...\r\n *   </PageContent>\r\n */\r\n\r\nexport interface PageContentProps {\r\n  /** Page sections / content */\r\n  children?: React.ReactNode;\r\n  /** Override the vertical gap between direct children (default var(--s-4)) */\r\n  gap?: string;\r\n  /** MUI sx overrides applied to the root Box */\r\n  sx?: SxProps<Theme>;\r\n}\r\n\r\nfunction PageContent({ children, gap, sx }: PageContentProps) {\r\n  return (\r\n    <Box\r\n      sx={{\r\n        /* Responsive padding — charter §7.1 bis */\r\n        padding: {\r\n          xs: \"var(--s-3)\" /* 12 px — mobile */,\r\n          sm: \"var(--s-4)\" /* 16 px — tablet */,\r\n          lg: \"var(--s-6)\" /* 24 px — desktop */,\r\n        },\r\n        /* Section layout */\r\n        display: \"flex\",\r\n        flexDirection: \"column\",\r\n        gap: gap ?? \"var(--s-4)\",\r\n        /* Prevent content from overflowing the viewport on narrow screens\r\n           while still allowing inner scroll containers (DataGrid) to work. */\r\n        minWidth: 0,\r\n        ...(sx as SystemStyleObject<Theme>),\r\n      }}\r\n    >\r\n      {children}\r\n    </Box>\r\n  );\r\n}\r\n\r\nexport default PageContent;\r\n"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,118 @@
+import * as React from "react";
+import Combobox from "../components/Combobox";
+import type { ComboboxOption, ComboboxOptionValue } from "../components/Combobox";
+import Modal from "../components/Modal";
+import type { DataGridColumn } from "../types/datagrid";
+import type { RowId, SortDescriptor } from "../types/common";
+/**
+ * ReferentielField — Portnet UI v2 (pattern)
+ *
+ * Charter §03 · Component "Referentiel · Search-and-select".
+ *
+ * Use this when:
+ *   - The selectable population is too large for <Combobox> to load.
+ *   - The host needs MULTI-CRITERIA search.
+ *   - The result rows benefit from a structured view.
+ *
+ * Criteria shape (B17 extension)
+ * ------------------------------
+ * Each criterion descriptor accepts:
+ *
+ *   { name, label, placeholder, hint, kind, options, loading,
+ *     getOptionValue, getOptionLabel, disableFuture }
+ *
+ *   - kind — discriminator: "input" (default) | "combobox" | "date"
+ *
+ * The B17 extension is purely additive: existing call sites with
+ * `criteria=[{name, label}]` keep rendering plain Inputs because
+ * `kind` defaults to "input".
+ *
+ * A11y trigger (audit Batch 5, finding B4-3):
+ *   The trigger Input acts as a combobox-like disclosure for a dialog
+ *   (the search Modal). aria-haspopup="dialog" + aria-expanded MUST sit
+ *   on the FOCUSABLE element (the <input/>), so every aria-* on the
+ *   trigger is routed through `inputProps` → slotProps.input. This
+ *   includes the Field-injected aria-invalid / aria-required /
+ *   aria-describedby so the whole aria contract lives on one element.
+ */
+/** Localisable strings; `resultsHeading` is a function for plural rules. */
+export interface ReferentielFieldLabels {
+    searchAria?: string;
+    clearAria?: string;
+    modalCancel?: React.ReactNode;
+    modalConfirm?: React.ReactNode;
+    searchSubmit?: React.ReactNode;
+    resultsHeading?: (n: number) => string;
+    initialEmptyTitle?: React.ReactNode;
+    initialEmptyHint?: React.ReactNode;
+    noResultsTitle?: React.ReactNode;
+    noResultsHint?: React.ReactNode;
+    errorTitle?: React.ReactNode;
+    errorRetry?: React.ReactNode;
+    loadingHint?: React.ReactNode;
+    placeholder?: string;
+}
+/** One search criterion. combobox/date-only fields reuse the real
+ *  component prop types so they stay exactly aligned. */
+export interface ReferentielCriterion {
+    name: string;
+    label: React.ReactNode;
+    placeholder?: string;
+    hint?: React.ReactNode;
+    kind?: "input" | "combobox" | "date";
+    options?: React.ComponentProps<typeof Combobox>["options"];
+    loading?: boolean;
+    /**
+     * Accepted for backward API compatibility with older criterion configs.
+     * Combobox has no equivalent hook (it resolves value/label straight off
+     * each option's own .value/.label), so this is currently NOT wired into
+     * the "combobox" kind's render below — kept typed rather than removed so
+     * any existing caller that sets it doesn't get a compile error.
+     */
+    getOptionValue?: (option: ComboboxOption | ComboboxOptionValue) => ComboboxOptionValue;
+    getOptionLabel?: React.ComponentProps<typeof Combobox>["getOptionLabel"];
+    disableFuture?: boolean;
+}
+export interface ReferentielSearchParams {
+    criteria: Record<string, unknown>;
+    page: number;
+    pageSize: number;
+    sort: SortDescriptor[] | undefined;
+}
+export interface ReferentielSearchResult<T> {
+    items: T[];
+    total?: number;
+}
+export interface ReferentielFieldProps<T> {
+    value?: T | null;
+    onChange?: (value: T | null) => void;
+    getDisplayValue?: (value: T) => string;
+    placeholder?: string;
+    disabled?: boolean;
+    readOnly?: boolean;
+    clearable?: boolean;
+    title?: React.ReactNode;
+    subtitle?: React.ReactNode;
+    size?: "sm" | "md" | "lg" | "xl";
+    modalProps?: Partial<React.ComponentProps<typeof Modal>>;
+    search: (params: ReferentielSearchParams) => ReferentielSearchResult<T> | Promise<ReferentielSearchResult<T>>;
+    criteria?: ReferentielCriterion[];
+    initialCriteria?: Record<string, unknown>;
+    columns: DataGridColumn<T>[];
+    pageSize?: number;
+    pageSizes?: number[];
+    getRowId?: (row: T) => RowId;
+    confirmOnSelection?: boolean;
+    sort?: SortDescriptor[];
+    onSortChange?: React.Dispatch<React.SetStateAction<SortDescriptor[]>>;
+    labels?: ReferentielFieldLabels;
+    locale?: string;
+    id?: string;
+    name?: string;
+    "aria-invalid"?: React.AriaAttributes["aria-invalid"];
+    "aria-required"?: React.AriaAttributes["aria-required"];
+    "aria-describedby"?: string;
+}
+declare function ReferentielField<T>({ value, onChange, getDisplayValue, placeholder, disabled, readOnly, clearable, title, subtitle, size, modalProps, search, criteria, initialCriteria, columns, pageSize: pageSizeProp, pageSizes, getRowId, confirmOnSelection, sort, onSortChange, labels, locale, id, name, "aria-invalid": ariaInvalid, "aria-required": ariaRequired, "aria-describedby": ariaDescribedBy, }: ReferentielFieldProps<T>): React.JSX.Element;
+export default ReferentielField;
+//# sourceMappingURL=ReferentielField.d.ts.map

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

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