@prolibu-suite/cobalt-core 0.11.0 → 0.11.2

package/dist/collection/components/co-overlay/focusTrap.js

@@ -40,9 +40,13 @@ export function resolveTabIndex(count, activeIndex, shiftKey) {
     return activeIndex === -1 || activeIndex >= count - 1 ? 0 : activeIndex + 1;
 }
 /**
- * Collect the tabbable elements slotted into the overlay's light DOM, skipping
- * hidden / aria-hidden ones. (Focusables nested inside further shadow roots are
- * out of scope — the common dialog/modal content lives in the slotted subtree.)
+ * Collect the tabbable elements in the overlay's light DOM, skipping hidden /
+ * aria-hidden ones.
+ *
+ * Kept for compatibility only — co-overlay no longer uses it: it cannot see past
+ * a shadow root, and co-overlay lives INSIDE co-modal's shadow, so its light DOM
+ * is the modal frame (the ✕) and never the consumer's slotted content nor the
+ * inner `<button>` of a co-button. Use `getComposedFocusables`.
  */
 export function getFocusableElements(root) {
     const nodes = Array.from(root.querySelectorAll(FOCUSABLE_SELECTOR));
@@ -51,3 +55,107 @@ export function getFocusableElements(root) {
         // offsetParent is null for display:none; getClientRects covers position:fixed.
         (el.offsetParent !== null || el.getClientRects().length > 0));
 }
+// ── Recorrido compuesto (QA 2026-09-24, «Generar contrato» de contratos V2) ──
+// El foco nunca entraba ni quedaba atrapado en un co-modal: `getFocusableElements`
+// solo mira el light DOM de co-overlay (el frame del modal: el ✕). El contenido
+// del consumidor llega por DOS <slot> (el de co-overlay y el del frame) y los
+// controles reales viven en el shadow de cada co-* (el <button> de co-button, el
+// <input> de co-input). El recorrido sigue el árbol PLANO: baja por shadowRoots
+// y, en cada <slot>, por sus asignados — o por su contenido por defecto si no
+// tiene. Todo esto corre solo en el navegador (abrir la trampa / cada Tab).
+/** Hijos en el árbol plano: el shadow del host, los asignados de un slot o los hijos. */
+function composedChildren(el) {
+    if (el.shadowRoot)
+        return Array.from(el.shadowRoot.children);
+    if (el.tagName === 'SLOT') {
+        const assigned = el.assignedElements({ flatten: true });
+        return assigned.length ? assigned : Array.from(el.children);
+    }
+    return Array.from(el.children);
+}
+/** Subárbol fuera de la trampa entero: oculto a AT o inerte. */
+function isExcludedSubtree(el) {
+    return el.getAttribute('aria-hidden') === 'true' || el.hasAttribute('inert');
+}
+/**
+ * Parada de Tab: matchea el selector, no está deshabilitado, no se sacó del
+ * orden con tabindex negativo (los botones internos de un trigger co-* —clear,
+ * chips— van con `tabIndex={-1}`, y `button:not([disabled])` los matchearía
+ * igual), tiene caja (offsetParent null = display:none; getClientRects cubre
+ * position:fixed) y no es `visibility:hidden`: un acordeón o fieldset colapsado
+ * conserva la caja pero el navegador no le da el foco, y la trampa lo elegiría
+ * igual → Tab clavado (WCAG 2.1.2). Sin la API (navegador viejo, jsdom) no filtra.
+ */
+function isTabStop(el) {
+    var _a, _b;
+    if (!((_a = el.matches) === null || _a === void 0 ? void 0 : _a.call(el, FOCUSABLE_SELECTOR)) || el.hasAttribute('disabled'))
+        return false;
+    const tabindex = el.getAttribute('tabindex');
+    if (tabindex !== null && Number(tabindex) < 0)
+        return false;
+    if (el.offsetParent === null && el.getClientRects().length === 0)
+        return false;
+    return ((_b = el.checkVisibility) === null || _b === void 0 ? void 0 : _b.call(el, { visibilityProperty: true })) !== false;
+}
+/**
+ * Recorre en orden del árbol plano los descendientes compuestos de `root` (sin
+ * incluirlo) hasta que `visit` devuelve true. Poda aria-hidden / inert.
+ */
+function walkComposed(root, visit) {
+    const step = (node) => {
+        if (isExcludedSubtree(node))
+            return false;
+        if (visit(node))
+            return true;
+        return composedChildren(node).some(step);
+    };
+    composedChildren(root).some(step);
+}
+/** Primer descendiente compuesto que cumple `match`, en orden del árbol plano. */
+function findComposed(root, match) {
+    let found = null;
+    walkComposed(root, (el) => {
+        if (!match(el))
+            return false;
+        found = el;
+        return true;
+    });
+    return found;
+}
+/**
+ * Paradas de Tab dentro de `root` en el árbol COMPUESTO (shadowRoots + slots
+ * asignados), con las mismas exclusiones que `getFocusableElements`.
+ */
+export function getComposedFocusables(root) {
+    const out = [];
+    walkComposed(root, (el) => {
+        if (isTabStop(el))
+            out.push(el);
+        return false;
+    });
+    return out;
+}
+/**
+ * Dónde cae el foco al abrir la trampa: el primer `[autofocus]` del recorrido
+ * compuesto —si es un host con shadow (`<co-input autofocus>`), su primer
+ * enfocable compuesto—; si no hay, la primera parada de Tab. `null` = nada
+ * enfocable (el llamador cae al contenedor).
+ */
+export function resolveInitialFocus(root) {
+    const autofocus = findComposed(root, (el) => el.hasAttribute('autofocus'));
+    if (autofocus) {
+        if (isTabStop(autofocus))
+            return autofocus;
+        const inner = autofocus.shadowRoot ? getComposedFocusables(autofocus)[0] : undefined;
+        if (inner)
+            return inner;
+    }
+    return findComposed(root, isTabStop);
+}
+/**
+ * Con dos trampas abiertas (un confirm sobre un modal, un modal anidado) las dos
+ * escuchan el keydown de document: solo la capa MÁS RECIENTE maneja Tab.
+ */
+export function isTopTrap(stack, id) {
+    return stack.length > 0 && stack[stack.length - 1] === id;
+}

