@prolibu-suite/cobalt-core 0.10.4 → 0.11.1

package/dist/collection/components/co-tree-item/co-tree-item.js

@@ -0,0 +1,355 @@
+import { Host, h } from "@stencil/core";
+import { getTreeItemStrings } from "./treeItemI18n";
+/**
+ * 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 class CoTreeItem {
+    constructor() {
+        /** Texto de la fila (se reemplaza con el slot `label`). */
+        this.label = '';
+        /** Profundidad en el árbol (0 = raíz). Sangría: `8px + depth × --co-tree-item-indent`. */
+        this.depth = 0;
+        /** Muestra el chevron y expone `aria-expanded`. */
+        this.expandable = false;
+        /** Estado de expansión (controlado: el componente nunca lo muta). */
+        this.expanded = false;
+        /** `solid` = accent (fila seleccionada); `soft` = tinte (descendiente de una selección). */
+        this.selection = 'none';
+        /** Alto de fila: `s` = 28 px (default), `xs` = 24 px. */
+        this.size = 's';
+        /** Atenúa la fila y desactiva el chevron. El click del host sigue llegando al consumidor. */
+        this.disabled = false;
+        /** Idioma del aria-label del chevron (es/en/pt; acepta locales completos). */
+        this.locale = 'es';
+        /** Hay contenido real en el slot por defecto (filas hijas). */
+        this.hasChildren = false;
+        // Cambios SOLO de light DOM (el consumidor monta/desmonta hijos sin tocar
+        // props) no re-renderizan: los atrapa el `slotchange` del slot por defecto.
+        this.syncHasChildren = () => {
+            const has = Array.from(this.el.childNodes).some((n) => {
+                var _a;
+                return (n.nodeType === 1 && !n.hasAttribute('slot')) ||
+                    (n.nodeType === 3 && !!((_a = n.textContent) === null || _a === void 0 ? void 0 : _a.trim()));
+            });
+            if (has !== this.hasChildren)
+                this.hasChildren = has;
+        };
+        // El chevron nunca selecciona: corta el `click` antes de que llegue al host
+        // (donde el consumidor escucha la selección). Con `disabled` tampoco emite.
+        // No se usa el `disabled` nativo del <button>: Chrome se traga el click
+        // entero y Firefox lo deja llegar a los ancestros — gatearlo acá es
+        // determinista en todos los navegadores.
+        this.handleCaretClick = (event) => {
+            event.stopPropagation();
+            if (this.disabled)
+                return;
+            this.coToggle.emit(!this.expanded);
+        };
+        // Pulsar el chevron no mueve el foco al botón del shadow: el foco (roving
+        // tabindex) sigue en el host, `:host(:focus-visible)` sigue matcheando y
+        // Enter/Espacio nunca caen en el botón (evitaría un click nativo → coToggle
+        // duplicado con el keydown del consumidor). Solo preventDefault: el
+        // mousedown/pointerdown SÍ siguen llegando al host (dnd-kit).
+        this.handleCaretMouseDown = (event) => {
+            event.preventDefault();
+        };
+    }
+    componentWillLoad() {
+        this.syncHasChildren();
+    }
+    // Un cambio de props re-renderiza; se re-mide aquí (síncrono, sin render
+    // extra) igual que hace co-accordion con su slot `subheading`.
+    componentWillRender() {
+        this.syncHasChildren();
+    }
+    render() {
+        var _a, _b, _c, _d;
+        // Defaults coalescidos: un consumidor React puede asignar `undefined`
+        // explícito (`depth={maybe}`) y Stencil no reaplica el default de clase.
+        const depth = (_a = this.depth) !== null && _a !== void 0 ? _a : 0;
+        const size = (_b = this.size) !== null && _b !== void 0 ? _b : 's';
+        const selection = (_c = this.selection) !== null && _c !== void 0 ? _c : 'none';
+        const expandable = !!this.expandable;
+        const expanded = expandable && !!this.expanded;
+        const isGroup = expanded && this.hasChildren;
+        const strings = getTreeItemStrings((_d = this.locale) !== null && _d !== void 0 ? _d : 'es');
+        return (h(Host, { key: '09547858bbf035d5b70b95bdf480a58378532ae3', role: "treeitem", "aria-level": String(depth + 1), "aria-expanded": expandable ? (expanded ? 'true' : 'false') : undefined, "aria-selected": selection !== 'none' ? 'true' : 'false', "aria-disabled": this.disabled ? 'true' : undefined }, h("div", { key: '1c720c317936faa2b01c6cdab61d339d4a3d40f0', class: {
+                'co-tree-item': true,
+                'co-tree-item--xs': size === 'xs',
+                'co-tree-item--soft': selection === 'soft',
+                'co-tree-item--solid': selection === 'solid',
+                'co-tree-item--expanded': expanded,
+                'co-tree-item--group': isGroup,
+                'co-tree-item--disabled': !!this.disabled,
+            } }, h("div", { key: 'e20c131f702d8de43901f12963da75949e3a9e6e', class: "co-tree-item__row", part: "row", style: { paddingLeft: `calc(8px + ${depth} * var(--co-tree-item-indent, 24px))` } }, expandable ? (h("button", { type: "button", class: "co-tree-item__caret", part: "caret", tabindex: "-1", "aria-label": expanded ? strings.collapse : strings.expand, "aria-disabled": this.disabled ? 'true' : undefined, onMouseDown: this.handleCaretMouseDown, onClick: this.handleCaretClick }, h("co-icon", { name: expanded ? 'caret-down' : 'caret-right', size: 8, weight: "fill" }))) : (h("span", { class: "co-tree-item__caret-space", "aria-hidden": "true" })), h("slot", { key: '313110e0f4b6b3d81faf1ecd63a56d40ebadc40f', name: "prefix" }), this.icon && (h("span", { key: 'e099db0908ccce9bea71fff6c58081126308277a', class: "co-tree-item__icon", part: "icon" }, h("co-icon", { key: '0ca917bbfcb13285d364b5b6c07ba52165df7c0b', name: this.icon, size: 12 }))), h("span", { key: '48d8b98d0af58627c6510a57b8d3a05c1c58452f', class: "co-tree-item__label", part: "label" }, h("slot", { key: 'a8c7dcfae8c5e4d7f2782b81d96a2f2924dc889c', name: "label" }, this.label)), h("span", { key: '8221cd9578dc226545e86e588d5e60fa75cd06f5', class: "co-tree-item__suffix", part: "suffix" }, h("slot", { key: '256ca2c9cc0b7f6249be0dd23b4dc14def735db9', name: "suffix" }))), h("div", { key: '246a9968d7443f2e9ab4cc37669861a6a89de546', class: "co-tree-item__children", part: "children", role: "group" }, h("slot", { key: '4726dadaf4b78766eea244866c97a2664e35c93c', onSlotchange: this.syncHasChildren })))));
+    }
+    static get is() { return "co-tree-item"; }
+    static get encapsulation() { return "shadow"; }
+    static get originalStyleUrls() {
+        return {
+            "$": ["co-tree-item.css"]
+        };
+    }
+    static get styleUrls() {
+        return {
+            "$": ["co-tree-item.css"]
+        };
+    }
+    static get properties() {
+        return {
+            "label": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Texto de la fila (se reemplaza con el slot `label`)."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "label",
+                "defaultValue": "''"
+            },
+            "icon": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string | undefined",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Icono de tipo (nombre Phosphor), 12 px."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "icon"
+            },
+            "depth": {
+                "type": "number",
+                "mutable": false,
+                "complexType": {
+                    "original": "number",
+                    "resolved": "number",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Profundidad en el \u00E1rbol (0 = ra\u00EDz). Sangr\u00EDa: `8px + depth \u00D7 --co-tree-item-indent`."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "depth",
+                "defaultValue": "0"
+            },
+            "expandable": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Muestra el chevron y expone `aria-expanded`."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true,
+                "attribute": "expandable",
+                "defaultValue": "false"
+            },
+            "expanded": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Estado de expansi\u00F3n (controlado: el componente nunca lo muta)."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true,
+                "attribute": "expanded",
+                "defaultValue": "false"
+            },
+            "selection": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "TreeItemSelection",
+                    "resolved": "\"none\" | \"soft\" | \"solid\"",
+                    "references": {
+                        "TreeItemSelection": {
+                            "location": "local",
+                            "path": "/Users/agox/worktrees/cobalt-docs-2026-09-24/packages/core/src/components/co-tree-item/co-tree-item.tsx",
+                            "id": "src/components/co-tree-item/co-tree-item.tsx::TreeItemSelection"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "`solid` = accent (fila seleccionada); `soft` = tinte (descendiente de una selecci\u00F3n)."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true,
+                "attribute": "selection",
+                "defaultValue": "'none'"
+            },
+            "size": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "TreeItemSize",
+                    "resolved": "\"s\" | \"xs\"",
+                    "references": {
+                        "TreeItemSize": {
+                            "location": "local",
+                            "path": "/Users/agox/worktrees/cobalt-docs-2026-09-24/packages/core/src/components/co-tree-item/co-tree-item.tsx",
+                            "id": "src/components/co-tree-item/co-tree-item.tsx::TreeItemSize"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Alto de fila: `s` = 28 px (default), `xs` = 24 px."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true,
+                "attribute": "size",
+                "defaultValue": "'s'"
+            },
+            "disabled": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Aten\u00FAa la fila y desactiva el chevron. El click del host sigue llegando al consumidor."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true,
+                "attribute": "disabled",
+                "defaultValue": "false"
+            },
+            "locale": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Idioma del aria-label del chevron (es/en/pt; acepta locales completos)."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "locale",
+                "defaultValue": "'es'"
+            }
+        };
+    }
+    static get states() {
+        return {
+            "hasChildren": {}
+        };
+    }
+    static get events() {
+        return [{
+                "method": "coToggle",
+                "name": "coToggle",
+                "bubbles": true,
+                "cancelable": true,
+                "composed": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Al pulsar el chevron, con el estado de expansi\u00F3n PEDIDO (`!expanded`)."
+                },
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                }
+            }];
+    }
+    static get elementRef() { return "el"; }
+}

