@prolibu-suite/cobalt-core 0.11.0 → 0.11.2

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

@@ -10,23 +10,35 @@ import { getDateStrings } from "../../utils/dateI18n";
  * unset) so it survives JSX attribute serialization. The trigger shows the
  * COMMITTED range; the popover edits a draft that only commits on Apply (or, if
  * `applyOnSelect`, debounced once both ends are chosen — for table filters).
+ * Wrapper Vue: `CoDateRangePicker` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part label - Etiqueta del campo.
+ * @part trigger - Botón que muestra el rango confirmado y abre el popover.
+ * @part helper - Texto de ayuda, o el `errorMessage` cuando el campo es inválido.
  */
 export class CoDateRangePicker {
     constructor() {
         /** JSON `{from,to}` or '' (empty). */
         this.value = '';
+        /** 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 las fechas en el trigger y los campos. Tokens: `yyyy yy MMMM MMM MM M dd d`. */
         this.displayFormat = 'd MMM yyyy';
+        /** Primer día de la semana del calendario: 0 = domingo … 6 = sábado (default 1, lunes). */
         this.firstDayOfWeek = 1;
         /** Show the quick-preset column. */
         this.presets = true;
         /** Allow from === to. */
         this.allowSameDay = true;
+        /** Muestra la acción «Limpiar» en el footer (default `true`); emite `coClear`. */
         this.clearable = true;
         /** Commit (emit coApply) as soon as a full valid range is picked, debounced. */
         this.applyOnSelect = false;
+        /** Deshabilita el campo: no abre el popover. */
         this.disabled = false;
+        /** Solo lectura: muestra el rango pero no permite cambiarlo. */
         this.readonly = false;
+        /** Marca el campo como inválido (validación externa): borde de error y `errorMessage` en lugar de `helperText`. */
         this.invalid = false;
         /** Whether the field is required (renders a required marker on the label). */
         this.required = false;
@@ -39,7 +51,9 @@ export class CoDateRangePicker {
          *  focus ring, disabled and invalid states are unaffected. `default` (the
          *  standard bordered box) renders identically to before this prop existed. */
         this.variant = 'default';
+        /** Lado y alineación del popover respecto del trigger (default `bottom-start`). */
         this.placement = 'bottom-start';
+        /** Popover abierto (reflejado; el componente lo actualiza al abrir y cerrar). */
         this.open = false;
         /** Max viewport width (px) that renders the picker as a bottom sheet. */
         this.mobileBreakpoint = 600;
@@ -384,7 +398,7 @@ export class CoDateRangePicker {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Fecha m\u00EDnima elegible, `YYYY-MM-DD`."
                 },
                 "getter": false,
                 "setter": false,
@@ -403,7 +417,7 @@ export class CoDateRangePicker {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Fecha m\u00E1xima elegible, `YYYY-MM-DD`."
                 },
                 "getter": false,
                 "setter": false,
@@ -422,7 +436,7 @@ export class CoDateRangePicker {
                 "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,
@@ -442,7 +456,7 @@ export class CoDateRangePicker {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Formato de las fechas en el trigger y los campos. Tokens: `yyyy yy MMMM MMM MM M dd d`."
                 },
                 "getter": false,
                 "setter": false,
@@ -462,7 +476,7 @@ export class CoDateRangePicker {
                 "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,
@@ -579,7 +593,7 @@ export class CoDateRangePicker {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Muestra la acci\u00F3n \u00ABLimpiar\u00BB en el footer (default `true`); emite `coClear`."
                 },
                 "getter": false,
                 "setter": false,
@@ -619,7 +633,7 @@ export class CoDateRangePicker {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Deshabilita el campo: no abre el popover."
                 },
                 "getter": false,
                 "setter": false,
@@ -639,7 +653,7 @@ export class CoDateRangePicker {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Solo lectura: muestra el rango pero no permite cambiarlo."
                 },
                 "getter": false,
                 "setter": false,
@@ -659,7 +673,7 @@ export class CoDateRangePicker {
                 "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,
@@ -679,7 +693,7 @@ export class CoDateRangePicker {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Mensaje bajo el campo cuando `invalid` es `true`."
                 },
                 "getter": false,
                 "setter": false,
@@ -698,7 +712,7 @@ export class CoDateRangePicker {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Texto de ayuda bajo el campo."
                 },
                 "getter": false,
                 "setter": false,
@@ -717,7 +731,7 @@ export class CoDateRangePicker {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Etiqueta del campo."
                 },
                 "getter": false,
                 "setter": false,
@@ -756,7 +770,7 @@ export class CoDateRangePicker {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Texto del trigger sin rango; vac\u00EDo = el del `locale`."
                 },
                 "getter": false,
                 "setter": false,
@@ -842,7 +856,7 @@ export class CoDateRangePicker {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Lado y alineaci\u00F3n del popover respecto del trigger (default `bottom-start`)."
                 },
                 "getter": false,
                 "setter": false,
@@ -862,7 +876,7 @@ export class CoDateRangePicker {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Popover abierto (reflejado; el componente lo actualiza al abrir y cerrar)."
                 },
                 "getter": false,
                 "setter": false,
@@ -882,7 +896,7 @@ export class CoDateRangePicker {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Texto del bot\u00F3n \u00ABAplicar\u00BB; vac\u00EDo = el del `locale`."
                 },
                 "getter": false,
                 "setter": false,
@@ -901,7 +915,7 @@ export class CoDateRangePicker {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Texto del bot\u00F3n \u00ABCancelar\u00BB; vac\u00EDo = el del `locale`."
                 },
                 "getter": false,
                 "setter": false,
@@ -920,7 +934,7 @@ export class CoDateRangePicker {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Texto de la acci\u00F3n \u00ABLimpiar\u00BB; vac\u00EDo = el del `locale`."
                 },
                 "getter": false,
                 "setter": false,
@@ -939,7 +953,7 @@ export class CoDateRangePicker {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Etiqueta del campo de inicio (\u00ABDesde\u00BB); vac\u00EDo = la del `locale`."
                 },
                 "getter": false,
                 "setter": false,
@@ -958,7 +972,7 @@ export class CoDateRangePicker {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Etiqueta del campo de fin (\u00ABHasta\u00BB); vac\u00EDo = la del `locale`."
                 },
                 "getter": false,
                 "setter": false,
@@ -1003,7 +1017,7 @@ export class CoDateRangePicker {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Cambi\u00F3 el inicio del borrador (sin confirmar); `detail` = `YYYY-MM-DD` o `null`."
                 },
                 "complexType": {
                     "original": "string | null",
@@ -1018,7 +1032,7 @@ export class CoDateRangePicker {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Cambi\u00F3 el fin del borrador (sin confirmar); `detail` = `YYYY-MM-DD` o `null`."
                 },
                 "complexType": {
                     "original": "string | null",
@@ -1033,7 +1047,7 @@ export class CoDateRangePicker {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Cambi\u00F3 el borrador del rango (sin confirmar); `detail` = `{ from, to }`. Tambi\u00E9n sale al limpiar, con ambos en `null`."
                 },
                 "complexType": {
                     "original": "DateRangeValue",
@@ -1041,7 +1055,7 @@ export class CoDateRangePicker {
                     "references": {
                         "DateRangeValue": {
                             "location": "local",
-                            "path": "/Users/agox/worktrees/cobalt-release-2026-09-24/packages/core/src/components/co-date-range-picker/co-date-range-picker.tsx",
+                            "path": "/Users/agox/worktrees/cobalt-release-0.11.2/packages/core/src/components/co-date-range-picker/co-date-range-picker.tsx",
                             "id": "src/components/co-date-range-picker/co-date-range-picker.tsx::DateRangeValue"
                         }
                     }
@@ -1054,7 +1068,7 @@ export class CoDateRangePicker {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Se confirm\u00F3 el rango (\u00ABAplicar\u00BB o `applyOnSelect`): `value` ya est\u00E1 actualizado; `detail` = `{ from, to }`."
                 },
                 "complexType": {
                     "original": "DateRangeValue",
@@ -1062,7 +1076,7 @@ export class CoDateRangePicker {
                     "references": {
                         "DateRangeValue": {
                             "location": "local",
-                            "path": "/Users/agox/worktrees/cobalt-release-2026-09-24/packages/core/src/components/co-date-range-picker/co-date-range-picker.tsx",
+                            "path": "/Users/agox/worktrees/cobalt-release-0.11.2/packages/core/src/components/co-date-range-picker/co-date-range-picker.tsx",
                             "id": "src/components/co-date-range-picker/co-date-range-picker.tsx::DateRangeValue"
                         }
                     }
@@ -1075,7 +1089,7 @@ export class CoDateRangePicker {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "\u00ABCancelar\u00BB: descarta el borrador y cierra. Sin `detail`."
                 },
                 "complexType": {
                     "original": "void",
@@ -1090,7 +1104,7 @@ export class CoDateRangePicker {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "\u00ABLimpiar\u00BB: vac\u00EDa `value` y cierra. Sin `detail`."
                 },
                 "complexType": {
                     "original": "void",
@@ -1105,7 +1119,7 @@ export class CoDateRangePicker {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Se abri\u00F3 el popover (o la hoja en mobile). No burbujea."
                 },
                 "complexType": {
                     "original": "void",
@@ -1120,7 +1134,7 @@ export class CoDateRangePicker {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Se cerr\u00F3 el popover (o la hoja en mobile). No burbujea."
                 },
                 "complexType": {
                     "original": "void",

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

@@ -44,6 +44,8 @@ const DEFAULT_MINUTES = 9 * 60;
  * to the field; outside-click/sheet-dismiss stay with co-popover/co-drawer and
  * are handled by `closeApplyingDraft` (see its doc for the Escape asymmetry).
  *
+ * Wrapper Vue: `CoDateTimePicker` de `@prolibu-suite/cobalt-vue`.
+ *
  * @part field - The bordered trigger row
  * @part label - The field label
  * @part display - The button that shows the formatted value
@@ -60,18 +62,25 @@ export class CoDateTimePicker {
         this.presetIds = ['morning', 'noon', 'afternoon', 'endOfDay', 'now'];
         /** 12-hour clock (Google style). `false` renders a 24h clock. */
         this.hour12 = true;
+        /** Locale BCP-47: nombres de meses y días, formato de la hora y textos de la UI (es/en/pt). */
         this.locale = 'es-CO';
         /** Date part of the trigger text (tokens yyyy/yy/MMMM/MMM/MM/M/dd/d). */
         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, mirrors co-input/co-date-field: s 28 / sm 32 / md 40 / lg 48. */
         this.size = 'md';
         /** `flat` strips the trigger's border/background so it reads as content. */
         this.variant = 'default';
+        /** Deshabilita el campo. */
         this.disabled = false;
+        /** Solo lectura: muestra el valor pero no abre el panel ni permite limpiar. */
         this.readonly = false;
+        /** Campo obligatorio: marca la etiqueta con el indicador de requerido. */
         this.required = false;
+        /** Botón × para vaciar el valor (default `true`); emite `coClear` y `coChange(null)`. */
         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';
@@ -362,10 +371,10 @@ export class CoDateTimePicker {
     render() {
         var _a;
         const t = getDateStrings(this.locale);
-        return (h("div", { key: 'f5805a061a0ab020f956e9333dd308745385814d', class: "co-date-time-picker", onKeyDown: this.onRootKeyDown }, this.renderLabel(), this.isMobile ? ([
+        return (h("div", { key: 'fd0f8441ff0531546790d1d318a580cd962bf345', class: "co-date-time-picker", onKeyDown: this.onRootKeyDown }, this.renderLabel(), this.isMobile ? ([
             h("div", { class: "co-date-time-picker__trigger", onClick: () => !this.disabled && !this.readonly && this.setOpen(true) }, this.renderTrigger(t)),
             h("co-drawer", { position: "bottom", open: this.open, heading: t.selectDateTime, onCoClose: this.closeApplyingDraft }, h("div", { class: "co-date-time-picker__sheet" }, this.renderPanel(t, true))),
-        ]) : (h("co-popover", { ref: (el) => (this.popoverEl = el), open: this.open, placement: this.placement, offset: 4, closeOnEscape: false, onCoOpen: this.onPopoverOpen, onCoClose: this.onPopoverClose }, h("div", { slot: "trigger", class: "co-date-time-picker__trigger" }, this.renderTrigger(t)), this.open && this.renderPanel(t, false))), this.name && h("input", { key: '58c58310ebc09b22b95ba8c7e231564edc7cecfa', type: "hidden", name: this.name, value: (_a = this.value) !== null && _a !== void 0 ? _a : '' }), this.renderHelper()));
+        ]) : (h("co-popover", { ref: (el) => (this.popoverEl = el), open: this.open, placement: this.placement, offset: 4, closeOnEscape: false, onCoOpen: this.onPopoverOpen, onCoClose: this.onPopoverClose }, h("div", { slot: "trigger", class: "co-date-time-picker__trigger" }, this.renderTrigger(t)), this.open && this.renderPanel(t, false))), this.name && h("input", { key: 'a30aed536d890836f468660f4f40f745504a6731', type: "hidden", name: this.name, value: (_a = this.value) !== null && _a !== void 0 ? _a : '' }), this.renderHelper()));
     }
     static get is() { return "co-date-time-picker"; }
     static get encapsulation() { return "shadow"; }
@@ -530,7 +539,7 @@ export class CoDateTimePicker {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "D\u00EDas bloqueados `YYYY-MM-DD`: array, o JSON / lista separada por comas desde HTML."
                 },
                 "getter": false,
                 "setter": false,
@@ -549,7 +558,7 @@ export class CoDateTimePicker {
                 "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,
@@ -568,7 +577,7 @@ export class CoDateTimePicker {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Locale BCP-47: nombres de meses y d\u00EDas, formato de la hora y textos de la UI (es/en/pt)."
                 },
                 "getter": false,
                 "setter": false,
@@ -608,7 +617,7 @@ export class CoDateTimePicker {
                 "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,
@@ -628,7 +637,7 @@ export class CoDateTimePicker {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Etiqueta del campo."
                 },
                 "getter": false,
                 "setter": false,
@@ -647,7 +656,7 @@ export class CoDateTimePicker {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Texto del campo sin valor; vac\u00EDo = el del `locale`."
                 },
                 "getter": false,
                 "setter": false,
@@ -706,7 +715,7 @@ export class CoDateTimePicker {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Atributo `name` del campo."
                 },
                 "getter": false,
                 "setter": false,
@@ -725,7 +734,7 @@ export class CoDateTimePicker {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Deshabilita el campo."
                 },
                 "getter": false,
                 "setter": false,
@@ -745,7 +754,7 @@ export class CoDateTimePicker {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Solo lectura: muestra el valor pero no abre el panel ni permite limpiar."
                 },
                 "getter": false,
                 "setter": false,
@@ -765,7 +774,7 @@ export class CoDateTimePicker {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Campo obligatorio: marca la etiqueta con el indicador de requerido."
                 },
                 "getter": false,
                 "setter": false,
@@ -785,7 +794,7 @@ export class CoDateTimePicker {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Bot\u00F3n \u00D7 para vaciar el valor (default `true`); emite `coClear` y `coChange(null)`."
                 },
                 "getter": false,
                 "setter": false,
@@ -805,7 +814,7 @@ export class CoDateTimePicker {
                 "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,
@@ -825,7 +834,7 @@ export class CoDateTimePicker {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Mensaje bajo el campo cuando `invalid` es `true`."
                 },
                 "getter": false,
                 "setter": false,
@@ -844,7 +853,7 @@ export class CoDateTimePicker {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Texto de ayuda bajo el campo."
                 },
                 "getter": false,
                 "setter": false,
@@ -970,7 +979,7 @@ export class CoDateTimePicker {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Se vaci\u00F3 el valor con la \u00D7; le sigue un `coChange(null)`. Sin `detail`."
                 },
                 "complexType": {
                     "original": "void",
@@ -985,7 +994,7 @@ export class CoDateTimePicker {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "El campo gan\u00F3 el foco."
                 },
                 "complexType": {
                     "original": "void",
@@ -1000,7 +1009,7 @@ export class CoDateTimePicker {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "El campo perdi\u00F3 el foco."
                 },
                 "complexType": {
                     "original": "void",
@@ -1015,7 +1024,7 @@ export class CoDateTimePicker {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Se abri\u00F3 el panel (popover u hoja en mobile). No burbujea."
                 },
                 "complexType": {
                     "original": "void",
@@ -1030,7 +1039,7 @@ export class CoDateTimePicker {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Se cerr\u00F3 el panel. No burbujea."
                 },
                 "complexType": {
                     "original": "void",