package/dist/collection/components/co-page-header/co-page-header.js

@@ -3,10 +3,13 @@ import { h } from "@stencil/core";
  * Page-level header bar with icon, title, and right actions.
  * @slot        - Title area (default slot)
  * @slot actions - Right-side actions (switches, buttons)
+ *
+ * Wrapper Vue: `CoPageHeader` de `@prolibu-suite/cobalt-vue`.
+ * @part page-header - La fila del encabezado.
  */
 export class CoPageHeader {
     render() {
-        return (h("div", { key: 'e3a67a921d1a5c5ac8a91d1bbf76efc5d1dc6e54', class: "co-page-header", part: "page-header" }, h("div", { key: 'c1487cedf194477595bb176c381d5e839a70571e', class: "co-page-header__left" }, this.icon && (h("span", { key: 'd07f12f586c1e42fb85a06c8a7cc634778a939e5', class: "co-page-header__icon" }, h("co-icon", { key: '0224fac27acc073beccd0d59b39e3714732b3fcc', name: this.icon, size: 24 }))), h("span", { key: 'c19700b850224b46a175c4a5fb082a7898842c7e', class: "co-page-header__title" }, h("slot", { key: '3e7426edb3999085f9791ed7fb9fb74b82e4227e' }, this.heading))), h("div", { key: 'ca4dd0bd5c5d553eb6adb80cc3d2093ea9dd4d2b', class: "co-page-header__actions" }, h("slot", { key: '3f108386752ebd1a740ab97c5f7fc8535a55f853', name: "actions" }))));
+        return (h("div", { key: '18d15d7b241f92bbd121fd6547832a30f4404928', class: "co-page-header", part: "page-header" }, h("div", { key: 'cbf4427991e3b43775a1d47c95f953ef79d71c77', class: "co-page-header__left" }, this.icon && (h("span", { key: '647701102f261fc214a0a4347894ba275da1ed7d', class: "co-page-header__icon" }, h("co-icon", { key: 'd377f2f5cbfa190cb483fe4a6ff2a483f9053f7b', name: this.icon, size: 24 }))), h("span", { key: 'ccf59184d2154c89fc90ccddfffc8dfc8c07b72b', class: "co-page-header__title" }, h("slot", { key: '34dd64e79e72cb154c63b16f72c2ec58193d9988' }, this.heading))), h("div", { key: 'e2f1d119629a3b9479896cf2338625ad775b8556', class: "co-page-header__actions" }, h("slot", { key: '62ee162b3388968ee1930a2c3ab20e45b34a2d65', name: "actions" }))));
     }
     static get is() { return "co-page-header"; }
     static get encapsulation() { return "shadow"; }

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

@@ -1,5 +1,10 @@
 /* co-popover — floating panel primitive */
 
+/**
+ * @prop --co-popover-border-color: Color del borde del panel (default border-subtle).
+ * @prop --co-popover-shadow: Sombra del panel (default `0 4px 16px` suave).
+ */
+
 :host {
   display: inline-block;
   position: relative;
@@ -45,7 +50,7 @@
   opacity: 0;
   transform: scale(0.97);
   background: var(--co-semantic-surface-page, #fff);
-  /* Task C10 (Fase 2 Cobalt): variables con el default de siempre como
+  /* Variables con el default de siempre como
      fallback — sin --co-popover-border-color/--co-popover-shadow, cero
      cambio visual. */
   border: 1px solid var(--co-popover-border-color, var(--co-semantic-border-subtle));
@@ -54,7 +59,7 @@
   overflow: visible;
 }
 
-/* `bare` (Task C10, Fase 2 Cobalt): sin fondo/borde/sombra propios, para
+/* `bare`: sin fondo/borde/sombra propios, para
    alojar un `co-menu` (u otro contenido con su propio chrome) sin "doble
    chrome". El resto del panel (posicionamiento, transición de entrada/salida)
    no cambia. */

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

@@ -3,6 +3,17 @@ import { computePosition, findScrollParents, getOffsetAncestor, isAnchorVisible
 import { pushLayer, removeLayer, isTopLayer } from "../../utils/popover-stack";
 /** Side classes driving the entrance `transform-origin` (see co-popover.css). */
 const SIDE_CLASSES = ['top', 'bottom', 'left', 'right'].map((s) => `co-popover__panel--${s}`);
+/**
+ * Panel flotante anclado a un disparador (slot `trigger`) con posicionamiento,
+ * volteo si no cabe y cierre por click afuera o Escape. Base de menús, selects y
+ * pickers. Sus eventos no burbujean. Wrapper Vue: `CoPopover` de
+ * `@prolibu-suite/cobalt-vue`.
+ *
+ * @slot trigger - Elemento que abre y cierra el panel al hacer click.
+ * @slot - Contenido del panel.
+ *
+ * @part panel - El panel flotante (fondo, borde, sombra).
+ */
 export class CoPopover {
     constructor() {
         // ── Props ──────────────────────────────────────────────────
@@ -28,7 +39,7 @@ export class CoPopover {
         /** Flip placement when the panel would overflow the viewport. */
         this.flip = true;
         /**
-         * El panel no pinta fondo/borde/sombra propios (Task C10, Fase 2 Cobalt):
+         * El panel no pinta fondo/borde/sombra propios:
          * para alojar un `co-menu` (u otro contenido con su propio chrome) sin
          * "doble chrome". Reflejado como atributo `bare`. Default `false` = panel
          * con el fondo/borde/sombra de siempre (`--co-popover-border-color` /
@@ -36,8 +47,7 @@ export class CoPopover {
          */
         this.bare = false;
         /**
-         * Desplazamiento en px sobre el eje CRUZADO del `placement` (Task C10, Fase
-         * 2 Cobalt): con un placement vertical (`top*`/`bottom*`) mueve `left`; con
+         * Desplazamiento en px sobre el eje CRUZADO del `placement`: con un placement vertical (`top*`/`bottom*`) mueve `left`; con
          * uno horizontal (`left*`/`right*`) mueve `top`. Default 0 = sin cambio.
          *
          * ⚠️ Se aplica ANTES del clamp de 4px a los bordes del viewport (ver
@@ -154,7 +164,7 @@ export class CoPopover {
                 width: this.panelEl.offsetWidth,
                 height: this.panelEl.offsetHeight,
             });
-            // Task C10 (Fase 2 Cobalt): `anchor` sin resolver (prop ausente, o
+            // `anchor` sin resolver (prop ausente, o
             // selector sin match en `document`) → `anchorRect` queda undefined y
             // computePosition cae a `triggerRect` — mismo resultado que hoy.
             const anchorEl = this.resolveAnchor();
@@ -302,17 +312,20 @@ export class CoPopover {
         this.pressStartedInside = false;
     }
     // ── Public methods ─────────────────────────────────────────
+    /** Abre o cierra el panel. */
     async toggle() {
         this.open = !this.open;
     }
+    /** Abre el panel. */
     async show() {
         this.open = true;
     }
+    /** Cierra el panel. */
     async hide() {
         this.open = false;
     }
     /**
-     * Resuelve la prop `anchor` a un elemento (Task C10, Fase 2 Cobalt):
+     * Resuelve la prop `anchor` a un elemento:
      *   - `HTMLElement` → se usa tal cual.
      *   - `string` → selector resuelto contra `document`; sin match, `null`
      *     (el llamador cae a `triggerRect`, el comportamiento de siempre).
@@ -382,13 +395,13 @@ export class CoPopover {
     }
     // ── Render ─────────────────────────────────────────────────
     render() {
-        return (h("div", { key: '662c5cf02c52e80ab1367b7bf5418a5314449b93', class: "co-popover" }, h("div", { key: '067b11518b303acbfdb695d339d5fc3a1c709413', class: "co-popover__trigger", ref: (el) => (this.triggerEl = el), onClick: this.handleTriggerClick }, h("slot", { key: 'b186427b3c97ff65beda554f0c54e0e4bd91b44b', name: "trigger" })), (this.open || this.closing) && (h("div", { key: '2e905ee909de4e8c89baefd0ad5218f5a5446ec9', class: { 'co-popover__panel': true, 'co-popover__panel--closing': this.closing }, part: "panel", popover: "manual", onTransitionEnd: this.handlePanelTransitionEnd, ref: (el) => {
+        return (h("div", { key: 'f9c23cf5b7beb42230fbc37e6aacb9d8423a2c34', class: "co-popover" }, h("div", { key: '255b7a3b713719283e3b4a6d65ed520661b4e40b', class: "co-popover__trigger", ref: (el) => (this.triggerEl = el), onClick: this.handleTriggerClick }, h("slot", { key: '82c7133648e7c55db263f1abae8902c3ab579d27', name: "trigger" })), (this.open || this.closing) && (h("div", { key: '990ca1400e5e19d6614dbc7b43e78b116626e1b0', class: { 'co-popover__panel': true, 'co-popover__panel--closing': this.closing }, part: "panel", popover: "manual", onTransitionEnd: this.handlePanelTransitionEnd, ref: (el) => {
                 if (el && el !== this.panelEl) {
                     this.panelEl = el;
                     this.promotePanel();
                     this.scheduleUpdate();
                 }
-            } }, h("slot", { key: '2220a6e8efdee1ec51c4c3d33eb1b016f0619f48' })))));
+            } }, h("slot", { key: 'fb635cf42e7866b055a59aaf471bab5bca995afb' })))));
     }
     static get is() { return "co-popover"; }
     static get encapsulation() { return "shadow"; }
@@ -433,7 +446,7 @@ export class CoPopover {
                     "references": {
                         "PopoverPlacement": {
                             "location": "local",
-                            "path": "/Users/agox/worktrees/cobalt-release-2026-09-24/packages/core/src/components/co-popover/co-popover.tsx",
+                            "path": "/Users/agox/worktrees/cobalt-release-0.11.2/packages/core/src/components/co-popover/co-popover.tsx",
                             "id": "src/components/co-popover/co-popover.tsx::PopoverPlacement"
                         }
                     }
@@ -562,7 +575,7 @@ export class CoPopover {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "El panel no pinta fondo/borde/sombra propios (Task C10, Fase 2 Cobalt):\npara alojar un `co-menu` (u otro contenido con su propio chrome) sin\n\"doble chrome\". Reflejado como atributo `bare`. Default `false` = panel\ncon el fondo/borde/sombra de siempre (`--co-popover-border-color` /\n`--co-popover-shadow`), sin cambio."
+                    "text": "El panel no pinta fondo/borde/sombra propios:\npara alojar un `co-menu` (u otro contenido con su propio chrome) sin\n\"doble chrome\". Reflejado como atributo `bare`. Default `false` = panel\ncon el fondo/borde/sombra de siempre (`--co-popover-border-color` /\n`--co-popover-shadow`), sin cambio."
                 },
                 "getter": false,
                 "setter": false,
@@ -587,7 +600,7 @@ export class CoPopover {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": "Elemento (o selector resuelto contra `document`) al que se alinea el\npanel EN VEZ del trigger (Task C10, Fase 2 Cobalt) \u2014 p.ej. la p\u00EDldora\ncompleta del zoom, no solo el bot\u00F3n \"\u25BE\" que abre el men\u00FA. Un selector sin\nmatch cae al trigger (comportamiento actual). Sin `anchor`, cero cambio."
+                    "text": "Elemento (o selector resuelto contra `document`) al que se alinea el\npanel EN VEZ del trigger \u2014 p.ej. la p\u00EDldora\ncompleta del zoom, no solo el bot\u00F3n \"\u25BE\" que abre el men\u00FA. Un selector sin\nmatch cae al trigger (comportamiento actual). Sin `anchor`, cero cambio."
                 },
                 "getter": false,
                 "setter": false,
@@ -606,7 +619,7 @@ export class CoPopover {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "Desplazamiento en px sobre el eje CRUZADO del `placement` (Task C10, Fase\n2 Cobalt): con un placement vertical (`top*`/`bottom*`) mueve `left`; con\nuno horizontal (`left*`/`right*`) mueve `top`. Default 0 = sin cambio.\n\n\u26A0\uFE0F Se aplica ANTES del clamp de 4px a los bordes del viewport (ver\n`computePosition` en `utils/positioning.ts`) \u2014 un `shift` grande cerca de\nun borde puede quedar clampeado igual que hoy, no lo evita. No hay forma\nde pedir un `shift` que se salga de pantalla a prop\u00F3sito."
+                    "text": "Desplazamiento en px sobre el eje CRUZADO del `placement`: con un placement vertical (`top*`/`bottom*`) mueve `left`; con\nuno horizontal (`left*`/`right*`) mueve `top`. Default 0 = sin cambio.\n\n\u26A0\uFE0F Se aplica ANTES del clamp de 4px a los bordes del viewport (ver\n`computePosition` en `utils/positioning.ts`) \u2014 un `shift` grande cerca de\nun borde puede quedar clampeado igual que hoy, no lo evita. No hay forma\nde pedir un `shift` que se salga de pantalla a prop\u00F3sito."
                 },
                 "getter": false,
                 "setter": false,
@@ -630,7 +643,7 @@ export class CoPopover {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Se abri\u00F3 el panel. No burbujea."
                 },
                 "complexType": {
                     "original": "void",
@@ -645,7 +658,7 @@ export class CoPopover {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Se cerr\u00F3 el panel (click afuera, Escape, m\u00E9todo o el ancla sali\u00F3 de la vista). No burbujea."
                 },
                 "complexType": {
                     "original": "void",
@@ -691,7 +704,7 @@ export class CoPopover {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "",
+                    "text": "Abre o cierra el panel.",
                     "tags": []
                 }
             },
@@ -708,7 +721,7 @@ export class CoPopover {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "",
+                    "text": "Abre el panel.",
                     "tags": []
                 }
             },
@@ -725,7 +738,7 @@ export class CoPopover {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "",
+                    "text": "Cierra el panel.",
                     "tags": []
                 }
             }

package/dist/collection/components/co-progress-bar/co-progress-bar.js

@@ -1,6 +1,9 @@
 import { h } from "@stencil/core";
 /**
  * A horizontal progress bar with status colors.
+ * Wrapper Vue: `CoProgressBar` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part bar - Contenedor de la barra (pista y relleno).
  */
 export class CoProgressBar {
     constructor() {
@@ -18,12 +21,12 @@ export class CoProgressBar {
     render() {
         const clamped = Math.max(0, Math.min(100, this.value));
         const indeterminate = this.indeterminate;
-        return (h("div", { key: 'c2286f839f8f8f472e76bcad9d3f77962112bf8f', class: {
+        return (h("div", { key: '73ffc3d2dedc7a87e2552a75b61a56199f60edb6', class: {
                 'co-progress-bar': true,
                 [`co-progress-bar--${this.status}`]: true,
                 [`co-progress-bar--${this.variant}`]: true,
                 'co-progress-bar--indeterminate': indeterminate,
-            }, role: "progressbar", "aria-valuenow": indeterminate ? undefined : clamped, "aria-valuemin": 0, "aria-valuemax": 100, part: "bar", style: { height: `${this.thickness}px` } }, h("div", { key: '2fe1138f2caac250117c14cc51aec68be76f48d8', class: "co-progress-bar__fill", style: indeterminate ? undefined : { width: `${clamped}%` } })));
+            }, role: "progressbar", "aria-valuenow": indeterminate ? undefined : clamped, "aria-valuemin": 0, "aria-valuemax": 100, part: "bar", style: { height: `${this.thickness}px` } }, h("div", { key: 'da42344ce3d88c2a1eec058b4bb57a7b8380a2aa', class: "co-progress-bar__fill", style: indeterminate ? undefined : { width: `${clamped}%` } })));
     }
     static get is() { return "co-progress-bar"; }
     static get encapsulation() { return "shadow"; }

package/dist/collection/components/co-progress-circle/co-progress-circle.js

@@ -1,6 +1,9 @@
 import { h } from "@stencil/core";
 /**
  * A circular progress indicator with status colors and optional label.
+ * Wrapper Vue: `CoProgressCircle` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part circle - Contenedor del círculo (SVG y etiqueta).
  */
 export class CoProgressCircle {
     constructor() {
@@ -19,7 +22,7 @@ export class CoProgressCircle {
         const clamped = Math.max(0, Math.min(100, this.value));
         const angle = (clamped / 100) * 360;
         const safeStroke = Math.min(this.strokeWidth, this.size / 2);
-        return (h("div", { key: '93f0e78b8f51342146367c35fb4a1238e6381fa4', class: {
+        return (h("div", { key: 'a3d5bc7d287ef18ad5d1d2f23373d25ea2509476', class: {
                 'co-progress-circle': true,
                 [`co-progress-circle--${this.status}`]: true,
             }, role: "progressbar", "aria-valuenow": clamped, "aria-valuemin": 0, "aria-valuemax": 100, part: "circle", style: {
@@ -27,7 +30,7 @@ export class CoProgressCircle {
                 height: `${this.size}px`,
                 '--co-pc-angle': `${angle}deg`,
                 '--co-pc-stroke': `${safeStroke}px`,
-            } }, h("div", { key: '433ddb015c524bc9fead3540a71a3c514d66a64c', class: "co-progress-circle__track" }), this.showLabel && (h("span", { key: '6951e520d786e0d22af5163d116464faa7be171a', class: "co-progress-circle__label" }, clamped, "%"))));
+            } }, h("div", { key: '3b922058d72dcb0d1a7a9f59b122b8a2d54c4d4a', class: "co-progress-circle__track" }), this.showLabel && (h("span", { key: '083498504b05357660f593c128258a2be8ca359e', class: "co-progress-circle__label" }, clamped, "%"))));
     }
     static get is() { return "co-progress-circle"; }
     static get encapsulation() { return "shadow"; }

package/dist/collection/components/co-provider-logo/co-provider-logo.js

@@ -28,6 +28,9 @@ const BRANDS = {
  * `plated` lo monta sobre un disco blanco: es lo que hace legible una marca a
  * color cuando va encima de una superficie teñida (el badge de un evento de
  * calendario externo, que hereda el color del calendario).
+ * Wrapper Vue: `CoProviderLogo` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part root - Contenedor del logo (el disco blanco con `plated`).
  */
 export class CoProviderLogo {
     constructor() {

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

@@ -1,4 +1,12 @@
 import { h } from "@stencil/core";
+/**
+ * Botón de opción individual con etiqueta; normalmente se agrupa en un
+ * `co-radio-group`, que coordina la selección única. Wrapper Vue: `CoRadio` de
+ * `@prolibu-suite/cobalt-vue`.
+ *
+ * @part circle - El círculo del radio.
+ * @part label - La etiqueta.
+ */
 export class CoRadio {
     constructor() {
         /** Whether the radio is selected */
@@ -17,15 +25,15 @@ export class CoRadio {
         };
     }
     render() {
-        return (h("div", { key: 'e919e4c950b39acb06eab78a8a22d5d5d3acb211', class: {
+        return (h("div", { key: '637efb5c90e6f1f2c205a9c97c020c609f72a093', class: {
                 'co-radio-row': true,
                 'co-radio-row--disabled': this.disabled,
-            }, onClick: this.handleClick }, h("button", { key: '9f52728498ff3092f994410a948e9e52cc83b0cb', role: "radio", "aria-checked": String(this.checked), "aria-label": this.label || '', class: {
+            }, onClick: this.handleClick }, h("button", { key: '7311c200f5b2e2029acfe2642aa59c850087a7b3', role: "radio", "aria-checked": String(this.checked), "aria-label": this.label || '', class: {
                 'co-radio': true,
                 [`co-radio--${this.size}`]: true,
                 'co-radio--checked': this.checked,
                 'co-radio--disabled': this.disabled,
-            }, disabled: this.disabled, part: "circle" }), this.label && (h("span", { key: '989a97802b68aabe45b5b5e983f10bb2bbf9b01e', class: "co-radio__label", part: "label" }, this.label))));
+            }, disabled: this.disabled, part: "circle" }), this.label && (h("span", { key: '067c567f9d70642c11ccb1a8d0b30c17323fb476', class: "co-radio__label", part: "label" }, this.label))));
     }
     static get is() { return "co-radio"; }
     static get encapsulation() { return "shadow"; }

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

@@ -1,4 +1,9 @@
 import { h } from "@stencil/core";
+/**
+ * Grupo de opciones de selección única con etiqueta, ayuda y estado de
+ * validación: `options` define los radios y `value` el elegido. Wrapper Vue:
+ * `CoRadioGroup` de `@prolibu-suite/cobalt-vue`.
+ */
 export class CoRadioGroup {
     constructor() {
         /** Label layout: vertical (label above) or horizontal (label beside) */
@@ -59,11 +64,11 @@ export class CoRadioGroup {
         const hasLabels = this.label || this.secondaryLabel;
         const hasHelper = this.helperText;
         const opts = this.parsedOptions;
-        return (h("div", { key: 'aed7b7da65c9115ab36df5e8ac883de54c95c9e6', class: {
+        return (h("div", { key: 'b1c5880c1f9faca27b89189de5d64e36569d5b4f', class: {
                 'co-radio-group': true,
                 'co-radio-group--disabled': this.disabled,
                 [`co-radio-group--${this.status}`]: this.status !== 'default',
-            }, role: "radiogroup", "aria-label": this.label || '' }, hasLabels && (h("div", { key: 'a9bebb49089cd496da9766edc80170d285f3e0f4', class: "co-radio-group__labels" }, this.label && h("span", { key: '07b2fa433d6414e69862ba88bb95485fa59e3cb0', class: "co-radio-group__label" }, this.label), this.secondaryLabel && (h("span", { key: '2fce367eb0415d3d030d0c5385d15a304a4ac2dd', class: "co-radio-group__secondary-label" }, this.secondaryLabel)))), h("div", { key: '22bed181fb344e6954afa82bd2e7d67814c87175', class: {
+            }, role: "radiogroup", "aria-label": this.label || '' }, hasLabels && (h("div", { key: '0e6088377e3cd361749b9aa98f2e6485a76fb577', class: "co-radio-group__labels" }, this.label && h("span", { key: '411bf1ec096311df2b25fac0b39c402d01365e5c', class: "co-radio-group__label" }, this.label), this.secondaryLabel && (h("span", { key: '917cc0dd87362d7add21d407869872a14378a0b9', class: "co-radio-group__secondary-label" }, this.secondaryLabel)))), h("div", { key: '6459fee05efb04d402c0c98dfcbad83fc7da7f06', class: {
                 'co-radio-group__options': true,
                 [`co-radio-group__options--${this.direction}`]: true,
             } }, opts.map(opt => {
@@ -78,7 +83,7 @@ export class CoRadioGroup {
                     'co-radio-group__circle--checked': isChecked,
                     'co-radio-group__circle--disabled': isDisabled,
                 }, role: "radio", "aria-checked": String(isChecked), "aria-label": opt.label }), h("span", { class: "co-radio-group__option-label" }, opt.label)));
-        })), hasHelper && (h("div", { key: '8377e98a33fc79ae642110aded1e8061b7f5a47e', class: `co-radio-group__helper co-radio-group__helper--${this.status}` }, this.statusIcon && (h("co-icon", { key: '3699789297cd963755d3855fda23e3884d85e6e0', name: this.statusIcon, size: 14, weight: "fill", class: "co-radio-group__helper-icon" })), h("span", { key: 'bcec0afba4852a80296ec04ece33708e17309f8b', class: "co-radio-group__helper-text" }, this.helperText)))));
+        })), hasHelper && (h("div", { key: '9cec80138190321eafb700039b2d33d24e420e30', class: `co-radio-group__helper co-radio-group__helper--${this.status}` }, this.statusIcon && (h("co-icon", { key: '8be3d15ffa7d528927f907b4c9523b7f2a6cdb94', name: this.statusIcon, size: 14, weight: "fill", class: "co-radio-group__helper-icon" })), h("span", { key: '6ccf0cfeea7f6e00047b2849edff9fd988eb36a6', class: "co-radio-group__helper-text" }, this.helperText)))));
     }
     static get is() { return "co-radio-group"; }
     static get encapsulation() { return "shadow"; }
@@ -219,7 +224,7 @@ export class CoRadioGroup {
                     "references": {
                         "RadioOption": {
                             "location": "local",
-                            "path": "/Users/agox/worktrees/cobalt-release-2026-09-24/packages/core/src/components/co-radio-group/co-radio-group.tsx",
+                            "path": "/Users/agox/worktrees/cobalt-release-0.11.2/packages/core/src/components/co-radio-group/co-radio-group.tsx",
                             "id": "src/components/co-radio-group/co-radio-group.tsx::RadioOption"
                         }
                     }

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

@@ -1,12 +1,24 @@
 import { h } from "@stencil/core";
+/**
+ * Calificación con estrellas (u otro ícono): el usuario elige de 1 a `max` y
+ * volver a elegir el valor actual lo pone en 0. Wrapper Vue: `CoRating` de
+ * `@prolibu-suite/cobalt-vue`.
+ */
 export class CoRating {
     constructor() {
+        /** Calificación actual, 0 a `max` (reflejado; el componente lo actualiza al elegir). */
         this.value = 0;
+        /** Cantidad de íconos (default 5). */
         this.max = 5;
+        /** Tamaño de los íconos: `small` (default) o `large`. */
         this.size = 'small';
+        /** Deshabilita la interacción y atenúa el control. */
         this.disabled = false;
+        /** Solo muestra el valor, sin interacción ni hover (atributo `read-only`). */
         this.readOnly = false;
+        /** Ícono Phosphor de cada paso (default `star`). */
         this.icon = 'star';
+        /** Estado de validación: colorea el `helperText`. */
         this.status = 'default';
         this.hoverValue = 0;
         this.handleClick = (star) => {
@@ -36,16 +48,16 @@ export class CoRating {
         const iconSize = this.size === 'large' ? 28 : 20;
         const active = this.hoverValue || this.value;
         const stars = Array.from({ length: this.max }, (_, i) => i + 1);
-        return (h("div", { key: 'f5945130cb06fff4082067667d4cf4a5af7c4382', class: {
+        return (h("div", { key: '007e7bf1aef33b6890f98e1fdac362aa3f578802', class: {
                 'co-rating': true,
                 'co-rating--disabled': this.disabled,
                 'co-rating--readonly': this.readOnly,
                 [`co-rating--${this.size}`]: true,
-            } }, this.label && h("label", { key: '5af2e8529dbcbbc467a76f9a45ad724cc352c24a', class: "co-rating__label" }, this.label), h("div", { key: 'bd4f80f83ad087593d5f892d6eb81d80071b0898', class: "co-rating__stars", onMouseLeave: this.handleMouseLeave }, stars.map(star => (h("button", { class: {
+            } }, this.label && h("label", { key: 'ebc8a44655b6f975d792546762d3fe1e4ccf2958', class: "co-rating__label" }, this.label), h("div", { key: 'eba75b8e98a075531afff4fe5781a63119206d7b', class: "co-rating__stars", onMouseLeave: this.handleMouseLeave }, stars.map(star => (h("button", { class: {
                 'co-rating__star': true,
                 'co-rating__star--active': star <= active,
                 'co-rating__star--hover': this.hoverValue > 0 && star <= this.hoverValue,
-            }, type: "button", tabIndex: this.disabled || this.readOnly ? -1 : 0, disabled: this.disabled, onClick: () => this.handleClick(star), onMouseEnter: () => this.handleMouseEnter(star), "aria-label": `${star} of ${this.max}` }, h("co-icon", { name: this.icon, size: iconSize, weight: star <= active ? 'fill' : 'regular' }))))), this.helperText && (h("div", { key: 'e9a4cbfda339926e1c31150129cf7ec6bacc53c2', class: `co-rating__helper co-rating__helper--${this.status}` }, this.statusIcon && h("co-icon", { key: '5b581b2d06bce928c7299d197747f1adb6b4a380', name: this.statusIcon, size: 14, weight: "fill", class: "co-rating__helper-icon" }), h("span", { key: '84dd514c19fe8f76916681da7682377abf3b37ea', class: "co-rating__helper-text" }, this.helperText)))));
+            }, type: "button", tabIndex: this.disabled || this.readOnly ? -1 : 0, disabled: this.disabled, onClick: () => this.handleClick(star), onMouseEnter: () => this.handleMouseEnter(star), "aria-label": `${star} of ${this.max}` }, h("co-icon", { name: this.icon, size: iconSize, weight: star <= active ? 'fill' : 'regular' }))))), this.helperText && (h("div", { key: '571bff4884aa6695e2edcb1ae42baae1d57eb3a0', class: `co-rating__helper co-rating__helper--${this.status}` }, this.statusIcon && h("co-icon", { key: '73cfba25f9b28ea6a6dc7b48c6f2009ac4024779', name: this.statusIcon, size: 14, weight: "fill", class: "co-rating__helper-icon" }), h("span", { key: '4029c8c33d6a967c063a886eca3043b22ecc9a2d', class: "co-rating__helper-text" }, this.helperText)))));
     }
     static get is() { return "co-rating"; }
     static get encapsulation() { return "shadow"; }
@@ -73,7 +85,7 @@ export class CoRating {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Etiqueta del campo."
                 },
                 "getter": false,
                 "setter": false,
@@ -92,7 +104,7 @@ export class CoRating {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Calificaci\u00F3n actual, 0 a `max` (reflejado; el componente lo actualiza al elegir)."
                 },
                 "getter": false,
                 "setter": false,
@@ -112,7 +124,7 @@ export class CoRating {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Cantidad de \u00EDconos (default 5)."
                 },
                 "getter": false,
                 "setter": false,
@@ -132,7 +144,7 @@ export class CoRating {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Tama\u00F1o de los \u00EDconos: `small` (default) o `large`."
                 },
                 "getter": false,
                 "setter": false,
@@ -152,7 +164,7 @@ export class CoRating {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Deshabilita la interacci\u00F3n y aten\u00FAa el control."
                 },
                 "getter": false,
                 "setter": false,
@@ -172,7 +184,7 @@ export class CoRating {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Solo muestra el valor, sin interacci\u00F3n ni hover (atributo `read-only`)."
                 },
                 "getter": false,
                 "setter": false,
@@ -192,7 +204,7 @@ export class CoRating {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "\u00CDcono Phosphor de cada paso (default `star`)."
                 },
                 "getter": false,
                 "setter": false,
@@ -212,7 +224,7 @@ export class CoRating {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Texto de ayuda o de error bajo el control."
                 },
                 "getter": false,
                 "setter": false,
@@ -231,7 +243,7 @@ export class CoRating {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Estado de validaci\u00F3n: colorea el `helperText`."
                 },
                 "getter": false,
                 "setter": false,
@@ -255,7 +267,7 @@ export class CoRating {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Cambi\u00F3 la calificaci\u00F3n (`value` ya est\u00E1 actualizado); `detail` = nuevo valor (0 si se desmarc\u00F3)."
                 },
                 "complexType": {
                     "original": "number",

package/dist/collection/components/co-ref-field/co-ref-field.css

@@ -1,5 +1,19 @@
 /* co-ref-field — reference selector with search + pagination */
 
+/**
+ * @prop --co-ref-field-label-color: Color de la etiqueta.
+ * @prop --co-ref-field-label-font-family: Familia tipográfica de la etiqueta.
+ * @prop --co-ref-field-label-font-size: Tamaño de la etiqueta.
+ * @prop --co-ref-field-label-font-weight: Peso de la etiqueta.
+ * @prop --co-ref-field-label-text-transform: Transformación de la etiqueta (p. ej. uppercase).
+ * @prop --co-ref-field-label-letter-spacing: Espaciado de letras de la etiqueta.
+ * @prop --co-ref-field-trigger-bg: Fondo del trigger.
+ * @prop --co-ref-field-trigger-border-color: Color del borde del trigger.
+ * @prop --co-ref-field-trigger-badge-bg: Fondo de la insignia de estado (`triggerBadgeIcon`).
+ * @prop --co-ref-field-inherited-badge-border: Borde del chip del valor heredado.
+ * @prop --co-ref-field-inherited-badge-color: Color de texto del chip del valor heredado.
+ */
+
 :host {
   display: block;
   font-family: var(--co-font-family-primary);