nuance-ui 0.1.7 → 0.1.8

package/dist/module.json

@@ -4,7 +4,7 @@
   "compatibility": {
     "nuxt": "^4.0.0"
   },
-  "version": "0.1.7",
+  "version": "0.1.8",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "3.6.1"

package/dist/module.mjs

@@ -24,26 +24,7 @@ const module$1 = defineNuxtModule({
     "@nuxt/icon": {
       version: ">=2.1.0",
       defaults: {
-        mode: "svg",
-        class: "",
-        clientBundle: {
-          scan: {
-            globInclude: ["src/**/*.vue", "src/**/*.ts"],
-            globExclude: [
-              "node_modules",
-              ".idea",
-              ".output",
-              ".data",
-              ".nuxt",
-              ".nitro",
-              ".cache",
-              "dist",
-              "server"
-            ]
-          },
-          includeCustomCollections: true,
-          sizeLimitKb: 256
-        }
+        class: ""
       }
     }
   },

package/dist/runtime/components/box.d.vue.ts

@@ -1,4 +1,4 @@
-import type { Mod } from '@nui/composals';
+import type { Mod } from '@nui/utils';
 import type { Component } from 'vue';
 export interface BoxProps {
     is?: keyof HTMLElementTagNameMap | Component;

package/dist/runtime/components/box.vue

@@ -1,10 +1,18 @@
 <script setup>
-import { useMod } from "@nui/composals";
+import { getMod, isFalsy } from "@nui/utils";
+import { computed } from "vue";
 const { is = "div", mod } = defineProps({
   is: { type: null, required: false },
   mod: { type: [Object, Array, null], required: false }
 });
-const _mod = useMod(mod);
+const _mod = computed(() => {
+  if (!mod)
+    return null;
+  if (Array.isArray(mod)) {
+    return mod.filter((i) => !isFalsy(i)).reduce((acc, value) => ({ ...acc, ...getMod(value) }), {});
+  }
+  return getMod(mod);
+});
 </script>
 
 <template>

package/dist/runtime/components/box.vue.d.ts

@@ -1,4 +1,4 @@
-import type { Mod } from '@nui/composals';
+import type { Mod } from '@nui/utils';
 import type { Component } from 'vue';
 export interface BoxProps {
     is?: keyof HTMLElementTagNameMap | Component;

package/dist/runtime/components/button/button.vue

@@ -34,6 +34,7 @@ const {
   is: { type: null, required: false },
   mod: { type: [Object, Array, null], required: false }
 });
+const mod = computed(() => [{ loading, variant }, _mod]);
 const style = computed(() => useStyleResolver((theme) => {
   const {
     background,
@@ -60,18 +61,17 @@ const style = computed(() => useStyleResolver((theme) => {
     }
   };
 }));
-const mod = computed(() => [{ loading, variant }, _mod]);
 </script>
 
 <template>
 	<Box
 		:is
 		:mod='[
-  mod,
   {
     "with-left-section": !!$slots?.leftSection,
     "with-right-section": !!$slots?.rightSection
-  }
+  },
+  mod
 ]'
 		:style='style.root'
 		:class='[css.root, classes?.root]'

package/dist/runtime/components/checkbox/checkbox-card.d.vue.ts

@@ -1,5 +1,5 @@
-import type { Mod } from '@nui/composals';
 import type { NuanceRadius } from '@nui/types';
+import type { Mod } from '@nui/utils';
 export interface CheckboxCardProps {
     mod?: Mod | Mod[];
     withBorder?: boolean;

package/dist/runtime/components/checkbox/checkbox-card.vue.d.ts

@@ -1,5 +1,5 @@
-import type { Mod } from '@nui/composals';
 import type { NuanceRadius } from '@nui/types';
+import type { Mod } from '@nui/utils';
 export interface CheckboxCardProps {
     mod?: Mod | Mod[];
     withBorder?: boolean;

package/dist/runtime/components/index.d.ts

@@ -17,10 +17,12 @@ export * from './modal/index.js';
 export * from './nav-link/index.js';
 export * from './paper.vue.js';
 export * from './popover/index.js';
+export * from './roving-focus/index.js';
 export * from './select/index.js';
 export * from './tabs/index.js';
 export * from './text.vue.js';
 export * from './textarea.vue.js';
 export * from './title.vue.js';
 export * from './transition/index.js';
+export * from './tree/index.js';
 export * from './visually-hidden/index.js';

package/dist/runtime/components/index.js

@@ -17,10 +17,12 @@ export * from "./modal/index.js";
 export * from "./nav-link/index.js";
 export * from "./paper.vue";
 export * from "./popover/index.js";
+export * from "./roving-focus/index.js";
 export * from "./select/index.js";
 export * from "./tabs/index.js";
 export * from "./text.vue";
 export * from "./textarea.vue";
 export * from "./title.vue";
 export * from "./transition/index.js";
+export * from "./tree/index.js";
 export * from "./visually-hidden/index.js";

package/dist/runtime/components/link/lib.d.ts

@@ -3,14 +3,14 @@ export declare function extractNuxtLinkProps<T extends NuxtLinkProps>(props: T):
     link: {
         prefetch: NonNullable<import("vue").UnwrapRef<T["prefetch"]>> | undefined;
         noPrefetch: NonNullable<import("vue").UnwrapRef<T["noPrefetch"]>> | undefined;
+        to?: import("vue").UnwrapRef<T["to"]> | undefined;
         target?: import("vue").UnwrapRef<T["target"]> | undefined;
         replace?: import("vue").UnwrapRef<T["replace"]> | undefined;
-        to?: import("vue").UnwrapRef<T["to"]> | undefined;
         external?: import("vue").UnwrapRef<T["external"]> | undefined;
         rel?: import("vue").UnwrapRef<T["rel"]> | undefined;
         noRel?: import("vue").UnwrapRef<T["noRel"]> | undefined;
         prefetchOn?: import("vue").UnwrapRef<T["prefetchOn"]> | undefined;
         trailingSlash?: import("vue").UnwrapRef<T["trailingSlash"]> | undefined;
     };
-    rest: Omit<T, Extract<"target", keyof T> | Extract<"replace", keyof T> | Extract<"to", keyof T> | Extract<"external", keyof T> | Extract<"rel", keyof T> | Extract<"noRel", keyof T> | Extract<"prefetch", keyof T> | Extract<"noPrefetch", keyof T> | Extract<"prefetchOn", keyof T> | Extract<"trailingSlash", keyof T>>;
+    rest: Omit<T, Extract<"to", keyof T> | Extract<"target", keyof T> | Extract<"replace", keyof T> | Extract<"external", keyof T> | Extract<"rel", keyof T> | Extract<"noRel", keyof T> | Extract<"prefetch", keyof T> | Extract<"noPrefetch", keyof T> | Extract<"prefetchOn", keyof T> | Extract<"trailingSlash", keyof T>>;
 };

package/dist/runtime/components/roving-focus/_lib/context.d.ts

@@ -0,0 +1,51 @@
+import type { ShallowRef } from 'vue';
+interface State {
+    /** Ref to the container that holds all roving items */
+    list: Readonly<ShallowRef<HTMLElement | null>>;
+    /** Whether focus should loop from last to first and vice versa */
+    loop?: boolean;
+    /** Keyboard navigation direction */
+    orientation?: 'vertical' | 'horizontal' | 'both';
+    /** Custom attribute to mark items instead of data-roving-item */
+    attr?: string;
+}
+/**
+ * Provides the roving focus context to descendants.
+ * Must be called in the parent component that wraps the roving items.
+ *
+ * @example
+ * const { init } = useProvideRovingFocus({ list: containerRef, loop: true })
+ */
+export declare const useProvideRovingFocus: (args_0: State) => {
+    attr: string;
+    list: Readonly<ShallowRef<HTMLElement | null>>;
+    loop: boolean | undefined;
+    orientation: "both" | "horizontal" | "vertical" | undefined;
+    init: () => number;
+    focus: {
+        (dir: "first" | "last"): void;
+        (dir: "prev" | "next", element: HTMLElement | undefined | null): void;
+    };
+    getItems: () => HTMLElement[];
+    focusElement: (element?: HTMLElement) => void;
+    onItemUnmount: (element: HTMLElement | null | undefined) => void;
+};
+/**
+ * Consumes the roving focus context.
+ * Use inside each roving focus item to get access to navigation methods.
+ */
+export declare const useRovingFocus: () => {
+    attr: string;
+    list: Readonly<ShallowRef<HTMLElement | null>>;
+    loop: boolean | undefined;
+    orientation: "both" | "horizontal" | "vertical" | undefined;
+    init: () => number;
+    focus: {
+        (dir: "first" | "last"): void;
+        (dir: "prev" | "next", element: HTMLElement | undefined | null): void;
+    };
+    getItems: () => HTMLElement[];
+    focusElement: (element?: HTMLElement) => void;
+    onItemUnmount: (element: HTMLElement | null | undefined) => void;
+};
+export {};

package/dist/runtime/components/roving-focus/_lib/context.js

@@ -0,0 +1,90 @@
+import { createStrictInjection } from "@nui/helpers";
+import { unrefElement } from "@vueuse/core";
+import { nextTick, ref, watch } from "vue";
+const SELECT_ATTR = "data-roving-item";
+const injectionKey = Symbol("roving-focus");
+const [useProvide, useState] = createStrictInjection(({ list, loop, orientation, attr = SELECT_ATTR }) => {
+  const activeIx = ref(-1);
+  const init = () => activeIx.value = 0;
+  const getItems = () => Array.from(
+    unrefElement(list)?.querySelectorAll(`[${attr}]:not(:disabled)`) ?? []
+  );
+  watch(activeIx, (ix, oldIx) => {
+    const items = getItems();
+    if (ix !== oldIx) {
+      items[oldIx]?.setAttribute("tabindex", "-1");
+      items[ix]?.setAttribute("tabindex", "0");
+    }
+  });
+  const focusElement = (element) => {
+    if (!element)
+      return;
+    activeIx.value = getItems().indexOf(element);
+    nextTick(() => element.focus());
+  };
+  function focus(dir, element) {
+    if (!element && dir !== "first" && dir !== "last")
+      return;
+    const items = getItems();
+    const ix = element ? items.indexOf(element) : -1;
+    let nextIndex = ix;
+    switch (dir) {
+      case "first":
+        nextIndex = 0;
+        break;
+      case "last":
+        nextIndex = items.length - 1;
+        break;
+      case "next": {
+        nextIndex = ix + 1;
+        if (nextIndex >= items.length)
+          nextIndex = loop ? 0 : items.length - 1;
+        break;
+      }
+      case "prev": {
+        nextIndex = ix - 1;
+        if (nextIndex < 0)
+          nextIndex = loop ? items.length - 1 : 0;
+        break;
+      }
+    }
+    if (nextIndex !== ix && items[nextIndex] !== void 0) {
+      activeIx.value = nextIndex;
+      focusElement(items[nextIndex]);
+    }
+  }
+  const onItemUnmount = (element) => {
+    if (!element)
+      return;
+    const items = getItems();
+    const currentIndex = items.indexOf(element);
+    if (currentIndex === activeIx.value) {
+      nextTick(() => {
+        const newItems = getItems();
+        if (newItems.length === 0)
+          return activeIx.value = -1;
+        const nextIndex = currentIndex < newItems.length ? currentIndex : newItems.length - 1;
+        activeIx.value = nextIndex;
+        newItems[nextIndex]?.focus();
+      });
+    } else if (currentIndex < activeIx.value) {
+      activeIx.value--;
+    }
+  };
+  return {
+    attr,
+    list,
+    loop,
+    orientation,
+    init,
+    focus,
+    getItems,
+    focusElement,
+    onItemUnmount
+  };
+}, {
+  injectionKey,
+  name: "RovingFocus"
+});
+export const useProvideRovingFocus = useProvide;
+export const useRovingFocus = useState;

package/dist/runtime/components/roving-focus/index.d.ts

@@ -0,0 +1 @@
+export { useRovingFocus } from './_lib/context.js';

package/dist/runtime/components/roving-focus/index.js

@@ -0,0 +1 @@
+export { useRovingFocus } from "./_lib/context.js";

package/dist/runtime/components/roving-focus/roving-focus-item.d.vue.ts

@@ -0,0 +1,13 @@
+declare var __VLS_16: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_16) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, 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/runtime/components/roving-focus/roving-focus-item.vue

@@ -0,0 +1,32 @@
+<script setup>
+import { unrefElement } from "@vueuse/core";
+import { computed, onBeforeUnmount, useTemplateRef } from "vue";
+import Renderless from "../renderless/renderless.vue";
+import { useRovingFocus } from "./_lib/context";
+const { focus, focusElement, orientation, attr, onItemUnmount } = useRovingFocus();
+const isVertical = computed(() => orientation === "vertical" || orientation === "both");
+const isHorizontal = computed(() => orientation === "horizontal" || orientation === "both");
+const attrs = computed(() => ({ [attr]: "" }));
+const ref = useTemplateRef("item");
+onBeforeUnmount(() => {
+  const el = unrefElement(ref);
+  onItemUnmount(el);
+});
+</script>
+
+<template>
+	<Renderless
+		v-bind='attrs'
+		ref='item'
+		:tabindex='-1'
+		@keydown.up.prevent='isVertical && focus("prev", $event.currentTarget)'
+		@keydown.down.prevent='isVertical && focus("next", $event.currentTarget)'
+		@keydown.left.prevent='isHorizontal && focus("prev", $event.currentTarget)'
+		@keydown.right.prevent='isHorizontal && focus("next", $event.currentTarget)'
+		@keydown.home.prevent='focus("first")'
+		@keydown.end.prevent='focus("last")'
+		@click.prevent='focusElement($event.currentTarget)'
+	>
+		<slot />
+	</Renderless>
+</template>

package/dist/runtime/components/roving-focus/roving-focus-item.vue.d.ts

@@ -0,0 +1,13 @@
+declare var __VLS_16: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_16) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, 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/runtime/components/roving-focus/roving-focus.d.vue.ts

@@ -0,0 +1,21 @@
+export interface RovingFocusProps {
+    /** Loop focus from last to first and vice versa */
+    loop?: boolean;
+    /** Allowed arrow key directions */
+    orientation?: 'vertical' | 'horizontal' | 'both';
+    /** Custom attribute instead of data-roving-item */
+    attr?: string;
+}
+declare var __VLS_7: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_7) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<RovingFocusProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<RovingFocusProps> & Readonly<{}>, {}, {}, {}, {}, 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/runtime/components/roving-focus/roving-focus.vue

