@prolibu-suite/cobalt-core 0.11.0 → 0.11.1

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?;

package/dist/types/components/co-document-editor/co-document-editor.d.ts

@@ -44,7 +44,8 @@ export interface DocumentMargins {
  * @part toolbar - Barra de formato
  * @part canvas - Superficie donde se centran las hojas
  * @part sheet - El papel
- * @part header-band - Banda del encabezado de la primera hoja
+ * @part header-band - Banda del encabezado de la primera hoja *
+ * Wrapper Vue: `CoDocumentEditor` de `@prolibu-suite/cobalt-vue`.
  */
 export declare class CoDocumentEditor {
     el: HTMLElement;
@@ -66,6 +67,7 @@ export declare class CoDocumentEditor {
     features?: string | DocumentFeatures;
     /** `(file) => Promise<{src, fileId?}>` (propiedad JS). */
     imageUpload?: ImageUploadHandler;
+    /** Solo lectura: sin barra ni edición (el encabezado tampoco se puede editar). */
     readonly: boolean;
     /** BCP-47 para los textos de la UI ('es', 'en', 'pt-BR'…). */
     locale: string;
@@ -83,6 +85,7 @@ export declare class CoDocumentEditor {
     coPagesChange: EventEmitter<number>;
     /** Clic en un botón del host (`extraItems`): `{ action: <id>, payload: { extra: true } }`. */
     coAction: EventEmitter<DocumentActionDetail>;
+    /** El editor terminó de montar. No burbujea. */
     coReady: EventEmitter<void>;
     ready: boolean;
     pageCount: number;
@@ -161,6 +164,7 @@ export declare class CoDocumentEditor {
      * banda sin confirmar NO cuenta.
      */
     getHeaderHtml(): Promise<string>;
+    /** Cuerpo como JSON de ProseMirror, o `null` si todavía no montó. */
     getJSON(): Promise<object | null>;
     /**
      * Emite YA el `coChange` pendiente (no-op si no hay). El host lo llama antes de
@@ -182,9 +186,13 @@ export declare class CoDocumentEditor {
      * se aplican también al confirmado, así cancelar no los pierde.
      */
     setFieldValues(values: Record<string, string>): Promise<void>;
+    /** Inserta un campo `[[name]]` en el cursor; `opts`: `required`, `type`, `enum`, `value`. */
     insertField(name: string, opts?: Partial<Omit<MergeFieldAttributes, 'name'>>): Promise<void>;
+    /** Inserta el siguiente marcador de firma libre (`⟦sig:N⟧`) en el cursor. */
     insertSignatureSlot(): Promise<void>;
+    /** Enfoca el cuerpo del documento. */
     focusEditor(): Promise<void>;
+    /** Instancia Tiptap del cuerpo (escape hatch), o `null` antes de montar. */
     getEditorInstance(): Promise<Editor | null>;
     /** Listeners y atributos del editor del cuerpo. */
     private wireEditor;

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

@@ -1,5 +1,18 @@
 import { EventEmitter } from '../../stencil-public-runtime';
 /**
+ * Panel lateral (derecha, izquierda o abajo) sobre un scrim, con header, pestañas,
+ * cuerpo scrolleable y footer. Es controlado: la ✕, el scrim y Escape emiten
+ * `coClose` y quien lo usa pone `open` en `false`. Wrapper Vue: `CoDrawer` de
+ * `@prolibu-suite/cobalt-vue`.
+ *
+ * @part drawer - El panel completo (posición, sombra y animación).
+ * @part card - Superficie interna del panel.
+ * @part header - Header (título o slot `header`, y la ✕).
+ * @part tabs - Fila del slot `tabs`.
+ * @part body - Cuerpo scrolleable (slot por defecto).
+ * @part loader - Loader superpuesto al cuerpo (`loading`).
+ * @part footer - Footer de acciones (slot `footer`).
+ *
  * @slot header  - Custom header content (overrides `heading` prop). Receives close button next to it.
  * @slot tabs    - Optional row under the header (e.g. <co-tab-group>).
  * @slot         - Drawer body (scrollable).

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

@@ -15,6 +15,19 @@ import { EventEmitter } from '../../stencil-public-runtime';
  *                  <co-file-type-tile> when `ext` is set.
  * @slot trailing - (folder) Trailing content after the star (e.g. a dots menu).
  * @slot actions  - (file) The fading action affordance in the foot row.
+ *
+ * Wrapper Vue: `CoDriveCard` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part card - Tarjeta completa.
+ * @part select - Chip de selección de la esquina.
+ * @part tile - (carpeta) Ícono de la carpeta.
+ * @part name - Nombre del ítem.
+ * @part meta - Texto secundario (fecha, tamaño…).
+ * @part trailing - (carpeta) Contenido final después de la estrella.
+ * @part thumb - (archivo) Zona de miniatura.
+ * @part star - Botón de favorito.
+ * @part foot - (archivo) Fila inferior con tipo, nombre y acciones.
+ * @part actions - (archivo) Acciones que aparecen en hover.
  */
 export declare class CoDriveCard {
     /** Which layout to render. */

package/dist/types/components/co-drop-zone/co-drop-zone.d.ts

@@ -8,7 +8,12 @@ import { EventEmitter } from '../../stencil-public-runtime';
  *  2. Self-managed — the host listens for native dragenter/over/leave/drop and
  *     flips `active` itself, emitting `coDragStateChange` and `coDrop`.
  *
- * Report ref: 3.17 (446–449); drag overlay spec: report lines 135–136.
+ * Wrapper Vue: `CoDropZone` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part host - El propio elemento (envuelve el contenido del slot).
+ * @part overlay - Capa que aparece al arrastrar archivos encima.
+ * @part badge - Círculo con el ícono dentro de la capa.
+ * @part label - Texto de la capa (`label`).
  */
 export declare class CoDropZone {
     /** Whether the drag-to-upload overlay is visible. */

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

@@ -12,6 +12,15 @@ import { EventEmitter } from '../../stencil-public-runtime';
  *
  * @event coSelect - El emoji elegido: `{ emoji, name }`.
  * @event coClose - Escape con el buscador vacío (el host decide si cierra).
+ *
+ * Wrapper Vue: `CoEmojiPicker` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part panel - Contenedor del panel.
+ * @part search - Fila del buscador.
+ * @part input - El `<input>` de búsqueda.
+ * @part tones - Selector de tono de piel.
+ * @part categories - Barra de categorías.
+ * @part grid - Grilla virtualizada de emoji.
  */
 export declare class CoEmojiPicker {
     el: HTMLElement;

package/dist/types/components/co-empty-state/co-empty-state.d.ts

@@ -1,6 +1,8 @@
 /**
  * Empty state placeholder — icon, title, description, and action buttons.
+ * Wrapper Vue: `CoEmptyState` de `@prolibu-suite/cobalt-vue`.
  * @slot - Action buttons
+ * @part empty-state - Contenedor del estado vacío.
  */
 export declare class CoEmptyState {
     /** Phosphor icon name */

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

@@ -1,25 +1,19 @@
 import { EventEmitter } from '../../stencil-public-runtime';
 import { type CoCalendarEvent, type NormalizedEvent } from '@prolibu-suite/cobalt-calendar-utils';
-/**
- * co-event-calendar — the public entry point of the Cobalt Calendars family.
- *
- * Owns view state, the visible anchor date, event normalization and the toolbar,
- * and delegates rendering to the active view (month/week/day; agenda pending).
- * All hard math lives in `@prolibu-suite/cobalt-calendar-utils`. Events are CONTROLLED: the
- * calendar emits requests (`coEventDrop`, `coDateSelect`) and the host applies
- * them by updating the `events` prop — leaving it unchanged on failure is the
- * revert.
- *
- * Instants are ISO-8601 strings WITH offset/Z (timed) or "YYYY-MM-DD" (all-day);
- * the calendar never exposes Date objects. `timeZone` controls wall-clock render.
- *
- * @part toolbar - The header toolbar
- * @part body - The active view container
- */
 type StatusColorsProp = Record<string, {
     backgroundColor?: string;
     borderColor?: string;
 }> | string;
+/**
+ * Calendario de eventos completo: vistas Mes, Semana y Día con barra de
+ * navegación. Es controlado: emite pedidos (`coEventDrop`, `coDateSelect`) y el
+ * host los aplica actualizando `events`. Los instantes son strings ISO-8601 con
+ * zona (o `YYYY-MM-DD` para todo el día); `timeZone` define el reloj en que se
+ * pintan. Wrapper Vue: `CoEventCalendar` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part toolbar - Barra de navegación (vista, fecha, hoy).
+ * @part body - Contenedor de la vista activa.
+ */
 export declare class CoEventCalendar {
     el: HTMLElement;
     /** Limpia el resaltado persistente de selección de la vista activa (timegrid
@@ -57,9 +51,11 @@ export declare class CoEventCalendar {
     allDaySlot: boolean;
     /** Visible-hours window for week/day (minutes-of-day bounds as "HH:mm"). */
     minTime: string;
+    /** Última hora visible `HH:mm` en Semana/Día (default 24:00). */
     maxTime: string;
     /** Slot/snap granularity (minutes) for week/day. */
     slotMinutes: number;
+    /** Minutos a los que se ajustan arrastres y selecciones en Semana/Día (default 15). */
     snapMinutes: number;
     /** Initial scroll position for week/day ("HH:mm"). */
     scrollTime: string;

package/dist/types/components/co-event-popover/co-event-popover.d.ts

@@ -6,9 +6,18 @@ import { type Placement } from '../../utils/positioning';
  * getBoundingClientRect), promotes to the top-layer (the calendar shell has
  * contain:layout ancestors that re-anchor position:fixed), and closes on Escape /
  * outside-click. Content is slotted by the host (suite-v2 fills the meeting fields).
+ *
+ * Wrapper Vue: `CoEventPopover` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @slot actions - Botones de acción de la esquina (editar, borrar, cerrar…).
+ * @slot - Contenido del detalle del evento.
+ *
+ * @part actions - Fila de acciones (slot `actions`).
+ * @part body - Cuerpo del detalle (slot por defecto).
  */
 export declare class CoEventPopover {
     el: HTMLElement;
+    /** Visible (reflejado); el componente lo pone en `false` al cerrarse por Escape o click afuera. */
     open: boolean;
     /** Anchor rect in viewport coords (chip.getBoundingClientRect()). */
     anchorRect?: {
@@ -17,15 +26,19 @@ export declare class CoEventPopover {
         width: number;
         height: number;
     };
+    /** Lado y alineación respecto de `anchorRect` (default `right-start`); voltea si no cabe. */
     placement: Placement;
     /** Accent color for the leading dot (event color). */
     color?: string;
     /** Render the leading color dot. Set false for dot-less content (quick-create). */
     dot: boolean;
+    /** Cierra con Escape (default `true`). */
     closeOnEscape: boolean;
+    /** Cierra con un click fuera del panel (default `true`). */
     closeOnClickOutside: boolean;
     /** Accessible name for the panel (role="dialog" needs one). */
     popoverLabel?: string;
+    /** Se cerró (Escape o click afuera). No burbujea. */
     coClose: EventEmitter<void>;
     private panelEl?;
     private prevFocus?;

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

@@ -1,18 +1,29 @@
 import { EventEmitter } from '../../stencil-public-runtime';
+/**
+ * Botón de acción flotante para la acción principal de una pantalla: círculo
+ * con ícono o, con `label`, pastilla extendida. `position` lo fija a una esquina
+ * de la ventana. Wrapper Vue: `CoFab` de `@prolibu-suite/cobalt-vue`.
+ */
 export declare class CoFab {
     el: HTMLElement;
+    /** Ícono Phosphor (default `plus`). */
     icon: string;
+    /** Texto: convierte el círculo en una pastilla extendida (o se revela con `expandOnHover`). */
     label?: string;
+    /** Estilo: `primary` (negro sólido), `secondary` o `stroke`. */
     variant: 'primary' | 'secondary' | 'stroke';
+    /** Diámetro: `xl` 64 · `l` 56 · `m` 48 (default) · `s` 40 px. */
     size: 'xl' | 'l' | 'm' | 's';
     /** Accessible label for icon-only FABs (falls back to `label`/`icon`). */
     ariaLabelText?: string;
+    /** Deshabilita el botón: no emite `coClick`. */
     disabled: boolean;
     /** Fixed position on screen */
     position: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left' | 'none';
     /** With `label`: icon-only circle at rest that stretches into the extended
      *  pill on hover/focus-visible (springy "liquid" morph). */
     expandOnHover: boolean;
+    /** Click en el botón (no se emite con `disabled`). Sin `detail`. */
     coClick: EventEmitter<void>;
     private labelEl?;
     private handleClick;

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

@@ -22,6 +22,7 @@ export interface FileItem {
  * in-memory CustomEvent detail, never a serialized attribute); the host uploads
  * them and feeds the resulting state back through the controlled `files` prop.
  * This mirrors `co-ref-field` (the WC emits intent, the host does the I/O).
+ * Wrapper Vue: `CoFileField` de `@prolibu-suite/cobalt-vue`.
  *
  * @part wrapper - Root container
  * @part label - The field label
@@ -41,10 +42,15 @@ export interface FileItem {
  */
 export declare class CoFileField {
     el: HTMLElement;
+    /** Etiqueta del campo. */
     label?: string;
+    /** Deshabilita el campo: no acepta archivos ni acciones. */
     disabled: boolean;
+    /** Solo lectura: muestra los archivos sin permitir subir, quitar ni reordenar. */
     readonly: boolean;
+    /** Campo obligatorio: marca la etiqueta con el indicador de requerido. */
     required: boolean;
+    /** Varios archivos: lista de subidos (con `max` y reordenamiento opcional); sin él, un solo archivo. */
     multiple: boolean;
     /** Accepted formats: comma list of extensions/mime (e.g. ".pdf,.png" or a JSON array). */
     accept?: string;

package/dist/types/components/co-file-type-tile/co-file-type-tile.d.ts

@@ -1,3 +1,10 @@
+/**
+ * Ícono de tipo de archivo (según la extensión) sobre un cuadrado redondeado
+ * tintado: PDF, documento, planilla, imagen… Wrapper Vue: `CoFileTypeTile` de
+ * `@prolibu-suite/cobalt-vue`.
+ *
+ * @part tile - El cuadrado con el ícono.
+ */
 export declare class CoFileTypeTile {
     /** File extension (e.g. "pdf", "docx", "png"). Case-insensitive; a leading dot is ignored. */
     ext: string;

package/dist/types/components/co-gradient-bar/co-gradient-bar.d.ts

@@ -17,6 +17,11 @@ import { type GradientStop, type GradientStopAddDetail, type GradientStopMoveDet
  * El componente es controlado: `stops` los pinta el host. Durante el arrastre
  * el handle se pinta en la posición viva aunque el host no aplique cada
  * `coStopMove`.
+ *
+ * Wrapper Vue: `CoGradientBar` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part track - La barra con el degradado.
+ * @part handle - Cada tirador de parada.
  */
 export declare class CoGradientBar {
     el: HTMLElement;

package/dist/types/components/co-helper-text/co-helper-text.d.ts

@@ -1,5 +1,7 @@
 /**
  * Helper / validation text shown below form fields.
+ * Wrapper Vue: `CoHelperText` de `@prolibu-suite/cobalt-vue`.
+ * @part helper-text - La fila del texto (ícono de estado + texto).
  */
 export declare class CoHelperText {
     /** Status variant */

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

@@ -5,6 +5,10 @@ import { type IconWeight } from './iconLoader';
  * Usage:
  *   <co-icon name="plus" />
  *   <co-icon name="arrow-right" weight="bold" size="24" />
+ *
+ * Wrapper Vue: `CoIcon` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part svg - Contenedor del SVG (toma `currentColor`).
  */
 export declare class CoIcon {
     /** Phosphor icon name in kebab-case, e.g. "plus", "arrow-right", "magnifying-glass" */

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

@@ -1,4 +1,10 @@
 /**
+ * Botón que solo muestra un ícono. Como no tiene texto visible, `label` es
+ * obligatorio (es su nombre accesible) y conviene envolverlo en un `co-tooltip`.
+ * Wrapper Vue: `CoIconButton` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part button - El `<button>` nativo interno.
+ *
  * @slot - Glifo propio (p.ej. un `<svg>` inline de 16px) que ocupa el lugar del
  *         `co-icon` cuando NO se pasa `icon`. Va dentro del `<button>`, así que
  *         hereda `color`/`currentColor`, la opacidad de hover/disabled, el
@@ -74,10 +80,9 @@ export declare class CoIconButton {
     /**
      * Agrega un `caret-down` de 8px a la derecha del icono principal (botones-disclosure).
      * Ensancha la caja +8px (el alto no cambia) para que el caret no le robe espacio
-     * al icono — fix round 1: la primera versión usaba `padding-right`, que con
-     * `box-sizing: border-box` y ancho fijo por talla ENCOGE el área de contenido en
-     * vez de agrandar la caja (overflow real en xs/xxs). Sin `caret`, el DOM/CSS
-     * quedan idénticos al comportamiento anterior.
+     * al icono (un `padding-right` con `box-sizing: border-box` y ancho fijo por talla
+     * encogería el área de contenido en vez de agrandar la caja). Sin `caret`, el
+     * DOM/CSS quedan idénticos al comportamiento anterior.
      */
     caret: boolean;
     render(): any;

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

@@ -8,6 +8,17 @@ import { EventEmitter } from '../../stencil-public-runtime';
  * @slot suffix - Slot for suffix content (e.g. toggle password icon) rendered after the input
  * @slot action - Slot for action button, rendered flush-right inside the field (Botón variant)
  * @slot chips - Slot for chip/tag elements rendered before the input (Chips variant)
+ *
+ * Wrapper Vue: `CoInput` 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 field - Caja con borde que contiene el input.
+ * @part input - El `<input>` nativo.
+ * @part clear - Botón × (`clearable`).
+ * @part action - Botón de acción (`actionIcon`/`actionLabel`).
+ * @part helper - Texto de ayuda o de error.
  */
 export declare class CoInput {
     /** Label text displayed above or beside the input */