@prolibu-suite/cobalt-core 0.10.4 → 0.11.1

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

@@ -0,0 +1,26 @@
+/** Aire lateral que se descuenta del lienzo al ajustar al ancho (2 × --co-spacing-lg). */
+export declare const ZOOM_GUTTER_PX = 32;
+/** Escala para que la hoja entre en el ancho disponible: nunca agranda, nunca baja de 25 %. */
+export declare function fitScale(available: number, pageWidth: number): number;
+/** Tope del zoom libre (pinza / ctrl+rueda). El piso es el mismo de «Ajustar al ancho». */
+export declare const ZOOM_MIN = 0.25;
+export declare const ZOOM_MAX = 3;
+/** Acota la escala a [ZOOM_MIN, ZOOM_MAX] y la redondea a milésimas (NaN → 1). */
+export declare function clampScale(scale: number): number;
+/**
+ * Nueva escala para un evento `wheel` con ctrlKey (la pinza del trackpad llega así en Chrome,
+ * Edge y Firefox; también ctrl+rueda del mouse). Exponencial: acercar y alejar el mismo delta
+ * vuelve al punto de partida, y la velocidad se siente igual a cualquier escala.
+ */
+export declare function pinchScale(current: number, deltaY: number): number;
+/**
+ * Punto del papel (px de layout, sin escala) bajo el cursor: `stageStart` es el borde de la hoja
+ * escalada en pantalla (getBoundingClientRect), `scale` la escala que el DOM refleja HOY.
+ */
+export declare function paperPoint(client: number, stageStart: number, scale: number): number;
+/**
+ * Cuánto hay que correr el scroll para que el punto `paper` vuelva a quedar bajo el cursor,
+ * medido DESPUÉS del render con la escala nueva (la hoja está centrada y el lienzo tiene
+ * relleno fijo: predecir la posición falla, medirla no).
+ */
+export declare function anchorCorrection(stageStart: number, paper: number, scale: number, client: number): number;

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