@@ -0,0 +1,23 @@
+<script setup>
+import { nextTick, onMounted, useTemplateRef } from "vue";
+import Renderless from "../renderless/renderless.vue";
+import { useProvideRovingFocus } from "./_lib/context";
+const { loop = false, orientation = "vertical" } = defineProps({
+  loop: { type: Boolean, required: false },
+  orientation: { type: String, required: false },
+  attr: { type: String, required: false }
+});
+const list = useTemplateRef("list");
+const { init } = useProvideRovingFocus({
+  list,
+  loop,
+  orientation
+});
+onMounted(() => nextTick(() => init()));
+</script>
+
+<template>
+	<Renderless ref='list'>
+		<slot />
+	</Renderless>
+</template>

package/dist/runtime/components/roving-focus/roving-focus.vue.d.ts

@@ -0,0 +1,21 @@
+export interface RovingFocusProps {
+    /** Loop focus from last to first and vice versa */
+    loop?: boolean;
+    /** Allowed arrow key directions */
+    orientation?: 'vertical' | 'horizontal' | 'both';
+    /** Custom attribute instead of data-roving-item */
+    attr?: string;
+}
+declare var __VLS_7: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_7) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<RovingFocusProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<RovingFocusProps> & Readonly<{}>, {}, {}, {}, {}, 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/runtime/components/select/select.d.vue.ts

