@prolibu-suite/cobalt-core 0.11.0 → 0.11.2

package/dist/types/components/co-calendar-timegrid/co-calendar-timegrid.d.ts

@@ -5,29 +5,49 @@ import { type NormalizedEvent } from '@prolibu-suite/cobalt-calendar-utils';
  * `dates` = 7 day-keys (week) or 1 (day). Presentation + interaction only; the
  * host owns data (CONTROLLED). All instant math is delegated to the engine — the
  * only timezone boundary is the `timeZone` prop (wall-clock render).
+ *
+ * Es la vista Semana/Día que compone `co-event-calendar`; se usa directo solo
+ * para una grilla horaria propia. Sus eventos NO burbujean ni cruzan el shadow
+ * DOM: se escuchan sobre el propio elemento. Wrapper Vue: `CoCalendarTimegrid`
+ * de `@prolibu-suite/cobalt-vue`.
  */
 export declare class CoCalendarTimegrid {
     el: HTMLElement;
+    /** Eventos ya normalizados por el motor (`@prolibu-suite/cobalt-calendar-utils`); propiedad JS. */
     events: NormalizedEvent[];
     /** Visible day keys "YYYY-MM-DD" (7 = week, 1 = day). */
     dates: string[];
+    /** Locale BCP-47 de las cabeceras de día y las etiquetas de hora. */
     locale: string;
+    /** Zona IANA en la que se pinta el reloj (única frontera de zona horaria del componente). */
     timeZone: string;
+    /** Permite mover y redimensionar eventos arrastrando (salvo los que traen `editable: false`); emite `coEventDrop`. */
     editable: boolean;
+    /** Permite seleccionar un rango en un área vacía para crear; emite `coRangeSelect`. */
     selectable: boolean;
+    /** Primer día interactuable `YYYY-MM-DD`: antes no se puede seleccionar ni soltar. */
     minDate?: string;
+    /** Último día interactuable `YYYY-MM-DD`. */
     maxDate?: string;
+    /** Minutos por fila de la grilla (default 15); también el paso del teclado. */
     slotMinutes: number;
+    /** Minutos a los que se ajustan arrastres y selecciones (default 15). */
     snapMinutes: number;
+    /** Duración en minutos del rango creado con un click simple (default 60). */
     defaultDurationMinutes: number;
+    /** Hora `HH:mm` a la que scrollea la grilla al montar (default 07:00). */
     scrollTime: string;
+    /** Línea de «ahora» en la columna del día actual. */
     nowIndicator: boolean;
     /** Cargando: en vez de los eventos pinta bloques skeleton en las columnas.
      *  La grilla (eje de horas, líneas, cabecera de días, franja de todo-el-día)
      *  se mantiene: lo único que todavía no se sabe son los eventos. */
     loading: boolean;
+    /** Franja superior de eventos de todo el día. */
     allDaySlot: boolean;
+    /** Primera hora visible `HH:mm` (default 00:00). */
     minTime: string;
+    /** Última hora visible `HH:mm` (default 24:00). */
     maxTime: string;
     /** Minute of "now" for the indicator; refreshed on a 60s timer. */
     nowMinutes: number;
@@ -47,10 +67,13 @@ export declare class CoCalendarTimegrid {
             height: number;
         };
     }>;
+    /** Click en un evento: `{ id, rect }` (rect del chip, para anclar un popover). No burbujea. */
     coEventClick: EventEmitter<{
         id: string;
         rect?: DOMRect;
     }>;
