@almadar/ui 5.29.0 → 5.31.0

package/dist/docs/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var React7 = require('react');
+var React8 = require('react');
 var logger = require('@almadar/logger');
 var jsxRuntime = require('react/jsx-runtime');
 var LucideIcons2 = require('lucide-react');
@@ -47,7 +47,7 @@ function _interopNamespace(e) {
   return Object.freeze(n);
 }
 
-var React7__default = /*#__PURE__*/_interopDefault(React7);
+var React8__default = /*#__PURE__*/_interopDefault(React8);
 var LucideIcons2__namespace = /*#__PURE__*/_interopNamespace(LucideIcons2);
 var PhosphorIcons__namespace = /*#__PURE__*/_interopNamespace(PhosphorIcons);
 var TablerIcons__namespace = /*#__PURE__*/_interopNamespace(TablerIcons);
@@ -2576,17 +2576,17 @@ var init_EventBusProvider = __esm({
     "use client";
     logger.createLogger("almadar:eventbus");
     logger.createLogger("almadar:eventbus:subscribe");
-    EventBusContext = React7.createContext(null);
+    EventBusContext = React8.createContext(null);
   }
 });
 function useTraitScope() {
-  return React7.useContext(TraitScopeContext);
+  return React8.useContext(TraitScopeContext);
 }
 var TraitScopeContext;
 var init_TraitScopeProvider = __esm({
   "providers/TraitScopeProvider.tsx"() {
     "use client";
-    TraitScopeContext = React7.createContext(null);
+    TraitScopeContext = React8.createContext(null);
   }
 });
 function getGlobalEventBus() {
@@ -2596,10 +2596,10 @@ function getGlobalEventBus() {
   return null;
 }
 function useEventBus() {
-  const context = React7.useContext(EventBusContext);
+  const context = React8.useContext(EventBusContext);
   const baseBus = context ?? getGlobalEventBus() ?? fallbackEventBus;
   const scope = useTraitScope();
-  return React7.useMemo(() => {
+  return React8.useMemo(() => {
     if (!scope) {
       return {
         ...baseBus,
@@ -2816,7 +2816,7 @@ var init_Box = __esm({
       fixed: "fixed",
       sticky: "sticky"
     };
-    exports.Box = React7__default.default.forwardRef(
+    exports.Box = React8__default.default.forwardRef(
       ({
         padding,
         paddingX,
@@ -2846,27 +2846,27 @@ var init_Box = __esm({
         ...rest
       }, ref) => {
         const eventBus = useEventBus();
-        const handleClick = React7.useCallback((e) => {
+        const handleClick = React8.useCallback((e) => {
           if (action) {
             e.stopPropagation();
             eventBus.emit(`UI:${action}`, actionPayload ?? {});
           }
           onClick?.(e);
         }, [action, actionPayload, eventBus, onClick]);
-        const handleMouseEnter = React7.useCallback((e) => {
+        const handleMouseEnter = React8.useCallback((e) => {
           if (hoverEvent) {
             eventBus.emit(`UI:${hoverEvent}`, { hovered: true });
           }
           onMouseEnter?.(e);
         }, [hoverEvent, eventBus, onMouseEnter]);
-        const handleMouseLeave = React7.useCallback((e) => {
+        const handleMouseLeave = React8.useCallback((e) => {
           if (hoverEvent) {
             eventBus.emit(`UI:${hoverEvent}`, { hovered: false });
           }
           onMouseLeave?.(e);
         }, [hoverEvent, eventBus, onMouseLeave]);
         const isClickable = action || onClick;
-        return React7__default.default.createElement(
+        return React8__default.default.createElement(
           Component,
           {
             ref,
@@ -3139,7 +3139,7 @@ function getIconFamilyServerSnapshot() {
   return DEFAULT_FAMILY;
 }
 function useIconFamily() {
-  return React7.useSyncExternalStore(
+  return React8.useSyncExternalStore(
     subscribeIconFamily,
     getIconFamilySnapshot,
     getIconFamilyServerSnapshot
@@ -3856,7 +3856,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 = React7__default.default.useMemo(() => {
+      const RenderedComponent = React8__default.default.useMemo(() => {
         if (directIcon) return null;
         return effectiveName ? resolveIconForFamily(effectiveName, family) : null;
       }, [directIcon, effectiveName, family]);
@@ -3915,7 +3915,7 @@ function resolveIconProp(value, sizeClass) {
     const IconComp = value;
     return /* @__PURE__ */ jsxRuntime.jsx(IconComp, { className: sizeClass });
   }
-  if (React7__default.default.isValidElement(value)) {
+  if (React8__default.default.isValidElement(value)) {
     return value;
   }
   if (typeof value === "object" && value !== null && "render" in value) {
@@ -3991,7 +3991,7 @@ var init_Button = __esm({
       md: "h-icon-default w-icon-default",
       lg: "h-icon-default w-icon-default"
     };
-    exports.Button = React7__default.default.forwardRef(
+    exports.Button = React8__default.default.forwardRef(
       ({
         className,
         variant = "primary",
@@ -4052,11 +4052,54 @@ var init_Button = __esm({
     exports.Button.displayName = "Button";
   }
 });
+var sizeStyles2, Spinner;
+var init_Spinner = __esm({
+  "components/core/atoms/Spinner.tsx"() {
+    init_cn();
+    init_Icon();
+    sizeStyles2 = {
+      xs: "h-3 w-3",
+      sm: "h-icon-default w-icon-default",
+      md: "h-6 w-6",
+      lg: "h-8 w-8"
+    };
+    Spinner = React8__default.default.forwardRef(
+      ({ className, size = "md", overlay, ...props }, ref) => {
+        if (overlay) {
+          return /* @__PURE__ */ jsxRuntime.jsx(
+            "div",
+            {
+              ref,
+              className: cn(
+                "absolute inset-0 z-10 flex items-center justify-center",
+                "bg-background/60 backdrop-blur-sm",
+                className
+              ),
+              ...props,
+              children: /* @__PURE__ */ jsxRuntime.jsx(exports.Icon, { name: "loader", className: cn("animate-spin text-foreground", sizeStyles2[size]) })
+            }
+          );
+        }
+        return /* @__PURE__ */ jsxRuntime.jsx(
+          "div",
+          {
+            ref,
+            className: cn("text-foreground", className),
+            ...props,
+            children: /* @__PURE__ */ jsxRuntime.jsx(exports.Icon, { name: "loader", className: cn("animate-spin", sizeStyles2[size]) })
+          }
+        );
+      }
+    );
+    Spinner.displayName = "Spinner";
+  }
+});
 var variantStyles3, paddingStyles2, shadowStyles2, lookStyles; exports.Card = void 0; var CardHeader, CardTitle, CardContent, CardBody, CardFooter;
 var init_Card = __esm({
   "components/core/atoms/Card.tsx"() {
     init_cn();
     init_useEventBus();
+    init_Spinner();
     variantStyles3 = {
       default: [
         "bg-card",
@@ -4110,7 +4153,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 = React7__default.default.forwardRef(
+    exports.Card = React8__default.default.forwardRef(
       ({
         className,
         variant = "bordered",
@@ -4121,6 +4164,7 @@ var init_Card = __esm({
         look = "elevated",
         children,
         action,
+        loading,
         onClick,
         ...props
       }, ref) => {
@@ -4134,7 +4178,7 @@ var init_Card = __esm({
           {
             ref,
             className: cn(
-              "rounded-container",
+              "rounded-container relative",
               "transition-all duration-[var(--transition-normal)]",
               variantStyles3[variant],
               paddingStyles2[padding],
@@ -4145,6 +4189,7 @@ var init_Card = __esm({
             onClick: handleClick,
             ...props,
             children: [
+              loading && /* @__PURE__ */ jsxRuntime.jsx(Spinner, { overlay: true, size: "md" }),
               (title || subtitle) && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "mb-4", children: [
                 title && /* @__PURE__ */ jsxRuntime.jsx("h3", { className: "text-lg text-card-foreground font-bold", children: title }),
                 subtitle && /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-sm text-muted-foreground mt-1", children: subtitle })
@@ -4156,9 +4201,9 @@ var init_Card = __esm({
       }
     );
     exports.Card.displayName = "Card";
-    CardHeader = React7__default.default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx("div", { ref, className: cn("mb-4", className), ...props }));
+    CardHeader = React8__default.default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx("div", { ref, className: cn("mb-4", className), ...props }));
     CardHeader.displayName = "CardHeader";
-    CardTitle = React7__default.default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx(
+    CardTitle = React8__default.default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx(
       "h3",
       {
         ref,
@@ -4171,11 +4216,11 @@ var init_Card = __esm({
       }
     ));
     CardTitle.displayName = "CardTitle";
-    CardContent = React7__default.default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx("div", { ref, className: cn("", className), ...props }));
+    CardContent = React8__default.default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx("div", { ref, className: cn("", className), ...props }));
     CardContent.displayName = "CardContent";
     CardBody = CardContent;
     CardBody.displayName = "CardBody";
-    CardFooter = React7__default.default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx(
+    CardFooter = React8__default.default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx(
       "div",
       {
         ref,
@@ -4741,7 +4786,7 @@ var init_en = __esm({
   }
 });
 function useTranslate() {
-  return React7.useContext(I18nContext);
+  return React8.useContext(I18nContext);
 }
 var _meta, coreMessages, coreLocale, I18nContext;
 var init_useTranslate = __esm({
@@ -4750,7 +4795,7 @@ var init_useTranslate = __esm({
     init_en();
     ({ $meta: _meta, ...coreMessages } = en_default);
     coreLocale = coreMessages;
-    I18nContext = React7.createContext({
+    I18nContext = React8.createContext({
       locale: "en",
       direction: "ltr",
       t: (key, params) => {
@@ -4774,11 +4819,13 @@ var init_Input = __esm({
     init_Icon();
     init_useTranslate();
     init_useEventBus();
-    exports.Input = React7__default.default.forwardRef(
+    exports.Input = React8__default.default.forwardRef(
       ({
         className,
         inputType,
         type: htmlType,
+        label,
+        helperText,
         error,
         leftIcon,
         rightIcon,
@@ -4834,82 +4881,95 @@ var init_Input = __esm({
             onClear?.();
           }
         };
+        const wrapField = (field) => /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "w-full", children: [
+          label && /* @__PURE__ */ jsxRuntime.jsx("label", { className: "block text-sm font-medium text-foreground mb-1", children: label }),
+          field,
+          (helperText || error) && /* @__PURE__ */ jsxRuntime.jsx("p", { className: cn("mt-1 text-xs", error ? "text-error" : "text-muted-foreground"), children: error ?? helperText })
+        ] });
         if (type === "select") {
-          return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "relative w-full", children: [
-            resolvedLeftIcon && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "absolute inset-y-0 left-0 pl-3 flex items-center pointer-events-none text-muted-foreground", children: resolvedLeftIcon }),
-            /* @__PURE__ */ jsxRuntime.jsxs(
-              "select",
+          return wrapField(
+            /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "relative w-full", children: [
+              resolvedLeftIcon && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "absolute inset-y-0 left-0 pl-3 flex items-center pointer-events-none text-muted-foreground", children: resolvedLeftIcon }),
+              /* @__PURE__ */ jsxRuntime.jsxs(
+                "select",
+                {
+                  ref,
+                  value,
+                  onChange: handleChange,
+                  className: cn(baseClassName, "appearance-none pr-10", className),
+                  ...props,
+                  children: [
+                    /* @__PURE__ */ jsxRuntime.jsx("option", { value: "", children: t("form.selectPlaceholder", { label: "" }) }),
+                    options?.map((opt) => /* @__PURE__ */ jsxRuntime.jsx("option", { value: opt.value, children: opt.label }, opt.value))
+                  ]
+                }
+              ),
+              /* @__PURE__ */ jsxRuntime.jsx("div", { className: "absolute inset-y-0 right-0 pr-3 flex items-center pointer-events-none text-muted-foreground", children: /* @__PURE__ */ jsxRuntime.jsx(exports.Icon, { name: "chevron-down", className: "h-icon-default w-icon-default" }) })
+            ] })
+          );
+        }
+        if (type === "textarea") {
+          return wrapField(
+            /* @__PURE__ */ jsxRuntime.jsx("div", { className: "relative w-full", children: /* @__PURE__ */ jsxRuntime.jsx(
+              "textarea",
               {
                 ref,
                 value,
                 onChange: handleChange,
-                className: cn(baseClassName, "appearance-none pr-10", className),
-                ...props,
-                children: [
-                  /* @__PURE__ */ jsxRuntime.jsx("option", { value: "", children: t("form.selectPlaceholder", { label: "" }) }),
-                  options?.map((opt) => /* @__PURE__ */ jsxRuntime.jsx("option", { value: opt.value, children: opt.label }, opt.value))
-                ]
+                rows,
+                className: baseClassName,
+                ...props
               }
-            ),
-            /* @__PURE__ */ jsxRuntime.jsx("div", { className: "absolute inset-y-0 right-0 pr-3 flex items-center pointer-events-none text-muted-foreground", children: /* @__PURE__ */ jsxRuntime.jsx(exports.Icon, { name: "chevron-down", className: "h-icon-default w-icon-default" }) })
-          ] });
-        }
-        if (type === "textarea") {
-          return /* @__PURE__ */ jsxRuntime.jsx("div", { className: "relative w-full", children: /* @__PURE__ */ jsxRuntime.jsx(
-            "textarea",
-            {
-              ref,
-              value,
-              onChange: handleChange,
-              rows,
-              className: baseClassName,
-              ...props
-            }
-          ) });
+            ) })
+          );
         }
         if (type === "checkbox") {
-          return /* @__PURE__ */ jsxRuntime.jsx(
-            "input",
-            {
-              ref,
-              type: "checkbox",
-              checked: props.checked,
-              onChange: handleChange,
-              className: cn(
-                "h-icon-default w-icon-default rounded-sm",
-                "border-border",
-                "text-primary focus:ring-ring",
-                "disabled:opacity-50 disabled:cursor-not-allowed",
-                className
-              ),
-              ...props
-            }
+          return wrapField(
+            /* @__PURE__ */ jsxRuntime.jsx(
+              "input",
+              {
+                ref,
+                type: "checkbox",
+                checked: props.checked,
+                onChange: handleChange,
+                className: cn(
+                  "h-icon-default w-icon-default rounded-sm",
+                  "border-border",
+                  "text-primary focus:ring-ring",
+                  "disabled:opacity-50 disabled:cursor-not-allowed",
+                  className
+                ),
+                ...props
+              }
+            )
           );
         }
-        return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "relative w-full", children: [
-          resolvedLeftIcon && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "absolute inset-y-0 left-0 pl-3 flex items-center pointer-events-none text-muted-foreground", children: resolvedLeftIcon }),
-          /* @__PURE__ */ jsxRuntime.jsx(
-            "input",
-            {
-              ref,
-              type,
-              value,
-              onChange: handleChange,
-              className: baseClassName,
-              ...props
-            }
-          ),
-          showClearButton && /* @__PURE__ */ jsxRuntime.jsx(
-            "button",
-            {
-              type: "button",
-              onClick: handleClear,
-              className: "absolute inset-y-0 right-0 pr-3 flex items-center text-muted-foreground hover:text-foreground",
-              children: /* @__PURE__ */ jsxRuntime.jsx(exports.Icon, { name: "x", className: "h-icon-default w-icon-default" })
-            }
-          ),
-          rightIcon && !showClearButton && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "absolute inset-y-0 right-0 pr-3 flex items-center text-muted-foreground", children: resolveIconNode(rightIcon, iconCls) })
-        ] });
+        return wrapField(
+          /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "relative w-full", children: [
+            resolvedLeftIcon && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "absolute inset-y-0 left-0 pl-3 flex items-center pointer-events-none text-muted-foreground", children: resolvedLeftIcon }),
+            /* @__PURE__ */ jsxRuntime.jsx(
+              "input",
+              {
+                ref,
+                type,
+                value,
+                onChange: handleChange,
+                className: baseClassName,
+                ...props
+              }
+            ),
+            showClearButton && /* @__PURE__ */ jsxRuntime.jsx(
+              "button",
+              {
+                type: "button",
+                onClick: handleClear,
+                className: "absolute inset-y-0 right-0 pr-3 flex items-center text-muted-foreground hover:text-foreground",
+                children: /* @__PURE__ */ jsxRuntime.jsx(exports.Icon, { name: "x", className: "h-icon-default w-icon-default" })
+              }
+            ),
+            rightIcon && !showClearButton && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "absolute inset-y-0 right-0 pr-3 flex items-center text-muted-foreground", children: resolveIconNode(rightIcon, iconCls) })
+          ] })
+        );
       }
     );
     exports.Input.displayName = "Input";
@@ -4927,7 +4987,7 @@ var init_DocSidebar = __esm({
     init_Icon();
     init_useTranslate();
     DocSidebarCategory = ({ item, depth }) => {
-      const [expanded, setExpanded] = React7.useState(
+      const [expanded, setExpanded] = React8.useState(
         () => item.items?.some(function hasActive(child) {
           if (child.active) return true;
           return child.items?.some(hasActive) ?? false;
@@ -5108,7 +5168,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(React7__default.default.Fragment, { children: [
+            return /* @__PURE__ */ jsxRuntime.jsxs(React8__default.default.Fragment, { children: [
               idx > 0 && /* @__PURE__ */ jsxRuntime.jsx(
                 exports.Icon,
                 {
@@ -5166,7 +5226,7 @@ var init_Textarea = __esm({
   "components/core/atoms/Textarea.tsx"() {
     init_cn();
     init_useEventBus();
-    Textarea = React7__default.default.forwardRef(
+    Textarea = React8__default.default.forwardRef(
       ({ className, error, onChange, ...props }, ref) => {
         const eventBus = useEventBus();
         const handleChange = (e) => {
@@ -5200,7 +5260,7 @@ var init_Textarea = __esm({
     Textarea.displayName = "Textarea";
   }
 });
-var variantStyles5, sizeStyles2, Badge;
+var variantStyles5, sizeStyles3, Badge;
 var init_Badge = __esm({
   "components/core/atoms/Badge.tsx"() {
     init_cn();
@@ -5237,12 +5297,12 @@ var init_Badge = __esm({
         "border-[length:var(--border-width-thin)] border-border"
       ].join(" ")
     };
-    sizeStyles2 = {
+    sizeStyles3 = {
       sm: "px-2 py-0.5 text-xs",
       md: "px-2.5 py-1 text-sm",
       lg: "px-3 py-1.5 text-base"
     };
-    Badge = React7__default.default.forwardRef(
+    Badge = React8__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",
@@ -5257,7 +5317,7 @@ var init_Badge = __esm({
             className: cn(
               "inline-flex items-center gap-1 font-bold rounded-sm",
               variantStyles5[variant],
-              sizeStyles2[size],
+              sizeStyles3[size],
               onRemove && "pr-1",
               className
             ),
@@ -5291,33 +5351,6 @@ var init_Badge = __esm({
     Badge.displayName = "Badge";
   }
 });
-var sizeStyles3, Spinner;
-var init_Spinner = __esm({
-  "components/core/atoms/Spinner.tsx"() {
-    init_cn();
-    init_Icon();
-    sizeStyles3 = {
-      xs: "h-3 w-3",
-      sm: "h-icon-default w-icon-default",
-      md: "h-6 w-6",
-      lg: "h-8 w-8"
-    };
-    Spinner = React7__default.default.forwardRef(
-      ({ className, size = "md", ...props }, ref) => {
-        return /* @__PURE__ */ jsxRuntime.jsx(
-          "div",
-          {
-            ref,
-            className: cn("text-foreground", className),
-            ...props,
-            children: /* @__PURE__ */ jsxRuntime.jsx(exports.Icon, { name: "loader", className: cn("animate-spin", sizeStyles3[size]) })
-          }
-        );
-      }
-    );
-    Spinner.displayName = "Spinner";
-  }
-});
 
 // components/game/atoms/index.ts
 var init_atoms = __esm({
@@ -5366,11 +5399,11 @@ var init_Tabs = __esm({
       const eventBus = useEventBus();
       const { t } = useTranslate();
       const initialActive = safeItems.find((item) => item.active)?.id;
-      const [internalActiveTab, setInternalActiveTab] = React7.useState(
+      const [internalActiveTab, setInternalActiveTab] = React8.useState(
         defaultActiveTab || initialActive || safeItems[0]?.id || ""
       );
       const activeTab = controlledActiveTab !== void 0 ? controlledActiveTab : internalActiveTab;
-      const tabRefs = React7.useRef({});
+      const tabRefs = React8.useRef({});
       const handleTabChange = (tabId, tabEvent) => {
         if (controlledActiveTab === void 0) {
           setInternalActiveTab(tabId);
@@ -5862,7 +5895,7 @@ var init_CodeBlock = __esm({
     };
     LINE_PROPS_FN = (n) => ({ "data-line": String(n - 1) });
     HIDDEN_LINE_NUMBERS = { display: "none" };
-    exports.DocCodeBlock = React7__default.default.memo(
+    exports.DocCodeBlock = React8__default.default.memo(
       ({
         code: rawCode,
         language = "text",
@@ -5894,16 +5927,16 @@ var init_CodeBlock = __esm({
         const activeStyle = isOrb ? orbStyle : isLolo ? loloStyle : dark__default.default;
         const eventBus = useEventBus();
         const { t } = useTranslate();
-        const scrollRef = React7.useRef(null);
-        const codeRef = React7.useRef(null);
-        const savedScrollLeftRef = React7.useRef(0);
-        const [copied, setCopied] = React7.useState(false);
-        const [wrap, setWrap] = React7.useState(wordWrap);
-        const [activeFileIndex, setActiveFileIndex] = React7.useState(0);
+        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 activeFile = files?.[activeFileIndex];
         const activeCode = activeFile?.code ?? code;
         const activeLanguage = activeFile?.language ?? language;
-        const diffLines = React7.useMemo(() => {
+        const diffLines = React8.useMemo(() => {
           if (propDiff) return propDiff;
           if (mode === "diff" && oldValue !== void 0 && newValue !== void 0) {
             return generateDiff(oldValue, newValue);
@@ -5912,19 +5945,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] = React7.useState(code);
-        const [editableTextareaKey, setEditableTextareaKey] = React7.useState(0);
-        const lastPropCodeRef = React7.useRef(code);
-        const editableTextareaRef = React7.useRef(null);
-        const editableOverlayRef = React7.useRef(null);
-        React7.useEffect(() => {
+        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(() => {
           if (code !== lastPropCodeRef.current) {
             lastPropCodeRef.current = code;
             setEditableValue(code);
             setEditableTextareaKey((k) => k + 1);
           }
         }, [code]);
-        const handleEditableScroll = React7.useCallback(() => {
+        const handleEditableScroll = React8.useCallback(() => {
           const ta = editableTextareaRef.current;
           const ov = editableOverlayRef.current;
           if (ta && ov) {
@@ -5932,7 +5965,7 @@ var init_CodeBlock = __esm({
             ov.scrollLeft = ta.scrollLeft;
           }
         }, []);
-        const errorLineProps = React7.useMemo(() => {
+        const errorLineProps = React8.useMemo(() => {
           if (!errorLines || errorLines.size === 0) {
             return LINE_PROPS_FN;
           }
@@ -5955,17 +5988,17 @@ var init_CodeBlock = __esm({
           };
         }, [errorLines]);
         const isFoldable = foldableProp ?? true;
-        const [collapsed, setCollapsed] = React7.useState(() => /* @__PURE__ */ new Set());
-        const foldRegions = React7.useMemo(
+        const [collapsed, setCollapsed] = React8.useState(() => /* @__PURE__ */ new Set());
+        const foldRegions = React8.useMemo(
           () => isFoldable ? computeFoldRegions(code) : [],
           [code, isFoldable]
         );
-        const foldStartMap = React7.useMemo(() => {
+        const foldStartMap = React8.useMemo(() => {
           const m = /* @__PURE__ */ new Map();
           for (const r2 of foldRegions) m.set(r2.start, r2);
           return m;
         }, [foldRegions]);
-        const hiddenLines = React7.useMemo(() => {
+        const hiddenLines = React8.useMemo(() => {
           const h = /* @__PURE__ */ new Set();
           for (const r2 of foldRegions) {
             if (!collapsed.has(r2.start)) continue;
@@ -5973,13 +6006,13 @@ var init_CodeBlock = __esm({
           }
           return h;
         }, [foldRegions, collapsed]);
-        const collapsedRef = React7.useRef(collapsed);
+        const collapsedRef = React8.useRef(collapsed);
         collapsedRef.current = collapsed;
-        const foldStartMapRef = React7.useRef(foldStartMap);
+        const foldStartMapRef = React8.useRef(foldStartMap);
         foldStartMapRef.current = foldStartMap;
-        const hiddenLinesRef = React7.useRef(hiddenLines);
+        const hiddenLinesRef = React8.useRef(hiddenLines);
         hiddenLinesRef.current = hiddenLines;
-        const toggleFold = React7.useCallback((lineNum) => {
+        const toggleFold = React8.useCallback((lineNum) => {
           setCollapsed((prev) => {
             const next = new Set(prev);
             if (next.has(lineNum)) next.delete(lineNum);
@@ -5987,12 +6020,12 @@ var init_CodeBlock = __esm({
             return next;
           });
         }, []);
-        const toggleFoldRef = React7.useRef(toggleFold);
+        const toggleFoldRef = React8.useRef(toggleFold);
         toggleFoldRef.current = toggleFold;
-        React7.useEffect(() => {
+        React8.useEffect(() => {
           setCollapsed(/* @__PURE__ */ new Set());
         }, [code]);
-        const highlightedElement = React7.useMemo(
+        const highlightedElement = React8.useMemo(
           () => /* @__PURE__ */ jsxRuntime.jsx(
             SyntaxHighlighter__default.default,
             {
@@ -6017,7 +6050,7 @@ var init_CodeBlock = __esm({
           ),
           [code, language, activeStyle]
         );
-        React7.useLayoutEffect(() => {
+        React8.useLayoutEffect(() => {
           const container = codeRef.current;
           if (!container) return;
           container.querySelectorAll(".fold-toggle, .fold-summary").forEach((el) => el.remove());
@@ -6061,17 +6094,17 @@ var init_CodeBlock = __esm({
             }
           });
         }, [collapsed, hiddenLines, foldStartMap, foldRegions, isFoldable]);
-        React7.useLayoutEffect(() => {
+        React8.useLayoutEffect(() => {
           const el = scrollRef.current;
           return () => {
             if (el) savedScrollLeftRef.current = el.scrollLeft;
           };
         }, [language, code]);
-        React7.useLayoutEffect(() => {
+        React8.useLayoutEffect(() => {
           const el = scrollRef.current;
           if (el) el.scrollLeft = savedScrollLeftRef.current;
         }, [language, code]);
-        React7.useEffect(() => {
+        React8.useEffect(() => {
           const el = scrollRef.current;
           if (!el) return;
           const handle = () => {
@@ -6091,7 +6124,7 @@ var init_CodeBlock = __esm({
             eventBus.emit("UI:COPY_CODE", { language: activeLanguage, success: false });
           }
         };
-        const handleSelectionCopy = React7.useCallback((e) => {
+        const handleSelectionCopy = React8.useCallback((e) => {
           if (hiddenLinesRef.current.size === 0) return;
           const sel = typeof window !== "undefined" ? window.getSelection() : null;
           if (!sel || sel.rangeCount === 0 || sel.isCollapsed) return;
@@ -6537,13 +6570,13 @@ function DocSearch({
 }) {
   const { t } = useTranslate();
   const resolvedPlaceholder = placeholder ?? t("docSearch.placeholder");
-  const [query, setQuery] = React7.useState("");
-  const [results, setResults] = React7.useState([]);
-  const [isOpen, setIsOpen] = React7.useState(false);
-  const [activeIndex, setActiveIndex] = React7.useState(-1);
-  const containerRef = React7.useRef(null);
-  const debounceRef = React7.useRef(void 0);
-  React7.useEffect(() => {
+  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(() => {
     function handleClickOutside(e) {
       if (containerRef.current && !containerRef.current.contains(e.target)) {
         setIsOpen(false);
@@ -6552,7 +6585,7 @@ function DocSearch({
     document.addEventListener("mousedown", handleClickOutside);
     return () => document.removeEventListener("mousedown", handleClickOutside);
   }, []);
-  const performSearch = React7.useCallback(
+  const performSearch = React8.useCallback(
     (value) => {
       if (!onSearch || !value.trim()) {
         setResults([]);
@@ -6574,7 +6607,7 @@ function DocSearch({
     },
     [onSearch]
   );
-  const handleChange = React7.useCallback(
+  const handleChange = React8.useCallback(
     (e) => {
       const value = e.target.value;
       setQuery(value);
@@ -6587,18 +6620,18 @@ function DocSearch({
     },
     [performSearch]
   );
-  const handleFocus = React7.useCallback(() => {
+  const handleFocus = React8.useCallback(() => {
     if (results.length > 0) {
       setIsOpen(true);
     }
   }, [results]);
-  const navigateTo = React7.useCallback((href) => {
+  const navigateTo = React8.useCallback((href) => {
     setIsOpen(false);
     setQuery("");
     setResults([]);
     window.location.href = href;
   }, []);
-  const handleKeyDown = React7.useCallback(
+  const handleKeyDown = React8.useCallback(
     (e) => {
       if (e.key === "Escape") {
         setIsOpen(false);
@@ -6625,7 +6658,7 @@ function DocSearch({
     },
     [isOpen, results, activeIndex, navigateTo]
   );
-  React7.useEffect(() => {
+  React8.useEffect(() => {
     return () => {
       if (debounceRef.current) {
         clearTimeout(debounceRef.current);