@portnet/ui 6.0.1 → 6.0.2

package/dist/v2/patterns/KeyboardShortcutsHelp.js

@@ -120,12 +120,31 @@ function KeyboardShortcutsHelp(_ref2) {
     shortcuts = _ref2$shortcuts === void 0 ? [] : _ref2$shortcuts,
     _ref2$title = _ref2.title,
     title = _ref2$title === void 0 ? "Raccourcis clavier" : _ref2$title,
-    labels = _ref2.labels;
+    labels = _ref2.labels,
+    open = _ref2.open,
+    onOpenChange = _ref2.onOpenChange;
   var _React$useState = React.useState(false),
     _React$useState2 = _slicedToArray(_React$useState, 2),
-    isOpen = _React$useState2[0],
-    setIsOpen = _React$useState2[1];
+    uncontrolledOpen = _React$useState2[0],
+    setUncontrolledOpen = _React$useState2[1];
+  var isControlled = open !== undefined;
+  var isOpen = isControlled ? open : uncontrolledOpen;
   var L = (0, _mergeLabels.mergeLabels)(DEFAULT_LABELS, labels);
+
+  /* Refs so the "?" listener can stay on a `[]` dependency list — it must not
+   * be torn down and re-added on every open/close, and in controlled mode there
+   * is no functional-update form to fall back on. */
+  var isOpenRef = React.useRef(isOpen);
+  isOpenRef.current = isOpen;
+  var onOpenChangeRef = React.useRef(onOpenChange);
+  onOpenChangeRef.current = onOpenChange;
+  var isControlledRef = React.useRef(isControlled);
+  isControlledRef.current = isControlled;
+  var requestOpen = React.useCallback(function (next) {
+    var _onOpenChangeRef$curr;
+    if (!isControlledRef.current) setUncontrolledOpen(next);
+    (_onOpenChangeRef$curr = onOpenChangeRef.current) === null || _onOpenChangeRef$curr === void 0 ? void 0 : _onOpenChangeRef$curr.call(onOpenChangeRef, next);
+  }, []);
   React.useEffect(function () {
     var handler = function handler(event) {
       // Only react to "?" (Shift+/ on US, AltGr+, on many AZERTY layouts).
@@ -138,15 +157,13 @@ function KeyboardShortcutsHelp(_ref2) {
       // User is typing in a text field — let "?" through.
       if (isFocusOnTextEntry()) return;
       event.preventDefault();
-      setIsOpen(function (prev) {
-        return !prev;
-      });
+      requestOpen(!isOpenRef.current);
     };
     window.addEventListener("keydown", handler);
     return function () {
       return window.removeEventListener("keydown", handler);
     };
-  }, []);
+  }, [requestOpen]);
   if (!Array.isArray(shortcuts) || shortcuts.length === 0) {
     return null;
   }