@@ -0,0 +1,77 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+import { type GradientStop, type GradientStopAddDetail, type GradientStopMoveDetail } from '../../utils/gradientStops';
+/**
+ * Barra de paradas de un degradado (popover de relleno del editor): arrastrar
+ * una parada, agregar una con click sobre la barra y seleccionar.
+ *
+ * Contrato de eventos (pensado para el historial de deshacer del host):
+ * - `coStopMove` — continuo, en cada movimiento del arrastre (preview en vivo).
+ * - `coStopsChange` — UNA vez al terminar el gesto (siempre que hubo al menos
+ *   un `coStopMove`, aunque el stop vuelva a su posición inicial: el host cierra
+ *   ahí su transacción) y una vez por cada paso de teclado.
+ * - `coStopSelect` — al hacer pointerdown sobre un handle.
+ * - `coStopAdd` — al hacer click sobre el track fuera de un handle; `color` es
+ *   el interpolado en esa posición.
+ * Con `disabled` no se emite nada.
+ *
+ * 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;
+    /** Paradas del degradado: `position` 0–100, `color` hex/rgba. */
+    stops: GradientStop[];
+    /** Índice de la parada seleccionada (anillo `accent`). Se actualiza al hacer pointerdown en un handle. */
+    selected?: number;
+    /** Deshabilita toda interacción; no se emite ningún evento. */
+    disabled: boolean;
+    /** aria-label del grupo. Vacío = el del `locale`. */
+    label?: string;
+    /** Locale de los strings integrados (es/en/pt). */
+    locale?: string;
+    /** Índice de la parada en arrastre; -1 sin gesto. */
+    dragIndex: number;
+    /** Posición viva de la parada en arrastre. */
+    dragPosition: number;
+    /** `{ index, position }` en cada movimiento del arrastre. */
+    coStopMove: EventEmitter<GradientStopMoveDetail>;
+    /**
+     * Paradas resultantes al soltar (una vez por gesto) o tras cada paso de
+     * teclado. Conserva el ORDEN e ÍNDICES del `stops` del host (solo cambia
+     * `position` de la parada movida): un host que ordene por posición al
+     * confirmar debe remapear `selected` al índice nuevo.
+     */
+    coStopsChange: EventEmitter<GradientStop[]>;
+    /** Índice de la parada al hacer pointerdown sobre su handle. */
+    coStopSelect: EventEmitter<number>;
+    /** `{ position, color }` al hacer click sobre el track fuera de un handle. */
+    coStopAdd: EventEmitter<GradientStopAddDetail>;
+    private trackEl?;
+    private pointerId;
+    /** Desplazamiento entre el puntero y el centro del handle al agarrarlo, para que no salte. */
+    private grabOffset;
+    /** Hubo al menos un `coStopMove` en el gesto → al soltar se emite `coStopsChange`. */
+    private dragMoved;
+    disconnectedCallback(): void;
+    private positionAt;
+    /** `stops` del host; un `undefined` explícito (wrappers React/Vue) cuenta como vacío. */
+    private get stopList();
+    private withPosition;
+    /** Paradas a pintar: las del host, con la que se arrastra en su posición viva. */
+    private liveStops;
+    private handleTrackClick;
+    private handleHandlePointerDown;
+    private handleWindowPointerMove;
+    private handleWindowPointerUp;
+    private endDrag;
+    private bindWindow;
+    private unbindWindow;
+    private handleHandleKeyDown;
+    render(): any;
+}

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,10 +1,27 @@
+/**
+ * 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
+ *         `:active` y el color de `selected` sin trabajo extra; mide lo mismo
+ *         que mediría el `co-icon` de esa talla (o `iconSize`) vía
+ *         `--co-icon-button-glyph-size`. Con `icon` el slot no se monta (DOM
+ *         idéntico al de siempre). El glifo proyectado no aporta nombre
+ *         accesible: pasar `label` siempre.
+ */
 export declare class CoIconButton {
     /**
      * filled = dark background (negro), outlined = light background (blanco + border),
-     * ghost = transparent background, no border, tinted hover (negro-8 on light / blanco-16 on dark).
+     * ghost = transparent background, no border, tinted hover (negro-8 on light / blanco-16 on dark),
+     * soft = fondo gris sólido (--co-color-gray-100), sin borde visible, sin frost.
      * Matches Figma: Secundario → filled, Primario → outlined
      */
-    variant: 'filled' | 'outlined' | 'ghost';
+    variant: 'filled' | 'outlined' | 'ghost' | 'soft';
     /**
      * Surface the button sits on. `dark` → white icon + blanco-16 hover (on-dark theming).
      * Defaults to `light` (no extra class → identical to previous behavior).
@@ -48,5 +65,25 @@ export declare class CoIconButton {
     toggled: boolean;
     /** Icon weight */
     iconWeight: 'regular' | 'thin' | 'light' | 'bold' | 'fill' | 'duotone';
+    /**
+     * Estado de selección (transversal, gana sobre cualquier `variant`): fondo/color
+     * de acento. Reflejado para que `:host([selected])` sea estilable desde afuera y
+     * marca `aria-pressed="true"` en el `<button>` (ausente cuando no está selected,
+     * en vez de "false", para no alterar el árbol de accesibilidad por defecto).
+     */
+    selected: boolean;
+    /**
+     * Ocupa el espacio disponible del contenedor flex (`flex: 1 1 0; min-width: 0`) en
+     * vez del ancho fijo por `size` — para filas de N botones repartidos en el 100%.
+     */
+    fluid: boolean;
+    /**
+     * 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 (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

@@ -4,9 +4,21 @@ import { EventEmitter } from '../../stencil-public-runtime';
  * Supports vertical and horizontal label layouts, action button, and chips.
  *
  * @slot - Default slot for custom content inside the field
+ * @slot prefix - Slot for prefix content (e.g. "$", "https://") rendered right before the native input, inside the input wrapper
  * @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 */
@@ -57,15 +69,23 @@ export declare class CoInput {
     autocomplete?: string;
     /** Validation status */
     status: 'default' | 'error' | 'success' | 'warning' | 'info';
-    /** Size variant: s (28px), sm (32px), md (40px, default), lg (48px).
+    /** Size variant: xs (24px), s (28px), sm (32px), md (40px, default), lg (48px).
      *  In the filled search-pill variant (`fill`) this drives the pill height
      *  instead (s ≈ 38px). */
-    size: 's' | 'sm' | 'md' | 'lg';
+    size: 'xs' | 's' | 'sm' | 'md' | 'lg';
     /** Visual style. `flat` strips the field's border and background so it
      *  reads as plain content instead of a boxed input — padding, label, focus
-     *  ring, disabled and status states are unaffected. `default` (the
-     *  standard bordered box) renders identically to before this prop existed. */
-    variant: 'default' | 'flat';
+     *  ring, disabled and status states are unaffected. `soft` renders a solid
+     *  gray-100 background with a transparent 1px border (same width as
+     *  default, so nothing shifts) and no backdrop-filter — the disabled state
+     *  keeps that gray-100 background and dims the field's content instead.
+     *  `default` (the standard bordered box) renders identically to before
+     *  this prop existed. */
+    variant: 'default' | 'flat' | 'soft';
+    /** Tamaño en px de los íconos `iconLeft`/`iconRight` (pasado al `co-icon`
+     *  interno). Sin este prop, el campo sigue con el tamaño fijo que ya tenía
+     *  (16px) — comportamiento idéntico a antes de esta prop. */
+    iconSize?: number;
     /** Filled search-pill variant. When true the field renders as a minimal gray
      *  pill (background gray-100, no border/box-shadow, 10px radius) with a search
      *  glyph on the left and a plain-`x` clear — the floating label, helper text and

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

@@ -17,17 +17,26 @@ import { EventEmitter } from '../../stencil-public-runtime';
  * @part field - The bordered textarea wrapper
  * @part input - The native textarea
  * @part helper - The helper/error text row
+ *
+ * Wrapper Vue: `CoJsonField` de `@prolibu-suite/cobalt-vue`.
  */
 export declare class CoJsonField {
     el: HTMLElement;
     /** Committed JSON text. */
     value: string;
+    /** Etiqueta del campo. */
     label?: string;
+    /** Placeholder del editor vacío (default `'{ }'`). */
     placeholder: string;
+    /** Atributo `name` del textarea nativo. */
     name?: string;
+    /** Campo obligatorio: marca la etiqueta con el indicador de requerido. */
     required: boolean;
+    /** Deshabilita el campo. */
     disabled: boolean;
+    /** Solo lectura: muestra el JSON sin permitir editarlo. */
     readonly: boolean;
+    /** Alto del editor en líneas (default 8). */
     rows: number;
     /** External validation status (e.g. from a form controller). */
     status: 'default' | 'error' | 'success' | 'warning';
@@ -49,7 +58,9 @@ export declare class CoJsonField {
         valid: boolean;
         message?: string;
     }>;
+    /** El editor ganó el foco. */
     coFocus: EventEmitter<void>;
+    /** El editor perdió el foco (lo sigue `coChange`). */
     coBlur: EventEmitter<void>;
     /** Raw text in the textarea. */
     draft: string;

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

@@ -0,0 +1,50 @@
+/**
+ * co-kbd — grupo de teclas de un atajo (p.ej. "shift+1", "mod+0", "v").
+ * Modificadores como ícono Phosphor en mac, como etiqueta i18n en win;
+ * teclas sueltas como texto en mayúscula. Con `chord`, toda la combinación
+ * va en UN solo chip (sin separadores).
+ *
+ * Usage:
+ *   <co-kbd keys="mod+0" />
+ *   <co-kbd keys="v" surface="dark" size="xs" />
+ *   <co-kbd keys="mod+0" chord />
+ *
+ * Wrapper Vue: `CoKbd` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part group - Contenedor de la combinación (`role="group"`).
+ * @part key - Cada tecla (en `chord`, el único chip).
+ * @part sep - Separador «+» entre teclas (sin `chord`).
+ * @part cell - Cada token dentro del chip de `chord`.
+ */
+export declare class CoKbd {
+    /** Combinación de teclas separadas por "+", p.ej. "shift+1", "mod+0", "v". */
+    keys: string;
+    /**
+     * Plataforma para resolver el render de los modificadores:
+     * `mac` → íconos Phosphor (⌘⇧⌥⌃); `win` → etiquetas de texto (`kbdI18n`).
+     * `auto` detecta por `navigator.platform`/`userAgent`; sin señal de Mac
+     * (p.ej. jsdom en tests) cae a `win`.
+     */
+    platform: 'auto' | 'mac' | 'win';
+    /** Superficie donde se apoya: `light` → fondo gray-100 (texto oscuro);
+     *  `dark` → blanco-16 (texto blanco) — pensado para pills oscuras, p.ej.
+     *  `co-tooltip` variant="label". */
+    surface: 'light' | 'dark';
+    /** Tamaño de cada tecla: `sm` 30×18 (con ícono 12px) · `xs` 16×16 (solo texto/1 char). */
+    size: 'sm' | 'xs';
+    /** Locale BCP-47 (p.ej. "es-CO") para las etiquetas de texto en `win`. Sin
+     *  locale explícito, `kbdI18n` resuelve a 'en'. */
+    locale?: string;
+    /**
+     * Modo acorde: toda la combinación en UN solo chip (`part="key"`; 30×18 en
+     * `sm`, 16 de alto en `xs`), sin separadores "+" — cada token va en una
+     * celda (`part="cell"`) de 12 de alto: ícono Phosphor de 12px en una celda
+     * de 12×12 fija (modificadores en mac); texto en una celda que crece con su
+     * contenido, mínimo 12 (modificadores en win, teclas sueltas). El chip
+     * ensancha con las celdas. `role="group"` y `aria-label` no cambian. Sin
+     * `chord`, el modo de siempre: un chip por tecla + separadores.
+     */
+    chord: boolean;
+    private resolvePlatform;
+    render(): any;
+}

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

@@ -6,6 +6,9 @@ import { EventEmitter } from '../../stencil-public-runtime';
  * primary/secondary actions, or the default slot for fully custom content.
  *
  * @slot - Custom footer content (rendered after the prop buttons).
+ *
+ * Wrapper Vue: `CoListFooter` de `@prolibu-suite/cobalt-vue`.
+ * @part footer - La fila del footer.
  */
 export declare class CoListFooter {
     /** Primary (filled) action label. Omit to hide the primary button. */

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

@@ -4,6 +4,9 @@ import { EventEmitter } from '../../stencil-public-runtime';
  * @slot prefix  - Leading content (icon, checkbox, avatar)
  * @slot         - Main content (default slot)
  * @slot suffix  - Trailing content (icon, badge, action)
+ *
+ * Wrapper Vue: `CoListItem` de `@prolibu-suite/cobalt-vue`.
+ * @part item - La fila.
  */
 export declare class CoListItem {
     /** Primary label */

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

@@ -2,6 +2,11 @@
  * Three-ball Google-style loader. Inline by default; pass `overlay` to fill
  * the nearest positioned ancestor with a backdrop (drop-in replacement for
  * q-inner-loading from V1's SkLoader).
+ * Wrapper Vue: `CoLoader` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part root - Contenedor del loader (o del overlay).
+ * @part balls - Las tres esferas animadas.
+ * @part text - Texto opcional bajo las esferas.
  */
 export declare class CoLoader {
     /** Show the loader. When false the component renders nothing so it doesn't

package/dist/types/components/co-media-thumb/co-media-thumb.d.ts

@@ -4,6 +4,13 @@
  * slot fallback (for a type-icon box) when there is no `src`.
  *
  * @slot - Fallback content shown when `src` is not set (e.g. a type-icon box).
+ *
+ * Wrapper Vue: `CoMediaThumb` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part thumb - La caja de la vista previa.
+ * @part img - La imagen de portada.
+ * @part scrim - Velo oscuro sobre un video.
+ * @part play - Botón de play (`video`).
  */
 export declare class CoMediaThumb {
     /** Image source URL. When set, a cover image is rendered. */