@prolibu-suite/cobalt-core 0.10.4 → 0.11.1

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

@@ -1,6 +1,20 @@
 import { h } from "@stencil/core";
 import { RequiredMark } from "../../utils/requiredMark";
 import { rankByMatch } from "../../utils/normalizeText";
+/**
+ * Selector de varias opciones (por defecto `multiple`) con chips en el trigger,
+ * buscador local opcional (`searchable`) y footer de acciones. Para opciones
+ * paginadas del servidor usá `co-ref-field`. Wrapper Vue: `CoCombobox` de
+ * `@prolibu-suite/cobalt-vue`.
+ *
+ * @part wrapper - Contenedor raíz del campo.
+ * @part label - Etiqueta.
+ * @part secondary-label - Texto secundario junto a la etiqueta.
+ * @part trigger - Caja clickeable con los chips seleccionados.
+ * @part clear - Botón × que vacía la selección.
+ * @part dropdown - Panel desplegable con las opciones.
+ * @part helper - Texto de ayuda o de error.
+ */
 export class CoCombobox {
     constructor() {
         /** Whether the field is required (renders a required marker on the label). */
@@ -261,15 +275,15 @@ export class CoCombobox {
         }
     }
     render() {
-        return (h("div", { key: '37a1a6c5d14a61e45a522024b1aecf9ef3421cb5', class: {
+        return (h("div", { key: '8b0ff4418cd4ef8313fb18f597423938668e7c4c', class: {
                 'co-combobox': true,
                 'co-combobox--open': this.isOpen,
                 'co-combobox--disabled': this.disabled,
                 [`co-combobox--${this.size}`]: true,
-            }, part: "wrapper" }, (this.label || this.secondaryLabel) && (h("div", { key: '4db14a62bbdbd01088df7279939cce69eb30f9a3', class: "co-combobox__labels" }, this.label && h("label", { key: '294744758ea6e99f1c68c3b612269aa5fb38e838', class: "co-combobox__label", part: "label" }, this.label, h(RequiredMark, { key: '17c9fd9fe7cac0abd1f6b8bee4f31a9e536758fb', required: this.required })), this.secondaryLabel && (h("span", { key: '457e35ca2dd250a7ecd5c36980ced045fb46f319', class: "co-combobox__secondary-label", part: "secondary-label" }, this.secondaryLabel)))), h("co-popover", { key: '54fdc55762dcf268d1522c345968d39f26fc768e', open: this.isOpen, placement: "bottom-start", matchWidth: true, offset: 4, onCoOpen: this.handlePopoverOpen, onCoClose: this.handlePopoverClose }, h("div", { key: '0bb104f5e51e7ea5b36d7325e178c7c7eadde05c', slot: "trigger", class: "co-combobox__trigger", part: "trigger", role: "combobox", "aria-expanded": this.isOpen ? 'true' : 'false', "aria-haspopup": "listbox", "aria-label": this.label || undefined, "aria-disabled": this.disabled ? 'true' : undefined, "aria-controls": this.isOpen ? CoCombobox.LIST_ID : undefined, tabIndex: this.disabled ? -1 : 0, ref: (el) => (this.triggerEl = el), onClick: this.handleTriggerClick, onKeyDown: this.handleTriggerKeyDown }, this.iconLeft && (h("co-icon", { key: 'ebdfa267be7257aaa2b187fc867cb5d334d91319', name: this.iconLeft, size: 16, class: "co-combobox__icon" })), h("div", { key: '77671cfffe0d593242c776316292dec69af64ed6', class: "co-combobox__input-wrapper", ref: (el) => (this.chipContainerEl = el) }, this.multiple && this.hasValue ? (this.selectedOptions.map(opt => (h("co-chip", { size: "small", "icon-mode": "both", label: opt.label }, h("co-icon", { slot: "icon-left", name: opt.icon || 'circle', size: 10 }), h("co-icon", { slot: "icon-right", name: "x-circle", size: 10, weight: "fill", onClick: (e) => { e.stopPropagation(); this.handleListRemove(opt.value); } }))))) : (h("span", { class: {
+            }, part: "wrapper" }, (this.label || this.secondaryLabel) && (h("div", { key: 'e54542e22563eafd57909405254d85a8b4df3e4f', class: "co-combobox__labels" }, this.label && h("label", { key: '3f54d1ba25400dd89b1e3a59c564f68e8a3785df', class: "co-combobox__label", part: "label" }, this.label, h(RequiredMark, { key: '4b0c64794195101ef3dfac1b656cd393eb19012a', required: this.required })), this.secondaryLabel && (h("span", { key: '51f2ed8dcd890fa162011ccf1fe9e3f96afcc6b9', class: "co-combobox__secondary-label", part: "secondary-label" }, this.secondaryLabel)))), h("co-popover", { key: 'c071e11ad27db937caa615b63d32e056b099ea4a', open: this.isOpen, placement: "bottom-start", matchWidth: true, offset: 4, onCoOpen: this.handlePopoverOpen, onCoClose: this.handlePopoverClose }, h("div", { key: 'c4b215350ab75d791e9f0181f43af320e32506a9', slot: "trigger", class: "co-combobox__trigger", part: "trigger", role: "combobox", "aria-expanded": this.isOpen ? 'true' : 'false', "aria-haspopup": "listbox", "aria-label": this.label || undefined, "aria-disabled": this.disabled ? 'true' : undefined, "aria-controls": this.isOpen ? CoCombobox.LIST_ID : undefined, tabIndex: this.disabled ? -1 : 0, ref: (el) => (this.triggerEl = el), onClick: this.handleTriggerClick, onKeyDown: this.handleTriggerKeyDown }, this.iconLeft && (h("co-icon", { key: '595cfc20ba148cd99e487002d4ce186feaf4b590', name: this.iconLeft, size: 16, class: "co-combobox__icon" })), h("div", { key: '04a932c116df074d9a9e293d7dc3fead24f85e84', class: "co-combobox__input-wrapper", ref: (el) => (this.chipContainerEl = el) }, this.multiple && this.hasValue ? (this.selectedOptions.map(opt => (h("co-chip", { size: "small", "icon-mode": "both", label: opt.label }, h("co-icon", { slot: "icon-left", name: opt.icon || 'circle', size: 10 }), h("co-icon", { slot: "icon-right", name: "x-circle", size: 10, weight: "fill", onClick: (e) => { e.stopPropagation(); this.handleListRemove(opt.value); } }))))) : (h("span", { class: {
                 'co-combobox__text': true,
                 'co-combobox__text--placeholder': !this.hasValue,
-            } }, this.hasValue ? this.displayText : this.placeholder))), this.multiple && this.overflowCount > 0 && (h("span", { key: 'c230748247efc705f21f299254c24b717d7f5af7', class: "co-combobox__overflow-badge" }, this.overflowCount)), this.clearable && this.hasValue && !this.disabled && (h("button", { key: 'b8acd2eeeb17ec672912886e7dfa67abd1026927', class: "co-combobox__clear", type: "button", tabIndex: -1, onClick: this.handleClear, "aria-label": "Clear selection", part: "clear" }, h("co-icon", { key: 'd21e7dec49db82e5514a1562b60596d51ee69094', name: "x-circle", size: 16, weight: "fill" }))), h("co-icon", { key: '51becab683f82d56d93599e701025a640822127c', name: this.isOpen ? 'caret-up' : 'caret-down', size: 16, class: "co-combobox__caret" })), h("div", { key: '8d21ea81c9c5ca9500359f7cedadf12328e4c5eb', class: "co-combobox__dropdown", part: "dropdown" }, this.isOpen && (h("co-option-list", { key: '066a18d85a356c238ff9ced3721c1d3280bce4c8', id: CoCombobox.LIST_ID, ref: (el) => (this.optionListEl = el), items: this.listItemsJson, value: this.multiple ? JSON.stringify(this.selectedValues) : (this.selectedValues[0] || ''), multiple: this.multiple, selectedAffordance: "check", removableItems: this.multiple, virtual: true, searchable: this.searchable, searchPlaceholder: this.searchPlaceholder, searchDebounce: 0, highlightMatches: true, emptyMessage: this.emptyMessage, onCoSearch: (e) => { this.searchQuery = e.detail; }, onCoChange: (e) => this.handleListChange(e.detail), onCoRemoveItem: (e) => this.handleListRemove(e.detail) }, this.showFooter && (h("co-list-footer", { key: '11d5f3fd067ac246e2068bc33a7ef938efef8829', slot: "footer", secondaryLabel: this.footerSecondaryLabel, primaryLabel: this.footerPrimaryLabel, onCoSecondary: this.handleFooterSecondary, onCoPrimary: this.handleFooterPrimary })))))), this.helperText && (h("div", { key: 'aea733779599bf85e1060062b9664821bcd1f003', class: `co-combobox__helper co-combobox__helper--${this.status}`, part: "helper" }, this.statusIcon && h("co-icon", { key: '629698daf7e0005c8849062777daf8b329fe969c', name: this.statusIcon, size: 14, weight: "fill", class: "co-combobox__helper-icon" }), h("span", { key: 'd91bd4fdadedb2eebbe4a2a3c5d033978cb8db76', class: "co-combobox__helper-text" }, this.helperText)))));
+            } }, this.hasValue ? this.displayText : this.placeholder))), this.multiple && this.overflowCount > 0 && (h("span", { key: '3717ddeb6a6cbfb50992f060a94466637d641848', class: "co-combobox__overflow-badge" }, this.overflowCount)), this.clearable && this.hasValue && !this.disabled && (h("button", { key: '3bd22162de7163e761f4deec4813c7bbd2dc7ab3', class: "co-combobox__clear", type: "button", tabIndex: -1, onClick: this.handleClear, "aria-label": "Clear selection", part: "clear" }, h("co-icon", { key: '466f7859e45f36d572e2736f8c67bb028be00e90', name: "x-circle", size: 16, weight: "fill" }))), h("co-icon", { key: '6631ac9f8053225d79b4ec3e70733de96044a5fa', name: this.isOpen ? 'caret-up' : 'caret-down', size: 16, class: "co-combobox__caret" })), h("div", { key: '3d3cf9b043e50c161f48575e625dfa167c0efefd', class: "co-combobox__dropdown", part: "dropdown" }, this.isOpen && (h("co-option-list", { key: '74eb44b2f32b30f5965a24d3d46fd99dba6b05b3', id: CoCombobox.LIST_ID, ref: (el) => (this.optionListEl = el), items: this.listItemsJson, value: this.multiple ? JSON.stringify(this.selectedValues) : (this.selectedValues[0] || ''), multiple: this.multiple, selectedAffordance: "check", removableItems: this.multiple, virtual: true, searchable: this.searchable, searchPlaceholder: this.searchPlaceholder, searchDebounce: 0, highlightMatches: true, emptyMessage: this.emptyMessage, onCoSearch: (e) => { this.searchQuery = e.detail; }, onCoChange: (e) => this.handleListChange(e.detail), onCoRemoveItem: (e) => this.handleListRemove(e.detail) }, this.showFooter && (h("co-list-footer", { key: '00861de6c0f6cd87a9a21d88d9f4fe1dd31afc6c', slot: "footer", secondaryLabel: this.footerSecondaryLabel, primaryLabel: this.footerPrimaryLabel, onCoSecondary: this.handleFooterSecondary, onCoPrimary: this.handleFooterPrimary })))))), this.helperText && (h("div", { key: 'ac1eaf079ae327e76df9723972404a375903689e', class: `co-combobox__helper co-combobox__helper--${this.status}`, part: "helper" }, this.statusIcon && h("co-icon", { key: 'be90b01fda8c51b11bbc73b8ab76085e160492b1', name: this.statusIcon, size: 14, weight: "fill", class: "co-combobox__helper-icon" }), h("span", { key: 'c3921ff5a264d24bbba07358085d92675aadbe9b', class: "co-combobox__helper-text" }, this.helperText)))));
     }
     static get is() { return "co-combobox"; }
     static get encapsulation() { return "shadow"; }
@@ -531,7 +545,7 @@ export class CoCombobox {
                     "references": {
                         "ComboboxOption": {
                             "location": "local",
-                            "path": "/Users/agox/worktrees/cobalt-release-0.10.3/packages/core/src/components/co-combobox/co-combobox.tsx",
+                            "path": "/Users/agox/worktrees/cobalt-docs-2026-09-24/packages/core/src/components/co-combobox/co-combobox.tsx",
                             "id": "src/components/co-combobox/co-combobox.tsx::ComboboxOption"
                         }
                     }

package/dist/collection/components/co-command-search/co-command-search.js

@@ -5,6 +5,17 @@ import { shouldKeepOpen, isEmptyBackspace, applyClientFilter } from "./commandSe
  * Opens as an overlay with a search input and filterable list of items.
  *
  * @slot trigger - Optional trigger element that opens the palette on click
+ *
+ * La búsqueda es del host: escucha `coSearch` y responde con los ítems.
+ * Wrapper Vue: `CoCommandSearch` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part panel - Panel de la paleta.
+ * @part input-row - Fila del buscador (ícono, chips de alcance e input).
+ * @part input - El `<input>` de búsqueda.
+ * @part loading - Loader mientras el host busca.
+ * @part tabs - Fila de pestañas de módulo.
+ * @part results - Área de resultados.
+ * @part favorites - Bloque de favoritos (con la búsqueda vacía).
  */
 export class CoCommandSearch {
     constructor() {
@@ -170,14 +181,14 @@ export class CoCommandSearch {
     render() {
         const items = this.filteredItems;
         return [
-            h("div", { key: '2fa819f611d5e106367baecd8d0d468ef538abb9', class: "co-command-search__trigger", onClick: this.handleTriggerClick }, h("slot", { key: 'ee17e409b1253cc447d9813a458c3b123597caa1', name: "trigger" })),
-            h("co-overlay", { key: '57f2be7cc61b9c73d20af7cabe44f27f52da130b', open: this.open, onCoClose: this.handleOverlayClick }, h("div", { key: '8e582bca997ca0b0ed0b77a26a2f5bce17540159', class: { 'co-command-search': true, 'co-command-search--open': this.open }, part: "panel", role: "dialog", "aria-modal": "true", "aria-label": "Command palette", onClick: this.handlePanelClick, onKeyDown: this.handlePanelKeyDown }, h("div", { key: '6252fab9df91285b063186c0814a678c2f91aec9', class: "co-command-search__input-row", part: "input-row" }, h("co-icon", { key: '4ce68141969cd823f3b6d1e286dcd62609244587', name: "magnifying-glass", size: 20 }), this.parsedChips.map((chip, idx) => (h("span", { class: "co-command-search__facet-chip" }, chip.icon && h("co-icon", { name: chip.icon, size: 12 }), h("span", { class: "co-command-search__facet-chip-label" }, chip.label), h("button", { class: "co-command-search__facet-chip-remove", type: "button", "aria-label": `Remove filter ${chip.label}`, onClick: (e) => {
+            h("div", { key: '37a7fa941fee9d90d58937fea9a968604e825daf', class: "co-command-search__trigger", onClick: this.handleTriggerClick }, h("slot", { key: '23aff571c1cc19b36b1931a5c30d3d3c544eb9b8', name: "trigger" })),
+            h("co-overlay", { key: 'bc74cdb881e5005d12ae0e55f301507715303d63', open: this.open, onCoClose: this.handleOverlayClick }, h("div", { key: '654ab29570bd313809b660cce6ba9f71c0730e57', class: { 'co-command-search': true, 'co-command-search--open': this.open }, part: "panel", role: "dialog", "aria-modal": "true", "aria-label": "Command palette", onClick: this.handlePanelClick, onKeyDown: this.handlePanelKeyDown }, h("div", { key: 'f62ae09d7384d180b4169e1f7c21d14c7f3ca0b3', class: "co-command-search__input-row", part: "input-row" }, h("co-icon", { key: '800323c34524e72dd0255166e45528dcf273a642', name: "magnifying-glass", size: 20 }), this.parsedChips.map((chip, idx) => (h("span", { class: "co-command-search__facet-chip" }, chip.icon && h("co-icon", { name: chip.icon, size: 12 }), h("span", { class: "co-command-search__facet-chip-label" }, chip.label), h("button", { class: "co-command-search__facet-chip-remove", type: "button", "aria-label": `Remove filter ${chip.label}`, onClick: (e) => {
                     e.stopPropagation();
                     this.coChipRemove.emit(idx);
-                } }, h("co-icon", { name: "x", size: 10, weight: "bold" }))))), h("input", { key: '565abed1c59c32ce3336e110cd9da6afadb693b5', class: "co-command-search__input", type: "text", placeholder: this.placeholder, value: this.query, onInput: this.handleInput, onKeyDown: this.handleKeyDown, ref: el => (this.inputEl = el), part: "input", role: "combobox", "aria-expanded": this.open ? 'true' : 'false', "aria-autocomplete": "list" }), this.loading && (h("co-loader", { key: 'f84db9e0b3f9c53d8eae6ab6edb790f189b3e49d', class: "co-command-search__loading", part: "loading", size: "sm" })), h("span", { key: '7f9e3b653c9d52d0438fafbb645506f3a7aa7f2c', class: "co-command-search__shortcut" }, "ESC")), (this.parsedTabs.length > 0 || this.hasMore) && (h("div", { key: 'fd734ad98b004d5e08f601631d6e2c547ef70dca', class: "co-command-search__tabs", part: "tabs", role: "tablist" }, this.parsedTabs.map(tab => {
+                } }, h("co-icon", { name: "x", size: 10, weight: "bold" }))))), h("input", { key: '5468e510b549c996e7208b691b846b2949b2870d', class: "co-command-search__input", type: "text", placeholder: this.placeholder, value: this.query, onInput: this.handleInput, onKeyDown: this.handleKeyDown, ref: el => (this.inputEl = el), part: "input", role: "combobox", "aria-expanded": this.open ? 'true' : 'false', "aria-autocomplete": "list" }), this.loading && (h("co-loader", { key: '300afe578342e795b968c01ec4a941b2fc07c25b', class: "co-command-search__loading", part: "loading", size: "sm" })), h("span", { key: '96c6c03f2330c1c4fbdecba635cc61aee1cef442', class: "co-command-search__shortcut" }, "ESC")), (this.parsedTabs.length > 0 || this.hasMore) && (h("div", { key: 'b05917311a4e65b98ed2e1db1c0cedb9f83bd5a2', class: "co-command-search__tabs", part: "tabs", role: "tablist" }, this.parsedTabs.map(tab => {
                 const active = tab.value === this.activeTab;
                 return (h("co-chip", { class: "co-command-search__tab", role: "tab", "aria-selected": active ? 'true' : 'false', clickable: true, selected: active, variant: active ? 'filled' : 'outlined', color: active ? 'primary' : 'default', iconLeft: tab.icon, label: tab.label, onCoClick: () => this.coTabSelect.emit(active ? '' : tab.value) }));
-            }), this.hasMore && (h("co-chip", { key: 'f5812a94f9f24df93b34abd9588e43b354d6c5e8', class: "co-command-search__tab co-command-search__tab--more", clickable: true, variant: "outlined", label: this.moreLabel, iconRight: "caret-down", onCoClick: () => this.coMoreTabs.emit() })))), h("div", { key: 'b21f950593d51ecb05ffa7f752cd3b8eebf0ef08', class: "co-command-search__results", part: "results" }, this.parsedFavorites.length > 0 && !this.query && (h("div", { key: '054210475307154dbd369a6468e5bd38a88534a2', class: "co-command-search__fav", part: "favorites" }, h("div", { key: '4cc849cf107af9b94cb9715a7d054f6567e75345', class: "co-command-search__fav-grid" }, this.parsedFavorites.map(fav => (h("button", { class: "co-command-search__fav-card", type: "button", onClick: () => this.coSelect.emit(fav.value) }, h("span", { class: "co-command-search__fav-icon", style: { background: fav.color || 'var(--co-semantic-surface-muted)' } }, h("co-icon", { name: fav.icon || 'circle', size: 26, weight: "fill" })), h("span", { class: "co-command-search__fav-label" }, fav.label))))))), h("co-option-list", { key: 'b48e7eb20f3591e8539211343908fa84ca1ebd1f', ref: (el) => (this.optionListEl = el), items: JSON.stringify(items.map((it) => ({
+            }), this.hasMore && (h("co-chip", { key: '36c25c208b1e26394bd02a56dda55d5e0fd912fd', class: "co-command-search__tab co-command-search__tab--more", clickable: true, variant: "outlined", label: this.moreLabel, iconRight: "caret-down", onCoClick: () => this.coMoreTabs.emit() })))), h("div", { key: '72497fec08f07fd6a91f62db10091d7d635eeab9', class: "co-command-search__results", part: "results" }, this.parsedFavorites.length > 0 && !this.query && (h("div", { key: 'be18a43f0e3e5cc4c9ce0cbfacc90c7e5568017b', class: "co-command-search__fav", part: "favorites" }, h("div", { key: '9c29628bb6ba66daf9253aa5d490f7dcc56e4b3b', class: "co-command-search__fav-grid" }, this.parsedFavorites.map(fav => (h("button", { class: "co-command-search__fav-card", type: "button", onClick: () => this.coSelect.emit(fav.value) }, h("span", { class: "co-command-search__fav-icon", style: { background: fav.color || 'var(--co-semantic-surface-muted)' } }, h("co-icon", { name: fav.icon || 'circle', size: 26, weight: "fill" })), h("span", { class: "co-command-search__fav-label" }, fav.label))))))), h("co-option-list", { key: 'ee50dd0d97743a7a85de59f8daf6e45e989a422d', ref: (el) => (this.optionListEl = el), items: JSON.stringify(items.map((it) => ({
                     _id: it.value, label: it.label, icon: it.icon, description: it.subtitle, group: it.section,
                     disabled: it.disabled,
                 }))), autoHighlight: true, highlightMatches: true, highlightTerm: this.query, loading: this.loading, emptyMessage: this.emptyMessage, onCoChange: (e) => this.handleListPick(e.detail.item._id) })))),
@@ -246,7 +257,7 @@ export class CoCommandSearch {
                     "references": {
                         "CommandItem": {
                             "location": "local",
-                            "path": "/Users/agox/worktrees/cobalt-release-0.10.3/packages/core/src/components/co-command-search/co-command-search.tsx",
+                            "path": "/Users/agox/worktrees/cobalt-docs-2026-09-24/packages/core/src/components/co-command-search/co-command-search.tsx",
                             "id": "src/components/co-command-search/co-command-search.tsx::CommandItem"
                         }
                     }
@@ -459,7 +470,7 @@ export class CoCommandSearch {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Se eligi\u00F3 un \u00EDtem (o un favorito) y la paleta se cierra; `detail` = `value` del \u00EDtem.\nLos \u00EDtems con `keepOpen` emiten `coScopeChange` en su lugar."
                 },
                 "complexType": {
                     "original": "string",
@@ -474,7 +485,7 @@ export class CoCommandSearch {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Se cerr\u00F3 la paleta (Escape, click en el fondo o tras elegir)."
                 },
                 "complexType": {
                     "original": "void",
@@ -489,7 +500,7 @@ export class CoCommandSearch {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Cambi\u00F3 el texto del buscador (sin debounce); `detail` = texto."
                 },
                 "complexType": {
                     "original": "string",

package/dist/collection/components/co-data-table/co-data-table.js

@@ -2,7 +2,12 @@ import { measureTruncatedHeaders } from "./headerTruncationLogic";
 import { h } from "@stencil/core";
 import { edgeAutoScrollSpeed, resizeWidth } from "../../utils/columnResize";
 /**
+ * Tabla de datos con columnas configurables, orden, selección de filas,
+ * estado de carga y estado vacío. Wrapper Vue: `CoDataTable` de
+ * `@prolibu-suite/cobalt-vue`.
+ *
  * @slot - Default slot for custom row content (advanced usage)
+ * @part empty - El estado vacío (`emptyTitle`, `emptyMessage`, `emptyIcon`).
  */
 export class CoDataTable {
     constructor() {
@@ -475,12 +480,12 @@ export class CoDataTable {
             : h("slot", { name: "empty-action" }))));
     }
     render() {
-        return (h("div", { key: '6f71533676a2c66ae46b1ee9940b405744cef174', class: {
+        return (h("div", { key: 'db627f32da540ce37e30ef6411c29ffc7be6b7fb', class: {
                 'co-data-table': true,
                 'co-data-table--resizing': this.resizingColumn !== null,
                 'co-data-table--loading': this.loading,
                 'co-data-table--empty': !this.loading && this.parsedRows.length === 0,
-            } }, h("div", { key: '8176dca34858e32ba2ce008ac44cf444ea952f08', class: "co-data-table__scroll" }, h("table", { key: 'f285815728244a7161d91dbed6ca87b158db4de6', class: "co-data-table__table", style: { width: `${this.getTableWidth()}px`, minWidth: '100%' } }, this.renderColgroup(), this.renderHeader(), h("slot", { key: '97f4ed9020a7bdb8b262313a10451e9aff754a8e' }), this.loading ? this.renderSkeletonBody() : null)), this.renderEmpty()));
+            } }, h("div", { key: '03c1c7eb194c077716535a73b753db1b1c7ea49f', class: "co-data-table__scroll" }, h("table", { key: '6401d8f51d991e434b6798ffa800ec05521408bd', class: "co-data-table__table", style: { width: `${this.getTableWidth()}px`, minWidth: '100%' } }, this.renderColgroup(), this.renderHeader(), h("slot", { key: 'ddc92d612b45877c558d2ad8dd567c1ea12d76ef' }), this.loading ? this.renderSkeletonBody() : null)), this.renderEmpty()));
     }
     static get is() { return "co-data-table"; }
     static get originalStyleUrls() {
@@ -504,7 +509,7 @@ export class CoDataTable {
                     "references": {
                         "CoDataTableColumn": {
                             "location": "local",
-                            "path": "/Users/agox/worktrees/cobalt-release-0.10.3/packages/core/src/components/co-data-table/co-data-table.tsx",
+                            "path": "/Users/agox/worktrees/cobalt-docs-2026-09-24/packages/core/src/components/co-data-table/co-data-table.tsx",
                             "id": "src/components/co-data-table/co-data-table.tsx::CoDataTableColumn"
                         }
                     }

package/dist/collection/components/co-data-table-pagination/co-data-table-pagination.js

@@ -1,4 +1,16 @@
 import { h } from "@stencil/core";
+/**
+ * Paginación de tabla: selector de filas por página, total de registros, salto
+ * a página y botones anterior/siguiente. Emite `coPageChange` con
+ * `{ page, pageSize }`. Wrapper Vue: `CoDataTablePagination` de
+ * `@prolibu-suite/cobalt-vue`.
+ *
+ * @part pagination - Contenedor de la barra.
+ * @part dropdown - Selector de filas por página.
+ * @part jump-input - Input de salto a página.
+ * @part prev-btn - Botón «anterior».
+ * @part next-btn - Botón «siguiente».
+ */
 export class CoDataTablePagination {
     constructor() {
         /** Current page (1-based) */
@@ -84,17 +96,17 @@ export class CoDataTablePagination {
     }
     render() {
         const pages = this.getVisiblePages();
-        return (h("div", { key: '7bb75d863d77c1ee257994eb81557f4efd320cf3', class: "co-pagination", part: "pagination" }, h("div", { key: '593441b0dc0178fd73a333636764e29fe60efa49', class: "co-pagination__section" }, h("span", { key: '453dc30bbfbd9eb899c8bd2e7aa112e9f183a8d8', class: "co-pagination__label" }, this.jumpToPageLabel), h("input", { key: 'a806c23c5515f81d4751a69950f3ff944a41c9b9', type: "text", class: "co-pagination__jump-input", value: this.jumpToValue || String(this.page), onInput: (e) => {
+        return (h("div", { key: '0f62fb900604d4deb263f03e8075e2c092e8ce73', class: "co-pagination", part: "pagination" }, h("div", { key: '257d5bc2c25ef058ceb7b41ddfba949e8da0d466', class: "co-pagination__section" }, h("span", { key: '61d243f6e20b8aca4f65c4f95dd0a85a98b70485', class: "co-pagination__label" }, this.jumpToPageLabel), h("input", { key: 'd99b709c2f9ac000adf4922c3cbcd9a745f6be2f', type: "text", class: "co-pagination__jump-input", value: this.jumpToValue || String(this.page), onInput: (e) => {
                 this.jumpToValue = e.target.value;
             }, onKeyDown: (e) => this.handleJumpToPage(e), onFocus: (e) => {
                 e.target.select();
-            }, part: "jump-input" })), h("div", { key: '9eadd04de3cab8260445a2eb133734c3c3aa7cf6', class: "co-pagination__section co-pagination__section--page-size" }, h("div", { key: 'e3dd5337ee92d9fa715fb27b1ff689b4e6fd4559', class: "co-pagination__page-size-trigger", onClick: () => { this.showPageSizeDropdown = !this.showPageSizeDropdown; } }, h("span", { key: '8699129db80a836d122b150d357f3c6d72b21683', class: "co-pagination__page-size-value" }, this.pageSize), h("span", { key: 'cfc74fc55c23887dc2d13efa379458d8ef9dd947', class: "co-pagination__label" }, this.perPageLabel), h("co-icon", { key: '700821528fd851f6c8cbafb07ffe3ba95838d977', name: "caret-down", size: 14 })), this.showPageSizeDropdown && (h("div", { key: 'd0cd76772f54b3a5853d8158dd72d5972a9ef5e8', class: "co-pagination__page-size-dropdown", part: "dropdown" }, this.parsedPageSizes.map(size => (h("button", { class: {
+            }, part: "jump-input" })), h("div", { key: '9737e4830745d75428184b9cb1e45f9cfd713aaf', class: "co-pagination__section co-pagination__section--page-size" }, h("div", { key: '1a025e7dc8fc1cc29547da7633b70e0b1b166ab7', class: "co-pagination__page-size-trigger", onClick: () => { this.showPageSizeDropdown = !this.showPageSizeDropdown; } }, h("span", { key: '5402395084c43c4e828de79454aa2dbb457bf6df', class: "co-pagination__page-size-value" }, this.pageSize), h("span", { key: '8010da33d478ce393f77122926d6d5e30eb6da27', class: "co-pagination__label" }, this.perPageLabel), h("co-icon", { key: '0abd66f654b36912826d9b11357837f1db5b045c', name: "caret-down", size: 14 })), this.showPageSizeDropdown && (h("div", { key: 'ca25c9f67dd28fbf58d903691a6f805168dc255e', class: "co-pagination__page-size-dropdown", part: "dropdown" }, this.parsedPageSizes.map(size => (h("button", { class: {
                 'co-pagination__page-size-option': true,
                 'co-pagination__page-size-option--active': size === this.pageSize,
-            }, onClick: () => this.changePageSize(size) }, size)))))), h("div", { key: '1389c60c3985201af55ba9ba609e020e6fb43c86', class: "co-pagination__spacer" }), h("div", { key: '6254c6c322e1ca929c6f2654ec80887efad30615', class: "co-pagination__section" }, h("span", { key: 'aeb3619ad97e67f866cc982745efb56aafc25f87', class: "co-pagination__count" }, this.totalCount.toLocaleString(), " ", this.recordsLabel)), h("div", { key: 'fae17e08dd1383aaf71587b7efe504d575e198c6', class: "co-pagination__section co-pagination__nav" }, h("button", { key: '912bfea50023f5e039364a5f4e3dc1d7bb2f05e7', class: "co-pagination__nav-btn", disabled: this.page <= 1, onClick: () => this.goToPage(this.page - 1), part: "prev-btn" }, this.previousLabel), pages.map(p => p === '...' ? (h("span", { class: "co-pagination__ellipsis" }, "\u2026")) : (h("button", { class: {
+            }, onClick: () => this.changePageSize(size) }, size)))))), h("div", { key: '3b84c572f6eb902d9bd2787e938014efa710b317', class: "co-pagination__spacer" }), h("div", { key: '0cf60f2844ccd5e7ce370bc57895c874f558b718', class: "co-pagination__section" }, h("span", { key: '944f414d863c494b00df4ac81f688b00597b0af4', class: "co-pagination__count" }, this.totalCount.toLocaleString(), " ", this.recordsLabel)), h("div", { key: '4190fcca176fc5d9918cc6e70c7ab6f5a244dfd7', class: "co-pagination__section co-pagination__nav" }, h("button", { key: '5dbb9d83e9e3df1ad9dc817e5e7995706e9c06b3', class: "co-pagination__nav-btn", disabled: this.page <= 1, onClick: () => this.goToPage(this.page - 1), part: "prev-btn" }, this.previousLabel), pages.map(p => p === '...' ? (h("span", { class: "co-pagination__ellipsis" }, "\u2026")) : (h("button", { class: {
                 'co-pagination__page-btn': true,
                 'co-pagination__page-btn--active': p === this.page,
-            }, onClick: () => this.goToPage(p) }, p))), h("button", { key: '7c933d5a710cb5509b360d23fa0512df1a7a8bc4', class: "co-pagination__nav-btn", disabled: this.page >= this.totalPages, onClick: () => this.goToPage(this.page + 1), part: "next-btn" }, this.nextLabel))));
+            }, onClick: () => this.goToPage(p) }, p))), h("button", { key: '7b27f1e6910b3f8c40198c83a6c6a11a4fbddaeb', class: "co-pagination__nav-btn", disabled: this.page >= this.totalPages, onClick: () => this.goToPage(this.page + 1), part: "next-btn" }, this.nextLabel))));
     }
     static get is() { return "co-data-table-pagination"; }
     static get encapsulation() { return "shadow"; }

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

@@ -24,6 +24,8 @@ import { getDateStrings } from "../../utils/dateI18n";
  * @part input - The native input element
  * @part clear - The clear button
  * @part helper - The helper/error text row
+ *
+ * Wrapper Vue: `CoDateField` de `@prolibu-suite/cobalt-vue`.
  */
 export class CoDateField {
     constructor() {
@@ -35,9 +37,13 @@ export class CoDateField {
         this.locale = 'es-CO';
         /** Display pattern (tokens yyyy/yy/MMMM/MMM/MM/M/dd/d). */
         this.displayFormat = 'd MMM yyyy';
+        /** Deshabilita el campo. */
         this.disabled = false;
+        /** Solo lectura: muestra la fecha pero no permite editarla. */
         this.readonly = false;
+        /** Campo obligatorio: marca la etiqueta con el indicador de requerido. */
         this.required = false;
+        /** Botón × para vaciar la fecha (default `true`). */
         this.clearable = true;
         /** External invalid flag (e.g. from a form controller). OR'd with internal parse failure. */
         this.invalid = false;
@@ -162,20 +168,20 @@ export class CoDateField {
         // should still fall back to the localized default placeholder.
         const placeholder = this.placeholder || t.setDate;
         const helper = this.isInvalid ? this.errorMessage : this.helperText;
-        return (h("div", { key: '0153dfa52a577f005fdcf86035611a0cecf56ecc', class: {
+        return (h("div", { key: 'd93a8860d06fcdd8b89dcb3aeccff5c9c5b38167', class: {
                 'co-date-field': true,
                 'co-date-field--disabled': this.disabled,
                 'co-date-field--focused': this.hasFocus,
                 'co-date-field--filled': this.hasValue,
                 'co-date-field--invalid': this.isInvalid,
                 [`co-date-field--${this.size}`]: true,
-            }, part: "wrapper" }, this.label && (h("div", { key: '477602a3cb3c1440b10d612c194f7d2ae5e03456', class: "co-date-field__labels" }, h("label", { key: '3f0b5d1243e703f70e827a48200355bf028ae4ca', class: "co-date-field__label", part: "label" }, this.label, h(RequiredMark, { key: '47d3b8f98cd50e63412d3ae6ed9f4e300210a60b', required: this.required })))), h("div", { key: '4f3b093f9c159e8476f6285402a5f8349bc55112', class: "co-date-field__field-row" }, h("div", { key: '37bff398a2377f38d34b6a1c6e15b1e0e2de783e', class: "co-date-field__field", part: "field" }, h("co-icon", { key: 'fe82197dcc67464415c3f49e565009acfe7b40b2', name: "calendar", size: 16, class: "co-date-field__icon" }), h("div", { key: '069847b02a6028e2ad0bc3c4a0d3817c899c2fbf', class: "co-date-field__input-wrapper" }, h("input", { key: '4669fc7cf06aff450707bf7975fd1141efdd8304', ref: (el) => (this.inputEl = el), class: "co-date-field__native", type: "text", inputMode: "numeric", autocomplete: "off", value: this.draft, placeholder: placeholder, disabled: this.disabled, readOnly: this.readonly, required: this.required, "aria-invalid": this.isInvalid ? 'true' : 'false', "aria-label": !this.label ? t.dateLabel : undefined, onInput: this.handleInput, onFocus: this.handleFocus, onBlur: this.handleBlur, onKeyDown: this.handleKeyDown, part: "input" })), this.clearable && (h("button", { key: 'fd52945af291236aecf4068625f8872b09e7d22f', class: {
+            }, part: "wrapper" }, this.label && (h("div", { key: '6504b4f052600de1c04f02a06d8bf63e1328d22e', class: "co-date-field__labels" }, h("label", { key: '123e4c3eebf375fb7aa9071122a414236ecf4655', class: "co-date-field__label", part: "label" }, this.label, h(RequiredMark, { key: '2fbfbfe2c135f6c7205650a53085aad1b0eb353c', required: this.required })))), h("div", { key: '6149b5560bde2ef55d161bfefce6eeb09070db58', class: "co-date-field__field-row" }, h("div", { key: '4457e1e7ac2e11246d4c03d5b6c0ae876aba9ff7', class: "co-date-field__field", part: "field" }, h("co-icon", { key: 'd65eba1f429aaaa8e484525aa7c9d51b054bbc76', name: "calendar", size: 16, class: "co-date-field__icon" }), h("div", { key: 'f8a34bef5a3ffadb07f9a74f78a67ef321566a7b', class: "co-date-field__input-wrapper" }, h("input", { key: '2fc599d088b02d4bda53d7839c2c923d63d23552', ref: (el) => (this.inputEl = el), class: "co-date-field__native", type: "text", inputMode: "numeric", autocomplete: "off", value: this.draft, placeholder: placeholder, disabled: this.disabled, readOnly: this.readonly, required: this.required, "aria-invalid": this.isInvalid ? 'true' : 'false', "aria-label": !this.label ? t.dateLabel : undefined, onInput: this.handleInput, onFocus: this.handleFocus, onBlur: this.handleBlur, onKeyDown: this.handleKeyDown, part: "input" })), this.clearable && (h("button", { key: 'f255bb2cb791e9956ee6dc89d19fd320069f566b', class: {
                 'co-date-field__clear': true,
                 'co-date-field__clear--hidden': !showClear,
-            }, type: "button", tabIndex: -1, onMouseDown: (e) => e.preventDefault() /* keep input focus */, onClick: this.handleClear, "aria-label": (_a = this.clearLabel) !== null && _a !== void 0 ? _a : t.clearDate, part: "clear" }, h("co-icon", { key: 'b4552bb9b1c77ffb156684464f14579530c00508', name: "x-circle", size: 16, weight: "fill" }))))), this.name && h("input", { key: '00e95a4ebc29f4d6b9a6dae1dc14456dcb7af21f', type: "hidden", name: this.name, value: (_b = this.value) !== null && _b !== void 0 ? _b : '' }), helper && (h("div", { key: '6c0b2272a6ba4139ad7bbd5e8755ef599f2ebe03', class: {
+            }, type: "button", tabIndex: -1, onMouseDown: (e) => e.preventDefault() /* keep input focus */, onClick: this.handleClear, "aria-label": (_a = this.clearLabel) !== null && _a !== void 0 ? _a : t.clearDate, part: "clear" }, h("co-icon", { key: '9d3aa2b050471790738c5744277c47a78b5c4f35', name: "x-circle", size: 16, weight: "fill" }))))), this.name && h("input", { key: '54a70ac066a6c20f644aecbd73c498485909b084', type: "hidden", name: this.name, value: (_b = this.value) !== null && _b !== void 0 ? _b : '' }), helper && (h("div", { key: '89574b44f7d194a5bfe36e639b00c9c2f62a438e', class: {
                 'co-date-field__helper': true,
                 'co-date-field__helper--error': this.isInvalid,
-            }, part: "helper" }, this.isInvalid && (h("co-icon", { key: 'e9340bf5490100f6b1a93fa7af1950253ae442e7', name: "warning-circle", size: 14, class: "co-date-field__helper-icon" })), h("span", { key: '5bd1d55005d6df5ef159bbd6e60b14c69b0314cc', class: "co-date-field__helper-text" }, helper)))));
+            }, part: "helper" }, this.isInvalid && (h("co-icon", { key: '6a3038de56a98bafdee4e6b11839031b37af9496', name: "warning-circle", size: 14, class: "co-date-field__helper-icon" })), h("span", { key: '9ac954adc74f2fac84abcd3a98fe68120edc1609', class: "co-date-field__helper-text" }, helper)))));
     }
     static get is() { return "co-date-field"; }
     static get encapsulation() { return "shadow"; }
@@ -359,7 +365,7 @@ export class CoDateField {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Etiqueta del campo."
                 },
                 "getter": false,
                 "setter": false,
@@ -378,7 +384,7 @@ export class CoDateField {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Placeholder del input vac\u00EDo; vac\u00EDo = el texto por defecto del `locale`."
                 },
                 "getter": false,
                 "setter": false,
@@ -397,7 +403,7 @@ export class CoDateField {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Atributo `name` del input nativo."
                 },
                 "getter": false,
                 "setter": false,
@@ -416,7 +422,7 @@ export class CoDateField {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Deshabilita el campo."
                 },
                 "getter": false,
                 "setter": false,
@@ -436,7 +442,7 @@ export class CoDateField {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Solo lectura: muestra la fecha pero no permite editarla."
                 },
                 "getter": false,
                 "setter": false,
@@ -456,7 +462,7 @@ export class CoDateField {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Campo obligatorio: marca la etiqueta con el indicador de requerido."
                 },
                 "getter": false,
                 "setter": false,
@@ -476,7 +482,7 @@ export class CoDateField {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Bot\u00F3n \u00D7 para vaciar la fecha (default `true`)."
                 },
                 "getter": false,
                 "setter": false,
@@ -659,7 +665,7 @@ export class CoDateField {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "El input gan\u00F3 el foco."
                 },
                 "complexType": {
                     "original": "void",
@@ -674,7 +680,7 @@ export class CoDateField {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "El input perdi\u00F3 el foco (tras intentar confirmar lo tipeado)."
                 },
                 "complexType": {
                     "original": "void",

package/dist/collection/components/co-date-picker/co-date-picker.js

@@ -18,13 +18,21 @@ import { getDateStrings } from "../../utils/dateI18n";
  *
  * Escape is owned here (co-popover `closeOnEscape=false`) so focus can return to
  * the field; outside-click stays with co-popover.
+ *
+ * Wrapper Vue: `CoDatePicker` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part label - Etiqueta del campo.
+ * @part helper - Texto de ayuda, o el `errorMessage` cuando el campo es inválido.
  */
 export class CoDatePicker {
     constructor() {
         /** Committed value, "YYYY-MM-DD" or null. */
         this.value = null;
+        /** Locale BCP-47: nombres de meses y días, parseo de lo tipeado y textos de la UI (es/en/pt). */
         this.locale = 'es-CO';
+        /** Formato de la fecha visible. Tokens: `yyyy yy MMMM MMM MM M dd d` (el valor sigue siendo `YYYY-MM-DD`). */
         this.displayFormat = 'd MMM yyyy';
+        /** Primer día de la semana del calendario: 0 = domingo … 6 = sábado (default 1, lunes). */
         this.firstDayOfWeek = 1;
         /** Field size, forwarded to the inner co-date-field. */
         this.size = 'md';
@@ -35,10 +43,15 @@ export class CoDatePicker {
          *  this prop existed. co-date-field itself has no `variant` prop, so this
          *  is applied from the outside via `::part(field)` — see co-date-picker.css. */
         this.variant = 'default';
+        /** Deshabilita el campo y el calendario. */
         this.disabled = false;
+        /** Solo lectura: muestra la fecha pero no permite cambiarla. */
         this.readonly = false;
+        /** Campo obligatorio: marca la etiqueta con el indicador de requerido. */
         this.required = false;
+        /** Botón × para vaciar la fecha (default `true`); emite `coClear`. */
         this.clearable = true;
+        /** Marca el campo como inválido (validación externa): borde de error y `errorMessage` en lugar de `helperText`. */
         this.invalid = false;
         /** Label layout: vertical (label above) or horizontal (label beside) */
         this.layout = 'vertical';
@@ -227,7 +240,7 @@ export class CoDatePicker {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Fecha m\u00EDnima elegible, `YYYY-MM-DD`."
                 },
                 "getter": false,
                 "setter": false,
@@ -246,7 +259,7 @@ export class CoDatePicker {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Fecha m\u00E1xima elegible, `YYYY-MM-DD`."
                 },
                 "getter": false,
                 "setter": false,
@@ -265,7 +278,7 @@ export class CoDatePicker {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Fechas bloqueadas `YYYY-MM-DD`: array, o JSON / lista separada por comas desde HTML."
                 },
                 "getter": false,
                 "setter": false,
@@ -284,7 +297,7 @@ export class CoDatePicker {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "D\u00EDas de la semana bloqueados (0 = domingo \u2026 6 = s\u00E1bado): array, o JSON / lista separada por comas."
                 },
                 "getter": false,
                 "setter": false,
@@ -303,7 +316,7 @@ export class CoDatePicker {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Locale BCP-47: nombres de meses y d\u00EDas, parseo de lo tipeado y textos de la UI (es/en/pt)."
                 },
                 "getter": false,
                 "setter": false,
@@ -323,7 +336,7 @@ export class CoDatePicker {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Formato de la fecha visible. Tokens: `yyyy yy MMMM MMM MM M dd d` (el valor sigue siendo `YYYY-MM-DD`)."
                 },
                 "getter": false,
                 "setter": false,
@@ -343,7 +356,7 @@ export class CoDatePicker {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Primer d\u00EDa de la semana del calendario: 0 = domingo \u2026 6 = s\u00E1bado (default 1, lunes)."
                 },
                 "getter": false,
                 "setter": false,
@@ -363,7 +376,7 @@ export class CoDatePicker {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Etiqueta del campo."
                 },
                 "getter": false,
                 "setter": false,
@@ -382,7 +395,7 @@ export class CoDatePicker {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Placeholder del campo vac\u00EDo; vac\u00EDo = el del `locale`."
                 },
                 "getter": false,
                 "setter": false,
@@ -441,7 +454,7 @@ export class CoDatePicker {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Atributo `name` del input interno."
                 },
                 "getter": false,
                 "setter": false,
@@ -460,7 +473,7 @@ export class CoDatePicker {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Deshabilita el campo y el calendario."
                 },
                 "getter": false,
                 "setter": false,
@@ -480,7 +493,7 @@ export class CoDatePicker {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Solo lectura: muestra la fecha pero no permite cambiarla."
                 },
                 "getter": false,
                 "setter": false,
@@ -500,7 +513,7 @@ export class CoDatePicker {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Campo obligatorio: marca la etiqueta con el indicador de requerido."
                 },
                 "getter": false,
                 "setter": false,
@@ -520,7 +533,7 @@ export class CoDatePicker {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Bot\u00F3n \u00D7 para vaciar la fecha (default `true`); emite `coClear`."
                 },
                 "getter": false,
                 "setter": false,
@@ -540,7 +553,7 @@ export class CoDatePicker {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Marca el campo como inv\u00E1lido (validaci\u00F3n externa): borde de error y `errorMessage` en lugar de `helperText`."
                 },
                 "getter": false,
                 "setter": false,
@@ -560,7 +573,7 @@ export class CoDatePicker {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Mensaje bajo el campo cuando es inv\u00E1lido (`invalid` o un tipeo que no se pudo interpretar)."
                 },
                 "getter": false,
                 "setter": false,
@@ -579,7 +592,7 @@ export class CoDatePicker {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Texto de ayuda bajo el campo."
                 },
                 "getter": false,
                 "setter": false,
@@ -710,7 +723,7 @@ export class CoDatePicker {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Texto crudo mientras se tipea (sin confirmar); `detail` = string."
                 },
                 "complexType": {
                     "original": "string",
@@ -725,7 +738,7 @@ export class CoDatePicker {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Se confirm\u00F3 una fecha v\u00E1lida (tipeada o elegida en el calendario) o se vaci\u00F3: `detail` = `YYYY-MM-DD` o `null`. `value` ya est\u00E1 actualizado."
                 },
                 "complexType": {
                     "original": "string | null",
@@ -740,7 +753,7 @@ export class CoDatePicker {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Lo tipeado no es una fecha v\u00E1lida (p. ej. `31/02/2026`): no se confirma nada; `detail` = `{ raw }`."
                 },
                 "complexType": {
                     "original": "{ raw: string }",
@@ -755,7 +768,7 @@ export class CoDatePicker {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Se vaci\u00F3 la fecha con la \u00D7. Sin `detail`."
                 },
                 "complexType": {
                     "original": "void",
@@ -770,7 +783,7 @@ export class CoDatePicker {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "El input gan\u00F3 el foco."
                 },
                 "complexType": {
                     "original": "void",
@@ -785,7 +798,7 @@ export class CoDatePicker {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "El input perdi\u00F3 el foco."
                 },
                 "complexType": {
                     "original": "void",
@@ -800,7 +813,7 @@ export class CoDatePicker {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Se abri\u00F3 el calendario (popover u hoja en mobile). No burbujea."
                 },
                 "complexType": {
                     "original": "void",
@@ -815,7 +828,7 @@ export class CoDatePicker {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Se cerr\u00F3 el calendario. No burbujea."
                 },
                 "complexType": {
                     "original": "void",