@beweco/aurora-ui 1.0.0-beta.122 → 1.0.0-beta.124

package/dist/index.esm.js

@@ -1,7 +1,7 @@
-import { Card as Card$1, Breadcrumbs, ListBoxSection, ListBoxItem, Separator, ProgressBar, useOverlayState, Spinner, Button as Button$1, Chip as Chip$1, cn, CloseButton, Pagination as Pagination$1, Skeleton, Accordion, DatePicker as DatePicker$1, Label, DateField, Description, Calendar, FieldError, DateRangePicker as DateRangePicker$1, RangeCalendar, TextField, InputGroup, RadioGroup, Radio, Tabs, Dropdown, ComboBox, Input as Input$1, ListBox, Tooltip as Tooltip$2, DropdownTrigger, DropdownPopover, DropdownMenu, DropdownSection, DropdownItem, Badge as Badge$1, Popover, PopoverTrigger, PopoverContent, Header, Avatar, Link, Switch as Switch$1, TimeField, Select as Select$1, Table as Table$1, TextArea, toastVariants, WarningIcon, SuccessIcon, InfoIcon, DangerIcon, Modal as Modal$1, Slider, Drawer, Checkbox as Checkbox$1, ModalHeader as ModalHeader$1, ModalBody as ModalBody$1, ModalFooter as ModalFooter$1, Alert as Alert$1 } from '@heroui/react';
-export { Accordion, AccordionItem, Avatar, Breadcrumbs, CardFooter, CardHeader, CheckboxGroup, CloseButton, Drawer, DrawerBody, DrawerContent, DrawerFooter, DrawerHeader, Dropdown, DropdownItem, DropdownMenu, DropdownSection, DropdownTrigger, Link, Popover, PopoverContent, PopoverTrigger, Radio, RadioGroup, Skeleton, Slider, Spinner, Tab, TableBody, TableCell, TableColumn, TableHeader, TableRow, Tabs, cn } from '@heroui/react';
+import { Card as Card$1, Breadcrumbs, ListBoxSection, ListBoxItem, Separator, ProgressBar, useOverlayState, Spinner, Button as Button$1, Chip as Chip$1, cn, CloseButton, Pagination as Pagination$1, Skeleton, Accordion, DatePicker as DatePicker$1, Label, DateField, Description, Calendar, FieldError, DateRangePicker as DateRangePicker$1, RangeCalendar, TextField, InputGroup, RadioGroup, Radio, Tabs, Dropdown as Dropdown$1, ComboBox, Input as Input$1, ListBox, Tooltip as Tooltip$2, DropdownTrigger, DropdownPopover, DropdownMenu, DropdownSection as DropdownSection$1, DropdownItem, Badge as Badge$1, Popover, PopoverTrigger, PopoverContent, Header, Avatar, Link, Switch as Switch$1, TimeField, Select as Select$1, Table as Table$1, TextArea, toastVariants, WarningIcon, SuccessIcon, InfoIcon, DangerIcon, Modal as Modal$1, Slider, Drawer, Checkbox as Checkbox$1, ModalHeader as ModalHeader$1, ModalBody as ModalBody$1, ModalFooter as ModalFooter$1, Alert as Alert$1 } from '@heroui/react';
+export { Accordion, AccordionItem, Avatar, Breadcrumbs, CardFooter, CardHeader, CheckboxGroup, CloseButton, Drawer, DrawerBody, DrawerContent, DrawerFooter, DrawerHeader, DropdownItem, DropdownMenu, DropdownTrigger, Link, Popover, PopoverContent, PopoverTrigger, Radio, RadioGroup, Skeleton, Slider, Spinner, Tab, TableBody, TableCell, TableColumn, TableHeader, TableRow, Tabs, cn } from '@heroui/react';
 import { jsx, Fragment, jsxs } from 'react/jsx-runtime';
-import $8WNJc$react, { useState, useRef, useCallback, useEffect, useId, useMemo, isValidElement, cloneElement, forwardRef, useImperativeHandle, createContext, useContext, useLayoutEffect, memo, useReducer, Children, Fragment as Fragment$1 } from 'react';
+import $8WNJc$react, { useState, useRef, useCallback, useEffect, useId, forwardRef, useMemo, isValidElement, cloneElement, useImperativeHandle, createContext, useContext, useLayoutEffect, memo, useReducer, Children, Fragment as Fragment$1 } from 'react';
 import { Icon } from '@iconify/react';
 export { loadIcons } from '@iconify/react';
 import { ResponsiveContainer, AreaChart, CartesianGrid, XAxis, Tooltip as Tooltip$1, Area, LineChart, YAxis, Line, PieChart, Pie, Cell } from 'recharts';
@@ -1167,7 +1167,7 @@ const CALENDAR_CELL_CLASS$1 = "size-8 place-self-center rounded-full " +
  * (grid) para que la API pública siga siendo un único componente con props planas, igual que en
  * v2 (label, description, errorMessage, endContent, variant, size, radius).
  */
-function DatePicker({ label, description, errorMessage, id, size = "md", variant = "bordered", radius = "md", isInvalid = false, isRequired = false, isDisabled = false, fullWidth, endContent, className, "aria-label": ariaLabel, ...props }) {
+function DatePicker({ label, description, errorMessage, id, size = "md", variant = "bordered", radius = "md", isInvalid = false, isRequired = false, isDisabled = false, fullWidth, endContent, calendarBottomContent, className, "aria-label": ariaLabel, ...props }) {
     const generatedId = useId();
     const autoId = id || generatedId;
     const calendarLabel = (typeof label === "string" ? label : undefined) ?? ariaLabel ?? "Calendario";
@@ -1180,7 +1180,7 @@ function DatePicker({ label, description, errorMessage, id, size = "md", variant
                     FIELD_FOCUS_CLASS$5,
                 ]
                     .filter(Boolean)
-                    .join(" "), children: [jsx(DateField.Input, { className: SIZE_TEXT_CLASS$3[size], children: (segment) => jsx(DateField.Segment, { segment: segment }) }), jsx(DateField.Suffix, { children: jsx(DatePicker$1.Trigger, { children: endContent !== undefined ? (jsx(DatePicker$1.TriggerIndicator, { children: endContent })) : (jsx(DatePicker$1.TriggerIndicator, {})) }) })] }), description && !isInvalid && jsx(Description, { children: description }), jsx(DatePicker$1.Popover, { children: jsxs(Calendar, { "aria-label": calendarLabel, children: [jsxs(Calendar.Header, { children: [jsxs(Calendar.YearPickerTrigger, { children: [jsx(Calendar.YearPickerTriggerHeading, {}), jsx(Calendar.YearPickerTriggerIndicator, {})] }), jsx(Calendar.NavButton, { slot: "previous" }), jsx(Calendar.NavButton, { slot: "next" })] }), jsxs(Calendar.Grid, { children: [jsx(Calendar.GridHeader, { children: (day) => jsx(Calendar.HeaderCell, { children: day }) }), jsx(Calendar.GridBody, { children: (date) => (jsx(Calendar.Cell, { date: date, className: CALENDAR_CELL_CLASS$1 })) })] })] }) }), isInvalid && errorMessage && jsx(FieldError, { children: errorMessage })] }));
+                    .join(" "), children: [jsx(DateField.Input, { className: SIZE_TEXT_CLASS$3[size], children: (segment) => jsx(DateField.Segment, { segment: segment }) }), jsx(DateField.Suffix, { children: jsx(DatePicker$1.Trigger, { children: endContent !== undefined ? (jsx(DatePicker$1.TriggerIndicator, { children: endContent })) : (jsx(DatePicker$1.TriggerIndicator, {})) }) })] }), description && !isInvalid && jsx(Description, { children: description }), jsxs(DatePicker$1.Popover, { children: [jsxs(Calendar, { "aria-label": calendarLabel, children: [jsxs(Calendar.Header, { children: [jsxs(Calendar.YearPickerTrigger, { children: [jsx(Calendar.YearPickerTriggerHeading, {}), jsx(Calendar.YearPickerTriggerIndicator, {})] }), jsx(Calendar.NavButton, { slot: "previous" }), jsx(Calendar.NavButton, { slot: "next" })] }), jsxs(Calendar.Grid, { children: [jsx(Calendar.GridHeader, { children: (day) => jsx(Calendar.HeaderCell, { children: day }) }), jsx(Calendar.GridBody, { children: (date) => (jsx(Calendar.Cell, { date: date, className: CALENDAR_CELL_CLASS$1 })) })] })] }), calendarBottomContent] }), isInvalid && errorMessage && jsx(FieldError, { children: errorMessage })] }));
 }
 
 // Mismo mecanismo que DatePicker.tsx / Input.tsx / Select.tsx (findings/
@@ -1259,7 +1259,7 @@ const CALENDAR_CELL_CLASS = "data-[today=true]:not-data-[selected=true]:[&_[data
  * `DatePicker`, migrado en tándem. Compone `DateRangePicker.Root/Trigger/TriggerIndicator/
  * RangeSeparator/Popover` + `DateField` (dos segmentos, start/end) + `RangeCalendar`.
  */
