@indielayer/ui 2.0.0 → 2.1.0

package/lib/components/menu/Menu.vue.d.ts

@@ -2,31 +2,45 @@ import type { ExtractPublicPropTypes, PropType } from 'vue';
 import { type Size } from '../../composables/useCommon';
 import { type ThemeComponent } from '../../composables/useTheme';
 declare const menuProps: {
-    items: PropType<MenuArrayItem[]>;
+    items: {
+        type: PropType<MenuArrayItem[]>;
+        description: string;
+    };
     collapsible: {
         type: BooleanConstructor;
         default: boolean;
+        description: string;
+    };
+    collapseIcon: {
+        type: StringConstructor;
+        description: string;
     };
-    collapseIcon: StringConstructor;
     expanded: import("vue").Prop<boolean | undefined>;
-    disabled: BooleanConstructor;
+    disabled: {
+        type: BooleanConstructor;
+        description: string;
+    };
     rounded: {
         type: BooleanConstructor;
         default: boolean;
+        description: string;
     };
     filled: {
         type: BooleanConstructor;
         default: boolean;
+        description: string;
     };
     minimal: import("vue").Prop<boolean | undefined>;
     color: {
         readonly type: StringConstructor;
         readonly default: string | undefined;
+        readonly description: "Theme or CSS color used for the control accents.";
     };
     size: {
         readonly type: PropType<Size>;
         readonly default: "md";
         readonly validator: (value: string) => boolean;
+        readonly description: "Control size. One of xs, sm, md, lg, xl.";
     };
 };
 export type MenuArrayItem = {
@@ -60,58 +74,86 @@ type InternalClasses = 'wrapper';
 export interface MenuTheme extends ThemeComponent<MenuProps, InternalClasses> {
 }
 declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
-    items: PropType<MenuArrayItem[]>;
+    items: {
+        type: PropType<MenuArrayItem[]>;
+        description: string;
+    };
     collapsible: {
         type: BooleanConstructor;
         default: boolean;
+        description: string;
+    };
+    collapseIcon: {
+        type: StringConstructor;
+        description: string;
     };
-    collapseIcon: StringConstructor;
     expanded: import("vue").Prop<boolean | undefined>;
-    disabled: BooleanConstructor;
+    disabled: {
+        type: BooleanConstructor;
+        description: string;
+    };
     rounded: {
         type: BooleanConstructor;
         default: boolean;
+        description: string;
     };
     filled: {
         type: BooleanConstructor;
         default: boolean;
+        description: string;
     };
     minimal: import("vue").Prop<boolean | undefined>;
     color: {
         readonly type: StringConstructor;
         readonly default: string | undefined;
+        readonly description: "Theme or CSS color used for the control accents.";
     };
     size: {
         readonly type: PropType<Size>;
         readonly default: "md";
         readonly validator: (value: string) => boolean;
+        readonly description: "Control size. One of xs, sm, md, lg, xl.";
     };
 }>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("expand" | "item-click")[], "expand" | "item-click", import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
-    items: PropType<MenuArrayItem[]>;
+    items: {
+        type: PropType<MenuArrayItem[]>;
+        description: string;
+    };
     collapsible: {
         type: BooleanConstructor;
         default: boolean;
+        description: string;
+    };
+    collapseIcon: {
+        type: StringConstructor;
+        description: string;
     };
-    collapseIcon: StringConstructor;
     expanded: import("vue").Prop<boolean | undefined>;
