@prolibu-suite/cobalt-core 0.11.0 → 0.11.1

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

@@ -5,25 +5,42 @@ export interface AutocompleteOption {
     icon?: string;
     disabled?: boolean;
 }
+/**
+ * Campo de texto con sugerencias: al tipear emite `coSearch` (con debounce y
+ * `minChars`) y el host responde con `options`; elegir una sugerencia fija el
+ * valor. Para una lista conocida sin búsqueda remota usá `co-select` o
+ * `co-combobox`. Wrapper Vue: `CoAutocomplete` de `@prolibu-suite/cobalt-vue`.
+ */
 export declare class CoAutocomplete {
+    /** Etiqueta del campo. */
     label?: string;
     /** Whether the field is required (renders a required marker on the label). */
     required: boolean;
+    /** Texto secundario junto a la etiqueta. */
     secondaryLabel?: string;
+    /** Placeholder del input. */
     placeholder: string;
+    /** Deshabilita el campo. */
     disabled: boolean;
+    /** Ícono Phosphor al inicio del input. */
     iconLeft?: string;
+    /** Botón × para vaciar texto y selección (default `true`); emite `coClear` y `coChange`. */
     clearable: boolean;
+    /** Texto de ayuda o de error bajo el campo. */
     helperText?: string;
     /** Label layout: vertical (label above) or horizontal (label beside) */
     layout: 'vertical' | 'horizontal';
     /** Field size (mirrors co-input): s 28 / sm 32 / md 40 / lg 48. */
     size: 's' | 'sm' | 'md' | 'lg';
+    /** Estado de validación: pinta el borde y el `helperText` con el color del estado. */
     status: 'default' | 'error' | 'success' | 'warning' | 'info';
     /** Pre-loaded or server-returned options */
     options: AutocompleteOption[] | string[] | string;
+    /** Selección: `value` de la opción elegida; en `multiple`, array o JSON array. El componente lo actualiza. */
     value: string | string[];
+    /** Selección múltiple: lo elegido se muestra como chips. */
     multiple: boolean;
+    /** El host está buscando: muestra un loader en la lista de sugerencias. */
     loading: boolean;
     /** Minimum characters before emitting coSearch */
     minChars: number;
@@ -38,6 +55,9 @@ export declare class CoAutocomplete {
     private optionListEl?;
     /** Fired when the user types (after debounce). Host should fetch and set options. */
     coSearch: EventEmitter<string>;
+    /** Cambió la selección (`value` ya está actualizado): `{ value, item }`. `value` = el elegido o
+     *  el array en `multiple`; `null` (con `item: null`) al deseleccionar desde la lista;
+     *  `''`/`[]` (con `item: null`) al vaciar con la ×. */
     coChange: EventEmitter<{
         value: string | string[] | null;
         item: {
@@ -45,6 +65,7 @@ export declare class CoAutocomplete {
             label: string;
         } | null;
     }>;
+    /** Se vació con la ×; le sigue un `coChange`. Sin `detail`. */
     coClear: EventEmitter<void>;
     private debounceTimer?;
     private inputEl?;

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

@@ -1,3 +1,10 @@
+/**
+ * Avatar de una persona o entidad: iniciales, ícono o imagen, en círculo,
+ * squircle o cuadrado de radio chico. Con `name` muestra el nombre completo en
+ * un `co-tooltip`. Wrapper Vue: `CoAvatar` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part avatar - Caja del avatar (fondo, máscara y anillo).
+ */
 export declare class CoAvatar {
     /** Display type: text shows initials, icon shows a Phosphor icon, image shows a picture */
     type: 'text' | 'icon' | 'image';
@@ -13,7 +20,7 @@ export declare class CoAvatar {
     icon: string;
     /** Icon weight */
     iconWeight: 'regular' | 'thin' | 'light' | 'bold' | 'fill' | 'duotone';
-    /** Shape of the avatar. `rounded` (Task C12) = radio chico
+    /** Shape of the avatar. `rounded` = radio chico
      *  (`--co-border-radius-xs`), sin máscara squircle — esquinas de radio fijo,
      *  no la superelipse de `square`. */
     shape: 'circle' | 'square' | 'rounded';

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

@@ -12,6 +12,11 @@ export interface CoAvatarGroupItem {
     /** Optional ring color forwarded to the child `co-avatar`. */
     ringColor?: string;
 }
+/**
+ * Pila de avatares superpuestos con un «+N» para los que no entran (`max`).
+ * `items` describe cada avatar (tipo, texto, imagen, color). Wrapper Vue:
+ * `CoAvatarGroup` de `@prolibu-suite/cobalt-vue`.
+ */
 export declare class CoAvatarGroup {
     /** Avatar descriptors rendered as an overlapping stack. */
     items: CoAvatarGroupItem[];

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

@@ -1,3 +1,10 @@
+/**
+ * Indicador pequeño de conteo o de estado (punto) con color semántico; con
+ * `animated` hace un pop de entrada. Wrapper Vue: `CoBadge` de
+ * `@prolibu-suite/cobalt-vue`.
+ *
+ * @part badge - El indicador.
+ */
 export declare class CoBadge {
     /**
      * Size: large=16px dot, small=6px dot

package/dist/types/components/co-bottom-sheet/co-bottom-sheet.d.ts

@@ -11,6 +11,15 @@ import { EventEmitter } from '../../stencil-public-runtime';
  * @slot header - Custom header content (overrides `heading`). Dragging it moves the sheet.
  * @slot        - Sheet body (scrollable).
  * @slot footer - Pinned action area below the body (outside the scroll), with safe-area padding.
+ *
+ * Wrapper Vue: `CoBottomSheet` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part backdrop - Fondo oscuro detrás de la hoja.
+ * @part sheet - La hoja.
+ * @part handle - Tirador superior.
+ * @part header - Encabezado (título o slot `header`).
+ * @part body - Cuerpo scrolleable.
+ * @part footer - Área de acciones fija al pie.
  */
 export declare class CoBottomSheet {
     el: HTMLElement;

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

@@ -6,6 +6,10 @@
  * leading icon (hidden on the first crumb via CSS), so no separator markup is
  * interleaved here. This component propagates its `separator` prop down to the
  * slotted items and layouts them in a `align-items:center; gap:4px` flex row.
+ *
+ * @part breadcrumb - El propio elemento (`role="navigation"`), fila de migas.
+ *
+ * Wrapper Vue: `CoBreadcrumb` de `@prolibu-suite/cobalt-vue`.
  */
 export declare class CoBreadcrumb {
     el: HTMLElement;

package/dist/types/components/co-breadcrumb-item/co-breadcrumb-item.d.ts

@@ -9,6 +9,12 @@ import { EventEmitter } from '../../stencil-public-runtime';
  *
  * Conventions mirror `co-menu-item`: the `current` crumb paints medium weight +
  * text-default ink; earlier crumbs are regular weight + muted (gray-500).
+ *
+ * Wrapper Vue: `CoBreadcrumbItem` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @slot - Contenido propio en lugar de `label`.
+ * @part breadcrumb-item - Contenedor de la miga (separador + contenido).
+ * @part content - Parte clickeable (ícono y texto).
  */
 export declare class CoBreadcrumbItem {
     /** Text shown in the crumb. */

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

@@ -1,14 +1,20 @@
 /**
+ * Botón de acción con texto e íconos opcionales. `variant` define el peso
+ * visual (`primary` para la acción principal), `size` la talla y `full-width`
+ * lo estira al ancho del contenedor. Wrapper Vue: `CoButton` de
+ * `@prolibu-suite/cobalt-vue`.
+ *
  * @slot - Button label text
+ * @part button - El `<button>` nativo interno.
  */
 export declare class CoButton {
-    /** Visual style. "soft" (Task C2, Fase 2 Cobalt): fondo gray-100 sólido, sin backdrop-filter — pensado para toolbars/paneles del editor. */
+    /** Visual style. "soft": fondo sólido `--co-semantic-surface-control` (gray-100 en claro), sin backdrop-filter — pensado para toolbars y paneles del editor. */
     variant: 'primary' | 'secondary' | 'stroke' | 'ghost' | 'danger' | 'success' | 'soft';
     /** Shape: pill or straight corners */
     shape: 'rounded' | 'square';
-    /** Size. "sm" (Task C2, Fase 2 Cobalt): 32px fijo — escala unificada de tallas nuevas del editor (xs=24/s=28/sm=32). */
+    /** Size: `l`, `m` (default), `s`, `xs`; `sm` = 32px fijo, de la escala compacta del editor (xs=24/s=28/sm=32). Un valor fuera de la lista no da error: el botón queda sin estilos de talla (sin padding ni tamaño de fuente). */
     size: 'l' | 'm' | 's' | 'xs' | 'sm';
-    /** Ocupa el 100% del ancho del contenedor (Task C2, Fase 2 Cobalt). Reflejado como atributo `full-width`. */
+    /** Ocupa el 100% del ancho del contenedor. Reflejado como atributo `full-width`. */
     fullWidth: boolean;
     /** Raised elevation — with variant="secondary" renders a white raised button (shadow-sm + inset hairline). */
     elevated: boolean;

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

@@ -1,3 +1,9 @@
+/**
+ * Grupo de `co-button` unidos en una fila o columna, con variante y talla
+ * compartidas. Wrapper Vue: `CoButtonGroup` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @slot - Los `co-button` del grupo.
+ */
 export declare class CoButtonGroup {
     /** Visual variant applied to the group container */
     variant: 'primary' | 'secondary' | 'stroke' | 'ghost';
@@ -5,6 +11,7 @@ export declare class CoButtonGroup {
     size: 'l' | 'm' | 's' | 'xs';
     /** Orientation */
     direction: 'row' | 'column';
+    /** Deshabilita el grupo entero (atenuado y sin clicks). */
     disabled: boolean;
     render(): any;
 }

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

@@ -11,6 +11,8 @@ import { EventEmitter } from '../../stencil-public-runtime';
  * chosen date. Today and selected are deliberately different visual states.
  *
  * @part root - The calendar container
+ * Wrapper Vue: `CoCalendar` de `@prolibu-suite/cobalt-vue`.
+ *
  * @part header - Month navigation header
  * @part grid - The day grid
  */

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;