@mieweb/ui 0.7.1-dev.7 → 0.7.1-dev.9

package/dist/{chunk-4GXECTPS.cjs → chunk-XB54G7WS.cjs}

@@ -2,7 +2,38 @@
 
 var react = require('react');
 
-// src/hooks/useKeyboardShortcut.ts
+// src/hooks/useDirection.ts
+var RTL_LOCALES = ["ar", "he", "fa", "ur"];
+function isRtlLocale(locale) {
+  const lang = locale.toLowerCase().split(/[-_]/)[0];
+  return RTL_LOCALES.includes(lang);
+}
+function resolveDirection(element) {
+  if (typeof document === "undefined") return "ltr";
+  const target = element ?? document.documentElement;
+  return getComputedStyle(target).direction === "rtl" ? "rtl" : "ltr";
+}
+function useDirection(elementRef) {
+  const [direction, setDirection] = react.useState(
+    () => resolveDirection(elementRef?.current)
+  );
+  react.useEffect(() => {
+    const update = () => setDirection(resolveDirection(elementRef?.current));
+    update();
+    const observer = new MutationObserver(update);
+    observer.observe(document.documentElement, {
+      attributes: true,
+      attributeFilter: ["dir"],
+      subtree: true
+    });
+    return () => observer.disconnect();
+  }, [elementRef]);
+  const currentElement = elementRef?.current ?? null;
+  react.useEffect(() => {
+    setDirection(resolveDirection(currentElement));
+  }, [currentElement]);
+  return direction;
+}
 function useKeyboardShortcut(key, callback, options = {}) {
   const {
     enabled = true,
@@ -179,7 +210,10 @@ function useScrollSpy({
   return { activeId };
 }
 
+exports.RTL_LOCALES = RTL_LOCALES;
+exports.isRtlLocale = isRtlLocale;
 exports.useCommandK = useCommandK;
+exports.useDirection = useDirection;
 exports.useIsDesktop = useIsDesktop;
 exports.useIsLargeDesktop = useIsLargeDesktop;
 exports.useIsMobile = useIsMobile;
@@ -189,5 +223,5 @@ exports.useIsTablet = useIsTablet;
 exports.useKeyboardShortcut = useKeyboardShortcut;
 exports.useMediaQuery = useMediaQuery;
 exports.useScrollSpy = useScrollSpy;
-//# sourceMappingURL=chunk-4GXECTPS.cjs.map
-//# sourceMappingURL=chunk-4GXECTPS.cjs.map
+//# sourceMappingURL=chunk-XB54G7WS.cjs.map
+//# sourceMappingURL=chunk-XB54G7WS.cjs.map

package/dist/chunk-XB54G7WS.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/useDirection.ts","../src/hooks/useKeyboardShortcut.ts","../src/hooks/useMediaQuery.ts","../src/hooks/useScrollSpy.ts"],"names":["useState","useEffect","useCallback","useRef","entries"],"mappings":"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","file":"chunk-XB54G7WS.cjs","sourcesContent":["import { useState, useEffect } from 'react';\nimport type { RefObject } from 'react';\n\nexport type Direction = 'ltr' | 'rtl';\n\n/** Locales whose primary script reads right-to-left. */\nexport const RTL_LOCALES = ['ar', 'he', 'fa', 'ur'] as const;\n\n/**\n * Returns true when the given locale (e.g. `ar`, `ar-SA`, `he_IL`) uses a\n * right-to-left script.\n */\nexport function isRtlLocale(locale: string): boolean {\n  const lang = locale.toLowerCase().split(/[-_]/)[0];\n  return (RTL_LOCALES as readonly string[]).includes(lang);\n}\n\nfunction resolveDirection(element?: HTMLElement | null): Direction {\n  if (typeof document === 'undefined') return 'ltr';\n  const target = element ?? document.documentElement;\n  return getComputedStyle(target).direction === 'rtl' ? 'rtl' : 'ltr';\n}\n\n/**\n * Hook returning the effective text direction (`ltr` | `rtl`) inherited from\n * the nearest `dir` attribute — zero setup for consumers who set\n * `<html dir=\"rtl\">`.\n *\n * Use for JS-level direction logic that CSS logical properties can't cover:\n * inverting ArrowLeft/ArrowRight keyboard handling, popover/toast placement,\n * drag math, etc.\n *\n * @param elementRef - Optional ref; when provided, direction is resolved from\n *   that element (respecting any local `dir` override) instead of `<html>`.\n *\n * @example\n * ```tsx\n * const direction = useDirection();\n * const nextKey = direction === 'rtl' ? 'ArrowLeft' : 'ArrowRight';\n * ```\n */\nexport function useDirection(\n  elementRef?: RefObject<HTMLElement | null>\n): Direction {\n  const [direction, setDirection] = useState<Direction>(() =>\n    resolveDirection(elementRef?.current)\n  );\n\n  useEffect(() => {\n    const update = () => setDirection(resolveDirection(elementRef?.current));\n    update();\n    // dir changes are rare; observing the whole tree for just this attribute is cheap.\n    const observer = new MutationObserver(update);\n    observer.observe(document.documentElement, {\n      attributes: true,\n      attributeFilter: ['dir'],\n      subtree: true,\n    });\n    return () => observer.disconnect();\n  }, [elementRef]);\n\n  // Re-sync when a re-render points elementRef.current at a different node:\n  // the MutationObserver only fires on `dir` attribute mutations, so a swapped\n  // ref target with a different inherited direction would otherwise go stale.\n  const currentElement = elementRef?.current ?? null;\n  useEffect(() => {\n    setDirection(resolveDirection(currentElement));\n  }, [currentElement]);\n\n  return direction;\n}\n","import { useEffect, useCallback } from 'react';\n\n/**\n * Options for keyboard shortcut hook\n */\nexport interface KeyboardShortcutOptions {\n  /** Whether the shortcut is currently enabled (default: true) */\n  enabled?: boolean;\n  /** Modifier keys required (default: none) */\n  modifiers?: {\n    ctrl?: boolean;\n    shift?: boolean;\n    alt?: boolean;\n    meta?: boolean;\n  };\n  /** Whether to prevent default browser behavior (default: true) */\n  preventDefault?: boolean;\n  /** Whether to stop event propagation (default: false) */\n  stopPropagation?: boolean;\n  /** Element types to ignore when the shortcut is pressed (default: ['INPUT', 'TEXTAREA', 'SELECT']) */\n  ignoreInputs?: boolean;\n}\n\n/**\n * Hook that triggers a callback when a specific keyboard shortcut is pressed.\n * Supports modifier keys (Ctrl, Shift, Alt, Meta) and ignores input fields by default.\n *\n * @param key - The key to listen for (e.g., 'k', 'Enter', 'Escape', '/')\n * @param callback - Function to call when the shortcut is pressed\n * @param options - Configuration options\n *\n * @example\n * ```tsx\n * // Cmd/Ctrl+K to open search\n * useKeyboardShortcut('k', openSearch, { modifiers: { meta: true, ctrl: true } });\n *\n * // Forward slash to focus search (ignoring when typing)\n * useKeyboardShortcut('/', focusSearch);\n *\n * // Escape to close modal\n * useKeyboardShortcut('Escape', closeModal);\n * ```\n */\nexport function useKeyboardShortcut(\n  key: string,\n  callback: (event: KeyboardEvent) => void,\n  options: KeyboardShortcutOptions = {}\n): void {\n  const {\n    enabled = true,\n    modifiers = {},\n    preventDefault = true,\n    stopPropagation = false,\n    ignoreInputs = true,\n  } = options;\n\n  const handleKeyDown = useCallback(\n    (event: KeyboardEvent) => {\n      // Check if we should ignore input fields\n      if (ignoreInputs) {\n        const target = event.target as HTMLElement;\n        const tagName = target.tagName.toUpperCase();\n        if (\n          tagName === 'INPUT' ||\n          tagName === 'TEXTAREA' ||\n          tagName === 'SELECT' ||\n          target.isContentEditable\n        ) {\n          return;\n        }\n      }\n\n      // Check modifiers\n      const { ctrl, shift, alt, meta } = modifiers;\n\n      // For Cmd+K style shortcuts, allow either meta (Mac) or ctrl (Windows/Linux)\n      const metaOrCtrl = meta || ctrl;\n      if (metaOrCtrl) {\n        if (!(event.metaKey || event.ctrlKey)) return;\n      } else {\n        // If no meta/ctrl modifier specified, ensure neither is pressed\n        if (event.metaKey || event.ctrlKey) return;\n      }\n\n      if (shift && !event.shiftKey) return;\n      if (alt && !event.altKey) return;\n\n      // Check key match (case-insensitive for letters)\n      const eventKey =\n        event.key.length === 1 ? event.key.toLowerCase() : event.key;\n      const targetKey = key.length === 1 ? key.toLowerCase() : key;\n      if (eventKey !== targetKey) return;\n\n      if (preventDefault) {\n        event.preventDefault();\n      }\n      if (stopPropagation) {\n        event.stopPropagation();\n      }\n\n      callback(event);\n    },\n    [key, callback, modifiers, preventDefault, stopPropagation, ignoreInputs]\n  );\n\n  useEffect(() => {\n    if (!enabled) return;\n\n    document.addEventListener('keydown', handleKeyDown);\n    return () => document.removeEventListener('keydown', handleKeyDown);\n  }, [handleKeyDown, enabled]);\n}\n\n/**\n * Hook for the common Cmd/Ctrl+K shortcut pattern (command palette, search, etc.)\n *\n * @param callback - Function to call when Cmd/Ctrl+K is pressed\n * @param enabled - Whether the shortcut is active (default: true)\n *\n * @example\n * ```tsx\n * useCommandK(() => setIsOpen(true));\n * ```\n */\nexport function useCommandK(callback: () => void, enabled = true): void {\n  useKeyboardShortcut('k', callback, {\n    enabled,\n    modifiers: { meta: true, ctrl: true },\n    ignoreInputs: false, // Cmd+K should work even in inputs\n  });\n}\n","import { useState, useEffect } from 'react';\n\n/**\n * Hook that tracks whether a media query matches.\n * Uses the native `matchMedia` API for efficient media query tracking.\n *\n * @param query - CSS media query string (e.g., '(min-width: 768px)')\n * @returns Boolean indicating whether the media query matches\n *\n * @example\n * ```tsx\n * function ResponsiveComponent() {\n *   const isMobile = useMediaQuery('(max-width: 767px)');\n *   const isTablet = useMediaQuery('(min-width: 768px) and (max-width: 1023px)');\n *   const isDesktop = useMediaQuery('(min-width: 1024px)');\n *\n *   return (\n *     <div>\n *       {isMobile && <MobileLayout />}\n *       {isTablet && <TabletLayout />}\n *       {isDesktop && <DesktopLayout />}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useMediaQuery(query: string): boolean {\n  // Initialize with null to indicate SSR/initial state\n  const [matches, setMatches] = useState<boolean>(() => {\n    // Check if we're in a browser environment\n    if (typeof window === 'undefined') return false;\n    return window.matchMedia(query).matches;\n  });\n\n  useEffect(() => {\n    if (typeof window === 'undefined') return;\n\n    const mediaQuery = window.matchMedia(query);\n\n    // Set initial value\n    setMatches(mediaQuery.matches);\n\n    // Handler for media query changes\n    const handler = (event: MediaQueryListEvent) => {\n      setMatches(event.matches);\n    };\n\n    // Modern browsers use addEventListener\n    if (mediaQuery.addEventListener) {\n      mediaQuery.addEventListener('change', handler);\n      return () => mediaQuery.removeEventListener('change', handler);\n    }\n\n    // Fallback for older browsers\n    mediaQuery.addListener(handler);\n    return () => mediaQuery.removeListener(handler);\n  }, [query]);\n\n  return matches;\n}\n\n/**\n * Preset breakpoint hooks following common responsive design patterns\n */\n\n/** Returns true when viewport is smaller than 640px (mobile) */\nexport function useIsMobile(): boolean {\n  return useMediaQuery('(max-width: 639px)');\n}\n\n/** Returns true when viewport is 640px-767px (large mobile / small tablet) */\nexport function useIsSmallTablet(): boolean {\n  return useMediaQuery('(min-width: 640px) and (max-width: 767px)');\n}\n\n/** Returns true when viewport is 768px-1023px (tablet) */\nexport function useIsTablet(): boolean {\n  return useMediaQuery('(min-width: 768px) and (max-width: 1023px)');\n}\n\n/** Returns true when viewport is 1024px or larger (desktop) */\nexport function useIsDesktop(): boolean {\n  return useMediaQuery('(min-width: 1024px)');\n}\n\n/** Returns true when viewport is 1280px or larger (large desktop) */\nexport function useIsLargeDesktop(): boolean {\n  return useMediaQuery('(min-width: 1280px)');\n}\n\n/** Returns true when viewport is smaller than 1024px (mobile/tablet) */\nexport function useIsMobileOrTablet(): boolean {\n  return useMediaQuery('(max-width: 1023px)');\n}\n","import { useEffect, useState, useRef, type RefObject } from 'react';\n\n// =============================================================================\n// Types\n// =============================================================================\n\nexport interface UseScrollSpyOptions {\n  /** CSS selector for the elements to observe (e.g. 'h2, h3, h4') */\n  selectors?: string;\n  /** Explicit list of element IDs to observe (alternative to selectors) */\n  ids?: string[];\n  /** IntersectionObserver root margin (default: '0px 0px -60% 0px') */\n  rootMargin?: string;\n  /** IntersectionObserver threshold (default: 0) */\n  threshold?: number | number[];\n  /** Scroll container element ref. Defaults to document viewport. */\n  root?: RefObject<HTMLElement | null>;\n  /** Whether the hook is active (default: true) */\n  enabled?: boolean;\n}\n\nexport interface UseScrollSpyReturn {\n  /** The ID of the currently active (in-view) element */\n  activeId: string | null;\n}\n\n// =============================================================================\n// Hook\n// =============================================================================\n\n/**\n * Tracks which section is currently in the viewport using IntersectionObserver.\n * Pairs naturally with `TableOfContents` to highlight the active heading.\n *\n * @example\n * ```tsx\n * function DocsPage() {\n *   const { activeId } = useScrollSpy({ selectors: 'h2, h3' });\n *   return (\n *     <aside>\n *       <TableOfContents activeId={activeId} />\n *     </aside>\n *   );\n * }\n * ```\n */\nexport function useScrollSpy({\n  selectors,\n  ids,\n  rootMargin = '0px 0px -60% 0px',\n  threshold = 0,\n  root,\n  enabled = true,\n}: UseScrollSpyOptions = {}): UseScrollSpyReturn {\n  const [activeId, setActiveId] = useState<string | null>(null);\n  const visibleEntries = useRef<Map<string, IntersectionObserverEntry>>(\n    new Map()\n  );\n\n  // Track root.current so the effect re-runs when the ref attaches\n  const rootEl = root?.current ?? null;\n\n  useEffect(() => {\n    if (!enabled) return;\n\n    const container = rootEl ?? document;\n\n    // Resolve target elements from the DOM\n    function resolveElements(): Element[] {\n      let els: Element[] = [];\n      if (ids && ids.length > 0) {\n        els = ids\n          .map((id) => document.getElementById(id))\n          .filter((el): el is HTMLElement => el !== null);\n      } else if (selectors) {\n        els = Array.from(container.querySelectorAll(selectors));\n      }\n      return els.filter((el) => el.id);\n    }\n\n    let intersectionObserver: IntersectionObserver | null = null;\n    let mutationObserver: MutationObserver | null = null;\n\n    function startObserving(): boolean {\n      const elements = resolveElements();\n      if (elements.length === 0) return false;\n\n      intersectionObserver = new IntersectionObserver(\n        (entries) => {\n          for (const entry of entries) {\n            if (entry.isIntersecting) {\n              visibleEntries.current.set(entry.target.id, entry);\n            } else {\n              visibleEntries.current.delete(entry.target.id);\n            }\n          }\n\n          // Pick the topmost visible heading (by DOM order)\n          if (visibleEntries.current.size > 0) {\n            let topmost: string | null = null;\n            let topmostTop = Infinity;\n\n            for (const [id, entry] of visibleEntries.current) {\n              const top = entry.boundingClientRect.top;\n              if (top < topmostTop) {\n                topmostTop = top;\n                topmost = id;\n              }\n            }\n\n            if (topmost) {\n              setActiveId(topmost);\n            }\n          }\n        },\n        {\n          root: rootEl,\n          rootMargin,\n          threshold,\n        }\n      );\n\n      for (const el of elements) {\n        intersectionObserver.observe(el);\n      }\n\n      // Elements found — stop watching for new DOM nodes\n      mutationObserver?.disconnect();\n      mutationObserver = null;\n      return true;\n    }\n\n    // If target elements don't exist yet (e.g. headings mount after ToC),\n    // watch for DOM changes and retry until they appear.\n    if (!startObserving()) {\n      const watchRoot = rootEl ?? document.body;\n      mutationObserver = new MutationObserver(() => {\n        startObserving();\n      });\n      mutationObserver.observe(watchRoot, { childList: true, subtree: true });\n    }\n\n    const entries = visibleEntries.current;\n    return () => {\n      mutationObserver?.disconnect();\n      intersectionObserver?.disconnect();\n      entries.clear();\n    };\n  }, [selectors, ids, rootMargin, threshold, rootEl, enabled]);\n\n  return { activeId };\n}\n"]}

package/dist/{chunk-MAMY5HTT.cjs → chunk-XCVBCY7L.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
 var chunkZDEYV373_cjs = require('./chunk-ZDEYV373.cjs');
-var chunkOR5DRJCW_cjs = require('./chunk-OR5DRJCW.cjs');
+var chunkS5RVSXDV_cjs = require('./chunk-S5RVSXDV.cjs');
 var React2 = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 var reactDom = require('react-dom');
@@ -81,7 +81,7 @@ function AttachmentPreviewItem({
   return /* @__PURE__ */ jsxRuntime.jsxs(
     "div",
     {
-      className: chunkOR5DRJCW_cjs.cn(
+      className: chunkS5RVSXDV_cjs.cn(
         "group relative overflow-hidden rounded-lg",
         "bg-neutral-100 dark:bg-neutral-800",
         "border border-neutral-200 dark:border-neutral-700",
@@ -95,7 +95,7 @@ function AttachmentPreviewItem({
             {
               src: previewUrl,
               alt: file.name,
-              className: chunkOR5DRJCW_cjs.cn(
+              className: chunkS5RVSXDV_cjs.cn(
                 "h-full w-full object-cover",
                 (isUploading || isFailed) && "opacity-50"
               )
@@ -207,7 +207,7 @@ function AttachmentPreviewItem({
           {
             type: "button",
             onClick: onRemove,
-            className: chunkOR5DRJCW_cjs.cn(
+            className: chunkS5RVSXDV_cjs.cn(
               "absolute -top-1 -right-1 z-10",
               "rounded-full p-1",
               "bg-neutral-900 text-white",
@@ -240,7 +240,7 @@ function AttachmentPreviewItem({
         /* @__PURE__ */ jsxRuntime.jsx(
           "div",
           {
-            className: chunkOR5DRJCW_cjs.cn(
+            className: chunkS5RVSXDV_cjs.cn(
               "absolute right-0 bottom-0 left-0",
               "bg-black/70 px-1 py-0.5",
               "opacity-0 group-hover:opacity-100",
@@ -313,7 +313,7 @@ var AttachmentPicker = React2__namespace.forwardRef(
           onClick: handleClick,
           disabled,
           "data-slot": "attachment-picker-button",
-          className: chunkOR5DRJCW_cjs.cn(
+          className: chunkS5RVSXDV_cjs.cn(
             "inline-flex items-center justify-center",
             "rounded-full p-2",
             "text-neutral-500 hover:text-neutral-700",
@@ -415,13 +415,13 @@ function DragDropZone({
       onDragLeave: handleDragLeave,
       onDragOver: handleDragOver,
       onDrop: handleDrop,
-      className: chunkOR5DRJCW_cjs.cn("relative", className),
+      className: chunkS5RVSXDV_cjs.cn("relative", className),
       children: [
         children,
         isDragging && /* @__PURE__ */ jsxRuntime.jsx(
           "div",
           {
-            className: chunkOR5DRJCW_cjs.cn(
+            className: chunkS5RVSXDV_cjs.cn(
               "absolute inset-0 z-50",
               "flex items-center justify-center",
               "bg-primary-50/90 dark:bg-primary-900/90",
@@ -494,7 +494,7 @@ function CameraButton({
         type: "button",
         onClick: handleClick,
         disabled,
-        className: chunkOR5DRJCW_cjs.cn(
+        className: chunkS5RVSXDV_cjs.cn(
           "inline-flex items-center justify-center",
           "rounded-full p-2",
           "text-neutral-500 hover:text-neutral-700",
@@ -571,7 +571,7 @@ function CharacterCounter({
   return /* @__PURE__ */ jsxRuntime.jsxs(
     "span",
     {
-      className: chunkOR5DRJCW_cjs.cn(
+      className: chunkS5RVSXDV_cjs.cn(
         "text-xs tabular-nums",
         isOver ? "font-medium text-red-700 dark:text-red-400" : isWarning ? "text-amber-700 dark:text-amber-400" : "text-neutral-600 dark:text-neutral-400",
         className
@@ -628,7 +628,7 @@ var SendButton = React2__namespace.forwardRef(
         type: "submit",
         disabled: disabled || !canSend || isLoading,
         "data-slot": "composer-send-button",
-        className: chunkOR5DRJCW_cjs.cn(sendButtonVariants({ variant, canSend }), className),
+        className: chunkS5RVSXDV_cjs.cn(sendButtonVariants({ variant, canSend }), className),
         "aria-label": isLoading ? "Sending message" : "Send message",
         ...props,
         children: isLoading ? /* @__PURE__ */ jsxRuntime.jsxs(
@@ -925,7 +925,7 @@ var MessageComposer = React2__namespace.forwardRef(
         maxFiles: maxAttachments - attachments.length,
         disabled: disabled || attachments.length >= maxAttachments,
         onError,
-        className: chunkOR5DRJCW_cjs.cn("w-full", className),
+        className: chunkS5RVSXDV_cjs.cn("w-full", className),
         children: /* @__PURE__ */ jsxRuntime.jsxs(
           "form",
           {
@@ -937,7 +937,7 @@ var MessageComposer = React2__namespace.forwardRef(
                 "div",
                 {
                   "data-slot": "composer-reply-preview",
-                  className: chunkOR5DRJCW_cjs.cn(
+                  className: chunkS5RVSXDV_cjs.cn(
                     "flex items-center gap-2 px-4 py-2",
                     "bg-neutral-50 dark:bg-neutral-800/50",
                     "border-primary-500 border-l-4"
@@ -955,7 +955,7 @@ var MessageComposer = React2__namespace.forwardRef(
                       {
                         type: "button",
                         onClick: onCancelReply,
-                        className: chunkOR5DRJCW_cjs.cn(
+                        className: chunkS5RVSXDV_cjs.cn(
                           "shrink-0 rounded p-1",
                           "text-neutral-500 hover:text-neutral-700",
                           "dark:text-neutral-400 dark:hover:text-neutral-200",
@@ -990,7 +990,7 @@ var MessageComposer = React2__namespace.forwardRef(
                 "div",
                 {
                   "data-slot": "composer-attachments",
-                  className: chunkOR5DRJCW_cjs.cn(
+                  className: chunkS5RVSXDV_cjs.cn(
                     "flex flex-wrap gap-2 p-3",
                     "border-t border-neutral-200 dark:border-neutral-700"
                   ),
@@ -1008,7 +1008,7 @@ var MessageComposer = React2__namespace.forwardRef(
                 "div",
                 {
                   "data-slot": "composer-input-area",
-                  className: chunkOR5DRJCW_cjs.cn(
+                  className: chunkS5RVSXDV_cjs.cn(
                     "flex items-center gap-2 p-3",
                     "bg-white dark:bg-neutral-900",
                     variant === "default" && "border-t border-neutral-200 dark:border-neutral-700"
@@ -1062,7 +1062,7 @@ var MessageComposer = React2__namespace.forwardRef(
                                       insertMention(option);
                                     },
                                     onMouseEnter: () => setMentionHighlight(i),
-                                    className: chunkOR5DRJCW_cjs.cn(
+                                    className: chunkS5RVSXDV_cjs.cn(
                                       "flex w-full items-center gap-2 px-3 py-1.5 text-left text-sm",
                                       i === clampedMentionHighlight ? "bg-primary-100 text-primary-900 dark:bg-primary-900/40 dark:text-primary-100" : "text-neutral-700 dark:text-neutral-200"
                                     ),
@@ -1102,7 +1102,7 @@ var MessageComposer = React2__namespace.forwardRef(
                               placeholder,
                               disabled: disabled || isSending,
                               rows: 1,
-                              className: chunkOR5DRJCW_cjs.cn(
+                              className: chunkS5RVSXDV_cjs.cn(
                                 "w-full resize-none rounded-2xl py-2.5",
                                 inputTrailing ? "pr-10 pl-4" : "px-4",
                                 "bg-neutral-100 dark:bg-neutral-800",
@@ -1173,5 +1173,5 @@ exports.generateAttachmentId = generateAttachmentId;
 exports.getFileType = getFileType;
 exports.sendButtonVariants = sendButtonVariants;
 exports.validateFile = validateFile;
-//# sourceMappingURL=chunk-MAMY5HTT.cjs.map
-//# sourceMappingURL=chunk-MAMY5HTT.cjs.map
+//# sourceMappingURL=chunk-XCVBCY7L.cjs.map
+//# sourceMappingURL=chunk-XCVBCY7L.cjs.map