@@ -23,7 +23,7 @@ declare const __VLS_export: <Value extends string = string, Ext extends Combobox
         open?: boolean;
         modelValue?: ComboboxItem<Value, Ext> | null;
         search?: string;
-    }) & __VLS_EmitsToProps<__VLS_NormalizeEmits<((evt: "select", args_0: number) => void) & ((evt: "clear") => void) & ((evt: "close", args_0: import("../combobox/index.js").ComboboxDropdownEventSource) => void) & ((evt: "submit", args_0: string, args_1: ComboboxItem) => void) & ((evt: "open", args_0: import("../combobox/index.js").ComboboxDropdownEventSource) => void) & ((evt: "update:modelValue", value: ComboboxItem<Value, Ext> | null) => void) & ((evt: "update:search", value: string) => void) & ((evt: "update:open", value: boolean) => void)>>> & import("vue").PublicProps;
+    }) & __VLS_EmitsToProps<__VLS_NormalizeEmits<((evt: "select", args_0: number) => void) & ((evt: "clear") => void) & ((evt: "close", args_0: import("..").ComboboxDropdownEventSource) => void) & ((evt: "submit", args_0: string, args_1: ComboboxItem) => void) & ((evt: "open", args_0: import("..").ComboboxDropdownEventSource) => void) & ((evt: "update:modelValue", value: ComboboxItem<Value, Ext> | null) => void) & ((evt: "update:search", value: string) => void) & ((evt: "update:open", value: boolean) => void)>>> & import("vue").PublicProps;
     expose: (exposed: {}) => void;
     attrs: any;
     slots: {
@@ -37,7 +37,7 @@ declare const __VLS_export: <Value extends string = string, Ext extends Combobox
     } & {
         rightSection?: (props: {}) => any;
     };
