@prolibu-suite/cobalt-core 0.11.0 → 0.11.1

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

@@ -19,15 +19,39 @@ export interface RefFieldDisplayItem {
     avatar?: string;
     image?: string;
 }
+/**
+ * Campo para elegir uno o varios registros relacionados (contactos, empresas,
+ * workspaces…) con búsqueda y paginación del lado del host: el componente pinta
+ * el trigger y el panel (`co-option-list`) y emite `coSearch`/`coLoadMore`; el
+ * host responde con `options`, `total` y `loading`. Wrapper Vue: `CoRefField` de
+ * `@prolibu-suite/cobalt-vue`.
+ *
+ * @slot panel - Reemplaza la lista del panel por contenido propio del host (su búsqueda, opciones y accesibilidad); se conservan el chrome del panel y el footer. Selecciona con `selectOption()`.
+ * @slot panel-footer - Contenido libre al pie de la lista del panel (p. ej. un switch), encima de los botones de `showFooter`.
+ *
+ * @part trigger-text - Texto del valor seleccionado en el trigger (modo single).
+ * @part trigger-placeholder - Placeholder del trigger sin valor.
+ * @part trigger-inherited - Texto del valor heredado (`inheritedLabel`) cuando no hay valor.
+ * @part trigger-inherited-badge - Chip junto al valor heredado (`inheritedBadgeLabel`).
+ * @part trigger-badge - Insignia de estado tras el valor (`triggerBadgeIcon`).
+ * @part trigger-edit - Botón lápiz del trigger (`editable`).
+ * @part trigger-clear - Botón × que vacía la selección (`clearable`).
+ * @part trigger-chevron - Ícono de apertura del panel.
+ */
 export declare class CoRefField {
+    /** 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 (p. ej. «Opcional»). */
     secondaryLabel?: string;
     /** Phosphor icon name rendered before the label text. */
     labelIcon?: string;
+    /** Texto del trigger sin valor (salvo que haya `inheritedLabel`). */
     placeholder: string;
+    /** Deshabilita el campo: no abre el panel ni muestra × ni lápiz. */
     disabled: boolean;
+    /** Muestra la × que vacía la selección cuando hay valor (default `true`); emite `coClear`. */
     clearable: boolean;
     /** Shows a pencil button on the single-value trigger that emits
      *  `coEditSelected` with the selected record id. The host owns policy
@@ -35,9 +59,13 @@ export declare class CoRefField {
     editable: boolean;
     /** Accessible name / tooltip for the edit button. */
     editLabel: string;
+    /** Selección múltiple: la selección se pinta como chips y `value` es un JSON array de ids. */
     multiple: boolean;
+    /** Estado de validación: pinta el borde y el `helperText` con el color del estado. */
     status: 'default' | 'error' | 'success' | 'warning';
+    /** Texto de ayuda o de error bajo el campo. */
     helperText?: string;
+    /** Ícono Phosphor al inicio del trigger. */
     iconLeft?: string;
     /** Label layout: vertical (label above) or horizontal (label beside) */
     layout: 'vertical' | 'horizontal';
@@ -65,9 +93,13 @@ export declare class CoRefField {
     loading: boolean;
     /** Total count of matching records from the API. */
     total: number;
+    /** Buscador en el panel (default `true`); el filtrado lo hace el host al recibir `coSearch`. */
     searchable: boolean;
+    /** Placeholder del buscador del panel. */
     searchPlaceholder: string;
+    /** Espera en ms entre la última tecla y el `coSearch` (default 350). */
     searchDebounce: number;
+    /** Texto del panel cuando no hay opciones. */
     emptyMessage: string;
     /** Show footer buttons (same pattern as co-combobox). */
     showFooter: boolean;
@@ -127,17 +159,27 @@ export declare class CoRefField {
     pinnable: boolean;
     /** Drag-reorder de la lista del panel (forward a co-option-list). */
     listReorderable: boolean;
+    /** Cambió la selección (el componente ya actualizó `value`). `detail.value`: el id
+     *  elegido, o el array completo en `multiple`; `detail.item`: la opción elegida o quitada. */
     coChange: EventEmitter<{
         value: string | string[];
         item: RefFieldOption;
     }>;
+    /** Se vació la selección (× del trigger o deselección de la fila en single). Sin `detail`. */
     coClear: EventEmitter<void>;
+    /** Término del buscador del panel, con debounce. El host filtra y responde con `options`. */
     coSearch: EventEmitter<string>;
+    /** Pide la página siguiente de opciones (scroll al final del panel). Sin `detail`. */
     coLoadMore: EventEmitter<void>;
+    /** Se abrió el panel. No burbujea. */
     coOpen: EventEmitter<void>;
+    /** Se cerró el panel. No burbujea. */
     coClose: EventEmitter<void>;
+    /** Se quitó un chip en `multiple`; `detail` = id quitado. También sale `coChange` con la selección nueva. */
     coRemove: EventEmitter<string>;
+    /** Click en el botón primario del footer (`showFooter`); cierra el panel. Sin `detail`. */
     coFooterPrimary: EventEmitter<void>;
+    /** Click en el botón secundario del footer (p. ej. «Nuevo»); el panel queda abierto. Sin `detail`. */
     coFooterSecondary: EventEmitter<void>;
     /** Re-emisión del toggle de pin de una fila del panel (pinnable). */
     coPinToggle: EventEmitter<{

package/dist/types/components/co-rich-text-editor/co-rich-text-editor.d.ts

@@ -7,11 +7,19 @@ import type { Editor, RichTextOutput, RichTextPreset, ToolbarVariant } from '@pr
  * ProseMirror builds its editable DOM imperatively — Stencil's scoped CSS would
  * never reach it. All styles live in light DOM via BEM + `--co-*` tokens.
  *
+ * Editor de texto enriquecido configurado por `preset` (tarea, comentario,
+ * notas, email, documento, impresión). Wrapper Vue: `CoRichTextEditor` de
+ * `@prolibu-suite/cobalt-vue`.
+ *
+ * @slot content-end - Zona entre el contenido y la barra inferior (adjuntos pendientes, vistas previas). Siempre montar el hijo y ocultarlo con CSS.
+ * @slot toolbar-end - Al final de la fila de la barra cuando `toolbarPosition="bottom"` (p. ej. el botón «Enviar»). Siempre montar el hijo.
+ *
  * @part wrapper - Outer container
  * @part toolbar - Formatting toolbar
  * @part content - Editable ProseMirror surface
  * @part label - Field label
  * @part helper - Helper text row
+ * @part toolbar-row - Fila de la barra inferior (`toolbarPosition="bottom"`) con el slot `toolbar-end`.
  */
 export declare class CoRichTextEditor {
     el: HTMLElement;
@@ -19,10 +27,15 @@ export declare class CoRichTextEditor {
     value: string | null;
     /** Preset controlling allowed nodes/marks, toolbar and sanitization. */
     preset: RichTextPreset;
+    /** Texto de ayuda del editor vacío. */
     placeholder: string;
+    /** Etiqueta del campo. */
     label?: string;
+    /** Texto secundario junto a la etiqueta. */
     secondaryLabel?: string;
+    /** Texto de ayuda o de error bajo el editor. */
     helperText?: string;
+    /** Estado de validación: pinta el borde y el `helperText` con el color del estado. */
     status: 'default' | 'error' | 'success' | 'warning' | 'info';
     /** Visual style. `flat` strips the frame's border and background so it
      *  reads as plain content instead of a boxed control — padding, label,
@@ -32,11 +45,17 @@ export declare class CoRichTextEditor {
      *  outer box is gone. `default` (the standard bordered box) renders
      *  identically to before this prop existed. */
     variant: 'default' | 'flat';
+    /** Deshabilita el editor. */
     disabled: boolean;
+    /** Solo lectura: sin barra ni edición; `coChange` sale en el acto (p. ej. al marcar una casilla de task-list). */
     readonly: boolean;
+    /** Campo obligatorio (marca de requerido en la etiqueta). */
     required: boolean;
+    /** Límite de caracteres (sobrescribe el del preset); muestra el contador «n / max». */
     maxLength?: number;
+    /** Muestra el contador de caracteres aunque no haya `maxLength`. */
     showCharacterCount: boolean;
+    /** Enfoca el editor al montarse. */
     autofocus: boolean;
     /** Toolbar layout. `auto` uses the preset default. */
     toolbar: ToolbarVariant;
@@ -100,8 +119,11 @@ export declare class CoRichTextEditor {
     coInput: EventEmitter<RichTextOutput>;
     /** Emitted on blur (committed value). */
     coChange: EventEmitter<RichTextOutput>;
+    /** El editor ganó el foco. */
     coFocus: EventEmitter<void>;
+    /** El editor perdió el foco (lo sigue `coChange`). */
     coBlur: EventEmitter<void>;
+    /** Se vació el contenido con `clear()`. */
     coClear: EventEmitter<void>;
     /** Emitted once the editor is mounted and ready. */
     coReady: EventEmitter<void>;
@@ -160,12 +182,19 @@ export declare class CoRichTextEditor {
     onAccountFontsChange(): void;
     onValueChange(next: string | null): void;
     onEditableChange(): void;
+    /** Documento como JSON de ProseMirror, o `null` si está vacío. */
     getJSON(): Promise<object | null>;
+    /** HTML sanitizado según el preset (`getHtml`, no `getHTML`, para no chocar con `HTMLElement`). */
     getHtml(): Promise<string>;
+    /** Texto plano del documento. */
     getText(): Promise<string>;
+    /** Vacía el contenido y emite `coClear`. */
     clear(): Promise<void>;
+    /** Enfoca el editor (`focusEditor`, no `focus`, para no chocar con `HTMLElement`). */
     focusEditor(): Promise<void>;
+    /** Reemplaza el contenido: HTML (string) o JSON de ProseMirror. */
     setContent(content: string | object): Promise<void>;
+    /** Instancia Tiptap subyacente (escape hatch para control avanzado), o `null` antes de montar. */
     getEditorInstance(): Promise<Editor | null>;
     /** Whether the image node is enabled (mirrors presets.ts `wantImage` logic). */
     private get imagesEnabled();

package/dist/types/components/co-rich-text-toolbar/co-rich-text-toolbar.d.ts

@@ -8,6 +8,8 @@ import type { Editor, ToolbarEntry, ToolbarExtraItem } from '@prolibu-suite/coba
  *
  * @part toolbar - The toolbar container
  * @part button - A toolbar button
+ *
+ * Wrapper Vue: `CoRichTextToolbar` de `@prolibu-suite/cobalt-vue`.
  */
 export declare class CoRichTextToolbar {
     el: HTMLElement;
@@ -18,6 +20,7 @@ export declare class CoRichTextToolbar {
     /** Placement inside co-rich-text-editor. `bottom` drops the toolbar's own bottom
      * border/background/rounding: the editor's toolbar row paints the separator. */
     position: 'top' | 'bottom';
+    /** Deshabilita la barra: sus botones no ejecutan acciones sobre el editor. */
     disabled: boolean;
     /** BCP-47 locale for UI strings (e.g. 'en', 'es-CO', 'pt-BR'). Default English. */
     locale: string;

package/dist/types/components/co-rich-text-viewer/co-rich-text-viewer.d.ts

@@ -1,4 +1,12 @@
 import type { RichTextPreset } from '@prolibu-suite/cobalt-rich-text';
+/**
+ * Visor de solo lectura de contenido rich text (HTML o JSON de ProseMirror),
+ * sanitizado según el `preset`. En `format="html"` no carga Tiptap: solo
+ * DOMPurify. Wrapper Vue: `CoRichTextViewer` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part content - El contenido renderizado.
+ * @part empty - El texto de vacío (`emptyText`) cuando no hay contenido.
+ */
 export declare class CoRichTextViewer {
     /** HTML string (default) or ProseMirror JSON string. */
     value: string | null;

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

@@ -3,6 +3,9 @@
  * @slot prefix  - Leading content (icon, checkbox)
  * @slot         - Main content
  * @slot suffix  - Trailing content (switch, badge, action)
+ *
+ * Wrapper Vue: `CoRow` de `@prolibu-suite/cobalt-vue`.
+ * @part row - La fila.
  */
 export declare class CoRow {
     /** Position in a group — affects border radius */

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;