@@ -154,7 +171,7 @@ function KeyboardShortcutsHelp(_ref2) {
     open: isOpen,
     title: title,
     onClose: function onClose() {
-      return setIsOpen(false);
+      return requestOpen(false);
     },
     size: "md",
     children: [/*#__PURE__*/(0, _jsxRuntime.jsx)("dl", {

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

@@ -1 +1 @@
-{"version":3,"file":"KeyboardShortcutsHelp.js","names":["React","_interopRequireWildcard","require","_Modal","_interopRequireDefault","_mergeLabels","_jsxRuntime","obj","__esModule","_getRequireWildcardCache","nodeInterop","WeakMap","cacheBabelInterop","cacheNodeInterop","_typeof","cache","has","get","newObj","hasPropertyDescriptor","Object","defineProperty","getOwnPropertyDescriptor","key","prototype","hasOwnProperty","call","desc","set","_slicedToArray","arr","i","_arrayWithHoles","_iterableToArrayLimit","_unsupportedIterableToArray","_nonIterableRest","TypeError","o","minLen","_arrayLikeToArray","n","toString","slice","constructor","name","Array","from","test","len","length","arr2","_i","Symbol","iterator","_s","_e","_x","_r","_arr","_n","_d","next","done","push","value","err","isArray","isFocusOnTextEntry","el","document","activeElement","tag","tagName","HTMLElement","isContentEditable","ShortcutKey","_ref","children","jsx","style","display","minWidth","padding","background","border","borderBottomColor","borderRadius","boxShadow","fontFamily","fontSize","textAlign","lineHeight","color","SHORTCUT_ROW_SX","gridTemplateColumns","gap","alignItems","borderBottom","SHORTCUT_KEYS_SX","flexWrap","HELP_FOOTNOTE_SX","marginTop","paddingTop","borderTop","DEFAULT_LABELS","freeze","footnoteIntro","footnoteOutro","listAriaLabel","keyJoiner","KeyboardShortcutsHelp","_ref2","_ref2$shortcuts","shortcuts","_ref2$title","title","labels","_React$useState","useState","_React$useState2","isOpen","setIsOpen","L","mergeLabels","useEffect","handler","event","ctrlKey","metaKey","altKey","preventDefault","prev","window","addEventListener","removeEventListener","jsxs","open","onClose","size","margin","map","sc","keys","k","j","Fragment","description","_default","exports"],"sources":["../../../src/lib/v2/patterns/KeyboardShortcutsHelp.tsx"],"sourcesContent":["import * as React from \"react\";\r\nimport Modal from \"../components/Modal\";\r\nimport { mergeLabels } from \"../utils/mergeLabels\";\r\n\r\n/* ── Body-only focus guard ────────────────────────────────────────\r\n * The \"?\" key is a printable character. If a user types \"?\" inside an\r\n * Input / Textarea / contentEditable element we must NOT hijack the\r\n * keypress to open the help — they're trying to type a question mark.\r\n *\r\n * BUTTON / A focus is NOT blocking by design: when the user has tabbed\r\n * onto an interactive non-text element, hitting \"?\" makes sense as a\r\n * help affordance (navigation mode, not text-entry mode).\r\n */\r\nfunction isFocusOnTextEntry(): boolean {\r\n  const el = typeof document !== \"undefined\" ? document.activeElement : null;\r\n  if (!el) return false;\r\n  const tag = el.tagName;\r\n  if (tag === \"INPUT\" || tag === \"TEXTAREA\" || tag === \"SELECT\") return true;\r\n  if (el instanceof HTMLElement && el.isContentEditable) return true;\r\n  return false;\r\n}\r\n\r\nfunction ShortcutKey({ children }: { children?: React.ReactNode }) {\r\n  return (\r\n    <kbd\r\n      style={{\r\n        display: \"inline-block\",\r\n        minWidth: \"1.75em\",\r\n        padding: \"0.15em 0.5em\",\r\n        background: \"var(--bg-subtle)\",\r\n        border: \"1px solid var(--border)\",\r\n        borderBottomColor: \"var(--border-strong, var(--border))\",\r\n        borderRadius: \"var(--r-sm)\",\r\n        boxShadow: \"inset 0 -1px 0 var(--border)\",\r\n        fontFamily: \"var(--font-mono, monospace)\",\r\n        fontSize: \"var(--text-sm)\",\r\n        textAlign: \"center\",\r\n        lineHeight: 1.4,\r\n        color: \"var(--fg)\",\r\n      }}\r\n    >\r\n      {children}\r\n    </kbd>\r\n  );\r\n}\r\n\r\nconst SHORTCUT_ROW_SX: React.CSSProperties = {\r\n  display: \"grid\",\r\n  gridTemplateColumns: \"auto 1fr\",\r\n  gap: \"var(--s-4)\",\r\n  alignItems: \"center\",\r\n  padding: \"var(--s-2) 0\",\r\n  borderBottom: \"1px solid var(--border-subtle, var(--border))\",\r\n};\r\n\r\nconst SHORTCUT_KEYS_SX: React.CSSProperties = {\r\n  display: \"flex\",\r\n  gap: \"var(--s-1)\",\r\n  alignItems: \"center\",\r\n  flexWrap: \"wrap\",\r\n};\r\n\r\nconst HELP_FOOTNOTE_SX: React.CSSProperties = {\r\n  marginTop: \"var(--s-4)\",\r\n  paddingTop: \"var(--s-3)\",\r\n  borderTop: \"1px solid var(--border)\",\r\n  fontSize: \"var(--text-xs)\",\r\n  color: \"var(--fg-subtle)\",\r\n  lineHeight: 1.5,\r\n};\r\n\r\nconst DEFAULT_LABELS = Object.freeze({\r\n  /* Footnote rendered below the shortcut list. Split into two parts so the\r\n   * keycap can be embedded in the middle without forcing the i18n string to\r\n   * carry HTML tags. */\r\n  footnoteIntro: \"Astuce : appuyez sur\",\r\n  footnoteOutro:\r\n    \"à tout moment pour ouvrir ou fermer cette aide. Les raccourcis s'activent uniquement quand votre curseur n'est pas dans un champ de saisie.\",\r\n  /* aria-label on the <dl> listing every shortcut. */\r\n  listAriaLabel: \"Liste des raccourcis clavier disponibles sur cette page\",\r\n  /* Joiner rendered between alternative keys for the same shortcut. */\r\n  keyJoiner: \"ou\",\r\n});\r\n\r\n/**\r\n * KeyboardShortcutsHelp — Portnet UI v2\r\n *\r\n * Charter §5.2 SHOULD — discoverable help overlay for page-level keyboard\r\n * shortcuts. Listens globally for \"?\" and opens a v2.Modal listing every\r\n * shortcut as <kbd> elements (WCAG 1.3.1 semantic).\r\n *\r\n * Self-contained: the host page only declares the shortcuts array and renders\r\n * <KeyboardShortcutsHelp shortcuts={…} /> once.\r\n *\r\n * Localisation (FR / EN / AR):\r\n *   <KeyboardShortcutsHelp\r\n *     title=\"Keyboard shortcuts\"\r\n *     labels={{\r\n *       footnoteIntro: \"Tip: press\",\r\n *       footnoteOutro: \"anytime to toggle this help…\",\r\n *       listAriaLabel: \"List of keyboard shortcuts available on this page\",\r\n *       keyJoiner:     \"or\",\r\n *     }}\r\n *     shortcuts={…}\r\n *   />\r\n *\r\n * Charter §5.2 SHOULD + WCAG 1.3.1 (semantic <kbd>) + 2.1.1 (keyboard\r\n * reachable) + R-M.* (modal focus trap inherited from v2.Modal).\r\n */\r\n\r\nexport interface KeyboardShortcut {\r\n  keys: string[];\r\n  description: React.ReactNode;\r\n}\r\n\r\nexport interface KeyboardShortcutsHelpLabels {\r\n  footnoteIntro?: string | undefined;\r\n  footnoteOutro?: string | undefined;\r\n  listAriaLabel?: string | undefined;\r\n  keyJoiner?: string | undefined;\r\n}\r\n\r\nexport interface KeyboardShortcutsHelpProps {\r\n  shortcuts?: KeyboardShortcut[] | undefined;\r\n  title?: React.ReactNode | undefined;\r\n  labels?: KeyboardShortcutsHelpLabels | undefined;\r\n}\r\n\r\nfunction KeyboardShortcutsHelp({\r\n  shortcuts = [],\r\n  title = \"Raccourcis clavier\",\r\n  labels,\r\n}: KeyboardShortcutsHelpProps) {\r\n  const [isOpen, setIsOpen] = React.useState(false);\r\n  const L = mergeLabels(DEFAULT_LABELS, labels);\r\n\r\n  React.useEffect(() => {\r\n    const handler = (event: KeyboardEvent) => {\r\n      // Only react to \"?\" (Shift+/ on US, AltGr+, on many AZERTY layouts).\r\n      // event.key gives us the resolved character regardless of physical key.\r\n      if (event.key !== \"?\") return;\r\n\r\n      // Modifier keys (Ctrl, Meta, Alt) reserved for browser / OS shortcuts.\r\n      if (event.ctrlKey || event.metaKey || event.altKey) return;\r\n\r\n      // User is typing in a text field — let \"?\" through.\r\n      if (isFocusOnTextEntry()) return;\r\n\r\n      event.preventDefault();\r\n      setIsOpen((prev) => !prev);\r\n    };\r\n\r\n    window.addEventListener(\"keydown\", handler);\r\n    return () => window.removeEventListener(\"keydown\", handler);\r\n  }, []);\r\n\r\n  if (!Array.isArray(shortcuts) || shortcuts.length === 0) {\r\n    return null;\r\n  }\r\n\r\n  return (\r\n    <Modal open={isOpen} title={title} onClose={() => setIsOpen(false)} size=\"md\">\r\n      <dl style={{ margin: 0, padding: 0 }} aria-label={L.listAriaLabel}>\r\n        {shortcuts.map((sc, i) => (\r\n          <div key={i} style={SHORTCUT_ROW_SX}>\r\n            <dt style={SHORTCUT_KEYS_SX}>\r\n              {sc.keys.map((k, j) => (\r\n                <React.Fragment key={j}>\r\n                  <ShortcutKey>{k}</ShortcutKey>\r\n                  {j < sc.keys.length - 1 && (\r\n                    <span\r\n                      aria-hidden=\"true\"\r\n                      style={{\r\n                        color: \"var(--fg-subtle)\",\r\n                        fontSize: \"var(--text-xs)\",\r\n                      }}\r\n                    >\r\n                      {L.keyJoiner}\r\n                    </span>\r\n                  )}\r\n                </React.Fragment>\r\n              ))}\r\n            </dt>\r\n            <dd style={{ margin: 0, fontSize: \"var(--text-body)\" }}>\r\n              {sc.description}\r\n            </dd>\r\n          </div>\r\n        ))}\r\n      </dl>\r\n      <div style={HELP_FOOTNOTE_SX}>\r\n        {L.footnoteIntro}{\" \"}\r\n        <ShortcutKey>?</ShortcutKey>{\" \"}\r\n        {L.footnoteOutro}\r\n      </div>\r\n    </Modal>\r\n  );\r\n}\r\n\r\nexport default KeyboardShortcutsHelp;\r\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"KeyboardShortcutsHelp.js","names":["React","_interopRequireWildcard","require","_Modal","_interopRequireDefault","_mergeLabels","_jsxRuntime","obj","__esModule","_getRequireWildcardCache","nodeInterop","WeakMap","cacheBabelInterop","cacheNodeInterop","_typeof","cache","has","get","newObj","hasPropertyDescriptor","Object","defineProperty","getOwnPropertyDescriptor","key","prototype","hasOwnProperty","call","desc","set","_slicedToArray","arr","i","_arrayWithHoles","_iterableToArrayLimit","_unsupportedIterableToArray","_nonIterableRest","TypeError","o","minLen","_arrayLikeToArray","n","toString","slice","constructor","name","Array","from","test","len","length","arr2","_i","Symbol","iterator","_s","_e","_x","_r","_arr","_n","_d","next","done","push","value","err","isArray","isFocusOnTextEntry","el","document","activeElement","tag","tagName","HTMLElement","isContentEditable","ShortcutKey","_ref","children","jsx","style","display","minWidth","padding","background","border","borderBottomColor","borderRadius","boxShadow","fontFamily","fontSize","textAlign","lineHeight","color","SHORTCUT_ROW_SX","gridTemplateColumns","gap","alignItems","borderBottom","SHORTCUT_KEYS_SX","flexWrap","HELP_FOOTNOTE_SX","marginTop","paddingTop","borderTop","DEFAULT_LABELS","freeze","footnoteIntro","footnoteOutro","listAriaLabel","keyJoiner","KeyboardShortcutsHelp","_ref2","_ref2$shortcuts","shortcuts","_ref2$title","title","labels","open","onOpenChange","_React$useState","useState","_React$useState2","uncontrolledOpen","setUncontrolledOpen","isControlled","undefined","isOpen","L","mergeLabels","isOpenRef","useRef","current","onOpenChangeRef","isControlledRef","requestOpen","useCallback","_onOpenChangeRef$curr","useEffect","handler","event","ctrlKey","metaKey","altKey","preventDefault","window","addEventListener","removeEventListener","jsxs","onClose","size","margin","map","sc","keys","k","j","Fragment","description","_default","exports"],"sources":["../../../src/lib/v2/patterns/KeyboardShortcutsHelp.tsx"],"sourcesContent":["import * as React from \"react\";\r\nimport Modal from \"../components/Modal\";\r\nimport { mergeLabels } from \"../utils/mergeLabels\";\r\n\r\n/* ── Body-only focus guard ────────────────────────────────────────\r\n * The \"?\" key is a printable character. If a user types \"?\" inside an\r\n * Input / Textarea / contentEditable element we must NOT hijack the\r\n * keypress to open the help — they're trying to type a question mark.\r\n *\r\n * BUTTON / A focus is NOT blocking by design: when the user has tabbed\r\n * onto an interactive non-text element, hitting \"?\" makes sense as a\r\n * help affordance (navigation mode, not text-entry mode).\r\n */\r\nfunction isFocusOnTextEntry(): boolean {\r\n  const el = typeof document !== \"undefined\" ? document.activeElement : null;\r\n  if (!el) return false;\r\n  const tag = el.tagName;\r\n  if (tag === \"INPUT\" || tag === \"TEXTAREA\" || tag === \"SELECT\") return true;\r\n  if (el instanceof HTMLElement && el.isContentEditable) return true;\r\n  return false;\r\n}\r\n\r\nfunction ShortcutKey({ children }: { children?: React.ReactNode }) {\r\n  return (\r\n    <kbd\r\n      style={{\r\n        display: \"inline-block\",\r\n        minWidth: \"1.75em\",\r\n        padding: \"0.15em 0.5em\",\r\n        background: \"var(--bg-subtle)\",\r\n        border: \"1px solid var(--border)\",\r\n        borderBottomColor: \"var(--border-strong, var(--border))\",\r\n        borderRadius: \"var(--r-sm)\",\r\n        boxShadow: \"inset 0 -1px 0 var(--border)\",\r\n        fontFamily: \"var(--font-mono, monospace)\",\r\n        fontSize: \"var(--text-sm)\",\r\n        textAlign: \"center\",\r\n        lineHeight: 1.4,\r\n        color: \"var(--fg)\",\r\n      }}\r\n    >\r\n      {children}\r\n    </kbd>\r\n  );\r\n}\r\n\r\nconst SHORTCUT_ROW_SX: React.CSSProperties = {\r\n  display: \"grid\",\r\n  gridTemplateColumns: \"auto 1fr\",\r\n  gap: \"var(--s-4)\",\r\n  alignItems: \"center\",\r\n  padding: \"var(--s-2) 0\",\r\n  borderBottom: \"1px solid var(--border-subtle, var(--border))\",\r\n};\r\n\r\nconst SHORTCUT_KEYS_SX: React.CSSProperties = {\r\n  display: \"flex\",\r\n  gap: \"var(--s-1)\",\r\n  alignItems: \"center\",\r\n  flexWrap: \"wrap\",\r\n};\r\n\r\nconst HELP_FOOTNOTE_SX: React.CSSProperties = {\r\n  marginTop: \"var(--s-4)\",\r\n  paddingTop: \"var(--s-3)\",\r\n  borderTop: \"1px solid var(--border)\",\r\n  fontSize: \"var(--text-xs)\",\r\n  color: \"var(--fg-subtle)\",\r\n  lineHeight: 1.5,\r\n};\r\n\r\nconst DEFAULT_LABELS = Object.freeze({\r\n  /* Footnote rendered below the shortcut list. Split into two parts so the\r\n   * keycap can be embedded in the middle without forcing the i18n string to\r\n   * carry HTML tags. */\r\n  footnoteIntro: \"Astuce : appuyez sur\",\r\n  footnoteOutro:\r\n    \"à tout moment pour ouvrir ou fermer cette aide. Les raccourcis s'activent uniquement quand votre curseur n'est pas dans un champ de saisie.\",\r\n  /* aria-label on the <dl> listing every shortcut. */\r\n  listAriaLabel: \"Liste des raccourcis clavier disponibles sur cette page\",\r\n  /* Joiner rendered between alternative keys for the same shortcut. */\r\n  keyJoiner: \"ou\",\r\n});\r\n\r\n/**\r\n * KeyboardShortcutsHelp — Portnet UI v2\r\n *\r\n * Charter §5.2 SHOULD — discoverable help overlay for page-level keyboard\r\n * shortcuts. Listens globally for \"?\" and opens a v2.Modal listing every\r\n * shortcut as <kbd> elements (WCAG 1.3.1 semantic).\r\n *\r\n * Self-contained: the host page only declares the shortcuts array and renders\r\n * <KeyboardShortcutsHelp shortcuts={…} /> once.\r\n *\r\n * Localisation (FR / EN / AR):\r\n *   <KeyboardShortcutsHelp\r\n *     title=\"Keyboard shortcuts\"\r\n *     labels={{\r\n *       footnoteIntro: \"Tip: press\",\r\n *       footnoteOutro: \"anytime to toggle this help…\",\r\n *       listAriaLabel: \"List of keyboard shortcuts available on this page\",\r\n *       keyJoiner:     \"or\",\r\n *     }}\r\n *     shortcuts={…}\r\n *   />\r\n *\r\n * Charter §5.2 SHOULD + WCAG 1.3.1 (semantic <kbd>) + 2.1.1 (keyboard\r\n * reachable) + R-M.* (modal focus trap inherited from v2.Modal).\r\n */\r\n\r\nexport interface KeyboardShortcut {\r\n  keys: string[];\r\n  description: React.ReactNode;\r\n}\r\n\r\nexport interface KeyboardShortcutsHelpLabels {\r\n  footnoteIntro?: string | undefined;\r\n  footnoteOutro?: string | undefined;\r\n  listAriaLabel?: string | undefined;\r\n  keyJoiner?: string | undefined;\r\n}\r\n\r\nexport interface KeyboardShortcutsHelpProps {\r\n  shortcuts?: KeyboardShortcut[] | undefined;\r\n  title?: React.ReactNode | undefined;\r\n  labels?: KeyboardShortcutsHelpLabels | undefined;\r\n  /**\r\n   * Optional CONTROLLED open state. Omit for the original self-contained\r\n   * behaviour (the \"?\" listener owns the state).\r\n   *\r\n   * Added because the panel had no trigger but the keystroke. Hosts wired it\r\n   * correctly and users still reported the shortcuts \"missing\" — they are, in\r\n   * every practical sense, if the only affordance is a key you have to already\r\n   * know about. Charter §05.2 asks for DISCOVERABLE help, and a host cannot add\r\n   * a menu item or button without being able to open this.\r\n   */\r\n  open?: boolean | undefined;\r\n  /** Called with the requested next state, for both \"?\" and the close button. */\r\n  onOpenChange?: ((open: boolean) => void) | undefined;\r\n}\r\n\r\nfunction KeyboardShortcutsHelp({\r\n  shortcuts = [],\r\n  title = \"Raccourcis clavier\",\r\n  labels,\r\n  open,\r\n  onOpenChange,\r\n}: KeyboardShortcutsHelpProps) {\r\n  const [uncontrolledOpen, setUncontrolledOpen] = React.useState(false);\r\n  const isControlled = open !== undefined;\r\n  const isOpen = isControlled ? open : uncontrolledOpen;\r\n  const L = mergeLabels(DEFAULT_LABELS, labels);\r\n\r\n  /* Refs so the \"?\" listener can stay on a `[]` dependency list — it must not\r\n   * be torn down and re-added on every open/close, and in controlled mode there\r\n   * is no functional-update form to fall back on. */\r\n  const isOpenRef = React.useRef(isOpen);\r\n  isOpenRef.current = isOpen;\r\n  const onOpenChangeRef = React.useRef(onOpenChange);\r\n  onOpenChangeRef.current = onOpenChange;\r\n  const isControlledRef = React.useRef(isControlled);\r\n  isControlledRef.current = isControlled;\r\n\r\n  const requestOpen = React.useCallback((next: boolean) => {\r\n    if (!isControlledRef.current) setUncontrolledOpen(next);\r\n    onOpenChangeRef.current?.(next);\r\n  }, []);\r\n\r\n  React.useEffect(() => {\r\n    const handler = (event: KeyboardEvent) => {\r\n      // Only react to \"?\" (Shift+/ on US, AltGr+, on many AZERTY layouts).\r\n      // event.key gives us the resolved character regardless of physical key.\r\n      if (event.key !== \"?\") return;\r\n\r\n      // Modifier keys (Ctrl, Meta, Alt) reserved for browser / OS shortcuts.\r\n      if (event.ctrlKey || event.metaKey || event.altKey) return;\r\n\r\n      // User is typing in a text field — let \"?\" through.\r\n      if (isFocusOnTextEntry()) return;\r\n\r\n      event.preventDefault();\r\n      requestOpen(!isOpenRef.current);\r\n    };\r\n\r\n    window.addEventListener(\"keydown\", handler);\r\n    return () => window.removeEventListener(\"keydown\", handler);\r\n  }, [requestOpen]);\r\n\r\n  if (!Array.isArray(shortcuts) || shortcuts.length === 0) {\r\n    return null;\r\n  }\r\n\r\n  return (\r\n    <Modal\r\n      open={isOpen}\r\n      title={title}\r\n      onClose={() => requestOpen(false)}\r\n      size=\"md\"\r\n    >\r\n      <dl style={{ margin: 0, padding: 0 }} aria-label={L.listAriaLabel}>\r\n        {shortcuts.map((sc, i) => (\r\n          <div key={i} style={SHORTCUT_ROW_SX}>\r\n            <dt style={SHORTCUT_KEYS_SX}>\r\n              {sc.keys.map((k, j) => (\r\n                <React.Fragment key={j}>\r\n                  <ShortcutKey>{k}</ShortcutKey>\r\n                  {j < sc.keys.length - 1 && (\r\n                    <span\r\n                      aria-hidden=\"true\"\r\n                      style={{\r\n                        color: \"var(--fg-subtle)\",\r\n                        fontSize: \"var(--text-xs)\",\r\n                      }}\r\n                    >\r\n                      {L.keyJoiner}\r\n                    </span>\r\n                  )}\r\n                </React.Fragment>\r\n              ))}\r\n            </dt>\r\n            <dd style={{ margin: 0, fontSize: \"var(--text-body)\" }}>\r\n              {sc.description}\r\n            </dd>\r\n          </div>\r\n        ))}\r\n      </dl>\r\n      <div style={HELP_FOOTNOTE_SX}>\r\n        {L.footnoteIntro}{\" \"}\r\n        <ShortcutKey>?</ShortcutKey>{\" \"}\r\n        {L.footnoteOutro}\r\n      </div>\r\n    </Modal>\r\n  );\r\n}\r\n\r\nexport default KeyboardShortcutsHelp;\r\n"],"mappings":";;;;;;;AAAA,IAAAA,KAAA,GAAAC,uBAAA,CAAAC,OAAA;AACA,IAAAC,MAAA,GAAAC,sBAAA,CAAAF,OAAA;AACA,IAAAG,YAAA,GAAAH,OAAA;AAAmD,IAAAI,WAAA,GAAAJ,OAAA;AAAA,SAAAE,uBAAAG,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,SAAAT,wBAAAM,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,eAAAC,GAAA,EAAAC,CAAA,WAAAC,eAAA,CAAAF,GAAA,KAAAG,qBAAA,CAAAH,GAAA,EAAAC,CAAA,KAAAG,2BAAA,CAAAJ,GAAA,EAAAC,CAAA,KAAAI,gBAAA;AAAA,SAAAA,iBAAA,cAAAC,SAAA;AAAA,SAAAF,4BAAAG,CAAA,EAAAC,MAAA,SAAAD,CAAA,qBAAAA,CAAA,sBAAAE,iBAAA,CAAAF,CAAA,EAAAC,MAAA,OAAAE,CAAA,GAAApB,MAAA,CAAAI,SAAA,CAAAiB,QAAA,CAAAf,IAAA,CAAAW,CAAA,EAAAK,KAAA,aAAAF,CAAA,iBAAAH,CAAA,CAAAM,WAAA,EAAAH,CAAA,GAAAH,CAAA,CAAAM,WAAA,CAAAC,IAAA,MAAAJ,CAAA,cAAAA,CAAA,mBAAAK,KAAA,CAAAC,IAAA,CAAAT,CAAA,OAAAG,CAAA,+DAAAO,IAAA,CAAAP,CAAA,UAAAD,iBAAA,CAAAF,CAAA,EAAAC,MAAA;AAAA,SAAAC,kBAAAT,GAAA,EAAAkB,GAAA,QAAAA,GAAA,YAAAA,GAAA,GAAAlB,GAAA,CAAAmB,MAAA,EAAAD,GAAA,GAAAlB,GAAA,CAAAmB,MAAA,WAAAlB,CAAA,MAAAmB,IAAA,OAAAL,KAAA,CAAAG,GAAA,GAAAjB,CAAA,GAAAiB,GAAA,EAAAjB,CAAA,MAAAmB,IAAA,CAAAnB,CAAA,IAAAD,GAAA,CAAAC,CAAA,YAAAmB,IAAA;AAAA,SAAAjB,sBAAAH,GAAA,EAAAC,CAAA,QAAAoB,EAAA,WAAArB,GAAA,gCAAAsB,MAAA,IAAAtB,GAAA,CAAAsB,MAAA,CAAAC,QAAA,KAAAvB,GAAA,4BAAAqB,EAAA,QAAAG,EAAA,EAAAC,EAAA,EAAAC,EAAA,EAAAC,EAAA,EAAAC,IAAA,OAAAC,EAAA,OAAAC,EAAA,iBAAAJ,EAAA,IAAAL,EAAA,GAAAA,EAAA,CAAAzB,IAAA,CAAAI,GAAA,GAAA+B,IAAA,QAAA9B,CAAA,QAAAX,MAAA,CAAA+B,EAAA,MAAAA,EAAA,UAAAQ,EAAA,uBAAAA,EAAA,IAAAL,EAAA,GAAAE,EAAA,CAAA9B,IAAA,CAAAyB,EAAA,GAAAW,IAAA,MAAAJ,IAAA,CAAAK,IAAA,CAAAT,EAAA,CAAAU,KAAA,GAAAN,IAAA,CAAAT,MAAA,KAAAlB,CAAA,GAAA4B,EAAA,sBAAAM,GAAA,IAAAL,EAAA,OAAAL,EAAA,GAAAU,GAAA,yBAAAN,EAAA,YAAAR,EAAA,eAAAM,EAAA,GAAAN,EAAA,cAAA/B,MAAA,CAAAqC,EAAA,MAAAA,EAAA,2BAAAG,EAAA,QAAAL,EAAA,aAAAG,IAAA;AAAA,SAAA1B,gBAAAF,GAAA,QAAAe,KAAA,CAAAqB,OAAA,CAAApC,GAAA,UAAAA,GAAA,IAEnD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASqC,kBAAkBA,CAAA,EAAY;EACrC,IAAMC,EAAE,GAAG,OAAOC,QAAQ,KAAK,WAAW,GAAGA,QAAQ,CAACC,aAAa,GAAG,IAAI;EAC1E,IAAI,CAACF,EAAE,EAAE,OAAO,KAAK;EACrB,IAAMG,GAAG,GAAGH,EAAE,CAACI,OAAO;EACtB,IAAID,GAAG,KAAK,OAAO,IAAIA,GAAG,KAAK,UAAU,IAAIA,GAAG,KAAK,QAAQ,EAAE,OAAO,IAAI;EAC1E,IAAIH,EAAE,YAAYK,WAAW,IAAIL,EAAE,CAACM,iBAAiB,EAAE,OAAO,IAAI;EAClE,OAAO,KAAK;AACd;AAEA,SAASC,WAAWA,CAAAC,IAAA,EAA+C;EAAA,IAA5CC,QAAQ,GAAAD,IAAA,CAARC,QAAQ;EAC7B,oBACE,IAAAvE,WAAA,CAAAwE,GAAA;IACEC,KAAK,EAAE;MACLC,OAAO,EAAE,cAAc;MACvBC,QAAQ,EAAE,QAAQ;MAClBC,OAAO,EAAE,cAAc;MACvBC,UAAU,EAAE,kBAAkB;MAC9BC,MAAM,EAAE,yBAAyB;MACjCC,iBAAiB,EAAE,qCAAqC;MACxDC,YAAY,EAAE,aAAa;MAC3BC,SAAS,EAAE,8BAA8B;MACzCC,UAAU,EAAE,6BAA6B;MACzCC,QAAQ,EAAE,gBAAgB;MAC1BC,SAAS,EAAE,QAAQ;MACnBC,UAAU,EAAE,GAAG;MACfC,KAAK,EAAE;IACT,CAAE;IAAAf,QAAA,EAEDA;EAAQ,CACN,CAAC;AAEV;AAEA,IAAMgB,eAAoC,GAAG;EAC3Cb,OAAO,EAAE,MAAM;EACfc,mBAAmB,EAAE,UAAU;EAC/BC,GAAG,EAAE,YAAY;EACjBC,UAAU,EAAE,QAAQ;EACpBd,OAAO,EAAE,cAAc;EACvBe,YAAY,EAAE;AAChB,CAAC;AAED,IAAMC,gBAAqC,GAAG;EAC5ClB,OAAO,EAAE,MAAM;EACfe,GAAG,EAAE,YAAY;EACjBC,UAAU,EAAE,QAAQ;EACpBG,QAAQ,EAAE;AACZ,CAAC;AAED,IAAMC,gBAAqC,GAAG;EAC5CC,SAAS,EAAE,YAAY;EACvBC,UAAU,EAAE,YAAY;EACxBC,SAAS,EAAE,yBAAyB;EACpCd,QAAQ,EAAE,gBAAgB;EAC1BG,KAAK,EAAE,kBAAkB;EACzBD,UAAU,EAAE;AACd,CAAC;AAED,IAAMa,cAAc,GAAGpF,MAAM,CAACqF,MAAM,CAAC;EACnC;AACF;AACA;EACEC,aAAa,EAAE,sBAAsB;EACrCC,aAAa,EACX,6IAA6I;EAC/I;EACAC,aAAa,EAAE,yDAAyD;EACxE;EACAC,SAAS,EAAE;AACb,CAAC,CAAC;;AAEF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAiCA,SAASC,qBAAqBA,CAAAC,KAAA,EAMC;EAAA,IAAAC,eAAA,GAAAD,KAAA,CAL7BE,SAAS;IAATA,SAAS,GAAAD,eAAA,cAAG,EAAE,GAAAA,eAAA;IAAAE,WAAA,GAAAH,KAAA,CACdI,KAAK;IAALA,KAAK,GAAAD,WAAA,cAAG,oBAAoB,GAAAA,WAAA;IAC5BE,MAAM,GAAAL,KAAA,CAANK,MAAM;IACNC,IAAI,GAAAN,KAAA,CAAJM,IAAI;IACJC,YAAY,GAAAP,KAAA,CAAZO,YAAY;EAEZ,IAAAC,eAAA,GAAgDvH,KAAK,CAACwH,QAAQ,CAAC,KAAK,CAAC;IAAAC,gBAAA,GAAA5F,cAAA,CAAA0F,eAAA;IAA9DG,gBAAgB,GAAAD,gBAAA;IAAEE,mBAAmB,GAAAF,gBAAA;EAC5C,IAAMG,YAAY,GAAGP,IAAI,KAAKQ,SAAS;EACvC,IAAMC,MAAM,GAAGF,YAAY,GAAGP,IAAI,GAAGK,gBAAgB;EACrD,IAAMK,CAAC,GAAG,IAAAC,wBAAW,EAACxB,cAAc,EAAEY,MAAM,CAAC;;EAE7C;AACF;AACA;EACE,IAAMa,SAAS,GAAGjI,KAAK,CAACkI,MAAM,CAACJ,MAAM,CAAC;EACtCG,SAAS,CAACE,OAAO,GAAGL,MAAM;EAC1B,IAAMM,eAAe,GAAGpI,KAAK,CAACkI,MAAM,CAACZ,YAAY,CAAC;EAClDc,eAAe,CAACD,OAAO,GAAGb,YAAY;EACtC,IAAMe,eAAe,GAAGrI,KAAK,CAACkI,MAAM,CAACN,YAAY,CAAC;EAClDS,eAAe,CAACF,OAAO,GAAGP,YAAY;EAEtC,IAAMU,WAAW,GAAGtI,KAAK,CAACuI,WAAW,CAAC,UAAC1E,IAAa,EAAK;IAAA,IAAA2E,qBAAA;IACvD,IAAI,CAACH,eAAe,CAACF,OAAO,EAAER,mBAAmB,CAAC9D,IAAI,CAAC;IACvD,CAAA2E,qBAAA,GAAAJ,eAAe,CAACD,OAAO,cAAAK,qBAAA,uBAAvBA,qBAAA,CAAA9G,IAAA,CAAA0G,eAAe,EAAWvE,IAAI,CAAC;EACjC,CAAC,EAAE,EAAE,CAAC;EAEN7D,KAAK,CAACyI,SAAS,CAAC,YAAM;IACpB,IAAMC,OAAO,GAAG,SAAVA,OAAOA,CAAIC,KAAoB,EAAK;MACxC;MACA;MACA,IAAIA,KAAK,CAACpH,GAAG,KAAK,GAAG,EAAE;;MAEvB;MACA,IAAIoH,KAAK,CAACC,OAAO,IAAID,KAAK,CAACE,OAAO,IAAIF,KAAK,CAACG,MAAM,EAAE;;MAEpD;MACA,IAAI3E,kBAAkB,CAAC,CAAC,EAAE;MAE1BwE,KAAK,CAACI,cAAc,CAAC,CAAC;MACtBT,WAAW,CAAC,CAACL,SAAS,CAACE,OAAO,CAAC;IACjC,CAAC;IAEDa,MAAM,CAACC,gBAAgB,CAAC,SAAS,EAAEP,OAAO,CAAC;IAC3C,OAAO;MAAA,OAAMM,MAAM,CAACE,mBAAmB,CAAC,SAAS,EAAER,OAAO,CAAC;IAAA;EAC7D,CAAC,EAAE,CAACJ,WAAW,CAAC,CAAC;EAEjB,IAAI,CAACzF,KAAK,CAACqB,OAAO,CAAC+C,SAAS,CAAC,IAAIA,SAAS,CAAChE,MAAM,KAAK,CAAC,EAAE;IACvD,OAAO,IAAI;EACb;EAEA,oBACE,IAAA3C,WAAA,CAAA6I,IAAA,EAAChJ,MAAA,WAAK;IACJkH,IAAI,EAAES,MAAO;IACbX,KAAK,EAAEA,KAAM;IACbiC,OAAO,EAAE,SAAAA,QAAA;MAAA,OAAMd,WAAW,CAAC,KAAK,CAAC;IAAA,CAAC;IAClCe,IAAI,EAAC,IAAI;IAAAxE,QAAA,gBAET,IAAAvE,WAAA,CAAAwE,GAAA;MAAIC,KAAK,EAAE;QAAEuE,MAAM,EAAE,CAAC;QAAEpE,OAAO,EAAE;MAAE,CAAE;MAAC,cAAY6C,CAAC,CAACnB,aAAc;MAAA/B,QAAA,EAC/DoC,SAAS,CAACsC,GAAG,CAAC,UAACC,EAAE,EAAEzH,CAAC;QAAA,oBACnB,IAAAzB,WAAA,CAAA6I,IAAA;UAAapE,KAAK,EAAEc,eAAgB;UAAAhB,QAAA,gBAClC,IAAAvE,WAAA,CAAAwE,GAAA;YAAIC,KAAK,EAAEmB,gBAAiB;YAAArB,QAAA,EACzB2E,EAAE,CAACC,IAAI,CAACF,GAAG,CAAC,UAACG,CAAC,EAAEC,CAAC;cAAA,oBAChB,IAAArJ,WAAA,CAAA6I,IAAA,EAACnJ,KAAK,CAAC4J,QAAQ;gBAAA/E,QAAA,gBACb,IAAAvE,WAAA,CAAAwE,GAAA,EAACH,WAAW;kBAAAE,QAAA,EAAE6E;gBAAC,CAAc,CAAC,EAC7BC,CAAC,GAAGH,EAAE,CAACC,IAAI,CAACxG,MAAM,GAAG,CAAC,iBACrB,IAAA3C,WAAA,CAAAwE,GAAA;kBACE,eAAY,MAAM;kBAClBC,KAAK,EAAE;oBACLa,KAAK,EAAE,kBAAkB;oBACzBH,QAAQ,EAAE;kBACZ,CAAE;kBAAAZ,QAAA,EAEDkD,CAAC,CAAClB;gBAAS,CACR,CACP;cAAA,GAZkB8C,CAaL,CAAC;YAAA,CAClB;UAAC,CACA,CAAC,eACL,IAAArJ,WAAA,CAAAwE,GAAA;YAAIC,KAAK,EAAE;cAAEuE,MAAM,EAAE,CAAC;cAAE7D,QAAQ,EAAE;YAAmB,CAAE;YAAAZ,QAAA,EACpD2E,EAAE,CAACK;UAAW,CACb,CAAC;QAAA,GArBG9H,CAsBL,CAAC;MAAA,CACP;IAAC,CACA,CAAC,eACL,IAAAzB,WAAA,CAAA6I,IAAA;MAAKpE,KAAK,EAAEqB,gBAAiB;MAAAvB,QAAA,GAC1BkD,CAAC,CAACrB,aAAa,EAAE,GAAG,eACrB,IAAApG,WAAA,CAAAwE,GAAA,EAACH,WAAW;QAAAE,QAAA,EAAC;MAAC,CAAa,CAAC,EAAC,GAAG,EAC/BkD,CAAC,CAACpB,aAAa;IAAA,CACb,CAAC;EAAA,CACD,CAAC;AAEZ;AAAC,IAAAmD,QAAA,GAAAC,OAAA,cAEcjD,qBAAqB","ignoreList":[]}

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

@@ -0,0 +1,92 @@
+import * as React from "react";
+import FavoriteToggle from "../components/FavoriteToggle";
+import type { RowId } from "../types/common";
+/**
+ * RowFavoriteToggle — Portnet UI v2 (pattern)
+ *
+ * A store-connected follow star for ONE row. Reads `useIsFavorite`, renders
+ * `FavoriteToggle`, and stops its own click/keydown from reaching the row's
+ * `onRowClick`.
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * WHY THIS BELONGS IN THE LIBRARY (capability gap G-36)
+ *
+ * This exact component already existed — as `FavoriteCell`, private inside
+ * `makeFavoriteColumn`. So the follow star was reachable in ONE context only:
+ * as a DataGrid column. Every other place a row appears had to rebuild it.
+ *
+ * The place that always appears is the MOBILE CARD. `DataGrid` swaps to
+ * `renderMobileCard` below its `mobileBreakpoint`, and `MobileRowCard` has a
+ * `leading` slot precisely for a per-row control — but a column definition
+ * cannot be rendered into a slot, so the host had to re-derive the star by
+ * hand. Observed in `onssa-export-fe` as a local `MobileFavoriteToggle`, and
+ * `ms-ti-fe` destructures the identical `MobileRowCard` + `FavoriteToggle` +
+ * `useIsFavorite` trio for the same reason.
+ *
+ * This is the same failure mode G-10 recorded for the card recipe welded
+ * inside `FormSection`: the library owned the behaviour but exposed it at only
+ * one composition point, so consumers reimplemented it at the others. And it
+ * was not a harmless copy — the local twin drifted on the part that matters
+ * least visibly and most to a screen-reader user. It labelled itself
+ * "Ajouter aux favoris" / "Retirer des favoris" while the grid column on the
+ * SAME page said "Suivre" / "Ne plus suivre", and it omitted the status
+ * Tooltip entirely. One list, one control, two accessible names, depending on
+ * viewport width — exactly what R-2.1 forbids.
+ *
+ * `makeFavoriteColumn` now renders this component, so the desktop column and
+ * the mobile card are guaranteed to agree by construction rather than by
+ * review.
+ * ─────────────────────────────────────────────────────────────────────────────
+ *
+ * Usage — mobile card `leading` slot:
+ *
+ *   <MobileRowCard
+ *     leading={
+ *       <RowFavoriteToggle
+ *         resourceKey="ti:list"
+ *         rowId={row.reference}
+ *         rowLabel={row.reference}
+ *       />
+ *     }
+ *     title={row.reference}
+ *     … />
+ *
+ * a11y. The accessible name is ACTION-oriented ("Suivre" / "Ne plus suivre",
+ * optionally enriched with `rowLabel`) because that is the toggle convention;
+ * `aria-pressed` — set by `FavoriteToggle` — carries the state. The visible
+ * status ("Suivi" / "Non suivi") is shown as a Tooltip on hover/focus. An
+ * `aria-label` is therefore ALWAYS supplied, which also stops Tooltip from
+ * mirroring its title onto the trigger and producing a doubled name.
+ *
+ * Requires a <UserPersonalizationProvider> ancestor (`useIsFavorite` throws
+ * otherwise). `rowId` MUST be the same id the grid uses, so the follow and the
+ * row agree.
+ */
+/** `FavoriteToggle`'s own size union, re-derived rather than restated. */
+export type FavoriteToggleSize = NonNullable<React.ComponentProps<typeof FavoriteToggle>["size"]>;
+export interface RowFavoriteToggleLabels {
+    addFavorite: string;
+    removeFavorite: string;
+    statusFollowed: string;
+    statusNotFollowed: string;
+}
+export declare const DEFAULT_ROW_FAVORITE_LABELS: Readonly<{
+    addFavorite: string;
+    removeFavorite: string;
+    statusFollowed: string;
+    statusNotFollowed: string;
+}>;
+export interface RowFavoriteToggleProps {
+    /** Follow namespace — must match the list's other personalization calls. */
+    resourceKey: string;
+    /** Business row id. MUST match the grid's `getRowId` for this row. */
+    rowId: RowId;
+    /** Enriches the per-row accessible name ("Suivre : 2025-IM-0042"). */
+    rowLabel?: string | undefined;
+    /** @default "sm" — fits dense rows and card leading slots. */
+    size?: FavoriteToggleSize | undefined;
+    labels?: Partial<RowFavoriteToggleLabels> | undefined;
+}
+declare function RowFavoriteToggle(props: RowFavoriteToggleProps): React.JSX.Element;
+export default RowFavoriteToggle;
+//# sourceMappingURL=RowFavoriteToggle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RowFavoriteToggle.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/patterns/RowFavoriteToggle.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,cAAc,MAAM,8BAA8B,CAAC;AAG1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AAEH,0EAA0E;AAC1E,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAC1C,KAAK,CAAC,cAAc,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CACpD,CAAC;AAEF,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,2BAA2B;;;;;EAKJ,CAAC;AAErC,MAAM,WAAW,sBAAsB;IACrC,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,KAAK,EAAE,KAAK,CAAC;IACb,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,8DAA8D;IAC9D,IAAI,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACtC,MAAM,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAAG,SAAS,CAAC;CACvD;AAED,iBAAS,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAuC3E;AAED,eAAe,iBAAiB,CAAC"}

package/dist/v2/patterns/RowFavoriteToggle.js

@@ -0,0 +1,127 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = exports.DEFAULT_ROW_FAVORITE_LABELS = void 0;
+var React = _interopRequireWildcard(require("react"));
+var _FavoriteToggle = _interopRequireDefault(require("../components/FavoriteToggle"));
+var _Tooltip = _interopRequireDefault(require("../components/Tooltip"));
+var _favorites = require("../personalization/capabilities/favorites");
+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); } /**
+ * RowFavoriteToggle — Portnet UI v2 (pattern)
+ *
+ * A store-connected follow star for ONE row. Reads `useIsFavorite`, renders
+ * `FavoriteToggle`, and stops its own click/keydown from reaching the row's
+ * `onRowClick`.
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * WHY THIS BELONGS IN THE LIBRARY (capability gap G-36)
+ *
+ * This exact component already existed — as `FavoriteCell`, private inside
+ * `makeFavoriteColumn`. So the follow star was reachable in ONE context only:
+ * as a DataGrid column. Every other place a row appears had to rebuild it.
+ *
+ * The place that always appears is the MOBILE CARD. `DataGrid` swaps to
+ * `renderMobileCard` below its `mobileBreakpoint`, and `MobileRowCard` has a
+ * `leading` slot precisely for a per-row control — but a column definition
+ * cannot be rendered into a slot, so the host had to re-derive the star by
+ * hand. Observed in `onssa-export-fe` as a local `MobileFavoriteToggle`, and
+ * `ms-ti-fe` destructures the identical `MobileRowCard` + `FavoriteToggle` +
+ * `useIsFavorite` trio for the same reason.
+ *
+ * This is the same failure mode G-10 recorded for the card recipe welded
+ * inside `FormSection`: the library owned the behaviour but exposed it at only
+ * one composition point, so consumers reimplemented it at the others. And it
+ * was not a harmless copy — the local twin drifted on the part that matters
+ * least visibly and most to a screen-reader user. It labelled itself
+ * "Ajouter aux favoris" / "Retirer des favoris" while the grid column on the
+ * SAME page said "Suivre" / "Ne plus suivre", and it omitted the status
+ * Tooltip entirely. One list, one control, two accessible names, depending on
+ * viewport width — exactly what R-2.1 forbids.
+ *
+ * `makeFavoriteColumn` now renders this component, so the desktop column and
+ * the mobile card are guaranteed to agree by construction rather than by
+ * review.
+ * ─────────────────────────────────────────────────────────────────────────────
+ *
+ * Usage — mobile card `leading` slot:
+ *
+ *   <MobileRowCard
+ *     leading={
+ *       <RowFavoriteToggle
+ *         resourceKey="ti:list"
+ *         rowId={row.reference}
+ *         rowLabel={row.reference}
+ *       />
+ *     }
+ *     title={row.reference}
+ *     … />
+ *
+ * a11y. The accessible name is ACTION-oriented ("Suivre" / "Ne plus suivre",
+ * optionally enriched with `rowLabel`) because that is the toggle convention;
+ * `aria-pressed` — set by `FavoriteToggle` — carries the state. The visible
+ * status ("Suivi" / "Non suivi") is shown as a Tooltip on hover/focus. An
+ * `aria-label` is therefore ALWAYS supplied, which also stops Tooltip from
+ * mirroring its title onto the trigger and producing a doubled name.
+ *
+ * Requires a <UserPersonalizationProvider> ancestor (`useIsFavorite` throws
+ * otherwise). `rowId` MUST be the same id the grid uses, so the follow and the
+ * row agree.
+ */ /** `FavoriteToggle`'s own size union, re-derived rather than restated. */
+var DEFAULT_ROW_FAVORITE_LABELS = exports.DEFAULT_ROW_FAVORITE_LABELS = Object.freeze({
+  addFavorite: "Suivre",
+  removeFavorite: "Ne plus suivre",
+  statusFollowed: "Suivi",
+  statusNotFollowed: "Non suivi"
+});
+function RowFavoriteToggle(props) {
+  var resourceKey = props.resourceKey,
+    rowId = props.rowId,
+    rowLabel = props.rowLabel,
+    _props$size = props.size,
+    size = _props$size === void 0 ? "sm" : _props$size,
+    labels = props.labels;
+  var L = labels ? _objectSpread(_objectSpread({}, DEFAULT_ROW_FAVORITE_LABELS), labels) : DEFAULT_ROW_FAVORITE_LABELS;
+  var _useIsFavorite = (0, _favorites.useIsFavorite)(resourceKey, rowId),
+    isFavorite = _useIsFavorite.isFavorite,
+    toggle = _useIsFavorite.toggle;
+  var action = isFavorite ? L.removeFavorite : L.addFavorite;
+  var ariaLabel = rowLabel ? action + " : " + rowLabel : action;
+  var statusLabel = isFavorite ? L.statusFollowed : L.statusNotFollowed;
+  var handleChange = function handleChange(_next, e) {
+    // Don't let the toggle's click bubble to the row's onRowClick.
+    if (e && typeof e.stopPropagation === "function") e.stopPropagation();
+    toggle();
+  };
+  var handleKeyDown = function handleKeyDown(e) {
+    // Prevent row-level Enter/Space (onRowClick) from also firing; the
+    // button's own native activation is unaffected.
+    e.stopPropagation();
+  };
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Tooltip["default"], {
+    title: statusLabel,
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_FavoriteToggle["default"], {
+      pressed: isFavorite,
+      onChange: handleChange,
+      onKeyDown: handleKeyDown,
+      size: size,
+      labels: {
+        addFavorite: L.addFavorite,
+        removeFavorite: L.removeFavorite
+      },
+      "aria-label": ariaLabel
+    })
+  });
+}
+var _default = exports["default"] = RowFavoriteToggle;
+//# sourceMappingURL=RowFavoriteToggle.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RowFavoriteToggle.js","names":["React","_interopRequireWildcard","require","_FavoriteToggle","_interopRequireDefault","_Tooltip","_favorites","_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","DEFAULT_ROW_FAVORITE_LABELS","exports","freeze","addFavorite","removeFavorite","statusFollowed","statusNotFollowed","RowFavoriteToggle","props","resourceKey","rowId","rowLabel","_props$size","size","labels","L","_useIsFavorite","useIsFavorite","isFavorite","toggle","action","ariaLabel","statusLabel","handleChange","_next","e","stopPropagation","handleKeyDown","jsx","title","children","pressed","onChange","onKeyDown","_default"],"sources":["../../../src/lib/v2/patterns/RowFavoriteToggle.tsx"],"sourcesContent":["import * as React from \"react\";\r\n\r\nimport FavoriteToggle from \"../components/FavoriteToggle\";\r\nimport Tooltip from \"../components/Tooltip\";\r\nimport { useIsFavorite } from \"../personalization/capabilities/favorites\";\r\nimport type { RowId } from \"../types/common\";\r\n\r\n/**\r\n * RowFavoriteToggle — Portnet UI v2 (pattern)\r\n *\r\n * A store-connected follow star for ONE row. Reads `useIsFavorite`, renders\r\n * `FavoriteToggle`, and stops its own click/keydown from reaching the row's\r\n * `onRowClick`.\r\n *\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n * WHY THIS BELONGS IN THE LIBRARY (capability gap G-36)\r\n *\r\n * This exact component already existed — as `FavoriteCell`, private inside\r\n * `makeFavoriteColumn`. So the follow star was reachable in ONE context only:\r\n * as a DataGrid column. Every other place a row appears had to rebuild it.\r\n *\r\n * The place that always appears is the MOBILE CARD. `DataGrid` swaps to\r\n * `renderMobileCard` below its `mobileBreakpoint`, and `MobileRowCard` has a\r\n * `leading` slot precisely for a per-row control — but a column definition\r\n * cannot be rendered into a slot, so the host had to re-derive the star by\r\n * hand. Observed in `onssa-export-fe` as a local `MobileFavoriteToggle`, and\r\n * `ms-ti-fe` destructures the identical `MobileRowCard` + `FavoriteToggle` +\r\n * `useIsFavorite` trio for the same reason.\r\n *\r\n * This is the same failure mode G-10 recorded for the card recipe welded\r\n * inside `FormSection`: the library owned the behaviour but exposed it at only\r\n * one composition point, so consumers reimplemented it at the others. And it\r\n * was not a harmless copy — the local twin drifted on the part that matters\r\n * least visibly and most to a screen-reader user. It labelled itself\r\n * \"Ajouter aux favoris\" / \"Retirer des favoris\" while the grid column on the\r\n * SAME page said \"Suivre\" / \"Ne plus suivre\", and it omitted the status\r\n * Tooltip entirely. One list, one control, two accessible names, depending on\r\n * viewport width — exactly what R-2.1 forbids.\r\n *\r\n * `makeFavoriteColumn` now renders this component, so the desktop column and\r\n * the mobile card are guaranteed to agree by construction rather than by\r\n * review.\r\n * ─────────────────────────────────────────────────────────────────────────────\r\n *\r\n * Usage — mobile card `leading` slot:\r\n *\r\n *   <MobileRowCard\r\n *     leading={\r\n *       <RowFavoriteToggle\r\n *         resourceKey=\"ti:list\"\r\n *         rowId={row.reference}\r\n *         rowLabel={row.reference}\r\n *       />\r\n *     }\r\n *     title={row.reference}\r\n *     … />\r\n *\r\n * a11y. The accessible name is ACTION-oriented (\"Suivre\" / \"Ne plus suivre\",\r\n * optionally enriched with `rowLabel`) because that is the toggle convention;\r\n * `aria-pressed` — set by `FavoriteToggle` — carries the state. The visible\r\n * status (\"Suivi\" / \"Non suivi\") is shown as a Tooltip on hover/focus. An\r\n * `aria-label` is therefore ALWAYS supplied, which also stops Tooltip from\r\n * mirroring its title onto the trigger and producing a doubled name.\r\n *\r\n * Requires a <UserPersonalizationProvider> ancestor (`useIsFavorite` throws\r\n * otherwise). `rowId` MUST be the same id the grid uses, so the follow and the\r\n * row agree.\r\n */\r\n\r\n/** `FavoriteToggle`'s own size union, re-derived rather than restated. */\r\nexport type FavoriteToggleSize = NonNullable<\r\n  React.ComponentProps<typeof FavoriteToggle>[\"size\"]\r\n>;\r\n\r\nexport interface RowFavoriteToggleLabels {\r\n  addFavorite: string;\r\n  removeFavorite: string;\r\n  statusFollowed: string;\r\n  statusNotFollowed: string;\r\n}\r\n\r\nexport const DEFAULT_ROW_FAVORITE_LABELS = Object.freeze({\r\n  addFavorite: \"Suivre\",\r\n  removeFavorite: \"Ne plus suivre\",\r\n  statusFollowed: \"Suivi\",\r\n  statusNotFollowed: \"Non suivi\",\r\n} satisfies RowFavoriteToggleLabels);\r\n\r\nexport interface RowFavoriteToggleProps {\r\n  /** Follow namespace — must match the list's other personalization calls. */\r\n  resourceKey: string;\r\n  /** Business row id. MUST match the grid's `getRowId` for this row. */\r\n  rowId: RowId;\r\n  /** Enriches the per-row accessible name (\"Suivre : 2025-IM-0042\"). */\r\n  rowLabel?: string | undefined;\r\n  /** @default \"sm\" — fits dense rows and card leading slots. */\r\n  size?: FavoriteToggleSize | undefined;\r\n  labels?: Partial<RowFavoriteToggleLabels> | undefined;\r\n}\r\n\r\nfunction RowFavoriteToggle(props: RowFavoriteToggleProps): React.JSX.Element {\r\n  const { resourceKey, rowId, rowLabel, size = \"sm\", labels } = props;\r\n  const L: RowFavoriteToggleLabels = labels\r\n    ? { ...DEFAULT_ROW_FAVORITE_LABELS, ...labels }\r\n    : DEFAULT_ROW_FAVORITE_LABELS;\r\n\r\n  const { isFavorite, toggle } = useIsFavorite(resourceKey, rowId);\r\n\r\n  const action = isFavorite ? L.removeFavorite : L.addFavorite;\r\n  const ariaLabel = rowLabel ? action + \" : \" + rowLabel : action;\r\n  const statusLabel = isFavorite ? L.statusFollowed : L.statusNotFollowed;\r\n\r\n  const handleChange: NonNullable<\r\n    React.ComponentProps<typeof FavoriteToggle>[\"onChange\"]\r\n  > = function handleChange(_next, e) {\r\n    // Don't let the toggle's click bubble to the row's onRowClick.\r\n    if (e && typeof e.stopPropagation === \"function\") e.stopPropagation();\r\n    toggle();\r\n  };\r\n  const handleKeyDown: NonNullable<\r\n    React.ComponentProps<typeof FavoriteToggle>[\"onKeyDown\"]\r\n  > = function handleKeyDown(e) {\r\n    // Prevent row-level Enter/Space (onRowClick) from also firing; the\r\n    // button's own native activation is unaffected.\r\n    e.stopPropagation();\r\n  };\r\n\r\n  return (\r\n    <Tooltip title={statusLabel}>\r\n      <FavoriteToggle\r\n        pressed={isFavorite}\r\n        onChange={handleChange}\r\n        onKeyDown={handleKeyDown}\r\n        size={size}\r\n        labels={{ addFavorite: L.addFavorite, removeFavorite: L.removeFavorite }}\r\n        aria-label={ariaLabel}\r\n      />\r\n    </Tooltip>\r\n  );\r\n}\r\n\r\nexport default RowFavoriteToggle;\r\n"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,44 @@
+/**
+ * _pickerSerialisation — lecture / ecriture partagees des ponts Formik de date.
+ *
+ * ── POURQUOI CE MODULE EXISTE ────────────────────────────────────────
+ *
+ * `FormikDatePicker` portait ces deux fonctions en prive. L'arrivee d'un
+ * SECOND pont (`FormikDateTimePicker`, gap G-E) posait le choix : les recopier,
+ * ou les partager.
+ *
+ * Les recopier aurait reproduit exactement la situation que la note S-03 de
+ * `FormikDatePicker` raconte. Rappel de ce qu'elle dit : ce pont serialisait
+ * VERS moment mais relisait DEPUIS `new Date(raw)`, en ignorant
+ * `outputFormat`. L'asymetrie corrompait silencieusement tout format non ISO —
+ * `new Date("31-12-2026")` donne Invalid Date, `new Date("05-03-2026")` donne
+ * le 3 mai au lieu du 5 mars. Le chemin d'ECRITURE fonctionnait, donc un
+ * formulaire rempli puis soumis se comportait correctement : le degat
+ * n'apparaissait qu'a la RELECTURE, c'est-a-dire en modification. Un module a
+ * livre ce defaut pendant sept lots sous un typecheck strict.
+ *
+ * Une asymetrie de ce genre entre DEUX ponts serait encore moins visible : ils
+ * se ressemblent, personne ne les compare, et chacun a l'air correct
+ * isolement. La seule garantie est qu'il n'y ait qu'un exemplaire du couple
+ * lecture / ecriture.
+ *
+ * Module INTERNE : non exporte par la surface publique (prefixe `_`).
+ */
+/**
+ * Relit une valeur stockee par Formik vers un `Date`.
+ *
+ * `outputFormat` est passe pour que la lecture soit SYMETRIQUE de
+ * `serialiseDate` : on parse avec le format qui a servi a ecrire, en mode
+ * STRICT. Une valeur stockee qui ne correspond pas rend `null` plutot que la
+ * meilleure approximation de moment — une date absente est recuperable, une
+ * date fausse de deux mois ne l'est pas.
+ */
+export declare const coerceToDate: (raw: unknown, outputFormat?: string) => Date | null;
+/**
+ * Serialise un `Date` vers le format demande.
+ *   undefined  -> rend le `Date` tel quel (defaut, compatible)
+ *   "iso"      -> `Date.toISOString()`
+ *   toute autre chaine -> `moment(date).format(outputFormat)`
+ */
+export declare function serialiseDate(date: Date | null, outputFormat: string | undefined): Date | string | null;
+//# sourceMappingURL=_pickerSerialisation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_pickerSerialisation.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/patterns/_pickerSerialisation.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,GACvB,KAAK,OAAO,EACZ,eAAe,MAAM,KACpB,IAAI,GAAG,IAwBT,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,IAAI,GAAG,IAAI,EACjB,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,IAAI,GAAG,MAAM,GAAG,IAAI,CAOtB"}