-    disabled: BooleanConstructor;
+    disabled: {
+        type: BooleanConstructor;
+        description: string;
+    };
     rounded: {
         type: BooleanConstructor;
         default: boolean;
+        description: string;
     };
     filled: {
         type: BooleanConstructor;
         default: boolean;
+        description: string;
     };
     minimal: import("vue").Prop<boolean | undefined>;
     color: {
         readonly type: StringConstructor;
         readonly default: string | undefined;
+        readonly description: "Theme or CSS color used for the control accents.";
     };
     size: {
         readonly type: PropType<Size>;
         readonly default: "md";
         readonly validator: (value: string) => boolean;
+        readonly description: "Control size. One of xs, sm, md, lg, xl.";
     };
 }>> & Readonly<{
     onExpand?: ((...args: any[]) => any) | undefined;

package/lib/components/menu/Menu.vue_vue_type_script_setup_true_lang.js

@@ -10,26 +10,42 @@ import { Fragment as s, createBlock as c, createCommentVNode as l, createElement
 var b = {
 	...r.props(),
 	...e.props("secondary"),
-	items: Array,
+	items: {
+		type: Array,
+		description: "Menu tree. Each item may nest `items`, links, icons, and dividers."
+	},
 	collapsible: {
 		type: Boolean,
-		default: !0
+		default: !0,
+		description: "Allows nested groups to collapse when they have child items."
+	},
+	collapseIcon: {
+		type: String,
+		description: "Default icon for collapsible group headers."
+	},
+	expanded: n("Default expanded state for collapsible groups."),
+	disabled: {
+		type: Boolean,
+		description: "Disables all menu items."
 	},
-	collapseIcon: String,
-	expanded: n(),
-	disabled: Boolean,
 	rounded: {
 		type: Boolean,
-		default: !0
+		default: !0,
+		description: "Applies rounded corners to menu items."
 	},
 	filled: {
 		type: Boolean,
-		default: !0
+		default: !0,
+		description: "Filled item backgrounds (vs. minimal text-only look)."
 	},
-	minimal: n()
+	minimal: n("Hides item labels; icons-only layout.")
 }, x = /* @__PURE__ */ f({
 	name: "XMenu",
 	validators: { ...r.validators() },
+	docs: { emits: {
+		expand: "Emitted when a nested group expands or a linked item becomes active.",
+		"item-click": "Emitted when a menu item is clicked."
+	} },
 	props: b,
 	emits: ["expand", "item-click"],
 	setup(e) {

package/lib/components/menu/MenuItem.js

@@ -1,6 +1,6 @@
 import e from "../../_virtual/_plugin-vue_export-helper.js";
 import t from "./MenuItem.vue_vue_type_script_setup_true_lang.js";
-import n from "./MenuItem.vue_vue_type_style_index_0_scoped_2a6b7341_lang.module.js";
-var r = /* @__PURE__ */ e(t, [["__cssModules", { $style: n }], ["__scopeId", "data-v-2a6b7341"]]);
+import n from "./MenuItem.vue_vue_type_style_index_0_scoped_5aebaff3_lang.module.js";
+var r = /* @__PURE__ */ e(t, [["__cssModules", { $style: n }], ["__scopeId", "data-v-5aebaff3"]]);
 //#endregion
 export { r as default };

package/lib/components/menu/MenuItem.vue.d.ts

@@ -5,44 +5,95 @@ declare const menuItemProps: {
     item: {
         type: PropType<MenuArrayItem>;
         default: () => void;
+        description: string;
+    };
+    active: {
+        type: BooleanConstructor;
+        description: string;
     };
-    active: BooleanConstructor;
     attrs: {
         type: ObjectConstructor;
         default: () => void;
+        description: string;
+    };
+    onClick: {
+        type: FunctionConstructor;
+        description: string;
+    };
+    value: {
+        type: (StringConstructor | NumberConstructor)[];
+        description: string;
+    };
+    to: {
+        type: (ObjectConstructor | StringConstructor)[];
+        description: string;
+    };
+    exact: {
+        type: BooleanConstructor;
+        description: string;
+    };
+    href: {
+        type: StringConstructor;
+        description: string;
+    };
+    target: {
+        type: StringConstructor;
+        description: string;
+    };
+    label: {
+        type: StringConstructor;
+        description: string;
+    };
+    icon: {
+        type: StringConstructor;
+        description: string;
+    };
+    iconRight: {
+        type: StringConstructor;
+        description: string;
+    };
+    loading: {
+        type: BooleanConstructor;
+        description: string;
     };
-    onClick: FunctionConstructor;
-    value: (StringConstructor | NumberConstructor)[];
-    to: (ObjectConstructor | StringConstructor)[];
-    exact: BooleanConstructor;
-    href: StringConstructor;
-    target: StringConstructor;
-    label: StringConstructor;
-    icon: StringConstructor;
-    iconRight: StringConstructor;
-    loading: BooleanConstructor;
     rounded: {
         type: BooleanConstructor;
         default: boolean;
+        description: string;
     };
     filled: {
         type: BooleanConstructor;
         default: boolean;
+        description: string;
+    };
+    selected: {
+        type: BooleanConstructor;
+        description: string;
+    };
+    disabled: {
+        type: BooleanConstructor;
+        description: string;
     };
-    selected: BooleanConstructor;
-    disabled: BooleanConstructor;
     minimal: import("vue").Prop<boolean | undefined>;
-    prefix: StringConstructor;
-    suffix: StringConstructor;
+    prefix: {
+        type: StringConstructor;
+        description: string;
+    };
+    suffix: {
+        type: StringConstructor;
+        description: string;
+    };
     checkbox: import("vue").Prop<boolean | undefined>;
     color: {
         readonly type: StringConstructor;
         readonly default: string | undefined;
+        readonly description: "Theme or CSS color used for the control accents.";
     };
     size: {
         readonly type: PropType<import("../../composables/useCommon").Size>;
         readonly default: "md";
         readonly validator: (value: string) => boolean;
+        readonly description: "Control size. One of xs, sm, md, lg, xl.";
     };
 };
 export type MenuItemProps = ExtractPublicPropTypes<typeof menuItemProps>;
@@ -56,87 +107,189 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
     item: {
         type: PropType<MenuArrayItem>;
         default: () => void;
+        description: string;
+    };
+    active: {
+        type: BooleanConstructor;
+        description: string;
     };
-    active: BooleanConstructor;
     attrs: {
         type: ObjectConstructor;
         default: () => void;
+        description: string;
+    };
+    onClick: {
+        type: FunctionConstructor;
+        description: string;
+    };
+    value: {
+        type: (StringConstructor | NumberConstructor)[];
+        description: string;
+    };
+    to: {
+        type: (ObjectConstructor | StringConstructor)[];
+        description: string;
+    };
+    exact: {
+        type: BooleanConstructor;
+        description: string;
+    };
+    href: {
+        type: StringConstructor;
+        description: string;
+    };
+    target: {
+        type: StringConstructor;
+        description: string;
+    };
+    label: {
+        type: StringConstructor;
+        description: string;
+    };
+    icon: {
+        type: StringConstructor;
+        description: string;
+    };
+    iconRight: {
+        type: StringConstructor;
+        description: string;
+    };
+    loading: {
+        type: BooleanConstructor;
+        description: string;
     };
-    onClick: FunctionConstructor;
-    value: (StringConstructor | NumberConstructor)[];
-    to: (ObjectConstructor | StringConstructor)[];
-    exact: BooleanConstructor;
-    href: StringConstructor;
-    target: StringConstructor;
-    label: StringConstructor;
-    icon: StringConstructor;
-    iconRight: StringConstructor;
-    loading: BooleanConstructor;
     rounded: {
         type: BooleanConstructor;
         default: boolean;
+        description: string;
     };
     filled: {
         type: BooleanConstructor;
         default: boolean;
+        description: string;
+    };
+    selected: {
+        type: BooleanConstructor;
+        description: string;
+    };
+    disabled: {
+        type: BooleanConstructor;
+        description: string;
     };
-    selected: BooleanConstructor;
-    disabled: BooleanConstructor;
     minimal: import("vue").Prop<boolean | undefined>;
-    prefix: StringConstructor;
-    suffix: StringConstructor;
+    prefix: {
+        type: StringConstructor;
+        description: string;
+    };
+    suffix: {
+        type: StringConstructor;
+        description: string;
+    };
     checkbox: import("vue").Prop<boolean | undefined>;
     color: {
         readonly type: StringConstructor;
         readonly default: string | undefined;
+        readonly description: "Theme or CSS color used for the control accents.";
     };
     size: {
         readonly type: PropType<import("../../composables/useCommon").Size>;
         readonly default: "md";
         readonly validator: (value: string) => boolean;
+        readonly description: "Control size. One of xs, sm, md, lg, xl.";
     };
 }>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("click" | "active" | "checkbox-click")[], "click" | "active" | "checkbox-click", import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
     item: {
         type: PropType<MenuArrayItem>;
         default: () => void;
+        description: string;
+    };
+    active: {
+        type: BooleanConstructor;
+        description: string;
     };
-    active: BooleanConstructor;
     attrs: {
         type: ObjectConstructor;
         default: () => void;
+        description: string;
+    };
+    onClick: {
+        type: FunctionConstructor;
+        description: string;
+    };
+    value: {
+        type: (StringConstructor | NumberConstructor)[];
+        description: string;
+    };
+    to: {
+        type: (ObjectConstructor | StringConstructor)[];
+        description: string;
+    };
+    exact: {
+        type: BooleanConstructor;
+        description: string;
+    };
+    href: {
+        type: StringConstructor;
+        description: string;
+    };
+    target: {
+        type: StringConstructor;
+        description: string;
+    };
+    label: {
+        type: StringConstructor;
+        description: string;
+    };
+    icon: {
+        type: StringConstructor;
+        description: string;
+    };
+    iconRight: {
+        type: StringConstructor;
+        description: string;
+    };
+    loading: {
+        type: BooleanConstructor;
+        description: string;
     };
-    onClick: FunctionConstructor;
-    value: (StringConstructor | NumberConstructor)[];
-    to: (ObjectConstructor | StringConstructor)[];
-    exact: BooleanConstructor;
-    href: StringConstructor;
-    target: StringConstructor;
-    label: StringConstructor;
-    icon: StringConstructor;
-    iconRight: StringConstructor;
-    loading: BooleanConstructor;
     rounded: {
         type: BooleanConstructor;
         default: boolean;
+        description: string;
     };
     filled: {
         type: BooleanConstructor;
         default: boolean;
+        description: string;
+    };
+    selected: {
+        type: BooleanConstructor;
+        description: string;
+    };
+    disabled: {
+        type: BooleanConstructor;
+        description: string;
     };
-    selected: BooleanConstructor;
-    disabled: BooleanConstructor;
     minimal: import("vue").Prop<boolean | undefined>;
-    prefix: StringConstructor;
-    suffix: StringConstructor;
+    prefix: {
+        type: StringConstructor;
+        description: string;
+    };
+    suffix: {
+        type: StringConstructor;
+        description: string;
+    };
     checkbox: import("vue").Prop<boolean | undefined>;
     color: {
         readonly type: StringConstructor;
         readonly default: string | undefined;
+        readonly description: "Theme or CSS color used for the control accents.";
     };
     size: {
         readonly type: PropType<import("../../composables/useCommon").Size>;
         readonly default: "md";
         readonly validator: (value: string) => boolean;
+        readonly description: "Control size. One of xs, sm, md, lg, xl.";
     };
 }>> & Readonly<{
     onClick?: ((...args: any[]) => any) | undefined;

package/lib/components/menu/MenuItem.vue_vue_type_script_setup_true_lang.js

@@ -19,40 +19,101 @@ var D = {
 	...e.props("secondary"),
 	item: {
 		type: Object,
-		default: () => {}
+		default: () => {},
+		description: "Item data object. Individual props override matching fields."
+	},
+	active: {
+		type: Boolean,
+		description: "Forces active styling when not using router link classes."
 	},
-	active: Boolean,
 	attrs: {
 		type: Object,
-		default: () => {}
-	},
-	onClick: Function,
-	value: [Number, String],
-	to: [String, Object],
-	exact: Boolean,
-	href: String,
-	target: String,
-	label: String,
-	icon: String,
-	iconRight: String,
-	loading: Boolean,
+		default: () => {},
+		description: "Extra HTML attributes merged onto the root element."
+	},
+	onClick: {
+		type: Function,
+		description: "Click handler invoked when the item is activated."
+	},
+	value: {
+		type: [Number, String],
+		description: "Item value identifier."
+	},
+	to: {
+		type: [String, Object],
+		description: "Vue Router location; renders as a router-link when set."
+	},
+	exact: {
+		type: Boolean,
+		description: "Requires exact route match for active state."
+	},
+	href: {
+		type: String,
+		description: "Native link URL; renders as an anchor when set."
+	},
+	target: {
+		type: String,
+		description: "Anchor target when `href` is set."
+	},
+	label: {
+		type: String,
+		description: "Visible label text."
+	},
+	icon: {
+		type: String,
+		description: "Icon name shown before the label."
+	},
+	iconRight: {
+		type: String,
+		description: "Icon name shown after the label."
+	},
+	loading: {
+		type: Boolean,
+		description: "Shows a spinner in place of the trailing icon."
+	},
 	rounded: {
 		type: Boolean,
-		default: !0
+		default: !0,
+		description: "Applies rounded corners."
 	},
 	filled: {
 		type: Boolean,
-		default: !0
-	},
-	selected: Boolean,
-	disabled: Boolean,
-	minimal: n(),
-	prefix: String,
-	suffix: String,
-	checkbox: n()
+		default: !0,
+		description: "Filled background style."
+	},
+	selected: {
+		type: Boolean,
+		description: "Selected visual state."
+	},
+	disabled: {
+		type: Boolean,
+		description: "Disables interaction."
+	},
+	minimal: n("Hides the label; icon-only layout."),
+	prefix: {
+		type: String,
+		description: "Text before the label when no prefix slot is used."
+	},
+	suffix: {
+		type: String,
+		description: "Text after the label when no suffix slot is used."
+	},
+	checkbox: n("Shows a checkbox before the label.")
 }, M = /* @__PURE__ */ h({
 	name: "XMenuItem",
 	validators: { ...r.validators() },
+	docs: {
+		slots: {
+			default: "Label content. Slot prop: item.",
+			prefix: "Content before the label. Slot prop: item.",
+			suffix: "Content after the label. Slot prop: item."
+		},
+		emits: {
+			active: "Emitted when the item becomes active (route or `active` prop).",
+			click: "Emitted on item click when not disabled.",
+			"checkbox-click": "Emitted when the checkbox is clicked."
+		}
+	},
 	props: j,
 	emits: [
 		"active",

package/lib/components/menu/{MenuItem.vue_vue_type_style_index_0_scoped_2a6b7341_lang.module.js → MenuItem.vue_vue_type_style_index_0_scoped_5aebaff3_lang.module.js}

@@ -1,4 +1,4 @@
-//#region src/components/menu/MenuItem.vue?vue&type=style&index=0&scoped=2a6b7341&lang.module.css
+//#region src/components/menu/MenuItem.vue?vue&type=style&index=0&scoped=5aebaff3&lang.module.css
 var e = {
 	"menu-item": "_menu-item_1mhic_2",
 	"menu-item--active": "_menu-item--active_1mhic_34"