@indielayer/ui 2.0.0 → 2.1.0

package/lib/components/carousel/Carousel.vue.d.ts

@@ -7,16 +7,22 @@ declare const carouselProps: {
     delay: {
         type: NumberConstructor;
         default: number;
+        description: string;
     };
     showDots: {
         type: BooleanConstructor;
         default: boolean;
+        description: string;
     };
     effect: {
         type: PropType<"slide">;
         default: string;
+        description: string;
+    };
+    classDots: {
+        type: (ArrayConstructor | StringConstructor)[];
+        description: string;
     };
-    classDots: (ArrayConstructor | StringConstructor)[];
 };
 export type CarouselProps = ExtractPublicPropTypes<typeof carouselProps>;
 type InternalClasses = 'wrapper' | 'slides' | 'dots' | 'dot' | 'dotActive';
@@ -31,16 +37,22 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
     delay: {
         type: NumberConstructor;
         default: number;
+        description: string;
     };
     showDots: {
         type: BooleanConstructor;
         default: boolean;
+        description: string;
     };
     effect: {
         type: PropType<"slide">;
         default: string;
+        description: string;
+    };
+    classDots: {
+        type: (ArrayConstructor | StringConstructor)[];
+        description: string;
     };
-    classDots: (ArrayConstructor | StringConstructor)[];
 }>, {
     to: (index: number) => void;
     next: () => void;
@@ -50,16 +62,22 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
     delay: {
         type: NumberConstructor;
         default: number;
+        description: string;
     };
     showDots: {
         type: BooleanConstructor;
         default: boolean;
+        description: string;
     };
     effect: {
         type: PropType<"slide">;
         default: string;
+        description: string;
+    };
+    classDots: {
+        type: (ArrayConstructor | StringConstructor)[];
+        description: string;
     };
-    classDots: (ArrayConstructor | StringConstructor)[];
 }>> & Readonly<{
     onUpdate?: ((...args: any[]) => any) | undefined;
 }>, {

package/lib/components/carousel/Carousel.vue_vue_type_script_setup_true_lang.js

@@ -5,21 +5,39 @@ import { Fragment as n, computed as r, createCommentVNode as i, createElementBlo
 var b = ["onClick"], x = /* @__PURE__ */ s({
 	name: "XCarousel",
 	validators: {},
+	docs: {
+		slots: {
+			default: "Slides (typically x-carousel-slide). Slot props: to, next, prev, current, total.",
+			dots: "Custom pagination dots. Slot props: to, next, prev, current, total."
+		},
+		emits: { update: "Emitted when the current slide index changes." },
+		methods: {
+			to: "Go to a slide by zero-based index.",
+			next: "Go to the next slide (wraps to the first).",
+			prev: "Go to the previous slide (wraps to the last)."
+		}
+	},
 	props: {
-		autoplay: t(),
+		autoplay: t("Advances slides automatically."),
 		delay: {
 			type: Number,
-			default: 5e3
+			default: 5e3,
+			description: "Autoplay interval in milliseconds."
 		},
 		showDots: {
 			type: Boolean,
-			default: !0
+			default: !0,
+			description: "Shows pagination dots under the slides."
 		},
 		effect: {
 			type: String,
-			default: "slide"
+			default: "slide",
+			description: "Transition effect between slides."
 		},
-		classDots: [Array, String]
+		classDots: {
+			type: [Array, String],
+			description: "Extra class(es) on the default dots container."
+		}
 	},
 	emits: ["update"],
 	setup(t, { expose: s, emit: x }) {

package/lib/components/carousel/CarouselSlide.js

@@ -1,6 +1,6 @@
 import e from "../../_virtual/_plugin-vue_export-helper.js";
 import t from "./CarouselSlide.vue_vue_type_script_setup_true_lang.js";
-import n from "./CarouselSlide.vue_vue_type_style_index_0_scoped_e90d2127_lang.module.js";
-var r = /* @__PURE__ */ e(t, [["__cssModules", { $style: n }], ["__scopeId", "data-v-e90d2127"]]);
+import n from "./CarouselSlide.vue_vue_type_style_index_0_scoped_4f559831_lang.module.js";
+var r = /* @__PURE__ */ e(t, [["__cssModules", { $style: n }], ["__scopeId", "data-v-4f559831"]]);
 //#endregion
 export { r as default };

package/lib/components/carousel/CarouselSlide.vue.d.ts

@@ -4,6 +4,7 @@ declare const carouselSlideProps: {
     tag: {
         type: StringConstructor;
         default: string;
+        description: string;
     };
 };
 export type CarouselSlideProps = ExtractPublicPropTypes<typeof carouselSlideProps>;
@@ -14,11 +15,13 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
     tag: {
         type: StringConstructor;
         default: string;
+        description: string;
     };
 }>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
     tag: {
         type: StringConstructor;
         default: string;
+        description: string;
     };
 }>> & Readonly<{}>, {
     tag: string;

package/lib/components/carousel/CarouselSlide.vue_vue_type_script_setup_true_lang.js

@@ -3,9 +3,11 @@ import { createBlock as t, defineComponent as n, normalizeClass as r, normalizeS
 //#region src/components/carousel/CarouselSlide.vue?vue&type=script&setup=true&lang.ts
 var u = /* @__PURE__ */ n({
 	name: "XCarouselSlide",
+	docs: { slots: { default: "Slide content." } },
 	props: { tag: {
 		type: String,
-		default: "div"
+		default: "div",
+		description: "Root element tag."
 	} },
 	setup(n) {
 		let { styles: u, classes: d, className: f } = e("CarouselSlide", {}, n);

package/lib/components/carousel/{CarouselSlide.vue_vue_type_style_index_0_scoped_e90d2127_lang.module.js → CarouselSlide.vue_vue_type_style_index_0_scoped_4f559831_lang.module.js}

@@ -1,4 +1,4 @@
-//#region src/components/carousel/CarouselSlide.vue?vue&type=style&index=0&scoped=e90d2127&lang.module.css
+//#region src/components/carousel/CarouselSlide.vue?vue&type=style&index=0&scoped=4f559831&lang.module.css
 var e = { "carousel-slide": "_carousel-slide_uzvvz_2" };
 //#endregion
 export { e as default };

package/lib/components/checkbox/Checkbox.vue.d.ts

@@ -1,46 +1,97 @@
 import { type ExtractPublicPropTypes, type Ref } from 'vue';
 import { type ThemeComponent } from '../../composables/useTheme';
 declare const checkboxProps: {
-    value: (StringConstructor | NumberConstructor)[];
-    indeterminate: BooleanConstructor;
+    value: {
+        type: (StringConstructor | NumberConstructor)[];
+        description: string;
+    };
+    indeterminate: {
+        type: BooleanConstructor;
+        description: string;
+    };
     glow: import("vue").Prop<boolean | undefined>;
     modelValue: {
         readonly type: import("vue").PropType<string | number | boolean | object | any[] | undefined>;
         readonly default: undefined;
+        readonly description: "Bound value (v-model).";
+    };
+    id: {
+        readonly type: StringConstructor;
+        readonly description: "Native id attribute for the input element.";
+    };
+    name: {
+        readonly type: StringConstructor;
+        readonly description: "Native name attribute for form submission.";
+    };
+    readonly: {
+        readonly type: BooleanConstructor;
+        readonly description: "Makes the field read-only without disabling it.";
+    };
+    required: {
+        readonly type: BooleanConstructor;
+        readonly description: "Marks the field as required for validation.";
     };
-    id: StringConstructor;
-    name: StringConstructor;
-    readonly: BooleanConstructor;
-    required: BooleanConstructor;
     validateOnInput: {
         readonly type: BooleanConstructor;
         readonly default: true;
+        readonly description: "Runs validation on each input event when true.";
+    };
+    label: {
+        readonly type: StringConstructor;
+        readonly description: "Visible label text for the field.";
+    };
+    helper: {
+        readonly type: StringConstructor;
+        readonly description: "Helper text shown below the field.";
+    };
+    error: {
+        readonly type: StringConstructor;
+        readonly description: "External error message; overrides rule errors when set.";
+    };
+    hideFooter: {
+        readonly type: BooleanConstructor;
+        readonly description: "Hides the footer area (helper / error).";
     };
-    label: StringConstructor;
-    helper: StringConstructor;
-    error: StringConstructor;
-    hideFooter: BooleanConstructor;
     rules: {
         readonly type: ArrayConstructor;
         readonly default: () => never[];
+        readonly description: "Validation rule functions or rule descriptors.";
+    };
+    tooltip: {
+        readonly type: StringConstructor;
+        readonly description: "Optional tooltip text next to the label.";
+    };
+    skipFormRegistry: {
+        readonly type: BooleanConstructor;
+        readonly description: "Skips registering this field with a parent x-form.";
+    };
+    disabled: {
+        readonly type: BooleanConstructor;
+        readonly description: "Disables interaction and applies disabled styling.";
+    };
+    loading: {
+        readonly type: BooleanConstructor;
+        readonly description: "Shows a loading indicator and blocks interaction.";
+    };
+    loadingLabel: {
+        readonly type: StringConstructor;
+        readonly description: "Accessible label announced while loading.";
     };
-    tooltip: StringConstructor;
-    skipFormRegistry: BooleanConstructor;
-    disabled: BooleanConstructor;
-    loading: BooleanConstructor;
-    loadingLabel: StringConstructor;
     loadingStatus: {
         readonly type: import("vue").PropType<import("../loader/Loader.vue").LoaderStatus>;
         readonly default: "active";
+        readonly description: "Loader visual status (for example active or indeterminate).";
     };
     color: {
         readonly type: StringConstructor;
         readonly default: string | undefined;
+        readonly description: "Theme or CSS color used for the control accents.";
     };
     size: {
         readonly type: import("vue").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 CheckboxProps = ExtractPublicPropTypes<typeof checkboxProps>;
@@ -53,46 +104,97 @@ type InternalExtraData = {
 export interface CheckboxTheme extends ThemeComponent<CheckboxProps, InternalClasses, InternalExtraData> {
 }
 declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<import("vue").ExtractPropTypes<{
-    value: (StringConstructor | NumberConstructor)[];
-    indeterminate: BooleanConstructor;
+    value: {
+        type: (StringConstructor | NumberConstructor)[];
+        description: string;
+    };
+    indeterminate: {
+        type: BooleanConstructor;
+        description: string;
+    };
     glow: import("vue").Prop<boolean | undefined>;
     modelValue: {
         readonly type: import("vue").PropType<string | number | boolean | object | any[] | undefined>;
         readonly default: undefined;
+        readonly description: "Bound value (v-model).";
+    };
+    id: {
+        readonly type: StringConstructor;
+        readonly description: "Native id attribute for the input element.";
+    };
+    name: {
+        readonly type: StringConstructor;
+        readonly description: "Native name attribute for form submission.";
+    };
+    readonly: {
+        readonly type: BooleanConstructor;
+        readonly description: "Makes the field read-only without disabling it.";
+    };
+    required: {
+        readonly type: BooleanConstructor;
+        readonly description: "Marks the field as required for validation.";
     };
-    id: StringConstructor;
-    name: StringConstructor;
-    readonly: BooleanConstructor;
-    required: BooleanConstructor;
     validateOnInput: {
         readonly type: BooleanConstructor;
         readonly default: true;
+        readonly description: "Runs validation on each input event when true.";
+    };
+    label: {
+        readonly type: StringConstructor;
+        readonly description: "Visible label text for the field.";
+    };
+    helper: {
+        readonly type: StringConstructor;
+        readonly description: "Helper text shown below the field.";
+    };
+    error: {
+        readonly type: StringConstructor;
+        readonly description: "External error message; overrides rule errors when set.";
+    };
+    hideFooter: {
+        readonly type: BooleanConstructor;
+        readonly description: "Hides the footer area (helper / error).";
     };
-    label: StringConstructor;
-    helper: StringConstructor;
-    error: StringConstructor;
-    hideFooter: BooleanConstructor;
     rules: {
         readonly type: ArrayConstructor;
         readonly default: () => never[];
+        readonly description: "Validation rule functions or rule descriptors.";
+    };
+    tooltip: {
+        readonly type: StringConstructor;
+        readonly description: "Optional tooltip text next to the label.";
+    };
+    skipFormRegistry: {
+        readonly type: BooleanConstructor;
+        readonly description: "Skips registering this field with a parent x-form.";
+    };
+    disabled: {
+        readonly type: BooleanConstructor;
+        readonly description: "Disables interaction and applies disabled styling.";
+    };
+    loading: {
+        readonly type: BooleanConstructor;
+        readonly description: "Shows a loading indicator and blocks interaction.";
+    };
+    loadingLabel: {
+        readonly type: StringConstructor;
+        readonly description: "Accessible label announced while loading.";
     };
-    tooltip: StringConstructor;
-    skipFormRegistry: BooleanConstructor;
-    disabled: BooleanConstructor;
-    loading: BooleanConstructor;
-    loadingLabel: StringConstructor;
     loadingStatus: {
         readonly type: import("vue").PropType<import("../loader/Loader.vue").LoaderStatus>;
         readonly default: "active";
+        readonly description: "Loader visual status (for example active or indeterminate).";
     };
     color: {
         readonly type: StringConstructor;
         readonly default: string | undefined;
+        readonly description: "Theme or CSS color used for the control accents.";
     };
     size: {
         readonly type: import("vue").PropType<import("../../composables/useCommon").Size>;
         readonly default: "md";
         readonly validator: (value: string) => boolean;
+        readonly description: "Control size. One of xs, sm, md, lg, xl.";
     };
 }>, {
     focus: () => void | undefined;
@@ -102,46 +204,97 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
     validate: (val?: any) => boolean;
     setError: (val: string) => void;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, string[], string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
-    value: (StringConstructor | NumberConstructor)[];
-    indeterminate: BooleanConstructor;
+    value: {
+        type: (StringConstructor | NumberConstructor)[];
+        description: string;
+    };
+    indeterminate: {
+        type: BooleanConstructor;
+        description: string;
+    };
     glow: import("vue").Prop<boolean | undefined>;
     modelValue: {
         readonly type: import("vue").PropType<string | number | boolean | object | any[] | undefined>;
         readonly default: undefined;
+        readonly description: "Bound value (v-model).";
+    };
+    id: {
+        readonly type: StringConstructor;
+        readonly description: "Native id attribute for the input element.";
+    };
+    name: {
+        readonly type: StringConstructor;
+        readonly description: "Native name attribute for form submission.";
+    };
+    readonly: {
+        readonly type: BooleanConstructor;
+        readonly description: "Makes the field read-only without disabling it.";
+    };
+    required: {
+        readonly type: BooleanConstructor;
+        readonly description: "Marks the field as required for validation.";
     };
-    id: StringConstructor;
-    name: StringConstructor;
-    readonly: BooleanConstructor;
-    required: BooleanConstructor;
     validateOnInput: {
         readonly type: BooleanConstructor;
         readonly default: true;
+        readonly description: "Runs validation on each input event when true.";
+    };
+    label: {
+        readonly type: StringConstructor;
+        readonly description: "Visible label text for the field.";
+    };
+    helper: {
+        readonly type: StringConstructor;
+        readonly description: "Helper text shown below the field.";
+    };
+    error: {
+        readonly type: StringConstructor;
+        readonly description: "External error message; overrides rule errors when set.";
+    };
+    hideFooter: {
+        readonly type: BooleanConstructor;
+        readonly description: "Hides the footer area (helper / error).";
     };
-    label: StringConstructor;
-    helper: StringConstructor;
-    error: StringConstructor;
-    hideFooter: BooleanConstructor;
     rules: {
         readonly type: ArrayConstructor;
         readonly default: () => never[];
+        readonly description: "Validation rule functions or rule descriptors.";
+    };
+    tooltip: {
+        readonly type: StringConstructor;
+        readonly description: "Optional tooltip text next to the label.";
+    };
+    skipFormRegistry: {
+        readonly type: BooleanConstructor;
+        readonly description: "Skips registering this field with a parent x-form.";
+    };
+    disabled: {
+        readonly type: BooleanConstructor;
+        readonly description: "Disables interaction and applies disabled styling.";
+    };
+    loading: {
+        readonly type: BooleanConstructor;
+        readonly description: "Shows a loading indicator and blocks interaction.";
+    };
+    loadingLabel: {
+        readonly type: StringConstructor;
+        readonly description: "Accessible label announced while loading.";
     };
-    tooltip: StringConstructor;
-    skipFormRegistry: BooleanConstructor;
-    disabled: BooleanConstructor;
-    loading: BooleanConstructor;
-    loadingLabel: StringConstructor;
     loadingStatus: {
         readonly type: import("vue").PropType<import("../loader/Loader.vue").LoaderStatus>;
         readonly default: "active";
+        readonly description: "Loader visual status (for example active or indeterminate).";
     };
     color: {
         readonly type: StringConstructor;
         readonly default: string | undefined;
+        readonly description: "Theme or CSS color used for the control accents.";
     };
     size: {
         readonly type: import("vue").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<{
     [x: `on${Capitalize<string>}`]: ((...args: any[]) => any) | undefined;

package/lib/components/checkbox/Checkbox.vue_vue_type_script_setup_true_lang.js

@@ -20,12 +20,29 @@ var D = ["onKeypress"], O = [
 	...e.props("primary"),
 	...i.props(),
 	...o.props(),
-	value: [String, Number],
-	indeterminate: Boolean,
-	glow: n()
+	value: {
+		type: [String, Number],
+		description: "Value used when the checkbox is inside an x-form-group (array selection)."
+	},
+	indeterminate: {
+		type: Boolean,
+		description: "Shows an indeterminate (mixed) check state."
+	},
+	glow: n("Soft colored glow behind the control.")
 }, j = /* @__PURE__ */ f({
 	name: "XCheckbox",
 	validators: { ...r.validators() },
+	docs: {
+		slots: {
+			default: "Label content when the `label` prop is not set.",
+			icon: "Custom checked-state icon."
+		},
+		emits: { ...o.emitDocs(!1) },
+		methods: {
+			...o.methodDocs(),
+			toggle: "Toggle the checked state (no-op when disabled, loading, or readonly)."
+		}
+	},
 	props: A,
 	emits: o.emits(!1),
 	setup(e, { expose: n, emit: r }) {

package/lib/components/container/Container.vue.d.ts

@@ -4,10 +4,12 @@ declare const containerProps: {
     tag: {
         type: StringConstructor;
         default: string;
+        description: string;
     };
     fluid: {
         type: BooleanConstructor;
         default: boolean;
+        description: string;
     };
 };
 export type ContainerProps = ExtractPublicPropTypes<typeof containerProps>;
@@ -18,19 +20,23 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
     tag: {
         type: StringConstructor;
         default: string;
+        description: string;
     };
     fluid: {
         type: BooleanConstructor;
         default: boolean;
+        description: string;
     };
 }>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
     tag: {
         type: StringConstructor;
         default: string;
+        description: string;
     };
     fluid: {
         type: BooleanConstructor;
         default: boolean;
+        description: string;
     };
 }>> & Readonly<{}>, {
     tag: string;

package/lib/components/container/Container.vue_vue_type_script_setup_true_lang.js

@@ -3,14 +3,17 @@ import { createBlock as t, defineComponent as n, normalizeClass as r, normalizeS
 //#region src/components/container/Container.vue?vue&type=script&setup=true&lang.ts
 var u = /* @__PURE__ */ n({
 	name: "XContainer",
+	docs: { slots: { default: "Container content." } },
 	props: {
 		tag: {
 			type: String,
-			default: "div"
+			default: "div",
+			description: "Root element tag."
 		},
 		fluid: {
 			type: Boolean,
-			default: !1
+			default: !1,
+			description: "Removes max-width constraints so the container spans the full parent width."
 		}
 	},
 	setup(n) {