@splunk/react-ui 4.34.0 → 4.36.0

package/List.js

@@ -62,7 +62,7 @@
     // EXPORTS
         e.d(t, {
         Item: () => /* reexport */ v,
-        default: () => /* reexport */ P
+        default: () => /* reexport */ S
     });
     // CONCATENATED MODULE: external "react"
     const r = require("react");
@@ -194,26 +194,22 @@
         ordered: i().bool,
         type: i().oneOf([ "disc", "decimal", "lower-alpha", "upper-alpha" ])
     };
-    var j = {
-        type: "disc"
-    };
-    function S(e) {
-        var t = e.children, r = e.elementRef, o = e.type, i = e.ordered, l = O(e, [ "children", "elementRef", "type", "ordered" ]);
+    function j(e) {
+        var t = e.children, r = e.elementRef, o = e.type, i = o === void 0 ? "disc" : o, l = e.ordered, a = O(e, [ "children", "elementRef", "type", "ordered" ]);
         // @docs-props-type ListPropsBase
         // Default prop value is "disc", we cannot determine if user or defaultProps is setting the value
                 if (false) {}
         
         return n().createElement(f, b({
-            as: i || o !== "disc" ? "ol" : "ul",
+            as: l || i !== "disc" ? "ol" : "ul",
             "data-test": "list",
             ref: r,
-            $listStyleType: i ? "decimal" : o
-        }, l), t);
+            $listStyleType: l ? "decimal" : i
+        }, a), t);
     }
-    S.propTypes = g;
-    S.defaultProps = j;
-    S.Item = v;
-    /* harmony default export */    const P = S;
+    j.propTypes = g;
+    j.Item = v;
+    /* harmony default export */    const S = j;
     // CONCATENATED MODULE: ./src/List/index.ts
     module.exports = t;
     /******/})();

package/MIGRATION.mdx

@@ -5,6 +5,30 @@ import Table from '@splunk/react-ui/Table';
 
 This document lists migration guidance for new features and breaking changes.
 
+## 4.35.0
+
+### Deprecated `Menu`'s `retainFocus` prop
+
+#### Change
+
+`Menu`'s `retainFocus` prop is deprecated and will be removed in the next major version.
+
+#### Context
+
+To provide more control over the focus behavior of `Menu`, including the option to opt out of focus management, a new `focusMode` prop has been introduced with the following values:
+- `never`: The menu will never take focus, and the active menu item will not have a focus-like appearance.
+- `normal`: Opts out of focus management. The menu and its children follow the normal focus order of DOM without any interference (no loop, no arrow keys, multiple tab stops).
+- `roving` (original `retainFocus={false}`): Does not retain focus inside the menu. There is one tab stop of menu. Uses up/down arrow keys to navigate and loop inside the menu.
+
+The original `retainFocus={true}` is no longer supported due to its poor user experience and accessibility issues:
+* If the Menu is used standalone, it traps the tab navigation within the Menu, preventing the user from accessing the next element via keyboard navigation.
+* If the Menu is used in a `Dropdown`, it creates multiple tab stops, making navigation inefficient.
+
+#### Migration steps
+
+* Replace `retainFocus={false}` with `focusMode="roving"`.
+* If `retainFocus={true}` was used, replace it with `focusMode="roving"`. Additionally, convert the corresponding tests with multiple tabs to use arrow key navigation.
+
 ## 4.34.0
 
 ### Deprecated `Select`'s `appearance` values of `"flat"`, `"pill"`, and `"toggle"`
@@ -624,3 +648,20 @@ With the new `Search` component optimized for user interaction, Text's `appearan
 #### Migration steps
 
 Replace all usage of `Text`'s `appearance="search"` value with the `Search` component. Remove all usage of `Text`'s `appearance="default"` value. 
+
+## 4.36.0
+
+### Deprecated `ComboBox`, `ControlGroup`, and `StaticContent`'s `size` prop
+
+#### Change
+
+`ComboBox`, `ControlGroup`, and `StaticContent`'s `size` prop has been deprecated and will be removed in the next major version.
+
+#### Context
+
+The `size` prop currently does not do anything in `ComboBox`, `ControlGroup`, or `StaticContent`, so it will be removed in the next major version.
+
+#### Migration steps
+
+Remove all usage of `ComboBox`, `ControlGroup`, and `StaticContent`'s `size` prop. To change the size of components, use the `SplunkThemeProvider`'s `density` prop. 
+