@prolibu-suite/cobalt-core 0.10.4 → 0.11.1

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

@@ -1,4 +1,14 @@
 import { Placement } from '../../utils/positioning';
+/**
+ * Globo de ayuda que aparece al pasar el mouse o enfocar el control envuelto.
+ * Es la forma de rotular un control de solo ícono (en lugar del `title`
+ * nativo), pero no le da nombre accesible: el control lleva el suyo.
+ * `variant="label"` + `shortcut` muestran el atajo con un `co-kbd`. Wrapper Vue:
+ * `CoTooltip` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @slot - El control que dispara el tooltip.
+ * @part panel - El globo.
+ */
 export declare class CoTooltip {
     /** Tooltip text content. */
     content: string;
@@ -22,6 +32,18 @@ export declare class CoTooltip {
      *  must fill its track — e.g. an ellipsised list/table cell — without the
      *  inline-block wrapper shrink-wrapping it. Drives the `:host([block])` CSS. */
     block: boolean;
+    /**
+     * Visual variant. `label` = compact pill for a labeled trigger with an
+     * optional keyboard shortcut (radius `--co-border-radius-xs`, tighter
+     * padding, medium (500) text, `line-height: 1`, no shadow, arrow hidden). The
+     * arrow hide is CSS-only — `arrow`'s own default/behavior is unchanged.
+     */
+    variant: 'default' | 'label';
+    /** Optional keyboard shortcut rendered as a `co-kbd` chip next to `content`
+     *  (dark surface, xs size) — e.g. content "Seleccionar" + shortcut "v". In
+     *  `variant="label"` the chip sits 4px from the pill's right edge
+     *  (`padding-right: 4px`); the default panel keeps its 10px. */
+    shortcut?: string;
     visible: boolean;
     actualPlacement: Placement;
     /** Fase de salida: mantiene el panel montado mientras corre la transición de cierre. */

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

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

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

@@ -0,0 +1,75 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+export type TreeItemSelection = 'none' | 'soft' | 'solid';
+export type TreeItemSize = 's' | 'xs';
+/**
+ * Fila de un árbol (paneles Páginas y Capas del editor). Pensada para
+ * renderizar cientos de filas: UN solo shadow root propio (los iconos son
+ * `co-icon`; las acciones van en light DOM por slot), sin estado interno de
+ * selección/expansión y sin capturar teclado.
+ *
+ * - **Selección**: la decide el consumidor escuchando el `click` NATIVO del
+ *   host (ahí lee `metaKey` / `shiftKey`). Este componente no emite un evento
+ *   propio de selección ni captura Enter/Espacio; el `tabindex` (roving) lo
+ *   pone el consumidor en el host.
+ * - **Expansión**: controlada. El chevron emite `coToggle` con el estado
+ *   pedido (`!expanded`) y detiene la propagación de su `click` para que
+ *   pulsar el chevron no seleccione la fila. `coToggle` burbujea: con filas
+ *   anidadas en el slot por defecto, un listener por fila debe comprobar
+ *   `event.target === event.currentTarget` (o delegar en la raíz del árbol).
+ * - **Solo se corta el `click`** del chevron. `pointerdown` / `mousedown` SÍ
+ *   llegan al host (el chevron solo hace `preventDefault` del mousedown para
+ *   no robar el foco). Un consumidor con dnd-kit debe usar una restricción de
+ *   activación (`activationConstraint: { distance }`) o descartar el gesto
+ *   cuando `event.composedPath()` incluya el `[part="caret"]`.
+ * - **Hijos**: las filas hijas van en el slot por defecto. Con
+ *   `expandable && expanded` y contenido en ese slot, la fila padre lleva
+ *   radio solo arriba y el bloque de hijos pinta `--co-tree-item-group-bg`.
+ * - **Alineación con hermanos sin chevron**: por defecto una fila no
+ *   expandable no reserva el hueco del chevron. En un árbol mixto (Capas) se
+ *   reserva con `--co-tree-item-caret-space: 12px` en el contenedor.
+ *
+ * @slot prefix - Contenido antes del icono (p. ej. tirador de arrastre).
+ * @slot label  - Reemplaza el texto del `label` (input de renombrar en light DOM).
+ * @slot suffix - Acciones a la derecha (candado, ojo…), gap 8.
+ * @slot        - Filas hijas (`co-tree-item` anidados), envueltas en `part="children"`.
+ *
+ * @part row      - La fila (padding por `depth`, fondo de hover/selección).
+ * @part caret    - Botón del chevron.
+ * @part icon     - Contenedor del icono de tipo.
+ * @part label    - Texto del label.
+ * @part suffix   - Contenedor de las acciones.
+ * @part children - Bloque de filas hijas (`role="group"`).
+ *
+ * Wrapper Vue: `CoTreeItem` de `@prolibu-suite/cobalt-vue`.
+ */
+export declare class CoTreeItem {
+    el: HTMLElement;
+    /** Texto de la fila (se reemplaza con el slot `label`). */
+    label: string;
+    /** Icono de tipo (nombre Phosphor), 12 px. */
+    icon?: string;
+    /** Profundidad en el árbol (0 = raíz). Sangría: `8px + depth × --co-tree-item-indent`. */
+    depth: number;
+    /** Muestra el chevron y expone `aria-expanded`. */
+    expandable: boolean;
+    /** Estado de expansión (controlado: el componente nunca lo muta). */
+    expanded: boolean;
+    /** `solid` = accent (fila seleccionada); `soft` = tinte (descendiente de una selección). */
+    selection: TreeItemSelection;
+    /** Alto de fila: `s` = 28 px (default), `xs` = 24 px. */
+    size: TreeItemSize;
+    /** Atenúa la fila y desactiva el chevron. El click del host sigue llegando al consumidor. */
+    disabled: boolean;
+    /** Idioma del aria-label del chevron (es/en/pt; acepta locales completos). */
+    locale: string;
+    /** Al pulsar el chevron, con el estado de expansión PEDIDO (`!expanded`). */
+    coToggle: EventEmitter<boolean>;
+    /** Hay contenido real en el slot por defecto (filas hijas). */
+    private hasChildren;
+    componentWillLoad(): void;
+    componentWillRender(): void;
+    private syncHasChildren;
+    private handleCaretClick;
+    private handleCaretMouseDown;
+    render(): any;
+}

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

@@ -0,0 +1,6 @@
+export interface TreeItemStrings {
+    expand: string;
+    collapse: string;
+}
+/** Resuelve los strings integrados para un locale (`es`, `en-US`, `pt-BR`…). */
+export declare function getTreeItemStrings(locale?: string): TreeItemStrings;

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

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