@prolibu-suite/cobalt-core 0.11.0 → 0.11.1

package/dist/collection/components/co-rich-text-editor/co-rich-text-editor.js

@@ -9,11 +9,19 @@ import { applyExternalValue, buildOutput, EchoGuard, parseEditorValue, parseFeat
  * ProseMirror builds its editable DOM imperatively — Stencil's scoped CSS would
  * never reach it. All styles live in light DOM via BEM + `--co-*` tokens.
  *
+ * Editor de texto enriquecido configurado por `preset` (tarea, comentario,
+ * notas, email, documento, impresión). Wrapper Vue: `CoRichTextEditor` de
+ * `@prolibu-suite/cobalt-vue`.
+ *
+ * @slot content-end - Zona entre el contenido y la barra inferior (adjuntos pendientes, vistas previas). Siempre montar el hijo y ocultarlo con CSS.
+ * @slot toolbar-end - Al final de la fila de la barra cuando `toolbarPosition="bottom"` (p. ej. el botón «Enviar»). Siempre montar el hijo.
+ *
  * @part wrapper - Outer container
  * @part toolbar - Formatting toolbar
  * @part content - Editable ProseMirror surface
  * @part label - Field label
  * @part helper - Helper text row
+ * @part toolbar-row - Fila de la barra inferior (`toolbarPosition="bottom"`) con el slot `toolbar-end`.
  */
 export class CoRichTextEditor {
     constructor() {
@@ -21,7 +29,9 @@ export class CoRichTextEditor {
         this.value = null;
         /** Preset controlling allowed nodes/marks, toolbar and sanitization. */
         this.preset = 'task';
+        /** Texto de ayuda del editor vacío. */
         this.placeholder = '';
+        /** Estado de validación: pinta el borde y el `helperText` con el color del estado. */
         this.status = 'default';
         /** Visual style. `flat` strips the frame's border and background so it
          *  reads as plain content instead of a boxed control — padding, label,
@@ -31,10 +41,15 @@ export class CoRichTextEditor {
          *  outer box is gone. `default` (the standard bordered box) renders
          *  identically to before this prop existed. */
         this.variant = 'default';
+        /** Deshabilita el editor. */
         this.disabled = false;
+        /** Solo lectura: sin barra ni edición; `coChange` sale en el acto (p. ej. al marcar una casilla de task-list). */
         this.readonly = false;
+        /** Campo obligatorio (marca de requerido en la etiqueta). */
         this.required = false;
+        /** Muestra el contador de caracteres aunque no haya `maxLength`. */
         this.showCharacterCount = false;
+        /** Enfoca el editor al montarse. */
         this.autofocus = false;
         /** Toolbar layout. `auto` uses the preset default. */
         this.toolbar = 'auto';
@@ -231,30 +246,37 @@ export class CoRichTextEditor {
         (_a = this.editor) === null || _a === void 0 ? void 0 : _a.setEditable(!this.disabled && !this.readonly);
     }
     /* ── Public methods (escape hatches + imperative control) ── */
+    /** Documento como JSON de ProseMirror, o `null` si está vacío. */
     async getJSON() {
         return this.editor && !this.editor.isEmpty ? this.editor.getJSON() : null;
     }
+    /** HTML sanitizado según el preset (`getHtml`, no `getHTML`, para no chocar con `HTMLElement`). */
     async getHtml() {
         return this.editor ? this.sanitizeHtml(this.editor.getHTML()) : '';
     }
+    /** Texto plano del documento. */
     async getText() {
         var _a, _b;
         return (_b = (_a = this.editor) === null || _a === void 0 ? void 0 : _a.getText()) !== null && _b !== void 0 ? _b : '';
     }
+    /** Vacía el contenido y emite `coClear`. */
     async clear() {
         if (!this.editor)
             return;
         this.editor.commands.clearContent(true);
         this.coClear.emit();
     }
+    /** Enfoca el editor (`focusEditor`, no `focus`, para no chocar con `HTMLElement`). */
     async focusEditor() {
         var _a;
         (_a = this.editor) === null || _a === void 0 ? void 0 : _a.commands.focus();
     }
+    /** Reemplaza el contenido: HTML (string) o JSON de ProseMirror. */
     async setContent(content) {
         var _a;
         (_a = this.editor) === null || _a === void 0 ? void 0 : _a.commands.setContent(content);
     }
+    /** Instancia Tiptap subyacente (escape hatch para control avanzado), o `null` antes de montar. */
     async getEditorInstance() {
         var _a;
         return (_a = this.editor) !== null && _a !== void 0 ? _a : null;
@@ -1985,11 +2007,11 @@ export class CoRichTextEditor {
         const showToolbar = this.resolvedToolbar !== 'none' && !this.readonly && !this.disabled;
         const showCount = this.showCharacterCount || this.maxLength != null;
         const bottom = this.toolbarPosition === 'bottom';
-        const toolbar = showToolbar && (h("co-rich-text-toolbar", { key: '8d13314a23cc3b290d5a2ac8a2ef1b68f55b9574', class: "co-rich-text-editor__toolbar", part: "toolbar", variant: this.resolvedToolbar, position: this.toolbarPosition, disabled: this.disabled || this.readonly, locale: this.locale, attachmentsEnabled: this.attachmentsEnabled, attachmentAccept: this.attachmentAccept, onCoAttachmentsSelected: (e) => {
+        const toolbar = showToolbar && (h("co-rich-text-toolbar", { key: '6bcb6ab2d8023c96062ce4aa64ef6450357c22e7', class: "co-rich-text-editor__toolbar", part: "toolbar", variant: this.resolvedToolbar, position: this.toolbarPosition, disabled: this.disabled || this.readonly, locale: this.locale, attachmentsEnabled: this.attachmentsEnabled, attachmentAccept: this.attachmentAccept, onCoAttachmentsSelected: (e) => {
                 e.stopPropagation();
                 this.coAttachmentsSelected.emit(e.detail);
             }, ref: (el) => (this.toolbarEl = el) }));
-        return (h("div", { key: '65401af712fa511cf2f30761d4b2ff753dc75a6f', class: {
+        return (h("div", { key: 'acb670aca986206aa8cae2960a9ace5723d5b710', class: {
                 'co-rich-text-editor': true,
                 'co-rich-text-editor--focused': this.hasFocus,
                 'co-rich-text-editor--disabled': this.disabled,
@@ -1998,7 +2020,7 @@ export class CoRichTextEditor {
                 [`co-rich-text-editor--${this.status}`]: this.status !== 'default',
                 'co-rich-text-editor--flat': this.variant === 'flat',
                 'co-rich-text-editor--toolbar-bottom': bottom,
-            }, part: "wrapper" }, (this.label || this.secondaryLabel) && (h("div", { key: '012dc50c67d9ca53896a8ffc329a32909685994e', class: "co-rich-text-editor__labels" }, this.label && h("label", { key: '23b54b1f9556bc1e6ad1a3b3dd0ed9e26a5e7500', class: "co-rich-text-editor__label", part: "label" }, this.label), this.secondaryLabel && (h("span", { key: '534941598c650f1262f046c16a3f30817b0c2d88', class: "co-rich-text-editor__secondary-label" }, this.secondaryLabel)))), h("div", { key: 'f14dbd62014625638da4b209d6f083d3ca16e184', class: "co-rich-text-editor__frame" }, !bottom && toolbar, h("div", { key: '98d5e7aa68b73a51da6a74512ac8a08e6dbb9df0', class: "co-rich-text-editor__box" }, h("div", { key: '16b7aaa9773290a58122595ad188ab6f9db3354b', class: "co-rte-content", part: "content", role: "textbox", "aria-multiline": "true", "aria-label": this.label, "aria-required": this.required ? 'true' : undefined, "aria-invalid": this.status === 'error' ? 'true' : undefined, ref: (el) => (this.contentEl = el) })), h("slot", { key: '0f90fc0c30ee03ec2023f229348debab6e734ade', name: "content-end" }), bottom && (h("div", { key: '68d646dbe5d37c7ebebe105b8ada3584684340e1', class: "co-rich-text-editor__toolbar-row", part: "toolbar-row" }, toolbar, h("slot", { key: '48ec89359f8a6957bf0451384602cabd37a99019', name: "toolbar-end" })))), h("div", { key: '932083b9360e7abbede76a10a3a7eeec1dc88a84', class: "co-rich-text-editor__footer" }, this.helperText && (h("div", { key: '6be15e0e151e9548e2d5a964f864992687113393', class: `co-rich-text-editor__helper co-rich-text-editor__helper--${this.status}`, part: "helper" }, h("co-icon", { key: '456f73c7afec3eb8bd88dc13c2b6942021d31b78', name: this.helperIcon, size: 14 }), h("span", { key: '666d8db7d19a1559f392b2cfea76c393080c2d98' }, this.helperText))), showCount && (h("span", { key: '2d561825e0bc7790407750de52242c87b1515e8c', class: "co-rich-text-editor__count", ref: (el) => (this.charCountEl = el) }, this.charCount, this.maxLength != null ? ` / ${this.maxLength}` : '')))));
+            }, part: "wrapper" }, (this.label || this.secondaryLabel) && (h("div", { key: '0bbda76dde378f9f9dc49593409036efa0306982', class: "co-rich-text-editor__labels" }, this.label && h("label", { key: '328d770182eeba4010337e32359f6e1f96c32e54', class: "co-rich-text-editor__label", part: "label" }, this.label), this.secondaryLabel && (h("span", { key: 'd8b3ac25a32189686226b9fe6da311f6672ca331', class: "co-rich-text-editor__secondary-label" }, this.secondaryLabel)))), h("div", { key: 'ed9d88e6e62a3defe9f302d252eb7f8dd33d4a0a', class: "co-rich-text-editor__frame" }, !bottom && toolbar, h("div", { key: '96625d0fbbc619e7a7f7812c83d1e86df8086da4', class: "co-rich-text-editor__box" }, h("div", { key: '77ce10f2902b9e758c18dabd5e91c5544c0cdd54', class: "co-rte-content", part: "content", role: "textbox", "aria-multiline": "true", "aria-label": this.label, "aria-required": this.required ? 'true' : undefined, "aria-invalid": this.status === 'error' ? 'true' : undefined, ref: (el) => (this.contentEl = el) })), h("slot", { key: '6c2fbaa3625889c4bb6a493be037f4c64b60fece', name: "content-end" }), bottom && (h("div", { key: 'eda6a58e138c36dc412a84aa995dfcbfd6d7e93f', class: "co-rich-text-editor__toolbar-row", part: "toolbar-row" }, toolbar, h("slot", { key: 'f8b01d2d2b27851d474bb174e4e42b45efd96758', name: "toolbar-end" })))), h("div", { key: 'fdffcf44d4d181d30cc6f48e073e3a18c18f48ca', class: "co-rich-text-editor__footer" }, this.helperText && (h("div", { key: '52ab70e42dad525b1fc1c4c27bdb98bedaf5cd90', class: `co-rich-text-editor__helper co-rich-text-editor__helper--${this.status}`, part: "helper" }, h("co-icon", { key: 'c7e79a0292c51c9cf7927eb504401be5fd68b767', name: this.helperIcon, size: 14 }), h("span", { key: '4a09b04c257f3cd605f9b753d12c118312cb65fc' }, this.helperText))), showCount && (h("span", { key: '7c25580b095af4d0ef11e77d13b07cedbf3e61c4', class: "co-rich-text-editor__count", ref: (el) => (this.charCountEl = el) }, this.charCount, this.maxLength != null ? ` / ${this.maxLength}` : '')))));
     }
     static get is() { return "co-rich-text-editor"; }
     static get originalStyleUrls() {
@@ -2072,7 +2094,7 @@ export class CoRichTextEditor {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Texto de ayuda del editor vac\u00EDo."
                 },
                 "getter": false,
                 "setter": false,
@@ -2092,7 +2114,7 @@ export class CoRichTextEditor {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Etiqueta del campo."
                 },
                 "getter": false,
                 "setter": false,
@@ -2111,7 +2133,7 @@ export class CoRichTextEditor {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Texto secundario junto a la etiqueta."
                 },
                 "getter": false,
                 "setter": false,
@@ -2130,7 +2152,7 @@ export class CoRichTextEditor {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Texto de ayuda o de error bajo el editor."
                 },
                 "getter": false,
                 "setter": false,
@@ -2149,7 +2171,7 @@ export class CoRichTextEditor {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Estado de validaci\u00F3n: pinta el borde y el `helperText` con el color del estado."
                 },
                 "getter": false,
                 "setter": false,
@@ -2189,7 +2211,7 @@ export class CoRichTextEditor {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Deshabilita el editor."
                 },
                 "getter": false,
                 "setter": false,
@@ -2209,7 +2231,7 @@ export class CoRichTextEditor {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Solo lectura: sin barra ni edici\u00F3n; `coChange` sale en el acto (p. ej. al marcar una casilla de task-list)."
                 },
                 "getter": false,
                 "setter": false,
@@ -2229,7 +2251,7 @@ export class CoRichTextEditor {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Campo obligatorio (marca de requerido en la etiqueta)."
                 },
                 "getter": false,
                 "setter": false,
@@ -2249,7 +2271,7 @@ export class CoRichTextEditor {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "L\u00EDmite de caracteres (sobrescribe el del preset); muestra el contador \u00ABn / max\u00BB."
                 },
                 "getter": false,
                 "setter": false,
@@ -2268,7 +2290,7 @@ export class CoRichTextEditor {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Muestra el contador de caracteres aunque no haya `maxLength`."
                 },
                 "getter": false,
                 "setter": false,
@@ -2288,7 +2310,7 @@ export class CoRichTextEditor {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Enfoca el editor al montarse."
                 },
                 "getter": false,
                 "setter": false,
@@ -2604,7 +2626,7 @@ export class CoRichTextEditor {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "El editor gan\u00F3 el foco."
                 },
                 "complexType": {
                     "original": "void",
@@ -2619,7 +2641,7 @@ export class CoRichTextEditor {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "El editor perdi\u00F3 el foco (lo sigue `coChange`)."
                 },
                 "complexType": {
                     "original": "void",
@@ -2634,7 +2656,7 @@ export class CoRichTextEditor {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Se vaci\u00F3 el contenido con `clear()`."
                 },
                 "complexType": {
                     "original": "void",
@@ -2723,7 +2745,7 @@ export class CoRichTextEditor {
                     "return": "Promise<object | null>"
                 },
                 "docs": {
-                    "text": "",
+                    "text": "Documento como JSON de ProseMirror, o `null` si est\u00E1 vac\u00EDo.",
                     "tags": []
                 }
             },
@@ -2740,7 +2762,7 @@ export class CoRichTextEditor {
                     "return": "Promise<string>"
                 },
                 "docs": {
-                    "text": "",
+                    "text": "HTML sanitizado seg\u00FAn el preset (`getHtml`, no `getHTML`, para no chocar con `HTMLElement`).",
                     "tags": []
                 }
             },
@@ -2757,7 +2779,7 @@ export class CoRichTextEditor {
                     "return": "Promise<string>"
                 },
                 "docs": {
-                    "text": "",
+                    "text": "Texto plano del documento.",
                     "tags": []
                 }
             },
@@ -2774,7 +2796,7 @@ export class CoRichTextEditor {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "",
+                    "text": "Vac\u00EDa el contenido y emite `coClear`.",
                     "tags": []
                 }
             },
@@ -2791,7 +2813,7 @@ export class CoRichTextEditor {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "",
+                    "text": "Enfoca el editor (`focusEditor`, no `focus`, para no chocar con `HTMLElement`).",
                     "tags": []
                 }
             },
@@ -2812,7 +2834,7 @@ export class CoRichTextEditor {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "",
+                    "text": "Reemplaza el contenido: HTML (string) o JSON de ProseMirror.",
                     "tags": []
                 }
             },
@@ -2835,7 +2857,7 @@ export class CoRichTextEditor {
                     "return": "Promise<Editor | null>"
                 },
                 "docs": {
-                    "text": "",
+                    "text": "Instancia Tiptap subyacente (escape hatch para control avanzado), o `null` antes de montar.",
                     "tags": []
                 }
             }

package/dist/collection/components/co-rich-text-toolbar/co-rich-text-toolbar.js

@@ -9,6 +9,8 @@ import { getRichTextStrings } from "../../utils/richTextI18n";
  *
  * @part toolbar - The toolbar container
  * @part button - A toolbar button
+ *
+ * Wrapper Vue: `CoRichTextToolbar` de `@prolibu-suite/cobalt-vue`.
  */
 export class CoRichTextToolbar {
     constructor() {
@@ -17,6 +19,7 @@ export class CoRichTextToolbar {
         /** Placement inside co-rich-text-editor. `bottom` drops the toolbar's own bottom
          * border/background/rounding: the editor's toolbar row paints the separator. */
         this.position = 'top';
+        /** Deshabilita la barra: sus botones no ejecutan acciones sobre el editor. */
         this.disabled = false;
         /** BCP-47 locale for UI strings (e.g. 'en', 'es-CO', 'pt-BR'). Default English. */
         this.locale = 'en';
@@ -1237,7 +1240,7 @@ export class CoRichTextToolbar {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Deshabilita la barra: sus botones no ejecutan acciones sobre el editor."
                 },
                 "getter": false,
                 "setter": false,

package/dist/collection/components/co-rich-text-viewer/co-rich-text-viewer.js

@@ -30,6 +30,14 @@ const ALLOWED_TAGS = {
 };
 /** iframes are permitted only with an https: source (blocks javascript:/data:/http:). */
 const SAFE_IFRAME_SRC_RE = /^https:\/\/[^\s"'<>]+$/i;
+/**
+ * Visor de solo lectura de contenido rich text (HTML o JSON de ProseMirror),
+ * sanitizado según el `preset`. En `format="html"` no carga Tiptap: solo
+ * DOMPurify. Wrapper Vue: `CoRichTextViewer` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part content - El contenido renderizado.
+ * @part empty - El texto de vacío (`emptyText`) cuando no hay contenido.
+ */
 export class CoRichTextViewer {
     constructor() {
         /** HTML string (default) or ProseMirror JSON string. */

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

@@ -4,6 +4,9 @@ import { h } from "@stencil/core";
  * @slot prefix  - Leading content (icon, checkbox)
  * @slot         - Main content
  * @slot suffix  - Trailing content (switch, badge, action)
+ *
+ * Wrapper Vue: `CoRow` de `@prolibu-suite/cobalt-vue`.
+ * @part row - La fila.
  */
 export class CoRow {
     constructor() {
@@ -13,11 +16,11 @@ export class CoRow {
         this.size = 'sm';
     }
     render() {
-        return (h("div", { key: 'd82c1b834c4c6825da02a0112d78a8e5a6d12219', class: {
+        return (h("div", { key: '077025b2a73f8440400c27923f1d3a7e38cfb346', class: {
                 'co-row': true,
                 [`co-row--${this.position}`]: true,
                 [`co-row--${this.size}`]: true,
-            }, part: "row" }, h("div", { key: '33ae6da740cd01f7b81ed2b76cdba355a9e3e3d2', class: "co-row__prefix" }, h("slot", { key: '9f646baf5b45b931042504b18bc683332f000f6a', name: "prefix" })), h("div", { key: '3c5648a7b0b326ad4c5a547a4ce6f158b85150ec', class: "co-row__content" }, h("slot", { key: '56384849d661312ffd659de530ffb4735fb943c2' })), h("div", { key: 'bf8d524a890d724db01d3216d9128bb00aa9011d', class: "co-row__suffix" }, h("slot", { key: '41aa4471ed0d20f925944e2ef850c0b8f8ec8607', name: "suffix" }))));
+            }, part: "row" }, h("div", { key: '2ffc2d8e5c0ab4779a5599736c877097039fd47f', class: "co-row__prefix" }, h("slot", { key: 'b6cb185d5f1bb577f78d19b9f78fce1be52c5252', name: "prefix" })), h("div", { key: 'f2a34f5554a832d6ae5030bb1138488928025d43', class: "co-row__content" }, h("slot", { key: 'a8ad430becc2e285e4fec43b16a6e29ba9088f8a' })), h("div", { key: '7fef31caadd3fb43571286a2ee13cf42ebbf8d78', class: "co-row__suffix" }, h("slot", { key: '63465e56defc9a0c11bc5a1eba46ac7f150d67fb', name: "suffix" }))));
     }
     static get is() { return "co-row"; }
     static get encapsulation() { return "shadow"; }

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

@@ -3,6 +3,12 @@ import { h } from "@stencil/core";
  * A stacked, multi-segment meter — a pill track split into N contiguous
  * colored segments (e.g. a storage breakdown). Display-only; colors are
  * supplied by the consumer. Provide an external legend via `slot="legend"`.
+ * Wrapper Vue: `CoSegmentedBar` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @slot legend - Leyenda externa bajo la barra.
+ * @part segmented-bar - Contenedor del componente.
+ * @part track - La pista (pastilla) que contiene los segmentos.
+ * @part segment - Cada segmento de color.
  */
 export class CoSegmentedBar {
     constructor() {
@@ -43,13 +49,13 @@ export class CoSegmentedBar {
     render() {
         const segments = this.parsedSegments;
         const total = this.total > 0 ? this.total : 100;
-        return (h("div", { key: 'f7301a9d7e31e6b3fbf6037fb2425b1701af171e', class: "co-segmented-bar", part: "segmented-bar" }, h("div", { key: '22f3063c1db26411e6c0b5e18f1d9249fcf05ca5', class: {
+        return (h("div", { key: '17f9d7dbccca7bf7dbcd3907094712da67b74f97', class: "co-segmented-bar", part: "segmented-bar" }, h("div", { key: '18747edfd30a3bf84e071570e8280b6d783c6c46', class: {
                 'co-segmented-bar__track': true,
                 [`co-segmented-bar__track--radius-${this.radius}`]: true,
             }, part: "track", style: { height: `${this.thickness}px`, background: this.trackColor } }, segments.map((seg, i) => (h("span", { key: i, class: "co-segmented-bar__segment", part: "segment", title: seg.label, style: {
                 width: `${(seg.value / total) * 100}%`,
                 background: seg.color,
-            } })))), h("slot", { key: '3eb6275c7f248d3f93d24f5e44c1c30e6eb4f019', name: "legend" })));
+            } })))), h("slot", { key: 'd04d1e4ade89c3b1e8e20486aceadf994c310092', name: "legend" })));
     }
     static get is() { return "co-segmented-bar"; }
     static get encapsulation() { return "shadow"; }
@@ -154,7 +160,7 @@ export class CoSegmentedBar {
                     "references": {
                         "CoSegment": {
                             "location": "local",
-                            "path": "/Users/agox/worktrees/cobalt-release-2026-09-24/packages/core/src/components/co-segmented-bar/co-segmented-bar.tsx",
+                            "path": "/Users/agox/worktrees/cobalt-docs-2026-09-24/packages/core/src/components/co-segmented-bar/co-segmented-bar.tsx",
                             "id": "src/components/co-segmented-bar/co-segmented-bar.tsx::CoSegment"
                         }
                     }

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

@@ -671,7 +671,19 @@ html[data-overlayscrollbars-viewport~=scrollbarHidden] > body::-webkit-scrollbar
   overflow: auto;
 }
 
-/* co-select — simple dropdown select (no search) */
+/**
+ * @prop --co-select-menu-padding: Padding del panel desplegable (acepta shorthand; default 8px).
+ * @prop --co-select-menu-gap: Separación entre filas del panel (default 0). La lista virtual la lee al abrir.
+ * @prop --co-select-option-height: Alto fijo de fila (default: sin alto fijo, mínimo 32px). La lista virtual lo lee al abrir.
+ * @prop --co-select-option-padding: Padding de la fila (default 8px 12px).
+ * @prop --co-select-option-gap: Separación entre check/ícono y texto de la fila.
+ * @prop --co-select-option-font-size: Tamaño del texto de la opción (default 14px).
+ * @prop --co-select-option-font-weight: Peso del texto de la opción (default 400).
+ * @prop --co-select-caret-size: Tamaño del ícono de apertura del trigger (default 16px).
+ * @prop --co-select-caret-color: Color del ícono de apertura del trigger.
+ */
+
+/* co-select — dropdown select (búsqueda opcional con `searchable`) */
 
 :host {
   display: block;