-function DateRangePicker({ label, description, errorMessage, id, size = "md", variant = "bordered", radius = "md", isInvalid = false, isRequired = false, isDisabled = false, fullWidth, endContent, className, "aria-label": ariaLabel, ...props }) {
+function DateRangePicker({ label, description, errorMessage, id, size = "md", variant = "bordered", radius = "md", isInvalid = false, isRequired = false, isDisabled = false, fullWidth, endContent, calendarBottomContent, className, "aria-label": ariaLabel, ...props }) {
     const generatedId = useId();
     const autoId = id || generatedId;
     const calendarLabel = (typeof label === "string" ? label : undefined) ?? ariaLabel ?? "Rango de fechas";
@@ -1272,7 +1272,7 @@ function DateRangePicker({ label, description, errorMessage, id, size = "md", va
                     FIELD_FOCUS_CLASS$4,
                 ]
                     .filter(Boolean)
-                    .join(" "), children: [jsx(DateField.Input, { slot: "start", className: SIZE_TEXT_CLASS$2[size], children: (segment) => jsx(DateField.Segment, { segment: segment }) }), jsx(DateRangePicker$1.RangeSeparator, {}), jsx(DateField.Input, { slot: "end", className: SIZE_TEXT_CLASS$2[size], children: (segment) => jsx(DateField.Segment, { segment: segment }) }), jsx(DateField.Suffix, { children: jsx(DateRangePicker$1.Trigger, { children: endContent !== undefined ? (jsx(DateRangePicker$1.TriggerIndicator, { children: endContent })) : (jsx(DateRangePicker$1.TriggerIndicator, {})) }) })] }), description && !isInvalid && jsx(Description, { children: description }), jsx(DateRangePicker$1.Popover, { children: jsxs(RangeCalendar, { "aria-label": calendarLabel, children: [jsxs(RangeCalendar.Header, { children: [jsxs(RangeCalendar.YearPickerTrigger, { children: [jsx(RangeCalendar.YearPickerTriggerHeading, {}), jsx(RangeCalendar.YearPickerTriggerIndicator, {})] }), jsx(RangeCalendar.NavButton, { slot: "previous" }), jsx(RangeCalendar.NavButton, { slot: "next" })] }), jsxs(RangeCalendar.Grid, { children: [jsx(RangeCalendar.GridHeader, { children: (day) => jsx(RangeCalendar.HeaderCell, { children: day }) }), jsx(RangeCalendar.GridBody, { children: (date) => (jsx(RangeCalendar.Cell, { date: date, className: CALENDAR_CELL_CLASS })) })] })] }) }), isInvalid && errorMessage && jsx(FieldError, { children: errorMessage })] }));
+                    .join(" "), children: [jsx(DateField.Input, { slot: "start", className: SIZE_TEXT_CLASS$2[size], children: (segment) => jsx(DateField.Segment, { segment: segment }) }), jsx(DateRangePicker$1.RangeSeparator, {}), jsx(DateField.Input, { slot: "end", className: SIZE_TEXT_CLASS$2[size], children: (segment) => jsx(DateField.Segment, { segment: segment }) }), jsx(DateField.Suffix, { children: jsx(DateRangePicker$1.Trigger, { children: endContent !== undefined ? (jsx(DateRangePicker$1.TriggerIndicator, { children: endContent })) : (jsx(DateRangePicker$1.TriggerIndicator, {})) }) })] }), description && !isInvalid && jsx(Description, { children: description }), jsxs(DateRangePicker$1.Popover, { children: [jsxs(RangeCalendar, { "aria-label": calendarLabel, children: [jsxs(RangeCalendar.Header, { children: [jsxs(RangeCalendar.YearPickerTrigger, { children: [jsx(RangeCalendar.YearPickerTriggerHeading, {}), jsx(RangeCalendar.YearPickerTriggerIndicator, {})] }), jsx(RangeCalendar.NavButton, { slot: "previous" }), jsx(RangeCalendar.NavButton, { slot: "next" })] }), jsxs(RangeCalendar.Grid, { children: [jsx(RangeCalendar.GridHeader, { children: (day) => jsx(RangeCalendar.HeaderCell, { children: day }) }), jsx(RangeCalendar.GridBody, { children: (date) => (jsx(RangeCalendar.Cell, { date: date, className: CALENDAR_CELL_CLASS })) })] })] }), calendarBottomContent] }), isInvalid && errorMessage && jsx(FieldError, { children: errorMessage })] }));
 }
 
 // TECH-2459 · F3.0 — v3 divide el `Input` monolítico de v2 en `TextField` (label/description/
@@ -1544,8 +1544,19 @@ const INVALID_TEXT_CLASS$2 = "text-danger";
  * - Radius configurable (v3 no tiene la prop).
  * - `startContent`/`endContent` → `InputGroup.Prefix`/`InputGroup.Suffix`.
  * - `isClearable` → botón de limpiar propio (`CloseButton`); solo en modo controlado (`value`).
+ *
+ * `ref` apunta al `<input>` REAL (`HTMLInputElement`), no al `InputGroup` ni al `TextField` que lo
+ * envuelven: el consumidor que necesita el nodo —insertar texto en la posición del cursor con
+ * `selectionStart`/`setSelectionRange`, enfocar, leer `validity`— lo alcanza directamente.
+ *
+ * ⚠️ Se reenvía con `forwardRef` (patrón de las 8 fachadas del repo que ya lo hacen) y NO
+ * confiando en que React 19 pase `ref` dentro de `...rest`: medido, en React 19 eso ya funcionaba
+ * de rebote —el `ref` viajaba en el spread hasta `InputGroup.Input`, que también hace spread— pero
+ * (a) el tipo público lo rechazaba, así que el consumidor no podía escribirlo sin un `as any`, y
+ * (b) era accidental: cualquier prop que se añadiese al destructuring lo habría cortado en
+ * silencio.
  */