package/dist/collection/components/co-tree-item/treeItemI18n.js

@@ -0,0 +1,16 @@
+/**
+ * Diccionario de strings de UI de co-tree-item (aria-label del chevron).
+ * Misma estrategia que carouselI18n / lightboxI18n: es/en/pt resueltos por la
+ * prop `locale`. Vive junto al componente (como `co-icon/iconLoader.ts`) para
+ * que la task no toque archivos compartidos fuera de `co-tree-item/*`.
+ */
+import { langFromLocale } from "../../utils/dateI18n";
+const DICT = {
+    es: { expand: 'Expandir', collapse: 'Contraer' },
+    en: { expand: 'Expand', collapse: 'Collapse' },
+    pt: { expand: 'Expandir', collapse: 'Recolher' },
+};
+/** Resuelve los strings integrados para un locale (`es`, `en-US`, `pt-BR`…). */
+export function getTreeItemStrings(locale) {
+    return DICT[langFromLocale(locale)];
+}

package/dist/collection/components/co-video/co-video.css

@@ -2,6 +2,17 @@
    co-video
    ═══════════════════════════════════════════════════ */
 
+/**
+ * Tienen su default en `:host`; se sobrescriben desde afuera sobre el elemento
+ * (`co-video { --co-video-accent: … }`), que le gana a la regla `:host`.
+ * @prop --co-video-accent: Color del progreso reproducido, del thumb y de los controles activos (default blanco).
+ * @prop --co-video-buffered: Color de la porción cargada de la barra de progreso.
+ * @prop --co-video-controls-bg: Fondo de la barra de controles (default degradado a negro).
+ * @prop --co-video-controls-color: Color de íconos y textos de los controles (default blanco).
+ * @prop --co-video-btn-hover: Fondo de un botón de control en hover.
+ * @prop --co-video-progress-height: Alto de la barra de progreso en reposo (default 4px).
+ * @prop --co-video-progress-height-hover: Alto de la barra de progreso en hover (default 8px).
+ */
 :host {
   display: block;
   font-family: var(--co-font-family-primary);

package/dist/collection/components/co-video/co-video.js

@@ -79,8 +79,19 @@ const ERROR_MESSAGES = {
 };
 /**
  * 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 class CoVideo {
     constructor() {
@@ -635,14 +646,17 @@ export class CoVideo {
     // ═══════════════════════════════════════════════════
     // PUBLIC METHODS
     // ═══════════════════════════════════════════════════
+    /** Inicia la reproducción (puede rechazarse si el navegador bloquea el autoplay con sonido). */
     async play() {
         var _a;
         await ((_a = this.videoEl) === null || _a === void 0 ? void 0 : _a.play());
     }
+    /** Pausa la reproducción. */
     async pause() {
         var _a;
         (_a = this.videoEl) === null || _a === void 0 ? void 0 : _a.pause();
     }
+    /** Alterna entre reproducir y pausar. */
     async togglePlay() {
         var _a, _b;
         if (this.isPlaying) {
@@ -652,11 +666,13 @@ export class CoVideo {
             await ((_b = this.videoEl) === null || _b === void 0 ? void 0 : _b.play());
         }
     }
+    /** Salta a `time` (segundos). */
     async seek(time) {
         if (this.videoEl) {
             this.videoEl.currentTime = time;
         }
     }
+    /** Fija el volumen (0–1; se recorta a ese rango). */
     async setVolume(level) {
         const clamped = Math.max(0, Math.min(1, level));
         this.volume = clamped;
@@ -664,12 +680,15 @@ export class CoVideo {
             this.videoEl.volume = clamped;
         this.volumeLevel = clamped;
     }
+    /** Alterna el silencio (igual que el botón de volumen). */
     async toggleMute() {
         this.handleMuteClick();
     }
+    /** Entra o sale de pantalla completa. */
     async toggleFullscreen() {
         this.handleFullscreenClick();
     }
+    /** Entra o sale de Picture-in-Picture (si el navegador lo soporta). */
     async togglePip() {
         this.handlePipClick();
     }
@@ -814,14 +833,14 @@ export class CoVideo {
     // ═══════════════════════════════════════════════════
     render() {
         const aspectClass = `co-video--${this.aspectRatio.replace(':', '-')}`;
-        return (h(Host, { key: '7547fe3cb220159ae7cb0d9bb890348ac8a62264' }, h("div", { key: 'efb33e16e1ce3f8312de4532528f217bcfd619be', class: {
+        return (h(Host, { key: 'd2f25697003337a41f2c6ac1f8b52b82c8341731' }, h("div", { key: 'b656b85d82072035f31358820db8c61a2db4cbbc', class: {
                 'co-video': true,
                 [aspectClass]: true,
                 [`co-video--rounded-${this.rounded}`]: true,
                 'co-video--disabled': this.disabled,
                 'co-video--fullscreen': this.isFullscreen,
                 'co-video--playing': this.isPlaying,
-            }, part: "container", ref: el => (this.containerEl = el), role: "region", "aria-label": this.t.player, tabindex: 0, onKeyDown: this.handleKeyDown, onMouseMove: this.handleContainerMouseMove, onMouseLeave: this.handleContainerMouseLeave, onTouchStart: this.handleContainerTouchStart }, h("video", { key: '14bf786bae4288e2eeb8171893bec70cb3dd0fc8', ref: el => (this.videoEl = el), class: "co-video__native", part: "video", src: this.src || undefined, poster: undefined, preload: this.preload, loop: this.loop, playsinline: true, tabindex: -1, controlsList: this.allowDownload ? undefined : 'nodownload' }), this.renderPoster(), this.renderLoader(), this.renderBigPlayButton(), this.renderError(), h("div", { key: '2e8b0cc3e3dbbb63aaebb44510ba43785de04fd4', class: "co-video__click-area", onClick: this.handleVideoAreaClick }), this.renderControls())));
+            }, part: "container", ref: el => (this.containerEl = el), role: "region", "aria-label": this.t.player, tabindex: 0, onKeyDown: this.handleKeyDown, onMouseMove: this.handleContainerMouseMove, onMouseLeave: this.handleContainerMouseLeave, onTouchStart: this.handleContainerTouchStart }, h("video", { key: '960e58a18058da5840fdbbdaf32a01afd1db06f9', ref: el => (this.videoEl = el), class: "co-video__native", part: "video", src: this.src || undefined, poster: undefined, preload: this.preload, loop: this.loop, playsinline: true, tabindex: -1, controlsList: this.allowDownload ? undefined : 'nodownload' }), this.renderPoster(), this.renderLoader(), this.renderBigPlayButton(), this.renderError(), h("div", { key: '4a772011fe579f90d3befe3ad925026835cece73', class: "co-video__click-area", onClick: this.handleVideoAreaClick }), this.renderControls())));
     }
     static get is() { return "co-video"; }
     static get encapsulation() { return "shadow"; }
@@ -1435,7 +1454,7 @@ export class CoVideo {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Empez\u00F3 o se reanud\u00F3 la reproducci\u00F3n."
                 },
                 "complexType": {
                     "original": "void",
@@ -1450,7 +1469,7 @@ export class CoVideo {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Se paus\u00F3 la reproducci\u00F3n."
                 },
                 "complexType": {
                     "original": "void",
@@ -1465,7 +1484,7 @@ export class CoVideo {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Termin\u00F3 el video (sin `loop`)."
                 },
                 "complexType": {
                     "original": "void",
@@ -1495,7 +1514,7 @@ export class CoVideo {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Error del medio: `detail` = `{ code, message }` (c\u00F3digo de `MediaError` y mensaje traducido seg\u00FAn `locale`)."
                 },
                 "complexType": {
                     "original": "{ code: number; message: string }",
@@ -1510,7 +1529,7 @@ export class CoVideo {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Avance de la reproducci\u00F3n, como mucho cada 250 ms: `{ currentTime, duration, progressPercent }` (segundos y 0\u2013100). No burbujea."
                 },
                 "complexType": {
                     "original": "{ currentTime: number; duration: number; progressPercent: number }",
@@ -1525,7 +1544,7 @@ export class CoVideo {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Termin\u00F3 un salto en la barra de progreso: `{ from, to }` en segundos."
                 },
                 "complexType": {
                     "original": "{ from: number; to: number }",
@@ -1540,7 +1559,7 @@ export class CoVideo {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Cambi\u00F3 el volumen o el silencio: `{ volume, muted }` (volumen 0\u20131)."
                 },
                 "complexType": {
                     "original": "{ volume: number; muted: boolean }",
@@ -1555,7 +1574,7 @@ export class CoVideo {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Entr\u00F3 o sali\u00F3 de pantalla completa: `{ fullscreen }`."
                 },
                 "complexType": {
                     "original": "{ fullscreen: boolean }",
@@ -1570,7 +1589,7 @@ export class CoVideo {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Cambi\u00F3 la velocidad desde el selector: `{ rate }`."
                 },
                 "complexType": {
                     "original": "{ rate: number }",
@@ -1585,7 +1604,7 @@ export class CoVideo {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Entr\u00F3 o sali\u00F3 de Picture-in-Picture: `{ pip }`."
                 },
                 "complexType": {
                     "original": "{ pip: boolean }",
@@ -1600,7 +1619,7 @@ export class CoVideo {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Click en descargar (con `allowDownload`), justo antes de iniciar la descarga: `{ src }`."
                 },
                 "complexType": {
                     "original": "{ src: string }",
@@ -1615,7 +1634,7 @@ export class CoVideo {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Se alcanz\u00F3 el `watchThreshold` (una sola vez por video): `{ threshold, currentTime, duration }`. \u00DAtil para marcar un video como visto."
                 },
                 "complexType": {
                     "original": "{ threshold: number; currentTime: number; duration: number }",
@@ -1639,7 +1658,7 @@ export class CoVideo {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "",
+                    "text": "Inicia la reproducci\u00F3n (puede rechazarse si el navegador bloquea el autoplay con sonido).",
                     "tags": []
                 }
             },
@@ -1656,7 +1675,7 @@ export class CoVideo {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "",
+                    "text": "Pausa la reproducci\u00F3n.",
                     "tags": []
                 }
             },
@@ -1673,7 +1692,7 @@ export class CoVideo {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "",
+                    "text": "Alterna entre reproducir y pausar.",
                     "tags": []
                 }
             },
@@ -1694,7 +1713,7 @@ export class CoVideo {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "",
+                    "text": "Salta a `time` (segundos).",
                     "tags": []
                 }
             },
@@ -1715,7 +1734,7 @@ export class CoVideo {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "",
+                    "text": "Fija el volumen (0\u20131; se recorta a ese rango).",
                     "tags": []
                 }
             },
@@ -1732,7 +1751,7 @@ export class CoVideo {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "",
+                    "text": "Alterna el silencio (igual que el bot\u00F3n de volumen).",
                     "tags": []
                 }
             },
@@ -1749,7 +1768,7 @@ export class CoVideo {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "",
+                    "text": "Entra o sale de pantalla completa.",
                     "tags": []
                 }
             },
@@ -1766,7 +1785,7 @@ export class CoVideo {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "",
+                    "text": "Entra o sale de Picture-in-Picture (si el navegador lo soporta).",
                     "tags": []
                 }
             }