energy-components 2.1.0 → 2.3.0

package/dist/types/src/components/content/table/table-renderer.vue.d.ts

@@ -5,7 +5,11 @@ declare const _default: <T extends Record<string, any>>(__VLS_props: NonNullable
         readonly onToggleSelectAll?: ((value: boolean) => any) | undefined;
         readonly onToggleRowSelection?: ((row: T) => any) | undefined;
         readonly onRowClick?: ((row: T) => any) | undefined;
-    } & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, never>, "onHeaderClick" | "onToggleSelectAll" | "onToggleRowSelection" | "onRowClick"> & {
+        readonly onColumnResize?: ((payload: {
+            key: string;
+            width: number;
+        }) => any) | undefined;
+    } & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, never>, "onHeaderClick" | "onToggleSelectAll" | "onToggleRowSelection" | "onRowClick" | "onColumnResize"> & {
         headers: TableHeader<T>[];
         rows: T[];
         rowKey: keyof T;
@@ -18,6 +22,7 @@ declare const _default: <T extends Record<string, any>>(__VLS_props: NonNullable
         emptyStateText?: string;
         selectedKeys?: Array<string | number>;
         expandedKeys?: Array<string | number>;
+        resizableColumns?: boolean;
         rowClass?: (row: T, index: number) => string;
         cellClass?: (row: T, header: TableHeader, index: number) => string;
         isRowDisabled?: (row: T) => boolean;
@@ -46,6 +51,10 @@ declare const _default: <T extends Record<string, any>>(__VLS_props: NonNullable
         (e: "toggleSelectAll", value: boolean): void;
         (e: "toggleRowSelection", row: T): void;
         (e: "rowClick", row: T): void;
+        (e: "columnResize", payload: {
+            key: string;
+            width: number;
+        }): void;
     };
 }>) => import("vue").VNode & {
     __ctx?: Awaited<typeof __VLS_setup>;

package/dist/types/src/components/content/table/table.vue.d.ts

@@ -1,6 +1,10 @@
 import type { SortDescriptor, TableHeader } from './types';
 declare const _default: <T extends Record<string, any>>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
     props: __VLS_PrettifyLocal<Pick<Partial<{}> & Omit<{
+        readonly onColumnResize?: ((v: {
+            key: string;
+            width: number;
+        }) => any) | undefined;
         readonly "onUpdate:page"?: ((v: number) => any) | undefined;
         readonly "onUpdate:pageSize"?: ((v: number) => any) | undefined;
         readonly "onUpdate:sort"?: ((v: SortDescriptor | null) => any) | undefined;
@@ -12,7 +16,7 @@ declare const _default: <T extends Record<string, any>>(__VLS_props: NonNullable
         }) => any) | undefined;
         readonly onSelectionChange?: ((v: (string | number)[]) => any) | undefined;
         readonly onRowExpand?: ((v: T) => any) | undefined;
