@almadar/ui 5.70.0 → 5.71.0

package/dist/docs/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var React8 = require('react');
+var React10 = require('react');
 var logger = require('@almadar/logger');
 var jsxRuntime = require('react/jsx-runtime');
 var LucideIcons2 = require('lucide-react');
@@ -44,7 +44,7 @@ function _interopNamespace(e) {
   return Object.freeze(n);
 }
 
-var React8__default = /*#__PURE__*/_interopDefault(React8);
+var React10__default = /*#__PURE__*/_interopDefault(React10);
 var LucideIcons2__namespace = /*#__PURE__*/_interopNamespace(LucideIcons2);
 var SyntaxHighlighter__default = /*#__PURE__*/_interopDefault(SyntaxHighlighter);
 var dark__default = /*#__PURE__*/_interopDefault(dark);
@@ -2570,17 +2570,17 @@ var init_EventBusProvider = __esm({
     "use client";
     logger.createLogger("almadar:eventbus");
     logger.createLogger("almadar:eventbus:subscribe");
-    EventBusContext = React8.createContext(null);
+    EventBusContext = React10.createContext(null);
   }
 });
 function useTraitScope() {
-  return React8.useContext(TraitScopeContext);
+  return React10.useContext(TraitScopeContext);
 }
 var TraitScopeContext;
 var init_TraitScopeProvider = __esm({
   "providers/TraitScopeProvider.tsx"() {
     "use client";
-    TraitScopeContext = React8.createContext(null);
+    TraitScopeContext = React10.createContext(null);
   }
 });
 function getGlobalEventBus() {
@@ -2590,10 +2590,10 @@ function getGlobalEventBus() {
   return null;
 }
 function useEventBus() {
-  const context = React8.useContext(EventBusContext);
+  const context = React10.useContext(EventBusContext);
   const baseBus = context ?? getGlobalEventBus() ?? fallbackEventBus;
   const scope = useTraitScope();
-  return React8.useMemo(() => {
+  return React10.useMemo(() => {
     if (!scope) {
       return {
         ...baseBus,
@@ -2704,24 +2704,24 @@ var init_useEventBus = __esm({
 });
 function useTapReveal(options = {}) {
   const { onReveal, onDismiss, refs, enabled = true } = options;
-  const [revealed, setRevealed] = React8.useState(false);
-  const onRevealRef = React8.useRef(onReveal);
-  const onDismissRef = React8.useRef(onDismiss);
+  const [revealed, setRevealed] = React10.useState(false);
+  const onRevealRef = React10.useRef(onReveal);
+  const onDismissRef = React10.useRef(onDismiss);
   onRevealRef.current = onReveal;
   onDismissRef.current = onDismiss;
-  const reveal = React8.useCallback(() => {
+  const reveal = React10.useCallback(() => {
     setRevealed((wasRevealed) => {
       if (!wasRevealed) onRevealRef.current?.();
       return true;
     });
   }, []);
-  const dismiss = React8.useCallback(() => {
+  const dismiss = React10.useCallback(() => {
     setRevealed((wasRevealed) => {
       if (wasRevealed) onDismissRef.current?.();
       return false;
     });
   }, []);
-  const onPointerDown = React8.useCallback(
+  const onPointerDown = React10.useCallback(
     (e) => {
       if (!enabled || e.pointerType === "mouse") return;
       if (revealed) dismiss();
@@ -2729,7 +2729,7 @@ function useTapReveal(options = {}) {
     },
     [enabled, revealed, reveal, dismiss]
   );
-  React8.useEffect(() => {
+  React10.useEffect(() => {
     if (!revealed || typeof document === "undefined") return;
     const onDocDown = (ev) => {
       const target = ev.target;
@@ -2858,7 +2858,7 @@ var init_Box = __esm({
       fixed: "fixed",
       sticky: "sticky"
     };
-    exports.Box = React8__default.default.forwardRef(
+    exports.Box = React10__default.default.forwardRef(
       ({
         padding,
         paddingX,
@@ -2890,20 +2890,20 @@ var init_Box = __esm({
         ...rest
       }, ref) => {
         const eventBus = useEventBus();
-        const handleClick = React8.useCallback((e) => {
+        const handleClick = React10.useCallback((e) => {
           if (action) {
             e.stopPropagation();
             eventBus.emit(`UI:${action}`, actionPayload ?? {});
           }
           onClick?.(e);
         }, [action, actionPayload, eventBus, onClick]);
-        const handleMouseEnter = React8.useCallback((e) => {
+        const handleMouseEnter = React10.useCallback((e) => {
           if (hoverEvent) {
             eventBus.emit(`UI:${hoverEvent}`, { hovered: true });
           }
           onMouseEnter?.(e);
         }, [hoverEvent, eventBus, onMouseEnter]);
-        const handleMouseLeave = React8.useCallback((e) => {
+        const handleMouseLeave = React10.useCallback((e) => {
           if (hoverEvent) {
             eventBus.emit(`UI:${hoverEvent}`, { hovered: false });
           }
@@ -2911,19 +2911,19 @@ var init_Box = __esm({
         }, [hoverEvent, eventBus, onMouseLeave]);
         const { triggerProps } = useTapReveal({
           enabled: tapReveal && !!hoverEvent,
-          onReveal: React8.useCallback(() => {
+          onReveal: React10.useCallback(() => {
             if (hoverEvent) eventBus.emit(`UI:${hoverEvent}`, { hovered: true });
           }, [hoverEvent, eventBus]),
-          onDismiss: React8.useCallback(() => {
+          onDismiss: React10.useCallback(() => {
             if (hoverEvent) eventBus.emit(`UI:${hoverEvent}`, { hovered: false });
           }, [hoverEvent, eventBus])
         });
-        const handlePointerDown = React8.useCallback((e) => {
+        const handlePointerDown = React10.useCallback((e) => {
           if (hoverEvent && tapReveal) triggerProps.onPointerDown(e);
           onPointerDown?.(e);
         }, [hoverEvent, tapReveal, triggerProps, onPointerDown]);
         const isClickable = action || onClick;
-        return React8__default.default.createElement(
+        return React10__default.default.createElement(
           Component,
           {
             ref,
@@ -3019,9 +3019,8 @@ var init_Stack = __esm({
       };
       const isHorizontal = direction === "horizontal";
       const directionClass = responsive && isHorizontal ? reverse ? "flex-col-reverse md:flex-row-reverse" : "flex-col md:flex-row" : isHorizontal ? reverse ? "flex-row-reverse" : "flex-row" : reverse ? "flex-col-reverse" : "flex-col";
-      const Comp = Component;
-      return /* @__PURE__ */ jsxRuntime.jsx(
-        Comp,
+      return React10__default.default.createElement(
+        Component,
         {
           className: cn(
             "flex",
@@ -3037,9 +3036,9 @@ var init_Stack = __esm({
           onClick: action || onClick ? handleClick : void 0,
           onKeyDown,
           role,
-          tabIndex,
-          children
-        }
+          tabIndex
+        },
+        children
       );
     };
     exports.VStack = (props) => /* @__PURE__ */ jsxRuntime.jsx(Stack, { direction: "vertical", ...props });
@@ -3136,9 +3135,8 @@ var init_Typography = __esm({
     }) => {
       const variant = variantProp ?? (level ? `h${level}` : "body1");
       const Component = as || defaultElements[variant];
-      const Comp = Component;
-      return /* @__PURE__ */ jsxRuntime.jsx(
-        Comp,
+      return React10__default.default.createElement(
+        Component,
         {
           id,
           className: cn(
@@ -3151,9 +3149,9 @@ var init_Typography = __esm({
             overflow && overflowStyles2[overflow],
             className
           ),
-          style,
-          children: children ?? content
-        }
+          style
+        },
+        children ?? content
       );
     };
     exports.Typography.displayName = "Typography";
@@ -3197,7 +3195,7 @@ function getIconFamilyServerSnapshot() {
   return DEFAULT_FAMILY;
 }
 function useIconFamily() {
-  return React8.useSyncExternalStore(
+  return React10.useSyncExternalStore(
     subscribeIconFamily,
     getIconFamilySnapshot,
     getIconFamilyServerSnapshot
@@ -3218,7 +3216,7 @@ function loadLib(key, importer) {
   return p;
 }
 function lazyFamilyIcon(libKey, importer, pick, fallbackName, family) {
-  const Lazy = React8__default.default.lazy(async () => {
+  const Lazy = React10__default.default.lazy(async () => {
     const lib = await loadLib(libKey, importer);
     const Comp = pick(lib);
     if (!Comp) {
@@ -3228,7 +3226,7 @@ function lazyFamilyIcon(libKey, importer, pick, fallbackName, family) {
     return { default: Comp };
   });
   const Wrapped = (props) => /* @__PURE__ */ jsxRuntime.jsx(
-    React8__default.default.Suspense,
+    React10__default.default.Suspense,
     {
       fallback: /* @__PURE__ */ jsxRuntime.jsx(
         "span",
@@ -3896,9 +3894,10 @@ function resolveIcon(name) {
 function doResolve(name) {
   if (iconAliases[name]) return iconAliases[name];
   const pascalName = kebabToPascal2(name);
-  const directLookup = LucideIcons2__namespace[pascalName];
+  const lucideMap = LucideIcons2__namespace;
+  const directLookup = lucideMap[pascalName];
   if (directLookup && typeof directLookup === "object") return directLookup;
-  const asIs = LucideIcons2__namespace[name];
+  const asIs = lucideMap[name];
   if (asIs && typeof asIs === "object") return asIs;
   return LucideIcons2__namespace.HelpCircle;
 }
@@ -3954,7 +3953,7 @@ var init_Icon = __esm({
       const directIcon = typeof icon === "string" ? void 0 : icon;
       const effectiveName = typeof icon === "string" ? icon : name;
       const family = useIconFamily();
-      const RenderedComponent = React8__default.default.useMemo(() => {
+      const RenderedComponent = React10__default.default.useMemo(() => {
         if (directIcon) return null;
         return effectiveName ? resolveIconForFamily(effectiveName, family) : null;
       }, [directIcon, effectiveName, family]);
@@ -4004,6 +4003,9 @@ var init_Icon = __esm({
     exports.Icon.displayName = "Icon";
   }
 });
+function isIconLike(v) {
+  return typeof v.render === "function";
+}
 function resolveIconProp(value, sizeClass) {
   if (!value) return null;
   if (typeof value === "string") {
@@ -4013,10 +4015,10 @@ function resolveIconProp(value, sizeClass) {
     const IconComp = value;
     return /* @__PURE__ */ jsxRuntime.jsx(IconComp, { className: sizeClass });
   }
-  if (React8__default.default.isValidElement(value)) {
+  if (React10__default.default.isValidElement(value)) {
     return value;
   }
-  if (typeof value === "object" && value !== null && "render" in value) {
+  if (typeof value === "object" && value !== null && isIconLike(value)) {
     const IconComp = value;
     return /* @__PURE__ */ jsxRuntime.jsx(IconComp, { className: sizeClass });
   }
@@ -4089,7 +4091,7 @@ var init_Button = __esm({
       md: "h-icon-default w-icon-default",
       lg: "h-icon-default w-icon-default"
     };
-    exports.Button = React8__default.default.forwardRef(
+    exports.Button = React10__default.default.forwardRef(
       ({
         className,
         variant = "primary",
@@ -4105,6 +4107,7 @@ var init_Button = __esm({
         label,
         children,
         onClick,
+        "data-testid": dataTestId,
         ...props
       }, ref) => {
         const eventBus = useEventBus();
@@ -4137,7 +4140,7 @@ var init_Button = __esm({
             ),
             onClick: handleClick,
             ...props,
-            "data-testid": props["data-testid"] ?? (action ? `action-${action}` : void 0),
+            "data-testid": dataTestId ?? (action ? `action-${action}` : void 0),
             children: [
               isLoading ? /* @__PURE__ */ jsxRuntime.jsx(LucideIcons2.Loader2, { className: "h-icon-default w-icon-default animate-spin" }) : resolvedLeftIcon && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "flex-shrink-0", children: resolvedLeftIcon }),
               children || label,
@@ -4161,7 +4164,7 @@ var init_Spinner = __esm({
       md: "h-6 w-6",
       lg: "h-8 w-8"
     };
-    Spinner = React8__default.default.forwardRef(
+    Spinner = React10__default.default.forwardRef(
       ({ className, size = "md", overlay, ...props }, ref) => {
         if (overlay) {
           return /* @__PURE__ */ jsxRuntime.jsx(
@@ -4251,7 +4254,7 @@ var init_Card = __esm({
       chip: "shadow-none rounded-pill border-[length:var(--border-width)] border-border",
       "tile-image-first": "p-0 overflow-hidden"
     };
-    exports.Card = React8__default.default.forwardRef(
+    exports.Card = React10__default.default.forwardRef(
       ({
         className,
         variant = "bordered",
@@ -4299,9 +4302,9 @@ var init_Card = __esm({
       }
     );
     exports.Card.displayName = "Card";
-    CardHeader = React8__default.default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx("div", { ref, className: cn("mb-4", className), ...props }));
+    CardHeader = React10__default.default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx("div", { ref, className: cn("mb-4", className), ...props }));
     CardHeader.displayName = "CardHeader";
-    CardTitle = React8__default.default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx(
+    CardTitle = React10__default.default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx(
       "h3",
       {
         ref,
@@ -4314,11 +4317,11 @@ var init_Card = __esm({
       }
     ));
     CardTitle.displayName = "CardTitle";
-    CardContent = React8__default.default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx("div", { ref, className: cn("", className), ...props }));
+    CardContent = React10__default.default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx("div", { ref, className: cn("", className), ...props }));
     CardContent.displayName = "CardContent";
     CardBody = CardContent;
     CardBody.displayName = "CardBody";
-    CardFooter = React8__default.default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx(
+    CardFooter = React10__default.default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx(
       "div",
       {
         ref,
@@ -4988,7 +4991,7 @@ var init_en = __esm({
   }
 });
 function useTranslate() {
-  return React8.useContext(I18nContext);
+  return React10.useContext(I18nContext);
 }
 var _meta, coreMessages, coreLocale, I18nContext;
 var init_useTranslate = __esm({
@@ -4997,7 +5000,7 @@ var init_useTranslate = __esm({
     init_en();
     ({ $meta: _meta, ...coreMessages } = en_default);
     coreLocale = coreMessages;
-    I18nContext = React8.createContext({
+    I18nContext = React10.createContext({
       locale: "en",
       direction: "ltr",
       t: (key, params) => {
@@ -5021,7 +5024,7 @@ var init_Input = __esm({
     init_Icon();
     init_useTranslate();
     init_useEventBus();
-    exports.Input = React8__default.default.forwardRef(
+    exports.Input = React10__default.default.forwardRef(
       ({
         className,
         inputType,
@@ -5189,7 +5192,7 @@ var init_DocSidebar = __esm({
     init_Icon();
     init_useTranslate();
     DocSidebarCategory = ({ item, depth }) => {
-      const [expanded, setExpanded] = React8.useState(
+      const [expanded, setExpanded] = React10.useState(
         () => item.items?.some(function hasActive(child) {
           if (child.active) return true;
           return child.items?.some(hasActive) ?? false;
@@ -5370,7 +5373,7 @@ var init_DocBreadcrumb = __esm({
           "aria-label": t("aria.breadcrumb"),
           children: /* @__PURE__ */ jsxRuntime.jsx(exports.HStack, { gap: "xs", align: "center", wrap: true, children: items.map((item, idx) => {
             const isLast = idx === items.length - 1;
-            return /* @__PURE__ */ jsxRuntime.jsxs(React8__default.default.Fragment, { children: [
+            return /* @__PURE__ */ jsxRuntime.jsxs(React10__default.default.Fragment, { children: [
               idx > 0 && /* @__PURE__ */ jsxRuntime.jsx(
                 exports.Icon,
                 {
@@ -5428,7 +5431,7 @@ var init_Textarea = __esm({
   "components/core/atoms/Textarea.tsx"() {
     init_cn();
     init_useEventBus();
-    Textarea = React8__default.default.forwardRef(
+    Textarea = React10__default.default.forwardRef(
       ({ className, error, onChange, ...props }, ref) => {
         const eventBus = useEventBus();
         const handleChange = (e) => {
@@ -5504,7 +5507,7 @@ var init_Badge = __esm({
       md: "px-2.5 py-1 text-sm",
       lg: "px-3 py-1.5 text-base"
     };
-    Badge = React8__default.default.forwardRef(
+    Badge = React10__default.default.forwardRef(
       ({ className, variant = "default", size = "sm", amount, label, icon, children, onRemove, removeLabel, ...props }, ref) => {
         const iconSizes = {
           sm: "h-icon-default w-icon-default",
@@ -5601,11 +5604,11 @@ var init_Tabs = __esm({
       const eventBus = useEventBus();
       const { t } = useTranslate();
       const initialActive = safeItems.find((item) => item.active)?.id;
-      const [internalActiveTab, setInternalActiveTab] = React8.useState(
+      const [internalActiveTab, setInternalActiveTab] = React10.useState(
         defaultActiveTab || initialActive || safeItems[0]?.id || ""
       );
       const activeTab = controlledActiveTab !== void 0 ? controlledActiveTab : internalActiveTab;
-      const tabRefs = React8.useRef({});
+      const tabRefs = React10.useRef({});
       const handleTabChange = (tabId, tabEvent) => {
         if (controlledActiveTab === void 0) {
           setInternalActiveTab(tabId);
@@ -6097,7 +6100,7 @@ var init_CodeBlock = __esm({
     };
     LINE_PROPS_FN = (n) => ({ "data-line": String(n - 1) });
     HIDDEN_LINE_NUMBERS = { display: "none" };
-    exports.DocCodeBlock = React8__default.default.memo(
+    exports.DocCodeBlock = React10__default.default.memo(
       ({
         code: rawCode,
         language = "text",
@@ -6129,16 +6132,16 @@ var init_CodeBlock = __esm({
         const activeStyle = isOrb ? orbStyle : isLolo ? loloStyle : dark__default.default;
         const eventBus = useEventBus();
         const { t } = useTranslate();
-        const scrollRef = React8.useRef(null);
-        const codeRef = React8.useRef(null);
-        const savedScrollLeftRef = React8.useRef(0);
-        const [copied, setCopied] = React8.useState(false);
-        const [wrap, setWrap] = React8.useState(wordWrap);
-        const [activeFileIndex, setActiveFileIndex] = React8.useState(0);
+        const scrollRef = React10.useRef(null);
+        const codeRef = React10.useRef(null);
+        const savedScrollLeftRef = React10.useRef(0);
+        const [copied, setCopied] = React10.useState(false);
+        const [wrap, setWrap] = React10.useState(wordWrap);
+        const [activeFileIndex, setActiveFileIndex] = React10.useState(0);
         const activeFile = files?.[activeFileIndex];
         const activeCode = activeFile?.code ?? code;
         const activeLanguage = activeFile?.language ?? language;
-        const diffLines = React8.useMemo(() => {
+        const diffLines = React10.useMemo(() => {
           if (propDiff) return propDiff;
           if (mode === "diff" && oldValue !== void 0 && newValue !== void 0) {
             return generateDiff(oldValue, newValue);
@@ -6147,19 +6150,19 @@ var init_CodeBlock = __esm({
         }, [propDiff, mode, oldValue, newValue]);
         const isViewerMode = !!(title || files || showLineNumbers || diffLines || mode === "diff" || actions);
         const effectiveCopy = showCopy ?? showCopyButton;
-        const [editableValue, setEditableValue] = React8.useState(code);
-        const [editableTextareaKey, setEditableTextareaKey] = React8.useState(0);
-        const lastPropCodeRef = React8.useRef(code);
-        const editableTextareaRef = React8.useRef(null);
-        const editableOverlayRef = React8.useRef(null);
-        React8.useEffect(() => {
+        const [editableValue, setEditableValue] = React10.useState(code);
+        const [editableTextareaKey, setEditableTextareaKey] = React10.useState(0);
+        const lastPropCodeRef = React10.useRef(code);
+        const editableTextareaRef = React10.useRef(null);
+        const editableOverlayRef = React10.useRef(null);
+        React10.useEffect(() => {
           if (code !== lastPropCodeRef.current) {
             lastPropCodeRef.current = code;
             setEditableValue(code);
             setEditableTextareaKey((k) => k + 1);
           }
         }, [code]);
-        const handleEditableScroll = React8.useCallback(() => {
+        const handleEditableScroll = React10.useCallback(() => {
           const ta = editableTextareaRef.current;
           const ov = editableOverlayRef.current;
           if (ta && ov) {
@@ -6167,7 +6170,7 @@ var init_CodeBlock = __esm({
             ov.scrollLeft = ta.scrollLeft;
           }
         }, []);
-        const errorLineProps = React8.useMemo(() => {
+        const errorLineProps = React10.useMemo(() => {
           if (!errorLines || errorLines.size === 0) {
             return LINE_PROPS_FN;
           }
@@ -6190,17 +6193,17 @@ var init_CodeBlock = __esm({
           };
         }, [errorLines]);
         const isFoldable = foldableProp ?? true;
-        const [collapsed, setCollapsed] = React8.useState(() => /* @__PURE__ */ new Set());
-        const foldRegions = React8.useMemo(
+        const [collapsed, setCollapsed] = React10.useState(() => /* @__PURE__ */ new Set());
+        const foldRegions = React10.useMemo(
           () => isFoldable ? computeFoldRegions(code) : [],
           [code, isFoldable]
         );
-        const foldStartMap = React8.useMemo(() => {
+        const foldStartMap = React10.useMemo(() => {
           const m = /* @__PURE__ */ new Map();
           for (const r2 of foldRegions) m.set(r2.start, r2);
           return m;
         }, [foldRegions]);
-        const hiddenLines = React8.useMemo(() => {
+        const hiddenLines = React10.useMemo(() => {
           const h = /* @__PURE__ */ new Set();
           for (const r2 of foldRegions) {
             if (!collapsed.has(r2.start)) continue;
@@ -6208,13 +6211,13 @@ var init_CodeBlock = __esm({
           }
           return h;
         }, [foldRegions, collapsed]);
-        const collapsedRef = React8.useRef(collapsed);
+        const collapsedRef = React10.useRef(collapsed);
         collapsedRef.current = collapsed;
-        const foldStartMapRef = React8.useRef(foldStartMap);
+        const foldStartMapRef = React10.useRef(foldStartMap);
         foldStartMapRef.current = foldStartMap;
-        const hiddenLinesRef = React8.useRef(hiddenLines);
+        const hiddenLinesRef = React10.useRef(hiddenLines);
         hiddenLinesRef.current = hiddenLines;
-        const toggleFold = React8.useCallback((lineNum) => {
+        const toggleFold = React10.useCallback((lineNum) => {
           setCollapsed((prev) => {
             const next = new Set(prev);
             if (next.has(lineNum)) next.delete(lineNum);
@@ -6222,12 +6225,12 @@ var init_CodeBlock = __esm({
             return next;
           });
         }, []);
-        const toggleFoldRef = React8.useRef(toggleFold);
+        const toggleFoldRef = React10.useRef(toggleFold);
         toggleFoldRef.current = toggleFold;
-        React8.useEffect(() => {
+        React10.useEffect(() => {
           setCollapsed(/* @__PURE__ */ new Set());
         }, [code]);
-        const highlightedElement = React8.useMemo(
+        const highlightedElement = React10.useMemo(
           () => /* @__PURE__ */ jsxRuntime.jsx(
             SyntaxHighlighter__default.default,
             {
@@ -6252,7 +6255,7 @@ var init_CodeBlock = __esm({
           ),
           [code, language, activeStyle]
         );
-        React8.useLayoutEffect(() => {
+        React10.useLayoutEffect(() => {
           const container = codeRef.current;
           if (!container) return;
           container.querySelectorAll(".fold-toggle, .fold-summary").forEach((el) => el.remove());
@@ -6296,17 +6299,17 @@ var init_CodeBlock = __esm({
             }
           });
         }, [collapsed, hiddenLines, foldStartMap, foldRegions, isFoldable]);
-        React8.useLayoutEffect(() => {
+        React10.useLayoutEffect(() => {
           const el = scrollRef.current;
           return () => {
             if (el) savedScrollLeftRef.current = el.scrollLeft;
           };
         }, [language, code]);
-        React8.useLayoutEffect(() => {
+        React10.useLayoutEffect(() => {
           const el = scrollRef.current;
           if (el) el.scrollLeft = savedScrollLeftRef.current;
         }, [language, code]);
-        React8.useEffect(() => {
+        React10.useEffect(() => {
           const el = scrollRef.current;
           if (!el) return;
           const handle = () => {
@@ -6326,7 +6329,7 @@ var init_CodeBlock = __esm({
             eventBus.emit("UI:COPY_CODE", { language: activeLanguage, success: false });
           }
         };
-        const handleSelectionCopy = React8.useCallback((e) => {
+        const handleSelectionCopy = React10.useCallback((e) => {
           if (hiddenLinesRef.current.size === 0) return;
           const sel = typeof window !== "undefined" ? window.getSelection() : null;
           if (!sel || sel.rangeCount === 0 || sel.isCollapsed) return;
@@ -6772,13 +6775,13 @@ function DocSearch({
 }) {
   const { t } = useTranslate();
   const resolvedPlaceholder = placeholder ?? t("docSearch.placeholder");
-  const [query, setQuery] = React8.useState("");
-  const [results, setResults] = React8.useState([]);
-  const [isOpen, setIsOpen] = React8.useState(false);
-  const [activeIndex, setActiveIndex] = React8.useState(-1);
-  const containerRef = React8.useRef(null);
-  const debounceRef = React8.useRef(void 0);
-  React8.useEffect(() => {
+  const [query, setQuery] = React10.useState("");
+  const [results, setResults] = React10.useState([]);
+  const [isOpen, setIsOpen] = React10.useState(false);
+  const [activeIndex, setActiveIndex] = React10.useState(-1);
+  const containerRef = React10.useRef(null);
+  const debounceRef = React10.useRef(void 0);
+  React10.useEffect(() => {
     function handleClickOutside(e) {
       if (containerRef.current && !containerRef.current.contains(e.target)) {
         setIsOpen(false);
@@ -6787,7 +6790,7 @@ function DocSearch({
     document.addEventListener("mousedown", handleClickOutside);
     return () => document.removeEventListener("mousedown", handleClickOutside);
   }, []);
-  const performSearch = React8.useCallback(
+  const performSearch = React10.useCallback(
     (value) => {
       if (!onSearch || !value.trim()) {
         setResults([]);
@@ -6809,7 +6812,7 @@ function DocSearch({
     },
     [onSearch]
   );
-  const handleChange = React8.useCallback(
+  const handleChange = React10.useCallback(
     (e) => {
       const value = e.target.value;
       setQuery(value);
@@ -6822,18 +6825,18 @@ function DocSearch({
     },
     [performSearch]
   );
-  const handleFocus = React8.useCallback(() => {
+  const handleFocus = React10.useCallback(() => {
     if (results.length > 0) {
       setIsOpen(true);
     }
   }, [results]);
-  const navigateTo = React8.useCallback((href) => {
+  const navigateTo = React10.useCallback((href) => {
     setIsOpen(false);
     setQuery("");
     setResults([]);
     window.location.href = href;
   }, []);
-  const handleKeyDown = React8.useCallback(
+  const handleKeyDown = React10.useCallback(
     (e) => {
       if (e.key === "Escape") {
         setIsOpen(false);
@@ -6860,7 +6863,7 @@ function DocSearch({
     },
     [isOpen, results, activeIndex, navigateTo]
   );
-  React8.useEffect(() => {
+  React10.useEffect(() => {
     return () => {
       if (debounceRef.current) {
         clearTimeout(debounceRef.current);

package/dist/docs/index.d.cts

@@ -267,6 +267,8 @@ interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
     label?: string;
     /** Disable the button (greys out, blocks click events) */
     disabled?: boolean;
+    /** Test identifier for automated tests */
+    'data-testid'?: string;
 }
 declare const Button: React.ForwardRefExoticComponent<ButtonProps & React.RefAttributes<HTMLButtonElement>>;