@prolibu-suite/cobalt-core 0.11.0 → 0.11.1

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: '57a1f893056adf9fd06ba6569be6ca56279e9d0a', 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: 'f1ca2acffbcfa44193a5706d1d812137c8b11c40', class: "co-date-field__labels" }, h("label", { key: '17427000b168ab491dc1ecdf14c6ed0be9d14071', class: "co-date-field__label", part: "label" }, this.label, h(RequiredMark, { key: 'a76cd091616df282024058f56d34739183567931', required: this.required })))), h("div", { key: 'e76b4e754f36df73f75066fad89e3a00005423f7', class: "co-date-field__field-row" }, h("div", { key: '9970c2ef78fbfc573f0a6a39c9b3b3382e03b719', class: "co-date-field__field", part: "field" }, h("co-icon", { key: '9e4d98bf770be953b45bbc53e59d3ec5b38d11df', name: "calendar", size: 16, class: "co-date-field__icon" }), h("div", { key: 'ce818cd98844390212bbd9ee40693d7f741cafd9', class: "co-date-field__input-wrapper" }, h("input", { key: 'ccf4825809b19b93bf1027474333af02ad66fa4f', 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: '4e740ed04a5d7f44484626c2afa01f4355041d56', 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: 'bdffd194b7e970843a1e78ac677aeec4db09ac1a', name: "x-circle", size: 16, weight: "fill" }))))), this.name && h("input", { key: '422332a357a4c32bb7192ea63f1537f64ebd3039', type: "hidden", name: this.name, value: (_b = this.value) !== null && _b !== void 0 ? _b : '' }), helper && (h("div", { key: '5c9e228508081f453aea404f19405c68a16d5157', 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: 'fe6e725310bb97ff25388ebf92f88816514241e0', name: "warning-circle", size: 14, class: "co-date-field__helper-icon" })), h("span", { key: 'fac146d794b97ca83ad7ee6e044411b549a1c472', 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",

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

@@ -1,5 +1,8 @@
 import { h } from "@stencil/core";
 /**
+ * Alias de compatibilidad de `co-date-range-picker`: no lo uses en código nuevo.
+ * Wrapper Vue: `CoDateRange` de `@prolibu-suite/cobalt-vue`.
+ *
  * @deprecated Use `<co-date-range-picker>` instead.
  *
  * Thin compatibility shim kept for one release: it renders the canonical
@@ -11,11 +14,17 @@ export class CoDateRange {
     constructor() {
         /** JSON `{from,to}` or empty string. */
         this.value = '';
+        /** Etiqueta del campo. */
         this.label = '';
+        /** Texto del trigger sin rango. */
         this.placeholder = 'Select range';
+        /** Deshabilita el campo. */
         this.disabled = false;
+        /** Acción «Limpiar» en el footer; emite `coClear`. */
         this.clearable = true;
+        /** Columna de rangos rápidos (hoy, esta semana…), traducidos según `locale`. */
         this.presets = true;
+        /** Texto de ayuda bajo el campo. */
         this.helperText = '';
         /** BCP-47 locale. */
         this.locale = 'es';
@@ -33,7 +42,7 @@ export class CoDateRange {
         }
     }
     render() {
-        return (h("co-date-range-picker", { key: 'f979460b1e6de4e3a519534a62258aebce1f2670', value: this.value, label: this.label, placeholder: this.placeholder, disabled: this.disabled, clearable: this.clearable, presets: this.presets, helperText: this.helperText, locale: this.locale, applyLabel: this.applyLabel, clearLabel: this.clearLabel, onCoApply: this.handleApply, onCoClear: () => this.coClear.emit() }));
+        return (h("co-date-range-picker", { key: 'e1d13b772fcd7aa60bbc77a25a5c6cb40a25dd4b', value: this.value, label: this.label, placeholder: this.placeholder, disabled: this.disabled, clearable: this.clearable, presets: this.presets, helperText: this.helperText, locale: this.locale, applyLabel: this.applyLabel, clearLabel: this.clearLabel, onCoApply: this.handleApply, onCoClear: () => this.coClear.emit() }));
     }
     static get is() { return "co-date-range"; }
     static get encapsulation() { return "shadow"; }
@@ -81,7 +90,7 @@ export class CoDateRange {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Etiqueta del campo."
                 },
                 "getter": false,
                 "setter": false,
@@ -101,7 +110,7 @@ export class CoDateRange {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Texto del trigger sin rango."
                 },
                 "getter": false,
                 "setter": false,
@@ -121,7 +130,7 @@ export class CoDateRange {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Deshabilita el campo."
                 },
                 "getter": false,
                 "setter": false,
@@ -141,7 +150,7 @@ export class CoDateRange {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Acci\u00F3n \u00ABLimpiar\u00BB en el footer; emite `coClear`."
                 },
                 "getter": false,
                 "setter": false,
@@ -161,7 +170,7 @@ export class CoDateRange {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Columna de rangos r\u00E1pidos (hoy, esta semana\u2026), traducidos seg\u00FAn `locale`."
                 },
                 "getter": false,
                 "setter": false,
@@ -181,7 +190,7 @@ export class CoDateRange {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Texto de ayuda bajo el campo."
                 },
                 "getter": false,
                 "setter": false,
@@ -221,7 +230,7 @@ export class CoDateRange {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Texto del bot\u00F3n \u00ABAplicar\u00BB; vac\u00EDo = el del `locale`."
                 },
                 "getter": false,
                 "setter": false,
@@ -240,7 +249,7 @@ export class CoDateRange {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Texto de la acci\u00F3n \u00ABLimpiar\u00BB; vac\u00EDo = el del `locale`."
                 },
                 "getter": false,
                 "setter": false,
@@ -280,7 +289,7 @@ export class CoDateRange {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Se vaci\u00F3 el rango con \u00ABLimpiar\u00BB. Sin `detail`."
                 },
                 "complexType": {
                     "original": "void",