-    } & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, never>, "onUpdate:page" | "onUpdate:pageSize" | "onUpdate:sort" | "onUpdate:checkedKeys" | "onOptionsChange" | "onSelectionChange" | "onRowExpand"> & {
+    } & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, never>, "onColumnResize" | "onUpdate:page" | "onUpdate:pageSize" | "onUpdate:sort" | "onUpdate:checkedKeys" | "onOptionsChange" | "onSelectionChange" | "onRowExpand"> & {
         /**
          * Definición de las columnas de la tabla.
          * Cada objeto define clave, texto, ancho, alineación y si es ordenable.
@@ -132,6 +136,10 @@ declare const _default: <T extends Record<string, any>>(__VLS_props: NonNullable
          * Predicado para deshabilitar la selección (checkbox/radio) de una fila específica.
          */
         isRowDisabled?: (row: T) => boolean;
+        /**
+         * Activa el resize de columnas arrastrando el borde derecho del encabezado.
+         */
+        resizableColumns?: boolean;
     } & Partial<{}>> & import("vue").PublicProps;
     expose(exposed: import("vue").ShallowUnwrapRef<{
         reset: () => void;
@@ -158,6 +166,10 @@ declare const _default: <T extends Record<string, any>>(__VLS_props: NonNullable
         }): void;
         (e: "selectionChange", v: Array<string | number>): void;
         (e: "rowExpand", v: T): void;
+        (e: "columnResize", v: {
+            key: string;
+            width: number;
+        }): void;
     };
 }>) => import("vue").VNode & {
     __ctx?: Awaited<typeof __VLS_setup>;

package/dist/types/src/components/content/table/use-column-resize.d.ts

@@ -0,0 +1,9 @@
+import type { Ref } from 'vue';
+import type { TableHeader } from './types';
+export declare function useColumnResize(headers: Ref<TableHeader[]>): {
+    columnWidths: Record<string, number>;
+    resizingKey: Ref<string | null, string | null>;
+    startResize: (key: string, event: PointerEvent, onEnd: (k: string) => void, initialWidth?: number) => void;
+    stopResize: () => void;
+    applyMeasuredWidths: (measured: Record<string, number>) => void;
+};

package/dist/types/src/components/feedback/indicator-dots/indicator-dots.vue.d.ts

@@ -0,0 +1,181 @@
+type SizeType = 'default' | 'small';
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    /**
+     * Número total de elementos a indicar.
+     */
+    items: {
+        type: NumberConstructor;
+        required: true;
+        validator(value: number): boolean;
+    };
+    /**
+     * Índice del elemento activo actual (base 0).
+     */
+    modelValue: {
+        type: NumberConstructor;
+        required: true;
+    };
+    /**
+     * Muestra los botones de flecha anterior/siguiente.
+     */
+    showArrows: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * Variante de tamaño del componente.
+     */
+    size: {
+        type: () => SizeType;
+        default: string;
+    };
+    /**
+     * Usa los tokens de color inverso (superficie oscura).
+     */
+    inverse: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * Número máximo de puntos visibles a la vez antes de activar la ventana deslizante.
+     */
+    maxVisible: {
+        type: NumberConstructor;
+        default: number;
+    };
+    /**
+     * Duración en milisegundos de cada elemento antes de avanzar automáticamente cuando isPlaying es true.
+     */
+    playInterval: {
+        type: NumberConstructor;
+        default: number;
+    };
+    /**
+     * Si es true, habilita la navegación manual: flechas (si showArrows) y clics en los puntos.
+     * Si es false, las flechas se ocultan y los puntos son solo visuales.
+     */
+    interactive: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * Muestra el botón de acción play/pause al final del componente.
+     */
+    showPlayPause: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * Si es true, el componente avanza automáticamente por los elementos con un temporizador, emitiendo update:modelValue.
+     * El botón play/pause (showPlayPause) refleja y controla este estado.
+     */
+    isPlaying: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * Atributo ID opcional para pruebas.
+     */
+    id: {
+        type: StringConstructor;
+        default: undefined;
+    };
+}>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    "update:modelValue": (value: number) => any;
+    playPauseClick: () => any;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    /**
+     * Número total de elementos a indicar.
+     */
+    items: {
+        type: NumberConstructor;
+        required: true;
+        validator(value: number): boolean;
+    };
+    /**
+     * Índice del elemento activo actual (base 0).
+     */
+    modelValue: {
+        type: NumberConstructor;
+        required: true;
+    };
+    /**
+     * Muestra los botones de flecha anterior/siguiente.
+     */
+    showArrows: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * Variante de tamaño del componente.
+     */
+    size: {
+        type: () => SizeType;
+        default: string;
+    };
+    /**
+     * Usa los tokens de color inverso (superficie oscura).
+     */
+    inverse: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * Número máximo de puntos visibles a la vez antes de activar la ventana deslizante.
+     */
+    maxVisible: {
+        type: NumberConstructor;
+        default: number;
+    };
+    /**
+     * Duración en milisegundos de cada elemento antes de avanzar automáticamente cuando isPlaying es true.
+     */
+    playInterval: {
+        type: NumberConstructor;
+        default: number;
+    };
+    /**
+     * Si es true, habilita la navegación manual: flechas (si showArrows) y clics en los puntos.
+     * Si es false, las flechas se ocultan y los puntos son solo visuales.
+     */
+    interactive: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * Muestra el botón de acción play/pause al final del componente.
+     */
+    showPlayPause: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * Si es true, el componente avanza automáticamente por los elementos con un temporizador, emitiendo update:modelValue.
+     * El botón play/pause (showPlayPause) refleja y controla este estado.
+     */
+    isPlaying: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * Atributo ID opcional para pruebas.
+     */
+    id: {
+        type: StringConstructor;
+        default: undefined;
+    };
+}>> & Readonly<{
+    "onUpdate:modelValue"?: ((value: number) => any) | undefined;
+    onPlayPauseClick?: (() => any) | undefined;
+}>, {
+    size: SizeType;
+    id: string;
+    inverse: boolean;
+    showArrows: boolean;
+    maxVisible: number;
+    playInterval: number;
+    interactive: boolean;
+    showPlayPause: boolean;
+    isPlaying: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/types/src/components/index.d.ts

@@ -4,6 +4,7 @@ export { default as RDSFloatinActionButton } from './buttons/floating-action-but
 export { default as RDSActionButton } from './buttons/action-button/action-button.vue';
 export { default as RDSCheckbox } from './input/checkbox/checkbox.vue';
 export { default as RDSTextField } from './input/text-field/text-field.vue';
+export { default as RDSSearchField } from './input/search-field/search-field.vue';
 export { default as RDSTextArea } from './input/text-area/text-area.vue';
 export { default as RDSSwitch } from './input/switch/switch.vue';
 export { default as RDSRadioButton } from './input/radio-button/radio-button.vue';
@@ -31,6 +32,7 @@ export { default as RDSTabBar } from './navigation/tab-bar/tab-bar.vue';
 export { default as RDSPagination } from './navigation/pagination/pagination.vue';
 export { default as RDSDirectAccess } from './navigation/direct-access/direct-access.vue';
 export { default as RDSIndicator } from './feedback/indicator/indicator.vue';
+export { default as RDSIndicatorDots } from './feedback/indicator-dots/indicator-dots.vue';
 export { default as RDSBadge } from './feedback/badge/badge.vue';
 export { default as RDSPersistentToast } from './feedback/persistent-toast/persistent-toast.vue';
 export { default as RDSSnackBar } from './feedback/snack-bar/snack-bar.vue';

package/dist/types/src/components/input/datepicker/datepicker.vue.d.ts

@@ -25,6 +25,18 @@ declare const __VLS_component: import("vue").DefineComponent<ExtractPropTypes<{
         type: StringConstructor;
         required: true;
     };
+    /**
+     * Versión compacta del datepicker con altura reducida (42px en lugar de 52px).
+     * En este modo se ocultan visualmente el label y el helper text para ahorrar espacio.
+     *
+     * ⚠️ **Uso recomendado**: Solo para celdas de tablas editables.
+     * No se recomienda fuera de este contexto por cuestiones de accesibilidad,
+     * ya que la ausencia del label visible puede dificultar la comprensión del campo.
+     */
+    compact: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
     /**
      * Etiqueta para el interruptor
      */
@@ -177,6 +189,18 @@ declare const __VLS_component: import("vue").DefineComponent<ExtractPropTypes<{
         type: StringConstructor;
         required: true;
     };
+    /**
+     * Versión compacta del datepicker con altura reducida (42px en lugar de 52px).
+     * En este modo se ocultan visualmente el label y el helper text para ahorrar espacio.
+     *
+     * ⚠️ **Uso recomendado**: Solo para celdas de tablas editables.
+     * No se recomienda fuera de este contexto por cuestiones de accesibilidad,
+     * ya que la ausencia del label visible puede dificultar la comprensión del campo.
+     */
+    compact: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
     /**
      * Etiqueta para el interruptor
      */
@@ -312,6 +336,7 @@ declare const __VLS_component: import("vue").DefineComponent<ExtractPropTypes<{
     [x: `on${Capitalize<any>}`]: ((...args: any) => any) | undefined;
 }>, {
     label: string;
+    compact: boolean;
     range: boolean;
     disabled: boolean;
     clearable: boolean;

package/dist/types/src/components/input/dropdown/dropdown.vue.d.ts

@@ -51,6 +51,18 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
         required: true;
         validator: (value: any) => boolean;
     };
+    /**
+     * Versión compacta del dropdown con altura reducida (42px en lugar de 52px).
+     * En este modo se ocultan visualmente el label y el helper text para ahorrar espacio.
+     *
+     * ⚠️ **Uso recomendado**: Solo para celdas de tablas editables.
+     * No se recomienda fuera de este contexto por cuestiones de accesibilidad,
+     * ya que la ausencia del label visible puede dificultar la comprensión del campo.
+     */
+    compact: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
     label: {
         type: StringConstructor;
         required: true;
@@ -234,6 +246,18 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
         required: true;
         validator: (value: any) => boolean;
     };
+    /**
+     * Versión compacta del dropdown con altura reducida (42px en lugar de 52px).
+     * En este modo se ocultan visualmente el label y el helper text para ahorrar espacio.
+     *
+     * ⚠️ **Uso recomendado**: Solo para celdas de tablas editables.
+     * No se recomienda fuera de este contexto por cuestiones de accesibilidad,
+     * ya que la ausencia del label visible puede dificultar la comprensión del campo.
+     */
+    compact: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
     label: {
         type: StringConstructor;
         required: true;
@@ -402,6 +426,7 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
     loading: boolean;
     error: boolean;
     small: boolean;
+    compact: boolean;
     multiple: boolean;
     disabled: boolean;
     inverse: boolean;

package/dist/types/src/components/input/search-field/search-field.vue.d.ts

@@ -0,0 +1,137 @@
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    /**
+     * v-model valor del campo de búsqueda.
+     */
+    modelValue: {
+        type: StringConstructor;
+        required: true;
+    };
+    /**
+     * Texto de ayuda contextual que se muestra cuando el campo está vacío.
+     */
+    placeholder: {
+        type: StringConstructor;
+        default: string;
+    };
+    /**
+     * Indica si el campo está deshabilitado.
+     */
+    disabled: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * Versión reducida del campo (altura 40px en lugar de 52px).
+     */
+    small: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * Lista de sugerencias a mostrar cuando el campo tiene contenido.
+     * El componente padre es responsable de filtrar las sugerencias.
+     */
+    suggestions: {
+        type: () => string[];
+        default: () => never[];
+    };
+    /**
+     * Número máximo de caracteres permitidos.
+     */
+    maxLength: {
+        type: NumberConstructor;
+        required: false;
+    };
+    /**
+     * Identificador único del campo. Se autogenera si no se proporciona.
+     */
+    id: {
+        type: StringConstructor;
+        required: false;
+    };
+    /**
+     * Texto accesible del botón de limpiar. Permite internacionalización.
+     */
+    clearButtonAriaLabel: {
+        type: StringConstructor;
+        default: string;
+    };
+}>, {
+    focus: () => void;
+    blur: () => void;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    search: (value: string) => any;
+    select: (value: string) => any;
+    clear: () => any;
+    "update:modelValue": (value: string) => any;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    /**
+     * v-model valor del campo de búsqueda.
+     */
+    modelValue: {
+        type: StringConstructor;
+        required: true;
+    };
+    /**
+     * Texto de ayuda contextual que se muestra cuando el campo está vacío.
+     */
+    placeholder: {
+        type: StringConstructor;
+        default: string;
+    };
+    /**
+     * Indica si el campo está deshabilitado.
+     */
+    disabled: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * Versión reducida del campo (altura 40px en lugar de 52px).
+     */
+    small: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * Lista de sugerencias a mostrar cuando el campo tiene contenido.
+     * El componente padre es responsable de filtrar las sugerencias.
+     */
+    suggestions: {
+        type: () => string[];
+        default: () => never[];
+    };
+    /**
+     * Número máximo de caracteres permitidos.
+     */
+    maxLength: {
+        type: NumberConstructor;
+        required: false;
+    };
+    /**
+     * Identificador único del campo. Se autogenera si no se proporciona.
+     */
+    id: {
+        type: StringConstructor;
+        required: false;
+    };
+    /**
+     * Texto accesible del botón de limpiar. Permite internacionalización.
+     */
+    clearButtonAriaLabel: {
+        type: StringConstructor;
+        default: string;
+    };
+}>> & Readonly<{
+    onSearch?: ((value: string) => any) | undefined;
+    onSelect?: ((value: string) => any) | undefined;
+    onClear?: (() => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string) => any) | undefined;
+}>, {
+    small: boolean;
+    disabled: boolean;
+    placeholder: string;
+    suggestions: string[];
+    clearButtonAriaLabel: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/types/src/components/input/text-field/text-field.vue.d.ts

@@ -1,11 +1,15 @@
 import { type PropType } from 'vue';
-declare var __VLS_1: {}, __VLS_9: {}, __VLS_20: {};
+declare var __VLS_1: {}, __VLS_9: {}, __VLS_11: {}, __VLS_13: {}, __VLS_24: {};
 type __VLS_Slots = {} & {
     'left-icon'?: (props: typeof __VLS_1) => any;
 } & {
-    'right-icon'?: (props: typeof __VLS_9) => any;
+    prefix?: (props: typeof __VLS_9) => any;
 } & {
-    'helper-text'?: (props: typeof __VLS_20) => any;
+    suffix?: (props: typeof __VLS_11) => any;
+} & {
+    'right-icon'?: (props: typeof __VLS_13) => any;
+} & {
+    'helper-text'?: (props: typeof __VLS_24) => any;
 };
 declare const __VLS_component: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
     /**
@@ -16,6 +20,19 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
         type: BooleanConstructor;
         default: boolean;
     };
+    /**
+     * Versión compacta del campo de texto con altura reducida (42px en lugar de 52px).
+     * En este modo se ocultan visualmente el label y el helper text para ahorrar espacio.
+     * Los eventos y cambios de estado visual se mantienen.
+     *
+     * ⚠️ **Uso recomendado**: Solo para celdas de tablas editables.
+     * No se recomienda fuera de este contexto por cuestiones de accesibilidad,
+     * ya que la ausencia del label visible puede dificultar la comprensión del campo.
+     */
+    compact: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
     /**
      * Etiqueta que se muestra sobre el campo de entrada. y Placeholder
      */
@@ -37,6 +54,20 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
         type: (StringConstructor | NumberConstructor | null)[];
         required: true;
     };