-const Input = ({ label, description, errorMessage, id, 
+const Input = forwardRef(({ label, description, errorMessage, id, 
 // ⚠️ El default de v2 era "md", no "lg" — verificado en el código de v2
 // (`git show b39d28f:src/components/input/Input.tsx`, `size = "md"`) y en su PNG congelado
 // (`input--default` mide exactamente lo mismo que `--medium`: 40px de alto, texto de 14px). El
@@ -1560,7 +1571,7 @@ size = "md", variant = "bordered", radius = "md", placeholder, startContent, end
 // `undefined` y el campo dejaba de llenar su contenedor: en una fila flex se encogía al ancho
 // de su contenido (medido por S2: 208px dentro de una fila de 592, 336px de hueco). En una
 // columna no se notaba porque el `stretch` del flex lo tapaba — pero afecta a cualquier app.
-fullWidth = true, value, defaultValue, onChange, onValueChange, className, classNames, required, name, type = "text", ...rest }) => {
+fullWidth = true, value, defaultValue, onChange, onValueChange, className, classNames, required, name, type = "text", ...rest }, ref) => {
     const generatedId = useId();
     const inputId = id || generatedId;
     // ⚠️ `isRequired` (prop de HeroUI, asterisco visual) y `required` (atributo HTML nativo, solo
@@ -1611,7 +1622,7 @@ fullWidth = true, value, defaultValue, onChange, onValueChange, className, class
                     className,
                 ]
                     .filter(Boolean)
-                    .join(" "), children: [startContent && (jsx(InputGroup.Prefix, { className: "border-none bg-transparent px-0", children: startContent })), jsx(InputGroup.Input, { ...rest, required: required, type: type, placeholder: labelFlotante ? " " : placeholder, value: value, defaultValue: defaultValue, onChange: handleChange, className: [
+                    .join(" "), children: [startContent && (jsx(InputGroup.Prefix, { className: "border-none bg-transparent px-0", children: startContent })), jsx(InputGroup.Input, { ...rest, ref: ref, required: required, type: type, placeholder: labelFlotante ? " " : placeholder, value: value, defaultValue: defaultValue, onChange: handleChange, className: [
                             "bg-transparent p-0",
                             SIZE_TEXT_CLASS$1[size],
                             isInvalid ? INVALID_TEXT_CLASS$2 : "",
@@ -1625,7 +1636,8 @@ fullWidth = true, value, defaultValue, onChange, onValueChange, className, class
                     .join(" "), children: description })), isInvalid && errorMessage && (jsx(FieldError, { className: [HELPER_CLASS$2, "text-left", classNames?.errorMessage]
                     .filter(Boolean)
                     .join(" "), children: errorMessage }))] }));
-};
+});
+Input.displayName = "Input";
 
 const defaultTranslations$g = {
     addHolidayTitle: "Add holiday",
@@ -1887,10 +1899,10 @@ const AnalyticsCard = ({ data, showTimePeriods = true, showDropdownMenu = true,
                 // colección por `id`+`textValue` (antes `key`); `variant="bordered"` de v2 no tiene
                 // equivalente (`DropdownVariants` no define ninguno hoy — el popover ya trae su
                 // propio borde/sombra por defecto).
-                jsxs(Dropdown, { children: [jsx(Dropdown.Trigger, { "aria-label": t.viewDetails, className: "absolute top-2 right-2 inline-flex h-11 w-11 items-center justify-center rounded-full border-2 transition-colors hover:bg-default-100 md:h-10 md:w-10", style: {
+                jsxs(Dropdown$1, { children: [jsx(Dropdown$1.Trigger, { "aria-label": t.viewDetails, className: "absolute top-2 right-2 inline-flex h-11 w-11 items-center justify-center rounded-full border-2 transition-colors hover:bg-default-100 md:h-10 md:w-10", style: {
                                 borderColor: "var(--color-default)",
                                 color: "var(--color-default-foreground)",
-                            }, children: jsx(IconComponent, { icon: "solar:menu-dots-bold", size: "sm" }) }), jsx(Dropdown.Popover, { placement: "bottom end", className: "min-w-[120px]", children: jsxs(Dropdown.Menu, { onAction: (key) => handleMenuAction(String(key)), children: [jsx(Dropdown.Item, { id: "view-details", textValue: t.viewDetails, className: "text-xs", children: t.viewDetails }), jsx(Dropdown.Item, { id: "export-data", textValue: t.exportData, className: "text-xs", children: t.exportData }), jsx(Dropdown.Item, { id: "set-alert", textValue: t.setAlert, className: "text-xs", children: t.setAlert })] }) })] }))] }) }));
+                            }, children: jsx(IconComponent, { icon: "solar:menu-dots-bold", size: "sm" }) }), jsx(Dropdown$1.Popover, { placement: "bottom end", className: "min-w-[120px]", children: jsxs(Dropdown$1.Menu, { onAction: (key) => handleMenuAction(String(key)), children: [jsx(Dropdown$1.Item, { id: "view-details", textValue: t.viewDetails, className: "text-xs", children: t.viewDetails }), jsx(Dropdown$1.Item, { id: "export-data", textValue: t.exportData, className: "text-xs", children: t.exportData }), jsx(Dropdown$1.Item, { id: "set-alert", textValue: t.setAlert, className: "text-xs", children: t.setAlert })] }) })] }))] }) }));
 };
 
 const H3 = ({ children, className, ...props }) => {
@@ -4882,14 +4894,14 @@ size: _size, radius: _radius, variant: _variant, className, ...heroUIProps }) =>
  */
 const ITEM_CLASS = "text-default-500 data-[hovered=true]:bg-primary-100 data-[hovered=true]:text-default-700";
 const ConfigMenu = ({ options, onLogout, onOptionSelect, translations, }) => {
-    return (jsxs(Dropdown, { children: [jsx(DropdownTrigger, { className: "button button--icon-only button--md button--primary button--hover-dim inline-flex rounded-[8px]", style: {
+    return (jsxs(Dropdown$1, { children: [jsx(DropdownTrigger, { className: "button button--icon-only button--md button--primary button--hover-dim inline-flex rounded-[8px]", style: {
                     "--button-bg": "var(--color-default)",
                     "--button-bg-hover": "var(--color-default)",
                     "--button-bg-pressed": "var(--color-default)",
                     "--button-fg": "var(--color-default-foreground)",
-                }, children: jsx(IconComponent, { icon: "solar:settings-linear" }) }), jsx(DropdownPopover, { className: "min-w-40", children: jsxs(DropdownMenu, { "aria-label": "Configuration", children: [jsx(DropdownSection, { className: "mb-0", children: options.map((item) => (jsxs(DropdownItem, { id: item.label, textValue: item.label, ...(onOptionSelect
+                }, children: jsx(IconComponent, { icon: "solar:settings-linear" }) }), jsx(DropdownPopover, { className: "min-w-40", children: jsxs(DropdownMenu, { "aria-label": "Configuration", children: [jsx(DropdownSection$1, { className: "mb-0", children: options.map((item) => (jsxs(DropdownItem, { id: item.label, textValue: item.label, ...(onOptionSelect
                                     ? { onAction: () => onOptionSelect(item.href) }
-                                    : { href: item.href }), className: ITEM_CLASS, children: [item.icon ? jsx(IconComponent, { icon: item.icon }) : null, jsx(Label, { children: item.label })] }, item.label))) }), jsx(Separator, {}), jsx(DropdownSection, { children: jsxs(DropdownItem, { id: "logout", textValue: translations?.logout ?? "logout", onAction: onLogout, className: ITEM_CLASS, children: [jsx(IconComponent, { icon: "solar:logout-2-linear" }), jsx(Label, { children: translations?.logout })] }, "logout") })] }) })] }));
+                                    : { href: item.href }), className: ITEM_CLASS, children: [item.icon ? jsx(IconComponent, { icon: item.icon }) : null, jsx(Label, { children: item.label })] }, item.label))) }), jsx(Separator, {}), jsx(DropdownSection$1, { children: jsxs(DropdownItem, { id: "logout", textValue: translations?.logout ?? "logout", onAction: onLogout, className: ITEM_CLASS, children: [jsx(IconComponent, { icon: "solar:logout-2-linear" }), jsx(Label, { children: translations?.logout })] }, "logout") })] }) })] }));
 };
 ConfigMenu.displayName = "ConfigMenu";
 
@@ -8788,17 +8800,17 @@ const OWN_SCROLL = new Set([
     Table$1.ResizableContainer,
 ]);
 /** Identidad por `child.type` contra los objetos reales de HeroUI (mismo patrón que la fachada `Alert`). */
-function isPart(node, parts) {
+function isPart$1(node, parts) {
     return isValidElement(node) && parts.has(node.type);
 }
 const TableFacade = ({ children, ...props }) => {
     const nodes = Children.toArray(children);
     // Sin hijos, o con un contenedor de scroll ya montado a mano: el root tal cual.
-    if (nodes.length === 0 || nodes.some((node) => isPart(node, OWN_SCROLL))) {
+    if (nodes.length === 0 || nodes.some((node) => isPart$1(node, OWN_SCROLL))) {
         return jsx(Table$1, { ...props, children: children });
     }
-    const scrollable = nodes.filter((node) => !isPart(node, OUTSIDE_SCROLL));
-    const outsideScroll = nodes.filter((node) => isPart(node, OUTSIDE_SCROLL));
+    const scrollable = nodes.filter((node) => !isPart$1(node, OUTSIDE_SCROLL));
+    const outsideScroll = nodes.filter((node) => isPart$1(node, OUTSIDE_SCROLL));
     return (jsxs(Table$1, { ...props, children: [jsx(Table$1.ScrollContainer, { children: scrollable }), outsideScroll] }));
 };
 TableFacade.displayName = "Aurora.Table";
@@ -8957,8 +8969,19 @@ const INVALID_TEXT_CLASS = "text-danger";
  * Textarea genérico reutilizable basado en HeroUI v3 (TextField + TextArea) siguiendo las reglas
  * de diseño BeweOS (TECH-2459 · F3 · G1-forms). La API pública v2 (label, description,
  * errorMessage, variant, size, radius, isClearable-less) se conserva sin cambios.
+ *
+ * `ref` apunta al `<textarea>` REAL (`HTMLTextAreaElement`), no al contenedor: el consumidor que
+ * necesita el nodo —insertar texto en la posición del cursor con `selectionStart`/
+ * `setSelectionRange`, enfocar, medir— lo alcanza directamente.
+ *
+ * ⚠️ Se reenvía con `forwardRef` (patrón de las 8 fachadas del repo que ya lo hacen) y NO
+ * confiando en que React 19 pase `ref` dentro de `...rest`: medido, en React 19 eso ya funcionaba
+ * de rebote —el `ref` viajaba en el spread hasta el `TextAreaRoot` de v3, que también hace spread—
+ * pero (a) el tipo público lo rechazaba, así que el consumidor no podía escribirlo sin un `as any`
+ * y acababa colgando el ref del contenedor y buscando el `<textarea>` con una query, y (b) era
+ * accidental: cualquier prop que se añadiese al destructuring lo habría cortado en silencio.
  */
-const Textarea = ({ label, description, errorMessage, id, size = "md", variant = "bordered", radius = "md", placeholder, isInvalid = false, isRequired = false, isDisabled = false, isReadOnly = false, 
+const Textarea = forwardRef(({ label, description, errorMessage, id, size = "md", variant = "bordered", radius = "md", placeholder, isInvalid = false, isRequired = false, isDisabled = false, isReadOnly = false, 
 // `fullWidth` por defecto a `true`: HeroUI v2 lo traía en sus `defaultVariants`
 // (verificado en el paquete v2 compilado, `dist/components/input.js`:
 // `defaultVariants: { variant:"flat", color:"default", size:"md", fullWidth:true, … }`, con
@@ -8966,7 +8989,7 @@ const Textarea = ({ label, description, errorMessage, id, size = "md", variant =
 // `undefined` y el campo dejaba de llenar su contenedor: en una fila flex se encogía al ancho
 // de su contenido (medido por S2: 208px dentro de una fila de 592, 336px de hueco). En una
 // columna no se notaba porque el `stretch` del flex lo tapaba — pero afecta a cualquier app.
-fullWidth = true, value, defaultValue, onChange, onValueChange, className, classNames, name, ...rest }) => {
+fullWidth = true, value, defaultValue, onChange, onValueChange, className, classNames, name, ...rest }, ref) => {
     const generatedId = useId();
     const textareaId = id || generatedId;
     const handleChange = (event) => {
@@ -8981,7 +9004,7 @@ fullWidth = true, value, defaultValue, onChange, onValueChange, className, class
                     classNames?.label,
                 ]
                     .filter(Boolean)
-                    .join(" "), children: label })), jsx(TextArea, { ...rest, placeholder: placeholder, value: value, defaultValue: defaultValue, onChange: handleChange, className: [
+                    .join(" "), children: label })), jsx(TextArea, { ...rest, ref: ref, placeholder: placeholder, value: value, defaultValue: defaultValue, onChange: handleChange, className: [
                     SIZE_CLASS[size],
                     RESIZE_CLASS,
                     RADIUS_CLASS$3[radius],
@@ -8999,7 +9022,8 @@ fullWidth = true, value, defaultValue, onChange, onValueChange, className, class
                     .join(" "), children: description })), isInvalid && errorMessage && (jsx(FieldError, { className: [HELPER_CLASS, "text-left", classNames?.errorMessage]
                     .filter(Boolean)
                     .join(" "), children: errorMessage }))] }));
