@vasakgroup/vue-libvasak 0.13.0 → 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/forms/SwitchRow.vue.d.ts

@@ -0,0 +1,31 @@
+type __VLS_Props = {
+    modelValue: boolean;
+    /** El nombre de la opción. Se dibuja, y es el nombre accesible de la fila. */
+    label: string;
+    /** Una línea debajo, para lo que el nombre no alcanza a decir. */
+    description?: string;
+    /** Del tema, por nombre. Las opciones sin identidad propia no llevan. */
+    icon?: string;
+    iconType?: 'icon' | 'symbol';
+    disabled?: boolean;
+};
+declare var __VLS_11: {};
+type __VLS_Slots = {} & {
+    pie?: (props: typeof __VLS_11) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (valor: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((valor: boolean) => any) | undefined;
+}>, {
+    disabled: boolean;
+    iconType: "icon" | "symbol";
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/types/index.d.ts

@@ -34,6 +34,7 @@ import DropdownMenuTrigger from "./dropdown/DropdownMenuTrigger.vue";
 import FormGroup from "./forms/FormGroup.vue";
 import ListCard from "./cards/ListCard.vue";
 import SliderControl from "./forms/SliderControl.vue";
+import SwitchRow from "./forms/SwitchRow.vue";
 import SwitchToggle from "./forms/SwitchToggle.vue";
 import SwitchTrack from "./forms/SwitchTrack.vue";
 import ToggleControl from "./controls/ToggleControl.vue";
@@ -46,7 +47,7 @@ declare const _default: {
     install(app: App): void;
 };
 export default _default;
-export { SideBar, SideButton, SideGroup, SelectField, ThemeIcon, WindowFrame, AppBar, WindowControls, TabBar, TabItem, BarSearch, ActionButton, AlertMessage, EmptyState, ProgressBar, SearchField, SearchSelect, TextInput, ToastArea, ConfigSection, DeviceCard, Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuTrigger, FormGroup, ListCard, SliderControl, SwitchToggle, SwitchTrack, ToggleControl, Tooltip, TooltipContent, TooltipTrigger, TrayIconButton, };
+export { SideBar, SideButton, SideGroup, SelectField, ThemeIcon, WindowFrame, AppBar, WindowControls, TabBar, TabItem, BarSearch, ActionButton, AlertMessage, EmptyState, ProgressBar, SearchField, SearchSelect, TextInput, ToastArea, ConfigSection, DeviceCard, Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuTrigger, FormGroup, ListCard, SliderControl, SwitchRow, SwitchToggle, SwitchTrack, ToggleControl, Tooltip, TooltipContent, TooltipTrigger, TrayIconButton, };
 export type { AvisoTransitorio } from "./feedback/ToastArea.vue";
 export type { TonoDelAviso } from "./feedback/tonos";
 export { CLASES_POR_TONO, rolDelTono } from "./feedback/tonos";
@@ -63,3 +64,15 @@ export type { AccionDePestana, ElementoDePestana } from "./tabs/tipos";
 export type { ContextoDeLaBarra, ControlDeVentana, OrientacionDeLaBarra, PosicionDeLaBarra, } from "./window/tipos";
 export { CLAVE_DE_LA_BARRA, esPosicion, LOS_TRES_CONTROLES, orientacionDe, POSICIONES, usarLaBarra, } from "./window/tipos";
 export { posicionDe, usarLaPosicionDeLaBarra } from "./window/preferencia";
+/**
+ * Vaciar la memoria de iconos del tema.
+ *
+ * Es para las pruebas de quien use la librería, y por eso sale del paquete y no
+ * se queda adentro. Lo resuelto se memoriza por nombre en el módulo, y un
+ * módulo se comparte entre archivos de prueba: el primero que pida un icono con
+ * el tema sin preparar deja **guardado que no hay ninguno**, y cualquier prueba
+ * posterior que lo prepare ya no lo ve. Pasó al adoptar la librería en el
+ * instalador, donde el aviso dejó de dibujar su icono al correr la suite entera
+ * y lo dibujaba bien al correr su archivo solo.
+ */
+export { olvidarLosIconosDelTema } from "./internos/iconoDelTema";

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;