package/dist/v2/patterns/_pickerSerialisation.js

@@ -0,0 +1,81 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.coerceToDate = void 0;
+exports.serialiseDate = serialiseDate;
+var _moment = _interopRequireDefault(require("moment"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+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); }
+/**
+ * _pickerSerialisation — lecture / ecriture partagees des ponts Formik de date.
+ *
+ * ── POURQUOI CE MODULE EXISTE ────────────────────────────────────────
+ *
+ * `FormikDatePicker` portait ces deux fonctions en prive. L'arrivee d'un
+ * SECOND pont (`FormikDateTimePicker`, gap G-E) posait le choix : les recopier,
+ * ou les partager.
+ *
+ * Les recopier aurait reproduit exactement la situation que la note S-03 de
+ * `FormikDatePicker` raconte. Rappel de ce qu'elle dit : ce pont serialisait
+ * VERS moment mais relisait DEPUIS `new Date(raw)`, en ignorant
+ * `outputFormat`. L'asymetrie corrompait silencieusement tout format non ISO —
+ * `new Date("31-12-2026")` donne Invalid Date, `new Date("05-03-2026")` donne
+ * le 3 mai au lieu du 5 mars. Le chemin d'ECRITURE fonctionnait, donc un
+ * formulaire rempli puis soumis se comportait correctement : le degat
+ * n'apparaissait qu'a la RELECTURE, c'est-a-dire en modification. Un module a
+ * livre ce defaut pendant sept lots sous un typecheck strict.
+ *
+ * Une asymetrie de ce genre entre DEUX ponts serait encore moins visible : ils
+ * se ressemblent, personne ne les compare, et chacun a l'air correct
+ * isolement. La seule garantie est qu'il n'y ait qu'un exemplaire du couple
+ * lecture / ecriture.
+ *
+ * Module INTERNE : non exporte par la surface publique (prefixe `_`).
+ */
+
+/**
+ * Relit une valeur stockee par Formik vers un `Date`.
+ *
+ * `outputFormat` est passe pour que la lecture soit SYMETRIQUE de
+ * `serialiseDate` : on parse avec le format qui a servi a ecrire, en mode
+ * STRICT. Une valeur stockee qui ne correspond pas rend `null` plutot que la
+ * meilleure approximation de moment — une date absente est recuperable, une
+ * date fausse de deux mois ne l'est pas.
+ */
+var coerceToDate = exports.coerceToDate = function coerceToDate(raw, outputFormat) {
+  if (raw == null || raw === "") return null;
+  if (raw instanceof Date) return raw;
+  if (_typeof(raw) === "object" && typeof raw.toDate === "function") {
+    var _d$getTime;
+    var _d = raw.toDate();
+    return isNaN(_d === null || _d === void 0 ? void 0 : (_d$getTime = _d.getTime) === null || _d$getTime === void 0 ? void 0 : _d$getTime.call(_d)) ? null : _d;
+  }
+  /* Garde sur `typeof raw === "string"` : un horodatage numerique garde le
+   * chemin `new Date(number)`, `moment(number, format)` n'ayant pas de sens.
+   * "iso" est exclu : ce n'est pas un jeton moment, et `new Date(isoString)`
+   * est deja correct. */
+  if (typeof raw === "string" && outputFormat !== undefined && outputFormat !== "iso") {
+    var parsed = (0, _moment["default"])(raw, outputFormat, true);
+    return parsed.isValid() ? parsed.toDate() : null;
+  }
+  var d = new Date(raw);
+  return isNaN(d.getTime()) ? null : d;
+};
+
+/**
+ * Serialise un `Date` vers le format demande.
+ *   undefined  -> rend le `Date` tel quel (defaut, compatible)
+ *   "iso"      -> `Date.toISOString()`
+ *   toute autre chaine -> `moment(date).format(outputFormat)`
+ */
+function serialiseDate(date, outputFormat) {
+  if (!date || !(date instanceof Date) || isNaN(date.getTime())) {
+    return outputFormat ? "" : null;
+  }
+  if (!outputFormat) return date;
+  if (outputFormat === "iso") return date.toISOString();
+  return (0, _moment["default"])(date).format(outputFormat);
+}
+//# sourceMappingURL=_pickerSerialisation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_pickerSerialisation.js","names":["_moment","_interopRequireDefault","require","obj","__esModule","_typeof","Symbol","iterator","constructor","prototype","coerceToDate","exports","raw","outputFormat","Date","toDate","_d$getTime","d","isNaN","getTime","call","undefined","parsed","moment","isValid","serialiseDate","date","toISOString","format"],"sources":["../../../src/lib/v2/patterns/_pickerSerialisation.ts"],"sourcesContent":["import moment from \"moment\";\r\n\r\n/**\r\n * _pickerSerialisation — lecture / ecriture partagees des ponts Formik de date.\r\n *\r\n * ── POURQUOI CE MODULE EXISTE ────────────────────────────────────────\r\n *\r\n * `FormikDatePicker` portait ces deux fonctions en prive. L'arrivee d'un\r\n * SECOND pont (`FormikDateTimePicker`, gap G-E) posait le choix : les recopier,\r\n * ou les partager.\r\n *\r\n * Les recopier aurait reproduit exactement la situation que la note S-03 de\r\n * `FormikDatePicker` raconte. Rappel de ce qu'elle dit : ce pont serialisait\r\n * VERS moment mais relisait DEPUIS `new Date(raw)`, en ignorant\r\n * `outputFormat`. L'asymetrie corrompait silencieusement tout format non ISO —\r\n * `new Date(\"31-12-2026\")` donne Invalid Date, `new Date(\"05-03-2026\")` donne\r\n * le 3 mai au lieu du 5 mars. Le chemin d'ECRITURE fonctionnait, donc un\r\n * formulaire rempli puis soumis se comportait correctement : le degat\r\n * n'apparaissait qu'a la RELECTURE, c'est-a-dire en modification. Un module a\r\n * livre ce defaut pendant sept lots sous un typecheck strict.\r\n *\r\n * Une asymetrie de ce genre entre DEUX ponts serait encore moins visible : ils\r\n * se ressemblent, personne ne les compare, et chacun a l'air correct\r\n * isolement. La seule garantie est qu'il n'y ait qu'un exemplaire du couple\r\n * lecture / ecriture.\r\n *\r\n * Module INTERNE : non exporte par la surface publique (prefixe `_`).\r\n */\r\n\r\n/**\r\n * Relit une valeur stockee par Formik vers un `Date`.\r\n *\r\n * `outputFormat` est passe pour que la lecture soit SYMETRIQUE de\r\n * `serialiseDate` : on parse avec le format qui a servi a ecrire, en mode\r\n * STRICT. Une valeur stockee qui ne correspond pas rend `null` plutot que la\r\n * meilleure approximation de moment — une date absente est recuperable, une\r\n * date fausse de deux mois ne l'est pas.\r\n */\r\nexport const coerceToDate = (\r\n  raw: unknown,\r\n  outputFormat?: string\r\n): Date | null => {\r\n  if (raw == null || raw === \"\") return null;\r\n  if (raw instanceof Date) return raw;\r\n  if (\r\n    typeof raw === \"object\" &&\r\n    typeof (raw as { toDate?: () => Date }).toDate === \"function\"\r\n  ) {\r\n    const d = (raw as { toDate: () => Date }).toDate();\r\n    return isNaN(d?.getTime?.()) ? null : d;\r\n  }\r\n  /* Garde sur `typeof raw === \"string\"` : un horodatage numerique garde le\r\n   * chemin `new Date(number)`, `moment(number, format)` n'ayant pas de sens.\r\n   * \"iso\" est exclu : ce n'est pas un jeton moment, et `new Date(isoString)`\r\n   * est deja correct. */\r\n  if (\r\n    typeof raw === \"string\" &&\r\n    outputFormat !== undefined &&\r\n    outputFormat !== \"iso\"\r\n  ) {\r\n    const parsed = moment(raw, outputFormat, true);\r\n    return parsed.isValid() ? parsed.toDate() : null;\r\n  }\r\n  const d = new Date(raw as string | number);\r\n  return isNaN(d.getTime()) ? null : d;\r\n};\r\n\r\n/**\r\n * Serialise un `Date` vers le format demande.\r\n *   undefined  -> rend le `Date` tel quel (defaut, compatible)\r\n *   \"iso\"      -> `Date.toISOString()`\r\n *   toute autre chaine -> `moment(date).format(outputFormat)`\r\n */\r\nexport function serialiseDate(\r\n  date: Date | null,\r\n  outputFormat: string | undefined\r\n): Date | string | null {\r\n  if (!date || !(date instanceof Date) || isNaN(date.getTime())) {\r\n    return outputFormat ? \"\" : null;\r\n  }\r\n  if (!outputFormat) return date;\r\n  if (outputFormat === \"iso\") return date.toISOString();\r\n  return moment(date).format(outputFormat);\r\n}\r\n"],"mappings":";;;;;;;AAAA,IAAAA,OAAA,GAAAC,sBAAA,CAAAC,OAAA;AAA4B,SAAAD,uBAAAE,GAAA,WAAAA,GAAA,IAAAA,GAAA,CAAAC,UAAA,GAAAD,GAAA,gBAAAA,GAAA;AAAA,SAAAE,QAAAF,GAAA,sCAAAE,OAAA,wBAAAC,MAAA,uBAAAA,MAAA,CAAAC,QAAA,aAAAJ,GAAA,kBAAAA,GAAA,gBAAAA,GAAA,WAAAA,GAAA,yBAAAG,MAAA,IAAAH,GAAA,CAAAK,WAAA,KAAAF,MAAA,IAAAH,GAAA,KAAAG,MAAA,CAAAG,SAAA,qBAAAN,GAAA,KAAAE,OAAA,CAAAF,GAAA;AAE5B;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;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,IAAMO,YAAY,GAAAC,OAAA,CAAAD,YAAA,GAAG,SAAfA,YAAYA,CACvBE,GAAY,EACZC,YAAqB,EACL;EAChB,IAAID,GAAG,IAAI,IAAI,IAAIA,GAAG,KAAK,EAAE,EAAE,OAAO,IAAI;EAC1C,IAAIA,GAAG,YAAYE,IAAI,EAAE,OAAOF,GAAG;EACnC,IACEP,OAAA,CAAOO,GAAG,MAAK,QAAQ,IACvB,OAAQA,GAAG,CAA6BG,MAAM,KAAK,UAAU,EAC7D;IAAA,IAAAC,UAAA;IACA,IAAMC,EAAC,GAAIL,GAAG,CAA4BG,MAAM,CAAC,CAAC;IAClD,OAAOG,KAAK,CAACD,EAAC,aAADA,EAAC,wBAAAD,UAAA,GAADC,EAAC,CAAEE,OAAO,cAAAH,UAAA,uBAAVA,UAAA,CAAAI,IAAA,CAAAH,EAAa,CAAC,CAAC,GAAG,IAAI,GAAGA,EAAC;EACzC;EACA;AACF;AACA;AACA;EACE,IACE,OAAOL,GAAG,KAAK,QAAQ,IACvBC,YAAY,KAAKQ,SAAS,IAC1BR,YAAY,KAAK,KAAK,EACtB;IACA,IAAMS,MAAM,GAAG,IAAAC,kBAAM,EAACX,GAAG,EAAEC,YAAY,EAAE,IAAI,CAAC;IAC9C,OAAOS,MAAM,CAACE,OAAO,CAAC,CAAC,GAAGF,MAAM,CAACP,MAAM,CAAC,CAAC,GAAG,IAAI;EAClD;EACA,IAAME,CAAC,GAAG,IAAIH,IAAI,CAACF,GAAsB,CAAC;EAC1C,OAAOM,KAAK,CAACD,CAAC,CAACE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,GAAGF,CAAC;AACtC,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACO,SAASQ,aAAaA,CAC3BC,IAAiB,EACjBb,YAAgC,EACV;EACtB,IAAI,CAACa,IAAI,IAAI,EAAEA,IAAI,YAAYZ,IAAI,CAAC,IAAII,KAAK,CAACQ,IAAI,CAACP,OAAO,CAAC,CAAC,CAAC,EAAE;IAC7D,OAAON,YAAY,GAAG,EAAE,GAAG,IAAI;EACjC;EACA,IAAI,CAACA,YAAY,EAAE,OAAOa,IAAI;EAC9B,IAAIb,YAAY,KAAK,KAAK,EAAE,OAAOa,IAAI,CAACC,WAAW,CAAC,CAAC;EACrD,OAAO,IAAAJ,kBAAM,EAACG,IAAI,CAAC,CAACE,MAAM,CAACf,YAAY,CAAC;AAC1C","ignoreList":[]}