@prolibu-suite/cobalt-core 0.11.0 → 0.11.2

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

@@ -2,12 +2,34 @@ import { h } from "@stencil/core";
 import { RequiredMark } from "../../utils/requiredMark";
 import { FieldChip } from "../../utils/fieldChip";
 import { isLightColor } from "../../utils/color";
+/**
+ * Campo para elegir uno o varios registros relacionados (contactos, empresas,
+ * workspaces…) con búsqueda y paginación del lado del host: el componente pinta
+ * el trigger y el panel (`co-option-list`) y emite `coSearch`/`coLoadMore`; el
+ * host responde con `options`, `total` y `loading`. Wrapper Vue: `CoRefField` de
+ * `@prolibu-suite/cobalt-vue`.
+ *
+ * @slot panel - Reemplaza la lista del panel por contenido propio del host (su búsqueda, opciones y accesibilidad); se conservan el chrome del panel y el footer. Selecciona con `selectOption()`.
+ * @slot panel-footer - Contenido libre al pie de la lista del panel (p. ej. un switch), encima de los botones de `showFooter`.
+ *
+ * @part trigger-text - Texto del valor seleccionado en el trigger (modo single).
+ * @part trigger-placeholder - Placeholder del trigger sin valor.
+ * @part trigger-inherited - Texto del valor heredado (`inheritedLabel`) cuando no hay valor.
+ * @part trigger-inherited-badge - Chip junto al valor heredado (`inheritedBadgeLabel`).
+ * @part trigger-badge - Insignia de estado tras el valor (`triggerBadgeIcon`).
+ * @part trigger-edit - Botón lápiz del trigger (`editable`).
+ * @part trigger-clear - Botón × que vacía la selección (`clearable`).
+ * @part trigger-chevron - Ícono de apertura del panel.
+ */
 export class CoRefField {
     constructor() {
         /** Whether the field is required (renders a required marker on the label). */
         this.required = false;
+        /** Texto del trigger sin valor (salvo que haya `inheritedLabel`). */
         this.placeholder = 'Select…';
+        /** Deshabilita el campo: no abre el panel ni muestra × ni lápiz. */
         this.disabled = false;
+        /** Muestra la × que vacía la selección cuando hay valor (default `true`); emite `coClear`. */
         this.clearable = true;
         /** Shows a pencil button on the single-value trigger that emits
          *  `coEditSelected` with the selected record id. The host owns policy
@@ -15,7 +37,9 @@ export class CoRefField {
         this.editable = false;
         /** Accessible name / tooltip for the edit button. */
         this.editLabel = 'Edit';
+        /** Selección múltiple: la selección se pinta como chips y `value` es un JSON array de ids. */
         this.multiple = false;
+        /** Estado de validación: pinta el borde y el `helperText` con el color del estado. */
         this.status = 'default';
         /** Label layout: vertical (label above) or horizontal (label beside) */
         this.layout = 'vertical';
@@ -43,9 +67,13 @@ export class CoRefField {
         /** Total count of matching records from the API. */
         this.total = 0;
         // ── Search props ───────────────────────────────────────────
+        /** Buscador en el panel (default `true`); el filtrado lo hace el host al recibir `coSearch`. */
         this.searchable = true;
+        /** Placeholder del buscador del panel. */
         this.searchPlaceholder = 'Search…';
+        /** Espera en ms entre la última tecla y el `coSearch` (default 350). */
         this.searchDebounce = 350;
+        /** Texto del panel cuando no hay opciones. */
         this.emptyMessage = 'No results found';
         // ── Action props ───────────────────────────────────────────
         /** Show footer buttons (same pattern as co-combobox). */
@@ -505,7 +533,7 @@ export class CoRefField {
     }
     // ── Main render ────────────────────────────────────────────
     render() {
-        return (h("div", { key: '67a5576b8bd40fce7ba99fd4cc32ea6666fc409c', class: "co-ref-field" }, (this.label || this.secondaryLabel) && (h("div", { key: 'e0a34e6913484e07d9b758ffb85969e1f5790603', class: "co-ref-field__labels" }, this.label && (h("label", { key: '7db53aa0ad57d8edbb4d745d52c9c6d6fa7697d1', class: "co-ref-field__label" }, this.labelIcon && (h("co-icon", { key: '220706f3a48453d84de18f8a12574560dcd33f16', class: "co-ref-field__label-icon", name: this.labelIcon, size: 16 })), this.label, h(RequiredMark, { key: 'fd1814aab65fadc89ae8bf8db4af9a7279761c23', required: this.required }))), this.secondaryLabel && (h("span", { key: '9d9292a8295a73536638718a67c97f326cece53a', class: "co-ref-field__secondary-label" }, this.secondaryLabel)))), h("co-popover", { key: '934f77e646fbe81f935415202884eead11b7044b', open: this.isOpen, placement: "bottom-start", matchWidth: !this.panelWidth, offset: 4, onCoOpen: this.handlePopoverOpen, onCoClose: this.handlePopoverClose }, h("div", { key: '840494a7ea54f4c58e77d90e1dc7c57713c26a25', slot: "trigger" }, this.renderTrigger()), this.isOpen && this.renderPanel()), this.helperText && (h("div", { key: '6ee3efb271c12356166e2980b521c31b3bda66ff', class: `co-ref-field__helper co-ref-field__helper--${this.status}` }, this.status !== 'default' && (h("co-icon", { key: '8889e534784663f5dabff0ffba4e7fa946916aa2', name: this.status === 'error' ? 'warning-circle' : this.status === 'success' ? 'check-circle' : 'info', size: 14 })), h("span", { key: 'a731a16b2bd53d83a7a0ed3c75d9cdb9ea3b5191' }, this.helperText)))));
+        return (h("div", { key: 'a3aef08c94e307af533bd47f40d0a4a92fe27d24', class: "co-ref-field" }, (this.label || this.secondaryLabel) && (h("div", { key: '77b6b86ec8180be67198551fdb85c005ff839e1d', class: "co-ref-field__labels" }, this.label && (h("label", { key: '19e162c60bff7a5e65744e21027ebf817bea2574', class: "co-ref-field__label" }, this.labelIcon && (h("co-icon", { key: '966f91705e5f5969361f86f9ef1ef613f458c610', class: "co-ref-field__label-icon", name: this.labelIcon, size: 16 })), this.label, h(RequiredMark, { key: 'b40e66babe9ebc1a812d429ec44711867817a35e', required: this.required }))), this.secondaryLabel && (h("span", { key: '59e005803c24da33bf561e861464128d6a19b0d5', class: "co-ref-field__secondary-label" }, this.secondaryLabel)))), h("co-popover", { key: 'b436e6ba857fd059dd15df3c83e9e321eceda17e', open: this.isOpen, placement: "bottom-start", matchWidth: !this.panelWidth, offset: 4, onCoOpen: this.handlePopoverOpen, onCoClose: this.handlePopoverClose }, h("div", { key: 'c13bb059934db87074ece6e42fb9913f69e4b81c', slot: "trigger" }, this.renderTrigger()), this.isOpen && this.renderPanel()), this.helperText && (h("div", { key: 'e58d1a42f44382f1c1be244d69a89851f32aad85', class: `co-ref-field__helper co-ref-field__helper--${this.status}` }, this.status !== 'default' && (h("co-icon", { key: '95544a78586c34901e3480f9c9b9c0f872362c12', name: this.status === 'error' ? 'warning-circle' : this.status === 'success' ? 'check-circle' : 'info', size: 14 })), h("span", { key: 'e536f2971bd27a87c5785ba7e950c29bd22bfeda' }, this.helperText)))));
     }
     static get is() { return "co-ref-field"; }
     static get encapsulation() { return "shadow"; }
@@ -533,7 +561,7 @@ export class CoRefField {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Etiqueta del campo."
                 },
                 "getter": false,
                 "setter": false,
@@ -572,7 +600,7 @@ export class CoRefField {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Texto secundario junto a la etiqueta (p. ej. \u00ABOpcional\u00BB)."
                 },
                 "getter": false,
                 "setter": false,
@@ -610,7 +638,7 @@ export class CoRefField {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Texto del trigger sin valor (salvo que haya `inheritedLabel`)."
                 },
                 "getter": false,
                 "setter": false,
@@ -630,7 +658,7 @@ export class CoRefField {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Deshabilita el campo: no abre el panel ni muestra \u00D7 ni l\u00E1piz."
                 },
                 "getter": false,
                 "setter": false,
@@ -650,7 +678,7 @@ export class CoRefField {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Muestra la \u00D7 que vac\u00EDa la selecci\u00F3n cuando hay valor (default `true`); emite `coClear`."
                 },
                 "getter": false,
                 "setter": false,
@@ -710,7 +738,7 @@ export class CoRefField {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Selecci\u00F3n m\u00FAltiple: la selecci\u00F3n se pinta como chips y `value` es un JSON array de ids."
                 },
                 "getter": false,
                 "setter": false,
@@ -730,7 +758,7 @@ export class CoRefField {
                 "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,
@@ -750,7 +778,7 @@ export class CoRefField {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Texto de ayuda o de error bajo el campo."
                 },
                 "getter": false,
                 "setter": false,
@@ -769,7 +797,7 @@ export class CoRefField {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "\u00CDcono Phosphor al inicio del trigger."
                 },
                 "getter": false,
                 "setter": false,
@@ -948,7 +976,7 @@ export class CoRefField {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Buscador en el panel (default `true`); el filtrado lo hace el host al recibir `coSearch`."
                 },
                 "getter": false,
                 "setter": false,
@@ -968,7 +996,7 @@ export class CoRefField {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Placeholder del buscador del panel."
                 },
                 "getter": false,
                 "setter": false,
@@ -988,7 +1016,7 @@ export class CoRefField {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Espera en ms entre la \u00FAltima tecla y el `coSearch` (default 350)."
                 },
                 "getter": false,
                 "setter": false,
@@ -1008,7 +1036,7 @@ export class CoRefField {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Texto del panel cuando no hay opciones."
                 },
                 "getter": false,
                 "setter": false,
@@ -1313,7 +1341,7 @@ export class CoRefField {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Cambi\u00F3 la selecci\u00F3n (el componente ya actualiz\u00F3 `value`). `detail.value`: el id\nelegido, o el array completo en `multiple`; `detail.item`: la opci\u00F3n elegida o quitada."
                 },
                 "complexType": {
                     "original": "{ value: string | string[]; item: RefFieldOption }",
@@ -1321,7 +1349,7 @@ export class CoRefField {
                     "references": {
                         "RefFieldOption": {
                             "location": "local",
-                            "path": "/Users/agox/worktrees/cobalt-release-2026-09-24/packages/core/src/components/co-ref-field/co-ref-field.tsx",
+                            "path": "/Users/agox/worktrees/cobalt-release-0.11.2/packages/core/src/components/co-ref-field/co-ref-field.tsx",
                             "id": "src/components/co-ref-field/co-ref-field.tsx::RefFieldOption"
                         }
                     }
@@ -1334,7 +1362,7 @@ export class CoRefField {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Se vaci\u00F3 la selecci\u00F3n (\u00D7 del trigger o deselecci\u00F3n de la fila en single). Sin `detail`."
                 },
                 "complexType": {
                     "original": "void",
@@ -1349,7 +1377,7 @@ export class CoRefField {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "T\u00E9rmino del buscador del panel, con debounce. El host filtra y responde con `options`."
                 },
                 "complexType": {
                     "original": "string",
@@ -1364,7 +1392,7 @@ export class CoRefField {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Pide la p\u00E1gina siguiente de opciones (scroll al final del panel). Sin `detail`."
                 },
                 "complexType": {
                     "original": "void",
@@ -1379,7 +1407,7 @@ export class CoRefField {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Se abri\u00F3 el panel. No burbujea."
                 },
                 "complexType": {
                     "original": "void",
@@ -1394,7 +1422,7 @@ export class CoRefField {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Se cerr\u00F3 el panel. No burbujea."
                 },
                 "complexType": {
                     "original": "void",
@@ -1409,7 +1437,7 @@ export class CoRefField {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Se quit\u00F3 un chip en `multiple`; `detail` = id quitado. Tambi\u00E9n sale `coChange` con la selecci\u00F3n nueva."
                 },
                 "complexType": {
                     "original": "string",
@@ -1424,7 +1452,7 @@ export class CoRefField {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Click en el bot\u00F3n primario del footer (`showFooter`); cierra el panel. Sin `detail`."
                 },
                 "complexType": {
                     "original": "void",
@@ -1439,7 +1467,7 @@ export class CoRefField {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Click en el bot\u00F3n secundario del footer (p. ej. \u00ABNuevo\u00BB); el panel queda abierto. Sin `detail`."
                 },
                 "complexType": {
                     "original": "void",
@@ -1462,7 +1490,7 @@ export class CoRefField {
                     "references": {
                         "RefFieldOption": {
                             "location": "local",
-                            "path": "/Users/agox/worktrees/cobalt-release-2026-09-24/packages/core/src/components/co-ref-field/co-ref-field.tsx",
+                            "path": "/Users/agox/worktrees/cobalt-release-0.11.2/packages/core/src/components/co-ref-field/co-ref-field.tsx",
                             "id": "src/components/co-ref-field/co-ref-field.tsx::RefFieldOption"
                         }
                     }
@@ -1483,7 +1511,7 @@ export class CoRefField {
                     "references": {
                         "RefFieldOption": {
                             "location": "local",
-                            "path": "/Users/agox/worktrees/cobalt-release-2026-09-24/packages/core/src/components/co-ref-field/co-ref-field.tsx",
+                            "path": "/Users/agox/worktrees/cobalt-release-0.11.2/packages/core/src/components/co-ref-field/co-ref-field.tsx",
                             "id": "src/components/co-ref-field/co-ref-field.tsx::RefFieldOption"
                         }
                     }
@@ -1522,7 +1550,7 @@ export class CoRefField {
                         },
                         "RefFieldOption": {
                             "location": "local",
-                            "path": "/Users/agox/worktrees/cobalt-release-2026-09-24/packages/core/src/components/co-ref-field/co-ref-field.tsx",
+                            "path": "/Users/agox/worktrees/cobalt-release-0.11.2/packages/core/src/components/co-ref-field/co-ref-field.tsx",
                             "id": "src/components/co-ref-field/co-ref-field.tsx::RefFieldOption"
                         }
                     },

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. */