-    emit: (((evt: "select", args_0: number) => void) & ((evt: "clear") => void) & ((evt: "close", args_0: import("../combobox/index.js").ComboboxDropdownEventSource) => void) & ((evt: "submit", args_0: string, args_1: ComboboxItem) => void) & ((evt: "open", args_0: import("../combobox/index.js").ComboboxDropdownEventSource) => void)) & (((evt: "update:modelValue", value: ComboboxItem<Value, Ext> | null) => void) & ((evt: "update:search", value: string) => void) & ((evt: "update:open", value: boolean) => void));
+    emit: (((evt: "select", args_0: number) => void) & ((evt: "clear") => void) & ((evt: "close", args_0: import("..").ComboboxDropdownEventSource) => void) & ((evt: "submit", args_0: string, args_1: ComboboxItem) => void) & ((evt: "open", args_0: import("..").ComboboxDropdownEventSource) => void)) & (((evt: "update:modelValue", value: ComboboxItem<Value, Ext> | null) => void) & ((evt: "update:search", value: string) => void) & ((evt: "update:open", value: boolean) => void));
 }>) => import("vue").VNode & {
     __ctx?: Awaited<typeof __VLS_setup>;
 };

package/dist/runtime/components/select/select.vue.d.ts

@@ -23,7 +23,7 @@ declare const __VLS_export: <Value extends string = string, Ext extends Combobox
         open?: boolean;
         modelValue?: ComboboxItem<Value, Ext> | null;
         search?: string;
