@prolibu-suite/cobalt-core 0.10.4 → 0.11.1

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

@@ -1,13 +1,21 @@
 /**
+ * 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 */
-    variant: 'primary' | 'secondary' | 'stroke' | 'ghost' | 'danger' | 'success';
+    /** 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 */
-    size: 'l' | 'm' | 's' | 'xs';
+    /** 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. 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/calendarMarks.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Fechas MARCADAS de co-calendar (feriados, hitos): se ven distintas pero siguen siendo
+ * seleccionables, a diferencia de `disabledDates`. Lógica pura para testear sin montar.
+ */
+/** Array, JSON (`'["2026-12-25"]'`) o CSV (`'2026-12-25, 2027-01-01'`) → string[]. */
+export declare function normalizeStringArray(v: string[] | string | undefined): string[];
+/** Set de `YYYY-MM-DD` válidos para consultar por día en O(1). */
+export declare function normalizeMarkedDates(v: string[] | string | undefined): Set<string>;
+/** El texto de marca lo da el anfitrión (i18n suya): «25 de diciembre de 2026, Feriado». */
+export declare function dayAriaLabel(base: string, marked: boolean, markedLabel?: string): string;
+/** `YYYY-MM` → { year, month } (mes 1–12) para anclar la vista; null si no es válido. */
+export declare function parseViewMonth(v: string | undefined | null): {
+    year: number;
+    month: number;
+} | null;

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
  */