-};
+});
+Textarea.displayName = "Textarea";
 
 // Traducciones por defecto en español según las reglas de diseño
 const defaultTranslations$3 = {
@@ -11570,14 +11594,23 @@ const EmailPreview = ({ htmlContent, subject, from, to, iframeHeight = 480, tran
                                                             }) })] }), jsxs("span", { className: "text-xs text-gray-500", children: [t.toLabel, ": ", displayTo] })] })] })] })), jsx("div", { className: "w-full overflow-hidden", children: jsx("iframe", { title: t.iframeTitle, srcDoc: htmlContent, className: "w-full border-0", style: { height: `${iframeHeight}px` }, sandbox: "allow-same-origin" }) })] }), jsx("div", { className: "flex justify-center py-2", children: jsx("div", { className: `w-32 h-1 rounded-full ${deviceColor === "black" ? "bg-gray-600" : "bg-gray-400"}` }) })] }) }));
 };
 
-const InputPassword = ({ translations, showCriteria = false, criteria, isPristine = true, renderCriterionLabel, criteriaId = "password-criteria", ...inputProps }) => {
+/**
+ * Campo de contraseña: la fachada `Input` con un botón de mostrar/ocultar y, opcionalmente, la
+ * lista de criterios.
+ *
+ * `ref` apunta al `<input>` REAL (`HTMLInputElement`) — el mismo contrato que `Input`, no el `<div>`
+ * que envuelve campo y criterios. Estaba afectado por el mismo defecto de tipos que `Input` y
+ * `Textarea`: el `ref` llegaba al `<input>` en runtime (React 19 lo pasaba dentro de
+ * `...inputProps`) pero `InputPasswordProps` no lo declaraba, así que TypeScript lo rechazaba.
+ */
+const InputPassword = forwardRef(({ translations, showCriteria = false, criteria, isPristine = true, renderCriterionLabel, criteriaId = "password-criteria", ...inputProps }, ref) => {
     const [showPassword, setShowPassword] = useState(false);
     const togglePasswordVisibility = () => {
         setShowPassword((prev) => !prev);
     };
     const showLabel = translations?.showPassword ?? "Show password";
     const hideLabel = translations?.hidePassword ?? "Hide password";
-    return (jsxs("div", { className: "flex flex-col w-full", children: [jsx(Input, { ...inputProps, type: showPassword ? "text" : "password", "aria-describedby": showCriteria ? criteriaId : inputProps["aria-describedby"], endContent: jsx("button", { type: "button", tabIndex: -1, onClick: togglePasswordVisibility, className: "focus:outline-none", "aria-label": showPassword ? hideLabel : showLabel, children: showPassword ? (jsx(IconComponent, { icon: "lucide:eye-off", color: "gray" })) : (jsx(IconComponent, { icon: "lucide:eye", color: "gray" })) }) }), showCriteria && criteria && criteria.length > 0 && (jsx("fieldset", { id: criteriaId, className: "mt-2", children: jsx("ul", { className: "flex flex-col gap-2 list-none", children: criteria.map((criterion, idx) => {
+    return (jsxs("div", { className: "flex flex-col w-full", children: [jsx(Input, { ...inputProps, ref: ref, type: showPassword ? "text" : "password", "aria-describedby": showCriteria ? criteriaId : inputProps["aria-describedby"], endContent: jsx("button", { type: "button", tabIndex: -1, onClick: togglePasswordVisibility, className: "focus:outline-none", "aria-label": showPassword ? hideLabel : showLabel, children: showPassword ? (jsx(IconComponent, { icon: "lucide:eye-off", color: "gray" })) : (jsx(IconComponent, { icon: "lucide:eye", color: "gray" })) }) }), showCriteria && criteria && criteria.length > 0 && (jsx("fieldset", { id: criteriaId, className: "mt-2", children: jsx("ul", { className: "flex flex-col gap-2 list-none", children: criteria.map((criterion, idx) => {
                         const colorClass = criterion.passed
                             ? "text-success"
                             : isPristine
@@ -11587,7 +11620,8 @@ const InputPassword = ({ translations, showCriteria = false, criteria, isPristin
                                     ? renderCriterionLabel(criterion.label)
                                     : criterion.label] }, `${criteriaId}-${idx}`));
                     }) }) }))] }));
-};
+});
+InputPassword.displayName = "InputPassword";
 
 const SimpleLineChart = ({ data, title, height = 200, color = "#3b82f6", className = "", showTitle = true, emptyMessage = "No hay datos disponibles", onPointClick, }) => {
     if (data.length === 0) {
@@ -13718,7 +13752,7 @@ function hasCompoundChildren$1(children) {
     return Children.toArray(children).some((child) => isValidElement(child) && COMPOUND_PARTS$1.has(child.type));
 }
 /** `isEmpty` de v2 (`@heroui/shared-utils`): null/undefined/"" no cuentan como contenido. */
-function hasValue(node) {
+function hasValue$1(node) {
     return node !== null && node !== undefined && node !== "" && node !== false;
 }
 /**
@@ -13756,10 +13790,10 @@ const AlertFacade = ({ color, status, variant = "flat", radius = "md", title, de
         onClose?.();
     };
     const slots = slotClasses(variant, effectiveColor);
-    const hasTitle = hasValue(title);
-    const hasDescription = hasValue(description);
+    const hasTitle = hasValue$1(title);
+    const hasDescription = hasValue$1(description);
     // `hasContent` de v2: sin descripción ni children, el título se centra verticalmente con el icono.
-    const hasContent = hasDescription || hasValue(children);
+    const hasContent = hasDescription || hasValue$1(children);
     const showClose = isClosable || Boolean(onClose);
     return (jsxs(Alert$1, { role: "alert", "data-visible": "true", "data-closeable": showClose ? "true" : undefined, "data-has-title": hasTitle ? "true" : undefined, "data-has-description": hasDescription ? "true" : undefined, ...rest, status: effectiveStatus, 
         // Base v2: `flex flex-grow flex-row w-full items-start py-3 px-4 gap-x-1`. v3 ya trae
@@ -13968,6 +14002,185 @@ const Checkbox = Object.assign(CheckboxFacade, {
     Content: Checkbox$1.Content,
 });
 
+// TECH-2459 — Fachada `Dropdown` / `DropdownSection`: repone la CABECERA DE SECCIÓN que la
+// migración a v3 dejó sin vía legal desde una app.
+//
+// EL DEFECTO (verificado en los tipos instalados, no deducido): el `DropdownSection` de v3 es
+// `interface DropdownSectionProps extends ComponentPropsWithRef<typeof MenuSectionRoot>`
+// (`@heroui/react/dist/components/dropdown/dropdown.d.ts`) y ahí NO hay `title` — react-aria lo
+// omite a mano en su base (`SectionProps<T> extends Omit<SharedSectionProps<T>, 'children' |
+// 'title'>`, `react-aria-components/dist/types/src/Collection.d.ts:79`). En v3 la cabecera es un
+// componente, el `Header` de react-aria, que `@heroui/react` SÍ reexporta
+// (`dist/index.js:128`, `export { Header } from './components/header/index.js'`) pero que la
+// fachada de Aurora no exponía. Con la regla de oro de la migración (0 imports directos de
+// `@heroui/*` ni de react-aria en las apps), desde una app no había NINGUNA forma de poner
+// cabecera a una sección: `title` compila como atributo global de HTML y sale como *tooltip*,
+// no como texto visible.
+//
+// Impacto medido: `beweossmbs/src/clients/ui/features/contact-list/components/column-manager/
+// column-manager.component.tsx:146` monta `<DropdownSection title={…} classNames={{heading}}>`
+// para su gestor de columnas — el único consumidor de secciones de dropdown en los repos de apps
+// (grep real de `DropdownSection|Dropdown.Section` en beweossmbs, beweosagency,
+// backoffice-beweos, loginos, linda-business y beweanalytics: 1 uso).
+//
+// POR QUÉ LA PROP `title` Y NO SOLO UN `Dropdown.SectionHeader` EXPORTADO: es la convención ya
+// establecida en este repo para esta MISMA forma de defecto (prop de v2 que v3 convierte en
+// pieza del compound) — la fachada `Alert` mantiene `title`/`description` como props y compone
+// `Alert.Title`/`Alert.Description` por dentro, y además publica esas piezas como estáticos;
+// `Checkbox`, `Switch` y `Table` siguen el mismo patrón (API v2 intacta + compound de v3 vía
+// estáticos). Exportar solo la pieza obligaría al consumidor a cambiar su marcado, que es
+// exactamente lo que la migración promete no pedir, y encima dejaría `classNames.heading` sin
+// destino. Se hacen las DOS cosas, igual que en `Alert`: la prop v2 y la pieza de v3
+// (`DropdownSection.Header`, alcanzable también como `Dropdown.Section.Header`).
+/**
+ * Cabecera de sección con el aspecto de v2. Se repone UN literal, el único que difiere de la
+ * clase `.header` de v3 — el resto ya coincide, MEDIDO en el navegador (Storybook, claro y
+ * oscuro), no deducido de la hoja:
+ *
+ * | | v2 (`heading`) | v3 (`.header`) | ¿se repone? |
+ * |---|---|---|---|
+ * | tamaño | `text-tiny` = 12px | `text-xs` = 12px | no, idéntico |
+ * | peso | sin clase → 400 | `font-medium` → 500 | **sí**, `font-normal` |
+ * | color | `text-foreground-500` | `text-muted` | no: MISMO gris (ver abajo) |
+ * | padding | `pl-1` (4px) | `px-2 pt-1.5 pb-1` | no, gana v3 (ver abajo) |
+ *
+ * Oráculo de v2 leído, no recordado: `@heroui/theme@2.4.15` →
+ * `dist/chunk-VFBRSBM5.mjs:478`, `menuSection.heading = "pl-1 text-tiny text-foreground-500"`.
+ * v3: `@heroui/styles/dist/components/header.css` → `.header { @apply w-full px-2 pt-1.5 pb-1
+ * text-start text-xs font-medium text-muted }`.
+ *
+ * **El color NO se repone porque `text-muted` ya ES el gris de v2.** Medido en el navegador:
+ * claro `--muted: oklch(55.17% .0138 285.94)` ≡ `--color-foreground-500: #71717a`; oscuro
+ * `oklch(70.5% .015 286.067)` ≡ `#a1a1aa` (los dos son zinc-500 / zinc-400). Se descartó el
+ * `text-foreground-500` redundante que tenía este constante en la primera versión: además de no
+ * pintar nada distinto, habría desacoplado la cabecera del token de v3 para siempre.
+ *
+ * **El padding sí se deja en v3 a propósito**: los ítems también cambiaron de caja
+ * (`.dropdown__popover [data-slot="menu-item"] { @apply px-2.5 }`), así que con el `px-2` de v3
+ * el texto de la cabecera queda 2px a la izquierda del de sus ítems (medido dentro del popover
+ * real: 605.9 vs 607.9); copiando el `pl-1` de v2 serían 6px.
+ *
+ * Va como utilidad (capa `utilities`), que gana a `.header` (capa `components`, ver
+ * `@heroui/styles/dist/index.css:14`) — mismo mecanismo que las fachadas Alert/Badge/Card/Chip.
+ * Ni una clase v2 muerta (`text-tiny` no existe sin el plugin `heroui()` y `cn` la BORRARÍA).
+ */
+const SECTION_HEADING_CLASS = "font-normal";
+/** `isEmpty` de v2 (`@heroui/shared-utils`): null/undefined/""/false no cuentan como contenido. */
+function hasValue(node) {
+    return node !== null && node !== undefined && node !== "" && node !== false;
+}
+/**
+ * Sección de un `DropdownMenu` con la API de v2: `title` compone el `Header` de v3 por dentro y
+ * `classNames.base`/`classNames.heading` apuntan a los dos slots que v3 conserva.
+ *
+ * La accesibilidad la cablea react-aria sola, y por eso la cabecera va DENTRO de la sección y no
+ * como `<div>` hermano: `MenuSectionInner` llama a `useMenuSection({heading})` y publica los
+ * `headingProps` (con su `id`) por `HeaderContext`, de modo que el `<section role="group">`
+ * acaba con `aria-labelledby` apuntando a la cabecera
+ * (`react-aria-components/dist/private/Menu.mjs:318-355`).
+ */
+const DropdownSectionFacade = ({ title, classNames, className, children, ...props }) => {
+    return (jsxs(Dropdown$1.Section, { ...props, className: cn(className, classNames?.base), children: [hasValue(title) ? (jsx(Header, { className: cn(SECTION_HEADING_CLASS, classNames?.heading), children: title })) : null, children] }));
+};
+DropdownSectionFacade.displayName = "Aurora.DropdownSection";
+/**
+ * `DropdownSection` de Aurora: la sección de v3 con el `title` de v2, más el `Header` de v3 como
+ * estático — la vía idiomática de v3 para quien escriba marcado nuevo:
+ *
+ * ```tsx
+ * <DropdownSection title="Gestionar columnas">…</DropdownSection>        // API v2
+ * <DropdownSection><DropdownSection.Header>…</DropdownSection.Header>…</DropdownSection>  // v3
+ * ```
+ *
+ * `Header` es el objeto EXACTO que exporta `@heroui/react`, así que la pieza se comporta igual
+ * que importándola de HeroUI (lo que las apps no pueden hacer).
+ */
+const DropdownSection = Object.assign(DropdownSectionFacade, {
+    Header,
+});
+// ---------------------------------------------------------------------------------------------
+// Inserción automática del `Dropdown.Popover` que v3 exige (TECH-2459)
+// ---------------------------------------------------------------------------------------------
+//
+// EL DEFECTO: `MenuTrigger` (el root de v3) solo PROVEE el contexto del popover — no lo
+// renderiza. Se ve en su implementación: monta un `PressResponder` y devuelve `props.children`
+// tal cual (`react-aria-components/dist/private/Menu.mjs:76-108`). Así que el marcado v2
+// `<Dropdown><DropdownTrigger/><DropdownMenu/></Dropdown>` compila en verde y en ejecución pinta
+// el menú **en línea, dentro del flujo del documento**, siempre visible y sin posicionar. No hay
+// error, ni aviso en consola.
+//
+// Medido en los repos de apps (grep real de `<Dropdown` + `DropdownMenu`, no de memoria):
+// **13 ficheros / 23 tags** de `<Dropdown>` consumen esta fachada — 10 ficheros y 20 tags en
+// beweossmbs (9 de ellos en `campaigns/.../AudienceReachStep.tsx`), 3 y 3 en beweanalytics. De
+// esos 23 tags, **solo 2 montan el popover**: los que beweanalytics puso a mano al migrar
+// (`toolbar-column-manager.component.tsx:85` y `toolbar-saved-views.component.tsx:78`). Los
+// otros 21 pintan el menú en línea, y uno de ellos está en una app YA migrada
+// (`beweanalytics/.../toolbar-bulk-actions.component.tsx:51`), que es la prueba de que esto se
+// olvida: es invisible hasta que alguien abre el menú.
+// Los 3+3 ficheros que el inventario contaba en `linda-business` y `chatbot-claw` son FALSOS
+// POSITIVOS: su `DropdownMenu` es el de Radix (`@radix-ui/react-dropdown-menu` vía un
+// `shared/ui/components/ui/dropdown-menu.tsx` estilo shadcn) y no toca esta librería.
+//
+// La partición es por IDENTIDAD de `child.type` contra los objetos reales de HeroUI, igual que
+// en la fachada `Table` — no por `displayName` ni por nombre. Y es CONSERVADORA: solo viaja al
+// popover lo que sabemos que va dentro (el menú); todo lo demás (el trigger, cualquier envoltorio
+// propio del consumidor) se queda fuera. Un falso negativo deja el comportamiento de hoy (menú en
+// línea, que el consumidor arregla montando el popover a mano); un falso positivo metería el
+// trigger dentro del popover y ROMPERÍA un dropdown que funcionaba.
+/** Lo que va DENTRO del popover: el menú. */
+const INSIDE_POPOVER = new Set([Dropdown$1.Menu]);
+/**
+ * Si el consumidor ya monta uno de estos, la fachada no envuelve nada: el árbol es suyo.
+ * `SubmenuTrigger` entra aquí porque trae su propio `Popover` dentro (aunque en la práctica vive
+ * dentro del menú, no como hijo del root).
+ */
+const OWN_POPOVER = new Set([
+    Dropdown$1.Popover,
+    Dropdown$1.SubmenuTrigger,
+]);
+/** Identidad por `child.type` contra los objetos reales de HeroUI (patrón de la fachada `Table`). */
+function isPart(node, parts) {
+    return isValidElement(node) && parts.has(node.type);
+}
+const DropdownFacade = ({ children, ...props }) => {
+    const nodes = Children.toArray(children);
+    const menus = nodes.filter((node) => isPart(node, INSIDE_POPOVER));
+    // Nada que envolver (sin hijos, `children` como función, un popover ya montado a mano, o
+    // simplemente ningún menú suelto): el root tal cual, byte a byte como el crudo de v3.
+    if (menus.length === 0 || nodes.some((node) => isPart(node, OWN_POPOVER))) {
+        return jsx(Dropdown$1, { ...props, children: children });
+    }
+    return (jsxs(Dropdown$1, { ...props, children: [nodes.filter((node) => !isPart(node, INSIDE_POPOVER)), jsx(Dropdown$1.Popover, { offset: 7, placement: "bottom", children: menus })] }));
+};
+DropdownFacade.displayName = "Aurora.Dropdown";
+/**
+ * `Dropdown` de Aurora: el root de v3 **más el `Dropdown.Popover` que faltaba**, con el compound
+ * completo colgado como estáticos y `Dropdown.Section` apuntando a la FACHADA de la sección.
+ *
+ * Dos defectos de la migración en una pieza:
+ * 1. **El popover que v3 exige** y v2 no pedía: sin él el menú se pinta en línea (ver el bloque
+ *    de comentarios de arriba). La fachada lo inserta si falta y respeta el del consumidor si ya
+ *    está.
+ * 2. **La cabecera de sección**: si solo se pisara el `DropdownSection` plano,
+ *    `Dropdown.Section` seguiría siendo el crudo de v3 y la misma pieza aceptaría `title` o no
+ *    según por qué nombre se llegue — el "falso amigo" que ya costó rondas en
+ *    Alert/Checkbox/Switch (el tipo v2 compilaba pero el componente era el de v3).
+ *
+ * `Dropdown.Root` queda deliberadamente crudo (el `MenuTrigger` pelado de v3, sin popover),
+ * igual que en `Table`: vía de escape para montar la anatomía a mano.
+ */
+const Dropdown = Object.assign(DropdownFacade, {
+    Item: Dropdown$1.Item,
+    ItemIndicator: Dropdown$1.ItemIndicator,
+    Menu: Dropdown$1.Menu,
+    Popover: Dropdown$1.Popover,
+    Root: Dropdown$1.Root,
+    Section: DropdownSection,
+    SubmenuIndicator: Dropdown$1.SubmenuIndicator,
+    SubmenuTrigger: Dropdown$1.SubmenuTrigger,
+    Trigger: Dropdown$1.Trigger,
+});
+
 /**
  * Tooltip - Componente BeweOS basado en HeroUI.
  *
@@ -14768,4 +14981,4 @@ const NavigationLoadingProvider = ({ children, }) => {
     return (jsxs(NavigationLoadingContext.Provider, { value: value, children: [children, jsx(NavigationLoadingOverlay, { isVisible: isVisible })] }));
 };
 
-export { ALL_THEMES, AURORA_THEME_FAMILIES, AURORA_THEME_REGISTRY, AccordionList, AddHolidayForm, Alert, AnalyticsCard, AreaLineChart, AuraAutocomplete, AuraTable, AuraToastProvider, AuraAutocomplete as Autocomplete, AutocompleteItem, BEWEOS_THEME_MODE_COOKIE_NAME, Badge, BreadcrumbItem, BreadcrumbsComponent, Button, CONTAINER_ATTRIBUTE, Card, CardBody, Checkbox, Chip, ColorPicker, ColorSelector, ContentCarousel, Currency, DEFAULT_DONUT_COLORS, DEFAULT_PREDEFINED_COLORS, DEFAULT_RANKED_BAR_COLORS, DISMISS_CONTROL_ATTRIBUTE, DatePicker, DateRangePicker, DateSelector, Divider, DonutChart, DrawerFilters, EmailPreview, EnumMenuNavListItem, GlobalToast, H1, H2, H3, H4, HeaderComponent, HeroUIProvider, HolidayType, IconComponent, Image$1 as Image, ImagePreview, Input, InputPassword, Kanban, KanbanCard, KanbanColumn, LINDA_TONE_PROPERTIES, LindaIcon, MenuClaw, MenuComponent, Modal, ModalBody, ModalContent, ModalFooter, ModalHeader, MultiStepWizard, NavigationLoadingContext, NavigationLoadingOverlay, NavigationLoadingProvider, P, Pagination, Phone, Progress, PromotionalBanner, REGISTERED_THEME_COLORS, RangeFilter, RankedBarList, RowSteps, DEFAULT_TRANSLATIONS$2 as SEGMENTATION_DEFAULT_TRANSLATIONS, ScheduleRow, SearchInput, SegmentationBuilder, Select, SelectItem, SelectSection, SimpleLineChart, SocialMediaBar, SocialMediaCarousel, SocialMediaPreview, StatTile, StepIndicator, Switch, Switch as SwitchComponent, THEME_COLOR_HEX_MAP, Table, TagsFilter, Textarea, ThemeContext, ThemePicker, ThemeProvider, TimeInput, TimeInput as TimeInputComponent, ToastContext, Tooltip, TwoColumnLayoutAgent, UploadFile, VerticalSteps, ViolinPlot, WhatsAppPreview, Wizard, WizardNavigation, WizardSidebar, applyCustomPrimaryColor, applyLindaTones, computeBars, computeMax, computeSlices, computeTotal, containerProps, createCurrencyFormatter, uniqueCountries as defaultCountries, defaultCurrencyOptions, defaultTranslations$5 as defaultTranslations, deriveLindaTones, dismissControlProps, forceLightOnlyThemeBeforeReact, formatAuroraThemeTooltip, generateThemeColorScale, getContrastForeground, getRegisteredThemeColorBases, getSelectedKeyFromPath, hexToHsl, hexToThemeColor, hslToCssValue, isAuroraFullThemeId, isDismissControl, isDonutEmpty, isExactThemeColor, isGroupState, isHexColor, isRankedBarListEmpty, isSegmentationGroup, parseColorToHsl, removeCustomPrimaryColor, removeLindaTones, shouldClosePopoverOnInteractOutside, sizeMap, themeColors, useAuraToast, useCloseOnAncestorScroll, useDisclosure, useMediaQuery, useNavigationLoading, useThemeContext };
+export { ALL_THEMES, AURORA_THEME_FAMILIES, AURORA_THEME_REGISTRY, AccordionList, AddHolidayForm, Alert, AnalyticsCard, AreaLineChart, AuraAutocomplete, AuraTable, AuraToastProvider, AuraAutocomplete as Autocomplete, AutocompleteItem, BEWEOS_THEME_MODE_COOKIE_NAME, Badge, BreadcrumbItem, BreadcrumbsComponent, Button, CONTAINER_ATTRIBUTE, Card, CardBody, Checkbox, Chip, ColorPicker, ColorSelector, ContentCarousel, Currency, DEFAULT_DONUT_COLORS, DEFAULT_PREDEFINED_COLORS, DEFAULT_RANKED_BAR_COLORS, DISMISS_CONTROL_ATTRIBUTE, DatePicker, DateRangePicker, DateSelector, Divider, DonutChart, DrawerFilters, Dropdown, DropdownSection, EmailPreview, EnumMenuNavListItem, GlobalToast, H1, H2, H3, H4, HeaderComponent, HeroUIProvider, HolidayType, IconComponent, Image$1 as Image, ImagePreview, Input, InputPassword, Kanban, KanbanCard, KanbanColumn, LINDA_TONE_PROPERTIES, LindaIcon, MenuClaw, MenuComponent, Modal, ModalBody, ModalContent, ModalFooter, ModalHeader, MultiStepWizard, NavigationLoadingContext, NavigationLoadingOverlay, NavigationLoadingProvider, P, Pagination, Phone, Progress, PromotionalBanner, REGISTERED_THEME_COLORS, RangeFilter, RankedBarList, RowSteps, DEFAULT_TRANSLATIONS$2 as SEGMENTATION_DEFAULT_TRANSLATIONS, ScheduleRow, SearchInput, SegmentationBuilder, Select, SelectItem, SelectSection, SimpleLineChart, SocialMediaBar, SocialMediaCarousel, SocialMediaPreview, StatTile, StepIndicator, Switch, Switch as SwitchComponent, THEME_COLOR_HEX_MAP, Table, TagsFilter, Textarea, ThemeContext, ThemePicker, ThemeProvider, TimeInput, TimeInput as TimeInputComponent, ToastContext, Tooltip, TwoColumnLayoutAgent, UploadFile, VerticalSteps, ViolinPlot, WhatsAppPreview, Wizard, WizardNavigation, WizardSidebar, applyCustomPrimaryColor, applyLindaTones, computeBars, computeMax, computeSlices, computeTotal, containerProps, createCurrencyFormatter, uniqueCountries as defaultCountries, defaultCurrencyOptions, defaultTranslations$5 as defaultTranslations, deriveLindaTones, dismissControlProps, forceLightOnlyThemeBeforeReact, formatAuroraThemeTooltip, generateThemeColorScale, getContrastForeground, getRegisteredThemeColorBases, getSelectedKeyFromPath, hexToHsl, hexToThemeColor, hslToCssValue, isAuroraFullThemeId, isDismissControl, isDonutEmpty, isExactThemeColor, isGroupState, isHexColor, isRankedBarListEmpty, isSegmentationGroup, parseColorToHsl, removeCustomPrimaryColor, removeLindaTones, shouldClosePopoverOnInteractOutside, sizeMap, themeColors, useAuraToast, useCloseOnAncestorScroll, useDisclosure, useMediaQuery, useNavigationLoading, useThemeContext };

package/dist/types/__smoke__/field-ref-surface.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Smoke test de tipos del `ref` de los campos de texto — TECH-2459 (hallazgo de beweanalytics,
+ * 10-sep).
+ *
+ * `Textarea`, `Input` e `InputPassword` se declaraban como funciones planas sin `ref` en sus props
+ * (`React.FC<TextareaProps>`, `React.FC<InputProps>`, `({…}: InputPasswordProps) =>`), así que
+ * TypeScript RECHAZABA `<Input ref={…} />` y el consumidor no podía alcanzar el `<input>`/
+ * `<textarea>` real. `VariableTextarea` de beweanalytics, que necesita el nodo para insertar
+ * variables en la posición del cursor, acabó colgando el ref del CONTENEDOR y buscando el
+ * `<textarea>` con una query; su guarda `if (!textarea) return` dejaba los botones mudos en
+ * silencio.
+ *
+ * En runtime el ref YA llegaba al elemento correcto por accidente (React 19 pasa `ref` como prop
+ * normal y viajaba dentro del `...rest` hasta la pieza de v3, que también hace spread), así que
+ * los tests de runtime —`components/input/Input.test.tsx` y `components/textarea/Textarea.test.tsx`,
+ * que sí ejercitan el caso real con `setSelectionRange`— NO detectarían una vuelta atrás.
+ * **Este fichero es el único gate del defecto que hubo**: si alguien devuelve una de las tres
+ * fachadas a `React.FC`, los `@ts-expect-error` de abajo se quedan sin error y `tsc` falla.
+ *
+ * Mismo mecanismo que `v2-api-surface.tsx`: no se ejecuta nunca (no hay runner que lo monte) y
+ * vive fuera del árbol de `src/index.tsx`, así que Rollup no lo empaqueta; `tsconfig.json` sí lo
+ * incluye (`include: ["src"]`), y por tanto `npx tsc --noEmit` lo valida.
+ */
+/** El tipo público expone el elemento REAL, no el contenedor. */
+declare function smokeFieldRefs(): import("react").JSX.Element;
+/**
+ * Y rechaza el ref del CONTENEDOR, que es justo el ref equivocado que tendría el consumidor si la
+ * fachada reenviase el `<div>` de `TextField`/`InputGroup` en vez del campo.
+ */
+declare function smokeFieldRefsRejectContainer(): import("react").JSX.Element;
+/** Un ref de callback también compila, con el elemento correcto ya tipado. */
+declare function smokeFieldCallbackRefs(): import("react").JSX.Element;
+export { smokeFieldRefs, smokeFieldRefsRejectContainer, smokeFieldCallbackRefs, };
+//# sourceMappingURL=field-ref-surface.d.ts.map

package/dist/types/__smoke__/field-ref-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-ref-surface.d.ts","sourceRoot":"","sources":["../../../src/__smoke__/field-ref-surface.tsx"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,iEAAiE;AACjE,iBAAS,cAAc,gCActB;AAED;;;GAGG;AACH,iBAAS,6BAA6B,gCAYrC;AAED,8EAA8E;AAC9E,iBAAS,sBAAsB,gCAiB9B;AAED,OAAO,EACN,cAAc,EACd,6BAA6B,EAC7B,sBAAsB,GACtB,CAAC"}

package/dist/types/__smoke__/v2-api-surface.d.ts

@@ -48,7 +48,18 @@ declare function smokeTabs(): import("react").JSX.Element;
 declare function smokeCardChildren(): import("react").JSX.Element;
 /** Familia Drawer v2. */
 declare function smokeDrawer(): import("react").JSX.Element;
-/** Familia Dropdown v2 (sección con `Header`, no prop `title`). */
+/**
+ * Familia Dropdown v2, con el JSX v2 COMPLETO de la sección: `title` + `classNames.heading`, tal
+ * como los monta el gestor de columnas de beweossmbs. Dejó de necesitar el `Header` crudo de
+ * `@heroui/react` el 10-sep-2026: la fachada `DropdownSection` repone el `title` de v2 y publica
+ * la pieza de v3 como estático (`DropdownSection.Header`), así que la cabecera ya tiene vía legal
+ * desde una app. Se ejercitan las dos formas.
+ *
+ * `shouldCloseOnSelect` NO aparece aquí porque el nombre v2 (`closeOnSelect`) no se repone en la
+ * fachada: es un renombrado que las apps aplican en su propio marcado (ver el README del
+ * componente). Tampoco `placement`/`offset`/`shouldCloseOnScroll`, que en v2 iban en el ROOT y en
+ * v3 son del `Dropdown.Popover` (o no existen) — también en el README, con los usos medidos.
+ */
 declare function smokeDropdown(): import("react").JSX.Element;
 /** AccordionItem v2 suelto. */
 declare function smokeAccordion(): import("react").JSX.Element;

package/dist/types/__smoke__/v2-api-surface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"v2-api-surface.d.ts","sourceRoot":"","sources":["../../../src/__smoke__/v2-api-surface.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,EAIN,KAAK,UAAU,EAUf,KAAK,aAAa,EAqBlB,KAAK,SAAS,EACd,KAAK,cAAc,EAGnB,KAAK,WAAW,EAChB,KAAK,oBAAoB,EASzB,KAAK,aAAa,EAIlB,MAAM,UAAU,CAAC;AAMlB,6EAA6E;AAC7E,iBAAS,iBAAiB,gCAWzB;AAED,wEAAwE;AACxE,iBAAS,oBAAoB,gCAQ5B;AAED,gEAAgE;AAChE,iBAAS,cAAc,gCAEtB;AAED,kFAAkF;AAClF,iBAAS,YAAY,gCAEpB;AAED,+DAA+D;AAC/D,iBAAS,UAAU,gCAElB;AAMD,oGAAoG;AACpG,iBAAS,gBAAgB,gCASxB;AAED,6CAA6C;AAC7C,iBAAS,UAAU,gCAalB;AAED,2DAA2D;AAC3D,iBAAS,SAAS,gCAMjB;AAED,gFAAgF;AAChF,iBAAS,iBAAiB,gCAQzB;AAED,yBAAyB;AACzB,iBAAS,WAAW,gCAUnB;AAED,mEAAmE;AACnE,iBAAS,aAAa,gCAcrB;AAED,+BAA+B;AAC/B,iBAAS,cAAc,gCAMtB;AAED,mGAAmG;AACnG,iBAAS,UAAU,gCAOlB;AAED,gCAAgC;AAChC,iBAAS,gBAAgB,gCAMxB;AAMD,uFAAuF;AACvF,iBAAS,mBAAmB,gCAM3B;AAMD,iBAAS,aAAa,gCAErB;AASD;;;;;;;;;GASG;AACH,iBAAS,uBAAuB,CAC/B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,EAC9B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,OAAO,+BAgBjB;AAED;;;GAGG;AACH,iBAAS,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,+BAoBxE;AAED,8DAA8D;AAC9D,iBAAS,gBAAgB,IAAI,WAAW,CAEvC;AAED;;;;GAIG;AACH,iBAAS,sBAAsB,CAAC,KAAK,EAAE,oBAAoB,+BAE1D;AAED,+DAA+D;AAC/D,iBAAS,qBAAqB,gCAW7B;AAaD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,iBAAS,yBAAyB,CACjC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAAE,EACpB,iBAAiB,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,+BAsC5C;AAED;;;;;;;;;GASG;AACH,iBAAS,4BAA4B,gCAUpC;AAMD,iGAAiG;AACjG,iBAAS,oBAAoB;;;EAO5B;AAED,qGAAqG;AACrG,iBAAS,eAAe,IAAI,UAAU,CAWrC;AAED,iGAAiG;AACjG,iBAAS,oBAAoB,IAAI,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,CAElE;AAOD,0GAA0G;AAC1G,iBAAS,YAAY,gCA+BpB;AAED,wFAAwF;AACxF,iBAAS,oBAAoB,gCAW5B;AAED,yGAAyG;AACzG,iBAAS,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,+BAyBtE;AAED,iEAAiE;AACjE,iBAAS,uBAAuB,gCAS/B;AAED,gEAAgE;AAChE,iBAAS,kBAAkB,IAAI,aAAa,CAE3C;AAED,iGAAiG;AACjG,iBAAS,kBAAkB,IAAI,aAAa,CAU3C;AAMD,iBAAS,kBAAkB;;iBAMP,IAAI;kBACH,IAAI;sBACA,OAAO,KAAK,IAAI;mBACnB,IAAI;EAEzB;AAKD,iBAAS,OAAO,yCAEf;AAKD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCjC,CAAC"}
+{"version":3,"file":"v2-api-surface.d.ts","sourceRoot":"","sources":["../../../src/__smoke__/v2-api-surface.tsx"],"names":[],"mappings":"AAWA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,EAIN,KAAK,UAAU,EAUf,KAAK,aAAa,EAqBlB,KAAK,SAAS,EACd,KAAK,cAAc,EAGnB,KAAK,WAAW,EAChB,KAAK,oBAAoB,EASzB,KAAK,aAAa,EAIlB,MAAM,UAAU,CAAC;AAMlB,6EAA6E;AAC7E,iBAAS,iBAAiB,gCAWzB;AAED,wEAAwE;AACxE,iBAAS,oBAAoB,gCAQ5B;AAED,gEAAgE;AAChE,iBAAS,cAAc,gCAEtB;AAED,kFAAkF;AAClF,iBAAS,YAAY,gCAEpB;AAED,+DAA+D;AAC/D,iBAAS,UAAU,gCAElB;AAMD,oGAAoG;AACpG,iBAAS,gBAAgB,gCASxB;AAED,6CAA6C;AAC7C,iBAAS,UAAU,gCAalB;AAED,2DAA2D;AAC3D,iBAAS,SAAS,gCAMjB;AAED,gFAAgF;AAChF,iBAAS,iBAAiB,gCAQzB;AAED,yBAAyB;AACzB,iBAAS,WAAW,gCAUnB;AAED;;;;;;;;;;;GAWG;AACH,iBAAS,aAAa,gCAoBrB;AAED,+BAA+B;AAC/B,iBAAS,cAAc,gCAMtB;AAED,mGAAmG;AACnG,iBAAS,UAAU,gCAOlB;AAED,gCAAgC;AAChC,iBAAS,gBAAgB,gCAMxB;AAMD,uFAAuF;AACvF,iBAAS,mBAAmB,gCAM3B;AAMD,iBAAS,aAAa,gCAErB;AASD;;;;;;;;;GASG;AACH,iBAAS,uBAAuB,CAC/B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,EAC9B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,OAAO,+BAgBjB;AAED;;;GAGG;AACH,iBAAS,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,+BAoBxE;AAED,8DAA8D;AAC9D,iBAAS,gBAAgB,IAAI,WAAW,CAEvC;AAED;;;;GAIG;AACH,iBAAS,sBAAsB,CAAC,KAAK,EAAE,oBAAoB,+BAE1D;AAED,+DAA+D;AAC/D,iBAAS,qBAAqB,gCAW7B;AAaD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,iBAAS,yBAAyB,CACjC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAAE,EACpB,iBAAiB,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,+BAsC5C;AAED;;;;;;;;;GASG;AACH,iBAAS,4BAA4B,gCAUpC;AAMD,iGAAiG;AACjG,iBAAS,oBAAoB;;;EAO5B;AAED,qGAAqG;AACrG,iBAAS,eAAe,IAAI,UAAU,CAWrC;AAED,iGAAiG;AACjG,iBAAS,oBAAoB,IAAI,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,CAElE;AAOD,0GAA0G;AAC1G,iBAAS,YAAY,gCA+BpB;AAED,wFAAwF;AACxF,iBAAS,oBAAoB,gCAW5B;AAED,yGAAyG;AACzG,iBAAS,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,+BAyBtE;AAED,iEAAiE;AACjE,iBAAS,uBAAuB,gCAS/B;AAED,gEAAgE;AAChE,iBAAS,kBAAkB,IAAI,aAAa,CAE3C;AAED,iGAAiG;AACjG,iBAAS,kBAAkB,IAAI,aAAa,CAU3C;AAMD,iBAAS,kBAAkB;;iBAMP,IAAI;kBACH,IAAI;sBACA,OAAO,KAAK,IAAI;mBACnB,IAAI;EAEzB;AAKD,iBAAS,OAAO,yCAEf;AAKD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCjC,CAAC"}

package/dist/types/components/autocomplete/AutoComplete.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AutoComplete.d.ts","sourceRoot":"","sources":["../../../../src/components/autocomplete/AutoComplete.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EACX,qBAAqB,EAGrB,MAAM,sBAAsB,CAAC;AA2O9B;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CA+F5D,CAAC"}
+{"version":3,"file":"AutoComplete.d.ts","sourceRoot":"","sources":["../../../../src/components/autocomplete/AutoComplete.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EACX,qBAAqB,EAGrB,MAAM,sBAAsB,CAAC;AA2O9B;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAwH5D,CAAC"}

package/dist/types/components/datepicker/DatePicker.d.ts

@@ -6,6 +6,6 @@ import type { DatePickerProps } from "./DatePicker.types";
  * (grid) para que la API pública siga siendo un único componente con props planas, igual que en
  * v2 (label, description, errorMessage, endContent, variant, size, radius).
  */
-export declare function DatePicker<T extends DateValue = DateValue>({ label, description, errorMessage, id, size, variant, radius, isInvalid, isRequired, isDisabled, fullWidth, endContent, className, "aria-label": ariaLabel, ...props }: DatePickerProps<T>): import("react").JSX.Element;
+export declare function DatePicker<T extends DateValue = DateValue>({ label, description, errorMessage, id, size, variant, radius, isInvalid, isRequired, isDisabled, fullWidth, endContent, calendarBottomContent, className, "aria-label": ariaLabel, ...props }: DatePickerProps<T>): import("react").JSX.Element;
 export default DatePicker;
 //# sourceMappingURL=DatePicker.d.ts.map

package/dist/types/components/datepicker/DatePicker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DatePicker.d.ts","sourceRoot":"","sources":["../../../../src/components/datepicker/DatePicker.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,KAAK,EACX,eAAe,EAIf,MAAM,oBAAoB,CAAC;AA6E5B;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EAAE,EAC3D,KAAK,EACL,WAAW,EACX,YAAY,EACZ,EAAE,EACF,IAAW,EACX,OAAoB,EACpB,MAAa,EACb,SAAiB,EACjB,UAAkB,EAClB,UAAkB,EAClB,SAAS,EACT,UAAU,EACV,SAAS,EACT,YAAY,EAAE,SAAS,EACvB,GAAG,KAAK,EACR,EAAE,eAAe,CAAC,CAAC,CAAC,+BA0EpB;AAED,eAAe,UAAU,CAAC"}
+{"version":3,"file":"DatePicker.d.ts","sourceRoot":"","sources":["../../../../src/components/datepicker/DatePicker.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,KAAK,EACX,eAAe,EAIf,MAAM,oBAAoB,CAAC;AA6E5B;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EAAE,EAC3D,KAAK,EACL,WAAW,EACX,YAAY,EACZ,EAAE,EACF,IAAW,EACX,OAAoB,EACpB,MAAa,EACb,SAAiB,EACjB,UAAkB,EAClB,UAAkB,EAClB,SAAS,EACT,UAAU,EACV,qBAAqB,EACrB,SAAS,EACT,YAAY,EAAE,SAAS,EACvB,GAAG,KAAK,EACR,EAAE,eAAe,CAAC,CAAC,CAAC,+BAwGpB;AAED,eAAe,UAAU,CAAC"}

package/dist/types/components/datepicker/DatePicker.types.d.ts

@@ -17,6 +17,44 @@ export interface DatePickerProps<T extends DateValue = DateValue> extends Omit<D
      * prop reemplaza ese icono por defecto, igual que hacía `endContent` en v2.
      */
     endContent?: ReactNode;
+    /**
+     * Contenido libre DENTRO del popover, bajo el calendario: el sitio de los presets
+     * ("Último mes cerrado", "Últimos 3 meses", "Año en curso"…) y de cualquier acción propia del
+     * desplegable.
+     *
+     * **Sustituye a `CalendarBottomContent` de HeroUI v2** — busca por ese nombre si vienes de v2.
+     * En v2 era `CalendarProps["bottomContent"]`; el nombre cambia a la convención `…Content` en
+     * camelCase del resto de la librería (`startContent`, `endContent`, `extraContent`).
+     *
+     * Lo medido en el navegador (Storybook, `custom-components-datepicker--with-calendar-bottom-content`):
+     *
+     * - Se pinta dentro del popover y 9px por debajo de la rejilla, alineado con ella: el popover
+     *   mide 276px (los 252px del calendario + su `p-3`) y el contenido a lo ancho llega a esos
+     *   252px sin pedirlo. Contenido MÁS ancho que 252px ensancha el popover, que es `w-fit`.
+     * - **Pulsar algo aquí no cierra el popover** — comprobado con 9 casos (ratón y Enter, botón
+     *   inerte y botón que escribe el valor, en `DatePicker` y en `DateRangePicker`): el popover
+     *   sigue abierto y el valor llega al campo. Se cierra por las vías de siempre (elegir en la
+     *   rejilla, `Escape`, clic fuera). Si quieres cerrarlo desde un preset, hazlo tú.
+     * - Es alcanzable por teclado: un `Tab` desde la celda del calendario.
+     * - Sigue visible y pulsable con el selector de año abierto (la rejilla de años de v3 se
+     *   posiciona en absoluto sobre la de días, no sobre el resto del popover).
+     * - Si el contenido es alto y el popover no tiene sitio, React Aria le pone un `max-height`
+     *   según el hueco disponible y el popover hace scroll (medido: 405px de contenido en un
+     *   techo de 380px al abrirse hacia arriba). Con sitio suficiente no se recorta nada.
+     *
+     * @example
+     * ```tsx
+     * <DatePicker
+     *   label="Fecha"
+     *   calendarBottomContent={
+     *     <Button size="sm" fullWidth onPress={() => setDate(today(getLocalTimeZone()))}>
+     *       Hoy
+     *     </Button>
+     *   }
+     * />
+     * ```
+     */
+    calendarBottomContent?: ReactNode;
     isInvalid?: boolean;
     isRequired?: boolean;
     isDisabled?: boolean;