@prolibu-suite/cobalt-core 0.11.0 → 0.11.2

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

@@ -11,6 +11,12 @@ export interface CoSegment {
  * A stacked, multi-segment meter — a pill track split into N contiguous
  * colored segments (e.g. a storage breakdown). Display-only; colors are
  * supplied by the consumer. Provide an external legend via `slot="legend"`.
+ * Wrapper Vue: `CoSegmentedBar` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @slot legend - Leyenda externa bajo la barra.
+ * @part segmented-bar - Contenedor del componente.
+ * @part track - La pista (pastilla) que contiene los segmentos.
+ * @part segment - Cada segmento de color.
  */
 export declare class CoSegmentedBar {
     /** Track height in px. */

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

@@ -7,7 +7,14 @@ export interface SelectOption {
     image?: string;
     disabled?: boolean;
 }
+/**
+ * Selector desplegable de una o varias opciones de una lista conocida, con
+ * búsqueda opcional del lado del cliente y lista virtualizada. Para opciones que
+ * vienen paginadas del servidor usá `co-ref-field`. Wrapper Vue: `CoSelect` de
+ * `@prolibu-suite/cobalt-vue`.
+ */
 export declare class CoSelect {
+    /** Etiqueta del campo (también es su nombre accesible). */
     label?: string;
     /** Accessible name for the combobox when there is NO visible `label` (compact
      *  rows that drop the field label). Same `ariaLabelText` precedent as
@@ -17,20 +24,34 @@ export declare class CoSelect {
     ariaLabelText?: string;
     /** Whether the field is required (renders a required marker on the label). */
     required: boolean;
+    /** Texto secundario junto a la etiqueta (p. ej. «Opcional»); con `labelStyle="inline-help"` va a la derecha. */
     secondaryLabel?: string;
+    /** Texto del trigger sin selección. */
     placeholder: string;
+    /** Deshabilita el campo. */
     disabled: boolean;
+    /** Ícono Phosphor al inicio del trigger. */
     iconLeft?: string;
     /** Tamaño (px) del `co-icon` de `iconLeft`. Sin setear, conserva el actual (16). */
     iconSize?: number;
+    /** Botón × para vaciar la selección cuando hay valor; 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';
+    /** Estado de validación: pinta el borde y el `helperText` con el color del estado. */
     status: 'default' | 'error' | 'success' | 'warning' | 'info';
+    /** Opciones: array de `{ value, label, icon?, image?, disabled? }`, array de strings
+     *  (value = label), o ese mismo array como JSON desde HTML. */
     options: SelectOption[] | string[] | string;
+    /** Selección: el `value` de la opción en single; en `multiple`, array o JSON array.
+     *  `''` significa «sin selección» (una opción con `value: ''` no se puede marcar).
+     *  El componente lo actualiza al elegir. */
     value: string | string[];
+    /** Selección múltiple: el panel queda abierto y `value`/`coChange` llevan un array. */
     multiple: boolean;
+    /** Alto del trigger: `xs` 24 · `s` 28 · `sm` 32 · `md` 40 (default) · `lg` 48. Un valor fuera de la lista cae al default. */
     size: 'xs' | 's' | 'sm' | 'md' | 'lg';
     /** Visual style. `flat` strips the trigger's border and background so it
      *  reads as plain content instead of a boxed control — padding, label,
@@ -52,7 +73,9 @@ export declare class CoSelect {
     menuSurface: 'light' | 'dark';
     /** Show a search box inside the dropdown to filter options client-side. */
     searchable: boolean;
+    /** Placeholder del buscador del panel (`searchable`). */
     searchPlaceholder: string;
+    /** Texto del panel cuando la búsqueda no encuentra opciones. */
     emptyText: string;
     /** Footer de confirmación al pie del panel (paridad co-combobox/co-ref-field). */
     showFooter: boolean;
@@ -95,7 +118,10 @@ export declare class CoSelect {
      *  el scroll quedaba clampeado en cualquier parte de la lista en vez de en la
      *  opción seleccionada. El loop corta solo al verificar el write o al cerrar. */
     private static readonly ACTIVE_SCROLL_MAX_FRAMES;
+    /** Cambió la selección (`value` ya está actualizado): `detail` = value elegido, o el
+     *  array completo en `multiple`. Al vaciar con la ×: `''` (o `[]`). */
     coChange: EventEmitter<string | string[]>;
+    /** Se vació la selección con la ×. Sin `detail`; le sigue un `coChange`. */
     coClear: EventEmitter<void>;
     /** Click en el botón primario del footer (el panel se cierra solo). */
     coFooterPrimary: EventEmitter<void>;

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

@@ -1,3 +1,10 @@
+/**
+ * Línea divisoria horizontal o vertical, con espaciado e inset opcionales y
+ * color/grosor configurables por prop. Wrapper Vue: `CoSeparator` de
+ * `@prolibu-suite/cobalt-vue`.
+ *
+ * @part separator - La línea.
+ */
 export declare class CoSeparator {
     /** Orientation: horizontal (default) or vertical */
     vertical: boolean;

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

@@ -1,5 +1,13 @@
 import { EventEmitter } from '../../stencil-public-runtime';
 /**
+ * Barra lateral de navegación con cabecera, cuerpo de ítems y pie. Wrapper Vue:
+ * `CoSidebar` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part sidebar - La barra completa.
+ * @part header - Área del slot `header`.
+ * @part body - Área de navegación (slot por defecto).
+ * @part footer - Área del slot `footer`.
+ *
  * @slot header - Logo / branding area
  * @slot        - Navigation items (co-list-item, etc.)
  * @slot footer - Bottom section

package/dist/types/components/co-sidebar-nav/co-sidebar-nav.d.ts

@@ -21,6 +21,7 @@ export interface NavigateDetail {
  * A complete sidebar navigation component that renders a hierarchical menu.
  * Accepts the raw `uiSchemas.sideBar` JSON from the Prolibu API and
  * automatically renders categories, expandable groups, and leaf items.
+ * Wrapper Vue: `CoSidebarNav` de `@prolibu-suite/cobalt-vue`.
  *
  * @example
  * ```html

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

@@ -2,6 +2,9 @@ import { EventEmitter } from '../../stencil-public-runtime';
 /**
  * Placeholder de carga con shimmer (sweep). Componer apilando varios.
  * Respeta prefers-reduced-motion (sin animación).
+ * Wrapper Vue: `CoSkeleton` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part skeleton - El bloque con el shimmer.
  */
 export declare class CoSkeleton {
     /** rect (default) | text (radio menor) | circle */

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

@@ -1,5 +1,12 @@
 import { EventEmitter } from '../../stencil-public-runtime';
+/**
+ * Control deslizante para elegir un número dentro de un rango, horizontal o
+ * vertical (volumen: el máximo arriba). `coInput` es la vista previa mientras se
+ * arrastra y `coChange` confirma una vez al terminar el gesto. Wrapper Vue:
+ * `CoSlider` de `@prolibu-suite/cobalt-vue`.
+ */
 export declare class CoSlider {
+    /** Etiqueta visible; también da el nombre accesible si no hay `ariaLabelText`. */
     label?: string;
     /**
      * Nombre accesible del control, SIN dibujar etiqueta. `label` hace las dos
@@ -21,13 +28,21 @@ export declare class CoSlider {
      * el mismo criterio que el `=== 'vertical'` de `isVertical`.
      */
     ariaLabelText?: string;
+    /** Texto secundario junto a la etiqueta (p. ej. la unidad). */
     secondaryLabel?: string;
+    /** Texto de ayuda o de error bajo el control. */
     helperText?: string;
+    /** Estado de validación: colorea el `helperText`. */
     status: 'default' | 'error' | 'success' | 'warning' | 'info';
+    /** Valor actual; el componente lo actualiza al arrastrar o con el teclado. */
     value: number;
+    /** Mínimo del rango (default 0). */
     min: number;
+    /** Máximo del rango (default 100). */
     max: number;
+    /** Paso entre valores (default 1); también el paso de las flechas. */
     step: number;
+    /** Deshabilita el control. */
     disabled: boolean;
     /** Show current value label */
     showValue: boolean;
@@ -51,7 +66,9 @@ export declare class CoSlider {
     orientation: 'horizontal' | 'vertical';
     dragging: boolean;
     el: HTMLElement;
+    /** Confirma el valor: una vez al terminar el gesto (si hubo algún `coInput`) y en cada paso de teclado. `detail` = número. */
     coChange: EventEmitter<number>;
+    /** Vista previa mientras se arrastra, solo cuando el valor cambia. `detail` = número. */
     coInput: EventEmitter<number>;
     private trackEl?;
     /** Puntero dueño del gesto en curso: un segundo dedo no lo secuestra. */

package/dist/types/components/co-swatch-grid/co-swatch-grid.d.ts

@@ -6,6 +6,7 @@ import { EventEmitter } from '../../stencil-public-runtime';
  *
  * Los colores claros (luminancia WCAG > 0,85) reciben un borde automático
  * para no fundirse con el fondo del panel.
+ * Wrapper Vue: `CoSwatchGrid` de `@prolibu-suite/cobalt-vue`.
  */
 export declare class CoSwatchGrid {
     el: HTMLElement;

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

@@ -1,4 +1,13 @@
 import { EventEmitter } from '../../stencil-public-runtime';
+/**
+ * Interruptor on/off para activar o desactivar una opción al instante, con
+ * etiqueta y texto secundario. Wrapper Vue: `CoSwitch` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part track - Riel del interruptor.
+ * @part thumb - Círculo que se desplaza.
+ * @part label - Etiqueta.
+ * @part secondary-label - Texto secundario bajo la etiqueta.
+ */
 export declare class CoSwitch {
     /** Whether the switch is on */
     checked: boolean;

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

@@ -1,4 +1,12 @@
 import { EventEmitter } from '../../stencil-public-runtime';
+/**
+ * Pestaña individual; va dentro de un `co-tab-group`, que le propaga `variant`,
+ * `size` y `fullWidth` y marca `selected` según su `value`. Wrapper Vue: `CoTab`
+ * de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part tab - El botón de la pestaña.
+ * @part badge - Contador junto al texto (`badge`).
+ */
 export declare class CoTab {
     /** Tab label */
     label: string;
@@ -6,9 +14,9 @@ export declare class CoTab {
     value: string;
     /** Whether this tab is active/selected */
     selected: boolean;
-    /** Size. 'large'/'small' son los tamaños históricos (pill/underline). 's' (28px)
-        y 'xs' (26px, excepción D-19 a la escala unificada) solo tienen chrome propio
-        en `variant="segmented"` — ver co-tab.css. */
+    /** Tamaño: `large`/`small` (default) son los de las variantes pill y underline;
+     *  `s` (28px) y `xs` (26px) solo tienen estilo propio en `variant="segmented"`.
+     *  Dentro de un `co-tab-group` con `size`, el grupo lo fija. */
     size: 'large' | 'small' | 's' | 'xs';
     /** Visual variant: filled pill (default), underline tab, or segmented-control pill */
     variant: 'pill' | 'underline' | 'segmented';

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

@@ -1,4 +1,13 @@
 import { EventEmitter } from '../../stencil-public-runtime';
+/**
+ * Grupo de pestañas (`co-tab`) que controla cuál está activa: `value` marca la
+ * pestaña, al elegir otra se actualiza y emite `coTabChange`. Propaga `variant`,
+ * `size` y `fullWidth` a sus pestañas y, si desbordan, lleva la activa a la
+ * vista. Wrapper Vue: `CoTabGroup` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @slot - Los `co-tab` del grupo.
+ * @part tab-group - La pista que contiene las pestañas.
+ */
 export declare class CoTabGroup {
     el: HTMLElement;
     /** Currently selected tab value */

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

@@ -19,17 +19,26 @@ import { EventEmitter } from '../../stencil-public-runtime';
  * @part input - The native text input
  * @part clear - The clear-all button
  * @part helper - The helper/error text row
+ *
+ * Wrapper Vue: `CoTagsField` de `@prolibu-suite/cobalt-vue`.
  */
 export declare class CoTagsField {
     el: HTMLElement;
     /** Committed value as a JSON array of strings (or an actual `string[]`). */
     value: string[] | string;
+    /** Etiqueta del campo. */
     label?: string;
+    /** Placeholder del input para escribir un tag nuevo. */
     placeholder: string;
+    /** Atributo `name` del input nativo. */
     name?: string;
+    /** Campo obligatorio: marca la etiqueta con el indicador de requerido. */
     required: boolean;
+    /** Deshabilita el campo. */
     disabled: boolean;
+    /** Solo lectura: muestra los tags sin permitir agregar ni quitar. */
     readonly: boolean;
+    /** Botón × que quita todos los tags (default `true`); emite `coClear`. */
     clearable: boolean;
     /** Maximum number of tags allowed (no cap when undefined). */
     maxTags?: number;
@@ -51,7 +60,9 @@ export declare class CoTagsField {
     coInput: EventEmitter<string>;
     /** Emitted when the clear-all button is clicked. */
     coClear: EventEmitter<void>;
+    /** El input ganó el foco. */
     coFocus: EventEmitter<void>;
+    /** El input perdió el foco. */
     coBlur: EventEmitter<void>;
     /** Raw text in the inline input. */
     draft: string;

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

@@ -12,6 +12,11 @@
  *
  * @slot icon - Reemplaza el `co-icon` por defecto (renderizado a partir de
  *              `icon`/`iconSize`) por contenido propio del consumidor.
+ *
+ * @part tile - La tarjeta.
+ * @part label - La etiqueta bajo el ícono.
+ *
+ * Wrapper Vue: `CoTile` de `@prolibu-suite/cobalt-vue`.
  */
 export declare class CoTile {
     /** Etiqueta visible debajo del ícono. Soporta `\n` (se renderiza en dos líneas). */

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

@@ -10,6 +10,8 @@ type Segment = 'hour' | 'minute' | 'period';
  * (co-date-time-picker: coInput→draft, coCommit→commit+close).
  * `coEscape` = anuncio de intención; el picker NO lo wirea — ver
  * co-date-time-picker.tsx (Escape lo posee su root handler).
+ *
+ * Wrapper Vue: `CoTimeField` de `@prolibu-suite/cobalt-vue`.
  */
 export declare class CoTimeField {
     el: HTMLElement;
@@ -17,7 +19,9 @@ export declare class CoTimeField {
     value: number | null;
     /** Reloj de 12 h. `false` = 00–23 sin segmento de período. */
     hour12: boolean;
+    /** Locale BCP-47: textos del período (a. m./p. m.) y nombres accesibles de los segmentos. */
     locale: string;
+    /** Deshabilita el campo. */
     disabled: boolean;
     /** Paso de PageUp/PageDown sobre el minuto. */
     pageStep: number;
@@ -41,6 +45,7 @@ export declare class CoTimeField {
     private hourEl?;
     componentWillLoad(): void;
     syncFromValue(v: number | null): void;
+    /** Enfoca el segmento de la hora. */
     focusInput(): Promise<void>;
     private minutesOfDay;
     private get isPm();

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

@@ -2,6 +2,11 @@ import { EventEmitter } from '../../stencil-public-runtime';
 export type CoToastVariant = 'success' | 'error' | 'warning' | 'info' | 'neutral';
 export type CoToastActionsLayout = 'inline' | 'stacked';
 /**
+ * Notificación breve con mensaje, descripción opcional, ícono, acciones y ✕,
+ * con variantes semánticas y barra de progreso opcional. Es solo la tarjeta:
+ * mostrarla, apilarla y ocultarla es del host. Wrapper Vue: `CoToast` de
+ * `@prolibu-suite/cobalt-vue`.
+ *
  * @slot action - Action area (buttons, icon buttons)
  *
  * Figma variants (Tipos) are layout choices:
@@ -11,6 +16,10 @@ export type CoToastActionsLayout = 'inline' | 'stacked';
  * - Tipo=04 → message + inline icon action + dismiss
  *
  * Semantic `variant` adds a colored left accent + tinted icon + default icon when none provided.
+ *
+ * @part toast - Tarjeta del toast.
+ * @part track - Riel de la barra de progreso (`progress`).
+ * @part fill - Relleno de la barra de progreso.
  */
 export declare class CoToast {
     /**

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

@@ -1,6 +1,7 @@
 import { EventEmitter } from '../../stencil-public-runtime';
 /**
  * co-toggle-button — pastilla de un `co-toggle-button-group`.
+ * Wrapper Vue: `CoToggleButton` de `@prolibu-suite/cobalt-vue`.
  *
  * @part button - El `<button>` interno. El hook para lo que el CSS deja
  *                hardcodeado y no tiene prop, empezando por su
@@ -11,10 +12,15 @@ import { EventEmitter } from '../../stencil-public-runtime';
  *                 lo espacia el mismo `gap` que a `iconLeft`.
  */
 export declare class CoToggleButton {
+    /** Activado (reflejado). El click lo invierte; dentro de un `co-toggle-button-group` lo coordina el grupo. */
     selected: boolean;
+    /** Valor que identifica al botón dentro de su grupo y que viaja en `coToggle`. */
     value: string;
+    /** Texto del botón. */
     label?: string;
+    /** Ícono Phosphor antes del texto. */
     iconLeft?: string;
+    /** Ícono Phosphor después del texto. */
     iconRight?: string;
     /** Talla del botón. Si no se indica (ni atributo ni propiedad) y el botón
      *  está dentro de un `co-toggle-button-group` con `variant="soft"` (cualquier
@@ -26,6 +32,7 @@ export declare class CoToggleButton {
      *  adopta UNA vez, al montar: cambiar después el `size` del grupo no
      *  re-talla a los botones ya montados (el editor lo fija estáticamente). */
     size: 'l' | 'm' | 's' | 'xs';
+    /** Deshabilita el botón. */
     disabled: boolean;
     /** Visual variant. 'track' renders the button as a detached rounded pill for a
      *  sunken toggle-button-group track. 'soft' renders it as a separated gray-100
@@ -36,6 +43,7 @@ export declare class CoToggleButton {
      *  is selected (e.g. 'fill' for the active segment of a track toggle). */
     selectedIconWeight?: 'regular' | 'fill';
     el: HTMLElement;
+    /** Click en el botón: `{ value, selected }` con el estado nuevo. */
     coToggle: EventEmitter<{
         value: string;
         selected: boolean;

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

@@ -1,12 +1,19 @@
 import { EventEmitter } from '../../stencil-public-runtime';
+/**
+ * Grupo de `co-toggle-button` que coordina la selección: única (default) o
+ * `multiple`. `variant` elige el estilo (`connected`, `track`, `soft`) y se
+ * propaga a los botones. Wrapper Vue: `CoToggleButtonGroup` de
+ * `@prolibu-suite/cobalt-vue`.
+ */
 export declare class CoToggleButtonGroup {
     /** Current selected value(s). Single string or JSON array for multiple. */
     value: string | string[];
+    /** Selección múltiple: `value` y `coChange` llevan un array de valores. */
     multiple: boolean;
     /** Talla del grupo. El grupo NO la empuja a sus hijos: cada `co-toggle-button`
      *  sin `size` propio la LEE al montarse (`componentWillLoad`, antes de su
-     *  primer render) y la adopta SOLO en las combinaciones nuevas de la Fase 2
-     *  Cobalt — `variant="soft"` (cualquier talla) o `variant="track"` +
+     *  primer render) y la adopta SOLO en las combinaciones compactas del editor
+     *  — `variant="soft"` (cualquier talla) o `variant="track"` +
      *  `size="xs"` — y nunca con un valor fuera de la unión del hijo (`l|m|s|xs`).
      *  Fuera de eso los hijos la ignoran, como siempre: el host ya usa
      *  `size="sm"` (fuera de la unión) y `size="s"` con la variante default, y
@@ -18,7 +25,9 @@ export declare class CoToggleButtonGroup {
      *  montar; cambiar `size` del grupo después no re-talla a los hijos ya
      *  montados (aquí solo actualiza la clase `--xs` de la pista). */
     size: 'l' | 'm' | 's' | 'xs';
+    /** Deshabilita todos los botones del grupo. */
     disabled: boolean;
+    /** Disposición de los botones: `row` (default) o `column`. */
     direction: 'row' | 'column';
     /** Stretch the group to fill its container; each button shares the width equally. */
     fullWidth: boolean;
@@ -29,6 +38,7 @@ export declare class CoToggleButtonGroup {
      *  the selected chip gets the celeste-100/primary-azul accent pair. */
     variant: 'connected' | 'track' | 'soft';
     el: HTMLElement;
+    /** Cambió la selección (`value` ya está actualizado): el valor elegido, o el array en `multiple`. */
     coChange: EventEmitter<string | string[]>;
     private get selectedValues();
     syncChildren(): void;

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

@@ -1,4 +1,14 @@
 import { Placement } from '../../utils/positioning';
+/**
+ * Globo de ayuda que aparece al pasar el mouse o enfocar el control envuelto.
+ * Es la forma de rotular un control de solo ícono (en lugar del `title`
+ * nativo), pero no le da nombre accesible: el control lleva el suyo.
+ * `variant="label"` + `shortcut` muestran el atajo con un `co-kbd`. Wrapper Vue:
+ * `CoTooltip` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @slot - El control que dispara el tooltip.
+ * @part panel - El globo.
+ */
 export declare class CoTooltip {
     /** Tooltip text content. */
     content: string;

package/dist/types/components/co-transfer-list/co-transfer-list.d.ts

@@ -4,19 +4,31 @@ export interface TransferOption {
     value: string;
     disabled?: boolean;
 }
+/**
+ * Selector de dos listas: se marcan opciones en la lista de disponibles y se
+ * pasan a la de seleccionadas (y de vuelta) con botones de mover, uno o todos.
+ * Wrapper Vue: `CoTransferList` de `@prolibu-suite/cobalt-vue`.
+ */
 export declare class CoTransferList {
+    /** Etiqueta del campo. */
     label?: string;
+    /** Título de la lista de disponibles. */
     leftTitle: string;
+    /** Título de la lista de seleccionadas. */
     rightTitle: string;
     /** All available options */
     options: TransferOption[] | string[] | string;
     /** Values in the right (selected) list */
     value: string[] | string;
+    /** Deshabilita las listas y los botones. */
     disabled: boolean;
+    /** Texto de ayuda o de error bajo el campo. */
     helperText?: string;
+    /** Estado de validación: colorea el `helperText`. */
     status: 'default' | 'error' | 'success' | 'warning' | 'info';
     leftChecked: Set<string>;
     rightChecked: Set<string>;
+    /** Cambió la lista de seleccionadas (`value` ya está actualizado); `detail` = array de valores. */
     coChange: EventEmitter<string[]>;
     el: HTMLElement;
     private osInstances;

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

@@ -39,6 +39,8 @@ export type TreeItemSize = 's' | 'xs';
  * @part label    - Texto del label.
  * @part suffix   - Contenedor de las acciones.
  * @part children - Bloque de filas hijas (`role="group"`).
+ *
+ * Wrapper Vue: `CoTreeItem` de `@prolibu-suite/cobalt-vue`.
  */
 export declare class CoTreeItem {
     el: HTMLElement;

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

@@ -2,8 +2,19 @@ import { EventEmitter } from '../../stencil-public-runtime';
 type VideoLang = 'es' | 'en' | 'pt';
 /**
  * A fully configurable video player component with custom controls.
+ * Reproductor de video con controles propios (play, volumen, progreso, tiempo,
+ * velocidad, pantalla completa, PiP, descarga), eventos de progreso y umbral de
+ * visualización. Wrapper Vue: `CoVideo` de `@prolibu-suite/cobalt-vue`.
  *
  * @slot - Default slot (unused, reserved for future captions/overlays)
+ *
+ * @part container - Caja del reproductor (relación de aspecto y radio).
+ * @part video - El elemento `<video>` nativo.
+ * @part poster - Imagen de portada antes de reproducir.
+ * @part big-play - Botón grande de play centrado.
+ * @part controls - Barra de controles inferior.
+ * @part progress - Barra de progreso/búsqueda.
+ * @part toolbar - Fila de botones de la barra de controles.
  */
 export declare class CoVideo {
     /** Video source URL */
@@ -62,8 +73,11 @@ export declare class CoVideo {
     watchThreshold: number;
     /** Language for labels and aria attributes */
     locale: VideoLang;
+    /** Empezó o se reanudó la reproducción. */
     coPlay: EventEmitter<void>;
+    /** Se pausó la reproducción. */
     coPause: EventEmitter<void>;
+    /** Terminó el video (sin `loop`). */
     coEnded: EventEmitter<void>;
     /** Metadata lista. Incluye el tamaño INTRÍNSECO del medio para que el host
      *  pueda ajustar su caja al frame (0 × 0 si el navegador aún no lo sabe). */
@@ -72,35 +86,44 @@ export declare class CoVideo {
         width: number;
         height: number;
     }>;
+    /** Error del medio: `detail` = `{ code, message }` (código de `MediaError` y mensaje traducido según `locale`). */
     coError: EventEmitter<{
         code: number;
         message: string;
     }>;
+    /** Avance de la reproducción, como mucho cada 250 ms: `{ currentTime, duration, progressPercent }` (segundos y 0–100). No burbujea. */
     coTimeUpdate: EventEmitter<{
         currentTime: number;
         duration: number;
         progressPercent: number;
     }>;
+    /** Terminó un salto en la barra de progreso: `{ from, to }` en segundos. */
     coSeeked: EventEmitter<{
         from: number;
         to: number;
     }>;
+    /** Cambió el volumen o el silencio: `{ volume, muted }` (volumen 0–1). */
     coVolumeChange: EventEmitter<{
         volume: number;
         muted: boolean;
     }>;
+    /** Entró o salió de pantalla completa: `{ fullscreen }`. */
     coFullscreenChange: EventEmitter<{
         fullscreen: boolean;
     }>;
+    /** Cambió la velocidad desde el selector: `{ rate }`. */
     coPlaybackRateChange: EventEmitter<{
         rate: number;
     }>;
+    /** Entró o salió de Picture-in-Picture: `{ pip }`. */
     coPipChange: EventEmitter<{
         pip: boolean;
     }>;
+    /** Click en descargar (con `allowDownload`), justo antes de iniciar la descarga: `{ src }`. */
     coDownload: EventEmitter<{
         src: string;
     }>;
+    /** Se alcanzó el `watchThreshold` (una sola vez por video): `{ threshold, currentTime, duration }`. Útil para marcar un video como visto. */
     coThresholdReached: EventEmitter<{
         threshold: number;
         currentTime: number;
@@ -146,13 +169,21 @@ export declare class CoVideo {
     componentWillLoad(): void;
     componentDidLoad(): void;
     disconnectedCallback(): void;
+    /** Inicia la reproducción (puede rechazarse si el navegador bloquea el autoplay con sonido). */
     play(): Promise<void>;
+    /** Pausa la reproducción. */
     pause(): Promise<void>;
+    /** Alterna entre reproducir y pausar. */
     togglePlay(): Promise<void>;
+    /** Salta a `time` (segundos). */
     seek(time: number): Promise<void>;
+    /** Fija el volumen (0–1; se recorta a ese rango). */
     setVolume(level: number): Promise<void>;
+    /** Alterna el silencio (igual que el botón de volumen). */
     toggleMute(): Promise<void>;
+    /** Entra o sale de pantalla completa. */
     toggleFullscreen(): Promise<void>;
+    /** Entra o sale de Picture-in-Picture (si el navegador lo soporta). */
     togglePip(): Promise<void>;
     private parseRates;
     private resetState;