@vasakgroup/vue-libvasak 0.18.0 → 1.0.0

package/README.md

@@ -19,12 +19,41 @@ Luego, en tu proyecto Vue:
 npm install /ruta/a/vue-libvasak/dist
 ```
 
-O publica el paquete en un registro npm privado/público y luego:
+O desde el registro, que es como la usan las aplicaciones del escritorio:
 
 ```bash
-npm install vue-libvasak
+bun add @vasakgroup/vue-libvasak
 ```
 
+## Versionado
+
+Desde la **1.0.0** esta librería sigue versionado semántico de verdad, y eso
+cambia lo que significa el rango que declara cada aplicación.
+
+Mientras estuvo en `0.x`, el acento **fijaba la minor**: `^0.7.2` aceptaba la
+0.7.9 y **no** aceptaba la 0.8.0. Como un candado que ya satisface el rango no
+se mueve solo, las aplicaciones se quedaban atrás sin que nada fallara —
+compilaban, pasaban sus pruebas y se empaquetaban con los componentes de hacía
+ocho versiones, y lo que se arreglaba acá no les llegaba. Pasó dos veces, y la
+segunda dejó dieciséis de diecisiete aplicaciones repartidas en siete rangos
+distintos.
+
+Con `^1.x` el acento hace lo que todo el mundo cree que hace: **una minor llega
+sola**. Declarar `^1.0.0` alcanza.
+
+Qué se compromete a partir de acá:
+
+- **Lo que se exporta desde `src/index.ts` no desaparece ni cambia de nombre en
+  una minor.** Hay una prueba que lo fija: sacar un componente de la lista
+  pública falla, así que dejar de exportar algo tiene que ser un acto
+  deliberado y va en una mayor.
+- Sumar componentes, propiedades opcionales o eventos nuevos es una minor.
+- Sacar o renombrar lo público, o cambiar el significado de una propiedad
+  existente, es una mayor.
+
+El `0.` de antes no estaba diciendo nada cierto sobre la estabilidad: la
+librería ya tenía diecisiete consumidores y una API que no se movía.
+
 ## Uso
 
 Importa los componentes que necesites:

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

@@ -3,7 +3,22 @@ type __VLS_Props = {
     value: number | null;
     /** Qué está progresando. Lo lee un lector de pantalla. */
     label: string;
+    /**
+     * El color de la franja, para las barras que miden un **nivel**.
+     *
+     * Una copia de un archivo al 95 % va bien; un disco al 95 % no. La
+     * diferencia no la puede adivinar la barra, así que la dice quien la
+     * pone: el monitor pinta en ámbar desde el 75 % y en rojo desde el 90 %,
+     * y era lo único que su copia tenía y ésta no.
+     *
+     * El color no informa solo: `aria-valuenow` ya dice el número, que es lo
+     * que oye quien no lo ve. Sirve para reconocerlo de un vistazo entre
+     * cinco barras, que es justo lo que hace un monitor.
+     */
+    tone?: 'normal' | 'warning' | 'critical';
 };
-declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    tone: "normal" | "warning" | "critical";
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;