@prolibu-suite/cobalt-core 0.11.0 → 0.11.2

package/dist/collection/components/co-avatar-group/co-avatar-group.js

@@ -12,6 +12,11 @@ const FONT_SIZE_MAP = {
     xs: 'var(--co-font-size-12)',
     xxs: 'var(--co-font-size-10)',
 };
+/**
+ * Pila de avatares superpuestos con un «+N» para los que no entran (`max`).
+ * `items` describe cada avatar (tipo, texto, imagen, color). Wrapper Vue:
+ * `CoAvatarGroup` de `@prolibu-suite/cobalt-vue`.
+ */
 export class CoAvatarGroup {
     constructor() {
         /** Avatar descriptors rendered as an overlapping stack. */
@@ -56,13 +61,13 @@ export class CoAvatarGroup {
                 onClick: this.activate,
             }
             : { role: 'group' };
-        return (h(Tag, Object.assign({ key: 'efe3aa5c3a13c33d220caf93f8ce7dfc929f9833', class: {
+        return (h(Tag, Object.assign({ key: '7e14b71d5b7391c15fcba50aa43964fdf65282e3', class: {
                 'co-avatar-group': true,
                 'co-avatar-group--interactive': this.interactive,
             } }, interactiveAttrs), visible.map((it, i) => {
             var _a, _b, _c;
             return (h("co-avatar", { key: i, class: "co-avatar-group__avatar", type: (_a = it.type) !== null && _a !== void 0 ? _a : (it.src ? 'image' : it.icon ? 'icon' : 'text'), size: this.size, shape: (_b = it.shape) !== null && _b !== void 0 ? _b : this.shape, text: it.text, src: it.src, icon: (_c = it.icon) !== null && _c !== void 0 ? _c : 'user', color: it.color, "ring-color": it.ringColor, name: it.name || it.text || '' }));
-        }), extra > 0 && (h("co-tooltip", { key: 'b6dffe856f5984d2e2731e84d9d4a46cfcfa0c7b', class: "co-avatar-group__slot", content: overflowLabel, placement: "bottom" }, h("div", { key: 'b7fe90ee1800ede2bdc3b8674d6ab0dcdfa4ac48', class: "co-avatar-group__overflow", style: { width: `${dim}px`, height: `${dim}px`, fontSize }, role: "img", "aria-label": `+${extra}` }, "+", extra)))));
+        }), extra > 0 && (h("co-tooltip", { key: 'f3cc2f5a9f1ceac07ea3b665e6bd0c87804d27ae', class: "co-avatar-group__slot", content: overflowLabel, placement: "bottom" }, h("div", { key: 'c0b5fcb8df88917b06a2a9b36f1c2798f10730ff', class: "co-avatar-group__overflow", style: { width: `${dim}px`, height: `${dim}px`, fontSize }, role: "img", "aria-label": `+${extra}` }, "+", extra)))));
     }
     static get is() { return "co-avatar-group"; }
     static get encapsulation() { return "shadow"; }
@@ -87,7 +92,7 @@ export class CoAvatarGroup {
                     "references": {
                         "CoAvatarGroupItem": {
                             "location": "local",
-                            "path": "/Users/agox/worktrees/cobalt-release-2026-09-24/packages/core/src/components/co-avatar-group/co-avatar-group.tsx",
+                            "path": "/Users/agox/worktrees/cobalt-release-0.11.2/packages/core/src/components/co-avatar-group/co-avatar-group.tsx",
                             "id": "src/components/co-avatar-group/co-avatar-group.tsx::CoAvatarGroupItem"
                         }
                     }

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

@@ -1,4 +1,11 @@
 import { h } from "@stencil/core";
+/**
+ * Indicador pequeño de conteo o de estado (punto) con color semántico; con
+ * `animated` hace un pop de entrada. Wrapper Vue: `CoBadge` de
+ * `@prolibu-suite/cobalt-vue`.
+ *
+ * @part badge - El indicador.
+ */
 export class CoBadge {
     constructor() {
         /**
@@ -17,7 +24,7 @@ export class CoBadge {
         this.animated = false;
     }
     render() {
-        return (h("span", { key: 'be0a55884e7afcf9761712b0318ad46f54a82786', class: {
+        return (h("span", { key: 'b22315d54caf4150b599d5a8b576a08e68f8bfea', class: {
                 'co-badge': true,
                 [`co-badge--${this.size}`]: true,
                 [`co-badge--${this.color}`]: true,

package/dist/collection/components/co-bottom-sheet/co-bottom-sheet.js

@@ -13,6 +13,15 @@ import { slotHasContent } from "../../utils/slotContent";
  * @slot header - Custom header content (overrides `heading`). Dragging it moves the sheet.
  * @slot        - Sheet body (scrollable).
  * @slot footer - Pinned action area below the body (outside the scroll), with safe-area padding.
+ *
+ * Wrapper Vue: `CoBottomSheet` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part backdrop - Fondo oscuro detrás de la hoja.
+ * @part sheet - La hoja.
+ * @part handle - Tirador superior.
+ * @part header - Encabezado (título o slot `header`).
+ * @part body - Cuerpo scrolleable.
+ * @part footer - Área de acciones fija al pie.
  */
 export class CoBottomSheet {
     constructor() {
@@ -250,17 +259,17 @@ export class CoBottomSheet {
         (_a = this.bodyEl) === null || _a === void 0 ? void 0 : _a.removeEventListener('touchmove', this.touchBlocker);
     }
     render() {
-        return (h("div", { key: '9afac86d3b0bdab25d92b283b079304b2801fdcf', class: { 'co-bottom-sheet-root': true, 'co-bottom-sheet-root--open': this.open } }, h("div", { key: 'bc0152d32c577d2aafadcdcaae065aacb7442350', class: "co-bottom-sheet__backdrop", part: "backdrop", onClick: this.handleBackdropClick, ref: (el) => (this.backdropEl = el) }), h("section", { key: '457847247df72eb810149148e0a02a13152b86c1', class: { 'co-bottom-sheet': true, 'co-bottom-sheet--open': this.open }, part: "sheet", role: "dialog", "aria-modal": "true", "aria-labelledby": this.hasHeaderSlot
+        return (h("div", { key: '43f05669ad96312f6bd2ee1c1d4698538f029e2c', class: { 'co-bottom-sheet-root': true, 'co-bottom-sheet-root--open': this.open } }, h("div", { key: '86040a5efd513a6c06bbe551f82bcdc619817ea3', class: "co-bottom-sheet__backdrop", part: "backdrop", onClick: this.handleBackdropClick, ref: (el) => (this.backdropEl = el) }), h("section", { key: '46155a318f952b9be717a47497f1f513d3cf970f', class: { 'co-bottom-sheet': true, 'co-bottom-sheet--open': this.open }, part: "sheet", role: "dialog", "aria-modal": "true", "aria-labelledby": this.hasHeaderSlot
                 ? 'co-bottom-sheet-header'
                 : this.heading
                     ? 'co-bottom-sheet-heading'
-                    : undefined, style: { '--co-bottom-sheet-max-height': this.maxHeight }, onTransitionEnd: this.handleTransitionEnd, ref: (el) => (this.sheetEl = el) }, h("div", { key: 'b4acb6f614163fafe7c29c40664a646788cdb05b', class: "co-bottom-sheet__grip", onPointerDown: this.handleGripPointerDown, onPointerMove: this.handlePointerMove, onPointerUp: this.handlePointerUp, onPointerCancel: this.handlePointerCancel }, this.showHandle && (h("div", { key: 'f72127311b1e3bf8939eac0bc227b98f8418e6f7', class: "co-bottom-sheet__handle", part: "handle", "aria-hidden": "true" })), h("header", { key: 'ba1be5188eb0e6eb3a0add620be5da8a99e65978', class: {
+                    : undefined, style: { '--co-bottom-sheet-max-height': this.maxHeight }, onTransitionEnd: this.handleTransitionEnd, ref: (el) => (this.sheetEl = el) }, h("div", { key: '8b4a140b235f9803f71fb8717763651557ec6ca6', class: "co-bottom-sheet__grip", onPointerDown: this.handleGripPointerDown, onPointerMove: this.handlePointerMove, onPointerUp: this.handlePointerUp, onPointerCancel: this.handlePointerCancel }, this.showHandle && (h("div", { key: '0c61ae9e1faf72485cf5b8c529041f740831d3a1', class: "co-bottom-sheet__handle", part: "handle", "aria-hidden": "true" })), h("header", { key: 'cd7116cd2b12c66e6cde63753dab12eaab31d04c', class: {
                 'co-bottom-sheet__header': true,
                 'co-bottom-sheet__header--show': this.hasHeaderSlot || !!this.heading,
-            }, part: "header", id: "co-bottom-sheet-header" }, h("slot", { key: '53ab489d36588e8c7e604d16ae63b871a62cc833', name: "header", onSlotchange: this.handleHeaderSlotChange }, this.heading && (h("h2", { key: '4519555ec9333f9c0af56e86cc67f7bad914e1b5', class: "co-bottom-sheet__heading", id: "co-bottom-sheet-heading" }, this.heading))))), h("div", { key: '141df16f223b8a82fc1f412466669f999cbdba8a', class: "co-bottom-sheet__body", part: "body", onPointerDown: this.handleBodyPointerDown, onPointerMove: this.handlePointerMove, onPointerUp: this.handlePointerUp, onPointerCancel: this.handlePointerCancel, ref: (el) => (this.bodyEl = el) }, h("slot", { key: '5299c10f8854ee5f32794608502777e08dc9cec7' })), h("footer", { key: 'b3ec3a0aa7779829783aea2d64fde9b2199ed73c', class: {
+            }, part: "header", id: "co-bottom-sheet-header" }, h("slot", { key: '8343901cfdb86eef24e3bbc7e7a9d270eeed6ed0', name: "header", onSlotchange: this.handleHeaderSlotChange }, this.heading && (h("h2", { key: '31874876e8fb9db7cf7ae57f3f704a569d4fb797', class: "co-bottom-sheet__heading", id: "co-bottom-sheet-heading" }, this.heading))))), h("div", { key: '126a26708b6d4b70c8bb74f6a4cd7fe43f74e725', class: "co-bottom-sheet__body", part: "body", onPointerDown: this.handleBodyPointerDown, onPointerMove: this.handlePointerMove, onPointerUp: this.handlePointerUp, onPointerCancel: this.handlePointerCancel, ref: (el) => (this.bodyEl = el) }, h("slot", { key: 'c8f5034ea3de0265d05203befc31e961f8340694' })), h("footer", { key: 'a2d40f9d6056df561388fa213995595a84044cd1', class: {
                 'co-bottom-sheet__footer': true,
                 'co-bottom-sheet__footer--show': this.hasFooter,
-            }, part: "footer" }, h("slot", { key: 'd97f14b88decd35ccfbb4cc7e4f63446ef30a4b5', name: "footer", onSlotchange: this.handleFooterSlotChange })))));
+            }, part: "footer" }, h("slot", { key: '0d97eb87bc4de74db631629a478bd01ce5a473a6', name: "footer", onSlotchange: this.handleFooterSlotChange })))));
     }
     static get is() { return "co-bottom-sheet"; }
     static get encapsulation() { return "shadow"; }

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

@@ -7,6 +7,10 @@ import { Host, h } from "@stencil/core";
  * leading icon (hidden on the first crumb via CSS), so no separator markup is
  * interleaved here. This component propagates its `separator` prop down to the
  * slotted items and layouts them in a `align-items:center; gap:4px` flex row.
+ *
+ * @part breadcrumb - El propio elemento (`role="navigation"`), fila de migas.
+ *
+ * Wrapper Vue: `CoBreadcrumb` de `@prolibu-suite/cobalt-vue`.
  */
 export class CoBreadcrumb {
     constructor() {
@@ -42,7 +46,7 @@ export class CoBreadcrumb {
     }
     render() {
         const data = this.parseItems();
-        return (h(Host, { key: 'c57f833d27edfc2848a8f72de1805968e9536b72', part: "breadcrumb", role: "navigation", "aria-label": "Breadcrumb" }, data
+        return (h(Host, { key: 'e368c6a9c2842ee88e66d72d33164653b623616b', part: "breadcrumb", role: "navigation", "aria-label": "Breadcrumb" }, data
             ? data.map((it, i) => (h("co-breadcrumb-item", { key: i, label: it.label, value: it.value, icon: it.icon, separator: this.separator, current: i === data.length - 1 })))
             : h("slot", { onSlotchange: this.handleSlotChange })));
     }

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

@@ -9,6 +9,12 @@ import { Host, h } from "@stencil/core";
  *
  * Conventions mirror `co-menu-item`: the `current` crumb paints medium weight +
  * text-default ink; earlier crumbs are regular weight + muted (gray-500).
+ *
+ * Wrapper Vue: `CoBreadcrumbItem` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @slot - Contenido propio en lugar de `label`.
+ * @part breadcrumb-item - Contenedor de la miga (separador + contenido).
+ * @part content - Parte clickeable (ícono y texto).
  */
 export class CoBreadcrumbItem {
     constructor() {
@@ -29,10 +35,10 @@ export class CoBreadcrumbItem {
         };
     }
     render() {
-        return (h(Host, { key: '6cb113e8326d6fa5fe9ee23dcd8083ab4664d343', part: "breadcrumb-item", class: {
+        return (h(Host, { key: 'e751e769b86efb5c9f929f818c6a7a020beeace6', part: "breadcrumb-item", class: {
                 'co-breadcrumb-item': true,
                 'co-breadcrumb-item--current': this.current,
-            } }, h("span", { key: '9031f0d3558c5ce7dcf298d6e2b04059dd463a34', class: "co-breadcrumb-item__sep", "aria-hidden": "true" }, h("co-icon", { key: '143800da5211dd7bdb1e3b06de8c90fbb8f94acf', name: this.separator, size: 13 })), h("span", { key: '23b11ae5ed8315fcf84ed83609b7d98c0142f50b', class: "co-breadcrumb-item__content", part: "content", role: "link", tabindex: "0", "aria-current": this.current ? 'page' : undefined, onClick: this.handleClick, onKeyDown: this.handleKeydown }, this.icon && (h("span", { key: 'e70f21819a4e9bc117282b062399960810256c1e', class: "co-breadcrumb-item__icon" }, h("co-icon", { key: 'ed942c739f1c67cd0b27facc2eabd1d016391719', name: this.icon, size: 16 }))), h("span", { key: '0b2c28119d1123196d313015e3020a82618b932f', class: "co-breadcrumb-item__label" }, this.label, h("slot", { key: 'c83fcd1764b279aed0b9c4a1c791b47d011d711f' })))));
+            } }, h("span", { key: '65c70c55e16037e97c35c3ad65548b8e15d1e07d', class: "co-breadcrumb-item__sep", "aria-hidden": "true" }, h("co-icon", { key: '8e70db08814fa611cacd2e78bb96ece6a2d5e9db', name: this.separator, size: 13 })), h("span", { key: 'acc0e0a8a5b6e18aac7af27f4b5971bb4f5ed054', class: "co-breadcrumb-item__content", part: "content", role: "link", tabindex: "0", "aria-current": this.current ? 'page' : undefined, onClick: this.handleClick, onKeyDown: this.handleKeydown }, this.icon && (h("span", { key: '4f22d7482c0a70b3973c2a66d1ba84db4c07445d', class: "co-breadcrumb-item__icon" }, h("co-icon", { key: 'b16cbcbe67336c57230929f45985262ebb6ae093', name: this.icon, size: 16 }))), h("span", { key: '4dd03fea8de55ace99325fa57afdcb47c9b36e54', class: "co-breadcrumb-item__label" }, this.label, h("slot", { key: 'ec8a0a40d2e1ccbabde80b724eb5a473e123ac7d' })))));
     }
     static get is() { return "co-breadcrumb-item"; }
     static get encapsulation() { return "shadow"; }

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

@@ -1,3 +1,11 @@
+/**
+ * @prop --co-button-border-color: Color del borde, en todas las variantes (gana sobre `--co-button-border`).
+ * @prop --co-button-border: Borde de la variante `secondary` (knob anterior; `--co-button-border-color` le gana).
+ * @prop --co-button-bg: Superficie de la variante `secondary` (se mezcla al 55% con transparencia).
+ * @prop --co-button-color: Color de texto de la variante `secondary`.
+ * @prop --co-button-radius: Radio del botón con `shape="rounded"` (default pill).
+ * @prop --co-button-icon-color: Color de los íconos de `icon-left`/`icon-right` (default: el del texto).
+ */
 :host {
   display: inline-flex;
 }
@@ -39,7 +47,7 @@
      blurear y el 78% de negro colapsa a un gris lavado. */
   background: var(--co-semantic-surface-primary);
   color: var(--co-semantic-on-primary);
-  /* --co-button-border-color (Task C2): override transversal; el fallback es
+  /* --co-button-border-color: override transversal; el fallback es
      el valor propio de la variante, así el default no cambia sin la var. */
   border-color: var(--co-button-border-color, color-mix(in srgb, var(--co-semantic-on-primary) 28%, transparent));
 }
@@ -176,6 +184,21 @@
     inset 0 0 0 1px var(--co-color-opacity-negro-8);
 }
 
+/* ─── FOCUS RING ─────────────────────────────────────────────────
+   Anillo de foco de teclado en TODAS las variantes (el base es outline:none). Doble anillo: el
+   interior del color de la página separa el anillo del fill del botón en cualquier variante.
+   QA 2026-09-24 («Generar contrato»): con Tab el foco era invisible en todo botón salvo
+   danger + surface-dark. Va DESPUÉS del elevated (misma especificidad: su sombra pisaba el
+   anillo) y antes de las overrides de superficie, que lo siguen ganando por especificidad. */
+.co-button:focus-visible {
+  box-shadow:
+    0 0 0 2px var(--co-semantic-surface-page),
+    0 0 0 4px var(--co-semantic-border-focus);
+  /* forced-colors (alto contraste de Windows) borra el box-shadow: el sistema pinta este outline. */
+  outline: 2px solid transparent;
+  outline-offset: 2px;
+}
+
 /* ─── ON-DARK SURFACE · ghost/stroke ─────────────────────────────
    surface="dark": for buttons placed on a dark bar (e.g. a selection
    bar). White ink/icon + a blanco-16 hover wash. Higher specificity
@@ -233,7 +256,7 @@
   .co-button--stroke { background: transparent; }
 }
 
-/* ═══ Task C2 (Fase 2 Cobalt) — size="sm", variant="soft", full-width,
+/* ═══ Tallas y variantes del editor — size="sm", variant="soft", full-width,
    --co-button-border-color / --co-button-icon-color. Todo lo de abajo es
    aditivo: no reemplaza ni recalcula ninguna regla de arriba. ═══ */
 

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

@@ -1,17 +1,23 @@
 import { h } from "@stencil/core";
 const ICON_SIZE = { l: 20, m: 18, s: 16, xs: 14, sm: 16 };
 /**
+ * Botón de acción con texto e íconos opcionales. `variant` define el peso
+ * visual (`primary` para la acción principal), `size` la talla y `full-width`
+ * lo estira al ancho del contenedor. Wrapper Vue: `CoButton` de
+ * `@prolibu-suite/cobalt-vue`.
+ *
  * @slot - Button label text
+ * @part button - El `<button>` nativo interno.
  */
 export class CoButton {
     constructor() {
-        /** Visual style. "soft" (Task C2, Fase 2 Cobalt): fondo gray-100 sólido, sin backdrop-filter — pensado para toolbars/paneles del editor. */
+        /** Visual style. "soft": fondo sólido `--co-semantic-surface-control` (gray-100 en claro), sin backdrop-filter — pensado para toolbars y paneles del editor. */
         this.variant = 'primary';
         /** Shape: pill or straight corners */
         this.shape = 'rounded';
-        /** Size. "sm" (Task C2, Fase 2 Cobalt): 32px fijo — escala unificada de tallas nuevas del editor (xs=24/s=28/sm=32). */
+        /** Size: `l`, `m` (default), `s`, `xs`; `sm` = 32px fijo, de la escala compacta del editor (xs=24/s=28/sm=32). Un valor fuera de la lista no da error: el botón queda sin estilos de talla (sin padding ni tamaño de fuente). */
         this.size = 'm';
-        /** Ocupa el 100% del ancho del contenedor (Task C2, Fase 2 Cobalt). Reflejado como atributo `full-width`. */
+        /** Ocupa el 100% del ancho del contenedor. Reflejado como atributo `full-width`. */
         this.fullWidth = false;
         /** Raised elevation — with variant="secondary" renders a white raised button (shadow-sm + inset hairline). */
         this.elevated = false;
@@ -57,7 +63,7 @@ export class CoButton {
             customStyle.background = this.color;
         if (this.textColor)
             customStyle.color = this.textColor;
-        return (h("button", { key: 'a095e308b3bea917ecfb4da4f78e9a6c9e3dfba2', class: {
+        return (h("button", { key: 'e77a3b67e23b2690a818e6ad9aa38b21b4c8f972', class: {
                 'co-button': true,
                 [`co-button--${this.variant}`]: true,
                 [`co-button--${this.shape}`]: true,
@@ -67,7 +73,7 @@ export class CoButton {
                 'co-button--disabled': this.disabled,
             }, style: Object.keys(customStyle).length ? customStyle : undefined, type: this.type, disabled: this.disabled, "aria-label": this.ariaLabelText || undefined, onClick: this.handleClick, part: "button" }, this.iconLeft
             ? h("co-icon", { name: this.iconLeft, weight: this.iconWeight, size: iconSize })
-            : null, h("slot", { key: '7a7dfff6e1dc249b423477263e9140183290bf18' }, this.label), this.iconRight
+            : null, h("slot", { key: 'ee52eb057c04ee3e1f5a5b2e87dc778a338d9887' }, this.label), this.iconRight
             ? h("co-icon", { name: this.iconRight, weight: this.iconWeight, size: iconSize })
             : null));
     }
@@ -97,7 +103,7 @@ export class CoButton {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "Visual style. \"soft\" (Task C2, Fase 2 Cobalt): fondo gray-100 s\u00F3lido, sin backdrop-filter \u2014 pensado para toolbars/paneles del editor."
+                    "text": "Visual style. \"soft\": fondo s\u00F3lido `--co-semantic-surface-control` (gray-100 en claro), sin backdrop-filter \u2014 pensado para toolbars y paneles del editor."
                 },
                 "getter": false,
                 "setter": false,
@@ -137,7 +143,7 @@ export class CoButton {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "Size. \"sm\" (Task C2, Fase 2 Cobalt): 32px fijo \u2014 escala unificada de tallas nuevas del editor (xs=24/s=28/sm=32)."
+                    "text": "Size: `l`, `m` (default), `s`, `xs`; `sm` = 32px fijo, de la escala compacta del editor (xs=24/s=28/sm=32). Un valor fuera de la lista no da error: el bot\u00F3n queda sin estilos de talla (sin padding ni tama\u00F1o de fuente)."
                 },
                 "getter": false,
                 "setter": false,
@@ -157,7 +163,7 @@ export class CoButton {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "Ocupa el 100% del ancho del contenedor (Task C2, Fase 2 Cobalt). Reflejado como atributo `full-width`."
+                    "text": "Ocupa el 100% del ancho del contenedor. Reflejado como atributo `full-width`."
                 },
                 "getter": false,
                 "setter": false,

package/dist/collection/components/co-button-group/co-button-group.js

@@ -1,4 +1,10 @@
 import { h } from "@stencil/core";
+/**
+ * Grupo de `co-button` unidos en una fila o columna, con variante y talla
+ * compartidas. Wrapper Vue: `CoButtonGroup` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @slot - Los `co-button` del grupo.
+ */
 export class CoButtonGroup {
     constructor() {
         /** Visual variant applied to the group container */
@@ -7,15 +13,16 @@ export class CoButtonGroup {
         this.size = 'm';
         /** Orientation */
         this.direction = 'row';
+        /** Deshabilita el grupo entero (atenuado y sin clicks). */
         this.disabled = false;
     }
     render() {
-        return (h("div", { key: '5975d27cfd432bfd859212059c4bc79d2d8107d2', class: {
+        return (h("div", { key: '2240bc00c44e532340b3ae288cc9df099b9e1846', class: {
                 'co-button-group': true,
                 [`co-button-group--${this.direction}`]: true,
                 [`co-button-group--${this.variant}`]: true,
                 'co-button-group--disabled': this.disabled,
-            }, role: "group" }, h("slot", { key: '90c9338e9d00c71ae09189ebd0e70d8fa11e3825' })));
+            }, role: "group" }, h("slot", { key: '0a719f1a5f21883f5923cd9f20a818f467339846' })));
     }
     static get is() { return "co-button-group"; }
     static get encapsulation() { return "shadow"; }
@@ -103,7 +110,7 @@ export class CoButtonGroup {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Deshabilita el grupo entero (atenuado y sin clicks)."
                 },
                 "getter": false,
                 "setter": false,

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

@@ -1,3 +1,11 @@
+/**
+ * @prop --co-calendar-day-size: Lado de cada celda de día (default 36px; 44px en táctil).
+ * @prop --co-calendar-width: Ancho del calendario (default: el de sus 7 celdas).
+ * @prop --co-calendar-col: Ancho de cada columna de la grilla (default: la celda).
+ * @prop --co-calendar-day-width: Ancho del botón de día (default: la celda).
+ * @prop --co-calendar-marked-bg: Fondo de los días de `markedDates` (default rosado de marca).
+ * @prop --co-calendar-marked-fg: Color del número en los días marcados (default blanco).
+ */
 :host {
   display: inline-block;
   font-family: var(--co-font-family-primary);

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

@@ -14,6 +14,8 @@ import { dayAriaLabel, normalizeMarkedDates, normalizeStringArray, parseViewMont
  * chosen date. Today and selected are deliberately different visual states.
  *
  * @part root - The calendar container
+ * Wrapper Vue: `CoCalendar` de `@prolibu-suite/cobalt-vue`.
+ *
  * @part header - Month navigation header
  * @part grid - The day grid
  */
@@ -386,7 +388,7 @@ export class CoCalendar {
     render() {
         var _a, _b;
         const t = getDateStrings(this.locale);
-        return (h("div", { key: 'd093188dc77cea7856a4126828167ccd0e97a28a', class: "co-calendar", part: "root" }, h("div", { key: '9b133e1e7c2538df80ae86d463ac80bd2262364c', class: "co-calendar__header", part: "header" }, h("button", { key: 'c7b5f9407556ab1c68815c2896ee3ea6d87866ee', type: "button", class: "co-calendar__nav", onClick: this.handlePrev, "aria-label": (_a = this.prevMonthLabel) !== null && _a !== void 0 ? _a : t.prevMonth }, h("co-icon", { key: 'e76e3550772f7456d44fca6229a92146f4849ffc', name: "caret-left", size: 16 })), h("button", { key: '7e8d2620e5d73f8ab17a0e6f163e4fc7859db0b9', type: "button", class: "co-calendar__title", "aria-live": "polite", onClick: this.toggleView }, this.headerTitle(), h("co-icon", { key: '0f113778ee2f22843627a0fb6f0550e7fd861774', name: "caret-down", size: 12, class: "co-calendar__title-caret" })), h("button", { key: 'e49b124dadf06b2a5bf7f25aab160a80f4d1a539', type: "button", class: "co-calendar__nav", onClick: this.handleNext, "aria-label": (_b = this.nextMonthLabel) !== null && _b !== void 0 ? _b : t.nextMonth }, h("co-icon", { key: 'e1993eddaa8a0c33179e453dadd4996f2d5fd4fc', name: "caret-right", size: 16 }))), this.view === 'days' && this.renderDays(t), this.view === 'months' && this.renderMonths(), this.view === 'years' && this.renderYears()));
+        return (h("div", { key: '5ecdc23692eb69b8dc86b225857f51a3acf54838', class: "co-calendar", part: "root" }, h("div", { key: 'b66924b6b59f91d284210c6a0ed24294f211a5b7', class: "co-calendar__header", part: "header" }, h("button", { key: 'a4d52f3c02081b03f872a95955986c6351f9ca44', type: "button", class: "co-calendar__nav", onClick: this.handlePrev, "aria-label": (_a = this.prevMonthLabel) !== null && _a !== void 0 ? _a : t.prevMonth }, h("co-icon", { key: '6eaf089247fc85477a1bd9095af2c1c557d01bb3', name: "caret-left", size: 16 })), h("button", { key: '473815fa6114c82f601bea27e919b5c4546648f2', type: "button", class: "co-calendar__title", "aria-live": "polite", onClick: this.toggleView }, this.headerTitle(), h("co-icon", { key: '923647a98317c5e42ec7655ac21eed3e645224b6', name: "caret-down", size: 12, class: "co-calendar__title-caret" })), h("button", { key: '1ccbdf76cc5574021894f8f1c6bd381b9b524cfa', type: "button", class: "co-calendar__nav", onClick: this.handleNext, "aria-label": (_b = this.nextMonthLabel) !== null && _b !== void 0 ? _b : t.nextMonth }, h("co-icon", { key: '4b06c0827034a9f6924f1e80a51fdef924a0f8d1', name: "caret-right", size: 16 }))), this.view === 'days' && this.renderDays(t), this.view === 'months' && this.renderMonths(), this.view === 'years' && this.renderYears()));
     }
     static get is() { return "co-calendar"; }
     static get encapsulation() { return "shadow"; }

package/dist/collection/components/co-calendar-timegrid/co-calendar-timegrid.js

@@ -14,26 +14,43 @@ const DRAG_THRESHOLD_PX = 5;
  * `dates` = 7 day-keys (week) or 1 (day). Presentation + interaction only; the
  * host owns data (CONTROLLED). All instant math is delegated to the engine — the
  * only timezone boundary is the `timeZone` prop (wall-clock render).
+ *
+ * Es la vista Semana/Día que compone `co-event-calendar`; se usa directo solo
+ * para una grilla horaria propia. Sus eventos NO burbujean ni cruzan el shadow
+ * DOM: se escuchan sobre el propio elemento. Wrapper Vue: `CoCalendarTimegrid`
+ * de `@prolibu-suite/cobalt-vue`.
  */
 export class CoCalendarTimegrid {
     constructor() {
+        /** Eventos ya normalizados por el motor (`@prolibu-suite/cobalt-calendar-utils`); propiedad JS. */
         this.events = [];
         /** Visible day keys "YYYY-MM-DD" (7 = week, 1 = day). */
         this.dates = [];
+        /** Locale BCP-47 de las cabeceras de día y las etiquetas de hora. */
         this.locale = 'es-CO';
+        /** Permite mover y redimensionar eventos arrastrando (salvo los que traen `editable: false`); emite `coEventDrop`. */
         this.editable = true;
+        /** Permite seleccionar un rango en un área vacía para crear; emite `coRangeSelect`. */
         this.selectable = true;
+        /** Minutos por fila de la grilla (default 15); también el paso del teclado. */
         this.slotMinutes = 15;
+        /** Minutos a los que se ajustan arrastres y selecciones (default 15). */
         this.snapMinutes = 15;
+        /** Duración en minutos del rango creado con un click simple (default 60). */
         this.defaultDurationMinutes = 60;
+        /** Hora `HH:mm` a la que scrollea la grilla al montar (default 07:00). */
         this.scrollTime = '07:00';
+        /** Línea de «ahora» en la columna del día actual. */
         this.nowIndicator = true;
         /** Cargando: en vez de los eventos pinta bloques skeleton en las columnas.
          *  La grilla (eje de horas, líneas, cabecera de días, franja de todo-el-día)
          *  se mantiene: lo único que todavía no se sabe son los eventos. */
         this.loading = false;
+        /** Franja superior de eventos de todo el día. */
         this.allDaySlot = true;
+        /** Primera hora visible `HH:mm` (default 00:00). */
         this.minTime = '00:00';
+        /** Última hora visible `HH:mm` (default 24:00). */
         this.maxTime = '24:00';
         /** Minute of "now" for the indicator; refreshed on a 60s timer. */
         this.nowMinutes = 0;
@@ -704,11 +721,11 @@ export class CoCalendarTimegrid {
             '--co-cal-hour-h': `calc(${60 / this.slotM} * var(--co-cal-slot-h))`,
             '--co-cal-hour-offset': `calc(${((60 - (this.minM % 60)) % 60) / this.slotM} * var(--co-cal-slot-h))`,
         };
-        return (h("div", { key: '359362b29a9241b51f752889dc4021b5cd01e85a', class: "tg", tabIndex: 0, onKeyDown: this.handleKeyDown, ref: (el) => (this.rootEl = el) }, h("div", { key: '09c9b5330ccb8e43dda4e08f623ee6a17f842472', class: "tg__head" }, h("div", { key: 'f071542e19332046fb8c7142c85992ce54ba1884', class: "tg__head-spacer" }), h("div", { key: '843fbe8e97a99aea58e79b95b508fa80782a3bd9', class: "tg__head-days", style: { gridTemplateColumns: colsTemplate } }, dates.map((d) => {
+        return (h("div", { key: '55c583abdd12ac65d8188a8f9d4f0448e4fcf5b7', class: "tg", tabIndex: 0, onKeyDown: this.handleKeyDown, ref: (el) => (this.rootEl = el) }, h("div", { key: '33fa43418fdff096918441e6a2fdbf1d647980ec', class: "tg__head" }, h("div", { key: '2c4134daefc3cb99aa4965787c11318be9f27d40', class: "tg__head-spacer" }), h("div", { key: '0b6c10bbfb8b91723d62f05f1387d8c0513d7b09', class: "tg__head-days", style: { gridTemplateColumns: colsTemplate } }, dates.map((d) => {
             const ymd = parseISO(d);
             const dow = utcDayOfWeek(d);
             return (h("div", { class: { 'tg__head-day': true, 'tg__head-day--today': compareYMD(d, today) === 0 } }, h("span", { class: "tg__head-dow" }, short[dow]), h("span", { class: "tg__head-num" }, ymd.day)));
-        }))), this.allDaySlot && (h("div", { key: 'be9bb57aae5990d5e492c1188085946e92580989', class: "tg__allday" }, h("div", { key: '0875d60eede7447fa6895641c25148a8ca511713', class: "tg__allday-axis" }, gmtLabel(this.timeZone, dates[0])), h("div", { key: '2ae5911eb2d7f88cbfab6b540df2883e85d02278', class: "tg__allday-lane", style: { height: `${Math.max(1, allDay.laneCount) * ALLDAY_LANE_H + 4}px` } }, allDay.segments.map((seg) => this.renderAllDayBar(seg, dates.length, byId))))), h("div", { key: '65fef707d9de748f3d3b112bf1a0e49ca5165ae9', class: "tg__scroll", ref: (el) => (this.scrollEl = el) }, h("div", { key: 'cc7c058cec0dc047ff6f934ef47316d966b2f18f', class: "tg__body" }, h("div", { key: 'a5318ad33e9bf7ba4fc2c99a00cf81cd07bd5fbf', class: "tg__axis", style: { height: bodyHeight } }, this.hourList().map((m) => (h("span", { class: "tg__axis-hour", style: { top: `${minutesToFraction(m, this.minM, this.maxM) * 100}%` } }, hourLabel(m, this.locale))))), h("div", { key: '1338c80689f1c1567a652a88111687298170ceac', class: "tg__cols", style: Object.assign({ gridTemplateColumns: colsTemplate, height: bodyHeight }, hourVars) }, dates.map((d, i) => {
+        }))), this.allDaySlot && (h("div", { key: 'ac00b1d478138334f6b265e7e7861dc910ea778e', class: "tg__allday" }, h("div", { key: '52ea789daff3b284863e90fe2356b3f1f5ed8e75', class: "tg__allday-axis" }, gmtLabel(this.timeZone, dates[0])), h("div", { key: '24e0a67773437bad42a3fb183cf55f53f2e04d0f', class: "tg__allday-lane", style: { height: `${Math.max(1, allDay.laneCount) * ALLDAY_LANE_H + 4}px` } }, allDay.segments.map((seg) => this.renderAllDayBar(seg, dates.length, byId))))), h("div", { key: '19ee69ba01bcd63d015acebba5001390324b1c93', class: "tg__scroll", ref: (el) => (this.scrollEl = el) }, h("div", { key: '644e0cae08a22795bfdaa802227c176e733dd418', class: "tg__body" }, h("div", { key: '56a20d546083e0a0695c01a0910c80fdcaf56589', class: "tg__axis", style: { height: bodyHeight } }, this.hourList().map((m) => (h("span", { class: "tg__axis-hour", style: { top: `${minutesToFraction(m, this.minM, this.maxM) * 100}%` } }, hourLabel(m, this.locale))))), h("div", { key: '391004de33499561a0fdc75e3eabf401fb4e5561', class: "tg__cols", style: Object.assign({ gridTemplateColumns: colsTemplate, height: bodyHeight }, hourVars) }, dates.map((d, i) => {
             var _a;
             const isToday = compareYMD(d, today) === 0;
             return (h("div", { class: { tg__col: true, 'tg__col--today': isToday }, "data-col-date": d, onPointerDown: (e) => this.startSelection(e, d, e.currentTarget), onPointerMove: (e) => this.extendSelection(e, e.currentTarget) }, this.loading
@@ -752,7 +769,7 @@ export class CoCalendarTimegrid {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Eventos ya normalizados por el motor (`@prolibu-suite/cobalt-calendar-utils`); propiedad JS."
                 },
                 "getter": false,
                 "setter": false,
@@ -788,7 +805,7 @@ export class CoCalendarTimegrid {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Locale BCP-47 de las cabeceras de d\u00EDa y las etiquetas de hora."
                 },
                 "getter": false,
                 "setter": false,
@@ -808,7 +825,7 @@ export class CoCalendarTimegrid {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Zona IANA en la que se pinta el reloj (\u00FAnica frontera de zona horaria del componente)."
                 },
                 "getter": false,
                 "setter": false,
@@ -827,7 +844,7 @@ export class CoCalendarTimegrid {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Permite mover y redimensionar eventos arrastrando (salvo los que traen `editable: false`); emite `coEventDrop`."
                 },
                 "getter": false,
                 "setter": false,
@@ -847,7 +864,7 @@ export class CoCalendarTimegrid {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Permite seleccionar un rango en un \u00E1rea vac\u00EDa para crear; emite `coRangeSelect`."
                 },
                 "getter": false,
                 "setter": false,
@@ -867,7 +884,7 @@ export class CoCalendarTimegrid {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Primer d\u00EDa interactuable `YYYY-MM-DD`: antes no se puede seleccionar ni soltar."
                 },
                 "getter": false,
                 "setter": false,
@@ -886,7 +903,7 @@ export class CoCalendarTimegrid {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "\u00DAltimo d\u00EDa interactuable `YYYY-MM-DD`."
                 },
                 "getter": false,
                 "setter": false,
@@ -905,7 +922,7 @@ export class CoCalendarTimegrid {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Minutos por fila de la grilla (default 15); tambi\u00E9n el paso del teclado."
                 },
                 "getter": false,
                 "setter": false,
@@ -925,7 +942,7 @@ export class CoCalendarTimegrid {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Minutos a los que se ajustan arrastres y selecciones (default 15)."
                 },
                 "getter": false,
                 "setter": false,
@@ -945,7 +962,7 @@ export class CoCalendarTimegrid {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Duraci\u00F3n en minutos del rango creado con un click simple (default 60)."
                 },
                 "getter": false,
                 "setter": false,
@@ -965,7 +982,7 @@ export class CoCalendarTimegrid {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Hora `HH:mm` a la que scrollea la grilla al montar (default 07:00)."
                 },
                 "getter": false,
                 "setter": false,
@@ -985,7 +1002,7 @@ export class CoCalendarTimegrid {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "L\u00EDnea de \u00ABahora\u00BB en la columna del d\u00EDa actual."
                 },
                 "getter": false,
                 "setter": false,
@@ -1025,7 +1042,7 @@ export class CoCalendarTimegrid {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Franja superior de eventos de todo el d\u00EDa."
                 },
                 "getter": false,
                 "setter": false,
@@ -1045,7 +1062,7 @@ export class CoCalendarTimegrid {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Primera hora visible `HH:mm` (default 00:00)."
                 },
                 "getter": false,
                 "setter": false,
@@ -1065,7 +1082,7 @@ export class CoCalendarTimegrid {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "\u00DAltima hora visible `HH:mm` (default 24:00)."
                 },
                 "getter": false,
                 "setter": false,
@@ -1111,7 +1128,7 @@ export class CoCalendarTimegrid {
                 "composed": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Click en un evento: `{ id, rect }` (rect del chip, para anclar un popover). No burbujea."
                 },
                 "complexType": {
                     "original": "{ id: string; rect?: DOMRect }",
@@ -1131,7 +1148,7 @@ export class CoCalendarTimegrid {
                 "composed": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Se movi\u00F3 o redimension\u00F3 un evento: `{ id, start, end, oldStart, oldEnd, allDay }` (instantes ISO UTC).\nControlado: el host decide si aplica el cambio actualizando `events`. No burbujea."
                 },
                 "complexType": {
                     "original": "{\n    id: string; start: string; end: string; oldStart: string; oldEnd: string; allDay: boolean;\n  }",

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

@@ -1,5 +1,14 @@
 import { h } from "@stencil/core";
 /**
+ * Contenedor tipo tarjeta con header, cuerpo y footer, en variantes elevada,
+ * con borde o plana; opcionalmente clickeable. Wrapper Vue: `CoCard` de
+ * `@prolibu-suite/cobalt-vue`.
+ *
+ * @part card - La tarjeta.
+ * @part header - Área del slot `header`.
+ * @part body - Cuerpo (slot por defecto).
+ * @part footer - Área del slot `footer`.
+ *
  * @slot header  - Card header area (image, title, actions)
  * @slot         - Default slot for card body/content
  * @slot footer  - Card footer area (meta, actions)
@@ -29,13 +38,13 @@ export class CoCard {
         return nodes.length > 0;
     }
     render() {
-        return (h("div", { key: 'e1ba367c02ad068e72d2daa1f90e2bbdcf262290', class: {
+        return (h("div", { key: '662e725ff539d1696eeaa99a42f8160df8ba13ae', class: {
                 'co-card': true,
                 [`co-card--${this.variant}`]: true,
                 [`co-card--pad-${this.padding}`]: true,
                 'co-card--clickable': this.clickable,
                 'co-card--stretch': this.stretch,
-            }, part: "card", role: this.clickable ? 'button' : undefined, tabIndex: this.clickable ? 0 : undefined }, h("div", { key: '265eae5ea9ca7765fa84c135d3141b21a1495212', class: { 'co-card__header': true, 'co-card__header--empty': !this.hasHeader }, part: "header" }, h("slot", { key: 'c639a5613b94a6cd5afadee4a508de80744f61a5', name: "header", onSlotchange: this.handleHeaderSlotChange })), h("div", { key: 'ace57349938320967253d0a6a32600c9a8580a47', class: "co-card__body", part: "body" }, h("slot", { key: '85b3b510c8004fe9753bce5de6a1c39754d09b38' })), h("div", { key: '011b688e835090f81c85d5207fc80fc7794b48fe', class: { 'co-card__footer': true, 'co-card__footer--empty': !this.hasFooter }, part: "footer" }, h("slot", { key: '565877135c3a16cbce2a8e15b0c9c4bc76dfbec1', name: "footer", onSlotchange: this.handleFooterSlotChange }))));
+            }, part: "card", role: this.clickable ? 'button' : undefined, tabIndex: this.clickable ? 0 : undefined }, h("div", { key: '63b8d7696663831f6151d66ea17855ce85421045', class: { 'co-card__header': true, 'co-card__header--empty': !this.hasHeader }, part: "header" }, h("slot", { key: 'b4318780fa0d1fb8c9475056d59b9dd3bf055594', name: "header", onSlotchange: this.handleHeaderSlotChange })), h("div", { key: '20d5231348b8031688380b08a8222f4bd3f68575', class: "co-card__body", part: "body" }, h("slot", { key: '2946cc5d8d80cbc23f98e710b97cb77d542a019e' })), h("div", { key: '90dd12b60204cbd2e1ddb6752c8e6a413db7f860', class: { 'co-card__footer': true, 'co-card__footer--empty': !this.hasFooter }, part: "footer" }, h("slot", { key: 'de9d77a21962ed35d2862059d13910b1067d1573', name: "footer", onSlotchange: this.handleFooterSlotChange }))));
     }
     static get is() { return "co-card"; }
     static get encapsulation() { return "shadow"; }

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

@@ -2,6 +2,16 @@
    co-carousel
    ═══════════════════════════════════════════════════ */
 
+/**
+ * Tienen su default en `:host`; se sobrescriben desde afuera sobre el elemento.
+ * @prop --co-carousel-arrow-size: Diámetro de las flechas (default 36px).
+ * @prop --co-carousel-arrow-bg: Fondo de las flechas.
+ * @prop --co-carousel-arrow-color: Color del ícono de las flechas.
+ * @prop --co-carousel-dot-size: Tamaño de los indicadores (default 6px).
+ * @prop --co-carousel-dot-color: Color de los indicadores inactivos.
+ * @prop --co-carousel-dot-active-color: Color del indicador activo.
+ * @prop --co-carousel-transition: Duración y curva del desplazamiento entre slides (default 320ms).
+ */
 :host {
   display: block;
   font-family: var(--co-font-family-primary);