+    /**
+     * Texto a mostrar antes del valor del input. (Reemplaza al icono izquierdo si existe)
+     */
+    prefix: {
+        type: StringConstructor;
+        default: string;
+    };
+    /**
+     * Texto a mostrar después del valor del input, siguiendo dinámicamente al texto.
+     */
+    suffix: {
+        type: StringConstructor;
+        default: string;
+    };
     /**
      * Indica si el campo de entrada está deshabilitado o no.
      */
@@ -224,6 +255,19 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
         type: BooleanConstructor;
         default: boolean;
     };
+    /**
+     * Versión compacta del campo de texto con altura reducida (42px en lugar de 52px).
+     * En este modo se ocultan visualmente el label y el helper text para ahorrar espacio.
+     * Los eventos y cambios de estado visual se mantienen.
+     *
+     * ⚠️ **Uso recomendado**: Solo para celdas de tablas editables.
+     * No se recomienda fuera de este contexto por cuestiones de accesibilidad,
+     * ya que la ausencia del label visible puede dificultar la comprensión del campo.
+     */
+    compact: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
     /**
      * Etiqueta que se muestra sobre el campo de entrada. y Placeholder
      */
@@ -245,6 +289,20 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
         type: (StringConstructor | NumberConstructor | null)[];
         required: true;
     };
