@splunk/react-ui 5.7.1 → 5.9.0

package/Number.js

@@ -607,7 +607,8 @@
             onClick: he
         }, Se),  t().createElement(T, null)),  t().createElement(q, {
             $disabled: l,
-            $error: s
+            $error: s,
+            decorative: true
         }),  t().createElement(E, G({
             "aria-label": (0, f._)("Decrement"),
             "data-test": "decrement",

package/Paginator.js

@@ -500,8 +500,8 @@
         }), [ d ]);
         // Can't show more links than total number of pages.
                 var h = Math.min(g, v);
-        var P = Math.ceil(h / 2);
-        var O = Math.ceil(v - h / 2);
+        var P = h;
+        var O = v - h + 1;
         var C = [];
         if (v <= 1) {
             return null;
@@ -512,20 +512,22 @@
    * firstPageNearbyCurrent and lastPageNearbyCurrent refer to the page number of the first and last of these buttons.
    */        var w;
         var k;
-        if (u <= P + 1) {
-            // + 1 to avoid ellipsis between 1 and 2
+        if (u < P) {
             w = 1;
-            k = w + Math.min(v, h) - 1;
-        } else if (u > P && u < O) {
-            k = Math.ceil(u + (h - 2) / 2);
-            w = k - h + 2;
+            k = h;
+        } else if (u >= P && u <= O) {
+            w = u - Math.floor((h - 2) / 2);
+            k = u + 1 === v ? v : u + Math.ceil((h - 2) / 2);
         } else {
-            // include page #1 to avoid ellipsis between 1 and 2
-            w = v - h === 1 ? 1 : v - h + 1;
+            w = O;
             k = v;
         }
         // bump up the last page to avoid ellipsis
                 k = t && k + 1 === v ? v : k;
+        // check to avoid ellipsis between 1 and 2
+                if (w === 2) {
+            w = 1;
+        }
         var E = u - 1;
         C.push( r().createElement(S, ne({}, l === null || l === void 0 ? void 0 : l({
             page: E
@@ -537,7 +539,7 @@
             onClick: y,
             page: E
         }),  r().createElement(i(), null), (0, p._)("Prev")));
-        if (u > P && v > h && w !== 1) {
+        if (u >= P && v > h && w !== 1) {
             var _ = 1;
             C.push( r().createElement(S, ne({}, l === null || l === void 0 ? void 0 : l({
                 page: _
@@ -567,7 +569,7 @@
                 page: x
             }), String(x)));
         }
-        if (u <= O && v > h && k !== v) {
+        if (v > h && k !== v) {
             C.push( r().createElement(ee, {
                 "data-test": "page",
                 key: "nextEllipsis"

package/Popover.js

@@ -422,6 +422,8 @@
                 w = f - r.left;
             }
         }
+        // SUI-8136: Set container width as min-width if it fits within viewport, otherwise allow it to shrink to fit
+                var R = (S === "above" || S === "below") && i.offsetWidth <= w ? i.offsetWidth : 0;
         return {
             placement: S,
             maxHeight: P,
@@ -429,7 +431,8 @@
             outerContainerStyle: {
                 top: b,
                 left: g,
-                bottom: y
+                bottom: y,
+                minWidth: R
             }
         };
     }

package/README.md

@@ -128,3 +128,14 @@ Further reading:
 * [styled-components and SC_ATTR](https://styled-components.com/docs/advanced#avoiding-conflicts-with-thirdparty-styles-and-scripts)
 * [styled-components "several instances" warning](https://styled-components.com/docs/faqs#why-am-i-getting-a-warning-about-several-instances-of-module-on-the-page)
 * [Duplicate React](https://reactjs.org/warnings/invalid-hook-call-warning.html#duplicate-react)
+
+
+## LLM Documentation
+
+This package includes AI-optimized documentation in the `docs-llm/` directory for use with AI assistants and tools like MCP  servers. These markdown files provide comprehensive component documentation suitable for LLM consumption.
+
+- **Location:** `node_modules/@splunk/react-ui/docs-llm/`
+- **Contents:** Component documentation, usage examples, API reference, accessibility guidelines
+- **Format:** Markdown files optimized for AI/LLM processing
+
+The LLM documentation mirrors the standard documentation but is formatted specifically for machine consumption, enabling AI assistants to provide accurate guidance on component usage, props, and best practices.

package/RadioBar.js

@@ -492,7 +492,7 @@
             flex: true,
             $disabled: W,
             $error: b,
-            elementRef: s,
+            ref: s,
             "data-test": "radio-bar",
             "data-test-value": A,
             "data-test-disabled": W ? "disabled" : undefined,

package/Search.js

@@ -63,7 +63,7 @@
         e.d(n, {
         Divider: () => /* reexport */ p.Divider,
         Heading: () => /* reexport */ p.Heading,
-        Option: () => /* reexport */ D,
+        Option: () => /* reexport */ x,
         default: () => /* reexport */ ie
     });
     // CONCATENATED MODULE: external "react"
@@ -101,9 +101,9 @@
     // CONCATENATED MODULE: external "@splunk/ui-utils/i18n"
     const C = require("@splunk/ui-utils/i18n");
     // CONCATENATED MODULE: external "@splunk/ui-utils/id"
-    const j = require("@splunk/ui-utils/id");
+    const k = require("@splunk/ui-utils/id");
     // CONCATENATED MODULE: external "@splunk/ui-utils/keyboard"
-    const k = require("@splunk/ui-utils/keyboard");
+    const j = require("@splunk/ui-utils/keyboard");
     // CONCATENATED MODULE: external "@splunk/ui-utils/scroll"
     const P = require("@splunk/ui-utils/scroll");
     // CONCATENATED MODULE: ./src/utils/updateReactRef.ts
@@ -113,7 +113,7 @@
  * @param ref - The React callback or object ref. Can be `null` or `undefined`.
  * @param current - The new value of the ref.
  */
-    function I(e, n) {
+    function R(e, n) {
         if (e) {
             if (typeof e === "function") {
                 e(n);
@@ -126,8 +126,8 @@
         }
     }
     // CONCATENATED MODULE: ./src/Search/Option.tsx
-    function R() {
-        return R = Object.assign ? Object.assign.bind() : function(e) {
+    function I() {
+        return I = Object.assign ? Object.assign.bind() : function(e) {
             for (var n = 1; n < arguments.length; n++) {
                 var r = arguments[n];
                 for (var t in r) {
@@ -135,7 +135,7 @@
                 }
             }
             return e;
-        }, R.apply(null, arguments);
+        }, I.apply(null, arguments);
     }
     function M(e, n) {
         if (null == e) return {};
@@ -181,7 +181,7 @@
     };
     /**
  * An option within a `Search`.
- */    function x(e) {
+ */    function D(e) {
         var n = e.active, o = e.description, a = e.descriptionPosition, i = a === void 0 ? "bottom" : a, l = e.disabled, u = e.elementRef, c = e.endAdornment, s = e.label, d = e.matchRanges, f = e.onClick, v = e.openInNewContext, b = e.startAdornment, m = e.to, y = e.truncate, g = e.value, h = M(e, [ "active", "description", "descriptionPosition", "disabled", "elementRef", "endAdornment", "label", "matchRanges", "onClick", "openInNewContext", "startAdornment", "to", "truncate", "value" ]);
         // @docs-props-type OptionPropsBase
                 var O = (0, r.useCallback)((function(e) {
@@ -193,11 +193,11 @@
             }
         }), [ l, f, m, g ]);
         var S = (0, r.useCallback)((function(e) {
-            I(u, e);
+            R(u, e);
         }), [ u ]);
         var w = s === undefined ? g : s;
         
-        return t().createElement(p.Item, R({
+        return t().createElement(p.Item, I({
             active: n,
             "data-test": "search-option",
             "data-test-value": g,
@@ -216,9 +216,9 @@
             role: "option"
         }), w);
     }
-    x.propTypes = q;
-    x.as = "Item";
-    /* harmony default export */    const D = x;
+    D.propTypes = q;
+    D.as = "Item";
+    /* harmony default export */    const x = D;
     // CONCATENATED MODULE: external "styled-components"
     const E = require("styled-components");
     var B =  e.n(E);
@@ -413,7 +413,7 @@
     }));
     var oe = (0, C._)("Search");
     function ae(e) {
-        var n = e.animateLoading, o = n === void 0 ? false : n, a = e.append, i = e.children, l = e.defaultPlacement, u = e.defaultValue, s = e.describedBy, f = e.disabled, v = f === void 0 ? false : f, p = e.elementRef, b = e.error, y = b === void 0 ? false : b, h = e.footerMessage, S = e.inline, R = S === void 0 ? false : S, M = e.inputRef, A = e.isLoadingOptions, q = A === void 0 ? false : A, x = e.labelledBy, D = e.loadingMessage, E = e.menuStyle, B = E === void 0 ? {} : E, T = e.name, H = e.noOptionsMessage, L = e.onChange, N = e.onClose, K = e.onFocus, W = e.onKeyDown, U = e.onOpen, $ = e.placeholder, X = $ === void 0 ? (0, 
+        var n = e.animateLoading, o = n === void 0 ? false : n, a = e.append, i = e.children, l = e.defaultPlacement, u = e.defaultValue, s = e.describedBy, f = e.disabled, v = f === void 0 ? false : f, p = e.elementRef, b = e.error, y = b === void 0 ? false : b, h = e.footerMessage, S = e.inline, I = S === void 0 ? false : S, M = e.inputRef, A = e.isLoadingOptions, q = A === void 0 ? false : A, D = e.labelledBy, x = e.loadingMessage, E = e.menuStyle, B = E === void 0 ? {} : E, T = e.name, H = e.noOptionsMessage, L = e.onChange, N = e.onClose, K = e.onFocus, W = e.onKeyDown, U = e.onOpen, $ = e.placeholder, X = $ === void 0 ? (0, 
         C._)("Search...") : $, Y = e.prepend, G = e.value, J = Z(e, [ "animateLoading", "append", "children", "defaultPlacement", "defaultValue", "describedBy", "disabled", "elementRef", "error", "footerMessage", "inline", "inputRef", "isLoadingOptions", "labelledBy", "loadingMessage", "menuStyle", "name", "noOptionsMessage", "onChange", "onClose", "onFocus", "onKeyDown", "onOpen", "placeholder", "prepend", "value" ]);
         // @docs-props-type SearchPropsBase
                 var Q = !!i || q;
@@ -424,33 +424,34 @@
         var be = (0, r.useState)(u || ""), me = z(be, 2), ye = me[0], ge = me[1];
         var he = (0, r.useState)((function() {
             return {
-                popoverId: (0, j.createDOMID)("popover"),
-                menuId: (0, j.createDOMID)("menu"),
-                activeItemId: (0, j.createDOMID)("active-item")
+                popoverId: (0, k.createDOMID)("popover"),
+                menuId: (0, k.createDOMID)("menu"),
+                activeItemId: (0, k.createDOMID)("active-item")
             };
-        })), Oe = z(he, 1), Se = Oe[0], we = Se.popoverId, Ce = Se.menuId, je = Se.activeItemId;
+        })), Oe = z(he, 1), Se = Oe[0], we = Se.popoverId, Ce = Se.menuId, ke = Se.activeItemId;
  // previous state
-                var ke = w()(ae);
+                var je = w()(ae);
         // refs
                 var Pe = (0, r.useRef)(null);
-        var Ie = (0, r.useRef)(null);
-        var Re = (0, r.useRef)(G !== undefined && G !== null);
+        var Re = (0, r.useRef)(null);
+        var Ie = (0, r.useRef)(G !== undefined && G !== null);
         var Me = (0, r.useRef)([]);
-        var Ae = (0, r.useRef)(ke);
-        var qe = (0, r.useRef)(undefined);
+        var Ae = (0, r.useRef)(je);
+        var qe = (0, r.useRef)(0);
+        var De = (0, r.useRef)(undefined);
         var xe = function e(n) {
-            I(Pe, n);
-            I(p, n);
+            R(Pe, n);
+            R(p, n);
         };
-        var De = function e(n) {
-            I(Ie, n);
-            I(M, n);
-        };
-        var Ee = function e() {
-            return Re.current ? G : ye;
+        var Ee = function e(n) {
+            R(Re, n);
+            R(M, n);
         };
         var Be = function e() {
-            var n = Ee();
+            return Ie.current ? G : ye;
+        };
+        var Te = function e() {
+            var n = Be();
             var t = r.Children.toArray(i).filter(r.isValidElement);
             var o = !ve && t.find((function(e) {
                 return e.props.label !== undefined && e.props.value === n;
@@ -460,27 +461,27 @@
             }
             return n;
         };
-        var Te = function e() {
+        var He = function e() {
             se(true);
             ie(-1);
             U === null || U === void 0 ? void 0 : U();
         };
-        var He = function e() {
+        var Le = function e() {
             se(false);
             Ae.current = null;
             N === null || N === void 0 ? void 0 : N();
         };
-        var Le = function e() {
+        var _e = function e() {
             var n;
-            (n = Ie.current) === null || n === void 0 ? void 0 : n.focus();
+            (n = Re.current) === null || n === void 0 ? void 0 : n.focus();
         };
-        var _e = function e(n, r) {
-            Te();
+        var Ne = function e(n, r) {
+            He();
             K === null || K === void 0 ? void 0 : K(n, r);
         };
-        var Ne = function e(n, r) {
+        var Ve = function e(n, r) {
             var t = r.value;
-            if (!Re.current) {
+            if (!Ie.current) {
                 ge(t);
             }
             ie(-1);
@@ -490,102 +491,117 @@
                 name: T
             });
         };
-        var Ve = function e(n, r) {
-            Ne(n, F({}, r));
+        var Ke = function e(n, r) {
+            Ve(n, F({}, r));
+            _e();
             Le();
-            He();
         };
-        var Ke = function e(n) {
-            var r = Me.current.length;
+        var Fe = function e(n) {
+            var r = qe.current;
             var t = n.key;
             if (ce) {
                 switch (t) {
                   case "Enter":
                     {
                         var o;
+                        n.preventDefault();
                         // triggering onClick so that links can be activated with the keyboard
                         // since the menu items themselves never receive focus
                         // this will implicitly call handleSelectOption()
-                                                (o = document.getElementById(je)) === null || o === void 0 ? void 0 : o.click();
+                                                (o = document.getElementById(ke)) === null || o === void 0 ? void 0 : o.click();
                         break;
                     }
 
                   case "Tab":
-                    He();
+                    Le();
                     break;
 
                   case "ArrowDown":
-                    ie(Math.min(ae + 1, r - 1));
+                    if (r <= 0) {
+                        break;
+                    }
+                    ie((function(e) {
+                        return Math.min(e + 1, r - 1);
+                    }));
                     break;
 
                   case "ArrowUp":
-                    ie(Math.max(ae - 1, 0));
+                    if (r <= 0) {
+                        break;
+                    }
+                    ie((function(e) {
+                        return Math.max(e - 1, 0);
+                    }));
                     break;
 
                   default:
  // do nothing
                                 }
-            } else if ((0, k.addsCharacter)(n.nativeEvent) !== false || 
+            } else if ((0, j.addsCharacter)(n.nativeEvent) !== false || 
             // Safari 9.0 returns undefined
             t === "Enter" || t === "Backspace" || t === "ArrowDown" || t === "ArrowUp") {
-                Te();
+                He();
             }
             W === null || W === void 0 ? void 0 : W(n);
         };
-        var Fe = function e() {
+        var We = function e() {
             if (!ce && !v) {
-                Te();
+                He();
             }
         };
-        var We = function e(n) {
+        var Ue = function e(n) {
             var r = n.event, t = n.reason;
             var o = t === "offScreen" || t === "escapeKey" || t === "clickAway" && Pe.current && !re(Pe.current, r);
             if (o) {
-                He();
+                Le();
             }
         };
-        var Ue = function e(n) {
+        var $e = function e(n) {
             if (Ae.current !== ae) {
                 if (n) {
                     (0, P.scrollIntoViewIfNeeded)(n);
                 }
             }
         };
-        var $e = function e(n) {
+        var ze = function e(n) {
             var a = n.anchorWidth, l = n.maxHeight;
             var u = r.Children.toArray(i).filter(r.isValidElement);
             // Highlight Active
-                        qe.current = undefined;
+                        De.current = undefined;
+            qe.current = 0;
             // Only update the menu options if they are valid and the dropdown is open.
             // This is necessary to handle the outro animation of the dropdown.
                         if (Q && ce) {
-                Me.current = u.map((function(e, n) {
+                Me.current = u.map((function(e) {
                     if (e.type.as !== "Item") {
                         // ignore non-Option items such as Headings and Dividers
                         return e;
                     }
-                    var t = function n(r, t) {
+                    var n = function n(r, t) {
                         var o, a;
                         var i = (o = (a = e.props).onClick) === null || o === void 0 ? void 0 : o.call(a, r, t);
                         if (i !== false) {
-                            Ve(r, t);
+                            Ke(r, t);
                         }
                     };
-                    if (n === ae) {
-                        if (!e.props.disabled) {
-                            qe.current = e.props.value;
-                        }
+                    if (e.props.disabled) {
+                        return e;
+                    }
+                    var t = qe.current === ae;
+                    qe.current += 1;
+                    if (t) {
+                        De.current = e.props.value;
                         
                         return (0, r.cloneElement)(e, {
-                            elementRef: Ue,
-                            id: je,
-                            onClick: t,
+                            elementRef: $e,
+                            id: ke,
+                            onClick: n,
                             active: true
                         });
                     }
                     
                     return (0, r.cloneElement)(e, {
-                        onClick: t
+                        onClick: n
                     });
                 }));
             }
@@ -603,20 +619,20 @@
                 noOptionsMessage: H,
                 footerMessage: h,
                 animateLoading: o,
-                loadingMessage: D,
+                loadingMessage: x,
                 menuId: Ce
             }), Me.current);
         };
-        var ze = Ee();
         var Xe = Be();
-        var Ye = ce && !!Pe.current && Q;
-        var Ge = Q ? "combobox" : "searchbox";
-        var Je = {
-            "aria-activedescendant": Ye && ae > -1 ? je : undefined,
+        var Ye = Te();
+        var Ge = ce && !!Pe.current && Q;
+        var Je = Q ? "combobox" : "searchbox";
+        var Qe = {
+            "aria-activedescendant": Ge && ae > -1 ? ke : undefined,
             "aria-expanded": Q ? ce && !!Pe.current : undefined,
-            "aria-controls": Ye ? Ce : undefined
+            "aria-controls": Ge ? Ce : undefined
         };
-        var Qe =  t().createElement(_, {
+        var Ze =  t().createElement(_, {
             $disabled: v,
             "aria-label": oe,
             "data-test": "search-icon"
@@ -631,28 +647,28 @@
             autoCorrect: "off",
             canClear: true,
             "data-test-popover-id": we,
-            "data-test-label": Xe,
-            "data-test-value": ze,
-            "data-test-open": Ye,
+            "data-test-label": Ye,
+            "data-test-value": Xe,
+            "data-test-open": Ge,
             describedBy: s,
             disabled: v,
             elementRef: xe,
             error: y,
-            inline: R,
-            inputRef: De,
-            labelledBy: x,
+            inline: I,
+            inputRef: Ee,
+            labelledBy: D,
             name: T,
-            onFocus: _e,
-            onClick: Fe,
-            onChange: Ne,
-            onKeyDown: Ke,
+            onFocus: Ne,
+            onClick: We,
+            onChange: Ve,
+            onKeyDown: Fe,
             placeholder: X,
             prepend: Y,
             spellCheck: false,
-            startAdornment: Qe,
-            value: Xe,
-            role: Ge
-        }, Je),  t().createElement(m(), {
+            startAdornment: Ze,
+            value: Ye,
+            role: Je
+        }, Qe),  t().createElement(m(), {
             anchor: function() {
                 return Pe.current;
             }(),
@@ -660,13 +676,13 @@
             canCoverAnchor: false,
             defaultPlacement: l,
             id: we,
-            onRequestClose: We,
-            open: Ye,
+            onRequestClose: Ue,
+            open: Ge,
             repositionMode: "flip"
-        }, $e));
+        }, ze));
     }
     ae.propTypes = ne;
-    ae.Option = D;
+    ae.Option = x;
     ae.Divider = p.Divider;
     ae.Heading = p.Heading;
     /* harmony default export */    const ie = ae;