@@ -30,6 +32,19 @@ export declare class CoCalendar {
     max?: string;
     /** Blocked dates. Accepts a string[] or a JSON/comma string for raw-HTML use. */
     disabledDates?: string[] | string;
+    /**
+     * Fechas `YYYY-MM-DD` que se MARCAN (feriados, hitos) sin deshabilitarlas: se pueden
+     * seleccionar igual. Array, JSON o CSV, como `disabledDates`. Color por la custom
+     * property `--co-calendar-marked-bg` (default: token de Cobalt).
+     */
+    markedDates?: string[] | string;
+    /** Texto accesible que se suma al día marcado («Feriado»). Lo traduce el anfitrión. */
+    markedLabel?: string;
+    /**
+     * Mes que muestra la vista (`YYYY-MM`), por encima del ancla de la selección. Para
+     * poner dos calendarios lado a lado (inicio y fin de un rango en meses distintos).
+     */
+    month?: string;
     /** Blocked weekdays (0=Sun..6=Sat). Accepts number[] or a JSON/comma string. */
     disabledDaysOfWeek?: number[] | string;
     /** BCP-47 locale used for month/weekday labels. */
@@ -60,6 +75,8 @@ export declare class CoCalendar {
     /** When set, focus the matching day cell after the next render. */
     private shouldFocusGrid;
     componentWillLoad(): void;
+    onMonthChange(): void;
+    private applyMonthProp;
     onValueChange(): void;
     /** Move keyboard focus into the grid (used by the picker when the popover opens). */
     focusGrid(): Promise<void>;
@@ -99,6 +116,7 @@ export declare class CoCalendar {
     private focusFocusedCell;
     /** Range endpoint/in-range flags for a cell, accounting for hover preview. */
     private rangeFlags;
+    private get markedSet();
     private dayClass;
     private headerTitle;
     private renderDays;

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;
@@ -6,6 +14,13 @@ export declare class CoCheckbox {
     indeterminate: boolean;
     /** Size: small=16px, medium=20px, large=24px (overlay appearance: small=20px, medium/large=22px) */
     size: 'small' | 'medium' | 'large';
+    /**
+     * Talla del label: 'default' (14px, sin cambios) o 'xs' (12px/400/text-default,
+     * gap 6). Con 'xs' la caja SIN MARCAR pasa a fondo transparente + borde
+     * `--co-semantic-border-default` pleno (hoy surface-secondary 35% + borde 75%);
+     * el estado marcado no cambia. Aditivo — el default sigue siendo idéntico.
+     */
+    labelSize: 'default' | 'xs';
     /** Disabled state */
     disabled: boolean;
     /** Label text displayed beside the checkbox */

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

@@ -0,0 +1,65 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+/** Payload de `coInput` / `coChange`: saturación y valor en 0–100. */
+export interface ColorAreaDetail {
+    saturation: number;
+    value: number;
+}
+/**
+ * Área saturación/valor (el "cuadrado" del picker de color). El tono viene de
+ * afuera (`hue`, normalmente de un `co-color-slider channel="hue"`); el usuario
+ * elige saturación (eje X) y valor (eje Y) arrastrando o con el teclado.
+ *
+ * Contrato de eventos (pensado para el historial de deshacer del editor):
+ *  - `coInput`  → en cada movimiento del arrastre (vista previa) y en cada paso
+ *                 de teclado.
+ *  - `coChange` → UNA vez al terminar el gesto (pointerup/pointercancel), solo
+ *                 si el gesto cambió el valor, o tras cada paso de teclado que
+ *                 lo cambie. Es el punto de commit: nunca un commit vacío.
+ *
+ * Los valores de puntero NO se redondean (una caja de 236 px da ~0,4 % por
+ * 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). *
+ * Wrapper Vue: `CoColorArea` de `@prolibu-suite/cobalt-vue`.
+ */
+export declare class CoColorArea {
+    el: HTMLElement;
+    /** Tono 0–360. Pinta el fondo; el área no lo modifica. */
+    hue: number;
+    /** Saturación 0–100 (eje X). Mutable: el área se actualiza sola al arrastrar. */
+    saturation: number;
+    /** Valor/brillo 0–100 (eje Y, 100 arriba). Mutable: el área se actualiza sola al arrastrar. */
+    value: number;
+    /** Deshabilita puntero y teclado; no emite nada. */
+    disabled: boolean;
+    /** Nombre accesible del slider (`aria-label`). */
+    label?: string;
+    /** Vista previa: cada movimiento del arrastre y cada paso de teclado. */
+    coInput: EventEmitter<ColorAreaDetail>;
+    /** Commit: una vez al soltar (o cancelar) el gesto si cambió el valor, y tras cada paso de teclado que lo cambie. */
+    coChange: EventEmitter<ColorAreaDetail>;
+    private dragging;
+    private areaEl?;
+    /** pointerId del gesto en curso: los eventos de OTRO puntero (segundo dedo) se ignoran. */
+    private activePointerId?;
+    /** ¿Algún coInput real durante el gesto? Sin cambio no hay coChange de cierre. */
+    private changedInGesture;
+    private get detail();
+    private handlePointerDown;
+    private handlePointerMove;
+    private handlePointerEnd;
+    /** `==`: en jsdom los MouseEvent traen `pointerId` undefined y deben seguir pasando. */
+    private isActivePointer;
+    /** `setPointerCapture` sigue el gesto fuera de la caja. jsdom no lo implementa
+     *  y un browser lanza NotFoundError con un pointerId sintético: guardado. */
+    private capturePointer;
+    private releasePointer;
+    /** clientX/Y → saturación (X, 0 izquierda) y valor (Y, 100 arriba), acotados a la caja. */
+    private applyPointer;
+    /** Aplica s/v y emite `coInput` solo si algo cambió (los moves repetidos no
+     *  disparan re-render ni trabajo en el host). */
+    private commitInput;
+    private handleKeyDown;
+    render(): any;
+}

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

@@ -0,0 +1,62 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+export type ColorSliderChannel = 'hue' | 'alpha';
+/**
+ * Slider de un canal del picker de color: tono (`hue`, 0–360) u opacidad
+ * (`alpha`, 0–100, sobre el color base `color`).
+ *
+ * Contrato de eventos (mismo que `co-color-area`, pensado para el historial del
+ * editor): `coInput` en cada movimiento del arrastre y en cada paso de teclado;
+ * `coChange` UNA vez al terminar el gesto (pointerup/pointercancel), solo si el
+ * gesto cambió el valor, o tras cada paso de teclado que lo cambie — nunca un
+ * commit vacío. Ambos llevan el valor numérico.
+ *
+ * El thumb (16 px) va INSET: su centro recorre [8 px, ancho − 8 px], así nunca
+ * se sale del track de 16 px de alto. El puntero usa el mismo mapeo, de modo
+ * 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). *
+ * Wrapper Vue: `CoColorSlider` de `@prolibu-suite/cobalt-vue`.
+ */
+export declare class CoColorSlider {
+    el: HTMLElement;
+    /** Canal: `hue` (0–360, gradiente HSL uniforme) o `alpha` (0–100, damero). */
+    channel: ColorSliderChannel;
+    /** Valor actual (tono 0–360 / alpha 0–100). Mutable: el slider se actualiza solo al arrastrar. */
+    value: number;
+    /** Color base para `channel="alpha"` (cualquier color CSS; el track va de transparente a él). */
+    color?: string;
+    /** Deshabilita puntero y teclado; no emite nada. */
+    disabled: boolean;
+    /** Nombre accesible del slider (`aria-label`). */
+    label?: string;
+    /** Vista previa: cada movimiento del arrastre y cada paso de teclado. */
+    coInput: EventEmitter<number>;
+    /** Commit: una vez al soltar (o cancelar) el gesto si cambió el valor, y tras cada paso de teclado que lo cambie. */
+    coChange: EventEmitter<number>;
+    private dragging;
+    private trackEl?;
+    private thumbEl?;
+    /** pointerId del gesto en curso: los eventos de OTRO puntero (segundo dedo) se ignoran. */
+    private activePointerId?;
+    /** ¿Algún coInput real durante el gesto? Sin cambio no hay coChange de cierre. */
+    private changedInGesture;
+    private get max();
+    private handlePointerDown;
+    private handlePointerMove;
+    private handlePointerEnd;
+    /** `==`: en jsdom los MouseEvent traen `pointerId` undefined y deben seguir pasando. */
+    private isActivePointer;
+    /** `setPointerCapture` sigue el gesto fuera del track. jsdom no lo implementa
+     *  y un browser lanza NotFoundError con un pointerId sintético: guardado. */
+    private capturePointer;
+    private releasePointer;
+    /** clientX → valor, con el recorrido del thumb inset (centro en [size/2, ancho − size/2]). */
+    private applyPointer;
+    /** Aplica el valor y emite `coInput` solo si cambió. */
+    private commitInput;
+    private handleKeyDown;
+    /** Relleno del thumb: el tono puro, o el color base con la opacidad actual sobre damero. */
+    private thumbFill;
+    render(): any;
+}

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;