+    /**
+     * Texto a mostrar antes del valor del input. (Reemplaza al icono izquierdo si existe)
+     */
+    prefix: {
+        type: StringConstructor;
+        default: string;
+    };
+    /**
+     * Texto a mostrar después del valor del input, siguiendo dinámicamente al texto.
+     */
+    suffix: {
+        type: StringConstructor;
+        default: string;
+    };
     /**
      * Indica si el campo de entrada está deshabilitado o no.
      */
@@ -425,12 +483,15 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
     error: boolean;
     type: string;
     required: boolean;
+    compact: boolean;
     icon: string;
     disabled: boolean;
     spellcheck: boolean;
+    prefix: string;
     fullWidth: boolean;
     readonly: boolean;
     password: boolean;
+    suffix: string;
     rightIcon: string;
     helper: boolean;
     helperText: string;

package/dist/types/src/components/overlay/tooltip/tooltip.vue.d.ts

@@ -104,7 +104,7 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
         default: boolean;
     };
     /**
-     * <span>Controla la visibilidad mediante v-model:open. Si se establece, el componente se comporta de forma controlada.</span>
+     * <span>Controla la visibilidad mediante v-model:open. Si se pasa (true o false), el componente entra en modo controlado: los eventos internos (hover/focus/click) solo emiten `update:open` sin cambiar la visibilidad directamente. Para volver al modo no controlado, no pasar la prop (undefined).</span>
      */
     open: {
         type: BooleanConstructor;
@@ -239,7 +239,7 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
         default: boolean;
     };
     /**
-     * <span>Controla la visibilidad mediante v-model:open. Si se establece, el componente se comporta de forma controlada.</span>
+     * <span>Controla la visibilidad mediante v-model:open. Si se pasa (true o false), el componente entra en modo controlado: los eventos internos (hover/focus/click) solo emiten `update:open` sin cambiar la visibilidad directamente. Para volver al modo no controlado, no pasar la prop (undefined).</span>
      */
     open: {
         type: BooleanConstructor;