@vasakgroup/vue-libvasak 0.2.3 → 0.3.0

package/src/sidebar/tipos.ts

@@ -0,0 +1,16 @@
+/** Un elemento de la barra lateral: un lugar al que se va. */
+export interface SidebarItem {
+	id: string;
+	label: string;
+	/** Un nombre del tema de iconos del escritorio, no una ruta. */
+	icon?: string;
+	badge?: string | number;
+	disabled?: boolean;
+}
+
+/** Un grupo de elementos, con su título plegable. */
+export interface SidebarCategory {
+	id: string;
+	title: string;
+	items: SidebarItem[];
+}

package/src/types/vue-libvasak.d.ts

@@ -10,18 +10,53 @@ declare module "@vasakgroup/vue-libvasak" {
   }
 
   /* Sidebar */
+  export interface SidebarItem {
+    id: string;
+    label: string;
+    /** Un nombre del tema de iconos del escritorio, no una ruta. */
+    icon?: string;
+    badge?: string | number;
+    disabled?: boolean;
+  }
+
+  export interface SidebarCategory {
+    id: string;
+    title: string;
+    items: SidebarItem[];
+  }
+
   export interface SideBarProps {
+    /** Sin `title` ni `subtitle` no se dibuja el área de título. */
+    title?: string;
+    subtitle?: string;
+    categories?: SidebarCategory[];
+    modelValue?: string;
+    collapsed?: boolean;
+    collapseLabel?: string;
+    expandLabel?: string;
     class?: string;
     [key: string]: any;
   }
 
   export interface SideButtonProps {
-    title?: string;
-    image?: string;
+    label: string;
+    /** Un nombre del tema de iconos, que se vuelve a resolver al cambiar de tema. */
+    icon?: string;
+    active?: boolean;
+    collapsed?: boolean;
+    disabled?: boolean;
+    badge?: string | number;
     class?: string;
     [key: string]: any;
   }
 
+  export interface SideGroupProps {
+    title: string;
+    collapsed?: boolean;
+    defaultOpen?: boolean;
+    [key: string]: any;
+  }
+
   /* Controls */
   export interface ActionButtonProps {
     label: string;
@@ -129,8 +164,9 @@ declare module "@vasakgroup/vue-libvasak" {
 
   /* Component exports */
   export const WindowFrame: DefineComponent<WindowFrameProps, any, any, {}, {}, {}, {}, {}, string>;
-  export const SideBar: DefineComponent<SideBarProps, any, any, {}, {}, {}, {}, {}, string>;
-  export const SideButton: DefineComponent<SideButtonProps, any, any, {}, {}, {}, {}, {}, string>;
+  export const SideBar: DefineComponent<SideBarProps, any, any, {}, {}, {}, {}, { 'update:modelValue': (value: string) => void; 'update:collapsed': (value: boolean) => void; change: (value: string) => void }, string>;
+  export const SideButton: DefineComponent<SideButtonProps, any, any, {}, {}, {}, {}, { click: () => void }, string>;
+  export const SideGroup: DefineComponent<SideGroupProps, any, any, {}, {}, {}, {}, {}, string>;
 
   export const ActionButton: DefineComponent<ActionButtonProps, any, any, {}, {}, {}, {}, { click: () => void }, string>;
   export const ToggleControl: DefineComponent<ToggleControlProps, any, any, {}, {}, {}, {}, { click: () => void }, string>;

package/src/window/WindowFrame.vue

@@ -1,16 +1,17 @@
 <script lang="ts" setup>
-import TopBar from "./TopBar.vue";
-import { defineProps } from "vue";
+/**
+ * El marco de una ventana: la barra superior y lo que va debajo.
+ *
+ * `defineProps` es una macro del compilador de componentes, no una función que
+ * se importe. Importarla desde `vue` choca con la que el compilador declara, y
+ * el typecheck lo decía —sólo que no había ninguno: un `declare module \'*\'`
+ * dejaba todos los imports en `any` y este archivo nunca se comprobó.
+ */
+import TopBar from './TopBar.vue';
 
-const props = defineProps({
-  title: {
-    type: String,
-    default: "Vasak",
-  },
-  image: {
-    type: String,
-    default: "",
-  },
+const props = withDefaults(defineProps<{ title?: string; image?: string }>(), {
+	title: 'Vasak',
+	image: '',
 });
 </script>
 

package/src/.d.ts

@@ -1 +0,0 @@
-declare module '*';