@prolibu-suite/cobalt-core 0.11.0 → 0.11.2

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 */

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

@@ -8,6 +8,13 @@
  *   <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". */

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. */

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

@@ -53,17 +53,18 @@ export declare class CoMenu {
      *  de siempre, así que sin `surface="dark"` no cambia nada. */
     surface: 'light' | 'dark';
     /** Elemento (o selector resuelto contra `document`) al que se alinea el
-     *  panel EN VEZ del trigger (Task C10, Fase 2 Cobalt — fix round 1).
+     *  panel EN VEZ del trigger.
      *  Reenviada tal cual al `co-popover` interno; sin `anchor`, cae al
      *  trigger (comportamiento de siempre). Útil para alinear el menú contra
      *  un contenedor más grande que el botón que lo abre (p.ej. la píldora del
      *  zoom del toolbar). */
     anchor?: HTMLElement | string;
-    /** Desplazamiento en px sobre el eje CRUZADO del `placement` (Task C10,
-     *  Fase 2 Cobalt — fix round 1). Reenviada tal cual al `co-popover`
-     *  interno. Default `0` = sin cambio. */
+    /** Desplazamiento en px sobre el eje CRUZADO del `placement`. Reenviada tal
+     *  cual al `co-popover` interno. Default `0` = sin cambio. */
     shift: number;
+    /** Se abrió el menú (toma el foco y el teclado). No burbujea. */
     coOpen: EventEmitter<void>;
+    /** Se cerró el menú (Escape, click afuera o selección con `autoClose`). No burbujea. */
     coClose: EventEmitter<void>;
     el: HTMLElement;
     /** Auto-close on leaf-item selection. Bubbled by `co-menu-item` when it has
@@ -72,6 +73,7 @@ export declare class CoMenu {
     onOpenChange(isOpen: boolean): void;
     componentDidLoad(): void;
     disconnectedCallback(): void;
+    /** Enfoca la primera fila del panel raíz (lo hace solo al abrir). */
     focusFirstItem(): Promise<void>;
     /** Walk the LIGHT DOM children for `<co-menu-item>` rows in document order.
      *  Returns the focusable inner buttons via `.focus()`-able interface — we

package/dist/types/components/co-menu-divider/co-menu-divider.d.ts

@@ -1,6 +1,7 @@
 /**
  * Thin horizontal separator between groups of `co-menu-item` rows. Renders an
  * accessible `<hr>` with `role="separator"`.
+ * Wrapper Vue: `CoMenuDivider` de `@prolibu-suite/cobalt-vue`.
  */
 export declare class CoMenuDivider {
     render(): any;

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

@@ -13,6 +13,8 @@ import type { Placement } from '../../utils/positioning';
  *      `coSelect` — only the leaf items inside do.
  *
  * Submenu nesting is unbounded — submenu items can themselves have submenus.
+ *
+ * Wrapper Vue: `CoMenuItem` de `@prolibu-suite/cobalt-vue`.
  */
 export declare class CoMenuItem {
     /** Icon name (Phosphor) rendered before the label. Optional — rows may be

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

@@ -1,16 +1,29 @@
 import { EventEmitter } from '../../stencil-public-runtime';
 /**
+ * Ventana modal con header (título, descripción, ✕), cuerpo y footer de
+ * acciones, sobre un scrim que bloquea la página (`co-overlay`). Es
+ * controlada: la ✕, el scrim y Escape solo emiten `coClose`; quien la usa pone
+ * `open` en `false`. Wrapper Vue: `CoModal` de `@prolibu-suite/cobalt-vue`.
+ *
  * @slot        - Modal body content
  * @slot header-leading - Control before the heading (e.g. a back arrow on a
  *                        second screen of the same modal)
  * @slot header-actions - Controls at the right end of the header (e.g. a settings
  *                        icon-button), before the close button
  * @slot footer - Footer with action buttons
- * @part modal | header | header-text | heading | description | body | footer -
- *       layout/typography hooks for a consumer that must match a specific spec
- *       (paddings, heading weight); colors stay on semantic tokens
+ *
+ * Los parts son ganchos de layout y tipografía (paddings, peso del título) para
+ * ajustar a una spec puntual; los colores siguen en tokens semánticos.
+ * @part modal - Panel del modal (superficie, radio y sombra).
+ * @part header - Header completo; con `movable` es la zona de arrastre.
+ * @part header-text - Contenedor del título y la descripción.
+ * @part heading - Título (`heading`).
+ * @part description - Descripción bajo el título.
+ * @part body - Cuerpo (slot por defecto).
+ * @part footer - Footer de acciones (slot `footer`).
  */
 export declare class CoModal {
+    el: HTMLElement;
     /** Whether the modal is visible */
     open: boolean;
     /** Modal title */
@@ -32,8 +45,8 @@ export declare class CoModal {
      */
     closeOnEscape: boolean;
     /**
-     * Modal width: xs (369px, vía `--co-modal-width` — Task C12, paneles
-     * anclados como "Tipografía y color"), sm (400px), md (540px), lg (680px),
+     * Modal width: xs (369px, vía `--co-modal-width` — paneles anclados como
+     * "Tipografía y color"), sm (400px), md (540px), lg (680px),
      * full (min(1400px, 95vw) × 92vh — media/document viewers).
      *
      * `full` also drops the body padding and lets the body grow, so a slotted
@@ -47,12 +60,12 @@ export declare class CoModal {
      *  under the heading (Figma modals whose first row is a segmented control). */
     headerDivider: boolean;
     /**
-     * Visual treatment (Task C12). `default` = superficie squircle actual
+     * Visual treatment. `default` = superficie squircle actual
      * (radio `--co-modal-r`, sombra que sigue la silueta). `panel` = superficie
      * plana (radio 12, borde `--co-semantic-border-subtle`, `--co-shadow-lg`),
      * SIN máscara squircle — look de panel anclado, no de diálogo centrado.
      *
-     * `dialog` (Task M1) = la anatomía del componente "Modal" del design system
+     * `dialog` = la anatomía del componente "Modal" del design system
      * (Figma Prolibu UI Suite, nodo `1179:37247`): superficie plana radio 16
      * (`--co-border-radius-lg`) sin borde ni sombra propios, título 22/500 y
      * cuerpo 16/1.5 `text-secondary` sin divisor entre ambos, padding 32
@@ -62,7 +75,7 @@ export declare class CoModal {
      */
     appearance: 'default' | 'panel' | 'dialog';
     /**
-     * Control del scrim (Task C12). `none` = sin fondo oscuro y sin cierre por
+     * Control del scrim. `none` = sin fondo oscuro y sin cierre por
      * clic afuera — independiente de `closeOnOverlay` (que solo aplica cuando
      * SÍ hay scrim). `co-overlay` es quien posee el único `<div>` de scrim del
      * árbol, así que `none` implica no montar `<co-overlay>` (ver `inline`).
@@ -70,21 +83,21 @@ export declare class CoModal {
     backdrop: 'default' | 'none';
     /**
      * Renderiza en `position: fixed` con su propio `--co-modal-z-index` en vez
-     * de promoverse al TOP LAYER del browser (Task C12). `co-overlay` promueve
+     * de promoverse al TOP LAYER del browser. `co-overlay` promueve
      * su scrim al top layer vía Popover API (`showPopover()`); el top layer
      * SIEMPRE pinta por encima de cualquier `z-index` normal, así que un
      * portal propio del consumidor (selector de fuente/color del editor) con
      * z-index alto quedaría igual TAPADO detrás del modal. `inline` evita eso.
      *
      * `co-overlay` es también quien posee la promoción a top layer — no hay
-     * forma de pedirle "no te promuevas" sin tocar ese componente (fuera de
-     * alcance de esta task), así que, igual que `backdrop="none"`, `inline`
+     * forma de pedirle "no te promuevas" sin tocar ese componente, así que,
+     * igual que `backdrop="none"`, `inline`
      * implica no montar `<co-overlay>`: el panel pasa a posicionarse y apilarse
      * solo (`.co-modal__frame--standalone`, ver co-modal.css).
      */
     inline: boolean;
     /**
-     * Opt-in: el modal se MUEVE arrastrando su header (Task D1). Default false →
+     * Opt-in: el modal se MUEVE arrastrando su header. Default false →
      * los consumidores actuales quedan byte-idénticos (ni DOM ni CSS cambian).
      *
      * Con `movable`, el `part="header"` entero es la zona de agarre (`cursor:
@@ -99,6 +112,19 @@ export declare class CoModal {
      * mismo nombre taparía `HTMLElement.draggable` con dos semánticas encimadas.
      */
     movable: boolean;
+    /**
+     * Opt-in: trampa de foco accesible (QA 2026-09-24, «Generar contrato»). Con
+     * `true`, al abrir el foco ENTRA al modal (el primer `[autofocus]`; si no
+     * hay, el primer control), Tab / Shift+Tab ciclan adentro y al cerrar vuelve
+     * a donde estaba. El recorrido es compuesto: ve el contenido proyectado por
+     * los slots y el `<button>` interno de cada co-button. Default false → los
+     * consumidores actuales no cambian.
+     *
+     * La trampa es de `<co-overlay>`, así que sin overlay (`inline` o
+     * `backdrop="none"`) NO aplica: esos modos son paneles no bloqueantes y la
+     * página de atrás sigue operable.
+     */
+    trapFocus: boolean;
     /** Verdadero cuando NO corresponde montar `<co-overlay>` — ver doc de
      *  `backdrop` e `inline` arriba: ambas comparten el mismo mecanismo porque
      *  co-overlay es la única superficie dueña del scrim Y del top layer. */
@@ -122,6 +148,15 @@ export declare class CoModal {
      *  eso se monta condicionado a `usesOverlay` — ver `render()`. */
     private stopPropagation;
     handleKeydown(e: KeyboardEvent): void;
+    /**
+     * Re-promueve el modal al TOPE del top layer (QA 2026-09-24, «Generar
+     * contrato»): un drawer que se abre DESPUÉS del modal (cambio de URL,
+     * historial) pinta encima, porque en el top layer gana el último promovido.
+     * Delega en su `<co-overlay>`: sin cerrar el modal, sin eventos (`coClose` /
+     * `coAfterClose` / `coAfterOpen`), sin soltar el scroll lock y sin re-animar
+     * la entrada. No-op sin overlay (`inline`, `backdrop="none"`) o cerrado.
+     */
+    bringToFront(): Promise<void>;
     private handleTransitionEnd;
     /** Gesto en curso: pinta el cursor `grabbing` (única razón para re-render). */
     dragging: boolean;