+    /** Se movió o redimensionó un evento: `{ id, start, end, oldStart, oldEnd, allDay }` (instantes ISO UTC).
+     *  Controlado: el host decide si aplica el cambio actualizando `events`. No burbujea. */
     coEventDrop: EventEmitter<{
         id: string;
         start: string;

package/dist/types/components/co-card/co-card.d.ts

@@ -1,4 +1,13 @@
 /**
+ * Contenedor tipo tarjeta con header, cuerpo y footer, en variantes elevada,
+ * con borde o plana; opcionalmente clickeable. Wrapper Vue: `CoCard` de
+ * `@prolibu-suite/cobalt-vue`.
+ *
+ * @part card - La tarjeta.
+ * @part header - Área del slot `header`.
+ * @part body - Cuerpo (slot por defecto).
+ * @part footer - Área del slot `footer`.
+ *
  * @slot header  - Card header area (image, title, actions)
  * @slot         - Default slot for card body/content
  * @slot footer  - Card footer area (meta, actions)

package/dist/types/components/co-carousel/co-carousel.d.ts

@@ -5,8 +5,17 @@ import { EventEmitter } from '../../stencil-public-runtime';
  * inertness on each item and translates a flex track to the active index.
  *
  * No v-model in the Vue wrappers — consume with `:value` + `@coSlideChange`.
+ * Wrapper Vue: `CoCarousel` de `@prolibu-suite/cobalt-vue`.
  *
  * @slot - co-carousel-item elements
+ *
+ * @part container - Caja del carrusel (relación de aspecto).
+ * @part viewport - Ventana visible que recorta los slides.
+ * @part track - Tira de slides que se desplaza al activo.
+ * @part arrow-prev - Flecha «anterior».
+ * @part arrow-next - Flecha «siguiente».
+ * @part dots - Grupo de indicadores.
+ * @part dot - Cada indicador (botón que lleva a su slide).
  */
 export declare class CoCarousel {
     el: HTMLElement;
@@ -57,8 +66,11 @@ export declare class CoCarousel {
     watchValue(): void;
     watchLocale(): void;
     watchAutoplay(): void;
+    /** Avanza al slide siguiente (con `loop`, del último vuelve al primero). */
     next(): Promise<void>;
+    /** Retrocede al slide anterior (con `loop`, del primero va al último). */
     prev(): Promise<void>;
+    /** Va al slide `index` (base 0; se recorta al rango válido). Emite `coSlideChange`. */
     goTo(index: number): Promise<void>;
     private getItems;
     private refreshItems;

package/dist/types/components/co-checkbox/co-checkbox.d.ts

@@ -1,4 +1,12 @@
 import { EventEmitter } from '../../stencil-public-runtime';
+/**
+ * Casilla de verificación con etiqueta, estado indeterminado y variante de chip
+ * de selección (`appearance="overlay"`). Wrapper Vue: `CoCheckbox` de
+ * `@prolibu-suite/cobalt-vue`.
+ *
+ * @part box - La casilla.
+ * @part label - La etiqueta.
+ */
 export declare class CoCheckbox {
     /** Whether the checkbox is checked */
     checked: boolean;

package/dist/types/components/co-checkbox-group/co-checkbox-group.d.ts

@@ -4,6 +4,11 @@ export interface CheckboxOption {
     value: string;
     disabled?: boolean;
 }
+/**
+ * Grupo de casillas con etiqueta, ayuda y estado de validación: `options`
+ * define las casillas y `value` las marcadas (array). Emite `coChange` con el
+ * array completo. Wrapper Vue: `CoCheckboxGroup` de `@prolibu-suite/cobalt-vue`.
+ */
 export declare class CoCheckboxGroup {
     /** Group label displayed above the options */
     label?: string;

package/dist/types/components/co-chip/co-chip.d.ts

@@ -1,8 +1,21 @@
 import { EventEmitter } from '../../stencil-public-runtime';
 /**
+ * Etiqueta compacta para estados, tags, filtros o selecciones: con color
+ * semántico, íconos, punto de color, sufijo de valor («Ordenar: Reciente»),
+ * botón de quitar y modo clickeable/seleccionable. Wrapper Vue: `CoChip` de
+ * `@prolibu-suite/cobalt-vue`.
+ *
  * @slot icon-left  - Icon before label (1nd Icon mode)
  * @slot icon-right - Icon after label (2nd Icon mode)
  * @slot            - Label text
+ *
+ * @part chip - Contenedor del chip.
+ * @part dot - Punto de color inicial (`dot`).
+ * @part icon-left - Ícono o slot de la izquierda.
+ * @part icon-right - Ícono o slot de la derecha.
+ * @part value - Sufijo de valor (`valueLabel`).
+ * @part trailing - Ícono final (`trailingIcon`).
+ * @part remove - Botón × (`removable`).
  */
 export declare class CoChip {
     /** Shape: pill or straight corners */

package/dist/types/components/co-color-area/co-color-area.d.ts

@@ -20,7 +20,8 @@ export interface ColorAreaDetail {
  * píxel; redondear a enteros dejaría hex inalcanzables). El teclado suma ±1
  * (±10 con Shift) sobre el valor vigente. Quien muestre números redondea.
  *
- * @part thumb - El indicador circular (16 px, anillo blanco + color actual).
+ * @part thumb - El indicador circular (16 px, anillo blanco + color actual). *
+ * Wrapper Vue: `CoColorArea` de `@prolibu-suite/cobalt-vue`.
  */
 export declare class CoColorArea {
     el: HTMLElement;

package/dist/types/components/co-color-picker/co-color-picker.d.ts

@@ -15,6 +15,8 @@ import { type ColorPreset } from './presets';
  * @event coChange - Emits the committed hex string (e.g. "#0066FF"): pointer
  * release, arrow key, swatch click, paste, and the end of a hex-field edit
  * (blur, Enter or panel close).
+ *
+ * Wrapper Vue: `CoColorPicker` de `@prolibu-suite/cobalt-vue`.
  */
 export declare class CoColorPicker {
     el: HTMLElement;

package/dist/types/components/co-color-slider/co-color-slider.d.ts

@@ -15,7 +15,8 @@ export type ColorSliderChannel = 'hue' | 'alpha';
  * que el color bajo el thumb es exactamente el valor emitido.
  *
  * @part track - La pista (gradiente de tono o damero + transparente→color).
- * @part thumb - El indicador circular (16 px, anillo blanco + color actual).
+ * @part thumb - El indicador circular (16 px, anillo blanco + color actual). *
+ * Wrapper Vue: `CoColorSlider` de `@prolibu-suite/cobalt-vue`.
  */
 export declare class CoColorSlider {
     el: HTMLElement;

package/dist/types/components/co-column-picker/co-column-picker.d.ts

@@ -1,33 +1,65 @@
 import { EventEmitter } from '../../stencil-public-runtime';
 import { type ColumnOption, type ColumnSection } from './utils/column-picker-tree';
+/**
+ * Selector de columnas o campos con rutas anidadas (`company.name`): arma un
+ * árbol plegable a partir de las rutas, con búsqueda, «seleccionar todo» y
+ * chips de lo elegido. Pensado para elegir las columnas de una tabla o los
+ * campos de un export. Wrapper Vue: `CoColumnPicker` de `@prolibu-suite/cobalt-vue`.
+ */
 export declare class CoColumnPicker {
+    /** Etiqueta del campo. */
     label?: string;
+    /** Texto secundario junto a la etiqueta. */
     secondaryLabel?: string;
+    /** Rutas elegibles: array de strings (`"company.name"`), de `{ value, label, icon?, disabled? }`,
+     *  o ese array como JSON desde HTML. Los puntos arman el árbol; sin `label`, el
+     *  texto sale de la ruta (camelCase y `_`/`-` separados en palabras). */
     options: ColumnOption[] | string[] | string;
+    /** Rutas seleccionadas: array o JSON array. El componente lo actualiza al elegir. */
     value: string | string[];
+    /** Selección múltiple (default `true`); con `false` elegir una ruta cierra el panel. */
     multiple: boolean;
+    /** Deshabilita el campo. */
     disabled: boolean;
+    /** Barra del panel con «seleccionar todo», «limpiar», expandir/contraer y el contador. */
     showToolbar: boolean;
+    /** Buscador del panel; al buscar se expanden las ramas con coincidencias. */
     showSearch: boolean;
+    /** Botón × en el campo para vaciar la selección. */
     clearable: boolean;
+    /** Texto del campo sin selección. */
     placeholder: string;
+    /** Alto máximo en px del árbol antes de scrollear (default 220). */
     maxHeight: number;
+    /** Texto cuando la búsqueda no encuentra rutas. */
     emptyText: string;
+    /** Texto del botón «seleccionar todo» de la barra. */
     selectAllText: string;
+    /** Texto del botón «limpiar» de la barra. */
     clearText: string;
+    /** Texto del botón «expandir todo» de la barra. */
     expandText: string;
+    /** Texto del botón «contraer todo» de la barra. */
     collapseText: string;
+    /** Palabra tras el contador de la barra («3 selected»). */
     selectedText: string;
+    /** Agrupa el árbol en secciones: `[{ label, prefix }]` (o JSON). Cada sección toma las
+     *  rutas que empiezan por `prefix.`; una sección con `prefix: ''` junta el resto. */
     sections: ColumnSection[] | string;
+    /** Estado de validación: pinta el borde y el `helperText` con el color del estado. */
     status: 'default' | 'error' | 'success' | 'warning' | 'info';
+    /** Texto de ayuda o de error bajo el campo. */
     helperText?: string;
     isOpen: boolean;
     query: string;
     expandedKeys: Set<string>;
     focused: boolean;
     el: HTMLElement;
+    /** Cambió la selección (`value` ya está actualizado); `detail` = array de rutas elegidas. */
     coChange: EventEmitter<string[]>;
+    /** Se vació la selección (× del campo o «limpiar» de la barra); le sigue un `coChange` con `[]`. */
     coClear: EventEmitter<void>;
+    /** Cambió el texto del buscador (sin debounce); `''` al vaciarlo. El filtrado es interno. */
     coSearch: EventEmitter<string>;
     private searchInputEl?;
     private get parsedOptions();

package/dist/types/components/co-combobox/co-combobox.d.ts

@@ -4,6 +4,20 @@ export interface ComboboxOption {
     value: string;
     icon?: string;
 }
+/**
+ * Selector de varias opciones (por defecto `multiple`) con chips en el trigger,
+ * buscador local opcional (`searchable`) y footer de acciones. Para opciones
+ * paginadas del servidor usá `co-ref-field`. Wrapper Vue: `CoCombobox` de
+ * `@prolibu-suite/cobalt-vue`.
+ *
+ * @part wrapper - Contenedor raíz del campo.
+ * @part label - Etiqueta.
+ * @part secondary-label - Texto secundario junto a la etiqueta.
+ * @part trigger - Caja clickeable con los chips seleccionados.
+ * @part clear - Botón × que vacía la selección.
+ * @part dropdown - Panel desplegable con las opciones.
+ * @part helper - Texto de ayuda o de error.
+ */
 export declare class CoCombobox {
     /** Label text displayed above the combobox */
     label?: string;

package/dist/types/components/co-command-search/co-command-search.d.ts

@@ -13,6 +13,17 @@ export interface CommandItem {
  * Opens as an overlay with a search input and filterable list of items.
  *
  * @slot trigger - Optional trigger element that opens the palette on click
+ *
+ * La búsqueda es del host: escucha `coSearch` y responde con los ítems.
+ * Wrapper Vue: `CoCommandSearch` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part panel - Panel de la paleta.
+ * @part input-row - Fila del buscador (ícono, chips de alcance e input).
+ * @part input - El `<input>` de búsqueda.
+ * @part loading - Loader mientras el host busca.
+ * @part tabs - Fila de pestañas de módulo.
+ * @part results - Área de resultados.
+ * @part favorites - Bloque de favoritos (con la búsqueda vacía).
  */
 export declare class CoCommandSearch {
     el: HTMLElement;
@@ -43,8 +54,12 @@ export declare class CoCommandSearch {
      *  Shown as a grid at the top of the results, only while the query is empty. */
     favorites: string;
     private query;
+    /** Se eligió un ítem (o un favorito) y la paleta se cierra; `detail` = `value` del ítem.
+     *  Los ítems con `keepOpen` emiten `coScopeChange` en su lugar. */
     coSelect: EventEmitter<string>;
+    /** Se cerró la paleta (Escape, click en el fondo o tras elegir). */
     coClose: EventEmitter<void>;
+    /** Cambió el texto del buscador (sin debounce); `detail` = texto. */
     coSearch: EventEmitter<string>;
     /** Emitted when an item with keepOpen=true is selected. Detail = item.value (scope model key). */
     coScopeChange: EventEmitter<string>;

package/dist/types/components/co-data-table/co-data-table.d.ts

@@ -10,7 +10,12 @@ export interface CoDataTableColumn {
     align?: 'left' | 'center' | 'right';
 }
 /**
+ * Tabla de datos con columnas configurables, orden, selección de filas,
+ * estado de carga y estado vacío. Wrapper Vue: `CoDataTable` de
+ * `@prolibu-suite/cobalt-vue`.
+ *
  * @slot - Default slot for custom row content (advanced usage)
+ * @part empty - El estado vacío (`emptyTitle`, `emptyMessage`, `emptyIcon`).
  */
 export declare class CoDataTable {
     el: HTMLElement;

package/dist/types/components/co-data-table-pagination/co-data-table-pagination.d.ts

@@ -1,4 +1,16 @@
 import { EventEmitter } from '../../stencil-public-runtime';
+/**
+ * Paginación de tabla: selector de filas por página, total de registros, salto
+ * a página y botones anterior/siguiente. Emite `coPageChange` con
+ * `{ page, pageSize }`. Wrapper Vue: `CoDataTablePagination` de
+ * `@prolibu-suite/cobalt-vue`.
+ *
+ * @part pagination - Contenedor de la barra.
+ * @part dropdown - Selector de filas por página.
+ * @part jump-input - Input de salto a página.
+ * @part prev-btn - Botón «anterior».
+ * @part next-btn - Botón «siguiente».
+ */
 export declare class CoDataTablePagination {
     /** Current page (1-based) */
     page: number;

package/dist/types/components/co-date-field/co-date-field.d.ts

@@ -21,6 +21,8 @@ import { EventEmitter } from '../../stencil-public-runtime';
  * @part input - The native input element
  * @part clear - The clear button
  * @part helper - The helper/error text row
+ *
+ * Wrapper Vue: `CoDateField` de `@prolibu-suite/cobalt-vue`.
  */
 export declare class CoDateField {
     el: HTMLElement;
@@ -40,12 +42,19 @@ export declare class CoDateField {
     locale: string;
     /** Display pattern (tokens yyyy/yy/MMMM/MMM/MM/M/dd/d). */
     displayFormat: string;
+    /** Etiqueta del campo. */
     label?: string;
+    /** Placeholder del input vacío; vacío = el texto por defecto del `locale`. */
     placeholder?: string;
+    /** Atributo `name` del input nativo. */
     name?: string;
+    /** Deshabilita el campo. */
     disabled: boolean;
+    /** Solo lectura: muestra la fecha pero no permite editarla. */
     readonly: boolean;
+    /** Campo obligatorio: marca la etiqueta con el indicador de requerido. */
     required: boolean;
+    /** Botón × para vaciar la fecha (default `true`). */
     clearable: boolean;
     /** External invalid flag (e.g. from a form controller). OR'd with internal parse failure. */
     invalid: boolean;
@@ -67,7 +76,9 @@ export declare class CoDateField {
     }>;
     /** Emitted when cleared. */
     coClear: EventEmitter<void>;
+    /** El input ganó el foco. */
     coFocus: EventEmitter<void>;
+    /** El input perdió el foco (tras intentar confirmar lo tipeado). */
     coBlur: EventEmitter<void>;
     /** Raw text in the box (display-formatted on commit). */
     draft: string;

package/dist/types/components/co-date-picker/co-date-picker.d.ts

@@ -17,19 +17,33 @@ import type { Placement } from '../../utils/positioning';
  *
  * Escape is owned here (co-popover `closeOnEscape=false`) so focus can return to
  * the field; outside-click stays with co-popover.
+ *
+ * Wrapper Vue: `CoDatePicker` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part label - Etiqueta del campo.
+ * @part helper - Texto de ayuda, o el `errorMessage` cuando el campo es inválido.
  */
 export declare class CoDatePicker {
     el: HTMLElement;
     /** Committed value, "YYYY-MM-DD" or null. */
     value: string | null;
+    /** Fecha mínima elegible, `YYYY-MM-DD`. */
     min?: string;
+    /** Fecha máxima elegible, `YYYY-MM-DD`. */
     max?: string;
+    /** Fechas bloqueadas `YYYY-MM-DD`: array, o JSON / lista separada por comas desde HTML. */
     disabledDates?: string[] | string;
+    /** Días de la semana bloqueados (0 = domingo … 6 = sábado): array, o JSON / lista separada por comas. */
     disabledDaysOfWeek?: number[] | string;
+    /** Locale BCP-47: nombres de meses y días, parseo de lo tipeado y textos de la UI (es/en/pt). */
     locale: string;
+    /** Formato de la fecha visible. Tokens: `yyyy yy MMMM MMM MM M dd d` (el valor sigue siendo `YYYY-MM-DD`). */
     displayFormat: string;
+    /** Primer día de la semana del calendario: 0 = domingo … 6 = sábado (default 1, lunes). */
     firstDayOfWeek: number;
+    /** Etiqueta del campo. */
     label?: string;
+    /** Placeholder del campo vacío; vacío = el del `locale`. */
     placeholder?: string;
     /** Field size, forwarded to the inner co-date-field. */
     size: 's' | 'sm' | 'md' | 'lg';
@@ -40,13 +54,21 @@ export declare class CoDatePicker {
      *  this prop existed. co-date-field itself has no `variant` prop, so this
      *  is applied from the outside via `::part(field)` — see co-date-picker.css. */
     variant: 'default' | 'flat';
+    /** Atributo `name` del input interno. */
     name?: string;
+    /** Deshabilita el campo y el calendario. */
     disabled: boolean;
+    /** Solo lectura: muestra la fecha pero no permite cambiarla. */
     readonly: boolean;
+    /** Campo obligatorio: marca la etiqueta con el indicador de requerido. */
     required: boolean;
+    /** Botón × para vaciar la fecha (default `true`); emite `coClear`. */
     clearable: boolean;
+    /** Marca el campo como inválido (validación externa): borde de error y `errorMessage` en lugar de `helperText`. */
     invalid: boolean;
+    /** Mensaje bajo el campo cuando es inválido (`invalid` o un tipeo que no se pudo interpretar). */
     errorMessage?: string;
+    /** Texto de ayuda bajo el campo. */
     helperText?: string;
     /** Label layout: vertical (label above) or horizontal (label beside) */
     layout: 'vertical' | 'horizontal';
@@ -60,15 +82,23 @@ export declare class CoDatePicker {
     mobileBreakpoint: number;
     /** True when the viewport is at/under `mobileBreakpoint`. */
     isMobile: boolean;
+    /** Texto crudo mientras se tipea (sin confirmar); `detail` = string. */
     coInput: EventEmitter<string>;
+    /** Se confirmó una fecha válida (tipeada o elegida en el calendario) o se vació: `detail` = `YYYY-MM-DD` o `null`. `value` ya está actualizado. */
     coChange: EventEmitter<string | null>;
+    /** Lo tipeado no es una fecha válida (p. ej. `31/02/2026`): no se confirma nada; `detail` = `{ raw }`. */
     coInvalid: EventEmitter<{
         raw: string;
     }>;
+    /** Se vació la fecha con la ×. Sin `detail`. */
     coClear: EventEmitter<void>;
+    /** El input ganó el foco. */
     coFocus: EventEmitter<void>;
+    /** El input perdió el foco. */
     coBlur: EventEmitter<void>;
+    /** Se abrió el calendario (popover u hoja en mobile). No burbujea. */
     coOpen: EventEmitter<void>;
+    /** Se cerró el calendario. No burbujea. */
     coClose: EventEmitter<void>;
     private internalInvalid;
     private fieldEl?;

package/dist/types/components/co-date-range/co-date-range.d.ts

@@ -1,6 +1,9 @@
 import { EventEmitter } from '../../stencil-public-runtime';
 import type { DateRangeValue } from '../co-date-range-picker/co-date-range-picker';
 /**
+ * Alias de compatibilidad de `co-date-range-picker`: no lo uses en código nuevo.
+ * Wrapper Vue: `CoDateRange` de `@prolibu-suite/cobalt-vue`.
+ *
  * @deprecated Use `<co-date-range-picker>` instead.
  *
  * Thin compatibility shim kept for one release: it renders the canonical
@@ -12,18 +15,27 @@ export declare class CoDateRange {
     el: HTMLElement;
     /** JSON `{from,to}` or empty string. */
     value: string;
+    /** Etiqueta del campo. */
     label: string;
+    /** Texto del trigger sin rango. */
     placeholder: string;
+    /** Deshabilita el campo. */
     disabled: boolean;
+    /** Acción «Limpiar» en el footer; emite `coClear`. */
     clearable: boolean;
+    /** Columna de rangos rápidos (hoy, esta semana…), traducidos según `locale`. */
     presets: boolean;
+    /** Texto de ayuda bajo el campo. */
     helperText: string;
     /** BCP-47 locale. */
     locale: string;
+    /** Texto del botón «Aplicar»; vacío = el del `locale`. */
     applyLabel?: string;
+    /** Texto de la acción «Limpiar»; vacío = el del `locale`. */
     clearLabel?: string;
     /** Fires (with `{from,to}`) when the user applies a range. */
     coChange: EventEmitter<DateRangeValue>;
+    /** Se vació el rango con «Limpiar». Sin `detail`. */
     coClear: EventEmitter<void>;
     private warned;
     connectedCallback(): void;

package/dist/types/components/co-date-range-picker/co-date-range-picker.d.ts

@@ -12,15 +12,25 @@ export interface DateRangeValue {
  * unset) so it survives JSX attribute serialization. The trigger shows the
  * COMMITTED range; the popover edits a draft that only commits on Apply (or, if
  * `applyOnSelect`, debounced once both ends are chosen — for table filters).
+ * Wrapper Vue: `CoDateRangePicker` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part label - Etiqueta del campo.
+ * @part trigger - Botón que muestra el rango confirmado y abre el popover.
+ * @part helper - Texto de ayuda, o el `errorMessage` cuando el campo es inválido.
  */
 export declare class CoDateRangePicker {
     el: HTMLElement;
     /** JSON `{from,to}` or '' (empty). */
     value: string;
+    /** Fecha mínima elegible, `YYYY-MM-DD`. */
     min?: string;
+    /** Fecha máxima elegible, `YYYY-MM-DD`. */
     max?: string;
+    /** Locale BCP-47: nombres de meses y días, parseo de lo tipeado y textos de la UI (es/en/pt). */
     locale: string;
+    /** Formato de las fechas en el trigger y los campos. Tokens: `yyyy yy MMMM MMM MM M dd d`. */
     displayFormat: string;
+    /** Primer día de la semana del calendario: 0 = domingo … 6 = sábado (default 1, lunes). */
     firstDayOfWeek: number;
     /** Show the quick-preset column. */
     presets: boolean;
@@ -38,17 +48,25 @@ export declare class CoDateRangePicker {
     minRangeDays?: number;
     /** Maximum span (inclusive days). */
     maxRangeDays?: number;
+    /** Muestra la acción «Limpiar» en el footer (default `true`); emite `coClear`. */
     clearable: boolean;
     /** Commit (emit coApply) as soon as a full valid range is picked, debounced. */
     applyOnSelect: boolean;
+    /** Deshabilita el campo: no abre el popover. */
     disabled: boolean;
+    /** Solo lectura: muestra el rango pero no permite cambiarlo. */
     readonly: boolean;
+    /** Marca el campo como inválido (validación externa): borde de error y `errorMessage` en lugar de `helperText`. */
     invalid: boolean;
+    /** Mensaje bajo el campo cuando `invalid` es `true`. */
     errorMessage?: string;
+    /** Texto de ayuda bajo el campo. */
     helperText?: string;
+    /** Etiqueta del campo. */
     label?: string;
     /** Whether the field is required (renders a required marker on the label). */
     required: boolean;
+    /** Texto del trigger sin rango; vacío = el del `locale`. */
     placeholder?: string;
     /** Label layout: vertical (label above) or horizontal (label beside) */
     layout: 'vertical' | 'horizontal';
@@ -59,22 +77,37 @@ export declare class CoDateRangePicker {
      *  focus ring, disabled and invalid states are unaffected. `default` (the
      *  standard bordered box) renders identically to before this prop existed. */
     variant: 'default' | 'flat';
+    /** Lado y alineación del popover respecto del trigger (default `bottom-start`). */
     placement: Placement;
+    /** Popover abierto (reflejado; el componente lo actualiza al abrir y cerrar). */
     open: boolean;
+    /** Texto del botón «Aplicar»; vacío = el del `locale`. */
     applyLabel?: string;
+    /** Texto del botón «Cancelar»; vacío = el del `locale`. */
     cancelLabel?: string;
+    /** Texto de la acción «Limpiar»; vacío = el del `locale`. */
     clearLabel?: string;
+    /** Etiqueta del campo de inicio («Desde»); vacío = la del `locale`. */
     fromLabel?: string;
+    /** Etiqueta del campo de fin («Hasta»); vacío = la del `locale`. */
     toLabel?: string;
     /** Max viewport width (px) that renders the picker as a bottom sheet. */
     mobileBreakpoint: number;
+    /** Cambió el inicio del borrador (sin confirmar); `detail` = `YYYY-MM-DD` o `null`. */
     coRangeStartChange: EventEmitter<string | null>;
+    /** Cambió el fin del borrador (sin confirmar); `detail` = `YYYY-MM-DD` o `null`. */
     coRangeEndChange: EventEmitter<string | null>;
+    /** Cambió el borrador del rango (sin confirmar); `detail` = `{ from, to }`. También sale al limpiar, con ambos en `null`. */
     coRangeChange: EventEmitter<DateRangeValue>;
+    /** Se confirmó el rango («Aplicar» o `applyOnSelect`): `value` ya está actualizado; `detail` = `{ from, to }`. */
     coApply: EventEmitter<DateRangeValue>;
+    /** «Cancelar»: descarta el borrador y cierra. Sin `detail`. */
     coCancel: EventEmitter<void>;
+    /** «Limpiar»: vacía `value` y cierra. Sin `detail`. */
     coClear: EventEmitter<void>;
+    /** Se abrió el popover (o la hoja en mobile). No burbujea. */
     coOpen: EventEmitter<void>;
+    /** Se cerró el popover (o la hoja en mobile). No burbujea. */
     coClose: EventEmitter<void>;
     /** Working range while the popover is open (commits on Apply). */
     draftFrom: string | null;

package/dist/types/components/co-date-time-picker/co-date-time-picker.d.ts

@@ -39,6 +39,8 @@ import type { Placement } from '../../utils/positioning';
  * to the field; outside-click/sheet-dismiss stay with co-popover/co-drawer and
  * are handled by `closeApplyingDraft` (see its doc for the Escape asymmetry).
  *
+ * Wrapper Vue: `CoDateTimePicker` de `@prolibu-suite/cobalt-vue`.
+ *
  * @part field - The bordered trigger row
  * @part label - The field label
  * @part display - The button that shows the formatted value
@@ -61,25 +63,39 @@ export declare class CoDateTimePicker {
     min?: string;
     /** Latest selectable day. Date-only "YYYY-MM-DD" or an instant. */
     max?: string;
+    /** Días bloqueados `YYYY-MM-DD`: array, o JSON / lista separada por comas desde HTML. */
     disabledDates?: string[] | string;
+    /** Días de la semana bloqueados (0 = domingo … 6 = sábado): array, o JSON / lista separada por comas. */
     disabledDaysOfWeek?: number[] | string;
+    /** Locale BCP-47: nombres de meses y días, formato de la hora y textos de la UI (es/en/pt). */
     locale: string;
     /** Date part of the trigger text (tokens yyyy/yy/MMMM/MMM/MM/M/dd/d). */
     displayFormat: string;
+    /** Primer día de la semana del calendario: 0 = domingo … 6 = sábado (default 1, lunes). */
     firstDayOfWeek: number;
+    /** Etiqueta del campo. */
     label?: string;
+    /** Texto del campo sin valor; vacío = el del `locale`. */
     placeholder?: string;
     /** Field size, mirrors co-input/co-date-field: s 28 / sm 32 / md 40 / lg 48. */
     size: 's' | 'sm' | 'md' | 'lg';
     /** `flat` strips the trigger's border/background so it reads as content. */
     variant: 'default' | 'flat';
+    /** Atributo `name` del campo. */
     name?: string;
+    /** Deshabilita el campo. */
     disabled: boolean;
+    /** Solo lectura: muestra el valor pero no abre el panel ni permite limpiar. */
     readonly: boolean;
+    /** Campo obligatorio: marca la etiqueta con el indicador de requerido. */
     required: boolean;
+    /** Botón × para vaciar el valor (default `true`); emite `coClear` y `coChange(null)`. */
     clearable: boolean;
+    /** Marca el campo como inválido (validación externa): borde de error y `errorMessage` en lugar de `helperText`. */
     invalid: boolean;
+    /** Mensaje bajo el campo cuando `invalid` es `true`. */
     errorMessage?: string;
+    /** Texto de ayuda bajo el campo. */
     helperText?: string;
     /** Label layout: vertical (label above) or horizontal (label beside). */
     layout: 'vertical' | 'horizontal';
@@ -95,10 +111,15 @@ export declare class CoDateTimePicker {
     draftMinutes: number;
     /** Committed instant (UTC ISO) or null. */
     coChange: EventEmitter<string | null>;
+    /** Se vació el valor con la ×; le sigue un `coChange(null)`. Sin `detail`. */
     coClear: EventEmitter<void>;
+    /** El campo ganó el foco. */
     coFocus: EventEmitter<void>;
+    /** El campo perdió el foco. */
     coBlur: EventEmitter<void>;
+    /** Se abrió el panel (popover u hoja en mobile). No burbujea. */
     coOpen: EventEmitter<void>;
+    /** Se cerró el panel. No burbujea. */
     coClose: EventEmitter<void>;
     private popoverEl?;
     private calendarEl?;