@vasakgroup/vue-libvasak 0.14.1 → 0.15.0

package/dist/types/controls/ToggleControl.vue.d.ts

@@ -1,21 +1,58 @@
-interface Props {
+/**
+ * Un botón de icono que alterna algo: Wi-Fi, Bluetooth, el tema.
+ *
+ * ── Lo que le faltaba ───────────────────────────────────────────────────────
+ *
+ * Es un `<button>` cuyo único contenido es un `<img>`, y ese `img` llevaba un
+ * `alt` que por omisión era la cadena vacía. O sea que **por omisión el botón
+ * no tenía nombre**: un lector de pantalla decía «botón» y nada más. Por eso
+ * `label` es obligatorio y reemplaza a `alt` y `tooltip`, que eran dos formas
+ * de nombrar lo mismo y ninguna obligaba a hacerlo.
+ *
+ * Tampoco decía si estaba encendido, que junto con el nombre es todo lo que
+ * este control transmite.
+ */
+type __VLS_Props = {
     icon: string;
-    alt?: string;
-    tooltip?: string;
+    /**
+     * Qué controla este botón, ya traducido. Obligatorio: el botón no tiene
+     * más contenido que un icono, y un icono no tiene nada que leer.
+     */
+    label: string;
+    /**
+     * El estado de dos posiciones, cuando el botón **realmente alterna algo**.
+     *
+     * Se deja en `null` —lo que viene por omisión— en los que abren un panel:
+     * ahí `aria-pressed` mentiría, diría «no presionado» sobre algo que no
+     * tiene dos estados, y lo que hay es sólo el resaltado de `isActive`.
+     *
+     * Es `boolean | null` y no `boolean | undefined` por una trampa de Vue:
+     * **una propiedad booleana que no se pasa llega como `false`**, no como
+     * `undefined`, salvo que tenga un valor por omisión declarado. La copia
+     * del escritorio tenía este mismo criterio escrito en su comentario y no
+     * lo cumplía: medida, ponía `aria-pressed="false"` en todos los botones
+     * que abren un panel. Declarar el `null` es lo que apaga esa conversión, y además es lo que Vue
+     * saca del atributo.
+     *
+     * El `?? undefined` de la plantilla es para el chequeo de tipos y no
+     * para el navegador —`aria-pressed` no acepta `null` en los tipos,
+     * aunque en el DOM `null` y `undefined` borran el atributo igual—. Sin
+     * él no cambia nada de lo que se dibuja, y el chequeo queda en rojo.
+     */
+    pressed?: boolean | null;
     isActive?: boolean;
     isLoading?: boolean;
     iconClass?: Record<string, boolean>;
     customClass?: Record<string, boolean>;
-}
-declare const __VLS_export: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     click: () => any;
-}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     onClick?: (() => any) | undefined;
 }>, {
-    alt: string;
     customClass: Record<string, boolean>;
-    tooltip: string;
     iconClass: Record<string, boolean>;
+    pressed: boolean | null;
     isActive: boolean;
     isLoading: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

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

@@ -1,7 +1,12 @@
 interface Props {
     icon: string;
-    alt?: string;
-    tooltip?: string;
+    /**
+     * Qué regula el deslizador, ya traducido. Obligatorio: el `input` no tiene
+     * `<label>` asociado ni texto propio.
+     */
+    label: string;
+    /** El nombre de la acción del botón, si no es el mismo que el del deslizador. */
+    buttonLabel?: string;
     modelValue: number;
     min?: number;
     max?: number;
@@ -16,8 +21,6 @@ declare const __VLS_export: import("vue").DefineComponent<Props, {}, {}, {}, {},
     "onUpdate:modelValue"?: ((value: number) => any) | undefined;
     onButtonClick?: (() => any) | undefined;
 }>, {
-    alt: string;
-    tooltip: string;
     min: number;
     max: number;
     showButton: boolean;

package/dist/types/tray/TrayIconButton.vue.d.ts

@@ -21,8 +21,8 @@ declare const __VLS_base: import("vue").DefineComponent<Props, {}, {}, {}, {}, i
     alt: string;
     badge: number | null;
     customClass: string | Record<string, boolean>;
-    tooltip: string;
     iconClass: string | Record<string, boolean>;
+    tooltip: string;
     tooltipClass: string | Record<string, boolean>;
     showCustomTooltip: boolean;
     customTooltipText: string;