-    }) & __VLS_EmitsToProps<__VLS_NormalizeEmits<((evt: "select", args_0: number) => void) & ((evt: "clear") => void) & ((evt: "close", args_0: import("../combobox/index.js").ComboboxDropdownEventSource) => void) & ((evt: "submit", args_0: string, args_1: ComboboxItem) => void) & ((evt: "open", args_0: import("../combobox/index.js").ComboboxDropdownEventSource) => void) & ((evt: "update:modelValue", value: ComboboxItem<Value, Ext> | null) => void) & ((evt: "update:search", value: string) => void) & ((evt: "update:open", value: boolean) => void)>>> & import("vue").PublicProps;
+    }) & __VLS_EmitsToProps<__VLS_NormalizeEmits<((evt: "select", args_0: number) => void) & ((evt: "clear") => void) & ((evt: "close", args_0: import("..").ComboboxDropdownEventSource) => void) & ((evt: "submit", args_0: string, args_1: ComboboxItem) => void) & ((evt: "open", args_0: import("..").ComboboxDropdownEventSource) => void) & ((evt: "update:modelValue", value: ComboboxItem<Value, Ext> | null) => void) & ((evt: "update:search", value: string) => void) & ((evt: "update:open", value: boolean) => void)>>> & import("vue").PublicProps;
     expose: (exposed: {}) => void;
     attrs: any;
     slots: {
@@ -37,7 +37,7 @@ declare const __VLS_export: <Value extends string = string, Ext extends Combobox
     } & {
         rightSection?: (props: {}) => any;
     };
-    emit: (((evt: "select", args_0: number) => void) & ((evt: "clear") => void) & ((evt: "close", args_0: import("../combobox/index.js").ComboboxDropdownEventSource) => void) & ((evt: "submit", args_0: string, args_1: ComboboxItem) => void) & ((evt: "open", args_0: import("../combobox/index.js").ComboboxDropdownEventSource) => void)) & (((evt: "update:modelValue", value: ComboboxItem<Value, Ext> | null) => void) & ((evt: "update:search", value: string) => void) & ((evt: "update:open", value: boolean) => void));
+    emit: (((evt: "select", args_0: number) => void) & ((evt: "clear") => void) & ((evt: "close", args_0: import("..").ComboboxDropdownEventSource) => void) & ((evt: "submit", args_0: string, args_1: ComboboxItem) => void) & ((evt: "open", args_0: import("..").ComboboxDropdownEventSource) => void)) & (((evt: "update:modelValue", value: ComboboxItem<Value, Ext> | null) => void) & ((evt: "update:search", value: string) => void) & ((evt: "update:open", value: boolean) => void));
 }>) => import("vue").VNode & {
     __ctx?: Awaited<typeof __VLS_setup>;
 };

package/dist/runtime/components/tabs/tabs-tab.d.vue.ts

@@ -1,4 +1,4 @@
-import type { Mod } from '@nui/composals';
+import type { Mod } from '@nui/utils';
 export interface TabsTabProps {
     value: string;
     mod?: Mod | Mod[];

package/dist/runtime/components/tabs/tabs-tab.vue.d.ts

@@ -1,4 +1,4 @@
-import type { Mod } from '@nui/composals';
+import type { Mod } from '@nui/utils';
 export interface TabsTabProps {
     value: string;
     mod?: Mod | Mod[];