@vasakgroup/vue-libvasak 0.17.0 → 0.18.0

package/dist/types/dialog/DialogContent.vue.d.ts

@@ -5,22 +5,56 @@ type __VLS_Props = {
      * `md` es el diálogo de siempre: una caja centrada, con borde, fondo y
      * un ancho máximo, que es lo que quiere una pregunta o un formulario.
      *
+     * `lg` es la misma caja más ancha, para un formulario de verdad: la
+     * ventana de redacción del correo, el editor de atajos de Configuración.
+     * Existe como opción y no como clase que se pasa desde afuera porque
+     * pisar el ancho del sistema no es estable: las dos clases van en el
+     * mismo atributo y ahí gana la que Tailwind haya emitido después en la
+     * hoja. `max-w-2xl` le gana a `max-w-lg` por el orden de la escala, y
+     * `max-w-xs` **no**, así que ensanchar funcionaba y angostar no — sin
+     * error, y sin forma de saberlo salvo mirándolo.
+     *
      * `full` ocupa la ventana entera y no dibuja nada —ni borde, ni fondo,
-     * ni relleno—: lo pone quien lo usa. Es para lo que **es** la pantalla
+     * ni relleno— salvo el redondeo de la ventana, que no es decoración:
+     * el panel tapa la pantalla entera y la ventana es transparente con las
+     * esquinas redondeadas, así que sin él el fondo que ponga quien lo usa
+     * asoma en cuadrado por fuera del marco. Lo demás lo pone quien lo usa. Es para lo que **es** la pantalla
      * mientras está abierto, como el visor de fotos de la galería, donde la
      * caja centrada no tiene sentido pero el foco encerrado y el Escape sí.
      *
      * El velo tampoco se tiñe en `full`: el panel lo tapa entero, y las dos
      * capas de color se sumaban a un gris que nadie pidió.
      */
-    size?: 'md' | 'full';
+    size?: 'md' | 'lg' | 'full';
+    /**
+     * Cómo se llama el diálogo cuando no hay un `DialogTitle` visible.
+     *
+     * Lo normal es el título: se registra solo y el `aria-labelledby` lo
+     * apunta. Esto es para cuando el nombre existe pero no como título —el
+     * visor de fotos de la galería lo dibuja en una píldora con su propia
+     * forma— y para cuando no hay ninguno.
+     *
+     * Es una **propiedad declarada** y no un atributo que cae: con
+     * `strictTemplates`, `aria-label` escrito a mano sobre el componente es
+     * un error de tipos, porque la raíz es un `Teleport` y de ahí no se
+     * deduce ningún elemento al que pudiera pertenecer. Lo que quedaba era
+     * `v-bind` de un objeto, que no se comprueba.
+     *
+     * Un `DialogTitle` montado gana: si los dos están, nombra el título.
+     *
+     * `aria-describedby` tiene el mismo problema y **no** se resuelve con
+     * otra propiedad: lo que corresponde es que `DialogDescription` se
+     * registre solo, como ya hace el título. Hoy no lo hace, y nadie lo
+     * pide todavía.
+     */
+    ariaLabel?: string;
 };
 declare var __VLS_13: {};
 type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_13) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
-    size: "md" | "full";
+    size: "md" | "lg" | "full";
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/types/forms/TextInput.vue.d.ts

@@ -41,7 +41,19 @@ type __VLS_Props = {
      */
     lazy?: boolean;
 };
-declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+/**
+ * Enfoca el campo y **dice si lo consiguió**.
+ *
+ * Lo segundo no es un detalle. Un campo dentro de un panel que está `hidden`
+ * no recibe el foco y tampoco falla: `focus()` no hace nada y no avisa, así
+ * que la tecla que lleva al buscador parece rota. Devolviendo si llegó, quien
+ * llama puede mostrar el panel y reintentar sin preguntar cuánto mide la
+ * ventana. Es de la lista del correo, que ya lo había resuelto así.
+ */
+declare function enfocar(): boolean;
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
+    enfocar: typeof enfocar;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     keydown: (evento: KeyboardEvent) => any;
     keyup: (evento: KeyboardEvent) => any;
     "update:modelValue": (valor: string) => any;

package/dist/types/search/SearchField.vue.d.ts

@@ -51,16 +51,25 @@ type __VLS_Props = {
  *
  * Es además la salida para el caso en que el campo aparezca detrás de una
  * animación y el foco de `autofocus` llegue demasiado pronto.
+ *
+ * Se lo pide a `TextInput`, que lo expone. Antes se alcanzaba el elemento por
+ * `$el`, que es `any` y deja de andar sin avisar el día que ese componente
+ * crezca una raíz distinta.
+ *
+ * Devuelve si el foco llegó: dentro de un panel `hidden` no llega y tampoco
+ * falla, y quien llama necesita saberlo para mostrar el panel y reintentar.
  */
-declare function enfocar(): void;
+declare function enfocar(): boolean;
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
     enfocar: typeof enfocar;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     search: (valor: string) => any;
+    keydown: (evento: KeyboardEvent) => any;
     "update:modelValue": (valor: string) => any;
     clear: () => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     onSearch?: ((valor: string) => any) | undefined;
+    onKeydown?: ((evento: KeyboardEvent) => any) | undefined;
     "onUpdate:modelValue"?: ((valor: string) => any) | undefined;
     onClear?: (() => any) | undefined;
 }>, {